Felsökning av Webex för Cisco BroadWorks

Den här artikeln är indelad i tre huvudavsnitt:

  • Resurser, vilket är en lista över verktyg, läsa material, loggar och kontakter som du kan behöva.
  • Processer, som beskriver några av de åtgärder du kan utföra vid felsökning av ett kundproblem.
  • Specifika problem, som kategoriserar och listar problem som har varit kända för att inträffa, hur man upptäcker dem och hur du potentiellt kan lösa dem.

Felsökningsresurser för Webex för Cisco BroadWorks

Användbara loggfiler

Loggnamn

Source

Användbar för felsökning

PSLog

Applikationsserver

Genomflödesetablering

hankatt access_log

Xsp

Webex-appen inloggning

XsiActionsLogga inXsp

Webex-appinloggningsinteraktioner med Webex IDP-proxy, klientinteraktioner för enhetsprofilfrågor

verifieringTjänstlogg

Xsp

Webex-appinloggning (tokenvalidering och utfärdande)

XSLogXsp?

Mobilprenumerationer för push-meddelanden

Samtalssignalering

Webex-appens startlogg

Windows: \Users\{username}\AppData\Local\CiscoSpark\current_log.txt

Mac:/Users/{username}/Library/Logs/SparkMacDesktop/current_log

Mobil: Använd Skicka loggar

Startup (sekvens) Rättighetskontroller för användaren

BWC bibliotek initiering för att ansluta till BroadWorks

getUserProfile & JwT token hämtar loggning

BroadWorks-samtal

Webex-applogg

klient

Windows: \Users\{username}\AppData\Local\CiscoSpark\current_log.txt

Mac:/Users/{username}/Library/Logs/SparkMacDesktop/current_log

Mobil: Använd Skicka loggar

All SIP-trafik för registrering och samtal

Håll levande trafik till BWKS Backend

Funktioner mitt i samtalet som kräver signalering (Hold/Resume, Överföring och så vidare.)

Medialogg (Webex Media Engine)

klient

Windows: \Users\{username}\AppData\Local\CiscoSpark\media\*.log

Mac: /Users/{username}/Library/Logs/SparkMacDesktop/media/

Mobil: Använd Skicka loggar

All medialoggning

Kodekar som förhandlats fram för ett samtal

Funktioner i Mitt samtal

Läslista

Kända problem och begränsningar

Artikeln Kända problem och begränsningar innehåller aktuell information om kända problem som vi har identifierat i Webex för BroadWorks-lösningen.

Kontakt för servicemöjlighet

Webex Serviceability-tjänsten ökar hastigheten med vilken Ciscos tekniska supportpersonal kan diagnostisera problem med infrastrukturen. Det automatiserar uppgifterna med att hitta, hämta och lagra diagnostiska loggar och information i ett SR-ärende. Tjänsten utlöser också analys av diagnostiska signaturer så att TAC på ett effektivare sätt kan identifiera och lösa problem med din lokala utrustning.

För mer information om hur du distribuerar Serviceability-anslutningen, se Distributionsguide för Cisco Webex Serviceability Connector.

Felsökningsprocess för Webex för BroadWorks

Eskalering av ett problem

När du har följt några av felsökningsvägledningen bör du ha en skälig idé om var problemet ligger.

Tillvägagångssätt

  1. Samla in så mycket information som möjligt från de system som är relaterade till problemet.
  2. Kontakta lämpligt team på Cisco för att öppna ett ärende.

Vilken klientinformation som ska samlas in

Om du tror att du måste öppna ett ärende eller eskalera ett problem samlar du in följande information när du felsöker med användaren:

  • Användaridentifierare: CI-e-postadress eller användar-UUID (detta är Webex-identifieraren, men om du också får användarens BroadWorks-identifierare hjälper det).
  • Organisationsidentifierare.
  • Ungefärlig tidsram under vilken problemet uppstod.
  • Klientplattform och version.
  • Skicka eller samla in loggar från klienten.
  • Registrera spårnings-ID om det visas på klienten.

Kontrollera användaruppgifter i helpdesk

Partneradministratörer som har behörighet för rollen Help Desk-administratör (grundläggande eller avancerad) kan använda den här proceduren för att kontrollera användarinformation med hjälp av Help Desk-vyn.

Tillvägagångssätt

  1. Logga in på Helpdesk.
  2. Sök efter och klicka sedan på användaren. Då öppnas skärmbilden användarsammanfattning.
  3. Klicka på användarnamn för att se den detaljerade användarkonfigurationen. Användbar information i den här vyn inkluderar användarens UUID, CI-kluster (Common Identity), Webex-appkluster, samtalsbeteende och BroadWorks-konto-GUID.
  4. Klicka på Kopiera om du behöver använda den här informationen i ett annat verktyg, eller bifoga den till ett Cisco-ärende.

Visa kundorganisation i Help Desk

Partneradministratörer som har behörighet för rollen Help Desk-administratör (grundläggande eller avancerad) kan använda den här proceduren för att visa information om kundorganisationen i Help Desk-vyn.

Tillvägagångssätt

  1. Logga in på Helpdesk.
  2. Sök efter och klicka sedan på kundens organisationsnamn.
  3. Scrolla ned tills du ser Kundportalvy och klicka på Visa kundnamn för att se en skrivskyddad vy av kundorganisationen – inklusive användare och konfiguration.

Hämta användarloggar från Partner Hub

Vid felsökning av problem med stationära och mobila klienter är det viktigt att partners (och TAC) kan se klientloggarna.

