Grazie per il feedback.

Questo articolo è destinato al team di supporto tecnico delle organizzazioni di fornitori di servizi che si occupano del supporto interno e di quello dei propri clienti. Devono avere familiarità con la risoluzione dei problemi generali, la lettura dei log e la gestione dei casi degli abbonati.

Questo articolo è suddiviso in tre sezioni principali:

• Risorse: fornisce un elenco di strumenti, materiale di lettura, registri e contatti che potrebbero esservi utili.
• Processi: descrive alcune delle azioni che è possibile intraprendere durante la risoluzione di un problema del cliente.
• Problemi specifici: classifica ed elenca i problemi noti che si sono verificati, come individuarli e come è possibile risolverli.

File di registro utili

Elenco di letture

• Portale di conoscenza Webex per i partner Cisco BroadWorks
• Guida alla configurazione della piattaforma XSP (R23)
• Guida alla gestione del software BroadWorks (R23)
• Guida alla configurazione della gestione dei dispositivi Cisco BroadWorks (R23)
• Guida all'amministrazione dell'interfaccia a riga di comando di Broadworks XSP
• Descrizione del token di autenticazione a lungo termine Release 23.0
• Guida all'integrazione dell'autenticazione SAML, R23
• Guida alle opzioni di supporto SSL di Cisco BroadWorks
• Descrizione della funzionalità di supporto CI di Cisco
• Server di notifiche push (Descrizione della funzionalità)
• Supporto della notifica push per la descrizione della funzione di chiamata Release 22.0
• Procedura di migrazione da Connect (Android) a Firebase
• Descrizione della funzionalità di archiviazione dei token del dispositivo per le notifiche push di Cisco BroadWorks, versione 22.0
• Strumento di pianificazione della capacità di Cisco BroadWorksSystem (foglio di calcolo)
• Guida al dimensionamento della piattaforma Cisco BroadWorks
• Guida all'ingegneria di sistema di Cisco Broadworks
• Requisiti di supporto autenticazione CI Documento Versione 1.0 MR-7136

Problemi noti e limitazioni

L'articolo Problemi noti e limitazioni contiene informazioni aggiornate sui problemi noti che abbiamo identificato nella soluzione Webex per BroadWorks.

Connettore servizi

Il servizio Webex Serviceability aumenta la velocità con cui il personale di assistenza tecnica di Cisco può diagnosticare i problemi dell'infrastruttura. Automatizza le attività di ricerca, recupero e archiviazione dei log diagnostici e delle informazioni in un caso SR. Il servizio attiva anche l'analisi a fronte delle firme diagnostiche in modo che il Tac possa identificare e risolvere in modo più efficiente i problemi con l'apparecchiatura on-premises.

Per informazioni dettagliate su come distribuire il connettore Serviceability, consultare la Guida alla distribuzione del connettore Cisco Webex Serviceability.

Segnalare un problema a un livello superiore

Dopo aver seguito alcune delle procedure di risoluzione dei problemi, dovreste avere un'idea abbastanza precisa di dove risiede il problema.

Procedura

1. Raccogli quante più informazioni possibili dai sistemi correlati al problema.
2. Contatta il team competente di Cisco per aprire una segnalazione.

Quali informazioni sui clienti raccogliere

Se si ritieni di aprire un caso o inoltrare un problema al supporto, raccogliere le seguenti informazioni durante la risoluzione dei problemi con l'utente:

