Integrate with Azure Boards

With an Azure Boards integration with Contrast, you can automatically generate tickets for bugtracking, synchronize comments and push notifications for your applications.

You will need:

  • Account credentials for Azure Boards or TFS: username and personal access token (PAT).

  • Scope to read and write work items with your PAT.

  • An Azure Boards or TFS instance, accessible by HTTP to Contrast.

  • An instrumented application in Contrast that is also associated to an Azure Boards project.

  • For more, see Microsoft's Azure Boards documentation.

To connect Contrast with Azure Boards:

  1. In Contrast, go to Organization settings > Integrations.

  2. For the Azure Boards integration, select Connect.

  3. Enter the following values:

    • Name: Label that will display when Contrast sends findings to bugtrackers in Azure Boards.

    • URL: Azure Boards or TFS URL. Contrast must be able to access this.

    • Version: Contrast uses API v2 to support Azure DevOps Services, TFS 2015 and TFS 2017.

    • Personal access token:An alternate password to authenticate to your host.

  4. Select Test connection. This may take a few minutes, depending on the number of Azure Boards or TFS projects. The test verifies that Contrast can reach the Azure Boards or TFS instance you entered, and it accepts the user's PAT to login.

  5. Once Azure Boards is connected, select the Contrast Applications you want to make available to this bugtracker.

  6. Enter values for Project, Assignee and Work Item Type.

  7. Select a Team, then select an Area within the team. This will send tickets to a specific backlog.

  8. Set the Default priority for vulnerability severity levels. This prioritizes tickets to fix vulnerabilities for the selected applications, based on severity. At this point, Contrast will make an API call and return a list of Azure Boards or TFS ticket states.

  9. You can also set up two-way integration (to automatically update vulnerability status in Contrast) or automatic ticket creation with Azure Boards.