Configuring Workbench for use with Azure DevOps

Granting Azure DevOps Git repository access to Workbench

1. Log onto the server hosting MettleCI Workbench and navigate to /opt/dm/mci/

2. Open the public Git SSH key workbench_rsa.pub in your favorite text edit and copy its contents:

   

   This file is automatically generated and configured during MettleCI workbench installation.

3. Following “Step 2: Add the public key to Azure DevOps Services/TFS” of the Azure DevOps instructions to set up SSH Key Authentication

Register Workbench as an OAuth 2.0 Azure Application

1. Follow Microsoft’s instructions for registering a new app with Azure. Use the following settings:
   

   

2. Note down the “Application (client) ID” and Directory (tenant) ID for later use:
   

   

3. Navigate to the “Authentication” section of your application registration and add a Redirect URI for workbench using the https://<workbench url>:8443/api/auth/delegated/azure_access and click save

   

   If your organization has installed multiple MettleCI Workbench application, you can add them all to the same Azure App Registration by adding multiple Redirect URIs.
   

4. Navigate to the “Certificates & Secrets” section of your application registration and add a “New Client Secret”, select an expiry (Never is convenient) and note down the generated secret for later use:

   

5. Navigate to the “API permissions” section of your application registration, click “Add a permission” and select “Azure DevOps” → “user_impersonatation”:

   

6. Log into your MettleCI Workbench server an open /opt/dm/mci/config.yml in your favorite editor

7. Change the issueManagement property to azure, add an azure section as shown below and replace the <tags> with the values noted in the previous steps:

   issueManagement: azure
   azure:
      tenant: <your Directory (tenant) ID>
      clientId: <your Application (client) ID>
      clientSecret: "<your client secret>"

8. Restart the workbench service

   sudo service dm-mettleci-workbench restart

9. Azure Work Items will be available from the the Issues drop down during Check-in: