Azure DevOps Connector
Documentation
Version: 2
Documentation

Authentication :: Personal Access Token (PAT) [Http]


Description

No description available

Instructions

To connect to Azure DevOps using a Personal Access Token (PAT), you must first create a valid PAT:
  1. Go to your Azure DevOps home page: https://dev.azure.com/{your organization name}.
  2. On the home page, select the User Settings menu dropdown (looks like a person icon with a small gear over it), and then select Personal access tokens.
  3. Select the New Token button.
  4. Enter a name for the new personal access token.
  5. Select the appropriate organization for the new personal access token.
  6. Select the expiration date for the new personal access token.
  7. Select the scopes for this token. (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.)
  8. Select the Create button.
  9. The new Personal Access Token (PAT) is created and displayed. Copy and save this token, since it is as sensitive as a password.
  10. Visit https://aex.dev.azure.com. Once you are logged in, record your organization name in the URL that is displayed on the page. For example, if your organization is called "acmeinc", the URL on the page would be acmeinc.visualstudio.com.
  11. Back at the connector screen, enter the token you recorded from step 9 into the Personal Access Token (PAT) field.
  12. Enter the organization that was recorded in step 10 into the Organization name or Id for url field.
  13. Enter the name or Id of the project you want to connect to by default in the Default Project (Choose after above fields) field.
  14. Select the Security tab.
  15. Enter https://auditservice.dev.azure.com,https://almsearch.dev.azure.com,https://analytics.dev.azure.com into the Additional Trusted Domains field.
  16. Select the Test Connection button at the bottom of the window to verify proper connectivity with your Azure DevOps account.
  17. If the connection test succeeds, select OK.

Parameters

Parameter Label Required Options Description Help
AuthScheme AuthScheme NO
AuthHeader AuthHeader NO
UserName UserName NO
Password Personal Access Token (PAT) YES
Organization Organization name or Id for url YES The organization name or Id obtained from the Azure Portal.
Project Default Project Name (Choose after Generating Token) NO The default project name to make API calls for.
ApiVersion API Version YES
Option Value
6.0 6.0
7.0 7.0
7.0-preview 7.0-preview
7.1-preview.2 7.1-preview.2
The version of the Azure DevOps API to use.
RetryMode RetryMode NO
Option Value
None None
RetryAny RetryAny
RetryWhenStatusCodeMatch RetryWhenStatusCodeMatch
RetryStatusCodeList RetryStatusCodeList NO
RetryCountMax RetryCountMax NO
RetryMultiplyWaitTime RetryMultiplyWaitTime NO