> 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

#### Prerequisites

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

#### **Steps**

1. 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 Jira integration card, and then click <mark style="color:orange;">**Add Azure Account**</mark>**.**

2. Allow Portal access to your DevOps Tenant
   1. When entering the setup, you may be redirected to the Microsoft login page as we request a scope increase on the permissions Portal has related to Azure DevOps. Accept the new login scope to continue setup.
   2. Depending on how your organization is setup, you may require admin approval to allow us access to your DevOps tenant.

3. Enter your Azure DevOps base URL
   1. Each Azure DevOps tenant has it's own base URL. Portal needs to know your organizations DevOps URL to integrate with it.
   2. To find your Azure DevOps tenant URL, login to your DevOps tenant. You'll see your tenants URL in the URL bar of your browser, formatted as the following:\
      `https://dev.azure.com/your_org_name` <br>

      <figure><img src="/files/nH7eJZpMEFhxN7nd6Piq" alt=""><figcaption><p>Enter your Azure DevOps Server URL.</p></figcaption></figure>

4. Select projects and boards.&#x20;
   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="/files/2lIwofycLMme0p5Exmds" alt=""><figcaption><p>Select your Azure DevOps project and Portal project for integration.</p></figcaption></figure>

5. Configure field mapping.&#x20;

{% hint style="success" %}

#### Note

If you already have fields in Jira 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="/files/EWt6OQfFNnWuNYYqn0aw" alt=""><figcaption><p>Configure your field mapping between Portal and Azure DevOps.</p></figcaption></figure>

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

#### 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;