SUPPORT

Contact Support

OPEN A TICKET

Integrating Netsparker Enterprise with Azure Boards

Microsoft Azure 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.

This topic explains how to configure Netsparker Enterprise to send a detected vulnerability to Azure Boards.

Netsparker Enterprise has out-of-the-box support for resolving and reactivating Azure Boards issues according to the scan results, in addition to automatic issue creation. Netsparker Enterprise uses user-provided resolved and reopened statuses in Azure Boards for this purpose.

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

  • Netsparker Enterprise 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 Netsparker Enterprise 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 Netsparker Enterprise and a retest scan is started. And, when you change your Azure Boards issue’s status to your preferred Reopened status, your corresponding Netsparker Enterprise issue is automatically marked as revived.

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

Azure Boards Fields

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

Button/Section/Field

Description

Name

This is the name of the configuration that will be shown elsewhere.

Mandatory

This section contains fields that must be completed.

Project URI

This is the Azure Boards project web address.

Username

This is the name of the user. If you are using a personal access token (see below), leave this field blank.

Password or
Access Token

This is the password or the access token for the user. If the password is entered, you need to provide the username too. (You can generate an access token by navigating to Azure DevOps Services, and selecting Security on your Profile context menu, then Personal Access Tokens.)

Work Item
Type Name

This is the type of work item (bug, task).

Title Format

This is the strong format that is used to create the vulnerability title.

Optional

This section contains options fields.

Domain

This is the domain of the user.

Assigned To

This is the user to whom the issue is assigned.

Tags

These are the work item tags, separated by a semicolon (;).

Reopen Status

Reopen Statuses vary according to the project type. Please write the correct values for your project type. This is the status of the reopened issues or tickets.

Resolved Status

Resolved Statuses vary according to the project type. Please write the correct values for your project type (This is the status name of the resolved issues or tickets. see Azure Boards State Categories).

Custom Fields

This section contains user-defined custom fields.

New Custom Field

Click to create a new custom field.

Name

Enter a name for the new custom field identifier.

Value

Enter a value for the new custom field.

Drop-down

Click the drop-down to change the input type. The options are:

  • Text
  • Password
  • Textarea
  • File upload
  • Complex

Create Sample Issue

Once all relevant fields have been configured, click to create a sample issue.

Save

Once all relevant fields have been configured, click the Save button to save integration settings.

How to Integrate Netsparker Enterprise with Azure Boards

  1. Log in to Netsparker Enterprise.
  2. From the main menu, select Integrations > New Integration.
  3. From the Issue Tracking Systems section, select Azure Boards.
  4. In the Name field, enter a name for the integration.
  5. In the Mandatory section, complete the connection details:
    • Project URI
    • Username
    • Password or Access Token
    • Work Item Type Name    
    • Title Format        
  1. Open Azure Boards.
  2. From the upper right menu, select the user icon, and then Personal Access Tokens. The current Personal Access Tokens are displayed. (Or you can create a new Personal Access Token by clicking New Token.)

Create a Personal Token in Azure DevOps

  1. Copy the Token value from Azure Boards (you will need it in the next step).
  2. In Netsparker Enterprise, paste it into the Password or Access Token field.
  3. Select Create Sample Issue to confirm that Netsparker Enterprise can connect to the configured system. A confirmation message is displayed to confirm that the sample issue has been successfully created.
  4. In the confirmation message, select the Issue number link to open the issue in your default browser.
  5. If the Azure Boards integration is not configured correctly, Netsparker Enterprise will correctly route the following descriptive error messages to you. Sample error messages may be displayed as illustrated:
    • If any information is entered incorrectly

  1. Select Save to save the integration.

How to Export Reported Vulnerabilities to Projects in Azure Boards

There are several ways to send issues to Azure Boards with Netsparker Enterprise:

  • Once notifications have been configured, you can configure Netsparker Enterprise 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).
    • You can send one or more issues from the Issues window:
    • You must have Manage Issue permission.
    • From the main menu, select Issues > All Issues
    • From the Issues window, select one or more issues you want to send.
    • Select Send To > Azure Boards.

    • A popup 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:
    • From the main menu, select Scans > Recent Scans.
    • Next to the relevant scan, click Report. The report is displayed.
    • Scrolls down to the Technical Report section.
    • From the list of detected vulnerabilities, select an issue and display its details.

      • Select Send To Azure Boards.
      • If you have previously submitted this vulnerability to Azure Boards, it will already be accessible. You cannot submit the same issue twice.
    • If you view opened problem logs in Azure Boards, they look like this.

    • Work item details on Azure Boards look like this.

    How to Register a Netsparker Enterprise 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, select 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.

    New Service Hooks Subscription in Azure DevOps

    1. From the opened modal page, select the Web Hooks option, then Next.
    2. In the next step, accurately identify the information requested from you to be compatible with the Netsparker Enterprise side.
    3. Paste the Webhook URL that you copied by Netsparker Enterprise 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.

    WebHook Action in Azure DevOps

    1. The Service hooks you have defined will appear in the list. Then you can edit it as you wish.   

    Service Hook in Azure DevOps

    1. In Azure Boards, go to the Boards> Work Items window, then select the problem. From the State drop-down, select Done (or the Resolved option suitable for your project) and then Save.
    2. The Webhook is triggered, and Netsparker Enterprise initiates a new Retest process.
    3. In Netsparker Enterprise, from the main menu, select Scans 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.

    If the problem is found again, the status will be withdrawn to the value you have specified in the Reopen status. However, for this to happen, please add your integrations in the ‘Integration Endpoint’ field of the Notification > Manage Notification > Scan Completed event.

    For further information, see Managing Notifications.

    Netsparker

    Highly accurate, fast & easy-to-use Web Application Security Scanner

    Get a demo