SSO unified login

Authenticate once to seamlessly access the LivePerson platform
  • Messaging
  • Chat

The single sign-on (SSO) unified login feature enables LivePerson agents and site administrators to authenticate once, in their own environment, and then to seamlessly access the LivePerson platform while already authenticated.

This feature allows for frictionless management of LivePerson agents, as well as providing the support required for financial services that are subject to OCC regulation- a regulation which requires multi-factor authentication for agents. These customers can leverage the SSO unified login feature to comply with the regulation by implementing an internal multi-factor authentication with its selected provider, and leverage that authentication when accessing the Conversational Cloud.

This capability includes an architecture based on the SAML protocol, a standard protocol for implementing and supporting Single Sign-On. This architecture ensures both scalability as well as the highest level of security.


SSO login architecture based on SAML Assertion

Figure 1: Architecture based on SAML Assertion:

Prerequisites for the Conversational Cloud:

  • SAML-enabled IdP server
  • Valid X.509 certificate


Customers wishing to authenticate agents to the Conversational Cloud based on the SSO Unified Login feature need to complete the following:

Configuration on LivePerson’s Environment

The following settings will be handled by LivePerson’s Production department on behalf of the customer:

The customer needs to provide LivePerson with their X.509 certificate that includes the signature algorithm called: SHA256. The certificate is then stored in the customer’s site configuration and is used for validating the SAML assertions. LivePerson will provide the customer with the certificate and assertion consumer URL.

The customer needs to provide LivePerson with the following three parameters:

  • Login page:  A login page to IDP when trying to access the Conversational Cloud without prior authentication to customer IDP.
  • Logout page:  A URL that the user will be redirected to when logging out of the Conversational Cloud.
  • Redirect Page Upon Login Error: A URL that the user will be redirected to when the login to the Conversational Cloud fails.

Configuration on the customer’s environment

  • Create a SAML assertion with dynamic variables: siteId and loginName. The SAML assertion must be sent to the Conversational Cloud every time a user (admin or agent) wishes to log in. If it is not possible to send the siteID, LivePerson can adapt the configuration. If it is not possible to send the loginName, LivePerson can accept the nameId field instead.
  • Provision the users in the customer’s User Management System to map to those of the Conversational Cloud. For new users created in the Customer's User Management system, the customer will need to manually create them in the Conversational Cloud (or automate the process via the Users API and create the linkage in the Customer's User Management system.
  • Use this consumer URL for connecting to the Conversational Cloud: https://<LPDomain>/hc/s-<YourAccountNumber>/web/m-LP/samlAssertionMembersArea/home.jsp?lpservice=liveEngage&servicepath=a%2F~~accountid~~%2F%23%2C~~ssokey~~
  • Use this consumer URL for connecting to the MCS toolkit: https://<LPDomain>/hc/s-<YourAccountNumber>/web/m-LP/samlAssertionMembersArea/home.jsp?lpservice=mcs&servicepath=a%2F~~accountid~~%2F%23%2C~~ssokey~~
  • Use this consumer URL for connecting to the Real Time Dashboard: https://<LPDomain>/hc/s-<YourAccountNumber>/web/m-LP/samlAssertionMembersArea/home.jsp?lpservice=rtDashboard&servicepath=a%2F~~accountid~~%2F%23%2C~~ssokey~~
  • Use this consumer URL for connecting to the Bot Studio: https://<LPDomain>/hc/s-<YourAccountNumber>/web/m-LP/samlAssertionMembersArea/home.jsp?lpservice=routingBot&servicepath=a%2F~~accountid~~%2F%23%2C~~ssokey~~
  • Use this consumer URL for connecting to the CoBrowse Admin console: https://<LPDomain>/hc/s-<YourAccountNumber>/web/m-LP/samlAssertionMembersArea/home.jsp?lpservice=coBrowse&servicepath=a%2F~~accountid~~%2F%23%2C~~ssokey~~

General notes on using the feature

  • HTTPS must be used for communication with the LivePerson servers.
  • Once the SSO unified login feature is turned on, users cannot log in using their previous credentials, even if they regenerate the password by clicking the 'forgot my password' link.
  • Password reset is still possible and will send a new password to the defined email in login policy tab, but the password will no longer be of use.
  • It is advised that once unified login is turned on, any issues with agent login should first be checked by the various technical teams on the customer’s side in order to rule out two-factor login, IdP and agent definition issues.
  • It is the responsibility of the brand to update LivePerson with the renewed X.509 certificate a month before the current certificate expires.

Missing Something?

Check out our Developer Center for more in-depth documentation. Please share your documentation feedback with us using the feedback button. We'd be happy to hear from you.