Skip to main content
This feature is available to customers on specific editions. Visit Matillion pricing to learn more about each edition.
When creating a new project in , the Select project configuration page asks you to choose either Matillion managed or Advanced settings. Choosing Advanced settings enables you to connect your own Azure DevOps repository to your project. Once you connect your Azure DevOps repository to , your data pipelines built using can be committed and pushed to your Azure DevOps repository. Read Prerequisites for connecting an Azure DevOps repository to before installing the app.
Matillion strongly recommends that you use the new repository that you created and intend to connect to solely for the purpose of developing your pipelines.
It may be advisable to use your repository’s README file to describe the purpose of the repository and the pipelines developed therein.

​
Video example

​
How to install the app

  1. During the project creation flow within , choose Advanced settings from the Select project configuration page.
  2. When prompted to choose an external Git provider, select Azure DevOps.
  3. You will then be redirected to the Azure login portal.
  4. If this is the first time you have logged in to Azure, you will receive a prompt for one of two options:
    • If you have sufficient permissions within Azure, you will be asked to provide consent for the application to perform certain actions within Azure on your behalf.
    • Otherwise, you will be informed you do not have the required permissions, and an Azure admin will be required to provide consent on your behalf.
For the latter case requiring Azure admin intervention, read below for how to proceed.
Once the Matillion app is installed in your Azure tenant, you can continue creating your project in and connect that project to an Azure DevOps repository.

​
Azure admin installation steps

If you are prompted for an admin to provide consent when attempting to authorize the Matillion for Azure DevOps application, this likely means that your Azure tenant has been configured to either require delegated consent for the app permissions, or explicit admin consent within the Azure portal.
Within the Azure prompt, Microsoft suggests logging in with admin credentials instead to proceed. Matillion strongly recommends against following this prompt, as this effectively captures the Azure admin OAuth token, rather than your user OAuth token. Any logins should only be for accounts that you have ownership or authority over, and Matillion does not recommend or expect any accounts to be shared under any circumstance.
Instead, the Azure admin will need to follow a number of steps:
  1. They will need to be invited to your Matillion organization, and granted sufficient permissions within the Matillion organization to create a project.
  2. After which, they need to follow the process of creating a new project, at least up to the point of choosing a repository within Azure DevOps.
    • This is to ensure the Matillion for Azure DevOps application is successfully installed within the Azure tenant.
    • Following this, the Azure admin can delegate consent through the Azure portal.
  3. From the Azure portal, the Azure admin can find the Matillion for Azure DevOps application listed within the Enterprise Applications installed in the Azure tenant.
  4. Next, either open or search for the Matillion for Azure DevOps application.
  5. Depending on the security policies of your Azure tenant, the Azure admin will need to perform one or more of the following actions:
    • If Assignment required? is set to Yes within the Manage → Properties menu blade, then assign the users who are intending to use the Matillion within the Manage → Users and groups menu blade, both of which can be found in the left-hand sidebar.
    • If the intended users can’t provide User consent for applications, then the Azure admin can provide tenant-wide consent on behalf of the users from the Security → Permissions menu blade.
This will allow either the granted users, or all tenant users respectively, to proceed with the authorization step within and accept the application permissions requested to act upon their behalf.

​
One-time installation

You only need to install the Matillion app in your Azure tenant once, unless it is explicitly removed by an Azure admin from your tenant in the Azure portal. After the app is installed, whenever you create a new project in , you can connect to any repositories that your Azure user account has access to.