Tillvägagångssätt

  1. Be användaren att skicka loggar. Mer information finns i: Webex-appen | Rapportera ett problem.
  2. Be användaren att exportera anropsmiljön och skicka filen ced.dat till dig.
  3. Hämta klientloggarna från Partner Hub eller Help Desk.

    Partner Hub-alternativ:

    1. Logga in på Partner Hub och hitta användarens kundorganisation.
    2. Välj Felsökning.
    3. Välj Loggar.
    4. Sök efter användaren (via e-post).
    5. Visa och hämta klientloggarna som en zip-fil.

    Help Desk alternativ:

    1. Logga in på Help Desk.
    2. Sök efter organisationen.
    3. Klicka på organisationen (öppnar sammanfattningsskärmen).
    4. Scrolla ned för att klicka på Visa kund.
    5. Välj Felsökning.
    6. Välj Loggar.
    7. Sök efter användaren (via e-post).
    8. Visa och hämta klientloggarna som en zip-fil.

Hur man hittar klientversionen

Tillvägagångssätt

  1. Dela den här länken med användaren: https://help.webex.com/njpf8r5
  2. Be användaren att skicka versionsnumret till dig.

Klientkontroll för samtalstjänst

Tillvägagångssätt

  1. Logga in på Webex-klienten.
  2. Kontrollera att ikonen Samtalsalternativ (en telefon med kugghjulet ovanför) finns på sidopanelen. Om ikonen inte finns är det möjligt att användaren ännu inte har aktiverats för samtalstjänsten i Control Hub.
  3. Öppna menyn Inställningar/Inställningar och gå till avsnittet Telefontjänster. Du bör se statusen SSO Session Du är inloggad. (Om en annan telefontjänst, t.ex. Webex Calling med, visas att användaren inte använder Webex för Cisco BroadWorks.)

    Den här verifieringen innebär:

    • Klienten har förflyttat sig över de Nödvändiga Webex-mikrotjänster.
    • Användaren har verifierats.
    • Klienten får en långlivad JSON-webbtoken av ditt BroadWorks-system.
    • Klienten har hämtat enhetsprofilen och har registrerats i BroadWorks.

Hämta klientloggar eller feedback

  • Se avsnittet Resurser för att hitta specifika klientloggar på Webex-skrivbordsklienter eller be användare att skicka loggar. Mer information finns i: Webex-appen | Rapportera ett problem.
  • Be användare av mobilklienter att skicka loggar och sedan kan du få dem via en partnerhubb eller helpdesk.

    Skicka loggar är tyst. Men om en användare skickar feedback går den till devops-teamet för Webex-appen. Se till att spela in användarens feedbacknummer om du vill följa upp med Cisco. Till exempel:

    ärendenummer för inskickat stödärende

Hämta data för samtalsmiljö

Webex-klientloggar är i stort fel för att ta bort personligt identifierbar information. Du bör exportera samtalsmiljödata från klienten i samma session som du märker problemet.

Tillvägagångssätt

  1. Klicka på Hjälp i klienten. > Hälsokontroll.
  2. Välj Återställ databas. Detta utlöser en fullständig återställning av klienten och läser in inloggningsskärmen för Webex-appen.

Verifiera att Webex ska registreras hos BroadWorks

Webex-appen kontrollerar följande information för att avgöra om den ska registreras i BroadWorks:

  • Användarrättighet till broadworks-connector.
  • Anropsbeteende för organisation och användare.

Kontrollera en användares samtalsbeteende och anslutningsberättigande

  1. Logga in på Help Desk med dina partneradministratörsuppgifter.
  2. Sök efter användaren.
  3. Klicka på användaren och kontrollera posten Samtalsbeteende. Det ska vara "Ringer i Webex".

    kontrollera en användares samtalsbeteende

  4. Klicka på användarnamn här sidan för att öppna skärmbilden Användarinformation.
  5. Scrolla ned för att hitta avsnittet entitlements och kontrollera att broadworks-connector finns med

    Skärm för användarinformation – Broadworks-anslutning aktiverad

    En Webex för Cisco BroadWorks-användare bör INTE ha behörigheten bc-sp-standard om de avser att använda Webex för Cisco BroadWorks. Detta är berättigandet för "Webex Calling (Broadcloud)" som är samtal från Webex-appar via en Cisco-hanterad molnsamtalstjänst.

Kontrollera organisationens samtalsbeteende

  1. Logga in på Help Desk med dina partneradministratörsuppgifter.
  2. Sök efter organisationen.
  3. Klicka på organisationen och markera posten Samtalsbeteende. Det ska vara "Ringer i Webex".

Analysera PSLog för problem med användarprovisionering

Använd programserverns PSLog för att se HTTP POST-begäran till etableringsbryggan och svaret från Webex. I ett korrekt arbetsfall är svaret 200 OK och efter några minuter kan du se användaren och den nya kundorganisationen om den är den första användaren – har skapats i Webex. Du kan verifiera detta genom att Help Desk efter den e-postadress du ser i POST.

Innan du börjar

Samla in en PSLog från programservern under ett flowuppräckningsförsök med en testanvändare.

