Gestionar la federación con Okta

Okta es solo uno de los proveedores de identidades (IdP) externos admitidos que puede usar con NiCE CXone. Esta página lo guía, paso a paso, en la configuración de la autenticación para su sistema NiCE CXone mediante Okta.

Si está realizando la implementación inicial de su NiCE CXone sistema, hay pasos adicionales a considerar. Recomendamos leer las siguientes páginas de ayuda en línea, las cuales incluyen estas consideraciones:

Gestionar la federación con Okta a través de SAML 2.0

Esta página lo guía, paso a paso, en la configuración de la autenticación para su sistema NiCE CXone usando Onelogin como su proveedor de identidad externo (IdP).

Complete cada una de estas tareas en el orden indicado.

Antes de empezar, asegúrese de que tiene acceso a Okta. Deberá crear una aplicación.

Configurar el Valor de estado de Retransmisión

El valor de estado de retransmisión es obligatorio al configurar la aplicación SAML Okta en la siguiente tarea. Use el valor que corresponda a su entorno.

Valores de estado de Relay por Entorno

La siguiente tabla enumera los entornos actualmente admitidos:

Entorno Valor de estado de retransmisión
Producción {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
FedRAMP {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
AUSOV1 {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
EUSOV1 {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}
UKSOV1 eyJjbGllbnRJZCI6IjBiNjk3ZWJiLTRlYTItNDA1Mi1iMTJiLWQzY2YxMmE1M2VjYSJ9
UKSOV2 {"clientId":"0b697ebb-4ea2-4052-b12b-d3cf12a53eca"}

Aunque el valor de Relay State es actualmente el mismo en todos los entornos, cada entorno tiene su propio id de cliente único. Los entornos futuros pueden usar valores diferentes. Utilice siempre el valor indicado para su entorno con el fin de garantizar la compatibilidad con versiones futuras.

  1. Identifique el entorno que utiliza su organización.

  2. Copie el valor de Relay State correspondiente de la tabla.

  3. Utilice este valor cuando configure la aplicación SAML Okta en la siguiente tarea.

Crear y configurar una Aplicación Okta con SAML 2.0

  1. Inicie sesión en su cuenta de gestión de Okta.
  2. Haga clic en menú de Aplicaciones > Create App Integration.
  3. Seleccione SAML 2.0 como método y haga clic en Siguiente.
  4. Intro el nombre que desea usar para identificar esta integrar, y haga clic en Next.
  5.  Configure SAML:
    1. Ingrese una URL de marcador como https://need_to_change en el campo URL de inicio de sesión único. Obtendrá el URI real del Servicio de Consumidor de Afirmación (ACS) desde su autenticador de inicio de sesión de NiCE CXone en un paso posterior.
    2. Seleccione Usar esto para la URL de Destinatario y la URL de Destino.
    3. Intro una URL de marcador como https://need_to_change en Audience URI (SP Entity ID). En un paso posterior, reemplazará el marcador con el Entity ID de su NiCE CXone autenticador de inicio de sesión.
    4. Intro el valor de Default Relay State que generó en el paso anterior.
    5. Especifique el formato de Name ID y el Application username para que correspondan con la forma en que desea identificar a sus usuarios ante NiCE CXone. Elija el atributo que se usará como el ID de nombre, como el username o el correo electrónico de Okta. Su selección aquí determina lo que utilizará en el campo Id externo en el perfil de empleado de cada usuario de NiCE CXone, el cual configurará en un paso posterior.
    6. Haga clic en Mostrar Configuración Avanzada.

    7. Seleccione un Signature Algorithm. Se recomienda RSA_SHA256.

    8. Cambie Assertion Signature a Unsigned. Deje Respuesta firmado.
    9. Asegúrese de que Cifrado de aserciones esté Sin cifrar.
  6. Haga clic en próximo, complete los comentarios y luego haga clic en Finalizar en la pestaña Comentarios.
  7. Click View SAML setup instructions to open a new tab, then:
    1. Haga clic en Descargar certificado para descargar el certificado de firma. Guarde este archivo para su NiCE CXone configuración.
    2. Cierre la pestaña Instrucciones de configuración de SAML. Deje abierta la pestaña Configurar SAML. Realizará cambios en su configuración según los valores de NiCE CXone que obtendrá en un paso posterior.

Configurar una Ubicación

Permisos requeridos: Crear Gestión de ubicación

Si desea exigir que los usuarios inicien sesión desde una Dirección IP determinada, cree una ubicación con las Direcciones IP, los rangos de direcciones IP o las subredes de direcciones IP que desea permitir. Cuando se requiere una ubicación configurada para un usuario, ese usuario debe tener tanto las credenciales como la Dirección IP correctas para iniciar sesión. De lo contrario, su intento de inicio de sesión falla y reciben un error. Puede tener hasta 20 ubicaciones a la vez y hasta 10 reglas por ubicación.

  1. Haga clic en el selector de aplicaciones icon of app selector y seleccioneAdmin.
  2. Vaya a Ubicaciones > Definiciones de ubicación.
  3. Haga clic en Nueva ubicación.
  4. Asigne un nombre descriptivo a la ubicación. Si desea agregar más detalles sobre la ubicación, ingrese una Descripción.
  5. Puede seleccionar Establecer como Ubicación predeterminada o Ubicación remota para indicar el tipo de Ubicación. Sólo puede tener una ubicación predeterminada. Estos campos no afectan actualmente a ninguna funcionalidad y su selección es para su propia referencia.

  6. Agregue cualquier otra información que desee utilizando los campos restantes, incluidos la dirección física, el país, las coordenadas GPS, la zona horaria o los grupos asignados. Estos campos actualmente no afectan a nada, y la información ingresada sería sólo para su propia referencia.

    Si agrega grupos al campo Grupos asignados los usuarios que pertenezcan a esos Grupos aparecerán en la pestaña Usuarios asignados. Sin embargo, la configuración de ubicación no se aplicará a ellos. Si asigna una ubicación a un autenticador de inicio de sesión, la ubicación se aplica a los Usuarios asignados a ese autenticador de inicio de sesión y restringe su capacidad para iniciar sesión en función de su Dirección IP. Sin embargo, esos usuarios no aparecerán en la pestaña usuarios asignados.

  7. Hacer clicGuardar.

  8. De vuelta en la página Definiciones de ubicación, haga clic en la Ubicación que acaba de crear para abrirla.

  9. Haga clic en la pestaña Reglas de detección automática.

  10. Cree una nueva regla. Para hacerlo:

    1. Haga clic en Nueva regla.

    2. Asigne un nombre descriptivo a la regla.

    3. Seleccione el Tipo de regla entre las siguientes opciones:

      • List: Lista de Direcciones IP específicas permitidas para esta ubicación. Por ejemplo, 100.0.1.100, 100.0.1.101, y 100.0.1.102.

      • Rango: Un rango de direcciones IP permitido para esta ubicación. Por ejemplo, 100.0.1.100-100.0.1.125.

      • Subred: Una subred permitida para esta ubicación. Por ejemplo, 100.0.0.1/32.

    4. Especifique la Versión IP como una de las siguientes:

      • IPV4: Una Dirección IP de 32 bits

      • IPV6: Una dirección hexadecimal de 128 bits.

    5. Introduzca las Direcciones IP reales, el rango o la subred en el campo Definición de regla, siguiendo los formatos de los ejemplos de los pasos anteriores. Si seleccionó Lista, puede ingresar hasta 100 Direcciones IP. Si seleccionó Rango o Subred, sólo puede ingresar un valor.

    6. Haga clic en Confirmar.

  11. Agregue más reglas según sea necesario. Puede tener hasta 10.

  12. Hacer clicGuardar.

Configurar un Autenticador de inicio de sesión de NiCE CXone con SAML 2.0

Permisos obligatorios: Autenticador de inicio de sesión Crear

  1. Haga clic en el selector de aplicaciones icon of app selector y seleccioneAdmin.
  2. Haga clic en Seguridad > Autenticador de inicio de sesión.
  3. Hacer clicNuevo Autenticador de inicio de sesión.
  4. Introduzca el nombre y la Descripción del autenticador de inicio de sesión. Para la descripción, use solo texto sin formato. Las URL o el marcado, como html, no se guardarán.
  5. Seleccione SAML como el Tipo de autenticación.

  6. Si desea exigir que los usuarios inicien sesión desde una Dirección IP determinada, seleccione la Ubicación que configuró en la sección anterior.

  7. Haga clic en Elija el archivo y seleccione el certificado de firma pública que descargó Okta en la tarea anterior. Este certificado debe ser un archivo PEM. Será un archivo de texto y la primera línea contendrá BEGIN CERTIFICATE con algún otro texto.

  8. Seleccione la pestaña Usuarios asignados. Seleccione los usuarios que desea asignar al autenticador de inicio de sesión que está creando. También puede asignar usuarios directamente al autenticador de inicio de sesión en su perfil del empleado.

  9. Haga clic en Guardar y activar.
  10. Abra el autenticador de inicio de sesión.

  11. Notará dos campos adicionales de solo lectura que se muestran: el ID de Entidad y la URL de ACS. Tome nota de estos valores. Las necesitará en la tarea agregar valores de NiCE CXone a Okta.

Configurar usuarios de NiCE CXone

Complete this task in NiCE CXone fir all NiCE CXone users who require single sign-on with Okta. También puede completar este paso usando la plantilla de carga en masa.

  1. En NiCE CXone, haga clic en el selector de aplicaciones y seleccione Admin.

  2. Haga clic enEmpleados.

  3. Seleccione el perfil de empleado que desea modificar y haga clic en Editar.

  4. Si aún no lo ha hecho, vaya a la pestaña Seguridad y seleccione el autenticador de inicio de sesión que creó anteriormente.

  5. Asegúrese de que Identidad externa esté configurada con el valor correcto. El valor debe coincidir exactamente con el Identificador único de usuario en Okta.

  6. Guarde sus cambios.

Agregar valores de NiCE CXone a Okta

  1. Regrese a su aplicación Okta y vaya a la Pestaña general.
  2. Haga clic en Editar en la ventana Configuración de SAML, luego haga clic en Siguiente.
  3. Para URL de inicio de sesión único, introduzca el URL de ACS valor de su NiCE CXone autenticador de inicio de sesión.
  4. Para URI de audiencia (ID de Entidad de SP), introduzca la identificación de la Entidad valor de su NiCE CXone autenticador de inicio de sesión.
  5. Haga clic en próximo, luego haga clic en Finalizar para completar el cambio.

Prueba la Integrar de SAML

Antes de asignar el autenticador de inicio de sesión SAML a los usuarios en NiCE CXone, debe probar la integración de SAML. Si la prueba falla, revise sus configuraciones y realice cambios en la configuración.

  1. Inicie una sesión de inicio de sesión desde el dashboard de Okta.
  2. Verifique que el flujo de Autenticación SAML funcione como lo espera.

Verificar el acceso de usuario con inicio de sesión único de Okta

  1. Haga que uno o más usuarios de prueba inicien sesión utilizando la URL de inicio de sesión más reciente, https://cxone.niceincontact.com. Para FedRAMP, utilice https://cxone-gov.niceincontact.com. Después de ingresar su nombre de usuario, serán dirigidos a Okta si es necesario.

  2. Cuando esté listo, implemente el inicio de sesión único de Okta para todos los empleados.

Este es el último paso para administrar la federación con SAML 2.0.

Administrar la federación con Okta con OpenID Connect

Complete cada una de estas tareas en el orden indicado.

Configure una Aplicación de Okta con OpenID Connect

  1. Inicie sesión en su cuenta de gestión de Okta.
  2. Haga clic en Applications menu > Create App Integration.
  3. Seleccione OIDC - OpenID Connect como el Sign-in method.
  4. Seleccione Web Application como el tipo de Aplicación y haga clic en Next.
  5. En el campo nombre de la integración de la app, escriba el nombre que desea usar para identificar esta integrar.
  6. Deberá proporcionar un Sign-in Redirect URI que no conoce en este momento. Use https://cxone.niceincontact.com/need_to_change como marcador. Cambiará este valor con el URI que reciba más adelante.
  7. Es posible que deba proporcionar un Sign-out Redirect URI que no conoce en este momento. Use https://cxone.niceincontact.com/need_to_change como marcador. Cambiará este valor con el URI que reciba más adelante.
  8. En el menú desplegable Acceso controlado, seleccione Omitir la asignación de grupo por ahora.
  9. Hacer clicGuardar.
  10. En la pestaña general, dentro de Credenciales de cliente, seleccione Autenticación del cliente.
  11. Select one of the following authentication methods:
    1. client_secret_basic: client credentials are passed in a basic header during authentication. After selecting this method, configure the following:
      1. Seleccione Autenticación del cliente como el Secreto de cliente.
      2. Copie la Id de cliente y el Secreto del cliente y péguelos en un lugar seguro de su dispositivo. Los necesitará al configurar un autenticador de inicio de sesión en NiCE CXone.
    2. client_secret_post: client credentials are passed in a body during authentication. After selecting this method, configure the following:
      1. Seleccione Autenticación del cliente como el Secreto de cliente.
      2. Copie la Id de cliente y el Secreto del cliente y péguelos en un lugar seguro de su dispositivo. Los necesitará al configurar un autenticador de inicio de sesión en NiCE CXone.
    3. client_secret_jwt: JWT bearer tokens are used for client authentication. After selecting this method, configure the following:
      1. Seleccione Autenticación del cliente como el Secreto de cliente.
      2. Copie la Id de cliente y el Secreto del cliente y péguelos en un lugar seguro de su dispositivo. Los necesitará al configurar un autenticador de inicio de sesión en NiCE CXone.
    4. private_key_jwt: JWT bearer tokens are used for client authentication. The JWT is signed by the Client Private Key that you will provide in later steps. After selecting this method, configure the following:
      1. Seleccione Autenticación de cliente como la clave pública/clave privada.
      2. Introduzca una clave pública de marcador en el campo Agregar clave pública. Deberá reemplazar el marcador con la clave proporcionada por NiCE CXone cuando configure su autenticador de inicio de sesión.
  12. En la pestaña Asignaciones, haga clic en Asignar y, después, haga clic en Asignar a Personas.
  13. Asigne usuarios a esta aplicación.

Configurar una Ubicación

Permisos requeridos: Crear Gestión de ubicación

Si desea exigir que los usuarios inicien sesión desde una Dirección IP determinada, cree una ubicación con las Direcciones IP, los rangos de direcciones IP o las subredes de direcciones IP que desea permitir. Cuando se requiere una ubicación configurada para un usuario, ese usuario debe tener tanto las credenciales como la Dirección IP correctas para iniciar sesión. De lo contrario, su intento de inicio de sesión falla y reciben un error. Puede tener hasta 20 ubicaciones a la vez y hasta 10 reglas por ubicación.

  1. Haga clic en el selector de aplicaciones icon of app selector y seleccioneAdmin.
  2. Vaya a Ubicaciones > Definiciones de ubicación.
  3. Haga clic en Nueva ubicación.
  4. Asigne un nombre descriptivo a la ubicación. Si desea agregar más detalles sobre la ubicación, ingrese una Descripción.
  5. Puede seleccionar Establecer como Ubicación predeterminada o Ubicación remota para indicar el tipo de Ubicación. Sólo puede tener una ubicación predeterminada. Estos campos no afectan actualmente a ninguna funcionalidad y su selección es para su propia referencia.

  6. Agregue cualquier otra información que desee utilizando los campos restantes, incluidos la dirección física, el país, las coordenadas GPS, la zona horaria o los grupos asignados. Estos campos actualmente no afectan a nada, y la información ingresada sería sólo para su propia referencia.

    Si agrega grupos al campo Grupos asignados los usuarios que pertenezcan a esos Grupos aparecerán en la pestaña Usuarios asignados. Sin embargo, la configuración de ubicación no se aplicará a ellos. Si asigna una ubicación a un autenticador de inicio de sesión, la ubicación se aplica a los Usuarios asignados a ese autenticador de inicio de sesión y restringe su capacidad para iniciar sesión en función de su Dirección IP. Sin embargo, esos usuarios no aparecerán en la pestaña usuarios asignados.

  7. Hacer clicGuardar.

  8. De vuelta en la página Definiciones de ubicación, haga clic en la Ubicación que acaba de crear para abrirla.

  9. Haga clic en la pestaña Reglas de detección automática.

  10. Cree una nueva regla. Para hacerlo:

    1. Haga clic en Nueva regla.

    2. Asigne un nombre descriptivo a la regla.

    3. Seleccione el Tipo de regla entre las siguientes opciones:

      • List: Lista de Direcciones IP específicas permitidas para esta ubicación. Por ejemplo, 100.0.1.100, 100.0.1.101, y 100.0.1.102.

      • Rango: Un rango de direcciones IP permitido para esta ubicación. Por ejemplo, 100.0.1.100-100.0.1.125.

      • Subred: Una subred permitida para esta ubicación. Por ejemplo, 100.0.0.1/32.

    4. Especifique la Versión IP como una de las siguientes:

      • IPV4: Una Dirección IP de 32 bits

      • IPV6: Una dirección hexadecimal de 128 bits.

    5. Introduzca las Direcciones IP reales, el rango o la subred en el campo Definición de regla, siguiendo los formatos de los ejemplos de los pasos anteriores. Si seleccionó Lista, puede ingresar hasta 100 Direcciones IP. Si seleccionó Rango o Subred, sólo puede ingresar un valor.

    6. Haga clic en Confirmar.

  11. Agregue más reglas según sea necesario. Puede tener hasta 10.

  12. Hacer clicGuardar.

Configurar un Autenticador de inicio de sesión con OpenID Connect en NiCE CXone

  1. Haga clic en el selector de aplicaciones icon of app selector y seleccioneAdmin

  2. Vaya a Parámetros de seguridad > Autenticador de inicio de sesión.

  3. Haga clic en Nuevo Autenticador de inicio de sesión o seleccione el autenticador de inicio de sesión que desea editar.
  4. Introduzca el nombre y una Descripción para el autenticador de inicio de sesión.
  5. Seleccione OIDC como Tipo de autenticación .

  6. Si desea exigir que los usuarios inicien sesión desde una Dirección IP determinada, seleccione la Ubicación que configuró en la sección anterior.

  7. Si tiene un terminal de descubrimiento de Okta, haga clic en Descubrir Configuración. Ingrese su punto final de descubrimiento y haga clic en Descubrir. Los campos restantes se completan automáticamente para usted. Descubrir Configuración no funciona con los puntos de conexión de descubrimiento de Salesforce.
  8. Entre su Identificador de cliente y Contraseña del cliente. Vuelva a escribir la contraseña en Client Confirm Password. El Identificador de cliente es la Id de inicio de sesión que Okta asignó a su cuenta.

  9. Si no tiene un terminal de descubrimiento de su Okta, ingrese los siguientes datos proporcionados por su Okta: Emisor, Terminal jsonwebkeyset, Terminal de autorización ,terminal de token ,Terminal de información de usuario y Terminal de revocación.

    Campo

    Detalles
    Emisor

    URL de Okta sin ningún parámetro.
    Terminal jsonwebkeyset La URL del Conjunto de JWK de Okta.
    Terminal de autorización La URL del Terminal de autorización 2.0 Okta de OAuth.
    Terminal de señal La URL del Terminal de token 2.0 Okta de OAuth.
    Terminal de información de usuario La URL del Terminal de información de usuario de Okta.
    Terminal de revocación La URL del Terminal de revocación de Okta.
  10. Seleccione un Método de autenticación del cliente. El método que seleccione debe coincidir con lo que había configurado en la tarea anterior. Okta debe admitir este método de autenticación. Si selecciona private_key_jwt, debe ingresar su Client Private Key.
  11. Puede seleccionar Habilitar Perfil FICAM para activar la configuración específica del gobierno de los Estados Unidos. Este paso es solo para usuarios de FedRAMP.

  12. Seleccione la pestaña Usuarios asignados. Seleccione los usuarios que desea asignar al autenticador de inicio de sesión que está creando. También puede asignar usuarios directamente al autenticador de inicio de sesión en su perfil del empleado.

  13. Haga clic en Guardar y Activar para validar la información proporcionada y vincular su cuenta de NiCE CXone con su cuenta de Okta.
  14. Abra el autenticador de inicio de sesión.

  15. Tome nota de la URI de redireccionamiento de inicio de sesión y la URI de redireccionamiento de cierre de sesión. Necesitará esos datos para actualizar su configuración de Okta.

  16. Actualice la configuración de Okta, reemplazando los marcadores de posición utilizados en la tarea anterior con los valores que acaba de anotar.

  17. Verifique que la NiCE CXoneIdentidad externa de para cada usuario que utiliza el autenticador de inicio de sesión tenga definido el valor correcto. Este campo se puede acceder en el sección de seguridad del perfil del empleado.

    Okta determina el valor que se debe utilizar. Se puede encontrar en el perfil del usuario en Okta. El valor debe coincidir exactamente con lo que puso en el campo Identidad externa en NiCE CXone. El valor de este campo debe tener este formato: claim(email):{correo electrónico configurado por su IdP}. Por ejemplo, si el correo electrónico del usuario en el IdP es nick.carraway@classics.com, debe escribir claim(email):nickcarraway@classics.com.

  18. Haga que el usuario inicie sesión en NiCE CXone. Deben usar la URL de inicio de sesión más reciente. Después de ingresar su nombre de usuario, serán dirigidos a Okta si es necesario.

  19. Cuando Okta le solicite que autentique su propia cuenta, hágalo como el usuario que desea asociar con su cuenta de NiCE CXone que tiene una sesión activa en este momento.
  20. Si la configuración de OpenID Connect en NiCE CXone no se muestra como validada, use los registros de Okta para diagnosticar el problema.

Agregue NiCE CXone valores a Okta

  1. Regrese a su aplicación Okta y vaya a la Pestaña general.
  2. Haga clic en Editar en la ventana Configuración de SAML, luego haga clic en Siguiente.
  3. Para URL de inicio de sesión único, introduzca el URL de ACS valor de su NiCE CXone autenticador de inicio de sesión.
  4. Para URI de audiencia (ID de Entidad de SP), introduzca la identificación de la Entidad valor de su NiCE CXone autenticador de inicio de sesión.
  5. Haga clic en próximo, luego haga clic en Finalizar para completar el cambio.

Verificar el acceso de usuario con inicio de sesión único de Okta

  1. Asegúrese de que el Identidad externa de cada empleado que use el autenticador de inicio de sesión esté configurado con el valor correcto. El valor debe coincidir exactamente con Identidad externa en NiCE CXone. El campo Identidad externa distingue entre mayúsculas y minúsculas.

  2. Haga que uno o más usuarios de prueba inicien sesión utilizando la URL de inicio de sesión más reciente, https://cxone.niceincontact.com. Para FedRAMP, utilice https://cxone-gov.niceincontact.com. Después de ingresar su nombre de usuario, serán dirigidos a Okta si es necesario.

  3. Cuando esté listo, implemente el inicio de sesión único de Okta para todos los empleados.