Integrating Acunetix 360 with Entra ID (Azure Active Directory) Boards

Microsoft Entra ID (formerly Azure AD) is a cloud computing service that offers Azure Boards, an issue tracking system. Its purpose is to help businesses build, deploy and manage web applications. Part of this web application management includes the ability to track work, issues, and code.

Acunetix 360 has out-of-the-box support for resolving and reactivating Azure Boards issues according to the scan results, in addition to automatic issue creation. Acunetix 360 employs user-provided Resolved and Reopened statuses in Azure Boards for this purpose.

To enhance issue synchronization support, Acunetix 360 also offers webhook support. This enables you to detect any status changes in Azure Boards issues opened by Acunetix 360.

• Acunetix 360 generates a Webhook URL after you save your integration settings. When you register this link as a webhook in your Azure Boards project, and enter your preferred Resolved and Reopen statuses, you will complete Acunetix 360 issue synchronization for your integration.
• When you change your Azure Boards issue’s status to your preferred Resolved status, the issue is automatically marked as Fixed (Unconfirmed) in Acunetix 360 and a retest scan is started. And, when you change your Azure Boards issue’s status to your preferred Reopened status, your corresponding Acunetix 360 issue is automatically marked as revived.

For further information, see What Systems Does Acunetix 360 Integrate With?.

This topic explains how to configure Acunetix 360 to send a detected vulnerability to Azure Boards.

Azure Boards Fields

This table lists and explains the Azure Boards fields in the New Azure Boards Integration window.

How to Integrate Acunetix 360 with Azure Boards

1. Log in to Acunetix 360.
2. From the main menu, go to Integrations > New Integration > Azure Boards.

3. In the Name field, enter a name for the integration.

4. In the Mandatory section, complete the connection details:

• Project URI
• Username
• Password or Access Token
• Work Item Type Name
• Title Format        

5. In the Optional section, you can specify:

• Domain
• Assigned To
• Tags
• Reopen Status
• Resolved Status
• Custom Fields

6. Click Create Sample Issue to confirm that Acunetix 360 can connect to the configured system. A confirmation message is displayed to confirm that the sample issue has been successfully created.

• In the confirmation message, click the Issue number link to open the issue in your default browser.

7. Click Save to save the integration.

How to Edit the Azure Boards Integration

1. Log in to Acunetix 360.
2. From the main menu, select Integrations > Manage Integration.
3. Next to the Azure Boards, select Edit.
4. Make the necessary changes and select Save.

How to Delete the Azure Boards Integration

1. Log in to Acunetix 360.
2. From the main menu, select Integrations > Manage Integration.
3. Next to the Azure Boards, select Delete.
4. On the confirmation dialog, select Delete.

How to Export Reported Vulnerabilities to Projects in Azure Boards

There are several ways to send issues to Azure Boards with Acunetix 360:

• Once notifications have been configured, you can configure Acunetix 360 to automatically send vulnerabilities to Azure Boards after scanning has been completed (see How to Configure a Notification to Report Vulnerabilities to an Issue Tracking System).

1. You can send one or more issues from the Issues window:
2. From the main menu, select Issues >  All Issues.
3. From the Issues window, select one or more issues you want to send.
4. Select Send To > Azure Boards.

A pop-up is displayed, with a link to the issue you have sent to Azure Boards. If there is an error, this information will be displayed instead.

• You can also send an issue from the Recent Scans window:

1. From the main menu, select Scans > Recent Scans.
2. Next to the relevant scan, select Report.
3. Scroll down to the Technical Report section.
4. From the list of detected vulnerabilities, click to select an issue and display its details.
5. Select Send To > Azure Boards

How to Register an Acunetix 360 Azure Boards Integration Webhook

1. From the main menu, select Integrations > Manage Integrations.
2. Next to the relevant Azure Boards integration, select Edit.

3. In the Webhook URL field, click Copy to clipboard ().
4. Enter your Azure project’s Reopen and Resolved statuses. They are case sensitive. (You can copy these values from the State property.)
5. Open Azure Boards.
6. Select Project Settings from the menu, then select Service Hooks. On the page that opens, select New Service Hooks Subscription.

7. From the opened modal page, select the Web Hooks option, then Next.

8. From the Trigger window, select Work item updated from the Trigger on this type of event drop-down. Next, from the Filters section, select the name of your project from the Area path drop-down.

9. Paste the Webhook URL that you copied from Acunetix 360 into the URL field on the Actions tab. And mark other areas as they appear in the screenshot. Then, you can end the configuration with the Finish button.

10. The Service hooks you have defined will appear in the list. You can edit them as you wish.

11. In Azure Boards, go to the Boards > Work Items window, then click on the problem. From the State drop-down, select Done (or the Resolved option suitable for your project) and then Save.

11. The Webhook is triggered, and Acunetix 360 initiates a new Retest process.
12. In Acunetix 360, from the main menu, select Issues > Waiting For Retest. The Issues window is displayed, showing the issues waiting to be rescanned. The scanning process will begin soon, depending on the availability of the scanning agents.

For further information, see Managing Notifications.