Skip to content

Commit 680895a

Browse files
authored
docs(connectors): add Rapid7 InsightAppSec connector reference (#15265)
Setup and usage for the InsightAppSec connector: Insight platform API key generation, regional endpoint selection, connector field mappings, and import behavior (one Record per app; only open vulnerabilities import so reimport closes remediated/triaged findings). Distinguishes it from the Security Console-based InsightVM connector. Story: sc-13704
1 parent 3a77574 commit 680895a

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

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

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -671,6 +671,26 @@ A Qualys user account with **VMDR API access**, and your subscription's **API se
671671

672672
Each Qualys host becomes a Record. Detections Qualys has marked **Fixed** are excluded, so reimport closes remediated findings.
673673

674+
## **Rapid7 InsightAppSec**
675+
676+
The Rapid7 InsightAppSec connector imports **DAST vulnerability findings** from the InsightAppSec cloud platform, enriched with attack\-module metadata (for example *SQL Injection*), CVSS scores, and the evidence collected by the scan. DefectDojo creates a Record for each InsightAppSec **app**.
677+
678+
**Please note:** this Connector is distinct from the **Rapid7 InsightVM** connector below — InsightAppSec is Rapid7's cloud DAST product on the Insight platform, while InsightVM findings come from your own Security Console.
679+
680+
#### Prerequisites
681+
682+
An Insight platform account with InsightAppSec, and a platform **API key**: in the [Rapid7 Insight platform](https://insight.rapid7.com), open the settings (gear) menu \> **API Keys** and generate a **User Key** (any role) or an **Organization Key** (platform admins). Copy the key when it is shown — it is displayed only once.
683+
684+
You also need your platform **region**, visible in your Insight URL (for example `us`, `us2`, `us3`, `eu`, `ca`, `au`, or `ap`).
685+
686+
#### Connector Mappings
687+
688+
1. Enter your regional API endpoint in the **Location** field — for example `https://us.api.insight.rapid7.com` (replace `us` with your region).
689+
2. Enter the Insight platform API key in the **API Key** field.
690+
3. Optionally, set a **Minimum Severity** to limit which findings are imported.
691+
692+
Each InsightAppSec app becomes a Record. Only **open** vulnerabilities (Unreviewed or Verified) are imported — findings Rapid7 has marked Remediated, a False Positive, Ignored, or Duplicate are excluded, so reimport closes them in DefectDojo. Severities map directly (`SAFE` and `INFORMATIONAL` import as Info).
693+
674694
## **Rapid7 InsightVM**
675695

676696
The Rapid7 InsightVM connector imports asset vulnerability findings from your InsightVM **Security Console** (API v3), enriched with the console's global vulnerability catalog. DefectDojo creates a Record for each InsightVM **site**.

0 commit comments

Comments
 (0)