> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datafold.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure DevOps

## 1. Issue an Access Token

To get your [repository access token](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops\&tabs=Windows#create-a-pat), navigate to your Azure DevOps settings and create a new token.

When configuring your token, enable the following permissions:

* **Code** -> **Read & write**
* **Identity** -> **Read**

We need write access to the repository to post reports with Data Diff results to pull requests, and read access to identities to be able to properly display Azure DevOps users in the Datafold UI.

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/azure_devops_access_token-7bd79728ae3447aa77f4246a1e66b249.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=79b790bb635c11e7b92e046ff26ff193)

## 2. Configure integration in Datafold

Navigate back to Datafold and fill in the configuration form.

* **Authentication**: **Personal/Project Access Token** or **Microsoft Entra ID**.
* **Personal/Project Access Token**: the token you created in step 1.
* For **Microsoft Entra ID** (service principal), enter the **Directory (tenant) ID**, **Application (client) ID**, and **Client secret** of an Entra app registration that has access to the project. Available for dev.azure.com only.
* **Organization**: your Azure DevOps organization name.
* **Project**: your Azure DevOps project name.
* **Repository**: your Azure DevOps repository name.

For example, if your Azure DevOps repository URL is `https://dev.azure.com/datafold/analytics/_git/dbt`:

* Your **Organization** is `datafold`
* your **Project** is `analytics`
* your **Repository** is `dbt`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.