IBM Security SOAR

This integration synchronizes accepted submissions from Crowdcontrol with the IBM Security SOAR platform. Specifically, it allows you to create and populate a Security SOAR incident with vulnerability data from Crowdcontrol to facilitate your response and remediation processes.

The Security SOAR integration is set up in the program’s settings and is specified to send notifications for activities in that program. There is no limitation on the number of projects that can be set up with the Security SOAR integration. To push or view an issue in Security SOAR, you must be authenticated as Bugcrowd will not collect any authentication permissions.

Setting Up IBM Security SOAR Integration

  1. Select a program, go to Settings > Integrations.

    integration

  2. On the integrations page, go to IBM Security SOAR and click Add integration.

    add-integration

  3. Click Add IBM Security SOAR Integration to setup your project.

    add-ibm-soar-integration

  4. Specify the following information:

    • Integration Name: Provide a name for the integration.
    • Instance: Specify the Security SOAR instance URL.
    • Integration status: Select Enabled for allowing submissions to be pushed to Security SOAR. By default, it is Disabled.

    integration-fields

  5. Click Save Integration.

    save

    The integration project is displayed in the IBM Security SOAR integrations page.

    integrations-list

    To setup another integration project, click Add another IBM Security SOAR Integration and perform the same steps.

    If you have setup the Security SOAR integration project appropriately, then Connected is displayed on the Integrations page. It also shows the number of project instances that are configured.

    connected

    You cannot delete a Security SOAR integration project. You can only disable the integration setup.

Pushing Submissions to IBM Security SOAR

  1. After you have setup and enabled IBM Security SOAR integration, you can go to any submission and click Push to IBM Security SOAR.

    push-to-soar

    The Push to IBM SOAR Integration pop-up window is displayed.

    If you have setup multiple integration projects, then the Push to IBM Security SOAR link will be displayed for each integration in the submission. You can push the submission to the required Security SOAR integration project.

  2. To create the incident in Security SOAR, click Create the incident.

    create-incident

    The Create New Incident page displays the contents of the submission. You can edit the information before creating the incident.

    create-form

  3. Click Create.

    click-create

    The incident is created in Security SOAR.

  4. Copy the ID number from the incident page.

    copy-id

  5. Go back to the Push to IBM SOAR Integration pop-up window and enter the incident number in External Link ID.

    external-link-id

  6. Click save.

    click-save

    The ID is displayed on the submission as a link. Click this link to access the Security SOAR incident within Crowdcontrol for further updates.

    displayed-id

Unlinking an IBM Security SOAR Incident

  1. To unlink an IBM Security SOAR Incident, go the Submissions page and select the submission.

  2. Click on the red bin icon adjacent to Update incident ID in the Integrations section.

    unlink-ibm-issue

  3. Click Unlink to confirm unlinking the issue.

    confirm-unlink-ibm

Editing Existing IBM Security SOAR Integration

To edit an existing IBM Security SOAR integration:

  1. On the IBM Security SOAR Integrations page, click the integration that you want to edit.

    edit

  2. Update the required information in the following fields:

    • Integration Name: Update the name of the integration.
    • Instance: Specify the Security SOAR instance URL.
    • Integration status: Select Enabled to push submissions to Security SOAR. Else, select Disabled.

    update-fields

  3. Click Save Integration.

    save-integration

    The integration project is saved.