Our Azure DevOps integration allows your team to transition seamlessly from product discovery to product delivery. There are a few common scenarios you may encounter while configuring this integration. If you encounter a scenario that isn't listed below, please don't hesitate to reach out to our support team.
In this article:
- What does "Partially valid" token status mean?
- What does "Invalid token" status mean?
- How can I prevent Azure DevOps from sending sensitive information to Productboard?
What does "Partially valid" token status mean?
If you see "Partially valid: Data synchronization from Azure DevOps to Productboard won't work." below your Token Status, this means your integration is working but certain functionality in your integration will be limited (e.g. no status synchronization).
There are two situations in which this error can happen:
Situation 1: The Azure DevOps administrator who created the token does not have high enough access.
What went wrong: The administrator who created the integration using his personal access token is not part of the "Project Collection Service Accounts" or "Project Collection Administrators" group.
How to solve it: Ask your Azure DevOps Administrator to include the administrator who created this integration in the "Project Collection Service Accounts" or "Project Collection Administrators" group.
See Microsoft documentation about permissions in Azure DevOps here.
Situation 2: The Read & Write Access for the Notifications has not been checked.
What went wrong: The administrator who created the integration using his personal access token forgot to give a Read & Write permission for Notifications. In this case, the status synchronization is not going to work because the Notification permission read & write access was not checked. Therefore, Productboard is unable to update it.
How to solve it: The administrator who created and set up the integration has to go to his personal access token and check the Read & Write Access for the Notifications.
What does "Invalid token" status mean?
If you see "Invalid" below your Token Status, this means your Productboard <> Azure DevOps integration will not work.
There are three situations in which this error can happen:
Situation 1: Your token has expired
What went wrong: The maximum expiration length of the personal access token is one year. Therefore, the token has expired and your administrator needs to extend it.
How to solve it:
1. Go to your personal access token settings
2. Click edit on the Productboard <> Azure DevOps integration token
3. Click on the calendar and extended it by another year.
Situation 2: The required access has not been checked
What went wrong: If the Read & Write access for Work items have not been checked, Productboard is not going to be able to make any modifications.
How to solve it:
1. Log in as an administrator of that personal access token
2. Go to your personal access token settings
3. Click on Read & Write access for Work Items and Notifications
Situation 3: Something mysterious...let us help!
What went wrong: If none of the resolutions above works, then the issue can be either on the Azure DevOps side or on the Productboard side.
How to solve it: In this case, reach out to our customer support who will help identify the issue and escalate it to the appropriate teams.
How can I prevent Azure DevOps from sending sensitive information to Productboard?
Users can limit Productboard's access to sensitive information from within their Azure DevOps instance. Access can be restricted in two ways:
- Limit the access of the Azure DevOps user who authorized the Productboard integration
- Limit the permissions of the Personal Access Token used to authenticate the integration.
For more information about Azure DevOps security, see Azure DevOps - Security FAQ.
Help! I tried to set up my Azure DevOps on-prem integration, and it says the address doesn't exist/is unavailable/there was a timeout!
Your Azure DevOps on-prem setup needs to be in a public network, with a public IP address, for the Azure DevOps integration to work. The IP address can be inaccessible from the Internet generally, but made accessible to Productboard.
If you are encountering these errors after following our instructions, reach out to your system administrator with the information above.