
Pentest Tools
Penetration Testing- Overview
- Setup
- Data & mappings
- Operations & API
- Changelog
The Pentest Tools connector integrates with the Pentest-Tools.com platform to synchronize scan targets and their security findings. Scan targets are mapped to Host and Site assets, the vulnerabilities and issues found on them to Findings, and the underlying checks (enriched from the public finding-template catalog) to Finding Definitions. All data is read across every workspace the API key can access.
Data retrieved from Pentest Tools
| Connector Object | Required | Maps to Data Model |
|---|---|---|
| Host | Yes | Host |
| Site | Yes | Site |
| Finding | Yes | Pentest Finding |
| Finding Definition | Yes | Pentest Finding Definition |
Model relationships
For detailed steps on how to view the data retrieved from Pentest Tools in the Brinqa Platform, see How to view your data.
Connection settings
When setting up a data integration, select Pentest Tools from the Connector dropdown and provide the following:
| Setting | Required | Default | Description |
|---|---|---|---|
| API URL | Yes | https://api.pentest-tools.com/api/v2 | Pentest-Tools.com API URL. Defaults to https://api.pentest-tools.com/api/v2, which routes to your account's region. Use https://app.pentest-tools.com/api/v2 (EU) or https://app-us.pentest-tools.com/api/v2 (US) to pin a region |
| API key | Yes | — | Pentest-Tools.com API key, generated under My account > API. Used as a Bearer token for authentication |
| Page size | No | 100 | Maximum number of records to get per API request (1-1000). Defaults to 100 |
| Max retries | No | 5 | Maximum number of retries for failed API requests |
Authentication
| Element | Description |
|---|---|
| Method | API Key, sent as a Bearer token |
The connector authenticates with a static API key generated in the Pentest-Tools.com UI (My account > API). There is no token-exchange step; the key is sent on every request. The connection is validated by listing workspaces, which every key is permitted to do.
Endpoint (connection test)
| Method | URL |
|---|---|
GET | {url}/workspaces |
Request Headers
| Header | Value |
|---|---|
Authorization | Bearer <apiKey> |
Accept | application/json |
Usage
Every API request includes the API key as a bearer token:
Authorization: Bearer <apiKey>
How to obtain Pentest Tools credentials
Obtain the required credentials (url, apiKey) from your Pentest Tools administrator or the Pentest Tools admin console, then enter them in the connection settings above.
Attribute mappings
Expand the sections below to view the mappings between the source and the Brinqa data model attributes:
Host
| Source Field Name | SDM Attribute |
|---|---|
*(constant)* | CATEGORIES |
*(constant)* | STATUS |
*(sync time)* | LAST_CAPTURED |
ScanResource.end_time | LAST_SCANNED |
ScanResource.start_time | SOURCE_CREATED_DATE |
ScanResource.status_name | LAST_SCAN_STATUS |
TargetResource.description | DESCRIPTION |
TargetResource.id | UID |
TargetResource.name | NAME |
TargetResource.name | HOSTNAMES |
TargetResource.name | DNS_NAMES |
TargetResource.name | IP_ADDRESSES |
TargetResource.type | TARGET_TYPE |
TargetResource.workspace_id | WORKSPACE_ID |
WorkspaceResource.name | WORKSPACE_NAME |
Site
| Source Field Name | SDM Attribute |
|---|---|
*(constant)* | CATEGORIES |
*(constant)* | STATUS |
*(sync time)* | LAST_CAPTURED |
ScanResource.end_time | LAST_SCANNED |
ScanResource.start_time | SOURCE_CREATED_DATE |
ScanResource.status_name | LAST_SCAN_STATUS |
TargetResource.description | DESCRIPTION |
TargetResource.id | UID |
TargetResource.name | NAME |
TargetResource.name | URL |
TargetResource.name | HOSTNAMES |
TargetResource.name | DNS_NAMES |
TargetResource.name | IP_ADDRESSES |
TargetResource.name | PORT |
TargetResource.workspace_id | WORKSPACE_ID |
WorkspaceResource.name | WORKSPACE_NAME |
Finding
| Source Field Name | SDM Attribute |
|---|---|
*(sync time)* | LAST_CAPTURED |
FindingResource.cve | CVE_IDS |
FindingResource.cve | CVE_RECORDS |
FindingResource.cvss | CVSS_V2_BASE_SCORE |
FindingResource.cvssv3 | CVSS_V3_BASE_SCORE |
FindingResource.cwe | CWE_IDS |
FindingResource.cwe | WEAKNESSES |
FindingResource.epss_percentile | EPSS_PERCENTILE |
FindingResource.epss_score | EPSS_SCORE |
FindingResource.group_id | GROUP_ID |
FindingResource.id | UID |
FindingResource.in_cisa_catalog | CISA_EXPLOITED |
FindingResource.iso27001 | ISO_27001 |
FindingResource.known_ransomware_campaign_use | KNOWN_RANSOMWARE_CAMPAIGN_USE |
FindingResource.name | NAME |
FindingResource.owasp | OWASP_CATEGORIES |
FindingResource.port | PORT |
FindingResource.protocol | PROTOCOL |
FindingResource.recommendation | RECOMMENDATION |
FindingResource.references | REFERENCES |
FindingResource.risk_level | SOURCE_SEVERITY |
FindingResource.risk_level | SEVERITY |
FindingResource.risk_level | SEVERITY_SCORE |
FindingResource.service | SERVICE |
FindingResource.soc2 | SOC_2 |
FindingResource.status | PROVIDER_STATUS |
FindingResource.status | SOURCE_STATUS |
FindingResource.status / confirmed | IS_FALSE_POSITIVE |
FindingResource.target_id | TARGETS |
FindingResource.verified | IS_MANUALLY_VERIFIED |
FindingResource.vuln_description | DESCRIPTION |
FindingResource.vuln_evidence | EVIDENCE |
FindingResource.vuln_id + name | TYPE |
ScanResource.end_time / start_time | FIRST_FOUND |
ScanResource.end_time / start_time | LAST_FOUND |
Finding Definition
| Source Field Name | SDM Attribute |
|---|---|
*(sync time)* | LAST_CAPTURED |
FindingResource.cve | CVE_IDS |
FindingResource.cve | CVE_RECORDS |
FindingResource.cvssv3 | CVSS_V3_BASE_SCORE |
FindingResource.cwe | CWE_IDS |
FindingResource.cwe | WEAKNESSES |
FindingResource.name | NAME |
FindingResource.risk_description | RISK_DESCRIPTION |
FindingResource.risk_level | SOURCE_SEVERITY |
FindingResource.risk_level | SEVERITY |
FindingResource.risk_level | SEVERITY_SCORE |
FindingResource.vuln_description | DESCRIPTION |
FindingResource.vuln_id | VULNERABILITY_ID |
FindingResource.vuln_id | CATEGORIES |
FindingResource.vuln_id + name | UID |
FindingTemplateResource.codename | CODENAME |
FindingTemplateResource.date | PUBLISHED_DATE |
FindingTemplateResource.how_to_reproduce | HOW_TO_REPRODUCE |
FindingTemplateResource.product | PRODUCT |
FindingTemplateResource.ptt_exploit_capabilities | PTT_EXPLOIT_CAPABILITIES |
FindingTemplateResource.public_vuln_description | PUBLIC_VULNERABILITY_DESCRIPTION |
FindingTemplateResource.published | SOURCE_CREATED_DATE |
FindingTemplateResource.software_type | SOFTWARE_TYPE |
FindingTemplateResource.updated | SOURCE_LAST_MODIFIED |
FindingTemplateResource.vendor | VENDOR |
Operations & API
Expand each connector object to see its operation options, delta-sync behavior, and the API it uses. See connector operation options for how to apply operation options (keys and values are case-sensitive).
Host
Operation options
This object does not support any operation options.
Delta sync
The connector README does not document sync behavior for this object.
API
- Type: REST · Endpoint:
GET /targets(per workspace, per type), with scan dates fromGET /scans - Default filters:
type=hostname,type=ip_address,workspace_id
Site
Operation options
This object does not support any operation options.
Delta sync
The connector README does not document sync behavior for this object.
API
- Type: REST · Endpoint:
GET /targets(per workspace), with scan dates fromGET /scans - Default filters:
type=url,workspace_id
Finding
Operation options
This object does not support any operation options.
Delta sync
The connector README does not document sync behavior for this object.
API
- Type: REST · Endpoint:
GET /findings(per workspace), with scan times fromGET /scans - Default filters:
workspace_id,group_duplicates=true
Finding Definition
Operation options
This object does not support any operation options.
Delta sync
The connector README does not document sync behavior for this object.
API
- Type: REST · Endpoint:
GET /findings(per workspace) for the definition set, enriched byGET /public/finding_templates - Default filters:
workspace_id,group_duplicates=true(findings); catalog fetched in full
Changelog
The Pentest Tools connector has undergone the following changes:
| Version | Description | Migration Steps |
|---|---|---|
| 3.0.0 | Overview The Pentest Tools connector integrates with Pentest-Tools.com to synchronize scan targets as host and web-application assets, along with penetration-testing findings and their finding definitions. Category: Penetration Testing Models | N/A |