Skip to main content
availability

Package: Invicti AppSec Enterprise (on-premise, on-demand)

HackerOne integration

HackerOne is a leading bug bounty and vulnerability disclosure platform that connects organizations with a global community of security researchers. The Invicti AppSec integration connects to your HackerOne account via API, retrieves vulnerability reports submitted to your managed programs, and imports them as findings — giving your security team a unified view of both internal scan results and externally reported vulnerabilities.

Prerequisites

FieldDescription
Usernameyour HackerOne API username (the identifier used for API authentication)
Tokenyour HackerOne API token (used as the password in Basic Auth)

Get API credentials (on HackerOne side)

  1. Log in to the HackerOne platform.
  2. Click your profile icon in the top right and select Settings.
  3. Navigate to API Token under the Authentication section.
  4. Click Create API Token.
  5. Enter a name for the token and click Create.
  6. Copy the Identifier (this is your Username) and the Token — the token is shown only once.
note

Keep both the Identifier and Token secure. The HackerOne API authenticates using HTTP Basic Auth with the Identifier as the username and the Token as the password.

Step 1: Navigate to Integrations

From the left sidebar menu, click Integrations.

Integrations sidebar

Step 2: Select the Bug Bounty tab

On the Integrations > Scanners page, click the Bug Bounty tab.

Bug Bounty tab

Step 3: Find and activate HackerOne

Scroll through the list of Bug Bounty scanners to find HackerOne.

  • If HackerOne is not activated, click Activate to enable the integration.
note

The scan method badge on the HackerOne card is Bind.

Step 4: Configure connection settings

Click the gear icon on the HackerOne card to open the settings panel. Fill in the required fields:

FieldDescriptionRequired
Usernameyour HackerOne API identifierYes
Tokenyour HackerOne API tokenYes
note

The HackerOne API base URL (https://api.hackerone.com/v1) is fixed and doesn't need to be configured.

HackerOne settings

Step 5: Test the connection

Click Test Connection. A green Connection successful message confirms that Invicti AppSec can authenticate with the HackerOne API and access your programs.

Summary

StepAction
1Navigate to Integrations from the sidebar
2Select the Bug Bounty tab
3Activate HackerOne
4Enter Username (API Identifier) and Token
5Test the connection

Create a scan

  1. Open a project in Invicti AppSec.
  2. Go to Settings > Scanners.
  3. Click Add Scanner.

Add HackerOne scanner

  1. Select Bug Bounty as the scanner type.
  2. Choose HackerOne from the scanner list.
  3. Click Add to open the scan configuration drawer.

Scan configuration fields

FieldDescriptionRequired
Environmentselect the environment for the scanNo
Programselect the HackerOne bug bounty program to pull reports fromYes
Assetselect the specific asset (structured scope) within the programYes
Branchsource code branch associated with this scanYes
Reports to Pullchoose between Triaged only or All reported vulnerabilitiesNo
Meta Dataadditional metadata for the scanNo
Scan Tagtag to identify the scanNo
note

The Program list is populated from your HackerOne account. After selecting a program, the Asset list shows the structured scopes defined for that program. The Reports to Pull option controls whether Invicti AppSec imports only triaged (validated) findings or all submitted reports including those pending triage.

HackerOne scan creation

Scheduler

Enable the Scheduler toggle to pull HackerOne reports on a recurring schedule.

Webhook (optional)

Add a webhook URL to receive scan completion notifications.

Troubleshooting

Connection fails

IssueResolution
401 Unauthorizedverify that both the API Identifier (Username) and Token are correct. Regenerate the API token in HackerOne Settings if needed.
No programs returnedensure the HackerOne account associated with the API credentials has access to at least one managed program.
403 Forbiddenthe API token may lack the required permissions. Verify the token has read access to programs and reports.

Scan issues

IssueResolution
No assets listedthe selected program may have no structured scopes defined. Configure assets in the HackerOne program scope settings.
Empty resultsthe program may have no reports matching the selected asset and triage filter. Try switching to All reported to verify if any reports exist.
Missing reportsHackerOne API results are paginated. For programs with large numbers of reports, the initial sync may take longer than expected.

Best practices

  • Use a dedicated HackerOne API token for the Invicti AppSec integration rather than a personal account token, to avoid access loss when team members change.
  • Rotate the API token periodically and update the integration promptly after each rotation.
  • Use the Triaged only filter as the default to focus on validated findings and reduce noise from unverified reports.
  • Map each HackerOne asset to its corresponding Invicti AppSec project so vulnerability data is organized by application.
  • Review new HackerOne report submissions regularly and re-trigger syncs to keep Invicti AppSec findings current.

Limitations

  • HackerOne is a Bind-only integration — scans can't be triggered via the KDT CLI; reports must be pulled through the Invicti AppSec web interface or scheduler.
  • The integration imports reports submitted to your HackerOne programs; it doesn't create or manage programs, assets, or researcher interactions within HackerOne.
  • Report data is fetched at sync time; new reports submitted after the last sync appear only on the next scheduled or manual run.
  • The structured scope (asset) filter applies at the time of import — reports not associated with the selected asset in HackerOne's scope definition won't be included.

Need help?

Invicti Support team is ready to provide you with technical help. Go to Help Center

Was this page useful?