Troubleshooting guide for connecting an Azure DevOps repository to the Data Productivity Cloud

This page is a list of troubleshooting guidance in the event that you experience issues when connecting your Azure DevOps repository to a Data Productivity Cloud project. Each scenario includes both an issue and a solution.

For basic connectivity issues, make sure the Hybrid SaaS agents and Git repositories IP addresses are allowed on your repository.

App Installation fails

Possible cause 1: There are no Azure DevOps organizations connected to the chosen Azure tenant

Solution: If you have not used Azure DevOps before, first log in to the Azure Portal, and search for Azure DevOps organizations. From this landing page, choose My Azure DevOps organizations, which will take you to the Azure DevOps portal. You will be prompted to create your first DevOps organization, along with a project to organize your resources, including a new repository.

Once created, retry the app installation through the Designer Project setup process.

Possible cause 2: You don't have sufficient permissions to install applications to your Azure tenant

Solution: Reach out to one of your Azure administrators to either:

Grant your user account sufficient permissions to install applications within your tenant.
Request an admin to install the application into your tenant.

Solution: It’s not possible to use a personal email address (such as those from Skype, Hotmail, or Outlook) to install Matillion for Azure DevOps due to restrictions on Enterprise applications within Azure. You will need to sign in with a work or school account that is an existing entity within Microsoft Entra ID. This account doesn’t have to match the email address you used to register with the Matillion Hub, but it must still meet the specified requirement. For more information about the different account/identity types, read Identity and account types for single and multitenant apps.

Authorization fails

Possible cause: the Data Productivity Cloud can't reach Azure

Solution: If you receive an authorization error, refresh the page and try again. If the issue persists, either Azure or the Data Productivity Cloud may be experiencing an issue.

Solution: Revoke Matillion app user access to Azure DevOps. To do this, follow these steps:

Go to your user profile in the Azure Portal, then click Revoke sessions.
1. Revoking access can sometimes take up to 60 minutes.
Once access is revoked, make sure you're logged in with the correct Azure DevOps user.
Go to the Data Productivity Cloud and trigger a Git remote action such as Pull remote changes. This will prompt you to reauthenticate using your other Azure DevOps user.

Note

Clicking Revoke sessions will revoke all of your Azure sessions and will require you to sign back in from all devices.