Documentación de Oracle Cloud Infrastructure

Creación del canal iOS de Oracle

Puede configurar el canal para conectarse al servidor de chat de Oracle en dos modos: modo no autenticado y modo autenticado (para proteger el acceso al canal).

  • Modo no autenticado: utilice el modo no autenticado cuando el cliente no pueda generar tokens de JWT firmados, cuando no se aplique ningún mecanismo de autenticación o cuando el widget de cliente ya esté protegido y visible para los usuarios autenticados.
  • Modo autenticado: la autenticación se aplica mediante tokens web de JSON (JWT). El servidor backend del cliente genera el token JWT, que se transfiere a continuación al SDK de iOS de Oracle. Este token se utiliza para cada solicitud a un servidor de voz, texto o anexos de ODA.
    Nota

    Para proteger el acceso al canal, el token siempre lo debe generar siempre un servidor remoto. Nunca se debe generar en la aplicación de cliente.
    Cuando la aplicación necesita conectarse a un servidor ODA, primero solicita el token del servidor backend y, a continuación, lo agrega a la cabecera de autorización. El servidor ODA valida el token, evalúa las reclamaciones y, a continuación, abre el socket o rechaza la conexión.
    El token de JWT tiene las siguientes reclamaciones: channelId y userId, y los nombres de reclamación iat (emitido a la vez), y exp (hora de caducidad). iat indica la hora a la que se emitió el token. Debe ser un número que represente los segundos que han transcurrido desde la época de UNIX. exp debe ser un número que represente los segundos que han transcurrido desde la época de UNIX. Se recomienda definir el tiempo de caducidad en al menos 30 minutos después de la hora de envío (iat). La cabecera del token tiene un aspecto similar al siguiente:
    {

 "alg": "HS256",

 "typ": "JWT"

}
    Un ejemplo de cuerpo de token tiene un aspecto similar al siguiente:
    {

  "iat": 1569828182,

  "exp": 1569831782,

  "channelId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",

  "userId": "John"

}
    Nota

    El token que se muestra en este ejemplo no está firmado. Los tokens reales están firmados por la clave secreta del canal.

Configuración del canal iOS de Oracle

Para configurar el canal iOS de Oracle:
  1. Seleccione Desarrollo y, a continuación, Canales en el menú.
  2. Seleccione Usuarios.
  3. Haga clic en Agregar canal y, a continuación, en Oracle iOS como tipo de canal.
  4. Complete el cuadro de diálogo:
    • Introduzca el nombre del canal.
    • Para conexiones autenticadas:
      • Active el conmutador Autenticación de cliente activada para determinar si el SDK se conecta a un canal con la autenticación de cliente activada.
      • En el campo Caducidad máxima de token (minutos), defina la cantidad máxima de tiempo para el token de JWT.
      • Defina la hora de caducidad de la sesión.
    • Para conexiones no autenticadas:
      • Desactive el conmutador Activación de la autenticación del cliente.
      • Defina la hora de caducidad de la sesión.
    • Haga clic en Crear. Oracle Digital Assistant generará el ID de canal y la clave secreta necesarios para inicializar el SDK. Manténgalos a mano porque los necesitará al configurar la página HTML para alojar el widget de chat.
  5. Enruta el canal a su aptitud o asistente digital.
  6. Active Canal activado.