Hartelijk dank voor uw feedback

Dit artikel is bedoeld voor het technische ondersteuningsteam van een serviceprovider die zichzelf en hun klanten ondersteunt. Ze moeten vertrouwd zijn met algemene probleemoplossing, het lezen van logboeken en het werken met abonneegevallen.

Dit artikel is opgedeeld in drie grote delen:

• Hulpbronnen: bevat een lijst met hulpmiddelen, leesmateriaal, logboeken en contactpersonen die u mogelijk nodig hebt.
• Processen — beschrijft enkele acties die u kunt ondernemen om een probleem van een klant op te lossen.
• Specifieke problemen: categoriseert en somt problemen op waarvan bekend is dat ze zich voordoen, hoe u ze kunt herkennen en hoe u ze mogelijk kunt oplossen.

Handige logbestanden

Leeslijst

• Kennisportaal voor partners van Webex voor Cisco BroadWorks
• Configuratiegids voor het XSP-platform (R23)
• Handleiding voor softwarebeheer voor BroadWorks (R23)
• Configuratiegids voor Cisco BroadWorks-apparaatbeheer (R23)
• Handleiding voor het beheer van de Broadworks Xsp Command Line Interface
• Functiebeschrijving van het authenticatietoken met een lange levensduur, release 23.0
• Handleiding voor integratie van SAML-authenticatie, R23
• Handleiding voor Cisco BroadWorks SSL-ondersteuningsopties
• Beschrijving van de Cisco CI-ondersteuningsfunctie
• Push-server voor meldingen (beschrijving van de functie)
• Ondersteuning voor pushmeldingen voor gesprekken Functiebeschrijving Release 22.0
• Connect (Android) Migratie naar Firebase Procedure
• Cisco BroadWorks-opslag van apparaattokens voor pushmeldingen Functiebeschrijving Release 22.0
• Cisco Broadworks Systeemcapaciteitsplanner (spreadsheet)
• Handleiding voor het dimensioneren van het Cisco BroadWorks-platform
• Handleiding voor systeemtechniek van Cisco Broadworks
• Vereisten voor ondersteuning van CI-authenticatie, document, versie 1.0, MR-7136

Bekende problemen en beperkingen

Het artikel Bekende problemen en beperkingen bevat actuele informatie over bekende problemen die we hebben geïdentificeerd in de Webex for BroadWorks-oplossing.

Connector voor onderhoudsgemak

De Webex Serviceability-service verhoogt de snelheid waarmee Cisco-medewerkers voor technische ondersteuning problemen met de infrastructuur kunnen diagnosticeren. Het automatiseert de taken voor het vinden, ophalen en opslaan van diagnoselogboeken en informatie in een SR-case. De service activeert ook analyses op basis van diagnostische handtekeningen, zodat TAC problemen met uw apparatuur op locatie efficiënter kan identificeren en oplossen.

Zie de implementatiegids voor Serviceability Connector voor meer informatie over de implementatie van de Cisco Webex Serviceability-connector.

Een probleem escaleren

Nadat u enkele richtlijnen voor probleemoplossing hebt gevolgd, zou u een redelijk idee moeten hebben van waar het probleem zich bevindt.

Procedure

1. Verzamel zoveel mogelijk informatie via de systemen die verband houden met het probleem.
2. Neem contact op met het juiste team van Cisco om een zaak te openen.

Welke klantinformatie moet ik verzamelen

Als u denkt dat u een hoesje moet openen of een probleem moet escaleren, verzamel dan de volgende informatie terwijl u samen met de gebruiker problemen oplost:

• Gebruikersidentificatie: CI-e-mailadres of UUID van de gebruiker (dit is de Webex-ID, maar als u ook de BroadWorks-ID van de gebruiker krijgt, vermeld deze dan bij de gegevens van de case).
• Identificatiecode van de organisatie.
• Geschatte periode waarin het probleem zich voordeed.
• Clientplatform en -versie.
• Verzend of verzamel logboeken van de klant.
• Noteer de tracking-ID, indien getoond op de client.

Controleer de gebruikersgegevens in de helpdesk

Partnerbeheerders die over de rol van Helpdesk Administrator (Basis of Geavanceerd) beschikken, kunnen deze procedure gebruiken om gebruikersgegevens te controleren met behulp van de Helpdesk-weergave.

Procedure

1. Meld u aan bij de helpdesk.
2. Zoek naar de gebruiker en klik erop. Dit opent het scherm met gebruikersoverzicht.
3. Klik op de gebruikersnaam om de gedetailleerde gebruikersconfiguratie te zien. Nuttige informatie in deze weergave omvat de UUID van de gebruiker, het cluster voor gemeenschappelijke identiteit (CI), het Webex App-cluster, het oproepgedrag, de BroadWorks-account-GUID
4. Klik op Kopiëren als u deze informatie in een ander programma wilt gebruiken, of als u ze aan een Cisco-hoesje wilt koppelen.

Bekijk de klantenorganisatie in de helpdesk

Partnerbeheerders die over de rol van Helpdesk Administrator (Basis of Geavanceerd) beschikken, kunnen deze procedure gebruiken om de gegevens van de klantenorganisatie te bekijken in de Helpdesk-weergave.

Procedure

1. Meld u aan bij de helpdesk.
2. Zoek naar de naam van de klantorganisatie en klik erop.
3. Scroll naar beneden tot u de weergave van het klantenportaal ziet en klik op Klantnaam bekijken om een alleen-lezen weergave van de klantorganisatie te zien , inclusief gebruikers en configuratie.

Gebruikerslogboeken ophalen van Partner Hub

