Webex voor BroadWorks-probleemoplossingsprocessen

Een probleem escaleren

Nadat u enkele richtlijnen voor probleemoplossing hebt gevolgd, moet u een redelijk idee hebben waar het probleem is geroot.

1

Zo veel informatie verzamelen als u kunt doen via de systemen die betrekking hebben op het probleem
2

Neem contact op met het juiste team van Cisco om een case te openen (zie het gedeelte Contactpersonen)

Welke clientgegevens u moet verzamelen

Als u denkt dat u een case moet openen of een probleem moet escaleren, verzamelt u de volgende informatie tijdens het oplossen met de gebruiker:

  • Gebruikers-id: CI e-mailadres of gebruikers-UUID (dit is de Webex-id, maar als u ook de BroadWorks-id van de gebruiker krijgt, die helpt)

  • Organisatie-id

  • Geschatte tijd gedurende het ervaren probleem

  • Clientplatform en versie

  • Logbestanden van de client verzenden of verzamelen

  • Neem de traceer-id op als deze op de client wordt weergegeven

Gebruikersgegevens in de Helpdesk

1

Meld u aan bij https://admin.webex.com/helpdesk.
2

Zoek naar en klik vervolgens op de gebruiker. Hiermee wordt het overzichtsscherm van de gebruiker geopend.
3

Klik op gebruikersnaam om de gedetailleerde gebruikersconfiguratie te bekijken.

Nuttige informatie in deze weergave omvat het UUID-cluster van de gebruiker, het CLUSTER Common Identity (CI), het Webex-app-cluster, Bellengedrag, BroadWorks-account GUID.
4

Klik op Kopiëren als u deze informatie in een ander hulpmiddel wilt gebruiken of als u deze aan een Cisco-case wilt koppelen.

Klantorganisatie in deze Helpdesk

1

Meld u aan bij https://admin.webex.com/helpdesk.
2

Zoek naar en klik vervolgens op de naam van de klantorganisatie.
3

Schuif omlaag totdat u de weergave van de klantportal ziet en klik op Klantnaam weergeven om de alleen-lezenweergave van de klant organisatie te zien, inclusief gebruikers en configuratie.

Gebruikerslogboeken ophalen van Partner Hub

Wanneer u problemen met het bureaublad en de mobiele client oplossert, is het belangrijk voor Partners (en TAC) om de clientlogboeken te kunnen bekijken.

1

Vraag de gebruiker om logboeken te verzenden.
2

Vraag de gebruiker om de belomgeving te exporteren en u het ced.dat-bestand te sturen.
3

Haal de clientlogboeken op bij Partner hub of Helpdesk (zie hieronder).

Partner hub-optie:

  1. Meld u aan bij Partner Hub en zoek de klantorganisatie van de gebruiker.

  2. Selecteer Problemen oplossen.

  3. Selecteer Logbestanden.

  4. De gebruiker zoeken (via e-mail).

  5. Bekijk en download de clientlogboeken als een zip-bestand.

Helpdesk:

  1. Meld u aan bij Helpdesk.

  2. Zoek naar de organisatie.

  3. Klik op de organisatie (hiermee opent u het overzichtsscherm).

  4. Scrol omlaag om te klikken op Klantweergeven.

  5. Selecteer Problemen oplossen.

  6. Selecteer Logboeken.

  7. De gebruiker zoeken (via e-mail).

  8. Bekijk en download de clientlogboeken als een zip-bestand.

Clientcontrole voor belservice

1

Meld u aan bij de Webex-client.
2

Controleer of het pictogram Belopties (een handset met een apparaat erboven) op de zijbalk aanwezig is.

Als het pictogram niet aanwezig is, is de gebruiker mogelijk nog niet ingeschakeld voor de belservice in Control Hub.
3

Open het menu Instellingen/Voorkeuren en ga naar het gedeelte Telefoonservices. U moet de status van SSO of u bentaangemeld.

(Als een andere telefoonservice, zoals Webex Calling, wordt weergegeven, gebruikt de gebruiker Webex niet voor BroadWorks.)

