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 klikt 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

Ontvang de clientlogboeken van 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. Zoeken naar de gebruiker (via e-mail).

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

Helpdesk- optie:

  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. Zoeken naar de gebruiker (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 staat.

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 Sessie U bent aangemeld.

(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 doorlopen.
  • 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.

Ontvang clientlogboeken of 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 deze via de partnerhub of de helpdesk kunt ontvangen.


Logboeken verzenden is stil. Als een gebruiker echter feedback verzendt, gaat deze naar het devopsteam van de Webex-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 > Gegevens van belomgeving 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 in de client op Help > gezondheidscontrole.

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

Controleer het belgedrag en de rechten op de connector van een gebruiker

  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 de entitlements en te controleren of broadworks-connector is opgenomen.


    Een Webex voor BroadWorks-gebruiker mag NIET de bc-sp-standard rechten in als zij Webex voor BroadWorks willen gebruiken. Dit is het recht 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 invoer Bellend gedrag. 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 provisioningbrug 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 zien als het de eerste gebruiker is die in Webex is gemaakt.

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 flowtro-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 kan een message knooppunt in de respons. De provisioningbrug kan iets in de subscriberProfile. 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 Partnerhub.

  • 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 de partnerhub op uw sjabloon kunt zien.

  • 409 duidt op een conflict tussen de opgegeven subscriberProfile en bestaande Webex-gegevens. Mogelijk is er een bestaande gebruiker met dat e-mailadres. Controleer de message in het antwoord.

2

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

Het POST-bericht 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.

  • group: Als de sjabloon de 'centrale serviceprovider' heeft, wordt deze sjabloon ingekapt en wordt deze de naam van de klant organisatie die u ziet in Partner hub.

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

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

  • email: wordt het Gebruikers-id in Webex. Moet geldig en uniek zijn voor Webex, anders mislukt de inrichting.


 

Negeer het services Stanza: 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, wanneer de gebruiker BroadWorks-verificatie doet in de Webex-app. Bovendien wordt de verbinding tussen Webex en de XSP beveiligd door MTLS.

In het gesprek dat volgt, 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

    De koppen bevatten authorization: Basic en user-agent: 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.

  • Het Xsi-antwoord op Webex bevat een XML Profile blokkeren dat de (BroadWorks) bevat userId en andere details (2.2 in diagram).

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 in de Helpdesk)

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

  • IDP-proxy valideert CI-token bij CI

  • Proxy-aanvragen 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 http_bw_userid koptekst en anderen te delen.

  • De XSP OCI-P UserGetLoginInfoRequest, 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 maken, zodat llt kan worden veroorzaakt.

  • Bekijk de respons (5.4 in diagram) van LongLivedTokenManager - Token generated, subject: bwksUserId@example.com, issuer: BroadWorks …

    en StatusCode=200 die u met het oorspronkelijke verzoek kunt associëren met de trackingid: 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 de koppen authorization: Bearer token en user-agent: WebexTeams (variant/version)

  • 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 zelf kunt doen met de trackingid: CLIENT… koptekst in de GET en de X-BROADSOFT-CORRELATION-ID : CLIENT… koptekst in de POST.

In het verificatieservicelogboek:

  • De ontvangst van het BERICHT van Xsi (loopback)

  • A StatusCode=200 terug naar Xsi

  • En een tokenvalidatiereactie, met een "token" JSON-blok in de body.

  • Gebruiksd met behulp van de trackingid: CLIENT…

In het XsiActionsLog:

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

  • Ontvangt OCI-P UserPrimaryAndSCADeviceGetListResponse met het volgende: accessDeviceTable XML-structuur.

  • Het OCI-P-antwoord wordt gecodeerd als Xsi-respons op de client, inclusief AccessDevices XML-structuur, 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)