Freigeben über

Authentifizierungstoken senden

Um einen Kunden zu authentifizieren, wenn er einen Chat startet, übergeben Sie ein Authentifizierungstoken an Omnichannel for Customer Service. Dieses Token wird verwendet, um einen angemeldeten Kunden aus einer Domäne zu validieren und Informationen basierend auf den definierten Kontextvariablen zu extrahieren. Die benutzerdefinierte Authentifizierung ist optional und nur relevant, wenn das Chat-Widget außerhalb von Power Apps-Portalen gehostet wird.

Von Bedeutung

  • In der Nutzlast des JSON Web Token (JWT) sollte der für den lwicontexts Schlüssel bereitgestellte Wert der serialisierte benutzerdefinierte Kontext sein.
  • Der benutzerdefinierte Kontext ist eine Sammlung von Schlüssel-Wert-Paaren. Für jeden Schlüssel sind nur primitive Werte zulässig.
  • Die Schlüssel des benutzerdefinierten Kontexts müssen den Kontextvariablen entsprechen, die für den zugehörigen Arbeitsstream in Omnichannel for Customer Service erstellt werden.
  • Der Authentifizierungstoken-Anbieter wird vom Live-Chat-Widget aufgerufen, wenn ein neuer Chat gestartet wird.

Die SDKs, die sich auf den Authentifizierungstokenanbieter beziehen, sind nur anwendbar, wenn die Authentifizierung für das Widget aktiviert ist. Informationen zum Aktivieren der Authentifizierung für Ihr Widget finden Sie unter Erstellen von Chat-Authentifizierungseinstellungen.

Führen Sie die folgenden Schritte aus, um ein Authentifizierungstoken zu senden, wenn Sie einen Chat starten:

  1. Generieren Sie ein gültiges JWT aus der JSON-Nutzlast. Weitere Informationen: setAuthTokenProvider

  2. Die Live-Chat-Methoden sollten aufgerufen werden, nachdem das lcw:ready-Ereignis ausgelöst wurde. Sie können auf dieses Ereignis lauschen, indem Sie dem window-Objekt einen eigenen Ereignis-Listener hinzufügen.

  3. Nachdem das lcw:ready Ereignis ausgelöst wurde, registrieren Sie einen Authentifizierungstokenanbieter beim Livechat, indem Sie die setAuthTokenProvider-Methode verwenden.

    Hinweis

    Um eine Zeitüberschreitung zu vermeiden, muss die authTokenProvider-Funktion in der setAuthTokenProvider-Methode innerhalb von 10 Sekunden antworten.

  4. Verwenden Sie die startChat-Methode , um den Chat zu starten.

Beispielcode

let payloadToEncrypt = {
    "sub" : "87b4d06c-abc2-e811-a9b0-000d3a10e09e",
    "lwicontexts" :"{\"msdyn_cartvalue\":\"10000\", \"msdyn_isvip\":\"false\"}",
    "iat" : 1542622071,
    "iss" : "contosohelp.com",
    "exp" : 1542625672,
    "nbf" : 1542622072
};

function convertToJwtToken(payloadToEncrypt){
  // Ideally, you should call your service to convert the payload to a valid JWT token
  return Promise.resolve("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI4N2I0ZDA2Yy1hYmMyLWU4MTEtYTliMC0wMDBkM2ExMGUwOWUiLCJsd2ljb250ZXh0cyI6IntcIm1zZHluX2NhcnR2YWx1ZVwiOlwiMTAwMDBcIiwgXCJtc2R5bl9pc3ZpcFwiOlwiZmFsc2VcIn0iLCJpYXQiOjE1NDI2MjIwNzEsImlzcyI6ImNvbnRvc29oZWxwLmNvbSIsImV4cCI6MTU0MjYyNTY3MiwibmJmIjoxNTQyNjIyMDcyfQ.r37z1M5rMyRYMOJ-rhyTRYFOgvl9N7KvTMueSFPkiuM");
}

function authTokenProvider(callback){
    convertToJwtToken(payloadToEncrypt).then(function (jwtToken){
    // Calling the callback with the valid JWT token
   callback(jwtToken);
   });
}

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
    // Handle live chat ready event
    // Can use the SDK methods now
    // Setting authentication token provider to be used for the chat
    Microsoft.Omnichannel.LiveChatWidget.SDK.setAuthTokenProvider(authTokenProvider);

   // Starting a new chat
   Microsoft.Omnichannel.LiveChatWidget.SDK.startChat();
});

window.addEventListener("lcw:error", function handleLivechatErrorEvent(errorEvent){
  // Handle livechat error event
   console.log(errorEvent);
});

setAuthTokenProvider
getAuthTokenProvider
removeAuthTokenProvider
JavaScript-API-Referenz für das Live-Chat-SDK
Benutzerdefinierten Kontext senden

  • Last updated on