How to Integrate Microsoft Entra ID With BarTender Cloud
Overview
This article will teach you how to connect your Microsoft Entra ID account with BarTender Cloud to serve as an identity provider.
Applicable to
BarTender Cloud
Microsoft Entra ID
Configuring Entra ID
New Application Registration
- Log in to Azure Services and select Microsoft Entra ID.
- Navigate to App registration, and then New registration.
- Provide a name for the application and choose Accounts in this organizational directory only.
- Set the Redirect URI to Web and provide a redirect URI that points to your BarTender Cloud tenant (for example, https://tenantname.am1.bartendercloud.com/signin-callback).
- Click Register.
- After pressing Register, you should see a page similar to the one below. Record the Application (client) ID and Directory (tenant) ID. These values will be used by BarTender Cloud.
Generating a Client Secret
- Click Add a certificate or secret and then New client secret.
- Enter a description and lifetime for the secret. Once this lifetime expires, you will need to generate a new secret for use with your application.
- Your secret will be generated, as shown below.
Make sure you copy the Value at this point, as you will not be able to access this page later.
Configuring API Permissions
Next, we will define API permissions. This defines what operations the application can perform.
- Navigate to API permissions and select Add a permission.
- Select Microsoft Graph.
- Select Delegated Permissions. Select Email, OpenID, and Profile permissions
- Press the Update Permissions button.
Token Configuration
- Select Token configuration.
- Click Add optional claim.
- Check the email checkbox and hit Add.
When configuring the Microsoft Entra ID login provider from Account Management or adding this provider from API, the Application (Client) ID, Directory (Tenant) ID, Client Secret, Redirect URI, and instance URL (https://login.microsoftonline.com) will be needed.
Integrating BarTender Cloud
Starting on the BarTender Cloud Home page, after logging in:
- Navigate to Administration> Security > Identity Providers > Add Identity Provider using the left-hand sidebar.
- Click the Set Up button next to Microsoft Entra ID.
- Fill out the required fields on the Add Identity Provider page.
- Click Learn more about connecting your identity provider for help with and additional information about filling out the required fields.
- Once you're finished, click Test Connection.
- If the test is successful, the Create Connection button will turn blue, and you can finish creating your connection.