Configuring single sign-on with the SAML using your product console

Configure single sign-on (SSO) by using Security Assertion Markup Language (SAML) from your product console.

Note: You can configure only one SAML connection.

You can configure the SAML connection by using any of the following methods:

Setting up the SAML connection

  1. Log on to the console as an administrator.

  2. From the navigation menu, click Administer > Identity providers.

  3. Click Create Connection. Select SAML 2.0 as the protocol type and click Next. The New SAML Connection page is displayed.

  4. In the New SAML Connection page, select the Connection details tab. It contains the following options that you are required to fill:

    • Name: A name for the SAML connection.

    • Description: Description of the SAML connection.

  5. Choose the type of SAML that you want to configure.

    • For SAML without dependency, do not change the toggle options. By default, these toggle options are disabled.

    SAML without dependency

    • For SAML with LDAP dependency, enable Use in conjunction with an existing ldap toggle option. From the Specify LDAP Connection drop-down list, choose the existing LDAP to integrate.

    Note: You must configure the LDAP connection before you configure SAML with LDAP dependency. Important: When you enable Use in conjunction with an existing ldap, you won't see the login option for LDAP authentication on the console login page.

    SAML with LDAP dependency

    • For SAML with SCIM dependency, enable This is a SCIM compliant identity provider toggle option.

    SAML with SCIM dependency

  6. Select the Token attribute mapping tab. It contains the following options that you are required to fill:

    • Subject
    • Given name
    • Family name
    • Groups
    • Email

    See the following notes:

    • By default, the Token attribute mapping values are pre-defined if you do not specify the mapping. It is recommended to modify the default values according to the SAML claim. The following default values are displayed if you do not specify the mapping values:

      • Subject : uid
      • Given name : firstName
      • Family name : lastName
      • Groups : blueGroups
      • Email : emailAddress
    • The uniqueSecurityName option is not supported from the product console. If the uniqueSecurityName is required in Token attribute mapping, see Different schema elements for IdP V3.

  7. Select To identity provider tab. Click Download metadata link to download the SAML 2.0 metadata. Once you download the metadata, you can upload that metadata to your identity provider to generate identity provider metadata.

  8. Select From identity provider tab. Upload the identity provider metadata in *.xml file that is supplied by your identity provider.

  9. The SCIM configuration tab is enabled when you choose to configure SAML with SCIM dependency. It contains the following fields:

    • Scim base path: It is required to uniquely identify the service instance.
    • Grant type: It identifies the token generation flow.
    • Token URL: It is the token endpoint of the IdP. It is used to request the token.
    • Client ID: It is used for the client credentials flow.
    • Client Secret: It is used for the client credentials flow.

    Scim configuration

    Also, you need to configure the SCIM attribute mapping for the user and group resources. By default, these fields are pre-defined as the principalName in both user and group attributes. It is recommended to modify the values based on the SCIM IdP configuration.

    SCIM attribute

  10. Click Create.