How to Configure Webex SSO for the YakChat Embedded App | YakChat Help

How to Configure Webex SSO for the YakChat Embedded App

Enable Single Sign-On (SSO) for Webex to allow users to automatically sign in to the YakChat Embedded App using their existing Webex credentials. This integration provides a seamless login experience and reduces login-related support requests.


Overview

When Webex SSO is enabled, users accessing the YakChat Embedded App are automatically authenticated through Webex, eliminating the need to enter separate YakChat credentials.

With Webex SSO enabled:

  • Users sign in to Webex normally.
  • Opening the YakChat Embedded App automatically signs them into YakChat.
  • The YakChat login page is bypassed.

Without Webex SSO:

  • Users must manually enter their YakChat credentials.
  • Frequent logins may be required when sessions expire.
  • Users may experience additional sign-in prompts.

Tip: Enabling SSO is recommended to provide a smoother experience and prevent session interruptions.


Before You Begin

Ensure the following before enabling Webex SSO:

  • Administrator access to the YakChat Admin Portal.
  • Access to the Webex Embedded App configuration.
  • The Embedded App ID from Webex.

Obtain the Embedded App ID

The Webex Embedded App ID is required as the Audience value in YakChat.

Step 1: Retrieve the Embedded App ID

  1. Sign in to the Webex administration dashboard.
  2. Navigate to the Embedded Apps configuration area.
  3. Locate the YakChat Embedded App.
  4. Copy the Embedded App ID.

This Embedded App ID serves as the Audience value used in the Webex SSO configuration.


Configure Webex SSO

Parent Companies

  1. Open the YakChat Admin Portal.
  2. Navigate to the company configuration.
  3. Locate the Webex SSO settings.
  4. Enter the Embedded App ID obtained from Webex.
  5. Save the configuration.

The Audience value is then inherited by descendant companies.

Child Companies

  1. Open the YakChat Admin Portal.
  2. Navigate to the company settings.
  3. Enable the Webex SSO toggle.
  4. Save the configuration.

Even when the Audience value is inherited, Webex SSO must be enabled individually for each child company.


Sign In Using Webex SSO
  1. Sign in to Webex.
  2. Open the YakChat Embedded App.
  3. YakChat automatically authenticates the user.
  4. The user is taken directly into the application.

No separate YakChat login is required.


Sign In Without Webex SSO
  1. Open the YakChat Embedded App from Webex.
  2. The YakChat login page appears.
  3. Enter your YakChat credentials.
  4. Complete the sign-in process.

In this mode, users authenticate directly with YakChat instead of Webex.


Child Companies Must Enable SSO Individually

Although the Audience value is inherited from the parent company, each child company must enable Webex SSO individually.


Multiple YakChat Accounts

When Webex SSO is enabled, switching between YakChat accounts is not supported. Authentication is managed through the active Webex session.


Troubleshooting

Users Still See the YakChat Login Page

Possible causes:

  • Webex SSO is not enabled for the company.
  • The Audience value has not been configured correctly.
  • The company has inherited the Audience value but has not enabled the Webex SSO toggle.

Verify the company’s Webex SSO configuration and save any changes.

Users Are Prompted to Log In Frequently

Ensure that Webex SSO is enabled. Companies using standard YakChat login may experience session expiration and reauthentication prompts.


Related Articles