Skip to content

Commit 8d89d5c

Browse files
devGregAclaude
andcommitted
docs(connectors): Escape connector reference
Document the Escape (escape.tech) API-security DAST connector: the API-key prerequisite, the Location/Secret/Minimum-Severity mappings, and the whole-account model (every organization -> every application -> a Record per application with a scan; each latest-scan issue -> finding, severity/CWE/OWASP-tag/method-tag/endpoint/remediation, dynamic, dedupe on issue id). Companion to connectors#762 and dojo-pro#2013. sc-13909 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 26d4032 commit 8d89d5c

1 file changed

Lines changed: 18 additions & 0 deletions

File tree

docs/content/import_data/pro/connectors/connectors_tool_reference.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -452,6 +452,24 @@ You will need an Edgescan API token. Create one from your Edgescan account under
452452

453453
Each Edgescan asset becomes a Record, and each open vulnerability on that asset is imported as a finding. Severity is mapped from Edgescan's numeric scale (1–5) to DefectDojo's Info–Critical, and CVE references, the CWE, and a CVSS v3 vector are included where Edgescan provides them.
454454

455+
## **Escape**
456+
457+
The Escape connector uses the [Escape](https://escape.tech) API to import **API\-security (DAST) findings**. DefectDojo enumerates every organization the token can access and every application within each, creates a Record for each application that has a scan, and imports that application's latest scan issues as findings — there is no per\-application configuration.
458+
459+
#### Prerequisites
460+
461+
You will need an Escape **API key**, created in the Escape app under **Settings → API keys**. The key is sent in the `Authorization: Key` header and is never logged.
462+
463+
#### Connector Mappings
464+
465+
1. Leave the **Location** field blank to use `https://public.escape.tech/v2`, or enter your Escape API host explicitly.
466+
2. Enter the Escape API key in the **Secret** field.
467+
3. Optionally, set a **Minimum Severity** to limit which findings are imported.
468+
469+
DefectDojo maps each **application** to a Record and each scan **issue** to a finding: the severity comes from Escape's rating (Critical/High/Medium/Low), the CWE is carried over, the OWASP category and HTTP method become tags, the affected URL becomes the endpoint, and the remediation guidance is included. Findings are recorded as dynamic findings and de\-duplicated on Escape's issue id.
470+
471+
See the [Escape API documentation](https://docs.escape.tech/) for more information.
472+
455473
## **GitGuardian**
456474

457475
The GitGuardian connector uses the GitGuardian REST API to import **secret incidents** — exposed credentials GitGuardian has detected across your monitored sources. DefectDojo creates a Record for each monitored source (repository or perimeter) that currently has open incidents, and imports each open incident as a finding.

0 commit comments

Comments
 (0)