setAuthTokenProvider

Το Πανκαναλικό για Customer Service προσφέρει δυνατότητες που επεκτείνουν την ισχύ του Dynamics 365 Customer Service Enterprise για να έχουν οι οργανισμοί τη δυνατότητα να συνδεθούν και να επικοινωνήσουν άμεσα με τους πελάτες τους μέσω καναλιών όπως η Live Συνομιλία και το SMS. Απαιτείται μια πρόσθετη άδεια χρήσης για την πρόσβαση στο Πανκαναλικό για Customer Service. Για περισσότερες πληροφορίες δείτε τις σελίδες Επισκόπηση τιμολόγησης Dynamics 365 Customer Service και Πλάνο τιμολόγησης Dynamics 365 Customer Service.

Ορίζει την υπηρεσία παροχής διακριτικού ελέγχου ταυτότητας.

Η συνάρτηση υπηρεσίας παροχής διακριτικού ελέγχου ταυτότητας, όταν καλείται με μια συνάρτηση επιστροφής κλήσης ως παράμετρο, καλεί τη συνάρτηση επιστροφής κλήσης με μια έγκυρη συμβολοσειρά JSON Web Token (JWT) ως όρισμα.
Αυτή η μέθοδος δημιουργεί ένα σφάλμα εάν η τιμή της authTokenProvider παραμέτρου δεν είναι συνάρτηση.

Σημαντικό

• Στο ωφέλιμο φορτίο του διακριτικού JWT, η τιμή που παρέχεται για lwicontexts το κλειδί θα πρέπει να είναι το σειριακό προσαρμοσμένο περιβάλλον.
  
• Το προσαρμοσμένο περιβάλλον είναι μια συλλογή ζευγών κλειδιού/τιμής. Επιτρέπονται μόνο πρωτόγονες τιμές για οποιοδήποτε κλειδί.
  
• Τα κλειδιά προσαρμοσμένου περιβάλλοντος πρέπει να αντιστοιχούν σε μεταβλητές περιβάλλοντος που δημιουργούνται για τη συσχετισμένη ροή εργασίας στο Πανκαναλικό για Customer Service.
  
• Ο πάροχος διακριτικού ελέγχου ταυτότητας θα κληθεί από το γραφικό στοιχείο ζωντανής συνομιλίας κατά την έναρξη μιας νέας συνομιλίας.

Σημείωμα

Οι μέθοδοι SDK ζωντανής συνομιλίας θα πρέπει να ενεργοποιηθούν μετά την εμφάνιση του συμβάντος lcw:ready . Μπορείτε να ακούσετε αυτό το συμβάν προσθέτοντας το δικό σας πρόγραμμα ακρόασης συμβάντων στο αντικείμενο παραθύρου.

Αυτό το SDK ισχύει μόνο εάν ο έλεγχος ταυτότητας είναι ενεργοποιημένος για το widget. Για να ενεργοποιήσετε τον έλεγχο ταυτότητας για το widget σας, ανατρέξτε στην ενότητα Δημιουργία ρυθμίσεων ελέγχου ταυτότητας συνομιλίας.

Σύνταξη

Microsoft.Omnichannel.LiveChatWidget.SDK.setAuthTokenProvider(authTokenProvider);

Παράμετροι

Παράμετρος	Type	Περιγραφή
authTokenProvider	Λειτουργία	Συνάρτηση η οποία όταν καλείται με μια συνάρτηση επιστροφής κλήσης ως όρισμα, λαμβάνει το διακριτικό JWT και καλεί τη συνάρτηση επιστροφής κλήσης με το διακριτικό JWT ως όρισμά της

Τιμή επιστροφής

None

Παράδειγμα

Δείγμα ωφέλιμου φορτίου διακριτικού

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

Σημείωμα

Στο παραπάνω ωφέλιμο φορτίο, η τιμή που αντιστοιχεί στο κλειδί θα πρέπει να lwicontexts είναι το σειριακό προσαρμοσμένο περιβάλλον. Τα κλειδιά msdyn_cartvalue και msdyn_isvip στο σειριακό προσαρμοσμένο περιβάλλον αντιστοιχούν σε μεταβλητές περιβάλλοντος που δημιουργούνται για τη συσχετισμένη ροή εργασίας στο Πανκαναλικό για Customer Service.

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 call your service to convert the payload to a valid JWT token
    return Promise.resolve("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI4N2I0ZDA2Yy1hYmMyLWU4MTEtYTliMC0wMDBkM2ExMGUwOWUiLCJsd2ljb250ZXh0cyI6IntcIm1zZHluX2NhcnR2YWx1ZVwiOlwiMTAwMDBcIiwgXCJtc2R5bl9pc3ZpcFwiOlwiZmFsc2VcIn0iLCJpYXQiOjE1NDI2MjIwNzEsImlzcyI6ImNvbnRvc29oZWxwLmNvbSIsImV4cCI6MTU0MjYyNTY3MiwibmJmIjoxNTQyNjIyMDcyfQ.r37z1M5rMyRYMOJ-rhyTRYFOgvl9N7KvTMueSFPkiuM");
}

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
// Sets the auth-token provider
// Throws error if authTokenProvider is not a function
    convertToJwtToken(payloadToEncrypt).then(function (jwtToken){
        Microsoft.Omnichannel.LiveChatWidget.SDK.setAuthTokenProvider(function authTokenProvider(callback){
            callback(jwtToken);
        });
    });
});

Κωδικοί σφάλματος

Τα ακόλουθα σφάλματα μπορεί να προκύψουν με αυτήν τη μέθοδο.

Κωδικός σφάλματος	Μήνυμα σφάλματος
2	Η εκτέλεση της μεθόδου υπηρεσίας παροχής διακριτικού ελέγχου ταυτότητας απέτυχε
3	Η υπηρεσία παροχής διακριτικού ελέγχου ταυτότητας δεν παρείχε διακριτικό
4	Η υπηρεσία παροχής διακριτικού ελέγχου ταυτότητας παρείχε μη έγκυρο διακριτικό

Σχετικές πληροφορίες

Αναφορά API JavaScript για SDK ζωντανής συζήτησης