OneLogin identity provider

Set up single sign-on (SSO) for Cloud Management Platform (CMP) using OneLogin

Before you begin

Add the OneLogin SSO provider in CMP

  1. Log in to CMP as an administrator.
  2. Select Admin > Single Sign-On (SSO).
  3. Select Add > Generic SAML Provider.
  4. Complete the SAML settings form.

Create the OneLogin application

In OneLogin, make sure you are in the Admin menu (https://<instance-name>.onelogin.com/admin).

  1. In the main navigation menu, select the Applications tab.
  2. Select Add App.
  3. In the search box, type “SAML Test” and search.
  4. Select SAML Test Connector (Advanced).
  5. Enter a Display Name for the app and ensure Visible in portal is checked.

Configure the SAML settings

Configure the SAML settings as shown below. Find the Metadata URL / Entity ID and Single Sign-On URL in CMP, on the OneLogin SSO provider’s Overview page (see Configure the identity provider).

SAML setting field Notes
Audience (EntityID) Metadata URL / Entity ID in CMP.
Recipient Single Sign-On URL.
ACS (Consumer) URL Validator Single Sign-On URL.
ACS (Consumer) URL Single Sign-On URL.
Single Logout URL Leave blank.
Login URL Single Sign-On URL.
SAML not valid before 3
SAML not valid on or after 3
SAML initiator OneLogin
SAML nameID format Unspecified
SAML issuer type Specific
SAML signature element Response
Encrypt assertion Unchecked
SAML encryption method TRIPLEDES-CBC
Send NameID Format in SLO Request Unchecked
Generate AttributeValue tag for empty values Unchecked
SAML sessionNotOnOrAfter 1440
Sign SLO Request Unchecked
Sign SLO Response Unchecked

Select Save.

The name ID for the email, given name, surname, and user ID fields is specified as parameters within the application:

Screenshot: the name ID for the email, given name, surname, and user ID fields is specified as parameters within the application (opens full-size image in a new tab)

Download the SAML metadata

  1. On the new application, select the More Actions dropdown in the top right.
  2. Select SAML Metadata to trigger the file download.

Screenshot: select SAML Metadata to trigger the file download (opens full-size image in a new tab)

Assign user access

  1. In the main navigation menu, select the Users tab and select the user.
  2. In the left navigation pane, select Applications.
  3. Select [+] in the top right.
  4. Select the application and the role to assign access to the user.
  5. Select Save User.

Finish SSO setup in CMP

  1. Log in to CMP as a Super Admin.
  2. Go to Admin > Single Sign-On (SSO).
  3. Select OneLogin.
  4. Select Upload IdP XML, set Metadata source to Metadata File, and choose the XML file you downloaded in Download the SAML metadata.
  5. Select the Edit icon.
  6. If you did not choose one at setup, scroll to the Branded Portal dropdown and select a portal for OneLogin.
  7. (Optional) Enable auto-login:
    1. Select Admin > Miscellaneous Settings.
    2. Set Automatically Login to SSO to On.