Skip to content

Commit a8895a1

Browse files
devGregAclaude
andauthored
docs(connectors): Sonatype IQ setup (#15268)
Add a Sonatype IQ (Nexus Lifecycle) section to the connectors tool reference: prerequisites (View IQ Elements permission, user token, on-prem/SaaS base URLs) and connector mappings (Location, Username, User Token, Stage, Minimum Severity). Pairs with connector DefectDojo-Inc/connectors#712 and DD Pro registration DefectDojo-Inc/dojo-pro#1905. Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
1 parent c5fa35e commit a8895a1

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
@@ -876,6 +876,24 @@ The Snyk connector uses the Snyk REST API to fetch data.
876876

877877
See the [Snyk API documentation](https://docs.snyk.io/snyk-api) for more info.
878878

879+
## **Sonatype IQ**
880+
881+
The Sonatype IQ connector uses the Sonatype IQ Server (Nexus Lifecycle) REST API to import open\-source component vulnerabilities. It enumerates every application in your IQ organization and, for each one, imports the component vulnerabilities from that application's latest report at the lifecycle stage you configure. DefectDojo creates a Record for each application automatically — there is no per\-application configuration.
882+
883+
#### Prerequisites
884+
885+
You will need a Sonatype IQ user account with the **View IQ Elements** permission on the applications you want to import. Sonatype recommends authenticating with a **user token** (generated under **My Profile > User Token** in IQ Server) rather than a password; the token's two parts map to the Username and User Token fields below. The connector works with both self\-hosted IQ Server and Sonatype\-hosted (SaaS) instances.
886+
887+
#### Connector Mappings
888+
889+
1. In the **Location** field, enter your IQ Server base URL — for a self\-hosted server, `https://iq.example.com`; for a Sonatype\-hosted instance, `https://<tenant>.sonatype.app/platform`.
890+
2. Enter the IQ user (or the user\-code part of your user token) in the **Username** field.
891+
3. Enter the IQ user token (or password) in the **User Token** field.
892+
4. Optionally, set a **Stage** to choose which lifecycle stage's report is imported per application (`build`, `stage-release`, `release`, and so on). Leave it blank to use `build`.
893+
5. Optionally, set a **Minimum Severity** to limit which findings are imported.
894+
895+
Each application becomes a Record, and each security issue in that application's latest report for the selected stage is imported as a finding. Severity is derived from the issue's numeric score, and CVE references, CWE, the CVSS vector, and the affected component's package URL (PURL) are included where available.
896+
879897
## Tenable
880898

881899
The Tenable connector uses the **Tenable.io** REST API to fetch data. Scans are pulled from the Tenable VM `/scans` endpoint.

0 commit comments

Comments
 (0)