Entra ID (Azure AD) Integration
This guide details how to integrate your Microsoft Entra ID (formerly Azure Active Directory) tenant with DataCentral. This allows your internal users to log in using their existing Microsoft credentials.
DataCentral supports two Entra ID models at a high level:
- Shared host authentication: Your DataCentral host provides the Entra ID application used for sign-in.
- Dedicated tenant authentication: Your organization registers its own Entra ID application so you can control branding, conditional access, and tenant-specific sign-in behavior.
This guide covers the dedicated tenant setup.
Prerequisites
Before beginning, ensure you have:
- Global Administrator or Privileged Role Administrator access to your Microsoft Entra ID portal.
- Tenant Administrator access to your DataCentral instance.
Step 1: Register an Application in Entra ID
You must register DataCentral as an application within your Azure portal.
- Log in to the Microsoft Entra admin center.
- Navigate to Identity > Applications > App registrations.
- Click New registration.
- Enter a name for the application (e.g.,
DataCentral Auth). - Select Accounts in this organizational directory only (Single tenant).
- Under Redirect URI, select Web and enter the callback URL provided in your DataCentral Administration settings (e.g.,
https://yourcompany.datacentral.ai/auth/callback). - Click Register.
Step 2: Configure Authentication Settings
Configure the app registration for interactive sign-in with OpenID Connect.
- In your App Registration, go to Authentication.
- Confirm the redirect URI matches the callback URL configured in DataCentral.
- Under Implicit grant and hybrid flows, enable ID tokens if your tenant policy or app platform settings require it for sign-in.
- Click Save.
Step 3: Configure API Permissions
You must grant the application the delegated permissions needed for user sign-in and profile identification.
- Go to API permissions.
- Click Add a permission.
- Select Microsoft Graph.
- Select Delegated permissions.
- Check the following permissions:
User.Readprofileemailopenid
- Click Add permissions.
- Click Grant admin consent for [Your Tenant Name].
Step 4: Configure DataCentral
Now, return to DataCentral to complete the integration.
- Log in to your DataCentral Tenant as an Administrator.
- Navigate to Administration > Settings > Authentication.
- Enable Entra ID.
- Enter the following details from your Azure App Registration:
- Client ID: Found on the Overview page of your App Registration.
- Tenant ID: Found on the Overview page of your App Registration.
- Click Save.
Your users can now log in to DataCentral using their Microsoft 365 credentials.
Next Steps
If you plan to use DataCentral to embed reports for users who do not have their own Power BI Pro licenses, you will also need to configure a Power BI Service Principal.