Deze verificatie betekent:

  • De client is via de vereiste Webex-microservices lopen.
  • De gebruiker heeft zich geverifieerd.
  • De client is uitgegeven een lang-goed JSON-web token door uw BroadWorks-systeem.
  • De client heeft het apparaatprofiel opgehaald en heeft zich geregistreerd bij BroadWorks.

Feedback clientlogboeken feedback

  • Zie het gedeelte Resources voor specifieke clientlogboeken op Webex-desktopclients, of vraag gebruikers om logboeken te verzenden.

  • Vraag gebruikers van mobiele clients om logboeken te verzenden, zodat u ze via de partnerhub of de helpdesk kunt vinden.

Logboeken verzenden is stil. Als een gebruiker echter feedback verzendt, gaat deze naar het team Cisco Webex devops van de app. Neem het feedbacknummer van de gebruiker op als u contact op wilt nemen met Cisco. Bijvoorbeeld:

Belomgevinggegevens krijgen

Webex-clientlogboeken worden sterk opnieuw vastgesteld om persoonlijk identificeerbare informatie te verwijderen. U moet de Gespreksomgevingsgegevens van de client exporteren in dezelfde sessie als u het probleem ziet.

1

Klik in de client op de profielfoto en klik vervolgens op Help > Omgevingsgegevens exporteren.
2

Sla het hieruit voortkomende bestand ced.dat op om belproblemen voor deze gebruiker op te lossen.

Belangrijk: Bij het uit- of opnieuw starten van de client wordt de interne cache gewist. Als u hierna ced.date exporteert, komen de geëxporteerde gegevens niet overeen met de logboeken die vóór de cache zijn verzonden.

Webex-database herstellen

1

Klik op Help en gezondheidscontrole > declient.
2

Selecteer Database herstellen.

Hiermee wordt een volledige reset van de client triggers en wordt het aanmeldscherm van de Webex-app geladen.

Controleer of Webex zich moet registreren bij BroadWorks

De Webex-app controleert de volgende informatie om te bepalen of u zich bij BroadWorks wilt registreren:

  • Gebruikersrechten voor broadworks-connector

  • Oproepgedrag voor organisatie en gebruiker

