# Register apps in Azure AD to use with extractors
You can use OpenID Connect and your existing identity provider (IdP) framework to manage access to CDF data securely. We currently support Azure AD, Microsoft's cloud-based identity and access management service.
This article explains how to register and configure apps in Azure AD (AAD) to use with extractors or scheduled custom scripts.
In this article:
To perform the steps below, you need to be an administrator of Azure AD.
# Before you start
Make sure you have registered the Cognite API and the CDF portal application in Azure AD and set up Azure AD and CDF groups to control access to CDF data.
# Step 1: Register an app in Azure AD to use with an extractor
Cognite recommends that you register one app per extractor and per environment. For example, we recommend 3 app registrations to run one extractor in dev, test, prod environments.
Sign in to the Azure portal (opens new window) as an admin.
If you have access to multiple tenants, use the Directory + subscription filter in the top menu to select the tenant in which you want to register an application.
Search for and select Azure Active Directory.
Under Manage, select App registrations > New registrations.
In the Register an application window, enter the app name, and then select Register.
Copy and make a note of the Application (client) ID. This value is required for authentication when reading and writing data with the extractor.
Under Manage, select Certificates & secrets > New client secret.
Enter a client secret description and an expiry time, and then select Add.
Copy and make a note of the client secret in the Value field.
Make sure you copy this value now. This value will be hidden after you leave this page.
# Step 2: Create a group in Azure AD and add the registered app as its member
Open the overview window in Azure AD and select Manage > Groups.
Create a group, read more here.
Open the group. Under Manage, select Members > Add members.
Find the app you created above and click Select.
Add all users you want to have access to extractors as members.
Return to the overview, and then copy and make a note of the Object Id.
# Step 3: Create a group in CDF and link to the Azure AD group
Sign in to Cognite Data Fusion (opens new window)as an admin.
In the top menu, select Manage & Configure > Manage access.
In the Access management window, select Groups > Create new group.
In the Create a new group window, enter the group name (case sensitive).
Add the necessary capabilities for your extractor. See Extractor capabilites below for details.
Link the group to an Azure AD group:
In the Source ID field, enter the Object Id for the AAD group exactly as it exists in AAD. You can use the same group Id for multiple extractors.
In the Source name field, enter the name of the group in Azure AD.
# Step 4: Run extractors using the client secret or client ID
- Configure and run the extractor according to the extractor documentation.
# Extractor capabilities
The table below lists the required CDF capabilities for the Cognite extractors.
|OPC UA Extractor|