• IDENTIFICATIVO utente: Indirizzo email CI o UUID utente (questo è l'identificativo Webex, ma se si ottiene anche l'identificativo BroadWorks dell'utente, includerlo nei dettagli del caso).
• Identificativo dell'organizzazione.
• Periodo di tempo approssimativo durante il quale si è verificato il problema.
• Piattaforma e versione del client.
• Inviare o raccogliere i log dal client.
• Annotare l'ID di tracciamento se visualizzato sul client.

Verifica i dettagli dell'utente nell'Help Desk

Gli amministratori dei partner che dispongono dei privilegi di ruolo Amministratore Help Desk (Base o Avanzato) possono utilizzare questa procedura per verificare i dettagli degli utenti tramite la vista Help Desk.

Procedura

1. Accedi all'Help Desk .
2. Cercare e fare clic sull'utente. Viene visualizzata la schermata di riepilogo degli utenti.
3. Fare clic sulla nome utente per visualizzare la configurazione utente dettagliata. Le informazioni utili in questa visualizzazione includono l'UUID dell'utente, il cluster di identità comune (CI), il cluster dell'app Webex, il comportamento di chiamata e il GUID dell'account BroadWorks.
4. Fare clic su Copia se occorre utilizzare queste informazioni in un altro strumento o allegarlo a un caso Cisco.

Visualizza l'organizzazione del cliente nell'Help Desk

Gli amministratori dei partner che dispongono dei privilegi di ruolo Amministratore Help Desk (Base o Avanzato) possono utilizzare questa procedura per visualizzare i dettagli dell'organizzazione del cliente nella vista Help Desk.

Procedura

1. Accedi all'Help Desk .
2. Cercare e fare clic sul nome dell'organizzazione cliente.
3. Scorri verso il basso finché non vedi Vista portale clienti e fai clic su Visualizza CustomerName per visualizzare una vista di sola lettura dell'organizzazione del cliente, inclusi utenti e configurazione.

Recupera i registri utente da Partner Hub

Durante la risoluzione dei problemi relativi ai client desktop e mobile, è importante che i partner (e il TAC) possano visualizzare i log del client.

Procedura

1. Richiedere all'utente di inviare i registri. Per informazioni, vedere: App Webex | Segnala un problema.
2. Chiedi all'utente di esportare l'ambiente di chiamata e di inviarti il file ced.dat.
3. Recupera i log del client da Partner Hub o Help Desk.

   Opzione Hub partner:

   1. Accedere all'hub del partner e individuare l'organizzazione cliente dell'utente.
   2. Selezionare Risoluzione deiproblemi.
   3. Selezionare Registri.
   4. Ricercare l'utente (per e-mail).
   5. Visualizzare e scaricare i log del client come file zip.

   help desk opzione:

   1. Eseguire l'accesso help desk.
   2. Cercare l'organizzazione.
   3. Fare clic sull'organizzazione (viene visualizzata la schermata di riepilogo).
   4. Scorri verso il basso e fai clic su Visualizza cliente.
   5. Selezionare Risoluzione deiproblemi.
   6. Selezionare Registri.
   7. Ricercare l'utente (per e-mail).
   8. Visualizzare e scaricare i log del client come file zip.

Come trovare la versione client

Procedura

1. Condividere questo collegamento con l'utente: https://help.webex.com/njpf8r5
2. Richiedere all'utente di inviare il numero di versione.

Verifica cliente per il servizio di chiamata

Procedura

1. Accedere al client Webex.
2. Controllare che l'icona Opzioni di chiamata (un ricevitore con un ingranaggio sopra) sia presente sulla barra laterale. Se l'icona non è presente, è possibile che l'utente non sia ancora abilitato per il servizio di chiamata in Control Hub.
3. Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici. Viene visualizzato lo stato SSO è stato eseguito l'accesso. (Se un servizio telefonico diverso, come Webex Calling ,viene visualizzato , l'utente non utilizza Webex per Cisco BroadWorks.

   Ciò significa:

   • Il client ha attraversato correttamente i microservizi Webex richiesti.
   • L'utente è stato autenticato correttamente.
   • Il client riceve dal sistema BroadWorks un token web JSON di lunga durata.
   • Il client ha recuperato il profilo del dispositivo ed è registrato per BroadWorks.

Ottieni i log o il feedback del client

• Vedere la sezione Risorse per trovare log del client specifici sui client desktop Webex o chiedere agli utenti di inviare i registri. Per informazioni, vedere: App Webex | Segnala un problema.
• Chiedi agli utenti dei client mobili di inviare i log, che potrai poi recuperare tramite Partner Hub o Help Desk.
  Invio dei registri invisibile all'utente. Tuttavia, se un utente invia un feedback, passa al team devops dell'app Webex. Accertarsi di registrare il numero del feedback dell'utente se si desidera eseguire il follow-up con Cisco. Ad esempio:

  

Ottieni dati ambiente di chiamata

I log del client Webex vengono riattivati pesantemente per rimuovere le informazioni di identificazione personale. È necessario esportare i dati dell'ambiente di chiamata dal client nella stessa sessione in cui si nota il problema.

Procedura

1. Sul client fare clic su Guida > Controllo salute.
2. Selezionare Ripristina database. Questo avvia un ripristino completo del client e carica la schermata di accesso dell'app Webex.

Verificare che Webex si registri a BroadWorks.

L'app Webex verifica le seguenti informazioni per determinare se registrarsi a BroadWorks:

• Diritto dell'utente a broadworks-connector.
• Comportamento di chiamata per organizzazione e utente.

Controllare il funzionamento delle chiamate e l'autorizzazione connector di un utente

1. Accedi all'Help Desk con le tue credenziali di amministratore partner.
2. Ricercare l'utente.
3. Fare clic sull'utente e selezionare la voce Funzionamento chiamata. Deve essere "Chiamata in Webex".

   

4. Fare clic sulla nome utente per aprire la schermata Dettagli utente.
5. Scorri verso il basso per individuare la sezione entitlements e verifica che broadworks-connector sia incluso

   

   Un utente di Webex per Cisco BroadWorks non dovrebbe avere il diritto bc-sp-standard se intende utilizzare Webex per Cisco BroadWorks. Si tratta del diritto di utilizzo per "Webex Calling (Broadcloud)", ovvero la possibilità di effettuare chiamate tramite l'app Webex utilizzando un servizio di chiamate cloud gestito da Cisco.

Controllare il funzionamento delle chiamate dell'organizzazione

1. Accedi all'Help Desk con le tue credenziali di amministratore partner.
2. Cercare l'organizzazione.
3. Fai clic sull'organizzazione e seleziona la voce Comportamento di chiamata. Deve essere "Chiamata in Webex".

Analizza PSLog per individuare problemi di provisioning degli utenti.

Utilizzare il registro PSLog del server applicazioni per visualizzare la richiesta HTTP POST al bridge di provisioning e la risposta da Webex. In un caso funzionante corretto, la risposta è stata 200 OK e dopo alcuni minuti è possibile visualizzare l'utente, e la nuova organizzazione cliente, se primo utente, è stata creata in Webex. È possibile verificare questa opzione ricercando help desk indirizzo e-mail visualizzato nel POST.

Operazioni preliminari

Raccoglie un registro PSLog dal server applicazioni durante un tentativo di provisioning flow con un utente di test.

Procedura

1. Innanzitutto, controlla il codice di risposta HTTP:
   • Un errore di provisioning dell'utente è qualsiasi elemento diverso da 200 OK.
   • Il codice 200 OK potrebbe comunque indicare un errore se qualcosa relativo al profilo dell'abbonato non funziona nei servizi Webex a monte del bridge di provisioning.
   • 400 potrebbe contenere un nodo message nella risposta. Il bridge di provisioning non è riuscito a elaborare qualcosa in subscriberProfile. Si potrebbe essere verificato un problema con i dettagli dell'abbonato o incompatibilità con un'impostazione nel modello.
   • 401 significa che le credenziali di provisioning inserite su AS non corrispondono a quelle inserite nel modello in Partner Hub.
   • 403 potrebbe indicare un problema di configurazione errata sul server applicazioni. Controllare la destinazione della richiesta. non deve essere un indirizzo IP; dovrebbe essere l'URL del bridge di provisioning che è possibile visualizzare nel modello in Partner Hub.
   • 409 indica un conflitto tra i dati forniti subscriberProfile e i dati Webex esistenti. Potrebbe essere presente un utente esistente con tale indirizzo e-mail. Controlla le parentesi message quadre nella risposta.
2. È anche possibile controllare il POST HTTP originale per qualsiasi valore sospettato che potrebbe causare errori di provisioning. La richiesta POST contiene una struttura XML subscriberProfile. All'interno di questa funzione, i nodi utili da verificare sono:
   • bwuserid: Utilizzare questa opzione per individuare il profilo dell'abbonato se occorre modificarlo in BroadWorks.
   • group: Se il modello è in "modalità fornitore di servizi", questo viene convertito in minuscolo e diventa il nome dell'organizzazione del cliente che vedi in Partner Hub.
   • serviceProvider: Se il modello è in "modalità Enterprise", questa viene minuscola e diventa il nome dell'organizzazione cliente visualizzata in Partner Hub.
   • primaryPhoneNumber: Deve esistere. Il provisioning non riesce.
   • email: Diventa l'ID utente in Webex. Deve essere valido e univoco per Webex, altrimenti il provisioning non riesce.

     Ignora la strofa services : viene creato da AS e accettato ma non utilizzato da Webex.

Analizzare i log XSP per risolvere i problemi di accesso dell'abbonato

Questo flusso descrive la modalità di autenticazione BroadWorks. È possibile visualizzare la modalità di autenticazione sul Modello BroadWorks, in Partner Hub. Vedere Configurazione dei modelli cliente in https://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_137726.

Il seguente diagramma a scaletta mostra l'interazione tra l'utente, il client, i servizi Webex e il sistema BroadWorks, quando l'utente esegue l'autenticazione BroadWorks nell'app Webex. Inoltre, la connessione tra Webex e XSP è protetta da MTLS.

La discussione seguente descrive cosa ci si può aspettare quando si esegue la ricerca di un registro per un accesso corretto.

L'utente interagisce con il client e il client interagisce con i servizi Webex:

• L'utente fornisce il proprio indirizzo email all'app Webex (1 nel diagramma).
• CI è in grado di reindirizzare questo utente per inserire la propria password BroadWorks (tramite UAP) (2 in diagramma).
• Il proxy IDP invia una richiesta di richiesta di ottenere il profilo all'interfaccia Xsi su XSP.

Nel gatto maschio access_log:

• Ricercare la richiesta GET per il profilo dell'abbonato, da Webex all'interfaccia Xsi-Actions (2.1 in diagramma). Dispone del ID utente Webex. Ad esempio:

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

Nel registro XsiActionsLog:

• Ricercare il profilo RICHIESTA GET da Webex (2.1 in diagramma). Dispone del ID utente Webex. Ad esempio:

  GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile Le intestazioni includono authorization: Basic e user-agent: broadworksTeamsClient

• XSP quindi esegue l'autenticazione di base OCI-P in base a BroadWorks (AuthenticationVerifyRequest e AuthenticationVerifyResponse, come qualsiasi altra applicazione che effettua l'autenticazione di base tramite Xsi) e anche una UserGetRequest e ServiceProviderGetRequest per raccogliere le informazioni del sotto sottoscrittore.
• La risposta Xsi a Webex contiene un blocco XML Profile contenente (BroadWorks) userId e altri dettagli (2.2 nel diagramma).