Tillvägagångssätt

  1. Det första du ska kontrollera är HTTP-svarskoden:
    • Allt annat än 200 OK är ett fel vid användareablering.
    • 200 OK kan fortfarande indikera ett fel om något med prenumerantprofilen inte fungerar i Webex-tjänsterna uppströms om provisioneringsbryggan.
    • 400 kan innehålla en message -nod i svaret. Provisioneringsbryggan kunde inte bearbeta något i subscriberProfile. Det kan vara något fel med prenumerantinformationen eller inkompatibilitet med mallens inställning.
    • 401 innebär att de inloggningsuppgifter för provisionering som angetts i AS inte överensstämmer med de som angavs i mallen i partnerhubben.
    • 403 kan indikera att något är felaktigt konfigurerat på programservern. Kontrollera målet för förfrågan. det ska inte vara en IP-adress, utan den URL för tillhandahållande bridge som du kan se i din mall i partnerhubben.
    • 409 indikerar en konflikt mellan den angivna subscriberProfile och befintliga Webex-data. Det kan finnas en befintlig användare med den e-postadressen. Markera message i svaret.
  2. Du kan även kontrollera original-HTTP POST med alla misstänker värden som kan orsaka att etableringen misslyckas. POST-filen innehåller en subscriberProfile XML-struktur. I detta är användbara noder att kontrollera:
    • bwuserid: Använd denna för att hitta prenumerantens profil om du behöver redigera den i BroadWorks.
    • group: Om mallen är i "Tjänsteleverantörsläge" skrivs detta med gemener och blir namnet på kundorganisationen som du ser i Partner Hub.
    • serviceProvider: Om mallen är i "Företagsläge" är denna i små bokstäver och blir namnet på den kundorganisation du ser i partnerhubben.
    • primaryPhoneNumber: Måste finnas. Etablering misslyckas utan den.
    • email: Blir användar-ID i Webex. Måste vara giltigt och unikt för Webex, annars misslyckas etableringen.

      Ignorera strofen services : den skapas av AS och accepteras men används inte av Webex.

Analysera XSP-loggar för att felsöka prenumerantinloggning

Det här flödet beskriver BroadWorks-autentiseringsläge. Du kan se autentiseringsläget för BroadWorks-mallen i Partner Hub. Se Konfigurera kundmallar i https://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_137726.

Följande stegdiagram visar interaktionen mellan användaren, klienten, Webex-tjänsterna och BroadWorks-systemet när användaren utför BroadWorks-autentisering i Webex-appen. Dessutom är anslutningen mellan Webex och XSP säkrad av MTLS.

Diskussionen som följer förklarar vad du kan förvänta dig att se när du undersöker loggarna för en lyckad inloggning. Analysera XSP-loggar för att felsöka prenumerantinloggning -flöde

Användaren interagerar med klient, klienten interagerar med Webex-tjänster:

  • Användaren levererar sin e-postadress till Webex-appen (1 i diagrammet).
  • CI vet att omdirigering av användaren ska ange sitt BroadWorks-lösenord (via UAP) (2 i diagrammet).
  • IDP-proxyn skickar in en begäran om att hämta profilen till Xsi-gränssnittet på XSP:en.

I hankatten access_log:

  • Sök efter GET-begäran för prenumerantens profil från Webex till Xsi-Actions-gränssnittet (2.1 i diagrammet). Den har Webex-användar-id. Till exempel:

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

I XsiActionsLog:

  • Sök efter profilen GET-begäran från Webex (2.1 i diagrammet). Den har Webex-användar-id. Till exempel:

    GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile Rubrikerna inkluderar authorization: Basic och user-agent: broadworksTeamsClient

  • XSP gör sedan RESPONS-P Basic-autentisering mot BroadWorks (AuthenticationVerifyRequest och AuthenticationVerifyResponse, precis som för alla andra program som gör grundläggande autentisering via Xsi) och även en UserGetRequest och ServiceProviderGetRequest för att samla in prenumerantens information.
  • Xsi-svaret till Webex innehåller ett XML Profile -block som innehåller (BroadWorks) userId och andra detaljer (2.2 i diagrammet).

Interaktioner mellan klienter och Webex-tjänster:

  • IDP-proxy matchar användarprofilen som mottagits från BroadWorks och utfärdar SAML-kontroll till klienten (2.3 i diagrammet).
  • Klienten utbyter SAML-assertion mot en CI-token (3 i diagrammet).
  • Klienten kontrollerar att den inloggade användaren har broadworks-connector-behörighet (4 i diagrammet). Du kan kontrollera användarrättigheter i Help Desk.
  • Klienten använder en CI-token för att begära en JSON Web Token (JWT) från en IDP-proxy (5 i diagrammet).
  • IDP-proxy validerar CI-token vid CI.
  • IDP-proxy begär JWT från autentiseringstjänsten.

I authenticationService-loggen:

  • Leta efter tokenbegäran från Webex (5.2 i diagrammet), till exempel: GET /authService/token som har http_bw_userid rubrik och andra.
  • XSP:n använder OCI-P UserGetLoginInfoRequestför att validera att det angivna användar-ID:t motsvarar en BroadWorks-användare (5.3 i diagrammet). AuthService har etablerat förtroende för Webex genom mTLS-anslutningen, så kan problemet LLT.
  • Leta efter svaret (5.4 i diagrammet) från LongLivedTokenManager - Token generated, subject: bwksUserId@example.com, issuer: BroadWorks … och StatusCode=200 som du kan associera med den ursprungliga begäran med hjälp av rubriken trackingid: CLIENT… .

I XsiActionsLog:

  • Klienten kan presentera den långlivade token i Xsi-Actions-gränssnittet för att hämta dess enhetsprofil (6 i diagrammet). Till exempel: GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserId%40example.com/profile/device Med rubrikerna authorization: Bearer token och user-agent: WebexTeams (variant/version)
  • Xsi-Actions-gränssnittet skickar token till authservice (konfigurerat att vara på loopback-gränssnittet) Till exempel: 127.0.0.1:80 POST http://127.0.0.1:80/authService/token som du kan korrelera med trackingid: CLIENT… -rubriken i GET och X-BROADSOFT-CORRELATION-ID : CLIENT… -rubriken i POST.

