Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Single sign-on enables you and your agents to log in to your Vonage Contact Center account by logging in to the linked Salesforce, Microsoft, or Vonage account, or any other configured provider account, instead of using their Vonage Contact Center username and password. You can enable multiple single sign-on providers at one time. To configure and use single sign-on, the feature must be enabled for your account.

...

  1. Log in to the VCC Admin Portal and go to System Settings. For information about accessing System Settings, see Editing System Settings.
  2. Click the Single Sign-On tab. The Single Sign-On area appears.
    Single Sign-On settings
  3. In the Vonage Contact Center portal and ContactPad fields in the Single Sign-On URLs section, the URLs that VCC Admin Portal supervisors and agents must use to access the single sign-on pages are displayed. Click the icon alongside the field to copy the contents of the field to the Clipboard.

    Info
    Provide the Vonage Contact Center portal URL to VCC Admin Portal users, both supervisors and non-Salesforce agents. Users should bookmark this URL to always use the single sign-on page.
    To make the single-sign on page available to agents in ContactPad in Salesforce, paste the ContactPad URL into the CTI Adapter URL field in your call center settings in Salesforce.


  4. Configure single sign-on for one or more of Salesforce, Microsoft, and Vonage. For information about configuring single sign-on for Salesforce, Microsoft, and Vonage, see How do I configure single sign-on using Salesforce?How do I configure single sign-on using Microsoft accounts?, and How do I configure single sign-on using Vonage?.

  5. Click Update. Now when you or your agents go to log into the VCC Admin Portal or ContactPad using the appropriate URLs, the single sign-on feature is available.
    For information about using single sign-on in the VCC Admin Portal or ContactPad, see Logging in to the Vonage Contact Center Admin Portal using single sign-on or Logging in to ContactPad using single sign-on.

...

To configure single sign-on for an external provider, provide the following information in the Custom OIDC SSO section:

Single sign-on settings for an external providerImage Added

FieldOptionsDescription
EnableSelect or clear

Use the Enable check box to enable and disable single sign-on using OIDC.

Select the Enable check box to enable single sign-on using OIDC. When you or your users go to the VCC Admin Portal's single sign-on URL, an OIDC button appears on the login page, using the Name you have specified.
Clear the Enable check box to disable single sign-on using OIDC . The OIDC button no longer appears on the single sign-on login page.

Name

The label that appears on the button on the single sign-on login page.

Type the label you want to appear on the button that you and your users will use to log in to Vonage Contact Center using the external provider. The value can be up to 14 characters.

Client Id

The client ID used to authenticate with the external provider. Generate the client ID in the provider's application.

Copy the ID into Client Id.

OpenID Connect (OIDC) Issuer URL

The single sign-on initialization URL that is used to log in to the external provider.

Type the URL into OpenID Connect (OIDC) Issuer URL

Identifier Fields

The identifier fields determine the values used to match Vonage Contact Center and external provider users.

By default, the VCC Admin Portal uses email addresses to match external provider users and Vonage Contact Center users. The external provider user's email address used to log in must match the email address of a single Vonage Contact Center supervisor or agent user.

If you do not want to use email addresses, use one or both identifier fields to define the values that the VCC Admin Portal should use to match the users.

When you change identifier values, the help text at the bottom of the Custom OIDC SSO section updates.

Vonage Contact Center Identifier

List of supported identifiers

Vonage Contact Center can identify agents and supervisors in the VCC Admin Portal using the value in any of the supported identifiers. Select the identifier that you want Vonage Contact Center to use to locate the VCC Admin Portal user that matches the logged in external provider user.

Supported Vonage Contact Center identifiers:

  • Email
  • Username
  • External ID


Info
You can modify the values for these identifiers in Real Time for agents or in User Access for supervisors. External ID contains the value in the SSO External Id or SSO External ID field.


External IdentifierList of supported identifiers

Vonage Contact Center can obtain the value in any of the supported identifiers for the logged in external provider user. Vonage Contact Center can then use that value to locate the corresponding VCC Admin Portal user. Select the External identifier that you want Vonage Contact Center to use to locate the corresponding VCC Admin Portal user.

Supported external provider identifiers:

  • Email. The Email identifier contains the email address in the external providers' profile.
  • Username. The Username identifier contains the username that the external provider user uses to log in.

  • Subject. The Subject identifier contains the subject that the external provider user uses to log in.

...