Webex a BroadWorks hibaelhárítási folyamataihoz

Probléma eszkalálódása

Miután követte a hibaelhárítási útmutatást, ésszerű elképzeléssel kell rendelkeznie arról, hogy hol gyökerezik a probléma.

1

Gyűjtsön annyi információt, amennyit csak tud a problémához kapcsolódó rendszerekből

2

Az ügy megnyitásához vegye fel a kapcsolatot a Cisco megfelelő csapatával (lásd a Kapcsolatok szakaszt)

Milyen ügyféladatokat gyűjtsön

Ha úgy gondolja, hogy meg kell nyitnia egy ügyet, vagy eszkalálnia kell egy problémát, gyűjtse össze a következő információkat a felhasználóval való hibaelhárítás közben:

  • Felhasználói azonosító: CI e-mail cím vagy felhasználói UUID (ez a Webex azonosító, de ha a felhasználó BroadWorks azonosítóját is megkapja, az segít)

  • Szervezet azonosítója

  • Hozzávetőleges időkeret, amely alatt a problémát tapasztalták

  • Ügyfélplatform és verzió

  • Naplók küldése vagy gyűjtése az ügyféltől

  • A nyomon követési azonosító rögzítése, ha megjelenik az ügyfélen

Felhasználói adatok ellenőrzése a Help Deskben

1

Jelentkezzen be a https://admin.webex.com/helpdesk.

2

Keresse meg, majd kattintson a felhasználóra. Ez megnyitja a felhasználói összesítő képernyőt.

3

Kattintson a felhasználónévre a részletes felhasználói konfiguráció megtekintéséhez.

Hasznos információk ebben a nézetben: a felhasználó UUID-címe, közös identitás (CI) fürtje, Webex alkalmazásfürtje, hívási viselkedése, BroadWorks-fiók GUID-címe.

4

Kattintson a Másolás gombra, ha ezt az információt egy másik eszközben kell használnia, vagy csatolja azt egy Cisco-ügyhöz.

Ügyfélszervezet megtekintése az Ügyfélszolgálaton

1

Jelentkezzen be a https://admin.webex.com/helpdesk.

2

Keresse meg, majd kattintson az ügyfélszervezet nevére.

3

Görgessen lefelé, amíg meg nem látja az Ügyfélportál nézetét, és kattintson az Ügyfélnév megtekintése gombra az Ügyfél szervezeti egy írásba beolvasott nézetének megtekintéséhez – beleértve a felhasználókat és a konfigurációt is.

Felhasználói naplók lekérése a Partner Hub-ból

Az asztali és mobil ügyfélproblémák elhárítása során fontos, hogy a partnerek (és a TAC) megtekinthessenek az ügyfélnaplókat.

1

Kérje meg a felhasználót, hogy küldjön naplókat.

2

Kérje meg a felhasználót, hogy exportálja a hívási környezetet, küldje el Önnek a ced.dat fájlt.

3

Szerezze be az ügyfélnaplókat a Partner Hubból vagy a Help Deskből (lásd alább).

Partner Hub opció:

  1. Jelentkezzen be a Partner Hubba, és keresse meg a felhasználó ügyfélszervezetét.

  2. Válassza a Hibaelhárítás lehetőséget.

  3. Válassza a Naplók lehetőséget.

  4. Keresés a felhasználó (e-mailben).

  5. Az ügyfélnaplók megtekintése és letöltése zip fájlként.

Help Desk lehetőség:

  1. Jelentkezzen be a Help Deskbe.

  2. Keresse meg a szervezetet.

  3. Kattintson a szervezetre (megnyitja az összefoglaló képernyőt).

  4. Görgessen lefelé az Ügyfél megtekintése gombra kattintva.

  5. Válassza a Hibaelhárítás lehetőséget.

  6. Válassza a Naplóklehetőséget .

  7. Keresés a felhasználó (e-mailben).

  8. Az ügyfélnaplók megtekintése és letöltése zip fájlként.

Az ügyfélverzió keresése

1

Ossza meg ezt a linket a felhasználóval: https://help.webex.com/njpf8r5.

2

Kérje meg a felhasználót, hogy küldje el Önnek a verziószámot.

Ügyfél-ellenőrzés hívásszolgáltatáshoz

1

Jelentkezzen be a Webex kliensbe.

2

Ellenőrizze, hogy a Hívásbeállítások ikon (egy készülék fölötte lévő fogaskerékkel) jelen van-e az oldalsávon.