I authenticationService-loggen:

  • Post har mottagits från Xsi (loopback)

  • En StatusCode=200 tillbaka till Xsi

  • Och ett tokenvalideringssvar, med ett "token" JSON-block i brödtexten.

  • Är förknippad med användning av trackingid: CLIENT…

I XsiActionsLog:

  • Efter att ha mottagit 200 OK från authservice, vilket validerade klientens token, skickar Xsi-Actions-applikationen nu en OCI-P-förfrågan för UserPrimaryAndSCADeviceGetListRequest
  • Tar emot OCI-P UserPrimaryAndSCADeviceGetListResponse som innehåller XML-strukturen accessDeviceTable.
  • OCI-P-svaret är kodat som Xsi-svar till klienten, inklusive AccessDevices XML-strukturen, som har deviceTypes. Till exempel: Business Communicator – PC och URL:er där klienten kan hämta enhetens konfigurationsfiler.

Klienten fortsätter som vanligt:

  • Väljer en enhetspost och interagerar med DMS för att hämta enhetsprofilen (6 i diagrammet).
  • Register till BroadWorks via SBC hämtade i konfigurationen från DMS (7 i diagrammet).

Felsökning av specifika problem i Webex för BroadWorks

Problem med Partner Hub

Administratören kan inte se kundorganisationer

Som administratör för din partnerorganisation i Webex bör du ha rollen Fullständig administratör. Den rollen används för att hantera din partnerorganisation, inklusive tilldelning av administratörsbehörigheter till dig själv och andra. För att hantera kundorganisationer måste du ge dig själv (eller andra personer) rollen Fullständig försäljningsadministratör eller rollen Försäljningsadministratör . Mer information finns i Tilldela organisationskontoroller i Control Hub.

Problem med användarprovisionering

Integrerad snabbmeddelanden & P-fel för specifika företag / kunder

Om du har en blandning av företag som använder olika cloud collaboration-tjänster, t.ex. UC-One SaaS och Webex för Cisco BroadWorks, kan du ha valt att ändra provisioneringsadaptern på en företagsnivå.

Så här kontrollerar du vad som är konfigurerat för integrerade snabbmeddelanden & P (standard för företag, såvida inte en mer specifik inställning finns), kör AS_CLI/Interface/Messaging> get. För ett specifikt företags provisioneringsparametrar, öppna företaget och gå till Tjänster > Integrerad snabbmeddelanden & P.

Kontrollera att det integrerade im&P-konfiguration för det företaget matchar exakt vad som visas i kundmallen i partnerhubben. Följande inställningar måste matcha eller så misslyckas etableringen för alla användare i företaget:

BroadWorks Enterprise-integrerad IM&P-inställning Inställning för kundmall för partnerhubben
URL till meddelandeserver Webbadress för tillhandahållande
Användarnamn för meddelandeserverNamn på provisioneringskonto
Lösenord för meddelandeserverLösenord för tillhandahållande konto, bekräfta lösenord

Integrerad snabbmeddelanden & P-fel för specifika användare

Det här gäller om du använder flow flera etableringar och förutsätter att etableringen fungerar för vissa/de flesta användare (så att du kan utesluta ett konfigurationsproblem). Om du ser integrerade IM&P-fel i BroadWorks, t.ex. "[Fel 18215] Etableringsfel med Meddelandeserver" och "[Error 18211] Kommunikationsfel med meddelandeserver" bör du undersöka följande potentiella orsaker:

  • Användarens e-postadress kunde redan finnas CI. Sök efter användaren i Help Desk kontrollera om deras e-postadress redan finns där. Detta är inte nödvändigtvis slutgiltiga, eftersom användaren kan finnas i en organisation vars data du inte har tillstånd att se i Help Desk.
  • Användaren har själv registrerat sig för Webex innan han/hon tilldelas den integrerade IM&P-tjänsten. I det här fallet är ett alternativ att låta användaren ta bort sina gratiskonton så att de kan bli en del av den kundorganisation som du etablerar. Instruktionerna finns på https://help.webex.com/5m4i4y
  • Användaren har inte ett primärt telefonnummer tilldelat till sin profil (alla Webex-prenumeranter för Cisco BroadWorks måste ha en primär DID). Se ämnet på analysen av PSLog från AS.

Användarprovisioneringsfel som svar från provisioneringsbryggan

Om användare inte visas i Control Hub bör du inom några minuter efter att du har tilldelat integrerat IM&P titta på svarstidskoderna från tjänsten för tillhandahållande bryggor. Kör en PSLog för att titta på HTTP-svarskoderna.

200 OK

Ett 200 OK-svar betyder inte att användaren har etablerats korrekt. Det innebär att etableringstjänsten tog emot begäran och skickade motsvarande begäran om skapande av användare till tjänster uppströms. Transaktionen för tillhandahållande är asynkron genom design. Tjänsten svarar på 200 OK eftersom processen för att skapa användare kan ta flera minuter, och av prestandaskäl vill vi inte ta emot flera förfrågningar om att skapa samma användare. Men om användaren inte så småningom visas i kundorganisationen efter ett 200 OK-svar, kan det indikera att användarens skapande misslyckades i Webex-tjänsterna före etableringstjänsten. Du måste eskalera ett etableringsfel som har ett 200OK-svar.

400 dålig begäran

