> ## Documentation Index > Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create an Azure Data Factory connection in Airflow [Azure Data Factory](https://learn.microsoft.com/en-us/azure/data-factory/) (ADF) is a cloud-based data integration and transformation service used to build data pipelines. Integrating ADF with Airflow allows you to run ADF pipelines and check their status from an Airflow DAG. This guide provides the basic setup for creating an ADF connection. For a complete integration tutorial, see [Run Azure Data Factory pipelines in Airflow](/docs/learn/2.x/airflow-azure-data-factory-integration). ## Prerequisites * The [Astro CLI](/docs/cli/v1.43/overview) * A locally running [Astro project](/docs/cli/v1.43/get-started-cli) * Permissions to [access your data factory](https://learn.microsoft.com/en-us/azure/data-factory/concepts-roles-permissions#roles-and-requirements) * A [Microsoft Entra ID application](https://learn.microsoft.com/en-us/entra/identity-platform/howto-create-service-principal-portal) ## Get connection details A connection from Airflow to Azure Data Factory requires the following information: * Subscription ID * Data factory name * Resource group name * Application Client ID * Tenant ID * Client secret Complete the following steps to retrieve all of these values: 1. In your Azure portal, open your [data factory](https://portal.azure.com/#view/HubsExtension/BrowseResource/resourceType/Microsoft.DataFactory%2FdataFactories) service and select the subscription that contains your data factory. 2. Copy the **Name** of your data factory and the **Resource group**. 3. Click the subscription for your data factory, then copy the **Subscription ID** from the subscription window. 4. Open your Microsoft Entra ID application. Then, from the **Overview** tab, copy the **Application (client) ID** and **Directory (tenant) ID**. 5. [Create a new client secret](https://learn.microsoft.com/en-us/entra/identity-platform/howto-create-service-principal-portal#option-3-create-a-new-application-secret) for your application to be used in the Airflow connection. Copy the **VALUE** of the client secret that appears. 6. [Assign](https://learn.microsoft.com/en-us/entra/identity-platform/howto-create-service-principal-portal#assign-a-role-to-the-application) the [Data Factory Contributor](https://learn.microsoft.com/en-us/azure/data-factory/concepts-roles-permissions#set-up-permissions) role to your app so that Airflow can access the data factory. ## Create your connection Astro users can also create connections using the [Astro Environment Manager](/docs/astro/manage-connections-variables#astro-environment-manager), which stores connections in an Astro-managed secrets backend. These connections can be shared across multiple deployed and local Airflow environments. See [Create Airflow connections in the Astro UI](/docs/astro/create-and-link-connections). 1. Open your Astro project and add the following line to your `requirements.txt` file: ```text wrap theme={null} apache-airflow-providers-microsoft-azure ``` This will install the Azure provider package, which makes the Azure Data Factory connection type available in Airflow. 2. Run `astro dev restart` to restart your local Airflow environment and apply your changes in `requirements.txt`. 3. In the Airflow UI for your local Airflow environment, go to **Admin** > **Connections**. Click **+** to add a new connection, then choose **Azure Data Factory** as the connection type. 4. Fill out the following connection fields using the information you retrieved from [Get connection details](#get-connection-details): * **Connection Id**: Enter a name for the connection. * **Client ID**: Enter the **Application (client) ID**. * **Secret**: Enter the client secret **VALUE**. * **Tenant ID**: Enter the **Directory (tenant) ID**. * **Subscription ID**: Enter the **Subscription ID**. * **Resource Group Name**: Enter your data factory **Resource group**. * **Factory Name**: Enter your data factory **Name**. 5. Click **Test**. After the connection test succeeds, click **Save**. azure-connection-data-factory To use the same connection for multiple data factories or multiple resource groups, skip the **Resource Group** and **Factory Name** fields in the connection configuration. Instead, you can pass these values to the `default_args` of a DAG or as parameters to the `AzureDataFactoryOperator`. For example: ```python wrap theme={null} "azure_data_factory_conn_id": "adf", "factory_name": "my-factory", "resource_group_name": "my-resource-group", ``` ## How it works Airflow uses the [`azure-mgmt-datafactory`](https://pypi.org/project/azure-mgmt-datafactory/) library from [Azure SDK for Python](https://github.com/Azure/azure-sdk-for-python) to connect to Azure Data Factory using [`AzureDataFactoryHook`](https://airflow.apache.org/docs/apache-airflow-providers-microsoft-azure/stable/_api/airflow/providers/microsoft/azure/hooks/data_factory/index.html). ## See also * [Apache Airflow Microsoft Azure provider package documentation](https://airflow.apache.org/docs/apache-airflow-providers-microsoft-azure/6.1.1/connections/adf.html) * [Import and export Airflow connections using Astro CLI](/docs/astro/import-export-connections-variables#using-the-astro-cli-local-environments-only) * Azure Data Factory modules in the [Airflow Registry](https://airflow.apache.org/registry/) * [Run Azure Data Factory pipelines in Airflow](/docs/learn/2.x/airflow-azure-data-factory-integration)