Set Up CXone Authentication Using an External Identity Provider

This page guides you, step-by-step, in setting up authentication for your CXone system using an external identity provider (IdP).

Complete each of these tasks in the order given.

Before You Begin

  • Gain a basic understanding of authentication and authorization concepts and terminology if you've never set up a process like this before.
  • Review the CXone-specific process if this is the first time you've worked with authentication in CXone.
  • Consider your human users and the levels of access they need. Decide whether people with greater access should have greater levels of security.
  • Decide whether you will use custom password requirements, multi-factor authentication (MFA), or both to enforce.
  • Based on your decisions, make a list of login authenticators. The list should include the password requirements and MFA status you want to use for each login authenticator. You don't have to create custom login authenticators if the default login authenticator meets your password management needs.
  • Consider whether you need to include authentication and authorization for applications like bots or intelligent virtual assistants (IVAs). If so, you will need to create access keys.
  • Identify your external IdP. CXone supports both hosted and cloud service IdPs. If necessary, involve your company's authentication experts in this process. There may already be established processes for integrating systems like CXone with your external IdP. Following these processes and meeting your specific security needs is ultimately your responsibility.
  • Define your authentication protocol. CXone supports SAML 2.0.
  • Evaluate the combination of IdP and protocol to ensure your use cases and user flows are supported, and to identify potential issues. This should include actual testing.

Your NICE CXone team can support and guide you in this planning process. Good planning makes for a smoother implementation. Implementing authentication and authorization as immediate needs come up is more likely to lead to issues.

Create External Login Authenticators

Required permissions: Login Authenticator Create

Login authenticators are used to manage password criteria. You can create different login authenticators for different employees.

You can use external authentication when you want a user's password to be managed by another system, or identity provider. CXone currently supports the SAML 2.0 federation protocol.

You can set up IdP-initiated authentication or SP-initiated authentication with the steps in this section.

IdP-Initiated Authentication—IdP stands for external identity provider. IdP-initiated authentication means that the external identity provider starts the login process.

SP-Initiated Authentication—SP stands for service provider. SP-initiated authentication means that CXone starts the login process.

If you are using Salesforce Agent, then the external identity provider (IdP) must be configured for SP-initiated authentication. The certificate provided by the IdP must be SP-initiated with a distinct endpoint URL. Any certificate with Endpoint URL None - IdP-initiated only will not work.

  1. Ensure that you have access to the external identity provider. You will need to create an integration specific to CXone.
  2. Create the integration in the external identity provider. Different systems use different names for these integrations, see specific instructions for Okta or Azure.
    1. You will need to provide an Entity ID which you don't know at this point. Use https://cxone.niceincontact.com/need_to_change as a placeholder.
    2. You will need to provide an ACS URL which you don't know at this point. Use https://cxone.niceincontact.com/need_to_change as a placeholder.
    3. The identity provider will generate a specific URL where SAML requests must be sent. Copy and save this URL to a place where you can find it. You will need to enter this value in later steps.
    4. The identity provider will generate a public signing certificate for the integration. Download the certificate. You will need to use it in later steps.
  3. Create an external login authenticator in CXone.
    1. Click the app selector and select Admin.
    2. Click SecurityLogin Authenticator.
    3. Enter the Name and Description of the login authenticator.
    4. Select SAML as the Authentication Type.
    5. If you select FICAM, the SAML response must have a single AuthnContextClassRef entry. Also, the NamespaceURI of the assertion subject must be: urn:oasis:names:tc:SAML:2.0:assertion. The AuthnContextClassRef and NamespaceURI fields are controlled by the identity provider.
    6. Enter the SAML request Endpoint you received from your provider above as the Endpoint URL.
    7. Click Choose File and select the public signing certificate you received from your provider. This file must be a PEM file. It will be a text file and the first line will contain BEGIN CERTIFICATE with some other text.
    8. Select the Assigned Roles tab and click one or more roles under All Unassigned Roles to assign them the login authenticator you are creating.

    9. Click Save and Activate.
    10. Open the login authenticator.
    11. You will notice two additional read-only fields displayed, the Entity ID and the ACS URL. Note these values.

  4. Update your identity provider settings, replacing the placeholders used above with the values you just noted.

  5. Associate the login authenticator with a user through that user's role.

  6. Ensure that the External Identity for each user that uses the login authenticator is set to the correct value.

    1. Your identity provider determines the value that must be used. The value must match exactly what you put in the External Identity field in CXone.

  7. Have the user log in. They must use the latest login URL. After entering their username they will be directed to the external identity provider if needed.

