Overview

Azure Active Directory (Azure AD) is a Microsoft cloud-based identity and access management service. ConductorOne integrates with your Azure AD account to provide visibility and permission management on users, groups, application, and roles.

Availability

✅ General availability. The Azure Active Directory integration is available to all ConductorOne users.

Capabilities

• Sync user identities from Azure AD to ConductorOne
• Resources supported:
  • Azure AD Groups
  • Azure AD User Roles
  • Azure AD Application Roles

Set up the Azure AD integration

A user with the Super Administrator role in ConductorOne must perform this task.

1. In ConductorOne, open Administer and click Integrations > Azure AD.

2. If this is your first Azure AD integration, the integration form opens automatically. Otherwise, click Add connector.

3. Choose whether to add the new Azure AD connector to an existing application (and select the app of your choice) or to create a new application.

4. Set the integration owner for this connector. You can manage the integration yourself, or choose someone else from the list of ConductorOne users. Setting multiple integration owners is allowed.

   A Azure AD integration owner must have the following permissions:

   • Integration Administrator or Super Administrator role in ConductorOne
   • Global Administrator in Azure AD

5. Click Create and add details.

Next steps

• If you are the integration owner, proceed to Integrate your Azure AD instance for instructions on integrating Azure AD with ConductorOne.

• If someone else is the integration owner, ConductorOne will notify them by email that their help is needed to complete the integration.

Integrate your Azure AD instance

A user with the Integration Administrator or Super Administrator role in ConductorOne and the Global Administrator permission in Azure AD must perform this task.

Step 1: Log in with OAuth

1. In ConductorOne, open Administer and click Integrations > Azure Active Directory.

2. In the list of connectors, locate and click on the name of the connector with the Not connected label.

3. Click Login with OAuth.

4. Log in and authorize ConductorOne with your Azure AD instance.

   In order for the integration to work properly, you must consent to all permissions:

   

Step 2: Grant permissions to the ConductorOne app

1. In the Azure AD control panel, go to Enterprise Applications.

   

2. Click the ConductorOne Integration app (not to be confused with the ConductorOne SSO app, which is used to log into ConductorOne, not to synchronize your data).

   If the ConductorOne Integration app doesn’t appear in the list of apps right away, wait a minute and click Refresh.

3. On the ConductorOne Integration page, click Permissions on the left side.

   

4. Click Grant admin consent for … on the ConductorOne Integration app permissions page.

   

Step 4: Complete integration

1. Return to the Azure AD integration in ConductorOne by clicking the Azure Active Directory tile on the Integrations page.

2. Click the Azure Active Directory connector link that shows today’s date in the Connected on column.

3. Click Login with OAuth a second time to complete the process and authorize ConductorOne to obtain an access token with the permissions you’ve just granted.

That’s it! Your Azure Active Directory instance is now integrated with ConductorOne.

What’s next?

If Azure Active Directory is your company’s identity provider (meaning that it is used to SSO into other software), the integration sync will automatically create applications in ConductorOne for all of your SCIMed software. Before you move on, review the Create applications page for important information about how to set up integrations with the SCIMed apps.

Configure the Azure Active Directory integration using Terraform

As an alternative to the integration process described above, you can use Terraform to configure the integration between Azure Active Directory and ConductorOne.

See the ConductorOne Azure Active Directory integration resource page in the ConductorOne Terraform registry for example usage and the full list of required and optional parameters.