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.

FieldValueExample
Company nameDeepSource Enterprise ServerDeepSource Enterprise Server
Application nameDeepSource ORGANIZATION_NAMEDeepSource Stark International
Application websitehttps://HOSTNAMEhttps://deepsource.stark.com/
Authorization callback URLhttps://HOSTNAME/accounts/ads/login/callback/bifrosthttps://deepsource.stark.com/accounts/ads/login/callback/bifrost/
Authorized scopesCheck the following boxes: - Code (read and write) - Code (status) - Project and team (read)
  1. Click on “Save changes”.
  2. 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.
  1. 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
  1. Click “Save config”.
  2. Deploy the new release with the updated config using the “Version history” tab.