• Un canal Oracle Web. La création du canal génère l'ID canal et la clé secrète dont vous avez besoin pour initialiser l'application de clavardage.
• L'URL du serveur de clavardage Oracle.
• La trousse SDK Oracle Web (située sous les trousses SDK client natives Oracle pour les environnements natifs OCI) téléchargée à partir de la page de téléchargement ODA et OMC d'Oracle Technology Network. Téléchargez ce fichier ZIP et extrayez-le sur votre système local. Ce fichier ZIP comprend un guide d'utilisation qui décrit les classes de la trousse SDK et un exemple d'application qui présente la plupart de ses fonctions.

• 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 Web. 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 du navigateur client.

  Lorsque l'application Web 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.

  Conseil :

  Cet article vous guide lors de l'exécution de la trousse SDK avec un canal authentifié.
• 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 le widget client est déjà sécurisé et visible pour les utilisateurs authentifiés.

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 Web 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.
     • Le canal communiquera uniquement avec les sites des domaines que vous ajoutez dans une liste séparée par des virgules. Par exemple, *.corp.example.com, *.hdr.example.com. L'entrée d'un seul astérisque (*) permet un accès illimité au canal depuis n'importe quel domaine. En règle générale, vous n'entrez qu'un seul astérisque lors du développement. En production, vous ajoutez une liste d'autorisation de domaines.
     • 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).
     • Entrez une liste séparée par des virgules de domaines pouvant accéder au canal. Si les domaines de cette liste d'autorisation incluent des astérisques (*.hdr.example.com) ou si elle n'est pas complètement connue, envisagez plutôt une connexion authentifié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-les à portée de main, car vous en aurez besoin lors de la configuration de la page HTML pour héberger le widget de clavardage.
5. Acheminez le canal vers votre compétence ou votre assistant numérique.
6. Sélectionnez Channel Enabled (Canal activé).

1. Dans le fichier ZIP extrait de la trousse SDK Oracle Web téléchargée, localisez le fichier web-sdk.js (situé dans le répertoire native-client-sdk-js).
2. Enregistrez web-sdk.js (situé dans le répertoire native-client-sdk-js du fichier ZIP extrait) dans le répertoire du 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 la trousse SDK. Nous appelons ce fichier settings.js dans l'exemple fourni avec la trousse 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 de l'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 canal généré lors de la création du canal Oracle Web. Cette propriété est obligatoire car elle connecte le widget à la compétence sous-jacente.
   • userId : Un ID utilisateur. Lorsque vous fournissez cette valeur, la base d'utilisateurs de cette compétence peut être suivie par les mesures d'utilisateur uniques dans les données clés. Lorsque vous ne fournissez pas d'ID utilisateur, mais que la trousse 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 de la trousse 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 comme suit : Bots.<API>(). Pour en savoir plus sur les divers fonctions et événements, consultez le guide de l'utilisateur (disponible sous forme de fichier Lisez-moi et de document HTML) fourni dans le fichier ZIP de la trousse 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);