Microsoft Entra identity provider

Set up single sign-on (SSO) for Cloud Management Platform (CMP) using Microsoft Entra (formerly Azure AD)

Before you begin

Configure Microsoft Entra as the IdP

  1. Log in to the Azure portal.

  2. Go to Enterprise Applications.

    Screenshot: go to Enterprise Applications (opens full-size image in a new tab)

  3. Select + New Application, then search for and select Microsoft Entra SAML Toolkit.

    Screenshot of Enterprise applications, with Microsoft Entra SAML Toolkit highlighted. (opens full-size image in a new tab)

    The create dialog appears.

    Screenshot of the Microsoft Entra SAML Toolkit create dialog. (opens full-size image in a new tab)

  4. Enter a name for the CMP application and select Create. The application is added to your enterprise applications.

  5. Select Microsoft Entra SAML Toolkit, then select Set up single sign-on to start configuring it for CMP.

    Screenshot: select Microsoft Entra SAML Toolkit, then select Set up single sign-on to start configuring it for CMP (opens full-size image in a new tab)

  6. On the single sign-on page, select SAML.

    Screenshot: on the single sign-on page, select SAML (opens full-size image in a new tab)

  7. In the Basic SAML Configuration section, set Identifier (Entity ID), Reply URL (Assertion Consumer Service URL), and Logout URL to point to your CMP instance.

    Screenshot: in the Basic SAML Configuration section, set Identifier (Entity ID), Reply URL (Assertion Consumer Service URL), and Logout URL to point to your CMP instance (opens full-size image in a new tab)

  8. Alternatively, select Upload metadata file and upload the metadata file you downloaded in step 6 of Set up SSO and SAML. The Basic SAML settings are then configured automatically from your metadata XML.

    Screenshot: alternatively, select Upload metadata file and upload the metadata file you downloaded in step 6 of Set up SSO and SAML (opens full-size image in a new tab)

  9. Ensure the Sign on URL is set.

  10. Select Save.

  11. When prompted to test the connection, select No, I’ll test later.

  12. Under SAML Certificates, select Download for Federation Metadata XML.

    Screenshot: under SAML Certificates, select Download for Federation Metadata XML (opens full-size image in a new tab)

  13. Save the metadata XML. You need it in Set up SSO and SAML.

  14. Select Edit on the SAML settings section and ensure the Signing Algorithm matches the one you set in the SAML settings in Set up SSO and SAML.

    Screenshot: select Edit on the SAML settings section and ensure the Signing Algorithm matches the one you set in the SAML settings in Set up SSO and SAML (opens full-size image in a new tab)

Add users and groups

  1. On the Azure portal, go to Users and groups under Microsoft Entra SAML Toolkit.

    Screenshot: on the Azure portal, go to Users and groups under Microsoft Entra SAML Toolkit (opens full-size image in a new tab)

  2. Select Add user/group.

    Screenshot: select Add user/group (opens full-size image in a new tab)

  3. Select users and add assignments as required.

    Screenshot: select users and add assignments as required (opens full-size image in a new tab)

Copy the claim names

User attributes and claims are standard in Microsoft Entra. You can change the defaults or add more if required.

  1. In User Attributes & Claims, select Edit.
  2. In the Additional claims > Claim name column, copy the claim names. You will use them during CMP configuration.

Set up signing and notifications

  1. In this example, Sign SAML Assertion and SHA-256 are set, along with an email address for notifications.
  2. Copy the App Federation Metadata URL. You need it for CMP configuration.

Step 5 in Azure’s SAML setup is a test step and is not available until SSO is configured in CMP.

Set up Microsoft Entra SSO in CMP

  1. Follow the steps in Set up SSO and SAML.
  2. On the SSO provider’s SAML settings, complete the fields with information from your Azure tenant.
  3. In the Attribute Name fields, paste the claim names from Copy the claim names, step 2.
  4. Select Create.

Upload the Microsoft Entra metadata

  1. On the Overview tab, select Upload IdP XML.
  2. Choose a source for the metadata. In this example, Metadata URL is used.
  3. Paste the App Federation Metadata URL you copied in Set up signing and notifications, step 2.
  4. Select Save.

Log in with SSO

Log out of CMP and log back in. You should see a Log In with SSO provider name button. If you are logged in with a valid user, you are redirected and logged in automatically.