Configurar los ajustes de autenticación

Artículo
08/28/2024

La Plataforma omnicanal para Customer Service ofrece un conjunto de funciones que extienden la potencia de Dynamics 365 Customer Service Enterprise con el que las organizaciones pueden conectarse e interactuar de forma instantánea con sus clientes en distintos canales de mensajería digital. Se necesitan una licencia adicional para acceder a la Plataforma omnicanal para Customer Service. Para más información, consulte las páginas Descripción general de precios de Dynamics 365 Customer Service y Plan de precios de Dynamics 365 Customer Service.

Nota

La información sobre la disponibilidad de funciones es la siguiente.

Dynamics 365 Contact Center - insertado	Dynamics 365 Contact Center—independiente	Dynamics 365 Customer Service
Sí	Sí	Sí

Puede crear configuraciones de autenticación para validar a un cliente que inició sesión desde un dominio y extraer información en función de las variables de contexto definidas. Puede distinguir a los clientes anónimos de clientes autenticados, y puede crear reglas en función de las variables de contexto.

Por ejemplo, se pueden separar colas independientes para los clientes anónimos y clientes autenticados. Puesto que tiene más información sobre los clientes autenticados, también puede concederles prioridad en función de variables específicas, como valor de carro de la compra o un estado de privilegio.

Después de crear un registro de configuración de autenticación, debe agregarlo a una instancia de canal dentro de la configuración del canal de una secuencia de trabajo para que funcione. La autenticación es compatible con estos canales:

Charlar
Apple Messages for Business

Para indicar si un cliente está autenticado, el agente recibe una notificación en la sección Resumen de la conversación . El campo Autenticado se establece en Sí o No según el estado de autenticación del cliente. Obtenga más información en Resumen de la conversación

Requisitos previos

Asegúrese de que su organización tenga un conocimiento práctico de OAuth 2.0 y JSON Web Tokens (JWT).
Verificar que tiene permisos en las columnas seguras. Obtenga más información en Configurar permisos para acceder a columnas seguras

Crear un registro de la configuración de autenticación de chat

Puede crear un registro de configuración de autenticación de chat en la aplicación de administrador.

En el mapa del sitio del centro de administración de Customer Service, seleccione Configuración del cliente y seleccione Asistencia al cliente. Aparece la página Configuración de cliente.
En la sección Configuración de autenticación, sleccione Administrar. Aparece la página Configuración de autenticación.
Seleccionar Nueva configuración de autenticación y luego proporcione la siguiente información en la página Agregar configuración de autenticación :
- Nombre: escriba un nombre para la configuración de la autenticación.
- Propietario: Acepte el valor predeterminado o cámbielo por un valor requerido.
- Tipo de autenticación: De forma predeterminada, el flujo implícito de OAuth 2.0 no se puede editar.
- Dirección URL de clave pública: especifique la dirección URL de clave pública del dominio. Esta URL se utiliza para validar la información que proviene del token web de notación de objetos JavaScript (JSON) (JWT) del dominio en el que inició sesión un cliente.
- Función de cliente de JavaScript: especifique la función de cliente de JavaScript para usar en la autenticación. Esta función extrae un token del extremo de token.
Obtenga más información sobre cómo encontrar la URL de la clave pública y la función de cliente de JavaScript en las secciones Configuración para Power Apps portales o Configuración para portales personalizados más adelante en este artículo.
Seleccione Guardar.

Crear un registro de configuración autenticación para chat usando OAuth 2.0