Bij het oplossen van problemen met desktop- en mobiele clients is het belangrijk dat partners (en TAC) de klantenlogboeken kunnen bekijken.

Procedure

1. Vraag de gebruiker om logboeken te verzenden. Zie voor hulp: Webex App | Een probleem melden.
2. Vraag de gebruiker om de oproepomgeving te exporteren en u het bestand ced.dat te sturen.
3. Vraag de klantenlogboeken op bij de Partner Hub of de helpdesk.

   Optie Partner Hub:

   1. Meld u aan bij Partner Hub en zoek de klantenorganisatie van de gebruiker.
   2. Selecteer Probleemoplossing.
   3. Selecteer Logboeken.
   4. Zoek naar de gebruiker (via e-mail).
   5. Bekijk en download de logboeken van de klanten als een zip-bestand.

   Optie voor de helpdesk:

   1. Meld u aan bij de helpdesk.
   2. Zoek naar de organisatie.
   3. Klik op de organisatie (opent het overzichtsscherm).
   4. Scroll naar beneden en klik op Klant bekijken.
   5. Selecteer Probleemoplossing.
   6. Selecteer Logboeken.
   7. Zoek naar de gebruiker (via e-mail).
   8. Bekijk en download de logboeken van de klanten als een zip-bestand.

Hoe vind ik de versie van de client

Procedure

1. Deel deze link met de gebruiker: https://help.webex.com/njpf8r5
2. Vraag de gebruiker om u het versienummer te sturen.

Klantencheck voor de belservice

Procedure

1. Meld u aan bij de Webex-client.
2. Controleer of het pictogram voor gespreksopties (een handset met een tandwiel erboven) aanwezig is op de zijbalk. Als het pictogram niet aanwezig is, is de gebruiker mogelijk nog niet ingeschakeld voor de oproepservice in Control Hub.
3. Open het menu Instellingen/Voorkeuren en ga naar de sectie Telefoondiensten. U zou de status moeten zien van de SSO-sessie. U bent aangemeld. (Als een andere telefoondienst, zoalsWebex Calling, wordt weergegeven, gebruikt de gebruiker Webex niet voor Cisco BroadWorks.)

   Deze verificatie betekent:

   • De klant heeft met succes de vereiste Webex-microservices doorlopen.
   • De gebruiker is succesvol geverifieerd.
   • De client krijgt van uw BroadWorks-systeem een JSON-webtoken met een lange levensduur.
   • De klant heeft zijn apparaatprofiel opgehaald en zich geregistreerd bij BroadWorks.

Logboeken van klanten of feedback opvragen

• Zie de sectie Bronnen om specifieke clientlogboeken te vinden op Webex-desktopclients, of vraag gebruikers om logboeken te verzenden. Zie voor hulp: Webex App | Een probleem melden.
• Vraag gebruikers van mobiele klanten om logboeken te verzenden, dan kunt u ze opvragen via de Partner Hub of de helpdesk.
  Logboeken verzenden is stil. Als een gebruiker echter feedback stuurt, gaat dat naar het DevOps-team van Webex App. Vergeet niet het feedbacknummer van de gebruiker te noteren als u contact wilt opnemen met Cisco. Bijvoorbeeld:

  

Gegevens over de belomgeving opvragen

De logboeken van Webex-klanten worden sterk geredigeerd om persoonlijk identificeerbare informatie te verwijderen. U moet de gegevens van de oproepomgeving van de client exporteren in dezelfde sessie waarin u het probleem opmerkt.

Procedure

1. Klik op de client op Help > Health Checker.
2. Selecteer Database opnieuw instellen. Dit activeert een volledige reset van de client en laadt het inlogscherm van de Webex App.

Controleer of Webex zich moet registreren bij BroadWorks

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

• Het recht van de gebruiker op Broadworks-connector.
• Belgedrag voor organisatie en gebruiker.

Controleer het belgedrag van een gebruiker en de connectorrechten

1. Meld u aan bij de helpdesk met de beheerdersgegevens van uw partner.
2. Zoek naar de gebruiker.
3. Klik op de gebruiker en vink het item Belgedrag aan. Het zou „Calling in Webex” moeten zijn.

   

4. Klik op de gebruikersnaam om het scherm met gebruikersgegevens te openen.
5. Scroll naar beneden om het gedeelte met rechten te vinden en controleer of de Broadworks-connector is inbegrepen

   

   Een gebruiker van Webex voor Cisco BroadWorks zou niet het recht moeten hebben op de bc-sp-standaard als hij van plan is Webex te gebruiken voor Cisco BroadWorks. Dit is het recht voor „Webex Calling(Broadcloud)”, dat is bellen via de Webex-app via een door Cisco beheerde service voor bellen in de cloud.

Controleer het belgedrag van de organisatie

1. Meld u aan bij de helpdesk met de beheerdersgegevens van uw partner.
2. Zoek naar de organisatie.
3. Klik op de organisatie en vink het item Belgedrag aan. Het zou „Calling in Webex” moeten zijn.

Analyseer PSLog voor problemen met de bevoorrading van gebruikers

Gebruik de PSlog van de Application Server om het HTTP POST-verzoek naar de provisioning bridge en het antwoord van Webex te bekijken. In een correct werkend geval is het antwoord 200 OK en na een paar minuten kunt u zien dat de gebruiker - en de nieuwe klantorganisatie als dat de eerste gebruiker is - is aangemaakt in Webex. U kunt dit verifiëren door op de helpdesk te zoeken naar het e-mailadres dat u in de POST ziet.

Voordat u begint

