Authentication Personal Access Token (PAT)
Contents
Description
Instructions
To connect to Azure DevOps using a Personal Access Token (PAT), you must first create a valid PAT:- Start by by going to https://aex.dev.azure.com and selecting relevant organization on the left.
-
Then copy Organization's host name part (e.g.
acmeinc
, if full host name isacmeinc.visualstudio.com
), save it to a file, and click it: -
Next, click User settings icon and then click Personal access tokens:
-
Then click New Token button to create a new personal access token:
-
Continue by...
- naming your token
- selecting the right Organization
- setting token's Expiration date (it's recommended to use
Custom defined
option and make it expire after one year or later) - and setting the Scopes:
NOTE: You may be restricted from creating full-scoped PATs. If so, your Azure DevOps administrator in Azure AD has enabled a policy which limits you to a specific custom defined set of scopes.
-
Now click Copy button and save the newly created token into a file for quick access later:
- Go back to the connector screen, input the token you saved in a previous step into the Personal Access Token (PAT) field.
- Then enter the Organization host name part that you noted recorded in previous step into Organization name or Id for url field.
- Enter the name or Id of the project you want to connect to by default in the Default Project (Choose after above fields) field.
- Select the Security tab.
- Enter
https://auditservice.dev.azure.com,https://almsearch.dev.azure.com,https://analytics.dev.azure.com
into the Additional Trusted Domains field. - Select the Test Connection button at the bottom of the window to verify proper connectivity with your Azure DevOps account.
- Done!
Parameters
Parameter | Label | Required | Default value | Options | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Password | Personal Access Token (PAT) | YES |
|
||||||||||||
Organization | Organization name or Id for url | YES |
|
||||||||||||
ApiVersion | API Version | YES |
7.0
|
|
|
||||||||||
AuthScheme | AuthScheme |
Bearer
|
|
||||||||||||
AuthHeader | AuthHeader |
Authorization
|
|
||||||||||||
UserName | UserName |
|
|||||||||||||
Project | Default Project Name (Choose after Generating Token) |
|
|||||||||||||
RetryMode | RetryMode |
RetryWhenStatusCodeMatch
|
|
|
|||||||||||
RetryStatusCodeList | RetryStatusCodeList |
429
|
|
||||||||||||
RetryCountMax | RetryCountMax |
5
|
|
||||||||||||
RetryMultiplyWaitTime | RetryMultiplyWaitTime |
True
|
|