Interazioni tra client e servizi Webex:

• Il proxy IDP confronta il profilo utente ricevuto da BroadWorks ed emette un'asserzione SAML al client (2.3 nel diagramma).
• Il client scambia un'asserzione SAML con un token CI (3 nel diagramma).
• Il client verifica che l'utente che ha eseguito l'accesso dispone dell'autorizzazione per broadworks-connector (4 in diagramma). È possibile verificare i diritti di accesso dell'utente nell'Help Desk.
• Il client utilizza il token CI per richiedere un JSON Web Token (JWT) al proxy IDP (5 nel diagramma).
• Il proxy IDP convalida il token CI presso CI.
• Il proxy IDP richiede JWT al servizio di autenticazione.

Nel log authenticationService:

• Cerca la richiesta di token da Webex (5.2 nello schema), ad esempio: GET /authService/token che ha http_bw_userid intestazione e altri.
• L'XSP esegue OCI-P UserGetLoginInfoRequest, per convalidare che l'ID utente fornito corrisponda a un utente BroadWorks (5.3 nel diagramma). AuthService ha stabilito una relazione di trust con Webex in virtù della connessione mTLS, pertanto può emettere LLT.
• Cerca la risposta (5.4 nel diagramma) da LongLivedTokenManager - Token generated, subject: bwksUserId@example.com, issuer: BroadWorks … e StatusCode=200 che puoi associare alla richiesta originale utilizzando l'intestazione trackingid: CLIENT… .