Verzamel een PsLog van de Application Server tijdens een doorstroomprovisioningspoging met een testgebruiker.

Procedure

1. Controleer eerst de HTTP-responscode:
   • Alles anders dan 200 OK is een fout bij de configuratie van de gebruiker.
   • 200 OK kan nog steeds duiden op een storing als iets met het abonneeprofiel niet werkt in de Webex-services vóór de provisioning bridge.
   • 400 kan een berichtknooppunt bevatten in het antwoord. De provisioning bridge kon iets in het SubscriberProfile niet verwerken. Misschien is er iets mis met de abonneegegevens of is er iets niet compatibel met een instelling in de sjabloon.
   • 401 betekent dat de inrichtingsgegevens die op het AS zijn ingevoerd, niet overeenkomen met de inloggegevens die zijn ingevoerd op het sjabloon in Partner Hub.
   • 403 kan erop wijzen dat er iets verkeerd is geconfigureerd op de toepassingsserver. Controleer het doel van de aanvraag. Het mag geen IP-adres zijn, maar de URL voor de inrichtingsbrug die u kunt zien op uw sjabloon in Partner Hub.
   • 409 duidt op een conflict tussen het geleverde SubscriberProfile en bestaande Webex-gegevens. Misschien is er een bestaande gebruiker met dat e-mailadres. Controleer het bericht in het antwoord.
2. U kunt ook in de originele HTTP POST controleren of er verdachte waarden zijn die ertoe kunnen leiden dat de voorziening mislukt. De POST bevat een SubscriberProfile XML-structuur. Hierbinnen zijn handige knooppunten om te controleren:
   • bwuserid: Gebruik dit om het abonneeprofiel te vinden als u dat in BroadWorks moet bewerken.
   • groep: Als de sjabloon in de „Service Provider-modus” staat, wordt dit in kleine letters weergegeven en wordt dit de naam van de klantenorganisatie die u ziet in de Partner Hub.
   • ServiceProvider: Als de sjabloon in „Enterprise-modus” staat, wordt dit in kleine letters weergegeven en wordt dit de naam van de klantenorganisatie die u ziet in de Partner Hub.
   • PrimaryPhoneNumber: Moet bestaan. Zonder dat lukt de bevoorrading niet.
   • e-mail: Wordt de gebruikersnaam in Webex. Moet geldig en uniek zijn voor Webex, anders mislukt de levering.

     Negeer de servicestanza: deze is gemaakt door AS en geaccepteerd, maar wordt niet gebruikt door Webex.

XSP-logboeken analyseren om problemen met het inloggen van abonnees op te lossen

In deze flow wordt de BroadWorks-verificatiemodus beschreven. U kunt de authenticatiemodus zien op de BroadWorks-sjabloon, in de Partner Hub. Zie Uw klantensjablonen configureren op https://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_137726.

Het volgende ladderdiagram toont de interactie tussen de gebruiker, de client, de Webex-services en het BroadWorks-systeem wanneer de gebruiker BroadWorks-authenticatie uitvoert in de Webex-app. Bovendien is de verbinding tussen Webex en de XSP beveiligd met MTLS.

In de discussie die volgt wordt uitgelegd wat u kunt verwachten als u de logboeken onderzoekt op een succesvolle aanmelding.

De gebruiker communiceert met de klant, de klant communiceert met de Webex-services:

• De gebruiker geeft zijn e-mailadres door aan de Webex-app (1 in het diagram).
• CI weet dat deze gebruiker moet worden omgeleid om zijn BroadWorks-wachtwoord in te voeren (via UAP) (2 in het diagram).
• De IDP-proxy stuurt een verzoek om een profiel op te halen naar de Xsi-interface op de XSP.

In het access_log voor kater:

• Zoek naar het GET-verzoek voor het abonneeprofiel, van Webex naar de Xsi-Actions-interface (2.1 in diagram). Het heeft de Webex-gebruikersnaam. Bijvoorbeeld:

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

In het XSIActions-logboek:

• Zoek naar de GET-aanvraag voor het profiel van Webex (2.1 in het diagram). Het heeft de Webex-gebruikersnaam. Bijvoorbeeld:

  GET /com.broadsoft.xsi-actions/v2.0/user/ webexuserid@example.com /profile De kopteksten bevatten autorisatie: Basic en user-agent: BroadworkSteamsClient

• De XSP voert vervolgens OCI-P Basic-authenticatie uit tegen BroadWorks (AuthenticationVerifyRequest en AuthenticationVerifyResponse, zoals elke andere toepassing die basisauthenticatie via Xsi uitvoert) en ook een UserGetRequest en ServiceProviderGetRequest om de abonneegegevens te verzamelen.
• Het Xsi-antwoord op Webex bevat een XML-profielblok met de (BroadWorks) UserID en andere gegevens (2.2 in het diagram).

Interacties tussen klanten en Webex-services:

• De IDP-proxy komt overeen met het gebruikersprofiel dat is ontvangen van BroadWorks en geeft een SAML-bevestiging aan de klant (2.3 in diagram).
• De klant ruilt de SAML-bewering in voor een CI-token (3 in het diagram).
• De client controleert of de aangemelde gebruiker de Broadworks-connectorrechten heeft (4 in het diagram). U kunt de rechten van gebruikers controleren in de helpdesk.
• De klant gebruikt een CI-token om een JSON Web Token (JWT) aan te vragen via de IDP-proxy (5 in het diagram).
• IDP-proxy valideert het CI-token bij CI.
• Een IDP-proxy vraagt JWT aan bij de authenticatieservice.

