Azure DevOps: PR Gating via Aikido Dashboard with a Personal Access Token

We recommend setting up this integration with a newly created user in Azure (e.g. called Aikido). The commenting feature uses the name of the user who has set up the integration.

Please note that for the integration to work properly, you must be able to manage service hooks in all projects within your organization. This is usually a reserved permission for Azure workspace admins.

First, go to the PAT management page in Aikido, which can be found here.

Next, follow the instructions below to generate a PAT in Azure DevOps.

Generating a PAT

1. Navigate to 'User Settings' > 'Personal Access Tokens', via the header icon shown here

   

   User settings menu highlighted near search and profile options.

   Or use the shortcut link 'Generate Access Token here' on the personal access token management page in Aikido.

   

   Input field for personal access token with option to generate or update token.
2. You should end up on a page similar to this

   

   Azure DevOps: No personal access tokens created; option to generate a new token available.
3. Make sure you have selected the same organization as the one in your Aikido workspace via the 'Access scope' button on the top right

4. Click on "New token"

5. Next you need to select the following permissions for the token: Work Items (Read & Write), Code (Read & Write), Code (Status) and Build (Read)

   

   Creating a custom personal access token with specific security and repository permissions.
6. For the expiration, use custom defined and set it to 1 year from now, this is the maximum duration that Azure DevOps allows the token to be valid for.

7. Click on 'Create' to create the access token

8. Copy the token on the next screen and insert it on the personal access token management page in Aikido.