Nel registro XsiActionsLog:

• Il client è in grado di presentare il token a lunga durata all'interfaccia Xsi-Actions per ottenere il profilo del dispositivo (6 nello schema). Ad esempio: GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserId%40example.com/profile/device Con le intestazioni authorization: Bearer token e user-agent: WebexTeams (variant/version)
• L'interfaccia Xsi-Actions invia il token tramite POST al servizio di autenticazione (configurato per essere sull'interfaccia di loopback). Ad esempio: 127.0.0.1:80 POST http://127.0.0.1:80/authService/token che puoi correlare con l'intestazione trackingid: CLIENT… nel GET e l'intestazione X-BROADSOFT-CORRELATION-ID : CLIENT… nel POST.

Nel log authenticationService:

• Ricezione di POST da Xsi (loopback)

• Un StatusCode=200 ritorno a Xsi

• E una risposta di convalida del token, con un blocco JSON "token" nel corpo.

• Correlato mediante l'uso del comando trackingid: CLIENT…

Nel registro XsiActionsLog:

• Dopo aver ricevuto 200 OK da authservice, che ha convalidato il client'stoken, l'applicazione Xsi-Actions ora invia la richiesta OCI-P per UserPrimaryAndSCADeviceGetListRequest
• Riceve OCI-P UserPrimaryAndSCADeviceGetListResponse contenente la struttura XML accessDeviceTable.
• La risposta OCI-P è codificata come risposta Xsi al client, inclusa la struttura XML AccessDevices, che ha il deviceTypes. Ad esempio: Business Communicator – PC e gli URL in cui il client può recuperare i file di configurazione del dispositivo.

Il client continua normalmente:

• Seleziona una voce del dispositivo e interagisce con DMS per ottenere il profilo del dispositivo (6 nello schema).
• Registri a BroadWorks tramite SBC recuperati nella configurazione da DMS (7 nello schema).

