This section explains how to configure SSO using Ping to use
use enterprise-wide Ping credentials to sign in to Contact Center AI Platform (CCAI Platform) and
the agent adapter. Ping SSO uses the Security Assertion Markup Language (SAML)
authentication protocol.

## Before you begin

To configure SSO using Ping, be sure you have the following:

- A Ping account
- An SSO URL
- An entity ID
- An email mapping field, usually Name ID
- A SAML certificate (in Base64)
- CCAI Platform administrator credentials

## Configure Ping for SSO

To configure Ping, follow these steps:

1. Sign in to your existing Ping account.

2. Using this [Ping documentation](https://docs.pingidentity.com/r/en-us/solution-guides/htg_config_saml_app) as
   a guide, select the tab for the specific product you have. The products
   available include the following:

   - PingFederate

   - PingOne

   - PingOne for Enterprise

3. Follow the specific instructions for your Ping product. At the end of the
   setup for your product, you should have obtained the following:

   - Login URL
   - Ping AD Identifier
   - Email name or Name ID
   - Certificate
4. When these are obtained, continue to configure your CCAI Platform portal instance
   for SSO.

## Configure your CCAI Platform instance for SSO

To configure SSO for your CCAI Platform instance, follow these steps:

1. In the Google Cloud console, go to the project selector dashboard and select the project that contains your instance.

   [Project selector dashboard](https://console.cloud.google.com/projectselector2/home/dashboard)

   <br />

2. In the navigation menu, click **CCAI Platform** .


   [CCAI Platform instances](https://console.cloud.google.com/contact-center-ai-platform)

   <br />

   The **CCAI Platform instances** page displays.
3. In the **Name** column, click the instance that you want to configure SSO for.
4. On the **CCAI Platform instance Detail** page, click **Edit**.
5. For the login method, select **SAML**.
6. In the **Single sign-on URL** field, enter your SSO URL.
7. In the **Entity ID** field, enter your entity ID.
8. In the **Email field mapping** field, enter a text string such as `Email name` or `Name ID`. This is used as a label for the email name field on the SSO sign-in page.
9. In the **Authentication contexts** field, select the authentication context that you want. If your IdP configuration doesn't require the authentication context to be specified, then leave this field empty. For more information, see [Authentication context](https://docs.cloud.google.com/contact-center/ccai-platform/docs/authentication-context).
10. In the **Certificate** field, enter your SAML certificate. Be sure to include `---BEGIN CERTIFICATE---` and `---END CERTIFICATE---` from the certificate.
11. Click **Save**.

## Verify SSO authentication

To verify SSO authentication, follow these steps:

1. Go to the agent adapter in your customer relationship management (CRM)
   application.

2. Click **Login with company SSO**. A sign-in page displays.

3. Sign in with your Ping credentials.