In het logboek van de AuthenticationService:

• Zoek naar het tokenverzoek van Webex (5.2 in het diagram), bijvoorbeeld: GET /AuthService/Token met een http_bw_userid-header en andere.
• De XSP voert OCI-P UserGetLoginForRequest uit, om te valideren dat de opgegeven gebruikers-id overeenkomt met een BroadWorks-gebruiker (5.3 in diagram). AuthService heeft vertrouwen opgebouwd bij Webex dankzij de MTLS-verbinding, dus kan LLT uitgeven.
• Zoek naar het antwoord (5.4 in diagram) van LongLivedTokenManager - Token gegenereerd, onderwerp: bwksUserId@example.com, uitgever: BroadWorks... en StatusCode=200 dat u kunt koppelen aan het oorspronkelijke verzoek met behulp van de trackingid: CLIENT... header.

In het XSIActions-logboek:

• De klant kan het token met een lange levensduur presenteren op de Xsi-Actions-interface om het apparaatprofiel te krijgen (6 in diagram). Bijvoorbeeld: GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserId %40example.com/profile/device Met de autorisatie van de koptekst: Bearer-token en user-agent: WebExTeams (variant/version)
• De Xsi-Actions-interface STUURT het token naar de authservice (geconfigureerd voor de loopback-interface), bijvoorbeeld: 127.0.0. 1:80 POST http://127.0.0.1:80/authService/token, wat u kunt correleren met de trackingid: CLIENT... header in de GET en de X-BROADSOFT-CORRELATION-ID: CLIENT... header in de POST.

In het logboek van de AuthenticationService:

• De ontvangst van de POST van Xsi (loopback)

• A StatusCode=200 terug naar Xsi

• En een reactie op de validatie van tokens, met een „token” JSON-blok in de body.

• Gecorreleerd met behulp van de tracking-id: CLIENT...

In het XSIActions-logboek:

• Na 200 OK te hebben ontvangen van authservice, die het token van de klant heeft gevalideerd, verstuurt de Xsi-Actions-toepassing nu een OCI-P-verzoek voor UserPrimary en SCADeviceGetListRequest
• Ontvangt OCI-P UserPrimary en SCADeviceGetListResponse die de AccessDeviceTable XML-structuur bevatten.
• Het OCI-P-antwoord is gecodeerd als Xsi-antwoord op de client, inclusief de XML-structuur van AccessDevices, die de DeviceTypes bevat. Bijvoorbeeld: Business Communicator — PC en de URL's waar de client de configuratiebestanden van het apparaat kan ophalen.

De klant gaat gewoon verder:

• Selecteert een apparaatinvoer en werkt samen met DMS om een apparaatprofiel te krijgen (6 in het diagram).
• Registers naar BroadWorks via SBC, opgehaald in configuratie van DMS (7 in diagram).

Problemen met de Partner Hub

1. De beheerder kan de klantenorganisaties niet zien

Als beheerder voor uw partnerorganisatie in Webex moet u de volledige beheerdersrol hebben. Die rol wordt gebruikt om uw partnerorganisatie te beheren, waaronder het toekennen van beheerdersbevoegdheden aan uzelf en anderen. Om klantenorganisaties te beheren, moet u uzelf (of andere mensen) de rol van volledige verkoopadministrateur of verkoopbeheerder toekennen. Zie Accountrollen van een organisatie toewijzen in Control Hub voor meer informatie.

Problemen met de bevoorrading van gebruikers

1. Geïntegreerde IM&P-fouten voor specifieke bedrijven/klanten

Als u een mix van ondernemingen hebt die verschillende diensten voor samenwerking in de cloud gebruiken, bijvoorbeeld UC-One SaaS en Webex voor Cisco BroadWorks, hebt u er misschien voor gekozen om de provisioningadapter per onderneming aan te passen.

Om te controleren wat er is geconfigureerd voor geïntegreerde IM&P (standaard voor ondernemingen, tenzij er een meer specifieke instelling bestaat), voert u as_CLI/Interface/Messaging> get uit. Voor de inrichtingsparameters van een specifieke onderneming opent u de onderneming en gaat u naar Services > Geïntegreerde IM&P.

Controleer of de geïntegreerde IM&P-configuratie voor die onderneming precies overeenkomt met wat wordt weergegeven in de Customer Template in Partner Hub. De volgende instellingen moeten overeenkomen, anders mislukt de bevoorrading voor alle gebruikers in de onderneming:

2. Geïntegreerde IM&P-fouten voor specifieke gebruikers

Dit is van toepassing als u flowthrough-voorzieningen gebruikt en ervan uitgaat dat de voorziening werkt voor bepaalde of de meeste gebruikers (u kunt dus een configuratieprobleem uitsluiten). Als u geïntegreerde IM&P-fouten ziet in BroadWorks, bijvoorbeeld „[Error 18215] Provisioning error with Messaging server” en „[Error 18211] Communicatiefout met Messaging server”, moet u de volgende mogelijke oorzaken onderzoeken:

• Het e-mailadres van de gebruiker bestaat misschien al CI. Zoek naar de gebruiker in de helpdesk om te controleren of zijn e-mailadres er al is. Dit is niet noodzakelijk overtuigend, omdat de gebruiker mogelijk in een organisatie zit waarvan u de gegevens niet mag zien in de helpdesk.
• De gebruiker heeft zich onafhankelijk aangemeld bij Webex, voordat de geïntegreerde IM&P-service werd toegewezen. In dat geval is een optie om de gebruiker zijn gratis accounts te laten verwijderen, zodat hij of zij deel kan uitmaken van de klantenorganisatie die u inricht. De instructies zijn te vinden op https://help.webex.com/5m4i4y
• De gebruiker heeft geen primair telefoonnummer toegewezen aan zijn profiel (alle Webex for Cisco BroadWorks-abonnees moeten een primaire DID hebben). Zie het onderwerp over het analyseren van PsLog vanuit AS.

