{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":32143,"path":"it-service-management/devops-change-velocity/devops-wkspc-azuredevops-tool-conn.md","title":"Onboard Azure DevOps to DevOps Change Velocity — Workspace","bundle":null,"doc_type":null,"release":"australia","body":"\n# Onboard Azure DevOps to DevOps Change Velocity — Workspace\n\nConnect to your Azure DevOps instance using the DevOps Change Workspace playbook to collect data for planning, coding, orchestration, artifact, and software quality functions.\n\nYou can connect to Azure DevOps \\(ADO\\) at your organization level or at individual project level. If you're connecting at the project level, for each project at your organization, you must repeat the connection process. After connecting to an instance of the tool, you can configure additional settings that enable DevOps to import pipelines, task execution records, and step execution records.\n\nWhen you configure webhooks in your Azure DevOps instance to send data to DevOps Change Velocity, Azure DevOps uses token authentication for the integration user by default. The DevOps Change Velocity APIs are invoked using token authentication and you don’t have to enter the integration user name and password while configuring. If the devops.system user isn’t available in your ServiceNow instance, you must set the **Switch to this user after token based authentication is successful** property. For more information, see [DevOps Change Velocity properties](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/dev-ops-administration.md). The step to enter the integration user name and password is required only in the following scenarios:\n\n-   If DevOps Config is installed, as DevOps Config APIs are invoked using basic authentication.\n-   If you use the Azure Invoke REST API service connection. You must enable the **This property decides whether to create a Generic Connection on configure operation for Azure DevOps** property in this case.\n\n**Note:** DevOps Change Velocity uses the term instance to refer to a particular occurrence of a tool. Azure DevOps uses the term project instead.\n\n**Parent Topic:**[Azure DevOps integration with DevOps Change Velocity](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/azure-devops-integration-dev-ops.md)\n\n## Connect an organization\n\nConnect and configure your Azure DevOps instance directly at your Azure DevOps organization level. All the projects within the organization can be discovered, and you can choose to configure multiple projects within the organization. You can manage the tool at the organization level.\n\n### Before you begin\n\nComplete the tasks specified in the [Getting started with DevOps Change Velocity](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/setting-up-devops-change-velocity.md) topic.\n\nRole required: sn\\_devops.admin or sn\\_devops.tool\\_owner\n\n### Procedure\n\n1.  Navigate to **Workspaces** &gt; **DevOps Change Workspace** and use one of the following options to open the Playbook to onboard Azure DevOps.\n\n<table id=\"choicetable_m3t_ky1_fwb\"><thead><tr><th align=\"left\" id=\"d43199e220\">\n\nOption\n\n</th><th align=\"left\" id=\"d43199e223\">\n\nSteps\n\n</th></tr></thead><tbody><tr><td id=\"d43199e229\">\n\n**Homepage**\n\n</td><td>\n\n1.  Select **Connect a tool**.\n2.  On the  Connect to a tool  modal, select Azure DevOps from the appropriate category \\(Orchestration, Plan, Code, Artifact, or Software quality\\).\n\n\n</td></tr><tr><td id=\"d43199e253\">\n\n**Applications module**\n\n</td><td>\n\n1.  Select **Applications** \\(\\[Omitted image \"applications-icon.png\"\\] Alt text: Applications icon.\\) from the primary navigation.\n2.  Select an existing application, or create one. To create an application, see [Create an application - Workspace](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/app-create-workspace.md).\n3.  From the  Recommended actions  pane, select the  **Connect a tool ** card.\n4.  On the  Connect to a tool  modal, select Azure DevOps from the appropriate category \\(Orchestration, Plan, Code, Artifact, or Software quality\\).\n\n\n</td></tr><tr><td id=\"d43199e302\">\n\n**Tools module**\n\n</td><td>\n\n1.  Select **Tools** \\(\\[Omitted image \"tools-icon-wkspc.png\"\\] Alt text: Tools icon.\\) from the primary navigation.\n2.  From the Capability list, select the appropriate category \\(Orchestration, Planning, Coding, Artifact, or Software quality\\).\n3.  Select **Connect a tool**.\n4.  On the  Connect to a tool  modal, select **Azure DevOps**.\n\n\n</td></tr></tbody>\n</table>    **Important:** If you want to discover and track tool objects like pipelines, plans, or repositories while connecting to the tool, you must connect your tool from the Application module.\n\n2.  In the Connect to a tool modal, enter the connection details.\n\n    1.  Select **Connect an organization** from the drop-down list.\n    2.  Enter the Azure DevOps URL for the organization.\n    3.  In the **Tool name** field, enter a name for the tool.\n    4.  Select **Next**.\n\n        \\[Omitted image \"azure-plybk-09.png\"\\] Alt text: Connect to organization.\n\n        The DevOps playbook opens to help you complete the onboarding tasks.\n\n3.  In the Enter Azure DevOps instance details section, select one of the following values in the **Credential type** field.\n\n<table id=\"choicetable_j33_jgk_lcc\"><tbody><tr><td id=\"d43199e409\">\n\n**Personal Access Token**\n\n</td><td>\n\nEnter the password or access token to access this instance.For information on creating a PAT, see [Personal access token \\(PAT\\)](https://docs.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=preview-page). \\[Omitted image \"ado-pat-01.png\"\\] Alt text: Connect to a tool - ADO PAT\n\n</td></tr><tr><td id=\"d43199e429\">\n\n**OAuth 2.0**\n\n</td><td>\n\nPre-requisites: -   [Create a tenant in Microsoft Entra](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n-   [Add a user to tenant in Microsoft Entra](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n-   [Create an organization in Azure portal](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n-   [Create an Azure DevOps app](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n-   [Register Azure DevOps as an OAuth provider](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n-   [Configure organization and project level settings](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n-   [Create credential record and get OAuth token](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n**Use an existing OAuth credential record**1.  Select the **Use an existing OAuth credential record** option.\n2.  Select a value in the **Credential** field.\n**Create a new credential record**1.  Clear the **Use an existing OAuth credential record** option.\n2.  Enter the application ID of your Azure application \\(available in the Overview section of your Azure application registry in Azure\\) in the **Application \\(client\\) ID** field.\n3.  Enter the directory ID of your Azure application \\(available in the Overview section of your Azure application registry in Azure\\) in the **Directory \\(tenant\\) ID** field.\n4.  Enter the client secret of your Azure application \\(available in the Certificates &amp; secrets section of your Azure application registry in Azure\\) in the **Client secret** field.\\[Omitted image \"ado-oauth-01.png\"\\] Alt text: Connect to a tool - ADO OAuth 2.0\n\n\n</td></tr></tbody>\n</table>4.  If your tool instance is attached to a MID Server, select the **MID Server** option and enter its details.\n\n    For more information about MID server, see [MID Server selection](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/servicenow-platform/c_MIDServerSelector.md).\n\n5.  Select **Connect**.\n\n6.  Permission checks are run on the credentials that you entered.\n\n    Permissions required and permissions that are available are displayed. If you want to enter credentials with better permissions, select **Re-enter credentials**. For detailed information on all the required permissions, see Azure DevOps permissions in [Permissions required for DevOps tools](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/tool-req-permission.md).\n\n    You can choose to continue with the tool connection even if you don't have all the required permissions.\n\n    **Note:** When onboarding an Organization, the **Project Administrators** privilege requires the owner of the PAT to be a member of the organization's **Project Collection Administrators** group.\n\n    You need the Project Administrators privilege only for onboarding the tool. Once the tool is successfully onboarded, you can choose to turn off the Project Administrators privilege from the PAT.\n\n    \\[Omitted image \"azure-plybk-03.png\"\\] Alt text: Permissions required for Azure PAT.\n\n7.  Specify the access for the tool.\n\n    1.  If you want to control access to the tool, add the groups that must be given access to the tool in the **Maintained by** field.\n\n        The tasks these users in the groups can perform depends on the role assigned to them.\n\n        -   DevOps Tool Owner role: Can view and edit the tool.\n        -   DevOps App Owner role: Can view the tool and can associate, discover, import historical data, and modify pipeline steps \\(if applicable\\) of the tool's objects \\(such as plans, repositories, and pipelines\\).\n        -   DevOps Administrator role: Can edit all tools.\n        -   Other DevOps roles: Can view the tool.\n        **Note:** If you don't select a group and skip this step, all users with the DevOps Tool Owner role will be able to edit the tool.\n\n    2.  If you choose to control access to the tool, the **All DevOps App Owners can view and associate tool objects to applications** option becomes available for selection.\n\n        This option enables all users having the DevOps App Owner role to access the tool. If selected, they’ll be able to view, associate, discover, import historical data, and modify pipeline steps \\(if applicable\\) of the tool's objects.\n\n    3.  Select **Assign**.\n\n        \\[Omitted image \"azure-plybk-11.png\"\\] Alt text: Assign access groups.\n\n8.  Install the ServiceNow DevOps extension in your Azure DevOps instance.\n\n    The ServiceNow DevOps extension will automatically create service connections while configuring webhooks. Service connections are required for sending build and release notifications from Azure DevOps. The extension also contains custom tasks to modify the Azure DevOps pipelines for change control, artifacts, and packages.\n\n    For more information on the extension, see [Use the ServiceNow DevOps extension for Azure DevOps and Azure DevOps custom actions](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/config-dev-ops-extensions-azure.md).\n\n    **Note:** If you skip this step, to send notifications from Azure DevOps, you must manually create service connections after configuring webhooks.\n\n    After installing the extension, select **Marked as installed**.\n\n    \\[Omitted image \"azure-plybk-01.png\"\\] Alt text: Install the ServiceNow DevOps extension.\n\n9.  Configure webhooks automatically in your Azure DevOps instance to send data to DevOps Change Velocity.\n\n    Choose to send data by either nightly polling or configuring webhooks to send real-time data.\n\n    -   Webhooks: Enable real-time notifications for your pipeline executions. Real-time notifications are ideal to maintain the most up-to-date information particularly for automating change requests.\n\n        To use webhooks, select **Configure.**\n\n    -   Nightly polling: If you don’t choose to configure now, you can enable nightly polling later to fetch data for any tracked plans by setting the **Enable Polling** property to **Yes**.\n    1.  Enter the DevOps integration user name and password.\n\n        For information about creating the DevOps integration user and password, see [Set up integration user account in DevOps Change Velocity](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/devops-plybk-set-up-system-accts.md).\n\n        **Note:**\n\n        -   The step to enter the integration user name and password is required to configure only when DevOps Config is installed or the **This property decides whether to create a Generic Connection on configure operation for Azure DevOps** property is enabled. If this step is not required, webhooks are configured using token-based authentication.\n        -   When DevOps Config is installed or the Generic Connection on configure operation for Azure DevOps property is enabled, you can regenerate token \\(auto-configure with new token\\) from the workspace UI only, which will update the integration user password. When DevOps Config is not installed, token can be regenerated from both the workspace and classic UI for token based authentication. Re-generate your token periodically for better security.\n    2.  Select the projects for which you want to configure webhooks.\n    3.  Select **Configure**.\n\n        \\[Omitted image \"azure-plybk-13.png\"\\] Alt text: Configure Azure DevOps for organization.\n\n    To configure webhooks manually, select **Configure manually**. See [Configure webhooks in Azure DevOps manually](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/configure-test-webhooks.md) for more information.\n\n    Webhook configuration and discovery happen in the background, and you’re taken to the Summary page.\n\n    \\[Omitted image \"azure-plybk-15.png\"\\] Alt text: Organization connection summary.\n\n10. From the Summary page, select **View tool record** to review the details of the connected tool.\n\n\n### Result\n\nYou’ve successfully onboarded your Azure DevOps tool to DevOps Change Velocity at the organization level.\n\n### What to do next\n\nFrom the **Projects** tab on the tool record page, select a project to navigate to the project record page. From here, you can discover project objects, and configure webhooks for the project.\n\n-   Select **Discover** to discover the project objects, including existing plans \\(boards\\), repositories, and pipelines.\n-   If you created the tool directly at the project level, then selecting **Discover projects** from the **Projects** tab of the tool record page will discover all the projects in your organization.\n-   Select **Configure** and enter the integration user credentials to configure webhooks for the project.\n-   If you're on the tool records page, selecting **Configure projects** and entering the integration user credentials gives the list of unconfigured projects in your organization. Select the projects that you want webhooks configured for and select **Configure**.\n\n    **Note:** The step to enter the integration user name and password is required to configure webhooks only when DevOps Config is installed or the Generic Connection on configure operation for Azure DevOps property is disabled. If this step is not required, webhooks are configured using token-based authentication.\n\n-   To import historical data to the project objects like plans, repositories, or pipelines, associate the objects with an application, and import the data. For more information, see [Associate tool objects to applications - Workspace](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/apps-associate-objects-wkspc.md).\n\n## Connect a project\n\nConnect and configure your Azure DevOps instance directly at the project level. If you have multiple projects within the organization, you must connect each of them separately.\n\n### Before you begin\n\nComplete the tasks specified in the [Getting started with DevOps Change Velocity](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/setting-up-devops-change-velocity.md) topic.\n\nRole required: sn\\_devops.admin or sn\\_devops.tool\\_owner\n\n### Procedure\n\n1.  Navigate to **Workspaces** &gt; **DevOps Change Workspace** and use one of the following options to open the Playbook to onboard Azure DevOps.\n\n<table id=\"choicetable_m3t_ky1_fwb\"><thead><tr><th align=\"left\" id=\"d43199e1063\">\n\nOption\n\n</th><th align=\"left\" id=\"d43199e1066\">\n\nSteps\n\n</th></tr></thead><tbody><tr><td id=\"d43199e1072\">\n\n**Homepage**\n\n</td><td>\n\n1.  Select **Connect a tool**.\n2.  On the  Connect to a tool  modal, select Azure DevOps from the appropriate category \\(Orchestration, Plan, Code, Artifact, or Software quality\\).\n\n\n</td></tr><tr><td id=\"d43199e1096\">\n\n**Applications module**\n\n</td><td>\n\n1.  Select **Applications** \\(\\[Omitted image \"applications-icon.png\"\\] Alt text: Applications icon.\\) from the primary navigation.\n2.  Select an existing application, or create one. To create an application, see [Create an application - Workspace](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/app-create-workspace.md).\n3.  From the  Recommended actions  pane, select the  **Connect a tool ** card.\n4.  On the  Connect to a tool  modal, select Azure DevOps from the appropriate category \\(Orchestration, Plan, Code, Artifact, or Software quality\\).\n\n\n</td></tr><tr><td id=\"d43199e1145\">\n\n**Tools module**\n\n</td><td>\n\n1.  Select **Tools** \\(\\[Omitted image \"tools-icon-wkspc.png\"\\] Alt text: Tools icon.\\) from the primary navigation.\n2.  From the Capability list, select the appropriate category \\(Orchestration, Planning, Coding, Artifact, or Software quality\\).\n3.  Select **Connect a tool**.\n4.  On the  Connect to a tool  modal, select **Azure DevOps**.\n\n\n</td></tr></tbody>\n</table>    **Important:** If you want to discover and track tool objects like pipelines, plans, or repositories while connecting to the tool, you must connect your tool from the Application module.\n\n2.  In the Connect to a tool modal, enter the connection details.\n\n    1.  Select **Connect a project** from the drop-down list.\n    2.  Enter the Azure DevOps URL for the project.\n    3.  In the **Tool name** field, enter a name for the tool.\n    4.  Select **Next**.\n\n        The DevOps playbook opens to help you complete the onboarding tasks.\n\n    \\[Omitted image \"azure-plybk-10.png\"\\] Alt text: Connect to project.\n\n3.  Enter the instance details for your tool.\n\n    1.  In the Enter Azure DevOps instance details section, select one of the following values in the **Credential type** field.\n\n        -   **Personal Access Token**: Enter the password or access token to access this instance.\n\n            For information on creating a PAT, see [Personal access token \\(PAT\\)](https://docs.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=preview-page). \\[Omitted image \"ado-pat-01.png\"\\] Alt text: Connect to a tool - ADO PAT\n\n        -   **OAuth 2.0**: Pre-requisites:\n\n            -   [Create a tenant in Microsoft Entra](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n            -   [Add a user to tenant in Microsoft Entra](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n            -   [Create an organization in Azure portal](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n            -   [Create an Azure DevOps app](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n            -   [Register Azure DevOps as an OAuth provider](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n            -   [Configure organization and project level settings](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n            -   [Create credential record and get OAuth token](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/set-up-azure-devops-oauth-2-0-credential.md)\n            **Use an existing OAuth credential record**\n\n            1.  Select the **Use an existing OAuth credential record** option.\n            2.  Select a value in the **Credential** field.\n            **Create a new credential record**\n\n            1.  Clear the **Use an existing OAuth credential record** option.\n            2.  Enter the application ID of your Azure application \\(available in the Overview section of your Azure application registry in Azure\\) in the **Application \\(client\\) ID** field.\n            3.  Enter the directory ID of your Azure application \\(available in the Overview section of your Azure application registry in Azure\\) in the **Directory \\(tenant\\) ID** field.\n            4.  Enter the client secret of your Azure application \\(available in the Certificates &amp; secrets section of your Azure application registry in Azure\\) in the **Client secret** field.\n            \\[Omitted image \"ado-prj-oauth.png\"\\] Alt text: Connect to a tool - ADO OAuth\n\n    2.  If your tool instance is attached to a MID Server, select the **MID Server** option and enter its details.\n\n        For more information about MID server, see [MID Server selection](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/servicenow-platform/c_MIDServerSelector.md).\n\n    3.  Select **Connect**.\n\n    4.  Permission checks are run on the credentials that you entered.\n\n        Permissions required and permissions that are available are displayed. If you want to enter credentials with better permissions, select **Re-enter credentials**. For detailed information on all the required permissions, see Azure DevOps permissions in [Permissions required for DevOps tools](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/tool-req-permission.md).\n\n        You can choose to continue with the tool connection even if you don't have all the required permissions.\n\n        **Note:** When onboarding a Project, the **Project Administrators** privilege requires the owner of the PAT to be a member of the project's **Project Administrators** group.\n\n        You need the Project Administrators privilege only for onboarding the tool. Once the tool is successfully onboarded, you can choose to turn off the Project Administrators privilege from the PAT.\n\n        \\[Omitted image \"azure-plybk-03.png\"\\] Alt text: Permissions required for Azure PAT.\n\n    5.  Select **Next**.\n\n4.  Specify the access for the tool.\n\n    1.  If you want to control access to the tool, add the groups that must be given access to the tool in the **Maintained by** field.\n\n        The tasks these users in the groups can perform depends on the role assigned to them.\n\n        -   DevOps Tool Owner role: Can view and edit the tool.\n        -   DevOps App Owner role: Can view the tool and can associate, discover, import historical data, and modify pipeline steps \\(if applicable\\) of the tool's objects \\(such as plans, repositories, and pipelines\\).\n        -   DevOps Administrator role: Can edit all tools.\n        -   Other DevOps roles: Can view the tool.\n        **Note:** If you don't select a group and skip this step, all users with the DevOps Tool Owner role will be able to edit the tool.\n\n    2.  If you choose to control access to the tool, the **All DevOps App Owners can view and associate tool objects to applications** option becomes available for selection.\n\n        This option enables all users having the DevOps App Owner role to access the tool. If selected, they’ll be able to view, associate, discover, import historical data, and modify pipeline steps \\(if applicable\\) of the tool's objects.\n\n    3.  Select **Assign**.\n\n        \\[Omitted image \"azure-plybk-11.png\"\\] Alt text: Assign access groups.\n\n5.  Install the ServiceNow DevOps extension in your Azure DevOps instance.\n\n    The ServiceNow DevOps extension will automatically create service connections while configuring webhooks. Service connections are required for sending build and release notifications from Azure DevOps. The extension also contains custom tasks to modify the Azure DevOps pipelines for change control, artifacts, and packages.\n\n    For more information on the extension, see [Use the ServiceNow DevOps extension for Azure DevOps and Azure DevOps custom actions](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/config-dev-ops-extensions-azure.md).\n\n    **Note:** If you skip this step, to send notifications from Azure DevOps, you must manually create service connections after configuring webhooks.\n\n    After installing the extension, select **Marked as installed**.\n\n    \\[Omitted image \"azure-plybk-01.png\"\\] Alt text: Install the ServiceNow DevOps extension.\n\n6.  Configure webhooks automatically in your Azure DevOps instance to send data to DevOps Change Velocity.\n\n    Choose to send data by either nightly polling or configuring webhooks to send real-time data.\n\n    -   Webhooks: Enable real-time notifications for your pipeline executions. Real-time notifications are ideal to maintain the most up-to-date information particularly for automating change requests.\n\n        To use webhooks, select **Configure.**\n\n    -   Nightly polling: If you don’t choose to configure now, you can enable nightly polling later to fetch data for any tracked plans by setting the **Enable Polling** property to **Yes**.\n    1.  Enter the DevOps integration user name and password.\n\n        For information about creating the DevOps integration user and password, see [Set up integration user account in DevOps Change Velocity](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/devops-plybk-set-up-system-accts.md).\n\n        **Note:**\n\n        -   The step to enter the integration user name and password is required to configure only when DevOps Config is installed or the **This property decides whether to create a Generic Connection on configure operation for Azure DevOps** property is enabled. If this step is not required, webhooks are configured using token-based authentication.\n        -   When DevOps Config is installed or the Generic Connection on configure operation for Azure DevOps property is enabled, you can regenerate token \\(auto-configure with new token\\) from the workspace UI only, which will update integration user password. When DevOps Config is not installed, token can be regenerated from both the workspace and classic UI for token based authentication. Re-generate your token periodically for better security.\n    2.  Select **Configure**.\n\n        \\[Omitted image \"azure-plybk-14.png\"\\] Alt text: Configure Azure DevOps for a project.\n\n        To configure webhooks manually, select **Configure manually**. See [Configure webhooks in Azure DevOps manually](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/configure-test-webhooks.md) for more information.\n\n        **Important:**\n\n        -   If you're connecting from the Home page or Tools module, the connection is complete and you're taken to the Summary page.\n        -   If you're connecting from the Applications module, then plans, repositories, and pipelines available in your project are discovered. You can track and import historical data from them.\n7.  Select the plans to track.\n\n    1.  Select the plans for which you want to track updates and associate to the application.\n    2.  Select **Next**.\n\n        \\[Omitted image \"azure-plybk-02.png\"\\] Alt text: Select plans to track.\n\n    3.  If you want to import plan data, select the date range and select **Submit**.\n\n        You can import up to 90 days of data.\n\n        \\[Omitted image \"azure-plybk-04.png\"\\] Alt text: Import plan data.\n\n8.  Select the repositories to track.\n\n    1.  Select the repositories for which you want to track updates and associate to the application.\n    2.  Select **Next**.\n\n        \\[Omitted image \"azure-plybk-05.png\"\\] Alt text: Select repositories to track.\n\n    3.  If you want to import repository data, select the date range and select **Submit**.\n\n        You can import up to 90 days of data.\n\n        \\[Omitted image \"azure-plybk-06.png\"\\] Alt text: Import repository data.\n\n9.  Select the pipelines to track.\n\n    1.  Select the pipelines for which you want to track updates and associate to the application.\n\n    2.  Select **Next**.\n\n        \\[Omitted image \"azure-plybk-07.png\"\\] Alt text: Select pipelines to track.\n\n    3.  For each selected pipeline, all steps or stages are imported for the last successful execution. In the Assign services to pipeline steps activity, you can select the following for each pipeline step:\n        1.  **Pipeline step type**: Select a step type for which you want to assign a service.\n\n            **Tip:** Specify at least the **Prod deploy** step type for steps that represents the production deployment to enable DevOps to identify successful pipeline executions as production deployments.\n\n        2.  **Service**: Select the CMDB application service that the pipeline step maps to.\n\n            Application service maps approximately to the environment. If you use the same pipeline step to deploy to different environments, leave the field empty. Service information enables DevOps to identify and report on operational metrics such as incidents, outages, and so on.\n\n    4.  Select **Next**.\n\n        \\[Omitted image \"azure-plybk-08.png\"\\] Alt text: Assign services to pipeline steps.\n\n    5.  If you want to import pipeline data, select the date range and select **Submit**.\n\n        You can import up to 90 days of data.\n\n        \\[Omitted image \"azure-plybk-17.png\"\\] Alt text: Import historical pipeline data.\n\n10. You're taken to the Summary page.\n\n    From the Summary page, select **View tool record** to review the details of the connected tool.\n\n    \\[Omitted image \"azure-plybk-16.png\"\\] Alt text: Project connection summary.\n\n\n### Result\n\nYou’ve successfully onboarded your Azure DevOps tool to DevOps Change Velocity at the project level.\n\n### What to do next\n\nFrom the **Projects** tab on the tool record page, select a project to navigate to the project record page. From here, you can discover project objects, and configure webhooks for the project.\n\n-   Select **Discover projects** to discover the project objects, including existing plans \\(boards\\), repositories, and pipelines. This will discover all the projects in your organization as well.\n-   Select **Configure projects** to configure webhooks for the project.\n-   If you're on the tool records page, selecting **Configure projects** and entering the integration user credentials gives the list of unconfigured projects in your organization. Select the projects that you want webhooks configured for and select **Configure**.\n\n    **Note:** The step to enter the integration user name and password is required to configure webhooks only when DevOps Config is installed or the Generic Connection on configure operation for Azure DevOps property is disabled. If this step is not required, webhooks are configured using token-based authentication.\n\n-   To import historical data to the project objects like plans, repositories, or pipelines, associate the objects with an application, and import the data. For more information, see [Associate tool objects to applications - Workspace](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/apps-associate-objects-wkspc.md).\n\n**Related topics**  \n\n\n[Configure webhooks from the tool record](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/configure-webhooks-from-the-tool-record.md)\n\n"}}