Incident.io

Configure Incident.io to work with Aikido and create tickets based on new vulnerabilities found. Linking your Incident.io team to Aikido ensures new vulnerabilities get notified when they are found. Meaning all the benefits of Incident.io can be used on the alerting system from Aikido.

How to set up Incident.io

Requirements

• Active Incident.io subscription (free users can not create API keys)

• Aikido Organization with Pro tier

1. Go to https://incident.io and log in

2. Navigate to the settings of the account by clicking on your organization top left and selecting 'settings'

3. Choose 'API keys' from the left sidebar and click [+ add new]

   1. Pick a fitting name (e.g. Aikido Api Key)

   2. From permissions select: 'Create incidents'

   3. Click [Create] on the bottom

   4. Save the API key for later use (copy paste it somewhere safe)

4. After that we want to navigate to 'Severities' in the left sidebar and click [+ Add severity]

   1. Pick a fitting name (e.g. Aikido)

   2. Pick a fitting description (e.g. Dedicated severity for Aikido)

5. Finally we want to navigate to 'Types' in the left sidebar and click the pencil to edit on the default type

   1. If not set, add a description.

   2. Scroll all the way down to 'Skip channel creation' and toggle it on

   3. Just below click [+ Add condition]

   4. Click on Severity twice

   5. Look for the Severity we just created and select it (should look like below)

   6. Click [Done]

   7. Finally press [Save] on the bottom right

   
6. Now everything from Incident.io should be ready to link to Aikido

7. On the integrations page in Aikido, click Incident.io

8. Paste your API key from step 3 in the input field and save settings

9. Make sure in the Incident.io Severity dropdown our new severity is selected

10. Press Save Settings on the top right of the page

11. (Optional) Send a test incident to confirm a working integration

You should now be all set to receive automatic alerts to your linked incident slack channel when new vulnerabilities are detected by Aikido.