Personal Access Token (PAT)
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 | Required | Default value | Options | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Name: Password Label: Personal Access Token (PAT) |
YES | ||||||||||||
Name: Organization Label: Organization name or Id for url |
YES | ||||||||||||
Name: ApiVersion Label: API Version |
YES |
7.0
|
|
||||||||||
Name: AuthScheme Label: AuthScheme |
Bearer
|
||||||||||||
Name: AuthHeader Label: AuthHeader |
Authorization
|
||||||||||||
Name: UserName Label: UserName |
|||||||||||||
Name: Project Label: Default Project Name (Choose after Generating Token) |
|||||||||||||
Name: RetryMode Label: RetryMode |
RetryWhenStatusCodeMatch
|
|
|||||||||||
Name: RetryStatusCodeList Label: RetryStatusCodeList |
429
|
||||||||||||
Name: RetryCountMax Label: RetryCountMax |
5
|
||||||||||||
Name: RetryMultiplyWaitTime Label: RetryMultiplyWaitTime |
True
|