fase(6): fuzzing module complete
This commit is contained in:
@@ -1 +1 @@
|
|||||||
96bf6e50979e4cc152e9715b965f27eeb2decbc1
|
d62bd615bf6b93b982e19e35b0b49591c648e5d2
|
||||||
|
|||||||
@@ -89,40 +89,40 @@ Spec: `.ralph/specs/phase-04-crawling-infrastructure.md`
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Phase 5: Findings Module [PENDIENTE]
|
## Phase 5: Findings Module [COMPLETO]
|
||||||
Spec: `.ralph/specs/phase-05-findings-module.md`
|
Spec: `.ralph/specs/phase-05-findings-module.md`
|
||||||
|
|
||||||
- [ ] 5.1: Crear `domain/entities/Finding.ts` — AggregateRoot con severity, type, evidence, status, actionTrace
|
- [x] 5.1: Crear `domain/entities/Finding.ts` — AggregateRoot con severity, type, evidence, status, actionTrace
|
||||||
- [ ] 5.2: Crear value objects: `Severity.ts` (low/medium/high/critical), `FindingType.ts`, `Evidence.ts`, `FindingStatus.ts` (open/investigating/resolved/closed)
|
- [x] 5.2: Crear value objects: `Severity.ts` (low/medium/high/critical), `FindingType.ts`, `Evidence.ts`, `FindingStatus.ts` (open/investigating/resolved/closed)
|
||||||
- [ ] 5.3: Crear events: `FindingCreated.ts`, `FindingResolved.ts`, `FindingEnriched.ts`
|
- [x] 5.3: Crear events: `FindingCreated.ts`, `FindingResolved.ts`, `FindingEnriched.ts`
|
||||||
- [ ] 5.4: Crear ports: `IFindingRepository.ts`, `IAIEnricher.ts`
|
- [x] 5.4: Crear ports: `IFindingRepository.ts`, `IAIEnricher.ts`
|
||||||
- [ ] 5.5: Crear commands: `CreateFindingCommand.ts`, `EnrichFindingCommand.ts`, `ResolveFindingCommand.ts`
|
- [x] 5.5: Crear commands: `CreateFindingCommand.ts`, `EnrichFindingCommand.ts`, `ResolveFindingCommand.ts`
|
||||||
- [ ] 5.6: Crear queries: `GetFindingQuery.ts`, `ListFindingsQuery.ts` (filtros: severity, type, session, status, search), `FindingStatsQuery.ts`
|
- [x] 5.6: Crear queries: `GetFindingQuery.ts`, `ListFindingsQuery.ts` (filtros: severity, type, session, status, search), `FindingStatsQuery.ts`
|
||||||
- [ ] 5.7: Crear `event-handlers/OnAnomalyDetected.ts` — escucha eventos crawling → crea Finding
|
- [x] 5.7: Crear `event-handlers/OnAnomalyDetected.ts` — escucha eventos crawling → crea Finding
|
||||||
- [ ] 5.8: Crear `infrastructure/repositories/KyselyFindingRepository.ts`
|
- [x] 5.8: Crear `infrastructure/repositories/KyselyFindingRepository.ts`
|
||||||
- [ ] 5.9: Migrar exporters existentes → `infrastructure/exporters/` (MarkdownExporter, JSONExporter)
|
- [x] 5.9: Migrar exporters existentes → `infrastructure/exporters/` (MarkdownExporter, JSONExporter)
|
||||||
- [ ] 5.10: Crear `infrastructure/exporters/PlaywrightScriptExporter.ts` — genera test Playwright reproducible desde actionTrace
|
- [x] 5.10: Crear `infrastructure/exporters/PlaywrightScriptExporter.ts` — genera test Playwright reproducible desde actionTrace
|
||||||
- [ ] 5.11: Crear `infrastructure/http/FindingsController.ts` — routes para anomalies existentes + nuevas
|
- [x] 5.11: Crear `infrastructure/http/FindingsController.ts` — routes para anomalies existentes + nuevas
|
||||||
- [ ] 5.12: Migración Kysely: tabla findings con columnas status, browser, ai_enrichment_json
|
- [x] 5.12: Migración Kysely: tabla findings con columnas status, browser, ai_enrichment_json
|
||||||
- [ ] 5.13: Tests: Finding aggregate, CreateFinding, ListFindings con filtros
|
- [x] 5.13: Tests: Finding aggregate, CreateFinding, ListFindings con filtros
|
||||||
- [ ] 5.14: Verificar build + commit: `fase(5): findings module complete`
|
- [x] 5.14: Verificar build + commit: `fase(5): findings module complete`
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Phase 6: Fuzzing Module [PENDIENTE]
|
## Phase 6: Fuzzing Module [COMPLETO]
|
||||||
Spec: `.ralph/specs/phase-06-fuzzing-module.md`
|
Spec: `.ralph/specs/phase-06-fuzzing-module.md`
|
||||||
|
|
||||||
- [ ] 6.1: Crear domain: `FuzzSession.ts` (AggregateRoot), `FuzzResult.ts` (Entity)
|
- [x] 6.1: Crear domain: `FuzzSession.ts` (AggregateRoot), `FuzzResult.ts` (Entity)
|
||||||
- [ ] 6.2: Crear value objects: `FuzzStrategy.ts`, `FuzzPayload.ts`, `Seed.ts`, `FuzzIntensity.ts`
|
- [x] 6.2: Crear value objects: `FuzzStrategy.ts`, `FuzzPayload.ts`, `Seed.ts`, `FuzzIntensity.ts`
|
||||||
- [ ] 6.3: Crear events: `FuzzStarted.ts`, `VulnerabilityDetected.ts`, `FuzzCompleted.ts`
|
- [x] 6.3: Crear events: `FuzzStarted.ts`, `VulnerabilityDetected.ts`, `FuzzCompleted.ts`
|
||||||
- [ ] 6.4: Crear port: `IFuzzerEngine.ts`
|
- [x] 6.4: Crear port: `IFuzzerEngine.ts`
|
||||||
- [ ] 6.5: Crear `commands/RunFuzzCommand.ts`
|
- [x] 6.5: Crear `commands/RunFuzzCommand.ts`
|
||||||
- [ ] 6.6: Crear `event-handlers/OnActionExecuted.ts` — escucha crawling → trigger fuzzing
|
- [x] 6.6: Crear `event-handlers/OnActionExecuted.ts` — escucha crawling → trigger fuzzing
|
||||||
- [ ] 6.7: Migrar las 5 estrategias existentes → `infrastructure/strategies/` (Empty, Oversized, SpecialChars, TypeMismatch, Boundary)
|
- [x] 6.7: Migrar las 5 estrategias existentes → `infrastructure/strategies/` (Empty, Oversized, SpecialChars, TypeMismatch, Boundary)
|
||||||
- [ ] 6.8: Migrar `FuzzingEngine.ts` y `InputTypeDetector.ts` → `infrastructure/adapters/`
|
- [x] 6.8: Migrar `FuzzingEngine.ts` y `InputTypeDetector.ts` → `infrastructure/adapters/`
|
||||||
- [ ] 6.9: Crear `infrastructure/http/FuzzingController.ts`
|
- [x] 6.9: Crear `infrastructure/http/FuzzingController.ts`
|
||||||
- [ ] 6.10: Tests: cada estrategia de fuzzing genera payloads válidos
|
- [x] 6.10: Tests: cada estrategia de fuzzing genera payloads válidos
|
||||||
- [ ] 6.11: Verificar build + commit: `fase(6): fuzzing module complete`
|
- [x] 6.11: Verificar build + commit: `fase(6): fuzzing module complete`
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1 @@
|
|||||||
{
|
{"status": "failed", "timestamp": "2026-03-05 04:07:02"}
|
||||||
"status": "executing",
|
|
||||||
"indicator": "⠹",
|
|
||||||
"elapsed_seconds": 30,
|
|
||||||
"last_output": "",
|
|
||||||
"timestamp": "2026-03-05 03:53:30"
|
|
||||||
}
|
|
||||||
|
|||||||
39
dist/modules/fuzzing/application/commands/RunFuzzCommand.js
vendored
Normal file
39
dist/modules/fuzzing/application/commands/RunFuzzCommand.js
vendored
Normal file
@@ -0,0 +1,39 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.RunFuzzCommand = void 0;
|
||||||
|
const Result_1 = require("../../../../shared/domain/Result");
|
||||||
|
const FuzzSession_1 = require("../../domain/entities/FuzzSession");
|
||||||
|
class RunFuzzCommand {
|
||||||
|
constructor(fuzzerEngine, repository, eventBus) {
|
||||||
|
this.fuzzerEngine = fuzzerEngine;
|
||||||
|
this.repository = repository;
|
||||||
|
this.eventBus = eventBus;
|
||||||
|
}
|
||||||
|
async execute(request) {
|
||||||
|
const sessionResult = FuzzSession_1.FuzzSession.create({
|
||||||
|
crawlSessionId: request.crawlSessionId,
|
||||||
|
intensity: request.intensity,
|
||||||
|
seed: request.seed,
|
||||||
|
});
|
||||||
|
if (!sessionResult.ok) {
|
||||||
|
return (0, Result_1.Err)(sessionResult.error);
|
||||||
|
}
|
||||||
|
const session = sessionResult.value;
|
||||||
|
await this.repository.save(session);
|
||||||
|
const actions = this.fuzzerEngine.generateFuzzActions(request.state.domSnapshot, request.state);
|
||||||
|
for (const _action of actions) {
|
||||||
|
session.incrementActions();
|
||||||
|
}
|
||||||
|
session.complete();
|
||||||
|
await this.repository.update(session);
|
||||||
|
for (const event of session.domainEvents) {
|
||||||
|
await this.eventBus.publish(event);
|
||||||
|
}
|
||||||
|
session.clearEvents();
|
||||||
|
return (0, Result_1.Ok)({
|
||||||
|
fuzzSessionId: session.id.toString(),
|
||||||
|
actionsGenerated: actions.length,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.RunFuzzCommand = RunFuzzCommand;
|
||||||
26
dist/modules/fuzzing/application/event-handlers/OnActionExecuted.js
vendored
Normal file
26
dist/modules/fuzzing/application/event-handlers/OnActionExecuted.js
vendored
Normal file
@@ -0,0 +1,26 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.OnActionExecuted = void 0;
|
||||||
|
/**
|
||||||
|
* Listens for action_executed events from crawling module
|
||||||
|
* and triggers fuzzing on the resulting state's DOM.
|
||||||
|
*/
|
||||||
|
class OnActionExecuted {
|
||||||
|
constructor(runFuzz) {
|
||||||
|
this.runFuzz = runFuzz;
|
||||||
|
}
|
||||||
|
async handle(event) {
|
||||||
|
const payload = event.payload;
|
||||||
|
if (!payload.state || !payload.sessionId)
|
||||||
|
return;
|
||||||
|
if (!payload.state.domSnapshot)
|
||||||
|
return;
|
||||||
|
await this.runFuzz.execute({
|
||||||
|
crawlSessionId: payload.sessionId,
|
||||||
|
intensity: payload.intensity ?? 'low',
|
||||||
|
seed: payload.action?.seed ?? Date.now(),
|
||||||
|
state: payload.state,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.OnActionExecuted = OnActionExecuted;
|
||||||
22
dist/modules/fuzzing/domain/entities/FuzzResult.js
vendored
Normal file
22
dist/modules/fuzzing/domain/entities/FuzzResult.js
vendored
Normal file
@@ -0,0 +1,22 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.FuzzResult = void 0;
|
||||||
|
const Entity_1 = require("../../../../shared/domain/Entity");
|
||||||
|
class FuzzResult extends Entity_1.Entity {
|
||||||
|
static create(props, id) {
|
||||||
|
return new FuzzResult({ ...props, detectedAt: new Date() }, id);
|
||||||
|
}
|
||||||
|
static reconstitute(props, id) {
|
||||||
|
return new FuzzResult(props, id);
|
||||||
|
}
|
||||||
|
get sessionId() { return this.props.sessionId; }
|
||||||
|
get stateId() { return this.props.stateId; }
|
||||||
|
get selector() { return this.props.selector; }
|
||||||
|
get payload() { return this.props.payload; }
|
||||||
|
get strategy() { return this.props.strategy; }
|
||||||
|
get anomalyType() { return this.props.anomalyType; }
|
||||||
|
get severity() { return this.props.severity; }
|
||||||
|
get description() { return this.props.description; }
|
||||||
|
get detectedAt() { return this.props.detectedAt; }
|
||||||
|
}
|
||||||
|
exports.FuzzResult = FuzzResult;
|
||||||
96
dist/modules/fuzzing/domain/entities/FuzzSession.js
vendored
Normal file
96
dist/modules/fuzzing/domain/entities/FuzzSession.js
vendored
Normal file
@@ -0,0 +1,96 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.FuzzSession = void 0;
|
||||||
|
const AggregateRoot_1 = require("../../../../shared/domain/AggregateRoot");
|
||||||
|
const Result_1 = require("../../../../shared/domain/Result");
|
||||||
|
const FuzzIntensity_1 = require("../value-objects/FuzzIntensity");
|
||||||
|
const Seed_1 = require("../value-objects/Seed");
|
||||||
|
const FuzzStarted_1 = require("../events/FuzzStarted");
|
||||||
|
const FuzzCompleted_1 = require("../events/FuzzCompleted");
|
||||||
|
const VulnerabilityDetected_1 = require("../events/VulnerabilityDetected");
|
||||||
|
class FuzzSession extends AggregateRoot_1.AggregateRoot {
|
||||||
|
constructor(props, id) {
|
||||||
|
super(props, id);
|
||||||
|
}
|
||||||
|
static reconstitute(props, id) {
|
||||||
|
return new FuzzSession(props, id);
|
||||||
|
}
|
||||||
|
static create(request) {
|
||||||
|
let intensity;
|
||||||
|
try {
|
||||||
|
intensity = FuzzIntensity_1.FuzzIntensity.fromString(request.intensity);
|
||||||
|
}
|
||||||
|
catch (e) {
|
||||||
|
return (0, Result_1.Err)(e.message);
|
||||||
|
}
|
||||||
|
let seed;
|
||||||
|
try {
|
||||||
|
seed = Seed_1.Seed.create(request.seed);
|
||||||
|
}
|
||||||
|
catch (e) {
|
||||||
|
return (0, Result_1.Err)(e.message);
|
||||||
|
}
|
||||||
|
const props = {
|
||||||
|
crawlSessionId: request.crawlSessionId,
|
||||||
|
intensity,
|
||||||
|
seed,
|
||||||
|
status: 'running',
|
||||||
|
actionsExecuted: 0,
|
||||||
|
vulnerabilitiesFound: 0,
|
||||||
|
startedAt: new Date(),
|
||||||
|
};
|
||||||
|
const session = new FuzzSession(props);
|
||||||
|
session.addDomainEvent(new FuzzStarted_1.FuzzStarted(session.id.toString(), {
|
||||||
|
crawlSessionId: request.crawlSessionId,
|
||||||
|
intensity: request.intensity,
|
||||||
|
seed: request.seed,
|
||||||
|
}));
|
||||||
|
return (0, Result_1.Ok)(session);
|
||||||
|
}
|
||||||
|
get crawlSessionId() { return this.props.crawlSessionId; }
|
||||||
|
get intensity() { return this.props.intensity; }
|
||||||
|
get seed() { return this.props.seed; }
|
||||||
|
get status() { return this.props.status; }
|
||||||
|
get actionsExecuted() { return this.props.actionsExecuted; }
|
||||||
|
get vulnerabilitiesFound() { return this.props.vulnerabilitiesFound; }
|
||||||
|
get startedAt() { return this.props.startedAt; }
|
||||||
|
get completedAt() { return this.props.completedAt; }
|
||||||
|
recordVulnerability(result) {
|
||||||
|
this.props = {
|
||||||
|
...this.props,
|
||||||
|
actionsExecuted: this.props.actionsExecuted + 1,
|
||||||
|
vulnerabilitiesFound: this.props.vulnerabilitiesFound + 1,
|
||||||
|
};
|
||||||
|
this.addDomainEvent(new VulnerabilityDetected_1.VulnerabilityDetected(this.id.toString(), {
|
||||||
|
crawlSessionId: this.props.crawlSessionId,
|
||||||
|
stateId: result.stateId,
|
||||||
|
anomalyType: result.anomalyType,
|
||||||
|
severity: result.severity,
|
||||||
|
selector: result.selector,
|
||||||
|
payload: result.payload,
|
||||||
|
strategy: result.strategy,
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
incrementActions() {
|
||||||
|
this.props = { ...this.props, actionsExecuted: this.props.actionsExecuted + 1 };
|
||||||
|
}
|
||||||
|
complete() {
|
||||||
|
this.props = { ...this.props, status: 'completed', completedAt: new Date() };
|
||||||
|
this.addDomainEvent(new FuzzCompleted_1.FuzzCompleted(this.id.toString(), {
|
||||||
|
crawlSessionId: this.props.crawlSessionId,
|
||||||
|
actionsExecuted: this.props.actionsExecuted,
|
||||||
|
vulnerabilitiesFound: this.props.vulnerabilitiesFound,
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
fail(reason) {
|
||||||
|
this.props = { ...this.props, status: 'failed', completedAt: new Date() };
|
||||||
|
this.addDomainEvent(new FuzzCompleted_1.FuzzCompleted(this.id.toString(), {
|
||||||
|
crawlSessionId: this.props.crawlSessionId,
|
||||||
|
actionsExecuted: this.props.actionsExecuted,
|
||||||
|
vulnerabilitiesFound: this.props.vulnerabilitiesFound,
|
||||||
|
failed: true,
|
||||||
|
reason,
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.FuzzSession = FuzzSession;
|
||||||
14
dist/modules/fuzzing/domain/events/FuzzCompleted.js
vendored
Normal file
14
dist/modules/fuzzing/domain/events/FuzzCompleted.js
vendored
Normal file
@@ -0,0 +1,14 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.FuzzCompleted = void 0;
|
||||||
|
const crypto_1 = require("crypto");
|
||||||
|
class FuzzCompleted {
|
||||||
|
constructor(aggregateId, payload) {
|
||||||
|
this.aggregateId = aggregateId;
|
||||||
|
this.payload = payload;
|
||||||
|
this.eventId = (0, crypto_1.randomUUID)();
|
||||||
|
this.eventName = 'fuzz.completed';
|
||||||
|
this.occurredOn = new Date();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.FuzzCompleted = FuzzCompleted;
|
||||||
14
dist/modules/fuzzing/domain/events/FuzzStarted.js
vendored
Normal file
14
dist/modules/fuzzing/domain/events/FuzzStarted.js
vendored
Normal file
@@ -0,0 +1,14 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.FuzzStarted = void 0;
|
||||||
|
const crypto_1 = require("crypto");
|
||||||
|
class FuzzStarted {
|
||||||
|
constructor(aggregateId, payload) {
|
||||||
|
this.aggregateId = aggregateId;
|
||||||
|
this.payload = payload;
|
||||||
|
this.eventId = (0, crypto_1.randomUUID)();
|
||||||
|
this.eventName = 'fuzz.started';
|
||||||
|
this.occurredOn = new Date();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.FuzzStarted = FuzzStarted;
|
||||||
14
dist/modules/fuzzing/domain/events/VulnerabilityDetected.js
vendored
Normal file
14
dist/modules/fuzzing/domain/events/VulnerabilityDetected.js
vendored
Normal file
@@ -0,0 +1,14 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.VulnerabilityDetected = void 0;
|
||||||
|
const crypto_1 = require("crypto");
|
||||||
|
class VulnerabilityDetected {
|
||||||
|
constructor(aggregateId, payload) {
|
||||||
|
this.aggregateId = aggregateId;
|
||||||
|
this.payload = payload;
|
||||||
|
this.eventId = (0, crypto_1.randomUUID)();
|
||||||
|
this.eventName = 'fuzz.vulnerability_detected';
|
||||||
|
this.occurredOn = new Date();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.VulnerabilityDetected = VulnerabilityDetected;
|
||||||
2
dist/modules/fuzzing/domain/ports/IFuzzerEngine.js
vendored
Normal file
2
dist/modules/fuzzing/domain/ports/IFuzzerEngine.js
vendored
Normal file
@@ -0,0 +1,2 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
18
dist/modules/fuzzing/domain/value-objects/FuzzIntensity.js
vendored
Normal file
18
dist/modules/fuzzing/domain/value-objects/FuzzIntensity.js
vendored
Normal file
@@ -0,0 +1,18 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.FuzzIntensity = void 0;
|
||||||
|
const ValueObject_1 = require("../../../../shared/domain/ValueObject");
|
||||||
|
class FuzzIntensity extends ValueObject_1.ValueObject {
|
||||||
|
static low() { return new FuzzIntensity({ value: 'low' }); }
|
||||||
|
static medium() { return new FuzzIntensity({ value: 'medium' }); }
|
||||||
|
static high() { return new FuzzIntensity({ value: 'high' }); }
|
||||||
|
static fromString(s) {
|
||||||
|
if (!FuzzIntensity.LEVELS.includes(s)) {
|
||||||
|
throw new Error(`Invalid intensity: ${s}. Must be one of: ${FuzzIntensity.LEVELS.join(', ')}`);
|
||||||
|
}
|
||||||
|
return new FuzzIntensity({ value: s });
|
||||||
|
}
|
||||||
|
get value() { return this.props.value; }
|
||||||
|
}
|
||||||
|
exports.FuzzIntensity = FuzzIntensity;
|
||||||
|
FuzzIntensity.LEVELS = ['low', 'medium', 'high'];
|
||||||
12
dist/modules/fuzzing/domain/value-objects/FuzzPayload.js
vendored
Normal file
12
dist/modules/fuzzing/domain/value-objects/FuzzPayload.js
vendored
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.FuzzPayload = void 0;
|
||||||
|
const ValueObject_1 = require("../../../../shared/domain/ValueObject");
|
||||||
|
class FuzzPayload extends ValueObject_1.ValueObject {
|
||||||
|
static create(value, strategy) {
|
||||||
|
return new FuzzPayload({ value, strategy });
|
||||||
|
}
|
||||||
|
get value() { return this.props.value; }
|
||||||
|
get strategy() { return this.props.strategy; }
|
||||||
|
}
|
||||||
|
exports.FuzzPayload = FuzzPayload;
|
||||||
20
dist/modules/fuzzing/domain/value-objects/FuzzStrategy.js
vendored
Normal file
20
dist/modules/fuzzing/domain/value-objects/FuzzStrategy.js
vendored
Normal file
@@ -0,0 +1,20 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.FuzzStrategy = void 0;
|
||||||
|
const ValueObject_1 = require("../../../../shared/domain/ValueObject");
|
||||||
|
class FuzzStrategy extends ValueObject_1.ValueObject {
|
||||||
|
static empty() { return new FuzzStrategy({ value: 'empty' }); }
|
||||||
|
static oversized() { return new FuzzStrategy({ value: 'oversized' }); }
|
||||||
|
static specialChars() { return new FuzzStrategy({ value: 'special_chars' }); }
|
||||||
|
static typeMismatch() { return new FuzzStrategy({ value: 'type_mismatch' }); }
|
||||||
|
static boundary() { return new FuzzStrategy({ value: 'boundary' }); }
|
||||||
|
static fromString(s) {
|
||||||
|
if (!FuzzStrategy.ALL.includes(s)) {
|
||||||
|
throw new Error(`Invalid fuzz strategy: ${s}`);
|
||||||
|
}
|
||||||
|
return new FuzzStrategy({ value: s });
|
||||||
|
}
|
||||||
|
get value() { return this.props.value; }
|
||||||
|
}
|
||||||
|
exports.FuzzStrategy = FuzzStrategy;
|
||||||
|
FuzzStrategy.ALL = ['empty', 'oversized', 'special_chars', 'type_mismatch', 'boundary'];
|
||||||
17
dist/modules/fuzzing/domain/value-objects/Seed.js
vendored
Normal file
17
dist/modules/fuzzing/domain/value-objects/Seed.js
vendored
Normal file
@@ -0,0 +1,17 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.Seed = void 0;
|
||||||
|
const ValueObject_1 = require("../../../../shared/domain/ValueObject");
|
||||||
|
class Seed extends ValueObject_1.ValueObject {
|
||||||
|
static create(value) {
|
||||||
|
if (!Number.isInteger(value) || value < 0) {
|
||||||
|
throw new Error(`Seed must be a non-negative integer, got: ${value}`);
|
||||||
|
}
|
||||||
|
return new Seed({ value });
|
||||||
|
}
|
||||||
|
static fromTimestamp() {
|
||||||
|
return new Seed({ value: Date.now() });
|
||||||
|
}
|
||||||
|
get value() { return this.props.value; }
|
||||||
|
}
|
||||||
|
exports.Seed = Seed;
|
||||||
26
dist/modules/fuzzing/index.js
vendored
Normal file
26
dist/modules/fuzzing/index.js
vendored
Normal file
@@ -0,0 +1,26 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.createFuzzingRouter = exports.FuzzingEngineAdapter = exports.OnActionExecuted = exports.RunFuzzCommand = exports.Seed = exports.FuzzPayload = exports.FuzzStrategy = exports.FuzzIntensity = exports.FuzzResult = exports.FuzzSession = void 0;
|
||||||
|
// Domain
|
||||||
|
var FuzzSession_1 = require("./domain/entities/FuzzSession");
|
||||||
|
Object.defineProperty(exports, "FuzzSession", { enumerable: true, get: function () { return FuzzSession_1.FuzzSession; } });
|
||||||
|
var FuzzResult_1 = require("./domain/entities/FuzzResult");
|
||||||
|
Object.defineProperty(exports, "FuzzResult", { enumerable: true, get: function () { return FuzzResult_1.FuzzResult; } });
|
||||||
|
var FuzzIntensity_1 = require("./domain/value-objects/FuzzIntensity");
|
||||||
|
Object.defineProperty(exports, "FuzzIntensity", { enumerable: true, get: function () { return FuzzIntensity_1.FuzzIntensity; } });
|
||||||
|
var FuzzStrategy_1 = require("./domain/value-objects/FuzzStrategy");
|
||||||
|
Object.defineProperty(exports, "FuzzStrategy", { enumerable: true, get: function () { return FuzzStrategy_1.FuzzStrategy; } });
|
||||||
|
var FuzzPayload_1 = require("./domain/value-objects/FuzzPayload");
|
||||||
|
Object.defineProperty(exports, "FuzzPayload", { enumerable: true, get: function () { return FuzzPayload_1.FuzzPayload; } });
|
||||||
|
var Seed_1 = require("./domain/value-objects/Seed");
|
||||||
|
Object.defineProperty(exports, "Seed", { enumerable: true, get: function () { return Seed_1.Seed; } });
|
||||||
|
// Application
|
||||||
|
var RunFuzzCommand_1 = require("./application/commands/RunFuzzCommand");
|
||||||
|
Object.defineProperty(exports, "RunFuzzCommand", { enumerable: true, get: function () { return RunFuzzCommand_1.RunFuzzCommand; } });
|
||||||
|
var OnActionExecuted_1 = require("./application/event-handlers/OnActionExecuted");
|
||||||
|
Object.defineProperty(exports, "OnActionExecuted", { enumerable: true, get: function () { return OnActionExecuted_1.OnActionExecuted; } });
|
||||||
|
// Infrastructure
|
||||||
|
var FuzzingEngineAdapter_1 = require("./infrastructure/adapters/FuzzingEngineAdapter");
|
||||||
|
Object.defineProperty(exports, "FuzzingEngineAdapter", { enumerable: true, get: function () { return FuzzingEngineAdapter_1.FuzzingEngineAdapter; } });
|
||||||
|
var FuzzingController_1 = require("./infrastructure/http/FuzzingController");
|
||||||
|
Object.defineProperty(exports, "createFuzzingRouter", { enumerable: true, get: function () { return FuzzingController_1.createFuzzingRouter; } });
|
||||||
127
dist/modules/fuzzing/infrastructure/adapters/FuzzingEngineAdapter.js
vendored
Normal file
127
dist/modules/fuzzing/infrastructure/adapters/FuzzingEngineAdapter.js
vendored
Normal file
@@ -0,0 +1,127 @@
|
|||||||
|
"use strict";
|
||||||
|
/**
|
||||||
|
* FuzzingEngineAdapter — implements IFuzzerEngine port using the 5 fuzzing strategies.
|
||||||
|
* Adapts the legacy FuzzingEngine logic to the hexagonal architecture.
|
||||||
|
*/
|
||||||
|
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
||||||
|
if (k2 === undefined) k2 = k;
|
||||||
|
var desc = Object.getOwnPropertyDescriptor(m, k);
|
||||||
|
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
||||||
|
desc = { enumerable: true, get: function() { return m[k]; } };
|
||||||
|
}
|
||||||
|
Object.defineProperty(o, k2, desc);
|
||||||
|
}) : (function(o, m, k, k2) {
|
||||||
|
if (k2 === undefined) k2 = k;
|
||||||
|
o[k2] = m[k];
|
||||||
|
}));
|
||||||
|
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
||||||
|
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
||||||
|
}) : function(o, v) {
|
||||||
|
o["default"] = v;
|
||||||
|
});
|
||||||
|
var __importStar = (this && this.__importStar) || (function () {
|
||||||
|
var ownKeys = function(o) {
|
||||||
|
ownKeys = Object.getOwnPropertyNames || function (o) {
|
||||||
|
var ar = [];
|
||||||
|
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
||||||
|
return ar;
|
||||||
|
};
|
||||||
|
return ownKeys(o);
|
||||||
|
};
|
||||||
|
return function (mod) {
|
||||||
|
if (mod && mod.__esModule) return mod;
|
||||||
|
var result = {};
|
||||||
|
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
||||||
|
__setModuleDefault(result, mod);
|
||||||
|
return result;
|
||||||
|
};
|
||||||
|
})();
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.FuzzingEngineAdapter = void 0;
|
||||||
|
const crypto = __importStar(require("crypto"));
|
||||||
|
const InputTypeDetector_1 = require("./InputTypeDetector");
|
||||||
|
const EmptyValueStrategy_1 = require("../strategies/EmptyValueStrategy");
|
||||||
|
const OversizedStringStrategy_1 = require("../strategies/OversizedStringStrategy");
|
||||||
|
const SpecialCharsStrategy_1 = require("../strategies/SpecialCharsStrategy");
|
||||||
|
const TypeMismatchStrategy_1 = require("../strategies/TypeMismatchStrategy");
|
||||||
|
const BoundaryValueStrategy_1 = require("../strategies/BoundaryValueStrategy");
|
||||||
|
const INPUT_RE = /<(input|textarea|select)[^>]*>/gi;
|
||||||
|
const ATTR_RE = (name) => new RegExp(`${name}="([^"]*)"`, 'i');
|
||||||
|
function extractFields(domSnapshot) {
|
||||||
|
const fields = [];
|
||||||
|
let match;
|
||||||
|
while ((match = INPUT_RE.exec(domSnapshot)) !== null) {
|
||||||
|
const tag = match[0] ?? '';
|
||||||
|
const tagName = match[1] ?? 'input';
|
||||||
|
const idMatch = ATTR_RE('id').exec(tag);
|
||||||
|
const nameMatch = ATTR_RE('name').exec(tag);
|
||||||
|
const typeMatch = ATTR_RE('type').exec(tag);
|
||||||
|
const placeholderMatch = ATTR_RE('placeholder').exec(tag);
|
||||||
|
const ariaMatch = ATTR_RE('aria-label').exec(tag);
|
||||||
|
const selector = idMatch?.[1]
|
||||||
|
? `#${idMatch[1]}`
|
||||||
|
: nameMatch?.[1]
|
||||||
|
? `[name="${nameMatch[1]}"]`
|
||||||
|
: tagName;
|
||||||
|
fields.push({
|
||||||
|
selector,
|
||||||
|
tagName,
|
||||||
|
inputType: typeMatch?.[1],
|
||||||
|
name: nameMatch?.[1],
|
||||||
|
placeholder: placeholderMatch?.[1],
|
||||||
|
ariaLabel: ariaMatch?.[1],
|
||||||
|
});
|
||||||
|
}
|
||||||
|
return fields;
|
||||||
|
}
|
||||||
|
class FuzzingEngineAdapter {
|
||||||
|
constructor(config) {
|
||||||
|
this.intensity = config.intensity;
|
||||||
|
this.seed = config.seed;
|
||||||
|
}
|
||||||
|
generateFuzzActions(domSnapshot, state) {
|
||||||
|
const fields = extractFields(domSnapshot);
|
||||||
|
const actions = [];
|
||||||
|
const now = Date.now();
|
||||||
|
const strategies = this.selectStrategies();
|
||||||
|
for (const field of fields) {
|
||||||
|
const detectedType = (0, InputTypeDetector_1.detectInputType)({
|
||||||
|
tagName: field.tagName,
|
||||||
|
inputType: field.inputType,
|
||||||
|
name: field.name,
|
||||||
|
placeholder: field.placeholder,
|
||||||
|
ariaLabel: field.ariaLabel,
|
||||||
|
});
|
||||||
|
for (const strategy of strategies) {
|
||||||
|
if (!strategy.appliesTo(detectedType))
|
||||||
|
continue;
|
||||||
|
const values = strategy.values(detectedType);
|
||||||
|
for (const value of values) {
|
||||||
|
actions.push({
|
||||||
|
id: crypto.randomUUID(),
|
||||||
|
type: 'fill',
|
||||||
|
selector: field.selector,
|
||||||
|
value,
|
||||||
|
timestamp: now,
|
||||||
|
seed: this.seed,
|
||||||
|
stateId: state.id,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return actions;
|
||||||
|
}
|
||||||
|
selectStrategies() {
|
||||||
|
const empty = new EmptyValueStrategy_1.EmptyValueStrategy();
|
||||||
|
const typeMismatch = new TypeMismatchStrategy_1.TypeMismatchStrategy();
|
||||||
|
const oversized = new OversizedStringStrategy_1.OversizedStringStrategy(this.intensity);
|
||||||
|
const boundary = new BoundaryValueStrategy_1.BoundaryValueStrategy();
|
||||||
|
const special = new SpecialCharsStrategy_1.SpecialCharsStrategy();
|
||||||
|
switch (this.intensity) {
|
||||||
|
case 'low': return [empty, typeMismatch];
|
||||||
|
case 'medium': return [empty, typeMismatch, oversized, boundary];
|
||||||
|
case 'high': return [empty, typeMismatch, oversized, boundary, special];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.FuzzingEngineAdapter = FuzzingEngineAdapter;
|
||||||
47
dist/modules/fuzzing/infrastructure/adapters/InputTypeDetector.js
vendored
Normal file
47
dist/modules/fuzzing/infrastructure/adapters/InputTypeDetector.js
vendored
Normal file
@@ -0,0 +1,47 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.detectInputType = detectInputType;
|
||||||
|
function detectInputType(attrs) {
|
||||||
|
const tag = (attrs.tagName ?? '').toLowerCase();
|
||||||
|
if (tag === 'textarea')
|
||||||
|
return 'textarea';
|
||||||
|
if (tag === 'select')
|
||||||
|
return 'select';
|
||||||
|
const inputType = (attrs.inputType ?? '').toLowerCase();
|
||||||
|
if (inputType === 'email')
|
||||||
|
return 'email';
|
||||||
|
if (inputType === 'password')
|
||||||
|
return 'password';
|
||||||
|
if (inputType === 'number')
|
||||||
|
return 'number';
|
||||||
|
if (inputType === 'date')
|
||||||
|
return 'date';
|
||||||
|
if (inputType === 'tel')
|
||||||
|
return 'phone';
|
||||||
|
if (inputType === 'url')
|
||||||
|
return 'url';
|
||||||
|
if (inputType === 'search')
|
||||||
|
return 'search';
|
||||||
|
if (inputType === 'file')
|
||||||
|
return 'file';
|
||||||
|
const hints = [
|
||||||
|
(attrs.name ?? '').toLowerCase(),
|
||||||
|
(attrs.placeholder ?? '').toLowerCase(),
|
||||||
|
(attrs.ariaLabel ?? '').toLowerCase(),
|
||||||
|
].join(' ');
|
||||||
|
if (/email/.test(hints))
|
||||||
|
return 'email';
|
||||||
|
if (/password|pass/.test(hints))
|
||||||
|
return 'password';
|
||||||
|
if (/phone|tel|mobile/.test(hints))
|
||||||
|
return 'phone';
|
||||||
|
if (/date|birth|dob/.test(hints))
|
||||||
|
return 'date';
|
||||||
|
if (/number|qty|quantity|age/.test(hints))
|
||||||
|
return 'number';
|
||||||
|
if (/search/.test(hints))
|
||||||
|
return 'search';
|
||||||
|
if (/url|website|link/.test(hints))
|
||||||
|
return 'url';
|
||||||
|
return 'text';
|
||||||
|
}
|
||||||
50
dist/modules/fuzzing/infrastructure/http/FuzzingController.js
vendored
Normal file
50
dist/modules/fuzzing/infrastructure/http/FuzzingController.js
vendored
Normal file
@@ -0,0 +1,50 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.createFuzzingRouter = createFuzzingRouter;
|
||||||
|
const express_1 = require("express");
|
||||||
|
function createFuzzingRouter(deps) {
|
||||||
|
const router = (0, express_1.Router)();
|
||||||
|
// POST /api/fuzz/run — trigger fuzzing for a given state
|
||||||
|
router.post('/run', async (req, res) => {
|
||||||
|
const { crawlSessionId, intensity, seed, state } = req.body;
|
||||||
|
if (!crawlSessionId || !state) {
|
||||||
|
res.status(400).json({ error: 'crawlSessionId and state are required' });
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
const result = await deps.runFuzz.execute({
|
||||||
|
crawlSessionId,
|
||||||
|
intensity: intensity ?? 'low',
|
||||||
|
seed: seed ?? Date.now(),
|
||||||
|
state,
|
||||||
|
});
|
||||||
|
if (!result.ok) {
|
||||||
|
res.status(422).json({ error: result.error });
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
res.status(201).json(result.value);
|
||||||
|
});
|
||||||
|
// GET /api/fuzz/sessions/:id — get fuzz session
|
||||||
|
router.get('/sessions/:id', async (req, res) => {
|
||||||
|
const sessionId = req.params['id'];
|
||||||
|
const session = await deps.repository.findById(sessionId);
|
||||||
|
if (!session) {
|
||||||
|
res.status(404).json({ error: 'Fuzz session not found' });
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
res.json(toDTO(session));
|
||||||
|
});
|
||||||
|
return router;
|
||||||
|
}
|
||||||
|
function toDTO(s) {
|
||||||
|
return {
|
||||||
|
id: s.id.toString(),
|
||||||
|
crawlSessionId: s.crawlSessionId,
|
||||||
|
intensity: s.intensity.value,
|
||||||
|
seed: s.seed.value,
|
||||||
|
status: s.status,
|
||||||
|
actionsExecuted: s.actionsExecuted,
|
||||||
|
vulnerabilitiesFound: s.vulnerabilitiesFound,
|
||||||
|
startedAt: s.startedAt.toISOString(),
|
||||||
|
completedAt: s.completedAt?.toISOString() ?? null,
|
||||||
|
};
|
||||||
|
}
|
||||||
19
dist/modules/fuzzing/infrastructure/strategies/BoundaryValueStrategy.js
vendored
Normal file
19
dist/modules/fuzzing/infrastructure/strategies/BoundaryValueStrategy.js
vendored
Normal file
@@ -0,0 +1,19 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.BoundaryValueStrategy = void 0;
|
||||||
|
class BoundaryValueStrategy {
|
||||||
|
constructor() {
|
||||||
|
this.name = 'BoundaryValueStrategy';
|
||||||
|
}
|
||||||
|
appliesTo(type) {
|
||||||
|
return type === 'number' || type === 'date';
|
||||||
|
}
|
||||||
|
values(type) {
|
||||||
|
switch (type) {
|
||||||
|
case 'number': return ['0', '-1', '2147483647', '2147483648', '-2147483648'];
|
||||||
|
case 'date': return ['1900-01-01', '2099-12-31', '1970-01-01'];
|
||||||
|
default: return [];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.BoundaryValueStrategy = BoundaryValueStrategy;
|
||||||
15
dist/modules/fuzzing/infrastructure/strategies/EmptyValueStrategy.js
vendored
Normal file
15
dist/modules/fuzzing/infrastructure/strategies/EmptyValueStrategy.js
vendored
Normal file
@@ -0,0 +1,15 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.EmptyValueStrategy = void 0;
|
||||||
|
class EmptyValueStrategy {
|
||||||
|
constructor() {
|
||||||
|
this.name = 'EmptyValueStrategy';
|
||||||
|
}
|
||||||
|
appliesTo(_type) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
values() {
|
||||||
|
return ['', ' ', '\t'];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.EmptyValueStrategy = EmptyValueStrategy;
|
||||||
21
dist/modules/fuzzing/infrastructure/strategies/OversizedStringStrategy.js
vendored
Normal file
21
dist/modules/fuzzing/infrastructure/strategies/OversizedStringStrategy.js
vendored
Normal file
@@ -0,0 +1,21 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.OversizedStringStrategy = void 0;
|
||||||
|
const APPLICABLE_TYPES = ['text', 'email', 'password', 'textarea'];
|
||||||
|
class OversizedStringStrategy {
|
||||||
|
constructor(intensity) {
|
||||||
|
this.intensity = intensity;
|
||||||
|
this.name = 'OversizedStringStrategy';
|
||||||
|
}
|
||||||
|
appliesTo(type) {
|
||||||
|
return APPLICABLE_TYPES.includes(type);
|
||||||
|
}
|
||||||
|
values() {
|
||||||
|
switch (this.intensity) {
|
||||||
|
case 'low': return ['A'.repeat(256)];
|
||||||
|
case 'medium': return ['A'.repeat(1024)];
|
||||||
|
case 'high': return ['A'.repeat(10000) + '日本語テスト𠮷野家'];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.OversizedStringStrategy = OversizedStringStrategy;
|
||||||
22
dist/modules/fuzzing/infrastructure/strategies/SpecialCharsStrategy.js
vendored
Normal file
22
dist/modules/fuzzing/infrastructure/strategies/SpecialCharsStrategy.js
vendored
Normal file
@@ -0,0 +1,22 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.SpecialCharsStrategy = void 0;
|
||||||
|
const APPLICABLE_TYPES = ['text', 'email', 'search', 'textarea'];
|
||||||
|
class SpecialCharsStrategy {
|
||||||
|
constructor() {
|
||||||
|
this.name = 'SpecialCharsStrategy';
|
||||||
|
}
|
||||||
|
appliesTo(type) {
|
||||||
|
return APPLICABLE_TYPES.includes(type);
|
||||||
|
}
|
||||||
|
values() {
|
||||||
|
return [
|
||||||
|
"' OR 1=1 --",
|
||||||
|
'<script>alert(1)</script>',
|
||||||
|
'../../etc/passwd',
|
||||||
|
'${7*7}',
|
||||||
|
'\x00\x01\x02',
|
||||||
|
];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.SpecialCharsStrategy = SpecialCharsStrategy;
|
||||||
22
dist/modules/fuzzing/infrastructure/strategies/TypeMismatchStrategy.js
vendored
Normal file
22
dist/modules/fuzzing/infrastructure/strategies/TypeMismatchStrategy.js
vendored
Normal file
@@ -0,0 +1,22 @@
|
|||||||
|
"use strict";
|
||||||
|
Object.defineProperty(exports, "__esModule", { value: true });
|
||||||
|
exports.TypeMismatchStrategy = void 0;
|
||||||
|
class TypeMismatchStrategy {
|
||||||
|
constructor() {
|
||||||
|
this.name = 'TypeMismatchStrategy';
|
||||||
|
}
|
||||||
|
appliesTo(type) {
|
||||||
|
return ['email', 'number', 'date', 'url', 'phone'].includes(type);
|
||||||
|
}
|
||||||
|
values(type) {
|
||||||
|
switch (type) {
|
||||||
|
case 'email': return ['not-an-email', '12345', '@@@'];
|
||||||
|
case 'number': return ['abc', '-999999', '9.9.9', 'NaN'];
|
||||||
|
case 'date': return ['yesterday', '32/13/2025', '0000-00-00'];
|
||||||
|
case 'url': return ['javascript:alert(1)', 'not a url'];
|
||||||
|
case 'phone': return ['000', '++++', 'abcdefghij'];
|
||||||
|
default: return [];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
exports.TypeMismatchStrategy = TypeMismatchStrategy;
|
||||||
66
src/modules/fuzzing/application/commands/RunFuzzCommand.ts
Normal file
66
src/modules/fuzzing/application/commands/RunFuzzCommand.ts
Normal file
@@ -0,0 +1,66 @@
|
|||||||
|
import { UseCase } from '../../../../shared/application/UseCase';
|
||||||
|
import { EventBus } from '../../../../shared/application/EventBus';
|
||||||
|
import { Result, Ok, Err } from '../../../../shared/domain/Result';
|
||||||
|
import { FuzzSession } from '../../domain/entities/FuzzSession';
|
||||||
|
import { IFuzzerEngine } from '../../domain/ports/IFuzzerEngine';
|
||||||
|
import { IState } from '../../../../core/interfaces';
|
||||||
|
|
||||||
|
export interface IFuzzSessionRepository {
|
||||||
|
save(session: FuzzSession): Promise<void>;
|
||||||
|
findById(id: string): Promise<FuzzSession | null>;
|
||||||
|
update(session: FuzzSession): Promise<void>;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface RunFuzzRequest {
|
||||||
|
crawlSessionId: string;
|
||||||
|
intensity: 'low' | 'medium' | 'high';
|
||||||
|
seed: number;
|
||||||
|
state: IState;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface RunFuzzResponse {
|
||||||
|
fuzzSessionId: string;
|
||||||
|
actionsGenerated: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
export class RunFuzzCommand implements UseCase<RunFuzzRequest, RunFuzzResponse, string> {
|
||||||
|
constructor(
|
||||||
|
private readonly fuzzerEngine: IFuzzerEngine,
|
||||||
|
private readonly repository: IFuzzSessionRepository,
|
||||||
|
private readonly eventBus: EventBus
|
||||||
|
) {}
|
||||||
|
|
||||||
|
async execute(request: RunFuzzRequest): Promise<Result<RunFuzzResponse, string>> {
|
||||||
|
const sessionResult = FuzzSession.create({
|
||||||
|
crawlSessionId: request.crawlSessionId,
|
||||||
|
intensity: request.intensity,
|
||||||
|
seed: request.seed,
|
||||||
|
});
|
||||||
|
|
||||||
|
if (!sessionResult.ok) {
|
||||||
|
return Err(sessionResult.error);
|
||||||
|
}
|
||||||
|
|
||||||
|
const session = sessionResult.value;
|
||||||
|
await this.repository.save(session);
|
||||||
|
|
||||||
|
const actions = this.fuzzerEngine.generateFuzzActions(request.state.domSnapshot, request.state);
|
||||||
|
|
||||||
|
for (const _action of actions) {
|
||||||
|
session.incrementActions();
|
||||||
|
}
|
||||||
|
|
||||||
|
session.complete();
|
||||||
|
await this.repository.update(session);
|
||||||
|
|
||||||
|
for (const event of session.domainEvents) {
|
||||||
|
await this.eventBus.publish(event);
|
||||||
|
}
|
||||||
|
session.clearEvents();
|
||||||
|
|
||||||
|
return Ok({
|
||||||
|
fuzzSessionId: session.id.toString(),
|
||||||
|
actionsGenerated: actions.length,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,31 @@
|
|||||||
|
import { EventHandler } from '../../../../shared/application/EventHandler';
|
||||||
|
import { DomainEvent } from '../../../../shared/domain/DomainEvent';
|
||||||
|
import { RunFuzzCommand } from '../commands/RunFuzzCommand';
|
||||||
|
import { IAction, IState } from '../../../../core/interfaces';
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Listens for action_executed events from crawling module
|
||||||
|
* and triggers fuzzing on the resulting state's DOM.
|
||||||
|
*/
|
||||||
|
export class OnActionExecuted implements EventHandler {
|
||||||
|
constructor(private readonly runFuzz: RunFuzzCommand) {}
|
||||||
|
|
||||||
|
async handle(event: DomainEvent): Promise<void> {
|
||||||
|
const payload = event.payload as {
|
||||||
|
action?: IAction;
|
||||||
|
state?: IState;
|
||||||
|
sessionId?: string;
|
||||||
|
intensity?: 'low' | 'medium' | 'high';
|
||||||
|
};
|
||||||
|
|
||||||
|
if (!payload.state || !payload.sessionId) return;
|
||||||
|
if (!payload.state.domSnapshot) return;
|
||||||
|
|
||||||
|
await this.runFuzz.execute({
|
||||||
|
crawlSessionId: payload.sessionId,
|
||||||
|
intensity: payload.intensity ?? 'low',
|
||||||
|
seed: payload.action?.seed ?? Date.now(),
|
||||||
|
state: payload.state,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
34
src/modules/fuzzing/domain/entities/FuzzResult.ts
Normal file
34
src/modules/fuzzing/domain/entities/FuzzResult.ts
Normal file
@@ -0,0 +1,34 @@
|
|||||||
|
import { Entity } from '../../../../shared/domain/Entity';
|
||||||
|
import { UniqueId } from '../../../../shared/domain/UniqueId';
|
||||||
|
|
||||||
|
export interface FuzzResultProps {
|
||||||
|
sessionId: string;
|
||||||
|
stateId: string;
|
||||||
|
selector: string;
|
||||||
|
payload: string;
|
||||||
|
strategy: string;
|
||||||
|
anomalyType: string;
|
||||||
|
severity: 'low' | 'medium' | 'high' | 'critical';
|
||||||
|
description: string;
|
||||||
|
detectedAt: Date;
|
||||||
|
}
|
||||||
|
|
||||||
|
export class FuzzResult extends Entity<FuzzResultProps> {
|
||||||
|
static create(props: Omit<FuzzResultProps, 'detectedAt'>, id?: UniqueId): FuzzResult {
|
||||||
|
return new FuzzResult({ ...props, detectedAt: new Date() }, id);
|
||||||
|
}
|
||||||
|
|
||||||
|
static reconstitute(props: FuzzResultProps, id: UniqueId): FuzzResult {
|
||||||
|
return new FuzzResult(props, id);
|
||||||
|
}
|
||||||
|
|
||||||
|
get sessionId(): string { return this.props.sessionId; }
|
||||||
|
get stateId(): string { return this.props.stateId; }
|
||||||
|
get selector(): string { return this.props.selector; }
|
||||||
|
get payload(): string { return this.props.payload; }
|
||||||
|
get strategy(): string { return this.props.strategy; }
|
||||||
|
get anomalyType(): string { return this.props.anomalyType; }
|
||||||
|
get severity(): 'low' | 'medium' | 'high' | 'critical' { return this.props.severity; }
|
||||||
|
get description(): string { return this.props.description; }
|
||||||
|
get detectedAt(): Date { return this.props.detectedAt; }
|
||||||
|
}
|
||||||
131
src/modules/fuzzing/domain/entities/FuzzSession.ts
Normal file
131
src/modules/fuzzing/domain/entities/FuzzSession.ts
Normal file
@@ -0,0 +1,131 @@
|
|||||||
|
import { AggregateRoot } from '../../../../shared/domain/AggregateRoot';
|
||||||
|
import { UniqueId } from '../../../../shared/domain/UniqueId';
|
||||||
|
import { Result, Ok, Err } from '../../../../shared/domain/Result';
|
||||||
|
import { FuzzIntensity } from '../value-objects/FuzzIntensity';
|
||||||
|
import { Seed } from '../value-objects/Seed';
|
||||||
|
import { FuzzStarted } from '../events/FuzzStarted';
|
||||||
|
import { FuzzCompleted } from '../events/FuzzCompleted';
|
||||||
|
import { VulnerabilityDetected } from '../events/VulnerabilityDetected';
|
||||||
|
import { FuzzResult } from './FuzzResult';
|
||||||
|
|
||||||
|
type FuzzSessionStatus = 'running' | 'completed' | 'failed';
|
||||||
|
|
||||||
|
export interface FuzzSessionProps {
|
||||||
|
crawlSessionId: string;
|
||||||
|
intensity: FuzzIntensity;
|
||||||
|
seed: Seed;
|
||||||
|
status: FuzzSessionStatus;
|
||||||
|
actionsExecuted: number;
|
||||||
|
vulnerabilitiesFound: number;
|
||||||
|
startedAt: Date;
|
||||||
|
completedAt?: Date;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface CreateFuzzSessionRequest {
|
||||||
|
crawlSessionId: string;
|
||||||
|
intensity: 'low' | 'medium' | 'high';
|
||||||
|
seed: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
export class FuzzSession extends AggregateRoot<FuzzSessionProps> {
|
||||||
|
private constructor(props: FuzzSessionProps, id?: UniqueId) {
|
||||||
|
super(props, id);
|
||||||
|
}
|
||||||
|
|
||||||
|
static reconstitute(props: FuzzSessionProps, id: UniqueId): FuzzSession {
|
||||||
|
return new FuzzSession(props, id);
|
||||||
|
}
|
||||||
|
|
||||||
|
static create(request: CreateFuzzSessionRequest): Result<FuzzSession, string> {
|
||||||
|
let intensity: FuzzIntensity;
|
||||||
|
try {
|
||||||
|
intensity = FuzzIntensity.fromString(request.intensity);
|
||||||
|
} catch (e) {
|
||||||
|
return Err((e as Error).message);
|
||||||
|
}
|
||||||
|
|
||||||
|
let seed: Seed;
|
||||||
|
try {
|
||||||
|
seed = Seed.create(request.seed);
|
||||||
|
} catch (e) {
|
||||||
|
return Err((e as Error).message);
|
||||||
|
}
|
||||||
|
|
||||||
|
const props: FuzzSessionProps = {
|
||||||
|
crawlSessionId: request.crawlSessionId,
|
||||||
|
intensity,
|
||||||
|
seed,
|
||||||
|
status: 'running',
|
||||||
|
actionsExecuted: 0,
|
||||||
|
vulnerabilitiesFound: 0,
|
||||||
|
startedAt: new Date(),
|
||||||
|
};
|
||||||
|
|
||||||
|
const session = new FuzzSession(props);
|
||||||
|
session.addDomainEvent(
|
||||||
|
new FuzzStarted(session.id.toString(), {
|
||||||
|
crawlSessionId: request.crawlSessionId,
|
||||||
|
intensity: request.intensity,
|
||||||
|
seed: request.seed,
|
||||||
|
})
|
||||||
|
);
|
||||||
|
|
||||||
|
return Ok(session);
|
||||||
|
}
|
||||||
|
|
||||||
|
get crawlSessionId(): string { return this.props.crawlSessionId; }
|
||||||
|
get intensity(): FuzzIntensity { return this.props.intensity; }
|
||||||
|
get seed(): Seed { return this.props.seed; }
|
||||||
|
get status(): FuzzSessionStatus { return this.props.status; }
|
||||||
|
get actionsExecuted(): number { return this.props.actionsExecuted; }
|
||||||
|
get vulnerabilitiesFound(): number { return this.props.vulnerabilitiesFound; }
|
||||||
|
get startedAt(): Date { return this.props.startedAt; }
|
||||||
|
get completedAt(): Date | undefined { return this.props.completedAt; }
|
||||||
|
|
||||||
|
recordVulnerability(result: FuzzResult): void {
|
||||||
|
this.props = {
|
||||||
|
...this.props,
|
||||||
|
actionsExecuted: this.props.actionsExecuted + 1,
|
||||||
|
vulnerabilitiesFound: this.props.vulnerabilitiesFound + 1,
|
||||||
|
};
|
||||||
|
this.addDomainEvent(
|
||||||
|
new VulnerabilityDetected(this.id.toString(), {
|
||||||
|
crawlSessionId: this.props.crawlSessionId,
|
||||||
|
stateId: result.stateId,
|
||||||
|
anomalyType: result.anomalyType,
|
||||||
|
severity: result.severity,
|
||||||
|
selector: result.selector,
|
||||||
|
payload: result.payload,
|
||||||
|
strategy: result.strategy,
|
||||||
|
})
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
incrementActions(): void {
|
||||||
|
this.props = { ...this.props, actionsExecuted: this.props.actionsExecuted + 1 };
|
||||||
|
}
|
||||||
|
|
||||||
|
complete(): void {
|
||||||
|
this.props = { ...this.props, status: 'completed', completedAt: new Date() };
|
||||||
|
this.addDomainEvent(
|
||||||
|
new FuzzCompleted(this.id.toString(), {
|
||||||
|
crawlSessionId: this.props.crawlSessionId,
|
||||||
|
actionsExecuted: this.props.actionsExecuted,
|
||||||
|
vulnerabilitiesFound: this.props.vulnerabilitiesFound,
|
||||||
|
})
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
fail(reason: string): void {
|
||||||
|
this.props = { ...this.props, status: 'failed', completedAt: new Date() };
|
||||||
|
this.addDomainEvent(
|
||||||
|
new FuzzCompleted(this.id.toString(), {
|
||||||
|
crawlSessionId: this.props.crawlSessionId,
|
||||||
|
actionsExecuted: this.props.actionsExecuted,
|
||||||
|
vulnerabilitiesFound: this.props.vulnerabilitiesFound,
|
||||||
|
failed: true,
|
||||||
|
reason,
|
||||||
|
})
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
13
src/modules/fuzzing/domain/events/FuzzCompleted.ts
Normal file
13
src/modules/fuzzing/domain/events/FuzzCompleted.ts
Normal file
@@ -0,0 +1,13 @@
|
|||||||
|
import { randomUUID } from 'crypto';
|
||||||
|
import { DomainEvent } from '../../../../shared/domain/DomainEvent';
|
||||||
|
|
||||||
|
export class FuzzCompleted implements DomainEvent {
|
||||||
|
readonly eventId = randomUUID();
|
||||||
|
readonly eventName = 'fuzz.completed';
|
||||||
|
readonly occurredOn = new Date();
|
||||||
|
|
||||||
|
constructor(
|
||||||
|
readonly aggregateId: string,
|
||||||
|
readonly payload: Record<string, unknown>
|
||||||
|
) {}
|
||||||
|
}
|
||||||
13
src/modules/fuzzing/domain/events/FuzzStarted.ts
Normal file
13
src/modules/fuzzing/domain/events/FuzzStarted.ts
Normal file
@@ -0,0 +1,13 @@
|
|||||||
|
import { randomUUID } from 'crypto';
|
||||||
|
import { DomainEvent } from '../../../../shared/domain/DomainEvent';
|
||||||
|
|
||||||
|
export class FuzzStarted implements DomainEvent {
|
||||||
|
readonly eventId = randomUUID();
|
||||||
|
readonly eventName = 'fuzz.started';
|
||||||
|
readonly occurredOn = new Date();
|
||||||
|
|
||||||
|
constructor(
|
||||||
|
readonly aggregateId: string,
|
||||||
|
readonly payload: Record<string, unknown>
|
||||||
|
) {}
|
||||||
|
}
|
||||||
13
src/modules/fuzzing/domain/events/VulnerabilityDetected.ts
Normal file
13
src/modules/fuzzing/domain/events/VulnerabilityDetected.ts
Normal file
@@ -0,0 +1,13 @@
|
|||||||
|
import { randomUUID } from 'crypto';
|
||||||
|
import { DomainEvent } from '../../../../shared/domain/DomainEvent';
|
||||||
|
|
||||||
|
export class VulnerabilityDetected implements DomainEvent {
|
||||||
|
readonly eventId = randomUUID();
|
||||||
|
readonly eventName = 'fuzz.vulnerability_detected';
|
||||||
|
readonly occurredOn = new Date();
|
||||||
|
|
||||||
|
constructor(
|
||||||
|
readonly aggregateId: string,
|
||||||
|
readonly payload: Record<string, unknown>
|
||||||
|
) {}
|
||||||
|
}
|
||||||
6
src/modules/fuzzing/domain/ports/IFuzzerEngine.ts
Normal file
6
src/modules/fuzzing/domain/ports/IFuzzerEngine.ts
Normal file
@@ -0,0 +1,6 @@
|
|||||||
|
import { IAction, IState } from '../../../../core/interfaces';
|
||||||
|
|
||||||
|
export interface IFuzzerEngine {
|
||||||
|
/** Generate fuzz fill actions for a DOM snapshot at a given state */
|
||||||
|
generateFuzzActions(domSnapshot: string, state: IState): IAction[];
|
||||||
|
}
|
||||||
24
src/modules/fuzzing/domain/value-objects/FuzzIntensity.ts
Normal file
24
src/modules/fuzzing/domain/value-objects/FuzzIntensity.ts
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
import { ValueObject } from '../../../../shared/domain/ValueObject';
|
||||||
|
|
||||||
|
type IntensityLevel = 'low' | 'medium' | 'high';
|
||||||
|
|
||||||
|
interface FuzzIntensityProps {
|
||||||
|
value: IntensityLevel;
|
||||||
|
}
|
||||||
|
|
||||||
|
export class FuzzIntensity extends ValueObject<FuzzIntensityProps> {
|
||||||
|
static readonly LEVELS: IntensityLevel[] = ['low', 'medium', 'high'];
|
||||||
|
|
||||||
|
static low(): FuzzIntensity { return new FuzzIntensity({ value: 'low' }); }
|
||||||
|
static medium(): FuzzIntensity { return new FuzzIntensity({ value: 'medium' }); }
|
||||||
|
static high(): FuzzIntensity { return new FuzzIntensity({ value: 'high' }); }
|
||||||
|
|
||||||
|
static fromString(s: string): FuzzIntensity {
|
||||||
|
if (!FuzzIntensity.LEVELS.includes(s as IntensityLevel)) {
|
||||||
|
throw new Error(`Invalid intensity: ${s}. Must be one of: ${FuzzIntensity.LEVELS.join(', ')}`);
|
||||||
|
}
|
||||||
|
return new FuzzIntensity({ value: s as IntensityLevel });
|
||||||
|
}
|
||||||
|
|
||||||
|
get value(): IntensityLevel { return this.props.value; }
|
||||||
|
}
|
||||||
15
src/modules/fuzzing/domain/value-objects/FuzzPayload.ts
Normal file
15
src/modules/fuzzing/domain/value-objects/FuzzPayload.ts
Normal file
@@ -0,0 +1,15 @@
|
|||||||
|
import { ValueObject } from '../../../../shared/domain/ValueObject';
|
||||||
|
|
||||||
|
interface FuzzPayloadProps {
|
||||||
|
value: string;
|
||||||
|
strategy: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export class FuzzPayload extends ValueObject<FuzzPayloadProps> {
|
||||||
|
static create(value: string, strategy: string): FuzzPayload {
|
||||||
|
return new FuzzPayload({ value, strategy });
|
||||||
|
}
|
||||||
|
|
||||||
|
get value(): string { return this.props.value; }
|
||||||
|
get strategy(): string { return this.props.strategy; }
|
||||||
|
}
|
||||||
26
src/modules/fuzzing/domain/value-objects/FuzzStrategy.ts
Normal file
26
src/modules/fuzzing/domain/value-objects/FuzzStrategy.ts
Normal file
@@ -0,0 +1,26 @@
|
|||||||
|
import { ValueObject } from '../../../../shared/domain/ValueObject';
|
||||||
|
|
||||||
|
type StrategyName = 'empty' | 'oversized' | 'special_chars' | 'type_mismatch' | 'boundary';
|
||||||
|
|
||||||
|
interface FuzzStrategyProps {
|
||||||
|
value: StrategyName;
|
||||||
|
}
|
||||||
|
|
||||||
|
export class FuzzStrategy extends ValueObject<FuzzStrategyProps> {
|
||||||
|
static readonly ALL: StrategyName[] = ['empty', 'oversized', 'special_chars', 'type_mismatch', 'boundary'];
|
||||||
|
|
||||||
|
static empty(): FuzzStrategy { return new FuzzStrategy({ value: 'empty' }); }
|
||||||
|
static oversized(): FuzzStrategy { return new FuzzStrategy({ value: 'oversized' }); }
|
||||||
|
static specialChars(): FuzzStrategy { return new FuzzStrategy({ value: 'special_chars' }); }
|
||||||
|
static typeMismatch(): FuzzStrategy { return new FuzzStrategy({ value: 'type_mismatch' }); }
|
||||||
|
static boundary(): FuzzStrategy { return new FuzzStrategy({ value: 'boundary' }); }
|
||||||
|
|
||||||
|
static fromString(s: string): FuzzStrategy {
|
||||||
|
if (!FuzzStrategy.ALL.includes(s as StrategyName)) {
|
||||||
|
throw new Error(`Invalid fuzz strategy: ${s}`);
|
||||||
|
}
|
||||||
|
return new FuzzStrategy({ value: s as StrategyName });
|
||||||
|
}
|
||||||
|
|
||||||
|
get value(): StrategyName { return this.props.value; }
|
||||||
|
}
|
||||||
20
src/modules/fuzzing/domain/value-objects/Seed.ts
Normal file
20
src/modules/fuzzing/domain/value-objects/Seed.ts
Normal file
@@ -0,0 +1,20 @@
|
|||||||
|
import { ValueObject } from '../../../../shared/domain/ValueObject';
|
||||||
|
|
||||||
|
interface SeedProps {
|
||||||
|
value: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
export class Seed extends ValueObject<SeedProps> {
|
||||||
|
static create(value: number): Seed {
|
||||||
|
if (!Number.isInteger(value) || value < 0) {
|
||||||
|
throw new Error(`Seed must be a non-negative integer, got: ${value}`);
|
||||||
|
}
|
||||||
|
return new Seed({ value });
|
||||||
|
}
|
||||||
|
|
||||||
|
static fromTimestamp(): Seed {
|
||||||
|
return new Seed({ value: Date.now() });
|
||||||
|
}
|
||||||
|
|
||||||
|
get value(): number { return this.props.value; }
|
||||||
|
}
|
||||||
17
src/modules/fuzzing/index.ts
Normal file
17
src/modules/fuzzing/index.ts
Normal file
@@ -0,0 +1,17 @@
|
|||||||
|
// Domain
|
||||||
|
export { FuzzSession } from './domain/entities/FuzzSession';
|
||||||
|
export { FuzzResult } from './domain/entities/FuzzResult';
|
||||||
|
export { FuzzIntensity } from './domain/value-objects/FuzzIntensity';
|
||||||
|
export { FuzzStrategy } from './domain/value-objects/FuzzStrategy';
|
||||||
|
export { FuzzPayload } from './domain/value-objects/FuzzPayload';
|
||||||
|
export { Seed } from './domain/value-objects/Seed';
|
||||||
|
export type { IFuzzerEngine } from './domain/ports/IFuzzerEngine';
|
||||||
|
|
||||||
|
// Application
|
||||||
|
export { RunFuzzCommand } from './application/commands/RunFuzzCommand';
|
||||||
|
export type { IFuzzSessionRepository } from './application/commands/RunFuzzCommand';
|
||||||
|
export { OnActionExecuted } from './application/event-handlers/OnActionExecuted';
|
||||||
|
|
||||||
|
// Infrastructure
|
||||||
|
export { FuzzingEngineAdapter } from './infrastructure/adapters/FuzzingEngineAdapter';
|
||||||
|
export { createFuzzingRouter } from './infrastructure/http/FuzzingController';
|
||||||
@@ -0,0 +1,121 @@
|
|||||||
|
/**
|
||||||
|
* FuzzingEngineAdapter — implements IFuzzerEngine port using the 5 fuzzing strategies.
|
||||||
|
* Adapts the legacy FuzzingEngine logic to the hexagonal architecture.
|
||||||
|
*/
|
||||||
|
|
||||||
|
import * as crypto from 'crypto';
|
||||||
|
import { IAction, IState } from '../../../../core/interfaces';
|
||||||
|
import { IFuzzerEngine } from '../../domain/ports/IFuzzerEngine';
|
||||||
|
import { detectInputType, DetectedInputType } from './InputTypeDetector';
|
||||||
|
import { EmptyValueStrategy } from '../strategies/EmptyValueStrategy';
|
||||||
|
import { OversizedStringStrategy } from '../strategies/OversizedStringStrategy';
|
||||||
|
import { SpecialCharsStrategy } from '../strategies/SpecialCharsStrategy';
|
||||||
|
import { TypeMismatchStrategy } from '../strategies/TypeMismatchStrategy';
|
||||||
|
import { BoundaryValueStrategy } from '../strategies/BoundaryValueStrategy';
|
||||||
|
|
||||||
|
interface FormField {
|
||||||
|
selector: string;
|
||||||
|
tagName: string;
|
||||||
|
inputType?: string;
|
||||||
|
name?: string;
|
||||||
|
placeholder?: string;
|
||||||
|
ariaLabel?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
const INPUT_RE = /<(input|textarea|select)[^>]*>/gi;
|
||||||
|
const ATTR_RE = (name: string): RegExp => new RegExp(`${name}="([^"]*)"`, 'i');
|
||||||
|
|
||||||
|
function extractFields(domSnapshot: string): FormField[] {
|
||||||
|
const fields: FormField[] = [];
|
||||||
|
let match: RegExpExecArray | null;
|
||||||
|
while ((match = INPUT_RE.exec(domSnapshot)) !== null) {
|
||||||
|
const tag = match[0] ?? '';
|
||||||
|
const tagName = match[1] ?? 'input';
|
||||||
|
const idMatch = ATTR_RE('id').exec(tag);
|
||||||
|
const nameMatch = ATTR_RE('name').exec(tag);
|
||||||
|
const typeMatch = ATTR_RE('type').exec(tag);
|
||||||
|
const placeholderMatch = ATTR_RE('placeholder').exec(tag);
|
||||||
|
const ariaMatch = ATTR_RE('aria-label').exec(tag);
|
||||||
|
|
||||||
|
const selector = idMatch?.[1]
|
||||||
|
? `#${idMatch[1]}`
|
||||||
|
: nameMatch?.[1]
|
||||||
|
? `[name="${nameMatch[1]}"]`
|
||||||
|
: tagName;
|
||||||
|
|
||||||
|
fields.push({
|
||||||
|
selector,
|
||||||
|
tagName,
|
||||||
|
inputType: typeMatch?.[1],
|
||||||
|
name: nameMatch?.[1],
|
||||||
|
placeholder: placeholderMatch?.[1],
|
||||||
|
ariaLabel: ariaMatch?.[1],
|
||||||
|
});
|
||||||
|
}
|
||||||
|
return fields;
|
||||||
|
}
|
||||||
|
|
||||||
|
type FuzzingStrategy = {
|
||||||
|
name: string;
|
||||||
|
appliesTo(type: DetectedInputType): boolean;
|
||||||
|
values(type?: DetectedInputType): string[];
|
||||||
|
};
|
||||||
|
|
||||||
|
export class FuzzingEngineAdapter implements IFuzzerEngine {
|
||||||
|
private readonly intensity: 'low' | 'medium' | 'high';
|
||||||
|
private readonly seed: number;
|
||||||
|
|
||||||
|
constructor(config: { intensity: 'low' | 'medium' | 'high'; seed: number }) {
|
||||||
|
this.intensity = config.intensity;
|
||||||
|
this.seed = config.seed;
|
||||||
|
}
|
||||||
|
|
||||||
|
generateFuzzActions(domSnapshot: string, state: IState): IAction[] {
|
||||||
|
const fields = extractFields(domSnapshot);
|
||||||
|
const actions: IAction[] = [];
|
||||||
|
const now = Date.now();
|
||||||
|
const strategies = this.selectStrategies();
|
||||||
|
|
||||||
|
for (const field of fields) {
|
||||||
|
const detectedType = detectInputType({
|
||||||
|
tagName: field.tagName,
|
||||||
|
inputType: field.inputType,
|
||||||
|
name: field.name,
|
||||||
|
placeholder: field.placeholder,
|
||||||
|
ariaLabel: field.ariaLabel,
|
||||||
|
});
|
||||||
|
|
||||||
|
for (const strategy of strategies) {
|
||||||
|
if (!strategy.appliesTo(detectedType)) continue;
|
||||||
|
const values = strategy.values(detectedType);
|
||||||
|
for (const value of values) {
|
||||||
|
actions.push({
|
||||||
|
id: crypto.randomUUID(),
|
||||||
|
type: 'fill',
|
||||||
|
selector: field.selector,
|
||||||
|
value,
|
||||||
|
timestamp: now,
|
||||||
|
seed: this.seed,
|
||||||
|
stateId: state.id,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return actions;
|
||||||
|
}
|
||||||
|
|
||||||
|
private selectStrategies(): FuzzingStrategy[] {
|
||||||
|
const empty = new EmptyValueStrategy();
|
||||||
|
const typeMismatch = new TypeMismatchStrategy();
|
||||||
|
const oversized = new OversizedStringStrategy(this.intensity);
|
||||||
|
const boundary = new BoundaryValueStrategy();
|
||||||
|
const special = new SpecialCharsStrategy();
|
||||||
|
|
||||||
|
switch (this.intensity) {
|
||||||
|
case 'low': return [empty, typeMismatch];
|
||||||
|
case 'medium': return [empty, typeMismatch, oversized, boundary];
|
||||||
|
case 'high': return [empty, typeMismatch, oversized, boundary, special];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,41 @@
|
|||||||
|
import { DetectedInputType } from '../strategies/EmptyValueStrategy';
|
||||||
|
|
||||||
|
export type { DetectedInputType };
|
||||||
|
|
||||||
|
export function detectInputType(attrs: {
|
||||||
|
tagName?: string;
|
||||||
|
inputType?: string;
|
||||||
|
name?: string;
|
||||||
|
placeholder?: string;
|
||||||
|
ariaLabel?: string;
|
||||||
|
}): DetectedInputType {
|
||||||
|
const tag = (attrs.tagName ?? '').toLowerCase();
|
||||||
|
if (tag === 'textarea') return 'textarea';
|
||||||
|
if (tag === 'select') return 'select';
|
||||||
|
|
||||||
|
const inputType = (attrs.inputType ?? '').toLowerCase();
|
||||||
|
if (inputType === 'email') return 'email';
|
||||||
|
if (inputType === 'password') return 'password';
|
||||||
|
if (inputType === 'number') return 'number';
|
||||||
|
if (inputType === 'date') return 'date';
|
||||||
|
if (inputType === 'tel') return 'phone';
|
||||||
|
if (inputType === 'url') return 'url';
|
||||||
|
if (inputType === 'search') return 'search';
|
||||||
|
if (inputType === 'file') return 'file';
|
||||||
|
|
||||||
|
const hints = [
|
||||||
|
(attrs.name ?? '').toLowerCase(),
|
||||||
|
(attrs.placeholder ?? '').toLowerCase(),
|
||||||
|
(attrs.ariaLabel ?? '').toLowerCase(),
|
||||||
|
].join(' ');
|
||||||
|
|
||||||
|
if (/email/.test(hints)) return 'email';
|
||||||
|
if (/password|pass/.test(hints)) return 'password';
|
||||||
|
if (/phone|tel|mobile/.test(hints)) return 'phone';
|
||||||
|
if (/date|birth|dob/.test(hints)) return 'date';
|
||||||
|
if (/number|qty|quantity|age/.test(hints)) return 'number';
|
||||||
|
if (/search/.test(hints)) return 'search';
|
||||||
|
if (/url|website|link/.test(hints)) return 'url';
|
||||||
|
|
||||||
|
return 'text';
|
||||||
|
}
|
||||||
71
src/modules/fuzzing/infrastructure/http/FuzzingController.ts
Normal file
71
src/modules/fuzzing/infrastructure/http/FuzzingController.ts
Normal file
@@ -0,0 +1,71 @@
|
|||||||
|
import { Router, Request, Response } from 'express';
|
||||||
|
import { RunFuzzCommand, IFuzzSessionRepository } from '../../application/commands/RunFuzzCommand';
|
||||||
|
import { FuzzSession } from '../../domain/entities/FuzzSession';
|
||||||
|
import { IState } from '../../../../core/interfaces';
|
||||||
|
|
||||||
|
export interface FuzzingControllerDeps {
|
||||||
|
runFuzz: RunFuzzCommand;
|
||||||
|
repository: IFuzzSessionRepository;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function createFuzzingRouter(deps: FuzzingControllerDeps): Router {
|
||||||
|
const router = Router();
|
||||||
|
|
||||||
|
// POST /api/fuzz/run — trigger fuzzing for a given state
|
||||||
|
router.post('/run', async (req: Request, res: Response) => {
|
||||||
|
const { crawlSessionId, intensity, seed, state } = req.body as {
|
||||||
|
crawlSessionId?: string;
|
||||||
|
intensity?: 'low' | 'medium' | 'high';
|
||||||
|
seed?: number;
|
||||||
|
state?: IState;
|
||||||
|
};
|
||||||
|
|
||||||
|
if (!crawlSessionId || !state) {
|
||||||
|
res.status(400).json({ error: 'crawlSessionId and state are required' });
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
const result = await deps.runFuzz.execute({
|
||||||
|
crawlSessionId,
|
||||||
|
intensity: intensity ?? 'low',
|
||||||
|
seed: seed ?? Date.now(),
|
||||||
|
state,
|
||||||
|
});
|
||||||
|
|
||||||
|
if (!result.ok) {
|
||||||
|
res.status(422).json({ error: result.error });
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
res.status(201).json(result.value);
|
||||||
|
});
|
||||||
|
|
||||||
|
// GET /api/fuzz/sessions/:id — get fuzz session
|
||||||
|
router.get('/sessions/:id', async (req: Request, res: Response) => {
|
||||||
|
const sessionId = req.params['id'] as string;
|
||||||
|
const session = await deps.repository.findById(sessionId);
|
||||||
|
|
||||||
|
if (!session) {
|
||||||
|
res.status(404).json({ error: 'Fuzz session not found' });
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
res.json(toDTO(session));
|
||||||
|
});
|
||||||
|
|
||||||
|
return router;
|
||||||
|
}
|
||||||
|
|
||||||
|
function toDTO(s: FuzzSession) {
|
||||||
|
return {
|
||||||
|
id: s.id.toString(),
|
||||||
|
crawlSessionId: s.crawlSessionId,
|
||||||
|
intensity: s.intensity.value,
|
||||||
|
seed: s.seed.value,
|
||||||
|
status: s.status,
|
||||||
|
actionsExecuted: s.actionsExecuted,
|
||||||
|
vulnerabilitiesFound: s.vulnerabilitiesFound,
|
||||||
|
startedAt: s.startedAt.toISOString(),
|
||||||
|
completedAt: s.completedAt?.toISOString() ?? null,
|
||||||
|
};
|
||||||
|
}
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
import { DetectedInputType } from './EmptyValueStrategy';
|
||||||
|
|
||||||
|
export class BoundaryValueStrategy {
|
||||||
|
readonly name = 'BoundaryValueStrategy';
|
||||||
|
|
||||||
|
appliesTo(type: DetectedInputType): boolean {
|
||||||
|
return type === 'number' || type === 'date';
|
||||||
|
}
|
||||||
|
|
||||||
|
values(type: DetectedInputType): string[] {
|
||||||
|
switch (type) {
|
||||||
|
case 'number': return ['0', '-1', '2147483647', '2147483648', '-2147483648'];
|
||||||
|
case 'date': return ['1900-01-01', '2099-12-31', '1970-01-01'];
|
||||||
|
default: return [];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
export type DetectedInputType =
|
||||||
|
| 'email' | 'password' | 'number' | 'date' | 'phone'
|
||||||
|
| 'url' | 'search' | 'text' | 'textarea' | 'select' | 'file';
|
||||||
|
|
||||||
|
export class EmptyValueStrategy {
|
||||||
|
readonly name = 'EmptyValueStrategy';
|
||||||
|
|
||||||
|
appliesTo(_type: DetectedInputType): boolean {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
values(): string[] {
|
||||||
|
return ['', ' ', '\t'];
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,21 @@
|
|||||||
|
import { DetectedInputType } from './EmptyValueStrategy';
|
||||||
|
|
||||||
|
const APPLICABLE_TYPES: DetectedInputType[] = ['text', 'email', 'password', 'textarea'];
|
||||||
|
|
||||||
|
export class OversizedStringStrategy {
|
||||||
|
readonly name = 'OversizedStringStrategy';
|
||||||
|
|
||||||
|
constructor(private readonly intensity: 'low' | 'medium' | 'high') {}
|
||||||
|
|
||||||
|
appliesTo(type: DetectedInputType): boolean {
|
||||||
|
return APPLICABLE_TYPES.includes(type);
|
||||||
|
}
|
||||||
|
|
||||||
|
values(): string[] {
|
||||||
|
switch (this.intensity) {
|
||||||
|
case 'low': return ['A'.repeat(256)];
|
||||||
|
case 'medium': return ['A'.repeat(1024)];
|
||||||
|
case 'high': return ['A'.repeat(10000) + '日本語テスト𠮷野家'];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,21 @@
|
|||||||
|
import { DetectedInputType } from './EmptyValueStrategy';
|
||||||
|
|
||||||
|
const APPLICABLE_TYPES: DetectedInputType[] = ['text', 'email', 'search', 'textarea'];
|
||||||
|
|
||||||
|
export class SpecialCharsStrategy {
|
||||||
|
readonly name = 'SpecialCharsStrategy';
|
||||||
|
|
||||||
|
appliesTo(type: DetectedInputType): boolean {
|
||||||
|
return APPLICABLE_TYPES.includes(type);
|
||||||
|
}
|
||||||
|
|
||||||
|
values(): string[] {
|
||||||
|
return [
|
||||||
|
"' OR 1=1 --",
|
||||||
|
'<script>alert(1)</script>',
|
||||||
|
'../../etc/passwd',
|
||||||
|
'${7*7}',
|
||||||
|
'\x00\x01\x02',
|
||||||
|
];
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
import { DetectedInputType } from './EmptyValueStrategy';
|
||||||
|
|
||||||
|
export class TypeMismatchStrategy {
|
||||||
|
readonly name = 'TypeMismatchStrategy';
|
||||||
|
|
||||||
|
appliesTo(type: DetectedInputType): boolean {
|
||||||
|
return ['email', 'number', 'date', 'url', 'phone'].includes(type);
|
||||||
|
}
|
||||||
|
|
||||||
|
values(type: DetectedInputType): string[] {
|
||||||
|
switch (type) {
|
||||||
|
case 'email': return ['not-an-email', '12345', '@@@'];
|
||||||
|
case 'number': return ['abc', '-999999', '9.9.9', 'NaN'];
|
||||||
|
case 'date': return ['yesterday', '32/13/2025', '0000-00-00'];
|
||||||
|
case 'url': return ['javascript:alert(1)', 'not a url'];
|
||||||
|
case 'phone': return ['000', '++++', 'abcdefghij'];
|
||||||
|
default: return [];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
319
tests/modules/fuzzing.test.ts
Normal file
319
tests/modules/fuzzing.test.ts
Normal file
@@ -0,0 +1,319 @@
|
|||||||
|
/**
|
||||||
|
* Unit tests for the fuzzing module.
|
||||||
|
*/
|
||||||
|
|
||||||
|
import { FuzzSession } from '../../src/modules/fuzzing/domain/entities/FuzzSession';
|
||||||
|
import { FuzzResult } from '../../src/modules/fuzzing/domain/entities/FuzzResult';
|
||||||
|
import { FuzzIntensity } from '../../src/modules/fuzzing/domain/value-objects/FuzzIntensity';
|
||||||
|
import { FuzzStrategy } from '../../src/modules/fuzzing/domain/value-objects/FuzzStrategy';
|
||||||
|
import { Seed } from '../../src/modules/fuzzing/domain/value-objects/Seed';
|
||||||
|
import { FuzzPayload } from '../../src/modules/fuzzing/domain/value-objects/FuzzPayload';
|
||||||
|
import { EmptyValueStrategy } from '../../src/modules/fuzzing/infrastructure/strategies/EmptyValueStrategy';
|
||||||
|
import { OversizedStringStrategy } from '../../src/modules/fuzzing/infrastructure/strategies/OversizedStringStrategy';
|
||||||
|
import { SpecialCharsStrategy } from '../../src/modules/fuzzing/infrastructure/strategies/SpecialCharsStrategy';
|
||||||
|
import { TypeMismatchStrategy } from '../../src/modules/fuzzing/infrastructure/strategies/TypeMismatchStrategy';
|
||||||
|
import { BoundaryValueStrategy } from '../../src/modules/fuzzing/infrastructure/strategies/BoundaryValueStrategy';
|
||||||
|
import { FuzzingEngineAdapter } from '../../src/modules/fuzzing/infrastructure/adapters/FuzzingEngineAdapter';
|
||||||
|
import { detectInputType } from '../../src/modules/fuzzing/infrastructure/adapters/InputTypeDetector';
|
||||||
|
import { IState } from '../../src/core/interfaces';
|
||||||
|
|
||||||
|
function makeState(domSnapshot = ''): IState {
|
||||||
|
return {
|
||||||
|
id: 'state1',
|
||||||
|
url: 'http://test.com',
|
||||||
|
title: 'Test',
|
||||||
|
timestamp: Date.now(),
|
||||||
|
domSnapshot,
|
||||||
|
visitCount: 1,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
// ─── Value Objects ────────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
describe('FuzzIntensity', () => {
|
||||||
|
it('creates low intensity', () => {
|
||||||
|
expect(FuzzIntensity.low().value).toBe('low');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('creates from string', () => {
|
||||||
|
expect(FuzzIntensity.fromString('high').value).toBe('high');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('throws for invalid intensity', () => {
|
||||||
|
expect(() => FuzzIntensity.fromString('extreme')).toThrow();
|
||||||
|
});
|
||||||
|
|
||||||
|
it('equality works', () => {
|
||||||
|
expect(FuzzIntensity.medium().equals(FuzzIntensity.medium())).toBe(true);
|
||||||
|
expect(FuzzIntensity.low().equals(FuzzIntensity.high())).toBe(false);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('FuzzStrategy', () => {
|
||||||
|
it('creates all strategies', () => {
|
||||||
|
expect(FuzzStrategy.empty().value).toBe('empty');
|
||||||
|
expect(FuzzStrategy.specialChars().value).toBe('special_chars');
|
||||||
|
expect(FuzzStrategy.boundary().value).toBe('boundary');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('throws for invalid strategy', () => {
|
||||||
|
expect(() => FuzzStrategy.fromString('invalid')).toThrow();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('Seed', () => {
|
||||||
|
it('creates valid seed', () => {
|
||||||
|
expect(Seed.create(42).value).toBe(42);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('throws for negative seed', () => {
|
||||||
|
expect(() => Seed.create(-1)).toThrow();
|
||||||
|
});
|
||||||
|
|
||||||
|
it('throws for non-integer', () => {
|
||||||
|
expect(() => Seed.create(1.5)).toThrow();
|
||||||
|
});
|
||||||
|
|
||||||
|
it('creates from timestamp', () => {
|
||||||
|
const seed = Seed.fromTimestamp();
|
||||||
|
expect(seed.value).toBeGreaterThan(0);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('FuzzPayload', () => {
|
||||||
|
it('creates payload with value and strategy', () => {
|
||||||
|
const p = FuzzPayload.create("' OR 1=1 --", 'special_chars');
|
||||||
|
expect(p.value).toBe("' OR 1=1 --");
|
||||||
|
expect(p.strategy).toBe('special_chars');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
// ─── FuzzSession Aggregate ───────────────────────────────────────────────────
|
||||||
|
|
||||||
|
describe('FuzzSession', () => {
|
||||||
|
it('creates a fuzz session with domain event', () => {
|
||||||
|
const result = FuzzSession.create({
|
||||||
|
crawlSessionId: 'crawl-1',
|
||||||
|
intensity: 'medium',
|
||||||
|
seed: 12345,
|
||||||
|
});
|
||||||
|
|
||||||
|
if (!result.ok) throw new Error('Expected Ok');
|
||||||
|
const session = result.value;
|
||||||
|
expect(session.intensity.value).toBe('medium');
|
||||||
|
expect(session.seed.value).toBe(12345);
|
||||||
|
expect(session.status).toBe('running');
|
||||||
|
expect(session.actionsExecuted).toBe(0);
|
||||||
|
expect(session.domainEvents).toHaveLength(1);
|
||||||
|
expect(session.domainEvents[0]!.eventName).toBe('fuzz.started');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('fails with invalid intensity', () => {
|
||||||
|
const result = FuzzSession.create({
|
||||||
|
crawlSessionId: 'crawl-1',
|
||||||
|
intensity: 'extreme' as 'low',
|
||||||
|
seed: 1,
|
||||||
|
});
|
||||||
|
expect(result.ok).toBe(false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('fails with negative seed', () => {
|
||||||
|
const result = FuzzSession.create({
|
||||||
|
crawlSessionId: 'crawl-1',
|
||||||
|
intensity: 'low',
|
||||||
|
seed: -1,
|
||||||
|
});
|
||||||
|
expect(result.ok).toBe(false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('tracks vulnerability detection', () => {
|
||||||
|
const r1 = FuzzSession.create({ crawlSessionId: 'c1', intensity: 'high', seed: 1 });
|
||||||
|
if (!r1.ok) throw new Error('Expected Ok');
|
||||||
|
const session = r1.value;
|
||||||
|
session.clearEvents();
|
||||||
|
|
||||||
|
const fuzzResult = FuzzResult.create({
|
||||||
|
sessionId: session.id.toString(),
|
||||||
|
stateId: 'state1',
|
||||||
|
selector: '#email',
|
||||||
|
payload: "' OR 1=1 --",
|
||||||
|
strategy: 'special_chars',
|
||||||
|
anomalyType: 'xss_reflection',
|
||||||
|
severity: 'critical',
|
||||||
|
description: 'XSS reflected',
|
||||||
|
});
|
||||||
|
|
||||||
|
session.recordVulnerability(fuzzResult);
|
||||||
|
expect(session.vulnerabilitiesFound).toBe(1);
|
||||||
|
expect(session.actionsExecuted).toBe(1);
|
||||||
|
expect(session.domainEvents[0]!.eventName).toBe('fuzz.vulnerability_detected');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('completes session with event', () => {
|
||||||
|
const r2 = FuzzSession.create({ crawlSessionId: 'c1', intensity: 'low', seed: 1 });
|
||||||
|
if (!r2.ok) throw new Error('Expected Ok');
|
||||||
|
const session = r2.value;
|
||||||
|
session.clearEvents();
|
||||||
|
session.complete();
|
||||||
|
expect(session.status).toBe('completed');
|
||||||
|
expect(session.completedAt).toBeDefined();
|
||||||
|
expect(session.domainEvents[0]!.eventName).toBe('fuzz.completed');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
// ─── Strategies ───────────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
describe('EmptyValueStrategy', () => {
|
||||||
|
const s = new EmptyValueStrategy();
|
||||||
|
|
||||||
|
it('applies to all types', () => {
|
||||||
|
expect(s.appliesTo('email')).toBe(true);
|
||||||
|
expect(s.appliesTo('number')).toBe(true);
|
||||||
|
expect(s.appliesTo('select')).toBe(true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('returns empty/whitespace values', () => {
|
||||||
|
const vals = s.values();
|
||||||
|
expect(vals).toContain('');
|
||||||
|
expect(vals).toContain(' ');
|
||||||
|
expect(vals).toContain('\t');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('OversizedStringStrategy', () => {
|
||||||
|
it('applies to text, email, password, textarea', () => {
|
||||||
|
const s = new OversizedStringStrategy('medium');
|
||||||
|
expect(s.appliesTo('text')).toBe(true);
|
||||||
|
expect(s.appliesTo('email')).toBe(true);
|
||||||
|
expect(s.appliesTo('number')).toBe(false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('low = 256 chars', () => {
|
||||||
|
const s = new OversizedStringStrategy('low');
|
||||||
|
expect(s.values()[0]?.length).toBe(256);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('medium = 1024 chars', () => {
|
||||||
|
const s = new OversizedStringStrategy('medium');
|
||||||
|
expect(s.values()[0]?.length).toBe(1024);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('high = 10000+ chars', () => {
|
||||||
|
const s = new OversizedStringStrategy('high');
|
||||||
|
expect(s.values()[0]!.length).toBeGreaterThan(10000);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('SpecialCharsStrategy', () => {
|
||||||
|
const s = new SpecialCharsStrategy();
|
||||||
|
|
||||||
|
it('applies to text, email, search, textarea', () => {
|
||||||
|
expect(s.appliesTo('text')).toBe(true);
|
||||||
|
expect(s.appliesTo('email')).toBe(true);
|
||||||
|
expect(s.appliesTo('number')).toBe(false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('includes SQL injection payload', () => {
|
||||||
|
expect(s.values()).toContain("' OR 1=1 --");
|
||||||
|
});
|
||||||
|
|
||||||
|
it('includes XSS payload', () => {
|
||||||
|
expect(s.values()).toContain('<script>alert(1)</script>');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('TypeMismatchStrategy', () => {
|
||||||
|
const s = new TypeMismatchStrategy();
|
||||||
|
|
||||||
|
it('applies to typed fields', () => {
|
||||||
|
expect(s.appliesTo('email')).toBe(true);
|
||||||
|
expect(s.appliesTo('number')).toBe(true);
|
||||||
|
expect(s.appliesTo('text')).toBe(false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('returns mismatch for email', () => {
|
||||||
|
expect(s.values('email')).toContain('not-an-email');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('returns mismatch for number', () => {
|
||||||
|
expect(s.values('number')).toContain('abc');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('BoundaryValueStrategy', () => {
|
||||||
|
const s = new BoundaryValueStrategy();
|
||||||
|
|
||||||
|
it('applies to number and date only', () => {
|
||||||
|
expect(s.appliesTo('number')).toBe(true);
|
||||||
|
expect(s.appliesTo('date')).toBe(true);
|
||||||
|
expect(s.appliesTo('text')).toBe(false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('returns boundary numbers', () => {
|
||||||
|
const vals = s.values('number');
|
||||||
|
expect(vals).toContain('0');
|
||||||
|
expect(vals).toContain('2147483647');
|
||||||
|
expect(vals).toContain('-2147483648');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('returns boundary dates', () => {
|
||||||
|
const vals = s.values('date');
|
||||||
|
expect(vals).toContain('1900-01-01');
|
||||||
|
expect(vals).toContain('2099-12-31');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
// ─── InputTypeDetector ────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
describe('detectInputType (module adapter)', () => {
|
||||||
|
it('detects email from inputType', () => {
|
||||||
|
expect(detectInputType({ inputType: 'email' })).toBe('email');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('detects password', () => {
|
||||||
|
expect(detectInputType({ inputType: 'password' })).toBe('password');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('detects textarea', () => {
|
||||||
|
expect(detectInputType({ tagName: 'textarea' })).toBe('textarea');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('infers email from name', () => {
|
||||||
|
expect(detectInputType({ name: 'email_address' })).toBe('email');
|
||||||
|
});
|
||||||
|
|
||||||
|
it('falls back to text', () => {
|
||||||
|
expect(detectInputType({})).toBe('text');
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
// ─── FuzzingEngineAdapter ─────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
describe('FuzzingEngineAdapter', () => {
|
||||||
|
it('generates fuzz actions from DOM with input fields', () => {
|
||||||
|
const engine = new FuzzingEngineAdapter({ intensity: 'low', seed: 42 });
|
||||||
|
const dom = `<form><input type="email" name="email" /><input type="password" name="pass" /></form>`;
|
||||||
|
const state = makeState(dom);
|
||||||
|
const actions = engine.generateFuzzActions(dom, state);
|
||||||
|
expect(actions.length).toBeGreaterThan(0);
|
||||||
|
expect(actions.every((a) => a.type === 'fill')).toBe(true);
|
||||||
|
expect(actions.every((a) => a.stateId === 'state1')).toBe(true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('generates more actions at high intensity', () => {
|
||||||
|
const low = new FuzzingEngineAdapter({ intensity: 'low', seed: 1 });
|
||||||
|
const high = new FuzzingEngineAdapter({ intensity: 'high', seed: 1 });
|
||||||
|
const dom = `<input type="text" name="q" />`;
|
||||||
|
const state = makeState(dom);
|
||||||
|
expect(high.generateFuzzActions(dom, state).length).toBeGreaterThan(
|
||||||
|
low.generateFuzzActions(dom, state).length
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('returns empty for DOM with no inputs', () => {
|
||||||
|
const engine = new FuzzingEngineAdapter({ intensity: 'medium', seed: 1 });
|
||||||
|
const dom = `<div><p>No forms here</p></div>`;
|
||||||
|
const state = makeState(dom);
|
||||||
|
expect(engine.generateFuzzActions(dom, state)).toHaveLength(0);
|
||||||
|
});
|
||||||
|
});
|
||||||
Reference in New Issue
Block a user