Tutorial: Microsoft Entra integration with Clear Review
Article
In this tutorial, you'll learn how to integrate Clear Review with Microsoft Entra ID. When you integrate Clear Review with Microsoft Entra ID, you can:
Control in Microsoft Entra ID who has access to Clear Review.
Enable your users to be automatically signed-in to Clear Review with their Microsoft Entra accounts.
Manage your accounts in one central location.
Prerequisites
To configure Microsoft Entra integration with Clear Review, you need the following items:
A Microsoft Entra subscription. If you don't have a Microsoft Entra environment, you can get a free account.
Clear Review single sign-on enabled subscription.
Note
This integration is also available to use from Microsoft Entra US Government Cloud environment. You can find this application in the Microsoft Entra US Government Cloud Application Gallery and configure it in the same way as you do from public cloud.
Scenario description
In this tutorial, you configure and test Microsoft Entra single sign-on in a test environment.
Clear Review supports SP and IDP initiated SSO.
Add Clear Review from the gallery
To configure the integration of Clear Review into Microsoft Entra ID, you need to add Clear Review from the gallery to your list of managed SaaS apps.
Configure and test Microsoft Entra SSO for Clear Review
Configure and test Microsoft Entra SSO with Clear Review using a test user called B.Simon. For SSO to work, you need to establish a link relationship between a Microsoft Entra user and the related user in Clear Review.
To configure and test Microsoft Entra SSO with Clear Review, perform the following steps:
Browse to Identity > Applications > Enterprise applications > Clear Review > Single sign-on.
On the Select a single sign-on method page, select SAML.
On the Set up single sign-on with SAML page, click the pencil icon for Basic SAML Configuration to edit the settings.
On the Basic SAML Configuration section, if you wish to configure the application in IDP initiated mode, perform the following steps:
a. In the Identifier text box, type a URL using the following pattern:
https://<CUSTOMER_NAME>.clearreview.com/sso/metadata/
b. In the Reply URL text box, type a URL using the following pattern:
https://<CUSTOMER_NAME>.clearreview.com/sso/acs/
Click Set additional URLs and perform the following step if you wish to configure the application in SP initiated mode:
In the Sign-on URL text box, type a URL using the following pattern:
https://<CUSTOMER_NAME>.clearreview.com
Note
These values are not real. Update these values with the actual Identifier, Reply URL and Sign-on URL. Contact Clear Review Client support team to get these values. You can also refer to the patterns shown in the Basic SAML Configuration section.
Clear Review application expects the SAML assertions in a specific format, which requires you to add custom attribute mappings to your SAML token attributes configuration. The following screenshot shows the list of default attributes, whereas nameidentifier is mapped with user.userprincipalname. Clear Review application expects nameidentifier to be mapped with user.mail, so you need to edit the attribute mapping by clicking on Edit icon and change the attribute mapping.
On the User Attributes & Claims dialog, perform the following steps:
a. Click Edit icon on the right of Name identifier value.
b. From the Source attribute list, select the user.mail attribute value for that row.
c. Click Save.
On the Set up Single Sign-On with SAML page, in the SAML Signing Certificate section, click Download to download the Certificate (Base64) from the given options as per your requirement and save it on your computer.
On the Set up Clear Review section, copy the appropriate URL(s) as per your requirement.
Create a Microsoft Entra test user
In this section, you'll create a test user called B.Simon.
In the app's overview page, select Users and groups.
Select Add user/group, then select Users and groups in the Add Assignment dialog.
In the Users and groups dialog, select B.Simon from the Users list, then click the Select button at the bottom of the screen.
If you are expecting a role to be assigned to the users, you can select it from the Select a role dropdown. If no role has been set up for this app, you see "Default Access" role selected.
In the Add Assignment dialog, click the Assign button.
Configure Clear Review SSO
To configure single sign-on on Clear Review side, open the Clear Review portal with admin credentials.
Select Admin from the left navigation.
In the Integrations section at the bottom of the page click the Change button to the right of Single Sign-On Settings.
Perform following steps on Single Sign-On Settings page.
a. In the Issuer URL textbox, paste the value of Microsoft Entra Identifier..
b. In the SAML Endpoint textbox, paste the value of Login URL..
c. In the SLO Endpoint textbox, paste the value of Logout URL..
d. Open the downloaded certificate in notepad and paste the content in the X.509 Certificate textbox.
e. Click Save.
Create Clear Review test user
In this section, you create a user called Britta Simon in Clear Review. Please work with Clear Review support team to add the users in the Clear Review platform.
Test SSO
In this section, you test your Microsoft Entra single sign-on configuration with following options.
SP initiated:
Click on Test this application, this will redirect to Clear Review Sign on URL where you can initiate the login flow.
Go to Clear Review Sign-on URL directly and initiate the login flow from there.
IDP initiated:
Click on Test this application, and you should be automatically signed in to the Clear Review for which you set up the SSO.
You can also use Microsoft My Apps to test the application in any mode. When you click the Clear Review tile in the My Apps, if configured in SP mode you would be redirected to the application sign on page for initiating the login flow and if configured in IDP mode, you should be automatically signed in to the Clear Review for which you set up the SSO. For more information about the My Apps, see Introduction to the My Apps.
Discover how Microsoft Entra External ID can provide secure, seamless sign-in experiences for your consumers and business customers. Explore tenant creation, app registration, flow customization, and account security.