- Webex voor BroadWorks-probleemoplossingsprocessen
- Een probleem escaleren
- Welke clientgegevens u moet verzamelen
- Gebruikersgegevens in de Helpdesk
- Klantorganisatie in deze Helpdesk
- Gebruikerslogboeken ophalen van Partner Hub
- Clientversie vinden
- Clientcontrole voor belservice
- Feedback clientlogboeken feedback
- Belomgevinggegevens krijgen
- Webex-database herstellen
- Controleer of Webex zich moet registreren bij BroadWorks
- PSLog analyseren voor problemen met gebruikersvoorzieningen
- XSP-logboeken analyseren om problemen met aanmelden abonnee op te lossen
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:
Helpdesk:
|
Clientversie vinden
1 | Deze koppeling delen met de gebruiker: https://help.webex.com/njpf8r5. |
2 | Vraag de gebruiker om u het versienummer te sturen. |
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:
|
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 client. |
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
Meld u aan Helpdesk (https://admin.webex.com/helpdesk) met uw aanmeldgegevens van de partnerbeheerder.
Zoek de gebruiker.
Klik op de gebruiker en controleer de invoer Calling Behavior. Het moet 'Bellen in Webex' zijn.
Klik op het gebruikersnaam om het scherm Gebruikersgegevens te openen.
Scrol omlaag om het gedeelte
rechten te vinden en controleer of
broadworks-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
Meld u aan Helpdesk (https://admin.webex.com/helpdesk) met uw aanmeldgegevens van de partnerbeheerder.
Zoek naar de organisatie.
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:
|
||
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
|
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.

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 verzoek
kunt 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
enuser-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 inde GET en de
X-BROADSOFT-CORRELATIE-ID: CLIENT...
koptekst in het BERICHT.
In het verificatieservicelogboek:
De ontvangst van het BERICHT van Xsi (loopback)
Een
StatusCode=200
terug naar XsiEn 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 deaccessDeviceTable
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)