• Un canal Oracle Web. La création du canal génère la clé secrète et l'ID de canal dont vous avez besoin pour initialiser l'application de discussion.
• L'URL du serveur de discussion Oracle.
• Le kit SDK Oracle Web (situé sous le kit SDK client natif Oracle pour les environnements natifs OCI) à partir de la page de téléchargement ODA et OMC d'Oracle Technology Network. Téléchargez ce fichier ZIP et extrayez-le vers votre système local. Ce fichier ZIP inclut un guide utilisateur qui décrit les classes du kit SDK et un exemple d'application illustrant un grand nombre de ses fonctionnalités.

• L'authentification est appliquée à l'aide de jetons Web JSON (JWT). Le serveur back-end du client génère le jeton JWT, qui est ensuite transmis au kit SDK Oracle Web. Ce jeton est utilisé pour chaque demande adressée à un serveur vocal, de texte ou de pièce jointe ODA.

  Remarque
  
  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é dans le navigateur client.

  Lorsque l'application Web doit se connecter à un serveur ODA, elle demande d'abord le jeton du serveur back-end, puis l'ajoute à l'en-tête d'autorisation. Le serveur ODA valide le jeton, évalue les déclarations, puis ouvre le socket ou rejette la connexion.

  Conseil :

  Cet article vous guide tout au long de l'exécution du kit SDK avec un canal authentifié.
• Mode non authentifié : utilisez le mode non authentifié lorsque le client ne peut pas générer de jetons JWT signés, lorsqu'aucune méthode d'authentification n'est configurée, ou lorsque le widget client est déjà sécurisé et visible par les utilisateurs authentifiés.

1. Choisissez Développement, puis Canaux dans le menu.
2. Choisissez Utilisateurs.
3. Cliquez sur Ajouter un canal, puis sur Oracle Web en tant que type de canal.
4. Renseignez les champs de la boîte de dialogue suivante :
   • Saisissez le nom du canal.
   • Pour les connexions authentifiées, procédez comme suit :
     • Activez l'option Authentification client activée afin de déterminer si le kit SDK se connecte à un canal activé pour l'authentification client.
     • Le canal communique uniquement avec les sites des domaines que vous ajoutez dans une liste en les séparant par une virgule. Par exemple, *.corp.example.com, *.hdr.example.com. La saisie d'un seul astérisque (*) permet un accès illimité au canal à partir de n'importe quel domaine. Généralement, l'astérisque est employé lors du développement uniquement. Pour la production, vous devez ajouter une liste d'autorisation des domaines.
     • Dans le champ Expiration de jeton max. (minutes), définissez le délai maximal pour le jeton JWT.
   • Pour les connexions non authentifiées, procédez comme suit :
     • Désactivez l'option Authentification client activée.
     • Entrez la liste des domaines pouvant accéder au canal en les séparant par une virgule. Si les domaines de cette liste d'autorisation incluent des astérisques (*.hdr.example.com) ou que la liste d'autorisation n'est pas complètement connue, vous pouvez envisager une connexion authentifiée.
   • Définissez le délai d'expiration de la session.
   • Cliquez sur Créer. Oracle Digital Assistant génère l'ID de canal et la clé secrète dont vous avez besoin pour initialiser le kit SDK. Conservez ces informations car vous en aurez besoin lors de la configuration de la page HTML pour héberger le widget de discussion.
5. Acheminez le canal vers votre brique ou votre assistant numérique.
6. Activez l'option Canal activé.

1. Dans le fichier ZIP extrait du kit SDK Oracle Web téléchargé en local, localisez le fichier web-sdk.js (situé dans le répertoire native-client-sdk-js).
2. Enregistrez le fichier web-sdk.js (situé dans le répertoire native-client-sdk-js du fichier ZIP extrait) dans votre répertoire de projet. Notez l'emplacement du fichier car vous en aurez besoin pour définir la propriété <WebSDK URL> dans le code de la balise <script>.
3. Créez un fichier JavaScript avec la fonction suivante qui initialise le kit SDK. Nous appelons ce fichier settings.js dans l'exemple fourni avec le kit SDK.

   // settings.js
   const chatSettings =
   { 	URI: '<Server URI>',
    	channelId: '<Channel ID>',
    	userId: '<User ID>' };
   
    function initSDK(name) {
    	// If WebSDK is not available, reattempt later
    	if (!document || !WebSDK) {
    		setTimeout(function() {
    			initSDK(name);
    		}, 2000);
    		return;
    	}
   
    	// Default name is Bots
    	if (!name) {
    		name = 'Bots';
    	}
    	setTimeout(function()
    {
    		const Bots = new WebSDK(chatSettings);
    // Initiate library with configuration
    		let isFirstConnection = true;
    		Bots.on(WebSDK.EVENT.WIDGET_OPENED, async () => {
    			if (isFirstConnection) {
    				try {
    					await Bots.connect(); // Connect to server
    					console.log('Connection Successful');
    				} catch (error) {
    					console.log('Connection failed');
    					console.log(error);
    				}
    				isFirstConnection = false;
    			}
    		});
   
    		window[name] = Bots;
    	}, 0);
    }

4. Définissez les propriétés suivantes :
   • URI : nom d'hôte dans l'URL d'instance Oracle Digital Assistant. Seul le premier chemin (/) doit être transmis ici. Vous pouvez transmettre cette URL avec ou sans le protocole (https://).
   • channelId : ID de canal généré lors de la création du canal Oracle Web. Cette propriété est requise car elle permet de connecter le widget à la brique sous-jacente.
   • userId : ID d'utilisateur. Lorsque vous indiquez cette valeur, la base d'utilisateurs de cette brique peut être suivie par les mesures utilisateur uniques dans Insights. Lorsque vous ne fournissez pas d'ID utilisateur, mais que le kit SDK en génère un à chaque nouvelle session. Cette propriété est facultative pour les connexions non authentifiées.
5. Dans votre page HTML, référencez les emplacements du fichier JS (setting.js dans l'exemple suivant) de la bibliothèque web-sdk.js et de l'espace de noms du kit SDK Web, qui est généralement Bots. Utilisez cet espace de noms pour appeler les API publiques. Par exemple, si vous définissez l'espace de noms sur Bots, vous appelez les API sous la forme Bots.<API>(). Pour en savoir plus sur les différents événements et fonctions, reportez-vous au guide de l'utilisateur (disponible sous forme de fichier README et de document HTML) inclus dans le fichier ZIP du kit SDK Oracle Web.

      <script src="scripts/settings.js"></script>
      <script src="scripts/web-sdk.js" onload="initSdk('Bots')"></script>    

async function generateToken() {
    const token = await fetch('https://yourbackend.com/endpointToGenerateJWTToken');
    return token;

}

Bots.init({
    URI: 'oda-instance.com',
    clientAuthEnabled: true
}, generateToken);