3. Fouten bij de bevoorrading van gebruikers als reactie op de provisioning bridge

Als gebruikers niet binnen enkele minuten na het toewijzen van Integrated IM&P in Control Hub verschijnen, kijk dan eens naar de responscodes van de provisioning bridge-service. Voer een PSlog uit om de HTTP-responscodes te bekijken.

200 OK

Een antwoord van 200 OK betekent niet dat de gebruiker succesvol is uitgerust. Dit betekent dat de leveringsdienst het verzoek heeft ontvangen en het bijbehorende verzoek om een gebruiker aan te maken met succes heeft ingediend bij de upstream services. De bevoorradingstransactie is asynchroon van opzet. De service reageert 200 OK omdat het aanmaken van een gebruiker enkele minuten kan duren en we om prestatieredenen niet meerdere aanvragen willen ontvangen om dezelfde gebruiker aan te maken. Als de gebruiker echter uiteindelijk niet in de klantenorganisatie verschijnt na een reactie van 200 OK, kan dit erop wijzen dat de aanmaak van de gebruiker in de Webex-services vóór de inrichtingsservice is mislukt. U moet een storing in de bevoorrading escaleren met een respons van 200 OK.

400 Ongeldig verzoek

Controleer het HTTP-antwoord, dat meer informatie zou moeten bevatten over mogelijke problemen die de oorzaak kunnen zijn van dit antwoord van de leveringsdienst. Enkele voorbeelden van het knooppunt:

• „Ik kan de e-mail van BroadWorks met de verouderde provisioning-API niet vertrouwen.” Het e-mailadres dat is gekoppeld aan de mislukte aanvraag voor de verstrekking van de gebruiker is niet geldig of is verkeerd getypt, maar u hebt in het sjabloon aangegeven dat de e-mailadressen betrouwbaar zijn. Controleer de gebruikersprofielen in BroadWorks, met name het e-mailadres.
• De klantenorganisatie is niet gevonden in de database en ook de vlag voor het aanmaken van een nieuwe organisatie is niet ingeschakeld.” Dit mislukte inrichtingsverzoek zou het aanmaken van een nieuwe klantenorganisatie in Webex moeten zijn, maar uw sjabloon is zo geconfigureerd dat er geen nieuwe klantenorganisaties worden aangemaakt. Als u nieuwe organisaties wilt toestaan, voor e-maildomeinen die niet overeenkomen met bestaande klanten in Webex, dan kunt u uw sjabloon opnieuw configureren in Partner Hub en het inrichtingsverzoek opnieuw testen. Als u echter niet verwacht dat er een nieuwe organisatie wordt aangemaakt voor deze gebruiker, is het e-mailadres misschien verkeerd getypt (met name het domeingedeelte). Controleer het e-mailadres van de gebruiker in BroadWorks.

403 Verboden

Het inrichtingsverzoek kan pas slagen als u de configuratie hebt hersteld. In dit geval moet u het verzoek en de reactie onderzoeken. Als u bijvoorbeeld een IP-adres ziet als het doel van het inrichtingsverzoek — in plaats van de juiste provisioning bridge-URL voor uw organisatie (zie de onderwerpen over de firewallconfiguratie in de Solution Guide) — kan dat erop wijzen dat uw toepassingsserver een vereiste patch mist (ap373197).

Controleer of alle vereiste patches zijn toegepast op de Application Server en of u de bijbehorende configuratie hebt voltooid voor een succesvolle doorstroomvoorziening.

409 Conflict

Het inrichtingsverzoek kan niet worden uitgevoerd omdat er een bestaande gebruiker in Webex is die overeenkomt met het e-mailadres in de aanvraag.

4. Gebruiker is al lid van CI

Haal het e-mailadres van de abonnee uit de HTTP POST-aanvraag en zoek ernaar in de helpdesk. Het kan zijn dat u de gebruiker niet ziet als dat niet is toegestaan, maar u kunt ook zien dat de gebruiker deel uitmaakt van een 'vrije' organisatie, bijv. „Consument”. U kunt deze gebruiker vragen om zijn gratis account te verwijderen, of u kunt een ander e-mailadres gebruiken om hem of haar te verstrekken. Zie https://help.webex.com/ndta402.

Problemen met inloggen door de gebruiker

1. Het portaal voor gebruikersactivering wordt niet geladen

De normale aanmeldingsstroom van Webex voor Cisco BroadWorks omvat een portaal voor gebruikersactivering waar gebruikers hun wachtwoorden invoeren. Soms wordt dit portaal niet geladen nadat de gebruiker zijn e-mailadres heeft opgegeven in het aanmeldingsscherm van de Webex App. Dit probleem kan worden veroorzaakt aan de kant van de klant of aan de servicekant. Aan de kant van de klant wordt dit meestal veroorzaakt doordat de eigen browser van de klant op een of andere manier niet compatibel is met de service.

2. Eenmalige aanmelding is mislukt

