How do I set up Single Sign-On with Microsoft Entra ID?
This article describes how to configure Single Sign-On (SSO) with Microsoft Entra ID in Security Center. SSO allows you to centralize user management with an identity provider (IDP) that supports SAML 2.0.
Create a Single Sign-On application in Microsoft Entra ID
- Log in to the Microsoft Entra admin center.
- Navigate to Identity > Applications > Enterprise applications.
- Click New application.
- Click Create your own application, enter a name for the application, select Integrate any other application you don't find in the gallery, and click Create.
Configure Single Sign-On in Security Center
- Log in to Security Center.
- Click the menu icon in the top right corner.
- Click Account settings.
- Click Single sign-on in the menu.
- Enable the Enabled toggle.
- Under IDP SAML configuration, select Manual.
- Copy the Login URL from your Microsoft Entra SSO application and enter it in the IDP login URL field.
- Copy the Microsoft Entra Identifier URL from your Microsoft Entra SSO application and enter it in the IDP entity ID/Metadata URL field.
- In Microsoft Entra ID, download the Certificate (Base64), open it with a text editor, copy the full content, including the header and footer, and enter it in the IDP certificate field.
- Uncheck Encrypt Assertion element.
- Click Save changes.
Tip: Make sure you paste the certificate in full, including the header and footer, and that all lines are continuous with no line breaks or spaces between them.
Configure Single Sign-On in the Microsoft Entra admin center
In your Security Center SSO settings, copy the following values from the Security Center section and enter them in the Basic SAML Configuration section of your Microsoft Entra application:
- Customer login URL should be placed under the Sign on URL.
- Login callback URL should be placed under the Reply URL (Assertion Consumer Service URL)
- Metadata URL should be placed under the Identifier (Entity ID).
Navigate back to the application overview and open the SAML Signing Certificate settings. Make sure the following values are set:
- Signing option: Sign SAML response and assertion
- Signing algorithm: SHA-256 or SHA-1
Configure user attribute mapping
In the User Attributes & Claims section of your Microsoft Entra application, the following fields are mandatory:
- emailaddress
- Unique User Identifier (also referred to as NameID)
Add the users or groups that should have access to Security Center by navigating to Users and groups in the left panel of your Microsoft Entra application.
Configure role mapping
By default, a user is assigned the lowest-privileged role, User, in Security Center. To assign the Superuser role, create an app role in Microsoft Entra ID and send it to Security Center with a role claim.
Create the app role
-
In the Microsoft Entra admin center, go to Identity > Applications > App registrations and open your Security Center application.
-
Click App roles, then Create app role.
-
Enter a Display name, for example Holm Superuser.
-
Under Allowed member types, select Users/Groups.
-
In the Value field, enter holm_superuser or holm-superuser.
-
Click Apply.
Assign the role
-
Go to Identity > Applications > Enterprise applications and open your Security Center application.
-
Click Users and groups, then Add user/group or Edit an existing one.
-
Select the users or groups and the role you created, and click Assign.
Add the role claim
In the User Attributes & Claims section, click Add new claim and enter the following:
-
Name: userrole
-
Namespace: http://schemas.microsoft.com/ws/2008/06/identity/claims/role
-
Source attribute: user.assignedroles
Click Save.
Note!
The role value must be exactly holm_superuser or holm-superuser. Other values, such as superuser, are not recognized, and the user is assigned the User role.
For more information, please contact our customer support.