Integrating your Azure DevOps Services (ADS) account with DeepSource requires an ADS application. This document outlines the configuration, permission requirements, and app configuration to get started with your ADS account and DeepSource Enterprise.

Creating an Azure DevOps application

🚧

Things to note before you proceed

• Azure doesn't allow access or transfership of an application so it's recommended to create this application using a team or service account.

1. With logged into Azure, visit https://aex.dev.azure.com/ (or the equivalent URL in your Azure DevOps Server instance).
2. Scroll to the bottom. On the left-hand side, you will find a section titled "Applications and services". Click on the "Create new application" under this section. You can also directly visit https://aex.dev.azure.com/app/register.
3. You'd be prompted to fill out a form to create a new application. Enter the following details:

📘

Replace ORGANIZATION_NAME with the name of your organization, and HOSTNAME with the actual hostname on which you plan to deploy DeepSource to.

4. Click on "Save changes".
5. On the next page, You will get theApp ID, Client Secret and Authorize URL. Enter these values in the DeepSource Enterprise admin console.

Configuring the Azure DevOps application in the Admin Console

After you have created your Azure DevOps application, you need to configure it in the DeepSource Admin Console.

1. Visit the Admin Console
2. Navigate to Application -> Config.
3. Select the checkbox for Azure DevOps Services.

4. Fill in the values for the following fields as explained in each field's subtext:
   1. Azure DevOps Services Host Domain
   2. Azure DevOps Services Authority Host
   3. Azure DevOps Services Application ID
   4. Azure DevOps Services Application Client Secret
   5. Azure DevOps Services Webhook Secret

5. Click "Save config".
6. Deploy the new release with the updated config using the "Version history" tab.