> For the complete documentation index, see [llms.txt](https://docs.softwaresecured.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.softwaresecured.com/account/integrations/azure-devops.md).

# Azure DevOps

Integrate Azure DevOps and Portal to link your work items to your vulnerabilities.

{% hint style="info" %}
Note: This integration is available with the Standard Plus package or above.
{% endhint %}

### Prerequisites

* An account with <mark style="color:orange;">Org Admin</mark> permissions.

### **Steps**

{% stepper %}
{% step %}

#### Start the integration setup

1. In the <code class="expression">space.vars.product\_name</code> navigation sidebar, locate the <mark style="color:orange;">**Integrations**</mark> page near the bottom and open it
2. Find the Azure integration card, and then click <mark style="color:orange;">**Add Azure Account**</mark>**.**
   {% endstep %}

{% step %}

#### Allow <code class="expression">space.vars.product\_name</code> access to your DevOps Tenant

1. When entering the setup, you might be redirected to the Microsoft login page since Portal requests a scope increase on the permissions that are related to Azure DevOps. Accept the new login scope to continue setup.
2. Depending on how your organization is set up, you might need admin approval to allow <code class="expression">space.vars.product\_name</code> to access your DevOps tenant.
   {% endstep %}

{% step %}

#### Enter your Azure DevOps base URL

1. Each Azure DevOps tenant has its own base URL. <code class="expression">space.vars.product\_name</code> requires your organization's DevOps URL to integrate with it.
2. To find your Azure DevOps tenant URL, log in to your DevOps tenant. You'll see your tenant's URL in the URL bar of your browser, formatted like the following example:\
   `https://dev.azure.com/your_org_name` <br>

   <figure><img src="https://3399686764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2VRHlIPF1fbDuNbp9G2t%2Fuploads%2Fr5G9bJ34pJBAiVfG2kIT%2FScreenshot%202026-06-19%20105341.png?alt=media&amp;token=4273913f-e435-46ea-bda1-526341ae2288" alt=""><figcaption><p>Enter your Azure DevOps Server URL.</p></figcaption></figure>

{% endstep %}

{% step %}

#### Select projects and boards

1. Select the Azure DevOps Project that you would like to connect. When creating tickets in DevOps from vulnerabilities in <code class="expression">space.vars.product\_name</code>, they will be created in this project.
2. Select the <code class="expression">space.vars.product\_name</code> Project that you would like to connect to.\ <br>

   <figure><img src="https://3399686764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2VRHlIPF1fbDuNbp9G2t%2Fuploads%2FPF1QDvGQQdeFYO9IgeXS%2FScreenshot%202026-06-19%20105139.png?alt=media&amp;token=892eb826-1de7-4408-a819-1f1fd948baff" alt=""><figcaption><p>Select your Azure DevOps project and Portal project for integration.</p></figcaption></figure>

{% endstep %}

{% step %}

#### Configure field mapping

{% hint style="success" %}

#### Note

If you already have fields in Azure that match the name of the fields in <code class="expression">space.vars.product\_name</code>, they are automatically mapped to each other.
{% endhint %}

1. Select the Azure DevOps record type that you would like the integration to use when creating new tickets. You can select any record type from your project.&#x20;
2. If necessary, customize the field mapping by selecting different fields from the dropdown menus.&#x20;

<figure><img src="https://3399686764-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2VRHlIPF1fbDuNbp9G2t%2Fuploads%2FOQRVteBSfep75F9UmbKp%2Fimage.png?alt=media&amp;token=098e94e8-6a90-474a-b67d-fb2a34ca793f" alt=""><figcaption><p>Configure field mapping between Portal and Azure DevOps.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Review and enable the integration

1. Review your integration configuration.&#x20;
2. To enable the integration, click <mark style="color:orange;">**Finish**</mark>.
   {% endstep %}
   {% endstepper %}

### Results

Use Azure DevOps to track remediation progress for your vulnerabilities. For more information, see [Using integrations to track remediation](/after-testing/remediating-vulnerabilities/using-integrations-to-track-remediation.md).&#x20;