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

## Before you begin

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

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

## Configure Idaptive for SSO

To configure Idaptive, follow these steps:

1. Sign in to the Idaptive administrator portal.

2. From the left menu, click **Web apps**.

3. Click **Add web apps**.

4. Click the **Custom** tab.

5. Locate the **SAML** web app and click **Add**.

6. On the confirmation dialog, click **Yes**.

7. On the SAML Web App Settings page, enter a **Name** and click **Save**.

8. On the SAML Web App page, click the **Trust** tab.

9. Navigate to the Identity Provider Configuration (IPC) section and
   select **Manual Configuration**.

10. Copy and save the **Entity ID** for later use in the CCAI Platform portal.

11. Download and save the **Signing Certificate** to a text file.

12. Copy and save the **IDP Login URL** for later use in the CCAI Platform portal.

13. Navigate to the Service Provider Configuration (SPC) section and
    select **Manual Configuration:**

14. Under **SP Entity ID / Issuer / Audience** , enter:
    `https://<environmentname>.ccaiplatform.com/saml/v1/metadata`

15. Under **Assertion Consumer Service (ACS) URL** , enter:
    `https://<environmentname>.ccaiplatform.com/saml/v1/consume`

16. Beside **Recipient** , select **Same as ACS URL**.

17. From the **NameID Format** drop-down, select emailAddress, then
    click **Save:**

18. On the SAML Web App page, click the **Permissions** tab:

19. Click **Add**.

20. In the Select User, Group, or Role dialog, search for and select a
    user, then click **Add**.

21. Click **Save** to deploy the SAML Web App:

## 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 Idaptive credentials.