Compose a Login URL with a Specific User, Tenant, and Identity Provider

With Single Sign On (SSO), you can deep link directly to a SSO log in page. To allow a user to log in to a specific user account, tenant, or identity provider, you can add the following query parameters to the SSO login URLs for Skylight Desktop, Skylight, the configuration interface, or Skylight for Salesforce.

In these examples, the user's email address is yourname@yourcompany.com, the tenant ID is 22b00050-18e4-11e8-bdf7-82e0b1c2c321 and the identity provider ID is 2b68b83b-402b-42e9-bd9f-11a093dc3513.

  • Username, which is represented with the query parameter user={username}. Use this access CxEngage with the specified user's default identity provider on their default tenant.
    • Skylight Desktop: https://skylight-desktop.cxengage.net/#sso?username=yourname@yourcompany.com
    • Skylight: https://skylight.cxengage.net/#sso?username=yourname@yourcompany.com
    • Configuration Interface: https://cxengage.net/#/login?sso=true&username=yourname@yourcompany.com
    • Skylight for Salesforce: https://skylight.cxengage.net/#sso?crmModule=salesforce-classic&username=yourname@yourcompany.com
  • Tenant ID, which is represented with the query parameter tenantId={tenantId}
    • Skylight Desktop: https://skylight-desktop.cxengage.net/#sso?tenantId=22b00050-18e4-11e8-bdf7-82e0b1c2c321
    • Skylight: https://skylight.cxengage.net/#sso?tenantId=22b00050-18e4-11e8-bdf7-82e0b1c2c321
    • Configuration Interface: https://cxengage.net/#/login?sso=true&tenantId=22b00050-18e4-11e8-bdf7-82e0b1c2c321
    • Skylight for Salesforce: https://skylight.cxengage.net/#sso?crmModule=salesforce-classic&tenantId=22b00050-18e4-11e8-bdf7-82e0b1c2c321
  • Identity Provider ID, which is represented with the query parameter idp={identityProviderId}. The identity provider ID must be paired with a tenant ID. Use this to access CxEngage with the specified identity provider on the specified tenant.
    • Skylight Desktop: https://skylight-desktop.cxengage.net/#sso?tenantId=22b00050-18e4-11e8-bdf7-82e0b1c2c321&idp=2b68b83b-402b-42e9-bd9f-11a093dc3513

    Note: This URL can be used for single sign on for users with multiple IDPs across a single tenant.

    • Skylight: https://skylight.cxengage.net/#sso?tenantId=22b00050-18e4-11e8-bdf7-82e0b1c2c321&idp=2b68b83b-402b-42e9-bd9f-11a093dc3513
    • Configuration Interface: https://cxengage.net/#/login?sso=true&tenantId=22b00050-18e4-11e8-bdf7-82e0b1c2c321&idp=2b68b83b-402b-42e9-bd9f-11a093dc3513

    Note: This URL can be used for single sign on for users with multiple IDPs across a single tenant.

    • Skylight for Salesforce: https://skylight.cxengage.net/#sso?crmModule=salesforce-classic&tenantId=22b00050-18e4-11e8-bdf7-82e0b1c2c321&2b68b83b-402b-42e9-bd9f-11a093dc3513

You can use these parameters for login URLs or for the CTI Adapter URL in your Skylight for Salesforce configuration.

For more information on how to retrieve the required IDs, see Finding Object IDs

You might also be interested in: