Hitelesítési beállítások konfigurálása
A Customer Service Omnicsatorna számos képességet biztosít, amelyek kiterjesztik a Dynamics 365 Customer Service Enterprise erejét, képessé téve a szervezeteket arra, hogy azonnal csatlakozhassanak az ügyfelekhez a digitális üzenetküldési csatornákon keresztül. További licenc szükséges ahhoz, hogy a felhasználó hozzáférjen a Customer Service Omnicsatornához. További információért lásd a Dynamics 365 Customer Service árszabási áttekintését és a Dynamics 365 Customer Service árképzésiterv oldalakat.
Feljegyzés
A funkciók elérhetőségére vonatkozó információk a következők.
Dynamics 365 ügyfélkapcsolati központ – beágyazott | Dynamics 365 ügyfélkapcsolati központ – önálló | Dynamics 365 Customer Service |
---|---|---|
Igen | Igen | Igen |
Hitelesítési beállításokat hozhat létre egy tartományból bejelentkezett ügyfél érvényesítéséhez és információk kinyeréséhez a definiált környezeti változók alapján. A névtelen ügyfelek megkülönböztethetők a hitelesített ügyfelektől, és a környezeti változók alapján is létrehozhatók szabályok.
Például a névtelen ügyfelek és a hitelesített ügyfelek esetében külön várólisták szerepelhetnek. Mivel a hitelesített ügyfelekkel kapcsolatban további információval rendelkezik, konkrét változók, például a bevásárlókosár értéke vagy a privilegizált állapot alapján is rangsorolhatja őket.
A hitelesítési beállítások rekordjának létrehozását követően a működéshez hozzá kell adnia azt egy csatornapéldányhoz a munkafolyam csatornájának beállításán belül. A következő csatornák esetében támogatott a hitelesítés:
- Csevegés
- Apple Messages for Business
Annak jelzésére, hogy egy ügyfél hitelesítve van-e, az ügynök értesítést kap a Beszélgetés összegzése szakaszban. A Hitelesített mező Igen vagy Nem értékre van állítva az ügyfél hitelesítési állapota alapján. További információ: Beszélgetés összegzése
Előfeltételek
- Győződjön meg róla, hogy szervezete jól ismeri az OAuth 2.0 és a JSON Web Tokeneket (JWT-k).
- Ellenőrizze, hogy rendelkezik-e a biztonságos oszlopokra vonatkozó engedélyekkel. További információ: Engedélyek konfigurálása biztonságos oszlopok eléréséhez
Hitelesítést beállító rekord létrehozása csevegéshez
A felügyeleti alkalmazásban csevegéses hitelesítési beállítási rekordot hozhat létre.
A Customer Service felügyeleti központ oldaltérképén válassza az Ügyfélbeállítások lehetőséget az Ügyfélszolgálatban . Megjelenik az Ügyfélbeállítások lap.
A Hitelesítési beállítások szakaszban válassza a Kezelés lehetőséget. Megjelenik a Hitelesítési beállítások lap.
Válassza az Új hitelesítési beállítások lehetőséget, majd adja meg a következő információkat a Hitelesítési beállítás hozzáadása lapon:
Név: adja meg a hitelesítési beállítás nevét.
Tulajdonos: Fogadja el az alapértelmezett értéket, vagy módosítsa egy kötelező értékre.
Hitelesítés típusa: Alapértelmezés szerint az OAuth 2.0 implicit folyamat nem szerkeszthető.
Nyilvános kulcs URL-címe: adja meg a tartomány nyilvános kulcsának URL-címét. Ez az URL-cím annak a tartománynak a JavaScript Object Notation (JSON) webtokenjéből (JWT) érkező információk ellenőrzésére szolgál, amelybe az ügyfél bejelentkezett.
JavaScript-kliens funkciója: adja meg a hitelesítéshez használandó JavaScript-kliens funkcióját. Ez a funkció kivon egy tokent a tokenvégpontból.
Tudjon meg többet arról, hogyan találhatja meg a nyilvános kulcs URL-címét és a JavaScript-ügyfél funkciót a cikk későbbi, Portálok Power Apps beállítása vagy Egyéni portálok beállítása szakaszaiban.
Válassza a Mentés parancsot.
Hitelesítési beállításrekord létrehozása csevegéshez az OAuth 2.0 használatával
Hajtsa végre a Hitelesítési beállításrekord létrehozása csevegéshez című témakör 1–3. lépését, és adja meg a következő adatokat a Hitelesítési beállítás hozzáadása lapon:
- Név: A hitelesítési beállítás neve.
- Csatorna típusa:Élő csevegés .
- Hitelesítés típusa: OAuth 2.0 implicit folyamat
Válassza a Tovább gombot , és a Részletek lapon adja meg a következő adatokat:
- Jogkivonat egyéni művelete: Az egyéni kódhivatkozás az identitásszolgáltató által biztosított jogkivonatok érvényesítéséhez és a hitelesített felhasználó felhasználói azonosítójának visszaadásához.
- Jogkivonat URL-címe: Az engedélyezési kód cseréjéhez használt URL-cím az egyéni műveletnek a felhasználói azonosító beszerzéséhez átadott jogkivonatra.
- Átirányítási URL-cím: Az eredeti engedélyezési kódkérésnek átadott URL-cím, amely kötelező paraméter a jogkivonatcsere-végpont hívásaiban.
- Ügyfél-azonosító: A jogkivonatcsere-végpont átadott ügyfél azonosítója.
- Titkos ügyféltitk: Az a titkos kulcs, amely hitelesíti a jogkivonatcsere-végpont átadott ügyfelet.
- Hatókör: Azok a hatókörök, amelyekhez a felhasználó a folyamatban beszerzett jogkivonat alapján jogosult.
Mentse el a módosításokat.
Hitelesítés hozzáadása a csevegési vezérlőhöz
A Customer Service felügyeleti központ lapon szerkessze a csevegési vezérlő a munkafolyam beállításaiban, majd lépjen a Viselkedések lapra.
A Hitelesítési beállítások mezőben keresse meg és jelölje ki a csevegés hitelesítési rekordját.
Amikor egy portálon egy bejelentkezett ügyfél megnyitja a csevegési vezérlőt, a JavaScript-kliens függvény átadja a JWT-t az ügyféltől a kiszolgálónak. A JWT-t a nyilvános kulccsal visszafejtik és érvényesítik, majd az információkat Customer Service Omnicsatorna továbbítják a csevegőügynöknek. Rendszergazdaként az egyéni környezeti változók definiálásával további információkat adhat meg az aláírt ügyfélről a JWT-ben. A környezeti változókat pontosan úgy kell meghatározni, ahogy a csevegési vezérlő társított munkafolyamatban vannak. További információ: Környezeti változók kezelése
A Power Apps portálok beállítása
Ha portálok használatával Power Apps fejlesztett webhelyen ad hozzá hitelesítést egy csevegési vezérlő hoz, akkor a nyilvános kulcs URL-címe és a JavaScript-ügyfélfunkció azonnal elérhető. Egyéni tanúsítványt kell feltöltenie, hogy érvényes nyilvános kulcsú URL-címmel rendelkezzen a Power Apps portálokon.
-
Nyilvános kulcs URL-je:
<portal_base_URL>/_services/auth/publickey
-
JavaScript-kliens funkciója:
auth.getAuthenticationToken
A Power Apps portál megpróbál automatikusan csatolni egy kapcsolattartói rekordot a beszélgetéshez a JavaScript-ügyfélfunkciójában átadott kontextuson keresztül.
Egyéni portálok beállítása
Ha hitelesített csevegési élményt ad hozzá egy olyan egyéni webhelyhez, amelyet nem portálok használatával Power Apps fejlesztettek ki, a webfejlesztő csapatnak a következő lépéseket kell végrehajtania, mielőtt a rendszergazda konfigurálhatja a hitelesített csevegést:
Hozzon létre nyilvános/személyes kulcspárt a hitelesítési kiszolgálóin. A kulcsokat az RSA256 algoritmus segítségével kell létrehozni.
Az alábbi mintakód titkos vagy nyilvános kulcspárok létrehozására szolgál.
openssl genpkey -algorithm RSA -out private_key.pem -pkeyopt rsa_keygen_bits:2048 openssl rsa -pubout -in private_key.pem -out public_key.pem
Hozzon létre egy végpont, amely visszaadja a nyilvános kulcsokat. A Omnicsatorna kiszolgálók a nyilvános kulcsokkal ellenőrzik a csevegési kérelem engedélyezésének részeként átadott JWT-jogkivonatot. Ennek a végpont URL-címét adja meg a felügyeleti alkalmazásban a hitelesítési beállítás rekordjának létrehozásakor.
A nyilvános kulcs végpont az alábbi példához hasonlóan néz ki:
-----BEGIN PUBLIC KEY----- NIIBIjANBgkqhkiG9w0BAQEFABCOPQ8AMIIBCgKCAQEAn+BjbrY5yhSpLjcV3seP mNvAvtQ/zLwkjCbpc8c0xVUOzEdH8tq4fPi/X5P/Uf2CJomWjdOf1wffmOZjFasx ELG+poTqy5uX2dNhH6lOMUsV31QGG36skLivpLBCSK6lWlzsV6WGkb/m8r86aGzp jtNhw8yvoTYB4updDrJ8pC+tx4EWK0WEmKn1GsW6TjUtxJjcTLI1puSbmcGHbkSi RSbWkKPqaEVFALprw+W5ZCung5QX3KOkY/rJd+2JwULm7okyQCQaF7qwa5i9Uf65 7M6ZL4vsDevq7E/v3tf6qxpSSHzt4XspXVQty9QHhqDqBEY3PfI4L2JjgIGuPhfS YQIDAQAB -----END PUBLIC KEY-----
Ha több nyilvános kulcsot kell használnia, a nyilvános kulcs végpont egy készlet <kid, publickey>
-párt küldhet vissza, ahol a kid
a kulcs azonosítóját jelzi. A kulcsazonosító pároknak egyedinek kell lenniük. A gyereket a 4. lépés kell átadni a JWT-jogkivonatban. Ha több kulcsot használ, a nyilvános kulcsú végpont az alábbi példához hasonló értéket kell visszaadnia. A nyilvános kulcs base64 kódolású.
[
{
"kid": "qWO4EaKT1xRO7JC/oqALz6DCVr41B/qL0Hqp4in7hu4=",
"publicKey": LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0NCk1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBbjFLdXhtSEh3V3hjelZSWGRBVmMNCnBEaFZwa0FnYklhTGZBUWc1bFpvemZqc29vcWRGWkl0VlFMdmRERWFVeDNqTytrTkxZM0JFRnBYVDZTN3ZNZCsNCnZoM2hpMDNsQ1dINnNCTWtaSWtuUUliMnFpekFsT0diU2EvK3JrUElnYnpXQjRpT1QyWVhyOVB4bXR5d2o4WUINCnYram55VU5DSzMyZy9FYWsvM0k3YW1vZ2pJY0JISjNFTjVuQWJBMExVVnJwMW5DODJmeEVPOHNJTzNYdjlWNVUNCnc5QnVTVVFRSmtMejNQYVI5WTdRZUEyNW5LUGtqTXZ2Y0UxVU5oeVpIYlNLbmorSitkZmFjb1hsSGtyMEdGTXYNCldkSDZqR0pWcGNQMHBkNjFOa3JKa2c0aStheThwS2ZqdjNUOHN3NWdaVHFweFFaaitVRWxqaVM0SHRPTlhkNlENCnZRSURBUUFCDQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0NCg==",
"expiry": 1608495423
},
{
"kid": "qWO4EaKT1xRO7JC/oqALz6DCVr41B/qL0Hqp__valid=",
"publicKey": "LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0NCk1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBbjFLdXhtSEh3V3hjelZSWGRBVmMNCnBEaFZwa0FnYklhTGZBUWc1bFpvemZqc29vcWRGWkl0VlFMdmRERWFVeDNqTytrTkxZM0JFRnBYVDZTN3ZNZCsNCnZoM2hpMDNsQ1dINnNCTWtaSWtuUUliMnFpekFsT0diU2EvK3JrUElnYnpXQjRpT1QyWVhyOVB4bXR5d2o4WUINCnYram55VU5DSzMyZy9FYWsvM0k3YW1vZ2pJY0JISjNFTjVuQWJBMExVVnJwMW5DODJmeEVPOHNJTzNYdjlWNVUNCnc5QnVTVVFRSmtMejNQYVI5WTdRZUEyNW5LUGtqTXZ2Y0UxVU5oeVpIYlNLbmorSitkZmFjb1hsSGtyMEdGTXYNCldkSDZqR0pWcGNQMHBkNjFOa3JKa2c0aStheThwS2ZqdjNUOHN3NWdaVHFweFFaaitVRWxqaVM0SHRPTlhkNlENCnZRSURBUUFCDQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0NCg==",
"expiry": 1608495423
}
]
Olyan szolgáltatásra van szüksége, amely létrehozza a JWT-t, amelyet el kell küldenie Omnicsatorna kiszolgálóira a hitelesített felhasználó csevegésének részeként.
a. A JWT-fejléc az alábbi példához hasonlóan néz ki.
{ "alg": "RS256", "typ": "JWT", }
Ha több nyilvános kulcsot használ, át kell adnia a kulcsazonosítót (kid). A fejléc az alábbi példához hasonlóan néz ki:
{ "alg": "RS256", "typ": "JWT", "kid": "qWO4EaKT1xRO7JC/oqALz6DCVr41B/qL0Hqp4in7hu4=" }
b. A JWT hasznos adatnak a következőket kell tartalmaznia:
Legalább a következő állítások:
Jogcím Definíció iss A lexikális elem kibocsátója. iat A lexikális elem kibocsátásának dátuma, numerikus dátumformátumban. exp A lexikális elem lejárati dátuma, numerikus dátumformátumban. sub A jogcím tárgya.
MEGJEGYZÉS: Javasoljuk, hogy adja át a bejelentkezett felhasználó kapcsolattartójának vagy partnerrekordjának GUID azonosítóját ügyfélszolgálat. Ez a GUID azonosító azonosítja és csatolja a partnerrekordot a beszélgetéshez. A rekordkeresés azonosítja azokat a rekordokat, amelyek a kapcsolattartók vagy partnerek aktív állapotkódjával rendelkeznek. A rekordazonosítás nem működik, ha egyéni állapotkódokat használ.lwicontexts A beszélgetés részeként átadható környezetváltozók továbbítási célokból vagy az ügynöknek való megjelenítés céljából.
További információk
Egyéni környezet kezelése
setAuthTokenProvider metódus
Rekordok automatikus azonosítása környezetváltozók használatávalMinden más átadni kívánt adat.
Az adatcsomagnak az alábbi példához hasonlóan kell kinéznie:
{ "sub" : "87b4d06c-abc2-e811-a9b0-000d3a10e09e", "lwicontexts" :"{\"msdyn_cartvalue\":\"10000\", \"msdyn_isvip\":\"false\", \"portalcontactid\":\"87b4d06c-abc2-e811-a9b0-000d3a10e09e\"}", "iat" : 1542622071, "iss" : "contosohelp.com", "exp" : 1542625672, "nbf" : 1542622072 }
c. A JWT aláírását a személyes kulcsának kell aláírnia.
Feljegyzés
- Ha a jogkivonat lejárt vagy érvénytelen, a csevegési vezérlő hibaeseményt ad vissza.
- A setContextProvider metódus nem támogatott hitelesített csevegéshez. A JWT hasznos adat részeként át kell adnia az lwicontexts elemét.
Hozzon létre egy JavaScript-függvényt a webhelyén, amely elfogad egy visszahívási függvényt, és visszaad egy JWT-t a visszahívási függvénynek. Az időtúllépés elkerülése érdekében ennek a JavaScript függvénynek 10 másodpercen belül vissza kell adnia egy JWT-t. Ennek a JWT-nek meg kell felelnie a következő feltételeknek:
Tartalmaznia kell a fejlécet, a hasznos adatokat és az aláírást a lépés 3-ból.
Ezt az 1. lépés kulcspárból származó titkos kulccsal kell aláírni.
Javasoljuk, hogy a JWT-t a webkiszolgálón hozza létre.
Ennek a JavaScript-módszernek a neve a hitelesítési beállítások rekordjának létrehozására szolgál a ügyfélszolgálat felügyeleti alkalmazásban.
// This is a sample JavaScript client function auth.getAuthenticationToken = function(callback){ var xhttp = new XMLHttpRequest(); xhttp.onreadystatechange = function() { if (this.readyState == 4 && this.status == 200) { callback(xhttp.responseText); } }; xhttp.onerror = function(error) { callback(null); }; //Replace this with a call to your token generating service xhttp.open("GET", "https://contosohelp.com/token", true); xhttp.send(); }
A fejlesztőnek meg kell osztania a következő információkat a Omnicsatorna rendszergazdájával:
a. A nyilvános kulcs szolgáltatás URL-címe a 2. lépésből.
Példa: https://www.contoso.com/auth/publickey
b. A JavaScript-ügyfél függvényének neve a 4. lépésből. Az élő csevegési vezérlő belsőleg hívja ezt a nevet a csevegés kezdetén.
Példa: auth.getAuthenticationToken
Feljegyzés
Ha felhasználói élménye kiteszi a csevegés gombot a felhasználók hitelesítése előtt, akkor biztosítsam hogy át legyenek irányítva a hitelesítési lapra. Az átirányítást beállíthatja a metódusban a 4 lépés ben, vagy a felhasználói folyamat korábbi lépés.
Az alábbi ábra bemutatja a telepítést.
Ezután a következő lépések végrehajtásával állíthatja be a hitelesített csevegést:
Hitelesített csevegési beállítása
Nyissa meg a felügyeleti alkalmazást, és hozzon létre egy hitelesítési beállítások rekordot az előző szakasz 5. lépés adataival. További információ: Hitelesítési beállításrekord létrehozása csevegéshez
Társítsa a hitelesítési beállításokat a hitelesített felhasználói élményt nyújtó csevegési vezérlő. További információ: Hitelesítés hozzáadása csevegési vezérlő
A következő illusztráció bemutatja a hívási sorrendet, amikor a felhasználó a csevegést egy hitelesített beállításban éri el.
Hitelesítési beállítások létrehozása a következőhöz: Apple Messages for Business
Előfeltételek
A hitelesítési beállításokat konfiguráló rendszergazdáknak több biztonsági engedélyre van szükségük. További információ: Biztonsági engedélyek beállítása mezőhöz
Győződjön meg arról, hogy a szervezet rendelkezik az OAuth 2.0 OpenID csatlakozási folyamatának ismeretével. A lépéseket a következő szakasz ismerteti.
Ellenőrizze, hogy a szervezete legalább egy Apple Messages for Business hitelesítés típusú formázott üzenettel rendelkezzen. Ez a gazdag üzenet konfiguráció szükséges a telepítéshez.
Hitelesítési beállításrekord Apple Messages for Business létrehozása az OAuth 2.0 OpenID csatlakozási folyamat használatához
A Customer Service felügyeleti központ oldaltérképen válassza az Ügyfélbeállítások, majd a Kezelés lehetőséget a hitelesítési beállításokhoz. Megjelenik a meglévő hitelesítési beállítások listája.
Válassza az Új hitelesítési beállítás lehetőséget, majd a Hitelesítési beállítás hozzáadása lapon adja meg a következő adatokat:
A Csatorna típusa lapon adjon meg egy nevet, majd válassza ki Apple Messages for Business a csatorna típusát.
Módosítsa a hitelesítés típusát OAuth 2.0 OpenID csatlakozási folyamat.
A Hitelesítési beállítás hozzáadása lapon adja meg a következő adatokat:
-
Ügyfélazonosító: Engedélyezési kiszolgáló által kiadott OAuth 2.0 ügyfélazonosító.
-
Titkos ügyfélkód: Az engedélyezési kiszolgálónak küldött kérések hitelesítésére használt titkos ügyfélkód.
-
Hatókör: Minden hozzáadott hatókör meghatározza, hogy mely felhasználói adatokat kérte az ügyféltől. A hatókör tartalmának pontosan meg kell egyeznie a szolgáltatón keresztül elérhető tartalommal.
- hozzáférési token URL: A szolgáltató végpont, ahol hozzáférési token kérhető le.
-
Visszafejtett jogkivonat URL-címe: Az a végpont, ahol az OAuth 2.0 API lekérheti a hatókörben kért ügyféladatokat.
- További paraméterek: Lehetővé teszi, hogy a hitelesítési szolgáltatások további paramétereket vegyenek fel a kérésből.
-
Ügyfélazonosító: Engedélyezési kiszolgáló által kiadott OAuth 2.0 ügyfélazonosító.
A További részletek lapon tetszés szerint megadhatja a hozzáférési jogkivonat lejárati idejét, másodpercekben kifejezve. Az alapértelmezett lejárati idő egy óra.
A megadott időpont után a korábban hitelesített beszélgetés Ügyfél összegzése szakaszának Hitelesített mezője Nem értékreváltozik.A Rich messages (Gazdag üzenetek ) lapon válassza a Add ( Hozzáadás ) lehetőséget, majd válasszon ki egy vagy több formázott üzenetet, amelyet társítani szeretne ehhez ahitelesítési beállításhoz.
Tekintse át az Összefoglalás lapot, majd válassza a Tovább lehetőséget. A hitelesítési beállítás konfigurálása sikeres.
Az Átirányítási információk lapon másolja ki az URL-címet. Ezt az URL-címet az engedélyezett visszahívási URL-címek alatt adhatja hozzá a hitelesítési szolgáltató webhelyéhez.
Válassza a Befejezés lehetőséget.
Hitelesítés hozzáadása Apple Messages for Business-csatornához
Nyissa meg azt a munkafolyamatot, amely azt a csatornapéldányt tartalmazza, amelyhez hitelesítést szeretne hozzáadni.
A csatornabeállítások Viselkedések lapján navigáljon a Hitelesítési beállítások lapra, engedélyezze a képességet, majd válassza ki a megfelelő beállítást a legördülő menüből. További információ: Csatorna konfigurálása Apple Messages for Business
Az egyes csatornapéldányok hitelesítési beállításainak áttekintéséhez vagy frissítéséhez válassza a Szerkesztés lehetőséget .
Kapcsolódó információk
Csevegési vezérlő hozzáadása
A beszélgetés előtti felmérés konfigurálása
Gyors válaszok létrehozása
Üzemórák létrehozása és kezelése
Csevegési vezérlő beágyazása a Power Apps portálokba
Ügyfelek automatikus azonosítása