Kontrollera HTTP-svaret som bör ha mer detaljerad information om potentiella problem som kan orsaka detta svar från etableringstjänsten. Några exempel på nod:

  • "Kan inte lita på BroadWorks-e-post med äldre etablerings-API." Den e-postadress som är kopplad till begäran om att användare inte tillhandahållande har misslyckats är ogiltig eller är felaktigt inskrivna, men du har angett i mallen som e-postadresserna kan vara betrodda. Kontrollera användarnas profiler i BroadWorks, specifikt e-post-ID:
  • Kundorganisationen hittades inte i databasen och flaggan för att skapa en ny organisation är inte aktiverad. Denna misslyckade etableringsbegäran bör skapa en ny kundorganisation i Webex, men din mall är konfigurerad för att förhindra att nya kundorganisationer skapas. Om du vill tillåta nya organisationer för e-postdomäner som inte matchar befintliga kunder i Webex, kan du konfigurera om mallen i Partner Hub och testa etableringsbegäran på nytt. Om du inte förväntade dig att en ny organisation skulle skapas för denna användare kanske e-postadressen är felaktig (särskilt domändelen). Kontrollera användarens e-post-ID i BroadWorks.

403 Förbjuden

Förfrågan om tillhandahållande har ingen chans att lyckas. I detta fall måste du undersöka begäran och svaret. Om du exempelvis ser en IP-adress som mål för etableringsbegäran – i stället för lämplig URL för etableringsbryggan för din organisation (se ämnen om brandväggskonfigurationen i Lösningsguide) – kan det indikera att din programserver saknar en obligatorisk programfix (ap373197).

Kontrollera att alla nödvändiga programfixar tillämpas på programservern och att du har slutfört relaterad konfiguration för lyckad flowavetablering.

409 Konflikt

Provisioneringsbegäran kan inte fortsätta eftersom det finns en befintlig användare i Webex som matchar e-postadressen i förfrågan.

Användaren finns redan i CI

Få prenumerantens e-post från HTTP POST-begäran och sök efter den i Help Desk. Du kanske inte ser användaren om du inte är tillåten, men du kan även se att användaren är i en "gratis"-organisation, t.ex. "konsument". Du kan be den här användaren att radera sitt kostnadsfria konto eller så kan du använda en annan e-postadress för att tillhandahålla dem. Se .https://help.webex.com/ndta402

Problem med användarinloggning

Användaraktiveringsportalen laddas inte

Det normala inloggningsflödet för Webex för Cisco BroadWorks inkluderar en användaraktiveringsportal där användare anger sina lösenord. Ibland läses inte denna portal in när användaren har angett sin e-postadress i inloggningsskärmen i Webex-appen. Problemet kan orsakas på klientsidan eller på tjänstsidan. På klientsidan orsakas det vanligtvis av att kundens inbyggda webbläsare är inkompatibel på något sätt med tjänsten.

Enkel inloggning misslyckades

  • I BroadWorks kontrollerar du att användaren har tilldelats enhetstyperna för Webex-appen (se avsnittet Enhetsprofiler i avsnittet Förbered din miljö i lösningsguiden).
  • Kontrollera att användaren använder rätt lösenord. Om mallen som du använde för att etablera användarens kundorganisation (i Partner Hub) är konfigurerad för BroadWorks-autentisering, bör användaren ange sitt BroadWorks-lösenord för "webbåtkomst". Användaren kan också behöva ange sitt BroadWorks-användar-ID om deras e-postadress inte är konfigurerad som ett alternativt användar-ID. Se till att användaren har angett korrekt stora och små tecken.

Problem med anropskonfiguration och registrering

När en användare har registrerats i Webex och de har loggat in i Webex-appen registreras appen i BroadWorks. Följande är den förväntade registreringssekvensen och de resultat som resulterar i en frisk registrering (som kan ses från Webex-appen):

Förväntad registreringssekvens

  1. Klienten ringer upp XSI för att få en token för enhetshantering och URL:en till DMS.
  2. Klienten begär sin enhetsprofil från DMS genom att presentera token från steg 1.
  3. Klienten läser in enhetsprofilen och hämtar SIP-inloggningsuppgifter, adresser och portar.
  4. Klienten skickar en SIP-REGISTRERING till SBC med hjälp av informationen från steg 3.
  5. SBC skickar SIP-REGISTER till AS (SBC kan göra en sökning i NS för att hitta ett AS om SBC inte redan känner till SIP-användaren).

Förväntade tecken på lyckad klientregistrering

Samtalsalternativ-ikonen visas i Webex-gränssnittet.

I Webex-appens fliken för telefontjänster (t.ex. Inställningar > Telefontjänster i Windows, Inställningar > Telefontjänster på Mac), meddelandet “SSO-session: Du är inloggad" innebär att appen har registrerats (till BroadWorks i det här fallet).

Klienten har ingen samtalsikon

För det mesta innebär detta att användaren inte har rätt licens/berättigande.

Klienten visar fliken Telefontjänster men ingen SSO-session

Webex-klienten visar fliken Telefontjänster men ingen SSO-session

Detta är en misslyckad registrering. Det finns flera orsaker till att en Webex-appklient inte registrerades hos BroadWorks:

Flera samtalstjänster testas med samma klienter

Det här kända problemet kan orsakas av att klienten ändrar mellan olika avslutat uppringning. Det förekommer troligtvis under provperioder av olika samtalstjänster som erbjuds via (samma) Webex-appklienter. Du kan återställa klientdatabasen (länk) för att åtgärda detta problem.

Felkonfiguration av autentiseringstjänsten