Ha az ikon nincs jelen, előfordulhat, hogy a felhasználó még nem engedélyezve van a hívásszolgáltatáshoz a Control Hubban.

3

Nyissa meg a Beállítások/Beállítások menüt, és lépjen a Telefonszolgáltatások szakaszba. Látnia kell a bejelentkezett állapotot.

(Ha egy másik telefonszolgáltatás, például a Webex Calling, jelenik meg, a felhasználó nem használja Webex a BroadWorks.)

Ez az ellenőrzés a következő eszközöket jelenti:

  • Az ügyfél sikeresen áthaladt a szükséges Webex mikroszolgáltatásokon.
  • A felhasználó sikeresen hitelesítette.
  • Az ügyfél hosszú élettartamú JSON webes tokent kapott a BroadWorks rendszerétől.
  • Az ügyfél letöltötte eszközprofilját, és regisztrált a BroadWorks-hez.

Ügyfélnaplók vagy visszajelzések lekérve

  • Tekintse meg az Erőforrások szakaszt, ahol konkrét ügyfélnaplókat talál a Webex asztali ügyfelein, vagy kérje meg a felhasználókat, hogy küldjenek naplókat.

  • Kérje meg a mobil ügyfelek felhasználóit, hogy küldjenek naplókat, majd a partnerközponton vagy az ügyfélszolgálaton keresztül kaphatja meg őket.


A naplók küldése néma. Ha azonban egy felhasználó visszajelzést küld, az a Webex App devops csapatához kerül. Ügyeljen arra, hogy rögzítse a felhasználó visszajelzési számát, ha nyomon szeretné követni a Cisco-t. Például:

Hívókörnyezeti adatok lehívása

A Webex ügyfélnaplók erősen kitakarva távolítják el a személyazonosításra alkalmas adatokat. A híváskörnyezeti adatokat ugyanabban a munkamenetben kell exportálnia az ügyféltől, amikor észreveszi a problémát.

1

Az ügyfélben kattintson a profilképre, majd kattintson a Súgó > a Híváskörnyezeti adatok exportálásaelemre.

2

Mentse el a kapott fájlt a ced.dat a felhasználó hívásproblémáinak elhárításához.

Fontos: Kijelentkezés az ügyfélről vagy újraindítása törli a belső gyorsítótárat. Ha ced.dat exportál, az exportált adatok nem felelnek meg a gyorsítótár előtt küldött naplóknak.

Webex adatbázis alaphelyzetbe állítása

1

Az ügyfélnél kattintson a Súgó > állapotellenőrzőelemre.

2

Válassza az Adatbázis alaphelyzetbe állításalehetőséget.

Ez elindítja az ügyfél teljes alaphelyzetbe állítását, és betölti a Webex alkalmazás bejelentkezési képernyőjét.

Ellenőrizze, hogy a Webexnek regisztrálnia kell-e a BroadWorks-hez

A Webex alkalmazás a következő adatokat ellenőrzi annak eldöntésére, hogy regisztráljon-e a BroadWorks-be:

  • Felhasználói jogosultság a broadworks-connector-ra

  • Hívási viselkedés a szervezet és a felhasználó számára

