Documentación de Oracle Cloud Infrastructure

Creación del canal Android de Oracle

Puede configurar el canal de Android para conectarse al servidor de chat de Oracle de 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 encuentra en vigor ningún mecanismo de autenticación o cuando la aplicación cliente ya está protegida 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 al SDK de Android 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 transcurridos desde la época de UNIX. exp debe ser un número que represente los segundos transcurridos 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 Android de Oracle

Para configurar el canal Android 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 Android 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.
    • 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 cerca.
  5. Enruta el canal a su aptitud o asistente digital.
  6. Active Canal activado.