Kontrollera XSP:erna som är värd för verifieringstjänsten mot lösningsguiden (se Konfigurera tjänster på din Webex för Cisco BroadWorks XSPs). Så här gör du:

  • RSA-tangenterna (som du genererar på en XSP) kopieras till alla XSP:er
  • URL:en för verifieringstjänsten har tillhandahållits till webbbehållaren på alla XSP:er och har angetts korrekt i klustret i partnerhubben
  • Extern verifiering av certifikat har konfigurerats:

    XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication>get

    allowUserApp = false

    allowClientApp = true

  • När du använder MTLS måste du ladda upp Webex-klientcertifikatet till XSP:erna (du kan hämta certifikatet från Partner Hub på sidan BroadWorks-inställningar).

Felaktig konfiguration av BroadWorks-taggar

Kontrollera att du har konfigurerat de BroadWorks-taggar som krävs för Webex-appen. Se Webex för Cisco BroadWorks-konfigurationsguiden för information om konfigurationstaggar. Se till att det inte finns några konflikter eller felaktiga värden. Mer specifikt bör taggen %SBC_ADDRESS_WXT% vara SBC mot din SIP-registrator för Webex-appklienter.

Skrivbordsklienten kopplar bort telefontjänster efter lyckad SSO-anslutning

Problemet orsakas av att samma användare loggar in på flera klienter på samma plattformstyp. Om till exempel en användare loggar in på Webex-appen i Windows och sedan loggar in på Webex-appen på en annan Windows-dator, finns det bara en aktiv SSO-session på en av datorerna. Detta är avsiktligt. Om du absolut måste arbeta runt detta problem kan du konfigurera BroadWorks så att det finns flera instanser av samma enhetstyp, men de måste ha unika SIP-adresser. Den här konfigurationen ligger utanför Webex-omfattningen för CiscoBroadWorks.

Skrivbordsenheten har inte tillhandahållits för användaren

Denna signatur syns i klientloggen:

[0x70000476b000] BroadWorksConfigDownloader.cpp:106

onAccessDeviceListSucceeded:BWC:SCF: ConfigDownload - the device profile 'Business Communicator - PC' is not found.

Problem med webbvyn för samtalsinställningar

Självvård button/link visas inte i Webex-appen

Ett annat symtom för detta problem är när knappen/länken visas, men när man klickar öppnas en extern webbläsare.

  • Kontrollera att den nödvändiga klientkonfigurationsmallen har distribuerats och att CSW-taggar är korrekt inställda. (Se avsnittet Samtalsinställningar Webview i lösningsguiden för Webex för Cisco BroadWorks).
  • Kontrollera att Webex-appen är registrerad för samtal i BroadWorks.
  • Kontrollera att Webex-appen är en ny version som har stöd för CSWV.

Tom sida eller felmeddelande efter att ha klickat på Självhjälp button/link

Den här funktionen i Webex-appen indikerar generellt sett ett konfigurations- eller distributionsproblem med CSWV-programmet på BroadWorks XSP. Samla in detaljer för vidare undersökning, inklusive CSWV-loggar, åtkomstloggar, lagringsplats för config-wxt.xml och mallfil och höj sedan ett ärende.

Problem med domänanspråk

Fel för användarregistrering kan uppstå till följd av fel som görs i anspråk av domäner. Innan du gör anspråk på några domäner måste du se till att du förstår följande:

  • Tjänsteleverantörer bör inte göra anspråk på domänerna för kundorganisationer som de hanterar. De ska endast göra anspråk på domänerna för de användare som finns tjänsteleverantör företagets interna organisation. Att göra anspråk på användardomänen i en separat organisation (även en som tjänsteleverantör hanterar) kan resultera i registreringsfel för användarna i kundorganisationen när begäran om användarautentisering dirigeras via tjänsteleverantör i stället för till kundorganisationen.
  • Om två kundorganisationer (företag A och företag B) delar samma domän och företag A har gjort anspråk på domänen, kan registrering för företag B-användare misslyckas på grund av att begäran om användarautentisering dirigeras via organisationen som har domänen fordrat (företag A).

    Om du gör anspråk på någon av domänerna i fel form och behöver ta bort ett anspråk, se Webex-artikeln Hantera dina domäner.

Felkoder för slutanvändare

Följande tabell sammanfattar felkoder för slutanvändare som kan ses i klientens portal för användaraktivering.

Detta är inte en uttömmande lista över felkoder. Tabellen visar endast befintliga felkoder för vilka Webex-appen för närvarande inte ger användaren tydlig ledning.

Tabell 1. Tabell 1: Felkoder för slutanvändare

Felkod

Felmeddelande

Förslag till åtgärd

100006

Inloggningen misslyckades: Användare ID/Password är felaktig.

Kontrollera att användaren använder rätt lösenord. Om mallen som du använde för att etablera användarens kundorganisation (i Partner Hub) är konfigurerad för BroadWorks-autentisering, bör användaren ange sitt BroadWorks-lösenord för "webbåtkomst". Användaren kan också behöva ange sitt BroadWorks-användar-ID om deras e-postadress inte är konfigurerad som ett alternativt användar-ID.

Se till att användaren har angett korrekt stora och små tecken.

200010

Misslyckades med att validera inloggningsuppgifter eftersom BroadWorks-användaren inte var auktoriserad.

Användare bör försöka med en annan kombination av användarnamn och lösenord.

Annars måste administratören återställa lösenordet i BroadWorks.

200013

Tyvärr kan du inte gå med i <name of SP offer> med Webex just nu. Försök igen om några minuter. Om problemet kvarstår, vänligen kontakta din <customer organization administrator>.

Det gick inte att uppdatera användarinformationen i Common Identity. Uppdatera användaren igen med hjälp av användar-API:et.

200014

Vänligen kontakta din <Service Provider> administratör.

