Connect action in Azure DevOps package

The Connect action in the Azure DevOps package enables you to establish an authenticated session with an Azure DevOps instance. Currently, it supports authentication through Personal Access Token (PAT) . On successful execution, the action creates a Azure DevOps session context that can be reused by subsequent actions.

Prerequisites

  • An active Azure DevOps organization is required. The authenticating user must have sufficient privileges within the organization to perform the required operations.
  • A valid Azure DevOps organization URL in the format: https://dev.azure.com/<organization>.
  • A valid Azure DevOps project name within the target organization.
  • Project-level Permissions : The user must have access to an existing project or permission to create one. Within the project, the following granular permissions are required based on intended usage:
    • Repositories: Read, write, and manage access to create and modify repos
    • Pipelines: Create, edit, and delete build/release pipelines
    • Pipeline Runs: Queue and manage pipeline executions
  • Personal Access Token (PAT) authentication is handled through a PAT generated from the user's Azure DevOps account. Perform the following steps to create a personal access token.
    1. Navigate to Organization > Project > Project settings.
    2. On the Project settings page click User settings icon on the right-hand side.
    3. Select Personal access tokens and then click +New Token icon to create access token.
    4. When creating the PAT you can define its access scope:
      • Full access: Grants complete access to all supported operations.
      • Custom defined: For restricted access, grant only the scopes corresponding to the operations your process will perform (example,Code: Read & Write, Build: Read & Execute, Pipeline Resources: Use)

Settings

  • Authentication Method: Choose the method to authenticate with Azure DevOps. Currently, authentication through Personal Access Token (PAT) is only supported.

    Personal Access Token The personal access token used to authenticate with Azure DevOps. Choose Credential to use a credential stored in the Control Room, choose Variable to use a string variable, or choose Insecure string to enter the token directly.

  • Organization URL: Specify the Azure DevOps organization URL, for example, https://dev.azure.com/<organization>. Enter the value directly or use a string variable. The URL must be a valid, accessible Azure DevOps organization URL.
  • Project name: Specify the name of the Azure DevOps project within the specified organization. Enter the value directly or use a string variable.
  • Azure DevOps Session: The session variable to store the Azure DevOps session context. Choose Local session to scope the session to the current bot, Global session to share it across bots such as parent bots and child bots. Create or select an existing session variable of the Azure DevOps session subtype.