Documentation sur Oracle Cloud Infrastructure

Créer le canal Oracle Android

Vous pouvez configurer le canal Android pour la connexion au serveur de clavardage Oracle dans deux modes : non authentifié et authentifié (pour protéger l'accès au canal).

  • Mode non authentifié : Utilisez ce mode lorsque le client ne peut pas générer des jetons JWT signés, lorsqu'aucun mécanisme d'authentification n'est en place ou lorsque l'application client est déjà sécurisée et visible pour les utilisateurs authentifiés.
  • Mode authentifié : L'authentification est effectuée à l'aide de jetons Web JSON (JWT). Le serveur dorsal du client génère le jeton JWT, qui est ensuite transmis à la trousse SDK Oracle Android. Ce jeton est utilisé pour chaque demande à un serveur vocal, de texte ou de fichiers joints ODA.
    Note

    Pour protéger l'accès au canal, le jeton doit toujours être généré par un serveur distant. Il ne doit jamais être généré au sein de l'application client.
    Lorsque l'application doit se connecter à un serveur ODA, elle demande d'abord le jeton du serveur dorsal, puis l'ajoute à l'en-tête Authorization (Autorisation). Le serveur ODA valide le jeton, évalue les revendications, puis ouvre le connecteur logiciel ou rejette la connexion.
Le jeton JWT contient les revendications suivantes : channelId et userId, avec les noms de revendication iat (heure d'émission) et exp (heure d'expiration). iat indique l'heure à laquelle le jeton a été émis. Sa valeur doit être un nombre représentant les secondes écoulées depuis l'heure initiale UNIX (epoch). exp doit être un nombre représentant les secondes écoulées depuis l'heure initiale UNIX. Nous recommandons de régler le délai d'expiration à au moins 30 minutes après l'heure d'émission (iat). L'en-tête de jeton ressemble à ce qui suit :
{

 "alg": "HS256",

 "typ": "JWT"

}
Voici un exemple de corps de jeton :
{

  "iat": 1569828182,

  "exp": 1569831782,

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

  "userId": "John"

}
Note

Le jeton illustré par cet exemple n'est pas signé. Les jetons réels sont signés par la clé secrète du canal.

Configurer le canal Oracle Android

Pour configurer le canal Oracle Android :
  1. Sélectionnez Development (Développement), puis Channels (Canaux) dans le menu.
  2. Sélectionner des utilisateurs.
  3. Cliquez sur Add Channel (Ajouter un canal), puis sélectionnez Oracle Android comme type de canal.
  4. Complétez la boîte de dialogue :
    • Entrez le nom du canal.
    • Pour les connexions authentiques :
      • Activez l'option Client Authentication Enabled (Authentification de client activée) pour déterminer si la trousse SDK se connecte au canal prenant en charge l'authentification de client.
      • Dans le champ Max. Token Expiration (Minutes) (Expiration du jeton max. (minutes)), définissez la durée maximale du jeton JWT.
    • Pour les connexions non authentifiées :
      • Désactivez l'option Client Authentication Enable (Authentification de client activée).
    • Définissez le délai d'expiration de la session.
    • Cliquez sur Create (Créer). Oracle Digital Assistant génère l'ID canal et la clé secrète dont vous avez besoin pour initialiser la trousse SDK. Gardez ces informations à portée de main.
  5. Acheminez le canal vers votre compétence ou votre assistant numérique.
  6. Sélectionnez Channel Enabled (Canal activé).