How to add a Microsoft Entra SSO to your CMS

Connecting Microsoft Entra ID to Keycloak: Two-Party Setup Guide


This article goes through all the steps to configure Google Single Sign, a fast and secure way to log into the CultureSuite CMS.

Client = manages the Microsoft Entra ID (Azure) environment CultureSuite = manages the Keycloak environment

ย 

Step 1: Request the Redirect URI from CultureSuite

  1. Contact our Customer Success team to request the Redirect URI.
ย 

Step 2: Register the Application in Microsoft Entra ID

The Client sets up the OAuth credentials using the URI received from CultureSuite (see screenshots of substeps at the bottom of this article).

  1. Go to the Azure Portal and navigate to Microsoft Entra ID.
  1. Go to App Registrations โ†’ New Registration.
    1. ย 
      Notion image
  1. Fill in the following:
      • Name: e.g. Keycloak-Integration
      • Supported account types: Accounts in this organizational directory only
      • Redirect URI: paste the URI received from CultureSuite in step 1
      ย 
      Notion image
  1. Click Register.
  1. Navigate to Certificates & Secrets โ†’ New client secret, create a secret and copy the value immediately.
    1. ย 
      Notion image
      Notion image
      Screenshot highlighting client secret value. Copy the value immediately.
      Screenshot highlighting client secret value. Copy the value immediately.
  1. Under API Permissions, select Add a permission, select Microsoft Graph.
    1. Add click Grant admin consent:
        • openid
        • email
        • profile
        • User.Read
      ย 
      Notion image
      Notion image
      Notion image
      Notion image
      Notion image
  1. Copy the Application (Client) ID from the app's Overview page.
  1. From the Azure Portal overview, also copy the Tenant ID.
๐Ÿ“ค Client sends to CultureSuite: the Client ID, the Client Secret, and the Tenant ID.
ย 

Step 3: CultureSuite configures the Entra ID Identity Provider in Keycloak

ย 

Step 4: Verify the Integration

  1. Open the CMS login page for the configured realm.
  1. Confirm that Login with Microsoft Entra ID appears as an option.
  1. The first time you log in, you are shown a message. This means your log in was succesfull, but you donโ€™t have a CMS role yet (admin or user).
    1. If you are the first (admin), please contact CultureSuite so we can set your admin role.
    2. After that, you can configure roles for all your colleagues via the CMS users module after their first login.
ย 
The new SSO button
The new SSO button
ย 
ย 
The message displayed the first time anyone logs in via SSO (see step 3 above)
The message displayed the first time anyone logs in via SSO (see step 3 above)
ย 
๐Ÿ‘‰

Take note! The SSO button can replace the familiar username + password fields. So make sure all your CMS users have a Microsoft account to access the new SSO.

If you still want to be able to also log in the โ€œclassicโ€ way via a password and email, we can keep that option available too.


Information Exchange Summary

#
From
To
What
1
CultureSuite
Client
Keycloak Redirect URI
2
Client
CultureSuite
Tenant ID, Client ID & Client Secret

ย 

Related articles

ย 
Did this answer your question?
๐Ÿ˜ž
๐Ÿ˜
๐Ÿคฉ