Hacker0x01 · martijnrusschen · Jan 24, 2022 · Jan 24, 2022 · Jan 24, 2022 · Jan 24, 2022
diff --git a/docs/programs/brinqa-integration.md b/docs/programs/brinqa-integration.md
@@ -0,0 +1,44 @@
+---
+title: "Brinqa Integration"
+path: "/programs/brinqa-integration.html"
+id: "programs/brinqa-integration"
+---
+
+With the Brinqa integration, you can push all of your HackerOne submissions to Brinqa so that you can track all of your vulnerability reports on Brinqa.
+
+The HackerOne connector requires an API ID and API Key to authenticate. Directions for creating these can be found [here](/programs/api-tokens.html).
+
+Once you have created your API ID and API Key, you can begin setting up the integration with Brinqa.
+
+1. Log in to your Brinqa account
+2. Navigate to data sources
+3. Create a new connector by selecting the HackerOne connector.
+4. Enter the API ID and Key from HackerOne in the Connector Properties
+5. Click Update
+![Connector Properties](./images/brinqa-connector-properties.png)
+
+Once you have the connection set up, you can begin configuring any custom data mapping you would like to have. HackerOne data will be synced to Brinqa’s “Activity Report” by default. Use the Attribute Mappings table to add or remove attributes from the Brinqa mapping.
+![Attribute Mapping](./images/brinqa/attribute-mapping.png)
+
+You can also set up a sync schedule and choose which data will apply.
+![Sync Schedule](./images/brinqa/sync-schedule.png)
+
+Within Brinqa, navigate to the data sources and create a new connector by selecting the HackerOne connector.
+
+### How the Integration Works
+After your Brinqa integration has been set up:
+1. Change the action picker to **Change state > Triaged** in your report.
+
+![Integrations](./images/add-integration-reference.png)
+
+2. Click **Add reference to issue tracker**.
+3. Make sure your Brinqa integration is selected.
+
+![Integration](./images/issue-tracker-reference.png)
+
+4. Click **Generate escalation**. You’ll be taken to your Brinqa account where the report is pre-populated.
+5. Submit the issue to create the report in Brinqa.
+6. Copy the Brinqa report issue number and paste it in the **Reference ID** field back in the HackerOne.
+7. Click **Create** to create a direct reference link to the issue in Brinqa.
+
+Once you’ve set up the HackerOne connector and configured the integration, data will be automatically pulled from HackerOne using the schedule you configured. All reports in the New and Triaged states will be imported in the Brinqa platform as open issues. This integration will not push any updates made in the Brinqa platform back to HackerOne. When you delete the connector, all data imported by the connector will also be deleted.
diff --git a/docs/programs/images/brinqa-attribute-mapping.png b/docs/programs/images/brinqa-attribute-mapping.png
diff --git a/docs/programs/images/brinqa-connector-properties.png b/docs/programs/images/brinqa-connector-properties.png
diff --git a/docs/programs/images/brinqa-sync-schedule.png b/docs/programs/images/brinqa-sync-schedule.png