Het belgedrag en de rechten van een connector controleren

  1. Meld u aan Helpdesk (https://admin.webex.com/helpdesk) met uw aanmeldgegevens van de partnerbeheerder.

  2. Zoek de gebruiker.

  3. Klik op de gebruiker en controleer de invoer Calling Behavior. Het moet 'Bellen in Webex' zijn.

  4. Klik op het gebruikersnaam om het scherm Gebruikersgegevens te openen.

  5. Scrol omlaag om het gedeelte rechten te vinden en controleer ofbroadworks-connector is opgenomen.

    Een Webex voor BroadWorks-gebruiker mag NIET de standaardrechten hebben als hij of zij Webex voor BroadWorks wil gebruiken. Dit is de rechten voor 'Webex Calling (BroadCloud)', wat een Webex-app is die belt via een door Cisco beheerde cloudbelservice.

Controleer het belgedrag van de organisatie

  1. Meld u aan Helpdesk (https://admin.webex.com/helpdesk) met uw aanmeldgegevens van de partnerbeheerder.

  2. Zoek naar de organisatie.

  3. Klik op de organisatie en controleer de vermelding Belgedrag. Het moet 'Bellen in Webex' zijn.

PSLog analyseren voor problemen met gebruikersvoorzieningen

Gebruik het PSLog van de toepassingsserver om het HTTP POST-verzoek naar de inrichtingsbrug en de respons van Webex te bekijken.

Bij een correct werkend geval is het antwoord 200 OK en na een paar minuten kunt u de gebruiker en de nieuwe klant organisatie, als het de eerste gebruiker is, in Webex zien.

U kunt dit verifiëren door op het Helpdesk te zoeken naar het e-mailadres dat u in het BERICHT ziet.

Voordat u begint

Verzamel een PSLog van de toepassingsserver tijdens een flowdoor een provisioningpoging met een testgebruiker.

1

U moet eerst de HTTP-antwoordcode controleren:

  • Alles anders dan 200 OK is een fout bij het inrichten van gebruikers.

  • 200 OK kan nog steeds een fout aangeven als iets over het abonneeprofiel niet werkt in de Webex-services upstream van de provisioningbrug.

  • 400 bevat mogelijk een bericht knooppunt in de respons. De provisioningbrug kan iets niet verwerken in het abonneeProfile. Er is mogelijk iets mis met de gegevens van de abonnee, of incompatibiliteit met een instelling in de sjabloon.

  • 401 betekent dat de in de AS ingevoerde inrichtingsgegevens niet overeenkomen met de gegevens die zijn ingevoerd op de sjabloon in Partner hub.

  • 403 kan wijzen op iets dat niet is geconfigureerd op de toepassingsserver. Controleer het doel van de aanvraag. het mag geen IP-adres zijn, maar de URL voor de provisioningbrug die u in partnerhub op uw sjabloon kunt zien.

  • 409 geeft een conflict aan tussen het opgegeven abonneeprofile en bestaande Webex-gegevens. Mogelijk is er een bestaande gebruiker met dat e-mailadres. Controleer het bericht in het antwoord.
2

U kunt ook het oorspronkelijke HTTP POST controleren op eventuele vermoede waarden die ertoe kunnen leiden dat de inrichting mislukt.

De POST bevat een subscriberProfile XML-structuur. In deze, nuttige knooppunten om te controleren zijn:

  • bwuserid: Gebruik dit om het abonneeprofiel te vinden als u het moet bewerken in BroadWorks.

  • groep: Als de sjabloon in de 'modus serviceprovider organisatie' staat, wordt deze sjabloon ingekapt en wordt deze de naam van de klant organisatie die u in Partner hub ziet.

  • serviceProvider: Als de sjabloon in de 'Enterprise-modus' staat, wordt deze onderstekt en wordt de naam van de klant organisatie die u ziet in Partner Hub.

  • primaryPhoneNumber: Moet bestaan. Provisioning mislukt zonder deze informatie.

  • e-mail: Wordt de Gebruikers-id in Webex. Moet geldig en uniek zijn voor Webex, anders mislukt de inrichting.


 

Negeer de services van : het wordt gemaakt door AS en geaccepteerd, maar niet gebruikt door Webex.

XSP-logboeken analyseren om problemen met aanmelden abonnee op te lossen

Deze flow beschrijft de BroadWorks-verificatiemodus. U kunt de verificatiemodus zien in de BroadWorks-sjabloon in Partner Hub. Zie Uw klantsjablonen configureren in https://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_137726.

Het volgende ladderdiagram toont de interactie tussen de gebruiker, client, Webex-services en BroadWorks-systeem, als de gebruiker BroadWorks-verificatie doet in de Webex-app. Ook wordt de verbinding tussen Webex en de XSP beveiligd door MTLS.

In het gesprek dat daarna wordt besproken, wordt uitgelegd wat u kunt zien wanneer u de logboeken voor een geslaagde aanmelding onderzoekt.

Afbeelding 1. BroadWorks-verificatie en apparaatconfiguratie

Gebruiker werkt met de client, de client werkt met Webex-services:

  • De gebruiker levert zijn/haar e-mailadres aan de Webex-app (1 in diagram).

  • CI weet deze gebruiker om te leiden om het BroadWorks-wachtwoord in te voeren (via UAP) (2 in diagram).

  • De IDP-proxy dient een get-profielverzoek in bij de Xsi-interface op de XSP.

In de tomcat-access_log:

  • Bekijk het GET-verzoek voor het abonneeprofiel, van Webex naar de interface van de Xsi-Acties (2.1 in diagram). Er is de Webex-Gebruikers-id. Bijvoorbeeld.

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

In het XsiActionsLog:

  • Zoek naar het GET-profielverzoek van Webex (2.1 in diagram). Er is de Webex-Gebruikers-id. Bijvoorbeeld.

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

    Deze koppen bevatten autorisatie: Basis-en gebruikersagent: broadworksTeamsClient

  • De XSP doet vervolgens basisverificatie van OCI-P tegen BroadWorks (AuthenticationVerifyRequest en AuthenticationVerifyResponse, zoals elke andere toepassing die basisverificatie via Xsi doet) en ook een UserGetRequest en ServiceProviderGetRequest om de abonneegegevens te verzamelen.

  • De Xsi-respons op Webex bevat een XML-profielblok dat de (BroadWorks) userId en andere gegevens (2.2 in diagram) bevat.

Interacties tussen de client en Webex-services:

  • De IDP-proxy gebruikersprofiel van BroadWorks ontvangen en geeft SAML-bevestiging aan client weer (2.3 in diagram)

  • Client wisselt SAML-bevestiging voor een CI-token uit (3 in diagram)

  • De client controleert of de aangemelde gebruiker over de rechten voor broadworks-connector beschikt (4 in diagram). U kunt de gebruikersrechten controleren in Helpdesk)

  • De client gebruikt CI-token om een JSON-web token (JWT) aan te vragen bij de IDP-proxy (5 in diagram)

  • De proxy van dedp valideert het CI-token bij CI

  • Proxy-proxy-IDP vraagt JWT aan van verificatieservice

In het verificatieservicelogboek:

  • Zoek in het diagram naar de tokenaanvraag van Webex (5.2), bijvoorbeeld:

    GET /authService/token

    die koptekst http_bw_userid andere heeft.

  • Met het XSP-OCI-P UserGetLoginInfoRequest komt deze overeen om te controleren of de opgegeven gebruikers-id overeenkomt met een BroadWorks-gebruiker (5.3 in diagram). AuthService heeft het vertrouwen in Webex bepaald door de mTLS-verbinding te gebruiken. Het kan dus zo zijn dat LLT problemen veroorzaakt.

  • Zoek naar de respons (5.4 in diagram) van LongLivedTokenManager - token gegenereerd, onderwerp: bwksUserId@example.com, vergever: BroadWorks ...

    en StatusCode=200 die u met de traceer-id aan het oorspronkelijke verzoekkunt koppelen: CLIENT... Header.

In het XsiActionsLog:

  • De client kan nu het lange token presenteren in de Xsi-Acties-interface om het apparaatprofiel op te halen (6 in diagram). Bijvoorbeeld.:

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

    Met autorisatie van de kopteksten: Berer token en user-agent: WebexTeams(variant/versie)

  • Met de Xsi-Actions-interface WORDT HET token doorverzonden naar de authservice (geconfigureerd voor gebruik op de loopback-interface) bijvoorbeeld: 127.0.0.1:80 POST http://127.0.0.1:80/authService/token

    die u kunt doen met de trackingid: CLIENT... koptekst in de GET en deX-BROADSOFT-CORRELATIE-ID: CLIENT... koptekst in het BERICHT .

In het verificatieservicelogboek:

  • De ontvangst van het BERICHT van Xsi (loopback)

  • Een StatusCode=200 terug naar Xsi

  • En een tokenvalidatiereactie door een JSON-blok in de body van een tokenvalidatie.

  • Gebruik van de trackingid: Client...

In het XsiActionsLog:

  • Als er 200 OK zijn ontvangen van de authservice, waardoor het token van de client werd gevalideerd, verzendt de Xsi-Actions-toepassing nu OCI-P-verzoek voor UserPrimaryAndSCADeviceGetListRequest

  • Ontvangt OCI-P UserPrimaryAndSCADeviceGetListResponse die de accessDeviceTable XML-structuur bevat.

  • De OCI-P-respons wordt gecodeerd als Xsi-respons op de client, inclusief de XML-structuur AccessDevices, met de deviceTypes bijvoorbeeld Business Communicator - PC en de URL's waarop de client de apparaatconfiguratiebestanden kan ophalen.

Client blijft zoals u gebruikelijk:

  • Selecteert een apparaatinvoer en werkt met DMS om het apparaatprofiel op te halen (6 in diagram)

  • Registeren bij BroadWorks via SBC opgehaald in configuratie van DMS (7 in diagram)