Integration Hub provides an ability to add Azure DevOps Server connection and launch Project Online <> Azure DevOps Server integrations.
Please note: To add Azure DevOps Server connection its version should be 2017 or higher and it should be accessible from the internet.
Please note: If your Integration Hub app is installed on the machine with Windows Server 2012 R2 system and you need to connect it to AzureDevOps Server 2020 installed on the machine with Windows Server 2019, you need to enable the TLS Security Cypher called TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 on the machine where Integration Hub is installed. This Cypher is disabled by default. You might also need to install all the latest Windows security updates on your Windows Server 2012 R2 machine to make this Cypher appear in the list. If Integration Hub is installed on the machine with Windows Server 2019 or 2022 system, you do not need any additional actions to connect to the Azure DevOps Server.
To establish a connection between Azure DevOps Server and Project Online and configure the integration scenario, the steps are the same as described in the Configuring Project Online <> Azure DevOps integration article, except for the step when you need to add Azure DevOps connection.
To add Azure DevOps Server connection perform the following:
1. When Project Online connection is added, Project Online and Azure DevOps Server environments are configured, you get to the step where you need to add Azure DevOps Server connection to Integration Hub app.
On the Visual Studio Team Services App Details page click the New button.
Please note: To add Azure DevOps Server connection its version should be 2017 or higher and it should be accessible from the internet.
Azure DevOps Server 2017
1. In the Connection Details window select the Team Foundation Server 2017 type.
2. Provide the Azure DevOps Server site URL.
Please note: For Azure DevOps Server 2017 only a default collection is supported for integrations. However, the Azure DevOps Server site URL should be provided without the '/DefaultCollection' part: https://devops.demo.com.
3. Personal Access Token is required to add Azure DevOps Server connection. Please refer to this article for information on how to create a Personal Access Token.
Please note: It is required to grant the following permissions when creating a token:
- Work Items: read & write
- Identity: read
- Project and Team: read & write
When the Token is created, provide the account name and the token to authenticate to Azure DevOps Server via the Integration Hub app and click OK to proceed.
Please continue configuring Azure DevOps Server <> Project Online integration scenario following the steps described in the Configuring Project Online <> Azure DevOps integration article.
Azure DevOps Server 2019
If you are using Azure DevOps Server 2019, both default collection and custom collections are supported.
In the Connection Details window, you can choose either Team Foundation Server 2017 type or the Visual Studio Team Services / Azure DevOps Services option.
1. Team Foundation Server 2017
If you select the Team Foundation Server 2017 type in the Connection Details window, only a default collection will be available for integrations.
In the Site URL section Provide the Azure DevOps Server site URL without the '/DefaultCollection' part: https://devops.demo.com.
2. Visual Studio Team Services / Azure DevOps Services
If you select the Visual Studio Team Services / Azure DevOps Services type in the Connection Details window, both default collection and custom collections will be available for integrations.
In the Site URL section Provide the Azure DevOps Server site URL with the name of your collection (default or custom), for example:
- https://devops.demo.com/DefaultCollection
- https://devops.demo.com/CustomCollection
Personal Access Token is required to add Azure DevOps Server connection for any of the connection types selected. Please refer to this article for information on how to create a Personal Access Token.
Please note: It is required to grant the following permissions when creating a token:
- Work Items: read & write
- Identity: read
- Project and Team: read & write
When the Token is created, provide the account name and the token to authenticate to Azure DevOps Server via the Integration Hub app and click OK to proceed.
Please continue configuring Azure DevOps Server <> Project Online integration scenario following the steps described in the Configuring Project Online <> Azure DevOps integration article.