Kontrollera att din konfiguration är korrekt och att provisionerings-ID:t i begäran är korrekt.
200016Misslyckades med att validera inloggningsuppgifter eftersom sessionen inte hittades.Användaren ska uppdatera webbläsaren och försöka använda användarnamnet/lösenordet igen.
200018Misslyckades med att validera inloggningsuppgifter eftersom användaren är utelåst.Användaren bör vänta i 10 minuter och sedan försöka igen.
200019Misslyckades med att validera inloggningsuppgifter eftersom det inte gick att lägga till en användare själv.Administratören bör kontrollera inställningarna för självaktivering i Control Hub.
200022Misslyckades med att skicka e-post eftersom användaren inte är autentiserad.Användare ska försöka registrera sig igen och ange inloggningsuppgifter.
200025Tyvärr kan du inte gå med i Självaktivering just nu. Försök igen om några minuter. Om problemet kvarstår, kontakta din systemadministratör.Låt användaren försöka igen efter några minuter. Om det inte fungerar, kontakta Ciscos support.
200026Misslyckades med att validera e-postadressen på grund av förkontrollfel eller felaktigt tillstånd för PartnerOrgUUID hos den väntande användaren : {partnerOrgUUID} , BroadoworksUUID : {broadworksUUID} , KonfigurationsuppsättningUUID : {configSetUUID}Administratören bör informera användaren om att den har angett fel e-postadress eftersom e-postadressen är associerad med en annan organisation.
200039Misslyckades med att validera e-postadressen eftersom e-post-ID redan används i en annan organisation.Användare bör försöka registrera igen på samma verifieringslänk, men använda ett annat BroadWorks-användar-ID.

Annars kan kundorganisationsadministratören från den olika organisationen ta bort den befintliga användarkonto.

200040Misslyckades med att validera e-postadressen eftersom configSet inte matchar configSet i customerConfig.Administratören bör jämföra verifieringslänken som användaren använde mot länken som är konfigurerad i Control Hub. De två länkarna och konfigurationerna måste matcha.
200041Misslyckades med att validera e-postadressen eftersom användaren redan har rätt till en annan konflikterande tjänst, med konflikterande rättigheter.Användare bör försöka registrera igen på samma verifieringslänk med ett annat BroadWorks-användar-ID.

Annars bör kundorganisationsadministratören som hanterar den tjänst som hanterar motstridande ta bort tjänsten eller berättigandena som instrider.

200042Misslyckades med att validera e-postadressen eftersom e-postadressen redan är kopplad till ett annat BroadWorks-användar-ID.Användare bör försöka igen med en annan e-postadress.

Annars måste administratören ta bort den andra användaren som använder den här e-postadressen.

200043Misslyckades med att validera e-postadressen eftersom användarens kundkonfigurationsmappning är felaktig.Användare bör försöka igen med en annan e-postadress. Annars måste administratören ta bort den andra användaren som använder den här e-postadressen.
200044Misslyckades med att validera e-postadressen eftersom användar-ID redan används i detta BroadWorks-kluster.Användare bör försöka igen med en annan e-postadress. Annars måste den kundorganisationsadministratör som hanterar den befintliga användarkonto använder den här e-postadressen ta bort den användarkonto.
200045Det gick inte att lägga till användaren via självaktivering eftersom användaren redan ingår i en annan organisation.Användaren bör försöka registrera sig igen, men med en annan e-postadress. Annars bör den kundorganisationsadministratör som administrerar den olika organisationen ta bort det befintliga kontot.
200046Misslyckades med att lägga till användare via självaktivering eftersom det finns flera väntande användare med samma broadworksUserId under samma BroadWorks-kluster.Administratören bör ta bort de väntande användarna från Control Hub.
200047Misslyckades med att lägga till användare via självaktivering eftersom användar-ID redan används i detta BroadWorks-kluster.Användare bör försöka igen med en annan e-postadress. Annars bör den kundorganisationsadministratör som hanterar den befintliga användarkonto ta bort den befintliga användarkonto ta bort andra rättigheter.
200048Det gick inte att lägga till användaren via självaktivering eftersom e-postadressen redan har etablerats för ett annat användar-ID i BroadWorks.Användare bör försöka igen med en annan e-postadress.
200049Misslyckades med att lägga till användare via självaktivering eftersom användar-ID redan används i detta BroadWorks-kluster.Användare bör försöka igen med en annan e-postadress. Annars bör den kundorganisationsadministratör som hanterar den befintliga användarkonto ta bort den befintliga användarkonto ta bort andra rättigheter.
200050Misslyckades med att lägga till användare via självaktivering eftersom provisioning-ID inte matchar förväntat provisioning-ID för prenumerantens företag.Administratören bör jämföra verifieringslänken som användaren använde mot länken som är konfigurerad i Control Hub. De två länkarna och konfigurationerna måste matcha.
200051Misslyckades med att lägga till användare via självaktivering eftersom spEnterpriseId som anges i denna begäran står i konflikt med en tjänsteleverantör eller ett företag som redan har etablerats från detta BroadWorks-kluster.Administratören bör kontrollera befintliga organisationer i Control Hub och se till att de inte skapar en organisation med ett namn som redan finns.
200054Misslyckades med att validera e-postadressen som kundorganisationens region och partnerorganisationens matchning.Administratören bör kontrollera inställningarna för partnerorganisationen och kundorganisationen i Control Hub och se till att områdena överensstämmer.
300005Förkontrollfel eftersom användaren redan är i kön och håller på att etableras.Användaradministration pågår fortfarande. Vänta några minuter och kontrollera igen.

Felkoder för katalogsynkronisering

Följande felkoder gäller för katalogsynkronisering.