Problemi con Partner Hub

1. L'amministratore non può visualizzare le organizzazioni dei clienti.

In qualità di amministratore della tua organizzazione partner in Webex, dovresti avere il ruolo di Amministratore completo. Tale ruolo viene utilizzato per la gestione dell'organizzazione partner, incluso l'assegnazione di privilegi amministrativi a se stessi e ad altri. Per gestire le organizzazioni dei clienti, è necessario assegnare a se stessi (o ad altre persone) il ruolo Amministratore completo delle vendite o il ruolo Amministratore delle vendite. Per i dettagli, vedere Assegnare i ruoli dell'account dell'organizzazione in Control Hub.

Problemi di provisioning degli utenti

1. IM integrato & Errori P per imprese specifiche / clienti

Se gestite un mix di aziende che utilizzano diversi servizi di collaborazione cloud, ad esempio UC-One SaaS e Webex per Cisco BroadWorks, potreste aver scelto di modificare l'adattatore di provisioning per ciascuna azienda.

Per verificare cosa è configurato per IM integrato & P (impostazione predefinita per le aziende, a meno che non esista un'impostazione più specifica), esegui AS_CLI/Interface/Messaging> get. Per i parametri di provisioning di una specifica azienda, apri l'azienda e vai a Servizi > IM integrato & P.

Verificare che la configurazione IM&P integrata per tale azienda corrisponda esattamente a ciò che viene mostrato nel Modello cliente in Partner Hub. Le seguenti impostazioni devono corrispondere, oppure il provisioning non riesce per tutti gli utenti nell'azienda:

2. IM integrato & Errori P per utenti specifici

Questo si applica se si utilizza il provisioning flowthrough e presuppone che il provisioning funzioni per some/most utenti (in modo da poter escludere un problema di configurazione). Se visualizzi IM integrato & Errori P in BroadWorks, ad esempio, “[Error 18215] Errore di provisioning con il server di messaggistica” e “[Error [18211] Errore di comunicazione con il server di messaggistica”, è necessario esaminare le seguenti possibili cause:

• L'indirizzo e-mail dell'utente potrebbe essere già esistente. Cerca l'utente nell'Help Desk per verificare se il suo indirizzo email è già presente. Questo non è necessariamente definitivo, perché l'utente potrebbe appartenere a un'organizzazione i cui dati non sono accessibili tramite l'Help Desk.
• L'utente ha eseguito in modo indipendente la richiesta di accesso a Webex, prima di essere assegnato al servizio IM&P integrato. In questo caso, un'opzione è quella di far eliminare all'utente i suoi account gratuiti in modo che possa entrare a far parte dell'organizzazione clienti che stai configurando. Le istruzioni sono a https://help.webex.com/5m4i4y
• L'utente non ha un numero di telefono principale assegnato al proprio profilo (tutti gli abbonati a Webex per Cisco BroadWorks devono avere un numero DID principale). Vedere l'argomento sull'analisi di PSLog da AS.

3. Errori di provisioning utente in risposta dal bridge di provisioning

Se gli utenti non vengono visualizzati in Control Hub, entro pochi minuti dall'assegnazione della messaggistica istantanea integrata & P, dai un'occhiata ai codici di risposta del servizio di provisioning bridge. Eseguire un registro DI PSLog per esaminare i codici di risposta HTTP.

200 OK

Una risposta 200 OK non significa che l'utente sia stato correttamente configurato. Significa che il servizio di provisioning ha ricevuto la richiesta e inviato correttamente la richiesta di creazione dell'utente corrispondente ai servizi upstream. La transazione di provisioning è asincrona per impostazione progettazione. Il servizio risponde con 200 OK perché il processo di creazione dell'utente può richiedere diversi minuti e, per motivi di prestazioni, non vogliamo ricevere più richieste di creazione dello stesso utente. Tuttavia, se l'utente non compare nell'organizzazione del cliente dopo una risposta 200 OK, ciò potrebbe indicare che la creazione dell'utente non è riuscita nei servizi Webex a monte del servizio di provisioning. È necessario inoltrare un errore di provisioning con una risposta OK da 200.

400 richiesta non valida

Controllare la risposta HTTP che dovrebbe avere maggiori dettagli sui potenziali problemi che potrebbero provocare questa risposta dal servizio di provisioning. Alcuni esempi del nodo:

• "Impossibile impostare come attendibile l'e-mail BroadWorks con l'API di provisioning preesistiva." L'indirizzo e-mail associato alla richiesta di provisioning dell'utente non riuscita non è valido o non è corretto, ma è stato asserto nel modello che gli indirizzi e-mail possono essere considerati attendibili. Controllare i profili degli utenti in BroadWorks, in particolare l'ID e-mail.
• L'organizzazione cliente non è presente nel database e l'opzione per la creazione di nuove organizzazioni non è abilitata. Questa richiesta di provisioning non riuscita dovrebbe creare una nuova organizzazione cliente in Webex, ma il modello è configurato per impedire la creazione di nuove organizzazioni cliente. Se si desidera consentire nuove organizzazioni, per i domini e-mail che non corrispondono ai clienti esistenti in Webex, è possibile riconfigurare il modello in Partner Hub ed eseguire nuovamente il test della richiesta di provisioning. Tuttavia, se non si prevede la creazione di una nuova organizzazione per questo utente, è possibile che l'indirizzo e-mail non sia specificato nel modo corretto (in particolare nella parte del dominio). Controllare l'ID e-mail dell'utente in BroadWorks.

403 Vietato

La richiesta di provisioning non può essere completata finché non si corregge la configurazione. In questo caso, sarà necessario esaminare la richiesta e la risposta. Ad esempio, se viene visualizzato un indirizzo IP come destinazione della richiesta di provisioning, anziché l'URL del bridge di provisioning appropriato per la propria organizzazione (vedere gli argomenti di configurazione del firewall nella Guida alla soluzione), è possibile indicare che il server applicazioni non contiene una patch richiesta (ap373197).

Verificare che tutte le patch richieste siano state applicate al server applicazioni e che sia stata completata la configurazione correlata per un provisioning corretto del flusso.

Conflitto 409

La richiesta di provisioning non può continuare perché in Webex è presente un utente esistente che corrisponde all'indirizzo e-mail nella richiesta.

4. Utente già presente in CI

Richiedere all'abbonato di inviare una richiesta HTTP POST e ricercarlo nell help desk. È possibile che l'utente non venga visualizzato se non lo si consente, ma è possibile anche che l'utente si trova in un'organizzazione "gratuita", ad esempio, "Consumer". È possibile chiedere a questo utente di eliminare l'account gratuito oppure utilizzare un indirizzo e-mail diverso per eseguirne il provisioning. Consultare .https://help.webex.com/ndta402

Problemi di accesso utente

1. Il portale di attivazione utente non si carica

Il normale flusso di accesso a Webex per Cisco BroadWorks include un portale di attivazione utente in cui gli utenti inseriscno le password. A volte questo portale non si carica dopo che l'utente ha inserito il proprio indirizzo email nella schermata di accesso dell'app Webex. Questo problema può essere provocato dal lato client o dal lato servizio. Sul lato client, solitamente si verifica l'incompatibilità del browser nativo del client con il servizio.

2. Single Sign On non riuscito

• In BroadWorks, verificare che all'utente siano stati assegnati i tipi di dispositivo per l'app Webex (vedere la sezione Profili dispositivo nella sezione Prepara il tuo ambiente della Guida alla soluzione).
• Verifica che l'utente stia utilizzando la password corretta. Se il modello utilizzato per il provisioning dell'organizzazione cliente dell'utente (in Partner Hub) è configurato per l'autenticazione BroadWorks, l'utente dovrà inserire la propria password di "Accesso Web" di BroadWorks. L'utente potrebbe anche dover inserire il proprio ID utente BroadWorks se il suo indirizzo e-mail non è configurato come ID utente alternativo. Assicurarsi che l'utente abbia inserito correttamente caratteri maiuscoli e minuscoli.

Problemi di configurazione e registrazione delle chiamate

Dopo che un utente è stato registrato in Webex e ha effettuato correttamente l'accesso all'app Webex, l'app si registra a BroadWorks. Di seguito è riportata la sequenza di registrazione prevista e i relativi segnali di una registrazione avvenuta correttamente (come visualizzati dall'app Webex):

1. Sequenza di registrazione prevista

1. Il client chiama XSI per ottenere un token di gestione dispositivi e l'URL sul DMS.
2. Il client richiede il profilo del dispositivo dal DMS presentando il token dal punto 1.
3. Il client legge il profilo del dispositivo e recupera le credenziali SIP, gli indirizzi e le porte.
4. Il client invia un SIP REGISTER al controller SBC utilizzando le informazioni del punto 3.
5. L'SBC invia il SIP REGISTER all'AS (l'SBC può eseguire una ricerca nel NS per individuare un AS se non conosce già l'utente SIP).

2. Segnali attesi di una registrazione del cliente andata a buon fine

L'icona Opzioni di chiamata appare nell'interfaccia Webex.

Nella scheda dei servizi telefonici dell'app Webex (ad esempio Impostazioni > Servizi telefonici su Windows, Preferenze > Servizi telefonici su Mac), il messaggio “Sessione SSO: È stato eseguito l'accesso" significa che l'app è stata registrata correttamente (per BroadWorks in questo caso).

3. Il client non ha l'icona di chiamata

Nella maggior parte dei casi, ciò significa che l'utente non dispone della licenza/diritti corretti.

Iscrizione non riuscita. Esistono diversi motivi per cui la registrazione di un client Webex App con BroadWorks potrebbe non riuscire:

4. Test di più servizi di chiamata con gli stessi clienti

Questo problema noto può essere provocato dalla modifica del client tra diversi back end di richiamata. È molto probabile che ciò accada durante le prove di diversi servizi di chiamata offerti tramite gli stessi client dell'app Webex. È possibile reimpostare il database del client (collegamento) per risolvere questo problema.

5. Errata configurazione del servizio di autenticazione

Controllare gli XSP che ospitano il servizio di autenticazione in base alla Guida alla soluzione (vedere Configurazione dei servizi su Webex per Cisco BroadWorks XSP). Nello specifico:

• Le chiavi RSA (generate su un XSP) vengono copiate su tutti gli XSP
• L'URL del servizio di autenticazione è stato fornito al contenitore Web su tutti gli XSP e immesso correttamente nel cluster in Partner Hub
• Autenticazione esterna dei certificati configurata:

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

  allowUserApp = false

  allowClientApp = true

• Quando si utilizza MTLS, è necessario caricare il certificato client Webex sugli XSP (è possibile ottenere il certificato da Partner Hub, nella pagina Impostazioni di BroadWorks).

6. Configurazione errata dei tag BroadWorks

Verifica di aver configurato i tag BroadWorks necessari per l'app Webex. Consultare la Guida alla configurazione di Webex per Cisco BroadWorks per informazioni sui tag di configurazione. Assicurati che non ci siano conflitti o valori errati. Nello specifico, il tag %SBC_ADDRESS_WXT% dovrebbe essere l'SBC verso il tuo registrar SIP per i client dell'app Webex.

7. Il client desktop disconnette i servizi telefonici dopo una connessione SSO riuscita.

Questo problema può essere provocato dall'accesso dello stesso utente a più client nello stesso tipo di piattaforma. Ad esempio, se un utente accede correttamente all'app Webex su Windows e poi accede all'app Webex su un'altra macchina Windows, la sessione SSO sarà attiva solo su una delle due macchine. Si tratta di progettazione. Se occorre assolutamente risolvere questo problema, è possibile configurare BroadWorks in modo che più istanze dello stesso tipo di dispositivo, ma devono disporre di indirizzi SIP univoci. Questa configurazione non rientra nell'ambito di Webex per Cisco BroadWorks.

8. Dispositivo desktop non configurato per l'utente

Questa firma è visibile nel registro del client:

[0x70000476b000] BroadWorksConfigDownloader.cpp:106

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

9. Le chiamate in arrivo sui cellulari squillano una sola volta o non è possibile rispondere.

Le chiamate in entrata al servizio mobile Webex squillano una sola volta oppure l'utente non può rispondere alla chiamata in entrata. Altri dispositivi appartenenti allo stesso utente potrebbero continuare a squillare.

Come identificarlo?

Nei log del client mobile Webex, cerca il codice di errore XSI 101002 nel flusso di chiamata push. Ad esempio:

Codice di risposta: 400

handlePushCallInfoFailure:BWC:INTERNAL: Premere il pulsante di chiamata: Stato xsi per callID: <callID> Codice di errore xsi: 101002

closePushCallWithReason:BWC:INTERNAL: Prova a chiudere la chiamata push con ID = <callID>, motivo = Chiamata abbandonata

Causa: Il codice di errore 101002 può indicare che nella risposta LocateUser è stato restituito il server delle applicazioni (AS) errato. Questo può accadere quando l'utente è migrato a un AS secondario.

Controlli consigliati:

Dall'ADP o XSP in cui è distribuito Push, eseguire LocateUser per l'utente interessato:

curl 'http://:80/servlet/LocateUser?url=&returnCompatibleXSP=true&callPRequest=true'

Esempio: curl 'http://1.1.1.1:80/servlet/LocateUser?url=9721112222@gmail.com&returnCompatibleXSP=true&callPRequest=true'

Risoluzione: Se LocateUser restituisce l'AS secondario per l'utente, esegui lo script migrateUserToDefaultNode.pl sul server NS primario per migrare gli utenti nuovamente al server applicazioni primario del cluster.

Accedi al server NS tramite SSH, vai alla directory /usr/local/broadworks/bw_base/bin ed esegui:migrateUserToDefaultNode.pl

Esempio: migrateUserToDefaultNode.pl bwas1

Per ottenere il valore hostingNE, eseguire: NS_CLI/System/Device/HostingNE> get

Lo script verifica innanzitutto se riesce a trovare l'NE host fornito come argomento. Dopo aver verificato la validità dell'NE di hosting, aggiorna il DN, l'estensione e l'URL al nodo predefinito per tale NE di hosting.

Esegui lo script durante un periodo di traffico ridotto, se possibile. Tuttavia, in genere è accettabile eseguire lo script in qualsiasi momento, se necessario, per ripristinare il servizio per gli utenti interessati.

Lo script non può essere eseguito da un singolo utente. Esegue la migrazione di tutti gli utenti elencati nell'output LocateUser. Se non riesci a eseguire lo script, elimina e ricrea l'utente interessato in BroadWorks in modo che venga ricreato sull'AS corretto.

Qualsiasi messaggio SIP inviato dal dispositivo dell'utente all'AS secondario può causare la migrazione dell'utente. In genere, dopo l'intervallo predefinito di 15 minuti, gli utenti tornano all'AS primario, a meno che le richieste in arrivo non continuino a raggiungere l'AS secondario. Ad esempio, se l'SBC non riesce a connettersi all'AS1 e passa all'AS secondario, gli utenti interessati potrebbero essere trasferiti all'AS secondario. A seconda della configurazione, un singolo gruppo di trunk o utente può rimanere bloccato sull'AS secondario se l'SBC continua ad avere problemi a raggiungere l'AS primario.

Per ulteriori informazioni, vedere i documenti seguenti:

• Sezioni 3.4.5 Funzionalità di rollback utente del server applicazioni e 5.4.5 Rollback automatico nella Guida alla ridondanza di Cisco BroadWorks

• Descrizione delle funzionalità di miglioramento di Cisco BroadWorks ASR

Problemi con la visualizzazione web delle impostazioni delle chiamate

1. Automedicazione button/link non visualizzato nell'app Webex

Un sintomo differente di questo problema è quando il pulsante o il collegamento viene visualizzato, ma facendo clic si apre un browser esterno.

• Verificare che il modello di configurazione client richiesto sia stato distribuito e che i tag CSW siano impostati correttamente. (Vedere la sezione Impostazioni chiamata Webview nella Guida alla soluzione Webex per Cisco BroadWorks).
• Verifica che l'app Webex sia registrata per le chiamate in BroadWorks.
• Verifica che l'app Webex sia una versione recente che supporti CSWV.

2. Pagina vuota o errore dopo aver fatto clic su Self Care button/link

In genere, questo comportamento nell'app Webex indica un problema di configurazione o di implementazione dell'applicazione CSWV su BroadWorks XSP. Raccogliere i dettagli per un'analisi specifica, compresi i registri CSWV, i registri di accesso, l'archivio config-wxt.xml e il file di modello, quindi generare un caso.

Problemi relativi alle rivendicazioni di dominio

Gli errori di registrazione utente possono verificarsi a causa di errori che vengono effettuati nella richiesta dei domini. Prima di richiedere qualsiasi dominio, accertarsi di avere compreso quanto segue:

• I provider di servizi non devono richiedere i domini delle organizzazioni dei clienti che gestiscono. Tali utenti devono richiedere solo i domini di tali utenti che si provider di servizi all'interno dell'organizzazione. La richiesta del dominio degli utenti in un'organizzazione separata (anche una che il provider di servizi gestisce) può provocare errori di registrazione per gli utenti nell'organizzazione del cliente poiché le richieste di autenticazione degli utenti vengono indirizzate attraverso provider di servizi anziché l'organizzazione del cliente.
• Se due organizzazioni clienti (Società A e Società B) condividono lo stesso dominio e la Società A ha richiesto il dominio, la registrazione per gli utenti della Società B potrebbe non riuscire a causa del fatto che le richieste di autenticazione degli utenti vengono inoltrate attraverso l'organizzazione con il dominio richiesto (Società A).

  Se si richiedere qualsiasi dominio in errore e occorre rimuovere una richiesta, fare riferimento all'articolo Gestione dei domini Webex.

Codici di errore dell'utente finale

La tabella seguente descrive i codici di errore degli utenti finali che possono essere visti nel portale di attivazione degli utenti client.

Codici di errore per la sincronizzazione della directory

I seguenti codici di errore si applicano alla sincronizzazione delle rubrica.