Create Roles

Required permissions: Role Management Create

  1. Click the app selector and select Admin.
  2. Go to Security SettingsRoles & Permissions.
  3. Click New Role.
  4. Type a Name and optionally a Description for the role.

    The role's description cannot have more than 200 characters.

  5. Select a login authenticator from the drop-down.
  6. Click the Permissions tab.
  7. Configure the permissions for the role. Permissions are categorized by CXone application, and you can only see applications that are part of your CXone system. Click the role categories on the left to move between them.

  8. If the role you're creating (or editing) has permissions similar to one of the CXone's four out-of-the-box (OOTB) roles, click Set To Default, select the relevant OOTB role (Agent, Manager, Administrator, or Evaluator) from the drop-down, and then click Apply. The permissions are set according to the selected out-of-the-box role. Make the changes in the permissions, as required for the role.
  9. When you are finished configuring permissions, click Save to save the role in draft status or click Save and Activate to save the role in active status. You cannot assign users to the role until you activate it.

Create or Edit Employees

Required permissions: Employees Create

If you are setting up authentication with an external IdP for an existing CXone business unit, you do not have to create new user accounts. However, you will need to edit user accounts and configure the External Identity Type and Federated Identity fields. This must be done for each user who will authenticate via the external IdP. The fields are explained in step 8 of this task.

You can add an employee account by using:

The instructions here are for creating a single employee account in the application. If your company is using ACD, you'll also need to configure ACD user settings for this employee.

CXone offers many options and settings to customize employees. Read through this entire task. Make sure you know the settings you need to configure before you begin.

