Creare il canale Oracle iOS

È possibile configurare il canale per la connessione al server di chat Oracle 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 il widget client è già protetto 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 iOS. 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 rappresenti i secondi trascorsi dall'epoca UNIX. exp deve essere un numero che rappresenti 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 iOS

Per configurare il canale Oracle iOS, 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 iOS 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.
      • Impostare l'ora di scadenza della sessione.
    • 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. Tienili a portata di mano perché ne avrai bisogno durante la configurazione della pagina HTML per ospitare il widget di chat.
  5. Instrada il canale allo skill o all'assistente digitale.
  6. Attivare Canale abilitato.