Realice los pasos 1 a 3 en Crear un registro de configuración de autenticación para el chat e ingrese los siguientes detalles en la página Agregar configuración de autenticación :
- Nombre: un nombre para la configuración de la autenticación.
- Tipo de canal: Chat en directo.
- Tipo de autenticación: flujo implícito OAuth 2.0
Seleccione Siguiente y en la página Detalles, introduzca la información siguiente:
- Acción personalizada de token: la referencia del código personalizado para validar los tokens proporcionados por su proveedor de identidad y devolver el ID de usuario del usuario autenticado.
- URL del token: la URL utilizada para intercambiar su código de autorización por el token pasado a su acción personalizada para adquirir el ID de usuario.
- URL de redireccionamiento: la URL pasada a la solicitud del código de autorización original, que es un parámetro obligatorio en las llamadas al intercambio de tokens punto de conexión.
- ID de cliente: el ID del cliente pasado al intercambio de tokens punto de conexión.
- Secreto del cliente: el secreto que autentica al cliente pasado al intercambio de tokens punto de conexión.
- Ámbito: los ámbitos para los cuales el usuario está autorizado por el token adquirido en el flujo.
Guarde los cambios.

En widget de chat, edite widget de chat en la configuración del flujo de trabajo y luego vaya a la pestaña Comportamientos .
En el cuadro Configuración de autenticación, busque y seleccione el registro de autenticación de chat.

Cuando un cliente registrado en un portal abre el widget de chat, la función de cliente de JavaScript pasa el JWT del cliente al servidor. El JWT se descifra y valida utilizando la clave pública, y luego la información se pasa al agente de chat en Plataforma omnicanal para Customer Service. Como administrador, también puede pasar información adicional sobre el cliente registrado en JWT definiendo variables personalizadas de contexto. Las variables de contexto deben definirse exactamente como están en el flujo de trabajo asociado con Omnicanal. Obtenga más información en Administrar variables de contexto

Configuración para portales de Power Apps

Si agrega autenticación para un widget de chat en un sitio web desarrollado utilizando portales, entonces la URL de clave pública y la función de cliente JavaScript estarán disponibles de inmediato. Power Apps Debes cargar un certificado personalizado para tener una URL de clave pública válida en los portales. Power Apps

Dirección URL de clave pública: <portal_base_URL>/_services/auth/publickey
Función de cliente JavaScript: auth.getAuthenticationToken

El portal intenta agregar automáticamente un registro de contacto a la conversación a través del contexto pasado en su función cliente JavaScript. Power Apps

Configuración para portales personalizados

Si agrega una experiencia de chat autenticada a un sitio web personalizado que no está desarrollado utilizando portales, su equipo de desarrollo web debe realizar los siguientes pasos antes de que su Administrador pueda configurar el chat autenticado: Power Apps

Genere un par de claves pública/privada en sus servidores de autenticación. Las claves deben generarse mediante el algoritmo RSA256.

El siguiente código de muestra es para generar pares de claves privadas o públicas.
```
openssl genpkey -algorithm RSA -out private_key.pem -pkeyopt rsa_keygen_bits:2048
openssl rsa -pubout -in private_key.pem -out public_key.pem
```

Crea un punto de conexión que devuelva tus claves públicas. Los servidores Omnicanal utilizan las claves públicas para validar el token JWT pasado como parte de la autorización de la solicitud de chat. Ingresa la URL de este punto de conexión en la aplicación de administración al crear un registro de configuración de autenticación.

Su clave pública punto de conexión se parece a este ejemplo:

Si necesita utilizar varias claves públicas, el extremo de su clave pública puede devolver un conjunto de pares <kid, publickey>, donde kid hace referencia al Id. de clave. Los pares de ID de clave deben ser únicos. Es necesario pasarle al niño el token JWT en paso 4. Si utiliza varias claves, su clave pública punto de conexión debería devolver algo parecido al siguiente ejemplo. La clave pública está codificada en base64.

 [
      { 
          "kid": "qWO4EaKT1xRO7JC/oqALz6DCVr41B/qL0Hqp4in7hu4=",
          "publicKey": LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0NCk1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBbjFLdXhtSEh3V3hjelZSWGRBVmMNCnBEaFZwa0FnYklhTGZBUWc1bFpvemZqc29vcWRGWkl0VlFMdmRERWFVeDNqTytrTkxZM0JFRnBYVDZTN3ZNZCsNCnZoM2hpMDNsQ1dINnNCTWtaSWtuUUliMnFpekFsT0diU2EvK3JrUElnYnpXQjRpT1QyWVhyOVB4bXR5d2o4WUINCnYram55VU5DSzMyZy9FYWsvM0k3YW1vZ2pJY0JISjNFTjVuQWJBMExVVnJwMW5DODJmeEVPOHNJTzNYdjlWNVUNCnc5QnVTVVFRSmtMejNQYVI5WTdRZUEyNW5LUGtqTXZ2Y0UxVU5oeVpIYlNLbmorSitkZmFjb1hsSGtyMEdGTXYNCldkSDZqR0pWcGNQMHBkNjFOa3JKa2c0aStheThwS2ZqdjNUOHN3NWdaVHFweFFaaitVRWxqaVM0SHRPTlhkNlENCnZRSURBUUFCDQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0NCg==",
          "expiry": 1608495423
      },
 {
          "kid": "qWO4EaKT1xRO7JC/oqALz6DCVr41B/qL0Hqp__valid=",
          "publicKey": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0NCk1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBbjFLdXhtSEh3V3hjelZSWGRBVmMNCnBEaFZwa0FnYklhTGZBUWc1bFpvemZqc29vcWRGWkl0VlFMdmRERWFVeDNqTytrTkxZM0JFRnBYVDZTN3ZNZCsNCnZoM2hpMDNsQ1dINnNCTWtaSWtuUUliMnFpekFsT0diU2EvK3JrUElnYnpXQjRpT1QyWVhyOVB4bXR5d2o4WUINCnYram55VU5DSzMyZy9FYWsvM0k3YW1vZ2pJY0JISjNFTjVuQWJBMExVVnJwMW5DODJmeEVPOHNJTzNYdjlWNVUNCnc5QnVTVVFRSmtMejNQYVI5WTdRZUEyNW5LUGtqTXZ2Y0UxVU5oeVpIYlNLbmorSitkZmFjb1hsSGtyMEdGTXYNCldkSDZqR0pWcGNQMHBkNjFOa3JKa2c0aStheThwS2ZqdjNUOHN3NWdaVHFweFFaaitVRWxqaVM0SHRPTlhkNlENCnZRSURBUUFCDQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0NCg==",
          "expiry": 1608495423
      } 
 ]

Necesita un servicio que genere el JWT para enviar a los servidores de vincular como parte del inicio de un chat para un usuario autenticado.

a. El encabezado JWT se parece al siguiente ejemplo.

{ 
  "alg": "RS256", 
  "typ": "JWT", 
}

Si utiliza varias claves públicas, deberá pasar el ID de la clave (kid). Su encabezado se parece al siguiente ejemplo:

{ 
  "alg": "RS256", 
  "typ": "JWT",
  "kid": "qWO4EaKT1xRO7JC/oqALz6DCVr41B/qL0Hqp4in7hu4="
}

b. La carga útil de JWT debe incluir:

Como mínimo, las siguientes afirmaciones:

Reclamación	Definición
iss	Emiror del token.
iat	La fecha en que se emitió el token, en formato de fecha numérico.
exp	La fecha de expiración del token, en formato de fecha numérico.
sub	Asunto de la notificación. NOTA: Le recomendamos que pase el GUID del registro de contacto o cuenta en servicio al cliente para el usuario que inició sesión. Este GUID se utiliza para identificar y vincular el registro de contacto de la conversación. La búsqueda de registros identifica registros que tienen el código de estado activo para contactos o cuentas. La identificación de registros no funciona si utiliza códigos de estado personalizados.

lwicontexts: las variables de contexto para pasar como parte de la conversación, ya sea con fines de enrutamiento o para mostrar al agente.
Obtenga más información en
Administrar contexto personalizado
método setAuthTokenProvider
Identificar registros automáticamente mediante el uso de variables de contexto
Cualquier otro dato que desee pasar.

