---
sourceDocument: Australia Strategic Portfolio Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/it-business-management

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia Strategic Portfolio Management

ft:clusterId :

    - itbm

bundleId :

    - itbm

workflow :

    - Technology


---

# Connecting Agile Development 2.0 and Azure DevOps

# Connecting Agile Development 2.0 and Azure DevOps {#ariaid-title1}

Establish a connection between Agile Development 2.0 and Azure DevOps using a connection alias and an Azure DevOps instance.

## Create an Azure DevOps connection alias {#ariaid-title2}

Create a Basic Auth credential and an HTTP(s) connection which will together be used as a connection alias to establish a connection with Azure DevOps.

### Antes de Iniciar

Roles required:

* admin to create a connection and credential alias
* sn_ado_int.admin or sn_ado_int.user to create basic authorization credentials and HTTP(s) connection
{#create-credential-alias-agile-azure__ul_r5c_s33_hmb}

### Procedimento

1. [Create a Connection
   \& Credential alias](https://www.servicenow.com/docs/access?context=connection-alias&version=australia&pubname=australia-platform-security&ft:locale=en-US)  
   * A connection alias (sn_ado_int.Azure_DevOps) is available by default.
   * You must create a connection alias for every Azure DevOps organization that you use.
   {#create-credential-alias-agile-azure__ul_od2_wd2_3kb}
2. Use OAuth 2.0 or Basic Auth to create credentials.
   * OAuth 2.0: See [Set up the Microsoft Azure DevOps Boards spoke using OAuth](https://www.servicenow.com/docs/access?context=setup-azdevops-boards-oauth&version=australia&pubname=australia-integrate-applications&ft:locale=en-US).  
     Importante:  
     Make sure to specify a username in the OAuth 2.0 Credentials \[oauth_2_0_credentials\] table for the Credential Alias record. This username must correspond to the service account used to interact with Azure DevOps.
   * Basic Authentication: See [Basic authentication credentials](https://www.servicenow.com/docs/access?context=r_BasicAuthCredentialsForm&version=australia&pubname=australia-platform-security&ft:locale=en-US).  
     Nota:  
     When creating Basic Auth credentials, use the details of your personal access token in Azure DevOps.
     * Set the Password field of the basic authentication credential as the personal access token in Azure DevOps.
     * Set the User Name field of the basic authentication credential as the username used to create the personal access token in Azure DevOps.

       If your login is in the format of
       domainname\\username, use only the username.
     {#create-credential-alias-agile-azure__ul_mhg_fbk_f4b}
   {#create-credential-alias-agile-azure__choices_wkb_fct_gdc}
3. Create [Create an HTTP(s) connection](https://www.servicenow.com/docs/access?context=create-https-connection&version=australia&pubname=australia-platform-security&ft:locale=en-US).
{#create-credential-alias-agile-azure__steps_xkk_htn_nkb}

### O que Fazer Depois

[Create an Azure DevOps instance](https://servicenow-prod.fluidtopics.net/xDAaKBbxP_ndO13~wD4H4w#create-azure-instance "Create an Azure DevOps instance record using the connection alias that you created. This instance is used to establish an integration between Agile Development 2.0 and Azure DevOps.")
.

## Create an Azure DevOps instance {#ariaid-title3}

Create an Azure DevOps instance record using the connection alias that you created. This instance is used to establish an integration between Agile Development 2.0 and Azure DevOps.

### Antes de Iniciar

Role required: sn_ado_int.admin or sn_ado_int.user

### Procedimento

1. Navigate to AllAgile Azure DevOps IntegrationAzure DevOps Instances.
2. Click New.
3. On the form, fill in the fields.  
   {#create-azure-instance__table_gjy_2tf_sjb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Name of the Azure DevOps instance. Enter a name of your choice. |
   | Connection Alias | Azure DevOps connection alias that you already created. Use the lookup (![Lookup icon]()) option to select your connection alias. |
   | Version | Azure DevOps version. Use the lookup (![Lookup icon]()) option to select your Azure DevOps version. |
   [Tabela 1. Azure DevOps Instance form]

   {#create-azure-instance__table_gjy_2tf_sjb}
4. Click Submit.
{#create-azure-instance__steps_uyl_pqf_sjb}

### O que Fazer Depois

[Connect to Azure DevOps](https://servicenow-prod.fluidtopics.net/xDAaKBbxP_ndO13~wD4H4w#connect-to-azure "Connect Azure DevOps with Agile Development 2.0 to enable the integration.")
.

## Connect to Azure DevOps {#ariaid-title4}

Connect Azure DevOps with Agile Development 2.0 to enable the integration.

### Antes de Iniciar

Role required: sn_ado_int.user

### Procedimento

1. Navigate to AllAgile Azure DevOps IntegrationAzure DevOps Instances.
2. Open your Azure DevOps instance record.
3. Click Connect.
{#connect-to-azure__steps_gsp_g5f_sjb}

### Resultado

If the State field on the Azure DevOps Instance record shows:

* Connected, the connection is successful.
* Not connected, the connection could not be established. You can view the reason for the failure in the error message.
{#connect-to-azure__ul_wmm_s1d_4kb}

### O que Fazer Depois

[Discover and import Azure DevOps projects](https://servicenow-prod.fluidtopics.net/lZkKTj_zFE0rpz32Fku7pg "Discover and import all available Azure DevOps projects into Agile Development 2.0 to start using the integration between the two applications.")
.