• Controleer in BroadWorks of aan de gebruiker de apparaattypen voor de Webex-app zijn toegewezen (zie de sectie Apparaatprofielen in de sectie Uw omgeving voorbereiden in de Solution Guide).
• Controleer of de gebruiker het juiste wachtwoord gebruikt. Als het sjabloon dat u hebt gebruikt om de klantenorganisatie van de gebruiker in te richten (in de Partner Hub) is geconfigureerd voor BroadWorks-authenticatie, moet de gebruiker zijn BroadWorks-wachtwoord voor „Web Access” invoeren. De gebruiker moet mogelijk ook zijn BroadWorks-gebruikersnaam invoeren als zijn e-mailadres niet is geconfigureerd als een alternatieve gebruikersnaam. Controleer of de gebruiker hoofdletters en kleine letters juist heeft ingevoerd.

Problemen met de configuratie en registratie van gesprekken

Nadat een gebruiker is voorzien in Webex en hij zich succesvol heeft aangemeld bij de Webex-app, registreert de app zich bij BroadWorks. Dit zijn de verwachte registratiereeks en de daaruit voortvloeiende tekenen van een gezonde registratie (zoals blijkt uit de Webex-app):

1. Verwachte registratiereeks

1. De klant belt XSI om een token voor apparaatbeheer en de URL naar het DMS te krijgen.
2. De klant vraagt zijn apparaatprofiel aan bij DMS door het token uit stap 1 te presenteren.
3. De client leest het apparaatprofiel en haalt de SIP-inloggegevens, -adressen en -poorten op.
4. De klant stuurt een SIP-REGISTER naar SBC op basis van de informatie uit stap 3.
5. SBC stuurt het SIP-REGISTER naar het AS (SBC kan een zoekopdracht uitvoeren in de NS om een AS te vinden als SBC de SIP-gebruiker nog niet kent.).

2. Verwachte tekenen van succesvolle klantenregistratie

Het pictogram Oproepopties verschijnt in de Webex-interface.

Op het tabblad Telefoondiensten van de Webex App (bijv. Instellingen > Telefoonservices op Windows, Voorkeuren > Telefoonservices op de Mac) betekent het bericht „SSO-sessie: u bent aangemeld” dat de app succesvol is geregistreerd (in dit geval bij BroadWorks).

3. De klant heeft geen oproeppictogram

Meestal betekent dit dat de gebruiker niet de juiste licentie/rechten heeft.

Dit is een mislukte registratie. Er zijn meerdere redenen waarom een Webex App-client de registratie bij BroadWorks niet zou kunnen doorstaan:

4. Meerdere beldiensten worden getest bij dezelfde klanten

Dit bekende probleem kan worden veroorzaakt doordat de klant van de ene naar de andere backend wisselt. Dit komt het meest waarschijnlijk voor tijdens proefversies van verschillende beldiensten die via (dezelfde) Webex App-clients worden aangeboden. U kunt de klantendatabase opnieuw instellen (link) om dit probleem te verhelpen.

5. Verkeerde configuratie van de authenticatieservice