Su carga útil debería verse similar al siguiente ejemplo:

  { 
      "sub" : "87b4d06c-abc2-e811-a9b0-000d3a10e09e",  
      "lwicontexts" :"{\"msdyn_cartvalue\":\"10000\", \"msdyn_isvip\":\"false\", \"portalcontactid\":\"87b4d06c-abc2-e811-a9b0-000d3a10e09e\"}", 
      "iat" : 1542622071, 
      "iss" : "contosohelp.com", 
      "exp" : 1542625672, 
      "nbf" : 1542622072 
  }

c. La firma JWT debe estar firmada por su clave privada.

Nota

Si el token ha expirado o no es válido, widget de chat genera un evento de error.
El método setContextProvider no es compatible con el chat autenticado. Debe pasar sus lwicontexts como parte de la carga útil de JWT.

Cree una función de JavaScript en su sitio web que acepte una función de devolución de llamada y devuelva un JWT a la función de devolución de llamada. Para evitar el tiempo de espera, esta función de JavaScript debe devolver un JWT en 10 segundos. Este JWT debe cumplir los siguientes criterios:
- Debe contener el encabezado, la carga útil y la firma de paso 3.
- Debe estar firmado con la clave privada del par de claves en paso 1.
  
  Recomendamos generar su JWT en su servidor web.
  
  El nombre de este método de JavaScript se utiliza para crear el registro de configuración de autenticación en la aplicación de administración servicio al cliente.
```
// This is a sample JavaScript client function  

auth.getAuthenticationToken = function(callback){ 

  var xhttp = new XMLHttpRequest(); 
  xhttp.onreadystatechange = function() { 
      if (this.readyState == 4 && this.status == 200) { 
          callback(xhttp.responseText); 
      } 
  }; 
  xhttp.onerror = function(error) { 
      callback(null); 
  }; 
//Replace this with a call to your token generating service 
  xhttp.open("GET", "https://contosohelp.com/token", true); 
  xhttp.send(); 
} 
```
Su desarrollador debe Compartir la siguiente información con su Omnicanal Administrador:

a. La URL del servicio de clave pública del paso 2.

Ejemplo: https://www.contoso.com/auth/publickey

b. El nombre de la función de cliente JavaScript del paso 4. El widget de chat en vivo llama a este nombre internamente durante el inicio de un chat.

Ejemplo: auth.getAuthenticationToken

Nota

Si su experiencia de usuario expone el botón de chat antes de que los usuarios se autentiquen, asegúrese de redirigirlos a su página de autenticación según sea necesario. Puede configurar la redirección en el método en paso 4, o como un paso anterior en su flujo de usuario.

La siguiente ilustración muestra la configuración.

Luego, puede configurar un chat autenticado siguiendo estos pasos:

Configuración de chat autenticado

Vaya a la aplicación de administración y cree un registro de configuración de autenticación con la información de paso 5 de la sección anterior. Obtenga más información en Crear un registro de configuración de autenticación para el chat
Asocie la configuración de autenticación al widget de chat que tiene una experiencia autenticada. Obtenga más información en Agregue autenticación a widget de chat

En la siguiente ilustración se demuestra la secuencia de llamadas cuando un usuario accede a su chat en una configuración autenticada.

Crear la configuración de autenticación para Apple Messages for Business

Requisitos previos

Los administradores que configuran los ajustes de autenticación necesitan más permisos de seguridad. Obtenga más información en Configurar permisos de seguridad para un campo
Asegúrese de que su organización tenga un conocimiento práctico del flujo OpenID Conectar de OAuth 2.0. Los pasos se describen en la siguiente sección.
Confirme que su organización tiene al menos un Mensaje enriquecido de tipo de autenticación Apple Messages for Business. Esta rica configuración de mensajes es necesaria para la configuración.

Cree un registro de configuración de autenticación para Apple Messages for Business usando el flujo de conexión OAuth 2.0 OpenID

