Crea il canale Oracle Android

È possibile configurare il canale Android per connettersi a Oracle Chat Server in due modalità: modalità non autenticata e modalità autenticata (per proteggere l'accesso al canale).

  • Modalità non autenticata: utilizzare la modalità non autenticata quando il client non è in grado di generare token JWT firmati, quando non è presente alcun meccanismo di autenticazione o quando l'applicazione client è già protetta e visibile agli utenti autenticati.
  • Modalità autenticata: l'autenticazione viene applicata utilizzando i token Web JSON (JWT). Il server backend del cliente genera il token JWT, che viene quindi passato all'SDK Oracle Andriod. Questo token viene utilizzato per ogni richiesta a un server di sintesi vocale, di testo o di allegati ODA.
    Nota

    Per proteggere l'accesso al canale, il token deve essere sempre generato da un server remoto. Non deve mai essere generato dall'applicazione client.
    Quando l'applicazione deve connettersi a un server ODA, in primo luogo richiede il token dal server backend e quindi lo aggiunge all'intestazione di autorizzazione. Il server ODA convalida il token, valuta le richieste e quindi apre il socket o rifiuta la connessione.
Il token JWT ha le seguenti richieste: channelId e userId, i nomi delle richieste iat (emesse in tempo) e exp (ora di scadenza). iat indica l'ora di emissione del token. Deve essere un numero che rappresenta i secondi trascorsi dall'epoca UNIX. exp deve essere un numero che rappresenta i secondi trascorsi dall'epoca UNIX. Si consiglia di impostare l'ora di scadenza ad almeno 30 minuti dopo l'emissione (iat). L'intestazione del token ha un aspetto simile al seguente:
{

 "alg": "HS256",

 "typ": "JWT"

}
Un corpo token di esempio ha un aspetto simile al seguente:
{

  "iat": 1569828182,

  "exp": 1569831782,

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

  "userId": "John"

}
Nota

Il token illustrato in questo esempio non è firmato. I token effettivi sono firmati dalla chiave segreta del canale.

Configurare il canale Oracle Android

Per configurare il canale Oracle Android, eseguire le operazioni riportate di seguito.
  1. Scegliere Sviluppo, quindi Canali dal menu.
  2. Scegliere Utenti.
  3. Fare clic su Aggiungi canale, quindi su Oracle Android come tipo di canale.
  4. Completare la finestra di dialogo:
    • Immettere il nome del canale.
    • Per le connessioni autenticate:
      • Attivare l'opzione Autenticazione client abilitata per determinare se l'SDK si sta connettendo a un canale abilitato all'autenticazione del client.
      • Nel Max. Campo Scadenza token (minuti), impostare la quantità massima di tempo per il token JWT.
    • Per le connessioni non autenticate:
      • Disattivare l'opzione Abilitazione autenticazione client.
    • Impostare l'ora di scadenza della sessione.
    • Fare clic su Crea. Oracle Digital Assistant genererà l'ID canale e la chiave segreta necessari per inizializzare l'SDK. Teneteli a portata di mano.
  5. Instrada il canale allo skill o all'assistente digitale.
  6. Attivare Canale abilitato.