Vergelijk de XSP (s) die de authenticatieservice hosten met de Solution Guide (zie Configure Services on your Webex for Cisco BroadWorks XSP's). In het bijzonder:

• De RSA-sleutels (die u op één XSP genereert) worden naar alle XSP's gekopieerd
• De URL van de authenticatieservice is op alle XSP's naar de webcontainer gestuurd en correct ingevoerd in het cluster in Partner Hub
• Externe authenticatie door middel van certificaten is geconfigureerd:

  xsp_cli/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/Certificate Authentication > Get

  allowUserApp = false

  allowClientApp = true

• Als u MTLS gebruikt, moet u het Webex-clientcertificaat uploaden naar de XSP's (u kunt het certificaat verkrijgen bij Partner Hub, op de pagina BroadWorks-instellingen).

6. Verkeerde configuratie van BroadWorks-tags

Controleer of u de vereiste BroadWorks-tags hebt geconfigureerd voor de Webex-app. Raadpleeg de Webex for Cisco BroadWorks Configuration Guide voor informatie over configuratietags. Zorg ervoor dat er geen conflicten of onjuiste waarden zijn. In het bijzonder moet de tag %SBC_ADDRESS_WXT% de SBC zijn voor uw SIP-registrar voor Webex App-clients.

7. De desktopclient verbreekt de verbinding met de telefoondiensten na een succesvolle SSO-verbinding

Dit probleem kan worden veroorzaakt doordat dezelfde gebruiker inlogt bij meerdere klanten op hetzelfde platformtype. Als een gebruiker zich bijvoorbeeld succesvol aanmeldt bij de Webex-app op Windows en zich vervolgens aanmeldt bij de Webex-app op een andere Windows-computer, is er slechts een actieve SSO-sessie op een van de machines. Dit is door het ontwerp. Als u dit probleem absoluut moet omzeilen, kunt u BroadWorks zo configureren dat er meerdere exemplaren van hetzelfde apparaattype zijn, maar die moeten unieke SIP-adressen hebben. Deze configuratie valt buiten het bereik van Webex voor Cisco BroadWorks.

8. Desktopapparaat dat niet beschikbaar is voor de gebruiker

Deze handtekening is te zien in het klantenlogboek:

[0x70000476b000] Broadworks Config Downloader.cpp:106 <Error>

onAccessDeviceListSucceeded:bwc:SCF: ConfigDownload - het apparaatprofiel 'Business Communicator - PC' is niet gevonden.

9. Inkomende mobiele gesprekken gaan één keer over of kunnen niet worden beantwoord

Inkomende gesprekken naar Webex Mobile gaan slechts één keer over, of de gebruiker kan de binnenkomende oproep niet beantwoorden. Andere eindpunten voor dezelfde gebruiker kunnen blijven rinkelen.

Hoe kan ik me identificeren?

Zoek in de logboeken van de mobiele Webex-client naar XSI-foutcode 101002 in de pushgespreksstroom. Bijvoorbeeld:

Antwoordcode: 400

<callID>HandlePushCallInfoFailure:BWC:Intern: Push-oproep: xsi-status voor callID: xsi-foutcode: 101002

<callID>closePushCallWithReason:bwc:Internal: Probeer de pushoproep te sluiten met id =, reason = CallaBandoned

Oorzaak: Foutcode 101002 kan erop wijzen dat de verkeerde Application Server (AS) wordt geretourneerd in het antwoord van LocateUser. Dit kan gebeuren wanneer de gebruiker naar een secundair AS is gemigreerd.

Aanbevolen controles:

Voer LocateUser uit voor de betreffende gebruiker vanaf de ADP of XSP waar Push is geïmplementeerd:

<FQDN or IP address of NS Server>curl 'http: //:80/servlet/locateUser? <BW userID @domain >url=&returncompatiblexsp=true&callprequest=true'

Voorbeeld: curl 'http://1.1.1.1:80/servlet/LocateUser? url= 9721112222@gmail.com &returncompatiblexsp=true&callprequest=true'

Oplossing: Als LocateUser de secundaire AS voor de gebruiker retourneert, voer dan het MigrateUserToDefaultNode.pl-script uit op de primaire NS-server om gebruikers terug te migreren naar de primaire toepassingsserver voor het cluster.

Meld u aan bij de NS-server via SSH, ga naar de map /usr/local/broadworks/bw_base/bin en voer het volgende uit: MigrateUserToDefaultNode.pl <hostingNE>

Voorbeeld: MigrateUserToDefaultNode.pl bwas1

Om de waarde van HostingNE te krijgen, voert u het volgende uit: ns_cli/system/device/hostingNE> get

Het script controleert eerst of het de hosting-NE kan vinden die u als argument opgeeft. Nadat is geverifieerd dat de hosting-NE geldig is, worden de DN, extensie en URL bijgewerkt naar het standaardknooppunt voor die hosting-NE.

Voer het script uit tijdens een periode met weinig verkeer, indien mogelijk. Over het algemeen is het echter acceptabel om het script op elk gewenst moment uit te voeren als dat nodig is om de service voor de betrokken gebruikers te herstellen.

Het script kan niet voor slechts één gebruiker worden uitgevoerd. Het migreert alle gebruikers die zijn vermeld in de LocateUser-uitvoer. Als u het script niet kunt uitvoeren, moet u de betreffende gebruiker in BroadWorks verwijderen en opnieuw opbouwen, zodat de gebruiker opnieuw wordt opgebouwd op het juiste AS.

Elk SIP-bericht van het gebruikersapparaat naar het secundaire AS kan ertoe leiden dat de gebruiker migreert. Gebruikers keren doorgaans terug naar het primaire AS na het standaardinterval van 15 minuten, tenzij binnenkomende aanvragen het secundaire AS blijven bereiken. Als de SBC bijvoorbeeld geen verbinding kan maken met AS1 en terugkeert naar het secundaire AS, kunnen de betrokken gebruikers overschakelen naar het secundaire AS. Afhankelijk van de implementatie kan een enkele trunkgroep of gebruiker aan het secundaire AS blijven vastzitten als de SBC problemen blijft hebben om het primaire AS te bereiken.

Zie de volgende documenten voor meer informatie:

• Paragraaf 3.4.5 Application Server voor het terugdraaien van gebruikers en 5.4.5 Automatisch terugdraaien in de Cisco BroadWorks-redundantiegids

• Beschrijving van de functies van Cisco BroadWorks ASR Enhancements

9. De verbinding met de telefoondiensten is verbroken

Als bij de telefoondiensten wordt aangegeven dat de verbinding is verbroken nadat de gebruiker zich heeft aangemeld bij de Webex-app, of als de telefoondienst de verbinding verbreekt terwijl de gebruiker de client gebruikt, controleer dan het klanttype en de registratiestroom.

Voor Windows- en Mac-clients registreert de Webex-app zich voor SIP en houdt een actieve SIP-registratie bij terwijl de gebruiker is aangemeld.

Controleer het volgende:

1. Controleer of config-wxt.xml succesvol is gedownload.

Zoek in de logboeken van de client naar ConfigDownload.

Een succesvolle download toont aan:

ConfigDownload - succesvol voltooid

Als in de logboeken de volgende fout wordt weergegeven, controleer dan de AuthService-logboeken op tokengerelateerde fouten:

ConfigDownload - is mislukt vanwege de foutcode: 1511

2. Controleer of het Webex-apparaatprofiel is gevonden.

Controleer in de logboeken van de client of het toegangsapparaat is gevonden en dat de used_value 1 is. Als used_value 0 is, controleer dan of Primary Line is ingeschakeld of uitgeschakeld en controleer de tagwaarde. Voor meer informatie, zie paragraaf 6.1.44 Primair profiel in de Webex for BroadWorks Configuration Guide.

Voorbeelden van logboekvermeldingen:

:BWC:SCF: ConfigDownload - toegangsapparaat gevonden

:BWC:SCF: ConfigDownload - toegangsapparaat: DeviceType=Business Communicator - PC, DeviceLevel=Group, allowTermination=1, IsDeviceOwner [has_value: 0, used_value: 1], hasOwnerDevice: 1, EndPointType: Shared Call Appearance

:BWC:SCF: ConfigDownload - toegangsapparaat: DeviceType=Connect - Mobile, DeviceLevel=Group, allowTermination=1, IsDeviceOwner [has_value: 0, used_value: 1], hasOwnerDevice: 1, EndpointType: Shared Call Appearance

:BWC:SCF: ConfigDownload - toegangsapparaat: DeviceType=Connect - Tablet, DeviceLevel=Group, allowTermination=1, IsDeviceOwner [has_value: 0, used_value: 1], hasOwnerDevice: 1, EndpointType: Shared Call Appearance

3. Controleer op DNS-fouten bij het oplossen van het SIP-proxyadres.

Voor meer informatie over SIP-proxydetectie, zie paragraaf 6.1.6 Dynamic SIP Proxy Discovery in de Webex for BroadWorks Configuration Guide.

Een succesvolle proxy-ontdekking toont aan:

De proxydetectie is voltooid, ik heb <number>resultaten

4. Controleer of de SIP-registratie mislukt.

Als in de logboeken mRegistration: TCPTimeout of Reason: SIP; cause=200; text="last=TCP-Timeout” wordt weergegeven, kan de Webex-client geen TCP-verbinding op laag niveau met de SBC tot stand brengen. De SIP-registratie wordt niet voltooid wanneer deze fout optreedt. Controleer of TCP geblokkeerd is op het netwerk van de gebruiker, of de SBC de TCP-verbinding weigert.

Als de SIP REGISTER-aanvraag wordt afgewezen of geen antwoord krijgt, zoek dan in de logboeken naar REGISTER sip en controleer of SIP/2.0 200 OK wordt geretourneerd. Als het niet wordt teruggestuurd, controleer dan of het netwerk van de gebruiker SIP blokkeert of dat de SBC het verzoek afwijst.

Ga in BroadWorks Admin naar Gebruiker > Hulpprogramma's > Registraties en controleer of er een geldige SIP-registratie aanwezig is voor de Webex-client.

Voor mobiele Android- en iOS-clients registreert de Webex-app zich niet voor SIP totdat een gesprek is geplaatst of ontvangen. De registratie wordt verwijderd wanneer het gesprek is voltooid. Mobiele klanten registreren zich voor pushmeldingen.

Voor mobiele klanten, controleer het volgende:

1. Controleer of config-wxt.xml succesvol is gedownload en of het apparaatprofiel is gevonden, zoals beschreven voor Windows- en Mac-clients.

2. Controleer of de pushregistratie geslaagd is.

Zoek in de Webex-logboeken naar de status van de pushregistratie:

onPushRegistrationStateChanged: :De status van de Push-registratie is gewijzigd, state=Niet geregistreerd

onPushRegistrationStateChanged: :De status van de Push-registratie is gewijzigd, state=Geregistreerd

Ga in BroadWorks Admin naar Gebruiker > Hulpprogramma's > Registraties voor pushmeldingen en controleer of er een geldige pushregistratie aanwezig is voor de Webex-client.

Problemen met de webweergave van gesprekken met oproepinstellingen

1. De zelfzorgknop/link wordt niet weergegeven in de Webex-app

Een ander symptoom van dit probleem is wanneer de knop/link wordt weergegeven, maar als u erop klikt, wordt een externe browser geopend.

• Controleer of de vereiste clientconfiguratiesjabloon is geïmplementeerd en dat de CSW-tags juist zijn ingesteld. (Zie de sectie Webview voor oproepinstellingen in de Webex for Cisco BroadWorks Solution Guide).
• Controleer of de Webex-app geregistreerd is voor bellen in BroadWorks.
• Controleer of de Webex-app een recente versie is die CSWV ondersteunt.

2. Lege pagina of fout nadat u op de zelfzorgknop/link hebt geklikt

Over het algemeen duidt dit gedrag in de Webex-app op een configuratie- of implementatieprobleem met de CSWV-toepassing op BroadWorks XSP. Verzamel gegevens voor verder onderzoek, waaronder CSWV-logboeken, toegangslogboeken, de opslagplaats config-wxt.xml en het sjabloonbestand, en breng vervolgens een zaak aan de orde.

Problemen met domeinclaims

Fouten bij de registratie van gebruikers kunnen optreden als gevolg van fouten die zijn gemaakt bij het claimen van domeinen. Voordat u domeinen claimt, moet u ervoor zorgen dat u het volgende begrijpt:

• Dienstverleners mogen geen aanspraak maken op de domeinen van klantenorganisaties die zij beheren. Ze zouden alleen de domeinen moeten claimen van de gebruikers die deel uitmaken van de interne organisatie van de serviceprovider. Het claimen van het domein van gebruikers in een aparte organisatie (zelfs een organisatie die door de serviceprovider wordt beheerd) kan leiden tot registratiefouten voor de gebruikers in de klantorganisatie, aangezien aanvragen voor gebruikersauthenticatie via de serviceprovider worden doorgestuurd in plaats van via de klantorganisatie.
• Als twee klantenorganisaties (bedrijf A en bedrijf B) hetzelfde domein delen en bedrijf A het domein heeft geclaimd, kan de registratie voor gebruikers van bedrijf B mislukken omdat aanvragen voor gebruikersauthenticatie worden doorgestuurd via de organisatie die het domein heeft geclaimd (bedrijf A).

  Als u ten onrechte domeinen claimt en een claim moet verwijderen, raadpleeg dan het Webex-artikel Uw domeinen beheren.

Foutcodes voor eindgebruikers

De volgende tabel bevat foutcodes voor eindgebruikers die te zien zijn op het portaal voor activatie van gebruikers van de client.

Foutcodes voor Directory Sync

De volgende foutcodes zijn van toepassing op Directory Sync.