Knowledge Base

Single Sign On (SAML SSO) (5.0)

Overview

Single Sign-On (SSO) lets users access multiple applications with a single set of credentials. The Cloudmore platform supports SSO using the SAML 2.0 protocol. Once a user authenticates through their Identity Provider (IdP), they do not need to re-enter credentials to log in to Cloudmore.

Prerequisites

  • A functioning Identity Provider (IdP) that supports SAML 2.0.

  • The ability to download your IdP's metadata XML and upload it to Cloudmore.

  • The ability to upload Cloudmore's Service Provider metadata to your IdP.

Configure SAML SSO

👥

Broker level: Settings > Security > SSO settings

Organization level: Settings > Security > SSO settings

  • Full access: Super Admin

  • Read only: Global Admin

SAML SSO can be set up at broker level, for broker users and optionally organization users, or at organization level, so that an organization's users sign in through their own IdP instead of the broker's.

  1. Navigate to Settings > Security. The SSO settings tab opens.

  2. Under SAML-based single sign-on (SSO), turn on Use SAML-based SSO.

  3. Under Scope, choose which users authenticate through this IdP. At organization level, the scope is SSO will be used for all organization users.

  4. Upload identity provider metadata: download the metadata XML file from your IdP. Click Choose file, select the file and click Read file. The metadata file name and the IdP entityID are filled in automatically.

  5. Share Cloudmore metadata with your IdP: click Download next to Cloudmore metadata file and upload the file to your IdP.

  6. Configure the email claim: in your IdP, set up the required email claim http://schemas.xmlsoap.org/ws/2005/05/identity/claims/mail. Map First Name and Last Name as well.

  7. Click Save changes.

[SCREENSHOT] The SAML-based SSO section with the three numbered setup steps.

Important: Users must already have a Cloudmore account before using SSO. Accounts are not created automatically on first login. The federated user is matched to their Cloudmore account using the mail attribute. This attribute must be unique and included in the authentication response from the IdP.

Automatic Login

To trigger SSO from an external system and bypass the login page, specify the IdP in the URL. Replace the placeholders below with your values:

https://<Branded_URL>/Shibboleth.sso/Login?entityID=<URL_to_the_IdP>

Example:

https://www.brokerdomain.com/Shibboleth.sso/Login?entityID=https://sts.windows.net/00000000-0000-0000-0000-000000

Okta Configuration

When using Okta as your IdP, add an attribute statement with these values:

  • Name: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/mail

  • Name format: Unspecified

  • Value: user.mail (from the dropdown)