Skip to content

Commit e1e704b

Browse files
devGregAclaudeMaffooch
authored
docs(connectors): Endor Labs connector reference (#15281)
Document the Endor Labs SCA connector (story sc-13761): namespace sync via an API key+secret bearer exchange, the region base URL, the optional traverse-child-namespaces scoping, and how Endor's reachability verdict surfaces on each finding (Impact + tag). Placed alphabetically in the connectors tool reference. Companion PRs: DefectDojo-Inc/connectors#726, DefectDojo-Inc/dojo-pro#1933. Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com> Co-authored-by: Cody Maffucci <46459665+Maffooch@users.noreply.github.com>
1 parent d94ac79 commit e1e704b

1 file changed

Lines changed: 23 additions & 0 deletions

File tree

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

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -378,6 +378,29 @@ DefectDojo creates a separate Record for each Docker Scout stream, and imports o
378378

379379
See the [Docker Scout documentation](https://docs.docker.com/scout/) for more information.
380380

381+
## **Endor Labs**
382+
383+
The Endor Labs connector uses the Endor Labs REST API to sync an entire Endor Labs **namespace**. DefectDojo discovers each Endor **project** as a Record and imports that project's findings, carrying Endor's **reachability** verdict so you can prioritize vulnerabilities whose affected code is actually reachable.
384+
385+
#### Prerequisites
386+
387+
You will need an Endor Labs **API key** (a key identifier plus its secret) and the **namespace** you want to sync. Create the key in the Endor Labs platform under **Settings \> Access \> API Keys**; the key needs read access to the projects and findings in that namespace.
388+
389+
The connector authenticates by exchanging the API key and secret for a short-lived bearer token — the secret is used only for that exchange and is never stored in cleartext.
390+
391+
#### Connector Mappings
392+
393+
1. Enter `https://api.endorlabs.com` in the **Location** field. If your tenant is hosted in a different region, use that region's API base URL instead.
394+
2. Enter the Endor Labs **Namespace** to sync (for example `your-org` or `your-org.team`).
395+
3. Enter the **API Key** identifier.
396+
4. Enter the **API Secret** paired with the key.
397+
5. Optionally set **Traverse Child Namespaces** to `true` to also import findings from child namespaces of the configured namespace.
398+
6. Optionally set a **Minimum Severity** to limit which findings are imported. Findings below the selected severity are not imported.
399+
400+
DefectDojo creates a Record for each Endor Labs project in the namespace and imports its findings, mapping Endor severity levels to DefectDojo severities, the CVE/GHSA identifiers and CVSS score of each vulnerability, and Endor's reachability tags. The reachability verdict (for example *Reachable — vulnerable function is called* or *Unreachable*) is surfaced as the finding's Impact and as a tag.
401+
402+
For more information, see the **[Endor Labs REST API documentation](https://docs.endorlabs.com/rest-api/)**.
403+
381404
## **Edgescan**
382405

383406
The Edgescan connector uses the Edgescan REST API to import open vulnerabilities across your whole Edgescan account. DefectDojo enumerates every Edgescan **asset** and creates a Record for each one, then imports that asset's open vulnerabilities as findings — there is no per\-asset configuration.

0 commit comments

Comments
 (0)