To add an employee:

  1. Click the app selector and select Admin.

  2. Click Employees > Create Employee.

  3. Enter the employee's First Name and Last Name. The Middle Name is optional.

  4. Enter a valid Email Address. CXone sends emails like activation invitations and password verification codes here. You can use the same email address for multiple employees. When you edit an employee's email address, a verification email is sent to the new email address.

  5. Enter the Username you want to assign to an employee. The username must be in the form of an email address. The field is auto filled from the Email Address field. You can edit it if you want to.

  6. Assign a Primary Role to an employee from the drop-down.

  7. Complete the fields on the General tab.

    Learn more about fields on the General tab

    Field

    Details

    Display Name Enter a Display Name you want to assign to an employee. Users from other teams can view the display name. They cannot view other information about the employee unless they have the View Employee permission enabled.
    Type Use Type to organize an employee outside of their assigned Role and Team. The type is not tied to permissions or unavailable codes. This makes reporting easier. You can select previously created types from the drop-down. You can also create new types by entering text in the search bar, and clicking Create.
    Hire Date The date you hired an employee. This field is for your records only. CXone doesn't use this information.
    Time Zone The employee is automatically assigned to the tenantClosed High-level organizational grouping used to manage technical support, billing, and global settings for your CXone environment time zone unless you change it.
    OS Login The operating system the employee uses. The CXone Recording application requires this information for screen recording. The field accepts free text and may contain a text string related to an operating system such as Windows 10.

    Rank

    This field is visible only if you have CXone WFM in your environment. It determines priority when creating a schedule.

    Assigned to Team Assign the employee to a team by selecting a team from the drop-down menu.

    If you haven't created teams yet, or if the employee will belong to a new team, you can just accept the Default Team setting and then change it later.

    Assigned To Groups Assign the employee to one or more groups by selecting groups from the drop-down menu.
    Assigned To Scheduling Unit This field is visible only if your system includes CXone WFM. It specifies the scheduling unit for the employee.
    Mobile Number The employee's mobile or cell phone number. This field is for your records only. CXone doesn't use this information.
    Attributes

    Under this drop-down select attributes related to the employee:

    • Can be Evaluated/Coached—This attribute appears only if your system includes CXoneQM. It enables the employee to be evaluated, and you will be billed for QM for this employee.

      The default value is selected for new employees. If you add QM to a system that has existing users, you must manually enable this setting for those users.

    • Can Be Recorded (Screen)—This attribute appears only if your system includes CXone Recording Advanced. It enables the employee's screen to be recorded, and you will be billed for screen recording for this employee.

      The default value is selected for new employees. If you add CXone Recording Advanced to a system that has existing users, you must manually enable this setting for those users.

    • Can be Recorded (Voice)—This attribute is visible only if your system includes CXone Recording/CXone Recording Advanced. It enables the employee's voice to be recorded. You will be billed for voice recording for this employee.

      The default value is selected for a new employees. If you add CXone Recording/CXone Recording Advanced to a system that has existing users, you must manually enable this setting for those users.

    • Can be Scheduled—This attribute is visible only if your system includes CXone WFM. It enables the employee to be scheduled. You will be billed for WFM for this employee.

      The default value is selected for new employees. If you add WFM to a system that has existing users, you must manually enable this setting for those users. Users who don't have this attribute selected won't appear in employee lists when creating weekly rules or shift templates. Removing this attribute from a user deletes that user from any weekly rules or shift templates to which the user is assigned.

    • Can be Analyzed—This attribute appears only if your system includes Interaction Analytics. When this attribute is selected, the employee's recorded interactions are analyzed by Interaction Analytics. You will be billed for Interaction Analytics for this employee.

      The default value is cleared for new employees.

    • Can Edit BI Reports—Employees with this attribute selected can edit any of the BI reports in the Reporting application as long as they also have the correct permissions.

      The default value is cleared for all employees, both existing and new.

    • Can View BI Reports—Employees will be able to open any BI reports with this attribute. Reports are in the Reporting application, but employees should have permissions to view the reports there. BI reports have no usage fee for up to 10% of either your concurrent or configured users, depending on your pricing model. Once the 10% threshold is passed, you will be billed for each additional employee with this checkbox selected.

      The default value is cleared for all employees, both for existing and new.

    • Customer Card—This attribute allows employees who don't work with digital contacts to access available customer cards for omnichannel-routed voice, chat, email, and CXone SMS Messaging contacts.

      The default value is cleared for new employees.

    • Digital Engagement—This attribute appears only if your system includes Digital First Omnichannel. When this attribute is selected, the employee's record is synced to Digital First Omnichannel, and they can work on digital contacts. You will be billed for Digital First Omnichannel for this employee. The default value is cleared for new employees.

  8. Click Create to create the employee profile and continue setting it up. Click Create & Invite if you're ready for the user to activate their account and set up their password.

Authenticate Applications

Users and applications are authenticated in very similar ways. The main difference is that applications are authenticated with an access key while users are authenticated with a username and password. Unlike users, applications are not required to interact through a browser. Applications typically are either back-office functionality or intelligent virtual agentsClosed Chatbot or similar application that interacts with a user based on artificial intelligence (IVAs).

To set up an application to interact with CXone, create an employee profile and name the profile after the application. Then create an access key for the application user as follows:

Required permissions: Employees Edit

  1. Click the app selector and select Admin.
  2. Click Employees and then click the employee profile you're editing to open it.
  3. Click the Security tab.

  4. Click Add access key.
  5. Copy the Access Key ID to a secure location.
  6. Click Show Secret Key and copy the secret key to a secure location.
  7. Click Save.

Authorization in CXone

Authorization is the process of verifying what resources a user is allowed to access. Resources can include applications, files, and data. You can define users' access to resources with role-based access control. CXone manages authorization automatically during authentication. When a user is authenticated they are given access only to the resources they're authorized for.

A user's authentication method doesn't impact authorization. CXone uses the same authorization process for all users. It doesn't matter whether they are authenticated with access keys or passwords.