Felkod

Felmeddelande

600000

Oväntat fel vid synkronisering av Broadworks externa kataloganvändare.

600001

Synkronisering av Broadworks externa kataloganvändare misslyckades.
600002

Synkronisering av Broadworks externa kataloganvändare måste avslutas innan slutförande.

600003

Synkronisering av Broadworks externa kataloganvändare slutfördes endast delvis. Vissa kundorganisationer kunde inte synkroniseras.

600004Synkronisering av Broadworks externa kataloganvändare är inte aktiverat för ConfigSet.
600005Synkronisering av Broadworks externa kataloganvändare pågår för ConfigSet.
600006Trådar för synkronisering av Broadworks externa kataloganvändare är upptagna eller stängs av, vilket innebär att fler synkroniseringsförfrågningar inte accepteras. Försök igen senare.
600007Hittade inte Identity Org för CustomerConfig.
600008Hittade inte CustomerConfig i partnerorganisationen.
600009Synkronisering av Broadworks extern kataloganvändare kan inte köras eftersom Broadworks-klustret som är associerat med CustomerConfig är upptaget.
600010Synkronisering av Broadworks extern kataloganvändare kan inte köras eftersom det inte finns något Broadworks-kluster kopplat till CustomerConfig.
600011Synkronisering av Broadworks externa kataloganvändare är inte aktiverat för CustomerConfig.
600012Synkronisering av Broadworks externa kataloganvändare kan inte köras eftersom hybridkatalogsynkronisering redan har aktiverats för CustomerConfig.
600013Synkronisering av Broadworks externa kataloganvändare kunde inte lägga till användare och maskinkonton i identitetslagret.
600014Synkronisering av Broadworks externa kataloganvändare kunde inte ansluta till Broadworks-kluster. Fel från Broadworks - %s.
600015Synkronisering av Broadworks externa kataloganvändare hittade ingen matchande användare i identitetlagret.
600017BroadWorks telefonlista kunde inte synkronisera alla användares och företags-/organisationskontakter.
600018BroadWorks telefonlista kunde inte synkroniseras för användare i företaget/organisationen.
600019BroadWorks telefonlista kunde inte synkronisera företags-/organisationskontakter.
600020BroadWorks externa katalog användarsynkronisering kan inte inaktiveras eftersom CustomerConfig-synkronisering pågår.
600022BroadWorks external directory enkel användarsynkronisering är inte möjlig eftersom företaget inte har någon användare.
600023BroadWorks extern katalog enkel användarsynkronisering är inte möjlig eftersom användaren redan finns i den här organisationen.
600024BroadWorks External Directory Enkel användarsynkronisering är inte möjlig eftersom ingen överensstämmande användare hittades i BroadWorks.
600025BroadWorks External Directory User Sync kunde inte uppdatera användarkonto CI.
600026BroadWorks External Directory User Sync kunde inte uppdatera maskinkontot i CI.
600027BroadWorks External Directory Enkel användarsynkronisering är inte möjlig eftersom flera användare hittades i BroadWorks.
600028Synkronisering av enskild användare för BroadWorks extern katalog är inte möjlig eftersom minst en företagskatalogsynkronisering borde ha slutförts.
600029BroadWorks External Directory User Sync misslyckades eftersom företaget inte har någon användare.

Ändringshistorik

Tabellen innehåller ändringshistoriken för den här guiden.

DatumByt
23 april 2025Borttagen bwc-mappen från BroadWorks Calling Webex-apploggen källa.
29 juli 2023Lade till referens till Webex-appen | Rapportera ett problem (för att generera loggar) i avsnittet Hämta användarloggar från partnerhubben och Hämta klientloggar eller feedback .
27 juni 2022Uppdaterad Läslista med saknad länk på Anslut (Android) Migrering till Firebase Procedurmetod.
21 juni 2022Uppdaterade länkarna ReadingList så att de pekar på nya webbadresser på Cisco.com. Uppdaterade Problem med samtalskonfiguration och registrering genom att lägga till en länk till Webex för Cisco BroadWorks-konfigurationsguiden för problem med BroadWorks-taggar.
14 april 2022Lade till kontextuttryck för Kontrollera användaruppgifter i Help Desk och för att visa kundorganisation i Help Desk för att förtydliga rollkrav för Help Desk.
26 mars 2022Lade till nya felkoder i Felkoder för katalogsynkronisering.
15 november 2021Lade till felkoderna 200013, 200014, 200025 och 300005 i Slutanvändarfelkoder.
28 september 2021Lade till felkoder för katalogsynkronisering.
15 juli 2021Lade till felmeddelande 100006 i Slutanvändarfelkoder. Även uppdaterad Problem med användares inloggning.
14 juli 2021Lade till ämne med länk till artikeln Kända problem och begränsningar .
2 juli, 2021Uppdaterat produktnamn för Webex-omprofilering.
18 juni 2021Uppdaterad Webex-logotyp i grafik.
8 juni 2021Kolumnen Föreslagen åtgärd har lagts till i tabellen Slutanvändarfelkoder.
4 juni 2021Rättelse till tabellen Slutanvändarfelkoder.
19 maj, 2021Lade till avsnittet Domänanspråksproblem.
22 april 2021Uppdaterade Slutanvändarfelkoder med två ytterligare koder: 200016 och 200054.
13 april 2021Lade till information om Webex Serviceability Connection.
8 december 2020Uppdaterat dokument. Nytt namn Webex Teams Webex (app). Lade till felkoder för slutanvändare.
3 november 2020Lade till webbvyn för samtalsinställningar.
22 oktober 2020Nytt dokument introducerat.