No entries match these filters. Clear filters
Dalfox adds OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. /Postman spec scanning, actionable confidence filtering with --min-confidence, blind OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. and session-loss parity on server/MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. , per-parameter filter fingerprints in all output formats, repeatable --sxss-url, and SCAN_TIMEOUT error codes.
└──▷ GET THIS VERSIONHomebrew Docker git
Homebrew
copy
$ brew install dalfox
$ brew upgrade dalfox
Docker
copy
$ docker pull ghcr.io/hahwul/dalfox:v3.3.0
git
copy
$ git clone --branch v3.3.0 https://github.com/hahwul/dalfox.git
$ git checkout v3.3.0
Homebrew lists this version · published under the project's GitHub account · checked 10 Nov
New integration Scan OpenAPI 3.x / Swagger 2.0 Swagger 2.0 A JSON/YAML specification format for describing REST APIs, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and request validation from a single machine-readable contract. specs or Postman collections with -i openapi or -i postman, and retarget the server URL with --base-url. Not checked yet Filter findings by confidence across CLI, REST, MCP, --limit, and exit code with --min-confidence <low|high>; meta.min_confidence.dropped prevents filtered targets from appearing clean. Not checked yet Server and MCP now support blind OOB (blind_oob, blind_oob_wait) and session-loss detection (session_check, session_check_url), matching CLI behavior. Not checked yet Findings now include a per-parameter filter fingerprint (allowed, blocked, escaped characters) in every output format. Not checked yet --sxss-url is now repeatable (config key sxss_url takes a list); file-upload injections now target both file content and filename. Not checked yet
+2 more
show less
Targets cut by --scan-timeout report a SCAN_TIMEOUT error code in target_summary and REST/MCP error_message. Not checked yet Per-target state is keyed by URL + method + body; target_summary and meta.skipped gain a method field. Not checked yet
7 details in Everything
Dalfox adds OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. /Postman input modes, --min-confidence filtering, --base-url, URL allow/exclude regex flags, and SARIF SARIF Static Analysis Results Interchange Format, a standard for sharing code-analysis findings, including locations and rule details. It lets scanners report results to a common review interface. output.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Crawl a target for XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. candidates while skipping logout and session-destroy endpoints to avoid side-effects.
copy
$ dalfox url https://example.com --exclude-url /logout --exclude-url /session/destroy
Adds openapi input mode supporting OpenAPI 3.x / Swagger 2.0 Swagger 2.0 A JSON/YAML specification format for describing REST APIs, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and request validation from a single machine-readable contract. in JSON or YAML format, letting Dalfox drive scans directly from API specs.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds postman input mode supporting Postman Collection v2.1, letting Dalfox drive scans from exported Postman collections. Not checked yet Adds --base-url flag (required for openapi and postman modes) to set the scheme, host, port, and path prefix for all requests; must be an absolute http(s) URL. Not checked yet Adds --min-confidence flag accepting low or high to filter detection results by confidence level — high gates only high-confidence findings, low retains all results including uncertain AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. -flow detections. Not checked yet Adds -f sarif output format for reporting findings as SARIF. Not checked yet
+4 more
show less
Adds URL allow-list regex flag to scan only URLs matching a given pattern (partial match, repeatable; also applied to discovered form actions and scripts). Not checked yet Adds URL exclude regex flag to skip URLs matching a given pattern (partial match, repeatable; also applied to discovered form actions and scripts, e.g. --exclude-url /logout avoids touching logout forms). Not checked yet Adds discovery-only mode that crawls and plans without sending XSS payloads. Not checked yet Adds deduplication of requests where URL, method, and body are identical. Not checked yet
9 details in Everything
Dalfox MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. scan jobs gain session-loss detection (session_check, session_check_url), confidence filtering (min_confidence), a warnings result field, and a ~2000-finding cap with partial-results marking.
Adds session_check and session_check_url to MCP scan jobs for session-loss detection; an expired session causes the scan to settle rather than report clean. Not checked yet Adds min_confidence to MCP scan jobs to drop low-confidence findings from results and findings_so_far; omitting the field keeps all findings. Not checked yet Adds a warnings list to MCP scan results for non-fatal conditions such as OAST OAST Out-of-band Application Security Testing: a technique for detecting vulnerabilities by having a target system make DNS or HTTP callbacks to an attacker-controlled server, revealing flaws that produce no visible in-band response. registration failure, session baseline capture failure, or parameter-cap hits. Not checked yet Caps MCP scan jobs at approximately 2000 findings per reflecting-payload scan, marking results as partial when the cap is reached. Not checked yet
4 details in Everything
Dalfox: Adds min_confidence job option to filter low-confidence results server-side, equivalent to CLI's --min-confidence flag.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Submit a server-mode scan job with OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. detection and confidence filtering to surface only high-confidence findings including blind XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. callbacks.
copy
$ curl -X POST https://<dalfox-server>/api/scan \
-H 'Content-Type: application/json' \
-d '{
"target": "https://app/page",
"min_confidence": "high",
"blind_oob": ["oast.fun", "oast.me"],
"blind_oob_wait": 30
}'
Enable session-loss detection on an authenticated scan so Dalfox aborts and flags the result if the session expires mid-scan.
copy
$ curl -X POST https://<dalfox-server>/api/scan \
-H 'Content-Type: application/json' \
-d '{
"target": "https://app/page",
"session_check": "Sign out",
"session_check_url": "https://app/me"
}'
Adds blind_oob job option for managed OAST OAST Out-of-band Application Security Testing: a technique for detecting vulnerabilities by having a target system make DNS or HTTP callbacks to an attacker-controlled server, revealing flaws that produce no visible in-band response. (interactsh) out-of-band detection in server/MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. mode: pass true for the public mesh or a list of hosts (e.g. ["oast.fun","oast.me"]), correlating each callback to its payload and promoting it to a V finding with detection_method: 'oob'. Not checked yet
1 detail in Everything
Dalfox adds --min-confidence to filter low-confidence XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. findings before output, exit codes, and deduplication.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Fail CI only on high-confidence XSS findings, silently dropping speculative results before they reach the exit code or report.
copy
$ dalfox url https://example.com --min-confidence high
Set confidence filtering persistently in the Dalfox config file so every scan run from this config skips low-confidence findings.
yaml
copy
min_confidence: high
Adds --min-confidence high CLI flag to drop low-confidence findings before output, exit codes, per-target counts in target_summary, and deduplication.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds min_confidence key to the config file, REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. , and MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. to apply the same confidence filter declaratively. Not checked yet Adds meta.min_confidence field reporting {level, dropped} in results, so a clean target filtered by confidence can be distinguished from one that found nothing. Not checked yet SARIF SARIF Static Analysis Results Interchange Format, a standard for sharing code-analysis findings, including locations and rule details. It lets scanners report results to a common review interface. output places the confidence grade under properties; SARIF level continues to follow severity. Not checked yet
Adds --min-confidence high CLI flag to drop low-confidence findings before output, exit codes, per-target counts in target_summary, and deduplication.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds min_confidence key to the config file, REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. , and MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. to apply the same confidence filter declaratively. Not checked yet Adds meta.min_confidence field reporting {level, dropped} in results, so a clean target filtered by confidence can be distinguished from one that found nothing. Not checked yet
1 more in Everything
Dalfox 3.2.4 adds --min-confidence filtering and a per-character probe disposition field to findings output.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Gate CI on only high-confidence XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. findings so low-signal results don't block the pipeline — filtered targets still report a distinct envelope field so nothing looks untested.
copy
$ dalfox scan https://target.app --min-confidence high
Adds --min-confidence high flag to drop low-confidence findings before output, exit-code evaluation, and display cutoffs, with meta.min_confidence: {"level": "high", "dropped": N} written to the JSON/JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. envelope so filtered-clean targets are never mistaken for untested ones.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds a per-finding character-disposition field showing how each probed special character was treated — allowed (reflected raw), encoded (HTML entity or %HH), blocked (stripped), or escaped (backslash-escaped) — present on reflection and DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. -verification findings; omitted on AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. , HPP, stored, and OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. findings. Not checked yet Emits a Warning: to stderr naming any flag that silently switches off output when passed on the command line. Not checked yet
3 details in Everything
Dalfox adds OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. 3.x, Swagger 2.0 Swagger 2.0 A JSON/YAML specification format for describing REST APIs, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and request validation from a single machine-readable contract. , and Postman Collection scanning via -i openapi and -i postman flags︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Scan every endpoint in an OpenAPI spec against a staging environment instead of the production server listed in the spec.
copy
$ dalfox scan -i openapi openapi.yaml --base-url https://staging.example.com
Pipe an OpenAPI JSON spec directly into Dalfox in a CI pipeline without writing a temp file.
copy
$ cat openapi.json | dalfox scan -i openapi
Scan a Postman Collection export, redirecting all requests to a staging host to avoid hitting production.
copy
$ dalfox scan -i postman api.postman_collection.json --base-url https://staging.example.com
Adds -i openapi flag to scan every endpoint defined in an OpenAPI 3.x (JSON or YAML) or Swagger 2.0 spec, building targets from paths, methods, query/header/cookie parameters, and request bodies (JSON, form, multipart, XML).︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds -i postman flag to scan every request in a Postman Collection v2.1 export, resolving {{variables}} from the collection's variable list and mapping raw, urlencoded, formdata, and graphql body modes. Not checked yet Adds --base-url flag to redirect OpenAPI or Postman scans to a different deployment (e.g. staging), replacing the spec's scheme, host, and port while preserving the server path. Not checked yet Supports piping specs into the scanner (cat openapi.json | dalfox scan -i openapi), consistent with other input modes. Not checked yet Deduplicates imported targets by URL + method + body, so two POSTs to the same URL with different bodies are both scanned while entries differing only in headers or cookies collapse. Not checked yet
+1 more
show less
Enforces a file size cap (INPUT_TOO_LARGE) and guards against hostile specs with deeply nested or cyclic $ref schemas; only local #/components/... references are followed. Not checked yet
6 details in Everything
Dalfox: Adds openapi and postman scan modes accepting OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. 3.x / Swagger 2.0 Swagger 2.0 A JSON/YAML specification format for describing REST APIs, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and request validation from a single machine-readable contract. (JSON or YAML) and Postman Collection v2.1 as input targets.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Crawl a target but exclude logout and session-destroy paths to avoid invalidating the test session mid-scan.
copy
$ dalfox url https://app.example.com --exclude-url /logout --exclude-url /session/destroy
Supports loading cookies from a raw HTTP request file, replacing same-named cookies from other sources; an unreadable or missing file is fatal. Not checked yet
1 detail in Everything
Dalfox: Adds --min-confidence flag to filter output by detection confidence level.
└──▷ TRY IT
Scan an OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. spec against a staging server, surfacing only high-confidence XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. findings to reduce noise in CI.
copy
$ dalfox openapi ./api-spec.yaml --base-url https://staging.example.com/api/v3 --min-confidence high
Scan a Postman collection scoped to a specific base URL, skipping health-check and metrics endpoints.
copy
$ dalfox postman ./collection.json --base-url https://api.example.com
Adds a URL-allow regex flag that restricts scanning to URLs matching at least one supplied pattern (partial match; repeatable; invalid regex is a startup error). Not checked yet Adds a URL-skip regex flag that skips URLs matching any supplied pattern (partial match; repeatable; invalid regex is a startup error). Not checked yet
2 details in Everything
Dalfox: Adds min_confidence field to server/MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. job config to filter findings by confidence grade, equivalent to CLI's --min-confidence.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Submit a server-mode scan job that drops low-confidence noise, enables managed OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. callback correlation, and detects session expiry mid-scan.
copy
$ curl -X POST https://dalfox-server/scan \
-H 'Content-Type: application/json' \
-d '{
"target": "https://app/search?q=FUZZ",
"min_confidence": "high",
"blind_oob": true,
"blind_oob_wait": 30,
"session_check": "Logged in as",
"session_check_url": "https://app/me"
}'
Use specific OOB servers instead of the public mesh so callbacks stay within your controlled infrastructure.
copy
$ curl -X POST https://dalfox-server/scan \
-H 'Content-Type: application/json' \
-d '{
"target": "https://app/search?q=FUZZ",
"blind_oob": ["oast.fun", "oast.me"],
"blind_oob_wait": 60
}'
Dalfox: Surfaces --scan-timeout cut-short status on targets, distinguishing a timed-out target with no findings from a clean target in output and exit codes.
└──▷ TRY IT
Filter out low-confidence XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. findings in CI so only high-confidence hits trigger a pipeline failure.
copy
$ dalfox scan https://target.app --min-confidence high
Dalfox adds OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. 3.x, Swagger 2.0 Swagger 2.0 A JSON/YAML specification format for describing REST APIs, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and request validation from a single machine-readable contract. , and Postman Collection scanning via -i openapi / -i postman︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Scan every endpoint in an OpenAPI spec against a staging environment instead of the production server listed in the spec.
copy
$ dalfox scan -i openapi openapi.yaml --base-url https://staging.example.com
Feed a Postman collection export into Dalfox to XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. -test every captured API request, overriding the collection's host with a test deployment.
copy
$ dalfox scan -i postman api.postman_collection.json --base-url https://test.example.com
Pipe an OpenAPI spec directly from stdout into Dalfox — useful when the spec is generated on the fly in a CI pipeline.
copy
$ cat openapi.json | dalfox scan -i openapi
Adds dalfox scan -i openapi to scan every endpoint defined in an OpenAPI 3.x (JSON or YAML) or Swagger 2.0 spec, automatically building URLs, path/query/header/cookie parameters, and request bodies (JSON, form, multipart, XML) as injection targets.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds dalfox scan -i postman to scan every request in a Postman Collection v2.1 export, resolving {{variables}} from the collection's variable list and mapping raw, urlencoded, formdata, and graphql body modes. Not checked yet Deduplicates scan targets across HAR HAR An HTTP Archive file, a JSON-format log of all network requests and responses captured by a browser's developer tools, used by cyber tools to replay, inspect, or analyze web traffic without re-running a live session. , raw HTTP, OpenAPI, and Postman modes by URL + method + body, so two POSTs to the same URL with different bodies are both scanned while entries differing only in headers or cookies collapse. Not checked yet Supports piping a spec file into OpenAPI mode (e.g., cat openapi.json | dalfox scan -i openapi) for use in shell pipelines. Not checked yet Fails with PARSE_ERROR only when the document is not a recognisable spec or contains nothing scannable, treating individual bad operations as non-fatal skips. Not checked yet
Adds dalfox scan -i openapi to scan every endpoint defined in an OpenAPI 3.x (JSON or YAML) or Swagger 2.0 spec, automatically building URLs, path/query/header/cookie parameters, and request bodies (JSON, form, multipart, XML) as injection targets.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds dalfox scan -i postman to scan every request in a Postman Collection v2.1 export, resolving {{variables}} from the collection's variable list and mapping raw, urlencoded, formdata, and graphql body modes. Not checked yet Supports piping a spec file into OpenAPI mode (e.g., cat openapi.json | dalfox scan -i openapi) for use in shell pipelines. Not checked yet Fails with PARSE_ERROR only when the document is not a recognisable spec or contains nothing scannable, treating individual bad operations as non-fatal skips. Not checked yet
1 more in Everything
Dalfox: Adds URL exclude-regex filtering: repeat the flag for multiple patterns; any matching URL is skipped; an invalid regex is a startup error.
└──▷ TRY IT
Scan an OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. spec against a staging server, suppressing low-confidence noise so only high-confidence XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. findings fail CI.
copy
$ dalfox openapi ./api-spec.yaml --base-url https://staging.example.com --min-confidence high
Dalfox adds OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. /Postman input modes, --min-confidence filtering, and --base-url for spec-driven scans︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Scan an OpenAPI spec hosted remotely, pointing Dalfox at your staging base URL so every path in the spec gets exercised
copy
$ dalfox openapi https://example.com/openapi.yaml --base-url https://staging.example.com/api/v3
Scan a Postman collection and fail CI only on high-confidence XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. findings, ignoring uncertain AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. -flow results
copy
$ dalfox postman ./collection.json --base-url https://api.example.com --min-confidence high
Adds openapi input mode supporting OpenAPI 3.x / Swagger 2.0 Swagger 2.0 A JSON/YAML specification format for describing REST APIs, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and request validation from a single machine-readable contract. (JSON or YAML) as a scan target source︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds postman input mode supporting Postman Collection v2.1 as a scan target source Not checked yet Adds --base-url flag for openapi and postman modes to set the scheme, host, port, and path prefix for all requests in a spec (must be an absolute http(s) URL) Not checked yet Adds --min-confidence flag to filter scan results by confidence level (low retains all; high gates on high-confidence findings only, dropping low-rated detections and uncertain AST-flow results before printing target_summary, counts, and exit code) Not checked yet
4 details in Everything
Dalfox: Adds min_confidence config key to drop low-confidence findings before output and the exit code; setting it to high suppresses low-confidence results.
└──▷ USE IT
Scan an OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. spec against a staging host, suppressing low-confidence noise so only high-confidence XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. findings affect the exit code.
toml
copy
# dalfox config file
mode = "openapi"
base_url = "https://staging.example.com"
min_confidence = "high"
Dalfox MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. gains blind_oob_wait polling tuning, session_check/session_check_url session-loss detection, min_confidence result filtering, and a warnings list for non-fatal scan conditions.
New detection Adds blind_oob_wait parameter to tune how long OAST OAST Out-of-band Application Security Testing: a technique for detecting vulnerabilities by having a target system make DNS or HTTP callbacks to an attacker-controlled server, revealing flaws that produce no visible in-band response. polling continues after the scan's last request. Not checked yet Adds session_check and session_check_url parameters for session-loss detection without cookies; invalid regex or non-http(s) URL is an error. Not checked yet Adds min_confidence parameter — set to "low" to drop low-confidence findings from results and findings_so_far. Not checked yet Adds a warnings list to scan results for non-fatal conditions such as OAST registration failure or a missed session baseline. Not checked yet Caps reflective (A) scans at approximately 2000 findings and marks results as partial when the limit is reached. Not checked yet
5 details in Everything
Dalfox: Adds min_confidence job option to filter findings by confidence level, equivalent to CLI's --min-confidence flag.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ USE IT
Submit a job with high-confidence-only results and OAST OAST Out-of-band Application Security Testing: a technique for detecting vulnerabilities by having a target system make DNS or HTTP callbacks to an attacker-controlled server, revealing flaws that produce no visible in-band response. OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. detection across two public interactsh servers to catch blind XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. callbacks.
json
copy
{
"url": "https://app/search?q=test",
"max_payloads_per_param": 0,
"min_confidence": "high",
"blind_oob": ["oast.fun", "oast.me"],
"blind_oob_wait": 30
}
Enable session-loss detection on an authenticated scan so an expired session is flagged rather than returning a misleading zero-finding result.
json
copy
{
"url": "https://app/dashboard?ref=test",
"session_check": "Sign out",
"session_check_url": "https://app/me",
"min_confidence": "low"
}
Adds blind_oob job option (server/MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. equivalent of --blind-oob) to enable managed OAST via interactsh — accepts true for the public mesh or a list of hosts such as ["oast.fun","oast.me"]; callbacks are correlated to their triggering payload and surfaced as V findings with detection_method: "oob". Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! Scans abandoned at shutdown (on SIGINT/SIGTERM) do not fire a completion webhook — any pipeline relying on a webhook for every scan must handle missing completion events.
Dalfox adds --min-confidence to filter low-confidence XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. findings before output, exit code, and deduplication.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Fail CI only on high-confidence XSS claims, silently dropping uncertain findings before they affect the exit code or reports.
copy
$ dalfox url https://example.com --min-confidence high
Set the confidence threshold project-wide via the config file so every scan run without a flag still filters low-confidence findings.
yaml
copy
min_confidence: high
Adds --min-confidence high CLI flag to drop every finding Dalfox cannot stand behind before output, exit code, per-target counts in target_summary, and deduplication.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds min_confidence key to the config file, REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. , and MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. to set the confidence threshold globally. Not checked yet Adds meta.min_confidence field reporting {level, dropped} so a target filtered to zero findings can be distinguished from one that found nothing. Not checked yet SARIF SARIF Static Analysis Results Interchange Format, a standard for sharing code-analysis findings, including locations and rule details. It lets scanners report results to a common review interface. output places the confidence grade under properties while level continues to follow severity. Not checked yet
Adds --min-confidence high CLI flag to drop every finding Dalfox cannot stand behind before output, exit code, per-target counts in target_summary, and deduplication.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds min_confidence key to the config file, REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. , and MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. to set the confidence threshold globally. Not checked yet Adds meta.min_confidence field reporting {level, dropped} so a target filtered to zero findings can be distinguished from one that found nothing. Not checked yet
1 more in Everything
Dalfox: Adds per-finding allowed, encoded, blocked, and escaped fields to reflection and DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. -verification findings showing how each probed special character was
└──▷ TRY IT
Gate CI on only high-confidence XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. findings — useful when you want to fail a pipeline only on findings Dalfox is most certain about and silently drop speculative results.
copy
$ dalfox scan https://target.app --min-confidence high
└──▷ TRY IT
Scan an OpenAPI OpenAPI A vendor-neutral specification for describing REST APIs in a machine-readable format, maintained by the OpenAPI Initiative. Cyber tools use it to auto-generate clients, documentation, and validation from a single source of truth. spec against a staging host, only surfacing high-confidence XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. findings to reduce noise in CI.
copy
$ dalfox openapi ./api-spec.yaml --base-url https://staging.example.com --min-confidence high
Scan a Postman collection against a local dev server, routing all requests through its base URL.
copy
$ dalfox postman ./collection.json --base-url http://127.0.0.1:8080
Dalfox gains a REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. server, MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. server, Caido Caido A web HTTP proxy and audit platform used to intercept, replay, and automate HTTP traffic during application testing, similar in role to Burp Suite. integration, and AI agent skill for XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. scanning︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
Runs Dalfox as a REST API server supporting async scan jobs, polling, cancellation, CORS CORS A browser mechanism that lets a server declare which foreign origins may read its HTTP responses, enforced by the browser to block unauthorized cross-site requests from JavaScript. , JSONP, webhook delivery, and API key authentication.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Runs Dalfox as an MCP server, enabling use as a structured XSS scanning tool from MCP clients such as Claude and Cursor. Not checked yet Integrates Dalfox with Caido Active Workflows and Findings to automate XSS checks on captured requests. Not checked yet Installs a SKILL.md for Dalfox into skill-aware agents including Claude Code, Cursor, OpenCode, and Codex. Not checked yet
4 details in Everything
Dalfox adds MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. support and a SKILL.md for skill-aware AI agents such as Claude Code, Cursor, OpenCode, and Codex.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
Dalfox gains a persistent config file (~/.config/dalfox/config.toml or .json) covering all scan flags, scoping rules, and WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. evasion settings.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ USE IT
Persist WAF-evasion, scoping, and proxy settings for every scan without repeating flags on the CLI.
~/.config/dalfox/config.toml
copy
# $HOME/.config/dalfox/config.toml
[scan]
proxy = "http://127.0.0.1:8080"
waf_evasion = true
force_waf = "cloudflare"
delay = 200
workers = 10
skip_hosts = ["*.gov", "cdn.example.com"]
ignore_status_codes = [302, 403]
headers = ["Accept: text/html", "X-Custom: value"]
Run only against URLs matching a regex scope and skip known out-of-scope hosts, using a pre-existing baseline to surface only net-new findings.
~/.config/dalfox/config.toml
copy
# $HOME/.config/dalfox/config.toml
[scan]
include_urls = ["https://app\\.example\\.com/.*"]
skip_hosts_file = "/etc/dalfox/oos-hosts.txt"
baseline = "/tmp/last-run.json"
print_found = true
limit = 100
Override the default config path for a one-off scan with a project-specific config file.
copy
$ dalfox scan https://app.example.com/search?q=test --config ./project-dalfox.toml
Adds ~/.config/dalfox/config.toml (or config.json) as a persistent config file, auto-created with a commented template on first run of any subcommand except completion and man.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Supports $XDG_CONFIG_HOME/dalfox/ as the config directory when XDG_CONFIG_HOME is set, falling back to $HOME/.config/dalfox/ (or %USERPROFILE%\.config\dalfox\ on Windows). Not checked yet Accepts --config <path> to point Dalfox at a specific config file; a non-existent path is created from a default template and the run uses built-in defaults. Not checked yet Config file mirrors dalfox scan flag names (snake-cased); the one rename is --blind / -b, whose config key is blind, and the global --debug flag maps to the debug key. Not checked yet Adds blind_oob config key as a dedicated probe URL for re-validation (absolute http(s):// URL). Not checked yet
+27 more
show less
Adds force_waf config key to treat the target as a specific WAF instead of relying on detection (case-insensitive, same names as --force-waf). Not checked yet Adds waf_evasion config key for adaptive evasion: randomized inter-request jitter plus escalating cooldown on block clusters. Not checked yet Adds skip_params config key (exact match) to exclude specific parameter names from injection. Not checked yet Adds skip_hosts config key supporting glob patterns (*.gov, cdn.example.com) to exclude hosts or subdomains from scanning. Not checked yet Adds skip_hosts_file config key pointing to a file of out-of-scope host patterns (one per line); an unreadable path aborts the scan. Not checked yet Adds include_urls config key for unanchored regex patterns — only URLs matching at least one are scanned. Not checked yet Adds exclude_urls config key for unanchored regex patterns of URLs to skip. Not checked yet Adds baseline config key to diff results against a previous JSON/JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. report, reporting only findings new since it. Not checked yet Adds timeout config key (seconds) covering both request timeouts and remote payload/wordlist fetches. Not checked yet Adds target_timeout config key as a hard wall-clock cap per target for the payload-injection stage in seconds (max enforced; 0 disables). Not checked yet Adds delay config key for inter-request delay in milliseconds per worker. Not checked yet Adds retries config key for exponential-backoff retry attempts. Not checked yet Adds proxy config key supporting http(s):// and socks4/5(h):// proxy URLs, also used for remote payload/wordlist fetches. Not checked yet Adds ignore_status_codes config key accepting a list of HTTP status codes to ignore (e.g. [302, 403]). Not checked yet Adds workers config key for concurrent workers per target. Not checked yet Adds concurrent config key for global concurrent targets. Not checked yet Adds per_host config key for a per-host concurrency cap. Not checked yet Adds encoders config key supporting 2url, 3url, 4url, html, htmlpad, base64, unicode, and zwsp encoders. Not checked yet Adds remote_payloads config key supporting portswigger and payloadbox remote payload sources. Not checked yet Adds blind_template config key for a custom blind XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. template file (each line must contain {callback}). Not checked yet Adds custom_payload config key for a custom payload file (one payload per line). Not checked yet Adds only_custom_payload config key to restrict scanning exclusively to custom payloads. Not checked yet Adds print_found config key to print each finding mid-scan instead of after the end-of-scan summary (plain format only). Not checked yet Adds limit config key to cap result count (must be at least 1; limit = 0 falls back to built-in default with a warning). Not checked yet Config files are capped at 1 MiB; files that fail to parse are dropped whole, with a warning printed when --config is used. Not checked yet A list key in the config (e.g. headers) is replaced, not merged, by a command-line flag: one -H on the CLI drops every headers entry from the config. Not checked yet Supports --insecure=false on the CLI to override a config file that sets insecure = true — the only on/off switch that can be turned back off per-run. Not checked yet
32 details in Everything
Dalfox: Adds _meta.progressToken support on wait=true calls and preflight, streaming notifications/progress with cumulative requests sent, phase, parameters tested, and findings so far.
└──▷ TRY IT
Run a preflight check to discover parameters and estimate request count before committing to a full authenticated scan.
copy
$ curl -X POST http://localhost:<port>/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"preflight","arguments":{"target":"https://example.com/search","cookie":"sid=abc; lang=en"}}}'
Submit an async scan, then poll the addressable resource URI until settled is true before fetching final findings.
copy
$ # Submit scan
curl -X POST http://localhost:<port>/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"scan","arguments":{"target":"https://example.com/search","cookie":"sid=abc; lang=en"}}}
# Poll via resource URI until settled: true
curl -X POST http://localhost:<port>/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":3,"method":"resources/read","params":{"uri":"dalfox://scan/<scan_id>"}}'
List only running scans with pagination to monitor queue depth when approaching the 100-scan capacity limit.
copy
$ curl -X POST http://localhost:<port>/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"list_scans","arguments":{"status":"running","offset":0,"limit":20}}}'
Supports notifications/cancelled on in-flight wait=true calls to stop the underlying scan itself (not just the wait), settling it with partial results. Not checked yet Publishes outputSchema in tools/list and returns a structuredContent object from tools/call conforming to it, alongside the existing text content block. Not checked yet Adds dalfox://scans and dalfox://scan/{scan_id} resource URIs so scan status, progress, and findings are addressable directly rather than only callable. Not checked yet Adds a requests_failed field to scan status responses counting requests that never reached the target, distinguishing a clean scan from one that never really ran. Not checked yet Adds queued_at_ms, started_at_ms, finished_at_ms, and duration_ms timestamps to full status responses, plus a settled flag indicating when a terminal record is safe to delete. Not checked yet
+6 more
show less
Adds status filter and offset/limit pagination (with has_more) to the scan list tool; limit: 0 (default) returns everything. Not checked yet Enforces capacity limits of 100 active (queued or running) scans and 32 concurrent preflights; calls past either limit are refused with a JSON-RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. error. Not checked yet Truncates scans to at most 512 parameters on targets that expose more, ending the scan as done with the truncated set. Not checked yet Deliberately excludes callback_url (REST webhook) and --cookie-from-raw / cookie_from_raw (server-side file read) from the MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. surface; passing either is an error. Not checked yet The preflight tool accepts credentials and target but refuses pacing, worker, WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. -handling, blind XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. , and wait options — returning reachability, discovered parameters, and an estimated request count in {target, reachable, method, params_discovered, estimated_total_requests, params}. Not checked yet Identifies the MCP server as dalfox (display title Dalfox XSS Scanner ) during initialize, advertising tools, resources, prompts, and completions capabilities along with instructions covering tool order, finding axes, and provenance provenance Evidence recording where a software artifact came from and how it was built, including its source and build process. It helps a consumer check that the artifact matches a trusted build. rules. Not checked yet
11 details in Everything
Dalfox documents structured output structured output Forcing a model's response to match a given format or JSON schema, so software can parse it reliably instead of hoping the text is well formed. formats, new output flags, and enriched JSON/JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. /SARIF SARIF Static Analysis Results Interchange Format, a standard for sharing code-analysis findings, including locations and rule details. It lets scanners report results to a common review interface. report fields including request/response capture︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Capture the full HTTP request and response in a JSONL report so you can replay or audit exactly what Dalfox sent — pipe through jq to isolate High-severity findings only.
copy
$ dalfox scan https://target.app -f jsonl --include-all -o findings.jsonl && jq 'select(.severity=="High")' findings.jsonl
Stream findings to stdout as they arrive and show only Vulnerable-tier results, useful in CI pipelines where you want early failure on confirmed XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. .
copy
$ dalfox scan https://target.app --stream-findings --only-poc v --silence -f jsonl
Generate a PoC in raw HTTP-request format for a confirmed finding, making it easy to paste directly into a bug report or replay with a proxy.
copy
$ dalfox scan https://target.app --poc-type http-request --only-poc v
Adds -f json and -f jsonl output format flags; JSON writes one envelope document with findings under findings, JSONL writes one object per line with {"meta": {…}} as the first line and one finding per subsequent line.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds -f toml output format flag for TOML TOML A configuration file format designed to be minimal and readable, mapping unambiguously to a hash table; cyber tools use it as a structured alternative to YAML or INI for config files. -formatted scan reports. Not checked yet Adds --include-request flag to embed the verbatim HTTP request Dalfox sent (including all -H headers and cookies) into each finding in structured output. Not checked yet Adds --include-response flag to embed the HTTP response into each finding in structured output. Not checked yet Adds --include-all flag as a shorthand to enable both --include-request and --include-response in a single invocation. Not checked yet
+13 more
show less
Adds --stream-findings flag to emit findings incrementally as they are discovered rather than at scan completion. Not checked yet Adds --poc-type flag accepting curl, httpie, or http-request to control the PoC line format in terminal output; http-request prints the raw recorded request and falls back to the URL when none is available. Not checked yet Adds --only-poc flag accepting tier codes (v, a, and combinations like v,a) to suppress output for findings below the selected tiers. Not checked yet Adds --silence flag to suppress banner and non-finding output, usable alongside -f jsonl for clean pipeline consumption. Not checked yet Adds --no-color flag to strip ANSI color codes from terminal output. Not checked yet Adds --limit flag to cap the number of findings emitted. Not checked yet Structured JSON/JSONL output now includes confidence and confidence_reason fields (e.g., 'payload reached an executable position in the parsed response') per finding. Not checked yet Structured JSON/JSONL output now includes a cwe field per finding and a meta envelope with dalfox_version, dedup_mode, failed_requests, findings_count, incomplete, scan_duration_ms, target_summary, targets, and targets_deduplicated. Not checked yet Structured JSON/JSONL output now includes inject_type labels covering sxss-inHTML (under --sxss), inHTML-HPP, DOM-XSSDOM-XSS A cross-site scripting vulnerability where malicious JavaScript executes entirely in the browser by manipulating the DOM, never touching the server, making it invisible to server-side input filters. (AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. ), blind-oob-<location>-<protocol>, and OutdatedComponent. Not checked yet Structured output includes location field indicating where a parameter travels: Query , Body , JsonBody, MultipartBody, GraphqlBody, XmlBody, Header , Path , or Fragment . Not checked yet SARIF output sets ruleId to dalfox/cwe-<n> (e.g., dalfox/cwe-79 for XSS, dalfox/cwe-1104 for outdated libraries), maps severity to SARIF level (High → error, Medium → warning, Low /Info → note), and includes partialFingerprints["vulnIdentity/v1"] as a stable cross-run hash for code-scanning deduplication. Not checked yet JSON/JSONL meta block gains resume fields state_file and targets_skipped_completed when --state-file was used, and targets_unparsable when target-list lines could not be parsed. Not checked yet JSON/JSONL target_summary per-target entries include waf object (with detected[] and a bypass block showing extra encoders, mutation counts, and requests sent/blocked) when a WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. is detected. Not checked yet
Adds -f json and -f jsonl output format flags; JSON writes one envelope document with findings under findings, JSONL writes one object per line with {"meta": {…}} as the first line and one finding per subsequent line.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds -f toml output format flag for TOML TOML A configuration file format designed to be minimal and readable, mapping unambiguously to a hash table; cyber tools use it as a structured alternative to YAML or INI for config files. -formatted scan reports. Not checked yet Adds --include-request flag to embed the verbatim HTTP request Dalfox sent (including all -H headers and cookies) into each finding in structured output. Not checked yet Adds --include-response flag to embed the HTTP response into each finding in structured output. Not checked yet Adds --include-all flag as a shorthand to enable both --include-request and --include-response in a single invocation. Not checked yet
+6 more
show less
Adds --stream-findings flag to emit findings incrementally as they are discovered rather than at scan completion. Not checked yet Adds --poc-type flag accepting curl, httpie, or http-request to control the PoC line format in terminal output; http-request prints the raw recorded request and falls back to the URL when none is available. Not checked yet Adds --only-poc flag accepting tier codes (v, a, and combinations like v,a) to suppress output for findings below the selected tiers. Not checked yet Adds --silence flag to suppress banner and non-finding output, usable alongside -f jsonl for clean pipeline consumption. Not checked yet Adds --no-color flag to strip ANSI color codes from terminal output. Not checked yet Adds --limit flag to cap the number of findings emitted. Not checked yet
7 more in Everything
Dalfox gains WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. fingerprinting, bypass strategies, and evasion controls via new flags including --waf-bypass, --force-waf, --skip-waf-probe, --waf-evasion, and --waf-min-confidence︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Scan a Cloudflare-protected target with automatic WAF detection and evasion — lets Dalfox fingerprint the WAF, apply Cloudflare-specific pacing (100 ms per request), and stack evasion encoders on top of your own.
copy
$ dalfox scan https://target.app --waf-bypass auto -e url,base64
Force an AWS WAF strategy without relying on fingerprinting, useful when the target suppresses WAF signatures but you already know what is in front of it.
copy
$ dalfox scan https://target.app --force-waf aws --waf-bypass auto
Scan a fragile target that bruises easily under extra probes — skip the active provocation request and add jitter to avoid triggering rate limits while still reporting any passively detected WAF.
copy
$ dalfox scan https://target.app --skip-waf-probe --waf-evasion --waf-min-confidence 0.7
Adds --waf-bypass auto to enable automatic WAF fingerprinting (passive header/body analysis plus a dalfox_waf_probe=<script>alert(1)</script> provocation probe) and apply a per-WAF evasion strategy.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds --force-waf <name> to override fingerprinting and force a specific WAF strategy; accepted names include cloudflare/cf, aws/awswaf/aws-waf, akamai, imperva/incapsula, modsecurity/modsec/owasp-crs/owaspcrs/crs, sucuri, f5/bigip/f5-bigip, barracuda, fortiweb/forti, azure/azurewaf/azure-waf, cloudarmor/cloud-armor/gcp, fastly, wordfence, and citrix/netscaler (case-insensitive; any other value is rejected). Not checked yet Adds --skip-waf-probe to suppress the active provocation request while still running passive WAF detection on the preflight response. Not checked yet Adds --waf-bypass off to disable WAF-specific encoders, mutations, per-WAF pacing, and the provocation probe entirely while still reporting passive WAF detections in target_summary. Not checked yet Adds --waf-evasion to randomize inter-request intervals (jitter, 75–225 ms baseline) and trigger exponential cooldown pauses (2 s, doubling, capped at 30 s) on clusters of 403/406/429/503 responses, and to serialize payloads per parameter instead of sending them concurrently. Not checked yet
+4 more
show less
Adds --waf-min-confidence <float> to set the minimum confidence threshold for WAF detection to apply bypass strategies. Not checked yet WAF-specific extra encoders (unicode, 4url, zwsp) are layered on top of user-supplied -e encoders when a WAF is detected, with duplicates dropped; structural mutations are not run through the extra encoders. Not checked yet Fingerprints Wallarm, NAXSI, and SafeLine (with no dedicated strategy; these fall back to the generic fallback strategy like unrecognised WAFs). Not checked yet Records an unknown WAF when a probe returns 403/406/429/503 with no recognisable signature, unless the plain preflight already returned that status or the 429 indicates plain rate limiting. Not checked yet
9 details in Everything
Dalfox adds dry-run mode, discovery-only mode, GraphQL/XML/multipart body probing, and smarter parameter mining with bucketed requests.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Audit a target without sending any XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. payloads — useful in environments where attack-shaped requests are prohibited.
copy
$ dalfox scan https://target.app/api --dry-run
Mine undeclared parameter names from a remote wordlist while excluding CSRF CSRF Cross-site request forgery, an attack that makes a signed-in browser send an unwanted request to a site. The site may accept the request using the victim's existing session. tokens that would inflate noise.
copy
$ dalfox scan https://target.app --remote-wordlists burp,assetnote --ignore-param csrf --ignore-param __RequestVerificationToken
Scan a GraphQL endpoint and probe each variable field as its own injection point.
copy
$ dalfox scan https://target.app/graphql --only-discovery
Adds --dry-run flag to print the attack plan (target count, parameters found, request estimate) without sending any XSS payloads or attack-shaped requests.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds --only-discovery flag to run the full discovery and mining stage and print one line per discovered parameter (URL, name, location) without scanning. Not checked yet Adds --ignore-param flag (repeatable) to exclude specific parameter names from scanning, with wildcard pattern support. Not checked yet Adds --out-of-scope flag (repeatable) to exclude hosts by pattern — does not split on commas, so each pattern must be its own flag. Not checked yet Adds --remote-wordlists flag accepting source names (e.g. burp,assetnote) for remote parameter wordlists; when loaded, it takes priority over -W and -W acts as fallback. Not checked yet
+13 more
show less
Adds -W flag for a local dictionary wordlist file to mine parameter names not present in the original request. Not checked yet Supports probing GraphQL variables (variables.<path>) as individual injection points, rebuilding the full request (operation + other variables) per payload. Not checked yet Supports probing XML/SOAP XML/SOAP A messaging protocol pairing XML-structured data with SOAP envelopes to call remote services over HTTP; cyber tools use it to integrate with legacy enterprise APIs that predate REST. request bodies (application/xhtml+xml), treating each element text node and attribute value as its own injection point. Not checked yet Supports probing multipart, JSON, and form POST body parameters in addition to query parameters. Not checked yet Buckets up to 64 candidate parameter names per request (capped at ~8 KiB) during wordlist mining, splitting only ambiguous buckets to minimise request count. Not checked yet Introduces a mirror-detection sentinel check — three random parameter names are tested first; if all reflect, mining is skipped and a single synthetic injection point is used. Not checked yet Introduces a rolling reflection-ratio check (≥85% after at least 15 candidates and 5 reflections) to confirm or collapse mined query parameters. Not checked yet Auto-detects single-step encodings (base64, JSON, JWT JWT An open standard (RFC 7519) for encoding claims as a signed, optionally encrypted JSON object passed between parties. Cyber tools use it to verify identity and permissions without querying a central session store. , and similar) on query parameters and wraps payloads in the same encoding when the plain marker does not reflect. Not checked yet Probes path segments as injection points, named by position (e.g. path_segment_0:path) using -p. Not checked yet Lists URL-fragment parameter keys for visibility (nameable with -p) while skipping active fuzzing since fragments do not reach the server. Not checked yet Skips heavy payload loops for a parameter when the fast-probe sandwich-marker request sees no reflection, unless --deep-scan is set. Not checked yet Performs AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. -based DOM-XSS DOM-XSS A cross-site scripting vulnerability where malicious JavaScript executes entirely in the browser by manipulating the DOM, never touching the server, making it invisible to server-side input filters. analysis once over the landing page and once per parameter on the fast-probe response. Not checked yet Updates the built-in seed wordlist to include a broader Param Miner seed covering API, authentication, pagination, feature flags, media, and operational parameter names. Not checked yet
Adds --dry-run flag to print the attack plan (target count, parameters found, request estimate) without sending any XSS payloads or attack-shaped requests.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds --only-discovery flag to run the full discovery and mining stage and print one line per discovered parameter (URL, name, location) without scanning. Not checked yet Adds --ignore-param flag (repeatable) to exclude specific parameter names from scanning, with wildcard pattern support. Not checked yet Adds --out-of-scope flag (repeatable) to exclude hosts by pattern — does not split on commas, so each pattern must be its own flag. Not checked yet Adds --remote-wordlists flag accepting source names (e.g. burp,assetnote) for remote parameter wordlists; when loaded, it takes priority over -W and -W acts as fallback. Not checked yet
+11 more
show less
Adds -W flag for a local dictionary wordlist file to mine parameter names not present in the original request. Not checked yet Supports probing GraphQL variables (variables.<path>) as individual injection points, rebuilding the full request (operation + other variables) per payload. Not checked yet Supports probing XML/SOAP XML/SOAP A messaging protocol pairing XML-structured data with SOAP envelopes to call remote services over HTTP; cyber tools use it to integrate with legacy enterprise APIs that predate REST. request bodies (application/xhtml+xml), treating each element text node and attribute value as its own injection point. Not checked yet Buckets up to 64 candidate parameter names per request (capped at ~8 KiB) during wordlist mining, splitting only ambiguous buckets to minimise request count. Not checked yet Introduces a mirror-detection sentinel check — three random parameter names are tested first; if all reflect, mining is skipped and a single synthetic injection point is used. Not checked yet Introduces a rolling reflection-ratio check (≥85% after at least 15 candidates and 5 reflections) to confirm or collapse mined query parameters. Not checked yet Auto-detects single-step encodings (base64, JSON, JWT JWT An open standard (RFC 7519) for encoding claims as a signed, optionally encrypted JSON object passed between parties. Cyber tools use it to verify identity and permissions without querying a central session store. , and similar) on query parameters and wraps payloads in the same encoding when the plain marker does not reflect. Not checked yet Probes path segments as injection points, named by position (e.g. path_segment_0:path) using -p. Not checked yet Lists URL-fragment parameter keys for visibility (nameable with -p) while skipping active fuzzing since fragments do not reach the server. Not checked yet Skips heavy payload loops for a parameter when the fast-probe sandwich-marker request sees no reflection, unless --deep-scan is set. Not checked yet Performs AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. -based DOM-XSS DOM-XSS A cross-site scripting vulnerability where malicious JavaScript executes entirely in the browser by manipulating the DOM, never touching the server, making it invisible to server-side input filters. analysis once over the landing page and once per parameter on the fast-probe response. Not checked yet
2 more in Everything
Dalfox docs reveal --blind-oob OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. detection, resume/state-file scanning, and HAR HAR An HTTP Archive file, a JSON-format log of all network requests and responses captured by a browser's developer tools, used by cyber tools to replay, inspect, or analyze web traffic without re-running a live session. /raw-HTTP input handling with --keep-duplicates︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Detect blind/stored XSS that fires in an admin panel by having Dalfox manage an interactsh OOB session and poll for callbacks after the scan.
copy
$ dalfox scan 'https://target.app/feedback?msg=1' --blind-oob --blind-oob=oast.fun --blind-oob-wait 120
Scan a Burp/browser HAR capture to test every recorded request for XSS, adding a fresh auth header on top of the captured credentials.
copy
$ dalfox scan -i har capture.har -H 'Authorization: Bearer <new_token>'
Adds --blind-oob flag (with optional --blind-oob=oast.fun server override and --blind-oob-wait poll duration) to register an interactsh session, mint a per-payload callback host, and surface late-firing XSS as V findings with detection_method: oob.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds -b flag for supplying your own out-of-band callback listener URL for blind XSS payloads without Dalfox managing the interactsh session. Not checked yet Adds scan resume via a state file: a target's identity is hashed from its URL, method, and request data (body, headers, cookies, user-agent, plus captured values in raw HTTP / HAR inputs), and run-wide credential headers (Authorization , Proxy-Authorization , Cookie , X-Api-Key , *-Api-Key, X-Auth-Token , *-Token, X-CSRF-Token , X-XSRF-Token , *-Session-Id, X-Session-Token , X-Access-Key , X-JWT-Assertion ) are excluded from the hash so a refreshed session resumes rather than rescans. Not checked yet Supports raw HTTP request files as scan input: Dalfox reads method, path, headers, cookies, and body, drops Host , Content-Length , Transfer-Encoding , hop-by-hop, and Accept-Encoding headers, and resolves the scheme from :scheme, :authority, HTTP/2HTTP/2 The second major version of the HTTP protocol, standardized by the IETF, adding multiplexed streams, header compression, and binary framing over a single TCP connection to cut latency and reduce overhead. /HTTP/3HTTP/3 The third major version of HTTP, standardized by the IETF, which runs over QUIC instead of TCP, eliminating head-of-line blocking and reducing connection latency for faster, more resilient data transfer. request-line markers, or Host ending in :443. Not checked yet Supports HAR files as scan input via -i har <capture.har>, with each entry becoming a target run through the same scope filters; duplicates are collapsed by URL + method by default. Not checked yet
+8 more
show less
Adds meta.targets_unparsable field in reports to count skipped unparseable lines (mailto:, javascript:, tel:, ftp://, truncated fragments) from URL-list scans without failing the run. Not checked yet Adds --sxss-url flag for stored XSS mode to specify a secondary fetch URL where a payload is expected to land, while also checking the source page, the form action (same-origin only), and discovered form fields. Not checked yet Adds --baseline-mode option so practitioners can declare what a normal response looks like and disable heuristic reflection detection. Not checked yet Adds --poc-type, --include-request, --include-response, and --include-all output flags controlling PoC report verbosity. Not checked yet Adds --retries and --retry-delay flags to control retry behaviour on transport failures. Not checked yet Adds mcp subcommand exposing a Model Context Protocol Model Context Protocol Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. stdio server interface. Not checked yet Adds completion subcommand to print shell completion scripts. Not checked yet Session-loss monitoring tracks cookies and Cookie /Authorization headers during scans and terminates a job with a SESSION_LOST message when the session is detected as dropped; monitoring is a no-op when no credentials are present. Not checked yet
13 details in Everything
Dalfox v3 adds MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. stdio server, managed OAST OAST Out-of-band Application Security Testing: a technique for detecting vulnerabilities by having a target system make DNS or HTTP callbacks to an attacker-controlled server, revealing flaws that produce no visible in-band response. , resumable scans, session monitoring, shell completions, and major CLI flag overhauls.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Run a stored-XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. scan against a login form, letting Dalfox auto-detect the verification URL from form discovery.
copy
$ dalfox scan https://example.com/login --sxss -H 'Cookie: session=abc123' --include-request --include-response
Resume a previous multi-target scan and report only findings new since the last JSON report, with rate limiting to avoid triggering WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. blocks.
copy
$ dalfox scan -f targets.txt --state-file ./dalfox-state.json --baseline ./prev-report.json --rate-limit 30 --retries 3
Scan a captured raw HTTP request exported as a HAR HAR An HTTP Archive file, a JSON-format log of all network requests and responses captured by a browser's developer tools, used by cyber tools to replay, inspect, or analyze web traffic without re-running a live session. file, enabling managed OAST callback correlation for blind XSS.
copy
$ dalfox scan capture.har --input-type har --blind-oob --max-concurrent-targets 5
Adds dalfox server --type mcp as a dedicated stdio subcommand exposing Dalfox to AI coding assistants over JSON-RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. , replacing v2's server --type mcp approach.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds --blind-oob flag for managed OAST: registers an interactsh session and correlates callbacks to the payload that triggered them, alongside the plain -b callback URL. Not checked yet Adds --state-file and --baseline flags for resumable and incremental runs — skip targets a previous run completed, or report only findings new since an earlier JSON report. Not checked yet Adds --rate-limit and --retries flags for pacing and backoff: a global requests-per-second cap shared across all workers, with automatic retries on 5xx and transient errors. Not checked yet Adds --sxss flag on the scan subcommand for stored-XSS scanning (replaces the removed sxss subcommand); pair with --sxss-url <url> to specify the check URL, or let form discovery auto-detect it. Not checked yet
+12 more
show less
Adds --max-concurrent-targets and --max-targets-per-host flags replacing the removed --mass / --multicast / --mass-worker switches for concurrent multi-target scanning. Not checked yet Adds --skip-mining-dict and --skip-mining-dom flags, replacing removed --mining-dict=false / --mining-dom=false and the old --skip-mining-all / --skip-mining. Not checked yet Adds --skip-ast-analysis flag — static AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. analysis now runs by default and this flag disables it. Not checked yet Adds --input-type har flag (alongside auto-detection) to force HAR or raw HTTP request parsing from a file (e.g. dalfox scan request.txt), replacing removed --rawdata, --har, and --http switches. Not checked yet Adds dalfox completion <shell> subcommand for shell completions across bash, zsh, fish, PowerShell, and Elvish. Not checked yet Adds -p token:header optional location suffix syntax to the -p parameter flag for pinning injection context. Not checked yet Renames -w, --worker to a new flag with no -w short form; default concurrent workers drops from 100 to 50. Not checked yet Pluralizes --header to --headers (long form only; -H short form unchanged) and allows multiple -H passes. Not checked yet Replaces dalfox payload --entity-event-handler, --entity-useful-tags, --entity-special-chars, --remote-portswigger, and --remote-payloadbox switches with positional selectors: dalfox payload event-handlers, useful-tags, special-chars, portswigger, payloadbox. Not checked yet Adds --silence (-S) mode on file/pipe subcommands that prints only PoC output. Not checked yet Adds --session-check flag for session monitoring — an authenticated scan whose session drops mid-run is reported as incomplete rather than clean. Not checked yet Adds per-character probing of reflected parameters (valid_specials / invalid_specials) built in by default to steer payload selection, with no flag required to enable it. Not checked yet
Adds dalfox server --type mcp as a dedicated stdio subcommand exposing Dalfox to AI coding assistants over JSON-RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. , replacing v2's server --type mcp approach.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Adds --blind-oob flag for managed OAST: registers an interactsh session and correlates callbacks to the payload that triggered them, alongside the plain -b callback URL. Not checked yet Adds --state-file and --baseline flags for resumable and incremental runs — skip targets a previous run completed, or report only findings new since an earlier JSON report. Not checked yet Adds --rate-limit and --retries flags for pacing and backoff: a global requests-per-second cap shared across all workers, with automatic retries on 5xx and transient errors. Not checked yet Adds --sxss flag on the scan subcommand for stored-XSS scanning (replaces the removed sxss subcommand); pair with --sxss-url <url> to specify the check URL, or let form discovery auto-detect it. Not checked yet
+7 more
show less
Adds --max-concurrent-targets and --max-targets-per-host flags replacing the removed --mass / --multicast / --mass-worker switches for concurrent multi-target scanning. Not checked yet Adds --skip-ast-analysis flag — static AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. analysis now runs by default and this flag disables it. Not checked yet Adds --input-type har flag (alongside auto-detection) to force HAR or raw HTTP request parsing from a file (e.g. dalfox scan request.txt), replacing removed --rawdata, --har, and --http switches. Not checked yet Adds dalfox completion <shell> subcommand for shell completions across bash, zsh, fish, PowerShell, and Elvish. Not checked yet Adds --silence (-S) mode on file/pipe subcommands that prints only PoC output. Not checked yet Adds --session-check flag for session monitoring — an authenticated scan whose session drops mid-run is reported as incomplete rather than clean. Not checked yet Adds per-character probing of reflected parameters (valid_specials / invalid_specials) built in by default to steer payload selection, with no flag required to enable it. Not checked yet
5 more in Everything
└──▷ BREAKING ON UPGRADE
! The sxss subcommand is removed; stored-XSS scanning moves to dalfox scan via the --sxss flag.! The bare dalfox url URL form no longer works; the url subcommand now requires -u/--url (e.g. dalfox url -u URL). Switch scripts to dalfox scan URL.! --rawdata, --har, and --http input switches are removed; use auto-detection (dalfox scan request.txt) or --input-type har instead.! The -w short form of --worker is removed; the default worker count drops from 100 to 50.! --header long form is renamed to --headers; -H short form is unchanged.! --output-request and --output-response are renamed to --include-request and --include-response.! --mining-dict=false and --mining-dom=false are removed; use --skip-mining-dict and --skip-mining-dom instead.! --skip-mining-all and --skip-mining are removed; replaced by --skip-mining-dict and --skip-mining-dom.! --limit is renamed to --limit-result.! --mass, --multicast, and --mass-worker are removed; use --max-concurrent-targets and --max-targets-per-host.! --deep-domxss, --detailed-analysis, --fast-scan, --har-file-path, --output-all, and --context-aware are removed with no v3 replacements.! --skip-grepping and --only-poc g (grep findings) are removed.! The --type flag on dalfox server is removed; the server now binds to localhost by default instead of all interfaces — pass --host 0.0.0.0 to restore the previous behavior.! dalfox payload flag switches --entity-event-handler, --entity-useful-tags, --entity-special-chars, --remote-portswigger, and --remote-payloadbox are replaced by positional selectors.! --silence-force on file/pipe is replaced by -S/--silence.! --trigger <url> on the old sxss subcommand is replaced by --sxss-url <url> on dalfox scan.
Dalfox: Adds out-of-scope pattern file support so a file of host-exclusion patterns (one per line, blank and # lines skipped) can be supplied alongside or instead of inline --out-of-scope flags.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Exclude a government TLD TLD The rightmost label in a domain name (e.g., .com, .gov, .uk), maintained by IANA's root zone. Cyber tools filter or pivot on TLDs to scope scans, flag suspicious registrations, or classify traffic by geography or type. and a specific CDN CDN A content delivery network, servers distributed across locations that cache and serve content near readers. It can reduce loading time and traffic to the original server. host from a scan so Dalfox never sends payloads to out-of-scope infrastructure.
copy
$ dalfox scan https://app.example.com --out-of-scope '*.gov' --out-of-scope cdn.example.com
Adds --blind-oob custom blind payload template file support: one template per line, each containing {callback}, which Dalfox replaces with the OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. callback URL; lines missing {callback} are skipped with a warning and fall back to built-in templates. Not checked yet Adds a custom payload file flag (one payload per line, blank and # lines skipped) that merges with built-in payloads unless the 'use only custom payloads' flag is also set. Not checked yet Adds a 'use only custom payloads' mode that requires the custom payload file flag (exits on missing file) and suppresses all built-in payloads. Not checked yet Adds NO_COLOR environment-variable support to disable ANSI colour output. Not checked yet Adds per-request timeout (seconds) and a per-host concurrent-target cap flag. Not checked yet
+10 more
show less
Adds a result cap flag (must be at least 1; omit for no cap) to limit total findings shown. Not checked yet Adds a re-validation probe URL flag to substitute a cheaper URL when re-validating findings instead of hitting the original scan target. Not checked yet Adds --config global flag accepting a path (e.g. ./dalfox.toml) that can be placed before or after any subcommand. Not checked yet Adds --api-key flag for server auth; passing --api-key "" explicitly disables authentication. Not checked yet Adds CORS CORS A browser mechanism that lets a server declare which foreign origins may read its HTTP responses, enforced by the browser to block unauthorized cross-site requests from JavaScript. origin control for the server mode (comma-separated exact origins, regex:<pattern>, or wildcard; patterns must match the whole origin including port). Not checked yet Adds plain-text log file output for the server (created mode with group/other-readability warning on Unix). Not checked yet Adds per-scan outbound request rate cap (requests/sec) and total wall-clock runtime cap (seconds) for server-mode scans. Not checked yet Adds --payload subcommand flag to print selected payloads as a JSON array instead of one-per-line; without a selector prints a summary (usage examples and per-selector counts) as JSON; unknown selector exits and suggests the closest match. Not checked yet Adds hidden legacy shorthand commands (dalfox url, dalfox file, dalfox pipe) as v2-era aliases for dalfox scan -i url/file/pipe; an explicit -i flag still wins. Not checked yet Adds dalfox man hidden command that prints the roff man page to stdout for packaging use. Not checked yet
15 details in Everything
└──▷ BREAKING ON UPGRADE
! The bare dalfox <TARGET> shorthand no longer accepts scan flags other than global ones — scan flags such as --workers now require the explicit dalfox scan <TARGET> --workers form or they are rejected as unexpected arguments.
Dalfox adds an out-of-scope host file option that aborts scanning if the file is unreadable︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
Adds support for a file listing out-of-scope hosts, where an unreadable path aborts the scan to enforce validation; coverage includes the scan target, any OAST OAST Out-of-band Application Security Testing: a technique for detecting vulnerabilities by having a target system make DNS or HTTP callbacks to an attacker-controlled server, revealing flaws that produce no visible in-band response. server named with --blind-oob=, and the public interactsh mesh.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
1 detail in Everything
Dalfox gains a full MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. server integration with async scanning, structured output structured output Forcing a model's response to match a given format or JSON schema, so software can parse it reliably instead of hoping the text is well formed. , resources, prompts, and progress streaming.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ TRY IT
Run a blocking MCP scan with progress streaming so your agent sees live phase updates rather than waiting silently for minutes.
copy
$ {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"scan","arguments":{"target":"https://example.com","wait":true},"_meta":{"progressToken":"tok-abc123"}}}
Poll a finished scan resource directly by URI to attach findings to the model context without re-quoting them through the tool.
copy
$ {"jsonrpc":"2.0","id":2,"method":"resources/read","params":{"uri":"dalfox://scan/<scan_id>"}}
Exposes six tools over MCP, with scans async by default — submit via the tool, poll for results, or pass wait: true to block and stream progress.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Streams notifications/progress against _meta.progressToken on wait=true calls or tools/call, reporting cumulative requests sent, phase, parameters tested, and findings so far. Not checked yet Publishes outputSchema in tools/list and returns a structuredContent object on tools/call so clients can validate and destructure responses without parsing strings. Not checked yet Exposes scans as addressable MCP resources: dalfox://scans returns the job index and dalfox://scan/{scan_id} returns one scan's status, progress, and findings. Not checked yet Returns resources/list with the job index plus one entry per tracked scan (paged with a cursor), bounded at 200 rows for the index. Not checked yet
+9 more
show less
Attaches a resource_link content block to any tool result carrying a scan_id, letting clients attach findings directly (omitted for protocol revisions older than 2025-06-18). Not checked yet Publishes two prompts in the client prompt menu: scan_target (size with preflight, run, report findings by confidence) and triage_findings (read a finished scan along type/detection_method axes). Not checked yet Supports completion/complete to autocomplete the scan_id argument for the triage_findings prompt and the dalfox://scan/{scan_id} template from currently tracked scans. Not checked yet Rejects any unrecognised field as a JSON-RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. error (invalid params) naming the offending key and listing every accepted one, rather than silently dropping it. Not checked yet Exposes a settled field on scan status so clients know when a terminal scan's worker has finished draining and the record is safe to delete or summarise. Not checked yet Auto-purges terminal scans after 1 hour; running or queued scans must be cancelled before deletion. Not checked yet Returns instructions in the initialize handshake covering intended tool order, how to read finding axes, and provenance provenance Evidence recording where a software artifact came from and how it was built, including its source and build process. It helps a consumer check that the artifact matches a trusted build. rules. Not checked yet Annotates each tool with readOnlyHint, destructiveHint, idempotentHint, and openWorldHint behaviour hints so hosts can decide autonomously which calls are safe. Not checked yet The preflight tool accepts a deliberately smaller argument set than the scan tool (no payload, pacing, WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. , blind XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. , or wait options), mirroring the difference from POST /preflight on the REST side. Not checked yet
14 details in Everything
Dalfox adds resume-capable scanning with completed-target tracking and an out-of-scope domain exclusion file.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
Records completed scan targets to a file and skips them on re-run, with raw HTTP/HAR HAR An HTTP Archive file, a JSON-format log of all network requests and responses captured by a browser's developer tools, used by cyber tools to replay, inspect, or analyze web traffic without re-running a live session. request data fingerprinted so changed captures are re-scanned; run-wide credential values are excluded from the fingerprint so a refreshed session resumes cleanly.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Supports a file listing out-of-scope domains to exclude from scanning; an unreadable file is a fatal FILE_READ_ERROR to prevent accidentally attacking every host in the exclusion list. Not checked yet
2 details in Everything
Dalfox v3.2.3 adds GraphQL and XML/SOAP XML/SOAP A messaging protocol pairing XML-structured data with SOAP envelopes to call remote services over HTTP; cyber tools use it to integrate with legacy enterprise APIs that predate REST. injection surfaces, wider DOM-XSS DOM-XSS A cross-site scripting vulnerability where malicious JavaScript executes entirely in the browser by manipulating the DOM, never touching the server, making it invisible to server-side input filters. AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. coverage, and a new sub-not-gsub filter bypass detection.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.2.3 https://github.com/hahwul/dalfox.git
$ git checkout v3.2.3
Adds GraphQL and XML / SOAP SOAP A W3C-standardized XML-based messaging protocol for exchanging structured data between services over HTTP or other transports, giving cyber tools a language-agnostic way to call remote APIs. request bodies as new injection surfaces for XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. scanning.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Widens DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. -XSS AST coverage to include Promise combinators, optional chaining, and static bracket paths, with more sinks and sources and fewer false positives. Not checked yet Detects the sub-not-gsub angle filter bypass: a doubled <<svg ...>> payload opens a real tag where a one-shot str::replace only consumed the first <. Not checked yet Scans now run concurrently within a parameter, ramp payload batches instead of jumping to a full --workers window, and exit early for endpoints that uniformly escape their echo — significantly cutting scan time. Not checked yet Cross-origin <form action> targets are no longer probed during parameter discovery, preventing -H headers and --cookies from being sent to page-controlled origins. Not checked yet
Adds GraphQL and XML / SOAP SOAP A W3C-standardized XML-based messaging protocol for exchanging structured data between services over HTTP or other transports, giving cyber tools a language-agnostic way to call remote APIs. request bodies as new injection surfaces for XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. scanning.︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet Detects the sub-not-gsub angle filter bypass: a doubled <<svg ...>> payload opens a real tag where a one-shot str::replace only consumed the first <. Not checked yet
3 more in Everything
Dalfox adds GraphQL/XML scanning, adaptive WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. evasion with jitter, a REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. server, an MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. server, and a /_dalfox endpoint.
└──▷ TRY IT
Submit a URL to the Dalfox REST API server for XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. scanning without using the CLI directly.
copy
$ curl http://localhost:port/_dalfox
Exposes a REST API server with a /_dalfox endpoint for programmatic XSS scanning. Not checked yet Adds an MCP server mode for tool integration. Not checked yet Adds adaptive WAF evasion that applies random jitter between requests and an escalating cooldown when blocked responses cluster, with WAF-specific pacing hints applied automatically on WAF detection even without the flag. Not checked yet Adds a config file reference and environment variable support for persistent Dalfox configuration. Not checked yet
4 details in Everything
Dalfox MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. integration gains paginated findings, size-capped pages, untrusted-content notices, and blind-XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. callback validation
Adds _untrusted_content_notice as the first key in every MCP findings response, ensuring agents read the safety warning before acting on scan output whose evidence, response, payload, param, location, and message_str fields contain target-controlled bytes. Not checked yet Adds offset and limit parameters to page through large MCP result sets, with a pagination object reporting {total, offset, limit, returned, has_more} and truncated_by_size: true / max_page_bytes when a 4 MiB per-page cap cuts a page short. Not checked yet Validates blind_callback_url at call time — must be empty or start with a recognized scheme — so blind-XSS <script src=...> payloads are not silently injected into every parameter (query, body, header, cookie) with no viable callback. Not checked yet Validates include_* provider names against registered providers so an unrecognized name fails loudly rather than silently omitting payload coverage from the scan. Not checked yet Attaches _untrusted_content_notice to discovered-parameter responses as well, since each discovered parameter name is lifted from the target's own markup. Not checked yet
Adds _untrusted_content_notice as the first key in every MCP findings response, ensuring agents read the safety warning before acting on scan output whose evidence, response, payload, param, location, and message_str fields contain target-controlled bytes. Not checked yet Adds offset and limit parameters to page through large MCP result sets, with a pagination object reporting {total, offset, limit, returned, has_more} and truncated_by_size: true / max_page_bytes when a 4 MiB per-page cap cuts a page short. Not checked yet Validates blind_callback_url at call time — must be empty or start with a recognized scheme — so blind-XSS <script src=...> payloads are not silently injected into every parameter (query, body, header, cookie) with no viable callback. Not checked yet Validates include_* provider names against registered providers so an unrecognized name fails loudly rather than silently omitting payload coverage from the scan. Not checked yet
1 more in Everything
Dalfox gains native GraphQL and XML/SOAP XML/SOAP A messaging protocol pairing XML-structured data with SOAP envelopes to call remote services over HTTP; cyber tools use it to integrate with legacy enterprise APIs that predate REST. body injection, treating inner values as individual XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. injection points.
└──▷ TRY IT
Scan a GraphQL endpoint for XSS by injecting into each variable leaf while keeping the operation structure valid.
copy
$ dalfox https://target.app/graphql -X POST -H 'Content-Type: application/json' -d '{"query":"query($q:String!){ search(term:$q){ id } }","variables":{"q":"seed"}}'
Scan a SOAP SOAP A W3C-standardized XML-based messaging protocol for exchanging structured data between services over HTTP or other transports, giving cyber tools a language-agnostic way to call remote APIs. endpoint for XSS by injecting into each XML text node while leaving the envelope and namespaces intact.
copy
$ dalfox https://target.app/soap -X POST -H 'Content-Type: application/soap+xml' -d '<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"><soap:Body><search><term>seed</term></search></soap:Body></soap:Envelope>'
Adds graphql parameter type: when the POST body carries a GraphQL operation with a variables object (Content-Type application/json or application/graphql), every string leaf inside variables is registered as its own injection point, and each payload rebuilds the full request so the server receives a valid, parseable GraphQL document. Not checked yet Adds xml parameter type: when the POST body is an XML or SOAP document (Content-Type text/xml, application/xml, or application/soap+xml, or a body with an <?xml …?> prolog), each element text node and attribute value becomes a separate injection point, injected via byte-range splice so namespaces, sibling elements, and the SOAP envelope are preserved. Not checked yet
2 details in Everything
Dalfox v3.2.2 adds WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. fingerprints for Wallarm/NAXSI/SafeLine, a javascript payload selector, and dalfox completion for shell completions.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.2.2 https://github.com/hahwul/dalfox.git
$ git checkout v3.2.2
└──▷ TRY IT
Generate a list of canonical JavaScript XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. payloads to review or pipe into a custom scan.
copy
$ dalfox payload javascript
Adds dalfox completion subcommand to generate shell completions, installed alongside the man page by packages. Not checked yet Adds dalfox payload javascript selector to print canonical JavaScript execution payloads used in JS-string contexts. Not checked yet Adds slash-separated attribute breakout payloads to dalfox payload for bypassing space-stripping filters. Not checked yet Config files no longer override flags explicitly typed on the CLI, fixing flag-precedence for all subcommands. Not checked yet
4 details in Everything
Dalfox adds dalfox payload javascript subcommand to print canonical JS execution payloads for XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. testing.
└──▷ TRY IT
Enumerate built-in JS-context payloads to feed into a custom fuzzer or review coverage before a pentest.
copy
$ dalfox payload javascript
Dalfox server mode gains rate caps, concurrency limits, reverse-proxy host support, and JS payload context improvements.
└──▷ TRY IT
Run the Dalfox server behind a reverse proxy that forwards traffic under a public hostname, so the Host header is accepted rather than rejected.
copy
$ dalfox server --allowed-hosts xss.example.com
Cap memory usage in long-running server deployments by limiting how many finished scans are retained.
copy
$ dalfox server --max-retained-scans 200
Adds --allowed-hosts flag to accept extra hostnames in the request Host header — required when Dalfox runs behind a reverse proxy that forwards a public hostname. Not checked yet Adds server-wide cap on each scan's outbound request rate (requests/sec) to limit scan throughput. Not checked yet Adds server-wide cap on each scan's total wall-clock runtime in seconds, with unbounded default. Not checked yet Adds --max-retained-scans to cap the number of finished scans kept in memory; oldest are dropped once the limit is exceeded — queued and running scans are never dropped. Not checked yet Adds a concurrency limit on simultaneous (queued + running) scans; submissions beyond the limit receive a 503 response. Not checked yet
+1 more
show less
Adds canonical JavaScript execution payloads for JS-string and script contexts (alert(1) , backtick and keyword-split variants) under the javascript payload class. Not checked yet
6 details in Everything
Dalfox gains completion subcommand for shell autocomplete across bash, zsh, fish, powershell, and elvish
└──▷ TRY IT
Install Dalfox tab-completion in a zsh session so subcommands and flags autocomplete at the prompt.
copy
$ dalfox completion zsh > "${fpath[1]}/_dalfox"
Install Dalfox tab-completion system-wide for bash on a Linux host.
copy
$ dalfox completion bash > /etc/bash_completion.d/dalfox
Dalfox v3 (Rust rewrite) consolidates scan subcommands, renames flags, and adds MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. server, WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. evasion, dry-run, and more.
└──▷ TRY IT
Run a preflight check on a target to discover parameters and estimate request count before committing to a full scan.
copy
$ dalfox scan https://example.com/search --dry-run
Scan a HAR HAR An HTTP Archive file, a JSON-format log of all network requests and responses captured by a browser's developer tools, used by cyber tools to replay, inspect, or analyze web traffic without re-running a live session. export with WAF evasion and HTTP parameter pollution enabled, enforcing a 120-second time budget per target.
copy
$ dalfox scan capture.har --waf-evasion --hpp --scan-timeout 120
Scan for stored XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. on a target, scoping payload injection to the query parameter q and capping payloads per parameter to avoid request bursts.
copy
$ dalfox scan 'https://example.com/post?q=test' --sxss -p q:query --max-payloads-per-param 50
Adds dalfox mcp subcommand to expose Dalfox to AI coding assistants over JSON-RPC RPC Remote Procedure Call, a protocol that lets a program execute a function on another machine as if it were local, giving cyber tools a structured way to communicate across processes or hosts without managing raw sockets. via an MCP server. Not checked yet Adds --sxss flag to dalfox scan for stored-XSS scanning (replaces the retired dalfox sxss subcommand). Not checked yet Adds --input-type raw-http to accept captured raw HTTP requests as scan input. Not checked yet Adds --scan-timeout <secs> to enforce a hard time budget per target, preventing half-hung servers from stalling a run. Not checked yet Adds --max-payloads-per-param <int> to cap combinatorial payload expansion and prevent request bursts. Not checked yet
+11 more
show less
Adds --dry-run preflight mode that reports discovered parameters and estimated request count without sending any payloads. Not checked yet Adds --waf-evasion for adaptive WAF evasion: randomizes inter-request timing and escalates cooldown when blocked responses cluster. Not checked yet Adds --hpp (HTTP parameter pollution) to duplicate query parameters and slip past string-matching WAF layers. Not checked yet Adds -p, --param <string> with type scoping syntax (e.g. -p id:query, -p sort:body) for per-parameter type targeting. Not checked yet Supports HAR file input natively — dalfox scan capture.har auto-detects the format. Not checked yet Unifies dalfox url, dalfox file, and dalfox pipe behind dalfox scan (or bare dalfox [url]); scan is now the default subcommand. Not checked yet Replaces headless Chrome (chromedp) verification with a compiler-grade JavaScript parser (oxc) that traces data flows and DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. sinks without a browser. Not checked yet Introduces finding evidence classes: [V] (DOM-level evidence in parsed response) and [A] (static-analysis source-to-sink flow). Not checked yet Replaces --report / --report-format with -f markdown -o <file> and -f sarif -o <file> output format flags. Not checked yet Spinners and banners are automatically suppressed for pipes, silent mode (-S), and machine-readable formats (json, sarif). Not checked yet The async scheduler (tokio) allocates work across cores automatically, eliminating the need for manual CPU CPU The main general-purpose processor in a computer. It runs application instructions and coordinates work with memory and other hardware. pinning via --max-cpu. Not checked yet
16 details in Everything
└──▷ BREAKING ON UPGRADE
! The dalfox url subcommand is retired as a first-class command (survives only as a hidden alias); replace with dalfox scan [url].! The dalfox file subcommand is retired as a first-class command (survives only as a hidden alias); replace with dalfox scan [file].! The dalfox pipe subcommand is retired as a first-class command (survives only as a hidden alias); replace with dalfox scan - or cat targets | dalfox scan.! The dalfox sxss subcommand is removed with no hidden alias; replace with dalfox scan [url] --sxss.! --concurrence <int> is renamed to --workers <int>.! -C, --cookie <string> is renamed to --cookies <string>.! --use-bav and --skip-bav are removed with no replacement; BAV checks are gone entirely from v3.! --found-action <cmd> and --found-action-shell are removed; use REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. webhooks or pipe stdout instead.! --skip-headless and --force-headless-verification are removed; headless Chrome is gone and static analysis is always on.! --grep <file> and --skip-grep are removed; regex response matching replaced by AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. analysis.! --report and --report-format are removed; use -f markdown -o <file> or -f sarif -o <file> instead.! --max-cpu is removed; CPU allocation is handled automatically by the async scheduler.! --no-spinner is removed; spinner suppression is now automatic.
Dalfox adds shell completion generation via dalfox completion for bash, zsh, fish, PowerShell, and Elvish.
└──▷ TRY IT
Install bash completions system-wide after building Dalfox from source or a release archive.
copy
$ dalfox completion bash > /etc/bash_completion.d/dalfox
Install zsh completions to your fpath when using a non-package-manager install.
copy
$ dalfox completion zsh > "${fpath[1]}/_dalfox"
Install fish completions after a Cargo or source build of Dalfox.
copy
$ dalfox completion fish > ~/.config/fish/completions/dalfox.fish
Dalfox adds dalfox completion subcommand for generating shell completion scripts in bash, zsh, fish, powershell, and elvish.
└──▷ TRY IT
Install persistent tab-completion for Dalfox in your bash environment so subcommands and flags are autocompleted at the prompt.
copy
$ dalfox completion bash > /etc/bash_completion.d/dalfox
Install tab-completion for Dalfox in a fish shell environment.
copy
$ dalfox completion fish > ~/.config/fish/completions/dalfox.fish
New dalfox completion <SHELL> subcommand generates and prints shell completion scripts to stdout for bash, zsh, fish, powershell, and elvish — output is safe to redirect directly to the appropriate completion file. Not checked yet Deprecated compat commands and the man packaging helper are hidden from generated completion scripts, keeping autocomplete output clean. Not checked yet
2 details in Everything
Dalfox server gains cross-site request blocking, DNS-rebinding protection, and memory-cap controls for finished scans.
└──▷ TRY IT
Run Dalfox server behind a reverse proxy that forwards a public hostname, so the Host-header gate doesn't reject legitimate requests.
copy
$ dalfox server --allowed-hosts "dalfox.internal,scan.corp.example"
Allow a specific internal web UI to call the Dalfox server API while keeping the cross-site gate active for all other origins.
copy
$ dalfox server --allowed-origins "https://app.example.com"
Prevent unbounded memory growth in long-running server mode by capping how many finished scan results are retained.
copy
$ dalfox server --max-retained-scans 200
Adds --allowed-hosts <names> flag to dalfox server, listing extra hostnames accepted in the Host header beyond the bind host, localhost, and IP literals — needed when a reverse proxy forwards a public hostname. Not checked yet New cross-site request gate on dalfox server rejects browser-originated cross-site requests by checking the Origin header against the allow-list and blocking Sec-Fetch-Site: cross-site or same-site requests with 403, while leaving non-browser clients (curl, CLI, CI) unaffected. Not checked yet DNS-rebinding protection added to dalfox server via Host header validation; IP literals and localhost are always accepted, any other hostname must be listed via --allowed-hosts. Not checked yet Server prints a startup warning when JSONP is enabled without an API key, because JSONP bypasses the cross-site gate and allows any site to launch scans and read results. Not checked yet Adds --allowed-origins flag to dalfox server to permit specific web UI origins through the cross-site gate while keeping CORS CORS A browser mechanism that lets a server declare which foreign origins may read its HTTP responses, enforced by the browser to block unauthorized cross-site requests from JavaScript. enforcement active. Not checked yet
5 details in Everything
Dalfox gains a payload subcommand with named selectors for XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. payload categories including mXSS, DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. clobbering, blind, and remote sources.
└──▷ TRY IT
Quickly dump every local payload category in one shot to pipe into a fuzzer or review offline.
copy
$ dalfox payload all
Generate blind-XSS skeletons pre-populated with your OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. callback to drop straight into a payload list.
copy
$ dalfox payload blind
Adds dalfox payload payloadbox to fetch and print remote XSS payloads from PayloadBox. Not checked yet Adds dalfox payload all to print every local payload selector in one pass, each grouped under a # name header (remote selectors excluded). Not checked yet Adds event-handlers selector to list all DOM event handler attribute names (e.g., onclick, onmouseover). Not checked yet Adds useful-tags selector to list HTML tag names commonly used in XSS contexts (e.g., script, img, svg). Not checked yet Adds uri-scheme selector to print scheme-based XSS payloads (e.g., javascript:). Not checked yet
+6 more
show less
Adds dom-clobbering selector to print DOM clobbering payloads. Not checked yet Adds mxss selector to print mutation-XSS and sanitizer-bypass payloads. Not checked yet Adds blind selector to print blind-XSS skeletons where {} is substituted with your OOB callback URL. Not checked yet Adds a selector to print special characters and encoded variants for context probing and breakout. Not checked yet Adds a selector to print visibly-confirmable sinks with filter-surviving variants. Not checked yet Adds a selector to print polished alert(document.domain) PoCs for clean screenshots and demos. Not checked yet
11 details in Everything
Dalfox adds --json flag to output selected payloads as a JSON array.
dalfox v3.2.1 adds all payload selector, JSON payload output, closest-selector suggestions, modern JS framework detection, and server-side SSRF SSRF Server-side request forgery, an attack that tricks a server into making requests chosen by an attacker. Those requests can reach internal services the attacker cannot access directly. guards.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.2.1 https://github.com/hahwul/dalfox.git
$ git checkout v3.2.1
Adds all selector to dalfox payload to dump every static payload group in one pass. Not checked yet Adds JSON output to dalfox payload for machine-readable payload lists. Not checked yet Adds per-selector item counts to dalfox payload summary output. Not checked yet Adds closest-selector suggestions to dalfox payload when an unknown selector is given (Levenshtein distance ≤ 2). Not checked yet Expands uri-scheme and special-chars payload lists in dalfox payload (uri-scheme grows from 5 to 11 entries). Not checked yet
+5 more
show less
Adds modern JavaScript framework detection during scanning. Not checked yet dalfox server now blocks browser-driven cross-site and DNS-rebinding requests by validating Origin , Sec-Fetch-Site , and Host headers. Not checked yet REST and MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. rate_limit now applies to discovery and mining phases, not only scanning. Not checked yet Cookie parameters are now injected as cookies rather than same-named headers, raising cookie recall from 80.0% to 87.5%. Not checked yet Introduces INTERNAL_ERROR status code on target_summary entries so a scanner panic is reported as skipped rather than silently falling through to clean. Not checked yet
10 details in Everything
Dalfox config reference adds state_file for resumable scans and documents raw-http, har, exact, and signature input options
└──▷ USE IT
Resume a large scan from where it left off after an interruption, skipping already-completed targets.
yaml
copy
state_file: /tmp/dalfox_state.json
Deduplicate scan targets by collapsing URLs that differ only in parameter values, cutting down redundant work.
Adds state_file config option to record completed targets and skip them on re-run, enabling resumable XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. scans. Not checked yet Documents raw-http and har as supported input sources in the config reference, allowing scans driven by raw HTTP request files or HAR HAR An HTTP Archive file, a JSON-format log of all network requests and responses captured by a browser's developer tools, used by cyber tools to replay, inspect, or analyze web traffic without re-running a live session. archives. Not checked yet
2 details in Everything
Dalfox MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. integration gains detailed scan parameters including WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. bypass modes, remote payloads, and blocking scan support
└──▷ USE IT
Run a blocking MCP scan with WAF bypass forced to Cloudflare profile and remote PortSwigger payloads, waiting up to 10 minutes for results.
json
copy
{
"waf_bypass": "force",
"force_waf": "cloudflare",
"waf_evasion": true,
"remote_payloads": ["portswigger"],
"wait": true,
"wait_timeout_sec": 600
}
Attach raw HTTP evidence to findings and route traffic through Burp Suite for a POST endpoint scan with cookie auth.
json
copy
{
"data": "user=admin&pass=test",
"cookies": "session=abc123",
"proxy": "http://127.0.0.1:8080",
"include_request": true,
"include_response": true
}
Run a fast smoke scan in CI by capping payloads per parameter and using Assetnote wordlists with a 500 ms delay.
json
copy
{
"remote_wordlists": ["assetnote"],
"max_payloads_per_param": 10,
"delay": 500,
"follow_redirects": true,
"wait": true,
"wait_timeout_sec": 120
}
Adds data field to MCP scan parameters for POST/PUT request bodies, accepting form-urlencoded ("user=admin&pass=test") or JSON strings. Not checked yet Adds cookies and user_agent fields to MCP scan parameters for per-scan cookie injection and User-Agent override. Not checked yet Adds delay field (default 0, range 0–9999 ms) and follow_redirects field to control request pacing and 3xx handling in MCP scans. Not checked yet Adds proxy field to route MCP scan traffic through an HTTP or SOCKS SOCKS A proxy protocol that relays TCP (and optionally UDP) connections through an intermediary server, letting cyber tools route traffic through a pivot host or anonymizing layer without needing raw network access. proxy (e.g. "http://127.0.0.1:8080"). Not checked yet Adds include_request and include_response fields (both default false) to attach raw HTTP request and response bodies to each finding for forensic analysis. Not checked yet
+5 more
show less
Adds five WAF control fields to MCP scan parameters: waf_bypass (mode: "auto", "force", or "off"), skip_waf_probe, force_waf (accepts "cloudflare", "akamai", "modsec"), waf_evasion, and waf_min_confidence (float in [0.0, 1.0], default 0.3). Not checked yet Adds remote_payloads and remote_wordlists fields (both default []) to pull extra XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. payloads ("portswigger", "payloadbox") and parameter wordlists ("burp", "assetnote") from remote providers before a scan starts. Not checked yet Adds max_payloads_per_param field to cap payloads tested per parameter; small values (e.g. 5–20) suitable for agent smoke scans. Not checked yet Adds wait field to make MCP scan calls blocking — instead of returning {scan_id, status: "queued"} immediately, the call blocks until the scan completes. Not checked yet Adds wait_timeout_sec field (default 300, range 1–86400) for the wall-clock budget on blocking scans; on timeout the job continues running and the response carries wait_timed_out: true. Not checked yet
10 details in Everything
Dalfox server mode gains analyze_external_js and five WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. config fields for DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. coverage and bypass control.
└──▷ USE IT
Scan an SPA whose DOM XSS sinks live in external JS bundles, with Cloudflare bypass forced and adaptive evasion enabled.
json
copy
{
"analyze_external_js": true,
"waf_bypass": "force",
"force_waf": "cloudflare",
"waf_evasion": true,
"waf_min_confidence": 0.5
}
Run WAF detection only (no bypass) with a high confidence floor to reduce false positives in the fingerprinting probe.
json
copy
{
"waf_bypass": "off",
"waf_min_confidence": 0.7
}
Adds analyze_external_js config field (default false) to fetch same-origin <script src> bundles at preflight and AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. -analyze them for DOM XSS sinks — useful for SPAs where sink logic lives in external bundles. Not checked yet Adds waf_bypass config field with modes "auto" (detect then bypass, default), "force" (use force_waf profile), or "off" (detect only) to control WAF handling behavior. Not checked yet Adds skip_waf_probe config field (default false) to skip the WAF fingerprinting probe entirely. Not checked yet Adds force_waf config field to pin a specific WAF profile (e.g. "cloudflare") instead of auto-detecting. Not checked yet Adds waf_evasion config field (default false) to enable adaptive WAF evasion. Not checked yet
+1 more
show less
Adds waf_min_confidence config field (range [0.0, 1.0], default 0.3) to set the detection confidence floor — fingerprints below this threshold are discarded. Not checked yet
6 details in Everything
Dalfox adds baseline diffing, session monitoring, state-file resume, and dedup modes for large-scale XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. scanning
└──▷ TRY IT
In CI, report only findings that are new since the last scan by diffing against the previous run's JSON report.
copy
$ dalfox url https://example.com -f json -o current.json --baseline previous.json --baseline-mode filter
Adds --dedup-urls with exact, signature, and no-dedup modes to collapse duplicate targets before scanning Not checked yet Adds --state-file to record completed targets and resume interrupted bulk scans without restarting from scratch Not checked yet Adds --baseline to compare results against a previous Dalfox JSON/JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. report and surface only newly introduced findings Not checked yet Adds --baseline-mode with filter (suppress known findings, adjust exit code) and annotate (keep all, tag new ones) modes Not checked yet Adds session monitoring to detect mid-scan authentication expiry and silent failures where a login redirect produces zero reported findings Not checked yet
+7 more
show less
Adds --session-check to specify a regex that must match the authenticated response body, overriding built-in heuristics Not checked yet Adds --session-check-url to designate a lightweight endpoint (e.g. /api/me) for session re-validation instead of the scan target Not checked yet Adds --on-session-loss with abort (halt target and skip same-host targets) or continue (keep scanning, preserve exit code) behaviors, marking affected targets as incomplete/SESSION_LOST Not checked yet Adds per-target wall-clock timeout (hard upper bound in seconds) to abort stalled endpoints during the scan phase Not checked yet Adds global request-rate cap friendly to shared IPs and edge WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. thresholds, with HTTP 429 always retried regardless of the setting Not checked yet Adds Interactsh integration to enable OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. /OAST OAST Out-of-band Application Security Testing: a technique for detecting vulnerabilities by having a target system make DNS or HTTP callbacks to an attacker-controlled server, revealing flaws that produce no visible in-band response. blind XSS detection with optional custom server domains Not checked yet Expands built-in payload categories to include dom-clobbering, mxss (mutation-XSS / sanitizer-bypass), blind (blind-XSS skeletons with {} OOB callback placeholder), and awesome-alert (screenshot-ready PoC payloads) Not checked yet
12 details in Everything
Dalfox gains MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. server integration and Caido Active Workflow support for AI-agent and proxy-driven XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. testing.
Exposes Dalfox as a tool via an MCP stdio server, making it available to any MCP-compatible client including Claude and Cursor. Not checked yet Adds drop-in instructions for skill-aware AI agents (Claude Code, Cursor, OpenCode, Codex) to safely invoke Dalfox. Not checked yet Integrates with Caido's Active Workflows and Findings to automate real-time XSS testing from within a proxy session. Not checked yet
3 details in Everything
Dalfox config gains baseline diffing, session-loss detection, and URL deduplication controls
└──▷ USE IT
Resume a large scan without re-testing already-completed targets, and only report findings not seen in a previous run
yaml
copy
# dalfox.yaml
state_file: "scan.state"
baseline: "baseline.json"
baseline_mode: "filter"
dedup_urls: "signature"
Abort a scan automatically if the authenticated session is lost mid-run
yaml
copy
# dalfox.yaml
session_check: "Welcome, "
session_check_url: "https://app.example.com/api/me"
on_session_loss: "abort"
Adds baseline config key to diff a new scan against a previous JSON/JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. report, surfacing only net-new findings Not checked yet Adds baseline_mode with filter (drops known findings) and annotate (keeps them, marks new) modes Not checked yet Adds mid-scan session-loss detection via session_check (regex on response body), session_check_url (dedicated probe), and on_session_loss (abort or continue) Not checked yet Adds dedup_urls config key with exact, signature (collapse URLs differing only in param values), and off modes Not checked yet Adds state_file config key to record completed targets and skip them on re-run (CLI only) Not checked yet
5 details in Everything
Dalfox server mode gains session-expiry detection, flagging SESSION_LOST when credentials expire mid-scan.
Detects expired sessions mid-scan: when credentials (cookie or Authorization header) are supplied, Dalfox fingerprints the authenticated response before scanning and re-checks it at completion, ending the scan with a SESSION_LOST signal if the session died rather than silently returning zero findings. Not checked yet
1 detail in Everything
Dalfox gains baseline diffing to suppress known findings in CI gates, with filter and annotate modes.
└──▷ TRY IT
Record a full-backlog baseline on first run, then gate CI on new findings only — the build goes red only when something new appears.
copy
$ # Record baseline once
dalfox scan scope.txt -f json -o .dalfox/baseline.json
# Every CI run after — exits non-zero only on new findings
dalfox scan scope.txt \
--baseline .dalfox/baseline.json \
--only-poc v \
-f json -o dalfox.json --silence
Use annotate mode to keep the full finding set while marking novelty, useful for dashboards that need historical and new findings together.
copy
$ dalfox scan scope.txt \
--baseline .dalfox/baseline.json \
--baseline-mode annotate \
-f json -o dalfox-annotated.json
Refresh the baseline after triage without accidentally overwriting it with a diff-only report — omit --baseline so the output holds the full set.
copy
$ dalfox scan scope.txt -f json -o .dalfox/baseline.json
git commit -am "chore: refresh dalfox baseline"
New --baseline flag suppresses previously known findings by diffing against a prior JSON/JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. report, so CI gates only fail on genuinely new XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. findings. Not checked yet Two baseline modes: --baseline-mode filter (drops known findings from counts, output, and exit code) and --baseline-mode annotate (keeps all findings and tags each with new: true / new: false for dashboards). Not checked yet Structured output Structured output Forcing a model's response to match a given format or JSON schema, so software can parse it reliably instead of hoping the text is well formed. gains a meta.baseline block reporting path, mode, enabled state, total baseline findings, new count, and known count. Not checked yet Session-loss mid-scan now emits "status": "incomplete" with "error_code": "SESSION_LOST" and a "error_message" field, plus a top-level incomplete flag in the report envelope. Not checked yet Report envelope adds dedup_mode and targets_deduplicated fields showing how many targets --dedup-urls collapsed. Not checked yet
+1 more
show less
Baseline fingerprinting matches findings on host+path, parameter name, parameter location, injection context, CWE CWE Common Weakness Enumeration, a catalog of recurring software and hardware weakness types. It describes classes of mistakes, such as injection, rather than individual vulnerability instances. , finding tier, and evidence family — intentionally excluding payload and AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. line numbers so re-runs and bundler rebuilds don't resurrect triaged findings. Not checked yet
6 details in Everything
Dalfox gains a payload subcommand with named selectors for special chars, sinks, PoC alerts, DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. clobbering, mXSS, and blind-XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. payloads.
└──▷ TRY IT
Quickly count how many special characters Dalfox considers relevant — useful before manual reflection testing to scope your character-probe list.
copy
$ dalfox payload special-chars | wc -l
Filter the confirmable-sink list down to prompt-based payloads when alert is blocked by the target's CSP CSP Content Security Policy: a browser security mechanism, standardized by the W3C, that lets a web server declare which sources of scripts, styles, and other resources a page may load, blocking injection attacks. or JS environment.
copy
$ dalfox payload functions | grep -i prompt
New dalfox payload subcommand lets practitioners query built-in payload libraries by named selector: special-chars, functions, awesome-alert, dom-clobbering, mxss, and blind. Not checked yet Each selector prints one payload per line, making the output directly composable with standard shell tools like grep and wc. Not checked yet Adds CSP-aware payload generation: when a Content-Security-Policy header is present, Dalfox tailors output to DOM script-gadgets and emits nonce-based policy-callback payloads. Not checked yet Adds mxss selector surfacing mutation-XSS and sanitizer-bypass vectors for testing HTML sanitizer pipelines. Not checked yet Adds blind selector emitting blind-XSS callback skeletons (with {} as a placeholder for a callback URL) for out-of-band impact confirmation. Not checked yet
5 details in Everything
Dalfox gains URL deduplication by parameter signature, resumable scans via state file, and authenticated session monitoring.
└──▷ TRY IT
Collapse thousands of harvested value-variant URLs into one scan per unique endpoint so your --max-targets-per-host budget covers different endpoints rather than one endpoint's parameter values.
copy
$ gau target.app | dalfox scan --dedup-urls signature
Resume a large scan that was interrupted by Ctrl-C or a dropped SSH session without re-scanning already-completed targets.
copy
$ dalfox scan --input-type file urls.txt --state-file scan.state
Scan an authenticated app and detect session expiry using an exact string marker and a cheap dedicated probe endpoint, aborting the host group if the session is lost.
copy
$ dalfox scan https://app.example.com/dashboard?q=1 --cookies sid=$SESSION --session-check 'Signed in as' --session-check-url https://app.example.com/api/me --on-session-loss abort
Adds --dedup-urls signature mode to collapse near-duplicate URLs by method, scheme, host, port, path, and sorted parameter names — so a recon dump of thousands of value variants scans each unique endpoint once instead of thousands of times. Not checked yet Adds --dedup-urls off to disable all deduplication when every input line must be scanned as given. Not checked yet Adds --state-file flag to record scan progress and resume interrupted runs, skipping already-completed targets while retrying cancelled or errored ones. Not checked yet Adds --session-check <marker> and --session-check-url <url> flags to explicitly specify authenticated response markers and a dedicated probe endpoint for session monitoring. Not checked yet Adds --on-session-loss abort|continue to control scan behavior when a session expiry is detected — defaulting to stopping the affected host group and exiting with code 2 when no findings were made. Not checked yet
+1 more
show less
Introduces automated session monitoring that fingerprints the authenticated response during preflight and re-probes after each target's injection stage, detecting session loss via status code changes, redirect-to-login, or appearance of a password field. Not checked yet
6 details in Everything
Dalfox gains URL deduplication, scan resumption, baseline diffing, and session-loss detection for mass XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. scans.
Adds --dedup-urls flag with exact (drop identical URL+method) and signature (collapse URLs differing only in parameter values) modes to reduce redundant scanning in large target sets. Not checked yet Adds --state-file to record completed targets and resume interrupted mass scans from where they left off instead of restarting. Not checked yet Adds --baseline to diff a new scan against a previous Dalfox JSON/JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. report, surfacing only net-new findings. Not checked yet Adds --baseline-mode with filter (exclude known findings from counts and exit code) and annotate (keep all findings but mark new ones) modes for CI-friendly baseline workflows. Not checked yet Adds session monitoring that detects when an authenticated session expires mid-scan, preventing silent zero-finding runs caused by login-page responses. Not checked yet
+4 more
show less
Adds --session-check to supply a regex that must keep matching authenticated response bodies, overriding built-in heuristics. Not checked yet Adds --session-check-url to probe a lightweight endpoint (e.g. /api/me) for session re-validation instead of the scan target. Not checked yet Adds --on-session-loss with abort (stop affected target, skip host, exit non-zero if nothing found) and continue (keep scanning, leave exit code unchanged) policies; affected targets are always reported as incomplete/SESSION_LOST. Not checked yet Adds new built-in payload categories: dom-clobbering vectors, mxss mutation-XSS/sanitizer-bypass payloads, awesome-alert polished PoCs, and blind blind-XSS skeletons with OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. callback placeholder. Not checked yet
9 details in Everything
Dalfox v3.2.0 adds mass-scan resumption, baseline diffing, dedup, six new DOM-XSS DOM-XSS A cross-site scripting vulnerability where malicious JavaScript executes entirely in the browser by manipulating the DOM, never touching the server, making it invisible to server-side input filters. sinks, HTTP QUERY method, and richer finding metadata.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.2.0 https://github.com/hahwul/dalfox.git
$ git checkout v3.2.0
└──▷ TRY IT
Resume a large mass scan that was interrupted — targets already scanned are skipped automatically.
copy
$ dalfox scan urls.txt --state-file scan-state.json
New --state-file flag lets mass scans resume from where they left off, skipping already-completed targets. Not checked yet New --baseline flag filters output to only findings that are new since a previous run, enabling diff-style reporting. Not checked yet New --dedup-urls flag performs signature-level deduplication on large URL lists before scanning begins. Not checked yet Session-loss detection now warns when authentication expires mid-scan rather than silently returning zero findings. Not checked yet Six new DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. -XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. sinks detected: drag-drop events, async clipboard API, FileReader, setAttributeNS, indirect eval, and DOMParser . Not checked yet
+4 more
show less
Supports the HTTP QUERY method (RFC 10008) for scanning targets that use it. Not checked yet MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. server gains max_payloads_per_param control and a synchronous wait mode for agent workflows. Not checked yet Expanded dalfox payload selectors: special-chars, functions, awesome-alert, dom-clobbering, mxss, and blind. Not checked yet Findings now carry three separate metadata axes: confidence, detection method, and impact. Not checked yet
9 details in Everything
Dalfox gains an MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. integration, exposing XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. scanning as a structured async service with progress tracking and rich findings.
└──▷ TRY IT
Start an async MCP-driven XSS scan from an AI agent or MCP-aware tool, scoping it to a single parameter with a blind-XSS callback.
copy
$ dalfox mcp --target "https://example.com/search?q=test" --method GET --param q --blind_callback_url "https://callback.example" --workers 50 --deep_scan
Configure an MCP server entry so an LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. agent can invoke Dalfox scans with full option support, including custom auth headers and URL+HTML encoding.
json
copy
{
"mcpServers": {
"dalfox": {
"command": "dalfox",
"args": [
"mcp",
"--target", "https://example.com/search?q=test",
"--method", "GET",
"--param", "q",
"--headers", "Authorization: Bearer token",
"--encoders", "url",
"--encoders", "html",
"--timeout", "10",
"--workers", "50",
"--blind_callback_url", "https://callback.example",
"--deep_scan"
]
}
}
}
Adds dalfox mcp subcommand to expose Dalfox scanning via the Model Context Protocol Model Context Protocol Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. (MCP), enabling AI agents and toolchains to drive scans programmatically. Not checked yet MCP scan jobs are asynchronous and return a scan_id immediately, with pollable status (queued → running → done) and per-poll progress metrics including params_tested, requests_sent, findings_so_far, and estimated_completion_pct. Not checked yet MCP findings include structured enrichment: type_description, detection_method, confidence, confidence_reason, inject_type, payload, evidence, cwe, and severity fields per result. Not checked yet MCP interface supports key scan options as named parameters: target, method, param, headers, encoders, timeout, scan_timeout, workers, rate_limit, insecure, blind_callback_url, deep_scan, skip_ast_analysis, analyze_external_js, detect_outdated_libs, skip_discovery, and skip_mining. Not checked yet Encoder names passed to encoders are validated at submission time — unknown encoder names are rejected outright rather than silently reducing payload coverage. Not checked yet
+2 more
show less
The method parameter is validated against the accepted HTTP verb set and auto-uppercased (e.g. "post" → "POST"), preventing misconfigured scans from placing the wrong method on the wire. Not checked yet MCP results include a suggested_poll_interval_ms hint to guide callers on how frequently to check scan status. Not checked yet
7 details in Everything
Dalfox server mode gains CORS CORS A browser mechanism that lets a server declare which foreign origins may read its HTTP responses, enforced by the browser to block unauthorized cross-site requests from JavaScript. controls, scan-progress polling, preflight checks, and a payload-cap option via its REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. .
└──▷ TRY IT
Start the Dalfox server with CORS restrictions so only your app origins can reach the API.
copy
$ dalfox server --port 6664 --host 0.0.0.0 --allowed-origins "https://app.example.com,https://admin.example.com" --cors-allow-methods "GET,POST,OPTIONS,DELETE" --cors-allow-headers "Content-Type,X-API-KEY,Authorization"
Queue a scan, then poll for live progress — useful in CI to stream findings as they arrive.
copy
$ # Submit the scan
curl -X POST http://127.0.0.1:6664/scan \
-H "X-API-KEY: change-me" \
-H "Content-Type: application/json" \
-d '{"target":"https://target.app?q=test"}'
# Poll progress (use suggested_poll_interval_ms from response to pace requests)
curl -H "X-API-KEY: change-me" http://127.0.0.1:6664/scan/9f2c…
Run a quick smoke scan by capping payloads per parameter, then cancel if it runs too long.
copy
$ # Launch a capped smoke scan
curl -X POST http://127.0.0.1:6664/scan \
-H "X-API-KEY: change-me" \
-H "Content-Type: application/json" \
-d '{"target":"https://target.app?q=test","max_payloads_per_param":10}'
# Cancel if needed
curl -X DELETE -H "X-API-KEY: change-me" http://127.0.0.1:6664/scan/9f2c…
Adds --allowed-origins, --cors-allow-methods, and --cors-allow-headers flags to the server mode for fine-grained CORS policy control. Not checked yet New GET /scan/{id} polling endpoint returns real-time progress including params_tested, requests_sent, findings_so_far, estimated_completion_pct, and suggested_poll_interval_ms. Not checked yet New GET /scans?status=<status> endpoint lets operators list scans filtered by state (e.g. running). Not checked yet New DELETE /scan/{id} endpoint allows cancellation of in-flight scans. Not checked yet New POST /preflight endpoint checks a target URL before committing to a full scan. Not checked yet
+3 more
show less
Adds max_payloads_per_param scan option to cap how many payloads are tested per parameter, enabling fast smoke scans. Not checked yet Server mode now validates and uppercases the method field and rejects unknown encoder names rather than silently misconfiguring scans. Not checked yet Documents systemd unit configuration for running Dalfox server as a hardened background service with DALFOX_API_KEY via environment variable. Not checked yet
8 details in Everything
Dalfox v3.1.1 unifies server/MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. scan target params, consolidates debug logging, and bounds request fan-out for safer large scans.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.1.1 https://github.com/hahwul/dalfox.git
$ git checkout v3.1.1
└──▷ TRY IT
Pipe a HAR HAR An HTTP Archive file, a JSON-format log of all network requests and responses captured by a browser's developer tools, used by cyber tools to replay, inspect, or analyze web traffic without re-running a live session. capture through dalfox using an explicit input type — now correctly honoured by the pipe subcommand after the parity fix.
copy
$ cat capture.har | dalfox pipe -i har --output results.json
Debug a scan against a REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. server using the unified target parameter (replacing the old url field for server/MCP calls).
copy
$ curl -s -X POST http://localhost:6664/scan -H 'Content-Type: application/json' -d '{"target": "https://example.com/search?q=test"}'
Unifies scan target parameter: Server and MCP modes now accept target (REST retains url as a backward-compatible alias). Not checked yet Consolidates all debug output through a single stderr dbg_log! macro, keeping JSON/JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. /SARIF SARIF Static Analysis Results Interchange Format, a standard for sharing code-analysis findings, including locations and rule details. It lets scanners report results to a common review interface. stdout clean under --debug. Not checked yet Aligns OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. /blind XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. lifecycle messages with the standard timestamped log format (INF/WRN/OOB), making output consistent across scan modes. Not checked yet Per-parameter payload safety cap and recall-preserving DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. -phase early-exit bound request fan-out, preventing runaway HTTP requests on wide parameter sets. Not checked yet Bounds unbounded task spawning in parameter mining and cuts server hot-path lock-hold and allocations, improving reliability under load. Not checked yet
5 details in Everything
Dalfox v3.1.1 unifies server/MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. scan target params, consolidates debug logging, and bounds request fan-out for safer large scans.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.1.1 https://github.com/hahwul/dalfox.git
$ git checkout v3.1.1
└──▷ TRY IT
Pipe a HAR HAR An HTTP Archive file, a JSON-format log of all network requests and responses captured by a browser's developer tools, used by cyber tools to replay, inspect, or analyze web traffic without re-running a live session. capture through dalfox using an explicit input type — now correctly honoured by the pipe subcommand after the parity fix.
copy
$ cat capture.har | dalfox pipe -i har --output results.json
Debug a scan against a REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. server using the unified target parameter (replacing the old url field for server/MCP calls).
copy
$ curl -s -X POST http://localhost:6664/scan -H 'Content-Type: application/json' -d '{"target": "https://example.com/search?q=test"}'
Unifies scan target parameter: Server and MCP modes now accept target (REST retains url as a backward-compatible alias). Not checked yet Consolidates all debug output through a single stderr dbg_log! macro, keeping JSON/JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. /SARIF SARIF Static Analysis Results Interchange Format, a standard for sharing code-analysis findings, including locations and rule details. It lets scanners report results to a common review interface. stdout clean under --debug. Not checked yet Aligns OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. /blind XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. lifecycle messages with the standard timestamped log format (INF/WRN/OOB), making output consistent across scan modes. Not checked yet Per-parameter payload safety cap and recall-preserving DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. -phase early-exit bound request fan-out, preventing runaway HTTP requests on wide parameter sets. Not checked yet Bounds unbounded task spawning in parameter mining and cuts server hot-path lock-hold and allocations, improving reliability under load. Not checked yet
5 details in Everything
Dalfox 3.1.1 unifies target parameter, enforces -i for stdin/file/pipe, bounds fan-out with per-payload cap and DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. early exit.
└──▷ GET THIS VERSION
copy
$ git clone --branch 3.1.1 https://github.com/hahwul/dalfox.git
$ git checkout 3.1.1
└──▷ TRY IT
Force stdin input by explicitly passing -i when piping a URL list.
copy
$ cat targets.txt | dalfox pipe -i --config /etc/dalfox/config.yaml
--target (alias -t) now serves as the unified argument for all scan types, including MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. server URLs; url remains a REST alias only Not checked yet url, file, and pipe input sources now properly load config files, apply global flags, and require explicit -i flag to read from stdin Not checked yet
2 details in Everything
Dalfox v3.1.0 adds blind/OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. via interactsh, HAR HAR An HTTP Archive file, a JSON-format log of all network requests and responses captured by a browser's developer tools, used by cyber tools to replay, inspect, or analyze web traffic without re-running a live session. input, external JS analysis, CSP CSP Content Security Policy: a browser security mechanism, standardized by the W3C, that lets a web server declare which sources of scripts, styles, and other resources a page may load, blocking injection attacks. /Trusted Types awareness, and a global rate limiter.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.1.0 https://github.com/hahwul/dalfox.git
$ git checkout v3.1.0
└──▷ TRY IT
Analyze external JS bundles and flag outdated vulnerable libraries in a single authenticated crawl.
copy
$ dalfox url https://app.example.com --analyze-external-js --detect-outdated-libs --header 'Cookie: session=<token>'
Adds --blind-oob for out-of-band XSS detection using an interactsh OAST OAST Out-of-band Application Security Testing: a technique for detecting vulnerabilities by having a target system make DNS or HTTP callbacks to an attacker-controlled server, revealing flaws that produce no visible in-band response. server, catching stored, async, and non-reflecting sinks. Not checked yet Adds --analyze-external-js to fetch and AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. -analyze same-origin <script src> bundles (up to 16 files / 512 KiB) for DOM-XSS DOM-XSS A cross-site scripting vulnerability where malicious JavaScript executes entirely in the browser by manipulating the DOM, never touching the server, making it invisible to server-side input filters. sinks. Not checked yet Adds --detect-outdated-libs to flag known-vulnerable front-end library versions as informational findings. Not checked yet Adds CSP and Trusted Types awareness, emitting strict-dynamic/nonce gadget payloads and adapting to Trusted Types policies. Not checked yet Adds filter-aware payload synthesis that computes exact JS breakout sequences from the observed script prefix, including escaped-quote and nested-context cases. Not checked yet
+9 more
show less
Adds four attribute-decode WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. -bypass mutations (KeywordEntityEncode, SchemeBreak, EntityScheme, MultiSlash) exploiting HTML tokenizer entity decoding. Not checked yet Adds size-limited WAF inspection-window bypass, positioning payloads past the byte boundary WAFs inspect. Not checked yet Adds --input-type har to accept HAR/proxy exports (Burp, Caido, ZAP, DevTools, mitmproxy) as a scan source. Not checked yet Adds --rate-limit / -r / --rl for a global requests-per-second token bucket shared across all workers and targets. Not checked yet Adds --retries and --retry-delay for optional exponential-backoff retries on HTTP 5xx and transient transport errors. Not checked yet Adds --insecure flag to make TLS certificate validation configurable for scan, server, and mcp modes. Not checked yet Adds scan_timeout configuration for server and MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. modes to bound total scan duration for concurrent REST/MCP jobs. Not checked yet Extends structured output structured output Forcing a model's response to match a given format or JSON schema, so software can parse it reliably instead of hoping the text is well formed. metadata (version, targets, duration, request/finding counts, per-target WAF info) to SARIF SARIF Static Analysis Results Interchange Format, a standard for sharing code-analysis findings, including locations and rule details. It lets scanners report results to a common review interface. , Markdown, and TOML TOML A configuration file format designed to be minimal and readable, mapping unambiguously to a hash table; cyber tools use it as a structured alternative to YAML or INI for config files. formats. Not checked yet Widens DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. -XSS sink coverage with Document.parseHTMLUnsafe() and window.open() as modeled sinks. Not checked yet
14 details in Everything
Dalfox v3.1.0 adds blind/OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. , HAR HAR An HTTP Archive file, a JSON-format log of all network requests and responses captured by a browser's developer tools, used by cyber tools to replay, inspect, or analyze web traffic without re-running a live session. input, external JS analysis, CSP CSP Content Security Policy: a browser security mechanism, standardized by the W3C, that lets a web server declare which sources of scripts, styles, and other resources a page may load, blocking injection attacks. /Trusted Types payloads, and a global rate limiter.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.1.0 https://github.com/hahwul/dalfox.git
$ git checkout v3.1.0
└──▷ TRY IT
Detect stored/async XSS in a target that never reflects payloads back — catch blind execution via an interactsh OOB callback.
copy
$ dalfox scan https://target.example.com --blind-oob
Replay every request captured in a proxy session (Burp/Caido/ZAP) as a scan source, feeding all recorded targets at once.
copy
$ dalfox scan export.har --input-type har --output json -o results.json
Cap aggregate outbound rate to 20 RPS across all workers while also pulling in external JS bundles for DOM-XSS DOM-XSS A cross-site scripting vulnerability where malicious JavaScript executes entirely in the browser by manipulating the DOM, never touching the server, making it invisible to server-side input filters. analysis — useful for rate-sensitive bug-bounty targets.
copy
$ dalfox scan https://target.example.com --rate-limit 20 --analyze-external-js
Adds --blind-oob for out-of-band (OAST OAST Out-of-band Application Security Testing: a technique for detecting vulnerabilities by having a target system make DNS or HTTP callbacks to an attacker-controlled server, revealing flaws that produce no visible in-band response. ) XSS detection via interactsh, catching stored and async sinks that never reflect. Not checked yet Adds --input-type har to accept HAR exports from Burp, Caido, ZAP, mitmproxy, or DevTools as a scan source. Not checked yet Adds --analyze-external-js to fetch and run AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. -XSS analysis on a target's same-origin <script src> bundles (capped at 16 files / 512 KiB). Not checked yet Adds --detect-outdated-libs (opt-in) to flag known-vulnerable front-end library versions as informational findings. Not checked yet Adds CSP & Trusted Types awareness: emits strict-dynamic / nonce gadget payloads and adapts when a Trusted Types policy is detected. Not checked yet
+9 more
show less
Adds filter-aware payload synthesis that computes exact JS breakout sequences from the observed script prefix, including escaped-quote and nested-context cases. Not checked yet Adds four attribute-decode WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. -bypass mutations (KeywordEntityEncode, SchemeBreak, EntityScheme, MultiSlash) exploiting HTML tokenizer entity decoding. Not checked yet Adds size-limited WAF inspection-window bypass: detects WAFs that inspect only the first N bytes and positions payloads past the inspection window. Not checked yet Adds global rate limiting via --rate-limit / -r / --rl (requests-per-second token bucket, 0 = unlimited) shared across all workers and targets. Not checked yet Adds --retries / --retry-delay for optional exponential-backoff retries on HTTP 5xx and transient errors (HTTP 429 is always retried). Not checked yet Adds --insecure TLS flag to make certificate validation configurable for scan, server, and mcp modes. Not checked yet Adds scan_timeout whole-scan budget for server and MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. modes to bound total duration of concurrent async jobs. Not checked yet Extends DOM-XSS sink coverage to include Document.parseHTMLUnsafe() and window.open() . Not checked yet Structured output Structured output Forcing a model's response to match a given format or JSON schema, so software can parse it reliably instead of hoping the text is well formed. metadata (version, targets, duration, request/finding counts, per-target WAF info) now included in SARIF SARIF Static Analysis Results Interchange Format, a standard for sharing code-analysis findings, including locations and rule details. It lets scanners report results to a common review interface. , Markdown, and TOML TOML A configuration file format designed to be minimal and readable, mapping unambiguously to a hash table; cyber tools use it as a structured alternative to YAML or INI for config files. formats. Not checked yet
14 details in Everything
Dalfox v3.1.0 adds blind/OOB OOB Out-of-band communication: a separate channel from the primary data path, used to send control signals or exfiltrate data without touching monitored traffic, giving cyber tools a covert or resilient side channel. XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. , HAR HAR An HTTP Archive file, a JSON-format log of all network requests and responses captured by a browser's developer tools, used by cyber tools to replay, inspect, or analyze web traffic without re-running a live session. input, external JS analysis, CSP CSP Content Security Policy: a browser security mechanism, standardized by the W3C, that lets a web server declare which sources of scripts, styles, and other resources a page may load, blocking injection attacks. /Trusted Types payloads, and a global rate limiter.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.1.0 https://github.com/hahwul/dalfox.git
$ git checkout v3.1.0
└──▷ TRY IT
Detect stored/async XSS in a target that never reflects payloads back — catch blind execution via an interactsh OOB callback.
copy
$ dalfox scan https://target.example.com --blind-oob
Replay every request captured in a proxy session (Burp/Caido/ZAP) as a scan source, feeding all recorded targets at once.
copy
$ dalfox scan export.har --input-type har --output json -o results.json
Cap aggregate outbound rate to 20 RPS across all workers while also pulling in external JS bundles for DOM-XSS DOM-XSS A cross-site scripting vulnerability where malicious JavaScript executes entirely in the browser by manipulating the DOM, never touching the server, making it invisible to server-side input filters. analysis — useful for rate-sensitive bug-bounty targets.
copy
$ dalfox scan https://target.example.com --rate-limit 20 --analyze-external-js
Adds --blind-oob for out-of-band (OAST OAST Out-of-band Application Security Testing: a technique for detecting vulnerabilities by having a target system make DNS or HTTP callbacks to an attacker-controlled server, revealing flaws that produce no visible in-band response. ) XSS detection via interactsh, catching stored and async sinks that never reflect. Not checked yet Adds --input-type har to accept HAR exports from Burp, Caido, ZAP, mitmproxy, or DevTools as a scan source. Not checked yet Adds --analyze-external-js to fetch and run AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. -XSS analysis on a target's same-origin <script src> bundles (capped at 16 files / 512 KiB). Not checked yet Adds --detect-outdated-libs (opt-in) to flag known-vulnerable front-end library versions as informational findings. Not checked yet Adds CSP & Trusted Types awareness: emits strict-dynamic / nonce gadget payloads and adapts when a Trusted Types policy is detected. Not checked yet
+9 more
show less
Adds filter-aware payload synthesis that computes exact JS breakout sequences from the observed script prefix, including escaped-quote and nested-context cases. Not checked yet Adds four attribute-decode WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. -bypass mutations (KeywordEntityEncode, SchemeBreak, EntityScheme, MultiSlash) exploiting HTML tokenizer entity decoding. Not checked yet Adds size-limited WAF inspection-window bypass: detects WAFs that inspect only the first N bytes and positions payloads past the inspection window. Not checked yet Adds global rate limiting via --rate-limit / -r / --rl (requests-per-second token bucket, 0 = unlimited) shared across all workers and targets. Not checked yet Adds --retries / --retry-delay for optional exponential-backoff retries on HTTP 5xx and transient errors (HTTP 429 is always retried). Not checked yet Adds --insecure TLS flag to make certificate validation configurable for scan, server, and mcp modes. Not checked yet Adds scan_timeout whole-scan budget for server and MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. modes to bound total duration of concurrent async jobs. Not checked yet Extends DOM-XSS sink coverage to include Document.parseHTMLUnsafe() and window.open() . Not checked yet Structured output Structured output Forcing a model's response to match a given format or JSON schema, so software can parse it reliably instead of hoping the text is well formed. metadata (version, targets, duration, request/finding counts, per-target WAF info) now included in SARIF SARIF Static Analysis Results Interchange Format, a standard for sharing code-analysis findings, including locations and rule details. It lets scanners report results to a common review interface. , Markdown, and TOML TOML A configuration file format designed to be minimal and readable, mapping unambiguously to a hash table; cyber tools use it as a structured alternative to YAML or INI for config files. formats. Not checked yet
14 details in Everything
Dalfox v3.0.1 adds jQuery/import() /fetch() DOM-XSS DOM-XSS A cross-site scripting vulnerability where malicious JavaScript executes entirely in the browser by manipulating the DOM, never touching the server, making it invisible to server-side input filters. sinks, NetScaler WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. fingerprints, and native .deb/.rpm/musl/Snap/AUR packages.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.0.1 https://github.com/hahwul/dalfox.git
$ git checkout v3.0.1
Adds DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. -XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. analysis for jQuery $()/jQuery() selector-to-HTML sinks, dynamic import() execution sinks, and fetch() /XMLHttpRequest response sources. Not checked yet Adds WAF fingerprints for NetScaler and cookie-based signatures, plus generalized bypass mutations shared across vendors. Not checked yet Adds native .deb and .rpm packages, musl static binaries for x86_64-musl and aarch64-musl, and distribution via Snapcraft and AUR. Not checked yet
3 details in Everything
Dalfox v3 rewrites in Rust with AST AST An abstract syntax tree, a structured representation of parsed code. Tools inspect or transform this tree to understand expressions and statements rather than just matching text. -based JS analysis, MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. server, async REST API REST API A web API design style where clients interact with resources over HTTP using standard methods like GET, POST, and DELETE, giving cyber tools a predictable, language-agnostic way to integrate with external services. , SARIF SARIF Static Analysis Results Interchange Format, a standard for sharing code-analysis findings, including locations and rule details. It lets scanners report results to a common review interface. output, and new scan-control flags.
└──▷ GET THIS VERSION
copy
$ git clone --branch v3.0.0 https://github.com/hahwul/dalfox.git
$ git checkout v3.0.0
└──▷ TRY IT
Output findings in SARIF format to integrate directly with GitHub Code Scanning in CI.
copy
$ dalfox scan url https://example.com/search?q=test --format sarif > results.sarif
Do a preflight dry-run to validate your scan configuration and targets before sending any payloads.
copy
$ dalfox scan url https://example.com/search?q=test --dry-run --max-payloads-per-param 10 --scan-timeout 30
New AST-based JS analysis via oxc replaces headless browsers for fast, accurate DOM-XSS DOM-XSS A cross-site scripting vulnerability where malicious JavaScript executes entirely in the browser by manipulating the DOM, never touching the server, making it invisible to server-side input filters. detection. Not checked yet New dalfox mcp subcommand launches an MCP stdio server to expose Dalfox scanning tools to AI coding assistants. Not checked yet Async REST API server rebuilt on axum with job queueing, real-time cancellation, and webhook notifications. Not checked yet Adds markdown, sarif (GitHub Code Scanning), and toml output formats alongside TOML TOML A configuration file format designed to be minimal and readable, mapping unambiguously to a hash table; cyber tools use it as a structured alternative to YAML or INI for config files. /JSON config file support. Not checked yet New --dry-run preflight mode runs a scan without sending payloads, and --stream-findings surfaces results immediately. Not checked yet
+4 more
show less
New --max-payloads-per-param and --scan-timeout flags cap scan resource usage for controlled environments. Not checked yet Unified scan subcommand consolidates all target scan paths; legacy aliases url, file, and pipe remain for backward compatibility. Not checked yet Exit codes standardized: 0 clean, 1 findings, 2 errors — enabling reliable CI pipeline integration. Not checked yet Per-target progress bars replace spinners; banners are automatically suppressed in silent or machine-readable modes. Not checked yet
9 details in Everything
└──▷ BREAKING ON UPGRADE
! Complete rewrite in Rust — the Go implementation moves to the v2 branch; the v3 binary is a different runtime.! The --found-action, --grep, --report, and --max-cpu flags are removed with no direct replacements.! The Chromium/chromedp headless browser engine and all headless-related CLI flags are removed.! Non-XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. (BAV) vulnerability checkers are removed; Dalfox v3 is strictly an XSS scanner.! The --cookie-from-raw flag is excluded from the MCP tool interface (sandbox restriction).
advisory CVE-2026-45088
May 7, 2026
·
issue 128
CVE-2026-45088: Unauthenticated Arbitrary File Read with Out-of-Band Exfiltration via custom-payload-file in Dalfox Server Mode (CVSS CVSS Common Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 7.5, affects <= 2.12.0)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
advisory CVE-2026-45090
May 7, 2026
·
issue 128
CVE-2026-45090: Unauthenticated Remote DoS via Closed-Channel Write in ParameterAnalysis (server mode) (CVSS CVSS Common Vulnerability Scoring System, a method for describing a vulnerability's characteristics and severity. Its score is not the probability that attackers will exploit it. 7.5, affects <= 2.12.0)︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄ Not checked yet
Dalfox v2.13.0 adds out-of-scope filtering, early-stop mode, JSON body XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. testing, and 10 new secret-pattern regexes.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.13.0 https://github.com/hahwul/dalfox.git
$ git checkout v2.13.0
Adds --out-of-scope domain filtering to exclude irrelevant domains from scans. Not checked yet Adds early-stop scan mode to halt on first result, with result-type filtering. Not checked yet Adds JSON body parameter testing for XSS, enabling coverage of API endpoints that accept JSON payloads. Not checked yet Expands secret-pattern grep ruleset with 10 new providers: Sentry, Netlify, Firebase, GitLab, SendGrid, Dropbox, Asana, DigitalOcean, Linear, and Shopify. Not checked yet Hardens REST/MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. server mode by stripping CLI-only options (filesystem and shell fields) at the API boundary, closing one Critical and three High-severity advisories. Not checked yet
5 details in Everything
Dalfox v2.12.0 adds custom blind XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. payloads, markdown reports, raw HTTP pipe mode, API key auth, and new XSS bypass payloads.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.12.0 https://github.com/hahwul/dalfox.git
$ git checkout v2.12.0
└──▷ TRY IT
Inject a custom blind XSS payload (e.g., pointing to your own callback server) instead of relying on built-in blind payloads.
copy
$ dalfox url https://target.example.com/search?q=test --blind https://your-callback.example.com --custom-blind-xss-payload '<script src="https://your-callback.example.com/payload.js"></script>'
Adds --custom-blind-xss-payload flag to supply user-defined blind XSS payloads at scan time. Not checked yet Adds DELETE endpoints to the server API for scan data management. Not checked yet Adds API key-based authentication for server mode. Not checked yet Adds CORS CORS A browser mechanism that lets a server declare which foreign origins may read its HTTP responses, enforced by the browser to block unauthorized cross-site requests from JavaScript. and JSONP support for server mode. Not checked yet Adds raw HTTP request support to pipe mode, enabling scans directly from raw request files. Not checked yet
+4 more
show less
Adds markdown report format as an output option. Not checked yet Adds new <object> and <embed> codebase XSS payloads for filter-bypass coverage. Not checked yet Adds advanced XSS scanning features (PR #765). Not checked yet Improves help message with grouped flag display for easier navigation. Not checked yet
9 details in Everything
Dalfox v2.11.0 adds MCP MCP Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. server mode, JSONL JSONL A text format where each line is a self-contained, valid JSON object, making it easy to stream, append, and process large datasets line by line without parsing a full JSON array into memory. output format, and XDG_CONFIG_HOME support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.11.0 https://github.com/hahwul/dalfox.git
$ git checkout v2.11.0
└──▷ TRY IT
Stream XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. scan results as JSON Lines into downstream tools like jq or a SIEM SIEM Security information and event management, collecting logs from many systems and correlating events to find suspicious activity. Analysts use it to investigate alerts and incidents. ingestion pipeline.
copy
$ dalfox url https://example.com/search?q=test --format=jsonl | jq '.type'
Start Dalfox as an MCP server so LLM LLM A large language model, a neural network trained on large amounts of text to recognize patterns and generate language. Applications use it for tasks such as answering, summarizing and writing code. -based agents (e.g. Claude, Cursor) can invoke XSS scanning as a tool.
copy
$ dalfox server --type=mcp
New dalfox server --type=mcp mode exposes Dalfox as an MCP (Model Context Protocol Model Context Protocol Model Context Protocol, a standard for connecting AI applications to external tools and data sources. A compatible server exposes capabilities an assistant can use through a common interface. ) server for LLM/AI tool integration. Not checked yet New --format=jsonl output option emits results as JSON Lines, enabling streaming pipeline-friendly processing. Not checked yet Supports XDG_CONFIG_HOME for standardized config file storage per the XDG XDG A set of specifications maintained by freedesktop.org that standardise where Linux applications store config, data, and cache files, letting tools respect user-defined paths instead of hardcoding locations. Base Directory Specification. Not checked yet
3 details in Everything
Dalfox v2.10.0 adds BAV opt-in flag, skip-discovery, result limits, force headless verification, and new XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. payload patterns.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.10.0 https://github.com/hahwul/dalfox.git
$ git checkout v2.10.0
└──▷ TRY IT
Re-enable BAV scanning on a target after upgrading, since it is now off by default.
copy
$ dalfox url https://example.com/search?q=test --use-bav
Adds --use-bav flag to explicitly opt into BAV (Blind-XSS Assisted Verification) scanning, which is now disabled by default. Not checked yet Adds option to skip the discovery phase, letting practitioners scan known endpoints without reconnaissance overhead. Not checked yet Adds result limit option for file and pipe commands to cap output volume. Not checked yet Adds force headless verification option to drive Chrome-based payload confirmation on demand. Not checked yet Adds custom transport support for HTTP-level customization of scan requests. Not checked yet
+1 more
show less
Adds new XSS payload and comment patterns, expanding detection coverage. Not checked yet
6 details in Everything
└──▷ BREAKING ON UPGRADE
! BAV (Blind-XSS Assisted Verification) is now disabled by default; existing workflows that relied on BAV being active must add --use-bav to restore previous behavior.
Dalfox v2.9.0 adds --output-request/--output-response flags and HAR HAR An HTTP Archive file, a JSON-format log of all network requests and responses captured by a browser's developer tools, used by cyber tools to replay, inspect, or analyze web traffic without re-running a live session. file writing support
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.9.0 https://github.com/hahwul/dalfox.git
$ git checkout v2.9.0
Adds --output-request and --output-response flags to export raw HTTP request and response data Not checked yet Adds HAR file writing support for capturing traffic in HAR format Not checked yet Adds arm64 (Apple Silicon) Docker image in GHCR GHCR GitHub Container Registry, GitHub's hosted service for storing and distributing OCI-compatible container images, giving cyber tools a versioned, access-controlled image store tied directly to a GitHub repository. Not checked yet
3 details in Everything
Dalfox v2.8.0 adds --report and --report-format flags to export scan results.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.8.0 https://github.com/hahwul/dalfox.git
$ git checkout v2.8.0
Adds --report flag to save scan findings directly to a file. Not checked yet Adds --report-format flag to specify the output format for the report (e.g., json, html). Not checked yet Adds HAR HAR An HTTP Archive file, a JSON-format log of all network requests and responses captured by a browser's developer tools, used by cyber tools to replay, inspect, or analyze web traffic without re-running a live session. format support in FILE mode, allowing Dalfox to read and process HAR files as input sources. Not checked yet
3 details in Everything
Adds --ignore-param global flag to skip specific parameters during scans
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.7.1 https://github.com/hahwul/dalfox.git
$ git checkout v2.7.1
└──▷ TRY IT
Scan a URL while ignoring specific query parameters like session_id or trace , which might cause false positives or noise.
copy
$ dalfox url 'https://example.com/page?id=1&session_id=abc123' --ignore-param session_id
Adds --ignore-param flag for excluding unwanted parameters from the scan surface Not checked yet
1 detail in Everything
Dalfox v2.7.0 adds ESI Injection to BAV module and Windows ARM64 ARM64 A 64-bit CPU architecture from ARM Holdings, used in mobile chips, Apple Silicon, and cloud servers; cyber tools target it to run natively on those platforms instead of relying on emulation. support
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.7.0 https://github.com/hahwul/dalfox.git
$ git checkout v2.7.0
Adds BAV Module with ESI Injection detection capability. Not checked yet Adds windows/arm64 platform support for the Dalfox CLI binary. Not checked yet Includes Severity information in the PoC object output format. Not checked yet
3 details in Everything
└──▷ BREAKING ON UPGRADE
! Go dependency upgraded from 1.16 to 1.17; builds require Go 1.17+.
Dalfox v2.6.3 adds severity and poctype fields to the PoC output object
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.6.3 https://github.com/hahwul/dalfox.git
$ git checkout v2.6.3
└──▷ USE IT
Filter scan results by severity level using jq
shell
copy
dalfox url https://example.com --json | jq '.[0].poc.severity'
Dalfox v2.6.1 adds PoCType to the library API and gzip support for request sending.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.6.1 https://github.com/hahwul/dalfox.git
$ git checkout v2.6.1
Adds PoCType field to the lib interface to enable different Proof of Concept types in programmatic usage Not checked yet Adds gzip handling in SendReq function and ParamterAnalysis for compressed request bodies Not checked yet
2 details in Everything
Adds --poc-type flag to export PoCs as curl/httpie/http-request formats.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.6.0 https://github.com/hahwul/dalfox.git
$ git checkout v2.6.0
└──▷ USE IT
Generate a curl command as Proof of Concept for easy manual verification.
shell
copy
dalfox url <target> --poc-type curl
Produce an httpie formatted PoC for modern API interaction patterns.
shell
copy
dalfox url <target> --poc-type httpie
Output a raw HTTP request string for logging or custom tooling integration.
shell
copy
dalfox url <target> --poc-type http-request
Adds --poc-type flag with curl, httpie, and http-request options to control Proof of Concept output format Not checked yet New JSON result fields: InjectType, PoCType, Method , Param , Payload , Evidence , and CWECWE Common Weakness Enumeration, a catalog of recurring software and hardware weakness types. It describes classes of mistakes, such as injection, rather than individual vulnerability instances. Not checked yet
2 details in Everything
Dalfox v2.5.5 adds support for specifying HTTP methods in Stored XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. (sxss) mode
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.5.5 https://github.com/hahwul/dalfox.git
$ git checkout v2.5.5
Adds the ability to specify different HTTP methods (e.g., PUT, DELETE) in sxss mode instead of only POST Not checked yet
1 detail in Everything
└──▷ BREAKING ON UPGRADE
! The internal option field for HTTP method is now named request-method (previously used generic naming)
Dalfox v2.5.0 adds WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. detection/evasion, DalLog format, and new flags
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.5.0 https://github.com/hahwul/dalfox.git
$ git checkout v2.5.0
└──▷ USE IT
Suppress all progress output for cleaner logs when scanning from a file or pipe.
shell
copy
dalfox pipe --silence-force
Adds --silence-force flag to force silent mode even when progress printing would normally occur during file/pipe scanning. Not checked yet Adds WAF Detection and Evasion capability as a core feature of the scanner. Not checked yet
2 details in Everything
Dalfox v2.4.7 adds DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. -based parameter scanning for form and a tags
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.4.7 https://github.com/hahwul/dalfox.git
$ git checkout v2.4.7
Dalfox v2.4.6 adds support for multiple headers via the -H option.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.4.6 https://github.com/hahwul/dalfox.git
$ git checkout v2.4.6
└──▷ USE IT
Inject custom headers along with your payload to bypass WAF WAF A reverse proxy that inspects HTTP/HTTPS traffic and blocks requests matching known attack patterns such as SQL injection or XSS, sitting between clients and a web application to filter malicious input before it reaches the server. rules or simulate specific client behavior.
shell
copy
dalfox url https://example.com -H "Authorization: Bearer token1" -H "X-Forwarded-For: 127.0.0.1"
The -H flag now accepts multiple header definitions in a single invocation. Not checked yet
1 detail in Everything
Adds --output-all flag and BAV scan ratelimit
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.4.5 https://github.com/hahwul/dalfox.git
$ git checkout v2.4.5
└──▷ USE IT
Run a scan and ensure all potential XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. vectors are captured in the results file rather than just the highest severity ones.
shell
copy
dalfox url https://example.com -o result.txt --output-all
Configure a delay between requests to manage rate limiting, using the new global limit.
shell
copy
dalfox url https://example.com --latelimit 1000
Adds the --output-all CLI flag to include all scan data in output Not checked yet Adds global latelimit configuration for delay concurrency control Not checked yet
2 details in Everything
Adds --found-action-shell flag for custom post-scan execution and enhanced server mode summary data.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.4.4 https://github.com/hahwul/dalfox.git
$ git checkout v2.4.4
└──▷ TRY IT
Execute a custom webhook or logging script immediately after Dalfox detects a vulnerability.
copy
$ dalfox url https://example.com --found-action-shell 'curl -X POST http://localhost:8080/alert -d @-'
Run Dalfox in server mode to receive detailed summary data upon completion.
copy
$ dalfox server --summary
Adds --found-action-shell flag to trigger external shell commands upon finding discovery Not checked yet Adds summary information data output in server mode Not checked yet
2 details in Everything
Adds print() payload capability, new --only-poc flag to target known PoCs only
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.4.3 https://github.com/hahwul/dalfox.git
$ git checkout v2.4.3
Adds print() support in payloads to generate alerts via the "alert is dead, long live print" technique Not checked yet Adds --only-poc flag to scan using only proof-of-concept payloads Not checked yet
2 details in Everything
Dalfox v2.4.0 adds payload mode, remote wordlists, Deep DOM DOM The browser's in-memory tree representation of a web page's structure, standardized by the W3C, giving cyber tools a programmable interface to read or manipulate page content at runtime. XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. detection and a library API
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.4.0 https://github.com/hahwul/dalfox.git
$ git checkout v2.4.0
└──▷ TRY IT
Fetch a custom wordlist from a GitHub raw URL and use it for scanning instead of local defaults.
copy
$ dalfox url https://example.com --remote-wordlists https://raw.githubusercontent.com/user/wordlist/main/xss.txt
Adds --remote-wordlists flag to fetch wordlists from external URLs instead of local files, enabling dynamic dictionary updates. Not checked yet Adds --deep-domxss flag to enable logic and payload functions specifically for detecting complex DOM-based XSS vulnerabilities via headless browsing. Not checked yet Exposes library API with NewScan function and result models in the Go package, allowing Dalfox to be integrated directly into other Go cyber tooling. Not checked yet Changes default scanning behavior by renaming the old --headless flag to --skip-headless, making headless DOM testing opt-in rather than automatic. Not checked yet
4 details in Everything
└──▷ BREAKING ON UPGRADE
! The --headless flag has been renamed to --skip-headless; scripts relying on the old flag name will fail.
Dalfox v2.3.4 adds recursive path-based XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. scanning and improves ATTR payloads
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.3.4 https://github.com/hahwul/dalfox.git
$ git checkout v2.3.4
Adds recursive directory traversal for PATH-based XSS detection to uncover hidden endpoints Not checked yet
1 detail in Everything
Dalfox v2.3.3 adds --mass-worker flag for pipe and file modes to scale mass scanning throughput.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.3.3 https://github.com/hahwul/dalfox.git
$ git checkout v2.3.3
└──▷ USE IT
Increase the worker pool for a large mass scanning job fed via file.
shell
copy
dalfox file input.txt --mass-worker 50
Pipe a list of targets and configure the worker count for parallel processing.
shell
copy
cat urls.txt | dalfox pipe --mass-worker 10
--mass-worker option available in file/pipe mode Not checked yet Improved system log output Not checked yet
2 details in Everything
Adds --mass sub-flags for mass scanning configuration.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.3.2 https://github.com/hahwul/dalfox.git
$ git checkout v2.3.2
Dalfox v2.2.6 adds --debug option for verbose logging.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.2.6 https://github.com/hahwul/dalfox.git
$ git checkout v2.2.6
└──▷ USE IT
Capture verbose logs during a scan for troubleshooting or auditing purposes.
shell
copy
dalfox url https://example.com --debug
--debug option added to enable debug-level logging output. Not checked yet
1 detail in Everything
Adds --only-custom-payload and --skip-grepping flags for more control over scanning scope and output.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.2.2 https://github.com/hahwul/dalfox.git
$ git checkout v2.2.2
└──▷ USE IT
Scan a target using only your own payload list, completely bypassing Dalfox's default XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. /SSRF SSRF Server-side request forgery, an attack that tricks a server into making requests chosen by an attacker. Those requests can reach internal services the attacker cannot access directly. checks to avoid noise or false positives.
shell
copy
dalfox url https://example.com --payloads my_payloads.txt --only-custom-payload
Disable Dalfox's pattern-matching to get unfiltered raw output, useful for integrating with external SIEM SIEM Security information and event management, collecting logs from many systems and correlating events to find suspicious activity. Analysts use it to investigate alerts and incidents. or custom parsers.
shell
copy
dalfox url https://example.com --skip-grepping
--only-custom-payload: Scans using only custom payloads (e.g. from --payloads) rather than the default Dalfox payload sets, suppressing all internal default scans. Not checked yet --skip-grepping: Disables Dalfox's built-in grepping engine entirely, outputting raw results without filtering for known patterns like google-captcha/secret-key/access-key. Not checked yet Removes google-captcha/secret-key/access-key from the built-in grepping pattern. Not checked yet
3 details in Everything
Dalfox v2.2.0 adds --skip-something and --no-bav flags plus server mode port/host configuration
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.2.0 https://github.com/hahwul/dalfox.git
$ git checkout v2.2.0
└──▷ TRY IT
Run Dalfox as a server listening on a specific interface and port
copy
$ dalfox server --host 0.0.0.0 --port 8080
Adds --skip-something flag to exclude specific vulnerability checks Not checked yet
1 detail in Everything
Dalfox v2.1.0 adds -X flag, mining subcommand with gf-patterns support, and log pattern names
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.1.0 https://github.com/hahwul/dalfox.git
$ git checkout v2.1.0
└──▷ TRY IT
Inject payloads using a custom HTTP method like PATCH instead of the default GET/POST.
copy
$ dalfox url -X PATCH
Run parameter mining with gf-patterns to discover hidden parameters.
copy
$ dalfox url --mining
Adds -X / --method flag to specify the HTTP method for payload injection. Not checked yet Adds --mining option to enable parameter mining using gf-patterns. Not checked yet Adds built-in grep rules that display the pattern name in the PoC output. Not checked yet
3 details in Everything
Dalfox v2.0.2 adds new XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. payloads and Go 1.15 support.
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.0.2 https://github.com/hahwul/dalfox.git
$ git checkout v2.0.2
Adds new XSS payloads to the default scan set Not checked yet Drops Go 1.14 runtime in favor of Go 1.15 Not checked yet
2 details in Everything
Dalfox v2.0 adds Server mode with API endpoints, follow-redirects flag, and header-based blind XSS XSS Cross-site scripting, an attack that runs malicious script in another user's browser through a trusted site. It can steal data or perform actions using the user's session. support
└──▷ GET THIS VERSION
copy
$ git clone --branch v2.0.0 https://github.com/hahwul/dalfox.git
$ git checkout v2.0.0
└──▷ TRY IT
Start the API server to allow remote scanning clients
copy
$ dalfox server --port 3000
Query the status or results of a previous scan via the API
copy
$ curl http://localhost:3000/scans
Enable following redirects during scanning and format logs as JSON
copy
$ dalfox url https://example.com --follow-redirects --format json
Adds Server mode for remote scanning via HTTP API Not checked yet Adds GET /scans endpoint to retrieve scan results Not checked yet Adds new command-line flags --follow-redirects (default false) and --format for log formatting Not checked yet Enables Blind XSS detection in HTTP headers Not checked yet Adds progress indicator showing scanned URL count in file/pipe modes Not checked yet
5 details in Everything
└──▷ BREAKING ON UPGRADE
! Dependency on echo updated to v4, requiring code changes if using Dalfox as a library
Adds --multicast flag for simultaneous multi-host testing in file/pipe modes
└──▷ GET THIS VERSION
copy
$ git clone --branch v1.2.0 https://github.com/hahwul/dalfox.git
$ git checkout v1.2.0
└──▷ USE IT
Scan multiple targets in a file simultaneously with equal load distribution
shell
copy
dalfox file --input targets.txt --multicast
Pipe multiple target URLs and scan them concurrently
shell
copy
cat urls.txt | dalfox pipe --multicast