En el mapa del sitio de Centro de administración de Customer Service, seleccione Configuración del cliente y, a continuación, seleccione Administrar para configuración de autenticación. Aparecerá una lista de configuraciones de autenticación existentes.
Seleccione Nueva configuración de autenticación y, en la página Agregar configuración de autenticación, proporcione los siguientes detalles:
1. En la página Tipo de canal , ingrese un nombre y luego Seleccionar Apple Messages for Business como tipo de canal.
2. Cambie el tipo de autenticación flujo de conexión OAuth 2.0 OpenID.
3. En la página Agregar configuración de autenticación, proporcione la información siguiente:
  - Id. del cliente: id. de cliente OAuth 2.0 emitido por un servidor de autorización.
  - Secreto del cliente: secreto de cliente utilizado para autenticar las solicitudes enviadas a un servidor de autorización.
  - Alcance: cada alcance agregado especifica qué datos de usuario solicitó al cliente. El contenido del alcance debe coincidir exactamente con los disponibles a través de su proveedor de servicios.
  - Token de acceso URL: el punto de conexión del proveedor de servicios donde se puede solicitar un token de acceso.
  - URL del token descifrado: punto de conexión donde la API de OAuth 2.0 puede recuperar la información del cliente solicitada en el ámbito.
  - Parámetros adicionales: permite que los servicios de autenticación tomen parámetros adicionales de la solicitud.
4. En la página Detalles adicionales, puede definir opcionalmente un tiempo de caducidad token de acceso, en segundos. El tiempo de caducidad predeterminado es de una hora.
  Después del tiempo especificado, el campo Autenticado en la sección Resumen del cliente de una conversación previamente autenticada cambia a No.
5. En la página Mensajes enriquecidos , Seleccionar Agregue y luego Seleccionar uno o más mensajes enriquecidos para asociar con esta configuración de autenticación.
6. Revise la página Resumen y luego seleccione Siguiente. Se configura el ajuste de autenticación.
7. En la página Información de redirección, copie la URL. Agrega esta URL al sitio web del proveedor de servicios de autenticación en las URL de devolución de llamada permitidas.
8. Seleccione Finalizar.

Agregar la autenticación a un canal de Apple Messages for Business

Abra el flujo de trabajo que contiene la instancia del canal para la cual desea agregar autenticación.
En la página Comportamientos de la configuración del canal, navegue a Configuración de autenticación, habilite la capacidad y luego Seleccionar la configuración correcta en el menú desplegable. Obtenga más información en Configurar un Apple Messages for Business canal
Para revisar o actualizar la configuración de autenticación para cada instancia de canal, Seleccionar Editar.

Agregar un widget de chat
Configurar una encuesta previa a la conversación
Crear respuestas rápidas
Crear y administrar las horas operativas
Insertar un widget de chat en portales de Power Apps
Identificar automáticamente a clientes

Compartir a través de

Configurar los ajustes de autenticación

Requisitos previos

Crear un registro de la configuración de autenticación de chat

Crear un registro de configuración autenticación para chat usando OAuth 2.0

Agregar la autenticación al widget de chat

Configuración para portales de Power Apps

Configuración para portales personalizados

Configuración de chat autenticado

Crear la configuración de autenticación para Apple Messages for Business

Requisitos previos

Cree un registro de configuración de autenticación para Apple Messages for Business usando el flujo de conexión OAuth 2.0 OpenID

Agregar la autenticación a un canal de Apple Messages for Business

Comentarios

Recursos adicionales

Compartir a través de

Configurar los ajustes de autenticación

Requisitos previos

Crear un registro de la configuración de autenticación de chat

Crear un registro de configuración autenticación para chat usando OAuth 2.0

Agregar la autenticación al widget de chat

Configuración para portales de Power Apps

Configuración para portales personalizados

Configuración de chat autenticado

Crear la configuración de autenticación para Apple Messages for Business

Requisitos previos

Cree un registro de configuración de autenticación para Apple Messages for Business usando el flujo de conexión OAuth 2.0 OpenID

Agregar la autenticación a un canal de Apple Messages for Business

Información relacionada

Comentarios

Recursos adicionales