A felhasználó hívási viselkedésének és csatlakozó jogosultságának ellenőrzése

  1. Jelentkezzen be a Help Desk (https://admin.webex.com/helpdesk) a partner rendszergazda hitelesítő adatait.

  2. Keresse meg a felhasználót.

  3. Kattintson a felhasználóra, és ellenőrizze a Hívás viselkedése bejegyzést. A "Call in Webex" legyen.

  4. Kattintson a felhasználónévre a Felhasználói adatok képernyő megnyitásához.

  5. Görgessen le, hogy megtalálja a entitlements szakaszt, és ellenőrizze, hogy broadworks-connector tartalmazza.


    A Webex a BroadWorks felhasználó nem rendelkezik a bc-sp-standard jogosultságot, ha a Webexet a BroadWorks számára kívánják használni. Ez a jogosultság a "Webex Calling (Broadcloud)" szolgáltatásra, amely a Webex alkalmazás hívása a Cisco által felügyelt felhőalapú hívási szolgáltatáson keresztül.

A szervezet hívási viselkedésének ellenőrzése

  1. Jelentkezzen be a Help Desk (https://admin.webex.com/helpdesk) a partner rendszergazda hitelesítő adatait.

  2. Keresse meg a szervezetet.

  3. Kattintson a szervezetre, és ellenőrizze a Hívás viselkedése bejegyzést. A "Call in Webex" legyen.

PSLog elemzése a felhasználók kiépítési problémáihoz

Az Alkalmazáskiszolgáló PSLog segítségével megtekintheti a HTTP POST kérést a kiépítési hídra és a Webex válaszát.

Helyes munka esetén a válasz 200 OK, és néhány perc múlva láthatja, hogy a felhasználó - és az új ügyfél org, ha az első felhasználó - a Webex-ben jött létre.

Ezt a Help Desk segítségével ellenőrizheti a POST-ban látható e-mail címért.

Mielőtt elkezdené

Gyűjtsön pslogot az alkalmazáskiszolgálóról egy tesztfelhasználóval végzett folyamatbeépítési kísérlet során.

1

Az első dolog, hogy ellenőrizze a HTTP válaszkód:

  • Bármi más, mint 200 OK a felhasználó kiépítési hiba.

  • 200 OK még mindig jelezheti a hibát, ha valami az előfizetői profil nem működik a Webex szolgáltatások előtt a kiépítési híd.

  • 400 tartalmazhat message csomópontot a válaszban. A kiépítési híd nem tudott feldolgozni valamit a subscriberProfile. Lehet, hogy valami baj van az előfizető adataival, vagy összeegyeztethetetlen a sablon beállításával.

  • 401: az AS-ben megadott kiépítési hitelesítő adatok nem egyeznek meg a Partner Hub sablonján megadott adatokkal.

  • A 403 jelezheti, hogy valami rosszul van konfigurálva az Application Serveren. Ellenőrizze a kérés célját. nem lehet IP-cím, hanem a partnerközpont sablonján látható kiépítési híd URL-je.

  • 409 a szállított subscriberProfile és a meglévő Webex-adatok. Előfordulhat, hogy egy meglévő felhasználó rendelkezik ezzel az e-mail címmel. Ellenőrizze a message – ikt.

2

Ellenőrizheti az eredeti HTTP POST-ot is, hogy nincsenek-e gyanús értékek, amelyek a kiépítés sikertelenségéhez vezethetnek.

A POSZT tartalmaz egy subscriberProfile XML-struktúra. Ezen belül hasznos csomópontokat kell ellenőrizni:

  • bwuserid: Ezzel megkeresheti az előfizetői profilt, ha módosítania kell a BroadWorksben.

  • group: Ha a sablon "Szolgáltató módban" van, ez kisbetűs, és a Partner Hubban látható Ügyfélközpont neve lesz.

  • serviceProvider: Ha a sablon "Vállalati módban" van, ez kisbetűs, és a Partner Hubban látható ügyfél-org neve lesz.

  • primaryPhoneNumber: Léteznie kell. A kiépítés enélkül nem sikerül.

  • email: A Webex felhasználói azonosítója lesz. Érvényesnek és egyedinek kell lennie a Webex számára, különben a kiépítés sikertelen.


 

Figyelmen kívül hagyja a services versszak: az AS hozta létre, és elfogadta, de a Webex nem használta.

XSP-naplók elemzése az előfizetői bejelentkezés hibaelhárításához

Ez az áramlás a BroadWorks hitelesítési módot írja le. A hitelesítési mód a BroadWorks sablonon, a Partner Hubban látható. Lásd: Ügyfélsablonok konfigurálása a https://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_1377262.

A következő létradiagram a felhasználó, az ügyfél, a Webex szolgáltatások és a BroadWorks rendszer közötti interakciót mutatja, amikor a felhasználó BroadWorks hitelesítést végez a Webex alkalmazásban. A Webex és az XSP közötti kapcsolatot az MTLS biztosítja.

Az ezt követő vita elmagyarázza, hogy mire számíthat a sikeres bejelentkezés naplóinak vizsgálatakor.

1. ábra. BroadWorks hitelesítés és eszközkonfiguráció

A felhasználó interakcióba lép az ügyféllel, az ügyfél interakcióba lép a Webex szolgáltatásaival:

  • A felhasználó meg kell adni az e-mail címét a Webex alkalmazásnak (1 a diagramon).

  • CI tudja átirányítani ezt a felhasználót, hogy adja meg BroadWorks jelszót (keresztül UAP) (2 diagram).

  • Az IDP Proxy kap profilkérelmet nyújt be az XSI felületére az XSP-n.

A tomcat access_log:

  • Keresse meg a GET kérést az előfizetői profilhoz, a Webex-től az Xsi-Actions felület felé (2.1 az ábrán). Webex felhasználói azonosítóval rendelkezik. Pl.

    GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile

Az XsiActionsLogban:

  • Keresse meg a Profil GET kérést a Webex-től (2.1 a diagramon). Webex felhasználói azonosítóval rendelkezik. Pl.

    GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile

    A fejlécek közé tartoznak a következők: authorization: Basic és user-agent: broadworksTeamsClient

  • Az XSP ezután elvégzi az OCI-P Basic hitelesítést a BroadWorks ellen (AuthenticationVerifyRequest és AuthenticationVerifyResponse, mint bármely más alkalmazás, amely az Xsi-n keresztül alapvető hitelesítést végez), valamint egy UserGetRequest és ServiceProviderGetRequest az előfizetői információk összegyűjtésére.

  • A Webexre adott Xsi-válasz XML-t tartalmaz Profile blokkot tartalmazó (BroadWorks) userId és egyéb részletek (2.2. ábra).

Ügyfél- és Webex-szolgáltatások interakciói:

  • Az IDP proxy megegyezik a BroadWorkstől kapott felhasználói profillal, és SAML állítást ad ki az ügyfélnek (2.3 a diagramon)

  • Az ügyfél kicseréli a SAML állítást egy CI tokenre (3 az ábrán)

  • Az ügyfél ellenőrzi, hogy a bejelentkezett felhasználó rendelkezik-e a broadworks-connector jogosultsággal (4 a diagramon). A felhasználói jogosultságokat a Help Deskben ellenőrizheti)

  • Az ügyfél CI tokent használ, hogy JSON web tokent (JWT) kérjen az IDP proxytól (5 a diagramon)

  • Az IDP proxy érvényesíti a CI tokent a CI-nél

  • Idp proxy kéri JWT a hitelesítési szolgáltatás

Az authenticationService naplóban:

  • Keresse meg a Webex token kérését (5.2 az ábrán), pl.:

    GET /authService/token

    amely http_bw_userid fejlécet és másokat.

  • Az XSP nem OCI-P UserGetLoginInfoRequest, annak igazolására, hogy a megadott felhasználói azonosító megfelel egy BroadWorks felhasználónak (5.3 a diagramon). Az AuthService az mTLS kapcsolatnak megfelelően bizalmat alakított ki a Webex-szel, így az LLT-t is ki tudja adnia.

  • Keresse meg a választ (5.4 diagramon) a LongLivedTokenManager - Token generated, subject: bwksUserId@example.com, issuer: BroadWorks …

    és StatusCode=200 amelyet az eredeti kérelemmel társíthat a trackingid: CLIENT… fejléc.

Az XsiActionsLogban:

  • Az ügyfél most már képes bemutatni a hosszú élettartamú tokent az Xsi-Actions felületen, hogy megkapja az eszköz profilját (6 a diagramon). Pl.:

    GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserId%40example.com/profile/device

    A fejlécekkel authorization: Bearer token és user-agent: WebexTeams (variant/version)

  • Az Xsi-Actions interfész POSTs a token az authservice (konfigurálva, hogy a visszacsatolás felület), pl.: 127.0.0.1:80 POST http://127.0.0.1:80/authService/token

    amely korrelálhat a trackingid: CLIENT… fejléc a GET és a X-BROADSOFT-CORRELATION-ID : CLIENT… fejléc a POST.

Az authenticationService naplóban:

  • A POST átvétele az Xsi-től (visszahívás)

  • A StatusCode=200 vissza Xsi

  • És egy token érvényesítési válasz, miután a "token" JSON blokk a testben.

  • Korrelál a trackingid: CLIENT…

Az XsiActionsLogban:

  • Miután 200 OK-t kapott az authservice-től, amely érvényesítette az ügyfél tokenjét, az Xsi-Actions alkalmazás most elküldi az OCI-P kérését UserPrimaryAndSCADeviceGetListRequest

  • OCI-P-t kap UserPrimaryAndSCADeviceGetListResponse tartalmazza a accessDeviceTable XML-struktúra.

  • Az OCI-P válasz Xsi válaszként van kódolva az ügyfél számára, beleértve a AccessDevices XML-struktúra, amely a deviceTypes pl. Business Communicator – PC és azokat az URL-eket, ahol az ügyfél lekérheti az eszköz konfigurációs fájljait.

Az ügyfél a szokásos módon folytatja:

  • Kiválaszt egy eszközbejegyzést, és kölcsönhatásba lép a DMS-szel az eszközprofil megszerzéséhez (6 a diagramon)

  • Regisztrál a BroadWorks keresztül SBC letölteni konfigurációban DMS (7 diagram)