- Home
- /
- Articolo
Guida alla soluzione Webex per Cisco BroadWorks
La Guida alla soluzione Webex per Cisco BroadWorks è destinata agli amministratori a livello di partner. La guida descrive come impostare e distribuire Webex per Cisco BroadWorks. Webex per Cisco BroadWorks fornisce ai clienti della chiamata BroadWorks funzioni di collaborazione Webex. Gli abbonati utilizzano una singola applicazione (app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme.
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione si rivolge agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei propri clienti o forniscono questa soluzione direttamente ai propri abbonati.
Scopo della soluzione
Fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che già dispongono del servizio di chiamata fornito dai provider di servizi BroadWorks.
Fornire il servizio di chiamata basato su BroadWorks a clienti Webex piccoli e medi.
Contesto
Stiamo evolvendo tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo sforzo consiste nello spostare le funzionalità di chiamata BroadWorks nell'app Webex e infine ridurre gli investimenti nei client UC-One.
Vantaggi
Prova futura: contro interruzione del servizio di UC-One Collaborate, spostamento di tutti i client verso Unified Client Framework (UCF)
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex mantenendo la chiamata BroadWorks sulla rete di telefonia
Ambito della soluzione
Clienti da piccoli a medi esistenti/nuovi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre di chiamate BroadWorks.
Clienti Webex esistenti di piccole e medie dimensioni che desiderano aggiungere BroadWorks Calling.
Non aziende più grandi (rivedere il nostro portfolio Enterprise per Webex).
Non utenti singoli (valutare le offerte Webex Online).
Le funzioni impostate in Webex per Cisco BroadWorks riguardano casi d'uso di piccole e medie imprese. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità per le PMI e ne valutiamo costantemente l'idoneità per questo segmento. Possiamo scegliere di nascondere o rimuovere funzioni che sarebbero altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# | Requisito | Note | ||
---|---|---|---|---|
1 | Patch BroadWorks R22 corrente o superiore | |||
2 | XSP|ADP per XSI, CTI, DMS e authService | XSP|ADP dedicato per Webex per Cisco BroadWorks | ||
3 | XSP|ADP separato per NPS, può essere condiviso con altre soluzioni che utilizzano NPS. | Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni XSP|ADP e NPS. | ||
4 | Convalida token CI (con TLS) configurata per le connessioni Webex al servizio di autenticazione. | |||
5 | mTLS configurato per le connessioni Webex all'interfaccia CTI. | Altre applicazioni non richiedono mTLS. | ||
6 | Gli utenti devono essere presenti in BroadWorks e necessitano dei seguenti attributi, a seconda della decisione di provisioning:
| Per i messaggi e-mail attendibili: Si consiglia di inserire lo stesso indirizzo e-mail anche nell'attributo ID alternativo, per consentire agli utenti di accedere con indirizzo e-mail rispetto a BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'uso di e-mail non attendibili può causare l'invio dell'e-mail alla cartella Posta indesiderata o SPAM dell'utente. L'amministratore potrebbe dover modificare le impostazioni e-mail dell'utente per consentire i domini | ||
7 | Webex per il file DTAF Cisco BroadWorks per l'app Webex | |||
8 | Utente BW Business Lic o Std Enterprise o Prem Enterprise Lic + Webex per abbonamento Cisco BroadWorks | Se si dispone di una distribuzione di collaborazione esistente, non è più necessario il pacchetto aggiuntivo UC-One, le porte per conferenze Collab Lic e Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non occorre apportare altre modifiche se non accettare i termini del pacchetto Premium. | ||
9 | IP/porte devono essere accessibili attraverso i servizi backend Webex e le app Webex su Internet pubblico. | Vedere la sezione "Preparazione della rete". | ||
10 | Configurazione TLS v1.2 su XSP|ADP | |||
11 | Per il provisioning Flowthrough, il server applicazioni deve connettersi all'adattatore di provisioning BroadWorks.
| Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è aiutarti a comprendere, preparare, distribuire e gestire la tua soluzione Webex per Cisco BroadWorks. Le principali sezioni del documento riflettono tale obiettivo.
Questa guida include materiale concettuale e di riferimento. In questo documento intendiamo trattare tutti gli aspetti della soluzione.
La serie minima di attività per distribuire la soluzione è la seguente:

Contatta il team dell'account per diventare un partner Cisco. È fondamentale esplorare i punti di contatto Cisco per acquisire familiarità (e ricevere formazione). Quando si diventa partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Onboarding partner in questo documento.
Configura i tuoi sistemi BroadWorks per l'integrazione con Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento.
Usa Partner Hub per connettere Webex a BroadWorks. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione partner in Partner Hub in questo documento.
Utilizzare Partner Hub per preparare i modelli di provisioning degli utenti. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento.
Testare e eseguire l'onboarding di un cliente mediante il provisioning di almeno un utente (vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
|
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. (Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto).
Come funziona
Webex per Cisco BroadWorks è un'offerta che integra BroadWorks Calling in Webex. Gli abbonati utilizzano una singola applicazione (l'app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
Gli utenti chiamano i numeri PSTN utilizzando l'infrastruttura BroadWorks.
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino numerico per introdurre i numeri).
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Chiamata Webex" sull'app Webex. (Queste chiamate sono da app Webex a app Webex, non da app Webex a PSTN).
Gli utenti possono organizzare e accedere a Webex Meetings.
Gli utenti possono scambiarsi messaggi uno a uno o in spazi (chat di gruppo persistente) e beneficiare di funzioni come ricerca e condivisione file (sull'infrastruttura Webex).
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
Una volta eseguito l'onboarding come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare la relazione tra l'istanza BroadWorks e Webex.
È possibile creare organizzazioni dei clienti in Control Hub e eseguire il provisioning degli utenti in tali organizzazioni.
Ogni abbonato in BroadWorks riceve un'identità Webex in base al proprio indirizzo e-mail (attributo ID e-mail in BroadWorks).
Gli utenti eseguono l'autenticazione su BroadWorks o su Webex.
Ai clienti vengono rilasciati token di lunga durata per autorizzarli per i servizi su BroadWorks e Webex.

L'app Webex al centro di questa soluzione, è un'applicazione personalizzabile disponibile su desktop Mac/Windows e dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzionalità di messaggistica, presenza e riunioni.
Il client esegue la registrazione ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i tuoi sistemi BroadWorks per garantire un'esperienza di provisioning utente perfetta.

Funzioni e limitazioni
Offriamo diversi pacchetti con diverse caratteristiche.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata, ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano nella rubrica un utente softphone, i risultati della ricerca non forniscono alcuna opzione per inviare un messaggio.
Gli utenti del softphone possono condividere lo schermo durante una chiamata.
Pacchetto "base"
Il pacchetto di base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti in riunioni a "spazio unificato" e riunioni nella sala riunioni personale. (** vedere la seguente nota a titolo di eccezione). In questo pacchetto le riunioni possono avere una durata massima di 40 minuti.
Pacchetto "Standard"
Questo pacchetto include anche tutto quello che è contenuto nel pacchetto Base, ad esempio fino a 100 partecipanti nelle riunioni "spazio unificato" e nelle riunioni nella sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è un ruolo inizialmente ricoperto solo dall'organizzatore della riunione, ma l'organizzatore può passare il "ruolo di relatore" a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può riprendere il ruolo di relatore senza che l'organizzatore corrente glielo passi.
Pacchetto "Premium"
Questo pacchetto include tutto nel pacchetto Standard più un massimo di 300 partecipanti in una riunione "spazio unificato" e fino a 1000 partecipanti in una sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è supportata per qualsiasi partecipante alla riunione.
Confronta pacchetti
Pacchetto | Chiamata | Messaggistica | Riunioni nello spazio Unified | PMR riunioni |
---|---|---|---|---|
Softphone | Incluso | Non incluso | Nessuno | Nessuno |
Base | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Standard | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Premium | Incluso | Incluso | 300 partecipanti | 1000 partecipanti |
Il limite della riunione nello spazio Unified per gli utenti Base è 100 partecipanti per riunione nello spazio Unified a meno che lo spazio non includa anche gli utenti a cui sono assegnati i pacchetti "Standard" o "Premium", nel qual caso il limite aumenta in base al pacchetto utente organizzatore. |
"Riunioni nello spazio Unified" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti "Riunione" o "Pianifica". "Riunioni PMR" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale (PMR) di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID). |
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per le differenze di supporto delle funzioni di riunione PMR per i pacchetti Base, Standard e Premium.
Funzione riunione | Supportato con il pacchetto base | Suported con pacchetto standard | Supportato con il pacchetto Preminum | Commento |
---|---|---|---|---|
Durata riunione | 40 minuti o meno | Illimitato | Illimitato | |
Condivisione desktop | Sì | Sì | Sì | Base: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione desktop solo da parte dell'organizzatore della riunione PMR. Premium: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. |
Condivisione applicazione | Sì | Sì | Sì | Base: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione delle applicazioni solo da parte dell'organizzatore della riunione PMR. Premium: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. |
Chat con più interlocutori | Sì | Sì | Sì | |
Lavagna | Sì | Sì | Sì | |
Protezione con password | Sì | Sì | Sì | |
App Web - nessun download o plug-in (Esperienza ospite) | Sì | Sì | Sì | |
Supporto dell'accoppiamento con i dispositivi Webex | Sì | Sì | Sì | |
Controllo del pavimento (disattivazione del microfono uno / espulsione tutti) | Sì | Sì | Sì | |
Collegamento Riunioni persistenti | Sì | Sì | Sì | |
Accesso sito riunioni | Sì | Sì | Sì | |
Accesso alla riunione tramite VoIP | Sì | Sì | Sì | |
Bloccaggio | Sì | Sì | Sì | |
Controlli relatore | No | No | Sì | |
Controllo desktop remoto | No | No | Sì | |
Numero di partecipanti | 100 | 100 | 1000 | |
Registrazione salvata in locale nel sistema | Sì | Sì | Sì | |
Registrazione nel cloud | No | No | Sì | |
Registrazione - Cloud Storage | No | No | 10 GB per sito | |
Trascrizione delle registrazioni | No | No | Sì | |
Pianificazione riunione | Sì | Sì | Sì | |
Abilita condivisione contenuto con integrazioni esterne | No | No | Sì | Base: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. Standard: condivisione di contenuto solo da parte dell'organizzatore della riunione PMR. Premium: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. |
Consenti modifica URL PMR | No | No | Sì | Base: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori dei partner e delle organizzazioni possono modificare l'URL da Control Hub. Standard: l'URL PMR può essere modificato solo da Partner Hub per Partner e amministratori organizzazione. Premium: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori partner e dell'organizzazione possono modificare l'URL da Partner Hub. |
Streaming in diretta riunioni (Ad Esempio, su Facebook, Youtube) | No | No | Sì | |
Consenti ad altri utenti di pianificare riunioni per loro conto | No | No | Sì | |
Aggiungi organizzatore alternativo | Sì | No | Sì | |
Integrazione app (es., Zendesk, Slack) | Dipende dall'integrazione | Dipende dall'integrazione | Sì | Per ulteriori informazioni sul supporto, vedere la sezione Integrazioni app riportata di seguito. |
Integrazione con il calendario Microsoft Office 365 | Sì | Sì | Sì | |
Integrazione con Google Calendaring per G Suite | Sì | Sì | Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione rivolta agli utenti per Webex su help.webex.com
. Per ulteriori informazioni sulle funzioni, leggere i seguenti articoli:
Funzioni di chiamata
L'esperienza di chiamata è simile alle soluzioni precedenti che utilizzano il motore di controllo delle chiamate BroadWorks. La differenza tra UC-One Collaborate e UC-One SaaS è che l'app Webex è il client software principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
Zendesk—Solo Premium
Slack: solo Premium
Microsoft Teams per Webex Meetings—Standard o Premium
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
Calendario Office 365—Standard o Premium
Google Calendaring per G Suite: standard o premium
Supporto dell'infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta gli ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione per Webex per l'infrastruttura desktop virtuale (VDI).
Supporto per IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Tabella di marcia futura
Per informazioni sulle nostre intenzioni per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Le voci della roadmap non sono vincolanti in alcuna capacità. Cisco si riserva il diritto di sospendere o rivedere uno o tutti questi elementi dalle release future.
Limiti
Limitazioni di provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario del sito Webex Meetings creato per tale pacchetto.
Se nella richiesta di provisioning per il primo utente di ciascun pacchetto non viene specificato alcun fuso orario, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sull'impostazione predefinita regionale dell'organizzazione degli abbonati.
Se il cliente necessita di uno specifico fuso orario del sito di Webex Meetings, specificare timezone
parametro nella richiesta di provisioning per:
il primo abbonato predisposto per il pacchetto Standard nell'organizzazione.
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
il primo abbonato predisposto per il pacchetto base nell'organizzazione.
Limitazioni generali
Nessuna chiamata nella versione Web del client Webex (questa è una limitazione del client, non una limitazione della soluzione).
Webex potrebbe non disporre ancora di tutti i controlli dell'interfaccia utente per supportare alcune funzioni di controllo delle chiamate disponibili da BroadWorks.
Attualmente, il client Webex non può essere "White Labeled" (etichetta bianca).
Quando si creano le organizzazioni dei clienti utilizzando il metodo di provisioning scelto, vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. Ci aspettiamo che i partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
I report sull'utilizzo di riunioni e messaggi sono disponibili attraverso l'organizzazione del cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti di messaggistica
I seguenti limiti di archiviazione dei dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo storage massimo per messaggistica e file combinati.
Di base: 2 GB per utente per 3 anni
Standard 5 GB per utente per 3 anni
Premio: 10 GB per utente per 5 anni
Per ciascuna organizzazione del cliente, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti premium ha un limite totale di messaggistica e storage file di 50 GB. Un singolo utente può superare il limite per utente (10 GB), a condizione che la società sia ancora al di sotto del massimo aggregato (50 GB).
Per gli spazi team creati, i limiti di messaggistica vengono applicati al totale aggregato per l'organizzazione cliente che possiede lo spazio team. Puoi trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti generali di messaggistica applicabili agli spazi dei team di messaggistica Webex, fare riferimento a https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure le connessioni a Webex e BroadWorks. I dati memorizzati nel cloud Webex ed esposti all'utente attraverso l'interfaccia dell'app Webex sono crittografati sia in transito che a riposo.
Maggiori dettagli sullo scambio di dati sono disponibili nella sezione Riferimento del presente documento.
Ulteriori letture
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati che più si avvicina alla propria regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore del provider di servizi (utente): Per le attività di manutenzione quotidiane, si gestiscono le parti della soluzione in sede (chiamata) utilizzando i propri sistemi. Gestisci le parti Webex della soluzione attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale.
Il primo utente predisposto per un nuovo organizzatore partner viene assegnato automaticamente ai ruoli amministratore completo e amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi. |
Team operativo di Cisco cloud: Crea la tua "organizzazione partner" in Partner Hub, se non esiste, durante l'onboarding.
Una volta ottenuto l'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente, create "Onboarding templates" (Modelli di onboarding) per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Quindi si fornisce i vostri clienti o abbonati.
# | Compito tipico | SP | Cisco |
---|---|---|---|
1 | Onboarding partner - Creazione dell'organizzazione partner se non esiste e abilitazione dei tasti di alternanza funzione necessari | ● | |
2 | Configurazione BroadWorks nell'organizzazione partner tramite Partner Hub (cluster) | ● | |
3 | Configurazione delle impostazioni di integrazione in Organizzazione partner tramite Partner Hub (modelli di offerta, branding) | ● | |
4 | Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|ADP Patching, firewall, configurazione XSP|ADP, XSI, AuthService, CTI, NPS, applicazioni DMS su XSP|ADP) | ● | |
5 | Sviluppo dell'integrazione o del processo di provisioning | ● | |
6 | Preparare i materiali GTM | ● | |
7 | Migrazione o provisioning di nuovi utenti | ● |
Architettura

Cosa c'è nel diagramma?
Client
Il client dell'app Webex serve come applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di messaggistica nativa, presenza e riunioni audio/video multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per le chiamate SIP e PSTN.
I telefoni IP Cisco e i relativi accessori utilizzano anche l'infrastruttura BroadWorks per le chiamate SIP e PSTN. Ci aspettiamo di essere in grado di supportare telefoni di terze parti.
Portale di attivazione utente per gli utenti che accedono a Webex utilizzando le credenziali BroadWorks.
Partner Hub è un'interfaccia Web per l'amministrazione dell'organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. Puoi anche utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
Rete di provider di servizi
Il blocco verde a sinistra dello schema rappresenta la tua rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
XSP|ADP rivolto al pubblico, per Webex per Cisco BroadWorks: (La scatola rappresenta una o più fattorie XSP|ADP, eventualmente frontali da bilanciatori di carico).
Ospita l'interfaccia dei servizi Xtended (XSI-Actions & XSI-Events), il servizio di gestione dei dispositivi (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato del ricevitore dell'altro (presenza di telefonia) e la cronologia chiamate.
Pubblica la rubrica ai client Webex.
XSP|ADP rivolto al pubblico, con NPS in esecuzione:
server push notifiche chiamate organizzatore: Un server push di notifica su un ADP XSP| nel proprio ambiente. Si interfaccia tra il server applicazioni e il proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS & FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
Server applicazioni:
Fornisce il controllo delle chiamate e le interfacce ad altri sistemi BroadWorks (generalmente)
Per il provisioning flowthrough, l'AS viene utilizzato dall'amministratore del partner per il provisioning degli utenti in Webex
Inserisce il profilo utente in BroadWorks
OSS/BSS: Sistema di supporto alle operazioni/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nello schema rappresenta il cloud Webex. I microservizi Webex supportano l'intero spettro di funzionalità di collaborazione Webex:
Cisco Common Identity (CI) è il servizio identità all'interno di Webex.
Webex per Cisco BroadWorks rappresenta la serie di microservizi che supportano l'integrazione tra Webex e BroadWorks ospitato da provider di servizi:
API di provisioning utente
Configurazione provider di servizi
Accesso utente mediante credenziali BroadWorks
Casella di messaggistica Webex per microservizi correlati alla messaggistica.
Casella Webex Meetings che rappresenta server di elaborazione multimediale e SBC per riunioni video con più partecipanti (SIP e SRTP)
Servizi Web di terze parti
Nello schema sono rappresentati i seguenti componenti di terze parti:
APNS (Apple Push Notifications Service) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Apple.
FCM (messaggistica cloud FireBase) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Il ruolo dei server XSP|ADP aperti al pubblico in Webex per Cisco BroadWorks

L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste Webex per BroadWorks JWT (JSON Web Token) per conto dell'utente
Interfaccia CTI, protetta da mTLS, a cui Webex sottoscrive gli eventi della cronologia chiamate e lo stato della presenza di telefonia da BroadWorks (stato hook).
Interfacce azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate degli abbonati, rubriche di elenchi di contatti e chiamate e configurazione del servizio di telefonia per gli utenti finali
Servizio DM (Device Management) per il recupero dei file di configurazione delle chiamate da parte dei client
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedere Configurazione dei cluster BroadWorks in Partner Hub in questo documento. Per ciascun cluster, è possibile fornire un solo URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP


È necessario utilizzare un'istanza ADP XSP|dedicata o un'azienda agricola separata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile organizzare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso XSP|ADP che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/azienda agricola ADP XSP| dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
Ad esempio, se offri UC-One SaaS, ti consigliamo di creare una nuova fattoria XSP|ADP per Webex per Cisco BroadWorks. In questo modo i due servizi possono operare in modo indipendente durante la migrazione degli abbonati.
Se si collocano le applicazioni Webex per Cisco BroadWorks in una fattoria ADP|XSP utilizzata per altri scopi, è responsabilità dell'utente monitorare l'utilizzo, gestire la complessità risultante e pianificare l'aumento della scala.
Il pianificatore della capacità di sistema Cisco BroadWorks assume una fattoria ADP XSP| dedicata e potrebbe non essere preciso se la si utilizza per i calcoli della posizione.
Se non diversamente specificato, gli Webex dedicati per Cisco BroadWorks XSP|ADP devono ospitare le seguenti applicazioni:
AuthService (TLS con convalida token CI o mTLS)
CTI (mTLS)
Azioni XSI (TLS)
XSI-Events (TLS)
DMS (TLS): opzionale. Non è obbligatorio distribuire un'istanza DMS o un'azienda agricola separata specificamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
TLS (Call Settings Webview): opzionale. La vista Webview (CSW) delle impostazioni di chiamata è richiesta solo se si desidera che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso a CTI attraverso un'interfaccia protetta dall'autenticazione TLS reciproca. Per supportare questo requisito, raccomandiamo una delle seguenti opzioni:
(Diagramma etichettato Opzione 1) Una istanza XSP|ADP o un'azienda agricola per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
(Diagramma etichettato Opzione 2) Due istanze ADP XSP| o aziende agricole, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSP|ADP Se si dispone di una fattoria ADP XSP|esistente conforme a una delle architetture suggerite sopra (Opzione 1 o 2) ed è leggermente caricata, è possibile riutilizzare le ADP XSP|esistenti. Dovrai verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti dell'applicazione per Webex. Le due considerazioni principali sono:
Poiché gli XSP|ADP hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero esserci altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di XSP|ADP deve essere verificato in un laboratorio con la configurazione desiderata prima di impegnarsi per il riutilizzo. |
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione temporale per tutti gli XSP|ADP utilizzati con Webex.
Installare il ntp
pacchetto dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Quindi è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, consultare la Guida alla gestione del software BroadWorks.
Durante l'installazione interattiva del software XSP|ADP, è possibile configurare NTP. Procedere come segue:
Quando l'installatore chiede,
Do you want to configure NTP?
, immetterey
.Quando l'installatore chiede,
Is this server going to be a NTP server?
, immetteren
.Quando l'installatore chiede,
What is the NTP address, hostname, or FQDN?
, immettere l'indirizzo del server NTP o un servizio NTP pubblico, ad esempio,pool.ntp.org
.
Se gli ADP XSP|utilizzano un'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie Key=Value:
NTP
NTP_SERVER=<NTP Server address, e.g., pool.ntp.org>
Requisiti di identità e sicurezza XSP|ADP
Sfondo
I protocolli e le crittografie delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli vanno dal più generale (provider SSL) al più specifico (interfaccia singola). Un'impostazione più specifica sostituisce sempre un'impostazione più generale. Se non sono specificate, le impostazioni SSL di livello "inferiore" vengono ereditate da livelli "superiori".
Se non viene modificata alcuna impostazione rispetto alle impostazioni predefinite, tutti i livelli ereditano le impostazioni predefinite del provider SSL (JSSE Java Secure Sockets Extension).
Elenco dei requisiti
L'|ADP XSP deve autenticarsi sui client utilizzando un certificato firmato da CA in cui il nome comune o il nome alternativo oggetto corrispondono alla parte di dominio dell'interfaccia XSI.
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
Diffie-Hellman Effemeral (DHE) o curve ellittiche Diffie-Hellman Effemeral (ECDHE) chiave-scambio
Crittografia AES (Advanced Encryption Standard) con una dimensione minima di blocco di 128 bit (ad esempio, AES-128 o AES-256)
Modalità di codifica GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
Se viene utilizzata una crittografia CBC, solo la famiglia SHA2 di funzioni hash è consentita per derivazione chiave (SHA256, SHA384, SHA512).
Ad esempio, le seguenti crittografie soddisfano i requisiti:
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come illustrato sopra, non la convenzione openSSL. |
Crittografie TLS supportate per le interfacce AuthService e XSI
Questo elenco è soggetto a modifiche a mano a mano che evolvono i nostri requisiti di sicurezza del cloud. Seguire l'attuale raccomandazione sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento. |
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_128_GCM_SHA256
TLS_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA256
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_256_CBC_SHA
TLS_PSK_WITH_AES_256_CBC_SHA384
TLS_PSK_WITH_AES_256_CBC_SHA
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA
TLS_PSK_WITH_AES_128_CBC_SHA256
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri della scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il numero di thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi visualizzati come segue (non diminuirli se sono al di sopra di questi valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più |ADP XSP
Elemento bordo bilanciamento carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, deve gestire in modo trasparente la distribuzione del traffico tra più server XSP|ADP e il cloud e i client Webex per Cisco BroadWorks. In questo caso, è possibile fornire l'URL del bilanciatore di carico alla configurazione Webex per Cisco BroadWorks.

Note su questa architettura:
Configurare il DNS in modo che i client possano trovare il bilanciatore di carico quando si connettono all'interfaccia Xsi (vedere configurazione DNS).
Si consiglia di configurare l'elemento edge in modalità proxy SSL inversa per garantire la crittografia dei dati punto a punto.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Server XSP|ADP orientati verso Internet
Se si espongono direttamente le interfacce Xsi, utilizzare il DNS per distribuire il traffico ai più server XSP|ADP.

Note su questa architettura:
Per connettersi ai server XSP|ADP sono necessari due record:
Per i microservizi Webex: Per targetizzare più indirizzi IP XSP|ADP sono necessari record A/AAAA round-robin. Questo perché i microservizi Webex non possono effettuare ricerche SRV. Per esempi, vedere Servizi cloud Webex.
Per l'app Webex: Un record SRV che si risolve in record A in cui ogni record A si risolve in un singolo XSP|ADP. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per targetizzare il servizio XSI per più indirizzi XSP|ADP. Assegnare la priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (e all'indirizzo IP successivo) e passino al record A successivo (e all'indirizzo IP) solo se il primo indirizzo IP è inattivo. NON utilizzare un approccio round-robin per l'app Webex.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune.
È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL XSP|ADP di un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server XSP|ADP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.

Ordinazione e provisioning
L'ordine e il provisioning si applicano a questi livelli:
Provisioning di partner/provider di servizi:
Ogni onboarding di Webex per provider di servizi Cisco BroadWorks (o rivenditore) deve essere configurato come organizzazione partner in Webex e devono essere concesse le autorizzazioni necessarie. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per gestire Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le operazioni di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/aziendale.
Ordinazione e provisioning clienti/aziende:
Ogni BroadWorks Enterprise abilitato per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo si verifica automaticamente come parte del provisioning utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks vengono predisposti nella stessa organizzazione cliente Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
Ordinazione e provisioning utente/abbonato:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning degli utenti:
Provisioning fluviale con e-mail attendibili
Provisioning eseguibile senza e-mail attendibili
Self-provisioning utente
Provisioning API
Provisioning eseguibile con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile affermare che BroadWorks dispone di indirizzi e-mail abbonati validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.

Provisioning eseguibile senza e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non puoi contare sugli indirizzi e-mail degli abbonati detenuti da BroadWorks, questa opzione di provisioning crea account Webex ma non può attivarli fino a quando gli abbonati non forniscono e convalidano i relativi indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Self-provisioning utente
Con questa opzione, non è disponibile il provisioning flowthrough da BroadWorks a Webex. Una volta configurata l'integrazione tra Webex e il sistema BroadWorks, vengono visualizzati uno o più collegamenti specifici per il provisioning degli utenti all'interno dell'organizzazione partner Webex per Cisco BroadWorks.
Successivamente, si progettano le proprie comunicazioni (o si delegano ai clienti) per distribuire il collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare i propri account Webex.

Poiché gli account vengono predisposti nell'ambito dell'organizzazione partner, puoi regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare tale operazione.
Gli utenti devono esistere nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento. |
Provisioning provider di servizi per API
Webex presenta un set di API pubbliche che consentono di creare il provisioning utente/abbonato Webex per Cisco BroadWorks nel flusso di lavoro/negli strumenti di gestione utenti esistenti.


Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti Webex per Cisco Broadworks di comporre altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella rubrica Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo dell'estensione di tutte le aree del metodo di avvio chiamata e del profilo dell'utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e gruppi diversi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due imprese che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Utenti Cisco BroadWorks
Provisioning API pubblica come 'interno
Il parametro dell'interno deve essere esplicitamente passato come parte della chiamata API. Per le imprese/gruppi con Location Dialing Code (LDC) configurato, il parametro dell'interno dovrebbe essere la combinazione di LDC e 'numero di interno.
Provisioning flusso o auto-attivazione
Estensione e LDC (se applicabile) saranno automaticamente recuperati da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione di codice di chiamata posizione (LDC) e numero di interno.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'interno |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'estensione deve essere passata come parametro |
Attraverso il flusso | Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Elenchi telefonici BroadWorks | Elenchi telefonici aziendali, di gruppo o personali | Sincronizzazione rubriche | Non applicabile |
Prerequisiti
La versione del client richiesta per supportare questa funzione è 42.11 o successiva.
Patch in cui i codici di chiamata di estensione e posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
AP.platform.23.0.1075.ap380045
AP.as.23.0.1075.ap380045
AP.xsp.23.0.1075.ap380045
AP.as.24.0.944.ap380045
Abilitare l'intestazione X-BroadWorks-Remote-Party-Info su AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP richiesto per il supporto della funzione di composizione dell'interno.
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata a interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità delle chiamate di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'estensione come seconda opzione in Partner Hub e Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con estensione attraverso uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione dell'interno sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Non verrà visualizzata un'estensione nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere visibile l'opzione di chiamata dell'interno per i clienti esistenti:
Se un partner desidera che tutte le organizzazioni dei clienti gestite siano dotate di un interno come una delle opzioni di chiamata, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
Se un partner desidera fornire un interno in opzioni di chiamata per una specifica organizzazione cliente, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e portarli alla pari con l'aumento di 30K contatti per l'elenco telefonico Enterprise, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per Organizzazione, che si applica alla somma degli elenchi telefonici Enterprise e Group in una singola azienda BroadWorks. Ad esempio, sarà supportato un'azienda BroadWorks che dispone di un elenco di telefoni aziendali con 30K e anche di 5 elenchi di telefoni di gruppo ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K totali).
Questa funzione è disponibile su richiesta. Contatta il team dell'account per abilitare questa opzione.
|
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks nello storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare a quale gruppo appartiene questo utente. L'associazione dell'utente con un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca dei contatti nello storage del gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning degli abbonati Webex per BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
È possibile eseguire il provisioning dell'ID gruppo aziendale BroadWorks per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Webex per gli utenti Cisco BroadWorks
Provisioning API pubblica come "spEnterpriseGroupId"
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
Provisioning flusso o auto-attivazione
L'ID gruppo aziendale BroadWorks verrà automaticamente recuperato da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Non applicabile. Non è necessario sincronizzare l'ID gruppo aziendale BroadWorks per questi utenti.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'ID gruppo aziendale BroadWorks deve essere superato come parametro spEnterpriseGroupId |
Attraverso il flusso | L'ID gruppo aziendale BroadWorks viene recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Non applicabile |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Non applicabile |
Elenchi telefonici BroadWorks | Contatti negli elenchi telefonici del gruppo BroadWorks | Sincronizzazione rubriche | I contatti di gruppo vengono memorizzati nel servizio Webex Contact associato al gruppo specifico |
Elenchi di telefoni BroadWorks Enterpsie o Persional | Contatti negli elenchi telefonici aziendali o personali | Sincronizzazione rubriche | Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. Impossibile completare la migrazione fino a quando QUESTA API non viene completata. L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march Una volta abilitata la funzione e a seguito della sincronizzazione della rubrica successiva, i gruppi di utenti aziendali verranno visualizzati anche in Control Hub. La visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativa in questa fase. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza a un gruppo in Control Hub poiché tali modifiche non verranno riportate nuovamente in BroadWorks. La gestione di gruppo in Control Hub è destinata all'uso da parte dei partner che adotteranno le prossime API di gestione contatti. |
Migrazione e prova del futuro
La progressione Cisco del client di comunicazione unificata BroadSoft deve spostarsi da UC-One a Webex. Si verifica una corrispondente progressione dei servizi di supporto dalla rete del provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che tu stia eseguendo UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita consiste nel distribuire nuovi ADP|XSP dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti in Webex e infine recuperare l'infrastruttura utilizzata per la soluzione precedente.
Sottoscrizioni di documenti consigliate
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Abbonati che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di eseguire l'abbonamento a ciascuno dei seguenti articoli per assicurarsi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per iscriversi, accedere a ciascuno dei link seguenti e nell'articolo che viene visualizzato fare clic sul pulsante Iscriviti.
Come minimo, si consiglia di iscriversi all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati in Documenti aggiuntivi dispone di un'opzione Sottoscrivi . Affinché questa opzione venga visualizzata, l'articolo deve essere visualizzato su help.webex.com.
Non esiste un'opzione di abbonamento per le landing page di documentazione. |
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Documenti Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
Porta la tua soluzione PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono di loro proprietà (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive come eseguire l'onboarding e il servizio dei dispositivi Room OS e MPP.
Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi di Webex per Cisco BroadWorks.
Articoli Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti siti opzionali per ulteriori informazioni su Webex per Cisco BroadWorks:
Documentazione Webex per Cisco BroadWorks: nella pagina di destinazione vengono elencati i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme a quelle presto disponibili.
Problemi noti e limitazioni: informazioni sui problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale: questo articolo descrive come assegnare i ruoli amministratore partner per le organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte della soluzione Cisco BroadWorks:
Articoli della Guida Webex
I seguenti siti della Guida Webex possono essere utilizzati per trovare gli articoli Webex che consentono agli amministratori dei clienti e agli utenti finali di utilizzare le funzioni Webex.
Webex da provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati comunemente per gli utenti dell'app Webex che hanno acquistato i servizi Webex da un provider di servizi.
Centro assistenza Webex: utilizzare la funzione di ricerca su help.webex.com per cercare altri articoli Webex che descrivono la funzionalità dell'app Webex e di Webex Meetings. È possibile ricercare gli articoli utente o amministratore.
Documentazione sviluppatore
Guida per sviluppatori Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Punti di decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastrutture
|
Quanti ADP XSP|? Come prendono l'mTLS? |
Pianificatore capacità di sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento CLI XSP|ADP Il presente documento |
Provisioning cliente e utente | Puoi affermare che ti fidi dei messaggi e-mail in BroadWorks? Vuoi che gli utenti forniscano indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Documenti API pubbliche su https://developer.webex.com Il presente documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo di branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso per i clienti? | Il presente documento |
Funzioni abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o Softphone. | Il presente documento Matrice caratteristiche/pacchetto |
autenticazione protetta | BroadWorks o Webex | Il presente documento |
Adattatore di provisioning (per opzioni di provisioning flowthrough) | Utilizzate già IM&P integrato, ad esempio per UC-One SaaS? Si desidera utilizzare più modelli? È previsto un caso d'uso più comune? |
Il presente documento Riferimento CLI server applicazioni |
Architettura e infrastrutture
Con che tipo di scala intende iniziare? È possibile scalare in futuro, ma la stima di utilizzo attuale dovrebbe guidare la pianificazione dell'infrastruttura.
Collaborare con il proprio account manager/rappresentante di vendita Cisco per dimensionare l'infrastruttura ADP XSP|, in base al Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
In che modo Webex renderà le connessioni TLS reciproche alle tue ADP XSP|? Direttamente a XSP|ADP in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce. (Non supportiamo connessioni TCP non crittografate al perimetro della rete).
Provisioning cliente e utente
Quale metodo di provisioning utente si adatta meglio?
Provisioning eseguibile con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene predisposto automaticamente in Webex.
Se puoi anche affermare che gli indirizzi e-mail dell'abbonato in BroadWorks sono validi e univoci per Webex, puoi utilizzare la variante "email attendibili" del provisioning flowthrough. Gli account Webex abbonati vengono creati e attivati senza il loro intervento; scaricano semplicemente il client e accedono.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto, il provider di servizi deve fornire un indirizzo e-mail valido all'utente per eseguire il provisioning dei servizi Webex. Questo deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo anche nell'attributo ID alternativo.
Provisioning eseguibile senza e-mail attendibili: Se non riesci a fidarti degli indirizzi e-mail degli abbonati, puoi comunque assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
Self-provisioning utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. Tu (o i tuoi clienti) distribuisci invece un collegamento di provisioning e i collegamenti per scaricare i diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare gli account Webex. Quindi, scaricano il client e accedono e Webex recupera una configurazione aggiuntiva su di essi da BroadWorks (inclusi i numeri principali).
Provisioning controllato da SP tramite API: Webex espone una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei propri flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti di sistema generali descritti in questa guida.
Metodo di provisioning | Requisiti |
---|---|
Provisioning del flusso (e-mail attendibili o non attendibili) | L'API di provisioning Webex aggiunge automaticamente gli utenti BroadWorks esistenti a Webex una volta che l'utente soddisfa i requisiti e si attiva il servizio Integrated IM+P. Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Self-provisioning utente | L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato il messaggio e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) | Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono previsti due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, vai a Utenti BroadWorks. |
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Impostazioni internazionali lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente di amministrazione con provisioning viene assegnata automaticamente come locale predefinita per l'organizzazione del cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti a riunioni all'interno dell'organizzazione del cliente.
Sono supportate le impostazioni internazionali in lingua a cinque caratteri (ISO-639-1)_(ISO-3166). Ad esempio, en_US corrisponde a English_UnitedStates. Se viene richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genera un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso internazionale dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, viene utilizzata l'impostazione locale ragionevole predefinita in base al codice della lingua richiesto.
Nella tabella riportata di seguito vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice lingua a due lettere in un'impostazione locale a cinque caratteri per le situazioni in cui un'impostazione locale a cinque caratteri non è disponibile.
Impostazioni internazionali lingua supportate (ISO-639-1)_(ISO-3166) | Se è disponibile solo un codice lingua a due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** | Usa impostazioni internazionali sensibili di default (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA | en en | en_USA |
fr_Fr fr_CA | Fr | fr_Fr |
cs_CZ | cs | cs_CZ |
da_DK | da | da_DK |
de_DE | DE | de_DE |
hu_HU | hu | hu_HU |
id_ID | ID | id_ID |
it_IT | IT | it_IT |
ja_JP | ja | ja_JP |
ko_KR | ko | ko_KR |
es_ES es_CO es_MX | ES | es_ES |
nl_NL | NL | nl_NL |
nb_NO | nb. | nb_NO |
pl_PL. | pl. | pl_PL. |
pt_PT pt_BR | pt | pt_PT |
ru_RU | RU | ru_RU |
ro_RO | ro | ro_RO |
zh_CN zh_TW | zh | zh_CN |
sv_SE | sv | sv_SE |
ar_SA | ar | ar_SA |
tr_TR | tr | tr_TR |
Le impostazioni internazionali es_CO, id_ID, nb_NO e pt_PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti Webex Meetings saranno solo in inglese. Inglese è la impostazioni internazionali predefinite per i siti se per il sito non sono richieste impostazioni internazionali non valide/non supportate. Questo campo lingua è applicabile durante la creazione di un'organizzazione e un sito Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, la lingua del modello verrà utilizzata come lingua predefinita. |
Branding
Gli amministratori partner possono utilizzare le personalizzazioni avanzate del branding per personalizzare l'aspetto dell'app Webex per le organizzazioni di clienti gestite dal partner. Gli amministratori partner possono personalizzare le seguenti impostazioni per garantire che l'app Webex rifletta il marchio e l'identità della società:
Loghi aziendali
Combinazioni di colori univoche per la modalità Chiaro o Scuro
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione delle personalizzazioni di branding avanzate.
|
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding come richiesto, ma quando si esegue l'onboarding di un cliente è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Alcuni parametri del modello principale sono elencati di seguito.
Pacchetto
È necessario selezionare un pacchetto predefinito quando si crea un modello (vedere Pacchetti nella sezione Panoramica per dettagli). Tutti gli utenti predisposti con tale modello, tramite flowthrough o self-provisioning, ricevono il pacchetto predefinito.
È possibile controllare la selezione dei pacchetti per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno di essi. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori di provisioning per azienda, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
È possibile modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedere Webex per la documentazione API Cisco BroadWorks o attraverso Partner Hub (vedere Modifica pacchetto utente in Partner Hub).
Non puoi modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è attivata o disattivata; se all'abbonato viene assegnato questo servizio in BroadWorks, il modello Partner Hub associato all'URL di provisioning aziendale di tale abbonato definisce il pacchetto.
Rivenditore e aziende o fornitore di servizi e gruppi?
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se sei un rivenditore con Enterprise, devi abilitare la modalità Enterprise quando crei un modello.
Se il sistema BroadWorks è configurato in modalità provider di servizi, è possibile lasciare disattivata la modalità Enterprise nei modelli.
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch BroadWorks richieste per il provisioning flow-through. Per ulteriori dettagli, vedere Patch richieste con provisioning flow-through. |
Modalità di autenticazione
Decidi come desideri che gli abbonati eseguano l'autenticazione quando accedono a Webex. È possibile assegnare la modalità utilizzando l'impostazione Modalità di autenticazione nel modello di onboarding. Nella tabella seguente sono riportate alcune opzioni.
Questa impostazione non ha effetto sull'accesso al portale di attivazione utente. Gli utenti che accedono al portale devono immettere l'ID utente e la password BroadWorks, come configurati su BroadWorks, indipendentemente da come si configura la modalità di autenticazione nel modello di onboarding. |
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | ID utente BroadWorks | Indirizzo e-mail |
Provider identità | BroadWorks.
| Identità comune Cisco |
Autenticazione a più fattori? | No | Richiede IdP del cliente che supporta l'autenticazione a più fattori. |
Percorso di convalida delle credenziali
|
|
|
Per una ripartizione più dettagliata del flusso di accesso SSO con autenticazione diretta a BroadWorks, vedere Flusso di accesso SSO. |
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che si può verificare con password che utilizzano caratteri speciali per cui il browser Web non codifica correttamente i caratteri. Utilizzando un'intestazione con codifica UTF-8, con codifica base 64, risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
Paese
Quando si crea un modello, è necessario selezionare un paese. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie S. | Posizione | Prefisso internazionale | Nome paese |
---|---|---|---|
1 | AMER | +1 | NOI, CA |
2 | APAC | +65 | Singapore |
3 | ANZ | +61 | Australia |
4 | EMEA | +44 | Regno Unito |
5 | EURO | +49 | Germania |
Accordi con più partner
Vuoi concedere in sublicenza Webex per Cisco BroadWorks a un altro provider di servizi? In questo caso, ciascun provider di servizi avrà bisogno di un'organizzazione partner distinta in Webex Control Hub per consentire loro di fornire la soluzione per la propria base clienti.
Adattatore di provisioning e modelli
Quando si utilizza il provisioning flowthrough, l'URL di provisioning inserito in BroadWorks viene derivato dal modello in Control Hub. È possibile disporre di più modelli e quindi di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati al momento della concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e quale modello si desidera utilizzare a tale scopo. In questo modo, è necessario impostare esplicitamente l'URL di provisioning per le aziende che necessitano di un modello diverso.
Inoltre, tenere presente che è possibile che si stia già utilizzando un URL di provisioning a livello di sistema, ad esempio con UC-One SaaS. In tal caso, è possibile scegliere di mantenere l'URL a livello di sistema per il provisioning degli utenti su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono dettagliate in Configura server applicazioni con URL servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning flowthrough tra AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server AS e Webex, annullando in tal modo la necessità di connettersi direttamente al servizio Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati che si sta eseguendo il provisioning per Webex devono esistere nel sistema BroadWorks integrato con Webex. È possibile integrare più sistemi BroadWorks, se necessario.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero o interno principale.
Webex utilizza gli indirizzi e-mail come identificatori principali per tutti gli utenti. Se si utilizza il provisioning flowthrough con e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail degli abbonati nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo di utenti di chiamata BroadWorks con un numero principale e/o interno. Se si utilizza il provisioning flowthrough, agli utenti deve essere assegnato anche il servizio IM&P integrato. |
Server nella rete e requisiti software
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Le istanze BroadWorks devono includere almeno i seguenti server:
Server applicazioni (AS) con versione BroadWorks come sopra
Server di rete (NS)
Server profilo (PS)
Server XSP|ADP o piattaforma di distribuzione delle applicazioni (ADP) di fronte al pubblico che soddisfano i seguenti requisiti:
Servizio di autenticazione (BWAuth)
Interfacce azioni ed eventi XSI
DMS (applicazione Web di gestione dispositivi)
Interfaccia CTI (Intergrazione Di Telefonia Informatica)
TLS 1.2 con certificato valido (non autofirmato) e qualsiasi intermediazione richiesta. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
Autenticazione Mutual TLS (mTLS) per il servizio di autenticazione (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Autenticazione Mutual TLS (mTLS) per l'interfaccia CTI (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Un server XSP/ADP separato che agisce come "Call Notifications Push Server" (un NPS nel tuo ambiente utilizzato per le notifiche di chiamata push per Apple/Google. Lo chiamiamo "CNPS" qui per distinguerlo dal servizio in Webex che fornisce notifiche push per messaggi e presenza).
Questo server deve essere su R22 o versione successiva.
Viene richiesto un server XSP/ADP separato per CNPS poiché l'imprevedibilità del carico da Webex per le connessioni cloud BWKS potrebbe influire negativamente sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSP|ADP, consultare la Guida tecnica di sistema Cisco BroadWorks.
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, andare a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
PC/laptop Windows
PC/laptop Apple con MacOS
iOS (Apple Store)
Android (Play store)
Browser Web (vai a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (tradizionale cinese)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (italiano)
Telefoni e accessori fisici
Telefoni IP Cisco:
telefono IP Cisco serie 6800 con firmware multipiattaforma
telefono IP Cisco serie 7800 con firmware multipiattaforma
telefono IP Cisco serie 8800 con firmware multipiattaforma
Vedere https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html per i modelli e ulteriori informazioni.
I telefoni di terze parti sono supportati allo stesso modo di altre integrazioni BroadWorks. Tuttavia, non dispongono ancora dell'integrazione di contatti e presenza con Webex per Cisco BroadWorks.
Adattatori:
Adattatore per telefono analogico multipiattaforma Cisco ATA 191
Adattatore per telefono analogico multipiattaforma Cisco ATA 192
Vedere https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html per i modelli e ulteriori informazioni.
Cuffie:
cuffia Cisco serie 500
Vedi https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html per i modelli e ulteriori informazioni.
Dispositivi Room OS:
Serie Webex Room e Room Kit
Serie Webex Desk
Serie Webex Board
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e l'assistenza dei dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivo
Di seguito sono riportati i file DTAF che devi caricare sui server delle applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia c'è una nuova config-wxt.xml.template
file utilizzato per l'app Webex.
Per scaricare i profili dei dispositivi più recenti, andare al sito di Download software della piattaforma di consegna delle applicazioni per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che per XSP.
Nome del cliente | Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Comunicatore aziendale - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili del dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Genera una richiesta di servizio con l'agente di onboarding o con Cisco TAC per eseguire il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il titolo della richiesta per le rispettive funzioni:
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
'NPS Configuration for Auth Proxy Setup' (Configurazione NPS per impostazione proxy automatica) per configurare NPS per l'uso del proxy di autenticazione.
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori informazioni su questa funzione, vedere: Supporto di Cisco BroadWorks per CI UUID.
Configura BroadWorks per abilitare la fatturazione Cisco per BroadWorks e Webex Per abbonamenti BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento valido per 60 giorni. Se il token scade prima di utilizzarlo, è possibile presentare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali. |
Certificati ordine
Requisiti di certificato per l'autenticazione TLS
Per tutte le applicazioni richieste, saranno necessari i certificati di sicurezza, firmati da un'autorità di certificazione ben nota e distribuiti su ADP XSP|pubblico. Verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in entrata ai server XSP|ADP.
Questi certificati devono includere il nome di dominio pubblico XSP|ADP completo come Nome comune oggetto o Nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati del server dipendono da come vengono distribuiti gli ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume dove il certificato del server pubblico firmato da CA deve essere caricato in questi tre casi:

Le autorità di certificazione supportate pubblicamente dall'app Webex per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per proxy bridge TLS
Il certificato del server firmato pubblicamente viene caricato nel proxy.
Il proxy presenta questo certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Un certificato firmato CA interno può essere caricato su XSP|ADP.
L'|ADP XSP presenta questo certificato del server firmato internamente al proxy.
Il proxy si basa sulla CA interna che ha firmato il certificato del server XSP|ADP.
Requisiti di certificato TLS per proxy passthrough TLS o XSP|ADP in DMZ
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
Gli ADP XSP|presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca sull'interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione Mutual TLS. Il certificato CA/catena del certificato del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedi a Partner Hub, vai a
e fai clic sul collegamento del certificato di download.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume i requisiti del certificato in questi tre casi:

Requisiti del certificato (opzione) per proxy bridge TLS
Webex presenta un certificato client firmato pubblicamente al proxy.
Il proxy considera attendibile la CA interna di Cisco che ha firmato il certificato del client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta il certificato del server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions: X509v3 Extended Key Usage: 1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Il CN del certificato interno deve essere
bwcticlient.webex.com
.
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le autorità pubbliche di certificazione potrebbero non essere disposte a firmare i certificati con l'OIDE proprietario di BroadWorks richiesto. In caso di proxy di bridging, è possibile che sia necessario utilizzare una CA interna per firmare il certificato del client che il proxy presenta all'ADP XSP|.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Il ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XSP| dal proxy.
Requisiti di certificato (opzione) per proxy passthrough TLS o XSP|ADP in DMZ
Webex presenta un certificato client firmato da CA Cisco interno alle ADP XSP|.
Gli ADP XSP|si fidano delle autorità di certificazione interne di Cisco che hanno firmato il certificato client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XSP|.
Gli ADP XSP|presentano i certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Il server applicazioni ClientIdentity contiene il CN del certificato del client firmato Cisco presentato a XSP|ADP da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene l'elenco di indirizzi IP, porte e protocolli richiesti per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle dei firewall delle regole di ingresso e uscita precedenti documentano solo le connessioni specifiche di Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico per Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e la rilevanza di ciascuna sezione per Webex per Cisco BroadWorks.
Sezione Requisiti di Rete Art. | Rilevanza delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex | Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud | Informativo |
Da leggere | |
Da leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex | Da leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione | Opzionale |
Servizi Webex per clienti FedRAMP | N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedi il whitepaper del firewall dell'app Webex (PDF).
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza XSP|ADP di Broadworks fornita dal partner. Quando un ADP o un sito XSP|non è disponibile per manutenzione pianificata o motivo non pianificato, i servizi e le app Webex possono passare a un altro ADP o sito XSP|fornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP Broadworks XSP|possono essere distribuiti direttamente su Internet o possono risiedere in un DMZ frontale da un elemento di bilanciamento del carico come F5 BIG-IP. Per fornire ridondanza geografica, gli ADP XSP|possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un bilanciatore di carico, ognuno con un indirizzo IP pubblico. Se gli ADP XSP| sono dietro a un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e Broadworks sembra avere solo un XSP|ADP, anche se vi sono più ADP XSP| dietro.
Nell'esempio seguente, le ADP|XSP vengono distribuite in due siti, il Sito A e il Sito B. Esistono due ADP|XSP frontali di un bilanciatore di carico in ogni sito. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali di LB1 e il sito B ha XSP|ADP3 e XSP|ADP4 frontali di LB2. Solo i bilanciatori di carico sono esposti sulla rete pubblica e le ADP|XSP sono nelle reti private DMZ.

Servizi cloud Webex
Configurazione DNS
I microservizi cloud Webex devono essere in grado di trovare il server|ADP Broadworks XSP per la connessione alle interfacce Xsi, al servizio di autenticazione e al CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host XSP|ADP configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso. Se vengono restituiti più indirizzi IP, viene selezionato il primo IP nell'elenco. La ricerca SRV non è attualmente supportata.
Esempio: Il DNS A Record del partner per la scoperta del server XSP|ADP/Load Balancers bilanciato Round-Robin.
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Punti a LB1 (Sito A) |
R |
|
| Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Failover
Quando i microservizi Webex inviano una richiesta al servizio |di bilanciamento del carico/ADP XSP e la richiesta non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se non viene ricevuta alcuna risposta HTTP entro 2 secondi, la richiesta viene timeout e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento dell'indirizzamento all'IP successivo.
Ciascuna richiesta viene provata 3 volte prima di segnalare un errore al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco degli indirizzi da provare quando si invia una richiesta a un XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna nell'elenco per provare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco bloccato. Se l'operazione va a buon fine, tale indirizzo IP viene rimosso dall'elenco bloccato.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP|XSP o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster BroadWorks Calling, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
Azioni XSI
Eventi XSI
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Gli stati delle connessioni possono essere:
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
Rosso: Quando tutti gli IP nella ricerca di record sono irraggiungibili e l'interfaccia non è disponibile.

I seguenti servizi utilizzano i microservizi per connettersi agli XSP|ADP e sono interessati dalla disponibilità dell'interfaccia XSP|ADP:
Accesso all'app Webex
Aggiornamento token app Webex
E-mail/autoattivazione non attendibile
Controllo stato servizio Broadworks
App Webex
Configurazione DNS
L'app Webex accede ai servizi Xtended Services Interface (XSI-Actions & XSI-Events) e Device Management Service (DMS) su XSP|ADP.
Per trovare il servizio XSI, l'app Webex esegue la ricerca DNS SRV per _xsi-client._tcp.<webex app xsi domain>
. L'SRV punta all'URL configurato per gli host XSP|ADP o i bilanciatori di carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex torna alla ricerca A/AAAA.
L'SRV può risolversi in più target A/AAAA. Tuttavia, ogni record A/AAAA deve mappare solo a un singolo indirizzo IP. Se sono presenti più ADP|XSP in un DMZ dietro il dispositivo di bilanciamento del carico/bordo, è necessario che il bilanciatore di carico sia configurato per mantenere la persistenza della sessione in modo da indirizzare tutte le richieste della stessa sessione allo stesso XSP|ADP. Questa configurazione viene avviata perché i heartbeat dell'evento XSI del client devono andare allo stesso XSP|ADP utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non deve esistere. Se il DNS richiede che un record A/AAAA deve essere definito, allora deve essere restituito solo 1 indirizzo IP. Indipendentemente da ciò, l'SRV deve essere ancora definito per l'app Webex. Se l'app Webex utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client alla fine invia heartbeat a un XSP|ADP dove non ha stabilito un canale per eventi. Di conseguenza, il canale viene strappato e il traffico interno è notevolmente più intenso, il che pregiudica le prestazioni del cluster ADP|XSP. Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca di record A/AAAA, è necessario utilizzare un nome di dominio completo separato per Webex Cloud e l'app Webex per accedere agli ADP|XSP. Come mostrato negli esempi, Webex Cloud utilizza Un record |
Esempio 1: ADP|XSP multipli, ciascuno dietro bilanciatori di carico separati
In questo esempio, SRV punta a disattivare l'audio dei record A con ogni record A che punta a un bilanciatore di carico diverso su un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito un esempio di record SRV.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Esempio 2: più amministratori XSP| dietro un singolo bilanciatore di carico (con bridge TLS)
Per la richiesta iniziale, il bilanciatore di carico seleziona un XSP|ADP casuale. XSP|ADP restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il bilanciatore di carico utilizza il cookie per indirizzare la connessione all'ADP XSP|corretto, assicurandosi che il canale dell'evento non si interrompa.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Bilanciatore di carico |
R | LB.esempio.com |
| Indirizzo IP del bilanciatore di carico (XSP|ADP sono dietro al bilanciatore di carico) |
URL DMS
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il file di configurazione. Viene eseguita l'analisi dell'organizzatore nell'URL e l'app Webex esegue la ricerca DNS A/AAAA dell'organizzatore per connettersi all'ADP XSP|che ospita il servizio DMS.
Esempio: DNS Un record per la scoperta di Round-Robin bilanciato server XSP|ADP/Bilanciamento del carico di Webex App per scaricare i file di configurazione tramite DMS:
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Come l'app Webex trova gli indirizzi XSP|ADP
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (sono stati inseriti quando si crea il cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue la ricerca SRV nel modo seguente:
Il cliente esegue una ricerca SRV per _xsi-cliente._tcp.<xsi domain="">
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
Il cliente cerca gli obiettivi A/AAAA e memorizza nella cache gli indirizzi IP restituiti.
Il client si connette a uno dei target (e quindi al suo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi al peso (o a caso se sono tutti uguali).
Se la ricerca SRV non restituisce alcun obiettivo:
Il client esegue una ricerca A/AAAA del parametro principale Xsi e quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso.
Come indicato, il record A/AAAA deve risolversi in un indirizzo IP per le stesse ragioni.
(Opzionale) Successivamente, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocols> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
Se esistono, il client confronterà l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
Se viene rilevata una differenza, il client re-inizializzerà la connettività XSI Actions/XSI Events. La prima fase consiste nell'eseguire lo stesso processo di ricerca DNS elencato nella fase 1, richiedendo questa volta una ricerca del valore nel %XSI_ROOT_WXT% parametro dal file di configurazione.
Assicurarsi di creare i record SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
Failover
Durante l'accesso, l'app Webex esegue una ricerca DNS SRV per _xsi-client._tcp.<xsi domain="">, crea un elenco di organizzatori e si connette a uno degli organizzatori in base alla priorità SRV, quindi al peso. Questo organizzatore connesso diventa quello selezionato per tutte le richieste future. Viene quindi aperto un canale evento all'organizzatore selezionato e viene inviato regolarmente un heartbeat per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP, pertanto è importante che il bilanciatore di carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server XSP|ADP di backend.
Se una richiesta o una richiesta heartbeat a un organizzatore non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), l'indirizzamento dell'app Webex viene eseguito immediatamente all'organizzatore successivo nell'elenco.
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e l'indirizzamento passa all'organizzatore successivo nell'elenco.
Se una risposta non viene ricevuta entro un periodo di tempo, la richiesta viene considerata non riuscita a causa del timeout e le richieste successive vengono inviate al successivo organizzatore. Tuttavia, la richiesta scaduta viene considerata come non riuscita. Alcune richieste vengono riprovate dopo l'errore (con un tempo di riprova crescente). Le richieste che il presunto non vitale non sono riprovate.
Quando un nuovo organizzatore viene provato correttamente, diventa il nuovo organizzatore selezionato se l'organizzatore è presente nell'elenco. Una volta provato l'ultimo organizzatore nell'elenco, l'app Webex passa al primo.
In caso di heartbeat, se si verificano due errori di richiesta consecutivi, l'app Webex re-inizializzerà il canale eventi.
Tenere presente che l'app Webex non esegue il failback e che il rilevamento del servizio DNS viene eseguito solo una volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione attraverso l'interfaccia XSP|ADP/Dms. Esegue una ricerca di record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Innanzitutto, tenterà di inviare la richiesta per scaricare il file di configurazione utilizzando un token SSO. Se ciò non riesce per qualsiasi motivo, verrà riprovato ma con il nome utente e la password del dispositivo.
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning dell'utente. Molte delle attività sono comuni a tutte le modalità di provisioning.



Onboarding dei partner per Webex per Cisco BroadWorks
Ciascun provider o rivenditore di servizi Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, è necessario eseguire la documentazione Cisco BroadWorks di Webex e i nuovi partner devono accettare l'ICPA (Indirect Channel Partner Agreement) online. Al termine di queste operazioni, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, il tuo Partner Activation e/o Customer Success Program Manager ti contatterà per iniziare il tuo onboarding.
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
È necessario eseguire l'applicazione NPS su un altro XSP|ADP. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi sugli ADP XSP|.
Servizio/Applicazione | Autenticazione richiesta | Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
autenticazione protetta |
Integrazione telefonia computer |
mTLS (client e server si autenticano a vicenda) |
Presenza di telefonia |
Applicazione Webview Impostazioni chiamata |
TLS (il server esegue l'autenticazione per i client) |
Mostra le impostazioni di chiamata utente nel portale Assistenza utente all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma occorre fare riferimento alla documentazione esistente per installare le applicazioni sugli ADP|XSP.
Requisiti di coresidenza
Il servizio di autenticazione deve essere coresidente con le applicazioni Xsi, perché tali interfacce devono accettare token di lunga durata per l'autorizzazione del servizio. Il servizio di autenticazione è richiesto per convalidare tali token.
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
È possibile separare gli altri servizi/applicazioni come richiesto per la propria bilancia (gestione dispositivi dedicata XSP|ADP farm, ad esempio).
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
Non installare altre applicazioni o servizi sugli ADP XSP| utilizzati per integrare BroadWorks con Webex.
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se è in esecuzione R22 o versione superiore e il sistema lo supporta.
Mutual TLS (mTLS) è supportato anche come metodo di autenticazione alternativo per il servizio Auth. Se più organizzazioni Webex eseguono lo stesso server ADP XSP|, è necessario utilizzare l'autenticazione mTLS poiché la convalida token CI non supporta più connessioni allo stesso servizio autenticazione ADP XSP|. Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida del token CI, fare riferimento all'Appendice per configurare i servizi (con mTLS per il servizio di autenticazione). |
Se attualmente si utilizza mTLS per il servizio autenticazione, non è obbligatorio riconfigurare l'uso della convalida token CI con TLS. |
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks.
Installare le seguenti patch su ciascun server ADP XSP|. Installare le patch appropriate alla release in uso:
Per R22:
Per R23:
Per R24: non è necessario alcun cerotto
Qualsiasi riferimento a XSP include XSP o ADP.Installare il
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP al percorso del contesto /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire il servizio di autenticazione su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
A partire da Broadworks build 2022.10, le autorità di certificazione in arrivo con Java non vengono più automaticamente incluse nel trust store BroadWorks quando si passa a una nuova versione di java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
Radice commerciale IdenTrust CA 1
autorità di certificazione radice Go Daddy - G2
Verificare che questi certificati siano presenti sotto la seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get
Se non presente, eseguire il seguente comando per importare i trust Java predefiniti:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come ancoraggi attendibili con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono automaticamente importate nella nuova release e continueranno a essere importate finché non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere la FD di convalida del certificato Cisco Broadworks X509.
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server ADP XSP|:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get
set clientId client-Id-From-Step1
set enabled true
set clientSecret client-Secret-From-Step1
set ciResponseBodyMaxSizeInBytes 65536
set issuerName <URL>
- Per ilURL
, immettere l'URL IssuerName che si applica al cluster CI. Vedere la tabella seguente.set issuerUrl <URL>
- Per ilURL
, immettere l'IssuerUrl che si applica al cluster CI. Vedere la tabella seguente.set tokenInfoUrl <IdPProxy URL>
—Inserire l'URL proxy IdP applicabile al cluster dei team. Si veda la seconda tabella che segue.
Tabella 1. Imposta nome emittente e URL emittente Se il cluster CI è... Imposta issuerName e issuerURL su... NOI-A
UE
NOI-B
Se non conosci il tuo cluster CI, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.Tabella 2. Imposta tokenInfoURL Se il cluster di Teams è... Imposta tokenInfoURL su...(URL proxy IdP) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AFRA
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
DOLORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.
Per il test, è possibile verificare che il tokenInfoURL sia valido sostituendo "
idp/authenticate
" parte dell'URL con "ping
".
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user
Configurare i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get
set flsUrl https://cifls.webex.com/federation
set refreshPeriodInMinutes 60
set refreshToken refresh-Token-From-Step1
Eseguire il seguente comando per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get
Configurare la gestione dei token utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
set tokenIssuer BroadWorks
set tokenDurationInHours 720
Genera e condividi chiavi RSA. È necessario generare chiavi su un XSP|ADP, quindi copiarle su tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP.Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web. Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token. Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Rimozione dei requisiti di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con la convalida del token CI su R24, è necessario rimuovere anche il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get

Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Interfaccia CTI e configurazione correlata

Di seguito viene elencato l'ordine di configurazione "da più a più". In seguito a questo ordine non è obbligatorio.
Configurazione del server di applicazione per gli abbonamenti CTI
Configurazione di XSP|ADPs per abbonamenti CTI autenticati mTLS
Apertura delle porte in entrata per l'interfaccia CTI protetta
Abbonamento dell'organizzazione Webex agli eventi CTI di BroadWorks
Configurazione del server di applicazione per gli abbonamenti CTI
Aggiornare ClientIdentity su Application Server con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ciascun server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è |
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocol> |
Una specifica interfaccia CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocol> |
Su una nuova installazione, le seguenti crittografie sono installate per impostazione predefinita a livello di sistema. Se non è configurato nulla a livello di interfaccia (ad esempio, nell'interfaccia CTI o HTTP), si applica questo elenco di crittografia. Si noti che questo elenco può cambiare nel tempo:
|
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp>
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
Inserisci il
get
comando per visualizzare le crittografie già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, si utilizzerebbe:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Ancoraggi affidabili per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che le ADP XSP|siano rivolte verso Internet o rivolte verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy bridge (vedere Requisiti del certificato TLS per proxy bridge TLS).
Per ogni amministratore XSP|nell'infrastruttura che pubblica eventi CTI in Webex, effettuare le seguenti operazioni:
Accedere a Hub partner .
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.
Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
(Opzionale) Esecuzione
help updateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot2023
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
Consenti ai client di autenticarsi con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione BroadWorks in uso. Il comando crea un certificato server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. È necessario l'indirizzo IP dell'interfaccia CTI per questo; è possibile leggerlo dal seguente contesto:
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>
Riavviare XSP|ADP.
Abilitazione dell'accesso a BroadWorks CTI Events su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
Specificare l'indirizzo CTI in base al quale Webex può iscriversi a CTI Events di BroadWorks.
Gli abbonamenti CTI sono su base per abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato viene predisposto per Webex per Cisco BroadWorks.
Visualizzazione Webview Impostazioni chiamata
Call Settings Webview (CSWV) è un'applicazione ospitata su XSP|ADP per consentire agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview per le impostazioni di chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono native dell'app Webex.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, è necessario distribuire la funzione Webview impostazioni chiamata.
La vista Webview impostazioni chiamata presenta due componenti:
Applicazione Webview Impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
App Webex, che esegue il rendering delle impostazioni di chiamata in una vista Webview.
Esperienza utente
Utenti Windows: Fai clic su Impostazioni chiamata, quindi su .
Utenti Mac: Fare clic sull'immagine del profilo, quindi
.
Distribuzione di CSWV su BroadWorks
Installazione di Webview impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso ADP|XSP che ospita l'interfaccia Xsi-Actions nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
Accedere a cisco.com e cercare "BWCallSettingsWeb" nella sezione download software.
Trovare e scaricare la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) è stata la più recente al momento della stesura del presente documento.Installare, attivare e distribuire l'archivio Web in base alla Guida alla configurazione della piattaforma di servizi Xtended di Cisco BroadWorks per la versione XSP|ADP. (Versione R24 https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
.Passare al seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più necessario).Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario fornire anche un contextPath perché è un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio
/callsettings
.Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
Ora è possibile prevedere l'URL delle impostazioni di chiamata che si specificherà per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
L'|ADP-FQDN XSP deve corrispondere al FQDN azioni Xsi, perché CSWV deve utilizzare le azioni Xsi e CORS non è supportato.
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview Impostazioni chiamata è ora attiva sugli ADP|XSP.
Configura l'app Webex per utilizzare Webview impostazioni chiamata
Per ulteriori dettagli sulla configurazione del client, vedere la Guida alla configurazione di Webex per Cisco BroadWorks.
Nel file di configurazione dell'app Webex è presente un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti attraverso l'interfaccia dell'applicazione.
<config>
<services>
<web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%">
<url>%WEB_CALL_SETTINGS_URL_WXT%</url>
</web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel %WEB_CALL_SETTINGS_URL_WXT% tag.
Se non si specifica esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
Imposta la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
Il file di configurazione client risultante dovrebbe avere una voce come segue:
<web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push delle chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Call Notifications Push Server (CNPS) per descrivere un'applicazione ospitata XSP o ospitata ADP che viene eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti e invia le notifiche a Google Firebase Cloud Messaging (FCM) o Apple Push Notification Service (APN).
Tali servizi notificano ai dispositivi mobili degli abbonati Webex per Cisco BroadWorks la presenza di chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzione Notification Push Server.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi a loro volta notificano agli utenti mobili Webex le modifiche ai messaggi in arrivo o alla presenza.
In questa sezione viene descritto come configurare l'NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se è necessario eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPShttps://help.webex.com/nl5rir2/. |
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario aggiornare il CNPS per supportare la funzione proxy NPS, server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server di notifica push per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e i tasti di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend di Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APN Apple e i servizi FCM Google.
La funzione migliora anche la capacità del server push delle notifiche di eseguire notifiche push ai dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
Per ulteriori informazioni, vedere Server push per VoIP nella descrizione della funzione UCaaS.
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software e le patch NPS, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Cercare e scaricare la patch dalla pagina di download del software.
Ulteriori informazioni sul server ADP sono disponibili su https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio Apple Push Notification dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per APN. Questo aggiornamento richiede che XSP|ADP che ospita l'NPS esegua R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 | Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma di consegna dell'applicazione (ADP). | ||
2 | Installare le patch proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: | ||
3 | Attivare l'applicazione Notification Push Server. | ||
4 | (Per le notifiche Android) Abilitare l'API FCM v1 sull'NPS.
| ||
5 | (Per le notifiche Apple iOS) Abilitare HTTP/2 su NPS.
| ||
6 | Collegare un supporto tecnico dell'NPS XSP/ADP. | ||
7 | Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN UN 10.193.78.149
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configura NPS per utilizzare il proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Migra NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un server NPS condiviso con altre app mobili, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPS ( https://help.webex.com/nl5rir2).
1 | Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 | Creare l'account cliente su NPS:
Per verificare che i valori inseriti corrispondano a quanto ricevuto, eseguire
| |||||||||||||||||||
3 | Immettere l'URL proxy NPS e impostare l'intervallo di aggiornamento del token (consigliato 30 minuti):
| |||||||||||||||||||
4 | (Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 | (Per le notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, assicurandosi di omettere il tasto Auth – impostarlo su vuoto.
| |||||||||||||||||||
6 | Configurare i seguenti URL NPS:
| |||||||||||||||||||
7 | Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 | Verificare se il server applicazioni sta eseguendo lo screening degli ID applicazione, poiché potrebbe essere necessario aggiungere le app Webex all'elenco utenti autorizzati: | |||||||||||||||||||
9 | Riavviare XSP|ADP: | |||||||||||||||||||
10 | Esegui test delle notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migrazione di NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente che è necessario eseguire la migrazione a FCMv1. Sono previste tre procedure:
Esegui migrazione dei client UC-One a FCMv1: quando disponi di client UCaaS esistenti e devi migrarli per utilizzare FCMv1.
Migrazione dei client SaaS a FCMv1: quando si dispone di client SaaS esistenti e occorre migrarli per utilizzare FCMv1.
Aggiorna server ADP: quando si esegue la migrazione di NPS a un server ADP.
Migrazione dei client UC-One a FCMv1
Utilizzare la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere . L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile Connect su https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al
|
Accedere a SDK amministratore FCM su http://console.firebase.google.com.
Selezionare l'applicazione Android appropriata.
Nella scheda General (Generale), registrare l’ID del progetto
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
Fare clic sul pulsante blu per creare un nuovo account di servizio
Fai clic sul pulsante blu per generare una nuova chiave privata
Chiave di download per una posizione sicura
Per riutilizzare un account servizio esistente:
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
Identificare l'account servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
Copiare il file json su XSP|ADP.
Configurare l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== my_project ********
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Migrazione dei clienti SaaS a FCMv1
Se si desidera eseguire la migrazione dei client SaaS a FCMv1, attenersi alla procedura seguente su Google FCM Console.
Assicurarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione". |
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Aggiorna server ADP
Se si esegue la migrazione dell'NPS per utilizzare un server ADP, utilizzare i passaggi seguenti nella console Google FCM.
Ottenere il file JSON dalla console cloud di Google:
Su Google Cloud Console, andare alla pagina Account servizio.
Fare clic su Seleziona un progetto, scegliere il progetto e fare clic su Apri.
Trova la riga dell'account servizio per la quale desideri creare una chiave, fai clic sul pulsante Altro verticale, quindi fai clic su Crea chiave.
Selezionare un tipo di chiave e fare clic su Crea
Il file viene scaricato.
Aggiungere FCM al server ADP:
Importare il file JSON nel server ADP utilizzando il
/bw/install
comando.Accedere all'ADP CLI e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON
:Quindi, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò avviene per i seguenti motivi:
Per consentire a Webex cloud di autenticare i tuoi utenti rispetto a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
Per consentire alle app Webex di utilizzare l'interfaccia Xsi per il controllo delle chiamate.
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se alcune interfacce non vengono convalidate correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide. Ciò viene impedito poiché un cluster configurato in modo errato potrebbe causare problemi che sono difficili da risolvere. |
Cosa è necessario fare:
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
Assegna un nome al cluster e fai clic su Avanti.
Il concetto di cluster qui è semplicemente una raccolta di interfacce, solitamente situate su un server ADP XSP| o in un'azienda agricola, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il sistema BroadWorks non sono applicabili qui.
(Opzionale) Immettere un Nome account utente e una Password BroadWorks noti all'interno del sistema BroadWorks che si connette a Webex, quindi fare clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
Aggiungere gli URL XSI Actions e XSI Events.
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
Opzionale. Selezionare la casella di controllo Abilita autenticazione diretta BroadWorks se si desidera che gli accessi a BroadWorks siano diretti a BroadWorks. In caso contrario, l'autenticazione per BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo influisce su queste situazioni di accesso:
Accesso al portale di attivazione utente: gli utenti devono immettere le credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o attraverso il proxy IdP.
Accesso client: se l'autenticazione BroadWorks è configurata nel modello di onboarding, l'impostazione precedente determina se l'accesso del client all'app Webex è diretto a BroadWorks o viene proxy attraverso il proxy IdP.
Fai clic su Avanti.
Nella pagina CTI Interface (Interfaccia CTI) procedere come segue:
Aggiungere l'URL CTI e la porta per l'interfaccia CTI a cui si desidera connettersi.
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
Opzionale. Abilita il tasto di alternanza Non disturbare (NoDist) e inserisci l'ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurandosi che la funzione funzioni allo stesso modo su entrambe le piattaforme.
Fai clic su Avanti.
Aggiungere l'URL del servizio di autenticazione.
Selezionare Servizio autenticazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex poiché il servizio di autenticazione convalida correttamente il token utente rispetto al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
Controllare le voci sulla schermata finale, quindi fare clic su Crea. Dovrebbe essere visualizzato un messaggio di successo.
Partner Hub passa gli URL a vari microservizi Webex che testano le connessioni alle interfacce fornite.
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è riuscita.
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Abbiamo implementato questa verifica per prevenire errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, caricatore di bilanciamento o firewall) come illustrato in questa guida, prima di salvare il modello.
Verifica delle connessioni alle interfacce BroadWorks
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Visualizza cluster.
Partner Hub avvia i test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina dell'elenco dei cluster mostra il messaggio di stato accanto a ciascun cluster.
I messaggi verdi relativi al successo dovrebbero essere visualizzati. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio XSI-Actions, XSI-Events, DAS URL e le impostazioni dell'interfaccia CTI.
Configurazione dei modelli di onboarding
I modelli di onboarding sono il modo in cui verrà applicata la configurazione condivisa a uno o più clienti man mano che vengono caricati tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma solo un modello può essere associato a un cliente.
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Aggiungi modello.
In questo modo viene avviata una procedura guidata in cui è possibile fornire la configurazione per i clienti che utilizzeranno questo modello.
Utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
Immettere un Nome modello, quindi fare clic su Avanti.
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per diverse modalità di provisioning Nome impostazione
Provisioning fluviale con e-mail attendibili
Provisioning flowthrough senza e-mail
Self-provisioning utente
Abilita flusso BroadWorks attraverso il provisioning (include le credenziali dell'account di provisioning se attivato**)
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il †
Il †
Il †
Indirizzo e-mail provider servizi
Selezionare un indirizzo e-mail dall'elenco a discesa (è possibile digitare alcuni caratteri per trovare l'indirizzo, se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello di onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature tra paese e regione in questo foglio di calcolo.
Il paese dell'organizzazione determina i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni consultare la sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questo interruttore spento.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note dalla tabella:
† Questo passaggio garantisce che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa opzione deve essere sempre attiva, a meno che non si utilizzi un processo manuale di ordinazione ed esecuzione (tramite Cisco Commerce Workspace) per creare le organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello di "provisioning ibrido" e non rientra nel campo di applicazione di questo documento.
** "Account di provisioning" si riferisce all'account di amministrazione a livello di sistema BroadWorks. Su BroadWorks, è necessario un account amministratore con questi attributi: Tipo amministratore=Provisioning, sola lettura=Disattivato.
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
Opzionale. Selezionare Disabilita chiamata gratuita Cisco Webex se si desidera disabilitare le chiamate Webex.
Per la configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
Numeri di chiamata in ingresso Cisco (PSTN)
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
Fai clic su Avanti.
Esistono due approcci per il provisioning degli abbonati relativamente a come vengono verificate le relative identità, utilizzando e-mail attendibili o e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile, gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. In qualità di partner, sei responsabile del provisioning dell'indirizzo e-mail come parte del metodo flow-through o API.
Si consiglia vivamente di utilizzare il metodo di provisioning attendibile poiché garantisce che tutti gli abbonati siano completamente predisposti dall'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso e-mail non attendibile, gli utenti devono verificare i relativi messaggi e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome impostazione
Provisioning flowthrough senza e-mail
Self-provisioning utente
Esegui prima provisioning amministratore
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
Note dalla tabella:
* Ciascuna organizzazione cliente in Webex deve disporre di almeno un utente con ruolo di amministratore. Il primo utente a cui assegnare IM&P integrato in BroadWorks assume il ruolo di amministratore del cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di fornitore di servizi è possibile avere il controllo su chi ottiene il ruolo. La verifica di questa impostazione impedisce agli utenti di completare l'attivazione fino a quando non viene attivato il primo utente fornito. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
Fai clic su Avanti.
Selezionare la modalità di autenticazione predefinita (autenticazione BroadWorks o autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.(Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
Fai clic su Avanti.
Per Preferenze, configurare quanto segue:
Scegliere se si desidera Precompilare gli indirizzi e-mail utente nella pagina di accesso.
Utilizzare questa opzione solo dopo aver selezionato Autenticazione BroadWorks e aver anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il nome utente BroadWorks. La pagina di accesso offre l'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
Se desideri abilitare la sincronizzazione delle rubriche, imposta l'opzione Abilita sincronizzazione rubrica telefonica per tutte le nuove organizzazioni clienti per attivare.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
Immettere un amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatico di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
Accertarsi che il tasto di alternanza Provisioning organizzazioni esistenti sia attivo (l'impostazione predefinita è attiva).
Fai clic su Avanti.
Esaminare le voci nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Dovrebbe essere visualizzato un messaggio di successo.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con altri modelli.
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario immettere nuovamente i dettagli dell'account di provisioning. I campi Password vuota/Conferma password sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori forniti alla procedura guidata.
Aggiungi altri modelli se disponi di diverse configurazioni condivise che desideri fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbe essere necessario specificare i dettagli del modello per una delle attività seguenti.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning. |
Patch Application Server (solo R22, R23 e R24)
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
Per R22:
AP.as.22.0.1123.ap373197
Per R23:
AP.as.23.0.1075.ap373197
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che costituiscono il requisito per la distribuzione di Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.Modifica della
Maintenance/ContainerOptions
contesto.Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true
Scarica gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interfaccia > Messaggistica e Servizio > IM&P integrato) dei comandi AS.
Accedi a Partner Hub e vai a
.Fare clic su Visualizza modelli.
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro flyout a destra. Se non è stato ancora creato un modello, è necessario farlo prima di poter ottenere l'URL di provisioning.
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per altri modelli se si dispone di più modelli.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema su server applicazioni
Se si utilizza UC-One SaaS, potrebbe non essere necessario impostare il provisioning e il dominio del servizio a livello di sistema. Vedere i Punti di decisione nella sezione Preparazione dell’ambiente. |
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password
AS_CLI/Interface/Messaging> set enableSynchronization true
Attivare l'interfaccia IMP integrata:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
È necessario inserire il nome completo per il |
(Opzione) Configurazione dei parametri di provisioning per azienda su server applicazioni
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
Selezionare Usa dominio di servizio e immettere un valore fittizio (Webex ignora questo parametro). È possibile utilizzare
example.com
).Selezionare Usa server di messaggistica.
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
È necessario inserire il nome completo per il
provisioningURL
parametro, come è stato dato in Partner Hub. Se il server applicazioni non può accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel/etc/hosts
file su AS.Nel campo Nome utente, immettere un nome per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Immettere una password per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Per Identità utente predefinita per ID IM&P, selezionare Principale.
Fare clic su Applica.
Ripeti per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning utente, vedi Provisioning utente provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning aiuta amministratori e team di vendita controllando la presenza di errori prima di eseguire il provisioning di un cliente o abbonato per un pacchetto. Gli utenti o le integrazioni autorizzati da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per assicurarsi che non vi siano conflitti o errori con il provisioning del pacchetto per un determinato cliente o abbonato.
L'API verifica se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto a un cliente o partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, è possibile correggere gli errori prima del provisioning, aumentando la probabilità di un provisioning riuscito.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore Webex per la vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare di un provisioning abbonato all'ingrosso
Per accedere a Precontrolla un documento di provisioning abbonato Wholesale, devi accedere al portale https://developer.webex.com/. |
Partner SSO - SAML
Consente agli amministratori dei partner di configurare l'SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La seguente procedura SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere la funzionalità SSO del partner a un'organizzazione cliente esistente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso. Per aggiungere SSO partner a un'organizzazione esistente, è necessario aprire un ticket con Cisco TAC. |
Verificare che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'integrazione Single Sign-On in Control Hub.
Aprire una richiesta di servizio con Cisco TAC. TAC deve stabilire una relazione di trust tra il provider di identità di terze parti e il servizio Cisco Common Identity. .
Se l'IdP richiedepassEmailInRequest
da abilitare, accertarsi di includere questo requisito nella richiesta di servizio. Controlla con il tuo IdP se non sei sicuro che questa funzione sia necessaria.Carica il file di metadati CI fornito da TAC al provider di identità.
Configurare un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, immettere l'ID entità dall'XML metadati SAML del provider di identità di terze parti.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
Proprio che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori dei partner di configurare l'SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per impostare SSO OIDC partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già caricate utilizzando il modello. Per aggiungere il Partner SSO a un'organizzazione di clienti esistente, è necessario aprire un ticket con Cisco TAC. |
Aprire una richiesta di servizio con il centro TAC di Cisco con i dettagli dell'IDP di connessione OpenID. Sono obbligatori e facoltativi gli attributi IDP. TAC deve impostare l'IDP sul CI e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC, potrebbe consistere in lettere, numeri, trattini, sottolineature, inclinazioni e punti e la lunghezza massima è 128 caratteri.
Id client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Segreto client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco degli ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio, ad esempio "profilo e-mail openid" Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non fornito
URL dell'endpoint di autorizzazione OAuth 2.0 dell'IdP.
endpoint token
Sì se discoveryEndpoint non fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
endpoint infoutente
No
URL dell'endpoint UserInfo di IdP.
Endpoint set di tasti
No
URL dell'endpoint JSON Web Key Set dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
Configurare l'URI di reindirizzamento sull'IDP di connessione OpenID.
Configurare un modello di onboarding. Per l'impostazione della modalità di autenticazione, selezionare Autenticazione partner Con OpenID Connect e immettere il nome IDP fornito durante l'impostazione IDP come ID entità IDP OpenID Connect.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui registrazione chiamata, risposta per assente di gruppo, dirigente e assistente di direzione.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
Eseguire i seguenti comandi sulle interfacce AS. Ciò consentirà all’AS di inviare il c.d.
X-BroadWorks-Correlation-Info
Intestazione SIP:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true
Il
enableCallCorrelationID
Il parametro associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione delle informazioni di correlazione delle chiamate nei registri Xsi-Actions. Si raccomanda di avereenableCallCorrelationID
abilitato utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione dell'identificativo di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione della rubrica garantisce che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la directory di chiamata completa dal server BroadWorks viene sincronizzata con la directory Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione rubriche, vai a Sincronizzazione rubriche in Webex per Cisco BroadWorks.
Webex per Cisco BroadWorks flowthrough provisioning aggiunge utenti di messaggistica e informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, gli elenchi telefonici, gli utenti non di messaggistica e le entità non utenti non sono inclusi (ad esempio, un telefono della sala conferenze, un fax o un numero di gruppo di risposta). L'attivazione della sincronizzazione delle rubriche garantisce che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex. |
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia chiamate e riunioni unificate Webex visualizzata sull'app Webex. Gli utenti possono visualizzare la cronologia dettagliata delle chiamate e della riunione dall'app Webex.
La cronologia chiamate unificata può essere abilitata dagli amministratori a livello di partner in Partner Hub su base cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
Eventi cronologia chiamate: questi eventi vengono utilizzati per creare una cronologia chiamate unificata dettagliata
Eventi di stato hook: la cronologia chiamate unificata include ottimizzazioni dello stato hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di Telephony Presence
Requisiti della cronologia chiamate unificata
Prima di configurare la cronologia chiamate unificata, accertarsi di aver eseguito la patch del sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
AP.as.22.0.1123.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per R23:
AP.as.23.0.1075.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Se si utilizza XSP—
AP.xsp.23.0.1075.ap378585
In caso di utilizzo di ADP
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
AP.as.24.0.944.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per l'elenco completo delle patch BroadWorks che è necessario installare come prerequisito per l'esecuzione di Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella sezione Riferimento. |
Oltre alla patch del sistema, il file di configurazione del client ( config-wxt.xml
) deve avere il seguente set di tag: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altro reindirizzamento nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
AP.as.23.0.1075.ap383346
AP.as.23.0.1075.ap383994
Per R24:
AP.as.24.0.944.ap383346
AP.as.24.0.944.ap383994
Per avere informazioni Dirigente-Assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
AP.as.24.0.944.ap380052
AP.as.24.0.944.ap384239
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare anche la sincronizzazione delle rubriche per la cronologia chiamate unificata dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione NoDist, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti nel cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione di Broadworks durante la stessa finestra di manutenzione. |
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configura organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettuare le seguenti operazioni:
Accedi a Partner Hub su
admin.webex.com
.Andare a Impostazioni e selezionare un cluster esistente.
Verificare che la connessione al cluster sia buona. Nel pannello a destra viene visualizzato un segno di spunta verde con Connection stabilita.
Se questa opzione non viene visualizzata, in Check Connnections (Opzionale), immettere BroadWorks User Id e BroadWorks Password e fare clic su Check per verificare che la connessione sia corretta.
Selezionare la casella di controllo Abilita cronologia chiamate.
Fai clic su Salva.
Interazioni funzione
Per la cronologia chiamate unificata sono presenti le seguenti interazioni delle funzioni:
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando questa situazione esiste, gli eventi Cronologia chiamate e Stato hook non vengono inviati all'app Webex.
La cronologia chiamate unificate non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia chiamate unificata dall'app Webex. Per informazioni dettagliate, vedere: Webex | visualizza cronologia chiamate e riunioni.
Disabilita cronologia chiamate unificata
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenta di identificare il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra di chiamata e una volta completata la chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante abbinando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se trova più istanze di un numero in un'origine, non tenterà di sceglierne una, in questo caso, non visualizzerà alcun ID chiamante. |
Webex Common Identity (CI) che contiene gli utenti della tua organizzazione.
Contatti personali e aziendali. I contatti personali sono visibili nella scheda Contatti.
Rubrica locale. In Windows - applicazione Outlook, in Mac - Contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non viene trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, utilizzerà la parte del nome utente dell'URI SIP dall'intestazione SIP From come ultima risorsa.
Per il controllo delle chiamate remote (ad esempio, modalità di controllo del telefono fisso) vengono utilizzate informazioni XSI, dove viene utilizzato ID BWKS o interno, estratte da informazioni di parte remota nell'evento XSI. Se l'informazione della parte remota non è disponibile, verrà utilizzata P-Asserted Identity (PAI) (se configurata).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica di chiamata e nella cronologia chiamate.
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
Coda Call Center: Visualizza il nome della coda che ha inoltrato la chiamata.
Dirigente-Assistente: Mostra il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
Per le chiamate nella coda chiamate interna, in cui un agente richiama una parte interna, la parte remota non visualizzerà il nome della coda chiamata, ma il nome dell'agente che le chiama.
Chiamata con risposta altrove:
Per gruppi di risposta o code chiamate impostate con indirizzamento simultaneo, gli agenti visualizzeranno una chiamata che ha ricevuto risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di risposta o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate perse nella cronologia chiamate se risposte da un altro agente.
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni da tavolo. Questa funzione specifica consente di assegnare gli indicatori di linea condivisa all'app Webex dell'utente finale.
Questa funzione consente agli utenti di gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente alle linee condivise.
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise dal client Webex
R23 senza ADP:
AP.as.23.0.1075.ap384179
AP.xsp.23.0.1075.ap384179
R23 con ADP:
AP.as.23.0.1075.ap384179
Xsi-Actions-23_2022.10
R24:
IN QUANTO: AP.as.24.0.944.ap384179
Xsi-Actions-24_2022.10
R25:
IN QUANTO: Versione RI Rel_2022.10_1.310
Xsi-Actions-25_2022.10
Cerotto 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo (in questo caso per il client desktop: Business Communicator).
Versione RI Rel_2022.10_1.310
Sincronizzazione Non disturbare (NoDist).
La sincronizzazione Non disturbare (NoDist) allinea le impostazioni NoDist tra Webex e BroadWorks sincronizzando lo stato NoDist tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato si sincronizza con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. Analogamente, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist da una piattaforma non vengono riconosciuti dall'altra piattaforma.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Prerequisiti
Assicurarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione BroadWorks.
Per la versione 22:
Cerotto AS: AP.as.22.0.1123.ap382615, AP.as.22.0.1123.ap382838
Patch XSP|ADP: AP.xsp.22.0.1123.ap382615, AP.xsp.22.0.1123.ap382838
Per la versione 23:
Cerotto AS: AP.as.23.0.1075.ap382615, AP.as.23.0.1075.ap382838
Patch XSP|ADP: AP.xsp.23.0.1075.ap382615, AP.xsp.23.0.1075.ap382838
App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
Cerotto AS: AP.as.24.0.944.ap382615, AP.as.24.0.944.ap382838
App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 su AS:
AS_CLI/System/ActivatableFeature> activate 25433
Configura sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto di eventi "as-feature-event". Per informazioni dettagliate, vedere Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
Accedi a Partner Hub
Fare clic su Impostazioni.
Fare clic su Visualizza cluster e selezionare il cluster BroadWorks appropriato.
Abilita il tasto di alternanza Non disturbare (NoDist).
Inserire l'ID utente BroadWorks e fare clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione NoDist. Se la convalida non riesce, il pulsante Salva viene disabilitato.
Se la convalida ha esito positivo, fare clic su Salva.
|
Abilita sincronizzazione NoDist (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per ulteriori dettagli, vedere "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Disabilita sincronizzazione NoDist
Non puoi disabilitare la sincronizzazione NoDist da solo. Per disabilitare la funzione, crea un caso BEMS di ingegneria con le seguenti informazioni:
Famiglia: Servizio Spark
Prodotto: Chiamata in Webex (Webex per BroadWorks)
Componente: Provisioning WxBW
Il caso BEMS deve indicare che la sincronizzazione non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterIdBroadWorks.
Casi d'uso

Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione delle chiamate.
Modalità di registrazione | Descrizione | Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta | La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente | La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Per R22: AP.as.22.0.1123.ap377718
Per R23: AP.as.23.0.1075.ap377718
Per R24: AP.as.24.0.944.ap377718
L'identificativo di correlazione chiamata deve essere attivato. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione delle chiamate Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, andare a help.webex.com
articolo Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla piattaforma di registrazione chiamate di terze parti.
Gruppo Parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione di parcheggio e recupero delle chiamate di gruppo. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti al dettaglio in un'impostazione di negozio possono utilizzare la funzione per parcheggiare una chiamata che può essere raccolta da qualcuno in un altro reparto.
Funzionamento funzione
Una volta configurata la funzione
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nell'app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nell'app Webex. L'utente quindi inserisce l'estensione della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per attivare questa funzione, verificare quanto segue:
Il file di configurazione client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
L'identificativo di correlazione chiamata deve essere abilitato su AS e XSP|ADP. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Il tuo SBC deve essere configurato per passare il ‘
x-broadworks-correlation-in
' Attributo SIP a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiungi gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo del server applicazioni Cisco BroadWorks - Parte 2. È necessario creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Parcheggio Webex | e Recupera chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzato
Il parcheggio chiamate regolare o indirizzato non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso funzione:
Immettere *68 per parcheggiare una chiamata
Immettere *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato negli ambienti del call center o in altre situazioni in cui può essere necessaria un'assistenza o un intervento immediati.
Quando un servizio di inclusione è abilitato, un utente o supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di tasti o pulsanti dedicati sul proprio telefono o dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o di partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in vari scenari. In un ambiente di call center, supervisori o formatori possono monitorare e assistere i rappresentanti del servizio clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire assistenza o prendere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può partecipare rapidamente a conversazioni in corso per fornire assistenza o prendere decisioni importanti.

Nell'app Webex per l'inclusione, viene inviata una notifica che la chiamata viene trasformata in una conferenza. In NOTIFY (informazioni sulla chiamata o conferenza) non sono disponibili ulteriori informazioni sul tipo di conferenza, pertanto è possibile trattarla in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Vengono introdotti i seguenti termini:
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore solitamente ha la possibilità di monitorare e intervenire nelle chiamate in corso dei clienti. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire assistenza agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può comprendere la formazione degli agenti, la gestione dei problemi dei clienti e l'ottimizzazione delle prestazioni del team.
Cliente: Per cliente si intende una persona fisica o giuridica che interagisce con un'azienda o un'organizzazione per ottenere prodotti, servizi o assistenza. Nel contesto dell'inclusione delle chiamate, un cliente è qualcuno che sta effettuando o ricevendo una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risolvere le loro richieste o problemi durante la chiamata. La funzione di inclusione chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
Agente: Un agente, anche noto come rappresentante del servizio clienti o agente del call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza telefonica o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare operazioni e offrire un'esperienza positiva al cliente. Nel contesto dell'inclusione delle chiamate, un agente è la persona che parla direttamente al cliente durante la telefonata. L'agente può ricevere indicazioni o feedback dal supervisore attraverso l'inclusione della chiamata, se necessario.
La chiamata nativa mobile viene inoltrata alla riunione
La funzione di escalation della chiamata nativa mobile alla riunione è dotata di due funzioni uniche:
Nuova notifica push
Gli utenti mobili su una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando si avvia una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si accede direttamente alla schermata in chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata utilizzando il controllo chiamate Cisco per le chiamate su cellulare, viene visualizzata la notifica Webex durante una chiamata su cellulare.
Trasferisci chiamata mobile a riunione
Quando sei nel mezzo di una chiamata con qualcuno, potresti voler trasferire la chiamata in una riunione per utilizzare alcune funzioni di riunione avanzate come video, condivisione o lavagna. In alternativa, invitare altre persone alla discussione e passare a una riunione.
Requisiti BroadWorks
Funzione attivabile 25239
R23 con XSP|ADP:
AS Patch AP.as.23.0.1075.ap383064
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
Patch AP.platform.23.0.1075.ap383064
R23 con ADP:
AS Patch AP.as.23.0.1075.ap383064
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R24:
Cerotto AS: AP.as.24.0.944.ap383064
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R25:
AS RI release Rel_2022.08_1.354
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e NPS versione > 2022.08_1.350
Configurazione chiamata URI per supportare lo spostamento della chiamata alla riunione
Criteri di chiamata Url NS
Definisci la regola per (.*)webex.com da indirizzare attraverso I-SBC
NS_CLI/Policy/UrlDialing> get WebexMeetings
Policy: UrlDialing Instance: Webex
unknownSipURIHandling = reject
disableSubscriberLookups = true
Enable = true
CallTypes:
Selection = {ALL}
From = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP}
lineportOnly = false
enableSipURIMatchingRules = true
NS_CLI/Policy/UrlDialing/Rules> get WebexMeetings
Policy: UrlDialing Instance: WebexCalling Table: Rules
id pattern routingNE cost weight dtg
===================================================================
1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE di indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> get ne WebexMeetings
Network Element WebexMeetings
Location = 1281465
Data Center =
Static Cost = 1
Static Weight = 99
Poll = false
OpState = enabled
State = OnLine
Profile = NIL_PROFILE
Remote Lookup Enabled = false
Signaling Attributes =
NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings
Routing NE Address Cost Weight Port Transport Route
=====================================================================
WebexMeetings sbc-address 1 99 - unspecified
Profilo di indirizzamento NS
Aggiunta dell'istanza della policy UrlDialing ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> get profile MyInst
Profile: Webex
Policy Instance
==========================================
…
UrlDialing WebexMeetings
AS Usa indirizzamento NS per chiamata NetworkURL
Consente all'AS di rispettare il percorso NS in modalità ibrida AS
AS_CLI/Interface/IMS> set queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un PSAP (Public Safety Answering Point), che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, è necessario integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Usa i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
Chiamata di emergenza E911 in Webex per BroadWorks: utilizzare questo articolo per configurare la chiamata di emergenza E911 in Webex per Cisco BroadWorks utilizzando uno dei seguenti provider E911 supportati:
Banda
Intrado
RedSky
Esclusione di responsabilità per chiamate di emergenza: se disponi di un servizio di posizione, puoi configurare la finestra Esclusione di responsabilità per i servizi di emergenza sull'app Webex in modo da includere un'opzione per gli utenti per aggiornare la propria posizione quando eseguono l'accesso.
Personalizzazione e provisioning dei clienti
Gli utenti scaricano e installano le relative app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedere Piattaforme app Webex). Una volta eseguita l'autenticazione dell'utente, il client si registra sul cloud Webex per messaggistica e riunioni, recupera le informazioni sul branding, scopre le informazioni del servizio BroadWorks e scarica la configurazione delle chiamate dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
Configurare i parametri di chiamata per le app Webex in BroadWorks (come di consueto). Configura i parametri di branding, messaggistica e riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Prepara il tuo ambiente).
Verificare di disporre dei set di tag corretti in BroadWorks System > Resources > Device Management Tag Sets.
Per ciascun client che si sta eseguendo il provisioning:
Scaricare ed estrarre il file zip DTAF per il client specifico.
Importare i file DTAF in BroadWorks all'indirizzo System > Resources > Identity/Device Profile Types
Apri il profilo dispositivo appena aggiunto per la modifica e:
Immettere il nome di dominio completo dell'azienda agricola XSP|ADP e il protocollo di accesso del dispositivo.
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per il funzionamento della condivisione desktop.
È inoltre possibile abilitare il supporto Parte remota eseguendo il seguente comando CLI sul server applicazioni:AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
Salvare il file.
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome | Descrizione |
Priorità codec | Configurazione dell'ordine di priorità per i codec audio e video per le chiamate VoIP |
TCP, UDP e TLS | Configurare i protocolli utilizzati per la segnalazione e il contenuto multimediale SIP |
Porte audio e video RTP | Configurazione degli intervalli di porte per audio e video RTP |
Opzioni SIP | Configurare diverse opzioni relative a SIP (SIP INFO, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti gestiti dal partner. Vedere Configurazione di personalizzazioni di branding avanzate.
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client. |
Personalizzazione dei report dei problemi e degli URL della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito Feedback e Guida", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con Flowthrough Provisioning
Prima di poter eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 | Assegna servizio in BroadWorks: |
2 | Verifica dell'organizzazione cliente e degli utenti in Control Hub: |
Test utente
1 | Scaricare l'app Webex su due diverse macchine. |
2 | Eseguire l'accesso come utenti di test sulle due macchine. |
3 | Effettuare chiamate di prova. |
Provisioning delle organizzazioni dei clienti
Nel modello corrente, eseguiamo automaticamente il provisioning dell'organizzazione del cliente quando si esegue l'onboarding del primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguito una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
Usa API per creare account Webex
Assegna il provisioning integrato IM&P (flowthrough provisioning) con e-mail attendibili per creare account Webex
Assegna provisioning integrato IM&P (flowthrough) senza e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per creare account Webex
Consenti agli utenti di autoattivarsi (invia loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex espone le API pubbliche per consentire ai provider di servizi di integrare il provisioning degli abbonati Webex per Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. Le specifiche per queste API sono disponibili su developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti wholesale verranno rifiutati da queste API. |
Provisioning del flusso
Su BroadWorks, è possibile eseguire il provisioning degli utenti con l'opzione Abilita IM&P integrato. Questa azione provoca l'adattatore di provisioning BroadWorks per effettuare una chiamata API per il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica del codice, ma solo una modifica della configurazione dell'endpoint API per l'adattatore di provisioning.
Il provisioning degli abbonati su Webex può richiedere molti minuti (diversi minuti per l'utente iniziale all'interno di un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il successo del provisioning flowthrough indica che il provisioning è stato avviato. Non indica il completamento. Per confermare che il provisioning di utenti e organizzazione cliente sia completo su Webex, devi accedere a Partner Hub e guardare nell'elenco dei clienti. Gli utenti di trunking BroadWorks possono disporre di Webex per BroadWorks tramite un identificativo di chiamata condiviso (SCA). L'utente che esegue il trunking dovrà disporre del servizio di autenticazione assegnato. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto Webex SCA dall'autenticazione del trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con le funzioni di elenco di indirizzamento o indirizzamento diretto assegnate. |
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata Modello di onboarding. |
Autoattivazione utente
Per eseguire il provisioning degli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
Accedere a Partner Hub e trovare la pagina Elenco clienti.
Fare clic su Visualizza modelli.
Seleziona il modello di onboarding di provisioning che desideri applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non si trova nel sistema BroadWorks associato a questo modello, non può attivarsi automaticamente con il collegamento.
Copiare il collegamento di provisioning e inviarlo all'utente.
È anche possibile includere il collegamento per il download del software e ricordare all'utente di cui ha bisogno di fornire e convalidare il proprio indirizzo e-mail per attivare l'account Webex.
È possibile monitorare lo stato di attivazione dell'utente nel modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi di attivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli all'interno della vista Stato utente che consentono agli amministratori dei provider di servizi Webex per Cisco BroadWorks di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Sposta gli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) |
|
Organizzazione cliente | Collega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge Webex per BroadWorks anche agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) | Se l'organizzazione Webex per BroadWorks non esiste (nessun utente predisposto):
Se esiste un'organizzazione Webex per BroadWorks (viene predisposto almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di autoiscrizione (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (con il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
Sposta utente (con e-mail attendibili): utilizza il provisioning con e-mail attendibili
Sposta utente (con e-mail non attendibili): utilizza il provisioning con e-mail non attendibili
Autoattivazione
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza messaggi e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
L'amministratore aggiunge l'utente.
L'utente viene spinto sul bridge di provisioning BroadWorks.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L’utente apre il messaggio e-mail e fa clic su Attiva account. L'utente viene reindirizzato al portale consumer Webex.
L'utente accede a Webex.
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza messaggi e-mail non attendibili, è necessario prima convalidare l’indirizzo e-mail dell’utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
L'amministratore aggiunge l'utente.
L'utente viene inviato automaticamente al bridge di provisioning BroadWorks.
All'utente viene inviato un testo con un collegamento di attivazione.
L'utente fa clic sul collegamento Attivazione e inserisce l'indirizzo e-mail.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L'utente apre il messaggio e-mail e fa clic su Accedi ora.
L'indirizzo e-mail viene convalidato.
L'utente viene reindirizzato all'accesso al portale consumer Webex.
L'utente accede a Webex.
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Flusso di autoattivazione
Se l'utente dispone di un account BroadWorks esistente, può utilizzare il processo di autoattivazione per spostare l'account.
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
L'utente inserisce il proprio indirizzo e-mail.
L'utente viene inviato al bridge di provisioning BroadWorks.
Viene inviata un'e-mail automatica all'indirizzo e-mail dell'utente.
L'utente apre il messaggio e-mail e fa clic sul collegamento Accedi ora, che convalida l'indirizzo e-mail.
CI rileva che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di poter continuare.
L'utente viene reindirizzato all'accesso a Webex.
L'utente accede al portale consumer.
L'utente fa clic su Elimina account.
L'account Webex precedente viene eliminato.
All'utente è stato predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
Collegamento di Webex per BroadWorks all'organizzazione esistente
Se sei un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, che non è ancora associata a un'azienda BroadWorks gestita da un partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso amministratore per la richiesta di provisioning riuscita.
È necessaria l'approvazione dell'amministratore dell'organizzazione se una delle seguenti affermazioni è vera:
L'organizzazione cliente esistente dispone di 100 utenti o più
L'organizzazione dispone di un dominio e-mail verificato
Dominio organizzazione richiesto
Se nessuno dei criteri di cui sopra è vero, può verificarsi un Attacco automatico.
In uno scenario di allegato automatico, un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner verranno concessi diritti di amministrazione provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà eseguito un amministratore completo. Con l'accesso amministratore di provisioning, la visibilità in Control Hub sarà limitata agli utenti nell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione. |
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
In Partner Hub, il tasto di alternanza Provisioning organizzazioni esistenti deve essere abilitato all'interno delle impostazioni del modello di onboarding di tale organizzazione (il tasto di alternanza è attivo per impostazione predefinita). |
1 | L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedere Provisioning delle organizzazioni dei clienti. Si verifica quanto segue:
| ||
2 | Con l'accesso amministratore completo, l'amministratore del partner può completare il processo di provisioning del cliente. Dovrai provare a eseguire nuovamente il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora come amministratore completo esterno, non si dovrebbe osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione cliente esistente sarà visibile come cliente sotto Webex per l'organizzazione partner BroadWorks.
|
Condizioni dell'allegato organizzazione
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione del cliente target. In caso contrario, verrà creata una nuova organizzazione cliente.
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato sul modello di provisioning Webex per BroadWorks. Di conseguenza, non vi sono modifiche alla modalità di accesso degli utenti esistenti.
Tuttavia, se l'organizzazione cliente esistente dispone di branding di base abilitato, una volta eseguito il collegamento, le impostazioni di branding avanzate del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
Il nome dell'organizzazione esistente non cambierà.
Non è stata apportata alcuna modifica all'impostazione del flag di soppressione e-mail nelle impostazioni dell'organizzazione esistente. Ciò può avere effetto sui nuovi utenti predisposti. A seconda di come è impostato il flag, i nuovi utenti possono o meno ricevere un'e-mail con un codice che deve essere immesso per completare l'attivazione.
La modalità di amministrazione con restrizioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
Accertarsi di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
Un'azienda BroadWorks può essere associata solo a una organziazione Webex. Non è possibile eseguire il provisioning degli abbonati da una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com
.
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo. |
L'indirizzo e-mail aggiunto dall'amministratore dell'organizzazione cliente come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore partner come configurato nel modello di onboarding su Partner Hub. Dopo aver aggiunto l'e-mail dal modello di onboarding in Partner Hub come amministratore completo, qualsiasi amministratore aggiuntivo del partner dovrà essere aggiunto anche come amministratore esterno con diritti di amministratore completo. |
Scollegare Webex per BroadWorks dall'organizzazione esistente
Effettuare le seguenti operazioni per scollegare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato accidentalmente Webex per BroadWorks a un'organizzazione esistente e si desidera rimuovere l'allegato.
In Flusso standard, il distacco di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati. |
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso all'amministratore esterno seguendo Approva richiesta amministratore esterno.
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Remove a BroadWorks Workspace.
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi abbonato BroadWorks.
Rimuovi gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se gli utenti sono stati predisposti tramite il flusso e-mail non attendibile e non sono stati ancora inseriti messaggi e-mail validi, gli utenti rimangono in stato di attesa. Segui Verifica provisioning utente con e-mail non attendibili per eliminare gli utenti.
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Hybrid, nella sezione BroadWorks Calling elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera collegare Webex per BroadWorks al cliente, seguire i processi di provisioning per collegarlo a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API Rimuovi abbonato BroadWorks è quella di accedere a BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati. |
Gestione di utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente sono in BroadWorks. Un'identità e-mail distinta per l'utente e le relative licenze per le funzioni Webex vengono conservate in Webex.
Verifica provisioning utente con e-mail non attendibili
Se si sta eseguendo il provisioning di utenti Webex per BroadWorks utilizzando il provisioning flow-through con e-mail non attendibili, gli utenti devono eseguire il provisioning automaticamente inserendo il relativo indirizzo e-mail nel portale di attivazione utente. Se l'utente riscontra un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riscontra nuovamente l'errore, l'amministratore può utilizzare i passaggi seguenti in Partner Hub per esaminare lo stato e caricare l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 | Accedere a Partner Hub e trovare la pagina Elenco clienti. |
2 | Fare clic su Visualizza modelli. Selezionare il modello di onboarding appropriato che si desidera applicare a questo utente. |
3 | In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con e-mail non attendibili sia configurato correttamente:
|
4 | In seguito al provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato del provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo stato corrente, che mostra se l'utente è predisposto o se è presente un requisito in sospeso.
|
5 | Per gli utenti con errori o requisiti in sospeso, fare clic sui tre punti a destra e scegliere una delle seguenti opzioni amministrative:
![]() |
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili quando si visualizza l'elenco degli utenti:
Esporta: fare clic su questo pulsante se si desidera esportare l'elenco utenti in un file CSV.
Escludi utenti predisposti: abilita questo tasto di alternanza se desideri visualizzare solo gli utenti con requisiti o errori in sospeso.
Modifica ID utente o indirizzo e-mail
Modifiche a ID utente e indirizzo e-mail
L'ID e-mail e l'ID alternativo sono gli attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. La tabella seguente descrive gli scopi di questi diversi attributi e cosa fare se occorre cambiarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non puoi modificare questo identificativo e comunque collegare l'utente allo stesso account in Webex. È possibile eliminare l'utente e ricreare se non è corretto. |
ID e-mail | ID utente | Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si afferma che l'e-mail è attendibile Non richiesto in BroadWorks se non si asserisce di poter considerare attendibili i messaggi e-mail Non richiesto in BroadWorks se consenti agli abbonati di autoattivarsi | È presente un processo manuale per modificare questa opzione in entrambe le posizioni se all'utente è stato eseguito il provisioning con l'indirizzo e-mail errato:
Non modificare l'ID utente BroadWorks. Questa operazione non è supportata. |
ID alternativo | Nessuno | Consente di abilitare l'autenticazione dell'utente per e-mail e password rispetto all'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se Non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti dovranno inserire il proprio ID utente BroadWorks durante l'autenticazione. |
Modifica pacchetto utenti in Partner Hub
1 | Accedi a Partner Hub e fai clic su Clienti. |
2 | Individuare e selezionare l'organizzazione del cliente a cui è assegnato l'utente. Viene visualizzata la pagina di panoramica dell'organizzazione in un pannello a destra dello schermo. |
3 | Fare clic su Visualizza cliente. L'organizzazione del cliente si apre in Control Hub, mostrando la pagina Panoramica.
|
4 | Fare clic su Utenti, quindi individuare e fare clic sull'utente interessato. |
5 | Nei Servizi dell'utente, fare clic su Webex per i pacchetti BroadWorks (Abbonamenti). Si apre il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 | Nella scheda Profilo, cercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 | Seleziona il pacchetto che desideri per questo utente (Base, Standard, Premium o Softphone) e fai clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 | Puoi chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium hanno siti di riunione distinti associati a ciascun pacchetto. Quando un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato viene visualizzato con due siti di riunione in Control Hub. Le funzionalità di riunione organizzatore e il sito della riunione dell'abbonato vengono allineati al pacchetto corrente. Il sito della riunione del pacchetto precedente e qualsiasi contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili all'amministratore del sito della riunione. |
Potrebbero essere necessarie da due a tre ore per le nuove impostazioni PMR derivanti da una modifica del pacchetto da aggiornare. |
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si desidera eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto alcun trasferimento automatico del ruolo di amministratore nel caso in cui venga eliminato l'ultimo amministratore. |
API Cisco BroadWorks per Webex
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
Eseguire la richiesta API Remove a BroadWorks Subscriber su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento Webex per Cisco BroadWorks. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
Eseguire la richiesta Elimina una persona API su https://developer.webex.com/docs/api/v1/people/delete-a-person per eliminare completamente l'utente.
Provisioning flow-through
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – IM&P integrato in BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks - Parte 2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento Webex per Cisco BroadWorks dall'utente. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla propria organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 | Usa le API Persone per eliminare tutti gli utenti dall'organizzazione:
| ||
2 | Se la sincronizzazione rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione rubriche tramite Partner Hub: Per disabilitare la sincronizzazione rubriche tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API aziendale BroadWorks e disabilita l'impostazione enableDirSync. Tutti gli utenti correlati alla sincronizzazione rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione degli utenti (utilizzando entrambi i metodi) può richiedere del tempo a seconda della quantità di utenti. | ||
3 | Una volta rimossi tutti gli utenti, utilizza l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Gestione delle release
I controlli di gestione delle release in Partner Hub consentono a Webex per i provider di servizi Cisco BroadWorks di gestire facilmente le release consentendo loro di controllare la cadenza di rilascio in base alla quale le app Webex degli utenti vengono aggiornate all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza gli aggiornamenti automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
Configurazione di pianificazioni di rilascio personalizzate con rinvii dalla pianificazione di rilascio predefinita Cisco
Configurare una singola pianificazione della release e trasferirla a cascata a tutte le organizzazioni dei clienti che gestiscono
Assegna diverse pianificazioni di rilascio a diverse organizzazioni di clienti
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di rilascio personalizzate, vedere l'articolo Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
Aggiunta di un cluster BroadWorks in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
Aggiunta di un modello di onboarding in Partner Hub
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | ||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | ||
3 | Fare clic su Visualizza cluster. | ||
4 | Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro flyout a destra.
| ||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | |||||||||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | |||||||||
3 | Fare clic su Visualizza modelli. | |||||||||
4 | Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere a Webex Assistant di seguire le azioni, prendere nota di decisioni importanti ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant per Meetings è disponibile gratuitamente per i siti per riunioni con pacchetto Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilitazione di Webex Assistant per Meetings
Webex Assistant è abilitato per impostazione predefinita per i clienti Broadworks con pacchetto standard e premium.
Gli amministratori dei partner e gli amministratori delle organizzazioni dei clienti possono disabilitare la funzione per le organizzazioni dei clienti tramite Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
Il supporto è limitato ai siti per riunioni con pacchetto Premium e Standard e solo alle sale riunioni personali.
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
La condivisione di contenuto tramite e-mail è accessibile solo dagli utenti all'interno della tua organizzazione
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Il contenuto della riunione non è accessibile anche se condiviso tra utenti di pacchetti diversi dall'interno della stessa organizzazione.
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile, pertanto le trascrizioni post-riunione non sono disponibili se Webex Assistant è abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni utente su come utilizzare la funzione, vedere Uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
Webex Calling gratuito è abilitato per impostazione predefinita consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, che disabilita tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzione
Se Webex Calling è disabilitato, le seguenti condizioni si applicano a Webex per gli utenti Cisco BroadWorks:
Gli utenti non visualizzano più Chiamata con Webex come opzione di chiamata selezionabile sull'app Webex.
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, la cronologia chiamate, i contatti, inserendo l'URI dell'altro utente o l'indirizzo e-mail nella barra di ricerca.
Condivisione schermo all'interno di una chiamata BroadWorks.
Le riunioni Webex e la presenza in telefonia funzionano ancora, anche se le chiamate Webex sono disabilitate.
Disabilita chiamate Webex (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno di Aggiungi un nuovo modello guidata. Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti assegnate al modello.
Per informazioni dettagliate sulla configurazione di un nuovo modello di onboarding, vedere Configurazione dell'organizzazione partner in Partner Hub.
Disabilita chiamate Webex (modello di onboarding esistente)
Seguire questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
Accedere a Partner Hub all'indirizzo admin.webex.com.
Scegliere Impostazioni.
Fare clic su Visualizza modello e scegliere il modello di inserimento appropriato.
Fai clic su Disabilita chiamata gratuita Cisco Webex.
Fai clic su Salva.
Disabilita chiamate Webex (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare Webex Calls per un utente esistente, è possibile seguire una delle procedure seguenti per aggiornare l'utente.
Accertarsi di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigura l'utente con le chiamate Webex abilitate. |
Se si utilizza il provisioning flow-through, è possibile effettuare le seguenti operazioni:
Aprire CommPilot e passare alla configurazione utente.
Rimuovere il servizio Integrated IM+P dall'utente e fare clic su OK.
Aggiungere il servizio Integrated IM+P all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
Utilizzare Remove a BroadWorks Subscriber API per eliminare l'utente.
Utilizzare la Provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione della condivisione video o dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per informazioni dettagliate sulla configurazione e le opzioni complete, vedere Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è anche possibile configurare se il contenuto multimediale delle chiamate in ingresso utilizza per impostazione predefinita solo il video o l'audio. |
Indicatore di stato della linea / Notifica risposta per assente
L'indicatore di stato/notifica di risposta per assente utilizza le funzioni di risposta per assente indirizzata. Un utente con indicatore di stato riceve una notifica audio e visiva sull'app Webex quando un utente dell'elenco di indicatori di stato monitorato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può Ignorare o Rispondere alla chiamata dell'utente monitorato.
La notifica dell'indicatore di stato/risposta per assente consente di rispondere alle chiamate di altri membri del team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra chiamata multipla - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza dei membri del team Webex e non Webex. I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati nella rubrica in Webex e avranno solo stati "sconosciuti" e "in chiamata" (lo stato suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
La presenza non è supportata per gli utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
Gli utenti CI senza autorizzazione cloud Webex o tipo di account macchina (spazi di lavoro) visualizzano solo la presenza "in chiamata" e "sconosciuta". Nessun stato attivo, suoneria, ecc.
Gli utenti non Webex dall'elenco di indicatori di stato, che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza "sconosciuta".
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
Se un utente non Webex dell'indicatore di stato detiene una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate su BroadWorks. Installare solo le patch valide per la versione in uso:
Per R22:
Piattaforma AP.22.0.1123.ap382053
AP.as.22.0.1123.ap382053
AP.as.22.0.1123.ap382362
AP.xsp.22.0.1123.ap382053
AP.xsp.22.0.1123.ap382362
AP.as.22.0.1123.ap383459
AP.as.22.0.1123.ap383520
Per R23:
Piattaforma AP.23.0.1075.ap382053
AP.as.23.0.1075.ap382053
AP.as.23.0.1075.ap382362
AP.as.23.0.1075.ap383459
AP.as.23.0.1075.ap383520
Se si utilizza XSP|ADP:
AP.xsp.23.0.1075.ap382053
AP.xsp.23.0.1075.ap382362
Se si utilizza ADP:
Xsi-Actions-23_2022.01_1.200.bwar
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
Per R24:
AP.as.24.0.944.ap382053
AP.as.24.0.944.ap382362
AP.as.24.0.944.ap383459
AP.as.24.0.944. ap383520
Xsi-Actions-24_2022.01_1.200.bwar
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
<busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare la funzione 101642 Enhanced Xsi Mechanism Per la telefonia del team su AS:
AS_CLI/System/ActivatableFeature> activate 101642
Abilita X-BroadWorks-Remote-Party-Info
in AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamata SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Accertarsi che i seguenti servizi siano assegnati agli utenti:
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP. |
Configurazione dell'indicatore di stato della linea su BroadWorks
Gli amministratori dei partner possono utilizzare la seguente procedura per impostare l'indicatore di stato della linea per un utente.
Accedere a BroadWorks CommPilot.
Per un utente selezionato, accedere ad Applicazioni client e configurare l'indicatore di stato della linea.
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
Utilizzare i parametri di ricerca per individuare e aggiungere utenti all'elenco Utenti monitorati.
Fai clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento di coinvolgimento del pubblico facile da usare. Consente alle persone di ottenere il massimo dalle riunioni colmando la distanza tra oratori e pubblico. Quando Slido è integrato nell'organizzazione Control Hub, gli utenti possono aggiungere l'Slido app alle riunioni nell'app Webex. Questa integrazione offre ulteriori funzionalità di Q&A e sondaggio alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando è stata accettata una riunione nel client Outlook che corrisponde a un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che hai assunto un impegno diverso e che la risposta potrebbe essere ritardata.
Per abilitare questa funzione:
andare alla scheda Generale della scheda Impostazioni su Windows o Preferenze su Mac.
Selezionare la casella per Mostra in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, "In una riunione di calendario" in Webex è associato a "Occupato" in Outlook. |
Avvertenza
Per utilizzare questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come funziona altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la sua presenza non verrà aggiornata fino al termine della riunione. A tale scopo, sarà necessario riavviare il client per rispondere.
Risposta automatica con tono
Con la risposta automatica con tono, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul desktop. Quando l'app Webex squilla sull'altra parte, l'utente sente un determinato segnale acustico che indica che la chiamata è in connessione.
Per utilizzare questa funzione per un utente Webex per Cisco BroadWorks:
La funzione è supportata solo sull'aspetto della linea principale
L'app Webex deve essere l'identificativo di linea principale
Il tag %ENABLE_AUTO_ANSWER_WXT% deve essere abilitato
Se l'utente dispone anche di indicatori di chiamata condivisa (ad esempio, un telefono da tavolo è configurato come uno degli indicatori di linea secondaria), la funzione è ancora supportata sull'aspetto principale, a condizione che gli indicatori di chiamata condivisa siano configurati per non ricevere chiamate in arrivo. Per effettuare questa operazione, è possibile configurare una delle tre condizioni seguenti su BroadWorks per tutte le chiamate condivise:
Avvisa tutti gli aspetti delle chiamate con clic è disabilitato nella configurazione dell'aspetto chiamata condivisa: questo è l'approccio consigliato
o
Consenti terminazione a questa posizione deve essere disabilitato per tutte le chiamate condivise o
o
Posizioni disabilitate per tutti gli indicatori di chiamata condivisi
Aumentare la capacità
Aziende agricole XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare quante risorse XSP|ADP aggiuntive sono necessarie per l'aumento proposto dei numeri di abbonati. Per le aziende NPS dedicate o Webex dedicato per le aziende Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
Fattoria dedicata in scala: Aggiungere uno o più server XSP|ADP all'azienda che ha bisogno di capacità extra. Installare e attivare lo stesso set di applicazioni e configurazioni dei nodi esistenti dell'azienda agricola.
Aggiungi azienda agricola dedicata: Aggiungi una nuova fattoria XSP|ADP dedicata. Dovrai creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti nella nuova fattoria, per ridurre la pressione sulla fattoria esistente.
Aggiungere azienda agricola specializzata: Se si verificano strozzature per un particolare servizio, è possibile creare un'azienda agricola ADP|XSP separata a tale scopo, tenendo conto dei requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster di Control Hub e le voci DNS se si modifica l'URL del servizio con una nuova azienda agricola.
In tutti i casi, è tua responsabilità monitorare e assegnare risorse all’ambiente BroadWorks. Se si desidera contattare l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare i servizi professionali.
Gestione dei certificati del server HTTP
È necessario gestire questi certificati per le applicazioni Web autenticate mTLS su XSP|ADP:
La nostra catena di certificati di attendibilità dal cloud Webex
Certificati delle interfacce del server HTTP di XSP|ADP
Catena di fiducia
È possibile scaricare la catena del certificato di attendibilità da Control Hub e installarlo sugli ADP|XSP durante la configurazione iniziale. Prevediamo di aggiornare il certificato prima della scadenza e di informarvi su come e quando modificarlo.
Interfacce del server HTTP
L'|ADP XSP deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Certificati ordine. Quando si protegge l'interfaccia, viene generato un certificato autofirmato per l'interfaccia. Questo certificato è valido per un anno da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione di Partner Hub che gli amministratori dei partner possono assegnare a organizzazioni di clienti specifiche per limitare le impostazioni dell'organizzazione che gli amministratori dei clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione del cliente, tutti gli amministratori del cliente di tale organizzazione, indipendentemente dalle autorizzazioni dei ruoli, non sono in grado di accedere a un set di controlli con limitazioni in Control Hub. Solo un amministratore partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner esiste un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita le autorizzazioni di ruolo specifiche per gli amministratori dei clienti nell'organizzazione a cui è applicata l'impostazione. |
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità con limitazioni per partner. Dopo l'accesso, vedrà un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner notifica all'amministratore del cliente che la Modalità con limitazioni è abilitata e che l'amministratore potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore del cliente in un'organizzazione in cui con limitazioni della modalità partner è abilitata, il livello di accesso di Control Hub è determinato con la formula seguente:
(Accesso a Control Hub) = (Entitlements Role Organization) - (Limitato dalle limitazioni della modalità partner)
Limitazioni
Quando è abilitata la modalità con limitazioni per partner per un'organizzazione del cliente, gli amministratori dei clienti di tale organizzazione non possono accedere alle seguenti impostazioni di Control Hub:
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
Pulsante Gestisci utenti: disattivato.
Aggiungi o modifica manualmente utenti: nessuna opzione per aggiungere o modificare gli utenti, né manualmente né tramite CSV.
Richiedi utenti: non disponibile
Assegna automaticamente licenze: non disponibile
Sincronizzazione rubriche —Impossibile modificare le impostazioni di sincronizzazione delle rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato ed e-mail principale* sono modificabili.
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, messaggi, riunioni, chiamate)
Visualizza stato servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
Numero di lavoro principale: questo campo è di sola lettura.
Nella vista Account, non sono disponibili le seguenti impostazioni:
Nome società: campo di sola lettura.
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
Dominio: accesso di sola lettura.
E-mail: le impostazioni Elimina inviti e-mail di amministrazione e Selezione impostazioni internazionali e-mail sono di sola lettura.
Autenticazione: nessuna opzione per la modifica delle impostazioni di autenticazione e SSO.
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
Impostazioni chiamata: le impostazioni di priorità della chiamata delle opzioni dell'app sono di sola lettura.
Funzionamento chiamata: le impostazioni sono di sola lettura.
Posizione > PSTN: le opzioni Gateway locale e Cisco PSTN sono nascoste.
Sotto SERVIZI, le opzioni di servizio Migrazioni e Connected UC vengono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori partner possono utilizzare la procedura seguente per l'abilitazione Con limitazioni della modalità partner per una determinata organizzazione cliente (l' impostazione predefinita è abilitata).
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
Seleziona l'organizzazione cliente applicabile.
Nella vista Impostazioni di destra, abilitare il Con limitazioni della modalità partner per attivare l'impostazione.
Se si desidera disattivare la modalità Con limitazioni per partner, disabilitare l'interruttore.
Se il partner rimuove la modalità amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà eseguire quanto segue:
|
Analisi dei partner
I miglioramenti di Control Hub consentono agli amministratori partner di visualizzare e aggiornare facilmente le informazioni sui pacchetti per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata di tutti i clienti e include i seguenti dettagli:
Utenti totali per pacchetto (Softphone, Base, Standard, Premium)
Tendenza utenti per pacchetto (giornaliero/settimanale/mensile)
Clienti con n. di pacchetti assegnati
Per informazioni dettagliate su come utilizzare Analisi dei partner, vedere l'articolo Webex Analisi per i pacchetti Webex per la vendita all'ingrosso e Webex per BroadWorks in Partner Hub .
API di report fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare report di fatturazione. Nella tabella seguente vengono elencate le API, il tipo di accesso richiesto e i requisiti di ruolo.
API di fatturazione | Scopo | Tipo di accesso | Requisiti di ruolo per API (L'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Creazione di un report di fatturazione BroadWorks | Utilizzato per generare un report di fatturazione. | Accesso in scrittura |
|
Elenca report di fatturazione BroadWorks | Consente di elencare i report disponibili per la visualizzazione. | Accesso in lettura |
|
Ottenere un report di fatturazione BroadWorks | Utilizzato per ottenere una copia di un report generato. | Accesso in lettura |
|
Eliminazione di un report di fatturazione BroadWorks | Utilizzato per eliminare un report generato. | Accesso scrittura |
|
Campi di fatturazione
Nella tabella seguente sono elencati i campi contenuti nel report generato.
Campo | Descrizione |
---|---|
nome rivenditore | Nome partner o ID organizzazione partner |
ID fatturazione | Identificativo di fatturazione univoco del partner o numero C |
IdImpresaSp | L'identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno | Stato versione di prova interna del cliente (Sì/No) |
ID utente | IDutente dell'abbonato su BroadWorks |
id abbonato | Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato | Sì/No |
Data iniziale | Data di provisioning dell'abbonato. |
dataInizioFatturazione | Data di inizio fatturazione in questo mese |
DataFineFatturazione | Data di fine fatturazione in questo mese |
pacchetto | Il tipo di confezione che viene caricata |
quantità | Quantità ripartita per fatturazione.
|
|
Risoluzione dei problemi di Webex per Cisco BroadWorks
Abbonamento alla pagina di stato Webex
Innanzitutto verificare https://status.webex.com quando si verifica un'interruzione imprevista del servizio. Se non hai modificato la tua configurazione in Control Hub o BroadWorks prima dell'interruzione, controlla la pagina di stato. Ulteriori informazioni sull'iscrizione per le notifiche di stato e incidenti al Centro assistenza Webex.
Usa analisi Control Hub
Webex monitora l'utilizzo e i dati di qualità per la tua organizzazione e le organizzazioni dei tuoi clienti. Ulteriori informazioni sulle analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
Clienti o utenti non vengono creati in Control Hub con provisioning flowthrough:
Il server applicazioni può raggiungere l'URL di provisioning?
L'account di provisioning e la password sono corretti? Tale account esiste in BroadWorks?
I cluster non riescono in modo coerente a eseguire i test di connettività:
La connessione mTLS al servizio di autenticazione non riesce quando si crea il primo cluster in Partner Hub, poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. In caso contrario, non è possibile creare un'ancora attendibile sul servizio di autenticazione XSP|ADPs, pertanto la connessione mTLS di prova da Partner Hub non viene eseguita correttamente. |
Le interfacce XSP|ADP sono accessibili pubblicamente?
Stai utilizzando le porte corrette? È possibile immettere una porta nella definizione dell'interfaccia sul cluster.
Convalida non riuscita interfacce
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Esaminare i consigli per la configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Rivedere i consigli sulla configurazione dell'interfaccia in questo documento, con particolare attenzione a:
- Accertarsi di aver condiviso le chiavi RSA tra tutti gli XSP|ADP.
- Accertarsi di aver fornito l'URL AuthService al contenitore Web su tutti gli XSP|ADP.
- Se è stata modificata la configurazione della crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'|ADP XSP richiede di immettere il formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento elencava erroneamente le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati sul proprio archivio attendibile XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere i certificati del client?
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere i certificati del client?
Problemi del cliente
Verificare che il client sia connesso a BroadWorks
Accedere all'app Webex.
Verificare che l'icona Opzioni di chiamata (un ricevitore con una marcia sopra) sia presente sulla barra laterale.
Se l'icona non è presente, l'utente potrebbe non essere ancora abilitato per il servizio di chiamata in Control Hub.
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici . Viene visualizzato lo stato Sessione SSO A cui è stato eseguito l'accesso.
Se viene visualizzato un servizio telefonico diverso, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Tale verifica comporta:
Il client ha eseguito correttamente il transveresed dei microservizi Webex richiesti.
Autenticazione dell'utente eseguita correttamente.
Il client ha ricevuto un token Web JSON di lunga durata dal sistema BroadWorks.
Il client ha recuperato il proprio profilo dispositivo e si è registrato su BroadWorks.
Registri client
Tutti i client dell'app Webex possono Inviare I Registri a Webex. Questa è l'opzione migliore per i client mobili. È inoltre necessario registrare l'indirizzo e-mail dell'utente e l'ora approssimativa in cui si è verificato il problema se si sta cercando assistenza da TAC. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se è necessario raccogliere manualmente i registri da un PC Windows, si trovano come segue:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac:/Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS configurata male
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
Verificare che la catena di certificati Webex sia installata come ancora affidabile.
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e firmato da una CA ben nota.
Messaggio di eccedenza licenza
Questo messaggio può apparire per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'utilizzo delle licenze supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Politica di supporto allo stato stazionario
Il provider di servizi è il primo punto di contatto per il supporto del cliente finale (aziendale). Inoltrare i problemi che il SP non è in grado di risolvere al centro TAC. Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Politica di escalation
Tu (provider di servizi/partner) sei il primo punto di contatto per il supporto clienti finali (aziendale).
I problemi che non possono essere risolti dal SP vengono inoltrati al centro TAC.
Versioni di BroadWorks
Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Risorse di autosupporto
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, dove è presente una pagina specifica di Webex per Cisco BroadWorks che elenca argomenti di Guida e supporto comuni dell'app Webex.
L'app Webex può essere personalizzata con questo URL della Guida e un URL di segnalazione problemi.
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I registri vengono inviati al cloud Webex, dove possono essere analizzati da Webex DevOps.
È disponibile anche una pagina Centro assistenza dedicata alla Guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccogliere informazioni per l'invio di una richiesta di assistenza
Quando vengono visualizzati errori in Control Hub, potrebbero essere allegate informazioni che possono aiutare TAC a indagare sul problema. Ad esempio, se viene visualizzato un ID di verifica per un particolare errore o un codice di errore, salvare il testo da condividere con noi.
Prova a includere almeno le seguenti informazioni quando invii una query o apri un caso:
ID organizzazione cliente e ID organizzazione partner (ogni ID è una stringa di 32 cifre esadecimali, separate da trattini)
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce uno
Indirizzo e-mail utente (se un particolare utente riscontra problemi)
Versioni del cliente (se il problema presenta sintomi notati attraverso il cliente)
Confronto UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > | SaaS UC-One | Webex per Cisco BroadWorks |
---|---|---|
Cloud | Cisco UC-One Cloud (GCP) | Webex Cloud (AWS) |
Client | UC-One: Mobile, desktop Receptionist, Supervisore | Webex: Mobile, desktop, Web |
Principale differenza tecnologica | Riunioni condotte sulla tecnologia BroadSoft Meet | Riunioni fornite sulla tecnologia Webex Meetings |
Prove sul campo iniziali | Contesto di stadiazione, clienti beta | Ambiente di produzione, clienti GA |
Identità utente | ID BroadWorks servito come ID principale, a meno che il provider di servizi non disponga già dell'integrazione SSO.
ID utente e segreto in BroadWorks | ID e-mail in Cisco CI serve come ID principale Integrazione SSO in BroadWorks provider di servizi in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks al momento.
L'utente fornisce le credenziali tramite SSO con BroadWorks e Secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e segreti in IdP |
Autenticazione client | Gli utenti forniscono le credenziali attraverso il client Token di lunga durata BroadWorks richiesti se si utilizza la messaggistica Webex | Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso a Webex e aggiornamento dei token |
Gestione / configurazione | I vostri sistemi OSS/BSS e Portale rivenditore | I tuoi sistemi OSS/BSS e Control Hub |
Attivazione partner/provider di servizi | Impostazione una tantum da Cisco Operations | Impostazione una tantum da Cisco Operations |
Attivazione cliente/azienda | Portale rivenditore | Control Hub Creato automaticamente alla prima iscrizione utente |
Opzioni di attivazione utente | Autoiscrizione Imposta IM&P esterno in BroadWorks
| Impostazione di IM&P integrato in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP | Azioni XSI
XSI-Eventi CTI (mTLS) AuthService (mTLS opzionale) DMS | Azioni XSI Azioni XSI (mTLS) XSI-Eventi CTI (mTLS) Servizio di autenticazione (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 | Scarica e installa Webex. Per informazioni dettagliate, vedi Webex | Download dell'app. |
2 | Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 | Inserisci l'indirizzo e-mail e fai clic su Avanti. |
4 | Una delle seguenti operazioni si verifica, a seconda del modo in cui l'organizzazione è configurata in Webex: Webex si carica dopo aver eseguito correttamente l'autenticazione su IdP o BroadWorks.
|
Scambio e archiviazione dati
Queste sezioni forniscono dettagli sullo scambio e la memorizzazione dei dati con Webex. Tutti i dati vengono crittografati sia in transito che a riposo. Per ulteriori informazioni, vedi Webex App Security.
Onboarding provider servizi
Quando si configurano cluster e modelli utente in Webex Control Hub durante l'onboarding di provider di servizi, è possibile scambiare i seguenti dati BroadWorks memorizzati in Webex:
URL Xsi-Actions
URL Xsi-Events
URL interfaccia CTI
URL servizio di autenticazione
Credenziali adattatore di provisioning BroadWorks
Provisioning utente provider di servizi
Questa tabella elenca i dati utente e aziendale che vengono scambiati come parte del provisioning utente attraverso le API Webex.
Trasferimento dei dati in Webex | Da | Attraverso | Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito da SP) | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito dall’utente) | Utente | Portale di attivazione utente | Sì |
Nome | BroadWorks, per API | API Webex | Sì |
Cognome | BroadWorks, per API | API Webex | Sì |
Numero di telefono principale | BroadWorks, per API | API Webex | Sì |
Numero telefono cellulare | BroadWorks, per API | API Webex | Sì |
Estensione principale | BroadWorks, per API | API Webex | Sì |
ID provider di servizi BroadWorks e ID gruppo | BroadWorks, per API | API Webex | Sì |
Lingua | BroadWorks, per API | API Webex | Sì |
Fuso orario | BroadWorks, per API | API Webex | Sì |
Rimozione utente
Le API Webex per Cisco BroadWorks supportano la rimozione parziale e completa dell'utente. Questa tabella elenca tutti i dati utente memorizzati durante il provisioning e ciò che viene eliminato in ogni scenario.
Dati utente | Eliminazione parziale | Eliminazione completa |
---|---|---|
ID utente BroadWorks | Sì | Sì |
No | Sì | |
Nome | No | Sì |
Cognome | No | Sì |
Numero di telefono principale | Sì | Sì |
Numero telefono cellulare | Sì | Sì |
Estensione | Sì | Sì |
ID provider di servizi BroadWorks e ID gruppo | Sì | Sì |
Lingua | No | Sì |
Accesso utente e recupero configurazione
Autenticazione Webex
L'autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da uno qualsiasi dei meccanismi di autenticazione del supporto Webex. (L'autenticazione BroadWorks è trattata separatamente.) Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (indipendente) | Webex | Browser utente |
Credenziali utente | Browser utente | Provider identità (che dispone già di identità utente) |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Autenticazione BroadWorks
L'autenticazione BroadWorks si riferisce all'accesso dell'utente a un'app Webex utilizzando le credenziali BroadWorks. Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (proxy Webex Bwks IdP) | Webex | Browser utente |
Informazioni sul branding e URL BroadWorks | Webex | Browser utente |
Credenziali utente BroadWorks | Utente tramite browser (pagina di accesso con marchio servita da Webex) | Webex |
Credenziali utente BroadWorks | Webex | BroadWorks |
Profilo utente BroadWorks | BroadWorks | Webex |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento dell'avviso di accesso e del messaggio di errore:
- Attualmente gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso poiché la password è già scaduta. Con questa funzione, se la password sta per scadere tra 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere, con l'indicazione di quanti giorni rimangono, e all'utente viene consigliato di contattare il partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su true, è stato emesso l'errore "nome utente e password errati", ma ora con questa funzione viene migliorato il messaggio di errore: Tentativo di accesso non riuscito. La combinazione di ID utente e password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice errore 100006
Controllo flusso di accesso:
- Il partner può limitare l'accesso abilitando o disabilitando un'impostazione "w4bwks-password-expiry-fail-login". Se la password BroadWorks è scaduta, la configurazione in broadworks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, quindi viene visualizzato un errore che indica che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso può essere configurato dal partner come parte della funzione di personalizzazione avanzata. I partner solitamente configurano il collegamento per passare dall'utente a un portale partner per la gestione della password e la reimpostazione della password.
Questa funzione migliora l'esperienza di accesso utente solo durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se una password scade mentre l'utente è connesso all'app Webex. L'utente riceve la notifica di scadenza della password al successivo tentativo di accesso. L'impostazione "w4bwks-password-expiry-fail-login" verrà abilitata o disabilitata da Cisco su richiesta di un partner. |
Recupero configurazione cliente
Questa tabella illustra la tipologia di dati scambiati tra le diverse componenti in fase di recupero delle configurazioni del cliente.
Trasferimento dei dati | Da | Per |
---|---|---|
Iscrizione | Client | Webex |
Impostazioni organizzazione, inclusi URL BroadWorks | Webex | Client |
Token JWT BroadWorks | BroadWorks attraverso Webex | Client |
Token JWT BroadWorks | Client | BroadWorks |
Token dispositivo | BroadWorks | Client |
Token dispositivo | Client | BroadWorks |
File di configurazione | BroadWorks | Client |
Utilizzo allo stato stazionario
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione dopo la scadenza del token, tramite BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Trasferimento dei dati | Da | Per |
---|---|---|
Segnalazione SIP | Client | BroadWorks |
Supporto SRTP | Client | BroadWorks |
Segnalazione SIP | BroadWorks | Client |
Supporto SRTP | BroadWorks | Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Trasferimento dei dati | Da | Per |
---|---|---|
Messaggistica e presenza REST HTTPS | Client | Webex |
Messaggistica e presenza REST HTTPS | Webex | Client |
Segnalazione SIP | Client | Webex |
Supporto SRTP | Client | Webex |
Segnalazione SIP | Webex | Client |
Supporto SRTP | Webex | Client |
Uso dell'API di provisioning
Accesso sviluppatore
Le specifiche API sono disponibili su https://developer.webex.com e una guida all'uso è disponibile su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l' accedere per leggere la specifica API all'indirizzohttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Autenticazione e autorizzazione applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (ad esempio provisioning abbonato) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere l'aggiornamento e l'accesso ai token per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
Devi prima registrare la tua integrazione con Webex. Una volta eseguita la registrazione, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di accesso e aggiornamento necessari.
Per ulteriori dettagli sulle integrazioni e sulle modalità di creazione di questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli obbligatori per l'implementazione delle integrazioni: sviluppatore e utente autorizzatore, che possono essere svolti da persone/team separati nel proprio ambiente.
|
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning utilizzata:
Modalità Enterprise: il nome dell'organizzazione corrisponde esattamente a spEnterpriseId.
Modalità provider di servizi: il nome dell'organizzazione è la parte groupID di spEnterpriseId.
Il nome dell'organizzazione conterrà qualsiasi spazio vuoto, maiuscolo e caratteri speciali specificati in spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "attuale" con le ultime patch BroadWorks e le app Release Independent (RI). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Assicurarsi di rivedere le note di patch per queste patch software. Alcune patch potrebbero avere requisiti CLI aggiuntivi. |
Versione R22
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | ||
Richiesto per sincronizzazione rubrica | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per il server applicazioni | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per la funzione di registrazione chiamata | ||
Patch richiesta per il provisioning flow-through | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | Richiesto per proxy autenticazione NPS | |
Richiesto per il servizio di autenticazione con convalida token CI | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Obbligatorio per la cronologia chiamate unificata | ||
Altro | AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Richiesto per sincronizzazione rubrica | |
Configurazione server app | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Se si utilizza ADP... | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Versione R24
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per il provisioning flowthrough | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che è necessario configurare per Webex, fare riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utente e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. L'attivazione include la convalida e-mail e l'assegnazione del servizio in Webex. |
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se disponi di indirizzi e-mail affidabili per gli utenti, puoi scegliere di attivarli automaticamente quando esegui il provisioning automatico degli utenti. Questo processo è "provisioning automatico e attivazione automatica".
Provisioning utente automatizzato e attivazione automatica (flusso e-mail affidabile)

Prerequisiti
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase | Descrizione |
---|---|
1 | Citare e prendere ordini per il servizio con i clienti. |
2 | Si elabora l'ordine del cliente e si esegue il provisioning del cliente nei sistemi. |
3 | Il sistema di provisioning dei servizi attiva il provisioning di BroadWorks. Questo passaggio, in sintesi, crea l'azienda e gli utenti. Quindi assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM&P esterno. |
4 | Questo passaggio di provisioning attiva il provisioning automatico dell'organizzazione cliente e degli utenti in Webex. (L'assegnazione del servizio IM&P determina che l'adattatore di provisioning chiami l'API di provisioning Webex). |
5 | I sistemi devono utilizzare l'API di provisioning Webex se successivamente è necessario regolare il pacchetto per l'utente (per passare dall'impostazione predefinita). |
Flusso di accesso SSO

Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, che consente l'autenticazione diretta a BroadWorks. L'immagine mostra gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresenta ciò che il client prevede per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.

Di seguito è riportato il flusso di rilevamento servizio BroadWorks che segue immediatamente il flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.

Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione BroadWorks diretta abilitata (condivisione risorse cross-origin). Di seguito sono riportati alcuni flussi di accesso SSO SAML alternativi:
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
L'unica differenza è nei punti 5 e 6 del flusso di accesso Webex. Nel passaggio 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
Il flusso procede attraverso i restanti passaggi dei due diagrammi.
Il token SSO non viene utilizzato in questo flusso.
Autenticazione SSO SAML Webex:
Nel passaggio 3 del flusso di accesso Webex, il servizio Common Identity restituisce il provider di identità utilizzato dall'autenticazione Webex.
A questo punto, viene invocato un flusso di accesso SSO SAML alternativo per Webex.
Interazioni utente
Accedi

L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
CI rileva che l'organizzazione cliente associata dispone del proxy IDP BroadWorks (IDP) configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso (il provider di servizi può contrassegnare questa pagina di accesso).
L'utente inserisce le credenziali BroadWorks.
Broadworks esegue l'autenticazione dell'utente attraverso l'IDP. In caso di successo, l'IDP reindirizza il browser a CI con un SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
Una volta completata l'autenticazione, l'app Webex ottiene i token di accesso da CI (non mostrati nel diagramma). Il client li utilizza per richiedere un token Web Jason (JWT) di lunga durata BroadWorks.
L'app Webex rileva la configurazione di chiamata da BroadWorks e altri servizi da Webex.
L'app Webex si registra in BroadWorks.
Accesso dalla prospettiva dell'utente
Questo diagramma è il tipico flusso di accesso, visualizzato dall'utente finale o dall'abbonato:

Scarica e installa l'app Webex.
È possibile che tu abbia ricevuto il collegamento dal provider di servizi o che tu possa trovare il download nella pagina di download di Webex.
Inserire l'indirizzo e-mail nella schermata di accesso Webex. Fai clic su Avanti.
Solitamente, si viene reindirizzati a una pagina con il marchio del fornitore di servizi.
Questa pagina potrebbe accogliervi tramite il vostro indirizzo e-mail.
Se non è presente alcun indirizzo e-mail o se l'indirizzo e-mail è errato, inserisci il nome utente BroadWorks.
Inserisci la password BroadWorks.
Se è stato eseguito correttamente l'accesso, Webex si apre.
Flusso chiamate - Rubrica aziendale

Flusso chiamata: numero PSTN

Presentazione e condivisione

Avvio di una riunione nello spazio

Interazioni con i clienti
Recupero del profilo dal registro DMS e SIP con AS
Il client chiama XSI per ottenere un token di gestione dispositivo e l'URL del DMS.
Il client richiede il proprio profilo dispositivo dal DMS presentando il token dal punto 1.
Il client legge il profilo del dispositivo e recupera le credenziali, gli indirizzi e le porte SIP.
Il Client invia un REGISTRO SIP a SBC utilizzando le informazioni dal punto 3.
SBC invia il REGISTRO SIP al SA (l'SBC può eseguire una ricerca nell'NS per individuare un SA se il SBC non conosce già l'utente SIP).
Linee guida per test e laboratorio
Le seguenti linee guida si applicano alle organizzazioni di test e laboratorio:
I partner provider di servizi sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
Tutti gli utenti oltre i primi 50 utenti di test verranno fatturati.
Per garantire un'elaborazione accurata sulla fattura, tutte le organizzazioni di test devono includere il "test" nel nome dell'organizzazione BroadWorks.
Le organizzazioni di test interni devono essere designate all'interno di Webex Control Hub. Ciò al fine di impedire agli utenti di test di essere fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di prova:
Accedi a Partner Hub e seleziona Clienti.
Selezionare il cliente appropriato.
Nella barra di controllo destra, abilitare il tasto di alternanza Organizzazione test interni.

Riproduzione casella vocale
Per la casella vocale, accertarsi di configurare il server multimediale per utilizzare uno dei seguenti codici:
mp3
wav: i file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android
Se si utilizzano i file wav, eseguire i seguenti comandi CLI per configurare il server applicazioni e il server multimediale:
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACIDITÀ
- Elenco di controllo accessi
- ALVEOLO
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APICI
- Servizio di notifica push Apple
- AS
- Server applicazioni
- ATA
- Adattatore per telefono analogico, adattatore che converte la telefonia analogica in VoIP
- BAMBOLA
- Gestione applicazioni BroadSoft
- Autenticazione base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- ALVEOLARE
- Server di messaggistica BroadSoft
- PALUDE
- Flussi bidirezionali Su HTTP sincrono
- BRI
- Basic Rate Interface BRI è un metodo di accesso ISDN
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico telefonico (cfr. partner, provider di servizi, rivenditore a valore aggiunto)
- CAPTCHA
- Test di Turing pubblico completamente automatizzato per distinguere Computer ed Esseri Umani
- CCXML
- Linguaggio di markup eXtensible controllo chiamate
- CIF
- Formato intermedio comune
- CLI
- Interfaccia riga di comando
- CN
- Nome comune
- CNPS
- Server push notifiche chiamate. Un server push notifiche che viene eseguito su un ADP XSP| nel proprio ambiente per eseguire notifiche di chiamata push su FCM e APNS. Vedere il proxy NPS.
- CPE
- Attrezzatura della sede del cliente
- CPR
- Regola presenza personalizzata
- CENERE
- Foglio stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione telefonia computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- NoDist
- Non disturbare
- DNS
- Sistema dei nomi di dominio
- DPG
- Chiama gruppo di pari
- DSCP
- Punto codice servizi differenziati
- DTAF
- File di archivio tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza a doppia tonalità
- Utente finale
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. Sottoscrittore)
- Aziendale
- Una raccolta di utenti finali (cfr. Organizzazione)
- FUSO
- Messaggistica cloud Firebase
- DI FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creare utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning completo flow-through
- Creare e verificare gli utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks e asserendo che ciascun utente BroadWorks dispone di un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. È la spina sul telefono o fax o i connettori sul sistema telefonico analogico. Fornisce un'indicazione di aggancio/aggancio sganciato (chiusura con loop). Poiché la porta FXO è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo FXO".
- FXS
- Foreign Exchange Subscriber è la porta che effettivamente fornisce la linea analogica all'abbonato. In altre parole, è la "spina nella parete" che fornisce un segnale di linea, corrente della batteria e tensione della suoneria.
- GABBIA
- Messaggio cloud Google
- GABBIA
- Modalità Galois/Counter (tecnologia di crittografia)
- HID
- Dispositivo interfaccia uomo
- HTTPS
- Prese protette da protocollo di trasferimento ipertestuale
- IAD
- Dispositivo di accesso integrato
- IM&P
- messaggistica istantanea e presenza
- PSTN IP
- Un provider di servizi che fornisce VoIP ai servizi PSTN, intercambiabile con ITSP, o un termine generale per la telefonia "pubblica" connessa a Internet, fornito collettivamente dai principali provider di telecomunicazioni (piuttosto che dai paesi, come è PSTN)
- ITSP
- Provider servizi di telefonia Internet
- IVR
- Risposta vocale/risponditore interattiva
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificatore Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notazione oggetto script Java
- JESS
- Java Secure Socket Extension; la tecnologia sottostante che fornisce funzioni di connettività sicure ai server BroadWorks
- KEM
- Modulo interno chiave (telefoni Cisco hardware)
- LLT
- Token di lunga durata (o Long Life): token di connessione autodescrittivo e sicuro che consente agli utenti di rimanere autenticati più a lungo e non è legato ad applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIGLIO
- Base di informazioni di gestione
- AVV.
- Server multimediale
- mTLS
- Autenticazione reciproca tra due parti, tramite scambio di certificati, quando si stabilisce una connessione TLS
- MUCO
- Chat con più utenti
- NAT
- Traduzioni dell'indirizzo di rete
- NPS
- Server push notifica; vedere CNPS
- Proxy NPS
-
Un servizio in Webex che fornisce token di autorizzazione di breve durata al CNPS, consentendo di eseguire notifiche di chiamata push a FCM e APN e, in ultima analisi, a dispositivi Android e iOS con Webex.
- ASSOCIAZIONE
- Apri interfaccia client
- Organizzazione
- Società o organizzazione che rappresentano un insieme di utenti finali (cfr. Impresa)
- OTG
- Gruppo di trunk in uscita
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- Partner
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. rivenditore a valore aggiunto, fornitore di servizi, gestore telefonico)
- PBX
- Borsa filiale privata
- DELLA SOCIETÀ
- E-mail avanzata per la privacy
- PIEDINO
- Rete mobile terrestre pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia per le telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- P.ES.
- Server profilo
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Sito web che consente all’amministratore del rivenditore di configurare la soluzione UC-One SaaS. Talvolta viene indicato come portale BAM, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Revisore di frontiera sessione
- CEMENTAZIONE
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; un'organizzazione che fornisce servizi di telefonia o correlati ad altre organizzazioni (cfr. vettore, partner, rivenditore a valore aggiunto)
- SIP
- Protocollo di avvio sessione
- SLITTA
- Token di breve durata (o Short Life) (chiamato anche BroadWorks SSO Token); token autenticato monouso utilizzato per accedere in sicurezza ad applicazioni Web.
- ODORE
- Piccole e medie imprese
- SNMP
- Protocollo di gestione di rete semplice
- sRTCP
- protocollo di controllo trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- sRTP
- protocollo di trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- SSL
- Strato di prese sicure
- Abbonato
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. utente finale)
- TCP
- Protocollo di controllo del cambio
- TDM
- Divisione Tempo Multiplexing
- TLS
- Sicurezza livello trasporto
- ToS
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Comunicazioni unificate
- UI
- Interfaccia utente
- U ID
- Identificativo univoco
- MUTI
- Server di messaggistica
- URI
- Identificativo risorsa uniforme
- URL
- Ricerca risorse uniformi
- DISTURBO
- Condivisione server
- UTC
- Coordinated Universal Time
- UVS.
- Server video
- Rivenditore a valore aggiunto (VAR)
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. vettore, partner, fornitore di servizi)
- VAMPATA
- Array di grafica video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Linguaggio di markup estensibile vocale
- WebDAV
- Creazione e versioni distribuite su Web
- WebRTC
- Comunicazioni Web in tempo reale
- WRS
- Server WebRTC
- XMPP
- Protocollo di presenza e messaggistica estendibile
Configurazione dei servizi (con mTLS per il servizio autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida token CI. Queste procedure sono obbligatorie se si stanno eseguendo più organizzazioni Webex dallo stesso server ADP XSP|. In caso contrario, sono facoltativi.
Se non si eseguono più organizzazioni Webex sullo stesso server ADP XSP|, si consiglia la convalida del token CI (con TLS) per il servizio di autenticazione. Fare riferimento a Configura servizi su Webex per Cisco BroadWorks XSP|ADPs per informazioni dettagliate su come configurare il servizio di autenticazione e altri servizi. |
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con mTLS)
I token longevi di BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sui tuoi XSP|ADP.
Requisiti
I server XSP|ADP che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
XSP|ADP devono condividere le stesse chiavi per crittografare/decrittografare token di lunga durata BroadWorks. Copiare queste chiavi in ogni XSP|ADP è un processo manuale.
Gli ADP XSP|devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli XSP|ADP include:
Distribuire il servizio di autenticazione.
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
Generare e condividere le chiavi RSA su XSP|ADP.
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ogni XSP|ADP utilizzato con Webex:
Attivare l'applicazione del servizio di autenticazione sul percorso
/authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService
(dove
<version>
è la versione BroadWorks).Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
deploy application /authService
Configurazione della durata del token
Verificare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
Impostare la durata su 60 giorni (max 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
set tokenDurationInHours 1440
Genera e condividi chiavi RSA
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori è necessario generare chiavi su un XSP|ADP quindi copiarle su tutti gli altri XSP|ADP.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP. |
Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web
Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token.
Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get

Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità per il servizio di autenticazione (con mTLS)
Accedi a Control Hub con l'account amministratore del partner.
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
.Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
.Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Esegui GuidaUpdateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot2023
,webexclientissuing
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte e quattro le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, è richiesto mTLS per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/HttpServer>
e eseguire ilget
comando per visualizzare le interfacce.Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che significa come mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. In sostanza, il primo
true
protegge l'interfaccia con TLS (il certificato del server viene creato se richiesto) e la secondatrue
forza l'interfaccia a richiedere l'autenticazione del certificato del client (insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Interface Port Name Secure Client Auth Req Cluster Fqdn
=======================================================
192.0.2.7 443 XSP|ADP01.collab.example.net true false
192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (autenticazione client richiesta = true) è abilitato il 192.0.2.7
porta 444
. TLS abilitato su 192.0.2.7
porta 443
.
(Opzione) Configurazione di mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, è necessario mTLS per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
e eseguire ilget
per visualizzare le applicazioni in esecuzione.Per aggiungere un'applicazione e richiederne l'autenticazione client (ovvero mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. I nomi delle applicazioni sono elencati qui. Il
true
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
add 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService a 192.0.2.7:443 e richiede di richiedere e autenticare i certificati dal client.
Verifica con get
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
get
Interface Ip Port Application Name Client Auth Req
===================================================
192.0.2.7 443 AuthenticationService true
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Dove andare Avanti
Per la configurazione, è possibile accedere nuovamente al flusso dei documenti principale all'interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca rispetto a AuthService
Webex interagisce con il servizio di autenticazione su una connessione TLS autenticata reciproca. Ciò significa che Webex presenta un certificato client e che XSP|ADP deve convalidarlo. Per garantire l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora attendibile su XSP|ADP (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
Vai a Impostazioni > BroadWorks Calling.
Fare clic sul collegamento del certificato di download.
È inoltre possibile scaricare la catena di certificati da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt. |
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il diagramma seguente riassume dove deve essere distribuita la catena di certificati CA Webex in questi tre casi.

Requisiti del certificato TLS reciproco per proxy bridge TLS
Webex presenta un certificato client firmato da CA Webex al proxy.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità proxy, pertanto il proxy considera attendibile il certificato del client.
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta un certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions:
X509v3 Extended Key Usage:
1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Requisiti di certificato TLS reciproco per proxy passthrough TLS o XSP in DMZ
Webex presenta un certificato client firmato da CA Webex agli XSP.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità degli XSP, pertanto gli XSP si affidano al certificato client.
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
Gli XSP presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i certificati server degli XSP.
Cronologia revisioni documenti
La tabella seguente mostra lo storico delle modifiche apportate a questo documento negli ultimi 12 mesi.
Data | Versione | Descrizione della modifica | |
---|---|---|---|
7 febbraio 2024 | 2-108 |
| |
25 gennaio 2024 | 2-107 |
| |
23 gennaio 2024 | 2-106 |
| |
10 gennaio 2024 | 2-105 |
| |
20 dicembre 2023 | 2-104 |
| |
13 dicembre 2023 | 2-103 |
| |
12 dicembre 2023 | 2-102 |
| |
8 dicembre 2023 | 2-101 |
| |
08 novembre 2023 | 2-100 |
| |
25 ottobre 2023 | 2-99 |
| |
13 settembre 2023 | 2-98 |
| |
04 settembre 2023 | 2-97 |
| |
08 agosto 2023 | 2-96 |
| |
23 giugno 2023 | 2-95 |
| |
30 maggio 2023 | 2-94 |
| |
26 maggio 2023 | 2-93 |
| |
24 maggio 2023 | 2-92 |
| |
10 maggio 2023 | 2-91 |
| |
09 maggio 2023 | 2-90 |
| |
4 maggio 2023 | 2-89 |
| |
27 aprile 2023 | 2-88 |
| |
14 aprile 2023 | 2-87 |
| |
17 marzo 2023 | 2-86 |
| |
11 marzo 2023 | 2-85 |
| |
10 marzo 2023 | 2-84 |
| |
7 marzo 2023 | 2-83 |
| |
28 febbraio 2023 | 2-82 |
| |
15 febbraio 2023 | 2-81 |
| |
10 febbraio 2023 | 2-80 |
| |
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione si rivolge agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei propri clienti o forniscono questa soluzione direttamente ai propri abbonati.
Scopo della soluzione
Fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che già dispongono del servizio di chiamata fornito dai provider di servizi BroadWorks.
Fornire il servizio di chiamata basato su BroadWorks a clienti Webex piccoli e medi.
Contesto
Stiamo evolvendo tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo sforzo consiste nello spostare le funzionalità di chiamata BroadWorks nell'app Webex e infine ridurre gli investimenti nei client UC-One.
Vantaggi
Prova futura: contro interruzione del servizio di UC-One Collaborate, spostamento di tutti i client verso Unified Client Framework (UCF)
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex mantenendo la chiamata BroadWorks sulla rete di telefonia
Ambito della soluzione
Clienti da piccoli a medi esistenti/nuovi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre di chiamate BroadWorks.
Clienti Webex esistenti di piccole e medie dimensioni che desiderano aggiungere BroadWorks Calling.
Non aziende più grandi (rivedere il nostro portfolio Enterprise per Webex).
Non utenti singoli (valutare le offerte Webex Online).
Le funzioni impostate in Webex per Cisco BroadWorks riguardano casi d'uso di piccole e medie imprese. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità per le PMI e ne valutiamo costantemente l'idoneità per questo segmento. Possiamo scegliere di nascondere o rimuovere funzioni che sarebbero altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# | Requisito | Note | ||
---|---|---|---|---|
1 | Patch BroadWorks R22 corrente o superiore | |||
2 | XSP|ADP per XSI, CTI, DMS e authService | XSP|ADP dedicato per Webex per Cisco BroadWorks | ||
3 | XSP|ADP separato per NPS, può essere condiviso con altre soluzioni che utilizzano NPS. | Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni XSP|ADP e NPS. | ||
4 | Convalida token CI (con TLS) configurata per le connessioni Webex al servizio di autenticazione. | |||
5 | mTLS configurato per le connessioni Webex all'interfaccia CTI. | Altre applicazioni non richiedono mTLS. | ||
6 | Gli utenti devono essere presenti in BroadWorks e necessitano dei seguenti attributi, a seconda della decisione di provisioning:
| Per i messaggi e-mail attendibili: Si consiglia di inserire lo stesso indirizzo e-mail anche nell'attributo ID alternativo, per consentire agli utenti di accedere con indirizzo e-mail rispetto a BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'uso di e-mail non attendibili può causare l'invio dell'e-mail alla cartella Posta indesiderata o SPAM dell'utente. L'amministratore potrebbe dover modificare le impostazioni e-mail dell'utente per consentire i domini | ||
7 | Webex per il file DTAF Cisco BroadWorks per l'app Webex | |||
8 | Utente BW Business Lic o Std Enterprise o Prem Enterprise Lic + Webex per abbonamento Cisco BroadWorks | Se si dispone di una distribuzione di collaborazione esistente, non è più necessario il pacchetto aggiuntivo UC-One, le porte per conferenze Collab Lic e Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non occorre apportare altre modifiche se non accettare i termini del pacchetto Premium. | ||
9 | IP/porte devono essere accessibili attraverso i servizi backend Webex e le app Webex su Internet pubblico. | Vedere la sezione "Preparazione della rete". | ||
10 | Configurazione TLS v1.2 su XSP|ADP | |||
11 | Per il provisioning Flowthrough, il server applicazioni deve connettersi all'adattatore di provisioning BroadWorks.
| Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è aiutarti a comprendere, preparare, distribuire e gestire la tua soluzione Webex per Cisco BroadWorks. Le principali sezioni del documento riflettono tale obiettivo.
Questa guida include materiale concettuale e di riferimento. In questo documento intendiamo trattare tutti gli aspetti della soluzione.
La serie minima di attività per distribuire la soluzione è la seguente:

Contatta il team dell'account per diventare un partner Cisco. È fondamentale esplorare i punti di contatto Cisco per acquisire familiarità (e ricevere formazione). Quando si diventa partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Onboarding partner in questo documento.
Configura i tuoi sistemi BroadWorks per l'integrazione con Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento.
Usa Partner Hub per connettere Webex a BroadWorks. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione partner in Partner Hub in questo documento.
Utilizzare Partner Hub per preparare i modelli di provisioning degli utenti. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento.
Testare e eseguire l'onboarding di un cliente mediante il provisioning di almeno un utente (vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
|
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. (Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto).
Come funziona
Webex per Cisco BroadWorks è un'offerta che integra BroadWorks Calling in Webex. Gli abbonati utilizzano una singola applicazione (l'app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
Gli utenti chiamano i numeri PSTN utilizzando l'infrastruttura BroadWorks.
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino numerico per introdurre i numeri).
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Chiamata Webex" sull'app Webex. (Queste chiamate sono da app Webex a app Webex, non da app Webex a PSTN).
Gli utenti possono organizzare e accedere a Webex Meetings.
Gli utenti possono scambiarsi messaggi uno a uno o in spazi (chat di gruppo persistente) e beneficiare di funzioni come ricerca e condivisione file (sull'infrastruttura Webex).
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
Una volta eseguito l'onboarding come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare la relazione tra l'istanza BroadWorks e Webex.
È possibile creare organizzazioni dei clienti in Control Hub e eseguire il provisioning degli utenti in tali organizzazioni.
Ogni abbonato in BroadWorks riceve un'identità Webex in base al proprio indirizzo e-mail (attributo ID e-mail in BroadWorks).
Gli utenti eseguono l'autenticazione su BroadWorks o su Webex.
Ai clienti vengono rilasciati token di lunga durata per autorizzarli per i servizi su BroadWorks e Webex.

L'app Webex al centro di questa soluzione, è un'applicazione personalizzabile disponibile su desktop Mac/Windows e dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzionalità di messaggistica, presenza e riunioni.
Il client esegue la registrazione ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i tuoi sistemi BroadWorks per garantire un'esperienza di provisioning utente perfetta.

Funzioni e limitazioni
Offriamo diversi pacchetti con diverse caratteristiche.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata, ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano nella rubrica un utente softphone, i risultati della ricerca non forniscono alcuna opzione per inviare un messaggio.
Gli utenti del softphone possono condividere lo schermo durante una chiamata.
Pacchetto "base"
Il pacchetto di base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti in riunioni a "spazio unificato" e riunioni nella sala riunioni personale. (** vedere la seguente nota a titolo di eccezione). In questo pacchetto le riunioni possono avere una durata massima di 40 minuti.
Pacchetto "Standard"
Questo pacchetto include anche tutto quello che è contenuto nel pacchetto Base, ad esempio fino a 100 partecipanti nelle riunioni "spazio unificato" e nelle riunioni nella sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è un ruolo inizialmente ricoperto solo dall'organizzatore della riunione, ma l'organizzatore può passare il "ruolo di relatore" a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può riprendere il ruolo di relatore senza che l'organizzatore corrente glielo passi.
Pacchetto "Premium"
Questo pacchetto include tutto nel pacchetto Standard più un massimo di 300 partecipanti in una riunione "spazio unificato" e fino a 1000 partecipanti in una sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è supportata per qualsiasi partecipante alla riunione.
Confronta pacchetti
Pacchetto | Chiamata | Messaggistica | Riunioni nello spazio Unified | PMR riunioni |
---|---|---|---|---|
Softphone | Incluso | Non incluso | Nessuno | Nessuno |
Base | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Standard | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Premium | Incluso | Incluso | 300 partecipanti | 1000 partecipanti |
Il limite della riunione nello spazio Unified per gli utenti Base è 100 partecipanti per riunione nello spazio Unified a meno che lo spazio non includa anche gli utenti a cui sono assegnati i pacchetti "Standard" o "Premium", nel qual caso il limite aumenta in base al pacchetto utente organizzatore. |
"Riunioni nello spazio Unified" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti "Riunione" o "Pianifica". "Riunioni PMR" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale (PMR) di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID). |
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per le differenze di supporto delle funzioni di riunione PMR per i pacchetti Base, Standard e Premium.
Funzione riunione | Supportato con il pacchetto base | Suported con pacchetto standard | Supportato con il pacchetto Preminum | Commento |
---|---|---|---|---|
Durata riunione | 40 minuti o meno | Illimitato | Illimitato | |
Condivisione desktop | Sì | Sì | Sì | Base: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione desktop solo da parte dell'organizzatore della riunione PMR. Premium: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. |
Condivisione applicazione | Sì | Sì | Sì | Base: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione delle applicazioni solo da parte dell'organizzatore della riunione PMR. Premium: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. |
Chat con più interlocutori | Sì | Sì | Sì | |
Lavagna | Sì | Sì | Sì | |
Protezione con password | Sì | Sì | Sì | |
App Web - nessun download o plug-in (Esperienza ospite) | Sì | Sì | Sì | |
Supporto dell'accoppiamento con i dispositivi Webex | Sì | Sì | Sì | |
Controllo del pavimento (disattivazione del microfono uno / espulsione tutti) | Sì | Sì | Sì | |
Collegamento Riunioni persistenti | Sì | Sì | Sì | |
Accesso sito riunioni | Sì | Sì | Sì | |
Accesso alla riunione tramite VoIP | Sì | Sì | Sì | |
Bloccaggio | Sì | Sì | Sì | |
Controlli relatore | No | No | Sì | |
Controllo desktop remoto | No | No | Sì | |
Numero di partecipanti | 100 | 100 | 1000 | |
Registrazione salvata in locale nel sistema | Sì | Sì | Sì | |
Registrazione nel cloud | No | No | Sì | |
Registrazione - Cloud Storage | No | No | 10 GB per sito | |
Trascrizione delle registrazioni | No | No | Sì | |
Pianificazione riunione | Sì | Sì | Sì | |
Abilita condivisione contenuto con integrazioni esterne | No | No | Sì | Base: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. Standard: condivisione di contenuto solo da parte dell'organizzatore della riunione PMR. Premium: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. |
Consenti modifica URL PMR | No | No | Sì | Base: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori dei partner e delle organizzazioni possono modificare l'URL da Control Hub. Standard: l'URL PMR può essere modificato solo da Partner Hub per Partner e amministratori organizzazione. Premium: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori partner e dell'organizzazione possono modificare l'URL da Partner Hub. |
Streaming in diretta riunioni (Ad Esempio, su Facebook, Youtube) | No | No | Sì | |
Consenti ad altri utenti di pianificare riunioni per loro conto | No | No | Sì | |
Aggiungi organizzatore alternativo | Sì | No | Sì | |
Integrazione app (es., Zendesk, Slack) | Dipende dall'integrazione | Dipende dall'integrazione | Sì | Per ulteriori informazioni sul supporto, vedere la sezione Integrazioni app riportata di seguito. |
Integrazione con il calendario Microsoft Office 365 | Sì | Sì | Sì | |
Integrazione con Google Calendaring per G Suite | Sì | Sì | Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione rivolta agli utenti per Webex su help.webex.com
. Per ulteriori informazioni sulle funzioni, leggere i seguenti articoli:
Funzioni di chiamata
L'esperienza di chiamata è simile alle soluzioni precedenti che utilizzano il motore di controllo delle chiamate BroadWorks. La differenza tra UC-One Collaborate e UC-One SaaS è che l'app Webex è il client software principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
Zendesk—Solo Premium
Slack: solo Premium
Microsoft Teams per Webex Meetings—Standard o Premium
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
Calendario Office 365—Standard o Premium
Google Calendaring per G Suite: standard o premium
Supporto dell'infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta gli ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione per Webex per l'infrastruttura desktop virtuale (VDI).
Supporto per IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Tabella di marcia futura
Per informazioni sulle nostre intenzioni per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Le voci della roadmap non sono vincolanti in alcuna capacità. Cisco si riserva il diritto di sospendere o rivedere uno o tutti questi elementi dalle release future.
Limiti
Limitazioni di provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario del sito Webex Meetings creato per tale pacchetto.
Se nella richiesta di provisioning per il primo utente di ciascun pacchetto non viene specificato alcun fuso orario, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sull'impostazione predefinita regionale dell'organizzazione degli abbonati.
Se il cliente necessita di uno specifico fuso orario del sito di Webex Meetings, specificare timezone
parametro nella richiesta di provisioning per:
il primo abbonato predisposto per il pacchetto Standard nell'organizzazione.
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
il primo abbonato predisposto per il pacchetto base nell'organizzazione.
Limitazioni generali
Nessuna chiamata nella versione Web del client Webex (questa è una limitazione del client, non una limitazione della soluzione).
Webex potrebbe non disporre ancora di tutti i controlli dell'interfaccia utente per supportare alcune funzioni di controllo delle chiamate disponibili da BroadWorks.
Attualmente, il client Webex non può essere "White Labeled" (etichetta bianca).
Quando si creano le organizzazioni dei clienti utilizzando il metodo di provisioning scelto, vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. Ci aspettiamo che i partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
I report sull'utilizzo di riunioni e messaggi sono disponibili attraverso l'organizzazione del cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti di messaggistica
I seguenti limiti di archiviazione dei dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo storage massimo per messaggistica e file combinati.
Di base: 2 GB per utente per 3 anni
Standard 5 GB per utente per 3 anni
Premio: 10 GB per utente per 5 anni
Per ciascuna organizzazione del cliente, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti premium ha un limite totale di messaggistica e storage file di 50 GB. Un singolo utente può superare il limite per utente (10 GB), a condizione che la società sia ancora al di sotto del massimo aggregato (50 GB).
Per gli spazi team creati, i limiti di messaggistica vengono applicati al totale aggregato per l'organizzazione cliente che possiede lo spazio team. Puoi trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti generali di messaggistica applicabili agli spazi dei team di messaggistica Webex, fare riferimento a https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure le connessioni a Webex e BroadWorks. I dati memorizzati nel cloud Webex ed esposti all'utente attraverso l'interfaccia dell'app Webex sono crittografati sia in transito che a riposo.
Maggiori dettagli sullo scambio di dati sono disponibili nella sezione Riferimento del presente documento.
Ulteriori letture
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati che più si avvicina alla propria regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore del provider di servizi (utente): Per le attività di manutenzione quotidiane, si gestiscono le parti della soluzione in sede (chiamata) utilizzando i propri sistemi. Gestisci le parti Webex della soluzione attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale.
Il primo utente predisposto per un nuovo organizzatore partner viene assegnato automaticamente ai ruoli amministratore completo e amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi. |
Team operativo di Cisco cloud: Crea la tua "organizzazione partner" in Partner Hub, se non esiste, durante l'onboarding.
Una volta ottenuto l'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente, create "Onboarding templates" (Modelli di onboarding) per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Quindi si fornisce i vostri clienti o abbonati.
# | Compito tipico | SP | Cisco |
---|---|---|---|
1 | Onboarding partner - Creazione dell'organizzazione partner se non esiste e abilitazione dei tasti di alternanza funzione necessari | ● | |
2 | Configurazione BroadWorks nell'organizzazione partner tramite Partner Hub (cluster) | ● | |
3 | Configurazione delle impostazioni di integrazione in Organizzazione partner tramite Partner Hub (modelli di offerta, branding) | ● | |
4 | Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|ADP Patching, firewall, configurazione XSP|ADP, XSI, AuthService, CTI, NPS, applicazioni DMS su XSP|ADP) | ● | |
5 | Sviluppo dell'integrazione o del processo di provisioning | ● | |
6 | Preparare i materiali GTM | ● | |
7 | Migrazione o provisioning di nuovi utenti | ● |
Architettura

Cosa c'è nel diagramma?
Client
Il client dell'app Webex serve come applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di messaggistica nativa, presenza e riunioni audio/video multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per le chiamate SIP e PSTN.
I telefoni IP Cisco e i relativi accessori utilizzano anche l'infrastruttura BroadWorks per le chiamate SIP e PSTN. Ci aspettiamo di essere in grado di supportare telefoni di terze parti.
Portale di attivazione utente per gli utenti che accedono a Webex utilizzando le credenziali BroadWorks.
Partner Hub è un'interfaccia Web per l'amministrazione dell'organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. Puoi anche utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
Rete di provider di servizi
Il blocco verde a sinistra dello schema rappresenta la tua rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
XSP|ADP rivolto al pubblico, per Webex per Cisco BroadWorks: (La scatola rappresenta una o più fattorie XSP|ADP, eventualmente frontali da bilanciatori di carico).
Ospita l'interfaccia dei servizi Xtended (XSI-Actions & XSI-Events), il servizio di gestione dei dispositivi (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato del ricevitore dell'altro (presenza di telefonia) e la cronologia chiamate.
Pubblica la rubrica ai client Webex.
XSP|ADP rivolto al pubblico, con NPS in esecuzione:
server push notifiche chiamate organizzatore: Un server push di notifica su un ADP XSP| nel proprio ambiente. Si interfaccia tra il server applicazioni e il proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS & FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
Server applicazioni:
Fornisce il controllo delle chiamate e le interfacce ad altri sistemi BroadWorks (generalmente)
Per il provisioning flowthrough, l'AS viene utilizzato dall'amministratore del partner per il provisioning degli utenti in Webex
Inserisce il profilo utente in BroadWorks
OSS/BSS: Sistema di supporto alle operazioni/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nello schema rappresenta il cloud Webex. I microservizi Webex supportano l'intero spettro di funzionalità di collaborazione Webex:
Cisco Common Identity (CI) è il servizio identità all'interno di Webex.
Webex per Cisco BroadWorks rappresenta la serie di microservizi che supportano l'integrazione tra Webex e BroadWorks ospitato da provider di servizi:
API di provisioning utente
Configurazione provider di servizi
Accesso utente mediante credenziali BroadWorks
Casella di messaggistica Webex per microservizi correlati alla messaggistica.
Casella Webex Meetings che rappresenta server di elaborazione multimediale e SBC per riunioni video con più partecipanti (SIP e SRTP)
Servizi Web di terze parti
Nello schema sono rappresentati i seguenti componenti di terze parti:
APNS (Apple Push Notifications Service) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Apple.
FCM (messaggistica cloud FireBase) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Il ruolo dei server XSP|ADP aperti al pubblico in Webex per Cisco BroadWorks

L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste Webex per BroadWorks JWT (JSON Web Token) per conto dell'utente
Interfaccia CTI, protetta da mTLS, a cui Webex sottoscrive gli eventi della cronologia chiamate e lo stato della presenza di telefonia da BroadWorks (stato hook).
Interfacce azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate degli abbonati, rubriche di elenchi di contatti e chiamate e configurazione del servizio di telefonia per gli utenti finali
Servizio DM (Device Management) per il recupero dei file di configurazione delle chiamate da parte dei client
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedere Configurazione dei cluster BroadWorks in Partner Hub in questo documento. Per ciascun cluster, è possibile fornire un solo URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP


È necessario utilizzare un'istanza ADP XSP|dedicata o un'azienda agricola separata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile organizzare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso XSP|ADP che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/azienda agricola ADP XSP| dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
Ad esempio, se offri UC-One SaaS, ti consigliamo di creare una nuova fattoria XSP|ADP per Webex per Cisco BroadWorks. In questo modo i due servizi possono operare in modo indipendente durante la migrazione degli abbonati.
Se si collocano le applicazioni Webex per Cisco BroadWorks in una fattoria ADP|XSP utilizzata per altri scopi, è responsabilità dell'utente monitorare l'utilizzo, gestire la complessità risultante e pianificare l'aumento della scala.
Il pianificatore della capacità di sistema Cisco BroadWorks assume una fattoria ADP XSP| dedicata e potrebbe non essere preciso se la si utilizza per i calcoli della posizione.
Se non diversamente specificato, gli Webex dedicati per Cisco BroadWorks XSP|ADP devono ospitare le seguenti applicazioni:
AuthService (TLS con convalida token CI o mTLS)
CTI (mTLS)
Azioni XSI (TLS)
XSI-Events (TLS)
DMS (TLS): opzionale. Non è obbligatorio distribuire un'istanza DMS o un'azienda agricola separata specificamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
TLS (Call Settings Webview): opzionale. La vista Webview (CSW) delle impostazioni di chiamata è richiesta solo se si desidera che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso a CTI attraverso un'interfaccia protetta dall'autenticazione TLS reciproca. Per supportare questo requisito, raccomandiamo una delle seguenti opzioni:
(Diagramma etichettato Opzione 1) Una istanza XSP|ADP o un'azienda agricola per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
(Diagramma etichettato Opzione 2) Due istanze ADP XSP| o aziende agricole, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSP|ADP Se si dispone di una fattoria ADP XSP|esistente conforme a una delle architetture suggerite sopra (Opzione 1 o 2) ed è leggermente caricata, è possibile riutilizzare le ADP XSP|esistenti. Dovrai verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti dell'applicazione per Webex. Le due considerazioni principali sono:
Poiché gli XSP|ADP hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero esserci altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di XSP|ADP deve essere verificato in un laboratorio con la configurazione desiderata prima di impegnarsi per il riutilizzo. |
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione temporale per tutti gli XSP|ADP utilizzati con Webex.
Installare il ntp
pacchetto dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Quindi è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, consultare la Guida alla gestione del software BroadWorks.
Durante l'installazione interattiva del software XSP|ADP, è possibile configurare NTP. Procedere come segue:
Quando l'installatore chiede,
Do you want to configure NTP?
, immetterey
.Quando l'installatore chiede,
Is this server going to be a NTP server?
, immetteren
.Quando l'installatore chiede,
What is the NTP address, hostname, or FQDN?
, immettere l'indirizzo del server NTP o un servizio NTP pubblico, ad esempio,pool.ntp.org
.
Se gli ADP XSP|utilizzano un'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie Key=Value:
NTP
NTP_SERVER=<NTP Server address, e.g., pool.ntp.org>
Requisiti di identità e sicurezza XSP|ADP
Sfondo
I protocolli e le crittografie delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli vanno dal più generale (provider SSL) al più specifico (interfaccia singola). Un'impostazione più specifica sostituisce sempre un'impostazione più generale. Se non sono specificate, le impostazioni SSL di livello "inferiore" vengono ereditate da livelli "superiori".
Se non viene modificata alcuna impostazione rispetto alle impostazioni predefinite, tutti i livelli ereditano le impostazioni predefinite del provider SSL (JSSE Java Secure Sockets Extension).
Elenco dei requisiti
L'|ADP XSP deve autenticarsi sui client utilizzando un certificato firmato da CA in cui il nome comune o il nome alternativo oggetto corrispondono alla parte di dominio dell'interfaccia XSI.
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
Diffie-Hellman Effemeral (DHE) o curve ellittiche Diffie-Hellman Effemeral (ECDHE) chiave-scambio
Crittografia AES (Advanced Encryption Standard) con una dimensione minima di blocco di 128 bit (ad esempio, AES-128 o AES-256)
Modalità di codifica GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
Se viene utilizzata una crittografia CBC, solo la famiglia SHA2 di funzioni hash è consentita per derivazione chiave (SHA256, SHA384, SHA512).
Ad esempio, le seguenti crittografie soddisfano i requisiti:
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come illustrato sopra, non la convenzione openSSL. |
Crittografie TLS supportate per le interfacce AuthService e XSI
Questo elenco è soggetto a modifiche a mano a mano che evolvono i nostri requisiti di sicurezza del cloud. Seguire l'attuale raccomandazione sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento. |
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_128_GCM_SHA256
TLS_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA256
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_256_CBC_SHA
TLS_PSK_WITH_AES_256_CBC_SHA384
TLS_PSK_WITH_AES_256_CBC_SHA
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA
TLS_PSK_WITH_AES_128_CBC_SHA256
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri della scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il numero di thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi visualizzati come segue (non diminuirli se sono al di sopra di questi valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più |ADP XSP
Elemento bordo bilanciamento carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, deve gestire in modo trasparente la distribuzione del traffico tra più server XSP|ADP e il cloud e i client Webex per Cisco BroadWorks. In questo caso, è possibile fornire l'URL del bilanciatore di carico alla configurazione Webex per Cisco BroadWorks.

Note su questa architettura:
Configurare il DNS in modo che i client possano trovare il bilanciatore di carico quando si connettono all'interfaccia Xsi (vedere configurazione DNS).
Si consiglia di configurare l'elemento edge in modalità proxy SSL inversa per garantire la crittografia dei dati punto a punto.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Server XSP|ADP orientati verso Internet
Se si espongono direttamente le interfacce Xsi, utilizzare il DNS per distribuire il traffico ai più server XSP|ADP.

Note su questa architettura:
Per connettersi ai server XSP|ADP sono necessari due record:
Per i microservizi Webex: Per targetizzare più indirizzi IP XSP|ADP sono necessari record A/AAAA round-robin. Questo perché i microservizi Webex non possono effettuare ricerche SRV. Per esempi, vedere Servizi cloud Webex.
Per l'app Webex: Un record SRV che si risolve in record A in cui ogni record A si risolve in un singolo XSP|ADP. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per targetizzare il servizio XSI per più indirizzi XSP|ADP. Assegnare la priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (e all'indirizzo IP successivo) e passino al record A successivo (e all'indirizzo IP) solo se il primo indirizzo IP è inattivo. NON utilizzare un approccio round-robin per l'app Webex.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune.
È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL XSP|ADP di un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server XSP|ADP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.

Ordinazione e provisioning
L'ordine e il provisioning si applicano a questi livelli:
Provisioning di partner/provider di servizi:
Ogni onboarding di Webex per provider di servizi Cisco BroadWorks (o rivenditore) deve essere configurato come organizzazione partner in Webex e devono essere concesse le autorizzazioni necessarie. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per gestire Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le operazioni di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/aziendale.
Ordinazione e provisioning clienti/aziende:
Ogni BroadWorks Enterprise abilitato per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo si verifica automaticamente come parte del provisioning utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks vengono predisposti nella stessa organizzazione cliente Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
Ordinazione e provisioning utente/abbonato:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning degli utenti:
Provisioning fluviale con e-mail attendibili
Provisioning eseguibile senza e-mail attendibili
Self-provisioning utente
Provisioning API
Provisioning eseguibile con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile affermare che BroadWorks dispone di indirizzi e-mail abbonati validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.

Provisioning eseguibile senza e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non puoi contare sugli indirizzi e-mail degli abbonati detenuti da BroadWorks, questa opzione di provisioning crea account Webex ma non può attivarli fino a quando gli abbonati non forniscono e convalidano i relativi indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Self-provisioning utente
Con questa opzione, non è disponibile il provisioning flowthrough da BroadWorks a Webex. Una volta configurata l'integrazione tra Webex e il sistema BroadWorks, vengono visualizzati uno o più collegamenti specifici per il provisioning degli utenti all'interno dell'organizzazione partner Webex per Cisco BroadWorks.
Successivamente, si progettano le proprie comunicazioni (o si delegano ai clienti) per distribuire il collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare i propri account Webex.

Poiché gli account vengono predisposti nell'ambito dell'organizzazione partner, puoi regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare tale operazione.
Gli utenti devono esistere nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento. |
Provisioning provider di servizi per API
Webex presenta un set di API pubbliche che consentono di creare il provisioning utente/abbonato Webex per Cisco BroadWorks nel flusso di lavoro/negli strumenti di gestione utenti esistenti.


Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti Webex per Cisco Broadworks di comporre altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella rubrica Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo dell'estensione di tutte le aree del metodo di avvio chiamata e del profilo dell'utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e gruppi diversi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due imprese che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Utenti Cisco BroadWorks
Provisioning API pubblica come 'interno
Il parametro dell'interno deve essere esplicitamente passato come parte della chiamata API. Per le imprese/gruppi con Location Dialing Code (LDC) configurato, il parametro dell'interno dovrebbe essere la combinazione di LDC e 'numero di interno.
Provisioning flusso o auto-attivazione
Estensione e LDC (se applicabile) saranno automaticamente recuperati da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione di codice di chiamata posizione (LDC) e numero di interno.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'interno |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'estensione deve essere passata come parametro |
Attraverso il flusso | Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Elenchi telefonici BroadWorks | Elenchi telefonici aziendali, di gruppo o personali | Sincronizzazione rubriche | Non applicabile |
Prerequisiti
La versione del client richiesta per supportare questa funzione è 42.11 o successiva.
Patch in cui i codici di chiamata di estensione e posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
AP.platform.23.0.1075.ap380045
AP.as.23.0.1075.ap380045
AP.xsp.23.0.1075.ap380045
AP.as.24.0.944.ap380045
Abilitare l'intestazione X-BroadWorks-Remote-Party-Info su AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP richiesto per il supporto della funzione di composizione dell'interno.
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata a interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità delle chiamate di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'estensione come seconda opzione in Partner Hub e Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con estensione attraverso uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione dell'interno sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Non verrà visualizzata un'estensione nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere visibile l'opzione di chiamata dell'interno per i clienti esistenti:
Se un partner desidera che tutte le organizzazioni dei clienti gestite siano dotate di un interno come una delle opzioni di chiamata, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
Se un partner desidera fornire un interno in opzioni di chiamata per una specifica organizzazione cliente, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e portarli alla pari con l'aumento di 30K contatti per l'elenco telefonico Enterprise, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per Organizzazione, che si applica alla somma degli elenchi telefonici Enterprise e Group in una singola azienda BroadWorks. Ad esempio, sarà supportato un'azienda BroadWorks che dispone di un elenco di telefoni aziendali con 30K e anche di 5 elenchi di telefoni di gruppo ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K totali).
Questa funzione è disponibile su richiesta. Contatta il team dell'account per abilitare questa opzione.
|
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks nello storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare a quale gruppo appartiene questo utente. L'associazione dell'utente con un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca dei contatti nello storage del gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning degli abbonati Webex per BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
È possibile eseguire il provisioning dell'ID gruppo aziendale BroadWorks per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Webex per gli utenti Cisco BroadWorks
Provisioning API pubblica come "spEnterpriseGroupId"
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
Provisioning flusso o auto-attivazione
L'ID gruppo aziendale BroadWorks verrà automaticamente recuperato da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Non applicabile. Non è necessario sincronizzare l'ID gruppo aziendale BroadWorks per questi utenti.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'ID gruppo aziendale BroadWorks deve essere superato come parametro spEnterpriseGroupId |
Attraverso il flusso | L'ID gruppo aziendale BroadWorks viene recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Non applicabile |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Non applicabile |
Elenchi telefonici BroadWorks | Contatti negli elenchi telefonici del gruppo BroadWorks | Sincronizzazione rubriche | I contatti di gruppo vengono memorizzati nel servizio Webex Contact associato al gruppo specifico |
Elenchi di telefoni BroadWorks Enterpsie o Persional | Contatti negli elenchi telefonici aziendali o personali | Sincronizzazione rubriche | Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. Impossibile completare la migrazione fino a quando QUESTA API non viene completata. L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march Una volta abilitata la funzione e a seguito della sincronizzazione della rubrica successiva, i gruppi di utenti aziendali verranno visualizzati anche in Control Hub. La visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativa in questa fase. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza a un gruppo in Control Hub poiché tali modifiche non verranno riportate nuovamente in BroadWorks. La gestione di gruppo in Control Hub è destinata all'uso da parte dei partner che adotteranno le prossime API di gestione contatti. |
Migrazione e prova del futuro
La progressione Cisco del client di comunicazione unificata BroadSoft deve spostarsi da UC-One a Webex. Si verifica una corrispondente progressione dei servizi di supporto dalla rete del provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che tu stia eseguendo UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita consiste nel distribuire nuovi ADP|XSP dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti in Webex e infine recuperare l'infrastruttura utilizzata per la soluzione precedente.
Sottoscrizioni di documenti consigliate
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Abbonati che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di eseguire l'abbonamento a ciascuno dei seguenti articoli per assicurarsi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per iscriversi, accedere a ciascuno dei link seguenti e nell'articolo che viene visualizzato fare clic sul pulsante Iscriviti.
Come minimo, si consiglia di iscriversi all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati in Documenti aggiuntivi dispone di un'opzione Sottoscrivi . Affinché questa opzione venga visualizzata, l'articolo deve essere visualizzato su help.webex.com.
Non esiste un'opzione di abbonamento per le landing page di documentazione. |
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Documenti Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
Porta la tua soluzione PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono di loro proprietà (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive come eseguire l'onboarding e il servizio dei dispositivi Room OS e MPP.
Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi di Webex per Cisco BroadWorks.
Articoli Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti siti opzionali per ulteriori informazioni su Webex per Cisco BroadWorks:
Documentazione Webex per Cisco BroadWorks: nella pagina di destinazione vengono elencati i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme a quelle presto disponibili.
Problemi noti e limitazioni: informazioni sui problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale: questo articolo descrive come assegnare i ruoli amministratore partner per le organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte della soluzione Cisco BroadWorks:
Articoli della Guida Webex
I seguenti siti della Guida Webex possono essere utilizzati per trovare gli articoli Webex che consentono agli amministratori dei clienti e agli utenti finali di utilizzare le funzioni Webex.
Webex da provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati comunemente per gli utenti dell'app Webex che hanno acquistato i servizi Webex da un provider di servizi.
Centro assistenza Webex: utilizzare la funzione di ricerca su help.webex.com per cercare altri articoli Webex che descrivono la funzionalità dell'app Webex e di Webex Meetings. È possibile ricercare gli articoli utente o amministratore.
Documentazione sviluppatore
Guida per sviluppatori Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Punti di decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastrutture
|
Quanti ADP XSP|? Come prendono l'mTLS? |
Pianificatore capacità di sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento CLI XSP|ADP Il presente documento |
Provisioning cliente e utente | Puoi affermare che ti fidi dei messaggi e-mail in BroadWorks? Vuoi che gli utenti forniscano indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Documenti API pubbliche su https://developer.webex.com Il presente documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo di branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso per i clienti? | Il presente documento |
Funzioni abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o Softphone. | Il presente documento Matrice caratteristiche/pacchetto |
autenticazione protetta | BroadWorks o Webex | Il presente documento |
Adattatore di provisioning (per opzioni di provisioning flowthrough) | Utilizzate già IM&P integrato, ad esempio per UC-One SaaS? Si desidera utilizzare più modelli? È previsto un caso d'uso più comune? |
Il presente documento Riferimento CLI server applicazioni |
Architettura e infrastrutture
Con che tipo di scala intende iniziare? È possibile scalare in futuro, ma la stima di utilizzo attuale dovrebbe guidare la pianificazione dell'infrastruttura.
Collaborare con il proprio account manager/rappresentante di vendita Cisco per dimensionare l'infrastruttura ADP XSP|, in base al Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
In che modo Webex renderà le connessioni TLS reciproche alle tue ADP XSP|? Direttamente a XSP|ADP in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce. (Non supportiamo connessioni TCP non crittografate al perimetro della rete).
Provisioning cliente e utente
Quale metodo di provisioning utente si adatta meglio?
Provisioning eseguibile con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene predisposto automaticamente in Webex.
Se puoi anche affermare che gli indirizzi e-mail dell'abbonato in BroadWorks sono validi e univoci per Webex, puoi utilizzare la variante "email attendibili" del provisioning flowthrough. Gli account Webex abbonati vengono creati e attivati senza il loro intervento; scaricano semplicemente il client e accedono.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto, il provider di servizi deve fornire un indirizzo e-mail valido all'utente per eseguire il provisioning dei servizi Webex. Questo deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo anche nell'attributo ID alternativo.
Provisioning eseguibile senza e-mail attendibili: Se non riesci a fidarti degli indirizzi e-mail degli abbonati, puoi comunque assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
Self-provisioning utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. Tu (o i tuoi clienti) distribuisci invece un collegamento di provisioning e i collegamenti per scaricare i diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare gli account Webex. Quindi, scaricano il client e accedono e Webex recupera una configurazione aggiuntiva su di essi da BroadWorks (inclusi i numeri principali).
Provisioning controllato da SP tramite API: Webex espone una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei propri flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti di sistema generali descritti in questa guida.
Metodo di provisioning | Requisiti |
---|---|
Provisioning del flusso (e-mail attendibili o non attendibili) | L'API di provisioning Webex aggiunge automaticamente gli utenti BroadWorks esistenti a Webex una volta che l'utente soddisfa i requisiti e si attiva il servizio Integrated IM+P. Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Self-provisioning utente | L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato il messaggio e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) | Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono previsti due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, vai a Utenti BroadWorks. |
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Impostazioni internazionali lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente di amministrazione con provisioning viene assegnata automaticamente come locale predefinita per l'organizzazione del cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti a riunioni all'interno dell'organizzazione del cliente.
Sono supportate le impostazioni internazionali in lingua a cinque caratteri (ISO-639-1)_(ISO-3166). Ad esempio, en_US corrisponde a English_UnitedStates. Se viene richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genera un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso internazionale dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, viene utilizzata l'impostazione locale ragionevole predefinita in base al codice della lingua richiesto.
Nella tabella riportata di seguito vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice lingua a due lettere in un'impostazione locale a cinque caratteri per le situazioni in cui un'impostazione locale a cinque caratteri non è disponibile.
Impostazioni internazionali lingua supportate (ISO-639-1)_(ISO-3166) | Se è disponibile solo un codice lingua a due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** | Usa impostazioni internazionali sensibili di default (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA | en en | en_USA |
fr_Fr fr_CA | Fr | fr_Fr |
cs_CZ | cs | cs_CZ |
da_DK | da | da_DK |
de_DE | DE | de_DE |
hu_HU | hu | hu_HU |
id_ID | ID | id_ID |
it_IT | IT | it_IT |
ja_JP | ja | ja_JP |
ko_KR | ko | ko_KR |
es_ES es_CO es_MX | ES | es_ES |
nl_NL | NL | nl_NL |
nb_NO | nb. | nb_NO |
pl_PL. | pl. | pl_PL. |
pt_PT pt_BR | pt | pt_PT |
ru_RU | RU | ru_RU |
ro_RO | ro | ro_RO |
zh_CN zh_TW | zh | zh_CN |
sv_SE | sv | sv_SE |
ar_SA | ar | ar_SA |
tr_TR | tr | tr_TR |
Le impostazioni internazionali es_CO, id_ID, nb_NO e pt_PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti Webex Meetings saranno solo in inglese. Inglese è la impostazioni internazionali predefinite per i siti se per il sito non sono richieste impostazioni internazionali non valide/non supportate. Questo campo lingua è applicabile durante la creazione di un'organizzazione e un sito Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, la lingua del modello verrà utilizzata come lingua predefinita. |
Branding
Gli amministratori partner possono utilizzare le personalizzazioni avanzate del branding per personalizzare l'aspetto dell'app Webex per le organizzazioni di clienti gestite dal partner. Gli amministratori partner possono personalizzare le seguenti impostazioni per garantire che l'app Webex rifletta il marchio e l'identità della società:
Loghi aziendali
Combinazioni di colori univoche per la modalità Chiaro o Scuro
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione delle personalizzazioni di branding avanzate.
|
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding come richiesto, ma quando si esegue l'onboarding di un cliente è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Alcuni parametri del modello principale sono elencati di seguito.
Pacchetto
È necessario selezionare un pacchetto predefinito quando si crea un modello (vedere Pacchetti nella sezione Panoramica per dettagli). Tutti gli utenti predisposti con tale modello, tramite flowthrough o self-provisioning, ricevono il pacchetto predefinito.
È possibile controllare la selezione dei pacchetti per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno di essi. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori di provisioning per azienda, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
È possibile modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedere Webex per la documentazione API Cisco BroadWorks o attraverso Partner Hub (vedere Modifica pacchetto utente in Partner Hub).
Non puoi modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è attivata o disattivata; se all'abbonato viene assegnato questo servizio in BroadWorks, il modello Partner Hub associato all'URL di provisioning aziendale di tale abbonato definisce il pacchetto.
Rivenditore e aziende o fornitore di servizi e gruppi?
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se sei un rivenditore con Enterprise, devi abilitare la modalità Enterprise quando crei un modello.
Se il sistema BroadWorks è configurato in modalità provider di servizi, è possibile lasciare disattivata la modalità Enterprise nei modelli.
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch BroadWorks richieste per il provisioning flow-through. Per ulteriori dettagli, vedere Patch richieste con provisioning flow-through. |
Modalità di autenticazione
Decidi come desideri che gli abbonati eseguano l'autenticazione quando accedono a Webex. È possibile assegnare la modalità utilizzando l'impostazione Modalità di autenticazione nel modello di onboarding. Nella tabella seguente sono riportate alcune opzioni.
Questa impostazione non ha effetto sull'accesso al portale di attivazione utente. Gli utenti che accedono al portale devono immettere l'ID utente e la password BroadWorks, come configurati su BroadWorks, indipendentemente da come si configura la modalità di autenticazione nel modello di onboarding. |
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | ID utente BroadWorks | Indirizzo e-mail |
Provider identità | BroadWorks.
| Identità comune Cisco |
Autenticazione a più fattori? | No | Richiede IdP del cliente che supporta l'autenticazione a più fattori. |
Percorso di convalida delle credenziali
|
|
|
Per una ripartizione più dettagliata del flusso di accesso SSO con autenticazione diretta a BroadWorks, vedere Flusso di accesso SSO. |
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che si può verificare con password che utilizzano caratteri speciali per cui il browser Web non codifica correttamente i caratteri. Utilizzando un'intestazione con codifica UTF-8, con codifica base 64, risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
Paese
Quando si crea un modello, è necessario selezionare un paese. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie S. | Posizione | Prefisso internazionale | Nome paese |
---|---|---|---|
1 | AMER | +1 | NOI, CA |
2 | APAC | +65 | Singapore |
3 | ANZ | +61 | Australia |
4 | EMEA | +44 | Regno Unito |
5 | EURO | +49 | Germania |
Accordi con più partner
Vuoi concedere in sublicenza Webex per Cisco BroadWorks a un altro provider di servizi? In questo caso, ciascun provider di servizi avrà bisogno di un'organizzazione partner distinta in Webex Control Hub per consentire loro di fornire la soluzione per la propria base clienti.
Adattatore di provisioning e modelli
Quando si utilizza il provisioning flowthrough, l'URL di provisioning inserito in BroadWorks viene derivato dal modello in Control Hub. È possibile disporre di più modelli e quindi di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati al momento della concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e quale modello si desidera utilizzare a tale scopo. In questo modo, è necessario impostare esplicitamente l'URL di provisioning per le aziende che necessitano di un modello diverso.
Inoltre, tenere presente che è possibile che si stia già utilizzando un URL di provisioning a livello di sistema, ad esempio con UC-One SaaS. In tal caso, è possibile scegliere di mantenere l'URL a livello di sistema per il provisioning degli utenti su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono dettagliate in Configura server applicazioni con URL servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning flowthrough tra AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server AS e Webex, annullando in tal modo la necessità di connettersi direttamente al servizio Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati che si sta eseguendo il provisioning per Webex devono esistere nel sistema BroadWorks integrato con Webex. È possibile integrare più sistemi BroadWorks, se necessario.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero o interno principale.
Webex utilizza gli indirizzi e-mail come identificatori principali per tutti gli utenti. Se si utilizza il provisioning flowthrough con e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail degli abbonati nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo di utenti di chiamata BroadWorks con un numero principale e/o interno. Se si utilizza il provisioning flowthrough, agli utenti deve essere assegnato anche il servizio IM&P integrato. |
Server nella rete e requisiti software
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Le istanze BroadWorks devono includere almeno i seguenti server:
Server applicazioni (AS) con versione BroadWorks come sopra
Server di rete (NS)
Server profilo (PS)
Server XSP|ADP o piattaforma di distribuzione delle applicazioni (ADP) di fronte al pubblico che soddisfano i seguenti requisiti:
Servizio di autenticazione (BWAuth)
Interfacce azioni ed eventi XSI
DMS (applicazione Web di gestione dispositivi)
Interfaccia CTI (Intergrazione Di Telefonia Informatica)
TLS 1.2 con certificato valido (non autofirmato) e qualsiasi intermediazione richiesta. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
Autenticazione Mutual TLS (mTLS) per il servizio di autenticazione (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Autenticazione Mutual TLS (mTLS) per l'interfaccia CTI (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Un server XSP/ADP separato che agisce come "Call Notifications Push Server" (un NPS nel tuo ambiente utilizzato per le notifiche di chiamata push per Apple/Google. Lo chiamiamo "CNPS" qui per distinguerlo dal servizio in Webex che fornisce notifiche push per messaggi e presenza).
Questo server deve essere su R22 o versione successiva.
Viene richiesto un server XSP/ADP separato per CNPS poiché l'imprevedibilità del carico da Webex per le connessioni cloud BWKS potrebbe influire negativamente sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSPADP, consultare la Guida tecnica di sistema Cisco BroadWorks|.
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, andare a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
PC/laptop Windows
PC/laptop Apple con MacOS
iOS (Apple Store)
Android (Play store)
Browser Web (vai a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (tradizionale cinese)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (italiano)
Telefoni e accessori fisici
Telefoni IP Cisco:
telefono IP Cisco serie 6800 con firmware multipiattaforma
telefono IP Cisco serie 7800 con firmware multipiattaforma
telefono IP Cisco serie 8800 con firmware multipiattaforma
Vedere https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html per i modelli e ulteriori informazioni.
I telefoni di terze parti sono supportati allo stesso modo di altre integrazioni BroadWorks. Tuttavia, non dispongono ancora dell'integrazione di contatti e presenza con Webex per Cisco BroadWorks.
Adattatori:
Adattatore per telefono analogico multipiattaforma Cisco ATA 191
Adattatore per telefono analogico multipiattaforma Cisco ATA 192
Vedere https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html per i modelli e ulteriori informazioni.
Cuffie:
cuffia Cisco serie 500
Vedi https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html per i modelli e ulteriori informazioni.
Dispositivi Room OS:
Serie Webex Room e Room Kit
Serie Webex Desk
Serie Webex Board
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e l'assistenza dei dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivo
Di seguito sono riportati i file DTAF che devi caricare sui server delle applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia c'è una nuova config-wxt.xml.template
file utilizzato per l'app Webex.
Per scaricare i profili dei dispositivi più recenti, andare al sito di Download software della piattaforma di consegna delle applicazioni per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che per XSP.
Nome del cliente | Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Comunicatore aziendale - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili del dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Genera una richiesta di servizio con l'agente di onboarding o con Cisco TAC per eseguire il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il titolo della richiesta per le rispettive funzioni:
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
'NPS Configuration for Auth Proxy Setup' (Configurazione NPS per impostazione proxy automatica) per configurare NPS per l'uso del proxy di autenticazione.
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori informazioni su questa funzione, vedere: Supporto di Cisco BroadWorks per CI UUID.
Configura BroadWorks per abilitare la fatturazione Cisco per BroadWorks e Webex Per abbonamenti BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento valido per 60 giorni. Se il token scade prima di utilizzarlo, è possibile presentare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali. |
Certificati ordine
Requisiti di certificato per l'autenticazione TLS
Per tutte le applicazioni richieste, saranno necessari i certificati di sicurezza, firmati da un'autorità di certificazione ben nota e distribuiti su ADP XSP|pubblico. Verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in entrata ai server XSP|ADP.
Questi certificati devono includere il nome di dominio pubblico XSP|ADP completo come Nome comune oggetto o Nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati del server dipendono da come vengono distribuiti gli ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume dove il certificato del server pubblico firmato da CA deve essere caricato in questi tre casi:

Le autorità di certificazione supportate pubblicamente dall'app Webex per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per proxy bridge TLS
Il certificato del server firmato pubblicamente viene caricato nel proxy.
Il proxy presenta questo certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Un certificato firmato CA interno può essere caricato su XSP|ADP.
L'|ADP XSP presenta questo certificato del server firmato internamente al proxy.
Il proxy si basa sulla CA interna che ha firmato il certificato del server XSP|ADP.
Requisiti di certificato TLS per proxy passthrough TLS o XSP|ADP in DMZ
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
Gli ADP XSP|presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca sull'interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione Mutual TLS. Il certificato CA/catena del certificato del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedi a Partner Hub, vai a
e fai clic sul collegamento del certificato di download.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume i requisiti del certificato in questi tre casi:

Requisiti del certificato (opzione) per proxy bridge TLS
Webex presenta un certificato client firmato pubblicamente al proxy.
Il proxy considera attendibile la CA interna di Cisco che ha firmato il certificato del client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta il certificato del server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions: X509v3 Extended Key Usage: 1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Il CN del certificato interno deve essere
bwcticlient.webex.com
.
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le autorità pubbliche di certificazione potrebbero non essere disposte a firmare i certificati con l'OIDE proprietario di BroadWorks richiesto. In caso di proxy di bridging, è possibile che sia necessario utilizzare una CA interna per firmare il certificato del client che il proxy presenta all'ADP XSP|.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Il ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XSP| dal proxy.
Requisiti di certificato (opzione) per proxy passthrough TLS o XSP|ADP in DMZ
Webex presenta un certificato client firmato da CA Cisco interno alle ADP XSP|.
Gli ADP XSP|si fidano delle autorità di certificazione interne di Cisco che hanno firmato il certificato client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XSP|.
Gli ADP XSP|presentano i certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Il server applicazioni ClientIdentity contiene il CN del certificato del client firmato Cisco presentato a XSP|ADP da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene l'elenco di indirizzi IP, porte e protocolli richiesti per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle dei firewall delle regole di ingresso e uscita precedenti documentano solo le connessioni specifiche di Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico per Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e la rilevanza di ciascuna sezione per Webex per Cisco BroadWorks.
Sezione Requisiti di Rete Art. | Rilevanza delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex | Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud | Informativo |
Da leggere | |
Da leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex | Da leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione | Opzionale |
Servizi Webex per clienti FedRAMP | N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedi il whitepaper del firewall dell'app Webex (PDF).
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza XSP|ADP di Broadworks fornita dal partner. Quando un ADP o un sito XSP|non è disponibile per manutenzione pianificata o motivo non pianificato, i servizi e le app Webex possono passare a un altro ADP o sito XSP|fornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP Broadworks XSP|possono essere distribuiti direttamente su Internet o possono risiedere in un DMZ frontale da un elemento di bilanciamento del carico come F5 BIG-IP. Per fornire ridondanza geografica, gli ADP XSP|possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un bilanciatore di carico, ognuno con un indirizzo IP pubblico. Se gli ADP XSP| sono dietro a un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e Broadworks sembra avere solo un XSP|ADP, anche se vi sono più ADP XSP| dietro.
Nell'esempio seguente, le ADP|XSP vengono distribuite in due siti, il Sito A e il Sito B. Esistono due ADP|XSP frontali di un bilanciatore di carico in ogni sito. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali di LB1 e il sito B ha XSP|ADP3 e XSP|ADP4 frontali di LB2. Solo i bilanciatori di carico sono esposti sulla rete pubblica e le ADP|XSP sono nelle reti private DMZ.

Servizi cloud Webex
Configurazione DNS
I microservizi cloud Webex devono essere in grado di trovare il server|ADP Broadworks XSP per la connessione alle interfacce Xsi, al servizio di autenticazione e al CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host XSP|ADP configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso. Se vengono restituiti più indirizzi IP, viene selezionato il primo IP nell'elenco. La ricerca SRV non è attualmente supportata.
Esempio: Il DNS A Record del partner per la scoperta del server XSP|ADP/Load Balancers bilanciato Round-Robin.
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Punti a LB1 (Sito A) |
R |
|
| Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Failover
Quando i microservizi Webex inviano una richiesta al servizio |di bilanciamento del carico/ADP XSP e la richiesta non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se non viene ricevuta alcuna risposta HTTP entro 2 secondi, la richiesta viene timeout e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento dell'indirizzamento all'IP successivo.
Ciascuna richiesta viene provata 3 volte prima di segnalare un errore al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco degli indirizzi da provare quando si invia una richiesta a un XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna nell'elenco per provare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco bloccato. Se l'operazione va a buon fine, tale indirizzo IP viene rimosso dall'elenco bloccato.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP|XSP o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster BroadWorks Calling, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
Azioni XSI
Eventi XSI
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Gli stati delle connessioni possono essere:
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
Rosso: Quando tutti gli IP nella ricerca di record sono irraggiungibili e l'interfaccia non è disponibile.

I seguenti servizi utilizzano i microservizi per connettersi agli XSP|ADP e sono interessati dalla disponibilità dell'interfaccia XSP|ADP:
Accesso all'app Webex
Aggiornamento token app Webex
E-mail/autoattivazione non attendibile
Controllo stato servizio Broadworks
App Webex
Configurazione DNS
L'app Webex accede ai servizi Xtended Services Interface (XSI-Actions & XSI-Events) e Device Management Service (DMS) su XSP|ADP.
Per trovare il servizio XSI, l'app Webex esegue la ricerca DNS SRV per _xsi-client._tcp.<webex app xsi domain>
. L'SRV punta all'URL configurato per gli host XSP|ADP o i bilanciatori di carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex torna alla ricerca A/AAAA.
L'SRV può risolversi in più target A/AAAA. Tuttavia, ogni record A/AAAA deve mappare solo a un singolo indirizzo IP. Se sono presenti più ADP|XSP in un DMZ dietro il dispositivo di bilanciamento del carico/bordo, è necessario che il bilanciatore di carico sia configurato per mantenere la persistenza della sessione in modo da indirizzare tutte le richieste della stessa sessione allo stesso XSP|ADP. Questa configurazione viene avviata perché i heartbeat dell'evento XSI del client devono andare allo stesso XSP|ADP utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non deve esistere. Se il DNS richiede che un record A/AAAA deve essere definito, allora deve essere restituito solo 1 indirizzo IP. Indipendentemente da ciò, l'SRV deve essere ancora definito per l'app Webex. Se l'app Webex utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client alla fine invia heartbeat a un XSP|ADP dove non ha stabilito un canale per eventi. Di conseguenza, il canale viene strappato e il traffico interno è notevolmente più intenso, il che pregiudica le prestazioni del cluster ADP|XSP. Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca di record A/AAAA, è necessario utilizzare un nome di dominio completo separato per Webex Cloud e l'app Webex per accedere agli ADP|XSP. Come mostrato negli esempi, Webex Cloud utilizza Un record |
Esempio 1: ADP|XSP multipli, ciascuno dietro bilanciatori di carico separati
In questo esempio, SRV punta a disattivare l'audio dei record A con ogni record A che punta a un bilanciatore di carico diverso su un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito un esempio di record SRV.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Esempio 2: più amministratori XSP| dietro un singolo bilanciatore di carico (con bridge TLS)
Per la richiesta iniziale, il bilanciatore di carico seleziona un XSP|ADP casuale. XSP|ADP restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il bilanciatore di carico utilizza il cookie per indirizzare la connessione all'ADP XSP|corretto, assicurandosi che il canale dell'evento non si interrompa.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Bilanciatore di carico |
R | LB.esempio.com |
| Indirizzo IP del bilanciatore di carico (XSP|ADP sono dietro al bilanciatore di carico) |
URL DMS
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il file di configurazione. Viene eseguita l'analisi dell'organizzatore nell'URL e l'app Webex esegue la ricerca DNS A/AAAA dell'organizzatore per connettersi all'ADP XSP|che ospita il servizio DMS.
Esempio: DNS Un record per la scoperta di Round-Robin bilanciato server XSP|ADP/Bilanciamento del carico di Webex App per scaricare i file di configurazione tramite DMS:
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Come l'app Webex trova gli indirizzi XSP|ADP
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (sono stati inseriti quando si crea il cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue la ricerca SRV nel modo seguente:
Il cliente esegue una ricerca SRV per _xsi-cliente._tcp.<xsi domain="">
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
Il cliente cerca gli obiettivi A/AAAA e memorizza nella cache gli indirizzi IP restituiti.
Il client si connette a uno dei target (e quindi al suo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi al peso (o a caso se sono tutti uguali).
Se la ricerca SRV non restituisce alcun obiettivo:
Il client esegue una ricerca A/AAAA del parametro principale Xsi e quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso.
Come indicato, il record A/AAAA deve risolversi in un indirizzo IP per le stesse ragioni.
(Opzionale) Successivamente, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocols> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
Se esistono, il client confronterà l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
Se viene rilevata una differenza, il client re-inizializzerà la connettività XSI Actions/XSI Events. La prima fase consiste nell'eseguire lo stesso processo di ricerca DNS elencato nella fase 1, richiedendo questa volta una ricerca del valore nel %XSI_ROOT_WXT% parametro dal file di configurazione.
Assicurarsi di creare i record SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
Failover
Durante l'accesso, l'app Webex esegue una ricerca DNS SRV per _xsi-client._tcp.<xsi domain="">, crea un elenco di organizzatori e si connette a uno degli organizzatori in base alla priorità SRV, quindi al peso. Questo organizzatore connesso diventa quello selezionato per tutte le richieste future. Viene quindi aperto un canale evento all'organizzatore selezionato e viene inviato regolarmente un heartbeat per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP, pertanto è importante che il bilanciatore di carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server XSP|ADP di backend.
Se una richiesta o una richiesta heartbeat a un organizzatore non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), l'indirizzamento dell'app Webex viene eseguito immediatamente all'organizzatore successivo nell'elenco.
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e l'indirizzamento passa all'organizzatore successivo nell'elenco.
Se una risposta non viene ricevuta entro un periodo di tempo, la richiesta viene considerata non riuscita a causa del timeout e le richieste successive vengono inviate al successivo organizzatore. Tuttavia, la richiesta scaduta viene considerata come non riuscita. Alcune richieste vengono riprovate dopo l'errore (con un tempo di riprova crescente). Le richieste che il presunto non vitale non sono riprovate.
Quando un nuovo organizzatore viene provato correttamente, diventa il nuovo organizzatore selezionato se l'organizzatore è presente nell'elenco. Una volta provato l'ultimo organizzatore nell'elenco, l'app Webex passa al primo.
In caso di heartbeat, se si verificano due errori di richiesta consecutivi, l'app Webex re-inizializzerà il canale eventi.
Tenere presente che l'app Webex non esegue il failback e che il rilevamento del servizio DNS viene eseguito solo una volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione attraverso l'interfaccia XSP|ADP/Dms. Esegue una ricerca di record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Innanzitutto, tenterà di inviare la richiesta per scaricare il file di configurazione utilizzando un token SSO. Se ciò non riesce per qualsiasi motivo, verrà riprovato ma con il nome utente e la password del dispositivo.
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning dell'utente. Molte delle attività sono comuni a tutte le modalità di provisioning.



Onboarding dei partner per Webex per Cisco BroadWorks
Ciascun provider o rivenditore di servizi Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, è necessario eseguire la documentazione Cisco BroadWorks di Webex e i nuovi partner devono accettare l'ICPA (Indirect Channel Partner Agreement) online. Al termine di queste operazioni, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, il tuo Partner Activation e/o Customer Success Program Manager ti contatterà per iniziare il tuo onboarding.
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
È necessario eseguire l'applicazione NPS su un altro XSP|ADP. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi sugli ADP XSP|.
Servizio/Applicazione | Autenticazione richiesta | Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
autenticazione protetta |
Integrazione telefonia computer |
mTLS (client e server si autenticano a vicenda) |
Presenza di telefonia |
Applicazione Webview Impostazioni chiamata |
TLS (il server esegue l'autenticazione per i client) |
Mostra le impostazioni di chiamata utente nel portale Assistenza utente all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma occorre fare riferimento alla documentazione esistente per installare le applicazioni sugli ADP|XSP.
Requisiti di coresidenza
Il servizio di autenticazione deve essere coresidente con le applicazioni Xsi, perché tali interfacce devono accettare token di lunga durata per l'autorizzazione del servizio. Il servizio di autenticazione è richiesto per convalidare tali token.
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
È possibile separare gli altri servizi/applicazioni come richiesto per la propria bilancia (gestione dispositivi dedicata XSP|ADP farm, ad esempio).
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
Non installare altre applicazioni o servizi sugli ADP XSP| utilizzati per integrare BroadWorks con Webex.
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se è in esecuzione R22 o versione superiore e il sistema lo supporta.
Mutual TLS (mTLS) è supportato anche come metodo di autenticazione alternativo per il servizio Auth. Se più organizzazioni Webex eseguono lo stesso server ADP XSP|, è necessario utilizzare l'autenticazione mTLS poiché la convalida token CI non supporta più connessioni allo stesso servizio autenticazione ADP XSP|. Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida del token CI, fare riferimento all'Appendice per configurare i servizi (con mTLS per il servizio di autenticazione). |
Se attualmente si utilizza mTLS per il servizio autenticazione, non è obbligatorio riconfigurare l'uso della convalida token CI con TLS. |
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks.
Installare le seguenti patch su ciascun server ADP XSP|. Installare le patch appropriate alla release in uso:
Per R22:
Per R23:
Per R24: non è necessario alcun cerotto
Qualsiasi riferimento a XSP include XSP o ADP.Installare il
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP al percorso del contesto /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire il servizio di autenticazione su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
A partire da Broadworks build 2022.10, le autorità di certificazione in arrivo con Java non vengono più automaticamente incluse nel trust store BroadWorks quando si passa a una nuova versione di java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
Radice commerciale IdenTrust CA 1
autorità di certificazione radice Go Daddy - G2
Verificare che questi certificati siano presenti sotto la seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get
Se non presente, eseguire il seguente comando per importare i trust Java predefiniti:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come ancoraggi attendibili con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono automaticamente importate nella nuova release e continueranno a essere importate finché non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere la FD di convalida del certificato Cisco Broadworks X509.
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server ADP XSP|:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get
set clientId client-Id-From-Step1
set enabled true
set clientSecret client-Secret-From-Step1
set ciResponseBodyMaxSizeInBytes 65536
set issuerName <URL>
- Per ilURL
, immettere l'URL IssuerName che si applica al cluster CI. Vedere la tabella seguente.set issuerUrl <URL>
- Per ilURL
, immettere l'IssuerUrl che si applica al cluster CI. Vedere la tabella seguente.set tokenInfoUrl <IdPProxy URL>
—Inserire l'URL proxy IdP applicabile al cluster dei team. Si veda la seconda tabella che segue.
Tabella 1. Imposta nome emittente e URL emittente Se il cluster CI è... Imposta issuerName e issuerURL su... NOI-A
UE
NOI-B
Se non conosci il tuo cluster CI, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.Tabella 2. Imposta tokenInfoURL Se il cluster di Teams è... Imposta tokenInfoURL su...(URL proxy IdP) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AFRA
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
DOLORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.
Per il test, è possibile verificare che il tokenInfoURL sia valido sostituendo "
idp/authenticate
" parte dell'URL con "ping
".
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user
Configurare i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get
set flsUrl https://cifls.webex.com/federation
set refreshPeriodInMinutes 60
set refreshToken refresh-Token-From-Step1
Eseguire il seguente comando per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get
Configurare la gestione dei token utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
set tokenIssuer BroadWorks
set tokenDurationInHours 720
Genera e condividi chiavi RSA. È necessario generare chiavi su un XSP|ADP, quindi copiarle su tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP.Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web. Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token. Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Rimozione dei requisiti di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con la convalida del token CI su R24, è necessario rimuovere anche il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get

Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Interfaccia CTI e configurazione correlata

Di seguito viene elencato l'ordine di configurazione "da più a più". In seguito a questo ordine non è obbligatorio.
Configurazione del server di applicazione per gli abbonamenti CTI
Configurazione di XSP|ADPs per abbonamenti CTI autenticati mTLS
Apertura delle porte in entrata per l'interfaccia CTI protetta
Abbonamento dell'organizzazione Webex agli eventi CTI di BroadWorks
Configurazione del server di applicazione per gli abbonamenti CTI
Aggiornare ClientIdentity su Application Server con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ciascun server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è |
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocol> |
Una specifica interfaccia CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocol> |
Su una nuova installazione, le seguenti crittografie sono installate per impostazione predefinita a livello di sistema. Se non è configurato nulla a livello di interfaccia (ad esempio, nell'interfaccia CTI o HTTP), si applica questo elenco di crittografia. Si noti che questo elenco può cambiare nel tempo:
|
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp>
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
Inserisci il
get
comando per visualizzare le crittografie già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, si utilizzerebbe:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Ancoraggi affidabili per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che le ADP XSP|siano rivolte verso Internet o rivolte verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy bridge (vedere Requisiti del certificato TLS per proxy bridge TLS).
Per ogni amministratore XSP|nell'infrastruttura che pubblica eventi CTI in Webex, effettuare le seguenti operazioni:
Accedere a Hub partner .
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.
Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
(Opzionale) Esecuzione
help updateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot2023
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
Consenti ai client di autenticarsi con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione BroadWorks in uso. Il comando crea un certificato server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. È necessario l'indirizzo IP dell'interfaccia CTI per questo; è possibile leggerlo dal seguente contesto:
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>
Riavviare XSP|ADP.
Abilitazione dell'accesso a BroadWorks CTI Events su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
Specificare l'indirizzo CTI in base al quale Webex può iscriversi a CTI Events di BroadWorks.
Gli abbonamenti CTI sono su base per abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato viene predisposto per Webex per Cisco BroadWorks.
Visualizzazione Webview Impostazioni chiamata
Call Settings Webview (CSWV) è un'applicazione ospitata su XSP|ADP per consentire agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview per le impostazioni di chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono native dell'app Webex.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, è necessario distribuire la funzione Webview impostazioni chiamata.
La vista Webview impostazioni chiamata presenta due componenti:
Applicazione Webview Impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
App Webex, che esegue il rendering delle impostazioni di chiamata in una vista Webview.
Esperienza utente
Utenti Windows: Fai clic su Impostazioni chiamata, quindi su .
Utenti Mac: Fare clic sull'immagine del profilo, quindi
.
Distribuzione di CSWV su BroadWorks
Installazione di Webview impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso ADP|XSP che ospita l'interfaccia Xsi-Actions nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
Accedere a cisco.com e cercare "BWCallSettingsWeb" nella sezione download software.
Trovare e scaricare la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) è stata la più recente al momento della stesura del presente documento.Installare, attivare e distribuire l'archivio Web in base alla Guida alla configurazione della piattaforma di servizi Xtended di Cisco BroadWorks per la versione XSP|ADP. (Versione R24 https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
.Passare al seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più necessario).Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario fornire anche un contextPath perché è un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio
/callsettings
.Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
Ora è possibile prevedere l'URL delle impostazioni di chiamata che si specificherà per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
L'|ADP-FQDN XSP deve corrispondere al FQDN azioni Xsi, perché CSWV deve utilizzare le azioni Xsi e CORS non è supportato.
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview Impostazioni chiamata è ora attiva sugli ADP|XSP.
Configura l'app Webex per utilizzare Webview impostazioni chiamata
Per ulteriori dettagli sulla configurazione del client, vedere la Guida alla configurazione di Webex per Cisco BroadWorks.
Nel file di configurazione dell'app Webex è presente un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti attraverso l'interfaccia dell'applicazione.
<config>
<services>
<web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%">
<url>%WEB_CALL_SETTINGS_URL_WXT%</url>
</web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel %WEB_CALL_SETTINGS_URL_WXT% tag.
Se non si specifica esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
Imposta la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
Il file di configurazione client risultante dovrebbe avere una voce come segue:
<web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push delle chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Call Notifications Push Server (CNPS) per descrivere un'applicazione ospitata XSP o ospitata ADP che viene eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti e invia le notifiche a Google Firebase Cloud Messaging (FCM) o Apple Push Notification Service (APN).
Tali servizi notificano ai dispositivi mobili degli abbonati Webex per Cisco BroadWorks la presenza di chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzione Notification Push Server.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi a loro volta notificano agli utenti mobili Webex le modifiche ai messaggi in arrivo o alla presenza.
In questa sezione viene descritto come configurare l'NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se è necessario eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPShttps://help.webex.com/nl5rir2/. |
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario aggiornare il CNPS per supportare la funzione proxy NPS, server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server di notifica push per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e i tasti di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend di Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APN Apple e i servizi FCM Google.
La funzione migliora anche la capacità del server push delle notifiche di eseguire notifiche push ai dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
Per ulteriori informazioni, vedere Server push per VoIP nella descrizione della funzione UCaaS.
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software e le patch NPS, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Cercare e scaricare la patch dalla pagina di download del software.
Ulteriori informazioni sul server ADP sono disponibili su https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio Apple Push Notification dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per APN. Questo aggiornamento richiede che XSP|ADP che ospita l'NPS esegua R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 | Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma di consegna dell'applicazione (ADP). | ||
2 | Installare le patch proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: | ||
3 | Attivare l'applicazione Notification Push Server. | ||
4 | (Per le notifiche Android) Abilitare l'API FCM v1 sull'NPS.
| ||
5 | (Per le notifiche Apple iOS) Abilitare HTTP/2 su NPS.
| ||
6 | Collegare un supporto tecnico dell'NPS XSP/ADP. | ||
7 | Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN UN 10.193.78.149
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configura NPS per utilizzare il proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Migra NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un server NPS condiviso con altre app mobili, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPS ( https://help.webex.com/nl5rir2).
1 | Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 | Creare l'account cliente su NPS:
Per verificare che i valori inseriti corrispondano a quanto ricevuto, eseguire
| |||||||||||||||||||
3 | Immettere l'URL proxy NPS e impostare l'intervallo di aggiornamento del token (consigliato 30 minuti):
| |||||||||||||||||||
4 | (Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 | (Per le notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, assicurandosi di omettere il tasto Auth – impostarlo su vuoto.
| |||||||||||||||||||
6 | Configurare i seguenti URL NPS:
| |||||||||||||||||||
7 | Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 | Verificare se il server applicazioni sta eseguendo lo screening degli ID applicazione, poiché potrebbe essere necessario aggiungere le app Webex all'elenco utenti autorizzati: | |||||||||||||||||||
9 | Riavviare XSP|ADP: | |||||||||||||||||||
10 | Esegui test delle notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migrazione di NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente che è necessario eseguire la migrazione a FCMv1. Sono previste tre procedure:
Esegui migrazione dei client UC-One a FCMv1: quando disponi di client UCaaS esistenti e devi migrarli per utilizzare FCMv1.
Migrazione dei client SaaS a FCMv1: quando si dispone di client SaaS esistenti e occorre migrarli per utilizzare FCMv1.
Aggiorna server ADP: quando si esegue la migrazione di NPS a un server ADP.
Migrazione dei client UC-One a FCMv1
Utilizzare la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere . L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile Connect su https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al
|
Accedere a SDK amministratore FCM su http://console.firebase.google.com.
Selezionare l'applicazione Android appropriata.
Nella scheda General (Generale), registrare l’ID del progetto
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
Fare clic sul pulsante blu per creare un nuovo account di servizio
Fai clic sul pulsante blu per generare una nuova chiave privata
Chiave di download per una posizione sicura
Per riutilizzare un account servizio esistente:
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
Identificare l'account servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
Copiare il file json su XSP|ADP.
Configurare l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== my_project ********
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Migrazione dei clienti SaaS a FCMv1
Se si desidera eseguire la migrazione dei client SaaS a FCMv1, attenersi alla procedura seguente su Google FCM Console.
Assicurarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione". |
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Aggiorna server ADP
Se si esegue la migrazione dell'NPS per utilizzare un server ADP, utilizzare i passaggi seguenti nella console Google FCM.
Ottenere il file JSON dalla console cloud di Google:
Su Google Cloud Console, andare alla pagina Account servizio.
Fare clic su Seleziona un progetto, scegliere il progetto e fare clic su Apri.
Trova la riga dell'account servizio per la quale desideri creare una chiave, fai clic sul pulsante Altro verticale, quindi fai clic su Crea chiave.
Selezionare un tipo di chiave e fare clic su Crea
Il file viene scaricato.
Aggiungere FCM al server ADP:
Importare il file JSON nel server ADP utilizzando il
/bw/install
comando.Accedere all'ADP CLI e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON
:Quindi, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò avviene per i seguenti motivi:
Per consentire a Webex cloud di autenticare i tuoi utenti rispetto a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
Per consentire alle app Webex di utilizzare l'interfaccia Xsi per il controllo delle chiamate.
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se alcune interfacce non vengono convalidate correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide. Ciò viene impedito poiché un cluster configurato in modo errato potrebbe causare problemi che sono difficili da risolvere. |
Cosa è necessario fare:
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
Assegna un nome al cluster e fai clic su Avanti.
Il concetto di cluster qui è semplicemente una raccolta di interfacce, solitamente situate su un server ADP XSP| o in un'azienda agricola, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il sistema BroadWorks non sono applicabili qui.
(Opzionale) Immettere un Nome account utente e una Password BroadWorks noti all'interno del sistema BroadWorks che si connette a Webex, quindi fare clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
Aggiungere gli URL XSI Actions e XSI Events.
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
Opzionale. Selezionare la casella di controllo Abilita autenticazione diretta BroadWorks se si desidera che gli accessi a BroadWorks siano diretti a BroadWorks. In caso contrario, l'autenticazione per BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo influisce su queste situazioni di accesso:
Accesso al portale di attivazione utente: gli utenti devono immettere le credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o attraverso il proxy IdP.
Accesso client: se l'autenticazione BroadWorks è configurata nel modello di onboarding, l'impostazione precedente determina se l'accesso del client all'app Webex è diretto a BroadWorks o viene proxy attraverso il proxy IdP.
Fai clic su Avanti.
Nella pagina CTI Interface (Interfaccia CTI) procedere come segue:
Aggiungere l'URL CTI e la porta per l'interfaccia CTI a cui si desidera connettersi.
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
Opzionale. Abilita il tasto di alternanza Non disturbare (NoDist) e inserisci l'ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurandosi che la funzione funzioni allo stesso modo su entrambe le piattaforme.
Fai clic su Avanti.
Aggiungere l'URL del servizio di autenticazione.
Selezionare Servizio autenticazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex poiché il servizio di autenticazione convalida correttamente il token utente rispetto al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
Controllare le voci sulla schermata finale, quindi fare clic su Crea. Dovrebbe essere visualizzato un messaggio di successo.
Partner Hub passa gli URL a vari microservizi Webex che testano le connessioni alle interfacce fornite.
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è riuscita.
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Abbiamo implementato questa verifica per prevenire errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, caricatore di bilanciamento o firewall) come illustrato in questa guida, prima di salvare il modello.
Verifica delle connessioni alle interfacce BroadWorks
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Visualizza cluster.
Partner Hub avvia i test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina dell'elenco dei cluster mostra il messaggio di stato accanto a ciascun cluster.
I messaggi verdi relativi al successo dovrebbero essere visualizzati. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio XSI-Actions, XSI-Events, DAS URL e le impostazioni dell'interfaccia CTI.
Configurazione dei modelli di onboarding
I modelli di onboarding sono il modo in cui verrà applicata la configurazione condivisa a uno o più clienti man mano che vengono caricati tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma solo un modello può essere associato a un cliente.
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Aggiungi modello.
In questo modo viene avviata una procedura guidata in cui è possibile fornire la configurazione per i clienti che utilizzeranno questo modello.
Utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
Immettere un Nome modello, quindi fare clic su Avanti.
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per diverse modalità di provisioning Nome impostazione
Provisioning fluviale con e-mail attendibili
Provisioning flowthrough senza e-mail
Self-provisioning utente
Abilita flusso BroadWorks attraverso il provisioning (include le credenziali dell'account di provisioning se attivato**)
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il †
Il †
Il †
Indirizzo e-mail provider servizi
Selezionare un indirizzo e-mail dall'elenco a discesa (è possibile digitare alcuni caratteri per trovare l'indirizzo, se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello di onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature tra paese e regione in questo foglio di calcolo.
Il paese dell'organizzazione determina i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni consultare la sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questo interruttore spento.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note dalla tabella:
† Questo passaggio garantisce che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa opzione deve essere sempre attiva, a meno che non si utilizzi un processo manuale di ordinazione ed esecuzione (tramite Cisco Commerce Workspace) per creare le organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello di "provisioning ibrido" e non rientra nel campo di applicazione di questo documento.
** "Account di provisioning" si riferisce all'account di amministrazione a livello di sistema BroadWorks. Su BroadWorks, è necessario un account amministratore con questi attributi: Tipo amministratore=Provisioning, sola lettura=Disattivato.
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
Opzionale. Selezionare Disabilita chiamata gratuita Cisco Webex se si desidera disabilitare le chiamate Webex.
Per la configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
Numeri di chiamata in ingresso Cisco (PSTN)
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
Fai clic su Avanti.
Esistono due approcci per il provisioning degli abbonati relativamente a come vengono verificate le relative identità, utilizzando e-mail attendibili o e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile, gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. In qualità di partner, sei responsabile del provisioning dell'indirizzo e-mail come parte del metodo flow-through o API.
Si consiglia vivamente di utilizzare il metodo di provisioning attendibile poiché garantisce che tutti gli abbonati siano completamente predisposti dall'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso e-mail non attendibile, gli utenti devono verificare i relativi messaggi e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome impostazione
Provisioning flowthrough senza e-mail
Self-provisioning utente
Esegui prima provisioning amministratore
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
Note dalla tabella:
* Ciascuna organizzazione cliente in Webex deve disporre di almeno un utente con ruolo di amministratore. Il primo utente a cui assegnare IM&P integrato in BroadWorks assume il ruolo di amministratore del cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di fornitore di servizi è possibile avere il controllo su chi ottiene il ruolo. La verifica di questa impostazione impedisce agli utenti di completare l'attivazione fino a quando non viene attivato il primo utente fornito. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
Fai clic su Avanti.
Selezionare la modalità di autenticazione predefinita (autenticazione BroadWorks o autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.(Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
Fai clic su Avanti.
Per Preferenze, configurare quanto segue:
Scegliere se si desidera Precompilare gli indirizzi e-mail utente nella pagina di accesso.
Utilizzare questa opzione solo dopo aver selezionato Autenticazione BroadWorks e aver anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il nome utente BroadWorks. La pagina di accesso offre l'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
Se desideri abilitare la sincronizzazione delle rubriche, imposta l'opzione Abilita sincronizzazione rubrica telefonica per tutte le nuove organizzazioni clienti per attivare.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
Immettere un amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatico di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
Assicurati che l'opzione Consenti invito e-mail amministratore quando ti colleghi a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
Fai clic su Avanti.
Esaminare le voci nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Dovrebbe essere visualizzato un messaggio di successo.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con altri modelli.
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario immettere nuovamente i dettagli dell'account di provisioning. I campi Password vuota/Conferma password sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori forniti alla procedura guidata.
Aggiungi altri modelli se disponi di diverse configurazioni condivise che desideri fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbe essere necessario specificare i dettagli del modello per una delle attività seguenti.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning. |
Patch Application Server (solo R22, R23 e R24)
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
Per R22:
AP.as.22.0.1123.ap373197
Per R23:
AP.as.23.0.1075.ap373197
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che costituiscono il requisito per la distribuzione di Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.Modifica della
Maintenance/ContainerOptions
contesto.Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true
Scarica gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interfaccia > Messaggistica e Servizio > IM&P integrato) dei comandi AS.
Accedi a Partner Hub e vai a
.Fare clic su Visualizza modelli.
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro flyout a destra. Se non è stato ancora creato un modello, è necessario farlo prima di poter ottenere l'URL di provisioning.
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per altri modelli se si dispone di più modelli.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema su server applicazioni
Se si utilizza UC-One SaaS, potrebbe non essere necessario impostare il provisioning e il dominio del servizio a livello di sistema. Vedere i Punti di decisione nella sezione Preparazione dell’ambiente. |
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password
AS_CLI/Interface/Messaging> set enableSynchronization true
Attivare l'interfaccia IMP integrata:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
È necessario inserire il nome completo per il |
(Opzione) Configurazione dei parametri di provisioning per azienda su server applicazioni
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
Selezionare Usa dominio di servizio e immettere un valore fittizio (Webex ignora questo parametro). È possibile utilizzare
example.com
).Selezionare Usa server di messaggistica.
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
È necessario inserire il nome completo per il
provisioningURL
parametro, come è stato dato in Partner Hub. Se il server applicazioni non può accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel/etc/hosts
file su AS.Nel campo Nome utente, immettere un nome per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Immettere una password per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Per Identità utente predefinita per ID IM&P, selezionare Principale.
Fare clic su Applica.
Ripeti per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning utente, vedi Provisioning utente provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning aiuta amministratori e team di vendita controllando la presenza di errori prima di eseguire il provisioning di un cliente o abbonato per un pacchetto. Gli utenti o le integrazioni autorizzati da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per assicurarsi che non vi siano conflitti o errori con il provisioning del pacchetto per un determinato cliente o abbonato.
L'API verifica se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto a un cliente o partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, è possibile correggere gli errori prima del provisioning, aumentando la probabilità di un provisioning riuscito.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore Webex per la vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare di un provisioning abbonato all'ingrosso
Per accedere a Precontrolla un documento di provisioning abbonato Wholesale, devi accedere al portale https://developer.webex.com/. |
Partner SSO - SAML
Consente agli amministratori dei partner di configurare l'SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La seguente procedura SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere la funzionalità SSO del partner a un'organizzazione cliente esistente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso. Per aggiungere SSO partner a un'organizzazione esistente, è necessario aprire un ticket con Cisco TAC. |
Verificare che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'integrazione Single Sign-On in Control Hub.
Aprire una richiesta di servizio con Cisco TAC. TAC deve stabilire una relazione di trust tra il provider di identità di terze parti e il servizio Cisco Common Identity. .
Se l'IdP richiedepassEmailInRequest
da abilitare, accertarsi di includere questo requisito nella richiesta di servizio. Controlla con il tuo IdP se non sei sicuro che questa funzione sia necessaria.Carica il file di metadati CI fornito da TAC al provider di identità.
Configurare un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, immettere l'ID entità dall'XML metadati SAML del provider di identità di terze parti.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
Proprio che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori dei partner di configurare l'SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per impostare SSO OIDC partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già caricate utilizzando il modello. Per aggiungere il Partner SSO a un'organizzazione di clienti esistente, è necessario aprire un ticket con Cisco TAC. |
Aprire una richiesta di servizio con il centro TAC di Cisco con i dettagli dell'IDP di connessione OpenID. Sono obbligatori e facoltativi gli attributi IDP. TAC deve impostare l'IDP sul CI e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC, potrebbe consistere in lettere, numeri, trattini, sottolineature, inclinazioni e punti e la lunghezza massima è 128 caratteri.
Id client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Segreto client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco degli ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio, ad esempio "profilo e-mail openid" Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non fornito
URL dell'endpoint di autorizzazione OAuth 2.0 dell'IdP.
endpoint token
Sì se discoveryEndpoint non fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
endpoint infoutente
No
URL dell'endpoint UserInfo di IdP.
Endpoint set di tasti
No
URL dell'endpoint JSON Web Key Set dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
Configurare l'URI di reindirizzamento sull'IDP di connessione OpenID.
Configurare un modello di onboarding. Per l'impostazione della modalità di autenticazione, selezionare Autenticazione partner Con OpenID Connect e immettere il nome IDP fornito durante l'impostazione IDP come ID entità IDP OpenID Connect.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui registrazione chiamata, risposta per assente di gruppo, dirigente e assistente di direzione.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
Eseguire i seguenti comandi sulle interfacce AS. Ciò consentirà all’AS di inviare il c.d.
X-BroadWorks-Correlation-Info
Intestazione SIP:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true
Il
enableCallCorrelationID
Il parametro associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione delle informazioni di correlazione delle chiamate nei registri Xsi-Actions. Si raccomanda di avereenableCallCorrelationID
abilitato utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione dell'identificativo di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione della rubrica garantisce che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la directory di chiamata completa dal server BroadWorks viene sincronizzata con la directory Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione rubriche, vai a Sincronizzazione rubriche in Webex per Cisco BroadWorks.
Webex per Cisco BroadWorks flowthrough provisioning aggiunge utenti di messaggistica e informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, gli elenchi telefonici, gli utenti non di messaggistica e le entità non utenti non sono inclusi (ad esempio, un telefono della sala conferenze, un fax o un numero di gruppo di risposta). L'attivazione della sincronizzazione delle rubriche garantisce che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex. |
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia chiamate e riunioni unificate Webex visualizzata sull'app Webex. Gli utenti possono visualizzare la cronologia dettagliata delle chiamate e della riunione dall'app Webex.
La cronologia chiamate unificata può essere abilitata dagli amministratori a livello di partner in Partner Hub su base cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
Eventi cronologia chiamate: questi eventi vengono utilizzati per creare una cronologia chiamate unificata dettagliata
Eventi di stato hook: la cronologia chiamate unificata include ottimizzazioni dello stato hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di Telephony Presence
Requisiti della cronologia chiamate unificata
Prima di configurare la cronologia chiamate unificata, accertarsi di aver eseguito la patch del sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
AP.as.22.0.1123.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per R23:
AP.as.23.0.1075.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Se si utilizza XSP—
AP.xsp.23.0.1075.ap378585
In caso di utilizzo di ADP
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
AP.as.24.0.944.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per l'elenco completo delle patch BroadWorks che è necessario installare come prerequisito per l'esecuzione di Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella sezione Riferimento. |
Oltre alla patch del sistema, il file di configurazione del client ( config-wxt.xml
) deve avere il seguente set di tag: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altro reindirizzamento nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
AP.as.23.0.1075.ap383346
AP.as.23.0.1075.ap383994
Per R24:
AP.as.24.0.944.ap383346
AP.as.24.0.944.ap383994
Per avere informazioni Dirigente-Assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
AP.as.24.0.944.ap380052
AP.as.24.0.944.ap384239
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare anche la sincronizzazione delle rubriche per la cronologia chiamate unificata dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione NoDist, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti nel cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione di Broadworks durante la stessa finestra di manutenzione. |
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configura organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettuare le seguenti operazioni:
Accedi a Partner Hub su
admin.webex.com
.Andare a Impostazioni e selezionare un cluster esistente.
Verificare che la connessione al cluster sia buona. Nel pannello a destra viene visualizzato un segno di spunta verde con Connection stabilita.
Se questa opzione non viene visualizzata, in Check Connnections (Opzionale), immettere BroadWorks User Id e BroadWorks Password e fare clic su Check per verificare che la connessione sia corretta.
Selezionare la casella di controllo Abilita cronologia chiamate.
Fai clic su Salva.
Interazioni funzione
Per la cronologia chiamate unificata sono presenti le seguenti interazioni delle funzioni:
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando questa situazione esiste, gli eventi Cronologia chiamate e Stato hook non vengono inviati all'app Webex.
La cronologia chiamate unificate non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia chiamate unificata dall'app Webex. Per informazioni dettagliate, vedere: Webex | visualizza cronologia chiamate e riunioni.
Disabilita cronologia chiamate unificata
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visivo
L'app Webex supporta un'indicazione visiva delle chiamate spam nel avviso popup quando la chiamata viene presentata al destinatario e nei record della cronologia delle chiamate unificate quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per utilizzare questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- Le seguenti patch devono essere installate e attive:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o AS-25_Rel_2022.12 come minimo
- La funzione deve essere attivata tramite AS CLI:
- AS_CLI/System/ActivatableFeature> attivare 104112
- AS_CLI/System/StirShaken> imposta enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'etichettatura e la verifica STIR-SHAKEN come descritto in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste di invito inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti che vengono inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione di spam visivo nella presentazione della chiamata e nella cronologia chiamate unificata della chiamata.
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenta di identificare il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra di chiamata e una volta completata la chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante abbinando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se trova più istanze di un numero in un'origine, non tenterà di sceglierne una, in questo caso, non visualizzerà alcun ID chiamante. |
Webex Common Identity (CI) che contiene gli utenti della tua organizzazione.
Contatti personali e aziendali. I contatti personali sono visibili nella scheda Contatti.
Rubrica locale. In Windows - applicazione Outlook, in Mac - Contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non viene trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, utilizzerà la parte del nome utente dell'URI SIP dall'intestazione SIP From come ultima risorsa.
Per il controllo delle chiamate remote (ad esempio, modalità di controllo del telefono fisso) vengono utilizzate informazioni XSI, dove viene utilizzato ID BWKS o interno, estratte da informazioni di parte remota nell'evento XSI. Se l'informazione della parte remota non è disponibile, verrà utilizzata P-Asserted Identity (PAI) (se configurata).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica di chiamata e nella cronologia chiamate.
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
Coda Call Center: Visualizza il nome della coda che ha inoltrato la chiamata.
Dirigente-Assistente: Mostra il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
Per le chiamate nella coda chiamate interna, in cui un agente richiama una parte interna, la parte remota non visualizzerà il nome della coda chiamata, ma il nome dell'agente che le chiama.
Chiamata con risposta altrove:
Per gruppi di risposta o code chiamate impostate con indirizzamento simultaneo, gli agenti visualizzeranno una chiamata che ha ricevuto risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di risposta o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate perse nella cronologia chiamate se risposte da un altro agente.
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni da tavolo. Questa funzione specifica consente di assegnare gli indicatori di linea condivisa all'app Webex dell'utente finale.
Questa funzione consente agli utenti di gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente alle linee condivise.
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise dal client Webex
R23 senza ADP:
AP.as.23.0.1075.ap384179
AP.xsp.23.0.1075.ap384179
R23 con ADP:
AP.as.23.0.1075.ap384179
Xsi-Actions-23_2022.10
R24:
IN QUANTO: AP.as.24.0.944.ap384179
Xsi-Actions-24_2022.10
R25:
IN QUANTO: Versione RI Rel_2022.10_1.310
Xsi-Actions-25_2022.10
Cerotto 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo (in questo caso per il client desktop: Business Communicator).
Versione RI Rel_2022.10_1.310
Sincronizzazione Non disturbare (NoDist).
La sincronizzazione Non disturbare (NoDist) allinea le impostazioni NoDist tra Webex e BroadWorks sincronizzando lo stato NoDist tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato si sincronizza con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. Analogamente, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist da una piattaforma non vengono riconosciuti dall'altra piattaforma.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Prerequisiti
Assicurarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione BroadWorks.
Per la versione 22:
Cerotto AS: AP.as.22.0.1123.ap382615, AP.as.22.0.1123.ap382838
Patch XSP|ADP: AP.xsp.22.0.1123.ap382615, AP.xsp.22.0.1123.ap382838
Per la versione 23:
Cerotto AS: AP.as.23.0.1075.ap382615, AP.as.23.0.1075.ap382838
Patch XSP|ADP: AP.xsp.23.0.1075.ap382615, AP.xsp.23.0.1075.ap382838
App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
Cerotto AS: AP.as.24.0.944.ap382615, AP.as.24.0.944.ap382838
App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 su AS:
AS_CLI/System/ActivatableFeature> activate 25433
Configura sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto di eventi "as-feature-event". Per informazioni dettagliate, vedere Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
Accedi a Partner Hub
Fare clic su Impostazioni.
Fare clic su Visualizza cluster e selezionare il cluster BroadWorks appropriato.
Abilita il tasto di alternanza Non disturbare (NoDist).
Inserire l'ID utente BroadWorks e fare clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione NoDist. Se la convalida non riesce, il pulsante Salva viene disabilitato.
Se la convalida ha esito positivo, fare clic su Salva.
|
Abilita sincronizzazione NoDist (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per ulteriori dettagli, vedere "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Disabilita sincronizzazione NoDist
Non puoi disabilitare la sincronizzazione NoDist da solo. Per disabilitare la funzione, crea un caso BEMS di ingegneria con le seguenti informazioni:
Famiglia: Servizio Spark
Prodotto: Chiamata in Webex (Webex per BroadWorks)
Componente: Provisioning WxBW
Il caso BEMS deve indicare che la sincronizzazione non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterIdBroadWorks.
Casi d'uso

Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione delle chiamate.
Modalità di registrazione | Descrizione | Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta | La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente | La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Per R22: AP.as.22.0.1123.ap377718
Per R23: AP.as.23.0.1075.ap377718
Per R24: AP.as.24.0.944.ap377718
L'identificativo di correlazione chiamata deve essere attivato. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione delle chiamate Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, andare a help.webex.com
articolo Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla piattaforma di registrazione chiamate di terze parti.
Gruppo Parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione di parcheggio e recupero delle chiamate di gruppo. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti al dettaglio in un'impostazione di negozio possono utilizzare la funzione per parcheggiare una chiamata che può essere raccolta da qualcuno in un altro reparto.
Funzionamento funzione
Una volta configurata la funzione
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nell'app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nell'app Webex. L'utente quindi inserisce l'estensione della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per attivare questa funzione, verificare quanto segue:
Il file di configurazione client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
L'identificativo di correlazione chiamata deve essere abilitato su AS e XSP|ADP. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Il tuo SBC deve essere configurato per passare il ‘
x-broadworks-correlation-in
' Attributo SIP a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiungi gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo del server applicazioni Cisco BroadWorks - Parte 2. È necessario creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Parcheggio Webex | e Recupera chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzato
Il parcheggio chiamate regolare o indirizzato non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso funzione:
Immettere *68 per parcheggiare una chiamata
Immettere *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato negli ambienti del call center o in altre situazioni in cui può essere necessaria un'assistenza o un intervento immediati.
Quando un servizio di inclusione è abilitato, un utente o supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di tasti o pulsanti dedicati sul proprio telefono o dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o di partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in vari scenari. In un ambiente di call center, supervisori o formatori possono monitorare e assistere i rappresentanti del servizio clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire assistenza o prendere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può partecipare rapidamente a conversazioni in corso per fornire assistenza o prendere decisioni importanti.

Nell'app Webex per l'inclusione, viene inviata una notifica che la chiamata viene trasformata in una conferenza. In NOTIFY (informazioni sulla chiamata o conferenza) non sono disponibili ulteriori informazioni sul tipo di conferenza, pertanto è possibile trattarla in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Vengono introdotti i seguenti termini:
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore solitamente ha la possibilità di monitorare e intervenire nelle chiamate in corso dei clienti. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire assistenza agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può comprendere la formazione degli agenti, la gestione dei problemi dei clienti e l'ottimizzazione delle prestazioni del team.
Cliente: Per cliente si intende una persona fisica o giuridica che interagisce con un'azienda o un'organizzazione per ottenere prodotti, servizi o assistenza. Nel contesto dell'inclusione delle chiamate, un cliente è qualcuno che sta effettuando o ricevendo una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risolvere le loro richieste o problemi durante la chiamata. La funzione di inclusione chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
Agente: Un agente, anche noto come rappresentante del servizio clienti o agente del call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza telefonica o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare operazioni e offrire un'esperienza positiva al cliente. Nel contesto dell'inclusione delle chiamate, un agente è la persona che parla direttamente al cliente durante la telefonata. L'agente può ricevere indicazioni o feedback dal supervisore attraverso l'inclusione della chiamata, se necessario.
La chiamata nativa mobile viene inoltrata alla riunione
La funzione di escalation della chiamata nativa mobile alla riunione è dotata di due funzioni uniche:
Nuova notifica push
Gli utenti mobili su una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando si avvia una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si accede direttamente alla schermata in chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata utilizzando il controllo chiamate Cisco per le chiamate su cellulare, viene visualizzata la notifica Webex durante una chiamata su cellulare.
Trasferisci chiamata mobile a riunione
Quando sei nel mezzo di una chiamata con qualcuno, potresti voler trasferire la chiamata in una riunione per utilizzare alcune funzioni di riunione avanzate come video, condivisione o lavagna. In alternativa, invitare altre persone alla discussione e passare a una riunione.
Requisiti BroadWorks
Funzione attivabile 25239
R23 con XSP|ADP:
AS Patch AP.as.23.0.1075.ap383064
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
Patch AP.platform.23.0.1075.ap383064
R23 con ADP:
AS Patch AP.as.23.0.1075.ap383064
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R24:
Cerotto AS: AP.as.24.0.944.ap383064
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R25:
AS RI release Rel_2022.08_1.354
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e NPS versione > 2022.08_1.350
Configurazione chiamata URI per supportare lo spostamento della chiamata alla riunione
Criteri di chiamata Url NS
Definisci la regola per (.*)webex.com da indirizzare attraverso I-SBC
NS_CLI/Policy/UrlDialing> get WebexMeetings
Policy: UrlDialing Instance: Webex
unknownSipURIHandling = reject
disableSubscriberLookups = true
Enable = true
CallTypes:
Selection = {ALL}
From = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP}
lineportOnly = false
enableSipURIMatchingRules = true
NS_CLI/Policy/UrlDialing/Rules> get WebexMeetings
Policy: UrlDialing Instance: WebexCalling Table: Rules
id pattern routingNE cost weight dtg
===================================================================
1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE di indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> get ne WebexMeetings
Network Element WebexMeetings
Location = 1281465
Data Center =
Static Cost = 1
Static Weight = 99
Poll = false
OpState = enabled
State = OnLine
Profile = NIL_PROFILE
Remote Lookup Enabled = false
Signaling Attributes =
NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings
Routing NE Address Cost Weight Port Transport Route
=====================================================================
WebexMeetings sbc-address 1 99 - unspecified
Profilo di indirizzamento NS
Aggiunta dell'istanza della policy UrlDialing ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> get profile MyInst
Profile: Webex
Policy Instance
==========================================
…
UrlDialing WebexMeetings
AS Usa indirizzamento NS per chiamata NetworkURL
Consente all'AS di rispettare il percorso NS in modalità ibrida AS
AS_CLI/Interface/IMS> set queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un PSAP (Public Safety Answering Point), che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, è necessario integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Usa i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
Chiamata di emergenza E911 in Webex per BroadWorks: utilizzare questo articolo per configurare la chiamata di emergenza E911 in Webex per Cisco BroadWorks utilizzando uno dei seguenti provider E911 supportati:
Banda
Intrado
RedSky
Esclusione di responsabilità per chiamate di emergenza: se disponi di un servizio di posizione, puoi configurare la finestra Esclusione di responsabilità per i servizi di emergenza sull'app Webex in modo da includere un'opzione per gli utenti per aggiornare la propria posizione quando eseguono l'accesso.
Personalizzazione e provisioning dei clienti
Gli utenti scaricano e installano le relative app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedere Piattaforme app Webex). Una volta eseguita l'autenticazione dell'utente, il client si registra sul cloud Webex per messaggistica e riunioni, recupera le informazioni sul branding, scopre le informazioni del servizio BroadWorks e scarica la configurazione delle chiamate dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
Configurare i parametri di chiamata per le app Webex in BroadWorks (come di consueto). Configura i parametri di branding, messaggistica e riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Prepara il tuo ambiente).
Verificare di disporre dei set di tag corretti in BroadWorks System > Resources > Device Management Tag Sets.
Per ciascun client che si sta eseguendo il provisioning:
Scaricare ed estrarre il file zip DTAF per il client specifico.
Importare i file DTAF in BroadWorks all'indirizzo System > Resources > Identity/Device Profile Types
Apri il profilo dispositivo appena aggiunto per la modifica e:
Immettere il nome di dominio completo dell'azienda agricola XSP|ADP e il protocollo di accesso del dispositivo.
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per il funzionamento della condivisione desktop.
È inoltre possibile abilitare il supporto Parte remota eseguendo il seguente comando CLI sul server applicazioni:AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
Salvare il file.
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome | Descrizione |
Priorità codec | Configurazione dell'ordine di priorità per i codec audio e video per le chiamate VoIP |
TCP, UDP e TLS | Configurare i protocolli utilizzati per la segnalazione e il contenuto multimediale SIP |
Porte audio e video RTP | Configurazione degli intervalli di porte per audio e video RTP |
Opzioni SIP | Configurare diverse opzioni relative a SIP (SIP INFO, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti gestiti dal partner. Vedere Configurazione di personalizzazioni di branding avanzate.
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client. |
Personalizzazione dei report dei problemi e degli URL della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito Feedback e Guida", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con Flowthrough Provisioning
Prima di poter eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 | Assegna servizio in BroadWorks: |
2 | Verifica dell'organizzazione cliente e degli utenti in Control Hub: |
Test utente
1 | Scaricare l'app Webex su due diverse macchine. |
2 | Eseguire l'accesso come utenti di test sulle due macchine. |
3 | Effettuare chiamate di prova. |
Provisioning delle organizzazioni dei clienti
Nel modello corrente, eseguiamo automaticamente il provisioning dell'organizzazione del cliente quando si esegue l'onboarding del primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguito una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
Usa API per creare account Webex
Assegna il provisioning integrato IM&P (flowthrough provisioning) con e-mail attendibili per creare account Webex
Assegna provisioning integrato IM&P (flowthrough) senza e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per creare account Webex
Consenti agli utenti di autoattivarsi (invia loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex espone le API pubbliche per consentire ai provider di servizi di integrare il provisioning degli abbonati Webex per Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. Le specifiche per queste API sono disponibili su developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti wholesale verranno rifiutati da queste API. |
Provisioning del flusso
Su BroadWorks, è possibile eseguire il provisioning degli utenti con l'opzione Abilita IM&P integrato. Questa azione provoca l'adattatore di provisioning BroadWorks per effettuare una chiamata API per il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica del codice, ma solo una modifica della configurazione dell'endpoint API per l'adattatore di provisioning.
Il provisioning degli abbonati su Webex può richiedere molti minuti (diversi minuti per l'utente iniziale all'interno di un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il successo del provisioning flowthrough indica che il provisioning è stato avviato. Non indica il completamento. Per confermare che il provisioning di utenti e organizzazione cliente sia completo su Webex, devi accedere a Partner Hub e guardare nell'elenco dei clienti. Gli utenti di trunking BroadWorks possono disporre di Webex per BroadWorks tramite un identificativo di chiamata condiviso (SCA). L'utente che esegue il trunking dovrà disporre del servizio di autenticazione assegnato. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto Webex SCA dall'autenticazione del trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con le funzioni di elenco di indirizzamento o indirizzamento diretto assegnate. |
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata Modello di onboarding. |
Autoattivazione utente
Per eseguire il provisioning degli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
Accedere a Partner Hub e trovare la pagina Elenco clienti.
Fare clic su Visualizza modelli.
Seleziona il modello di onboarding di provisioning che desideri applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non si trova nel sistema BroadWorks associato a questo modello, non può attivarsi automaticamente con il collegamento.
Copiare il collegamento di provisioning e inviarlo all'utente.
È anche possibile includere il collegamento per il download del software e ricordare all'utente di cui ha bisogno di fornire e convalidare il proprio indirizzo e-mail per attivare l'account Webex.
È possibile monitorare lo stato di attivazione dell'utente nel modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi di attivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli all'interno della vista Stato utente che consentono agli amministratori dei provider di servizi Webex per Cisco BroadWorks di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Sposta gli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) |
|
Organizzazione cliente | Collega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge Webex per BroadWorks anche agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) | Se l'organizzazione Webex per BroadWorks non esiste (nessun utente predisposto):
Se esiste un'organizzazione Webex per BroadWorks (viene predisposto almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di autoiscrizione (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (con il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
Sposta utente (con e-mail attendibili): utilizza il provisioning con e-mail attendibili
Sposta utente (con e-mail non attendibili): utilizza il provisioning con e-mail non attendibili
Autoattivazione
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza messaggi e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
L'amministratore aggiunge l'utente.
L'utente viene spinto sul bridge di provisioning BroadWorks.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L’utente apre il messaggio e-mail e fa clic su Attiva account. L'utente viene reindirizzato al portale consumer Webex.
L'utente accede a Webex.
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza messaggi e-mail non attendibili, è necessario prima convalidare l’indirizzo e-mail dell’utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
L'amministratore aggiunge l'utente.
L'utente viene inviato automaticamente al bridge di provisioning BroadWorks.
All'utente viene inviato un testo con un collegamento di attivazione.
L'utente fa clic sul collegamento Attivazione e inserisce l'indirizzo e-mail.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L'utente apre il messaggio e-mail e fa clic su Accedi ora.
L'indirizzo e-mail viene convalidato.
L'utente viene reindirizzato all'accesso al portale consumer Webex.
L'utente accede a Webex.
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Flusso di autoattivazione
Se l'utente dispone di un account BroadWorks esistente, può utilizzare il processo di autoattivazione per spostare l'account.
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
L'utente inserisce il proprio indirizzo e-mail.
L'utente viene inviato al bridge di provisioning BroadWorks.
Viene inviata un'e-mail automatica all'indirizzo e-mail dell'utente.
L'utente apre il messaggio e-mail e fa clic sul collegamento Accedi ora, che convalida l'indirizzo e-mail.
CI rileva che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di poter continuare.
L'utente viene reindirizzato all'accesso a Webex.
L'utente accede al portale consumer.
L'utente fa clic su Elimina account.
L'account Webex precedente viene eliminato.
All'utente è stato predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
Collegamento di Webex per BroadWorks all'organizzazione esistente
Se sei un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, che non è ancora associata a un'azienda BroadWorks gestita da un partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso amministratore per la richiesta di provisioning riuscita.
È necessaria l'approvazione dell'amministratore dell'organizzazione se una delle seguenti affermazioni è vera:
L'organizzazione cliente esistente dispone di 100 utenti o più
L'organizzazione dispone di un dominio e-mail verificato
Dominio organizzazione richiesto
Se nessuno dei criteri di cui sopra è vero, può verificarsi un Attacco automatico.
In uno scenario di allegato automatico, un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner verranno concessi diritti di amministrazione provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà eseguito un amministratore completo. Con l'accesso amministratore di provisioning, la visibilità in Control Hub sarà limitata agli utenti nell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione. |
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che i messaggi e-mail di invito amministratore vengano collegati a organizzazioni esistenti (il tasto di alternanza è attivo per impostazione predefinita). |
1 | L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedere Provisioning delle organizzazioni dei clienti. Si verifica quanto segue:
| ||
2 | Con l'accesso amministratore completo, l'amministratore del partner può completare il processo di provisioning del cliente. Dovrai provare a eseguire nuovamente il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora come amministratore completo esterno, non si dovrebbe osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione cliente esistente sarà visibile come cliente sotto Webex per l'organizzazione partner BroadWorks.
|
Condizioni dell'allegato organizzazione
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione del cliente target. In caso contrario, verrà creata una nuova organizzazione cliente.
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato sul modello di provisioning Webex per BroadWorks. Di conseguenza, non vi sono modifiche alla modalità di accesso degli utenti esistenti.
Tuttavia, se l'organizzazione cliente esistente dispone di branding di base abilitato, una volta eseguito il collegamento, le impostazioni di branding avanzate del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
Il nome dell'organizzazione esistente non cambierà.
Non è stata apportata alcuna modifica all'impostazione del flag di soppressione e-mail nelle impostazioni dell'organizzazione esistente. Ciò può avere effetto sui nuovi utenti predisposti. A seconda di come è impostato il flag, i nuovi utenti possono o meno ricevere un'e-mail con un codice che deve essere immesso per completare l'attivazione.
La modalità di amministrazione con restrizioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
Accertarsi di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
Un'azienda BroadWorks può essere associata solo a una organziazione Webex. Non è possibile eseguire il provisioning degli abbonati da una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com
.
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo. |
L'indirizzo e-mail aggiunto dall'amministratore dell'organizzazione cliente come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore partner come configurato nel modello di onboarding su Partner Hub. Dopo aver aggiunto l'e-mail dal modello di onboarding in Partner Hub come amministratore completo, qualsiasi amministratore aggiuntivo del partner dovrà essere aggiunto anche come amministratore esterno con diritti di amministratore completo. |
Scollegare Webex per BroadWorks dall'organizzazione esistente
Effettuare le seguenti operazioni per scollegare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato accidentalmente Webex per BroadWorks a un'organizzazione esistente e si desidera rimuovere l'allegato.
In Flusso standard, il distacco di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati. |
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso all'amministratore esterno seguendo Approva richiesta amministratore esterno.
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Remove a BroadWorks Workspace.
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi abbonato BroadWorks.
Rimuovi gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se gli utenti sono stati predisposti tramite il flusso e-mail non attendibile e non sono stati ancora inseriti messaggi e-mail validi, gli utenti rimangono in stato di attesa. Segui Verifica provisioning utente con e-mail non attendibili per eliminare gli utenti.
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Hybrid, nella sezione BroadWorks Calling elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera collegare Webex per BroadWorks al cliente, seguire i processi di provisioning per collegarlo a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API Rimuovi abbonato BroadWorks è quella di accedere a BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati. |
Gestione di utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente sono in BroadWorks. Un'identità e-mail distinta per l'utente e le relative licenze per le funzioni Webex vengono conservate in Webex.
Verifica provisioning utente con e-mail non attendibili
Se si sta eseguendo il provisioning di utenti Webex per BroadWorks utilizzando il provisioning flow-through con e-mail non attendibili, gli utenti devono eseguire il provisioning automaticamente inserendo il relativo indirizzo e-mail nel portale di attivazione utente. Se l'utente riscontra un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riscontra nuovamente l'errore, l'amministratore può utilizzare i passaggi seguenti in Partner Hub per esaminare lo stato e caricare l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 | Accedere a Partner Hub e trovare la pagina Elenco clienti. |
2 | Fare clic su Visualizza modelli. Selezionare il modello di onboarding appropriato che si desidera applicare a questo utente. |
3 | In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con e-mail non attendibili sia configurato correttamente:
|
4 | In seguito al provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato del provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo stato corrente, che mostra se l'utente è predisposto o se è presente un requisito in sospeso.
|
5 | Per gli utenti con errori o requisiti in sospeso, fare clic sui tre punti a destra e scegliere una delle seguenti opzioni amministrative:
![]() |
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili quando si visualizza l'elenco degli utenti:
Esporta: fare clic su questo pulsante se si desidera esportare l'elenco utenti in un file CSV.
Escludi utenti predisposti: abilita questo tasto di alternanza se desideri visualizzare solo gli utenti con requisiti o errori in sospeso.
Modifica ID utente o indirizzo e-mail
Modifiche a ID utente e indirizzo e-mail
L'ID e-mail e l'ID alternativo sono gli attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. La tabella seguente descrive gli scopi di questi diversi attributi e cosa fare se occorre cambiarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non puoi modificare questo identificativo e comunque collegare l'utente allo stesso account in Webex. È possibile eliminare l'utente e ricreare se non è corretto. |
ID e-mail | ID utente | Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si afferma che l'e-mail è attendibile Non richiesto in BroadWorks se non si asserisce di poter considerare attendibili i messaggi e-mail Non richiesto in BroadWorks se consenti agli abbonati di autoattivarsi | È presente un processo manuale per modificare questa opzione in entrambe le posizioni se all'utente è stato eseguito il provisioning con l'indirizzo e-mail errato:
Non modificare l'ID utente BroadWorks. Questa operazione non è supportata. |
ID alternativo | Nessuno | Consente di abilitare l'autenticazione dell'utente per e-mail e password rispetto all'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se Non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti dovranno inserire il proprio ID utente BroadWorks durante l'autenticazione. |
Modifica pacchetto utenti in Partner Hub
1 | Accedi a Partner Hub e fai clic su Clienti. |
2 | Individuare e selezionare l'organizzazione del cliente a cui è assegnato l'utente. Viene visualizzata la pagina di panoramica dell'organizzazione in un pannello a destra dello schermo. |
3 | Fare clic su Visualizza cliente. L'organizzazione del cliente si apre in Control Hub, mostrando la pagina Panoramica.
|
4 | Fare clic su Utenti, quindi individuare e fare clic sull'utente interessato. |
5 | Nei Servizi dell'utente, fare clic su Webex per i pacchetti BroadWorks (Abbonamenti). Si apre il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 | Nella scheda Profilo, cercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 | Seleziona il pacchetto che desideri per questo utente (Base, Standard, Premium o Softphone) e fai clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 | Puoi chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium hanno siti di riunione distinti associati a ciascun pacchetto. Quando un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato viene visualizzato con due siti di riunione in Control Hub. Le funzionalità di riunione organizzatore e il sito della riunione dell'abbonato vengono allineati al pacchetto corrente. Il sito della riunione del pacchetto precedente e qualsiasi contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili all'amministratore del sito della riunione. |
Potrebbero essere necessarie da due a tre ore per le nuove impostazioni PMR derivanti da una modifica del pacchetto da aggiornare. |
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si desidera eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto alcun trasferimento automatico del ruolo di amministratore nel caso in cui venga eliminato l'ultimo amministratore. |
API Cisco BroadWorks per Webex
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
Eseguire la richiesta API Remove a BroadWorks Subscriber su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento Webex per Cisco BroadWorks. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
Eseguire la richiesta Elimina una persona API su https://developer.webex.com/docs/api/v1/people/delete-a-person per eliminare completamente l'utente.
Provisioning flow-through
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – IM&P integrato in BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks - Parte 2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento Webex per Cisco BroadWorks dall'utente. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla propria organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 | Usa le API Persone per eliminare tutti gli utenti dall'organizzazione:
| ||
2 | Se la sincronizzazione rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione rubriche tramite Partner Hub: Per disabilitare la sincronizzazione rubriche tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API aziendale BroadWorks e disabilita l'impostazione enableDirSync. Tutti gli utenti correlati alla sincronizzazione rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione degli utenti (utilizzando entrambi i metodi) può richiedere del tempo a seconda della quantità di utenti. | ||
3 | Una volta rimossi tutti gli utenti, utilizza l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Gestione delle release
I controlli di gestione delle release in Partner Hub consentono a Webex per i provider di servizi Cisco BroadWorks di gestire facilmente le release consentendo loro di controllare la cadenza di rilascio in base alla quale le app Webex degli utenti vengono aggiornate all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza gli aggiornamenti automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
Configurazione di pianificazioni di rilascio personalizzate con rinvii dalla pianificazione di rilascio predefinita Cisco
Configurare una singola pianificazione della release e trasferirla a cascata a tutte le organizzazioni dei clienti che gestiscono
Assegna diverse pianificazioni di rilascio a diverse organizzazioni di clienti
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di rilascio personalizzate, vedere l'articolo Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
Aggiunta di un cluster BroadWorks in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
Aggiunta di un modello di onboarding in Partner Hub
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | ||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | ||
3 | Fare clic su Visualizza cluster. | ||
4 | Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro flyout a destra.
| ||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | |||||||||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | |||||||||
3 | Fare clic su Visualizza modelli. | |||||||||
4 | Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere a Webex Assistant di seguire le azioni, prendere nota di decisioni importanti ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant per Meetings è disponibile gratuitamente per i siti per riunioni con pacchetto Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilitazione di Webex Assistant per Meetings
Webex Assistant è abilitato per impostazione predefinita per i clienti Broadworks con pacchetto standard e premium.
Gli amministratori dei partner e gli amministratori delle organizzazioni dei clienti possono disabilitare la funzione per le organizzazioni dei clienti tramite Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
Il supporto è limitato ai siti per riunioni con pacchetto Premium e Standard e solo alle sale riunioni personali.
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
La condivisione di contenuto tramite e-mail è accessibile solo dagli utenti all'interno della tua organizzazione
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Il contenuto della riunione non è accessibile anche se condiviso tra utenti di pacchetti diversi dall'interno della stessa organizzazione.
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile, pertanto le trascrizioni post-riunione non sono disponibili se Webex Assistant è abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni utente su come utilizzare la funzione, vedere Uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
Webex Calling gratuito è abilitato per impostazione predefinita consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, che disabilita tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzione
Se Webex Calling è disabilitato, le seguenti condizioni si applicano a Webex per gli utenti Cisco BroadWorks:
Gli utenti non visualizzano più Chiamata con Webex come opzione di chiamata selezionabile sull'app Webex.
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, la cronologia chiamate, i contatti, inserendo l'URI dell'altro utente o l'indirizzo e-mail nella barra di ricerca.
Condivisione schermo all'interno di una chiamata BroadWorks.
Le riunioni Webex e la presenza in telefonia funzionano ancora, anche se le chiamate Webex sono disabilitate.
Disabilita chiamate Webex (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno di Aggiungi un nuovo modello guidata. Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti assegnate al modello.
Per informazioni dettagliate sulla configurazione di un nuovo modello di onboarding, vedere Configurazione dell'organizzazione partner in Partner Hub.
Disabilita chiamate Webex (modello di onboarding esistente)
Seguire questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
Accedere a Partner Hub all'indirizzo admin.webex.com.
Scegliere Impostazioni.
Fare clic su Visualizza modello e scegliere il modello di inserimento appropriato.
Fai clic su Disabilita chiamata gratuita Cisco Webex.
Fai clic su Salva.
Disabilita chiamate Webex (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare Webex Calls per un utente esistente, è possibile seguire una delle procedure seguenti per aggiornare l'utente.
Accertarsi di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigura l'utente con le chiamate Webex abilitate. |
Se si utilizza il provisioning flow-through, è possibile effettuare le seguenti operazioni:
Aprire CommPilot e passare alla configurazione utente.
Rimuovere il servizio Integrated IM+P dall'utente e fare clic su OK.
Aggiungere il servizio Integrated IM+P all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
Utilizzare Remove a BroadWorks Subscriber API per eliminare l'utente.
Utilizzare la Provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione della condivisione video o dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per informazioni dettagliate sulla configurazione e le opzioni complete, vedere Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è anche possibile configurare se il contenuto multimediale delle chiamate in ingresso utilizza per impostazione predefinita solo il video o l'audio. |
Indicatore di stato della linea / Notifica risposta per assente
L'indicatore di stato/notifica di risposta per assente utilizza le funzioni di risposta per assente indirizzata. Un utente con indicatore di stato riceve una notifica audio e visiva sull'app Webex quando un utente dell'elenco di indicatori di stato monitorato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può Ignorare o Rispondere alla chiamata dell'utente monitorato.
La notifica dell'indicatore di stato/risposta per assente consente di rispondere alle chiamate di altri membri del team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra chiamata multipla - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza dei membri del team Webex e non Webex. I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati nella rubrica in Webex e avranno solo stati "sconosciuti" e "in chiamata" (lo stato suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
La presenza non è supportata per gli utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
Gli utenti CI senza autorizzazione cloud Webex o tipo di account macchina (spazi di lavoro) visualizzano solo la presenza "in chiamata" e "sconosciuta". Nessun stato attivo, suoneria, ecc.
Gli utenti non Webex dall'elenco di indicatori di stato, che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza "sconosciuta".
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
Se un utente non Webex dell'indicatore di stato detiene una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate su BroadWorks. Installare solo le patch valide per la versione in uso:
Per R22:
Piattaforma AP.22.0.1123.ap382053
AP.as.22.0.1123.ap382053
AP.as.22.0.1123.ap382362
AP.xsp.22.0.1123.ap382053
AP.xsp.22.0.1123.ap382362
AP.as.22.0.1123.ap383459
AP.as.22.0.1123.ap383520
Per R23:
Piattaforma AP.23.0.1075.ap382053
AP.as.23.0.1075.ap382053
AP.as.23.0.1075.ap382362
AP.as.23.0.1075.ap383459
AP.as.23.0.1075.ap383520
Se si utilizza XSP|ADP:
AP.xsp.23.0.1075.ap382053
AP.xsp.23.0.1075.ap382362
Se si utilizza ADP:
Xsi-Actions-23_2022.01_1.200.bwar
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
Per R24:
AP.as.24.0.944.ap382053
AP.as.24.0.944.ap382362
AP.as.24.0.944.ap383459
AP.as.24.0.944. ap383520
Xsi-Actions-24_2022.01_1.200.bwar
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
<busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare la funzione 101642 Enhanced Xsi Mechanism Per la telefonia del team su AS:
AS_CLI/System/ActivatableFeature> activate 101642
Abilita X-BroadWorks-Remote-Party-Info
in AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamata SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Accertarsi che i seguenti servizi siano assegnati agli utenti:
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP. |
Configurazione dell'indicatore di stato della linea su BroadWorks
Gli amministratori dei partner possono utilizzare la seguente procedura per impostare l'indicatore di stato della linea per un utente.
Accedere a BroadWorks CommPilot.
Per un utente selezionato, accedere ad Applicazioni client e configurare l'indicatore di stato della linea.
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
Utilizzare i parametri di ricerca per individuare e aggiungere utenti all'elenco Utenti monitorati.
Fai clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento di coinvolgimento del pubblico facile da usare. Consente alle persone di ottenere il massimo dalle riunioni colmando la distanza tra oratori e pubblico. Quando Slido è integrato nell'organizzazione Control Hub, gli utenti possono aggiungere l'Slido app alle riunioni nell'app Webex. Questa integrazione offre ulteriori funzionalità di Q&A e sondaggio alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando è stata accettata una riunione nel client Outlook che corrisponde a un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che hai assunto un impegno diverso e che la risposta potrebbe essere ritardata.
Per abilitare questa funzione:
andare alla scheda Generale della scheda Impostazioni su Windows o Preferenze su Mac.
Selezionare la casella per Mostra in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, "In una riunione di calendario" in Webex è associato a "Occupato" in Outlook. |
Avvertenza
Per utilizzare questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come funziona altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la sua presenza non verrà aggiornata fino al termine della riunione. A tale scopo, sarà necessario riavviare il client per rispondere.
Risposta automatica con tono
Con la risposta automatica con tono, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul desktop. Quando l'app Webex squilla sull'altra parte, l'utente sente un determinato segnale acustico che indica che la chiamata è in connessione.
Per utilizzare questa funzione per un utente Webex per Cisco BroadWorks:
La funzione è supportata solo sull'aspetto della linea principale
L'app Webex deve essere l'identificativo di linea principale
Il tag %ENABLE_AUTO_ANSWER_WXT% deve essere abilitato
Se l'utente dispone anche di indicatori di chiamata condivisa (ad esempio, un telefono da tavolo è configurato come uno degli indicatori di linea secondaria), la funzione è ancora supportata sull'aspetto principale, a condizione che gli indicatori di chiamata condivisa siano configurati per non ricevere chiamate in arrivo. Per effettuare questa operazione, è possibile configurare una delle tre condizioni seguenti su BroadWorks per tutte le chiamate condivise:
Avvisa tutti gli aspetti delle chiamate con clic è disabilitato nella configurazione dell'aspetto chiamata condivisa: questo è l'approccio consigliato
o
Consenti terminazione a questa posizione deve essere disabilitato per tutte le chiamate condivise o
o
Posizioni disabilitate per tutti gli indicatori di chiamata condivisi
Aumentare la capacità
Aziende agricole XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare quante risorse XSP|ADP aggiuntive sono necessarie per l'aumento proposto dei numeri di abbonati. Per le aziende NPS dedicate o Webex dedicato per le aziende Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
Fattoria dedicata in scala: Aggiungere uno o più server XSP|ADP all'azienda che ha bisogno di capacità extra. Installare e attivare lo stesso set di applicazioni e configurazioni dei nodi esistenti dell'azienda agricola.
Aggiungi azienda agricola dedicata: Aggiungi una nuova fattoria XSP|ADP dedicata. Dovrai creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti nella nuova fattoria, per ridurre la pressione sulla fattoria esistente.
Aggiungere azienda agricola specializzata: Se si verificano strozzature per un particolare servizio, è possibile creare un'azienda agricola ADP|XSP separata a tale scopo, tenendo conto dei requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster di Control Hub e le voci DNS se si modifica l'URL del servizio con una nuova azienda agricola.
In tutti i casi, è tua responsabilità monitorare e assegnare risorse all’ambiente BroadWorks. Se si desidera contattare l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare i servizi professionali.
Gestione dei certificati del server HTTP
È necessario gestire questi certificati per le applicazioni Web autenticate mTLS su XSP|ADP:
La nostra catena di certificati di attendibilità dal cloud Webex
Certificati delle interfacce del server HTTP di XSP|ADP
Catena di fiducia
È possibile scaricare la catena del certificato di attendibilità da Control Hub e installarlo sugli ADP|XSP durante la configurazione iniziale. Prevediamo di aggiornare il certificato prima della scadenza e di informarvi su come e quando modificarlo.
Interfacce del server HTTP
L'|ADP XSP deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Certificati ordine. Quando si protegge l'interfaccia, viene generato un certificato autofirmato per l'interfaccia. Questo certificato è valido per un anno da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione di Partner Hub che gli amministratori dei partner possono assegnare a organizzazioni di clienti specifiche per limitare le impostazioni dell'organizzazione che gli amministratori dei clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione del cliente, tutti gli amministratori del cliente di tale organizzazione, indipendentemente dalle autorizzazioni dei ruoli, non sono in grado di accedere a un set di controlli con limitazioni in Control Hub. Solo un amministratore partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner esiste un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita le autorizzazioni di ruolo specifiche per gli amministratori dei clienti nell'organizzazione a cui è applicata l'impostazione. |
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità con limitazioni per partner. Dopo l'accesso, vedrà un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner notifica all'amministratore del cliente che la Modalità con limitazioni è abilitata e che l'amministratore potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore del cliente in un'organizzazione in cui con limitazioni della modalità partner è abilitata, il livello di accesso di Control Hub è determinato con la formula seguente:
(Accesso a Control Hub) = (Entitlements Role Organization) - (Limitato dalle limitazioni della modalità partner)
Limitazioni
Quando è abilitata la modalità con limitazioni per partner per un'organizzazione del cliente, gli amministratori dei clienti di tale organizzazione non possono accedere alle seguenti impostazioni di Control Hub:
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
Pulsante Gestisci utenti: disattivato.
Aggiungi o modifica manualmente utenti: nessuna opzione per aggiungere o modificare gli utenti, né manualmente né tramite CSV.
Richiedi utenti: non disponibile
Assegna automaticamente licenze: non disponibile
Sincronizzazione rubriche —Impossibile modificare le impostazioni di sincronizzazione delle rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato ed e-mail principale* sono modificabili.
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, messaggi, riunioni, chiamate)
Visualizza stato servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
Numero di lavoro principale: questo campo è di sola lettura.
Nella vista Account, non sono disponibili le seguenti impostazioni:
Nome società: campo di sola lettura.
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
Dominio: accesso di sola lettura.
E-mail: le impostazioni Elimina inviti e-mail di amministrazione e Selezione impostazioni internazionali e-mail sono di sola lettura.
Autenticazione: nessuna opzione per la modifica delle impostazioni di autenticazione e SSO.
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
Impostazioni chiamata: le impostazioni di priorità della chiamata delle opzioni dell'app sono di sola lettura.
Funzionamento chiamata: le impostazioni sono di sola lettura.
Posizione > PSTN: le opzioni Gateway locale e Cisco PSTN sono nascoste.
Sotto SERVIZI, le opzioni di servizio Migrazioni e Connected UC vengono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori partner possono utilizzare la procedura seguente per l'abilitazione Con limitazioni della modalità partner per una determinata organizzazione cliente (l' impostazione predefinita è abilitata).
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
Seleziona l'organizzazione cliente applicabile.
Nella vista Impostazioni di destra, abilitare il Con limitazioni della modalità partner per attivare l'impostazione.
Se si desidera disattivare la modalità Con limitazioni per partner, disabilitare l'interruttore.
Se il partner rimuove la modalità amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà eseguire quanto segue:
|
Analisi dei partner
I miglioramenti di Control Hub consentono agli amministratori partner di visualizzare e aggiornare facilmente le informazioni sui pacchetti per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata di tutti i clienti e include i seguenti dettagli:
Utenti totali per pacchetto (Softphone, Base, Standard, Premium)
Tendenza utenti per pacchetto (giornaliero/settimanale/mensile)
Clienti con n. di pacchetti assegnati
Per informazioni dettagliate su come utilizzare Analisi dei partner, vedere l'articolo Webex Analisi per i pacchetti Webex per la vendita all'ingrosso e Webex per BroadWorks in Partner Hub .
API di report fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare report di fatturazione. Nella tabella seguente vengono elencate le API, il tipo di accesso richiesto e i requisiti di ruolo.
API di fatturazione | Scopo | Tipo di accesso | Requisiti di ruolo per API (L'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Creazione di un report di fatturazione BroadWorks | Utilizzato per generare un report di fatturazione. | Accesso in scrittura |
|
Elenca report di fatturazione BroadWorks | Consente di elencare i report disponibili per la visualizzazione. | Accesso in lettura |
|
Ottenere un report di fatturazione BroadWorks | Utilizzato per ottenere una copia di un report generato. | Accesso in lettura |
|
Eliminazione di un report di fatturazione BroadWorks | Utilizzato per eliminare un report generato. | Accesso scrittura |
|
Campi di fatturazione
Nella tabella seguente sono elencati i campi contenuti nel report generato.
Campo | Descrizione |
---|---|
nome rivenditore | Nome partner o ID organizzazione partner |
ID fatturazione | Identificativo di fatturazione univoco del partner o numero C |
IdImpresaSp | L'identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno | Stato versione di prova interna del cliente (Sì/No) |
ID utente | IDutente dell'abbonato su BroadWorks |
id abbonato | Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato | Sì/No |
Data iniziale | Data di provisioning dell'abbonato. |
dataInizioFatturazione | Data di inizio fatturazione in questo mese |
DataFineFatturazione | Data di fine fatturazione in questo mese |
pacchetto | Il tipo di confezione che viene caricata |
quantità | Quantità ripartita per fatturazione.
|
|
Risoluzione dei problemi di Webex per Cisco BroadWorks
Abbonamento alla pagina di stato Webex
Innanzitutto verificare https://status.webex.com quando si verifica un'interruzione imprevista del servizio. Se non hai modificato la tua configurazione in Control Hub o BroadWorks prima dell'interruzione, controlla la pagina di stato. Ulteriori informazioni sull'iscrizione per le notifiche di stato e incidenti al Centro assistenza Webex.
Usa analisi Control Hub
Webex monitora l'utilizzo e i dati di qualità per la tua organizzazione e le organizzazioni dei tuoi clienti. Ulteriori informazioni sulle analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
Clienti o utenti non vengono creati in Control Hub con provisioning flowthrough:
Il server applicazioni può raggiungere l'URL di provisioning?
L'account di provisioning e la password sono corretti? Tale account esiste in BroadWorks?
I cluster non riescono in modo coerente a eseguire i test di connettività:
La connessione mTLS al servizio di autenticazione non riesce quando si crea il primo cluster in Partner Hub, poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. In caso contrario, non è possibile creare un'ancora attendibile sul servizio di autenticazione XSP|ADPs, pertanto la connessione mTLS di prova da Partner Hub non viene eseguita correttamente. |
Le interfacce XSP|ADP sono accessibili pubblicamente?
Stai utilizzando le porte corrette? È possibile immettere una porta nella definizione dell'interfaccia sul cluster.
Convalida non riuscita interfacce
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Esaminare i consigli per la configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Rivedere i consigli sulla configurazione dell'interfaccia in questo documento, con particolare attenzione a:
- Accertarsi di aver condiviso le chiavi RSA tra tutti gli XSP|ADP.
- Accertarsi di aver fornito l'URL AuthService al contenitore Web su tutti gli XSP|ADP.
- Se è stata modificata la configurazione della crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'|ADP XSP richiede di immettere il formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento elencava erroneamente le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati sul proprio archivio attendibile XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere i certificati del client?
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere i certificati del client?
Problemi del cliente
Verificare che il client sia connesso a BroadWorks
Accedere all'app Webex.
Verificare che l'icona Opzioni di chiamata (un ricevitore con una marcia sopra) sia presente sulla barra laterale.
Se l'icona non è presente, l'utente potrebbe non essere ancora abilitato per il servizio di chiamata in Control Hub.
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici . Viene visualizzato lo stato Sessione SSO A cui è stato eseguito l'accesso.
Se viene visualizzato un servizio telefonico diverso, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Tale verifica comporta:
Il client ha eseguito correttamente il transveresed dei microservizi Webex richiesti.
Autenticazione dell'utente eseguita correttamente.
Il client ha ricevuto un token Web JSON di lunga durata dal sistema BroadWorks.
Il client ha recuperato il proprio profilo dispositivo e si è registrato su BroadWorks.
Registri client
Tutti i client dell'app Webex possono Inviare I Registri a Webex. Questa è l'opzione migliore per i client mobili. È inoltre necessario registrare l'indirizzo e-mail dell'utente e l'ora approssimativa in cui si è verificato il problema se si sta cercando assistenza da TAC. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se è necessario raccogliere manualmente i registri da un PC Windows, si trovano come segue:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac:/Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS configurata male
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
Verificare che la catena di certificati Webex sia installata come ancora affidabile.
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e firmato da una CA ben nota.
Messaggio di eccedenza licenza
Questo messaggio può apparire per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'utilizzo delle licenze supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Politica di supporto allo stato stazionario
Il provider di servizi è il primo punto di contatto per il supporto del cliente finale (aziendale). Inoltrare i problemi che il SP non è in grado di risolvere al centro TAC. Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Politica di escalation
Tu (provider di servizi/partner) sei il primo punto di contatto per il supporto clienti finali (aziendale).
I problemi che non possono essere risolti dal SP vengono inoltrati al centro TAC.
Versioni di BroadWorks
Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Risorse di autosupporto
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, dove è presente una pagina specifica di Webex per Cisco BroadWorks che elenca argomenti di Guida e supporto comuni dell'app Webex.
L'app Webex può essere personalizzata con questo URL della Guida e un URL di segnalazione problemi.
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I registri vengono inviati al cloud Webex, dove possono essere analizzati da Webex DevOps.
È disponibile anche una pagina Centro assistenza dedicata alla Guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccogliere informazioni per l'invio di una richiesta di assistenza
Quando vengono visualizzati errori in Control Hub, potrebbero essere allegate informazioni che possono aiutare TAC a indagare sul problema. Ad esempio, se viene visualizzato un ID di verifica per un particolare errore o un codice di errore, salvare il testo da condividere con noi.
Prova a includere almeno le seguenti informazioni quando invii una query o apri un caso:
ID organizzazione cliente e ID organizzazione partner (ogni ID è una stringa di 32 cifre esadecimali, separate da trattini)
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce uno
Indirizzo e-mail utente (se un particolare utente riscontra problemi)
Versioni del cliente (se il problema presenta sintomi notati attraverso il cliente)
Confronto UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > | SaaS UC-One | Webex per Cisco BroadWorks |
---|---|---|
Cloud | Cisco UC-One Cloud (GCP) | Webex Cloud (AWS) |
Client | UC-One: Mobile, desktop Receptionist, Supervisore | Webex: Mobile, desktop, Web |
Principale differenza tecnologica | Riunioni condotte sulla tecnologia BroadSoft Meet | Riunioni fornite sulla tecnologia Webex Meetings |
Prove sul campo iniziali | Contesto di stadiazione, clienti beta | Ambiente di produzione, clienti GA |
Identità utente | ID BroadWorks servito come ID principale, a meno che il provider di servizi non disponga già dell'integrazione SSO.
ID utente e segreto in BroadWorks | ID e-mail in Cisco CI serve come ID principale Integrazione SSO in BroadWorks provider di servizi in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks al momento.
L'utente fornisce le credenziali tramite SSO con BroadWorks e Secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e segreti in IdP |
Autenticazione client | Gli utenti forniscono le credenziali attraverso il client Token di lunga durata BroadWorks richiesti se si utilizza la messaggistica Webex | Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso a Webex e aggiornamento dei token |
Gestione / configurazione | I vostri sistemi OSS/BSS e Portale rivenditore | I tuoi sistemi OSS/BSS e Control Hub |
Attivazione partner/provider di servizi | Impostazione una tantum da Cisco Operations | Impostazione una tantum da Cisco Operations |
Attivazione cliente/azienda | Portale rivenditore | Control Hub Creato automaticamente alla prima iscrizione utente |
Opzioni di attivazione utente | Autoiscrizione Imposta IM&P esterno in BroadWorks
| Impostazione di IM&P integrato in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP | Azioni XSI
XSI-Eventi CTI (mTLS) AuthService (mTLS opzionale) DMS | Azioni XSI Azioni XSI (mTLS) XSI-Eventi CTI (mTLS) Servizio di autenticazione (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 | Scarica e installa Webex. Per informazioni dettagliate, vedi Webex | Download dell'app. |
2 | Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 | Inserisci l'indirizzo e-mail e fai clic su Avanti. |
4 | Una delle seguenti operazioni si verifica, a seconda del modo in cui l'organizzazione è configurata in Webex: Webex si carica dopo aver eseguito correttamente l'autenticazione su IdP o BroadWorks.
|
Scambio e archiviazione dati
Queste sezioni forniscono dettagli sullo scambio e la memorizzazione dei dati con Webex. Tutti i dati vengono crittografati sia in transito che a riposo. Per ulteriori informazioni, vedi Webex App Security.
Onboarding provider servizi
Quando si configurano cluster e modelli utente in Webex Control Hub durante l'onboarding di provider di servizi, è possibile scambiare i seguenti dati BroadWorks memorizzati in Webex:
URL Xsi-Actions
URL Xsi-Events
URL interfaccia CTI
URL servizio di autenticazione
Credenziali adattatore di provisioning BroadWorks
Provisioning utente provider di servizi
Questa tabella elenca i dati utente e aziendale che vengono scambiati come parte del provisioning utente attraverso le API Webex.
Trasferimento dei dati in Webex | Da | Attraverso | Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito da SP) | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito dall’utente) | Utente | Portale di attivazione utente | Sì |
Nome | BroadWorks, per API | API Webex | Sì |
Cognome | BroadWorks, per API | API Webex | Sì |
Numero di telefono principale | BroadWorks, per API | API Webex | Sì |
Numero telefono cellulare | BroadWorks, per API | API Webex | Sì |
Estensione principale | BroadWorks, per API | API Webex | Sì |
ID provider di servizi BroadWorks e ID gruppo | BroadWorks, per API | API Webex | Sì |
Lingua | BroadWorks, per API | API Webex | Sì |
Fuso orario | BroadWorks, per API | API Webex | Sì |
Rimozione utente
Le API Webex per Cisco BroadWorks supportano la rimozione parziale e completa dell'utente. Questa tabella elenca tutti i dati utente memorizzati durante il provisioning e ciò che viene eliminato in ogni scenario.
Dati utente | Eliminazione parziale | Eliminazione completa |
---|---|---|
ID utente BroadWorks | Sì | Sì |
No | Sì | |
Nome | No | Sì |
Cognome | No | Sì |
Numero di telefono principale | Sì | Sì |
Numero telefono cellulare | Sì | Sì |
Estensione | Sì | Sì |
ID provider di servizi BroadWorks e ID gruppo | Sì | Sì |
Lingua | No | Sì |
Accesso utente e recupero configurazione
Autenticazione Webex
L'autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da uno qualsiasi dei meccanismi di autenticazione del supporto Webex. (L'autenticazione BroadWorks è trattata separatamente.) Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (indipendente) | Webex | Browser utente |
Credenziali utente | Browser utente | Provider identità (che dispone già di identità utente) |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Autenticazione BroadWorks
L'autenticazione BroadWorks si riferisce all'accesso dell'utente a un'app Webex utilizzando le credenziali BroadWorks. Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (proxy Webex Bwks IdP) | Webex | Browser utente |
Informazioni sul branding e URL BroadWorks | Webex | Browser utente |
Credenziali utente BroadWorks | Utente tramite browser (pagina di accesso con marchio servita da Webex) | Webex |
Credenziali utente BroadWorks | Webex | BroadWorks |
Profilo utente BroadWorks | BroadWorks | Webex |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento dell'avviso di accesso e del messaggio di errore:
- Attualmente gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso poiché la password è già scaduta. Con questa funzione, se la password sta per scadere tra 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere, con l'indicazione di quanti giorni rimangono, e all'utente viene consigliato di contattare il partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su true, è stato emesso l'errore "nome utente e password errati", ma ora con questa funzione viene migliorato il messaggio di errore: Tentativo di accesso non riuscito. La combinazione di ID utente e password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice errore 100006
Controllo flusso di accesso:
- Il partner può limitare l'accesso abilitando o disabilitando un'impostazione "w4bwks-password-expiry-fail-login". Se la password BroadWorks è scaduta, la configurazione in broadworks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, quindi viene visualizzato un errore che indica che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso può essere configurato dal partner come parte della funzione di personalizzazione avanzata. I partner solitamente configurano il collegamento per passare dall'utente a un portale partner per la gestione della password e la reimpostazione della password.
Questa funzione migliora l'esperienza di accesso utente solo durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se una password scade mentre l'utente è connesso all'app Webex. L'utente riceve la notifica di scadenza della password al successivo tentativo di accesso. L'impostazione "w4bwks-password-expiry-fail-login" verrà abilitata o disabilitata da Cisco su richiesta di un partner. |
Recupero configurazione cliente
Questa tabella illustra la tipologia di dati scambiati tra le diverse componenti in fase di recupero delle configurazioni del cliente.
Trasferimento dei dati | Da | Per |
---|---|---|
Iscrizione | Client | Webex |
Impostazioni organizzazione, inclusi URL BroadWorks | Webex | Client |
Token JWT BroadWorks | BroadWorks attraverso Webex | Client |
Token JWT BroadWorks | Client | BroadWorks |
Token dispositivo | BroadWorks | Client |
Token dispositivo | Client | BroadWorks |
File di configurazione | BroadWorks | Client |
Utilizzo allo stato stazionario
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione dopo la scadenza del token, tramite BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Trasferimento dei dati | Da | Per |
---|---|---|
Segnalazione SIP | Client | BroadWorks |
Supporto SRTP | Client | BroadWorks |
Segnalazione SIP | BroadWorks | Client |
Supporto SRTP | BroadWorks | Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Trasferimento dei dati | Da | Per |
---|---|---|
Messaggistica e presenza REST HTTPS | Client | Webex |
Messaggistica e presenza REST HTTPS | Webex | Client |
Segnalazione SIP | Client | Webex |
Supporto SRTP | Client | Webex |
Segnalazione SIP | Webex | Client |
Supporto SRTP | Webex | Client |
Uso dell'API di provisioning
Accesso sviluppatore
Le specifiche API sono disponibili su https://developer.webex.com e una guida all'uso è disponibile su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l' accedere per leggere la specifica API all'indirizzohttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Autenticazione e autorizzazione applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (ad esempio provisioning abbonato) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere l'aggiornamento e l'accesso ai token per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
Devi prima registrare la tua integrazione con Webex. Una volta eseguita la registrazione, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di accesso e aggiornamento necessari.
Per ulteriori dettagli sulle integrazioni e sulle modalità di creazione di questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli obbligatori per l'implementazione delle integrazioni: sviluppatore e utente autorizzatore, che possono essere svolti da persone/team separati nel proprio ambiente.
|
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning utilizzata:
Modalità Enterprise: il nome dell'organizzazione corrisponde esattamente a spEnterpriseId.
Modalità provider di servizi: il nome dell'organizzazione è la parte groupID di spEnterpriseId.
Il nome dell'organizzazione conterrà qualsiasi spazio vuoto, maiuscolo e caratteri speciali specificati in spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "attuale" con le ultime patch BroadWorks e le app Release Independent (RI). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Assicurarsi di rivedere le note di patch per queste patch software. Alcune patch potrebbero avere requisiti CLI aggiuntivi. |
Versione R22
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | ||
Richiesto per sincronizzazione rubrica | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per il server applicazioni | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per la funzione di registrazione chiamata | ||
Patch richiesta per il provisioning flow-through | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | Richiesto per proxy autenticazione NPS | |
Richiesto per il servizio di autenticazione con convalida token CI | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Obbligatorio per la cronologia chiamate unificata | ||
Altro | AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Richiesto per sincronizzazione rubrica | |
Configurazione server app | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Se si utilizza ADP... | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Versione R24
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per il provisioning flowthrough | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che è necessario configurare per Webex, fare riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utente e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. L'attivazione include la convalida e-mail e l'assegnazione del servizio in Webex. |
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se disponi di indirizzi e-mail affidabili per gli utenti, puoi scegliere di attivarli automaticamente quando esegui il provisioning automatico degli utenti. Questo processo è "provisioning automatico e attivazione automatica".
Provisioning utente automatizzato e attivazione automatica (flusso e-mail affidabile)

Prerequisiti
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase | Descrizione |
---|---|
1 | Citare e prendere ordini per il servizio con i clienti. |
2 | Si elabora l'ordine del cliente e si esegue il provisioning del cliente nei sistemi. |
3 | Il sistema di provisioning dei servizi attiva il provisioning di BroadWorks. Questo passaggio, in sintesi, crea l'azienda e gli utenti. Quindi assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM&P esterno. |
4 | Questo passaggio di provisioning attiva il provisioning automatico dell'organizzazione cliente e degli utenti in Webex. (L'assegnazione del servizio IM&P determina che l'adattatore di provisioning chiami l'API di provisioning Webex). |
5 | I sistemi devono utilizzare l'API di provisioning Webex se successivamente è necessario regolare il pacchetto per l'utente (per passare dall'impostazione predefinita). |
Flusso di accesso SSO

Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, che consente l'autenticazione diretta a BroadWorks. L'immagine mostra gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresenta ciò che il client prevede per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.

Di seguito è riportato il flusso di rilevamento servizio BroadWorks che segue immediatamente il flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.

Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione BroadWorks diretta abilitata (condivisione risorse cross-origin). Di seguito sono riportati alcuni flussi di accesso SSO SAML alternativi:
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
L'unica differenza è nei punti 5 e 6 del flusso di accesso Webex. Nel passaggio 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
Il flusso procede attraverso i restanti passaggi dei due diagrammi.
Il token SSO non viene utilizzato in questo flusso.
Autenticazione SSO SAML Webex:
Nel passaggio 3 del flusso di accesso Webex, il servizio Common Identity restituisce il provider di identità utilizzato dall'autenticazione Webex.
A questo punto, viene invocato un flusso di accesso SSO SAML alternativo per Webex.
Interazioni utente
Accedi

L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
CI rileva che l'organizzazione cliente associata dispone del proxy IDP BroadWorks (IDP) configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso (il provider di servizi può contrassegnare questa pagina di accesso).
L'utente inserisce le credenziali BroadWorks.
Broadworks esegue l'autenticazione dell'utente attraverso l'IDP. In caso di successo, l'IDP reindirizza il browser a CI con un SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
Una volta completata l'autenticazione, l'app Webex ottiene i token di accesso da CI (non mostrati nel diagramma). Il client li utilizza per richiedere un token Web Jason (JWT) di lunga durata BroadWorks.
L'app Webex rileva la configurazione di chiamata da BroadWorks e altri servizi da Webex.
L'app Webex si registra in BroadWorks.
Accesso dalla prospettiva dell'utente
Questo diagramma è il tipico flusso di accesso, visualizzato dall'utente finale o dall'abbonato:

Scarica e installa l'app Webex.
È possibile che tu abbia ricevuto il collegamento dal provider di servizi o che tu possa trovare il download nella pagina di download di Webex.
Inserire l'indirizzo e-mail nella schermata di accesso Webex. Fai clic su Avanti.
Solitamente, si viene reindirizzati a una pagina con il marchio del fornitore di servizi.
Questa pagina potrebbe accogliervi tramite il vostro indirizzo e-mail.
Se non è presente alcun indirizzo e-mail o se l'indirizzo e-mail è errato, inserisci il nome utente BroadWorks.
Inserisci la password BroadWorks.
Se è stato eseguito correttamente l'accesso, Webex si apre.
Flusso chiamate - Rubrica aziendale

Flusso chiamata: numero PSTN

Presentazione e condivisione

Avvio di una riunione nello spazio

Interazioni con i clienti
Recupero del profilo dal registro DMS e SIP con AS
Il client chiama XSI per ottenere un token di gestione dispositivo e l'URL del DMS.
Il client richiede il proprio profilo dispositivo dal DMS presentando il token dal punto 1.
Il client legge il profilo del dispositivo e recupera le credenziali, gli indirizzi e le porte SIP.
Il Client invia un REGISTRO SIP a SBC utilizzando le informazioni dal punto 3.
SBC invia il REGISTRO SIP al SA (l'SBC può eseguire una ricerca nell'NS per individuare un SA se il SBC non conosce già l'utente SIP).
Linee guida per test e laboratorio
Le seguenti linee guida si applicano alle organizzazioni di test e laboratorio:
I partner provider di servizi sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
Tutti gli utenti oltre i primi 50 utenti di test verranno fatturati.
Per garantire un'elaborazione accurata sulla fattura, tutte le organizzazioni di test devono includere il "test" nel nome dell'organizzazione BroadWorks.
Le organizzazioni di test interni devono essere designate all'interno di Webex Control Hub. Ciò al fine di impedire agli utenti di test di essere fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di prova:
Accedi a Partner Hub e seleziona Clienti.
Selezionare il cliente appropriato.
Nella barra di controllo destra, abilitare il tasto di alternanza Organizzazione test interni.

Riproduzione casella vocale
Per la casella vocale, accertarsi di configurare il server multimediale per utilizzare uno dei seguenti codici:
mp3
wav: i file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android
Se si utilizzano i file wav, eseguire i seguenti comandi CLI per configurare il server applicazioni e il server multimediale:
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACIDITÀ
- Elenco di controllo accessi
- ALVEOLO
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APICI
- Servizio di notifica push Apple
- AS
- Server applicazioni
- ATA
- Adattatore per telefono analogico, adattatore che converte la telefonia analogica in VoIP
- BAMBOLA
- Gestione applicazioni BroadSoft
- Autenticazione base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- ALVEOLARE
- Server di messaggistica BroadSoft
- PALUDE
- Flussi bidirezionali Su HTTP sincrono
- BRI
- Basic Rate Interface BRI è un metodo di accesso ISDN
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico telefonico (cfr. partner, provider di servizi, rivenditore a valore aggiunto)
- CAPTCHA
- Test di Turing pubblico completamente automatizzato per distinguere Computer ed Esseri Umani
- CCXML
- Linguaggio di markup eXtensible controllo chiamate
- CIF
- Formato intermedio comune
- CLI
- Interfaccia riga di comando
- CN
- Nome comune
- CNPS
- Server push notifiche chiamate. Un server push notifiche che viene eseguito su un ADP XSP| nel proprio ambiente per eseguire notifiche di chiamata push su FCM e APNS. Vedere il proxy NPS.
- CPE
- Attrezzatura della sede del cliente
- CPR
- Regola presenza personalizzata
- CENERE
- Foglio stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione telefonia computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- NoDist
- Non disturbare
- DNS
- Sistema dei nomi di dominio
- DPG
- Chiama gruppo di pari
- DSCP
- Punto codice servizi differenziati
- DTAF
- File di archivio tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza a doppia tonalità
- Utente finale
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. Sottoscrittore)
- Aziendale
- Una raccolta di utenti finali (cfr. Organizzazione)
- FUSO
- Messaggistica cloud Firebase
- DI FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creare utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning completo flow-through
- Creare e verificare gli utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks e asserendo che ciascun utente BroadWorks dispone di un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. È la spina sul telefono o fax o i connettori sul sistema telefonico analogico. Fornisce un'indicazione di aggancio/aggancio sganciato (chiusura con loop). Poiché la porta FXO è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo FXO".
- FXS
- Foreign Exchange Subscriber è la porta che effettivamente fornisce la linea analogica all'abbonato. In altre parole, è la "spina nella parete" che fornisce un segnale di linea, corrente della batteria e tensione della suoneria.
- GABBIA
- Messaggio cloud Google
- GABBIA
- Modalità Galois/Counter (tecnologia di crittografia)
- HID
- Dispositivo interfaccia uomo
- HTTPS
- Prese protette da protocollo di trasferimento ipertestuale
- IAD
- Dispositivo di accesso integrato
- IM&P
- messaggistica istantanea e presenza
- PSTN IP
- Un provider di servizi che fornisce VoIP ai servizi PSTN, intercambiabile con ITSP, o un termine generale per la telefonia "pubblica" connessa a Internet, fornito collettivamente dai principali provider di telecomunicazioni (piuttosto che dai paesi, come è PSTN)
- ITSP
- Provider servizi di telefonia Internet
- IVR
- Risposta vocale/risponditore interattiva
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificatore Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notazione oggetto script Java
- JESS
- Java Secure Socket Extension; la tecnologia sottostante che fornisce funzioni di connettività sicure ai server BroadWorks
- KEM
- Modulo interno chiave (telefoni Cisco hardware)
- LLT
- Token di lunga durata (o Long Life): token di connessione autodescrittivo e sicuro che consente agli utenti di rimanere autenticati più a lungo e non è legato ad applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIGLIO
- Base di informazioni di gestione
- AVV.
- Server multimediale
- mTLS
- Autenticazione reciproca tra due parti, tramite scambio di certificati, quando si stabilisce una connessione TLS
- MUCO
- Chat con più utenti
- NAT
- Traduzioni dell'indirizzo di rete
- NPS
- Server push notifica; vedere CNPS
- Proxy NPS
-
Un servizio in Webex che fornisce token di autorizzazione di breve durata al CNPS, consentendo di eseguire notifiche di chiamata push a FCM e APN e, in ultima analisi, a dispositivi Android e iOS con Webex.
- ASSOCIAZIONE
- Apri interfaccia client
- Organizzazione
- Società o organizzazione che rappresentano un insieme di utenti finali (cfr. Impresa)
- OTG
- Gruppo di trunk in uscita
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- Partner
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. rivenditore a valore aggiunto, fornitore di servizi, gestore telefonico)
- PBX
- Borsa filiale privata
- DELLA SOCIETÀ
- E-mail avanzata per la privacy
- PIEDINO
- Rete mobile terrestre pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia per le telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- P.ES.
- Server profilo
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Sito web che consente all’amministratore del rivenditore di configurare la soluzione UC-One SaaS. Talvolta viene indicato come portale BAM, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Revisore di frontiera sessione
- CEMENTAZIONE
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; un'organizzazione che fornisce servizi di telefonia o correlati ad altre organizzazioni (cfr. vettore, partner, rivenditore a valore aggiunto)
- SIP
- Protocollo di avvio sessione
- SLITTA
- Token di breve durata (o Short Life) (chiamato anche BroadWorks SSO Token); token autenticato monouso utilizzato per accedere in sicurezza ad applicazioni Web.
- ODORE
- Piccole e medie imprese
- SNMP
- Protocollo di gestione di rete semplice
- sRTCP
- protocollo di controllo trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- sRTP
- protocollo di trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- SSL
- Strato di prese sicure
- Abbonato
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. utente finale)
- TCP
- Protocollo di controllo del cambio
- TDM
- Divisione Tempo Multiplexing
- TLS
- Sicurezza livello trasporto
- ToS
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Comunicazioni unificate
- UI
- Interfaccia utente
- U ID
- Identificativo univoco
- MUTI
- Server di messaggistica
- URI
- Identificativo risorsa uniforme
- URL
- Ricerca risorse uniformi
- DISTURBO
- Condivisione server
- UTC
- Coordinated Universal Time
- UVS.
- Server video
- Rivenditore a valore aggiunto (VAR)
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. vettore, partner, fornitore di servizi)
- VAMPATA
- Array di grafica video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Linguaggio di markup estensibile vocale
- WebDAV
- Creazione e versioni distribuite su Web
- WebRTC
- Comunicazioni Web in tempo reale
- WRS
- Server WebRTC
- XMPP
- Protocollo di presenza e messaggistica estendibile
Configurazione dei servizi (con mTLS per il servizio autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida token CI. Queste procedure sono obbligatorie se si stanno eseguendo più organizzazioni Webex dallo stesso server ADP XSP|. In caso contrario, sono facoltativi.
Se non si eseguono più organizzazioni Webex sullo stesso server ADP XSP|, si consiglia la convalida del token CI (con TLS) per il servizio di autenticazione. Fare riferimento a Configura servizi su Webex per Cisco BroadWorks XSP|ADPs per informazioni dettagliate su come configurare il servizio di autenticazione e altri servizi. |
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con mTLS)
I token longevi di BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sui tuoi XSP|ADP.
Requisiti
I server XSP|ADP che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
XSP|ADP devono condividere le stesse chiavi per crittografare/decrittografare token di lunga durata BroadWorks. Copiare queste chiavi in ogni XSP|ADP è un processo manuale.
Gli ADP XSP|devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli XSP|ADP include:
Distribuire il servizio di autenticazione.
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
Generare e condividere le chiavi RSA su XSP|ADP.
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ogni XSP|ADP utilizzato con Webex:
Attivare l'applicazione del servizio di autenticazione sul percorso
/authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService
(dove
<version>
è la versione BroadWorks).Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
deploy application /authService
Configurazione della durata del token
Verificare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
Impostare la durata su 60 giorni (max 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
set tokenDurationInHours 1440
Genera e condividi chiavi RSA
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori è necessario generare chiavi su un XSP|ADP quindi copiarle su tutti gli altri XSP|ADP.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP. |
Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web
Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token.
Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get

Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità per il servizio di autenticazione (con mTLS)
Accedi a Control Hub con l'account amministratore del partner.
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
.Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
.Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Esegui GuidaUpdateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot2023
,webexclientissuing
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte e quattro le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, è richiesto mTLS per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/HttpServer>
e eseguire ilget
comando per visualizzare le interfacce.Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che significa come mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. In sostanza, il primo
true
protegge l'interfaccia con TLS (il certificato del server viene creato se richiesto) e la secondatrue
forza l'interfaccia a richiedere l'autenticazione del certificato del client (insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Interface Port Name Secure Client Auth Req Cluster Fqdn
=======================================================
192.0.2.7 443 XSP|ADP01.collab.example.net true false
192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (autenticazione client richiesta = true) è abilitato il 192.0.2.7
porta 444
. TLS abilitato su 192.0.2.7
porta 443
.
(Opzione) Configurazione di mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, è necessario mTLS per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
e eseguire ilget
per visualizzare le applicazioni in esecuzione.Per aggiungere un'applicazione e richiederne l'autenticazione client (ovvero mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. I nomi delle applicazioni sono elencati qui. Il
true
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
add 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService a 192.0.2.7:443 e richiede di richiedere e autenticare i certificati dal client.
Verifica con get
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
get
Interface Ip Port Application Name Client Auth Req
===================================================
192.0.2.7 443 AuthenticationService true
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Dove andare Avanti
Per la configurazione, è possibile accedere nuovamente al flusso dei documenti principale all'interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca rispetto a AuthService
Webex interagisce con il servizio di autenticazione su una connessione TLS autenticata reciproca. Ciò significa che Webex presenta un certificato client e che XSP|ADP deve convalidarlo. Per garantire l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora attendibile su XSP|ADP (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
Vai a Impostazioni > BroadWorks Calling.
Fare clic sul collegamento del certificato di download.
È inoltre possibile scaricare la catena di certificati da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt. |
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il diagramma seguente riassume dove deve essere distribuita la catena di certificati CA Webex in questi tre casi.

Requisiti del certificato TLS reciproco per proxy bridge TLS
Webex presenta un certificato client firmato da CA Webex al proxy.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità proxy, pertanto il proxy considera attendibile il certificato del client.
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta un certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions:
X509v3 Extended Key Usage:
1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Requisiti di certificato TLS reciproco per proxy passthrough TLS o XSP in DMZ
Webex presenta un certificato client firmato da CA Webex agli XSP.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità degli XSP, pertanto gli XSP si affidano al certificato client.
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
Gli XSP presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i certificati server degli XSP.
Cronologia revisioni documenti
La tabella seguente mostra lo storico delle modifiche apportate a questo documento negli ultimi 12 mesi.
Data | Versione | Descrizione della modifica | |
---|---|---|---|
24 febbraio 2024 | 2-110 |
| |
20 febbraio 2024 | 2-109 |
| |
7 febbraio 2024 | 2-108 |
| |
25 gennaio 2024 | 2-107 |
| |
23 gennaio 2024 | 2-106 |
| |
10 gennaio 2024 | 2-105 |
| |
20 dicembre 2023 | 2-104 |
| |
13 dicembre 2023 | 2-103 |
| |
12 dicembre 2023 | 2-102 |
| |
8 dicembre 2023 | 2-101 |
| |
08 novembre 2023 | 2-100 |
| |
25 ottobre 2023 | 2-99 |
| |
13 settembre 2023 | 2-98 |
| |
04 settembre 2023 | 2-97 |
| |
08 agosto 2023 | 2-96 |
| |
23 giugno 2023 | 2-95 |
| |
30 maggio 2023 | 2-94 |
| |
26 maggio 2023 | 2-93 |
| |
24 maggio 2023 | 2-92 |
| |
10 maggio 2023 | 2-91 |
| |
09 maggio 2023 | 2-90 |
| |
4 maggio 2023 | 2-89 |
| |
27 aprile 2023 | 2-88 |
| |
14 aprile 2023 | 2-87 |
| |
17 marzo 2023 | 2-86 |
| |
11 marzo 2023 | 2-85 |
| |
10 marzo 2023 | 2-84 |
| |
7 marzo 2023 | 2-83 |
| |
28 febbraio 2023 | 2-82 |
| |
15 febbraio 2023 | 2-81 |
| |
10 febbraio 2023 | 2-80 |
| |
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione si rivolge agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei propri clienti o forniscono questa soluzione direttamente ai propri abbonati.
Scopo della soluzione
Fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che già dispongono del servizio di chiamata fornito dai provider di servizi BroadWorks.
Fornire il servizio di chiamata basato su BroadWorks a clienti Webex piccoli e medi.
Contesto
Stiamo evolvendo tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo sforzo consiste nello spostare le funzionalità di chiamata BroadWorks nell'app Webex e infine ridurre gli investimenti nei client UC-One.
Vantaggi
Prova futura: contro interruzione del servizio di UC-One Collaborate, spostamento di tutti i client verso Unified Client Framework (UCF)
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex mantenendo la chiamata BroadWorks sulla rete di telefonia
Ambito della soluzione
Clienti da piccoli a medi esistenti/nuovi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre di chiamate BroadWorks.
Clienti Webex esistenti di piccole e medie dimensioni che desiderano aggiungere BroadWorks Calling.
Non aziende più grandi (rivedere il nostro portfolio Enterprise per Webex).
Non utenti singoli (valutare le offerte Webex Online).
Le funzioni impostate in Webex per Cisco BroadWorks riguardano casi d'uso di piccole e medie imprese. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità per le PMI e ne valutiamo costantemente l'idoneità per questo segmento. Possiamo scegliere di nascondere o rimuovere funzioni che sarebbero altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# | Requisito | Note | ||
---|---|---|---|---|
1 | Patch BroadWorks R22 corrente o superiore | |||
2 | XSP|ADP per XSI, CTI, DMS e authService | XSP|ADP dedicato per Webex per Cisco BroadWorks | ||
3 | XSP|ADP separato per NPS, può essere condiviso con altre soluzioni che utilizzano NPS. | Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni XSP|ADP e NPS. | ||
4 | Convalida token CI (con TLS) configurata per le connessioni Webex al servizio di autenticazione. | |||
5 | mTLS configurato per le connessioni Webex all'interfaccia CTI. | Altre applicazioni non richiedono mTLS. | ||
6 | Gli utenti devono essere presenti in BroadWorks e necessitano dei seguenti attributi, a seconda della decisione di provisioning:
| Per i messaggi e-mail attendibili: Si consiglia di inserire lo stesso indirizzo e-mail anche nell'attributo ID alternativo, per consentire agli utenti di accedere con indirizzo e-mail rispetto a BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'uso di e-mail non attendibili può causare l'invio dell'e-mail alla cartella Posta indesiderata o SPAM dell'utente. L'amministratore potrebbe dover modificare le impostazioni e-mail dell'utente per consentire i domini | ||
7 | Webex per il file DTAF Cisco BroadWorks per l'app Webex | |||
8 | Utente BW Business Lic o Std Enterprise o Prem Enterprise Lic + Webex per abbonamento Cisco BroadWorks | Se si dispone di una distribuzione di collaborazione esistente, non è più necessario il pacchetto aggiuntivo UC-One, le porte per conferenze Collab Lic e Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non occorre apportare altre modifiche se non accettare i termini del pacchetto Premium. | ||
9 | IP/porte devono essere accessibili attraverso i servizi backend Webex e le app Webex su Internet pubblico. | Vedere la sezione "Preparazione della rete". | ||
10 | Configurazione TLS v1.2 su XSP|ADP | |||
11 | Per il provisioning Flowthrough, il server applicazioni deve connettersi all'adattatore di provisioning BroadWorks.
| Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è aiutarti a comprendere, preparare, distribuire e gestire la tua soluzione Webex per Cisco BroadWorks. Le principali sezioni del documento riflettono tale obiettivo.
Questa guida include materiale concettuale e di riferimento. In questo documento intendiamo trattare tutti gli aspetti della soluzione.
La serie minima di attività per distribuire la soluzione è la seguente:
Contatta il team dell'account per diventare un partner Cisco. È fondamentale esplorare i punti di contatto Cisco per acquisire familiarità (e ricevere formazione). Quando si diventa partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Onboarding partner in questo documento.
Configura i tuoi sistemi BroadWorks per l'integrazione con Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento.
Usa Partner Hub per connettere Webex a BroadWorks. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione partner in Partner Hub in questo documento.
Utilizzare Partner Hub per preparare i modelli di provisioning degli utenti. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento.
Testare e eseguire l'onboarding di un cliente mediante il provisioning di almeno un utente (vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
|
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. (Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto).
Come funziona
Webex per Cisco BroadWorks è un'offerta che integra BroadWorks Calling in Webex. Gli abbonati utilizzano una singola applicazione (l'app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
Gli utenti chiamano i numeri PSTN utilizzando l'infrastruttura BroadWorks.
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino numerico per introdurre i numeri).
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Chiamata Webex" sull'app Webex. (Queste chiamate sono da app Webex a app Webex, non da app Webex a PSTN).
Gli utenti possono organizzare e accedere a Webex Meetings.
Gli utenti possono scambiarsi messaggi uno a uno o in spazi (chat di gruppo persistente) e beneficiare di funzioni come ricerca e condivisione file (sull'infrastruttura Webex).
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
Una volta eseguito l'onboarding come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare la relazione tra l'istanza BroadWorks e Webex.
È possibile creare organizzazioni dei clienti in Control Hub e eseguire il provisioning degli utenti in tali organizzazioni.
Ogni abbonato in BroadWorks riceve un'identità Webex in base al proprio indirizzo e-mail (attributo ID e-mail in BroadWorks).
Gli utenti eseguono l'autenticazione su BroadWorks o su Webex.
Ai clienti vengono rilasciati token di lunga durata per autorizzarli per i servizi su BroadWorks e Webex.
L'app Webex al centro di questa soluzione, è un'applicazione personalizzabile disponibile su desktop Mac/Windows e dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzionalità di messaggistica, presenza e riunioni.
Il client esegue la registrazione ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i tuoi sistemi BroadWorks per garantire un'esperienza di provisioning utente perfetta.
Funzioni e limitazioni
Offriamo diversi pacchetti con diverse caratteristiche.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata, ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano nella rubrica un utente softphone, i risultati della ricerca non forniscono alcuna opzione per inviare un messaggio.
Gli utenti del softphone possono condividere lo schermo durante una chiamata.
Pacchetto "base"
Il pacchetto di base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti in riunioni a "spazio unificato" e riunioni nella sala riunioni personale. (** vedere la seguente nota a titolo di eccezione). In questo pacchetto le riunioni possono avere una durata massima di 40 minuti.
Pacchetto "Standard"
Questo pacchetto include anche tutto quello che è contenuto nel pacchetto Base, ad esempio fino a 100 partecipanti nelle riunioni "spazio unificato" e nelle riunioni nella sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è un ruolo inizialmente ricoperto solo dall'organizzatore della riunione, ma l'organizzatore può passare il "ruolo di relatore" a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può riprendere il ruolo di relatore senza che l'organizzatore corrente glielo passi.
Pacchetto "Premium"
Questo pacchetto include tutto nel pacchetto Standard più un massimo di 300 partecipanti in una riunione "spazio unificato" e fino a 1000 partecipanti in una sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è supportata per qualsiasi partecipante alla riunione.
Confronta pacchetti
Pacchetto | Chiamata | Messaggistica | Riunioni nello spazio Unified | PMR riunioni |
---|---|---|---|---|
Softphone | Incluso | Non incluso | Nessuno | Nessuno |
Base | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Standard | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Premium | Incluso | Incluso | 300 partecipanti | 1000 partecipanti |
Il limite della riunione nello spazio Unified per gli utenti Base è 100 partecipanti per riunione nello spazio Unified a meno che lo spazio non includa anche gli utenti a cui sono assegnati i pacchetti "Standard" o "Premium", nel qual caso il limite aumenta in base al pacchetto utente organizzatore. |
"Riunioni nello spazio Unified" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti "Riunione" o "Pianifica". "Riunioni PMR" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale (PMR) di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID). |
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per le differenze di supporto delle funzioni di riunione PMR per i pacchetti Base, Standard e Premium.
Funzione riunione | Supportato con il pacchetto base | Suported con pacchetto standard | Supportato con il pacchetto Preminum | Commento |
---|---|---|---|---|
Durata riunione | 40 minuti o meno | Illimitato | Illimitato | |
Condivisione desktop | Sì | Sì | Sì | Base: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione desktop solo da parte dell'organizzatore della riunione PMR. Premium: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. |
Condivisione applicazione | Sì | Sì | Sì | Base: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione delle applicazioni solo da parte dell'organizzatore della riunione PMR. Premium: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. |
Chat con più interlocutori | Sì | Sì | Sì | |
Lavagna | Sì | Sì | Sì | |
Protezione con password | Sì | Sì | Sì | |
App Web - nessun download o plug-in (Esperienza ospite) | Sì | Sì | Sì | |
Supporto dell'accoppiamento con i dispositivi Webex | Sì | Sì | Sì | |
Controllo del pavimento (disattivazione del microfono uno / espulsione tutti) | Sì | Sì | Sì | |
Collegamento Riunioni persistenti | Sì | Sì | Sì | |
Accesso sito riunioni | Sì | Sì | Sì | |
Accesso alla riunione tramite VoIP | Sì | Sì | Sì | |
Bloccaggio | Sì | Sì | Sì | |
Controlli relatore | No | No | Sì | |
Controllo desktop remoto | No | No | Sì | |
Numero di partecipanti | 100 | 100 | 1000 | |
Registrazione salvata in locale nel sistema | Sì | Sì | Sì | |
Registrazione nel cloud | No | No | Sì | |
Registrazione - Cloud Storage | No | No | 10 GB per sito | |
Trascrizione delle registrazioni | No | No | Sì | |
Pianificazione riunione | Sì | Sì | Sì | |
Abilita condivisione contenuto con integrazioni esterne | No | No | Sì | Base: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. Standard: condivisione di contenuto solo da parte dell'organizzatore della riunione PMR. Premium: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. |
Consenti modifica URL PMR | No | No | Sì | Base: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori dei partner e delle organizzazioni possono modificare l'URL da Control Hub. Standard: l'URL PMR può essere modificato solo da Partner Hub per Partner e amministratori organizzazione. Premium: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori partner e dell'organizzazione possono modificare l'URL da Partner Hub. |
Streaming in diretta riunioni (Ad Esempio, su Facebook, Youtube) | No | No | Sì | |
Consenti ad altri utenti di pianificare riunioni per loro conto | No | No | Sì | |
Aggiungi organizzatore alternativo | Sì | No | Sì | |
Integrazione app (es., Zendesk, Slack) | Dipende dall'integrazione | Dipende dall'integrazione | Sì | Per ulteriori informazioni sul supporto, vedere la sezione Integrazioni app riportata di seguito. |
Integrazione con il calendario Microsoft Office 365 | Sì | Sì | Sì | |
Integrazione con Google Calendaring per G Suite | Sì | Sì | Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione rivolta agli utenti per Webex su help.webex.com
. Per ulteriori informazioni sulle funzioni, leggere i seguenti articoli:
Funzioni di chiamata
L'esperienza di chiamata è simile alle soluzioni precedenti che utilizzano il motore di controllo delle chiamate BroadWorks. La differenza tra UC-One Collaborate e UC-One SaaS è che l'app Webex è il client software principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
Zendesk—Solo Premium
Slack: solo Premium
Microsoft Teams per Webex Meetings—Standard o Premium
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
Calendario Office 365—Standard o Premium
Google Calendaring per G Suite: standard o premium
Supporto dell'infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta gli ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione per Webex per l'infrastruttura desktop virtuale (VDI).
Supporto per IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Tabella di marcia futura
Per informazioni sulle nostre intenzioni per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Le voci della roadmap non sono vincolanti in alcuna capacità. Cisco si riserva il diritto di sospendere o rivedere uno o tutti questi elementi dalle release future.
Limiti
Limitazioni di provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario del sito Webex Meetings creato per tale pacchetto.
Se nella richiesta di provisioning per il primo utente di ciascun pacchetto non viene specificato alcun fuso orario, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sull'impostazione predefinita regionale dell'organizzazione degli abbonati.
Se il cliente necessita di uno specifico fuso orario del sito di Webex Meetings, specificare timezone
parametro nella richiesta di provisioning per:
il primo abbonato predisposto per il pacchetto Standard nell'organizzazione.
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
il primo abbonato predisposto per il pacchetto base nell'organizzazione.
Limitazioni generali
Nessuna chiamata nella versione Web del client Webex (questa è una limitazione del client, non una limitazione della soluzione).
Webex potrebbe non disporre ancora di tutti i controlli dell'interfaccia utente per supportare alcune funzioni di controllo delle chiamate disponibili da BroadWorks.
Attualmente, il client Webex non può essere "White Labeled" (etichetta bianca).
Quando si creano le organizzazioni dei clienti utilizzando il metodo di provisioning scelto, vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. Ci aspettiamo che i partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
I report sull'utilizzo di riunioni e messaggi sono disponibili attraverso l'organizzazione del cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti di messaggistica
I seguenti limiti di archiviazione dei dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo storage massimo per messaggistica e file combinati.
Di base: 2 GB per utente per 3 anni
Standard 5 GB per utente per 3 anni
Premio: 10 GB per utente per 5 anni
Per ciascuna organizzazione del cliente, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti premium ha un limite totale di messaggistica e storage file di 50 GB. Un singolo utente può superare il limite per utente (10 GB), a condizione che la società sia ancora al di sotto del massimo aggregato (50 GB).
Per gli spazi team creati, i limiti di messaggistica vengono applicati al totale aggregato per l'organizzazione cliente che possiede lo spazio team. Puoi trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti generali di messaggistica applicabili agli spazi dei team di messaggistica Webex, fare riferimento a https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure le connessioni a Webex e BroadWorks. I dati memorizzati nel cloud Webex ed esposti all'utente attraverso l'interfaccia dell'app Webex sono crittografati sia in transito che a riposo.
Maggiori dettagli sullo scambio di dati sono disponibili nella sezione Riferimento del presente documento.
Ulteriori letture
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati che più si avvicina alla propria regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore del provider di servizi (utente): Per le attività di manutenzione quotidiane, si gestiscono le parti della soluzione in sede (chiamata) utilizzando i propri sistemi. Gestisci le parti Webex della soluzione attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale.
Il primo utente predisposto per un nuovo organizzatore partner viene assegnato automaticamente ai ruoli amministratore completo e amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi. |
Team operativo di Cisco cloud: Crea la tua "organizzazione partner" in Partner Hub, se non esiste, durante l'onboarding.
Una volta ottenuto l'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente, create "Onboarding templates" (Modelli di onboarding) per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Quindi si fornisce i vostri clienti o abbonati.
# | Compito tipico | SP | Cisco |
---|---|---|---|
1 | Onboarding partner - Creazione dell'organizzazione partner se non esiste e abilitazione dei tasti di alternanza funzione necessari | ● | |
2 | Configurazione BroadWorks nell'organizzazione partner tramite Partner Hub (cluster) | ● | |
3 | Configurazione delle impostazioni di integrazione in Organizzazione partner tramite Partner Hub (modelli di offerta, branding) | ● | |
4 | Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|ADP Patching, firewall, configurazione XSP|ADP, XSI, AuthService, CTI, NPS, applicazioni DMS su XSP|ADP) | ● | |
5 | Sviluppo dell'integrazione o del processo di provisioning | ● | |
6 | Preparare i materiali GTM | ● | |
7 | Migrazione o provisioning di nuovi utenti | ● |
Architettura
Cosa c'è nel diagramma?
Client
Il client dell'app Webex serve come applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di messaggistica nativa, presenza e riunioni audio/video multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per le chiamate SIP e PSTN.
I telefoni IP Cisco e i relativi accessori utilizzano anche l'infrastruttura BroadWorks per le chiamate SIP e PSTN. Ci aspettiamo di essere in grado di supportare telefoni di terze parti.
Portale di attivazione utente per gli utenti che accedono a Webex utilizzando le credenziali BroadWorks.
Partner Hub è un'interfaccia Web per l'amministrazione dell'organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. Puoi anche utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
Rete di provider di servizi
Il blocco verde a sinistra dello schema rappresenta la tua rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
XSP|ADP rivolto al pubblico, per Webex per Cisco BroadWorks: (La scatola rappresenta una o più fattorie XSP|ADP, eventualmente frontali da bilanciatori di carico).
Ospita l'interfaccia dei servizi Xtended (XSI-Actions & XSI-Events), il servizio di gestione dei dispositivi (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato del ricevitore dell'altro (presenza di telefonia) e la cronologia chiamate.
Pubblica la rubrica ai client Webex.
XSP|ADP rivolto al pubblico, con NPS in esecuzione:
server push notifiche chiamate organizzatore: Un server push di notifica su un ADP XSP| nel proprio ambiente. Si interfaccia tra il server applicazioni e il proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS & FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
Server applicazioni:
Fornisce il controllo delle chiamate e le interfacce ad altri sistemi BroadWorks (generalmente)
Per il provisioning flowthrough, l'AS viene utilizzato dall'amministratore del partner per il provisioning degli utenti in Webex
Inserisce il profilo utente in BroadWorks
OSS/BSS: Sistema di supporto alle operazioni/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nello schema rappresenta il cloud Webex. I microservizi Webex supportano l'intero spettro di funzionalità di collaborazione Webex:
Cisco Common Identity (CI) è il servizio identità all'interno di Webex.
Webex per Cisco BroadWorks rappresenta la serie di microservizi che supportano l'integrazione tra Webex e BroadWorks ospitato da provider di servizi:
API di provisioning utente
Configurazione provider di servizi
Accesso utente mediante credenziali BroadWorks
Casella di messaggistica Webex per microservizi correlati alla messaggistica.
Casella Webex Meetings che rappresenta server di elaborazione multimediale e SBC per riunioni video con più partecipanti (SIP e SRTP)
Servizi Web di terze parti
Nello schema sono rappresentati i seguenti componenti di terze parti:
APNS (Apple Push Notifications Service) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Apple.
FCM (messaggistica cloud FireBase) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Il ruolo dei server XSP|ADP aperti al pubblico in Webex per Cisco BroadWorks
L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste Webex per BroadWorks JWT (JSON Web Token) per conto dell'utente
Interfaccia CTI, protetta da mTLS, a cui Webex sottoscrive gli eventi della cronologia chiamate e lo stato della presenza di telefonia da BroadWorks (stato hook).
Interfacce azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate degli abbonati, rubriche di elenchi di contatti e chiamate e configurazione del servizio di telefonia per gli utenti finali
Servizio DM (Device Management) per il recupero dei file di configurazione delle chiamate da parte dei client
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedere Configurazione dei cluster BroadWorks in Partner Hub in questo documento. Per ciascun cluster, è possibile fornire un solo URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP
È necessario utilizzare un'istanza ADP XSP|dedicata o un'azienda agricola separata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile organizzare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso XSP|ADP che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/azienda agricola ADP XSP| dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
Ad esempio, se offri UC-One SaaS, ti consigliamo di creare una nuova fattoria XSP|ADP per Webex per Cisco BroadWorks. In questo modo i due servizi possono operare in modo indipendente durante la migrazione degli abbonati.
Se si collocano le applicazioni Webex per Cisco BroadWorks in una fattoria ADP|XSP utilizzata per altri scopi, è responsabilità dell'utente monitorare l'utilizzo, gestire la complessità risultante e pianificare l'aumento della scala.
Il pianificatore della capacità di sistema Cisco BroadWorks assume una fattoria ADP XSP| dedicata e potrebbe non essere preciso se la si utilizza per i calcoli della posizione.
Se non diversamente specificato, gli Webex dedicati per Cisco BroadWorks XSP|ADP devono ospitare le seguenti applicazioni:
AuthService (TLS con convalida token CI o mTLS)
CTI (mTLS)
Azioni XSI (TLS)
XSI-Events (TLS)
DMS (TLS): opzionale. Non è obbligatorio distribuire un'istanza DMS o un'azienda agricola separata specificamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
TLS (Call Settings Webview): opzionale. La vista Webview (CSW) delle impostazioni di chiamata è richiesta solo se si desidera che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso a CTI attraverso un'interfaccia protetta dall'autenticazione TLS reciproca. Per supportare questo requisito, raccomandiamo una delle seguenti opzioni:
(Diagramma etichettato Opzione 1) Una istanza XSP|ADP o un'azienda agricola per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
(Diagramma etichettato Opzione 2) Due istanze ADP XSP| o aziende agricole, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSP|ADP Se si dispone di una fattoria ADP XSP|esistente conforme a una delle architetture suggerite sopra (Opzione 1 o 2) ed è leggermente caricata, è possibile riutilizzare le ADP XSP|esistenti. Dovrai verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti dell'applicazione per Webex. Le due considerazioni principali sono:
Poiché gli XSP|ADP hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero esserci altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di XSP|ADP deve essere verificato in un laboratorio con la configurazione desiderata prima di impegnarsi per il riutilizzo. |
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione temporale per tutti gli XSP|ADP utilizzati con Webex.
Installare il ntp
pacchetto dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Quindi è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, consultare la Guida alla gestione del software BroadWorks.
Durante l'installazione interattiva del software XSP|ADP, è possibile configurare NTP. Procedere come segue:
Quando l'installatore chiede,
Do you want to configure NTP?
, immetterey
.Quando l'installatore chiede,
Is this server going to be a NTP server?
, immetteren
.Quando l'installatore chiede,
What is the NTP address, hostname, or FQDN?
, immettere l'indirizzo del server NTP o un servizio NTP pubblico, ad esempio,pool.ntp.org
.
Se gli ADP XSP|utilizzano un'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie Key=Value:
NTP
NTP_SERVER=<NTP Server address, e.g., pool.ntp.org>
Requisiti di identità e sicurezza XSP|ADP
Sfondo
I protocolli e le crittografie delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli vanno dal più generale (provider SSL) al più specifico (interfaccia singola). Un'impostazione più specifica sostituisce sempre un'impostazione più generale. Se non sono specificate, le impostazioni SSL di livello "inferiore" vengono ereditate da livelli "superiori".
Se non viene modificata alcuna impostazione rispetto alle impostazioni predefinite, tutti i livelli ereditano le impostazioni predefinite del provider SSL (JSSE Java Secure Sockets Extension).
Elenco dei requisiti
L'|ADP XSP deve autenticarsi sui client utilizzando un certificato firmato da CA in cui il nome comune o il nome alternativo oggetto corrispondono alla parte di dominio dell'interfaccia XSI.
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
Diffie-Hellman Effemeral (DHE) o curve ellittiche Diffie-Hellman Effemeral (ECDHE) chiave-scambio
Crittografia AES (Advanced Encryption Standard) con una dimensione minima di blocco di 128 bit (ad esempio, AES-128 o AES-256)
Modalità di codifica GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
Se viene utilizzata una crittografia CBC, solo la famiglia SHA2 di funzioni hash è consentita per derivazione chiave (SHA256, SHA384, SHA512).
Ad esempio, le seguenti crittografie soddisfano i requisiti:
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come illustrato sopra, non la convenzione openSSL. |
Crittografie TLS supportate per le interfacce AuthService e XSI
Questo elenco è soggetto a modifiche a mano a mano che evolvono i nostri requisiti di sicurezza del cloud. Seguire l'attuale raccomandazione sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento. |
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_128_GCM_SHA256
TLS_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA256
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_256_CBC_SHA
TLS_PSK_WITH_AES_256_CBC_SHA384
TLS_PSK_WITH_AES_256_CBC_SHA
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA
TLS_PSK_WITH_AES_128_CBC_SHA256
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri della scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il numero di thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi visualizzati come segue (non diminuirli se sono al di sopra di questi valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più |ADP XSP
Elemento bordo bilanciamento carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, deve gestire in modo trasparente la distribuzione del traffico tra più server XSP|ADP e il cloud e i client Webex per Cisco BroadWorks. In questo caso, è possibile fornire l'URL del bilanciatore di carico alla configurazione Webex per Cisco BroadWorks.
Note su questa architettura:
Configurare il DNS in modo che i client possano trovare il bilanciatore di carico quando si connettono all'interfaccia Xsi (vedere configurazione DNS).
Si consiglia di configurare l'elemento edge in modalità proxy SSL inversa per garantire la crittografia dei dati punto a punto.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Server XSP|ADP orientati verso Internet
Se si espongono direttamente le interfacce Xsi, utilizzare il DNS per distribuire il traffico ai più server XSP|ADP.
Note su questa architettura:
Per connettersi ai server XSP|ADP sono necessari due record:
Per i microservizi Webex: Per targetizzare più indirizzi IP XSP|ADP sono necessari record A/AAAA round-robin. Questo perché i microservizi Webex non possono effettuare ricerche SRV. Per esempi, vedere Servizi cloud Webex.
Per l'app Webex: Un record SRV che si risolve in record A in cui ogni record A si risolve in un singolo XSP|ADP. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per targetizzare il servizio XSI per più indirizzi XSP|ADP. Assegnare la priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (e all'indirizzo IP successivo) e passino al record A successivo (e all'indirizzo IP) solo se il primo indirizzo IP è inattivo. NON utilizzare un approccio round-robin per l'app Webex.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune.
È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL XSP|ADP di un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server XSP|ADP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.
Ordinazione e provisioning
L'ordine e il provisioning si applicano a questi livelli:
Provisioning di partner/provider di servizi:
Ogni onboarding di Webex per provider di servizi Cisco BroadWorks (o rivenditore) deve essere configurato come organizzazione partner in Webex e devono essere concesse le autorizzazioni necessarie. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per gestire Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le operazioni di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/aziendale.
Ordinazione e provisioning clienti/aziende:
Ogni BroadWorks Enterprise abilitato per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo si verifica automaticamente come parte del provisioning utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks vengono predisposti nella stessa organizzazione cliente Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
Ordinazione e provisioning utente/abbonato:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning degli utenti:
Provisioning fluviale con e-mail attendibili
Provisioning eseguibile senza e-mail attendibili
Self-provisioning utente
Provisioning API
Provisioning eseguibile con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile affermare che BroadWorks dispone di indirizzi e-mail abbonati validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Provisioning eseguibile senza e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non puoi contare sugli indirizzi e-mail degli abbonati detenuti da BroadWorks, questa opzione di provisioning crea account Webex ma non può attivarli fino a quando gli abbonati non forniscono e convalidano i relativi indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Self-provisioning utente
Con questa opzione, non è disponibile il provisioning flowthrough da BroadWorks a Webex. Una volta configurata l'integrazione tra Webex e il sistema BroadWorks, vengono visualizzati uno o più collegamenti specifici per il provisioning degli utenti all'interno dell'organizzazione partner Webex per Cisco BroadWorks.
Successivamente, si progettano le proprie comunicazioni (o si delegano ai clienti) per distribuire il collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account vengono predisposti nell'ambito dell'organizzazione partner, puoi regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare tale operazione.
Gli utenti devono esistere nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento. |
Provisioning provider di servizi per API
Webex presenta un set di API pubbliche che consentono di creare il provisioning utente/abbonato Webex per Cisco BroadWorks nel flusso di lavoro/negli strumenti di gestione utenti esistenti.
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti Webex per Cisco Broadworks di comporre altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella rubrica Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo dell'estensione di tutte le aree del metodo di avvio chiamata e del profilo dell'utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e gruppi diversi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due imprese che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Utenti Cisco BroadWorks
Provisioning API pubblica come 'interno
Il parametro dell'interno deve essere esplicitamente passato come parte della chiamata API. Per le imprese/gruppi con Location Dialing Code (LDC) configurato, il parametro dell'interno dovrebbe essere la combinazione di LDC e 'numero di interno.
Provisioning flusso o auto-attivazione
Estensione e LDC (se applicabile) saranno automaticamente recuperati da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione di codice di chiamata posizione (LDC) e numero di interno.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'interno |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'estensione deve essere passata come parametro |
Attraverso il flusso | Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Elenchi telefonici BroadWorks | Elenchi telefonici aziendali, di gruppo o personali | Sincronizzazione rubriche | Non applicabile |
Prerequisiti
La versione del client richiesta per supportare questa funzione è 42.11 o successiva.
Patch in cui i codici di chiamata di estensione e posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
AP.platform.23.0.1075.ap380045
AP.as.23.0.1075.ap380045
AP.xsp.23.0.1075.ap380045
AP.as.24.0.944.ap380045
Abilitare l'intestazione X-BroadWorks-Remote-Party-Info su AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP richiesto per il supporto della funzione di composizione dell'interno.
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata a interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità delle chiamate di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'estensione come seconda opzione in Partner Hub e Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con estensione attraverso uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione dell'interno sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Non verrà visualizzata un'estensione nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere visibile l'opzione di chiamata dell'interno per i clienti esistenti:
Se un partner desidera che tutte le organizzazioni dei clienti gestite siano dotate di un interno come una delle opzioni di chiamata, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
Se un partner desidera fornire un interno in opzioni di chiamata per una specifica organizzazione cliente, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e portarli alla pari con l'aumento di 30K contatti per l'elenco telefonico Enterprise, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per Organizzazione, che si applica alla somma degli elenchi telefonici Enterprise e Group in una singola azienda BroadWorks. Ad esempio, sarà supportato un'azienda BroadWorks che dispone di un elenco di telefoni aziendali con 30K e anche di 5 elenchi di telefoni di gruppo ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K totali).
Questa funzione è disponibile su richiesta. Contatta il team dell'account per abilitare questa opzione.
|
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks nello storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare a quale gruppo appartiene questo utente. L'associazione dell'utente con un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca dei contatti nello storage del gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning degli abbonati Webex per BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
È possibile eseguire il provisioning dell'ID gruppo aziendale BroadWorks per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Webex per gli utenti Cisco BroadWorks
Provisioning API pubblica come "spEnterpriseGroupId"
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
Provisioning flusso o auto-attivazione
L'ID gruppo aziendale BroadWorks verrà automaticamente recuperato da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Non applicabile. Non è necessario sincronizzare l'ID gruppo aziendale BroadWorks per questi utenti.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'ID gruppo aziendale BroadWorks deve essere superato come parametro spEnterpriseGroupId |
Attraverso il flusso | L'ID gruppo aziendale BroadWorks viene recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Non applicabile |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Non applicabile |
Elenchi telefonici BroadWorks | Contatti negli elenchi telefonici del gruppo BroadWorks | Sincronizzazione rubriche | I contatti di gruppo vengono memorizzati nel servizio Webex Contact associato al gruppo specifico |
Elenchi di telefoni BroadWorks Enterpsie o Persional | Contatti negli elenchi telefonici aziendali o personali | Sincronizzazione rubriche | Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. Impossibile completare la migrazione fino a quando QUESTA API non viene completata. L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march Una volta abilitata la funzione e a seguito della sincronizzazione della rubrica successiva, i gruppi di utenti aziendali verranno visualizzati anche in Control Hub. La visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativa in questa fase. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza a un gruppo in Control Hub poiché tali modifiche non verranno riportate nuovamente in BroadWorks. La gestione di gruppo in Control Hub è destinata all'uso da parte dei partner che adotteranno le prossime API di gestione contatti. |
Migrazione e prova del futuro
La progressione Cisco del client di comunicazione unificata BroadSoft deve spostarsi da UC-One a Webex. Si verifica una corrispondente progressione dei servizi di supporto dalla rete del provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che tu stia eseguendo UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita consiste nel distribuire nuovi ADP|XSP dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti in Webex e infine recuperare l'infrastruttura utilizzata per la soluzione precedente.
Sottoscrizioni di documenti consigliate
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Abbonati che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di eseguire l'abbonamento a ciascuno dei seguenti articoli per assicurarsi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per iscriversi, accedere a ciascuno dei link seguenti e nell'articolo che viene visualizzato fare clic sul pulsante Iscriviti.
Come minimo, si consiglia di iscriversi all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati in Documenti aggiuntivi dispone di un'opzione Sottoscrivi . Affinché questa opzione venga visualizzata, l'articolo deve essere visualizzato su help.webex.com.
Non esiste un'opzione di abbonamento per le landing page di documentazione. |
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Documenti Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
Porta la tua soluzione PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono di loro proprietà (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive come eseguire l'onboarding e il servizio dei dispositivi Room OS e MPP.
Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi di Webex per Cisco BroadWorks.
Articoli Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti siti opzionali per ulteriori informazioni su Webex per Cisco BroadWorks:
Documentazione Webex per Cisco BroadWorks: nella pagina di destinazione vengono elencati i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme a quelle presto disponibili.
Problemi noti e limitazioni: informazioni sui problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale: questo articolo descrive come assegnare i ruoli amministratore partner per le organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte della soluzione Cisco BroadWorks:
Articoli della Guida Webex
I seguenti siti della Guida Webex possono essere utilizzati per trovare gli articoli Webex che consentono agli amministratori dei clienti e agli utenti finali di utilizzare le funzioni Webex.
Webex da provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati comunemente per gli utenti dell'app Webex che hanno acquistato i servizi Webex da un provider di servizi.
Centro assistenza Webex: utilizzare la funzione di ricerca su help.webex.com per cercare altri articoli Webex che descrivono la funzionalità dell'app Webex e di Webex Meetings. È possibile ricercare gli articoli utente o amministratore.
Documentazione sviluppatore
Guida per sviluppatori Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Punti di decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastrutture
|
Quanti ADP XSP|? Come prendono l'mTLS? |
Pianificatore capacità di sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento CLI XSP|ADP Il presente documento |
Provisioning cliente e utente | Puoi affermare che ti fidi dei messaggi e-mail in BroadWorks? Vuoi che gli utenti forniscano indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Documenti API pubbliche su https://developer.webex.com Il presente documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo di branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso per i clienti? | Il presente documento |
Funzioni abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o Softphone. | Il presente documento Matrice caratteristiche/pacchetto |
autenticazione protetta | BroadWorks o Webex | Il presente documento |
Adattatore di provisioning (per opzioni di provisioning flowthrough) | Utilizzate già IM&P integrato, ad esempio per UC-One SaaS? Si desidera utilizzare più modelli? È previsto un caso d'uso più comune? |
Il presente documento Riferimento CLI server applicazioni |
Architettura e infrastrutture
Con che tipo di scala intende iniziare? È possibile scalare in futuro, ma la stima di utilizzo attuale dovrebbe guidare la pianificazione dell'infrastruttura.
Collaborare con il proprio account manager/rappresentante di vendita Cisco per dimensionare l'infrastruttura ADP XSP|, in base al Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
In che modo Webex renderà le connessioni TLS reciproche alle tue ADP XSP|? Direttamente a XSP|ADP in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce. (Non supportiamo connessioni TCP non crittografate al perimetro della rete).
Provisioning cliente e utente
Quale metodo di provisioning utente si adatta meglio?
Provisioning eseguibile con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene predisposto automaticamente in Webex.
Se puoi anche affermare che gli indirizzi e-mail dell'abbonato in BroadWorks sono validi e univoci per Webex, puoi utilizzare la variante "email attendibili" del provisioning flowthrough. Gli account Webex abbonati vengono creati e attivati senza il loro intervento; scaricano semplicemente il client e accedono.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto, il provider di servizi deve fornire un indirizzo e-mail valido all'utente per eseguire il provisioning dei servizi Webex. Questo deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo anche nell'attributo ID alternativo.
Provisioning eseguibile senza e-mail attendibili: Se non riesci a fidarti degli indirizzi e-mail degli abbonati, puoi comunque assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
Self-provisioning utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. Tu (o i tuoi clienti) distribuisci invece un collegamento di provisioning e i collegamenti per scaricare i diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare gli account Webex. Quindi, scaricano il client e accedono e Webex recupera una configurazione aggiuntiva su di essi da BroadWorks (inclusi i numeri principali).
Provisioning controllato da SP tramite API: Webex espone una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei propri flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti di sistema generali descritti in questa guida.
Metodo di provisioning | Requisiti |
---|---|
Provisioning del flusso (e-mail attendibili o non attendibili) | L'API di provisioning Webex aggiunge automaticamente gli utenti BroadWorks esistenti a Webex una volta che l'utente soddisfa i requisiti e si attiva il servizio Integrated IM+P. Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Self-provisioning utente | L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato il messaggio e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) | Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono previsti due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, vai a Utenti BroadWorks. |
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Impostazioni internazionali lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente di amministrazione con provisioning viene assegnata automaticamente come locale predefinita per l'organizzazione del cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti a riunioni all'interno dell'organizzazione del cliente.
Sono supportate le impostazioni internazionali in lingua a cinque caratteri (ISO-639-1)_(ISO-3166). Ad esempio, en_US corrisponde a English_UnitedStates. Se viene richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genera un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso internazionale dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, viene utilizzata l'impostazione locale ragionevole predefinita in base al codice della lingua richiesto.
Nella tabella riportata di seguito vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice lingua a due lettere in un'impostazione locale a cinque caratteri per le situazioni in cui un'impostazione locale a cinque caratteri non è disponibile.
Impostazioni internazionali lingua supportate (ISO-639-1)_(ISO-3166) | Se è disponibile solo un codice lingua a due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** | Usa impostazioni internazionali sensibili di default (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA | en en | en_USA |
fr_Fr fr_CA | Fr | fr_Fr |
cs_CZ | cs | cs_CZ |
da_DK | da | da_DK |
de_DE | DE | de_DE |
hu_HU | hu | hu_HU |
id_ID | ID | id_ID |
it_IT | IT | it_IT |
ja_JP | ja | ja_JP |
ko_KR | ko | ko_KR |
es_ES es_CO es_MX | ES | es_ES |
nl_NL | NL | nl_NL |
nb_NO | nb. | nb_NO |
pl_PL. | pl. | pl_PL. |
pt_PT pt_BR | pt | pt_PT |
ru_RU | RU | ru_RU |
ro_RO | ro | ro_RO |
zh_CN zh_TW | zh | zh_CN |
sv_SE | sv | sv_SE |
ar_SA | ar | ar_SA |
tr_TR | tr | tr_TR |
Le impostazioni internazionali es_CO, id_ID, nb_NO e pt_PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti Webex Meetings saranno solo in inglese. Inglese è la impostazioni internazionali predefinite per i siti se per il sito non sono richieste impostazioni internazionali non valide/non supportate. Questo campo lingua è applicabile durante la creazione di un'organizzazione e un sito Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, la lingua del modello verrà utilizzata come lingua predefinita. |
Branding
Gli amministratori partner possono utilizzare le personalizzazioni avanzate del branding per personalizzare l'aspetto dell'app Webex per le organizzazioni di clienti gestite dal partner. Gli amministratori partner possono personalizzare le seguenti impostazioni per garantire che l'app Webex rifletta il marchio e l'identità della società:
Loghi aziendali
Combinazioni di colori univoche per la modalità Chiaro o Scuro
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione delle personalizzazioni di branding avanzate.
|
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding come richiesto, ma quando si esegue l'onboarding di un cliente è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Alcuni parametri del modello principale sono elencati di seguito.
Pacchetto
È necessario selezionare un pacchetto predefinito quando si crea un modello (vedere Pacchetti nella sezione Panoramica per dettagli). Tutti gli utenti predisposti con tale modello, tramite flowthrough o self-provisioning, ricevono il pacchetto predefinito.
È possibile controllare la selezione dei pacchetti per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno di essi. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori di provisioning per azienda, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
È possibile modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedere Webex per la documentazione API Cisco BroadWorks o attraverso Partner Hub (vedere Modifica pacchetto utente in Partner Hub).
Non puoi modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è attivata o disattivata; se all'abbonato viene assegnato questo servizio in BroadWorks, il modello Partner Hub associato all'URL di provisioning aziendale di tale abbonato definisce il pacchetto.
Rivenditore e aziende o fornitore di servizi e gruppi?
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se sei un rivenditore con Enterprise, devi abilitare la modalità Enterprise quando crei un modello.
Se il sistema BroadWorks è configurato in modalità provider di servizi, è possibile lasciare disattivata la modalità Enterprise nei modelli.
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch BroadWorks richieste per il provisioning flow-through. Per ulteriori dettagli, vedere Patch richieste con provisioning flow-through. |
Modalità di autenticazione
Decidi come desideri che gli abbonati eseguano l'autenticazione quando accedono a Webex. È possibile assegnare la modalità utilizzando l'impostazione Modalità di autenticazione nel modello di onboarding. Nella tabella seguente sono riportate alcune opzioni.
Questa impostazione non ha effetto sull'accesso al portale di attivazione utente. Gli utenti che accedono al portale devono immettere l'ID utente e la password BroadWorks, come configurati su BroadWorks, indipendentemente da come si configura la modalità di autenticazione nel modello di onboarding. |
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | ID utente BroadWorks | Indirizzo e-mail |
Provider identità | BroadWorks.
| Identità comune Cisco |
Autenticazione a più fattori? | No | Richiede IdP del cliente che supporta l'autenticazione a più fattori. |
Percorso di convalida delle credenziali
|
|
|
Per una ripartizione più dettagliata del flusso di accesso SSO con autenticazione diretta a BroadWorks, vedere Flusso di accesso SSO. |
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che si può verificare con password che utilizzano caratteri speciali per cui il browser Web non codifica correttamente i caratteri. Utilizzando un'intestazione con codifica UTF-8, con codifica base 64, risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
Paese
Quando si crea un modello, è necessario selezionare un paese. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie S. | Posizione | Prefisso internazionale | Nome paese |
---|---|---|---|
1 | AMER | +1 | NOI, CA |
2 | APAC | +65 | Singapore |
3 | ANZ | +61 | Australia |
4 | EMEA | +44 | Regno Unito |
5 | EURO | +49 | Germania |
Accordi con più partner
Vuoi concedere in sublicenza Webex per Cisco BroadWorks a un altro provider di servizi? In questo caso, ciascun provider di servizi avrà bisogno di un'organizzazione partner distinta in Webex Control Hub per consentire loro di fornire la soluzione per la propria base clienti.
Adattatore di provisioning e modelli
Quando si utilizza il provisioning flowthrough, l'URL di provisioning inserito in BroadWorks viene derivato dal modello in Control Hub. È possibile disporre di più modelli e quindi di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati al momento della concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e quale modello si desidera utilizzare a tale scopo. In questo modo, è necessario impostare esplicitamente l'URL di provisioning per le aziende che necessitano di un modello diverso.
Inoltre, tenere presente che è possibile che si stia già utilizzando un URL di provisioning a livello di sistema, ad esempio con UC-One SaaS. In tal caso, è possibile scegliere di mantenere l'URL a livello di sistema per il provisioning degli utenti su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono dettagliate in Configura server applicazioni con URL servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning flowthrough tra AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server AS e Webex, annullando in tal modo la necessità di connettersi direttamente al servizio Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati che si sta eseguendo il provisioning per Webex devono esistere nel sistema BroadWorks integrato con Webex. È possibile integrare più sistemi BroadWorks, se necessario.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero o interno principale.
Webex utilizza gli indirizzi e-mail come identificatori principali per tutti gli utenti. Se si utilizza il provisioning flowthrough con e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail degli abbonati nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo di utenti di chiamata BroadWorks con un numero principale e/o interno. Se si utilizza il provisioning flowthrough, agli utenti deve essere assegnato anche il servizio IM&P integrato. |
Server nella rete e requisiti software
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Le istanze BroadWorks devono includere almeno i seguenti server:
Server applicazioni (AS) con versione BroadWorks come sopra
Server di rete (NS)
Server profilo (PS)
Server XSP|ADP o piattaforma di distribuzione delle applicazioni (ADP) di fronte al pubblico che soddisfano i seguenti requisiti:
Servizio di autenticazione (BWAuth)
Interfacce azioni ed eventi XSI
DMS (applicazione Web di gestione dispositivi)
Interfaccia CTI (Intergrazione Di Telefonia Informatica)
TLS 1.2 con certificato valido (non autofirmato) e qualsiasi intermediazione richiesta. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
Autenticazione Mutual TLS (mTLS) per il servizio di autenticazione (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Autenticazione Mutual TLS (mTLS) per l'interfaccia CTI (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Un server XSP/ADP separato che agisce come "Call Notifications Push Server" (un NPS nel tuo ambiente utilizzato per le notifiche di chiamata push per Apple/Google. Lo chiamiamo "CNPS" qui per distinguerlo dal servizio in Webex che fornisce notifiche push per messaggi e presenza).
Questo server deve essere su R22 o versione successiva.
Viene richiesto un server XSP/ADP separato per CNPS poiché l'imprevedibilità del carico da Webex per le connessioni cloud BWKS potrebbe influire negativamente sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSPADP, consultare la Guida tecnica di sistema Cisco BroadWorks|.
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, andare a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
PC/laptop Windows
PC/laptop Apple con MacOS
iOS (Apple Store)
Android (Play store)
Browser Web (vai a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (tradizionale cinese)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (italiano)
Telefoni e accessori fisici
Telefoni IP Cisco:
telefono IP Cisco serie 6800 con firmware multipiattaforma
telefono IP Cisco serie 7800 con firmware multipiattaforma
telefono IP Cisco serie 8800 con firmware multipiattaforma
Vedere https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html per i modelli e ulteriori informazioni.
I telefoni di terze parti sono supportati allo stesso modo di altre integrazioni BroadWorks. Tuttavia, non dispongono ancora dell'integrazione di contatti e presenza con Webex per Cisco BroadWorks.
Adattatori:
Adattatore per telefono analogico multipiattaforma Cisco ATA 191
Adattatore per telefono analogico multipiattaforma Cisco ATA 192
Vedere https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html per i modelli e ulteriori informazioni.
Cuffie:
cuffia Cisco serie 500
Vedi https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html per i modelli e ulteriori informazioni.
Dispositivi Room OS:
Serie Webex Room e Room Kit
Serie Webex Desk
Serie Webex Board
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e l'assistenza dei dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivo
Di seguito sono riportati i file DTAF che devi caricare sui server delle applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia c'è una nuova config-wxt.xml.template
file utilizzato per l'app Webex.
Per scaricare i profili dei dispositivi più recenti, andare al sito di Download software della piattaforma di consegna delle applicazioni per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che per XSP.
Nome del cliente | Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Comunicatore aziendale - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili del dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Genera una richiesta di servizio con l'agente di onboarding o con Cisco TAC per eseguire il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il titolo della richiesta per le rispettive funzioni:
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
'NPS Configuration for Auth Proxy Setup' (Configurazione NPS per impostazione proxy automatica) per configurare NPS per l'uso del proxy di autenticazione.
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori informazioni su questa funzione, vedere: Supporto di Cisco BroadWorks per CI UUID.
Configura BroadWorks per abilitare la fatturazione Cisco per BroadWorks e Webex Per abbonamenti BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento valido per 60 giorni. Se il token scade prima di utilizzarlo, è possibile presentare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali. |
Certificati ordine
Requisiti di certificato per l'autenticazione TLS
Per tutte le applicazioni richieste, saranno necessari i certificati di sicurezza, firmati da un'autorità di certificazione ben nota e distribuiti su ADP XSP|pubblico. Verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in entrata ai server XSP|ADP.
Questi certificati devono includere il nome di dominio pubblico XSP|ADP completo come Nome comune oggetto o Nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati del server dipendono da come vengono distribuiti gli ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume dove il certificato del server pubblico firmato da CA deve essere caricato in questi tre casi:
Le autorità di certificazione supportate pubblicamente dall'app Webex per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per proxy bridge TLS
Il certificato del server firmato pubblicamente viene caricato nel proxy.
Il proxy presenta questo certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Un certificato firmato CA interno può essere caricato su XSP|ADP.
L'|ADP XSP presenta questo certificato del server firmato internamente al proxy.
Il proxy si basa sulla CA interna che ha firmato il certificato del server XSP|ADP.
Requisiti di certificato TLS per proxy passthrough TLS o XSP|ADP in DMZ
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
Gli ADP XSP|presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca sull'interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione Mutual TLS. Il certificato CA/catena del certificato del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedi a Partner Hub, vai a
e fai clic sul collegamento del certificato di download.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume i requisiti del certificato in questi tre casi:
Requisiti del certificato (opzione) per proxy bridge TLS
Webex presenta un certificato client firmato pubblicamente al proxy.
Il proxy considera attendibile la CA interna di Cisco che ha firmato il certificato del client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta il certificato del server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions: X509v3 Extended Key Usage: 1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Il CN del certificato interno deve essere
bwcticlient.webex.com
.
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le autorità pubbliche di certificazione potrebbero non essere disposte a firmare i certificati con l'OIDE proprietario di BroadWorks richiesto. In caso di proxy di bridging, è possibile che sia necessario utilizzare una CA interna per firmare il certificato del client che il proxy presenta all'ADP XSP|.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Il ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XSP| dal proxy.
Requisiti di certificato (opzione) per proxy passthrough TLS o XSP|ADP in DMZ
Webex presenta un certificato client firmato da CA Cisco interno alle ADP XSP|.
Gli ADP XSP|si fidano delle autorità di certificazione interne di Cisco che hanno firmato il certificato client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XSP|.
Gli ADP XSP|presentano i certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Il server applicazioni ClientIdentity contiene il CN del certificato del client firmato Cisco presentato a XSP|ADP da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene l'elenco di indirizzi IP, porte e protocolli richiesti per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle dei firewall delle regole di ingresso e uscita precedenti documentano solo le connessioni specifiche di Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico per Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e la rilevanza di ciascuna sezione per Webex per Cisco BroadWorks.
Sezione Requisiti di Rete Art. | Rilevanza delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex | Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud | Informativo |
Da leggere | |
Da leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex | Da leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione | Opzionale |
Servizi Webex per clienti FedRAMP | N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedi il whitepaper del firewall dell'app Webex (PDF).
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza XSP|ADP di Broadworks fornita dal partner. Quando un ADP o un sito XSP|non è disponibile per manutenzione pianificata o motivo non pianificato, i servizi e le app Webex possono passare a un altro ADP o sito XSP|fornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP Broadworks XSP|possono essere distribuiti direttamente su Internet o possono risiedere in un DMZ frontale da un elemento di bilanciamento del carico come F5 BIG-IP. Per fornire ridondanza geografica, gli ADP XSP|possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un bilanciatore di carico, ognuno con un indirizzo IP pubblico. Se gli ADP XSP| sono dietro a un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e Broadworks sembra avere solo un XSP|ADP, anche se vi sono più ADP XSP| dietro.
Nell'esempio seguente, le ADP|XSP vengono distribuite in due siti, il Sito A e il Sito B. Esistono due ADP|XSP frontali di un bilanciatore di carico in ogni sito. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali di LB1 e il sito B ha XSP|ADP3 e XSP|ADP4 frontali di LB2. Solo i bilanciatori di carico sono esposti sulla rete pubblica e le ADP|XSP sono nelle reti private DMZ.
Servizi cloud Webex
Configurazione DNS
I microservizi cloud Webex devono essere in grado di trovare il server|ADP Broadworks XSP per la connessione alle interfacce Xsi, al servizio di autenticazione e al CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host XSP|ADP configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso. Se vengono restituiti più indirizzi IP, viene selezionato il primo IP nell'elenco. La ricerca SRV non è attualmente supportata.
Esempio: Il DNS A Record del partner per la scoperta del server XSP|ADP/Load Balancers bilanciato Round-Robin.
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Punti a LB1 (Sito A) |
R |
|
| Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Failover
Quando i microservizi Webex inviano una richiesta al servizio |di bilanciamento del carico/ADP XSP e la richiesta non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se non viene ricevuta alcuna risposta HTTP entro 2 secondi, la richiesta viene timeout e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento dell'indirizzamento all'IP successivo.
Ciascuna richiesta viene provata 3 volte prima di segnalare un errore al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco degli indirizzi da provare quando si invia una richiesta a un XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna nell'elenco per provare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco bloccato. Se l'operazione va a buon fine, tale indirizzo IP viene rimosso dall'elenco bloccato.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP|XSP o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster BroadWorks Calling, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
Azioni XSI
Eventi XSI
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Gli stati delle connessioni possono essere:
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
Rosso: Quando tutti gli IP nella ricerca di record sono irraggiungibili e l'interfaccia non è disponibile.
I seguenti servizi utilizzano i microservizi per connettersi agli XSP|ADP e sono interessati dalla disponibilità dell'interfaccia XSP|ADP:
Accesso all'app Webex
Aggiornamento token app Webex
E-mail/autoattivazione non attendibile
Controllo stato servizio Broadworks
App Webex
Configurazione DNS
L'app Webex accede ai servizi Xtended Services Interface (XSI-Actions & XSI-Events) e Device Management Service (DMS) su XSP|ADP.
Per trovare il servizio XSI, l'app Webex esegue la ricerca DNS SRV per _xsi-client._tcp.<webex app xsi domain>
. L'SRV punta all'URL configurato per gli host XSP|ADP o i bilanciatori di carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex torna alla ricerca A/AAAA.
L'SRV può risolversi in più target A/AAAA. Tuttavia, ogni record A/AAAA deve mappare solo a un singolo indirizzo IP. Se sono presenti più ADP|XSP in un DMZ dietro il dispositivo di bilanciamento del carico/bordo, è necessario che il bilanciatore di carico sia configurato per mantenere la persistenza della sessione in modo da indirizzare tutte le richieste della stessa sessione allo stesso XSP|ADP. Questa configurazione viene avviata perché i heartbeat dell'evento XSI del client devono andare allo stesso XSP|ADP utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non deve esistere. Se il DNS richiede che un record A/AAAA deve essere definito, allora deve essere restituito solo 1 indirizzo IP. Indipendentemente da ciò, l'SRV deve essere ancora definito per l'app Webex. Se l'app Webex utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client alla fine invia heartbeat a un XSP|ADP dove non ha stabilito un canale per eventi. Di conseguenza, il canale viene strappato e il traffico interno è notevolmente più intenso, il che pregiudica le prestazioni del cluster ADP|XSP. Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca di record A/AAAA, è necessario utilizzare un nome di dominio completo separato per Webex Cloud e l'app Webex per accedere agli ADP|XSP. Come mostrato negli esempi, Webex Cloud utilizza Un record |
Esempio 1: ADP|XSP multipli, ciascuno dietro bilanciatori di carico separati
In questo esempio, SRV punta a disattivare l'audio dei record A con ogni record A che punta a un bilanciatore di carico diverso su un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito un esempio di record SRV.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Esempio 2: più amministratori XSP| dietro un singolo bilanciatore di carico (con bridge TLS)
Per la richiesta iniziale, il bilanciatore di carico seleziona un XSP|ADP casuale. XSP|ADP restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il bilanciatore di carico utilizza il cookie per indirizzare la connessione all'ADP XSP|corretto, assicurandosi che il canale dell'evento non si interrompa.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Bilanciatore di carico |
R | LB.esempio.com |
| Indirizzo IP del bilanciatore di carico (XSP|ADP sono dietro al bilanciatore di carico) |
URL DMS
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il file di configurazione. Viene eseguita l'analisi dell'organizzatore nell'URL e l'app Webex esegue la ricerca DNS A/AAAA dell'organizzatore per connettersi all'ADP XSP|che ospita il servizio DMS.
Esempio: DNS Un record per la scoperta di Round-Robin bilanciato server XSP|ADP/Bilanciamento del carico di Webex App per scaricare i file di configurazione tramite DMS:
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Come l'app Webex trova gli indirizzi XSP|ADP
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (sono stati inseriti quando si crea il cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue la ricerca SRV nel modo seguente:
Il cliente esegue una ricerca SRV per _xsi-cliente._tcp.<xsi domain="">
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
Il cliente cerca gli obiettivi A/AAAA e memorizza nella cache gli indirizzi IP restituiti.
Il client si connette a uno dei target (e quindi al suo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi al peso (o a caso se sono tutti uguali).
Se la ricerca SRV non restituisce alcun obiettivo:
Il client esegue una ricerca A/AAAA del parametro principale Xsi e quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso.
Come indicato, il record A/AAAA deve risolversi in un indirizzo IP per le stesse ragioni.
(Opzionale) Successivamente, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocols> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
Se esistono, il client confronterà l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
Se viene rilevata una differenza, il client re-inizializzerà la connettività XSI Actions/XSI Events. La prima fase consiste nell'eseguire lo stesso processo di ricerca DNS elencato nella fase 1, richiedendo questa volta una ricerca del valore nel %XSI_ROOT_WXT% parametro dal file di configurazione.
Assicurarsi di creare i record SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
Failover
Durante l'accesso, l'app Webex esegue una ricerca DNS SRV per _xsi-client._tcp.<xsi domain="">, crea un elenco di organizzatori e si connette a uno degli organizzatori in base alla priorità SRV, quindi al peso. Questo organizzatore connesso diventa quello selezionato per tutte le richieste future. Viene quindi aperto un canale evento all'organizzatore selezionato e viene inviato regolarmente un heartbeat per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP, pertanto è importante che il bilanciatore di carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server XSP|ADP di backend.
Se una richiesta o una richiesta heartbeat a un organizzatore non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), l'indirizzamento dell'app Webex viene eseguito immediatamente all'organizzatore successivo nell'elenco.
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e l'indirizzamento passa all'organizzatore successivo nell'elenco.
Se una risposta non viene ricevuta entro un periodo di tempo, la richiesta viene considerata non riuscita a causa del timeout e le richieste successive vengono inviate al successivo organizzatore. Tuttavia, la richiesta scaduta viene considerata come non riuscita. Alcune richieste vengono riprovate dopo l'errore (con un tempo di riprova crescente). Le richieste che il presunto non vitale non sono riprovate.
Quando un nuovo organizzatore viene provato correttamente, diventa il nuovo organizzatore selezionato se l'organizzatore è presente nell'elenco. Una volta provato l'ultimo organizzatore nell'elenco, l'app Webex passa al primo.
In caso di heartbeat, se si verificano due errori di richiesta consecutivi, l'app Webex re-inizializzerà il canale eventi.
Tenere presente che l'app Webex non esegue il failback e che il rilevamento del servizio DNS viene eseguito solo una volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione attraverso l'interfaccia XSP|ADP/Dms. Esegue una ricerca di record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Innanzitutto, tenterà di inviare la richiesta per scaricare il file di configurazione utilizzando un token SSO. Se ciò non riesce per qualsiasi motivo, verrà riprovato ma con il nome utente e la password del dispositivo.
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning dell'utente. Molte delle attività sono comuni a tutte le modalità di provisioning.
Onboarding dei partner per Webex per Cisco BroadWorks
Ciascun provider o rivenditore di servizi Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, è necessario eseguire la documentazione Cisco BroadWorks di Webex e i nuovi partner devono accettare l'ICPA (Indirect Channel Partner Agreement) online. Al termine di queste operazioni, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, il tuo Partner Activation e/o Customer Success Program Manager ti contatterà per iniziare il tuo onboarding.
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
È necessario eseguire l'applicazione NPS su un altro XSP|ADP. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi sugli ADP XSP|.
Servizio/Applicazione | Autenticazione richiesta | Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
autenticazione protetta |
Integrazione telefonia computer |
mTLS (client e server si autenticano a vicenda) |
Presenza di telefonia |
Applicazione Webview Impostazioni chiamata |
TLS (il server esegue l'autenticazione per i client) |
Mostra le impostazioni di chiamata utente nel portale Assistenza utente all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma occorre fare riferimento alla documentazione esistente per installare le applicazioni sugli ADP|XSP.
Requisiti di coresidenza
Il servizio di autenticazione deve essere coresidente con le applicazioni Xsi, perché tali interfacce devono accettare token di lunga durata per l'autorizzazione del servizio. Il servizio di autenticazione è richiesto per convalidare tali token.
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
È possibile separare gli altri servizi/applicazioni come richiesto per la propria bilancia (gestione dispositivi dedicata XSP|ADP farm, ad esempio).
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
Non installare altre applicazioni o servizi sugli ADP XSP| utilizzati per integrare BroadWorks con Webex.
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se è in esecuzione R22 o versione superiore e il sistema lo supporta.
Mutual TLS (mTLS) è supportato anche come metodo di autenticazione alternativo per il servizio Auth. Se più organizzazioni Webex eseguono lo stesso server ADP XSP|, è necessario utilizzare l'autenticazione mTLS poiché la convalida token CI non supporta più connessioni allo stesso servizio autenticazione ADP XSP|. Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida del token CI, fare riferimento all'Appendice per configurare i servizi (con mTLS per il servizio di autenticazione). |
Se attualmente si utilizza mTLS per il servizio autenticazione, non è obbligatorio riconfigurare l'uso della convalida token CI con TLS. |
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks.
Installare le seguenti patch su ciascun server ADP XSP|. Installare le patch appropriate alla release in uso:
Per R22:
Per R23:
Per R24: non è necessario alcun cerotto
Qualsiasi riferimento a XSP include XSP o ADP.Installare il
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP al percorso del contesto /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire il servizio di autenticazione su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
A partire da Broadworks build 2022.10, le autorità di certificazione in arrivo con Java non vengono più automaticamente incluse nel trust store BroadWorks quando si passa a una nuova versione di java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
Radice commerciale IdenTrust CA 1
autorità di certificazione radice Go Daddy - G2
Verificare che questi certificati siano presenti sotto la seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get
Se non presente, eseguire il seguente comando per importare i trust Java predefiniti:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come ancoraggi attendibili con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono automaticamente importate nella nuova release e continueranno a essere importate finché non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere la FD di convalida del certificato Cisco Broadworks X509.
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server ADP XSP|:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get
set clientId client-Id-From-Step1
set enabled true
set clientSecret client-Secret-From-Step1
set ciResponseBodyMaxSizeInBytes 65536
set issuerName <URL>
- Per ilURL
, immettere l'URL IssuerName che si applica al cluster CI. Vedere la tabella seguente.set issuerUrl <URL>
- Per ilURL
, immettere l'IssuerUrl che si applica al cluster CI. Vedere la tabella seguente.set tokenInfoUrl <IdPProxy URL>
—Inserire l'URL proxy IdP applicabile al cluster dei team. Si veda la seconda tabella che segue.
Tabella 1. Imposta nome emittente e URL emittente Se il cluster CI è... Imposta issuerName e issuerURL su... NOI-A
UE
NOI-B
Se non conosci il tuo cluster CI, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.Tabella 2. Imposta tokenInfoURL Se il cluster di Teams è... Imposta tokenInfoURL su...(URL proxy IdP) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AFRA
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
DOLORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.
Per il test, è possibile verificare che il tokenInfoURL sia valido sostituendo "
idp/authenticate
" parte dell'URL con "ping
".
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user
Configurare i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get
set flsUrl https://cifls.webex.com/federation
set refreshPeriodInMinutes 60
set refreshToken refresh-Token-From-Step1
Eseguire il seguente comando per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get
Configurare la gestione dei token utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
set tokenIssuer BroadWorks
set tokenDurationInHours 720
Genera e condividi chiavi RSA. È necessario generare chiavi su un XSP|ADP, quindi copiarle su tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP.Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web. Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token. Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Rimozione dei requisiti di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con la convalida del token CI su R24, è necessario rimuovere anche il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Interfaccia CTI e configurazione correlata
Di seguito viene elencato l'ordine di configurazione "da più a più". In seguito a questo ordine non è obbligatorio.
Configurazione del server di applicazione per gli abbonamenti CTI
Configurazione di XSP|ADPs per abbonamenti CTI autenticati mTLS
Apertura delle porte in entrata per l'interfaccia CTI protetta
Abbonamento dell'organizzazione Webex agli eventi CTI di BroadWorks
Configurazione del server di applicazione per gli abbonamenti CTI
Aggiornare ClientIdentity su Application Server con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ciascun server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è |
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocol> |
Una specifica interfaccia CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocol> |
Su una nuova installazione, le seguenti crittografie sono installate per impostazione predefinita a livello di sistema. Se non è configurato nulla a livello di interfaccia (ad esempio, nell'interfaccia CTI o HTTP), si applica questo elenco di crittografia. Si noti che questo elenco può cambiare nel tempo:
|
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp>
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
Inserisci il
get
comando per visualizzare le crittografie già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, si utilizzerebbe:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Ancoraggi affidabili per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che le ADP XSP|siano rivolte verso Internet o rivolte verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy bridge (vedere Requisiti del certificato TLS per proxy bridge TLS).
Per ogni amministratore XSP|nell'infrastruttura che pubblica eventi CTI in Webex, effettuare le seguenti operazioni:
Accedere a Hub partner .
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.
Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
(Opzionale) Esecuzione
help updateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot2023
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
Consenti ai client di autenticarsi con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione BroadWorks in uso. Il comando crea un certificato server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. È necessario l'indirizzo IP dell'interfaccia CTI per questo; è possibile leggerlo dal seguente contesto:
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>
Riavviare XSP|ADP.
Abilitazione dell'accesso a BroadWorks CTI Events su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
Specificare l'indirizzo CTI in base al quale Webex può iscriversi a CTI Events di BroadWorks.
Gli abbonamenti CTI sono su base per abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato viene predisposto per Webex per Cisco BroadWorks.
Visualizzazione Webview Impostazioni chiamata
Call Settings Webview (CSWV) è un'applicazione ospitata su XSP|ADP per consentire agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview per le impostazioni di chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono native dell'app Webex.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, è necessario distribuire la funzione Webview impostazioni chiamata.
La vista Webview impostazioni chiamata presenta due componenti:
Applicazione Webview Impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
App Webex, che esegue il rendering delle impostazioni di chiamata in una vista Webview.
Esperienza utente
Utenti Windows: Fai clic su Impostazioni chiamata, quindi su .
Utenti Mac: Fare clic sull'immagine del profilo, quindi
.
Distribuzione di CSWV su BroadWorks
Installazione di Webview impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso ADP|XSP che ospita l'interfaccia Xsi-Actions nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
Accedere a cisco.com e cercare "BWCallSettingsWeb" nella sezione download software.
Trovare e scaricare la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) è stata la più recente al momento della stesura del presente documento.Installare, attivare e distribuire l'archivio Web in base alla Guida alla configurazione della piattaforma di servizi Xtended di Cisco BroadWorks per la versione XSP|ADP. (Versione R24 https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
.Passare al seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più necessario).Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario fornire anche un contextPath perché è un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio
/callsettings
.Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
Ora è possibile prevedere l'URL delle impostazioni di chiamata che si specificherà per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
L'|ADP-FQDN XSP deve corrispondere al FQDN azioni Xsi, perché CSWV deve utilizzare le azioni Xsi e CORS non è supportato.
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview Impostazioni chiamata è ora attiva sugli ADP|XSP.
Configura l'app Webex per utilizzare Webview impostazioni chiamata
Per ulteriori dettagli sulla configurazione del client, vedere la Guida alla configurazione di Webex per Cisco BroadWorks.
Nel file di configurazione dell'app Webex è presente un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti attraverso l'interfaccia dell'applicazione.
<config>
<services>
<web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%">
<url>%WEB_CALL_SETTINGS_URL_WXT%</url>
</web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel %WEB_CALL_SETTINGS_URL_WXT% tag.
Se non si specifica esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
Imposta la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
Il file di configurazione client risultante dovrebbe avere una voce come segue:
<web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push delle chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Call Notifications Push Server (CNPS) per descrivere un'applicazione ospitata XSP o ospitata ADP che viene eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti e invia le notifiche a Google Firebase Cloud Messaging (FCM) o Apple Push Notification Service (APN).
Tali servizi notificano ai dispositivi mobili degli abbonati Webex per Cisco BroadWorks la presenza di chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzione Notification Push Server.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi a loro volta notificano agli utenti mobili Webex le modifiche ai messaggi in arrivo o alla presenza.
In questa sezione viene descritto come configurare l'NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se è necessario eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPShttps://help.webex.com/nl5rir2/. |
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario aggiornare il CNPS per supportare la funzione proxy NPS, server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server di notifica push per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e i tasti di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend di Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APN Apple e i servizi FCM Google.
La funzione migliora anche la capacità del server push delle notifiche di eseguire notifiche push ai dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
Per ulteriori informazioni, vedere Server push per VoIP nella descrizione della funzione UCaaS.
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software e le patch NPS, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Cercare e scaricare la patch dalla pagina di download del software.
Ulteriori informazioni sul server ADP sono disponibili su https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio Apple Push Notification dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per APN. Questo aggiornamento richiede che XSP|ADP che ospita l'NPS esegua R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 | Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma di consegna dell'applicazione (ADP). | ||
2 | Installare le patch proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: | ||
3 | Attivare l'applicazione Notification Push Server. | ||
4 | (Per le notifiche Android) Abilitare l'API FCM v1 sull'NPS.
| ||
5 | (Per le notifiche Apple iOS) Abilitare HTTP/2 su NPS.
| ||
6 | Collegare un supporto tecnico dell'NPS XSP/ADP. | ||
7 | Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN UN 10.193.78.149
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configura NPS per utilizzare il proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Migra NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un server NPS condiviso con altre app mobili, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPS ( https://help.webex.com/nl5rir2).
1 | Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 | Creare l'account cliente su NPS:
Per verificare che i valori inseriti corrispondano a quanto ricevuto, eseguire
| |||||||||||||||||||
3 | Immettere l'URL proxy NPS e impostare l'intervallo di aggiornamento del token (consigliato 30 minuti):
| |||||||||||||||||||
4 | (Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 | (Per le notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, assicurandosi di omettere il tasto Auth – impostarlo su vuoto.
| |||||||||||||||||||
6 | Configurare i seguenti URL NPS:
| |||||||||||||||||||
7 | Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 | Verificare se il server applicazioni sta eseguendo lo screening degli ID applicazione, poiché potrebbe essere necessario aggiungere le app Webex all'elenco utenti autorizzati: | |||||||||||||||||||
9 | Riavviare XSP|ADP: | |||||||||||||||||||
10 | Esegui test delle notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migrazione di NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente che è necessario eseguire la migrazione a FCMv1. Sono previste tre procedure:
Esegui migrazione dei client UC-One a FCMv1: quando disponi di client UCaaS esistenti e devi migrarli per utilizzare FCMv1.
Migrazione dei client SaaS a FCMv1: quando si dispone di client SaaS esistenti e occorre migrarli per utilizzare FCMv1.
Aggiorna server ADP: quando si esegue la migrazione di NPS a un server ADP.
Migrazione dei client UC-One a FCMv1
Utilizzare la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere . L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile Connect su https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al
|
Accedere a SDK amministratore FCM su http://console.firebase.google.com.
Selezionare l'applicazione Android appropriata.
Nella scheda General (Generale), registrare l’ID del progetto
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
Fare clic sul pulsante blu per creare un nuovo account di servizio
Fai clic sul pulsante blu per generare una nuova chiave privata
Chiave di download per una posizione sicura
Per riutilizzare un account servizio esistente:
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
Identificare l'account servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
Copiare il file json su XSP|ADP.
Configurare l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== my_project ********
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Migrazione dei clienti SaaS a FCMv1
Se si desidera eseguire la migrazione dei client SaaS a FCMv1, attenersi alla procedura seguente su Google FCM Console.
Assicurarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione". |
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Aggiorna server ADP
Se si esegue la migrazione dell'NPS per utilizzare un server ADP, utilizzare i passaggi seguenti nella console Google FCM.
Ottenere il file JSON dalla console cloud di Google:
Su Google Cloud Console, andare alla pagina Account servizio.
Fare clic su Seleziona un progetto, scegliere il progetto e fare clic su Apri.
Trova la riga dell'account servizio per la quale desideri creare una chiave, fai clic sul pulsante Altro verticale, quindi fai clic su Crea chiave.
Selezionare un tipo di chiave e fare clic su Crea
Il file viene scaricato.
Aggiungere FCM al server ADP:
Importare il file JSON nel server ADP utilizzando il
/bw/install
comando.Accedere all'ADP CLI e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON
:Quindi, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò avviene per i seguenti motivi:
Per consentire a Webex cloud di autenticare i tuoi utenti rispetto a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
Per consentire alle app Webex di utilizzare l'interfaccia Xsi per il controllo delle chiamate.
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se alcune interfacce non vengono convalidate correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide. Ciò viene impedito poiché un cluster configurato in modo errato potrebbe causare problemi che sono difficili da risolvere. |
Cosa è necessario fare:
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
Assegna un nome al cluster e fai clic su Avanti.
Il concetto di cluster qui è semplicemente una raccolta di interfacce, solitamente situate su un server ADP XSP| o in un'azienda agricola, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il sistema BroadWorks non sono applicabili qui.
(Opzionale) Immettere un Nome account utente e una Password BroadWorks noti all'interno del sistema BroadWorks che si connette a Webex, quindi fare clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
Aggiungere gli URL XSI Actions e XSI Events.
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
Opzionale. Selezionare la casella di controllo Abilita autenticazione diretta BroadWorks se si desidera che gli accessi a BroadWorks siano diretti a BroadWorks. In caso contrario, l'autenticazione per BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo influisce su queste situazioni di accesso:
Accesso al portale di attivazione utente: gli utenti devono immettere le credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o attraverso il proxy IdP.
Accesso client: se l'autenticazione BroadWorks è configurata nel modello di onboarding, l'impostazione precedente determina se l'accesso del client all'app Webex è diretto a BroadWorks o viene proxy attraverso il proxy IdP.
Fai clic su Avanti.
Nella pagina CTI Interface (Interfaccia CTI) procedere come segue:
Aggiungere l'URL CTI e la porta per l'interfaccia CTI a cui si desidera connettersi.
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
Opzionale. Abilita il tasto di alternanza Non disturbare (NoDist) e inserisci l'ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurandosi che la funzione funzioni allo stesso modo su entrambe le piattaforme.
Fai clic su Avanti.
Aggiungere l'URL del servizio di autenticazione.
Selezionare Servizio autenticazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex poiché il servizio di autenticazione convalida correttamente il token utente rispetto al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
Controllare le voci sulla schermata finale, quindi fare clic su Crea. Dovrebbe essere visualizzato un messaggio di successo.
Partner Hub passa gli URL a vari microservizi Webex che testano le connessioni alle interfacce fornite.
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è riuscita.
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Abbiamo implementato questa verifica per prevenire errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, caricatore di bilanciamento o firewall) come illustrato in questa guida, prima di salvare il modello.
Verifica delle connessioni alle interfacce BroadWorks
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Visualizza cluster.
Partner Hub avvia i test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina dell'elenco dei cluster mostra il messaggio di stato accanto a ciascun cluster.
I messaggi verdi relativi al successo dovrebbero essere visualizzati. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio XSI-Actions, XSI-Events, DAS URL e le impostazioni dell'interfaccia CTI.
Configurazione dei modelli di onboarding
I modelli di onboarding sono il modo in cui verrà applicata la configurazione condivisa a uno o più clienti man mano che vengono caricati tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma solo un modello può essere associato a un cliente.
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Aggiungi modello.
In questo modo viene avviata una procedura guidata in cui è possibile fornire la configurazione per i clienti che utilizzeranno questo modello.
Utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
Immettere un Nome modello, quindi fare clic su Avanti.
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per diverse modalità di provisioning Nome impostazione
Provisioning fluviale con e-mail attendibili
Provisioning flowthrough senza e-mail
Self-provisioning utente
Abilita flusso BroadWorks attraverso il provisioning (include le credenziali dell'account di provisioning se attivato**)
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il †
Il †
Il †
Indirizzo e-mail provider servizi
Selezionare un indirizzo e-mail dall'elenco a discesa (è possibile digitare alcuni caratteri per trovare l'indirizzo, se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello di onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature tra paese e regione in questo foglio di calcolo.
Il paese dell'organizzazione determina i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni consultare la sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questo interruttore spento.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note dalla tabella:
† Questo passaggio garantisce che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa opzione deve essere sempre attiva, a meno che non si utilizzi un processo manuale di ordinazione ed esecuzione (tramite Cisco Commerce Workspace) per creare le organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello di "provisioning ibrido" e non rientra nel campo di applicazione di questo documento.
** "Account di provisioning" si riferisce all'account di amministrazione a livello di sistema BroadWorks. Su BroadWorks, è necessario un account amministratore con questi attributi: Tipo amministratore=Provisioning, sola lettura=Disattivato.
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
Opzionale. Selezionare Disabilita chiamata gratuita Cisco Webex se si desidera disabilitare le chiamate Webex.
Per la configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
Numeri di chiamata in ingresso Cisco (PSTN)
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
Fai clic su Avanti.
Esistono due approcci per il provisioning degli abbonati relativamente a come vengono verificate le relative identità, utilizzando e-mail attendibili o e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile, gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. In qualità di partner, sei responsabile del provisioning dell'indirizzo e-mail come parte del metodo flow-through o API.
Si consiglia vivamente di utilizzare il metodo di provisioning attendibile poiché garantisce che tutti gli abbonati siano completamente predisposti dall'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso e-mail non attendibile, gli utenti devono verificare i relativi messaggi e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome impostazione
Provisioning flowthrough senza e-mail
Self-provisioning utente
Esegui prima provisioning amministratore
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
Note dalla tabella:
* Ciascuna organizzazione cliente in Webex deve disporre di almeno un utente con ruolo di amministratore. Il primo utente a cui assegnare IM&P integrato in BroadWorks assume il ruolo di amministratore del cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di fornitore di servizi è possibile avere il controllo su chi ottiene il ruolo. La verifica di questa impostazione impedisce agli utenti di completare l'attivazione fino a quando non viene attivato il primo utente fornito. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
Fai clic su Avanti.
Selezionare la modalità di autenticazione predefinita (autenticazione BroadWorks o autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.(Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
Fai clic su Avanti.
Per Preferenze, configurare quanto segue:
Scegliere se si desidera Precompilare gli indirizzi e-mail utente nella pagina di accesso.
Utilizzare questa opzione solo dopo aver selezionato Autenticazione BroadWorks e aver anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il nome utente BroadWorks. La pagina di accesso offre l'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
Se desideri abilitare la sincronizzazione delle rubriche, imposta l'opzione Abilita sincronizzazione rubrica telefonica per tutte le nuove organizzazioni clienti per attivare.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
Immettere un amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatico di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
Assicurati che l'opzione Consenti invito e-mail amministratore quando ti colleghi a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
Fai clic su Avanti.
Esaminare le voci nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Dovrebbe essere visualizzato un messaggio di successo.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con altri modelli.
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario immettere nuovamente i dettagli dell'account di provisioning. I campi Password vuota/Conferma password sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori forniti alla procedura guidata.
Aggiungi altri modelli se disponi di diverse configurazioni condivise che desideri fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbe essere necessario specificare i dettagli del modello per una delle attività seguenti.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning. |
Patch Application Server (solo R22, R23 e R24)
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
Per R22:
AP.as.22.0.1123.ap373197
Per R23:
AP.as.23.0.1075.ap373197
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che costituiscono il requisito per la distribuzione di Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.Modifica della
Maintenance/ContainerOptions
contesto.Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true
Scarica gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interfaccia > Messaggistica e Servizio > IM&P integrato) dei comandi AS.
Accedi a Partner Hub e vai a
.Fare clic su Visualizza modelli.
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro flyout a destra. Se non è stato ancora creato un modello, è necessario farlo prima di poter ottenere l'URL di provisioning.
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per altri modelli se si dispone di più modelli.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema su server applicazioni
Se si utilizza UC-One SaaS, potrebbe non essere necessario impostare il provisioning e il dominio del servizio a livello di sistema. Vedere i Punti di decisione nella sezione Preparazione dell’ambiente. |
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password
AS_CLI/Interface/Messaging> set enableSynchronization true
Attivare l'interfaccia IMP integrata:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
È necessario inserire il nome completo per il |
(Opzione) Configurazione dei parametri di provisioning per azienda su server applicazioni
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
Selezionare Usa dominio di servizio e immettere un valore fittizio (Webex ignora questo parametro). È possibile utilizzare
example.com
).Selezionare Usa server di messaggistica.
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
È necessario inserire il nome completo per il
provisioningURL
parametro, come è stato dato in Partner Hub. Se il server applicazioni non può accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel/etc/hosts
file su AS.Nel campo Nome utente, immettere un nome per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Immettere una password per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Per Identità utente predefinita per ID IM&P, selezionare Principale.
Fare clic su Applica.
Ripeti per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning utente, vedi Provisioning utente provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning aiuta amministratori e team di vendita controllando la presenza di errori prima di eseguire il provisioning di un cliente o abbonato per un pacchetto. Gli utenti o le integrazioni autorizzati da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per assicurarsi che non vi siano conflitti o errori con il provisioning del pacchetto per un determinato cliente o abbonato.
L'API verifica se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto a un cliente o partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, è possibile correggere gli errori prima del provisioning, aumentando la probabilità di un provisioning riuscito.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore Webex per la vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare di un provisioning abbonato all'ingrosso
Per accedere a Precontrolla un documento di provisioning abbonato Wholesale, devi accedere al portale https://developer.webex.com/. |
Partner SSO - SAML
Consente agli amministratori dei partner di configurare l'SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La seguente procedura SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere la funzionalità SSO del partner a un'organizzazione cliente esistente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso. Per aggiungere SSO partner a un'organizzazione esistente, è necessario aprire un ticket con Cisco TAC. |
Verificare che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'integrazione Single Sign-On in Control Hub.
Aprire una richiesta di servizio con Cisco TAC. TAC deve stabilire una relazione di trust tra il provider di identità di terze parti e il servizio Cisco Common Identity. .
Se l'IdP richiedepassEmailInRequest
da abilitare, accertarsi di includere questo requisito nella richiesta di servizio. Controlla con il tuo IdP se non sei sicuro che questa funzione sia necessaria.Carica il file di metadati CI fornito da TAC al provider di identità.
Configurare un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, immettere l'ID entità dall'XML metadati SAML del provider di identità di terze parti.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
Proprio che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori dei partner di configurare l'SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per impostare SSO OIDC partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già caricate utilizzando il modello. Per aggiungere il Partner SSO a un'organizzazione di clienti esistente, è necessario aprire un ticket con Cisco TAC. |
Aprire una richiesta di servizio con il centro TAC di Cisco con i dettagli dell'IDP di connessione OpenID. Sono obbligatori e facoltativi gli attributi IDP. TAC deve impostare l'IDP sul CI e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC, potrebbe consistere in lettere, numeri, trattini, sottolineature, inclinazioni e punti e la lunghezza massima è 128 caratteri.
Id client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Segreto client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco degli ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio, ad esempio "profilo e-mail openid" Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non fornito
URL dell'endpoint di autorizzazione OAuth 2.0 dell'IdP.
endpoint token
Sì se discoveryEndpoint non fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
endpoint infoutente
No
URL dell'endpoint UserInfo di IdP.
Endpoint set di tasti
No
URL dell'endpoint JSON Web Key Set dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
Configurare l'URI di reindirizzamento sull'IDP di connessione OpenID.
Configurare un modello di onboarding. Per l'impostazione della modalità di autenticazione, selezionare Autenticazione partner Con OpenID Connect e immettere il nome IDP fornito durante l'impostazione IDP come ID entità IDP OpenID Connect.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui registrazione chiamata, risposta per assente di gruppo, dirigente e assistente di direzione.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
Eseguire i seguenti comandi sulle interfacce AS. Ciò consentirà all’AS di inviare il c.d.
X-BroadWorks-Correlation-Info
Intestazione SIP:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true
Il
enableCallCorrelationID
Il parametro associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione delle informazioni di correlazione delle chiamate nei registri Xsi-Actions. Si raccomanda di avereenableCallCorrelationID
abilitato utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione dell'identificativo di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione della rubrica garantisce che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la directory di chiamata completa dal server BroadWorks viene sincronizzata con la directory Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione rubriche, vai a Sincronizzazione rubriche in Webex per Cisco BroadWorks.
Webex per Cisco BroadWorks flowthrough provisioning aggiunge utenti di messaggistica e informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, gli elenchi telefonici, gli utenti non di messaggistica e le entità non utenti non sono inclusi (ad esempio, un telefono della sala conferenze, un fax o un numero di gruppo di risposta). L'attivazione della sincronizzazione delle rubriche garantisce che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex. |
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia chiamate e riunioni unificate Webex visualizzata sull'app Webex. Gli utenti possono visualizzare la cronologia dettagliata delle chiamate e della riunione dall'app Webex.
La cronologia chiamate unificata può essere abilitata dagli amministratori a livello di partner in Partner Hub su base cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
Eventi cronologia chiamate: questi eventi vengono utilizzati per creare una cronologia chiamate unificata dettagliata
Eventi di stato hook: la cronologia chiamate unificata include ottimizzazioni dello stato hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di Telephony Presence
Requisiti della cronologia chiamate unificata
Prima di configurare la cronologia chiamate unificata, accertarsi di aver eseguito la patch del sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
AP.as.22.0.1123.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per R23:
AP.as.23.0.1075.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Se si utilizza XSP—
AP.xsp.23.0.1075.ap378585
In caso di utilizzo di ADP
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
AP.as.24.0.944.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per l'elenco completo delle patch BroadWorks che è necessario installare come prerequisito per l'esecuzione di Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella sezione Riferimento. |
Oltre alla patch del sistema, il file di configurazione del client ( config-wxt.xml
) deve avere il seguente set di tag: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altro reindirizzamento nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
AP.as.23.0.1075.ap383346
AP.as.23.0.1075.ap383994
Per R24:
AP.as.24.0.944.ap383346
AP.as.24.0.944.ap383994
Per avere informazioni Dirigente-Assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
AP.as.24.0.944.ap380052
AP.as.24.0.944.ap384239
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare anche la sincronizzazione delle rubriche per la cronologia chiamate unificata dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione NoDist, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti nel cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione di Broadworks durante la stessa finestra di manutenzione. |
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configura organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettuare le seguenti operazioni:
Accedi a Partner Hub su
admin.webex.com
.Andare a Impostazioni e selezionare un cluster esistente.
Verificare che la connessione al cluster sia buona. Nel pannello a destra viene visualizzato un segno di spunta verde con Connection stabilita.
Se questa opzione non viene visualizzata, in Check Connnections (Opzionale), immettere BroadWorks User Id e BroadWorks Password e fare clic su Check per verificare che la connessione sia corretta.
Selezionare la casella di controllo Abilita cronologia chiamate.
Fai clic su Salva.
Interazioni funzione
Per la cronologia chiamate unificata sono presenti le seguenti interazioni delle funzioni:
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando questa situazione esiste, gli eventi Cronologia chiamate e Stato hook non vengono inviati all'app Webex.
La cronologia chiamate unificate non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia chiamate unificata dall'app Webex. Per informazioni dettagliate, vedere: Webex | visualizza cronologia chiamate e riunioni.
Disabilita cronologia chiamate unificata
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visivo
L'app Webex supporta un'indicazione visiva delle chiamate spam nel avviso popup quando la chiamata viene presentata al destinatario e nei record della cronologia delle chiamate unificate quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per utilizzare questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- Le seguenti patch devono essere installate e attive:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o AS-25_Rel_2022.12 come minimo
- La funzione deve essere attivata tramite AS CLI:
- AS_CLI/System/ActivatableFeature> attivare 104112
- AS_CLI/System/StirShaken> imposta enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'etichettatura e la verifica STIR-SHAKEN come descritto in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste di invito inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti che vengono inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione di spam visivo nella presentazione della chiamata e nella cronologia chiamate unificata della chiamata.
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenta di identificare il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra di chiamata e una volta completata la chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante abbinando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se trova più istanze di un numero in un'origine, non tenterà di sceglierne una, in questo caso, non visualizzerà alcun ID chiamante. |
Webex Common Identity (CI) che contiene gli utenti della tua organizzazione.
Contatti personali e aziendali. I contatti personali sono visibili nella scheda Contatti.
Rubrica locale. In Windows - applicazione Outlook, in Mac - Contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non viene trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, utilizzerà la parte del nome utente dell'URI SIP dall'intestazione SIP From come ultima risorsa.
Per il controllo delle chiamate remote (ad esempio, modalità di controllo del telefono fisso) vengono utilizzate informazioni XSI, dove viene utilizzato ID BWKS o interno, estratte da informazioni di parte remota nell'evento XSI. Se l'informazione della parte remota non è disponibile, verrà utilizzata P-Asserted Identity (PAI) (se configurata).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica di chiamata e nella cronologia chiamate.
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
Coda Call Center: Visualizza il nome della coda che ha inoltrato la chiamata.
Dirigente-Assistente: Mostra il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
Per le chiamate nella coda chiamate interna, in cui un agente richiama una parte interna, la parte remota non visualizzerà il nome della coda chiamata, ma il nome dell'agente che le chiama.
Chiamata con risposta altrove:
Per gruppi di risposta o code chiamate impostate con indirizzamento simultaneo, gli agenti visualizzeranno una chiamata che ha ricevuto risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di risposta o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate perse nella cronologia chiamate se risposte da un altro agente.
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni da tavolo. Questa funzione specifica consente di assegnare gli indicatori di linea condivisa all'app Webex dell'utente finale.
Questa funzione consente agli utenti di gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente alle linee condivise.
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise dal client Webex
R23 senza ADP:
AP.as.23.0.1075.ap384179
AP.xsp.23.0.1075.ap384179
R23 con ADP:
AP.as.23.0.1075.ap384179
Xsi-Actions-23_2022.10
R24:
IN QUANTO: AP.as.24.0.944.ap384179
Xsi-Actions-24_2022.10
R25:
IN QUANTO: Versione RI Rel_2022.10_1.310
Xsi-Actions-25_2022.10
Cerotto 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo (in questo caso per il client desktop: Business Communicator).
Versione RI Rel_2022.10_1.310
Sincronizzazione Non disturbare (NoDist).
La sincronizzazione Non disturbare (NoDist) allinea le impostazioni NoDist tra Webex e BroadWorks sincronizzando lo stato NoDist tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato si sincronizza con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. Analogamente, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist da una piattaforma non vengono riconosciuti dall'altra piattaforma.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Prerequisiti
Assicurarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione BroadWorks.
Per la versione 22:
Cerotto AS: AP.as.22.0.1123.ap382615, AP.as.22.0.1123.ap382838
Patch XSP|ADP: AP.xsp.22.0.1123.ap382615, AP.xsp.22.0.1123.ap382838
Per la versione 23:
Cerotto AS: AP.as.23.0.1075.ap382615, AP.as.23.0.1075.ap382838
Patch XSP|ADP: AP.xsp.23.0.1075.ap382615, AP.xsp.23.0.1075.ap382838
App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
Cerotto AS: AP.as.24.0.944.ap382615, AP.as.24.0.944.ap382838
App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 su AS:
AS_CLI/System/ActivatableFeature> activate 25433
Configura sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto di eventi "as-feature-event". Per informazioni dettagliate, vedere Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
Accedi a Partner Hub
Fare clic su Impostazioni.
Fare clic su Visualizza cluster e selezionare il cluster BroadWorks appropriato.
Abilita il tasto di alternanza Non disturbare (NoDist).
Inserire l'ID utente BroadWorks e fare clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione NoDist. Se la convalida non riesce, il pulsante Salva viene disabilitato.
Se la convalida ha esito positivo, fare clic su Salva.
|
Abilita sincronizzazione NoDist (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per ulteriori dettagli, vedere "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Disabilita sincronizzazione NoDist
Non puoi disabilitare la sincronizzazione NoDist da solo. Per disabilitare la funzione, crea un caso BEMS di ingegneria con le seguenti informazioni:
Famiglia: Servizio Spark
Prodotto: Chiamata in Webex (Webex per BroadWorks)
Componente: Provisioning WxBW
Il caso BEMS deve indicare che la sincronizzazione non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterIdBroadWorks.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione delle chiamate.
Modalità di registrazione | Descrizione | Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta | La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente | La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Per R22: AP.as.22.0.1123.ap377718
Per R23: AP.as.23.0.1075.ap377718
Per R24: AP.as.24.0.944.ap377718
L'identificativo di correlazione chiamata deve essere attivato. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione delle chiamate Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, andare a help.webex.com
articolo Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla piattaforma di registrazione chiamate di terze parti.
Gruppo Parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione di parcheggio e recupero delle chiamate di gruppo. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti al dettaglio in un'impostazione di negozio possono utilizzare la funzione per parcheggiare una chiamata che può essere raccolta da qualcuno in un altro reparto.
Funzionamento funzione
Una volta configurata la funzione
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nell'app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nell'app Webex. L'utente quindi inserisce l'estensione della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per attivare questa funzione, verificare quanto segue:
Il file di configurazione client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
L'identificativo di correlazione chiamata deve essere abilitato su AS e XSP|ADP. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Il tuo SBC deve essere configurato per passare il ‘
x-broadworks-correlation-in
' Attributo SIP a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiungi gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo del server applicazioni Cisco BroadWorks - Parte 2. È necessario creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Parcheggio Webex | e Recupera chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzato
Il parcheggio chiamate regolare o indirizzato non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso funzione:
Immettere *68 per parcheggiare una chiamata
Immettere *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato negli ambienti del call center o in altre situazioni in cui può essere necessaria un'assistenza o un intervento immediati.
Quando un servizio di inclusione è abilitato, un utente o supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di tasti o pulsanti dedicati sul proprio telefono o dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o di partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in vari scenari. In un ambiente di call center, supervisori o formatori possono monitorare e assistere i rappresentanti del servizio clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire assistenza o prendere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può partecipare rapidamente a conversazioni in corso per fornire assistenza o prendere decisioni importanti.
Nell'app Webex per l'inclusione, viene inviata una notifica che la chiamata viene trasformata in una conferenza. In NOTIFY (informazioni sulla chiamata o conferenza) non sono disponibili ulteriori informazioni sul tipo di conferenza, pertanto è possibile trattarla in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Vengono introdotti i seguenti termini:
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore solitamente ha la possibilità di monitorare e intervenire nelle chiamate in corso dei clienti. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire assistenza agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può comprendere la formazione degli agenti, la gestione dei problemi dei clienti e l'ottimizzazione delle prestazioni del team.
Cliente: Per cliente si intende una persona fisica o giuridica che interagisce con un'azienda o un'organizzazione per ottenere prodotti, servizi o assistenza. Nel contesto dell'inclusione delle chiamate, un cliente è qualcuno che sta effettuando o ricevendo una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risolvere le loro richieste o problemi durante la chiamata. La funzione di inclusione chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
Agente: Un agente, anche noto come rappresentante del servizio clienti o agente del call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza telefonica o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare operazioni e offrire un'esperienza positiva al cliente. Nel contesto dell'inclusione delle chiamate, un agente è la persona che parla direttamente al cliente durante la telefonata. L'agente può ricevere indicazioni o feedback dal supervisore attraverso l'inclusione della chiamata, se necessario.
La chiamata nativa mobile viene inoltrata alla riunione
La funzione di escalation della chiamata nativa mobile alla riunione è dotata di due funzioni uniche:
Nuova notifica push
Gli utenti mobili su una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando si avvia una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si accede direttamente alla schermata in chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata utilizzando il controllo chiamate Cisco per le chiamate su cellulare, viene visualizzata la notifica Webex durante una chiamata su cellulare.
Trasferisci chiamata mobile a riunione
Quando sei nel mezzo di una chiamata con qualcuno, potresti voler trasferire la chiamata in una riunione per utilizzare alcune funzioni di riunione avanzate come video, condivisione o lavagna. In alternativa, invitare altre persone alla discussione e passare a una riunione.
Requisiti BroadWorks
Funzione attivabile 25239
R23 con XSP|ADP:
AS Patch AP.as.23.0.1075.ap383064
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
Patch AP.platform.23.0.1075.ap383064
R23 con ADP:
AS Patch AP.as.23.0.1075.ap383064
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R24:
Cerotto AS: AP.as.24.0.944.ap383064
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R25:
AS RI release Rel_2022.08_1.354
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e NPS versione > 2022.08_1.350
Configurazione chiamata URI per supportare lo spostamento della chiamata alla riunione
Criteri di chiamata Url NS
Definisci la regola per (.*)webex.com da indirizzare attraverso I-SBC
NS_CLI/Policy/UrlDialing> get WebexMeetings
Policy: UrlDialing Instance: Webex
unknownSipURIHandling = reject
disableSubscriberLookups = true
Enable = true
CallTypes:
Selection = {ALL}
From = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP}
lineportOnly = false
enableSipURIMatchingRules = true
NS_CLI/Policy/UrlDialing/Rules> get WebexMeetings
Policy: UrlDialing Instance: WebexCalling Table: Rules
id pattern routingNE cost weight dtg
===================================================================
1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE di indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> get ne WebexMeetings
Network Element WebexMeetings
Location = 1281465
Data Center =
Static Cost = 1
Static Weight = 99
Poll = false
OpState = enabled
State = OnLine
Profile = NIL_PROFILE
Remote Lookup Enabled = false
Signaling Attributes =
NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings
Routing NE Address Cost Weight Port Transport Route
=====================================================================
WebexMeetings sbc-address 1 99 - unspecified
Profilo di indirizzamento NS
Aggiunta dell'istanza della policy UrlDialing ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> get profile MyInst
Profile: Webex
Policy Instance
==========================================
…
UrlDialing WebexMeetings
AS Usa indirizzamento NS per chiamata NetworkURL
Consente all'AS di rispettare il percorso NS in modalità ibrida AS
AS_CLI/Interface/IMS> set queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un PSAP (Public Safety Answering Point), che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, è necessario integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Usa i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
Chiamata di emergenza E911 in Webex per BroadWorks: utilizzare questo articolo per configurare la chiamata di emergenza E911 in Webex per Cisco BroadWorks utilizzando uno dei seguenti provider E911 supportati:
Banda
Intrado
RedSky
Esclusione di responsabilità per chiamate di emergenza: se disponi di un servizio di posizione, puoi configurare la finestra Esclusione di responsabilità per i servizi di emergenza sull'app Webex in modo da includere un'opzione per gli utenti per aggiornare la propria posizione quando eseguono l'accesso.
Personalizzazione e provisioning dei clienti
Gli utenti scaricano e installano le relative app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedere Piattaforme app Webex). Una volta eseguita l'autenticazione dell'utente, il client si registra sul cloud Webex per messaggistica e riunioni, recupera le informazioni sul branding, scopre le informazioni del servizio BroadWorks e scarica la configurazione delle chiamate dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
Configurare i parametri di chiamata per le app Webex in BroadWorks (come di consueto). Configura i parametri di branding, messaggistica e riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Prepara il tuo ambiente).
Verificare di disporre dei set di tag corretti in BroadWorks System > Resources > Device Management Tag Sets.
Per ciascun client che si sta eseguendo il provisioning:
Scaricare ed estrarre il file zip DTAF per il client specifico.
Importare i file DTAF in BroadWorks all'indirizzo System > Resources > Identity/Device Profile Types
Apri il profilo dispositivo appena aggiunto per la modifica e:
Immettere il nome di dominio completo dell'azienda agricola XSP|ADP e il protocollo di accesso del dispositivo.
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per il funzionamento della condivisione desktop.
È inoltre possibile abilitare il supporto Parte remota eseguendo il seguente comando CLI sul server applicazioni:AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
Salvare il file.
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome | Descrizione |
Priorità codec | Configurazione dell'ordine di priorità per i codec audio e video per le chiamate VoIP |
TCP, UDP e TLS | Configurare i protocolli utilizzati per la segnalazione e il contenuto multimediale SIP |
Porte audio e video RTP | Configurazione degli intervalli di porte per audio e video RTP |
Opzioni SIP | Configurare diverse opzioni relative a SIP (SIP INFO, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti gestiti dal partner. Vedere Configurazione di personalizzazioni di branding avanzate.
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client. |
Personalizzazione dei report dei problemi e degli URL della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito Feedback e Guida", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con Flowthrough Provisioning
Prima di poter eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 | Assegna servizio in BroadWorks: |
2 | Verifica dell'organizzazione cliente e degli utenti in Control Hub: |
Test utente
1 | Scaricare l'app Webex su due diverse macchine. |
2 | Eseguire l'accesso come utenti di test sulle due macchine. |
3 | Effettuare chiamate di prova. |
Provisioning delle organizzazioni dei clienti
Nel modello corrente, eseguiamo automaticamente il provisioning dell'organizzazione del cliente quando si esegue l'onboarding del primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguito una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
Usa API per creare account Webex
Assegna il provisioning integrato IM&P (flowthrough provisioning) con e-mail attendibili per creare account Webex
Assegna provisioning integrato IM&P (flowthrough) senza e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per creare account Webex
Consenti agli utenti di autoattivarsi (invia loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex espone le API pubbliche per consentire ai provider di servizi di integrare il provisioning degli abbonati Webex per Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. Le specifiche per queste API sono disponibili su developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti wholesale verranno rifiutati da queste API. |
Provisioning del flusso
Su BroadWorks, è possibile eseguire il provisioning degli utenti con l'opzione Abilita IM&P integrato. Questa azione provoca l'adattatore di provisioning BroadWorks per effettuare una chiamata API per il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica del codice, ma solo una modifica della configurazione dell'endpoint API per l'adattatore di provisioning.
Il provisioning degli abbonati su Webex può richiedere molti minuti (diversi minuti per l'utente iniziale all'interno di un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il successo del provisioning flowthrough indica che il provisioning è stato avviato. Non indica il completamento. Per confermare che il provisioning di utenti e organizzazione cliente sia completo su Webex, devi accedere a Partner Hub e guardare nell'elenco dei clienti. Gli utenti di trunking BroadWorks possono disporre di Webex per BroadWorks tramite un identificativo di chiamata condiviso (SCA). L'utente che esegue il trunking dovrà disporre del servizio di autenticazione assegnato. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto Webex SCA dall'autenticazione del trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con le funzioni di elenco di indirizzamento o indirizzamento diretto assegnate. |
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata Modello di onboarding. |
Autoattivazione utente
Per eseguire il provisioning degli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
Accedere a Partner Hub e trovare la pagina Elenco clienti.
Fare clic su Visualizza modelli.
Seleziona il modello di onboarding di provisioning che desideri applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non si trova nel sistema BroadWorks associato a questo modello, non può attivarsi automaticamente con il collegamento.
Copiare il collegamento di provisioning e inviarlo all'utente.
È anche possibile includere il collegamento per il download del software e ricordare all'utente di cui ha bisogno di fornire e convalidare il proprio indirizzo e-mail per attivare l'account Webex.
È possibile monitorare lo stato di attivazione dell'utente nel modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi di attivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli all'interno della vista Stato utente che consentono agli amministratori dei provider di servizi Webex per Cisco BroadWorks di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Sposta gli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) |
|
Organizzazione cliente | Collega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge Webex per BroadWorks anche agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) | Se l'organizzazione Webex per BroadWorks non esiste (nessun utente predisposto):
Se esiste un'organizzazione Webex per BroadWorks (viene predisposto almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di autoiscrizione (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (con il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
Sposta utente (con e-mail attendibili): utilizza il provisioning con e-mail attendibili
Sposta utente (con e-mail non attendibili): utilizza il provisioning con e-mail non attendibili
Autoattivazione
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza messaggi e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
L'amministratore aggiunge l'utente.
L'utente viene spinto sul bridge di provisioning BroadWorks.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L’utente apre il messaggio e-mail e fa clic su Attiva account. L'utente viene reindirizzato al portale consumer Webex.
L'utente accede a Webex.
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza messaggi e-mail non attendibili, è necessario prima convalidare l’indirizzo e-mail dell’utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
L'amministratore aggiunge l'utente.
L'utente viene inviato automaticamente al bridge di provisioning BroadWorks.
All'utente viene inviato un testo con un collegamento di attivazione.
L'utente fa clic sul collegamento Attivazione e inserisce l'indirizzo e-mail.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L'utente apre il messaggio e-mail e fa clic su Accedi ora.
L'indirizzo e-mail viene convalidato.
L'utente viene reindirizzato all'accesso al portale consumer Webex.
L'utente accede a Webex.
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Flusso di autoattivazione
Se l'utente dispone di un account BroadWorks esistente, può utilizzare il processo di autoattivazione per spostare l'account.
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
L'utente inserisce il proprio indirizzo e-mail.
L'utente viene inviato al bridge di provisioning BroadWorks.
Viene inviata un'e-mail automatica all'indirizzo e-mail dell'utente.
L'utente apre il messaggio e-mail e fa clic sul collegamento Accedi ora, che convalida l'indirizzo e-mail.
CI rileva che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di poter continuare.
L'utente viene reindirizzato all'accesso a Webex.
L'utente accede al portale consumer.
L'utente fa clic su Elimina account.
L'account Webex precedente viene eliminato.
All'utente è stato predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
Collegamento di Webex per BroadWorks all'organizzazione esistente
Se sei un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, che non è ancora associata a un'azienda BroadWorks gestita da un partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso amministratore per la richiesta di provisioning riuscita.
È necessaria l'approvazione dell'amministratore dell'organizzazione se una delle seguenti affermazioni è vera:
L'organizzazione cliente esistente dispone di 100 utenti o più
L'organizzazione dispone di un dominio e-mail verificato
Dominio organizzazione richiesto
Se nessuno dei criteri di cui sopra è vero, può verificarsi un Attacco automatico.
In uno scenario di allegato automatico, un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner verranno concessi diritti di amministrazione provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà eseguito un amministratore completo. Con l'accesso amministratore di provisioning, la visibilità in Control Hub sarà limitata agli utenti nell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione. |
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che i messaggi e-mail di invito amministratore vengano collegati a organizzazioni esistenti (il tasto di alternanza è attivo per impostazione predefinita). |
1 | L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedere Provisioning delle organizzazioni dei clienti. Si verifica quanto segue:
| ||
2 | Con l'accesso amministratore completo, l'amministratore del partner può completare il processo di provisioning del cliente. Dovrai provare a eseguire nuovamente il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora come amministratore completo esterno, non si dovrebbe osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione cliente esistente sarà visibile come cliente sotto Webex per l'organizzazione partner BroadWorks.
|
Condizioni dell'allegato organizzazione
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione del cliente target. In caso contrario, verrà creata una nuova organizzazione cliente.
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato sul modello di provisioning Webex per BroadWorks. Di conseguenza, non vi sono modifiche alla modalità di accesso degli utenti esistenti.
Tuttavia, se l'organizzazione cliente esistente dispone di branding di base abilitato, una volta eseguito il collegamento, le impostazioni di branding avanzate del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
Il nome dell'organizzazione esistente non cambierà.
Non è stata apportata alcuna modifica all'impostazione del flag di soppressione e-mail nelle impostazioni dell'organizzazione esistente. Ciò può avere effetto sui nuovi utenti predisposti. A seconda di come è impostato il flag, i nuovi utenti possono o meno ricevere un'e-mail con un codice che deve essere immesso per completare l'attivazione.
La modalità di amministrazione con restrizioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
Accertarsi di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
Un'azienda BroadWorks può essere associata solo a una organziazione Webex. Non è possibile eseguire il provisioning degli abbonati da una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com
.
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo. |
L'indirizzo e-mail aggiunto dall'amministratore dell'organizzazione cliente come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore partner come configurato nel modello di onboarding su Partner Hub. Dopo aver aggiunto l'e-mail dal modello di onboarding in Partner Hub come amministratore completo, qualsiasi amministratore aggiuntivo del partner dovrà essere aggiunto anche come amministratore esterno con diritti di amministratore completo. |
Scollegare Webex per BroadWorks dall'organizzazione esistente
Effettuare le seguenti operazioni per scollegare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato accidentalmente Webex per BroadWorks a un'organizzazione esistente e si desidera rimuovere l'allegato.
In Flusso standard, il distacco di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati. |
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso all'amministratore esterno seguendo Approva richiesta amministratore esterno.
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Remove a BroadWorks Workspace.
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi abbonato BroadWorks.
Rimuovi gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se gli utenti sono stati predisposti tramite il flusso e-mail non attendibile e non sono stati ancora inseriti messaggi e-mail validi, gli utenti rimangono in stato di attesa. Segui Verifica provisioning utente con e-mail non attendibili per eliminare gli utenti.
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Hybrid, nella sezione BroadWorks Calling elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera collegare Webex per BroadWorks al cliente, seguire i processi di provisioning per collegarlo a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API Rimuovi abbonato BroadWorks è quella di accedere a BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati. |
Gestione di utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente sono in BroadWorks. Un'identità e-mail distinta per l'utente e le relative licenze per le funzioni Webex vengono conservate in Webex.
Verifica provisioning utente con e-mail non attendibili
Se si sta eseguendo il provisioning di utenti Webex per BroadWorks utilizzando il provisioning flow-through con e-mail non attendibili, gli utenti devono eseguire il provisioning automaticamente inserendo il relativo indirizzo e-mail nel portale di attivazione utente. Se l'utente riscontra un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riscontra nuovamente l'errore, l'amministratore può utilizzare i passaggi seguenti in Partner Hub per esaminare lo stato e caricare l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 | Accedere a Partner Hub e trovare la pagina Elenco clienti. |
2 | Fare clic su Visualizza modelli. Selezionare il modello di onboarding appropriato che si desidera applicare a questo utente. |
3 | In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con e-mail non attendibili sia configurato correttamente:
|
4 | In seguito al provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato del provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo stato corrente, che mostra se l'utente è predisposto o se è presente un requisito in sospeso.
|
5 | Per gli utenti con errori o requisiti in sospeso, fare clic sui tre punti a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili quando si visualizza l'elenco degli utenti:
Esporta: fare clic su questo pulsante se si desidera esportare l'elenco utenti in un file CSV.
Escludi utenti predisposti: abilita questo tasto di alternanza se desideri visualizzare solo gli utenti con requisiti o errori in sospeso.
Modifica ID utente o indirizzo e-mail
Modifiche a ID utente e indirizzo e-mail
L'ID e-mail e l'ID alternativo sono gli attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. La tabella seguente descrive gli scopi di questi diversi attributi e cosa fare se occorre cambiarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non puoi modificare questo identificativo e comunque collegare l'utente allo stesso account in Webex. È possibile eliminare l'utente e ricreare se non è corretto. |
ID e-mail | ID utente | Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si afferma che l'e-mail è attendibile Non richiesto in BroadWorks se non si asserisce di poter considerare attendibili i messaggi e-mail Non richiesto in BroadWorks se consenti agli abbonati di autoattivarsi | È presente un processo manuale per modificare questa opzione in entrambe le posizioni se all'utente è stato eseguito il provisioning con l'indirizzo e-mail errato:
Non modificare l'ID utente BroadWorks. Questa operazione non è supportata. |
ID alternativo | Nessuno | Consente di abilitare l'autenticazione dell'utente per e-mail e password rispetto all'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se Non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti dovranno inserire il proprio ID utente BroadWorks durante l'autenticazione. |
Modifica pacchetto utenti in Partner Hub
1 | Accedi a Partner Hub e fai clic su Clienti. |
2 | Individuare e selezionare l'organizzazione del cliente a cui è assegnato l'utente. Viene visualizzata la pagina di panoramica dell'organizzazione in un pannello a destra dello schermo. |
3 | Fare clic su Visualizza cliente. L'organizzazione del cliente si apre in Control Hub, mostrando la pagina Panoramica.
|
4 | Fare clic su Utenti, quindi individuare e fare clic sull'utente interessato. |
5 | Nei Servizi dell'utente, fare clic su Webex per i pacchetti BroadWorks (Abbonamenti). Si apre il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 | Nella scheda Profilo, cercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 | Seleziona il pacchetto che desideri per questo utente (Base, Standard, Premium o Softphone) e fai clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 | Puoi chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium hanno siti di riunione distinti associati a ciascun pacchetto. Quando un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato viene visualizzato con due siti di riunione in Control Hub. Le funzionalità di riunione organizzatore e il sito della riunione dell'abbonato vengono allineati al pacchetto corrente. Il sito della riunione del pacchetto precedente e qualsiasi contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili all'amministratore del sito della riunione. |
Potrebbero essere necessarie da due a tre ore per le nuove impostazioni PMR derivanti da una modifica del pacchetto da aggiornare. |
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si desidera eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto alcun trasferimento automatico del ruolo di amministratore nel caso in cui venga eliminato l'ultimo amministratore. |
API Cisco BroadWorks per Webex
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
Eseguire la richiesta API Remove a BroadWorks Subscriber su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento Webex per Cisco BroadWorks. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
Eseguire la richiesta Elimina una persona API su https://developer.webex.com/docs/api/v1/people/delete-a-person per eliminare completamente l'utente.
Provisioning flow-through
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – IM&P integrato in BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks - Parte 2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento Webex per Cisco BroadWorks dall'utente. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla propria organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 | Usa le API Persone per eliminare tutti gli utenti dall'organizzazione:
| ||
2 | Se la sincronizzazione rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione rubriche tramite Partner Hub: Per disabilitare la sincronizzazione rubriche tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API aziendale BroadWorks e disabilita l'impostazione enableDirSync. Tutti gli utenti correlati alla sincronizzazione rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione degli utenti (utilizzando entrambi i metodi) può richiedere del tempo a seconda della quantità di utenti. | ||
3 | Una volta rimossi tutti gli utenti, utilizza l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Gestione delle release
I controlli di gestione delle release in Partner Hub consentono a Webex per i provider di servizi Cisco BroadWorks di gestire facilmente le release consentendo loro di controllare la cadenza di rilascio in base alla quale le app Webex degli utenti vengono aggiornate all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza gli aggiornamenti automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
Configurazione di pianificazioni di rilascio personalizzate con rinvii dalla pianificazione di rilascio predefinita Cisco
Configurare una singola pianificazione della release e trasferirla a cascata a tutte le organizzazioni dei clienti che gestiscono
Assegna diverse pianificazioni di rilascio a diverse organizzazioni di clienti
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di rilascio personalizzate, vedere l'articolo Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
Aggiunta di un cluster BroadWorks in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
Aggiunta di un modello di onboarding in Partner Hub
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | ||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | ||
3 | Fare clic su Visualizza cluster. | ||
4 | Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro flyout a destra.
| ||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | |||||||||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | |||||||||
3 | Fare clic su Visualizza modelli. | |||||||||
4 | Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere a Webex Assistant di seguire le azioni, prendere nota di decisioni importanti ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant per Meetings è disponibile gratuitamente per i siti per riunioni con pacchetto Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilitazione di Webex Assistant per Meetings
Webex Assistant è abilitato per impostazione predefinita per i clienti Broadworks con pacchetto standard e premium.
Gli amministratori dei partner e gli amministratori delle organizzazioni dei clienti possono disabilitare la funzione per le organizzazioni dei clienti tramite Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
Il supporto è limitato ai siti per riunioni con pacchetto Premium e Standard e solo alle sale riunioni personali.
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
La condivisione di contenuto tramite e-mail è accessibile solo dagli utenti all'interno della tua organizzazione
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Il contenuto della riunione non è accessibile anche se condiviso tra utenti di pacchetti diversi dall'interno della stessa organizzazione.
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile, pertanto le trascrizioni post-riunione non sono disponibili se Webex Assistant è abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni utente su come utilizzare la funzione, vedere Uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
Webex Calling gratuito è abilitato per impostazione predefinita consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, che disabilita tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzione
Se Webex Calling è disabilitato, le seguenti condizioni si applicano a Webex per gli utenti Cisco BroadWorks:
Gli utenti non visualizzano più Chiamata con Webex come opzione di chiamata selezionabile sull'app Webex.
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, la cronologia chiamate, i contatti, inserendo l'URI dell'altro utente o l'indirizzo e-mail nella barra di ricerca.
Condivisione schermo all'interno di una chiamata BroadWorks.
Le riunioni Webex e la presenza in telefonia funzionano ancora, anche se le chiamate Webex sono disabilitate.
Disabilita chiamate Webex (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno di Aggiungi un nuovo modello guidata. Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti assegnate al modello.
Per informazioni dettagliate sulla configurazione di un nuovo modello di onboarding, vedere Configurazione dell'organizzazione partner in Partner Hub.
Disabilita chiamate Webex (modello di onboarding esistente)
Seguire questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
Accedere a Partner Hub all'indirizzo admin.webex.com.
Scegliere Impostazioni.
Fare clic su Visualizza modello e scegliere il modello di inserimento appropriato.
Fai clic su Disabilita chiamata gratuita Cisco Webex.
Fai clic su Salva.
Disabilita chiamate Webex (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare Webex Calls per un utente esistente, è possibile seguire una delle procedure seguenti per aggiornare l'utente.
Accertarsi di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigura l'utente con le chiamate Webex abilitate. |
Se si utilizza il provisioning flow-through, è possibile effettuare le seguenti operazioni:
Aprire CommPilot e passare alla configurazione utente.
Rimuovere il servizio Integrated IM+P dall'utente e fare clic su OK.
Aggiungere il servizio Integrated IM+P all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
Utilizzare Remove a BroadWorks Subscriber API per eliminare l'utente.
Utilizzare la Provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione della condivisione video o dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per informazioni dettagliate sulla configurazione e le opzioni complete, vedere Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è anche possibile configurare se il contenuto multimediale delle chiamate in ingresso utilizza per impostazione predefinita solo il video o l'audio. |
Indicatore di stato della linea / Notifica risposta per assente
L'indicatore di stato/notifica di risposta per assente utilizza le funzioni di risposta per assente indirizzata. Un utente con indicatore di stato riceve una notifica audio e visiva sull'app Webex quando un utente dell'elenco di indicatori di stato monitorato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può Ignorare o Rispondere alla chiamata dell'utente monitorato.
La notifica dell'indicatore di stato/risposta per assente consente di rispondere alle chiamate di altri membri del team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra chiamata multipla - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza dei membri del team Webex e non Webex. I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati nella rubrica in Webex e avranno solo stati "sconosciuti" e "in chiamata" (lo stato suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
La presenza non è supportata per gli utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
Gli utenti CI senza autorizzazione cloud Webex o tipo di account macchina (spazi di lavoro) visualizzano solo la presenza "in chiamata" e "sconosciuta". Nessun stato attivo, suoneria, ecc.
Gli utenti non Webex dall'elenco di indicatori di stato, che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza "sconosciuta".
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
Se un utente non Webex dell'indicatore di stato detiene una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate su BroadWorks. Installare solo le patch valide per la versione in uso:
Per R22:
Piattaforma AP.22.0.1123.ap382053
AP.as.22.0.1123.ap382053
AP.as.22.0.1123.ap382362
AP.xsp.22.0.1123.ap382053
AP.xsp.22.0.1123.ap382362
AP.as.22.0.1123.ap383459
AP.as.22.0.1123.ap383520
Per R23:
Piattaforma AP.23.0.1075.ap382053
AP.as.23.0.1075.ap382053
AP.as.23.0.1075.ap382362
AP.as.23.0.1075.ap383459
AP.as.23.0.1075.ap383520
Se si utilizza XSP|ADP:
AP.xsp.23.0.1075.ap382053
AP.xsp.23.0.1075.ap382362
Se si utilizza ADP:
Xsi-Actions-23_2022.01_1.200.bwar
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
Per R24:
AP.as.24.0.944.ap382053
AP.as.24.0.944.ap382362
AP.as.24.0.944.ap383459
AP.as.24.0.944. ap383520
Xsi-Actions-24_2022.01_1.200.bwar
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
<busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare la funzione 101642 Enhanced Xsi Mechanism Per la telefonia del team su AS:
AS_CLI/System/ActivatableFeature> activate 101642
Abilita X-BroadWorks-Remote-Party-Info
in AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamata SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Accertarsi che i seguenti servizi siano assegnati agli utenti:
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP. |
Configurazione dell'indicatore di stato della linea su BroadWorks
Gli amministratori dei partner possono utilizzare la seguente procedura per impostare l'indicatore di stato della linea per un utente.
Accedere a BroadWorks CommPilot.
Per un utente selezionato, accedere ad Applicazioni client e configurare l'indicatore di stato della linea.
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
Utilizzare i parametri di ricerca per individuare e aggiungere utenti all'elenco Utenti monitorati.
Fai clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento di coinvolgimento del pubblico facile da usare. Consente alle persone di ottenere il massimo dalle riunioni colmando la distanza tra oratori e pubblico. Quando Slido è integrato nell'organizzazione Control Hub, gli utenti possono aggiungere l'Slido app alle riunioni nell'app Webex. Questa integrazione offre ulteriori funzionalità di Q&A e sondaggio alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando è stata accettata una riunione nel client Outlook che corrisponde a un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che hai assunto un impegno diverso e che la risposta potrebbe essere ritardata.
Per abilitare questa funzione:
andare alla scheda Generale della scheda Impostazioni su Windows o Preferenze su Mac.
Selezionare la casella per Mostra in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, "In una riunione di calendario" in Webex è associato a "Occupato" in Outlook. |
Avvertenza
Per utilizzare questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come funziona altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la sua presenza non verrà aggiornata fino al termine della riunione. A tale scopo, sarà necessario riavviare il client per rispondere.
Risposta automatica con tono
Con la risposta automatica con tono, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul desktop. Quando l'app Webex squilla sull'altra parte, l'utente sente un determinato segnale acustico che indica che la chiamata è in connessione.
Per utilizzare questa funzione per un utente Webex per Cisco BroadWorks:
La funzione è supportata solo sull'aspetto della linea principale
L'app Webex deve essere l'identificativo di linea principale
Il tag %ENABLE_AUTO_ANSWER_WXT% deve essere abilitato
Se l'utente dispone anche di indicatori di chiamata condivisa (ad esempio, un telefono da tavolo è configurato come uno degli indicatori di linea secondaria), la funzione è ancora supportata sull'aspetto principale, a condizione che gli indicatori di chiamata condivisa siano configurati per non ricevere chiamate in arrivo. Per effettuare questa operazione, è possibile configurare una delle tre condizioni seguenti su BroadWorks per tutte le chiamate condivise:
Avvisa tutti gli aspetti delle chiamate con clic è disabilitato nella configurazione dell'aspetto chiamata condivisa: questo è l'approccio consigliato
o
Consenti terminazione a questa posizione deve essere disabilitato per tutte le chiamate condivise o
o
Posizioni disabilitate per tutti gli indicatori di chiamata condivisi
Aumentare la capacità
Aziende agricole XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare quante risorse XSP|ADP aggiuntive sono necessarie per l'aumento proposto dei numeri di abbonati. Per le aziende NPS dedicate o Webex dedicato per le aziende Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
Fattoria dedicata in scala: Aggiungere uno o più server XSP|ADP all'azienda che ha bisogno di capacità extra. Installare e attivare lo stesso set di applicazioni e configurazioni dei nodi esistenti dell'azienda agricola.
Aggiungi azienda agricola dedicata: Aggiungi una nuova fattoria XSP|ADP dedicata. Dovrai creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti nella nuova fattoria, per ridurre la pressione sulla fattoria esistente.
Aggiungere azienda agricola specializzata: Se si verificano strozzature per un particolare servizio, è possibile creare un'azienda agricola ADP|XSP separata a tale scopo, tenendo conto dei requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster di Control Hub e le voci DNS se si modifica l'URL del servizio con una nuova azienda agricola.
In tutti i casi, è tua responsabilità monitorare e assegnare risorse all’ambiente BroadWorks. Se si desidera contattare l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare i servizi professionali.
Gestione dei certificati del server HTTP
È necessario gestire questi certificati per le applicazioni Web autenticate mTLS su XSP|ADP:
La nostra catena di certificati di attendibilità dal cloud Webex
Certificati delle interfacce del server HTTP di XSP|ADP
Catena di fiducia
È possibile scaricare la catena del certificato di attendibilità da Control Hub e installarlo sugli ADP|XSP durante la configurazione iniziale. Prevediamo di aggiornare il certificato prima della scadenza e di informarvi su come e quando modificarlo.
Interfacce del server HTTP
L'|ADP XSP deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Certificati ordine. Quando si protegge l'interfaccia, viene generato un certificato autofirmato per l'interfaccia. Questo certificato è valido per un anno da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione di Partner Hub che gli amministratori dei partner possono assegnare a organizzazioni di clienti specifiche per limitare le impostazioni dell'organizzazione che gli amministratori dei clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione del cliente, tutti gli amministratori del cliente di tale organizzazione, indipendentemente dalle autorizzazioni dei ruoli, non sono in grado di accedere a un set di controlli con limitazioni in Control Hub. Solo un amministratore partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner esiste un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita le autorizzazioni di ruolo specifiche per gli amministratori dei clienti nell'organizzazione a cui è applicata l'impostazione. |
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità con limitazioni per partner. Dopo l'accesso, vedrà un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner notifica all'amministratore del cliente che la Modalità con limitazioni è abilitata e che l'amministratore potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore del cliente in un'organizzazione in cui con limitazioni della modalità partner è abilitata, il livello di accesso di Control Hub è determinato con la formula seguente:
(Accesso a Control Hub) = (Entitlements Role Organization) - (Limitato dalle limitazioni della modalità partner)
Limitazioni
Quando è abilitata la modalità con limitazioni per partner per un'organizzazione del cliente, gli amministratori dei clienti di tale organizzazione non possono accedere alle seguenti impostazioni di Control Hub:
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
Pulsante Gestisci utenti: disattivato.
Aggiungi o modifica manualmente utenti: nessuna opzione per aggiungere o modificare gli utenti, né manualmente né tramite CSV.
Richiedi utenti: non disponibile
Assegna automaticamente licenze: non disponibile
Sincronizzazione rubriche —Impossibile modificare le impostazioni di sincronizzazione delle rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato ed e-mail principale* sono modificabili.
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, messaggi, riunioni, chiamate)
Visualizza stato servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
Numero di lavoro principale: questo campo è di sola lettura.
Nella vista Account, non sono disponibili le seguenti impostazioni:
Nome società: campo di sola lettura.
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
Dominio: accesso di sola lettura.
E-mail: le impostazioni Elimina inviti e-mail di amministrazione e Selezione impostazioni internazionali e-mail sono di sola lettura.
Autenticazione: nessuna opzione per la modifica delle impostazioni di autenticazione e SSO.
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
Impostazioni chiamata: le impostazioni di priorità della chiamata delle opzioni dell'app sono di sola lettura.
Funzionamento chiamata: le impostazioni sono di sola lettura.
Posizione > PSTN: le opzioni Gateway locale e Cisco PSTN sono nascoste.
Sotto SERVIZI, le opzioni di servizio Migrazioni e Connected UC vengono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori partner possono utilizzare la procedura seguente per l'abilitazione Con limitazioni della modalità partner per una determinata organizzazione cliente (l' impostazione predefinita è abilitata).
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
Seleziona l'organizzazione cliente applicabile.
Nella vista Impostazioni di destra, abilitare il Con limitazioni della modalità partner per attivare l'impostazione.
Se si desidera disattivare la modalità Con limitazioni per partner, disabilitare l'interruttore.
Se il partner rimuove la modalità amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà eseguire quanto segue:
|
Analisi dei partner
I miglioramenti di Control Hub consentono agli amministratori partner di visualizzare e aggiornare facilmente le informazioni sui pacchetti per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata di tutti i clienti e include i seguenti dettagli:
Utenti totali per pacchetto (Softphone, Base, Standard, Premium)
Tendenza utenti per pacchetto (giornaliero/settimanale/mensile)
Clienti con n. di pacchetti assegnati
Per informazioni dettagliate su come utilizzare Analisi dei partner, vedere l'articolo Webex Analisi per i pacchetti Webex per la vendita all'ingrosso e Webex per BroadWorks in Partner Hub .
API di report fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare report di fatturazione. Nella tabella seguente vengono elencate le API, il tipo di accesso richiesto e i requisiti di ruolo.
API di fatturazione | Scopo | Tipo di accesso | Requisiti di ruolo per API (L'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Creazione di un report di fatturazione BroadWorks | Utilizzato per generare un report di fatturazione. | Accesso in scrittura |
|
Elenca report di fatturazione BroadWorks | Consente di elencare i report disponibili per la visualizzazione. | Accesso in lettura |
|
Ottenere un report di fatturazione BroadWorks | Utilizzato per ottenere una copia di un report generato. | Accesso in lettura |
|
Eliminazione di un report di fatturazione BroadWorks | Utilizzato per eliminare un report generato. | Accesso scrittura |
|
Campi di fatturazione
Nella tabella seguente sono elencati i campi contenuti nel report generato.
Campo | Descrizione |
---|---|
nome rivenditore | Nome partner o ID organizzazione partner |
ID fatturazione | Identificativo di fatturazione univoco del partner o numero C |
IdImpresaSp | L'identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno | Stato versione di prova interna del cliente (Sì/No) |
ID utente | IDutente dell'abbonato su BroadWorks |
id abbonato | Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato | Sì/No |
Data iniziale | Data di provisioning dell'abbonato. |
dataInizioFatturazione | Data di inizio fatturazione in questo mese |
DataFineFatturazione | Data di fine fatturazione in questo mese |
pacchetto | Il tipo di confezione che viene caricata |
quantità | Quantità ripartita per fatturazione.
|
|
Risoluzione dei problemi di Webex per Cisco BroadWorks
Abbonamento alla pagina di stato Webex
Innanzitutto verificare https://status.webex.com quando si verifica un'interruzione imprevista del servizio. Se non hai modificato la tua configurazione in Control Hub o BroadWorks prima dell'interruzione, controlla la pagina di stato. Ulteriori informazioni sull'iscrizione per le notifiche di stato e incidenti al Centro assistenza Webex.
Usa analisi Control Hub
Webex monitora l'utilizzo e i dati di qualità per la tua organizzazione e le organizzazioni dei tuoi clienti. Ulteriori informazioni sulle analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
Clienti o utenti non vengono creati in Control Hub con provisioning flowthrough:
Il server applicazioni può raggiungere l'URL di provisioning?
L'account di provisioning e la password sono corretti? Tale account esiste in BroadWorks?
I cluster non riescono in modo coerente a eseguire i test di connettività:
La connessione mTLS al servizio di autenticazione non riesce quando si crea il primo cluster in Partner Hub, poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. In caso contrario, non è possibile creare un'ancora attendibile sul servizio di autenticazione XSP|ADPs, pertanto la connessione mTLS di prova da Partner Hub non viene eseguita correttamente. |
Le interfacce XSP|ADP sono accessibili pubblicamente?
Stai utilizzando le porte corrette? È possibile immettere una porta nella definizione dell'interfaccia sul cluster.
Convalida non riuscita interfacce
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Esaminare i consigli per la configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Rivedere i consigli sulla configurazione dell'interfaccia in questo documento, con particolare attenzione a:
- Accertarsi di aver condiviso le chiavi RSA tra tutti gli XSP|ADP.
- Accertarsi di aver fornito l'URL AuthService al contenitore Web su tutti gli XSP|ADP.
- Se è stata modificata la configurazione della crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'|ADP XSP richiede di immettere il formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento elencava erroneamente le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati sul proprio archivio attendibile XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere i certificati del client?
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere i certificati del client?
Problemi del cliente
Verificare che il client sia connesso a BroadWorks
Accedere all'app Webex.
Verificare che l'icona Opzioni di chiamata (un ricevitore con una marcia sopra) sia presente sulla barra laterale.
Se l'icona non è presente, l'utente potrebbe non essere ancora abilitato per il servizio di chiamata in Control Hub.
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici . Viene visualizzato lo stato Sessione SSO A cui è stato eseguito l'accesso.
Se viene visualizzato un servizio telefonico diverso, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Tale verifica comporta:
Il client ha eseguito correttamente il transveresed dei microservizi Webex richiesti.
Autenticazione dell'utente eseguita correttamente.
Il client ha ricevuto un token Web JSON di lunga durata dal sistema BroadWorks.
Il client ha recuperato il proprio profilo dispositivo e si è registrato su BroadWorks.
Registri client
Tutti i client dell'app Webex possono Inviare I Registri a Webex. Questa è l'opzione migliore per i client mobili. È inoltre necessario registrare l'indirizzo e-mail dell'utente e l'ora approssimativa in cui si è verificato il problema se si sta cercando assistenza da TAC. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se è necessario raccogliere manualmente i registri da un PC Windows, si trovano come segue:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac:/Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS configurata male
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
Verificare che la catena di certificati Webex sia installata come ancora affidabile.
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e firmato da una CA ben nota.
Messaggio di eccedenza licenza
Questo messaggio può apparire per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'utilizzo delle licenze supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Politica di supporto allo stato stazionario
Il provider di servizi è il primo punto di contatto per il supporto del cliente finale (aziendale). Inoltrare i problemi che il SP non è in grado di risolvere al centro TAC. Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Politica di escalation
Tu (provider di servizi/partner) sei il primo punto di contatto per il supporto clienti finali (aziendale).
I problemi che non possono essere risolti dal SP vengono inoltrati al centro TAC.
Versioni di BroadWorks
Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Risorse di autosupporto
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, dove è presente una pagina specifica di Webex per Cisco BroadWorks che elenca argomenti di Guida e supporto comuni dell'app Webex.
L'app Webex può essere personalizzata con questo URL della Guida e un URL di segnalazione problemi.
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I registri vengono inviati al cloud Webex, dove possono essere analizzati da Webex DevOps.
È disponibile anche una pagina Centro assistenza dedicata alla Guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccogliere informazioni per l'invio di una richiesta di assistenza
Quando vengono visualizzati errori in Control Hub, potrebbero essere allegate informazioni che possono aiutare TAC a indagare sul problema. Ad esempio, se viene visualizzato un ID di verifica per un particolare errore o un codice di errore, salvare il testo da condividere con noi.
Prova a includere almeno le seguenti informazioni quando invii una query o apri un caso:
ID organizzazione cliente e ID organizzazione partner (ogni ID è una stringa di 32 cifre esadecimali, separate da trattini)
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce uno
Indirizzo e-mail utente (se un particolare utente riscontra problemi)
Versioni del cliente (se il problema presenta sintomi notati attraverso il cliente)
Confronto UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > | SaaS UC-One | Webex per Cisco BroadWorks |
---|---|---|
Cloud | Cisco UC-One Cloud (GCP) | Webex Cloud (AWS) |
Client | UC-One: Mobile, desktop Receptionist, Supervisore | Webex: Mobile, desktop, Web |
Principale differenza tecnologica | Riunioni condotte sulla tecnologia BroadSoft Meet | Riunioni fornite sulla tecnologia Webex Meetings |
Prove sul campo iniziali | Contesto di stadiazione, clienti beta | Ambiente di produzione, clienti GA |
Identità utente | ID BroadWorks servito come ID principale, a meno che il provider di servizi non disponga già dell'integrazione SSO.
ID utente e segreto in BroadWorks | ID e-mail in Cisco CI serve come ID principale Integrazione SSO in BroadWorks provider di servizi in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks al momento.
L'utente fornisce le credenziali tramite SSO con BroadWorks e Secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e segreti in IdP |
Autenticazione client | Gli utenti forniscono le credenziali attraverso il client Token di lunga durata BroadWorks richiesti se si utilizza la messaggistica Webex | Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso a Webex e aggiornamento dei token |
Gestione / configurazione | I vostri sistemi OSS/BSS e Portale rivenditore | I tuoi sistemi OSS/BSS e Control Hub |
Attivazione partner/provider di servizi | Impostazione una tantum da Cisco Operations | Impostazione una tantum da Cisco Operations |
Attivazione cliente/azienda | Portale rivenditore | Control Hub Creato automaticamente alla prima iscrizione utente |
Opzioni di attivazione utente | Autoiscrizione Imposta IM&P esterno in BroadWorks
| Impostazione di IM&P integrato in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP | Azioni XSI
XSI-Eventi CTI (mTLS) AuthService (mTLS opzionale) DMS | Azioni XSI Azioni XSI (mTLS) XSI-Eventi CTI (mTLS) Servizio di autenticazione (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 | Scarica e installa Webex. Per informazioni dettagliate, vedi Webex | Download dell'app. |
2 | Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 | Inserisci l'indirizzo e-mail e fai clic su Avanti. |
4 | Una delle seguenti operazioni si verifica, a seconda del modo in cui l'organizzazione è configurata in Webex: Webex si carica dopo aver eseguito correttamente l'autenticazione su IdP o BroadWorks.
|
Scambio e archiviazione dati
Queste sezioni forniscono dettagli sullo scambio e la memorizzazione dei dati con Webex. Tutti i dati vengono crittografati sia in transito che a riposo. Per ulteriori informazioni, vedi Webex App Security.
Onboarding provider servizi
Quando si configurano cluster e modelli utente in Webex Control Hub durante l'onboarding di provider di servizi, è possibile scambiare i seguenti dati BroadWorks memorizzati in Webex:
URL Xsi-Actions
URL Xsi-Events
URL interfaccia CTI
URL servizio di autenticazione
Credenziali adattatore di provisioning BroadWorks
Provisioning utente provider di servizi
Questa tabella elenca i dati utente e aziendale che vengono scambiati come parte del provisioning utente attraverso le API Webex.
Trasferimento dei dati in Webex | Da | Attraverso | Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito da SP) | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito dall’utente) | Utente | Portale di attivazione utente | Sì |
Nome | BroadWorks, per API | API Webex | Sì |
Cognome | BroadWorks, per API | API Webex | Sì |
Numero di telefono principale | BroadWorks, per API | API Webex | Sì |
Numero telefono cellulare | BroadWorks, per API | API Webex | Sì |
Estensione principale | BroadWorks, per API | API Webex | Sì |
ID provider di servizi BroadWorks e ID gruppo | BroadWorks, per API | API Webex | Sì |
Lingua | BroadWorks, per API | API Webex | Sì |
Fuso orario | BroadWorks, per API | API Webex | Sì |
Rimozione utente
Le API Webex per Cisco BroadWorks supportano la rimozione parziale e completa dell'utente. Questa tabella elenca tutti i dati utente memorizzati durante il provisioning e ciò che viene eliminato in ogni scenario.
Dati utente | Eliminazione parziale | Eliminazione completa |
---|---|---|
ID utente BroadWorks | Sì | Sì |
No | Sì | |
Nome | No | Sì |
Cognome | No | Sì |
Numero di telefono principale | Sì | Sì |
Numero telefono cellulare | Sì | Sì |
Estensione | Sì | Sì |
ID provider di servizi BroadWorks e ID gruppo | Sì | Sì |
Lingua | No | Sì |
Accesso utente e recupero configurazione
Autenticazione Webex
L'autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da uno qualsiasi dei meccanismi di autenticazione del supporto Webex. (L'autenticazione BroadWorks è trattata separatamente.) Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (indipendente) | Webex | Browser utente |
Credenziali utente | Browser utente | Provider identità (che dispone già di identità utente) |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Autenticazione BroadWorks
L'autenticazione BroadWorks si riferisce all'accesso dell'utente a un'app Webex utilizzando le credenziali BroadWorks. Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (proxy Webex Bwks IdP) | Webex | Browser utente |
Informazioni sul branding e URL BroadWorks | Webex | Browser utente |
Credenziali utente BroadWorks | Utente tramite browser (pagina di accesso con marchio servita da Webex) | Webex |
Credenziali utente BroadWorks | Webex | BroadWorks |
Profilo utente BroadWorks | BroadWorks | Webex |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento dell'avviso di accesso e del messaggio di errore:
- Attualmente gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso poiché la password è già scaduta. Con questa funzione, se la password sta per scadere tra 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere, con l'indicazione di quanti giorni rimangono, e all'utente viene consigliato di contattare il partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su true, è stato emesso l'errore "nome utente e password errati", ma ora con questa funzione viene migliorato il messaggio di errore: Tentativo di accesso non riuscito. La combinazione di ID utente e password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice errore 100006
Controllo flusso di accesso:
- Il partner può limitare l'accesso abilitando un'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione in broadworks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, quindi viene visualizzato un errore che indica che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso può essere configurato dal partner come parte della funzione di personalizzazione avanzata. I partner solitamente configurano il collegamento per passare dall'utente a un portale partner per la gestione della password e la reimpostazione della password.
Questa funzione migliora l'esperienza di accesso utente solo durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se una password scade mentre l'utente è connesso all'app Webex. L'utente riceve la notifica di scadenza della password al successivo tentativo di accesso. |
Recupero configurazione cliente
Questa tabella illustra la tipologia di dati scambiati tra le diverse componenti in fase di recupero delle configurazioni del cliente.
Trasferimento dei dati | Da | Per |
---|---|---|
Iscrizione | Client | Webex |
Impostazioni organizzazione, inclusi URL BroadWorks | Webex | Client |
Token JWT BroadWorks | BroadWorks attraverso Webex | Client |
Token JWT BroadWorks | Client | BroadWorks |
Token dispositivo | BroadWorks | Client |
Token dispositivo | Client | BroadWorks |
File di configurazione | BroadWorks | Client |
Utilizzo allo stato stazionario
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione dopo la scadenza del token, tramite BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Trasferimento dei dati | Da | Per |
---|---|---|
Segnalazione SIP | Client | BroadWorks |
Supporto SRTP | Client | BroadWorks |
Segnalazione SIP | BroadWorks | Client |
Supporto SRTP | BroadWorks | Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Trasferimento dei dati | Da | Per |
---|---|---|
Messaggistica e presenza REST HTTPS | Client | Webex |
Messaggistica e presenza REST HTTPS | Webex | Client |
Segnalazione SIP | Client | Webex |
Supporto SRTP | Client | Webex |
Segnalazione SIP | Webex | Client |
Supporto SRTP | Webex | Client |
Uso dell'API di provisioning
Accesso sviluppatore
Le specifiche API sono disponibili su https://developer.webex.com e una guida all'uso è disponibile su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l' accedere per leggere la specifica API all'indirizzohttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Autenticazione e autorizzazione applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (ad esempio provisioning abbonato) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere l'aggiornamento e l'accesso ai token per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
Devi prima registrare la tua integrazione con Webex. Una volta eseguita la registrazione, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di accesso e aggiornamento necessari.
Per ulteriori dettagli sulle integrazioni e sulle modalità di creazione di questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli obbligatori per l'implementazione delle integrazioni: sviluppatore e utente autorizzatore, che possono essere svolti da persone/team separati nel proprio ambiente.
|
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning utilizzata:
Modalità Enterprise: il nome dell'organizzazione corrisponde esattamente a spEnterpriseId.
Modalità provider di servizi: il nome dell'organizzazione è la parte groupID di spEnterpriseId.
Il nome dell'organizzazione conterrà qualsiasi spazio vuoto, maiuscolo e caratteri speciali specificati in spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "attuale" con le ultime patch BroadWorks e le app Release Independent (RI). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Assicurarsi di rivedere le note di patch per queste patch software. Alcune patch potrebbero avere requisiti CLI aggiuntivi. |
Versione R22
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | ||
Richiesto per sincronizzazione rubrica | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per il server applicazioni | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per la funzione di registrazione chiamata | ||
Patch richiesta per il provisioning flow-through | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | Richiesto per proxy autenticazione NPS | |
Richiesto per il servizio di autenticazione con convalida token CI | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Obbligatorio per la cronologia chiamate unificata | ||
Altro | AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Richiesto per sincronizzazione rubrica | |
Configurazione server app | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Se si utilizza ADP... | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Versione R24
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per il provisioning flowthrough | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che è necessario configurare per Webex, fare riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utente e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. L'attivazione include la convalida e-mail e l'assegnazione del servizio in Webex. |
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se disponi di indirizzi e-mail affidabili per gli utenti, puoi scegliere di attivarli automaticamente quando esegui il provisioning automatico degli utenti. Questo processo è "provisioning automatico e attivazione automatica".
Provisioning utente automatizzato e attivazione automatica (flusso e-mail affidabile)
Prerequisiti
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase | Descrizione |
---|---|
1 | Citare e prendere ordini per il servizio con i clienti. |
2 | Si elabora l'ordine del cliente e si esegue il provisioning del cliente nei sistemi. |
3 | Il sistema di provisioning dei servizi attiva il provisioning di BroadWorks. Questo passaggio, in sintesi, crea l'azienda e gli utenti. Quindi assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM&P esterno. |
4 | Questo passaggio di provisioning attiva il provisioning automatico dell'organizzazione cliente e degli utenti in Webex. (L'assegnazione del servizio IM&P determina che l'adattatore di provisioning chiami l'API di provisioning Webex). |
5 | I sistemi devono utilizzare l'API di provisioning Webex se successivamente è necessario regolare il pacchetto per l'utente (per passare dall'impostazione predefinita). |
Flusso di accesso SSO
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, che consente l'autenticazione diretta a BroadWorks. L'immagine mostra gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresenta ciò che il client prevede per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizio BroadWorks che segue immediatamente il flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione BroadWorks diretta abilitata (condivisione risorse cross-origin). Di seguito sono riportati alcuni flussi di accesso SSO SAML alternativi:
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
L'unica differenza è nei punti 5 e 6 del flusso di accesso Webex. Nel passaggio 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
Il flusso procede attraverso i restanti passaggi dei due diagrammi.
Il token SSO non viene utilizzato in questo flusso.
Autenticazione SSO SAML Webex:
Nel passaggio 3 del flusso di accesso Webex, il servizio Common Identity restituisce il provider di identità utilizzato dall'autenticazione Webex.
A questo punto, viene invocato un flusso di accesso SSO SAML alternativo per Webex.
Interazioni utente
Accedi
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
CI rileva che l'organizzazione cliente associata dispone del proxy IDP BroadWorks (IDP) configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso (il provider di servizi può contrassegnare questa pagina di accesso).
L'utente inserisce le credenziali BroadWorks.
Broadworks esegue l'autenticazione dell'utente attraverso l'IDP. In caso di successo, l'IDP reindirizza il browser a CI con un SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
Una volta completata l'autenticazione, l'app Webex ottiene i token di accesso da CI (non mostrati nel diagramma). Il client li utilizza per richiedere un token Web Jason (JWT) di lunga durata BroadWorks.
L'app Webex rileva la configurazione di chiamata da BroadWorks e altri servizi da Webex.
L'app Webex si registra in BroadWorks.
Accesso dalla prospettiva dell'utente
Questo diagramma è il tipico flusso di accesso, visualizzato dall'utente finale o dall'abbonato:
Scarica e installa l'app Webex.
È possibile che tu abbia ricevuto il collegamento dal provider di servizi o che tu possa trovare il download nella pagina di download di Webex.
Inserire l'indirizzo e-mail nella schermata di accesso Webex. Fai clic su Avanti.
Solitamente, si viene reindirizzati a una pagina con il marchio del fornitore di servizi.
Questa pagina potrebbe accogliervi tramite il vostro indirizzo e-mail.
Se non è presente alcun indirizzo e-mail o se l'indirizzo e-mail è errato, inserisci il nome utente BroadWorks.
Inserisci la password BroadWorks.
Se è stato eseguito correttamente l'accesso, Webex si apre.
Flusso chiamate - Rubrica aziendale
Flusso chiamata: numero PSTN
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni con i clienti
Recupero del profilo dal registro DMS e SIP con AS
Il client chiama XSI per ottenere un token di gestione dispositivo e l'URL del DMS.
Il client richiede il proprio profilo dispositivo dal DMS presentando il token dal punto 1.
Il client legge il profilo del dispositivo e recupera le credenziali, gli indirizzi e le porte SIP.
Il Client invia un REGISTRO SIP a SBC utilizzando le informazioni dal punto 3.
SBC invia il REGISTRO SIP al SA (l'SBC può eseguire una ricerca nell'NS per individuare un SA se il SBC non conosce già l'utente SIP).
Linee guida per test e laboratorio
Le seguenti linee guida si applicano alle organizzazioni di test e laboratorio:
I partner provider di servizi sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
Tutti gli utenti oltre i primi 50 utenti di test verranno fatturati.
Per garantire un'elaborazione accurata sulla fattura, tutte le organizzazioni di test devono includere il "test" nel nome dell'organizzazione BroadWorks.
Le organizzazioni di test interni devono essere designate all'interno di Webex Control Hub. Ciò al fine di impedire agli utenti di test di essere fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di prova:
Accedi a Partner Hub e seleziona Clienti.
Selezionare il cliente appropriato.
Nella barra di controllo destra, abilitare il tasto di alternanza Organizzazione test interni.
Riproduzione casella vocale
Per la casella vocale, accertarsi di configurare il server multimediale per utilizzare uno dei seguenti codici:
mp3
wav: i file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android
Se si utilizzano i file wav, eseguire i seguenti comandi CLI per configurare il server applicazioni e il server multimediale:
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACIDITÀ
- Elenco di controllo accessi
- ALVEOLO
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APICI
- Servizio di notifica push Apple
- AS
- Server applicazioni
- ATA
- Adattatore per telefono analogico, adattatore che converte la telefonia analogica in VoIP
- BAMBOLA
- Gestione applicazioni BroadSoft
- Autenticazione base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- ALVEOLARE
- Server di messaggistica BroadSoft
- PALUDE
- Flussi bidirezionali Su HTTP sincrono
- BRI
- Basic Rate Interface BRI è un metodo di accesso ISDN
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico telefonico (cfr. partner, provider di servizi, rivenditore a valore aggiunto)
- CAPTCHA
- Test di Turing pubblico completamente automatizzato per distinguere Computer ed Esseri Umani
- CCXML
- Linguaggio di markup eXtensible controllo chiamate
- CIF
- Formato intermedio comune
- CLI
- Interfaccia riga di comando
- CN
- Nome comune
- CNPS
- Server push notifiche chiamate. Un server push notifiche che viene eseguito su un ADP XSP| nel proprio ambiente per eseguire notifiche di chiamata push su FCM e APNS. Vedere il proxy NPS.
- CPE
- Attrezzatura della sede del cliente
- CPR
- Regola presenza personalizzata
- CENERE
- Foglio stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione telefonia computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- NoDist
- Non disturbare
- DNS
- Sistema dei nomi di dominio
- DPG
- Chiama gruppo di pari
- DSCP
- Punto codice servizi differenziati
- DTAF
- File di archivio tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza a doppia tonalità
- Utente finale
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. Sottoscrittore)
- Aziendale
- Una raccolta di utenti finali (cfr. Organizzazione)
- FUSO
- Messaggistica cloud Firebase
- DI FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creare utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning completo flow-through
- Creare e verificare gli utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks e asserendo che ciascun utente BroadWorks dispone di un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. È la spina sul telefono o fax o i connettori sul sistema telefonico analogico. Fornisce un'indicazione di aggancio/aggancio sganciato (chiusura con loop). Poiché la porta FXO è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo FXO".
- FXS
- Foreign Exchange Subscriber è la porta che effettivamente fornisce la linea analogica all'abbonato. In altre parole, è la "spina nella parete" che fornisce un segnale di linea, corrente della batteria e tensione della suoneria.
- GABBIA
- Messaggio cloud Google
- GABBIA
- Modalità Galois/Counter (tecnologia di crittografia)
- HID
- Dispositivo interfaccia uomo
- HTTPS
- Prese protette da protocollo di trasferimento ipertestuale
- IAD
- Dispositivo di accesso integrato
- IM&P
- messaggistica istantanea e presenza
- PSTN IP
- Un provider di servizi che fornisce VoIP ai servizi PSTN, intercambiabile con ITSP, o un termine generale per la telefonia "pubblica" connessa a Internet, fornito collettivamente dai principali provider di telecomunicazioni (piuttosto che dai paesi, come è PSTN)
- ITSP
- Provider servizi di telefonia Internet
- IVR
- Risposta vocale/risponditore interattiva
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificatore Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notazione oggetto script Java
- JESS
- Java Secure Socket Extension; la tecnologia sottostante che fornisce funzioni di connettività sicure ai server BroadWorks
- KEM
- Modulo interno chiave (telefoni Cisco hardware)
- LLT
- Token di lunga durata (o Long Life): token di connessione autodescrittivo e sicuro che consente agli utenti di rimanere autenticati più a lungo e non è legato ad applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIGLIO
- Base di informazioni di gestione
- AVV.
- Server multimediale
- mTLS
- Autenticazione reciproca tra due parti, tramite scambio di certificati, quando si stabilisce una connessione TLS
- MUCO
- Chat con più utenti
- NAT
- Traduzioni dell'indirizzo di rete
- NPS
- Server push notifica; vedere CNPS
- Proxy NPS
-
Un servizio in Webex che fornisce token di autorizzazione di breve durata al CNPS, consentendo di eseguire notifiche di chiamata push a FCM e APN e, in ultima analisi, a dispositivi Android e iOS con Webex.
- ASSOCIAZIONE
- Apri interfaccia client
- Organizzazione
- Società o organizzazione che rappresentano un insieme di utenti finali (cfr. Impresa)
- OTG
- Gruppo di trunk in uscita
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- Partner
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. rivenditore a valore aggiunto, fornitore di servizi, gestore telefonico)
- PBX
- Borsa filiale privata
- DELLA SOCIETÀ
- E-mail avanzata per la privacy
- PIEDINO
- Rete mobile terrestre pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia per le telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- P.ES.
- Server profilo
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Sito web che consente all’amministratore del rivenditore di configurare la soluzione UC-One SaaS. Talvolta viene indicato come portale BAM, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Revisore di frontiera sessione
- CEMENTAZIONE
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; un'organizzazione che fornisce servizi di telefonia o correlati ad altre organizzazioni (cfr. vettore, partner, rivenditore a valore aggiunto)
- SIP
- Protocollo di avvio sessione
- SLITTA
- Token di breve durata (o Short Life) (chiamato anche BroadWorks SSO Token); token autenticato monouso utilizzato per accedere in sicurezza ad applicazioni Web.
- ODORE
- Piccole e medie imprese
- SNMP
- Protocollo di gestione di rete semplice
- sRTCP
- protocollo di controllo trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- sRTP
- protocollo di trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- SSL
- Strato di prese sicure
- Abbonato
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. utente finale)
- TCP
- Protocollo di controllo del cambio
- TDM
- Divisione Tempo Multiplexing
- TLS
- Sicurezza livello trasporto
- ToS
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Comunicazioni unificate
- UI
- Interfaccia utente
- U ID
- Identificativo univoco
- MUTI
- Server di messaggistica
- URI
- Identificativo risorsa uniforme
- URL
- Ricerca risorse uniformi
- DISTURBO
- Condivisione server
- UTC
- Coordinated Universal Time
- UVS.
- Server video
- Rivenditore a valore aggiunto (VAR)
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. vettore, partner, fornitore di servizi)
- VAMPATA
- Array di grafica video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Linguaggio di markup estensibile vocale
- WebDAV
- Creazione e versioni distribuite su Web
- WebRTC
- Comunicazioni Web in tempo reale
- WRS
- Server WebRTC
- XMPP
- Protocollo di presenza e messaggistica estendibile
Configurazione dei servizi (con mTLS per il servizio autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida token CI. Queste procedure sono obbligatorie se si stanno eseguendo più organizzazioni Webex dallo stesso server ADP XSP|. In caso contrario, sono facoltativi.
Se non si eseguono più organizzazioni Webex sullo stesso server ADP XSP|, si consiglia la convalida del token CI (con TLS) per il servizio di autenticazione. Fare riferimento a Configura servizi su Webex per Cisco BroadWorks XSP|ADPs per informazioni dettagliate su come configurare il servizio di autenticazione e altri servizi. |
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con mTLS)
I token longevi di BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sui tuoi XSP|ADP.
Requisiti
I server XSP|ADP che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
XSP|ADP devono condividere le stesse chiavi per crittografare/decrittografare token di lunga durata BroadWorks. Copiare queste chiavi in ogni XSP|ADP è un processo manuale.
Gli ADP XSP|devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli XSP|ADP include:
Distribuire il servizio di autenticazione.
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
Generare e condividere le chiavi RSA su XSP|ADP.
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ogni XSP|ADP utilizzato con Webex:
Attivare l'applicazione del servizio di autenticazione sul percorso
/authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService
(dove
<version>
è la versione BroadWorks).Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
deploy application /authService
Configurazione della durata del token
Verificare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
Impostare la durata su 60 giorni (max 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
set tokenDurationInHours 1440
Genera e condividi chiavi RSA
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori è necessario generare chiavi su un XSP|ADP quindi copiarle su tutti gli altri XSP|ADP.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP. |
Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web
Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token.
Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità per il servizio di autenticazione (con mTLS)
Accedi a Control Hub con l'account amministratore del partner.
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
.Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
.Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Esegui GuidaUpdateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot2023
,webexclientissuing
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte e quattro le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, è richiesto mTLS per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/HttpServer>
e eseguire ilget
comando per visualizzare le interfacce.Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che significa come mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. In sostanza, il primo
true
protegge l'interfaccia con TLS (il certificato del server viene creato se richiesto) e la secondatrue
forza l'interfaccia a richiedere l'autenticazione del certificato del client (insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Interface Port Name Secure Client Auth Req Cluster Fqdn
=======================================================
192.0.2.7 443 XSP|ADP01.collab.example.net true false
192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (autenticazione client richiesta = true) è abilitato il 192.0.2.7
porta 444
. TLS abilitato su 192.0.2.7
porta 443
.
(Opzione) Configurazione di mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, è necessario mTLS per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
e eseguire ilget
per visualizzare le applicazioni in esecuzione.Per aggiungere un'applicazione e richiederne l'autenticazione client (ovvero mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. I nomi delle applicazioni sono elencati qui. Il
true
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
add 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService a 192.0.2.7:443 e richiede di richiedere e autenticare i certificati dal client.
Verifica con get
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
get
Interface Ip Port Application Name Client Auth Req
===================================================
192.0.2.7 443 AuthenticationService true
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Dove andare Avanti
Per la configurazione, è possibile accedere nuovamente al flusso dei documenti principale all'interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca rispetto a AuthService
Webex interagisce con il servizio di autenticazione su una connessione TLS autenticata reciproca. Ciò significa che Webex presenta un certificato client e che XSP|ADP deve convalidarlo. Per garantire l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora attendibile su XSP|ADP (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
Vai a Impostazioni > BroadWorks Calling.
Fare clic sul collegamento del certificato di download.
È inoltre possibile scaricare la catena di certificati da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt. |
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il diagramma seguente riassume dove deve essere distribuita la catena di certificati CA Webex in questi tre casi.
Requisiti del certificato TLS reciproco per proxy bridge TLS
Webex presenta un certificato client firmato da CA Webex al proxy.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità proxy, pertanto il proxy considera attendibile il certificato del client.
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta un certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions:
X509v3 Extended Key Usage:
1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Requisiti di certificato TLS reciproco per proxy passthrough TLS o XSP in DMZ
Webex presenta un certificato client firmato da CA Webex agli XSP.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità degli XSP, pertanto gli XSP si affidano al certificato client.
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
Gli XSP presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i certificati server degli XSP.
Cronologia revisioni documenti
La tabella seguente mostra lo storico delle modifiche apportate a questo documento negli ultimi 12 mesi.
Data | Versione | Descrizione della modifica | |
---|---|---|---|
7 marzo 2024 | 2-111 |
| |
24 febbraio 2024 | 2-110 |
| |
20 febbraio 2024 | 2-109 |
| |
7 febbraio 2024 | 2-108 |
| |
25 gennaio 2024 | 2-107 |
| |
23 gennaio 2024 | 2-106 |
| |
10 gennaio 2024 | 2-105 |
| |
20 dicembre 2023 | 2-104 |
| |
13 dicembre 2023 | 2-103 |
| |
12 dicembre 2023 | 2-102 |
| |
8 dicembre 2023 | 2-101 |
| |
08 novembre 2023 | 2-100 |
| |
25 ottobre 2023 | 2-99 |
| |
13 settembre 2023 | 2-98 |
| |
04 settembre 2023 | 2-97 |
| |
08 agosto 2023 | 2-96 |
| |
23 giugno 2023 | 2-95 |
| |
30 maggio 2023 | 2-94 |
| |
26 maggio 2023 | 2-93 |
| |
24 maggio 2023 | 2-92 |
| |
10 maggio 2023 | 2-91 |
| |
09 maggio 2023 | 2-90 |
| |
4 maggio 2023 | 2-89 |
| |
27 aprile 2023 | 2-88 |
| |
14 aprile 2023 | 2-87 |
| |
17 marzo 2023 | 2-86 |
| |
11 marzo 2023 | 2-85 |
| |
10 marzo 2023 | 2-84 |
| |
7 marzo 2023 | 2-83 |
| |
28 febbraio 2023 | 2-82 |
| |
15 febbraio 2023 | 2-81 |
| |
10 febbraio 2023 | 2-80 |
| |
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione si rivolge agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei propri clienti o forniscono questa soluzione direttamente ai propri abbonati.
Scopo della soluzione
Fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che già dispongono del servizio di chiamata fornito dai provider di servizi BroadWorks.
Fornire il servizio di chiamata basato su BroadWorks a clienti Webex piccoli e medi.
Contesto
Stiamo evolvendo tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo sforzo consiste nello spostare le funzionalità di chiamata BroadWorks nell'app Webex e infine ridurre gli investimenti nei client UC-One.
Vantaggi
Prova futura: contro interruzione del servizio di UC-One Collaborate, spostamento di tutti i client verso Unified Client Framework (UCF)
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex mantenendo la chiamata BroadWorks sulla rete di telefonia
Ambito della soluzione
Clienti da piccoli a medi esistenti/nuovi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre di chiamate BroadWorks.
Clienti Webex esistenti di piccole e medie dimensioni che desiderano aggiungere BroadWorks Calling.
Non aziende più grandi (rivedere il nostro portfolio Enterprise per Webex).
Non utenti singoli (valutare le offerte Webex Online).
Le funzioni impostate in Webex per Cisco BroadWorks riguardano casi d'uso di piccole e medie imprese. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità per le PMI e ne valutiamo costantemente l'idoneità per questo segmento. Possiamo scegliere di nascondere o rimuovere funzioni che sarebbero altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# | Requisito | Note | ||
---|---|---|---|---|
1 | Patch BroadWorks R22 corrente o superiore | |||
2 | XSP|ADP per XSI, CTI, DMS e authService | XSP|ADP dedicato per Webex per Cisco BroadWorks | ||
3 | XSP|ADP separato per NPS, può essere condiviso con altre soluzioni che utilizzano NPS. | Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni XSP|ADP e NPS. | ||
4 | Convalida token CI (con TLS) configurata per le connessioni Webex al servizio di autenticazione. | |||
5 | mTLS configurato per le connessioni Webex all'interfaccia CTI. | Altre applicazioni non richiedono mTLS. | ||
6 | Gli utenti devono essere presenti in BroadWorks e necessitano dei seguenti attributi, a seconda della decisione di provisioning:
| Per i messaggi e-mail attendibili: Si consiglia di inserire lo stesso indirizzo e-mail anche nell'attributo ID alternativo, per consentire agli utenti di accedere con indirizzo e-mail rispetto a BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'uso di e-mail non attendibili può causare l'invio dell'e-mail alla cartella Posta indesiderata o SPAM dell'utente. L'amministratore potrebbe dover modificare le impostazioni e-mail dell'utente per consentire i domini | ||
7 | Webex per il file DTAF Cisco BroadWorks per l'app Webex | |||
8 | Utente BW Business Lic o Std Enterprise o Prem Enterprise Lic + Webex per abbonamento Cisco BroadWorks | Se si dispone di una distribuzione di collaborazione esistente, non è più necessario il pacchetto aggiuntivo UC-One, le porte per conferenze Collab Lic e Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non occorre apportare altre modifiche se non accettare i termini del pacchetto Premium. | ||
9 | IP/porte devono essere accessibili attraverso i servizi backend Webex e le app Webex su Internet pubblico. | Vedere la sezione "Preparazione della rete". | ||
10 | Configurazione TLS v1.2 su XSP|ADP | |||
11 | Per il provisioning Flowthrough, il server applicazioni deve connettersi all'adattatore di provisioning BroadWorks.
| Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è aiutarti a comprendere, preparare, distribuire e gestire la tua soluzione Webex per Cisco BroadWorks. Le principali sezioni del documento riflettono tale obiettivo.
Questa guida include materiale concettuale e di riferimento. In questo documento intendiamo trattare tutti gli aspetti della soluzione.
La serie minima di attività per distribuire la soluzione è la seguente:
Contatta il team dell'account per diventare un partner Cisco. È fondamentale esplorare i punti di contatto Cisco per acquisire familiarità (e ricevere formazione). Quando si diventa partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Onboarding partner in questo documento.
Configura i tuoi sistemi BroadWorks per l'integrazione con Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento.
Usa Partner Hub per connettere Webex a BroadWorks. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione partner in Partner Hub in questo documento.
Utilizzare Partner Hub per preparare i modelli di provisioning degli utenti. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento.
Testare e eseguire l'onboarding di un cliente mediante il provisioning di almeno un utente (vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
|
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. (Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto).
Come funziona
Webex per Cisco BroadWorks è un'offerta che integra BroadWorks Calling in Webex. Gli abbonati utilizzano una singola applicazione (l'app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
Gli utenti chiamano i numeri PSTN utilizzando l'infrastruttura BroadWorks.
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino numerico per introdurre i numeri).
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Chiamata Webex" sull'app Webex. (Queste chiamate sono da app Webex a app Webex, non da app Webex a PSTN).
Gli utenti possono organizzare e accedere a Webex Meetings.
Gli utenti possono scambiarsi messaggi uno a uno o in spazi (chat di gruppo persistente) e beneficiare di funzioni come ricerca e condivisione file (sull'infrastruttura Webex).
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
Una volta eseguito l'onboarding come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare la relazione tra l'istanza BroadWorks e Webex.
È possibile creare organizzazioni dei clienti in Control Hub e eseguire il provisioning degli utenti in tali organizzazioni.
Ogni abbonato in BroadWorks riceve un'identità Webex in base al proprio indirizzo e-mail (attributo ID e-mail in BroadWorks).
Gli utenti eseguono l'autenticazione su BroadWorks o su Webex.
Ai clienti vengono rilasciati token di lunga durata per autorizzarli per i servizi su BroadWorks e Webex.
L'app Webex al centro di questa soluzione, è un'applicazione personalizzabile disponibile su desktop Mac/Windows e dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzionalità di messaggistica, presenza e riunioni.
Il client esegue la registrazione ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i tuoi sistemi BroadWorks per garantire un'esperienza di provisioning utente perfetta.
Funzioni e limitazioni
Offriamo diversi pacchetti con diverse caratteristiche.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata, ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano nella rubrica un utente softphone, i risultati della ricerca non forniscono alcuna opzione per inviare un messaggio.
Gli utenti del softphone possono condividere lo schermo durante una chiamata.
Pacchetto "base"
Il pacchetto di base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti in riunioni a "spazio unificato" e riunioni nella sala riunioni personale. (** vedere la seguente nota a titolo di eccezione). In questo pacchetto le riunioni possono avere una durata massima di 40 minuti.
Pacchetto "Standard"
Questo pacchetto include anche tutto quello che è contenuto nel pacchetto Base, ad esempio fino a 100 partecipanti nelle riunioni "spazio unificato" e nelle riunioni nella sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è un ruolo inizialmente ricoperto solo dall'organizzatore della riunione, ma l'organizzatore può passare il "ruolo di relatore" a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può riprendere il ruolo di relatore senza che l'organizzatore corrente glielo passi.
Pacchetto "Premium"
Questo pacchetto include tutto nel pacchetto Standard più un massimo di 300 partecipanti in una riunione "spazio unificato" e fino a 1000 partecipanti in una sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è supportata per qualsiasi partecipante alla riunione.
Confronta pacchetti
Pacchetto | Chiamata | Messaggistica | Riunioni nello spazio Unified | PMR riunioni |
---|---|---|---|---|
Softphone | Incluso | Non incluso | Nessuno | Nessuno |
Base | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Standard | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Premium | Incluso | Incluso | 300 partecipanti | 1000 partecipanti |
Il limite della riunione nello spazio Unified per gli utenti Base è 100 partecipanti per riunione nello spazio Unified a meno che lo spazio non includa anche gli utenti a cui sono assegnati i pacchetti "Standard" o "Premium", nel qual caso il limite aumenta in base al pacchetto utente organizzatore. |
"Riunioni nello spazio Unified" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti "Riunione" o "Pianifica". "Riunioni PMR" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale (PMR) di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID). |
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per le differenze di supporto delle funzioni di riunione PMR per i pacchetti Base, Standard e Premium.
Funzione riunione | Supportato con il pacchetto base | Suported con pacchetto standard | Supportato con il pacchetto Preminum | Commento |
---|---|---|---|---|
Durata riunione | 40 minuti o meno | Illimitato | Illimitato | |
Condivisione desktop | Sì | Sì | Sì | Base: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione desktop solo da parte dell'organizzatore della riunione PMR. Premium: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. |
Condivisione applicazione | Sì | Sì | Sì | Base: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione delle applicazioni solo da parte dell'organizzatore della riunione PMR. Premium: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. |
Chat con più interlocutori | Sì | Sì | Sì | |
Lavagna | Sì | Sì | Sì | |
Protezione con password | Sì | Sì | Sì | |
App Web - nessun download o plug-in (Esperienza ospite) | Sì | Sì | Sì | |
Supporto dell'accoppiamento con i dispositivi Webex | Sì | Sì | Sì | |
Controllo del pavimento (disattivazione del microfono uno / espulsione tutti) | Sì | Sì | Sì | |
Collegamento Riunioni persistenti | Sì | Sì | Sì | |
Accesso sito riunioni | Sì | Sì | Sì | |
Accesso alla riunione tramite VoIP | Sì | Sì | Sì | |
Bloccaggio | Sì | Sì | Sì | |
Controlli relatore | No | No | Sì | |
Controllo desktop remoto | No | No | Sì | |
Numero di partecipanti | 100 | 100 | 1000 | |
Registrazione salvata in locale nel sistema | Sì | Sì | Sì | |
Registrazione nel cloud | No | No | Sì | |
Registrazione - Cloud Storage | No | No | 10 GB per sito | |
Trascrizione delle registrazioni | No | No | Sì | |
Pianificazione riunione | Sì | Sì | Sì | |
Abilita condivisione contenuto con integrazioni esterne | No | No | Sì | Base: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. Standard: condivisione di contenuto solo da parte dell'organizzatore della riunione PMR. Premium: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. |
Consenti modifica URL PMR | No | No | Sì | Base: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori dei partner e delle organizzazioni possono modificare l'URL da Control Hub. Standard: l'URL PMR può essere modificato solo da Partner Hub per Partner e amministratori organizzazione. Premium: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori partner e dell'organizzazione possono modificare l'URL da Partner Hub. |
Streaming in diretta riunioni (Ad Esempio, su Facebook, Youtube) | No | No | Sì | |
Consenti ad altri utenti di pianificare riunioni per loro conto | No | No | Sì | |
Aggiungi organizzatore alternativo | Sì | No | Sì | |
Integrazione app (es., Zendesk, Slack) | Dipende dall'integrazione | Dipende dall'integrazione | Sì | Per ulteriori informazioni sul supporto, vedere la sezione Integrazioni app riportata di seguito. |
Integrazione con il calendario Microsoft Office 365 | Sì | Sì | Sì | |
Integrazione con Google Calendaring per G Suite | Sì | Sì | Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione rivolta agli utenti per Webex su help.webex.com
. Per ulteriori informazioni sulle funzioni, leggere i seguenti articoli:
Funzioni di chiamata
L'esperienza di chiamata è simile alle soluzioni precedenti che utilizzano il motore di controllo delle chiamate BroadWorks. La differenza tra UC-One Collaborate e UC-One SaaS è che l'app Webex è il client software principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
Zendesk—Solo Premium
Slack: solo Premium
Microsoft Teams per Webex Meetings—Standard o Premium
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
Calendario Office 365—Standard o Premium
Google Calendaring per G Suite: standard o premium
Supporto dell'infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta gli ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione per Webex per l'infrastruttura desktop virtuale (VDI).
Supporto per IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Tabella di marcia futura
Per informazioni sulle nostre intenzioni per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Le voci della roadmap non sono vincolanti in alcuna capacità. Cisco si riserva il diritto di sospendere o rivedere uno o tutti questi elementi dalle release future.
Limiti
Limitazioni di provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario del sito Webex Meetings creato per tale pacchetto.
Se nella richiesta di provisioning per il primo utente di ciascun pacchetto non viene specificato alcun fuso orario, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sull'impostazione predefinita regionale dell'organizzazione degli abbonati.
Se il cliente necessita di uno specifico fuso orario del sito di Webex Meetings, specificare timezone
parametro nella richiesta di provisioning per:
il primo abbonato predisposto per il pacchetto Standard nell'organizzazione.
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
il primo abbonato predisposto per il pacchetto base nell'organizzazione.
Limitazioni generali
Nessuna chiamata nella versione Web del client Webex (questa è una limitazione del client, non una limitazione della soluzione).
Webex potrebbe non disporre ancora di tutti i controlli dell'interfaccia utente per supportare alcune funzioni di controllo delle chiamate disponibili da BroadWorks.
Attualmente, il client Webex non può essere "White Labeled" (etichetta bianca).
Quando si creano le organizzazioni dei clienti utilizzando il metodo di provisioning scelto, vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. Ci aspettiamo che i partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
I report sull'utilizzo di riunioni e messaggi sono disponibili attraverso l'organizzazione del cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti di messaggistica
I seguenti limiti di archiviazione dei dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo storage massimo per messaggistica e file combinati.
Di base: 2 GB per utente per 3 anni
Standard 5 GB per utente per 3 anni
Premio: 10 GB per utente per 5 anni
Per ciascuna organizzazione del cliente, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti premium ha un limite totale di messaggistica e storage file di 50 GB. Un singolo utente può superare il limite per utente (10 GB), a condizione che la società sia ancora al di sotto del massimo aggregato (50 GB).
Per gli spazi team creati, i limiti di messaggistica vengono applicati al totale aggregato per l'organizzazione cliente che possiede lo spazio team. Puoi trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti generali di messaggistica applicabili agli spazi dei team di messaggistica Webex, fare riferimento a https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure le connessioni a Webex e BroadWorks. I dati memorizzati nel cloud Webex ed esposti all'utente attraverso l'interfaccia dell'app Webex sono crittografati sia in transito che a riposo.
Maggiori dettagli sullo scambio di dati sono disponibili nella sezione Riferimento del presente documento.
Ulteriori letture
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati che più si avvicina alla propria regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore del provider di servizi (utente): Per le attività di manutenzione quotidiane, si gestiscono le parti della soluzione in sede (chiamata) utilizzando i propri sistemi. Gestisci le parti Webex della soluzione attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale.
Il primo utente predisposto per un nuovo organizzatore partner viene assegnato automaticamente ai ruoli amministratore completo e amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi. |
Team operativo di Cisco cloud: Crea la tua "organizzazione partner" in Partner Hub, se non esiste, durante l'onboarding.
Una volta ottenuto l'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente, create "Onboarding templates" (Modelli di onboarding) per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Quindi si fornisce i vostri clienti o abbonati.
# | Compito tipico | SP | Cisco |
---|---|---|---|
1 | Onboarding partner - Creazione dell'organizzazione partner se non esiste e abilitazione dei tasti di alternanza funzione necessari | ● | |
2 | Configurazione BroadWorks nell'organizzazione partner tramite Partner Hub (cluster) | ● | |
3 | Configurazione delle impostazioni di integrazione in Organizzazione partner tramite Partner Hub (modelli di offerta, branding) | ● | |
4 | Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|ADP Patching, firewall, configurazione XSP|ADP, XSI, AuthService, CTI, NPS, applicazioni DMS su XSP|ADP) | ● | |
5 | Sviluppo dell'integrazione o del processo di provisioning | ● | |
6 | Preparare i materiali GTM | ● | |
7 | Migrazione o provisioning di nuovi utenti | ● |
Architettura
Cosa c'è nel diagramma?
Client
Il client dell'app Webex serve come applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di messaggistica nativa, presenza e riunioni audio/video multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per le chiamate SIP e PSTN.
I telefoni IP Cisco e i relativi accessori utilizzano anche l'infrastruttura BroadWorks per le chiamate SIP e PSTN. Ci aspettiamo di essere in grado di supportare telefoni di terze parti.
Portale di attivazione utente per gli utenti che accedono a Webex utilizzando le credenziali BroadWorks.
Partner Hub è un'interfaccia Web per l'amministrazione dell'organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. Puoi anche utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
Rete di provider di servizi
Il blocco verde a sinistra dello schema rappresenta la tua rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
XSP|ADP rivolto al pubblico, per Webex per Cisco BroadWorks: (La scatola rappresenta una o più fattorie XSP|ADP, eventualmente frontali da bilanciatori di carico).
Ospita l'interfaccia dei servizi Xtended (XSI-Actions & XSI-Events), il servizio di gestione dei dispositivi (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato del ricevitore dell'altro (presenza di telefonia) e la cronologia chiamate.
Pubblica la rubrica ai client Webex.
XSP|ADP rivolto al pubblico, con NPS in esecuzione:
server push notifiche chiamate organizzatore: Un server push di notifica su un ADP XSP| nel proprio ambiente. Si interfaccia tra il server applicazioni e il proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS & FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
Server applicazioni:
Fornisce il controllo delle chiamate e le interfacce ad altri sistemi BroadWorks (generalmente)
Per il provisioning flowthrough, l'AS viene utilizzato dall'amministratore del partner per il provisioning degli utenti in Webex
Inserisce il profilo utente in BroadWorks
OSS/BSS: Sistema di supporto alle operazioni/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nello schema rappresenta il cloud Webex. I microservizi Webex supportano l'intero spettro di funzionalità di collaborazione Webex:
Cisco Common Identity (CI) è il servizio identità all'interno di Webex.
Webex per Cisco BroadWorks rappresenta la serie di microservizi che supportano l'integrazione tra Webex e BroadWorks ospitato da provider di servizi:
API di provisioning utente
Configurazione provider di servizi
Accesso utente mediante credenziali BroadWorks
Casella di messaggistica Webex per microservizi correlati alla messaggistica.
Casella Webex Meetings che rappresenta server di elaborazione multimediale e SBC per riunioni video con più partecipanti (SIP e SRTP)
Servizi Web di terze parti
Nello schema sono rappresentati i seguenti componenti di terze parti:
APNS (Apple Push Notifications Service) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Apple.
FCM (messaggistica cloud FireBase) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Il ruolo dei server XSP|ADP aperti al pubblico in Webex per Cisco BroadWorks
L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste Webex per BroadWorks JWT (JSON Web Token) per conto dell'utente
Interfaccia CTI, protetta da mTLS, a cui Webex sottoscrive gli eventi della cronologia chiamate e lo stato della presenza di telefonia da BroadWorks (stato hook).
Interfacce azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate degli abbonati, rubriche di elenchi di contatti e chiamate e configurazione del servizio di telefonia per gli utenti finali
Servizio DM (Device Management) per il recupero dei file di configurazione delle chiamate da parte dei client
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedere Configurazione dei cluster BroadWorks in Partner Hub in questo documento. Per ciascun cluster, è possibile fornire un solo URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP
È necessario utilizzare un'istanza ADP XSP|dedicata o un'azienda agricola separata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile organizzare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso XSP|ADP che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/azienda agricola ADP XSP| dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
Ad esempio, se offri UC-One SaaS, ti consigliamo di creare una nuova fattoria XSP|ADP per Webex per Cisco BroadWorks. In questo modo i due servizi possono operare in modo indipendente durante la migrazione degli abbonati.
Se si collocano le applicazioni Webex per Cisco BroadWorks in una fattoria ADP|XSP utilizzata per altri scopi, è responsabilità dell'utente monitorare l'utilizzo, gestire la complessità risultante e pianificare l'aumento della scala.
Il pianificatore della capacità di sistema Cisco BroadWorks assume una fattoria ADP XSP| dedicata e potrebbe non essere preciso se la si utilizza per i calcoli della posizione.
Se non diversamente specificato, gli Webex dedicati per Cisco BroadWorks XSP|ADP devono ospitare le seguenti applicazioni:
AuthService (TLS con convalida token CI o mTLS)
CTI (mTLS)
Azioni XSI (TLS)
XSI-Events (TLS)
DMS (TLS): opzionale. Non è obbligatorio distribuire un'istanza DMS o un'azienda agricola separata specificamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
TLS (Call Settings Webview): opzionale. La vista Webview (CSW) delle impostazioni di chiamata è richiesta solo se si desidera che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso a CTI attraverso un'interfaccia protetta dall'autenticazione TLS reciproca. Per supportare questo requisito, raccomandiamo una delle seguenti opzioni:
(Diagramma etichettato Opzione 1) Una istanza XSP|ADP o un'azienda agricola per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
(Diagramma etichettato Opzione 2) Due istanze ADP XSP| o aziende agricole, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSP|ADP Se si dispone di una fattoria ADP XSP|esistente conforme a una delle architetture suggerite sopra (Opzione 1 o 2) ed è leggermente caricata, è possibile riutilizzare le ADP XSP|esistenti. Dovrai verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti dell'applicazione per Webex. Le due considerazioni principali sono:
Poiché gli XSP|ADP hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero esserci altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di XSP|ADP deve essere verificato in un laboratorio con la configurazione desiderata prima di impegnarsi per il riutilizzo. |
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione temporale per tutti gli XSP|ADP utilizzati con Webex.
Installare il ntp
pacchetto dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Quindi è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, consultare la Guida alla gestione del software BroadWorks.
Durante l'installazione interattiva del software XSP|ADP, è possibile configurare NTP. Procedere come segue:
Quando l'installatore chiede,
Do you want to configure NTP?
, immetterey
.Quando l'installatore chiede,
Is this server going to be a NTP server?
, immetteren
.Quando l'installatore chiede,
What is the NTP address, hostname, or FQDN?
, immettere l'indirizzo del server NTP o un servizio NTP pubblico, ad esempio,pool.ntp.org
.
Se gli ADP XSP|utilizzano un'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie Key=Value:
NTP
NTP_SERVER=<NTP Server address, e.g., pool.ntp.org>
Requisiti di identità e sicurezza XSP|ADP
Sfondo
I protocolli e le crittografie delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli vanno dal più generale (provider SSL) al più specifico (interfaccia singola). Un'impostazione più specifica sostituisce sempre un'impostazione più generale. Se non sono specificate, le impostazioni SSL di livello "inferiore" vengono ereditate da livelli "superiori".
Se non viene modificata alcuna impostazione rispetto alle impostazioni predefinite, tutti i livelli ereditano le impostazioni predefinite del provider SSL (JSSE Java Secure Sockets Extension).
Elenco dei requisiti
L'|ADP XSP deve autenticarsi sui client utilizzando un certificato firmato da CA in cui il nome comune o il nome alternativo oggetto corrispondono alla parte di dominio dell'interfaccia XSI.
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
Diffie-Hellman Effemeral (DHE) o curve ellittiche Diffie-Hellman Effemeral (ECDHE) chiave-scambio
Crittografia AES (Advanced Encryption Standard) con una dimensione minima di blocco di 128 bit (ad esempio, AES-128 o AES-256)
Modalità di codifica GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
Se viene utilizzata una crittografia CBC, solo la famiglia SHA2 di funzioni hash è consentita per derivazione chiave (SHA256, SHA384, SHA512).
Ad esempio, le seguenti crittografie soddisfano i requisiti:
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come illustrato sopra, non la convenzione openSSL. |
Crittografie TLS supportate per le interfacce AuthService e XSI
Questo elenco è soggetto a modifiche a mano a mano che evolvono i nostri requisiti di sicurezza del cloud. Seguire l'attuale raccomandazione sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento. |
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_128_GCM_SHA256
TLS_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA256
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_256_CBC_SHA
TLS_PSK_WITH_AES_256_CBC_SHA384
TLS_PSK_WITH_AES_256_CBC_SHA
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA
TLS_PSK_WITH_AES_128_CBC_SHA256
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri della scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il numero di thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi visualizzati come segue (non diminuirli se sono al di sopra di questi valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più |ADP XSP
Elemento bordo bilanciamento carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, deve gestire in modo trasparente la distribuzione del traffico tra più server XSP|ADP e il cloud e i client Webex per Cisco BroadWorks. In questo caso, è possibile fornire l'URL del bilanciatore di carico alla configurazione Webex per Cisco BroadWorks.
Note su questa architettura:
Configurare il DNS in modo che i client possano trovare il bilanciatore di carico quando si connettono all'interfaccia Xsi (vedere configurazione DNS).
Si consiglia di configurare l'elemento edge in modalità proxy SSL inversa per garantire la crittografia dei dati punto a punto.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Server XSP|ADP orientati verso Internet
Se si espongono direttamente le interfacce Xsi, utilizzare il DNS per distribuire il traffico ai più server XSP|ADP.
Note su questa architettura:
Per connettersi ai server XSP|ADP sono necessari due record:
Per i microservizi Webex: Per targetizzare più indirizzi IP XSP|ADP sono necessari record A/AAAA round-robin. Questo perché i microservizi Webex non possono effettuare ricerche SRV. Per esempi, vedere Servizi cloud Webex.
Per l'app Webex: Un record SRV che si risolve in record A in cui ogni record A si risolve in un singolo XSP|ADP. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per targetizzare il servizio XSI per più indirizzi XSP|ADP. Assegnare la priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (e all'indirizzo IP successivo) e passino al record A successivo (e all'indirizzo IP) solo se il primo indirizzo IP è inattivo. NON utilizzare un approccio round-robin per l'app Webex.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune.
È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL XSP|ADP di un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server XSP|ADP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.
Ordinazione e provisioning
L'ordine e il provisioning si applicano a questi livelli:
Provisioning di partner/provider di servizi:
Ogni onboarding di Webex per provider di servizi Cisco BroadWorks (o rivenditore) deve essere configurato come organizzazione partner in Webex e devono essere concesse le autorizzazioni necessarie. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per gestire Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le operazioni di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/aziendale.
Ordinazione e provisioning clienti/aziende:
Ogni BroadWorks Enterprise abilitato per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo si verifica automaticamente come parte del provisioning utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks vengono predisposti nella stessa organizzazione cliente Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
Ordinazione e provisioning utente/abbonato:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning degli utenti:
Provisioning fluviale con e-mail attendibili
Provisioning eseguibile senza e-mail attendibili
Self-provisioning utente
Provisioning API
Provisioning eseguibile con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile affermare che BroadWorks dispone di indirizzi e-mail abbonati validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Provisioning eseguibile senza e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non puoi contare sugli indirizzi e-mail degli abbonati detenuti da BroadWorks, questa opzione di provisioning crea account Webex ma non può attivarli fino a quando gli abbonati non forniscono e convalidano i relativi indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Self-provisioning utente
Con questa opzione, non è disponibile il provisioning flowthrough da BroadWorks a Webex. Una volta configurata l'integrazione tra Webex e il sistema BroadWorks, vengono visualizzati uno o più collegamenti specifici per il provisioning degli utenti all'interno dell'organizzazione partner Webex per Cisco BroadWorks.
Successivamente, si progettano le proprie comunicazioni (o si delegano ai clienti) per distribuire il collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account vengono predisposti nell'ambito dell'organizzazione partner, puoi regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare tale operazione.
Gli utenti devono esistere nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento. |
Provisioning provider di servizi per API
Webex presenta un set di API pubbliche che consentono di creare il provisioning utente/abbonato Webex per Cisco BroadWorks nel flusso di lavoro/negli strumenti di gestione utenti esistenti.
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti Webex per Cisco Broadworks di comporre altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella rubrica Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo dell'estensione di tutte le aree del metodo di avvio chiamata e del profilo dell'utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e gruppi diversi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due imprese che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Utenti Cisco BroadWorks
Provisioning API pubblica come 'interno
Il parametro dell'interno deve essere esplicitamente passato come parte della chiamata API. Per le imprese/gruppi con Location Dialing Code (LDC) configurato, il parametro dell'interno dovrebbe essere la combinazione di LDC e 'numero di interno.
Provisioning flusso o auto-attivazione
Estensione e LDC (se applicabile) saranno automaticamente recuperati da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione di codice di chiamata posizione (LDC) e numero di interno.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'interno |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'estensione deve essere passata come parametro |
Attraverso il flusso | Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Elenchi telefonici BroadWorks | Elenchi telefonici aziendali, di gruppo o personali | Sincronizzazione rubriche | Non applicabile |
Prerequisiti
La versione del client richiesta per supportare questa funzione è 42.11 o successiva.
Patch in cui i codici di chiamata di estensione e posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
AP.platform.23.0.1075.ap380045
AP.as.23.0.1075.ap380045
AP.xsp.23.0.1075.ap380045
AP.as.24.0.944.ap380045
Abilitare l'intestazione X-BroadWorks-Remote-Party-Info su AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP richiesto per il supporto della funzione di composizione dell'interno.
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata a interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità delle chiamate di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'estensione come seconda opzione in Partner Hub e Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con estensione attraverso uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione dell'interno sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Non verrà visualizzata un'estensione nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere visibile l'opzione di chiamata dell'interno per i clienti esistenti:
Se un partner desidera che tutte le organizzazioni dei clienti gestite siano dotate di un interno come una delle opzioni di chiamata, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
Se un partner desidera fornire un interno in opzioni di chiamata per una specifica organizzazione cliente, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e portarli alla pari con l'aumento di 30K contatti per l'elenco telefonico Enterprise, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per Organizzazione, che si applica alla somma degli elenchi telefonici Enterprise e Group in una singola azienda BroadWorks. Ad esempio, sarà supportato un'azienda BroadWorks che dispone di un elenco di telefoni aziendali con 30K e anche di 5 elenchi di telefoni di gruppo ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K totali).
Questa funzione è disponibile su richiesta. Contatta il team dell'account per abilitare questa opzione.
|
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks nello storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare a quale gruppo appartiene questo utente. L'associazione dell'utente con un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca dei contatti nello storage del gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning degli abbonati Webex per BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
È possibile eseguire il provisioning dell'ID gruppo aziendale BroadWorks per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Webex per gli utenti Cisco BroadWorks
Provisioning API pubblica come "spEnterpriseGroupId"
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
Provisioning flusso o auto-attivazione
L'ID gruppo aziendale BroadWorks verrà automaticamente recuperato da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Non applicabile. Non è necessario sincronizzare l'ID gruppo aziendale BroadWorks per questi utenti.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'ID gruppo aziendale BroadWorks deve essere superato come parametro spEnterpriseGroupId |
Attraverso il flusso | L'ID gruppo aziendale BroadWorks viene recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Non applicabile |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Non applicabile |
Elenchi telefonici BroadWorks | Contatti negli elenchi telefonici del gruppo BroadWorks | Sincronizzazione rubriche | I contatti di gruppo vengono memorizzati nel servizio Webex Contact associato al gruppo specifico |
Elenchi di telefoni BroadWorks Enterpsie o Persional | Contatti negli elenchi telefonici aziendali o personali | Sincronizzazione rubriche | Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. Impossibile completare la migrazione fino a quando QUESTA API non viene completata. L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march Una volta abilitata la funzione e a seguito della sincronizzazione della rubrica successiva, i gruppi di utenti aziendali verranno visualizzati anche in Control Hub. La visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativa in questa fase. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza a un gruppo in Control Hub poiché tali modifiche non verranno riportate nuovamente in BroadWorks. La gestione di gruppo in Control Hub è destinata all'uso da parte dei partner che adotteranno le prossime API di gestione contatti. |
Migrazione e prova del futuro
La progressione Cisco del client di comunicazione unificata BroadSoft deve spostarsi da UC-One a Webex. Si verifica una corrispondente progressione dei servizi di supporto dalla rete del provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che tu stia eseguendo UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita consiste nel distribuire nuovi ADP|XSP dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti in Webex e infine recuperare l'infrastruttura utilizzata per la soluzione precedente.
Sottoscrizioni di documenti consigliate
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Abbonati che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di eseguire l'abbonamento a ciascuno dei seguenti articoli per assicurarsi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per iscriversi, accedere a ciascuno dei link seguenti e nell'articolo che viene visualizzato fare clic sul pulsante Iscriviti.
Come minimo, si consiglia di iscriversi all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati in Documenti aggiuntivi dispone di un'opzione Sottoscrivi . Affinché questa opzione venga visualizzata, l'articolo deve essere visualizzato su help.webex.com.
Non esiste un'opzione di abbonamento per le landing page di documentazione. |
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Documenti Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
Porta la tua soluzione PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono di loro proprietà (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive come eseguire l'onboarding e il servizio dei dispositivi Room OS e MPP.
Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi di Webex per Cisco BroadWorks.
Articoli Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti siti opzionali per ulteriori informazioni su Webex per Cisco BroadWorks:
Documentazione Webex per Cisco BroadWorks: nella pagina di destinazione vengono elencati i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme a quelle presto disponibili.
Problemi noti e limitazioni: informazioni sui problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale: questo articolo descrive come assegnare i ruoli amministratore partner per le organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte della soluzione Cisco BroadWorks:
Articoli della Guida Webex
I seguenti siti della Guida Webex possono essere utilizzati per trovare gli articoli Webex che consentono agli amministratori dei clienti e agli utenti finali di utilizzare le funzioni Webex.
Webex da provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati comunemente per gli utenti dell'app Webex che hanno acquistato i servizi Webex da un provider di servizi.
Centro assistenza Webex: utilizzare la funzione di ricerca su help.webex.com per cercare altri articoli Webex che descrivono la funzionalità dell'app Webex e di Webex Meetings. È possibile ricercare gli articoli utente o amministratore.
Documentazione sviluppatore
Guida per sviluppatori Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Punti di decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastrutture
|
Quanti ADP XSP|? Come prendono l'mTLS? |
Pianificatore capacità di sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento CLI XSP|ADP Il presente documento |
Provisioning cliente e utente | Puoi affermare che ti fidi dei messaggi e-mail in BroadWorks? Vuoi che gli utenti forniscano indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Documenti API pubbliche su https://developer.webex.com Il presente documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo di branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso per i clienti? | Il presente documento |
Funzioni abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o Softphone. | Il presente documento Matrice caratteristiche/pacchetto |
autenticazione protetta | BroadWorks o Webex | Il presente documento |
Adattatore di provisioning (per opzioni di provisioning flowthrough) | Utilizzate già IM&P integrato, ad esempio per UC-One SaaS? Si desidera utilizzare più modelli? È previsto un caso d'uso più comune? |
Il presente documento Riferimento CLI server applicazioni |
Architettura e infrastrutture
Con che tipo di scala intende iniziare? È possibile scalare in futuro, ma la stima di utilizzo attuale dovrebbe guidare la pianificazione dell'infrastruttura.
Collaborare con il proprio account manager/rappresentante di vendita Cisco per dimensionare l'infrastruttura ADP XSP|, in base al Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
In che modo Webex renderà le connessioni TLS reciproche alle tue ADP XSP|? Direttamente a XSP|ADP in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce. (Non supportiamo connessioni TCP non crittografate al perimetro della rete).
Provisioning cliente e utente
Quale metodo di provisioning utente si adatta meglio?
Provisioning eseguibile con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene predisposto automaticamente in Webex.
Se puoi anche affermare che gli indirizzi e-mail dell'abbonato in BroadWorks sono validi e univoci per Webex, puoi utilizzare la variante "email attendibili" del provisioning flowthrough. Gli account Webex abbonati vengono creati e attivati senza il loro intervento; scaricano semplicemente il client e accedono.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto, il provider di servizi deve fornire un indirizzo e-mail valido all'utente per eseguire il provisioning dei servizi Webex. Questo deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo anche nell'attributo ID alternativo.
Provisioning eseguibile senza e-mail attendibili: Se non riesci a fidarti degli indirizzi e-mail degli abbonati, puoi comunque assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
Self-provisioning utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. Tu (o i tuoi clienti) distribuisci invece un collegamento di provisioning e i collegamenti per scaricare i diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare gli account Webex. Quindi, scaricano il client e accedono e Webex recupera una configurazione aggiuntiva su di essi da BroadWorks (inclusi i numeri principali).
Provisioning controllato da SP tramite API: Webex espone una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei propri flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti di sistema generali descritti in questa guida.
Metodo di provisioning | Requisiti |
---|---|
Provisioning del flusso (e-mail attendibili o non attendibili) | L'API di provisioning Webex aggiunge automaticamente gli utenti BroadWorks esistenti a Webex una volta che l'utente soddisfa i requisiti e si attiva il servizio Integrated IM+P. Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Self-provisioning utente | L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato il messaggio e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) | Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono previsti due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, vai a Utenti BroadWorks. |
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Impostazioni internazionali lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente di amministrazione con provisioning viene assegnata automaticamente come locale predefinita per l'organizzazione del cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti a riunioni all'interno dell'organizzazione del cliente.
Sono supportate le impostazioni internazionali in lingua a cinque caratteri (ISO-639-1)_(ISO-3166). Ad esempio, en_US corrisponde a English_UnitedStates. Se viene richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genera un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso internazionale dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, viene utilizzata l'impostazione locale ragionevole predefinita in base al codice della lingua richiesto.
Nella tabella riportata di seguito vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice lingua a due lettere in un'impostazione locale a cinque caratteri per le situazioni in cui un'impostazione locale a cinque caratteri non è disponibile.
Impostazioni internazionali lingua supportate (ISO-639-1)_(ISO-3166) | Se è disponibile solo un codice lingua a due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** | Usa impostazioni internazionali sensibili di default (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA | en en | en_USA |
fr_Fr fr_CA | Fr | fr_Fr |
cs_CZ | cs | cs_CZ |
da_DK | da | da_DK |
de_DE | DE | de_DE |
hu_HU | hu | hu_HU |
id_ID | ID | id_ID |
it_IT | IT | it_IT |
ja_JP | ja | ja_JP |
ko_KR | ko | ko_KR |
es_ES es_CO es_MX | ES | es_ES |
nl_NL | NL | nl_NL |
nb_NO | nb. | nb_NO |
pl_PL. | pl. | pl_PL. |
pt_PT pt_BR | pt | pt_PT |
ru_RU | RU | ru_RU |
ro_RO | ro | ro_RO |
zh_CN zh_TW | zh | zh_CN |
sv_SE | sv | sv_SE |
ar_SA | ar | ar_SA |
tr_TR | tr | tr_TR |
Le impostazioni internazionali es_CO, id_ID, nb_NO e pt_PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti Webex Meetings saranno solo in inglese. Inglese è la impostazioni internazionali predefinite per i siti se per il sito non sono richieste impostazioni internazionali non valide/non supportate. Questo campo lingua è applicabile durante la creazione di un'organizzazione e un sito Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, la lingua del modello verrà utilizzata come lingua predefinita. |
Branding
Gli amministratori partner possono utilizzare le personalizzazioni avanzate del branding per personalizzare l'aspetto dell'app Webex per le organizzazioni di clienti gestite dal partner. Gli amministratori partner possono personalizzare le seguenti impostazioni per garantire che l'app Webex rifletta il marchio e l'identità della società:
Loghi aziendali
Combinazioni di colori univoche per la modalità Chiaro o Scuro
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione delle personalizzazioni di branding avanzate.
|
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding come richiesto, ma quando si esegue l'onboarding di un cliente è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Alcuni parametri del modello principale sono elencati di seguito.
Pacchetto
È necessario selezionare un pacchetto predefinito quando si crea un modello (vedere Pacchetti nella sezione Panoramica per dettagli). Tutti gli utenti predisposti con tale modello, tramite flowthrough o self-provisioning, ricevono il pacchetto predefinito.
È possibile controllare la selezione dei pacchetti per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno di essi. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori di provisioning per azienda, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
È possibile modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedere Webex per la documentazione API Cisco BroadWorks o attraverso Partner Hub (vedere Modifica pacchetto utente in Partner Hub).
Non puoi modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è attivata o disattivata; se all'abbonato viene assegnato questo servizio in BroadWorks, il modello Partner Hub associato all'URL di provisioning aziendale di tale abbonato definisce il pacchetto.
Rivenditore e aziende o fornitore di servizi e gruppi?
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se sei un rivenditore con Enterprise, devi abilitare la modalità Enterprise quando crei un modello.
Se il sistema BroadWorks è configurato in modalità provider di servizi, è possibile lasciare disattivata la modalità Enterprise nei modelli.
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch BroadWorks richieste per il provisioning flow-through. Per ulteriori dettagli, vedere Patch richieste con provisioning flow-through. |
Modalità di autenticazione
Decidi come desideri che gli abbonati eseguano l'autenticazione quando accedono a Webex. È possibile assegnare la modalità utilizzando l'impostazione Modalità di autenticazione nel modello di onboarding. Nella tabella seguente sono riportate alcune opzioni.
Questa impostazione non ha effetto sull'accesso al portale di attivazione utente. Gli utenti che accedono al portale devono immettere l'ID utente e la password BroadWorks, come configurati su BroadWorks, indipendentemente da come si configura la modalità di autenticazione nel modello di onboarding. |
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | ID utente BroadWorks | Indirizzo e-mail |
Provider identità | BroadWorks.
| Identità comune Cisco |
Autenticazione a più fattori? | No | Richiede IdP del cliente che supporta l'autenticazione a più fattori. |
Percorso di convalida delle credenziali
|
|
|
Per una ripartizione più dettagliata del flusso di accesso SSO con autenticazione diretta a BroadWorks, vedere Flusso di accesso SSO. |
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che si può verificare con password che utilizzano caratteri speciali per cui il browser Web non codifica correttamente i caratteri. Utilizzando un'intestazione con codifica UTF-8, con codifica base 64, risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
Paese
Quando si crea un modello, è necessario selezionare un paese. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie S. | Posizione | Prefisso internazionale | Nome paese |
---|---|---|---|
1 | AMER | +1 | NOI, CA |
2 | APAC | +65 | Singapore |
3 | ANZ | +61 | Australia |
4 | EMEA | +44 | Regno Unito |
5 | EURO | +49 | Germania |
Accordi con più partner
Vuoi concedere in sublicenza Webex per Cisco BroadWorks a un altro provider di servizi? In questo caso, ciascun provider di servizi avrà bisogno di un'organizzazione partner distinta in Webex Control Hub per consentire loro di fornire la soluzione per la propria base clienti.
Adattatore di provisioning e modelli
Quando si utilizza il provisioning flowthrough, l'URL di provisioning inserito in BroadWorks viene derivato dal modello in Control Hub. È possibile disporre di più modelli e quindi di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati al momento della concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e quale modello si desidera utilizzare a tale scopo. In questo modo, è necessario impostare esplicitamente l'URL di provisioning per le aziende che necessitano di un modello diverso.
Inoltre, tenere presente che è possibile che si stia già utilizzando un URL di provisioning a livello di sistema, ad esempio con UC-One SaaS. In tal caso, è possibile scegliere di mantenere l'URL a livello di sistema per il provisioning degli utenti su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono dettagliate in Configura server applicazioni con URL servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning flowthrough tra AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server AS e Webex, annullando in tal modo la necessità di connettersi direttamente al servizio Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati che si sta eseguendo il provisioning per Webex devono esistere nel sistema BroadWorks integrato con Webex. È possibile integrare più sistemi BroadWorks, se necessario.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero o interno principale.
Webex utilizza gli indirizzi e-mail come identificatori principali per tutti gli utenti. Se si utilizza il provisioning flowthrough con e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail degli abbonati nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo di utenti di chiamata BroadWorks con un numero principale e/o interno. Se si utilizza il provisioning flowthrough, agli utenti deve essere assegnato anche il servizio IM&P integrato. |
Server nella rete e requisiti software
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Le istanze BroadWorks devono includere almeno i seguenti server:
Server applicazioni (AS) con versione BroadWorks come sopra
Server di rete (NS)
Server profilo (PS)
Server XSP|ADP o piattaforma di distribuzione delle applicazioni (ADP) di fronte al pubblico che soddisfano i seguenti requisiti:
Servizio di autenticazione (BWAuth)
Interfacce azioni ed eventi XSI
DMS (applicazione Web di gestione dispositivi)
Interfaccia CTI (Intergrazione Di Telefonia Informatica)
TLS 1.2 con certificato valido (non autofirmato) e qualsiasi intermediazione richiesta. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
Autenticazione Mutual TLS (mTLS) per il servizio di autenticazione (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Autenticazione Mutual TLS (mTLS) per l'interfaccia CTI (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Un server XSP/ADP separato che agisce come "Call Notifications Push Server" (un NPS nel tuo ambiente utilizzato per le notifiche di chiamata push per Apple/Google. Lo chiamiamo "CNPS" qui per distinguerlo dal servizio in Webex che fornisce notifiche push per messaggi e presenza).
Questo server deve essere su R22 o versione successiva.
Viene richiesto un server XSP/ADP separato per CNPS poiché l'imprevedibilità del carico da Webex per le connessioni cloud BWKS potrebbe influire negativamente sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSPADP, consultare la Guida tecnica di sistema Cisco BroadWorks|.
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, andare a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
PC/laptop Windows
PC/laptop Apple con MacOS
iOS (Apple Store)
Android (Play store)
Browser Web (vai a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (tradizionale cinese)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (italiano)
Telefoni e accessori fisici
Telefoni IP Cisco:
telefono IP Cisco serie 6800 con firmware multipiattaforma
telefono IP Cisco serie 7800 con firmware multipiattaforma
telefono IP Cisco serie 8800 con firmware multipiattaforma
Vedere https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html per i modelli e ulteriori informazioni.
I telefoni di terze parti sono supportati allo stesso modo di altre integrazioni BroadWorks. Tuttavia, non dispongono ancora dell'integrazione di contatti e presenza con Webex per Cisco BroadWorks.
Adattatori:
Adattatore per telefono analogico multipiattaforma Cisco ATA 191
Adattatore per telefono analogico multipiattaforma Cisco ATA 192
Vedere https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html per i modelli e ulteriori informazioni.
Cuffie:
cuffia Cisco serie 500
Vedi https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html per i modelli e ulteriori informazioni.
Dispositivi Room OS:
Serie Webex Room e Room Kit
Serie Webex Desk
Serie Webex Board
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e l'assistenza dei dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivo
Di seguito sono riportati i file DTAF che devi caricare sui server delle applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia c'è una nuova config-wxt.xml.template
file utilizzato per l'app Webex.
Per scaricare i profili dei dispositivi più recenti, andare al sito di Download software della piattaforma di consegna delle applicazioni per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che per XSP.
Nome del cliente | Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Comunicatore aziendale - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili del dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Genera una richiesta di servizio con l'agente di onboarding o con Cisco TAC per eseguire il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il titolo della richiesta per le rispettive funzioni:
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
'NPS Configuration for Auth Proxy Setup' (Configurazione NPS per impostazione proxy automatica) per configurare NPS per l'uso del proxy di autenticazione.
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori informazioni su questa funzione, vedere: Supporto di Cisco BroadWorks per CI UUID.
Configura BroadWorks per abilitare la fatturazione Cisco per BroadWorks e Webex Per abbonamenti BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento valido per 60 giorni. Se il token scade prima di utilizzarlo, è possibile presentare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali. |
Certificati ordine
Requisiti di certificato per l'autenticazione TLS
Per tutte le applicazioni richieste, saranno necessari i certificati di sicurezza, firmati da un'autorità di certificazione ben nota e distribuiti su ADP XSP|pubblico. Verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in entrata ai server XSP|ADP.
Questi certificati devono includere il nome di dominio pubblico XSP|ADP completo come Nome comune oggetto o Nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati del server dipendono da come vengono distribuiti gli ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume dove il certificato del server pubblico firmato da CA deve essere caricato in questi tre casi:
Le autorità di certificazione supportate pubblicamente dall'app Webex per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per proxy bridge TLS
Il certificato del server firmato pubblicamente viene caricato nel proxy.
Il proxy presenta questo certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Un certificato firmato CA interno può essere caricato su XSP|ADP.
L'|ADP XSP presenta questo certificato del server firmato internamente al proxy.
Il proxy si basa sulla CA interna che ha firmato il certificato del server XSP|ADP.
Requisiti di certificato TLS per proxy passthrough TLS o XSP|ADP in DMZ
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
Gli ADP XSP|presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca sull'interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione Mutual TLS. Il certificato CA/catena del certificato del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedi a Partner Hub, vai a
e fai clic sul collegamento del certificato di download.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume i requisiti del certificato in questi tre casi:
Requisiti del certificato (opzione) per proxy bridge TLS
Webex presenta un certificato client firmato pubblicamente al proxy.
Il proxy considera attendibile la CA interna di Cisco che ha firmato il certificato del client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta il certificato del server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions: X509v3 Extended Key Usage: 1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Il CN del certificato interno deve essere
bwcticlient.webex.com
.
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le autorità pubbliche di certificazione potrebbero non essere disposte a firmare i certificati con l'OIDE proprietario di BroadWorks richiesto. In caso di proxy di bridging, è possibile che sia necessario utilizzare una CA interna per firmare il certificato del client che il proxy presenta all'ADP XSP|.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Il ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XSP| dal proxy.
Requisiti di certificato (opzione) per proxy passthrough TLS o XSP|ADP in DMZ
Webex presenta un certificato client firmato da CA Cisco interno alle ADP XSP|.
Gli ADP XSP|si fidano delle autorità di certificazione interne di Cisco che hanno firmato il certificato client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XSP|.
Gli ADP XSP|presentano i certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Il server applicazioni ClientIdentity contiene il CN del certificato del client firmato Cisco presentato a XSP|ADP da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene l'elenco di indirizzi IP, porte e protocolli richiesti per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle dei firewall delle regole di ingresso e uscita precedenti documentano solo le connessioni specifiche di Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico per Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e la rilevanza di ciascuna sezione per Webex per Cisco BroadWorks.
Sezione Requisiti di Rete Art. | Rilevanza delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex | Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud | Informativo |
Da leggere | |
Da leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex | Da leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione | Opzionale |
Servizi Webex per clienti FedRAMP | N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedi il whitepaper del firewall dell'app Webex (PDF).
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza XSP|ADP di Broadworks fornita dal partner. Quando un ADP o un sito XSP|non è disponibile per manutenzione pianificata o motivo non pianificato, i servizi e le app Webex possono passare a un altro ADP o sito XSP|fornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP Broadworks XSP|possono essere distribuiti direttamente su Internet o possono risiedere in un DMZ frontale da un elemento di bilanciamento del carico come F5 BIG-IP. Per fornire ridondanza geografica, gli ADP XSP|possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un bilanciatore di carico, ognuno con un indirizzo IP pubblico. Se gli ADP XSP| sono dietro a un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e Broadworks sembra avere solo un XSP|ADP, anche se vi sono più ADP XSP| dietro.
Nell'esempio seguente, le ADP|XSP vengono distribuite in due siti, il Sito A e il Sito B. Esistono due ADP|XSP frontali di un bilanciatore di carico in ogni sito. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali di LB1 e il sito B ha XSP|ADP3 e XSP|ADP4 frontali di LB2. Solo i bilanciatori di carico sono esposti sulla rete pubblica e le ADP|XSP sono nelle reti private DMZ.
Servizi cloud Webex
Configurazione DNS
I microservizi cloud Webex devono essere in grado di trovare il server|ADP Broadworks XSP per la connessione alle interfacce Xsi, al servizio di autenticazione e al CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host XSP|ADP configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso. Se vengono restituiti più indirizzi IP, viene selezionato il primo IP nell'elenco. La ricerca SRV non è attualmente supportata.
Esempio: Il DNS A Record del partner per la scoperta del server XSP|ADP/Load Balancers bilanciato Round-Robin.
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Punti a LB1 (Sito A) |
R |
|
| Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Failover
Quando i microservizi Webex inviano una richiesta al servizio |di bilanciamento del carico/ADP XSP e la richiesta non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se non viene ricevuta alcuna risposta HTTP entro 2 secondi, la richiesta viene timeout e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento dell'indirizzamento all'IP successivo.
Ciascuna richiesta viene provata 3 volte prima di segnalare un errore al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco degli indirizzi da provare quando si invia una richiesta a un XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna nell'elenco per provare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco bloccato. Se l'operazione va a buon fine, tale indirizzo IP viene rimosso dall'elenco bloccato.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP|XSP o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster BroadWorks Calling, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
Azioni XSI
Eventi XSI
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Gli stati delle connessioni possono essere:
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
Rosso: Quando tutti gli IP nella ricerca di record sono irraggiungibili e l'interfaccia non è disponibile.
I seguenti servizi utilizzano i microservizi per connettersi agli XSP|ADP e sono interessati dalla disponibilità dell'interfaccia XSP|ADP:
Accesso all'app Webex
Aggiornamento token app Webex
E-mail/autoattivazione non attendibile
Controllo stato servizio Broadworks
App Webex
Configurazione DNS
L'app Webex accede ai servizi Xtended Services Interface (XSI-Actions & XSI-Events) e Device Management Service (DMS) su XSP|ADP.
Per trovare il servizio XSI, l'app Webex esegue la ricerca DNS SRV per _xsi-client._tcp.<webex app xsi domain>
. L'SRV punta all'URL configurato per gli host XSP|ADP o i bilanciatori di carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex torna alla ricerca A/AAAA.
L'SRV può risolversi in più target A/AAAA. Tuttavia, ogni record A/AAAA deve mappare solo a un singolo indirizzo IP. Se sono presenti più ADP|XSP in un DMZ dietro il dispositivo di bilanciamento del carico/bordo, è necessario che il bilanciatore di carico sia configurato per mantenere la persistenza della sessione in modo da indirizzare tutte le richieste della stessa sessione allo stesso XSP|ADP. Questa configurazione viene avviata perché i heartbeat dell'evento XSI del client devono andare allo stesso XSP|ADP utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non deve esistere. Se il DNS richiede che un record A/AAAA deve essere definito, allora deve essere restituito solo 1 indirizzo IP. Indipendentemente da ciò, l'SRV deve essere ancora definito per l'app Webex. Se l'app Webex utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client alla fine invia heartbeat a un XSP|ADP dove non ha stabilito un canale per eventi. Di conseguenza, il canale viene strappato e il traffico interno è notevolmente più intenso, il che pregiudica le prestazioni del cluster ADP|XSP. Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca di record A/AAAA, è necessario utilizzare un nome di dominio completo separato per Webex Cloud e l'app Webex per accedere agli ADP|XSP. Come mostrato negli esempi, Webex Cloud utilizza Un record |
Esempio 1: ADP|XSP multipli, ciascuno dietro bilanciatori di carico separati
In questo esempio, SRV punta a disattivare l'audio dei record A con ogni record A che punta a un bilanciatore di carico diverso su un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito un esempio di record SRV.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Esempio 2: più amministratori XSP| dietro un singolo bilanciatore di carico (con bridge TLS)
Per la richiesta iniziale, il bilanciatore di carico seleziona un XSP|ADP casuale. XSP|ADP restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il bilanciatore di carico utilizza il cookie per indirizzare la connessione all'ADP XSP|corretto, assicurandosi che il canale dell'evento non si interrompa.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Bilanciatore di carico |
R | LB.esempio.com |
| Indirizzo IP del bilanciatore di carico (XSP|ADP sono dietro al bilanciatore di carico) |
URL DMS
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il file di configurazione. Viene eseguita l'analisi dell'organizzatore nell'URL e l'app Webex esegue la ricerca DNS A/AAAA dell'organizzatore per connettersi all'ADP XSP|che ospita il servizio DMS.
Esempio: DNS Un record per la scoperta di Round-Robin bilanciato server XSP|ADP/Bilanciamento del carico di Webex App per scaricare i file di configurazione tramite DMS:
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Come l'app Webex trova gli indirizzi XSP|ADP
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (sono stati inseriti quando si crea il cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue la ricerca SRV nel modo seguente:
Il cliente esegue una ricerca SRV per _xsi-cliente._tcp.<xsi domain="">
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
Il cliente cerca gli obiettivi A/AAAA e memorizza nella cache gli indirizzi IP restituiti.
Il client si connette a uno dei target (e quindi al suo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi al peso (o a caso se sono tutti uguali).
Se la ricerca SRV non restituisce alcun obiettivo:
Il client esegue una ricerca A/AAAA del parametro principale Xsi e quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso.
Come indicato, il record A/AAAA deve risolversi in un indirizzo IP per le stesse ragioni.
(Opzionale) Successivamente, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocols> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
Se esistono, il client confronterà l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
Se viene rilevata una differenza, il client re-inizializzerà la connettività XSI Actions/XSI Events. La prima fase consiste nell'eseguire lo stesso processo di ricerca DNS elencato nella fase 1, richiedendo questa volta una ricerca del valore nel %XSI_ROOT_WXT% parametro dal file di configurazione.
Assicurarsi di creare i record SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
Failover
Durante l'accesso, l'app Webex esegue una ricerca DNS SRV per _xsi-client._tcp.<xsi domain="">, crea un elenco di organizzatori e si connette a uno degli organizzatori in base alla priorità SRV, quindi al peso. Questo organizzatore connesso diventa quello selezionato per tutte le richieste future. Viene quindi aperto un canale evento all'organizzatore selezionato e viene inviato regolarmente un heartbeat per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP, pertanto è importante che il bilanciatore di carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server XSP|ADP di backend.
Se una richiesta o una richiesta heartbeat a un organizzatore non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), l'indirizzamento dell'app Webex viene eseguito immediatamente all'organizzatore successivo nell'elenco.
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e l'indirizzamento passa all'organizzatore successivo nell'elenco.
Se una risposta non viene ricevuta entro un periodo di tempo, la richiesta viene considerata non riuscita a causa del timeout e le richieste successive vengono inviate al successivo organizzatore. Tuttavia, la richiesta scaduta viene considerata come non riuscita. Alcune richieste vengono riprovate dopo l'errore (con un tempo di riprova crescente). Le richieste che il presunto non vitale non sono riprovate.
Quando un nuovo organizzatore viene provato correttamente, diventa il nuovo organizzatore selezionato se l'organizzatore è presente nell'elenco. Una volta provato l'ultimo organizzatore nell'elenco, l'app Webex passa al primo.
In caso di heartbeat, se si verificano due errori di richiesta consecutivi, l'app Webex re-inizializzerà il canale eventi.
Tenere presente che l'app Webex non esegue il failback e che il rilevamento del servizio DNS viene eseguito solo una volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione attraverso l'interfaccia XSP|ADP/Dms. Esegue una ricerca di record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Innanzitutto, tenterà di inviare la richiesta per scaricare il file di configurazione utilizzando un token SSO. Se ciò non riesce per qualsiasi motivo, verrà riprovato ma con il nome utente e la password del dispositivo.
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning dell'utente. Molte delle attività sono comuni a tutte le modalità di provisioning.
Onboarding dei partner per Webex per Cisco BroadWorks
Ciascun provider o rivenditore di servizi Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, è necessario eseguire la documentazione Cisco BroadWorks di Webex e i nuovi partner devono accettare l'ICPA (Indirect Channel Partner Agreement) online. Al termine di queste operazioni, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, il tuo Partner Activation e/o Customer Success Program Manager ti contatterà per iniziare il tuo onboarding.
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
È necessario eseguire l'applicazione NPS su un altro XSP|ADP. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi sugli ADP XSP|.
Servizio/Applicazione | Autenticazione richiesta | Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
autenticazione protetta |
Integrazione telefonia computer |
mTLS (client e server si autenticano a vicenda) |
Presenza di telefonia |
Applicazione Webview Impostazioni chiamata |
TLS (il server esegue l'autenticazione per i client) |
Mostra le impostazioni di chiamata utente nel portale Assistenza utente all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma occorre fare riferimento alla documentazione esistente per installare le applicazioni sugli ADP|XSP.
Requisiti di coresidenza
Il servizio di autenticazione deve essere coresidente con le applicazioni Xsi, perché tali interfacce devono accettare token di lunga durata per l'autorizzazione del servizio. Il servizio di autenticazione è richiesto per convalidare tali token.
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
È possibile separare gli altri servizi/applicazioni come richiesto per la propria bilancia (gestione dispositivi dedicata XSP|ADP farm, ad esempio).
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
Non installare altre applicazioni o servizi sugli ADP XSP| utilizzati per integrare BroadWorks con Webex.
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se è in esecuzione R22 o versione superiore e il sistema lo supporta.
Mutual TLS (mTLS) è supportato anche come metodo di autenticazione alternativo per il servizio Auth. Se più organizzazioni Webex eseguono lo stesso server ADP XSP|, è necessario utilizzare l'autenticazione mTLS poiché la convalida token CI non supporta più connessioni allo stesso servizio autenticazione ADP XSP|. Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida del token CI, fare riferimento all'Appendice per configurare i servizi (con mTLS per il servizio di autenticazione). |
Se attualmente si utilizza mTLS per il servizio autenticazione, non è obbligatorio riconfigurare l'uso della convalida token CI con TLS. |
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks.
Installare le seguenti patch su ciascun server ADP XSP|. Installare le patch appropriate alla release in uso:
Per R22:
Per R23:
Per R24: non è necessario alcun cerotto
Qualsiasi riferimento a XSP include XSP o ADP.Installare il
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP al percorso del contesto /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire il servizio di autenticazione su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
A partire da Broadworks build 2022.10, le autorità di certificazione in arrivo con Java non vengono più automaticamente incluse nel trust store BroadWorks quando si passa a una nuova versione di java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
Radice commerciale IdenTrust CA 1
autorità di certificazione radice Go Daddy - G2
Verificare che questi certificati siano presenti sotto la seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get
Se non presente, eseguire il seguente comando per importare i trust Java predefiniti:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come ancoraggi attendibili con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono automaticamente importate nella nuova release e continueranno a essere importate finché non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere la FD di convalida del certificato Cisco Broadworks X509.
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server ADP XSP|:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get
set clientId client-Id-From-Step1
set enabled true
set clientSecret client-Secret-From-Step1
set ciResponseBodyMaxSizeInBytes 65536
set issuerName <URL>
- Per ilURL
, immettere l'URL IssuerName che si applica al cluster CI. Vedere la tabella seguente.set issuerUrl <URL>
- Per ilURL
, immettere l'IssuerUrl che si applica al cluster CI. Vedere la tabella seguente.set tokenInfoUrl <IdPProxy URL>
—Inserire l'URL proxy IdP applicabile al cluster dei team. Si veda la seconda tabella che segue.
Tabella 1. Imposta nome emittente e URL emittente Se il cluster CI è... Imposta issuerName e issuerURL su... NOI-A
UE
NOI-B
Se non conosci il tuo cluster CI, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.Tabella 2. Imposta tokenInfoURL Se il cluster di Teams è... Imposta tokenInfoURL su...(URL proxy IdP) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AFRA
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
DOLORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.
Per il test, è possibile verificare che il tokenInfoURL sia valido sostituendo "
idp/authenticate
" parte dell'URL con "ping
".
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user
Configurare i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get
set flsUrl https://cifls.webex.com/federation
set refreshPeriodInMinutes 60
set refreshToken refresh-Token-From-Step1
Eseguire il seguente comando per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get
Configurare la gestione dei token utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
set tokenIssuer BroadWorks
set tokenDurationInHours 720
Genera e condividi chiavi RSA. È necessario generare chiavi su un XSP|ADP, quindi copiarle su tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP.Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web. Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token. Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Rimozione dei requisiti di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con la convalida del token CI su R24, è necessario rimuovere anche il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Interfaccia CTI e configurazione correlata
Di seguito viene elencato l'ordine di configurazione "da più a più". In seguito a questo ordine non è obbligatorio.
Configurazione del server di applicazione per gli abbonamenti CTI
Configurazione di XSP|ADPs per abbonamenti CTI autenticati mTLS
Apertura delle porte in entrata per l'interfaccia CTI protetta
Abbonamento dell'organizzazione Webex agli eventi CTI di BroadWorks
Configurazione del server di applicazione per gli abbonamenti CTI
Aggiornare ClientIdentity su Application Server con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ciascun server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è |
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocol> |
Una specifica interfaccia CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocol> |
Su una nuova installazione, le seguenti crittografie sono installate per impostazione predefinita a livello di sistema. Se non è configurato nulla a livello di interfaccia (ad esempio, nell'interfaccia CTI o HTTP), si applica questo elenco di crittografia. Si noti che questo elenco può cambiare nel tempo:
|
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp>
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
Inserisci il
get
comando per visualizzare le crittografie già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, si utilizzerebbe:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Ancoraggi affidabili per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che le ADP XSP|siano rivolte verso Internet o rivolte verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy bridge (vedere Requisiti del certificato TLS per proxy bridge TLS).
Per ogni amministratore XSP|nell'infrastruttura che pubblica eventi CTI in Webex, effettuare le seguenti operazioni:
Accedere a Hub partner .
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.
Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
(Opzionale) Esecuzione
help updateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot2023
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
Consenti ai client di autenticarsi con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione BroadWorks in uso. Il comando crea un certificato server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. È necessario l'indirizzo IP dell'interfaccia CTI per questo; è possibile leggerlo dal seguente contesto:
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>
Riavviare XSP|ADP.
Abilitazione dell'accesso a BroadWorks CTI Events su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
Specificare l'indirizzo CTI in base al quale Webex può iscriversi a CTI Events di BroadWorks.
Gli abbonamenti CTI sono su base per abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato viene predisposto per Webex per Cisco BroadWorks.
Visualizzazione Webview Impostazioni chiamata
Call Settings Webview (CSWV) è un'applicazione ospitata su XSP|ADP per consentire agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview per le impostazioni di chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono native dell'app Webex.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, è necessario distribuire la funzione Webview impostazioni chiamata.
La vista Webview impostazioni chiamata presenta due componenti:
Applicazione Webview Impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
App Webex, che esegue il rendering delle impostazioni di chiamata in una vista Webview.
Esperienza utente
Utenti Windows: Fai clic su Impostazioni chiamata, quindi su .
Utenti Mac: Fare clic sull'immagine del profilo, quindi
.
Distribuzione di CSWV su BroadWorks
Installazione di Webview impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso ADP|XSP che ospita l'interfaccia Xsi-Actions nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
Accedere a cisco.com e cercare "BWCallSettingsWeb" nella sezione download software.
Trovare e scaricare la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) è stata la più recente al momento della stesura del presente documento.Installare, attivare e distribuire l'archivio Web in base alla Guida alla configurazione della piattaforma di servizi Xtended di Cisco BroadWorks per la versione XSP|ADP. (Versione R24 https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
.Passare al seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più necessario).Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario fornire anche un contextPath perché è un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio
/callsettings
.Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
Ora è possibile prevedere l'URL delle impostazioni di chiamata che si specificherà per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
L'|ADP-FQDN XSP deve corrispondere al FQDN azioni Xsi, perché CSWV deve utilizzare le azioni Xsi e CORS non è supportato.
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview Impostazioni chiamata è ora attiva sugli ADP|XSP.
Configura l'app Webex per utilizzare Webview impostazioni chiamata
Per ulteriori dettagli sulla configurazione del client, vedere la Guida alla configurazione di Webex per Cisco BroadWorks.
Nel file di configurazione dell'app Webex è presente un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti attraverso l'interfaccia dell'applicazione.
<config>
<services>
<web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%">
<url>%WEB_CALL_SETTINGS_URL_WXT%</url>
</web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel %WEB_CALL_SETTINGS_URL_WXT% tag.
Se non si specifica esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
Imposta la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
Il file di configurazione client risultante dovrebbe avere una voce come segue:
<web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push delle chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Call Notifications Push Server (CNPS) per descrivere un'applicazione ospitata XSP o ospitata ADP che viene eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti e invia le notifiche a Google Firebase Cloud Messaging (FCM) o Apple Push Notification Service (APN).
Tali servizi notificano ai dispositivi mobili degli abbonati Webex per Cisco BroadWorks la presenza di chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzione Notification Push Server.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi a loro volta notificano agli utenti mobili Webex le modifiche ai messaggi in arrivo o alla presenza.
In questa sezione viene descritto come configurare l'NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se è necessario eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPShttps://help.webex.com/nl5rir2/. |
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario aggiornare il CNPS per supportare la funzione proxy NPS, server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server di notifica push per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e i tasti di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend di Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APN Apple e i servizi FCM Google.
La funzione migliora anche la capacità del server push delle notifiche di eseguire notifiche push ai dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
Per ulteriori informazioni, vedere Server push per VoIP nella descrizione della funzione UCaaS.
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software e le patch NPS, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Cercare e scaricare la patch dalla pagina di download del software.
Ulteriori informazioni sul server ADP sono disponibili su https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio Apple Push Notification dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per APN. Questo aggiornamento richiede che XSP|ADP che ospita l'NPS esegua R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 | Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma di consegna dell'applicazione (ADP). | ||
2 | Installare le patch proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: | ||
3 | Attivare l'applicazione Notification Push Server. | ||
4 | (Per le notifiche Android) Abilitare l'API FCM v1 sull'NPS.
| ||
5 | (Per le notifiche Apple iOS) Abilitare HTTP/2 su NPS.
| ||
6 | Collegare un supporto tecnico dell'NPS XSP/ADP. | ||
7 | Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN UN 10.193.78.149
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configura NPS per utilizzare il proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Migra NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un server NPS condiviso con altre app mobili, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPS ( https://help.webex.com/nl5rir2).
1 | Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 | Creare l'account cliente su NPS:
Per verificare che i valori inseriti corrispondano a quanto ricevuto, eseguire
| |||||||||||||||||||
3 | Immettere l'URL proxy NPS e impostare l'intervallo di aggiornamento del token (consigliato 30 minuti):
| |||||||||||||||||||
4 | (Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 | (Per le notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, assicurandosi di omettere il tasto Auth – impostarlo su vuoto.
| |||||||||||||||||||
6 | Configurare i seguenti URL NPS:
| |||||||||||||||||||
7 | Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 | Verificare se il server applicazioni sta eseguendo lo screening degli ID applicazione, poiché potrebbe essere necessario aggiungere le app Webex all'elenco utenti autorizzati: | |||||||||||||||||||
9 | Riavviare XSP|ADP: | |||||||||||||||||||
10 | Esegui test delle notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migrazione di NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente che è necessario eseguire la migrazione a FCMv1. Sono previste tre procedure:
Esegui migrazione dei client UC-One a FCMv1: quando disponi di client UCaaS esistenti e devi migrarli per utilizzare FCMv1.
Migrazione dei client SaaS a FCMv1: quando si dispone di client SaaS esistenti e occorre migrarli per utilizzare FCMv1.
Aggiorna server ADP: quando si esegue la migrazione di NPS a un server ADP.
Migrazione dei client UC-One a FCMv1
Utilizzare la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere . L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile Connect su https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al
|
Accedere a SDK amministratore FCM su http://console.firebase.google.com.
Selezionare l'applicazione Android appropriata.
Nella scheda General (Generale), registrare l’ID del progetto
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
Fare clic sul pulsante blu per creare un nuovo account di servizio
Fai clic sul pulsante blu per generare una nuova chiave privata
Chiave di download per una posizione sicura
Per riutilizzare un account servizio esistente:
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
Identificare l'account servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
Copiare il file json su XSP|ADP.
Configurare l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== my_project ********
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Migrazione dei clienti SaaS a FCMv1
Se si desidera eseguire la migrazione dei client SaaS a FCMv1, attenersi alla procedura seguente su Google FCM Console.
Assicurarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione". |
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Aggiorna server ADP
Se si esegue la migrazione dell'NPS per utilizzare un server ADP, utilizzare i passaggi seguenti nella console Google FCM.
Ottenere il file JSON dalla console cloud di Google:
Su Google Cloud Console, andare alla pagina Account servizio.
Fare clic su Seleziona un progetto, scegliere il progetto e fare clic su Apri.
Trova la riga dell'account servizio per la quale desideri creare una chiave, fai clic sul pulsante Altro verticale, quindi fai clic su Crea chiave.
Selezionare un tipo di chiave e fare clic su Crea
Il file viene scaricato.
Aggiungere FCM al server ADP:
Importare il file JSON nel server ADP utilizzando il
/bw/install
comando.Accedere all'ADP CLI e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON
:Quindi, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò avviene per i seguenti motivi:
Per consentire a Webex cloud di autenticare i tuoi utenti rispetto a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
Per consentire alle app Webex di utilizzare l'interfaccia Xsi per il controllo delle chiamate.
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se alcune interfacce non vengono convalidate correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide. Ciò viene impedito poiché un cluster configurato in modo errato potrebbe causare problemi che sono difficili da risolvere. |
Cosa è necessario fare:
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
Assegna un nome al cluster e fai clic su Avanti.
Il concetto di cluster qui è semplicemente una raccolta di interfacce, solitamente situate su un server ADP XSP| o in un'azienda agricola, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il sistema BroadWorks non sono applicabili qui.
(Opzionale) Immettere un Nome account utente e una Password BroadWorks noti all'interno del sistema BroadWorks che si connette a Webex, quindi fare clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
Aggiungere gli URL XSI Actions e XSI Events.
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
Opzionale. Selezionare la casella di controllo Abilita autenticazione diretta BroadWorks se si desidera che gli accessi a BroadWorks siano diretti a BroadWorks. In caso contrario, l'autenticazione per BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo influisce su queste situazioni di accesso:
Accesso al portale di attivazione utente: gli utenti devono immettere le credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o attraverso il proxy IdP.
Accesso client: se l'autenticazione BroadWorks è configurata nel modello di onboarding, l'impostazione precedente determina se l'accesso del client all'app Webex è diretto a BroadWorks o viene proxy attraverso il proxy IdP.
Fai clic su Avanti.
Nella pagina CTI Interface (Interfaccia CTI) procedere come segue:
Aggiungere l'URL CTI e la porta per l'interfaccia CTI a cui si desidera connettersi.
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
Opzionale. Abilita il tasto di alternanza Non disturbare (NoDist) e inserisci l'ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurandosi che la funzione funzioni allo stesso modo su entrambe le piattaforme.
Fai clic su Avanti.
Aggiungere l'URL del servizio di autenticazione.
Selezionare Servizio autenticazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex poiché il servizio di autenticazione convalida correttamente il token utente rispetto al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
Controllare le voci sulla schermata finale, quindi fare clic su Crea. Dovrebbe essere visualizzato un messaggio di successo.
Partner Hub passa gli URL a vari microservizi Webex che testano le connessioni alle interfacce fornite.
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è riuscita.
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Abbiamo implementato questa verifica per prevenire errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, caricatore di bilanciamento o firewall) come illustrato in questa guida, prima di salvare il modello.
Verifica delle connessioni alle interfacce BroadWorks
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Visualizza cluster.
Partner Hub avvia i test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina dell'elenco dei cluster mostra il messaggio di stato accanto a ciascun cluster.
I messaggi verdi relativi al successo dovrebbero essere visualizzati. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio XSI-Actions, XSI-Events, DAS URL e le impostazioni dell'interfaccia CTI.
Configurazione dei modelli di onboarding
I modelli di onboarding sono il modo in cui verrà applicata la configurazione condivisa a uno o più clienti man mano che vengono caricati tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma solo un modello può essere associato a un cliente.
Accedere a Partner Hub e selezionare Clienti.
Fare clic sul pulsante Modelli di onboarding per visualizzare i modelli esistenti.
Fare clic su Crea modello.
Nella finestra Dettagli modello, aggiungere il nome del modello, il paese o la regione e la lingua e-mail predefinita.
Nella finestra Impostazione servizio, utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
Immettere un Nome modello, quindi fare clic su Avanti.
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per diverse modalità di provisioning Nome impostazione
Provisioning fluviale con e-mail attendibili
Provisioning flowthrough senza e-mail
Self-provisioning utente
Abilita flusso BroadWorks attraverso il provisioning (include le credenziali dell'account di provisioning se attivato**)
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il †
Il †
Il †
Indirizzo e-mail provider servizi
Selezionare un indirizzo e-mail dall'elenco a discesa (è possibile digitare alcuni caratteri per trovare l'indirizzo, se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello di onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature tra paese e regione in questo foglio di calcolo.
Il paese dell'organizzazione determina i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni consultare la sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questo interruttore spento.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note dalla tabella:
† Questo passaggio garantisce che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa opzione deve essere sempre attiva, a meno che non si utilizzi un processo manuale di ordinazione ed esecuzione (tramite Cisco Commerce Workspace) per creare le organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello di "provisioning ibrido" e non rientra nel campo di applicazione di questo documento.
** "Account di provisioning" si riferisce all'account di amministrazione a livello di sistema BroadWorks. Su BroadWorks, è necessario un account amministratore con questi attributi: Tipo amministratore=Provisioning, sola lettura=Disattivato.
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
Opzionale. Selezionare Disabilita chiamata gratuita Cisco Webex se si desidera disabilitare le chiamate Webex.
Per la configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
Numeri di chiamata in ingresso Cisco (PSTN)
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
Fai clic su Avanti.
Esistono due approcci per il provisioning degli abbonati relativamente a come vengono verificate le relative identità, utilizzando e-mail attendibili o e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile, gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. In qualità di partner, sei responsabile del provisioning dell'indirizzo e-mail come parte del metodo flow-through o API.
Si consiglia vivamente di utilizzare il metodo di provisioning attendibile poiché garantisce che tutti gli abbonati siano completamente predisposti dall'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso e-mail non attendibile, gli utenti devono verificare i relativi messaggi e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome impostazione
Provisioning flowthrough senza e-mail
Self-provisioning utente
Esegui prima provisioning amministratore
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
Note dalla tabella:
* Ciascuna organizzazione cliente in Webex deve disporre di almeno un utente con ruolo di amministratore. Il primo utente a cui assegnare IM&P integrato in BroadWorks assume il ruolo di amministratore del cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di fornitore di servizi è possibile avere il controllo su chi ottiene il ruolo. La verifica di questa impostazione impedisce agli utenti di completare l'attivazione fino a quando non viene attivato il primo utente fornito. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
Fai clic su Avanti.
Selezionare la modalità di autenticazione predefinita (autenticazione BroadWorks o autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.(Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
Fai clic su Avanti.
Per Preferenze, configurare quanto segue:
Scegliere se si desidera Precompilare gli indirizzi e-mail utente nella pagina di accesso.
Utilizzare questa opzione solo dopo aver selezionato Autenticazione BroadWorks e aver anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il nome utente BroadWorks. La pagina di accesso offre l'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
Se desideri abilitare la sincronizzazione delle rubriche, imposta l'opzione Abilita sincronizzazione rubrica telefonica per tutte le nuove organizzazioni clienti per attivare.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
Immettere un amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatico di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
Assicurati che l'opzione Consenti invito e-mail amministratore quando ti colleghi a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
Fai clic su Avanti.
Esaminare le voci nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Dovrebbe essere visualizzato un messaggio di successo.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con altri modelli.
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario immettere nuovamente i dettagli dell'account di provisioning. I campi Password vuota/Conferma password sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori forniti alla procedura guidata.
Aggiungi altri modelli se disponi di diverse configurazioni condivise che desideri fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbe essere necessario specificare i dettagli del modello per una delle attività seguenti.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning. |
Patch Application Server (solo R22, R23 e R24)
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
Per R22:
AP.as.22.0.1123.ap373197
Per R23:
AP.as.23.0.1075.ap373197
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che costituiscono il requisito per la distribuzione di Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.Modifica della
Maintenance/ContainerOptions
contesto.Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true
Scarica gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interfaccia > Messaggistica e Servizio > IM&P integrato) dei comandi AS.
Accedi a Partner Hub e vai a
.Fare clic su Visualizza modelli.
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro flyout a destra. Se non è stato ancora creato un modello, è necessario farlo prima di poter ottenere l'URL di provisioning.
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per altri modelli se si dispone di più modelli.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema su server applicazioni
Se si utilizza UC-One SaaS, potrebbe non essere necessario impostare il provisioning e il dominio del servizio a livello di sistema. Vedere i Punti di decisione nella sezione Preparazione dell’ambiente. |
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password
AS_CLI/Interface/Messaging> set enableSynchronization true
Attivare l'interfaccia IMP integrata:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
È necessario inserire il nome completo per il |
(Opzione) Configurazione dei parametri di provisioning per azienda su server applicazioni
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
Selezionare Usa dominio di servizio e immettere un valore fittizio (Webex ignora questo parametro). È possibile utilizzare
example.com
).Selezionare Usa server di messaggistica.
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
È necessario inserire il nome completo per il
provisioningURL
parametro, come è stato dato in Partner Hub. Se il server applicazioni non può accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel/etc/hosts
file su AS.Nel campo Nome utente, immettere un nome per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Immettere una password per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Per Identità utente predefinita per ID IM&P, selezionare Principale.
Fare clic su Applica.
Ripeti per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning utente, vedi Provisioning utente provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning aiuta amministratori e team di vendita controllando la presenza di errori prima di eseguire il provisioning di un cliente o abbonato per un pacchetto. Gli utenti o le integrazioni autorizzati da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per assicurarsi che non vi siano conflitti o errori con il provisioning del pacchetto per un determinato cliente o abbonato.
L'API verifica se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto a un cliente o partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, è possibile correggere gli errori prima del provisioning, aumentando la probabilità di un provisioning riuscito.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore Webex per la vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare di un provisioning abbonato all'ingrosso
Per accedere a Precontrolla un documento di provisioning abbonato Wholesale, devi accedere al portale https://developer.webex.com/. |
Partner SSO - SAML
Consente agli amministratori dei partner di configurare l'SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La seguente procedura SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere la funzionalità SSO del partner a un'organizzazione cliente esistente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso. Per aggiungere SSO partner a un'organizzazione esistente, è necessario aprire un ticket con Cisco TAC. |
Verificare che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'integrazione Single Sign-On in Control Hub.
Aprire una richiesta di servizio con Cisco TAC. TAC deve stabilire una relazione di trust tra il provider di identità di terze parti e il servizio Cisco Common Identity. .
Se l'IdP richiedepassEmailInRequest
da abilitare, accertarsi di includere questo requisito nella richiesta di servizio. Controlla con il tuo IdP se non sei sicuro che questa funzione sia necessaria.Carica il file di metadati CI fornito da TAC al provider di identità.
Configurare un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, immettere l'ID entità dall'XML metadati SAML del provider di identità di terze parti.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
Proprio che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori dei partner di configurare l'SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per impostare SSO OIDC partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già caricate utilizzando il modello. Per aggiungere il Partner SSO a un'organizzazione di clienti esistente, è necessario aprire un ticket con Cisco TAC. |
Aprire una richiesta di servizio con il centro TAC di Cisco con i dettagli dell'IDP di connessione OpenID. Sono obbligatori e facoltativi gli attributi IDP. TAC deve impostare l'IDP sul CI e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC, potrebbe consistere in lettere, numeri, trattini, sottolineature, inclinazioni e punti e la lunghezza massima è 128 caratteri.
Id client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Segreto client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco degli ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio, ad esempio "profilo e-mail openid" Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non fornito
URL dell'endpoint di autorizzazione OAuth 2.0 dell'IdP.
endpoint token
Sì se discoveryEndpoint non fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
endpoint infoutente
No
URL dell'endpoint UserInfo di IdP.
Endpoint set di tasti
No
URL dell'endpoint JSON Web Key Set dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
Configurare l'URI di reindirizzamento sull'IDP di connessione OpenID.
Configurare un modello di onboarding. Per l'impostazione della modalità di autenticazione, selezionare Autenticazione partner Con OpenID Connect e immettere il nome IDP fornito durante l'impostazione IDP come ID entità IDP OpenID Connect.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui registrazione chiamata, risposta per assente di gruppo, dirigente e assistente di direzione.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
Eseguire i seguenti comandi sulle interfacce AS. Ciò consentirà all’AS di inviare il c.d.
X-BroadWorks-Correlation-Info
Intestazione SIP:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true
Il
enableCallCorrelationID
Il parametro associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione delle informazioni di correlazione delle chiamate nei registri Xsi-Actions. Si raccomanda di avereenableCallCorrelationID
abilitato utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione dell'identificativo di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione della rubrica garantisce che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la directory di chiamata completa dal server BroadWorks viene sincronizzata con la directory Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione rubriche, vai a Sincronizzazione rubriche in Webex per Cisco BroadWorks.
Webex per Cisco BroadWorks flowthrough provisioning aggiunge utenti di messaggistica e informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, gli elenchi telefonici, gli utenti non di messaggistica e le entità non utenti non sono inclusi (ad esempio, un telefono della sala conferenze, un fax o un numero di gruppo di risposta). L'attivazione della sincronizzazione delle rubriche garantisce che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex. |
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia chiamate e riunioni unificate Webex visualizzata sull'app Webex. Gli utenti possono visualizzare la cronologia dettagliata delle chiamate e della riunione dall'app Webex.
La cronologia chiamate unificata può essere abilitata dagli amministratori a livello di partner in Partner Hub su base cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
Eventi cronologia chiamate: questi eventi vengono utilizzati per creare una cronologia chiamate unificata dettagliata
Eventi di stato hook: la cronologia chiamate unificata include ottimizzazioni dello stato hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di Telephony Presence
Requisiti della cronologia chiamate unificata
Prima di configurare la cronologia chiamate unificata, accertarsi di aver eseguito la patch del sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
AP.as.22.0.1123.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per R23:
AP.as.23.0.1075.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Se si utilizza XSP—
AP.xsp.23.0.1075.ap378585
In caso di utilizzo di ADP
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
AP.as.24.0.944.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per l'elenco completo delle patch BroadWorks che è necessario installare come prerequisito per l'esecuzione di Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella sezione Riferimento. |
Oltre alla patch del sistema, il file di configurazione del client ( config-wxt.xml
) deve avere il seguente set di tag: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altro reindirizzamento nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
AP.as.23.0.1075.ap383346
AP.as.23.0.1075.ap383994
Per R24:
AP.as.24.0.944.ap383346
AP.as.24.0.944.ap383994
Per avere informazioni Dirigente-Assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
AP.as.24.0.944.ap380052
AP.as.24.0.944.ap384239
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare anche la sincronizzazione delle rubriche per la cronologia chiamate unificata dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione NoDist, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti nel cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione di Broadworks durante la stessa finestra di manutenzione. |
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configura organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettuare le seguenti operazioni:
Accedi a Partner Hub su
admin.webex.com
.Andare a Impostazioni e selezionare un cluster esistente.
Verificare che la connessione al cluster sia buona. Nel pannello a destra viene visualizzato un segno di spunta verde con Connection stabilita.
Se questa opzione non viene visualizzata, in Check Connnections (Opzionale), immettere BroadWorks User Id e BroadWorks Password e fare clic su Check per verificare che la connessione sia corretta.
Selezionare la casella di controllo Abilita cronologia chiamate.
Fai clic su Salva.
Interazioni funzione
Per la cronologia chiamate unificata sono presenti le seguenti interazioni delle funzioni:
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando questa situazione esiste, gli eventi Cronologia chiamate e Stato hook non vengono inviati all'app Webex.
La cronologia chiamate unificate non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia chiamate unificata dall'app Webex. Per informazioni dettagliate, vedere: Webex | visualizza cronologia chiamate e riunioni.
Disabilita cronologia chiamate unificata
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visivo
L'app Webex supporta un'indicazione visiva delle chiamate spam nel avviso popup quando la chiamata viene presentata al destinatario e nei record della cronologia delle chiamate unificate quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per utilizzare questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- Le seguenti patch devono essere installate e attive:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o AS-25_Rel_2022.12 come minimo
- La funzione deve essere attivata tramite AS CLI:
- AS_CLI/System/ActivatableFeature> attivare 104112
- AS_CLI/System/StirShaken> imposta enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'etichettatura e la verifica STIR-SHAKEN come descritto in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste di invito inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti che vengono inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione di spam visivo nella presentazione della chiamata e nella cronologia chiamate unificata della chiamata.
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenta di identificare il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra di chiamata e una volta completata la chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante abbinando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se trova più istanze di un numero in un'origine, non tenterà di sceglierne una, in questo caso, non visualizzerà alcun ID chiamante. |
Webex Common Identity (CI) che contiene gli utenti della tua organizzazione.
Contatti personali e aziendali. I contatti personali sono visibili nella scheda Contatti.
Rubrica locale. In Windows - applicazione Outlook, in Mac - Contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non viene trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, utilizzerà la parte del nome utente dell'URI SIP dall'intestazione SIP From come ultima risorsa.
Per il controllo delle chiamate remote (ad esempio, modalità di controllo del telefono fisso) vengono utilizzate informazioni XSI, dove viene utilizzato ID BWKS o interno, estratte da informazioni di parte remota nell'evento XSI. Se l'informazione della parte remota non è disponibile, verrà utilizzata P-Asserted Identity (PAI) (se configurata).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica di chiamata e nella cronologia chiamate.
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
Coda Call Center: Visualizza il nome della coda che ha inoltrato la chiamata.
Dirigente-Assistente: Mostra il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
Per le chiamate nella coda chiamate interna, in cui un agente richiama una parte interna, la parte remota non visualizzerà il nome della coda chiamata, ma il nome dell'agente che le chiama.
Chiamata con risposta altrove:
Per gruppi di risposta o code chiamate impostate con indirizzamento simultaneo, gli agenti visualizzeranno una chiamata che ha ricevuto risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di risposta o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate perse nella cronologia chiamate se risposte da un altro agente.
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni da tavolo. Questa funzione specifica consente di assegnare gli indicatori di linea condivisa all'app Webex dell'utente finale.
Questa funzione consente agli utenti di gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente alle linee condivise.
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise dal client Webex
R23 senza ADP:
AP.as.23.0.1075.ap384179
AP.xsp.23.0.1075.ap384179
R23 con ADP:
AP.as.23.0.1075.ap384179
Xsi-Actions-23_2022.10
R24:
IN QUANTO: AP.as.24.0.944.ap384179
Xsi-Actions-24_2022.10
R25:
IN QUANTO: Versione RI Rel_2022.10_1.310
Xsi-Actions-25_2022.10
Cerotto 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo (in questo caso per il client desktop: Business Communicator).
Versione RI Rel_2022.10_1.310
Sincronizzazione Non disturbare (NoDist).
La sincronizzazione Non disturbare (NoDist) allinea le impostazioni NoDist tra Webex e BroadWorks sincronizzando lo stato NoDist tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato si sincronizza con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. Analogamente, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist da una piattaforma non vengono riconosciuti dall'altra piattaforma.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Prerequisiti
Assicurarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione BroadWorks.
Per la versione 23:
<snipped>
- App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
<snipped>
- App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 su AS:
AS_CLI/System/ActivatableFeature> activate 25433
Se sono presenti molti clienti (>50) nel cluster BroadWorks, operazioni come l'aggiornamento di azioni XSI, eventi XSI, URL DAS, URL XSP|ADP o sincronizzazione NoDist non sono supportate. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza.
Configura sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto di eventi "as-feature-event". Per informazioni dettagliate, vedere Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
Accedi a Partner Hub
Fare clic su Impostazioni.
Fare clic su Visualizza cluster e selezionare il cluster BroadWorks appropriato.
Abilita il tasto di alternanza Non disturbare (NoDist).
Inserire l'ID utente BroadWorks e fare clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione NoDist. Se la convalida non riesce, il pulsante Salva viene disabilitato.
Se la convalida ha esito positivo, fare clic su Salva.
|
Abilita sincronizzazione NoDist (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per ulteriori dettagli, vedere "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Disabilita sincronizzazione NoDist
Non puoi disabilitare la sincronizzazione NoDist da solo. Per disabilitare la funzione, crea un caso BEMS di ingegneria con le seguenti informazioni:
Famiglia: Servizio Spark
Prodotto: Chiamata in Webex (Webex per BroadWorks)
Componente: Provisioning WxBW
Il caso BEMS deve indicare che la sincronizzazione non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterIdBroadWorks.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione delle chiamate.
Modalità di registrazione | Descrizione | Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta | La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente | La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Per R22: AP.as.22.0.1123.ap377718
Per R23: AP.as.23.0.1075.ap377718
Per R24: AP.as.24.0.944.ap377718
L'identificativo di correlazione chiamata deve essere attivato. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione delle chiamate Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, andare a help.webex.com
articolo Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla piattaforma di registrazione chiamate di terze parti.
Gruppo Parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione di parcheggio e recupero delle chiamate di gruppo. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti al dettaglio in un'impostazione di negozio possono utilizzare la funzione per parcheggiare una chiamata che può essere raccolta da qualcuno in un altro reparto.
Funzionamento funzione
Una volta configurata la funzione
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nell'app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nell'app Webex. L'utente quindi inserisce l'estensione della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per attivare questa funzione, verificare quanto segue:
Il file di configurazione client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
L'identificativo di correlazione chiamata deve essere abilitato su AS e XSP|ADP. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Il tuo SBC deve essere configurato per passare il ‘
x-broadworks-correlation-in
' Attributo SIP a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiungi gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo del server applicazioni Cisco BroadWorks - Parte 2. È necessario creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Parcheggio Webex | e Recupera chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzato
Il parcheggio chiamate regolare o indirizzato non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso funzione:
Immettere *68 per parcheggiare una chiamata
Immettere *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato negli ambienti del call center o in altre situazioni in cui può essere necessaria un'assistenza o un intervento immediati.
Quando un servizio di inclusione è abilitato, un utente o supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di tasti o pulsanti dedicati sul proprio telefono o dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o di partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in vari scenari. In un ambiente di call center, supervisori o formatori possono monitorare e assistere i rappresentanti del servizio clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire assistenza o prendere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può partecipare rapidamente a conversazioni in corso per fornire assistenza o prendere decisioni importanti.
Nell'app Webex per l'inclusione, viene inviata una notifica che la chiamata viene trasformata in una conferenza. In NOTIFY (informazioni sulla chiamata o conferenza) non sono disponibili ulteriori informazioni sul tipo di conferenza, pertanto è possibile trattarla in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Vengono introdotti i seguenti termini:
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore solitamente ha la possibilità di monitorare e intervenire nelle chiamate in corso dei clienti. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire assistenza agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può comprendere la formazione degli agenti, la gestione dei problemi dei clienti e l'ottimizzazione delle prestazioni del team.
Cliente: Per cliente si intende una persona fisica o giuridica che interagisce con un'azienda o un'organizzazione per ottenere prodotti, servizi o assistenza. Nel contesto dell'inclusione delle chiamate, un cliente è qualcuno che sta effettuando o ricevendo una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risolvere le loro richieste o problemi durante la chiamata. La funzione di inclusione chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
Agente: Un agente, anche noto come rappresentante del servizio clienti o agente del call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza telefonica o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare operazioni e offrire un'esperienza positiva al cliente. Nel contesto dell'inclusione delle chiamate, un agente è la persona che parla direttamente al cliente durante la telefonata. L'agente può ricevere indicazioni o feedback dal supervisore attraverso l'inclusione della chiamata, se necessario.
La chiamata nativa mobile viene inoltrata alla riunione
La funzione di escalation della chiamata nativa mobile alla riunione è dotata di due funzioni uniche:
Nuova notifica push
Gli utenti mobili su una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando si avvia una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si accede direttamente alla schermata in chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata utilizzando il controllo chiamate Cisco per le chiamate su cellulare, viene visualizzata la notifica Webex durante una chiamata su cellulare.
Trasferisci chiamata mobile a riunione
Quando sei nel mezzo di una chiamata con qualcuno, potresti voler trasferire la chiamata in una riunione per utilizzare alcune funzioni di riunione avanzate come video, condivisione o lavagna. In alternativa, invitare altre persone alla discussione e passare a una riunione.
Requisiti BroadWorks
Funzione attivabile 25239
R23 con XSP|ADP:
AS Patch AP.as.23.0.1075.ap383064
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
Patch AP.platform.23.0.1075.ap383064
R23 con ADP:
AS Patch AP.as.23.0.1075.ap383064
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R24:
Cerotto AS: AP.as.24.0.944.ap383064
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R25:
AS RI release Rel_2022.08_1.354
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e NPS versione > 2022.08_1.350
Configurazione chiamata URI per supportare lo spostamento della chiamata alla riunione
Criteri di chiamata Url NS
Definisci la regola per (.*)webex.com da indirizzare attraverso I-SBC
NS_CLI/Policy/UrlDialing> get WebexMeetings
Policy: UrlDialing Instance: Webex
unknownSipURIHandling = reject
disableSubscriberLookups = true
Enable = true
CallTypes:
Selection = {ALL}
From = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP}
lineportOnly = false
enableSipURIMatchingRules = true
NS_CLI/Policy/UrlDialing/Rules> get WebexMeetings
Policy: UrlDialing Instance: WebexCalling Table: Rules
id pattern routingNE cost weight dtg
===================================================================
1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE di indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> get ne WebexMeetings
Network Element WebexMeetings
Location = 1281465
Data Center =
Static Cost = 1
Static Weight = 99
Poll = false
OpState = enabled
State = OnLine
Profile = NIL_PROFILE
Remote Lookup Enabled = false
Signaling Attributes =
NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings
Routing NE Address Cost Weight Port Transport Route
=====================================================================
WebexMeetings sbc-address 1 99 - unspecified
Profilo di indirizzamento NS
Aggiunta dell'istanza della policy UrlDialing ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> get profile MyInst
Profile: Webex
Policy Instance
==========================================
…
UrlDialing WebexMeetings
AS Usa indirizzamento NS per chiamata NetworkURL
Consente all'AS di rispettare il percorso NS in modalità ibrida AS
AS_CLI/Interface/IMS> set queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un PSAP (Public Safety Answering Point), che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, è necessario integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Usa i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
Chiamata di emergenza E911 in Webex per BroadWorks: utilizzare questo articolo per configurare la chiamata di emergenza E911 in Webex per Cisco BroadWorks utilizzando uno dei seguenti provider E911 supportati:
Banda
Intrado
RedSky
Esclusione di responsabilità per chiamate di emergenza: se disponi di un servizio di posizione, puoi configurare la finestra Esclusione di responsabilità per i servizi di emergenza sull'app Webex in modo da includere un'opzione per gli utenti per aggiornare la propria posizione quando eseguono l'accesso.
Personalizzazione e provisioning dei clienti
Gli utenti scaricano e installano le relative app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedere Piattaforme app Webex). Una volta eseguita l'autenticazione dell'utente, il client si registra sul cloud Webex per messaggistica e riunioni, recupera le informazioni sul branding, scopre le informazioni del servizio BroadWorks e scarica la configurazione delle chiamate dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
Configurare i parametri di chiamata per le app Webex in BroadWorks (come di consueto). Configura i parametri di branding, messaggistica e riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Prepara il tuo ambiente).
Verificare di disporre dei set di tag corretti in BroadWorks System > Resources > Device Management Tag Sets.
Per ciascun client che si sta eseguendo il provisioning:
Scaricare ed estrarre il file zip DTAF per il client specifico.
Importare i file DTAF in BroadWorks all'indirizzo System > Resources > Identity/Device Profile Types
Apri il profilo dispositivo appena aggiunto per la modifica e:
Immettere il nome di dominio completo dell'azienda agricola XSP|ADP e il protocollo di accesso del dispositivo.
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per il funzionamento della condivisione desktop.
È inoltre possibile abilitare il supporto Parte remota eseguendo il seguente comando CLI sul server applicazioni:AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
Salvare il file.
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome | Descrizione |
Priorità codec | Configurazione dell'ordine di priorità per i codec audio e video per le chiamate VoIP |
TCP, UDP e TLS | Configurare i protocolli utilizzati per la segnalazione e il contenuto multimediale SIP |
Porte audio e video RTP | Configurazione degli intervalli di porte per audio e video RTP |
Opzioni SIP | Configurare diverse opzioni relative a SIP (SIP INFO, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti gestiti dal partner. Vedere Configurazione di personalizzazioni di branding avanzate.
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client. |
Personalizzazione dei report dei problemi e degli URL della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito Feedback e Guida", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con Flowthrough Provisioning
Prima di poter eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 | Assegna servizio in BroadWorks: |
2 | Verifica dell'organizzazione cliente e degli utenti in Control Hub: |
Test utente
1 | Scaricare l'app Webex su due diverse macchine. |
2 | Eseguire l'accesso come utenti di test sulle due macchine. |
3 | Effettuare chiamate di prova. |
Provisioning delle organizzazioni dei clienti
Nel modello corrente, eseguiamo automaticamente il provisioning dell'organizzazione del cliente quando si esegue l'onboarding del primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguito una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
Usa API per creare account Webex
Assegna il provisioning integrato IM&P (flowthrough provisioning) con e-mail attendibili per creare account Webex
Assegna provisioning integrato IM&P (flowthrough) senza e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per creare account Webex
Consenti agli utenti di autoattivarsi (invia loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex espone le API pubbliche per consentire ai provider di servizi di integrare il provisioning degli abbonati Webex per Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. Le specifiche per queste API sono disponibili su developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti wholesale verranno rifiutati da queste API. |
Provisioning del flusso
Su BroadWorks, è possibile eseguire il provisioning degli utenti con l'opzione Abilita IM&P integrato. Questa azione provoca l'adattatore di provisioning BroadWorks per effettuare una chiamata API per il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica del codice, ma solo una modifica della configurazione dell'endpoint API per l'adattatore di provisioning.
Il provisioning degli abbonati su Webex può richiedere molti minuti (diversi minuti per l'utente iniziale all'interno di un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il successo del provisioning flowthrough indica che il provisioning è stato avviato. Non indica il completamento. Per confermare che il provisioning di utenti e organizzazione cliente sia completo su Webex, devi accedere a Partner Hub e guardare nell'elenco dei clienti. Gli utenti di trunking BroadWorks possono disporre di Webex per BroadWorks tramite un identificativo di chiamata condiviso (SCA). L'utente che esegue il trunking dovrà disporre del servizio di autenticazione assegnato. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto Webex SCA dall'autenticazione del trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con le funzioni di elenco di indirizzamento o indirizzamento diretto assegnate. |
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata Modello di onboarding. |
Autoattivazione utente
Per eseguire il provisioning degli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
Accedere a Partner Hub e trovare la pagina Elenco clienti.
Fare clic su Visualizza modelli.
Seleziona il modello di onboarding di provisioning che desideri applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non si trova nel sistema BroadWorks associato a questo modello, non può attivarsi automaticamente con il collegamento.
Copiare il collegamento di provisioning e inviarlo all'utente.
È anche possibile includere il collegamento per il download del software e ricordare all'utente di cui ha bisogno di fornire e convalidare il proprio indirizzo e-mail per attivare l'account Webex.
È possibile monitorare lo stato di attivazione dell'utente nel modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi di attivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli all'interno della vista Stato utente che consentono agli amministratori dei provider di servizi Webex per Cisco BroadWorks di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Sposta gli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) |
|
Organizzazione cliente | Collega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge Webex per BroadWorks anche agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) | Se l'organizzazione Webex per BroadWorks non esiste (nessun utente predisposto):
Se esiste un'organizzazione Webex per BroadWorks (viene predisposto almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di autoiscrizione (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (con il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
Sposta utente (con e-mail attendibili): utilizza il provisioning con e-mail attendibili
Sposta utente (con e-mail non attendibili): utilizza il provisioning con e-mail non attendibili
Autoattivazione
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza messaggi e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
L'amministratore aggiunge l'utente.
L'utente viene spinto sul bridge di provisioning BroadWorks.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L’utente apre il messaggio e-mail e fa clic su Attiva account. L'utente viene reindirizzato al portale consumer Webex.
L'utente accede a Webex.
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza messaggi e-mail non attendibili, è necessario prima convalidare l’indirizzo e-mail dell’utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
L'amministratore aggiunge l'utente.
L'utente viene inviato automaticamente al bridge di provisioning BroadWorks.
All'utente viene inviato un testo con un collegamento di attivazione.
L'utente fa clic sul collegamento Attivazione e inserisce l'indirizzo e-mail.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L'utente apre il messaggio e-mail e fa clic su Accedi ora.
L'indirizzo e-mail viene convalidato.
L'utente viene reindirizzato all'accesso al portale consumer Webex.
L'utente accede a Webex.
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Flusso di autoattivazione
Se l'utente dispone di un account BroadWorks esistente, può utilizzare il processo di autoattivazione per spostare l'account.
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
L'utente inserisce il proprio indirizzo e-mail.
L'utente viene inviato al bridge di provisioning BroadWorks.
Viene inviata un'e-mail automatica all'indirizzo e-mail dell'utente.
L'utente apre il messaggio e-mail e fa clic sul collegamento Accedi ora, che convalida l'indirizzo e-mail.
CI rileva che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di poter continuare.
L'utente viene reindirizzato all'accesso a Webex.
L'utente accede al portale consumer.
L'utente fa clic su Elimina account.
L'account Webex precedente viene eliminato.
All'utente è stato predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
Collegamento di Webex per BroadWorks all'organizzazione esistente
Se sei un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, che non è ancora associata a un'azienda BroadWorks gestita da un partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso amministratore per la richiesta di provisioning riuscita.
È necessaria l'approvazione dell'amministratore dell'organizzazione se una delle seguenti affermazioni è vera:
L'organizzazione cliente esistente dispone di 100 utenti o più
L'organizzazione dispone di un dominio e-mail verificato
Dominio organizzazione richiesto
Se nessuno dei criteri di cui sopra è vero, può verificarsi un Attacco automatico.
In uno scenario di allegato automatico, un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner verranno concessi diritti di amministrazione provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà eseguito un amministratore completo. Con l'accesso amministratore di provisioning, la visibilità in Control Hub sarà limitata agli utenti nell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione. |
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che i messaggi e-mail di invito amministratore vengano collegati a organizzazioni esistenti (il tasto di alternanza è attivo per impostazione predefinita). |
1 | L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedere Provisioning delle organizzazioni dei clienti. Si verifica quanto segue:
| ||
2 | Con l'accesso amministratore completo, l'amministratore del partner può completare il processo di provisioning del cliente. Dovrai provare a eseguire nuovamente il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora come amministratore completo esterno, non si dovrebbe osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione cliente esistente sarà visibile come cliente sotto Webex per l'organizzazione partner BroadWorks.
|
Condizioni dell'allegato organizzazione
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione del cliente target. In caso contrario, verrà creata una nuova organizzazione cliente.
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato sul modello di provisioning Webex per BroadWorks. Di conseguenza, non vi sono modifiche alla modalità di accesso degli utenti esistenti.
Tuttavia, se l'organizzazione cliente esistente dispone di branding di base abilitato, una volta eseguito il collegamento, le impostazioni di branding avanzate del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
Il nome dell'organizzazione esistente non cambierà.
Non è stata apportata alcuna modifica all'impostazione del flag di soppressione e-mail nelle impostazioni dell'organizzazione esistente. Ciò può avere effetto sui nuovi utenti predisposti. A seconda di come è impostato il flag, i nuovi utenti possono o meno ricevere un'e-mail con un codice che deve essere immesso per completare l'attivazione.
La modalità di amministrazione con restrizioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
Accertarsi di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
Un'azienda BroadWorks può essere associata solo a una organziazione Webex. Non è possibile eseguire il provisioning degli abbonati da una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com
.
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo. |
L'indirizzo e-mail aggiunto dall'amministratore dell'organizzazione cliente come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore partner come configurato nel modello di onboarding su Partner Hub. Dopo aver aggiunto l'e-mail dal modello di onboarding in Partner Hub come amministratore completo, qualsiasi amministratore aggiuntivo del partner dovrà essere aggiunto anche come amministratore esterno con diritti di amministratore completo. |
Scollegare Webex per BroadWorks dall'organizzazione esistente
Effettuare le seguenti operazioni per scollegare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato accidentalmente Webex per BroadWorks a un'organizzazione esistente e si desidera rimuovere l'allegato.
In Flusso standard, il distacco di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati. |
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso all'amministratore esterno seguendo Approva richiesta amministratore esterno.
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Remove a BroadWorks Workspace.
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi abbonato BroadWorks.
Rimuovi gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se gli utenti sono stati predisposti tramite il flusso e-mail non attendibile e non sono stati ancora inseriti messaggi e-mail validi, gli utenti rimangono in stato di attesa. Segui Verifica provisioning utente con e-mail non attendibili per eliminare gli utenti.
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Hybrid, nella sezione BroadWorks Calling elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera collegare Webex per BroadWorks al cliente, seguire i processi di provisioning per collegarlo a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API Rimuovi abbonato BroadWorks è quella di accedere a BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati. |
Gestione di utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente sono in BroadWorks. Un'identità e-mail distinta per l'utente e le relative licenze per le funzioni Webex vengono conservate in Webex.
Verifica provisioning utente con e-mail non attendibili
Se si sta eseguendo il provisioning di utenti Webex per BroadWorks utilizzando il provisioning flow-through con e-mail non attendibili, gli utenti devono eseguire il provisioning automaticamente inserendo il relativo indirizzo e-mail nel portale di attivazione utente. Se l'utente riscontra un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riscontra nuovamente l'errore, l'amministratore può utilizzare i passaggi seguenti in Partner Hub per esaminare lo stato e caricare l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 | Accedere a Partner Hub e trovare la pagina Elenco clienti. |
2 | Fare clic su Visualizza modelli. Selezionare il modello di onboarding appropriato che si desidera applicare a questo utente. |
3 | In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con e-mail non attendibili sia configurato correttamente:
|
4 | In seguito al provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato del provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo stato corrente, che mostra se l'utente è predisposto o se è presente un requisito in sospeso.
|
5 | Per gli utenti con errori o requisiti in sospeso, fare clic sui tre punti a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili quando si visualizza l'elenco degli utenti:
Esporta: fare clic su questo pulsante se si desidera esportare l'elenco utenti in un file CSV.
Escludi utenti predisposti: abilita questo tasto di alternanza se desideri visualizzare solo gli utenti con requisiti o errori in sospeso.
Modifica ID utente o indirizzo e-mail
Modifiche a ID utente e indirizzo e-mail
L'ID e-mail e l'ID alternativo sono gli attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. La tabella seguente descrive gli scopi di questi diversi attributi e cosa fare se occorre cambiarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non puoi modificare questo identificativo e comunque collegare l'utente allo stesso account in Webex. È possibile eliminare l'utente e ricreare se non è corretto. |
ID e-mail | ID utente | Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si afferma che l'e-mail è attendibile Non richiesto in BroadWorks se non si asserisce di poter considerare attendibili i messaggi e-mail Non richiesto in BroadWorks se consenti agli abbonati di autoattivarsi | È presente un processo manuale per modificare questa opzione in entrambe le posizioni se all'utente è stato eseguito il provisioning con l'indirizzo e-mail errato:
Non modificare l'ID utente BroadWorks. Questa operazione non è supportata. |
ID alternativo | Nessuno | Consente di abilitare l'autenticazione dell'utente per e-mail e password rispetto all'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se Non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti dovranno inserire il proprio ID utente BroadWorks durante l'autenticazione. |
Modifica pacchetto utenti in Partner Hub
1 | Accedi a Partner Hub e fai clic su Clienti. |
2 | Individuare e selezionare l'organizzazione del cliente a cui è assegnato l'utente. Viene visualizzata la pagina di panoramica dell'organizzazione in un pannello a destra dello schermo. |
3 | Fare clic su Visualizza cliente. L'organizzazione del cliente si apre in Control Hub, mostrando la pagina Panoramica.
|
4 | Fare clic su Utenti, quindi individuare e fare clic sull'utente interessato. |
5 | Nei Servizi dell'utente, fare clic su Webex per i pacchetti BroadWorks (Abbonamenti). Si apre il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 | Nella scheda Profilo, cercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 | Seleziona il pacchetto che desideri per questo utente (Base, Standard, Premium o Softphone) e fai clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 | Puoi chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium hanno siti di riunione distinti associati a ciascun pacchetto. Quando un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato viene visualizzato con due siti di riunione in Control Hub. Le funzionalità di riunione organizzatore e il sito della riunione dell'abbonato vengono allineati al pacchetto corrente. Il sito della riunione del pacchetto precedente e qualsiasi contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili all'amministratore del sito della riunione. |
Potrebbero essere necessarie da due a tre ore per le nuove impostazioni PMR derivanti da una modifica del pacchetto da aggiornare. |
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si desidera eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto alcun trasferimento automatico del ruolo di amministratore nel caso in cui venga eliminato l'ultimo amministratore. |
API Cisco BroadWorks per Webex
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
Eseguire la richiesta API Remove a BroadWorks Subscriber su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento Webex per Cisco BroadWorks. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
Eseguire la richiesta Elimina una persona API su https://developer.webex.com/docs/api/v1/people/delete-a-person per eliminare completamente l'utente.
Provisioning flow-through
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – IM&P integrato in BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks - Parte 2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento Webex per Cisco BroadWorks dall'utente. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla propria organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 | Usa le API Persone per eliminare tutti gli utenti dall'organizzazione:
| ||
2 | Se la sincronizzazione rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione rubriche tramite Partner Hub: Per disabilitare la sincronizzazione rubriche tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API aziendale BroadWorks e disabilita l'impostazione enableDirSync. Tutti gli utenti correlati alla sincronizzazione rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione degli utenti (utilizzando entrambi i metodi) può richiedere del tempo a seconda della quantità di utenti. | ||
3 | Una volta rimossi tutti gli utenti, utilizza l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Gestione delle release
I controlli di gestione delle release in Partner Hub consentono a Webex per i provider di servizi Cisco BroadWorks di gestire facilmente le release consentendo loro di controllare la cadenza di rilascio in base alla quale le app Webex degli utenti vengono aggiornate all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza gli aggiornamenti automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
Configurazione di pianificazioni di rilascio personalizzate con rinvii dalla pianificazione di rilascio predefinita Cisco
Configurare una singola pianificazione della release e trasferirla a cascata a tutte le organizzazioni dei clienti che gestiscono
Assegna diverse pianificazioni di rilascio a diverse organizzazioni di clienti
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di rilascio personalizzate, vedere l'articolo Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
Aggiunta di un cluster BroadWorks in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
Aggiunta di un modello di onboarding in Partner Hub
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | ||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | ||
3 | Fare clic su Visualizza cluster. | ||
4 | Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro flyout a destra.
| ||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | |||||||||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | |||||||||
3 | Fare clic su Visualizza modelli. | |||||||||
4 | Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere a Webex Assistant di seguire le azioni, prendere nota di decisioni importanti ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant per Meetings è disponibile gratuitamente per i siti per riunioni con pacchetto Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilitazione di Webex Assistant per Meetings
Webex Assistant è abilitato per impostazione predefinita per i clienti Broadworks con pacchetto standard e premium.
Gli amministratori dei partner e gli amministratori delle organizzazioni dei clienti possono disabilitare la funzione per le organizzazioni dei clienti tramite Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
Il supporto è limitato ai siti per riunioni con pacchetto Premium e Standard e solo alle sale riunioni personali.
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
La condivisione di contenuto tramite e-mail è accessibile solo dagli utenti all'interno della tua organizzazione
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Il contenuto della riunione non è accessibile anche se condiviso tra utenti di pacchetti diversi dall'interno della stessa organizzazione.
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile, pertanto le trascrizioni post-riunione non sono disponibili se Webex Assistant è abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni utente su come utilizzare la funzione, vedere Uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
Webex Calling gratuito è abilitato per impostazione predefinita consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, che disabilita tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzione
Se Webex Calling è disabilitato, le seguenti condizioni si applicano a Webex per gli utenti Cisco BroadWorks:
Gli utenti non visualizzano più Chiamata con Webex come opzione di chiamata selezionabile sull'app Webex.
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, la cronologia chiamate, i contatti, inserendo l'URI dell'altro utente o l'indirizzo e-mail nella barra di ricerca.
Condivisione schermo all'interno di una chiamata BroadWorks.
Le riunioni Webex e la presenza in telefonia funzionano ancora, anche se le chiamate Webex sono disabilitate.
Disabilita chiamate Webex (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno di Aggiungi un nuovo modello guidata. Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti assegnate al modello.
Per informazioni dettagliate sulla configurazione di un nuovo modello di onboarding, vedere Configurazione dell'organizzazione partner in Partner Hub.
Disabilita chiamate Webex (modello di onboarding esistente)
Seguire questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
Accedere a Partner Hub all'indirizzo admin.webex.com.
Scegliere Impostazioni.
Fare clic su Visualizza modello e scegliere il modello di inserimento appropriato.
Fai clic su Disabilita chiamata gratuita Cisco Webex.
Fai clic su Salva.
Disabilita chiamate Webex (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare Webex Calls per un utente esistente, è possibile seguire una delle procedure seguenti per aggiornare l'utente.
Accertarsi di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigura l'utente con le chiamate Webex abilitate. |
Se si utilizza il provisioning flow-through, è possibile effettuare le seguenti operazioni:
Aprire CommPilot e passare alla configurazione utente.
Rimuovere il servizio Integrated IM+P dall'utente e fare clic su OK.
Aggiungere il servizio Integrated IM+P all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
Utilizzare Remove a BroadWorks Subscriber API per eliminare l'utente.
Utilizzare la Provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione della condivisione video o dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per informazioni dettagliate sulla configurazione e le opzioni complete, vedere Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è anche possibile configurare se il contenuto multimediale delle chiamate in ingresso utilizza per impostazione predefinita solo il video o l'audio. |
Indicatore di stato della linea / Notifica risposta per assente
L'indicatore di stato/notifica di risposta per assente utilizza le funzioni di risposta per assente indirizzata. Un utente con indicatore di stato riceve una notifica audio e visiva sull'app Webex quando un utente dell'elenco di indicatori di stato monitorato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può Ignorare o Rispondere alla chiamata dell'utente monitorato.
La notifica dell'indicatore di stato/risposta per assente consente di rispondere alle chiamate di altri membri del team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra chiamata multipla - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza dei membri del team Webex e non Webex. I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati nella rubrica in Webex e avranno solo stati "sconosciuti" e "in chiamata" (lo stato suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
La presenza non è supportata per gli utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
Gli utenti CI senza autorizzazione cloud Webex o tipo di account macchina (spazi di lavoro) visualizzano solo la presenza "in chiamata" e "sconosciuta". Nessun stato attivo, suoneria, ecc.
Gli utenti non Webex dall'elenco di indicatori di stato, che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza "sconosciuta".
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
Se un utente non Webex dell'indicatore di stato detiene una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate su BroadWorks. Installare solo le patch valide per la versione in uso:
Per R22:
Piattaforma AP.22.0.1123.ap382053
AP.as.22.0.1123.ap382053
AP.as.22.0.1123.ap382362
AP.xsp.22.0.1123.ap382053
AP.xsp.22.0.1123.ap382362
AP.as.22.0.1123.ap383459
AP.as.22.0.1123.ap383520
Per R23:
Piattaforma AP.23.0.1075.ap382053
AP.as.23.0.1075.ap382053
AP.as.23.0.1075.ap382362
AP.as.23.0.1075.ap383459
AP.as.23.0.1075.ap383520
Se si utilizza XSP|ADP:
AP.xsp.23.0.1075.ap382053
AP.xsp.23.0.1075.ap382362
Se si utilizza ADP:
Xsi-Actions-23_2022.01_1.200.bwar
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
Per R24:
AP.as.24.0.944.ap382053
AP.as.24.0.944.ap382362
AP.as.24.0.944.ap383459
AP.as.24.0.944. ap383520
Xsi-Actions-24_2022.01_1.200.bwar
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
<busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare la funzione 101642 Enhanced Xsi Mechanism Per la telefonia del team su AS:
AS_CLI/System/ActivatableFeature> activate 101642
Abilita X-BroadWorks-Remote-Party-Info
in AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamata SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Accertarsi che i seguenti servizi siano assegnati agli utenti:
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP. |
Configurazione dell'indicatore di stato della linea su BroadWorks
Gli amministratori dei partner possono utilizzare la seguente procedura per impostare l'indicatore di stato della linea per un utente.
Accedere a BroadWorks CommPilot.
Per un utente selezionato, accedere ad Applicazioni client e configurare l'indicatore di stato della linea.
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
Utilizzare i parametri di ricerca per individuare e aggiungere utenti all'elenco Utenti monitorati.
Fai clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento di coinvolgimento del pubblico facile da usare. Consente alle persone di ottenere il massimo dalle riunioni colmando la distanza tra oratori e pubblico. Quando Slido è integrato nell'organizzazione Control Hub, gli utenti possono aggiungere l'Slido app alle riunioni nell'app Webex. Questa integrazione offre ulteriori funzionalità di Q&A e sondaggio alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando è stata accettata una riunione nel client Outlook che corrisponde a un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che hai assunto un impegno diverso e che la risposta potrebbe essere ritardata.
Per abilitare questa funzione:
andare alla scheda Generale della scheda Impostazioni su Windows o Preferenze su Mac.
Selezionare la casella per Mostra in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, "In una riunione di calendario" in Webex è associato a "Occupato" in Outlook. |
Avvertenza
Per utilizzare questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come funziona altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la sua presenza non verrà aggiornata fino al termine della riunione. A tale scopo, sarà necessario riavviare il client per rispondere.
Risposta automatica con tono
Con la risposta automatica con tono, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul desktop. Quando l'app Webex squilla sull'altra parte, l'utente sente un determinato segnale acustico che indica che la chiamata è in connessione.
Per utilizzare questa funzione per un utente Webex per Cisco BroadWorks:
La funzione è supportata solo sull'aspetto della linea principale
L'app Webex deve essere l'identificativo di linea principale
Il tag %ENABLE_AUTO_ANSWER_WXT% deve essere abilitato
Se l'utente dispone anche di indicatori di chiamata condivisa (ad esempio, un telefono da tavolo è configurato come uno degli indicatori di linea secondaria), la funzione è ancora supportata sull'aspetto principale, a condizione che gli indicatori di chiamata condivisa siano configurati per non ricevere chiamate in arrivo. Per effettuare questa operazione, è possibile configurare una delle tre condizioni seguenti su BroadWorks per tutte le chiamate condivise:
Avvisa tutti gli aspetti delle chiamate con clic è disabilitato nella configurazione dell'aspetto chiamata condivisa: questo è l'approccio consigliato
o
Consenti terminazione a questa posizione deve essere disabilitato per tutte le chiamate condivise o
o
Posizioni disabilitate per tutti gli indicatori di chiamata condivisi
Aumentare la capacità
Aziende agricole XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare quante risorse XSP|ADP aggiuntive sono necessarie per l'aumento proposto dei numeri di abbonati. Per le aziende NPS dedicate o Webex dedicato per le aziende Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
Fattoria dedicata in scala: Aggiungere uno o più server XSP|ADP all'azienda che ha bisogno di capacità extra. Installare e attivare lo stesso set di applicazioni e configurazioni dei nodi esistenti dell'azienda agricola.
Aggiungi azienda agricola dedicata: Aggiungi una nuova fattoria XSP|ADP dedicata. Dovrai creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti nella nuova fattoria, per ridurre la pressione sulla fattoria esistente.
Aggiungere azienda agricola specializzata: Se si verificano strozzature per un particolare servizio, è possibile creare un'azienda agricola ADP|XSP separata a tale scopo, tenendo conto dei requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster di Control Hub e le voci DNS se si modifica l'URL del servizio con una nuova azienda agricola.
In tutti i casi, è tua responsabilità monitorare e assegnare risorse all’ambiente BroadWorks. Se si desidera contattare l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare i servizi professionali.
Gestione dei certificati del server HTTP
È necessario gestire questi certificati per le applicazioni Web autenticate mTLS su XSP|ADP:
La nostra catena di certificati di attendibilità dal cloud Webex
Certificati delle interfacce del server HTTP di XSP|ADP
Catena di fiducia
È possibile scaricare la catena del certificato di attendibilità da Control Hub e installarlo sugli ADP|XSP durante la configurazione iniziale. Prevediamo di aggiornare il certificato prima della scadenza e di informarvi su come e quando modificarlo.
Interfacce del server HTTP
L'|ADP XSP deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Certificati ordine. Quando si protegge l'interfaccia, viene generato un certificato autofirmato per l'interfaccia. Questo certificato è valido per un anno da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione di Partner Hub che gli amministratori dei partner possono assegnare a organizzazioni di clienti specifiche per limitare le impostazioni dell'organizzazione che gli amministratori dei clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione del cliente, tutti gli amministratori del cliente di tale organizzazione, indipendentemente dalle autorizzazioni dei ruoli, non sono in grado di accedere a un set di controlli con limitazioni in Control Hub. Solo un amministratore partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner esiste un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita le autorizzazioni di ruolo specifiche per gli amministratori dei clienti nell'organizzazione a cui è applicata l'impostazione. |
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità con limitazioni per partner. Dopo l'accesso, vedrà un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner notifica all'amministratore del cliente che la Modalità con limitazioni è abilitata e che l'amministratore potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore del cliente in un'organizzazione in cui con limitazioni della modalità partner è abilitata, il livello di accesso di Control Hub è determinato con la formula seguente:
(Accesso a Control Hub) = (Entitlements Role Organization) - (Limitato dalle limitazioni della modalità partner)
Limitazioni
Quando è abilitata la modalità con limitazioni per partner per un'organizzazione del cliente, gli amministratori dei clienti di tale organizzazione non possono accedere alle seguenti impostazioni di Control Hub:
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
Pulsante Gestisci utenti: disattivato.
Aggiungi o modifica manualmente utenti: nessuna opzione per aggiungere o modificare gli utenti, né manualmente né tramite CSV.
Richiedi utenti: non disponibile
Assegna automaticamente licenze: non disponibile
Sincronizzazione rubriche —Impossibile modificare le impostazioni di sincronizzazione delle rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato ed e-mail principale* sono modificabili.
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, messaggi, riunioni, chiamate)
Visualizza stato servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
Numero di lavoro principale: questo campo è di sola lettura.
Nella vista Account, non sono disponibili le seguenti impostazioni:
Nome società: campo di sola lettura.
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
Dominio: accesso di sola lettura.
E-mail: le impostazioni Elimina inviti e-mail di amministrazione e Selezione impostazioni internazionali e-mail sono di sola lettura.
Autenticazione: nessuna opzione per la modifica delle impostazioni di autenticazione e SSO.
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
Impostazioni chiamata: le impostazioni di priorità della chiamata delle opzioni dell'app sono di sola lettura.
Funzionamento chiamata: le impostazioni sono di sola lettura.
Posizione > PSTN: le opzioni Gateway locale e Cisco PSTN sono nascoste.
Sotto SERVIZI, le opzioni di servizio Migrazioni e Connected UC vengono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori partner possono utilizzare la procedura seguente per l'abilitazione Con limitazioni della modalità partner per una determinata organizzazione cliente (l' impostazione predefinita è abilitata).
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
Seleziona l'organizzazione cliente applicabile.
Nella vista Impostazioni di destra, abilitare il Con limitazioni della modalità partner per attivare l'impostazione.
Se si desidera disattivare la modalità Con limitazioni per partner, disabilitare l'interruttore.
Se il partner rimuove la modalità amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà eseguire quanto segue:
|
Analisi dei partner
I miglioramenti di Control Hub consentono agli amministratori partner di visualizzare e aggiornare facilmente le informazioni sui pacchetti per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata di tutti i clienti e include i seguenti dettagli:
Utenti totali per pacchetto (Softphone, Base, Standard, Premium)
Tendenza utenti per pacchetto (giornaliero/settimanale/mensile)
Clienti con n. di pacchetti assegnati
Per informazioni dettagliate su come utilizzare Analisi dei partner, vedere l'articolo Webex Analisi per i pacchetti Webex per la vendita all'ingrosso e Webex per BroadWorks in Partner Hub .
API di report fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare report di fatturazione. Nella tabella seguente vengono elencate le API, il tipo di accesso richiesto e i requisiti di ruolo.
API di fatturazione | Scopo | Tipo di accesso | Requisiti di ruolo per API (L'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Creazione di un report di fatturazione BroadWorks | Utilizzato per generare un report di fatturazione. | Accesso in scrittura |
|
Elenca report di fatturazione BroadWorks | Consente di elencare i report disponibili per la visualizzazione. | Accesso in lettura |
|
Ottenere un report di fatturazione BroadWorks | Utilizzato per ottenere una copia di un report generato. | Accesso in lettura |
|
Eliminazione di un report di fatturazione BroadWorks | Utilizzato per eliminare un report generato. | Accesso scrittura |
|
Campi di fatturazione
Nella tabella seguente sono elencati i campi contenuti nel report generato.
Campo | Descrizione |
---|---|
nome rivenditore | Nome partner o ID organizzazione partner |
ID fatturazione | Identificativo di fatturazione univoco del partner o numero C |
IdImpresaSp | L'identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno | Stato versione di prova interna del cliente (Sì/No) |
ID utente | IDutente dell'abbonato su BroadWorks |
id abbonato | Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato | Sì/No |
Data iniziale | Data di provisioning dell'abbonato. |
dataInizioFatturazione | Data di inizio fatturazione in questo mese |
DataFineFatturazione | Data di fine fatturazione in questo mese |
pacchetto | Il tipo di confezione che viene caricata |
quantità | Quantità ripartita per fatturazione.
|
|
Risoluzione dei problemi di Webex per Cisco BroadWorks
Abbonamento alla pagina di stato Webex
Innanzitutto verificare https://status.webex.com quando si verifica un'interruzione imprevista del servizio. Se non hai modificato la tua configurazione in Control Hub o BroadWorks prima dell'interruzione, controlla la pagina di stato. Ulteriori informazioni sull'iscrizione per le notifiche di stato e incidenti al Centro assistenza Webex.
Usa analisi Control Hub
Webex monitora l'utilizzo e i dati di qualità per la tua organizzazione e le organizzazioni dei tuoi clienti. Ulteriori informazioni sulle analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
Clienti o utenti non vengono creati in Control Hub con provisioning flowthrough:
Il server applicazioni può raggiungere l'URL di provisioning?
L'account di provisioning e la password sono corretti? Tale account esiste in BroadWorks?
I cluster non riescono in modo coerente a eseguire i test di connettività:
La connessione mTLS al servizio di autenticazione non riesce quando si crea il primo cluster in Partner Hub, poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. In caso contrario, non è possibile creare un'ancora attendibile sul servizio di autenticazione XSP|ADPs, pertanto la connessione mTLS di prova da Partner Hub non viene eseguita correttamente. |
Le interfacce XSP|ADP sono accessibili pubblicamente?
Stai utilizzando le porte corrette? È possibile immettere una porta nella definizione dell'interfaccia sul cluster.
Convalida non riuscita interfacce
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Esaminare i consigli per la configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Rivedere i consigli sulla configurazione dell'interfaccia in questo documento, con particolare attenzione a:
- Accertarsi di aver condiviso le chiavi RSA tra tutti gli XSP|ADP.
- Accertarsi di aver fornito l'URL AuthService al contenitore Web su tutti gli XSP|ADP.
- Se è stata modificata la configurazione della crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'|ADP XSP richiede di immettere il formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento elencava erroneamente le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati sul proprio archivio attendibile XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere i certificati del client?
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere i certificati del client?
Problemi del cliente
Verificare che il client sia connesso a BroadWorks
Accedere all'app Webex.
Verificare che l'icona Opzioni di chiamata (un ricevitore con una marcia sopra) sia presente sulla barra laterale.
Se l'icona non è presente, l'utente potrebbe non essere ancora abilitato per il servizio di chiamata in Control Hub.
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici . Viene visualizzato lo stato Sessione SSO A cui è stato eseguito l'accesso.
Se viene visualizzato un servizio telefonico diverso, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Tale verifica comporta:
Il client ha eseguito correttamente il transveresed dei microservizi Webex richiesti.
Autenticazione dell'utente eseguita correttamente.
Il client ha ricevuto un token Web JSON di lunga durata dal sistema BroadWorks.
Il client ha recuperato il proprio profilo dispositivo e si è registrato su BroadWorks.
Registri client
Tutti i client dell'app Webex possono Inviare I Registri a Webex. Questa è l'opzione migliore per i client mobili. È inoltre necessario registrare l'indirizzo e-mail dell'utente e l'ora approssimativa in cui si è verificato il problema se si sta cercando assistenza da TAC. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se è necessario raccogliere manualmente i registri da un PC Windows, si trovano come segue:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac:/Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS configurata male
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
Verificare che la catena di certificati Webex sia installata come ancora affidabile.
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e firmato da una CA ben nota.
Messaggio di eccedenza licenza
Questo messaggio può apparire per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'utilizzo delle licenze supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Politica di supporto allo stato stazionario
Il provider di servizi è il primo punto di contatto per il supporto del cliente finale (aziendale). Inoltrare i problemi che il SP non è in grado di risolvere al centro TAC. Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Politica di escalation
Tu (provider di servizi/partner) sei il primo punto di contatto per il supporto clienti finali (aziendale).
I problemi che non possono essere risolti dal SP vengono inoltrati al centro TAC.
Versioni di BroadWorks
Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Risorse di autosupporto
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, dove è presente una pagina specifica di Webex per Cisco BroadWorks che elenca argomenti di Guida e supporto comuni dell'app Webex.
L'app Webex può essere personalizzata con questo URL della Guida e un URL di segnalazione problemi.
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I registri vengono inviati al cloud Webex, dove possono essere analizzati da Webex DevOps.
È disponibile anche una pagina Centro assistenza dedicata alla Guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccogliere informazioni per l'invio di una richiesta di assistenza
Quando vengono visualizzati errori in Control Hub, potrebbero essere allegate informazioni che possono aiutare TAC a indagare sul problema. Ad esempio, se viene visualizzato un ID di verifica per un particolare errore o un codice di errore, salvare il testo da condividere con noi.
Prova a includere almeno le seguenti informazioni quando invii una query o apri un caso:
ID organizzazione cliente e ID organizzazione partner (ogni ID è una stringa di 32 cifre esadecimali, separate da trattini)
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce uno
Indirizzo e-mail utente (se un particolare utente riscontra problemi)
Versioni del cliente (se il problema presenta sintomi notati attraverso il cliente)
Confronto UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > | SaaS UC-One | Webex per Cisco BroadWorks |
---|---|---|
Cloud | Cisco UC-One Cloud (GCP) | Webex Cloud (AWS) |
Client | UC-One: Mobile, desktop Receptionist, Supervisore | Webex: Mobile, desktop, Web |
Principale differenza tecnologica | Riunioni condotte sulla tecnologia BroadSoft Meet | Riunioni fornite sulla tecnologia Webex Meetings |
Prove sul campo iniziali | Contesto di stadiazione, clienti beta | Ambiente di produzione, clienti GA |
Identità utente | ID BroadWorks servito come ID principale, a meno che il provider di servizi non disponga già dell'integrazione SSO.
ID utente e segreto in BroadWorks | ID e-mail in Cisco CI serve come ID principale Integrazione SSO in BroadWorks provider di servizi in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks al momento.
L'utente fornisce le credenziali tramite SSO con BroadWorks e Secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e segreti in IdP |
Autenticazione client | Gli utenti forniscono le credenziali attraverso il client Token di lunga durata BroadWorks richiesti se si utilizza la messaggistica Webex | Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso a Webex e aggiornamento dei token |
Gestione / configurazione | I vostri sistemi OSS/BSS e Portale rivenditore | I tuoi sistemi OSS/BSS e Control Hub |
Attivazione partner/provider di servizi | Impostazione una tantum da Cisco Operations | Impostazione una tantum da Cisco Operations |
Attivazione cliente/azienda | Portale rivenditore | Control Hub Creato automaticamente alla prima iscrizione utente |
Opzioni di attivazione utente | Autoiscrizione Imposta IM&P esterno in BroadWorks
| Impostazione di IM&P integrato in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP | Azioni XSI
XSI-Eventi CTI (mTLS) AuthService (mTLS opzionale) DMS | Azioni XSI Azioni XSI (mTLS) XSI-Eventi CTI (mTLS) Servizio di autenticazione (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 | Scarica e installa Webex. Per informazioni dettagliate, vedi Webex | Download dell'app. |
2 | Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 | Inserisci l'indirizzo e-mail e fai clic su Avanti. |
4 | Una delle seguenti operazioni si verifica, a seconda del modo in cui l'organizzazione è configurata in Webex: Webex si carica dopo aver eseguito correttamente l'autenticazione su IdP o BroadWorks.
|
Scambio e archiviazione dati
Queste sezioni forniscono dettagli sullo scambio e la memorizzazione dei dati con Webex. Tutti i dati vengono crittografati sia in transito che a riposo. Per ulteriori informazioni, vedi Webex App Security.
Onboarding provider servizi
Quando si configurano cluster e modelli utente in Webex Control Hub durante l'onboarding di provider di servizi, è possibile scambiare i seguenti dati BroadWorks memorizzati in Webex:
URL Xsi-Actions
URL Xsi-Events
URL interfaccia CTI
URL servizio di autenticazione
Credenziali adattatore di provisioning BroadWorks
Provisioning utente provider di servizi
Questa tabella elenca i dati utente e aziendale che vengono scambiati come parte del provisioning utente attraverso le API Webex.
Trasferimento dei dati in Webex | Da | Attraverso | Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito da SP) | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito dall’utente) | Utente | Portale di attivazione utente | Sì |
Nome | BroadWorks, per API | API Webex | Sì |
Cognome | BroadWorks, per API | API Webex | Sì |
Numero di telefono principale | BroadWorks, per API | API Webex | Sì |
Numero telefono cellulare | BroadWorks, per API | API Webex | Sì |
Estensione principale | BroadWorks, per API | API Webex | Sì |
ID provider di servizi BroadWorks e ID gruppo | BroadWorks, per API | API Webex | Sì |
Lingua | BroadWorks, per API | API Webex | Sì |
Fuso orario | BroadWorks, per API | API Webex | Sì |
Rimozione utente
Le API Webex per Cisco BroadWorks supportano la rimozione parziale e completa dell'utente. Questa tabella elenca tutti i dati utente memorizzati durante il provisioning e ciò che viene eliminato in ogni scenario.
Dati utente | Eliminazione parziale | Eliminazione completa |
---|---|---|
ID utente BroadWorks | Sì | Sì |
No | Sì | |
Nome | No | Sì |
Cognome | No | Sì |
Numero di telefono principale | Sì | Sì |
Numero telefono cellulare | Sì | Sì |
Estensione | Sì | Sì |
ID provider di servizi BroadWorks e ID gruppo | Sì | Sì |
Lingua | No | Sì |
Accesso utente e recupero configurazione
Autenticazione Webex
L'autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da uno qualsiasi dei meccanismi di autenticazione del supporto Webex. (L'autenticazione BroadWorks è trattata separatamente.) Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (indipendente) | Webex | Browser utente |
Credenziali utente | Browser utente | Provider identità (che dispone già di identità utente) |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Autenticazione BroadWorks
L'autenticazione BroadWorks si riferisce all'accesso dell'utente a un'app Webex utilizzando le credenziali BroadWorks. Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (proxy Webex Bwks IdP) | Webex | Browser utente |
Informazioni sul branding e URL BroadWorks | Webex | Browser utente |
Credenziali utente BroadWorks | Utente tramite browser (pagina di accesso con marchio servita da Webex) | Webex |
Credenziali utente BroadWorks | Webex | BroadWorks |
Profilo utente BroadWorks | BroadWorks | Webex |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento dell'avviso di accesso e del messaggio di errore:
- Attualmente gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso poiché la password è già scaduta. Con questa funzione, se la password sta per scadere tra 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere, con l'indicazione di quanti giorni rimangono, e all'utente viene consigliato di contattare il partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su true, è stato emesso l'errore "nome utente e password errati", ma ora con questa funzione viene migliorato il messaggio di errore: Tentativo di accesso non riuscito. La combinazione di ID utente e password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice errore 100006
Controllo flusso di accesso:
- Il partner può limitare l'accesso abilitando un'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione in broadworks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, quindi viene visualizzato un errore che indica che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso può essere configurato dal partner come parte della funzione di personalizzazione avanzata. I partner solitamente configurano il collegamento per passare dall'utente a un portale partner per la gestione della password e la reimpostazione della password.
Questa funzione migliora l'esperienza di accesso utente solo durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se una password scade mentre l'utente è connesso all'app Webex. L'utente riceve la notifica di scadenza della password al successivo tentativo di accesso. |
Recupero configurazione cliente
Questa tabella illustra la tipologia di dati scambiati tra le diverse componenti in fase di recupero delle configurazioni del cliente.
Trasferimento dei dati | Da | Per |
---|---|---|
Iscrizione | Client | Webex |
Impostazioni organizzazione, inclusi URL BroadWorks | Webex | Client |
Token JWT BroadWorks | BroadWorks attraverso Webex | Client |
Token JWT BroadWorks | Client | BroadWorks |
Token dispositivo | BroadWorks | Client |
Token dispositivo | Client | BroadWorks |
File di configurazione | BroadWorks | Client |
Utilizzo allo stato stazionario
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione dopo la scadenza del token, tramite BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Trasferimento dei dati | Da | Per |
---|---|---|
Segnalazione SIP | Client | BroadWorks |
Supporto SRTP | Client | BroadWorks |
Segnalazione SIP | BroadWorks | Client |
Supporto SRTP | BroadWorks | Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Trasferimento dei dati | Da | Per |
---|---|---|
Messaggistica e presenza REST HTTPS | Client | Webex |
Messaggistica e presenza REST HTTPS | Webex | Client |
Segnalazione SIP | Client | Webex |
Supporto SRTP | Client | Webex |
Segnalazione SIP | Webex | Client |
Supporto SRTP | Webex | Client |
Uso dell'API di provisioning
Accesso sviluppatore
Le specifiche API sono disponibili su https://developer.webex.com e una guida all'uso è disponibile su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l' accedere per leggere la specifica API all'indirizzohttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Autenticazione e autorizzazione applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (ad esempio provisioning abbonato) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere l'aggiornamento e l'accesso ai token per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
Devi prima registrare la tua integrazione con Webex. Una volta eseguita la registrazione, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di accesso e aggiornamento necessari.
Per ulteriori dettagli sulle integrazioni e sulle modalità di creazione di questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli obbligatori per l'implementazione delle integrazioni: sviluppatore e utente autorizzatore, che possono essere svolti da persone/team separati nel proprio ambiente.
|
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning utilizzata:
Modalità Enterprise: il nome dell'organizzazione corrisponde esattamente a spEnterpriseId.
Modalità provider di servizi: il nome dell'organizzazione è la parte groupID di spEnterpriseId.
Il nome dell'organizzazione conterrà qualsiasi spazio vuoto, maiuscolo e caratteri speciali specificati in spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "attuale" con le ultime patch BroadWorks e le app Release Independent (RI). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Assicurarsi di rivedere le note di patch per queste patch software. Alcune patch potrebbero avere requisiti CLI aggiuntivi. |
Versione R22
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | ||
Richiesto per sincronizzazione rubrica | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per il server applicazioni | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per la funzione di registrazione chiamata | ||
Patch richiesta per il provisioning flow-through | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | Richiesto per proxy autenticazione NPS | |
Richiesto per il servizio di autenticazione con convalida token CI | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Obbligatorio per la cronologia chiamate unificata | ||
Altro | AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Richiesto per sincronizzazione rubrica | |
Configurazione server app | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Se si utilizza ADP... | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Versione R24
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per il provisioning flowthrough | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che è necessario configurare per Webex, fare riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utente e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. L'attivazione include la convalida e-mail e l'assegnazione del servizio in Webex. |
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se disponi di indirizzi e-mail affidabili per gli utenti, puoi scegliere di attivarli automaticamente quando esegui il provisioning automatico degli utenti. Questo processo è "provisioning automatico e attivazione automatica".
Provisioning utente automatizzato e attivazione automatica (flusso e-mail affidabile)
Prerequisiti
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase | Descrizione |
---|---|
1 | Citare e prendere ordini per il servizio con i clienti. |
2 | Si elabora l'ordine del cliente e si esegue il provisioning del cliente nei sistemi. |
3 | Il sistema di provisioning dei servizi attiva il provisioning di BroadWorks. Questo passaggio, in sintesi, crea l'azienda e gli utenti. Quindi assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM&P esterno. |
4 | Questo passaggio di provisioning attiva il provisioning automatico dell'organizzazione cliente e degli utenti in Webex. (L'assegnazione del servizio IM&P determina che l'adattatore di provisioning chiami l'API di provisioning Webex). |
5 | I sistemi devono utilizzare l'API di provisioning Webex se successivamente è necessario regolare il pacchetto per l'utente (per passare dall'impostazione predefinita). |
Flusso di accesso SSO
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, che consente l'autenticazione diretta a BroadWorks. L'immagine mostra gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresenta ciò che il client prevede per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizio BroadWorks che segue immediatamente il flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione BroadWorks diretta abilitata (condivisione risorse cross-origin). Di seguito sono riportati alcuni flussi di accesso SSO SAML alternativi:
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
L'unica differenza è nei punti 5 e 6 del flusso di accesso Webex. Nel passaggio 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
Il flusso procede attraverso i restanti passaggi dei due diagrammi.
Il token SSO non viene utilizzato in questo flusso.
Autenticazione SSO SAML Webex:
Nel passaggio 3 del flusso di accesso Webex, il servizio Common Identity restituisce il provider di identità utilizzato dall'autenticazione Webex.
A questo punto, viene invocato un flusso di accesso SSO SAML alternativo per Webex.
Interazioni utente
Accedi
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
CI rileva che l'organizzazione cliente associata dispone del proxy IDP BroadWorks (IDP) configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso (il provider di servizi può contrassegnare questa pagina di accesso).
L'utente inserisce le credenziali BroadWorks.
Broadworks esegue l'autenticazione dell'utente attraverso l'IDP. In caso di successo, l'IDP reindirizza il browser a CI con un SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
Una volta completata l'autenticazione, l'app Webex ottiene i token di accesso da CI (non mostrati nel diagramma). Il client li utilizza per richiedere un token Web Jason (JWT) di lunga durata BroadWorks.
L'app Webex rileva la configurazione di chiamata da BroadWorks e altri servizi da Webex.
L'app Webex si registra in BroadWorks.
Accesso dalla prospettiva dell'utente
Questo diagramma è il tipico flusso di accesso, visualizzato dall'utente finale o dall'abbonato:
Scarica e installa l'app Webex.
È possibile che tu abbia ricevuto il collegamento dal provider di servizi o che tu possa trovare il download nella pagina di download di Webex.
Inserire l'indirizzo e-mail nella schermata di accesso Webex. Fai clic su Avanti.
Solitamente, si viene reindirizzati a una pagina con il marchio del fornitore di servizi.
Questa pagina potrebbe accogliervi tramite il vostro indirizzo e-mail.
Se non è presente alcun indirizzo e-mail o se l'indirizzo e-mail è errato, inserisci il nome utente BroadWorks.
Inserisci la password BroadWorks.
Se è stato eseguito correttamente l'accesso, Webex si apre.
Flusso chiamate - Rubrica aziendale
Flusso chiamata: numero PSTN
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni con i clienti
Recupero del profilo dal registro DMS e SIP con AS
Il client chiama XSI per ottenere un token di gestione dispositivo e l'URL del DMS.
Il client richiede il proprio profilo dispositivo dal DMS presentando il token dal punto 1.
Il client legge il profilo del dispositivo e recupera le credenziali, gli indirizzi e le porte SIP.
Il Client invia un REGISTRO SIP a SBC utilizzando le informazioni dal punto 3.
SBC invia il REGISTRO SIP al SA (l'SBC può eseguire una ricerca nell'NS per individuare un SA se il SBC non conosce già l'utente SIP).
Linee guida per test e laboratorio
Le seguenti linee guida si applicano alle organizzazioni di test e laboratorio:
I partner provider di servizi sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
Tutti gli utenti oltre i primi 50 utenti di test verranno fatturati.
Per garantire un'elaborazione accurata sulla fattura, tutte le organizzazioni di test devono includere il "test" nel nome dell'organizzazione BroadWorks.
Le organizzazioni di test interni devono essere designate all'interno di Webex Control Hub. Ciò al fine di impedire agli utenti di test di essere fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di prova:
Accedi a Partner Hub e seleziona Clienti.
Selezionare il cliente appropriato.
Nella barra di controllo destra, abilitare il tasto di alternanza Organizzazione test interni.
Riproduzione casella vocale
Per la casella vocale, accertarsi di configurare il server multimediale per utilizzare uno dei seguenti codici:
mp3
wav: i file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android
Se si utilizzano i file wav, eseguire i seguenti comandi CLI per configurare il server applicazioni e il server multimediale:
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACIDITÀ
- Elenco di controllo accessi
- ALVEOLO
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APICI
- Servizio di notifica push Apple
- AS
- Server applicazioni
- ATA
- Adattatore per telefono analogico, adattatore che converte la telefonia analogica in VoIP
- BAMBOLA
- Gestione applicazioni BroadSoft
- Autenticazione base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- ALVEOLARE
- Server di messaggistica BroadSoft
- PALUDE
- Flussi bidirezionali Su HTTP sincrono
- BRI
- Basic Rate Interface BRI è un metodo di accesso ISDN
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico telefonico (cfr. partner, provider di servizi, rivenditore a valore aggiunto)
- CAPTCHA
- Test di Turing pubblico completamente automatizzato per distinguere Computer ed Esseri Umani
- CCXML
- Linguaggio di markup eXtensible controllo chiamate
- CIF
- Formato intermedio comune
- CLI
- Interfaccia riga di comando
- CN
- Nome comune
- CNPS
- Server push notifiche chiamate. Un server push notifiche che viene eseguito su un ADP XSP| nel proprio ambiente per eseguire notifiche di chiamata push su FCM e APNS. Vedere il proxy NPS.
- CPE
- Attrezzatura della sede del cliente
- CPR
- Regola presenza personalizzata
- CENERE
- Foglio stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione telefonia computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- NoDist
- Non disturbare
- DNS
- Sistema dei nomi di dominio
- DPG
- Chiama gruppo di pari
- DSCP
- Punto codice servizi differenziati
- DTAF
- File di archivio tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza a doppia tonalità
- Utente finale
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. Sottoscrittore)
- Aziendale
- Una raccolta di utenti finali (cfr. Organizzazione)
- FUSO
- Messaggistica cloud Firebase
- DI FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creare utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning completo flow-through
- Creare e verificare gli utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks e asserendo che ciascun utente BroadWorks dispone di un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. È la spina sul telefono o fax o i connettori sul sistema telefonico analogico. Fornisce un'indicazione di aggancio/aggancio sganciato (chiusura con loop). Poiché la porta FXO è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo FXO".
- FXS
- Foreign Exchange Subscriber è la porta che effettivamente fornisce la linea analogica all'abbonato. In altre parole, è la "spina nella parete" che fornisce un segnale di linea, corrente della batteria e tensione della suoneria.
- GABBIA
- Messaggio cloud Google
- GABBIA
- Modalità Galois/Counter (tecnologia di crittografia)
- HID
- Dispositivo interfaccia uomo
- HTTPS
- Prese protette da protocollo di trasferimento ipertestuale
- IAD
- Dispositivo di accesso integrato
- IM&P
- messaggistica istantanea e presenza
- PSTN IP
- Un provider di servizi che fornisce VoIP ai servizi PSTN, intercambiabile con ITSP, o un termine generale per la telefonia "pubblica" connessa a Internet, fornito collettivamente dai principali provider di telecomunicazioni (piuttosto che dai paesi, come è PSTN)
- ITSP
- Provider servizi di telefonia Internet
- IVR
- Risposta vocale/risponditore interattiva
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificatore Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notazione oggetto script Java
- JESS
- Java Secure Socket Extension; la tecnologia sottostante che fornisce funzioni di connettività sicure ai server BroadWorks
- KEM
- Modulo interno chiave (telefoni Cisco hardware)
- LLT
- Token di lunga durata (o Long Life): token di connessione autodescrittivo e sicuro che consente agli utenti di rimanere autenticati più a lungo e non è legato ad applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIGLIO
- Base di informazioni di gestione
- AVV.
- Server multimediale
- mTLS
- Autenticazione reciproca tra due parti, tramite scambio di certificati, quando si stabilisce una connessione TLS
- MUCO
- Chat con più utenti
- NAT
- Traduzioni dell'indirizzo di rete
- NPS
- Server push notifica; vedere CNPS
- Proxy NPS
-
Un servizio in Webex che fornisce token di autorizzazione di breve durata al CNPS, consentendo di eseguire notifiche di chiamata push a FCM e APN e, in ultima analisi, a dispositivi Android e iOS con Webex.
- ASSOCIAZIONE
- Apri interfaccia client
- Organizzazione
- Società o organizzazione che rappresentano un insieme di utenti finali (cfr. Impresa)
- OTG
- Gruppo di trunk in uscita
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- Partner
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. rivenditore a valore aggiunto, fornitore di servizi, gestore telefonico)
- PBX
- Borsa filiale privata
- DELLA SOCIETÀ
- E-mail avanzata per la privacy
- PIEDINO
- Rete mobile terrestre pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia per le telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- P.ES.
- Server profilo
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Sito web che consente all’amministratore del rivenditore di configurare la soluzione UC-One SaaS. Talvolta viene indicato come portale BAM, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Revisore di frontiera sessione
- CEMENTAZIONE
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; un'organizzazione che fornisce servizi di telefonia o correlati ad altre organizzazioni (cfr. vettore, partner, rivenditore a valore aggiunto)
- SIP
- Protocollo di avvio sessione
- SLITTA
- Token di breve durata (o Short Life) (chiamato anche BroadWorks SSO Token); token autenticato monouso utilizzato per accedere in sicurezza ad applicazioni Web.
- ODORE
- Piccole e medie imprese
- SNMP
- Protocollo di gestione di rete semplice
- sRTCP
- protocollo di controllo trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- sRTP
- protocollo di trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- SSL
- Strato di prese sicure
- Abbonato
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. utente finale)
- TCP
- Protocollo di controllo del cambio
- TDM
- Divisione Tempo Multiplexing
- TLS
- Sicurezza livello trasporto
- ToS
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Comunicazioni unificate
- UI
- Interfaccia utente
- U ID
- Identificativo univoco
- MUTI
- Server di messaggistica
- URI
- Identificativo risorsa uniforme
- URL
- Ricerca risorse uniformi
- DISTURBO
- Condivisione server
- UTC
- Coordinated Universal Time
- UVS.
- Server video
- Rivenditore a valore aggiunto (VAR)
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. vettore, partner, fornitore di servizi)
- VAMPATA
- Array di grafica video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Linguaggio di markup estensibile vocale
- WebDAV
- Creazione e versioni distribuite su Web
- WebRTC
- Comunicazioni Web in tempo reale
- WRS
- Server WebRTC
- XMPP
- Protocollo di presenza e messaggistica estendibile
Configurazione dei servizi (con mTLS per il servizio autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida token CI. Queste procedure sono obbligatorie se si stanno eseguendo più organizzazioni Webex dallo stesso server ADP XSP|. In caso contrario, sono facoltativi.
Se non si eseguono più organizzazioni Webex sullo stesso server ADP XSP|, si consiglia la convalida del token CI (con TLS) per il servizio di autenticazione. Fare riferimento a Configura servizi su Webex per Cisco BroadWorks XSP|ADPs per informazioni dettagliate su come configurare il servizio di autenticazione e altri servizi. |
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con mTLS)
I token longevi di BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sui tuoi XSP|ADP.
Requisiti
I server XSP|ADP che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
XSP|ADP devono condividere le stesse chiavi per crittografare/decrittografare token di lunga durata BroadWorks. Copiare queste chiavi in ogni XSP|ADP è un processo manuale.
Gli ADP XSP|devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli XSP|ADP include:
Distribuire il servizio di autenticazione.
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
Generare e condividere le chiavi RSA su XSP|ADP.
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ogni XSP|ADP utilizzato con Webex:
Attivare l'applicazione del servizio di autenticazione sul percorso
/authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService
(dove
<version>
è la versione BroadWorks).Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
deploy application /authService
Configurazione della durata del token
Verificare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
Impostare la durata su 60 giorni (max 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
set tokenDurationInHours 1440
Genera e condividi chiavi RSA
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori è necessario generare chiavi su un XSP|ADP quindi copiarle su tutti gli altri XSP|ADP.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP. |
Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web
Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token.
Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità per il servizio di autenticazione (con mTLS)
Accedi a Control Hub con l'account amministratore del partner.
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
.Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
.Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Esegui GuidaUpdateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot2023
,webexclientissuing
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte e quattro le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, è richiesto mTLS per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/HttpServer>
e eseguire ilget
comando per visualizzare le interfacce.Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che significa come mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. In sostanza, il primo
true
protegge l'interfaccia con TLS (il certificato del server viene creato se richiesto) e la secondatrue
forza l'interfaccia a richiedere l'autenticazione del certificato del client (insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Interface Port Name Secure Client Auth Req Cluster Fqdn
=======================================================
192.0.2.7 443 XSP|ADP01.collab.example.net true false
192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (autenticazione client richiesta = true) è abilitato il 192.0.2.7
porta 444
. TLS abilitato su 192.0.2.7
porta 443
.
(Opzione) Configurazione di mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, è necessario mTLS per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
e eseguire ilget
per visualizzare le applicazioni in esecuzione.Per aggiungere un'applicazione e richiederne l'autenticazione client (ovvero mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. I nomi delle applicazioni sono elencati qui. Il
true
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
add 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService a 192.0.2.7:443 e richiede di richiedere e autenticare i certificati dal client.
Verifica con get
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
get
Interface Ip Port Application Name Client Auth Req
===================================================
192.0.2.7 443 AuthenticationService true
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Dove andare Avanti
Per la configurazione, è possibile accedere nuovamente al flusso dei documenti principale all'interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca rispetto a AuthService
Webex interagisce con il servizio di autenticazione su una connessione TLS autenticata reciproca. Ciò significa che Webex presenta un certificato client e che XSP|ADP deve convalidarlo. Per garantire l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora attendibile su XSP|ADP (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
Vai a Impostazioni > BroadWorks Calling.
Fare clic sul collegamento del certificato di download.
È inoltre possibile scaricare la catena di certificati da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt. |
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il diagramma seguente riassume dove deve essere distribuita la catena di certificati CA Webex in questi tre casi.
Requisiti del certificato TLS reciproco per proxy bridge TLS
Webex presenta un certificato client firmato da CA Webex al proxy.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità proxy, pertanto il proxy considera attendibile il certificato del client.
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta un certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions:
X509v3 Extended Key Usage:
1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Requisiti di certificato TLS reciproco per proxy passthrough TLS o XSP in DMZ
Webex presenta un certificato client firmato da CA Webex agli XSP.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità degli XSP, pertanto gli XSP si affidano al certificato client.
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
Gli XSP presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i certificati server degli XSP.
Cronologia revisioni documenti
La tabella seguente mostra lo storico delle modifiche apportate a questo documento negli ultimi 12 mesi.
Data | Versione | Descrizione della modifica | |
---|---|---|---|
22 marzo 2024 | 2-112 |
| |
7 marzo 2024 | 2-111 |
| |
24 febbraio 2024 | 2-110 |
| |
20 febbraio 2024 | 2-109 |
| |
7 febbraio 2024 | 2-108 |
| |
25 gennaio 2024 | 2-107 |
| |
23 gennaio 2024 | 2-106 |
| |
10 gennaio 2024 | 2-105 |
| |
20 dicembre 2023 | 2-104 |
| |
13 dicembre 2023 | 2-103 |
| |
12 dicembre 2023 | 2-102 |
| |
8 dicembre 2023 | 2-101 |
| |
08 novembre 2023 | 2-100 |
| |
25 ottobre 2023 | 2-99 |
| |
13 settembre 2023 | 2-98 |
| |
04 settembre 2023 | 2-97 |
| |
08 agosto 2023 | 2-96 |
| |
23 giugno 2023 | 2-95 |
| |
30 maggio 2023 | 2-94 |
| |
26 maggio 2023 | 2-93 |
| |
24 maggio 2023 | 2-92 |
| |
10 maggio 2023 | 2-91 |
| |
09 maggio 2023 | 2-90 |
| |
4 maggio 2023 | 2-89 |
| |
27 aprile 2023 | 2-88 |
| |
14 aprile 2023 | 2-87 |
| |
17 marzo 2023 | 2-86 |
| |
11 marzo 2023 | 2-85 |
| |
10 marzo 2023 | 2-84 |
| |
7 marzo 2023 | 2-83 |
| |
28 febbraio 2023 | 2-82 |
| |
15 febbraio 2023 | 2-81 |
| |
10 febbraio 2023 | 2-80 |
| |
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione si rivolge agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei propri clienti o forniscono questa soluzione direttamente ai propri abbonati.
Scopo della soluzione
Fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che già dispongono del servizio di chiamata fornito dai provider di servizi BroadWorks.
Fornire il servizio di chiamata basato su BroadWorks a clienti Webex piccoli e medi.
Contesto
Stiamo evolvendo tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo sforzo consiste nello spostare le funzionalità di chiamata BroadWorks nell'app Webex e infine ridurre gli investimenti nei client UC-One.
Vantaggi
Prova futura: contro interruzione del servizio di UC-One Collaborate, spostamento di tutti i client verso Unified Client Framework (UCF)
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex mantenendo la chiamata BroadWorks sulla rete di telefonia
Ambito della soluzione
Clienti da piccoli a medi esistenti/nuovi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre di chiamate BroadWorks.
Clienti Webex esistenti di piccole e medie dimensioni che desiderano aggiungere BroadWorks Calling.
Non aziende più grandi (rivedere il nostro portfolio Enterprise per Webex).
Non utenti singoli (valutare le offerte Webex Online).
Le funzioni impostate in Webex per Cisco BroadWorks riguardano casi d'uso di piccole e medie imprese. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità per le PMI e ne valutiamo costantemente l'idoneità per questo segmento. Possiamo scegliere di nascondere o rimuovere funzioni che sarebbero altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# | Requisito | Note | ||
---|---|---|---|---|
1 | Patch BroadWorks R22 corrente o superiore | |||
2 | XSP|ADP per XSI, CTI, DMS e authService | XSP|ADP dedicato per Webex per Cisco BroadWorks | ||
3 | XSP|ADP separato per NPS, può essere condiviso con altre soluzioni che utilizzano NPS. | Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni XSP|ADP e NPS. | ||
4 | Convalida token CI (con TLS) configurata per le connessioni Webex al servizio di autenticazione. | |||
5 | mTLS configurato per le connessioni Webex all'interfaccia CTI. | Altre applicazioni non richiedono mTLS. | ||
6 | Gli utenti devono essere presenti in BroadWorks e necessitano dei seguenti attributi, a seconda della decisione di provisioning:
| Per i messaggi e-mail attendibili: Si consiglia di inserire lo stesso indirizzo e-mail anche nell'attributo ID alternativo, per consentire agli utenti di accedere con indirizzo e-mail rispetto a BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'uso di e-mail non attendibili può causare l'invio dell'e-mail alla cartella Posta indesiderata o SPAM dell'utente. L'amministratore potrebbe dover modificare le impostazioni e-mail dell'utente per consentire i domini | ||
7 | Webex per il file DTAF Cisco BroadWorks per l'app Webex | |||
8 | Utente BW Business Lic o Std Enterprise o Prem Enterprise Lic + Webex per abbonamento Cisco BroadWorks | Se si dispone di una distribuzione di collaborazione esistente, non è più necessario il pacchetto aggiuntivo UC-One, le porte per conferenze Collab Lic e Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non occorre apportare altre modifiche se non accettare i termini del pacchetto Premium. | ||
9 | IP/porte devono essere accessibili attraverso i servizi backend Webex e le app Webex su Internet pubblico. | Vedere la sezione "Preparazione della rete". | ||
10 | Configurazione TLS v1.2 su XSP|ADP | |||
11 | Per il provisioning Flowthrough, il server applicazioni deve connettersi all'adattatore di provisioning BroadWorks.
| Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è aiutarti a comprendere, preparare, distribuire e gestire la tua soluzione Webex per Cisco BroadWorks. Le principali sezioni del documento riflettono tale obiettivo.
Questa guida include materiale concettuale e di riferimento. In questo documento intendiamo trattare tutti gli aspetti della soluzione.
La serie minima di attività per distribuire la soluzione è la seguente:
Contatta il team dell'account per diventare un partner Cisco. È fondamentale esplorare i punti di contatto Cisco per acquisire familiarità (e ricevere formazione). Quando si diventa partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Onboarding partner in questo documento.
Configura i tuoi sistemi BroadWorks per l'integrazione con Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento.
Usa Partner Hub per connettere Webex a BroadWorks. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione partner in Partner Hub in questo documento.
Utilizzare Partner Hub per preparare i modelli di provisioning degli utenti. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento.
Testare e eseguire l'onboarding di un cliente mediante il provisioning di almeno un utente (vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
|
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. (Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto).
Come funziona
Webex per Cisco BroadWorks è un'offerta che integra BroadWorks Calling in Webex. Gli abbonati utilizzano una singola applicazione (l'app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
Gli utenti chiamano i numeri PSTN utilizzando l'infrastruttura BroadWorks.
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino numerico per introdurre i numeri).
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Chiamata Webex" sull'app Webex. (Queste chiamate sono da app Webex a app Webex, non da app Webex a PSTN).
Gli utenti possono organizzare e accedere a Webex Meetings.
Gli utenti possono scambiarsi messaggi uno a uno o in spazi (chat di gruppo persistente) e beneficiare di funzioni come ricerca e condivisione file (sull'infrastruttura Webex).
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
Una volta eseguito l'onboarding come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare la relazione tra l'istanza BroadWorks e Webex.
È possibile creare organizzazioni dei clienti in Control Hub e eseguire il provisioning degli utenti in tali organizzazioni.
Ogni abbonato in BroadWorks riceve un'identità Webex in base al proprio indirizzo e-mail (attributo ID e-mail in BroadWorks).
Gli utenti eseguono l'autenticazione su BroadWorks o su Webex.
Ai clienti vengono rilasciati token di lunga durata per autorizzarli per i servizi su BroadWorks e Webex.
L'app Webex al centro di questa soluzione, è un'applicazione personalizzabile disponibile su desktop Mac/Windows e dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzionalità di messaggistica, presenza e riunioni.
Il client esegue la registrazione ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i tuoi sistemi BroadWorks per garantire un'esperienza di provisioning utente perfetta.
Funzioni e limitazioni
Offriamo diversi pacchetti con diverse caratteristiche.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata, ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano nella rubrica un utente softphone, i risultati della ricerca non forniscono alcuna opzione per inviare un messaggio.
Gli utenti del softphone possono condividere lo schermo durante una chiamata.
Pacchetto "base"
Il pacchetto di base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti in riunioni a "spazio unificato" e riunioni nella sala riunioni personale. (** vedere la seguente nota a titolo di eccezione). In questo pacchetto le riunioni possono avere una durata massima di 40 minuti.
Pacchetto "Standard"
Questo pacchetto include anche tutto quello che è contenuto nel pacchetto Base, ad esempio fino a 100 partecipanti nelle riunioni "spazio unificato" e nelle riunioni nella sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è un ruolo inizialmente ricoperto solo dall'organizzatore della riunione, ma l'organizzatore può passare il "ruolo di relatore" a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può riprendere il ruolo di relatore senza che l'organizzatore corrente glielo passi.
Pacchetto "Premium"
Questo pacchetto include tutto nel pacchetto Standard più un massimo di 300 partecipanti in una riunione "spazio unificato" e fino a 1000 partecipanti in una sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è supportata per qualsiasi partecipante alla riunione.
Confronta pacchetti
Pacchetto | Chiamata | Messaggistica | Riunioni nello spazio Unified | PMR riunioni |
---|---|---|---|---|
Softphone | Incluso | Non incluso | Nessuno | Nessuno |
Base | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Standard | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Premium | Incluso | Incluso | 300 partecipanti | 1000 partecipanti |
Il limite della riunione nello spazio Unified per gli utenti Base è 100 partecipanti per riunione nello spazio Unified a meno che lo spazio non includa anche gli utenti a cui sono assegnati i pacchetti "Standard" o "Premium", nel qual caso il limite aumenta in base al pacchetto utente organizzatore. |
"Riunioni nello spazio Unified" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti "Riunione" o "Pianifica". "Riunioni PMR" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale (PMR) di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID). |
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per le differenze di supporto delle funzioni di riunione PMR per i pacchetti Base, Standard e Premium.
Funzione riunione | Supportato con il pacchetto base | Suported con pacchetto standard | Supportato con il pacchetto Preminum | Commento |
---|---|---|---|---|
Durata riunione | 40 minuti o meno | Illimitato | Illimitato | |
Condivisione desktop | Sì | Sì | Sì | Base: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione desktop solo da parte dell'organizzatore della riunione PMR. Premium: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. |
Condivisione applicazione | Sì | Sì | Sì | Base: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione delle applicazioni solo da parte dell'organizzatore della riunione PMR. Premium: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. |
Chat con più interlocutori | Sì | Sì | Sì | |
Lavagna | Sì | Sì | Sì | |
Protezione con password | Sì | Sì | Sì | |
App Web - nessun download o plug-in (Esperienza ospite) | Sì | Sì | Sì | |
Supporto dell'accoppiamento con i dispositivi Webex | Sì | Sì | Sì | |
Controllo del pavimento (disattivazione del microfono uno / espulsione tutti) | Sì | Sì | Sì | |
Collegamento Riunioni persistenti | Sì | Sì | Sì | |
Accesso sito riunioni | Sì | Sì | Sì | |
Accesso alla riunione tramite VoIP | Sì | Sì | Sì | |
Bloccaggio | Sì | Sì | Sì | |
Controlli relatore | No | No | Sì | |
Controllo desktop remoto | No | No | Sì | |
Numero di partecipanti | 100 | 100 | 1000 | |
Registrazione salvata in locale nel sistema | Sì | Sì | Sì | |
Registrazione nel cloud | No | No | Sì | |
Registrazione - Cloud Storage | No | No | 10 GB per sito | |
Trascrizione delle registrazioni | No | No | Sì | |
Pianificazione riunione | Sì | Sì | Sì | |
Abilita condivisione contenuto con integrazioni esterne | No | No | Sì | Base: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. Standard: condivisione di contenuto solo da parte dell'organizzatore della riunione PMR. Premium: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. |
Consenti modifica URL PMR | No | No | Sì | Base: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori dei partner e delle organizzazioni possono modificare l'URL da Control Hub. Standard: l'URL PMR può essere modificato solo da Partner Hub per Partner e amministratori organizzazione. Premium: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori partner e dell'organizzazione possono modificare l'URL da Partner Hub. |
Streaming in diretta riunioni (Ad Esempio, su Facebook, Youtube) | No | No | Sì | |
Consenti ad altri utenti di pianificare riunioni per loro conto | No | No | Sì | |
Aggiungi organizzatore alternativo | Sì | No | Sì | |
Integrazione app (es., Zendesk, Slack) | Dipende dall'integrazione | Dipende dall'integrazione | Sì | Per ulteriori informazioni sul supporto, vedere la sezione Integrazioni app riportata di seguito. |
Integrazione con il calendario Microsoft Office 365 | Sì | Sì | Sì | |
Integrazione con Google Calendaring per G Suite | Sì | Sì | Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione rivolta agli utenti per Webex su help.webex.com
. Per ulteriori informazioni sulle funzioni, leggere i seguenti articoli:
Funzioni di chiamata
L'esperienza di chiamata è simile alle soluzioni precedenti che utilizzano il motore di controllo delle chiamate BroadWorks. La differenza tra UC-One Collaborate e UC-One SaaS è che l'app Webex è il client software principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
Zendesk—Solo Premium
Slack: solo Premium
Microsoft Teams per Webex Meetings—Standard o Premium
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
Calendario Office 365—Standard o Premium
Google Calendaring per G Suite: standard o premium
Supporto dell'infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta gli ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione per Webex per l'infrastruttura desktop virtuale (VDI).
Supporto per IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Tabella di marcia futura
Per informazioni sulle nostre intenzioni per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Le voci della roadmap non sono vincolanti in alcuna capacità. Cisco si riserva il diritto di sospendere o rivedere uno o tutti questi elementi dalle release future.
Limiti
Limitazioni di provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario del sito Webex Meetings creato per tale pacchetto.
Se nella richiesta di provisioning per il primo utente di ciascun pacchetto non viene specificato alcun fuso orario, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sull'impostazione predefinita regionale dell'organizzazione degli abbonati.
Se il cliente necessita di uno specifico fuso orario del sito di Webex Meetings, specificare timezone
parametro nella richiesta di provisioning per:
il primo abbonato predisposto per il pacchetto Standard nell'organizzazione.
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
il primo abbonato predisposto per il pacchetto base nell'organizzazione.
Limitazioni generali
Nessuna chiamata nella versione Web del client Webex (questa è una limitazione del client, non una limitazione della soluzione).
Webex potrebbe non disporre ancora di tutti i controlli dell'interfaccia utente per supportare alcune funzioni di controllo delle chiamate disponibili da BroadWorks.
Attualmente, il client Webex non può essere "White Labeled" (etichetta bianca).
Quando si creano le organizzazioni dei clienti utilizzando il metodo di provisioning scelto, vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. Ci aspettiamo che i partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
I report sull'utilizzo di riunioni e messaggi sono disponibili attraverso l'organizzazione del cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti di messaggistica
I seguenti limiti di archiviazione dei dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo storage massimo per messaggistica e file combinati.
Di base: 2 GB per utente per 3 anni
Standard 5 GB per utente per 3 anni
Premio: 10 GB per utente per 5 anni
Per ciascuna organizzazione del cliente, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti premium ha un limite totale di messaggistica e storage file di 50 GB. Un singolo utente può superare il limite per utente (10 GB), a condizione che la società sia ancora al di sotto del massimo aggregato (50 GB).
Per gli spazi team creati, i limiti di messaggistica vengono applicati al totale aggregato per l'organizzazione cliente che possiede lo spazio team. Puoi trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti generali di messaggistica applicabili agli spazi dei team di messaggistica Webex, fare riferimento a https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure le connessioni a Webex e BroadWorks. I dati memorizzati nel cloud Webex ed esposti all'utente attraverso l'interfaccia dell'app Webex sono crittografati sia in transito che a riposo.
Maggiori dettagli sullo scambio di dati sono disponibili nella sezione Riferimento del presente documento.
Ulteriori letture
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati che più si avvicina alla propria regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore del provider di servizi (utente): Per le attività di manutenzione quotidiane, si gestiscono le parti della soluzione in sede (chiamata) utilizzando i propri sistemi. Gestisci le parti Webex della soluzione attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale.
Il primo utente predisposto per un nuovo organizzatore partner viene assegnato automaticamente ai ruoli amministratore completo e amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi. |
Team operativo di Cisco cloud: Crea la tua "organizzazione partner" in Partner Hub, se non esiste, durante l'onboarding.
Una volta ottenuto l'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente, create "Onboarding templates" (Modelli di onboarding) per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Quindi si fornisce i vostri clienti o abbonati.
# | Compito tipico | SP | Cisco |
---|---|---|---|
1 | Onboarding partner - Creazione dell'organizzazione partner se non esiste e abilitazione dei tasti di alternanza funzione necessari | ● | |
2 | Configurazione BroadWorks nell'organizzazione partner tramite Partner Hub (cluster) | ● | |
3 | Configurazione delle impostazioni di integrazione in Organizzazione partner tramite Partner Hub (modelli di offerta, branding) | ● | |
4 | Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|ADP Patching, firewall, configurazione XSP|ADP, XSI, AuthService, CTI, NPS, applicazioni DMS su XSP|ADP) | ● | |
5 | Sviluppo dell'integrazione o del processo di provisioning | ● | |
6 | Preparare i materiali GTM | ● | |
7 | Migrazione o provisioning di nuovi utenti | ● |
Architettura
Cosa c'è nel diagramma?
Client
Il client dell'app Webex serve come applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di messaggistica nativa, presenza e riunioni audio/video multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per le chiamate SIP e PSTN.
I telefoni IP Cisco e i relativi accessori utilizzano anche l'infrastruttura BroadWorks per le chiamate SIP e PSTN. Ci aspettiamo di essere in grado di supportare telefoni di terze parti.
Portale di attivazione utente per gli utenti che accedono a Webex utilizzando le credenziali BroadWorks.
Partner Hub è un'interfaccia Web per l'amministrazione dell'organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. Puoi anche utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
Rete di provider di servizi
Il blocco verde a sinistra dello schema rappresenta la tua rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
XSP|ADP rivolto al pubblico, per Webex per Cisco BroadWorks: (La scatola rappresenta una o più fattorie XSP|ADP, eventualmente frontali da bilanciatori di carico).
Ospita l'interfaccia dei servizi Xtended (XSI-Actions & XSI-Events), il servizio di gestione dei dispositivi (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato del ricevitore dell'altro (presenza di telefonia) e la cronologia chiamate.
Pubblica la rubrica ai client Webex.
XSP|ADP rivolto al pubblico, con NPS in esecuzione:
server push notifiche chiamate organizzatore: Un server push di notifica su un ADP XSP| nel proprio ambiente. Si interfaccia tra il server applicazioni e il proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS & FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
Server applicazioni:
Fornisce il controllo delle chiamate e le interfacce ad altri sistemi BroadWorks (generalmente)
Per il provisioning flowthrough, l'AS viene utilizzato dall'amministratore del partner per il provisioning degli utenti in Webex
Inserisce il profilo utente in BroadWorks
OSS/BSS: Sistema di supporto alle operazioni/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nello schema rappresenta il cloud Webex. I microservizi Webex supportano l'intero spettro di funzionalità di collaborazione Webex:
Cisco Common Identity (CI) è il servizio identità all'interno di Webex.
Webex per Cisco BroadWorks rappresenta la serie di microservizi che supportano l'integrazione tra Webex e BroadWorks ospitato da provider di servizi:
API di provisioning utente
Configurazione provider di servizi
Accesso utente mediante credenziali BroadWorks
Casella di messaggistica Webex per microservizi correlati alla messaggistica.
Casella Webex Meetings che rappresenta server di elaborazione multimediale e SBC per riunioni video con più partecipanti (SIP e SRTP)
Servizi Web di terze parti
Nello schema sono rappresentati i seguenti componenti di terze parti:
APNS (Apple Push Notifications Service) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Apple.
FCM (messaggistica cloud FireBase) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Il ruolo dei server XSP|ADP aperti al pubblico in Webex per Cisco BroadWorks
L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste Webex per BroadWorks JWT (JSON Web Token) per conto dell'utente
Interfaccia CTI, protetta da mTLS, a cui Webex sottoscrive gli eventi della cronologia chiamate e lo stato della presenza di telefonia da BroadWorks (stato hook).
Interfacce azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate degli abbonati, rubriche di elenchi di contatti e chiamate e configurazione del servizio di telefonia per gli utenti finali
Servizio DM (Device Management) per il recupero dei file di configurazione delle chiamate da parte dei client
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedere Configurazione dei cluster BroadWorks in Partner Hub in questo documento. Per ciascun cluster, è possibile fornire un solo URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP
È necessario utilizzare un'istanza ADP XSP|dedicata o un'azienda agricola separata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile organizzare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso XSP|ADP che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/azienda agricola ADP XSP| dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
Ad esempio, se offri UC-One SaaS, ti consigliamo di creare una nuova fattoria XSP|ADP per Webex per Cisco BroadWorks. In questo modo i due servizi possono operare in modo indipendente durante la migrazione degli abbonati.
Se si collocano le applicazioni Webex per Cisco BroadWorks in una fattoria ADP|XSP utilizzata per altri scopi, è responsabilità dell'utente monitorare l'utilizzo, gestire la complessità risultante e pianificare l'aumento della scala.
Il pianificatore della capacità di sistema Cisco BroadWorks assume una fattoria ADP XSP| dedicata e potrebbe non essere preciso se la si utilizza per i calcoli della posizione.
Se non diversamente specificato, gli Webex dedicati per Cisco BroadWorks XSP|ADP devono ospitare le seguenti applicazioni:
AuthService (TLS con convalida token CI o mTLS)
CTI (mTLS)
Azioni XSI (TLS)
XSI-Events (TLS)
DMS (TLS): opzionale. Non è obbligatorio distribuire un'istanza DMS o un'azienda agricola separata specificamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
TLS (Call Settings Webview): opzionale. La vista Webview (CSW) delle impostazioni di chiamata è richiesta solo se si desidera che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso a CTI attraverso un'interfaccia protetta dall'autenticazione TLS reciproca. Per supportare questo requisito, raccomandiamo una delle seguenti opzioni:
(Diagramma etichettato Opzione 1) Una istanza XSP|ADP o un'azienda agricola per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
(Diagramma etichettato Opzione 2) Due istanze ADP XSP| o aziende agricole, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSP|ADP Se si dispone di una fattoria ADP XSP|esistente conforme a una delle architetture suggerite sopra (Opzione 1 o 2) ed è leggermente caricata, è possibile riutilizzare le ADP XSP|esistenti. Dovrai verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti dell'applicazione per Webex. Le due considerazioni principali sono:
Poiché gli XSP|ADP hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero esserci altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di XSP|ADP deve essere verificato in un laboratorio con la configurazione desiderata prima di impegnarsi per il riutilizzo. |
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione temporale per tutti gli XSP|ADP utilizzati con Webex.
Installare il ntp
pacchetto dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Quindi è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, consultare la Guida alla gestione del software BroadWorks.
Durante l'installazione interattiva del software XSP|ADP, è possibile configurare NTP. Procedere come segue:
Quando l'installatore chiede,
Do you want to configure NTP?
, immetterey
.Quando l'installatore chiede,
Is this server going to be a NTP server?
, immetteren
.Quando l'installatore chiede,
What is the NTP address, hostname, or FQDN?
, immettere l'indirizzo del server NTP o un servizio NTP pubblico, ad esempio,pool.ntp.org
.
Se gli ADP XSP|utilizzano un'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie Key=Value:
NTP
NTP_SERVER=<NTP Server address, e.g., pool.ntp.org>
Requisiti di identità e sicurezza XSP|ADP
Sfondo
I protocolli e le crittografie delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli vanno dal più generale (provider SSL) al più specifico (interfaccia singola). Un'impostazione più specifica sostituisce sempre un'impostazione più generale. Se non sono specificate, le impostazioni SSL di livello "inferiore" vengono ereditate da livelli "superiori".
Se non viene modificata alcuna impostazione rispetto alle impostazioni predefinite, tutti i livelli ereditano le impostazioni predefinite del provider SSL (JSSE Java Secure Sockets Extension).
Elenco dei requisiti
L'|ADP XSP deve autenticarsi sui client utilizzando un certificato firmato da CA in cui il nome comune o il nome alternativo oggetto corrispondono alla parte di dominio dell'interfaccia XSI.
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
Diffie-Hellman Effemeral (DHE) o curve ellittiche Diffie-Hellman Effemeral (ECDHE) chiave-scambio
Crittografia AES (Advanced Encryption Standard) con una dimensione minima di blocco di 128 bit (ad esempio, AES-128 o AES-256)
Modalità di codifica GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
Se viene utilizzata una crittografia CBC, solo la famiglia SHA2 di funzioni hash è consentita per derivazione chiave (SHA256, SHA384, SHA512).
Ad esempio, le seguenti crittografie soddisfano i requisiti:
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come illustrato sopra, non la convenzione openSSL. |
Crittografie TLS supportate per le interfacce AuthService e XSI
Questo elenco è soggetto a modifiche a mano a mano che evolvono i nostri requisiti di sicurezza del cloud. Seguire l'attuale raccomandazione sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento. |
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_128_GCM_SHA256
TLS_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA256
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_256_CBC_SHA
TLS_PSK_WITH_AES_256_CBC_SHA384
TLS_PSK_WITH_AES_256_CBC_SHA
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA
TLS_PSK_WITH_AES_128_CBC_SHA256
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri della scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il numero di thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi visualizzati come segue (non diminuirli se sono al di sopra di questi valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più |ADP XSP
Elemento bordo bilanciamento carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, deve gestire in modo trasparente la distribuzione del traffico tra più server XSP|ADP e il cloud e i client Webex per Cisco BroadWorks. In questo caso, è possibile fornire l'URL del bilanciatore di carico alla configurazione Webex per Cisco BroadWorks.
Note su questa architettura:
Configurare il DNS in modo che i client possano trovare il bilanciatore di carico quando si connettono all'interfaccia Xsi (vedere configurazione DNS).
Si consiglia di configurare l'elemento edge in modalità proxy SSL inversa per garantire la crittografia dei dati punto a punto.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Server XSP|ADP orientati verso Internet
Se si espongono direttamente le interfacce Xsi, utilizzare il DNS per distribuire il traffico ai più server XSP|ADP.
Note su questa architettura:
Per connettersi ai server XSP|ADP sono necessari due record:
Per i microservizi Webex: Per targetizzare più indirizzi IP XSP|ADP sono necessari record A/AAAA round-robin. Questo perché i microservizi Webex non possono effettuare ricerche SRV. Per esempi, vedere Servizi cloud Webex.
Per l'app Webex: Un record SRV che si risolve in record A in cui ogni record A si risolve in un singolo XSP|ADP. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per targetizzare il servizio XSI per più indirizzi XSP|ADP. Assegnare la priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (e all'indirizzo IP successivo) e passino al record A successivo (e all'indirizzo IP) solo se il primo indirizzo IP è inattivo. NON utilizzare un approccio round-robin per l'app Webex.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune.
È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL XSP|ADP di un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server XSP|ADP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.
Ordinazione e provisioning
L'ordine e il provisioning si applicano a questi livelli:
Provisioning di partner/provider di servizi:
Ogni onboarding di Webex per provider di servizi Cisco BroadWorks (o rivenditore) deve essere configurato come organizzazione partner in Webex e devono essere concesse le autorizzazioni necessarie. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per gestire Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le operazioni di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/aziendale.
Ordinazione e provisioning clienti/aziende:
Ogni BroadWorks Enterprise abilitato per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo si verifica automaticamente come parte del provisioning utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks vengono predisposti nella stessa organizzazione cliente Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
Ordinazione e provisioning utente/abbonato:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning degli utenti:
Provisioning fluviale con e-mail attendibili
Provisioning eseguibile senza e-mail attendibili
Self-provisioning utente
Provisioning API
Provisioning eseguibile con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile affermare che BroadWorks dispone di indirizzi e-mail abbonati validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Provisioning eseguibile senza e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non puoi contare sugli indirizzi e-mail degli abbonati detenuti da BroadWorks, questa opzione di provisioning crea account Webex ma non può attivarli fino a quando gli abbonati non forniscono e convalidano i relativi indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Self-provisioning utente
Con questa opzione, non è disponibile il provisioning flowthrough da BroadWorks a Webex. Una volta configurata l'integrazione tra Webex e il sistema BroadWorks, vengono visualizzati uno o più collegamenti specifici per il provisioning degli utenti all'interno dell'organizzazione partner Webex per Cisco BroadWorks.
Successivamente, si progettano le proprie comunicazioni (o si delegano ai clienti) per distribuire il collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account vengono predisposti nell'ambito dell'organizzazione partner, puoi regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare tale operazione.
Gli utenti devono esistere nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento. |
Provisioning provider di servizi per API
Webex presenta un set di API pubbliche che consentono di creare il provisioning utente/abbonato Webex per Cisco BroadWorks nel flusso di lavoro/negli strumenti di gestione utenti esistenti.
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti Webex per Cisco Broadworks di comporre altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella rubrica Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo dell'estensione di tutte le aree del metodo di avvio chiamata e del profilo dell'utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e gruppi diversi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due imprese che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Utenti Cisco BroadWorks
Provisioning API pubblica come 'interno
Il parametro dell'interno deve essere esplicitamente passato come parte della chiamata API. Per le imprese/gruppi con Location Dialing Code (LDC) configurato, il parametro dell'interno dovrebbe essere la combinazione di LDC e 'numero di interno.
Provisioning flusso o auto-attivazione
Estensione e LDC (se applicabile) saranno automaticamente recuperati da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione di codice di chiamata posizione (LDC) e numero di interno.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'interno |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'estensione deve essere passata come parametro |
Attraverso il flusso | Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Elenchi telefonici BroadWorks | Elenchi telefonici aziendali, di gruppo o personali | Sincronizzazione rubriche | Non applicabile |
Prerequisiti
La versione del client richiesta per supportare questa funzione è 42.11 o successiva.
Patch in cui i codici di chiamata di estensione e posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
AP.platform.23.0.1075.ap380045
AP.as.23.0.1075.ap380045
AP.xsp.23.0.1075.ap380045
AP.as.24.0.944.ap380045
Abilitare l'intestazione X-BroadWorks-Remote-Party-Info su AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP richiesto per il supporto della funzione di composizione dell'interno.
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata a interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità delle chiamate di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'estensione come seconda opzione in Partner Hub e Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con estensione attraverso uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione dell'interno sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Non verrà visualizzata un'estensione nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere visibile l'opzione di chiamata dell'interno per i clienti esistenti:
Se un partner desidera che tutte le organizzazioni dei clienti gestite siano dotate di un interno come una delle opzioni di chiamata, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
Se un partner desidera fornire un interno in opzioni di chiamata per una specifica organizzazione cliente, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e portarli alla pari con l'aumento di 30K contatti per l'elenco telefonico Enterprise, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per Organizzazione, che si applica alla somma degli elenchi telefonici Enterprise e Group in una singola azienda BroadWorks. Ad esempio, sarà supportato un'azienda BroadWorks che dispone di un elenco di telefoni aziendali con 30K e anche di 5 elenchi di telefoni di gruppo ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K totali).
Questa funzione è disponibile su richiesta. Contatta il team dell'account per abilitare questa opzione.
|
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks nello storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare a quale gruppo appartiene questo utente. L'associazione dell'utente con un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca dei contatti nello storage del gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning degli abbonati Webex per BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
È possibile eseguire il provisioning dell'ID gruppo aziendale BroadWorks per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Webex per gli utenti Cisco BroadWorks
Provisioning API pubblica come "spEnterpriseGroupId"
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
Provisioning flusso o auto-attivazione
L'ID gruppo aziendale BroadWorks verrà automaticamente recuperato da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Non applicabile. Non è necessario sincronizzare l'ID gruppo aziendale BroadWorks per questi utenti.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'ID gruppo aziendale BroadWorks deve essere superato come parametro spEnterpriseGroupId |
Attraverso il flusso | L'ID gruppo aziendale BroadWorks viene recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Non applicabile |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Non applicabile |
Elenchi telefonici BroadWorks | Contatti negli elenchi telefonici del gruppo BroadWorks | Sincronizzazione rubriche | I contatti di gruppo vengono memorizzati nel servizio Webex Contact associato al gruppo specifico |
Elenchi di telefoni BroadWorks Enterpsie o Persional | Contatti negli elenchi telefonici aziendali o personali | Sincronizzazione rubriche | Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. Impossibile completare la migrazione fino a quando QUESTA API non viene completata. L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march Una volta abilitata la funzione e a seguito della sincronizzazione della rubrica successiva, i gruppi di utenti aziendali verranno visualizzati anche in Control Hub. La visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativa in questa fase. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza a un gruppo in Control Hub poiché tali modifiche non verranno riportate nuovamente in BroadWorks. La gestione di gruppo in Control Hub è destinata all'uso da parte dei partner che adotteranno le prossime API di gestione contatti. |
Migrazione e prova del futuro
La progressione Cisco del client di comunicazione unificata BroadSoft deve spostarsi da UC-One a Webex. Si verifica una corrispondente progressione dei servizi di supporto dalla rete del provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che tu stia eseguendo UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita consiste nel distribuire nuovi ADP|XSP dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti in Webex e infine recuperare l'infrastruttura utilizzata per la soluzione precedente.
Sottoscrizioni di documenti consigliate
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Abbonati che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di eseguire l'abbonamento a ciascuno dei seguenti articoli per assicurarsi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per iscriversi, accedere a ciascuno dei link seguenti e nell'articolo che viene visualizzato fare clic sul pulsante Iscriviti.
Come minimo, si consiglia di iscriversi all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati in Documenti aggiuntivi dispone di un'opzione Sottoscrivi . Affinché questa opzione venga visualizzata, l'articolo deve essere visualizzato su help.webex.com.
Non esiste un'opzione di abbonamento per le landing page di documentazione. |
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Documenti Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
Porta la tua soluzione PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono di loro proprietà (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive come eseguire l'onboarding e il servizio dei dispositivi Room OS e MPP.
Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi di Webex per Cisco BroadWorks.
Articoli Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti siti opzionali per ulteriori informazioni su Webex per Cisco BroadWorks:
Documentazione Webex per Cisco BroadWorks: nella pagina di destinazione vengono elencati i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme a quelle presto disponibili.
Problemi noti e limitazioni: informazioni sui problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale: questo articolo descrive come assegnare i ruoli amministratore partner per le organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte della soluzione Cisco BroadWorks:
Articoli della Guida Webex
I seguenti siti della Guida Webex possono essere utilizzati per trovare gli articoli Webex che consentono agli amministratori dei clienti e agli utenti finali di utilizzare le funzioni Webex.
Webex da provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati comunemente per gli utenti dell'app Webex che hanno acquistato i servizi Webex da un provider di servizi.
Centro assistenza Webex: utilizzare la funzione di ricerca su help.webex.com per cercare altri articoli Webex che descrivono la funzionalità dell'app Webex e di Webex Meetings. È possibile ricercare gli articoli utente o amministratore.
Documentazione sviluppatore
Guida per sviluppatori Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Punti di decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastrutture
|
Quanti ADP XSP|? Come prendono l'mTLS? |
Pianificatore capacità di sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento CLI XSP|ADP Il presente documento |
Provisioning cliente e utente | Puoi affermare che ti fidi dei messaggi e-mail in BroadWorks? Vuoi che gli utenti forniscano indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Documenti API pubbliche su https://developer.webex.com Il presente documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo di branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso per i clienti? | Il presente documento |
Funzioni abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o Softphone. | Il presente documento Matrice caratteristiche/pacchetto |
autenticazione protetta | BroadWorks o Webex | Il presente documento |
Adattatore di provisioning (per opzioni di provisioning flowthrough) | Utilizzate già IM&P integrato, ad esempio per UC-One SaaS? Si desidera utilizzare più modelli? È previsto un caso d'uso più comune? |
Il presente documento Riferimento CLI server applicazioni |
Architettura e infrastrutture
Con che tipo di scala intende iniziare? È possibile scalare in futuro, ma la stima di utilizzo attuale dovrebbe guidare la pianificazione dell'infrastruttura.
Collaborare con il proprio account manager/rappresentante di vendita Cisco per dimensionare l'infrastruttura ADP XSP|, in base al Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
In che modo Webex renderà le connessioni TLS reciproche alle tue ADP XSP|? Direttamente a XSP|ADP in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce. (Non supportiamo connessioni TCP non crittografate al perimetro della rete).
Provisioning cliente e utente
Quale metodo di provisioning utente si adatta meglio?
Provisioning eseguibile con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene predisposto automaticamente in Webex.
Se puoi anche affermare che gli indirizzi e-mail dell'abbonato in BroadWorks sono validi e univoci per Webex, puoi utilizzare la variante "email attendibili" del provisioning flowthrough. Gli account Webex abbonati vengono creati e attivati senza il loro intervento; scaricano semplicemente il client e accedono.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto, il provider di servizi deve fornire un indirizzo e-mail valido all'utente per eseguire il provisioning dei servizi Webex. Questo deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo anche nell'attributo ID alternativo.
Provisioning eseguibile senza e-mail attendibili: Se non riesci a fidarti degli indirizzi e-mail degli abbonati, puoi comunque assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
Self-provisioning utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. Tu (o i tuoi clienti) distribuisci invece un collegamento di provisioning e i collegamenti per scaricare i diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare gli account Webex. Quindi, scaricano il client e accedono e Webex recupera una configurazione aggiuntiva su di essi da BroadWorks (inclusi i numeri principali).
Provisioning controllato da SP tramite API: Webex espone una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei propri flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti di sistema generali descritti in questa guida.
Metodo di provisioning | Requisiti |
---|---|
Provisioning del flusso (e-mail attendibili o non attendibili) | L'API di provisioning Webex aggiunge automaticamente gli utenti BroadWorks esistenti a Webex una volta che l'utente soddisfa i requisiti e si attiva il servizio Integrated IM+P. Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Self-provisioning utente | L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato il messaggio e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) | Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono previsti due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, vai a Utenti BroadWorks. |
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Impostazioni internazionali lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente di amministrazione con provisioning viene assegnata automaticamente come locale predefinita per l'organizzazione del cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti a riunioni all'interno dell'organizzazione del cliente.
Sono supportate le impostazioni internazionali in lingua a cinque caratteri (ISO-639-1)_(ISO-3166). Ad esempio, en_US corrisponde a English_UnitedStates. Se viene richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genera un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso internazionale dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, viene utilizzata l'impostazione locale ragionevole predefinita in base al codice della lingua richiesto.
Nella tabella riportata di seguito vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice lingua a due lettere in un'impostazione locale a cinque caratteri per le situazioni in cui un'impostazione locale a cinque caratteri non è disponibile.
Impostazioni internazionali lingua supportate (ISO-639-1)_(ISO-3166) | Se è disponibile solo un codice lingua a due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** | Usa impostazioni internazionali sensibili di default (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA | en en | en_USA |
fr_Fr fr_CA | Fr | fr_Fr |
cs_CZ | cs | cs_CZ |
da_DK | da | da_DK |
de_DE | DE | de_DE |
hu_HU | hu | hu_HU |
id_ID | ID | id_ID |
it_IT | IT | it_IT |
ja_JP | ja | ja_JP |
ko_KR | ko | ko_KR |
es_ES es_CO es_MX | ES | es_ES |
nl_NL | NL | nl_NL |
nb_NO | nb. | nb_NO |
pl_PL. | pl. | pl_PL. |
pt_PT pt_BR | pt | pt_PT |
ru_RU | RU | ru_RU |
ro_RO | ro | ro_RO |
zh_CN zh_TW | zh | zh_CN |
sv_SE | sv | sv_SE |
ar_SA | ar | ar_SA |
tr_TR | tr | tr_TR |
Le impostazioni internazionali es_CO, id_ID, nb_NO e pt_PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti Webex Meetings saranno solo in inglese. Inglese è la impostazioni internazionali predefinite per i siti se per il sito non sono richieste impostazioni internazionali non valide/non supportate. Questo campo lingua è applicabile durante la creazione di un'organizzazione e un sito Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, la lingua del modello verrà utilizzata come lingua predefinita. |
Branding
Gli amministratori partner possono utilizzare le personalizzazioni avanzate del branding per personalizzare l'aspetto dell'app Webex per le organizzazioni di clienti gestite dal partner. Gli amministratori partner possono personalizzare le seguenti impostazioni per garantire che l'app Webex rifletta il marchio e l'identità della società:
Loghi aziendali
Combinazioni di colori univoche per la modalità Chiaro o Scuro
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione delle personalizzazioni di branding avanzate.
|
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding come richiesto, ma quando si esegue l'onboarding di un cliente è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Alcuni parametri del modello principale sono elencati di seguito.
Pacchetto
È necessario selezionare un pacchetto predefinito quando si crea un modello (vedere Pacchetti nella sezione Panoramica per dettagli). Tutti gli utenti predisposti con tale modello, tramite flowthrough o self-provisioning, ricevono il pacchetto predefinito.
È possibile controllare la selezione dei pacchetti per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno di essi. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori di provisioning per azienda, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
È possibile modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedere Webex per la documentazione API Cisco BroadWorks o attraverso Partner Hub (vedere Modifica pacchetto utente in Partner Hub).
Non puoi modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è attivata o disattivata; se all'abbonato viene assegnato questo servizio in BroadWorks, il modello Partner Hub associato all'URL di provisioning aziendale di tale abbonato definisce il pacchetto.
Rivenditore e aziende o fornitore di servizi e gruppi?
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se sei un rivenditore con Enterprise, devi abilitare la modalità Enterprise quando crei un modello.
Se il sistema BroadWorks è configurato in modalità provider di servizi, è possibile lasciare disattivata la modalità Enterprise nei modelli.
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch BroadWorks richieste per il provisioning flow-through. Per ulteriori dettagli, vedere Patch richieste con provisioning flow-through. |
Modalità di autenticazione
Decidi come desideri che gli abbonati eseguano l'autenticazione quando accedono a Webex. È possibile assegnare la modalità utilizzando l'impostazione Modalità di autenticazione nel modello di onboarding. Nella tabella seguente sono riportate alcune opzioni.
Questa impostazione non ha effetto sull'accesso al portale di attivazione utente. Gli utenti che accedono al portale devono immettere l'ID utente e la password BroadWorks, come configurati su BroadWorks, indipendentemente da come si configura la modalità di autenticazione nel modello di onboarding. |
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | ID utente BroadWorks | Indirizzo e-mail |
Provider identità | BroadWorks.
| Identità comune Cisco |
Autenticazione a più fattori? | No | Richiede IdP del cliente che supporta l'autenticazione a più fattori. |
Percorso di convalida delle credenziali
|
|
|
Per una ripartizione più dettagliata del flusso di accesso SSO con autenticazione diretta a BroadWorks, vedere Flusso di accesso SSO. |
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che si può verificare con password che utilizzano caratteri speciali per cui il browser Web non codifica correttamente i caratteri. Utilizzando un'intestazione con codifica UTF-8, con codifica base 64, risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
Paese
Quando si crea un modello, è necessario selezionare un paese. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie S. | Posizione | Prefisso internazionale | Nome paese |
---|---|---|---|
1 | AMER | +1 | NOI, CA |
2 | APAC | +65 | Singapore |
3 | ANZ | +61 | Australia |
4 | EMEA | +44 | Regno Unito |
5 | EURO | +49 | Germania |
Accordi con più partner
Vuoi concedere in sublicenza Webex per Cisco BroadWorks a un altro provider di servizi? In questo caso, ciascun provider di servizi avrà bisogno di un'organizzazione partner distinta in Webex Control Hub per consentire loro di fornire la soluzione per la propria base clienti.
Adattatore di provisioning e modelli
Quando si utilizza il provisioning flowthrough, l'URL di provisioning inserito in BroadWorks viene derivato dal modello in Control Hub. È possibile disporre di più modelli e quindi di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati al momento della concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e quale modello si desidera utilizzare a tale scopo. In questo modo, è necessario impostare esplicitamente l'URL di provisioning per le aziende che necessitano di un modello diverso.
Inoltre, tenere presente che è possibile che si stia già utilizzando un URL di provisioning a livello di sistema, ad esempio con UC-One SaaS. In tal caso, è possibile scegliere di mantenere l'URL a livello di sistema per il provisioning degli utenti su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono dettagliate in Configura server applicazioni con URL servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning flowthrough tra AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server AS e Webex, annullando in tal modo la necessità di connettersi direttamente al servizio Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati che si sta eseguendo il provisioning per Webex devono esistere nel sistema BroadWorks integrato con Webex. È possibile integrare più sistemi BroadWorks, se necessario.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero o interno principale.
Webex utilizza gli indirizzi e-mail come identificatori principali per tutti gli utenti. Se si utilizza il provisioning flowthrough con e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail degli abbonati nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo di utenti di chiamata BroadWorks con un numero principale e/o interno. Se si utilizza il provisioning flowthrough, agli utenti deve essere assegnato anche il servizio IM&P integrato. |
Server nella rete e requisiti software
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Le istanze BroadWorks devono includere almeno i seguenti server:
Server applicazioni (AS) con versione BroadWorks come sopra
Server di rete (NS)
Server profilo (PS)
Server XSP|ADP o piattaforma di distribuzione delle applicazioni (ADP) di fronte al pubblico che soddisfano i seguenti requisiti:
Servizio di autenticazione (BWAuth)
Interfacce azioni ed eventi XSI
DMS (applicazione Web di gestione dispositivi)
Interfaccia CTI (Intergrazione Di Telefonia Informatica)
TLS 1.2 con certificato valido (non autofirmato) e qualsiasi intermediazione richiesta. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
Autenticazione Mutual TLS (mTLS) per il servizio di autenticazione (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Autenticazione Mutual TLS (mTLS) per l'interfaccia CTI (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Un server XSP/ADP separato che agisce come "Call Notifications Push Server" (un NPS nel tuo ambiente utilizzato per le notifiche di chiamata push per Apple/Google. Lo chiamiamo "CNPS" qui per distinguerlo dal servizio in Webex che fornisce notifiche push per messaggi e presenza).
Questo server deve essere su R22 o versione successiva.
Viene richiesto un server XSP/ADP separato per CNPS poiché l'imprevedibilità del carico da Webex per le connessioni cloud BWKS potrebbe influire negativamente sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSPADP, consultare la Guida tecnica di sistema Cisco BroadWorks|.
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, andare a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
PC/laptop Windows
PC/laptop Apple con MacOS
iOS (Apple Store)
Android (Play store)
Browser Web (vai a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (tradizionale cinese)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (italiano)
Telefoni e accessori fisici
Telefoni IP Cisco:
telefono IP Cisco serie 6800 con firmware multipiattaforma
telefono IP Cisco serie 7800 con firmware multipiattaforma
telefono IP Cisco serie 8800 con firmware multipiattaforma
Vedere https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html per i modelli e ulteriori informazioni.
I telefoni di terze parti sono supportati allo stesso modo di altre integrazioni BroadWorks. Tuttavia, non dispongono ancora dell'integrazione di contatti e presenza con Webex per Cisco BroadWorks.
Adattatori:
Adattatore per telefono analogico multipiattaforma Cisco ATA 191
Adattatore per telefono analogico multipiattaforma Cisco ATA 192
Vedere https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html per i modelli e ulteriori informazioni.
Cuffie:
cuffia Cisco serie 500
Vedi https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html per i modelli e ulteriori informazioni.
Dispositivi Room OS:
Serie Webex Room e Room Kit
Serie Webex Desk
Serie Webex Board
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e l'assistenza dei dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivo
Di seguito sono riportati i file DTAF che devi caricare sui server delle applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia c'è una nuova config-wxt.xml.template
file utilizzato per l'app Webex.
Per scaricare i profili dei dispositivi più recenti, andare al sito di Download software della piattaforma di consegna delle applicazioni per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che per XSP.
Nome del cliente | Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Comunicatore aziendale - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili del dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Genera una richiesta di servizio con l'agente di onboarding o con Cisco TAC per eseguire il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il titolo della richiesta per le rispettive funzioni:
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
'NPS Configuration for Auth Proxy Setup' (Configurazione NPS per impostazione proxy automatica) per configurare NPS per l'uso del proxy di autenticazione.
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori informazioni su questa funzione, vedere: Supporto di Cisco BroadWorks per CI UUID.
Configura BroadWorks per abilitare la fatturazione Cisco per BroadWorks e Webex Per abbonamenti BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento valido per 60 giorni. Se il token scade prima di utilizzarlo, è possibile presentare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali. |
Certificati ordine
Requisiti di certificato per l'autenticazione TLS
Per tutte le applicazioni richieste, saranno necessari i certificati di sicurezza, firmati da un'autorità di certificazione ben nota e distribuiti su ADP XSP|pubblico. Verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in entrata ai server XSP|ADP.
Questi certificati devono includere il nome di dominio pubblico XSP|ADP completo come Nome comune oggetto o Nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati del server dipendono da come vengono distribuiti gli ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume dove il certificato del server pubblico firmato da CA deve essere caricato in questi tre casi:
Le autorità di certificazione supportate pubblicamente dall'app Webex per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per proxy bridge TLS
Il certificato del server firmato pubblicamente viene caricato nel proxy.
Il proxy presenta questo certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Un certificato firmato CA interno può essere caricato su XSP|ADP.
L'|ADP XSP presenta questo certificato del server firmato internamente al proxy.
Il proxy si basa sulla CA interna che ha firmato il certificato del server XSP|ADP.
Requisiti di certificato TLS per proxy passthrough TLS o XSP|ADP in DMZ
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
Gli ADP XSP|presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca sull'interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione Mutual TLS. Il certificato CA/catena del certificato del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedi a Partner Hub, vai a
e fai clic sul collegamento del certificato di download.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume i requisiti del certificato in questi tre casi:
Requisiti del certificato (opzione) per proxy bridge TLS
Webex presenta un certificato client firmato pubblicamente al proxy.
Il proxy considera attendibile la CA interna di Cisco che ha firmato il certificato del client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta il certificato del server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions: X509v3 Extended Key Usage: 1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Il CN del certificato interno deve essere
bwcticlient.webex.com
.
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le autorità pubbliche di certificazione potrebbero non essere disposte a firmare i certificati con l'OIDE proprietario di BroadWorks richiesto. In caso di proxy di bridging, è possibile che sia necessario utilizzare una CA interna per firmare il certificato del client che il proxy presenta all'ADP XSP|.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Il ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XSP| dal proxy.
Requisiti di certificato (opzione) per proxy passthrough TLS o XSP|ADP in DMZ
Webex presenta un certificato client firmato da CA Cisco interno alle ADP XSP|.
Gli ADP XSP|si fidano delle autorità di certificazione interne di Cisco che hanno firmato il certificato client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XSP|.
Gli ADP XSP|presentano i certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Il server applicazioni ClientIdentity contiene il CN del certificato del client firmato Cisco presentato a XSP|ADP da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene l'elenco di indirizzi IP, porte e protocolli richiesti per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle dei firewall delle regole di ingresso e uscita precedenti documentano solo le connessioni specifiche di Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico per Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e la rilevanza di ciascuna sezione per Webex per Cisco BroadWorks.
Sezione Requisiti di Rete Art. | Rilevanza delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex | Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud | Informativo |
Da leggere | |
Da leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex | Da leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione | Opzionale |
Servizi Webex per clienti FedRAMP | N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedi il whitepaper del firewall dell'app Webex (PDF).
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza XSP|ADP di Broadworks fornita dal partner. Quando un ADP o un sito XSP|non è disponibile per manutenzione pianificata o motivo non pianificato, i servizi e le app Webex possono passare a un altro ADP o sito XSP|fornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP Broadworks XSP|possono essere distribuiti direttamente su Internet o possono risiedere in un DMZ frontale da un elemento di bilanciamento del carico come F5 BIG-IP. Per fornire ridondanza geografica, gli ADP XSP|possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un bilanciatore di carico, ognuno con un indirizzo IP pubblico. Se gli ADP XSP| sono dietro a un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e Broadworks sembra avere solo un XSP|ADP, anche se vi sono più ADP XSP| dietro.
Nell'esempio seguente, le ADP|XSP vengono distribuite in due siti, il Sito A e il Sito B. Esistono due ADP|XSP frontali di un bilanciatore di carico in ogni sito. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali di LB1 e il sito B ha XSP|ADP3 e XSP|ADP4 frontali di LB2. Solo i bilanciatori di carico sono esposti sulla rete pubblica e le ADP|XSP sono nelle reti private DMZ.
Servizi cloud Webex
Configurazione DNS
I microservizi cloud Webex devono essere in grado di trovare il server|ADP Broadworks XSP per la connessione alle interfacce Xsi, al servizio di autenticazione e al CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host XSP|ADP configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso. Se vengono restituiti più indirizzi IP, viene selezionato il primo IP nell'elenco. La ricerca SRV non è attualmente supportata.
Esempio: Il DNS A Record del partner per la scoperta del server XSP|ADP/Load Balancers bilanciato Round-Robin.
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Punti a LB1 (Sito A) |
R |
|
| Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Failover
Quando i microservizi Webex inviano una richiesta al servizio |di bilanciamento del carico/ADP XSP e la richiesta non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se non viene ricevuta alcuna risposta HTTP entro 2 secondi, la richiesta viene timeout e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento dell'indirizzamento all'IP successivo.
Ciascuna richiesta viene provata 3 volte prima di segnalare un errore al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco degli indirizzi da provare quando si invia una richiesta a un XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna nell'elenco per provare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco bloccato. Se l'operazione va a buon fine, tale indirizzo IP viene rimosso dall'elenco bloccato.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP|XSP o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster BroadWorks Calling, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
Azioni XSI
Eventi XSI
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Gli stati delle connessioni possono essere:
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
Rosso: Quando tutti gli IP nella ricerca di record sono irraggiungibili e l'interfaccia non è disponibile.
I seguenti servizi utilizzano i microservizi per connettersi agli XSP|ADP e sono interessati dalla disponibilità dell'interfaccia XSP|ADP:
Accesso all'app Webex
Aggiornamento token app Webex
E-mail/autoattivazione non attendibile
Controllo stato servizio Broadworks
App Webex
Configurazione DNS
L'app Webex accede ai servizi Xtended Services Interface (XSI-Actions & XSI-Events) e Device Management Service (DMS) su XSP|ADP.
Per trovare il servizio XSI, l'app Webex esegue la ricerca DNS SRV per _xsi-client._tcp.<webex app xsi domain>
. L'SRV punta all'URL configurato per gli host XSP|ADP o i bilanciatori di carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex torna alla ricerca A/AAAA.
L'SRV può risolversi in più target A/AAAA. Tuttavia, ogni record A/AAAA deve mappare solo a un singolo indirizzo IP. Se sono presenti più ADP|XSP in un DMZ dietro il dispositivo di bilanciamento del carico/bordo, è necessario che il bilanciatore di carico sia configurato per mantenere la persistenza della sessione in modo da indirizzare tutte le richieste della stessa sessione allo stesso XSP|ADP. Questa configurazione viene avviata perché i heartbeat dell'evento XSI del client devono andare allo stesso XSP|ADP utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non deve esistere. Se il DNS richiede che un record A/AAAA deve essere definito, allora deve essere restituito solo 1 indirizzo IP. Indipendentemente da ciò, l'SRV deve essere ancora definito per l'app Webex. Se l'app Webex utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client alla fine invia heartbeat a un XSP|ADP dove non ha stabilito un canale per eventi. Di conseguenza, il canale viene strappato e il traffico interno è notevolmente più intenso, il che pregiudica le prestazioni del cluster ADP|XSP. Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca di record A/AAAA, è necessario utilizzare un nome di dominio completo separato per Webex Cloud e l'app Webex per accedere agli ADP|XSP. Come mostrato negli esempi, Webex Cloud utilizza Un record |
Esempio 1: ADP|XSP multipli, ciascuno dietro bilanciatori di carico separati
In questo esempio, SRV punta a disattivare l'audio dei record A con ogni record A che punta a un bilanciatore di carico diverso su un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito un esempio di record SRV.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Esempio 2: più amministratori XSP| dietro un singolo bilanciatore di carico (con bridge TLS)
Per la richiesta iniziale, il bilanciatore di carico seleziona un XSP|ADP casuale. XSP|ADP restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il bilanciatore di carico utilizza il cookie per indirizzare la connessione all'ADP XSP|corretto, assicurandosi che il canale dell'evento non si interrompa.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Bilanciatore di carico |
R | LB.esempio.com |
| Indirizzo IP del bilanciatore di carico (XSP|ADP sono dietro al bilanciatore di carico) |
URL DMS
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il file di configurazione. Viene eseguita l'analisi dell'organizzatore nell'URL e l'app Webex esegue la ricerca DNS A/AAAA dell'organizzatore per connettersi all'ADP XSP|che ospita il servizio DMS.
Esempio: DNS Un record per la scoperta di Round-Robin bilanciato server XSP|ADP/Bilanciamento del carico di Webex App per scaricare i file di configurazione tramite DMS:
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Come l'app Webex trova gli indirizzi XSP|ADP
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (sono stati inseriti quando si crea il cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue la ricerca SRV nel modo seguente:
Il cliente esegue una ricerca SRV per _xsi-cliente._tcp.<xsi domain="">
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
Il cliente cerca gli obiettivi A/AAAA e memorizza nella cache gli indirizzi IP restituiti.
Il client si connette a uno dei target (e quindi al suo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi al peso (o a caso se sono tutti uguali).
Se la ricerca SRV non restituisce alcun obiettivo:
Il client esegue una ricerca A/AAAA del parametro principale Xsi e quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso.
Come indicato, il record A/AAAA deve risolversi in un indirizzo IP per le stesse ragioni.
(Opzionale) Successivamente, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocols> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
Se esistono, il client confronterà l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
Se viene rilevata una differenza, il client re-inizializzerà la connettività XSI Actions/XSI Events. La prima fase consiste nell'eseguire lo stesso processo di ricerca DNS elencato nella fase 1, richiedendo questa volta una ricerca del valore nel %XSI_ROOT_WXT% parametro dal file di configurazione.
Assicurarsi di creare i record SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
Failover
Durante l'accesso, l'app Webex esegue una ricerca DNS SRV per _xsi-client._tcp.<xsi domain="">, crea un elenco di organizzatori e si connette a uno degli organizzatori in base alla priorità SRV, quindi al peso. Questo organizzatore connesso diventa quello selezionato per tutte le richieste future. Viene quindi aperto un canale evento all'organizzatore selezionato e viene inviato regolarmente un heartbeat per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP, pertanto è importante che il bilanciatore di carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server XSP|ADP di backend.
Se una richiesta o una richiesta heartbeat a un organizzatore non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), l'indirizzamento dell'app Webex viene eseguito immediatamente all'organizzatore successivo nell'elenco.
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e l'indirizzamento passa all'organizzatore successivo nell'elenco.
Se una risposta non viene ricevuta entro un periodo di tempo, la richiesta viene considerata non riuscita a causa del timeout e le richieste successive vengono inviate al successivo organizzatore. Tuttavia, la richiesta scaduta viene considerata come non riuscita. Alcune richieste vengono riprovate dopo l'errore (con un tempo di riprova crescente). Le richieste che il presunto non vitale non sono riprovate.
Quando un nuovo organizzatore viene provato correttamente, diventa il nuovo organizzatore selezionato se l'organizzatore è presente nell'elenco. Una volta provato l'ultimo organizzatore nell'elenco, l'app Webex passa al primo.
In caso di heartbeat, se si verificano due errori di richiesta consecutivi, l'app Webex re-inizializzerà il canale eventi.
Tenere presente che l'app Webex non esegue il failback e che il rilevamento del servizio DNS viene eseguito solo una volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione attraverso l'interfaccia XSP|ADP/Dms. Esegue una ricerca di record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Innanzitutto, tenterà di inviare la richiesta per scaricare il file di configurazione utilizzando un token SSO. Se ciò non riesce per qualsiasi motivo, verrà riprovato ma con il nome utente e la password del dispositivo.
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning dell'utente. Molte delle attività sono comuni a tutte le modalità di provisioning.
Onboarding dei partner per Webex per Cisco BroadWorks
Ciascun provider o rivenditore di servizi Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, è necessario eseguire la documentazione Cisco BroadWorks di Webex e i nuovi partner devono accettare l'ICPA (Indirect Channel Partner Agreement) online. Al termine di queste operazioni, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, il tuo Partner Activation e/o Customer Success Program Manager ti contatterà per iniziare il tuo onboarding.
I partner Webex in una regione possono creare organizzazioni di clienti in qualsiasi regione in cui offriamo i servizi. Per informazioni, vedere: Residenza dati in Webex. |
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
È necessario eseguire l'applicazione NPS su un altro XSP|ADP. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi sugli ADP XSP|.
Servizio/Applicazione | Autenticazione richiesta | Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
autenticazione protetta |
Integrazione telefonia computer |
mTLS (client e server si autenticano a vicenda) |
Presenza di telefonia |
Applicazione Webview Impostazioni chiamata |
TLS (il server esegue l'autenticazione per i client) |
Mostra le impostazioni di chiamata utente nel portale Assistenza utente all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma occorre fare riferimento alla documentazione esistente per installare le applicazioni sugli ADP|XSP.
Requisiti di coresidenza
Il servizio di autenticazione deve essere coresidente con le applicazioni Xsi, perché tali interfacce devono accettare token di lunga durata per l'autorizzazione del servizio. Il servizio di autenticazione è richiesto per convalidare tali token.
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
È possibile separare gli altri servizi/applicazioni come richiesto per la propria bilancia (gestione dispositivi dedicata XSP|ADP farm, ad esempio).
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
Non installare altre applicazioni o servizi sugli ADP XSP| utilizzati per integrare BroadWorks con Webex.
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se è in esecuzione R22 o versione superiore e il sistema lo supporta.
Mutual TLS (mTLS) è supportato anche come metodo di autenticazione alternativo per il servizio Auth. Se più organizzazioni Webex eseguono lo stesso server ADP XSP|, è necessario utilizzare l'autenticazione mTLS poiché la convalida token CI non supporta più connessioni allo stesso servizio autenticazione ADP XSP|. Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida del token CI, fare riferimento all'Appendice per configurare i servizi (con mTLS per il servizio di autenticazione). |
Se attualmente si utilizza mTLS per il servizio autenticazione, non è obbligatorio riconfigurare l'uso della convalida token CI con TLS. |
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks.
Installare le seguenti patch su ciascun server ADP XSP|. Installare le patch appropriate alla release in uso:
Per R22:
Per R23:
Per R24: non è necessario alcun cerotto
Qualsiasi riferimento a XSP include XSP o ADP.Installare il
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP al percorso del contesto /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire il servizio di autenticazione su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
A partire da Broadworks build 2022.10, le autorità di certificazione in arrivo con Java non vengono più automaticamente incluse nel trust store BroadWorks quando si passa a una nuova versione di java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
Radice commerciale IdenTrust CA 1
autorità di certificazione radice Go Daddy - G2
Verificare che questi certificati siano presenti sotto la seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get
Se non presente, eseguire il seguente comando per importare i trust Java predefiniti:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come ancoraggi attendibili con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono automaticamente importate nella nuova release e continueranno a essere importate finché non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere la FD di convalida del certificato Cisco Broadworks X509.
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server ADP XSP|:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get
set clientId client-Id-From-Step1
set enabled true
set clientSecret client-Secret-From-Step1
set ciResponseBodyMaxSizeInBytes 65536
set issuerName <URL>
- Per ilURL
, immettere l'URL IssuerName che si applica al cluster CI. Vedere la tabella seguente.set issuerUrl <URL>
- Per ilURL
, immettere l'IssuerUrl che si applica al cluster CI. Vedere la tabella seguente.set tokenInfoUrl <IdPProxy URL>
—Inserire l'URL proxy IdP applicabile al cluster dei team. Si veda la seconda tabella che segue.
Tabella 1. Imposta nome emittente e URL emittente Se il cluster CI è... Imposta issuerName e issuerURL su... NOI-A
UE
NOI-B
Se non conosci il tuo cluster CI, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.Tabella 2. Imposta tokenInfoURL Se il cluster di Teams è... Imposta tokenInfoURL su...(URL proxy IdP) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AFRA
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
DOLORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.
Per il test, è possibile verificare che il tokenInfoURL sia valido sostituendo "
idp/authenticate
" parte dell'URL con "ping
".
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user
Configurare i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get
set flsUrl https://cifls.webex.com/federation
set refreshPeriodInMinutes 60
set refreshToken refresh-Token-From-Step1
Eseguire il seguente comando per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get
Configurare la gestione dei token utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
set tokenIssuer BroadWorks
set tokenDurationInHours 720
Genera e condividi chiavi RSA. È necessario generare chiavi su un XSP|ADP, quindi copiarle su tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP.Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web. Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token. Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Rimozione dei requisiti di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con la convalida del token CI su R24, è necessario rimuovere anche il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Interfaccia CTI e configurazione correlata
Di seguito viene elencato l'ordine di configurazione "da più a più". In seguito a questo ordine non è obbligatorio.
Configurazione del server di applicazione per gli abbonamenti CTI
Configurazione di XSP|ADPs per abbonamenti CTI autenticati mTLS
Apertura delle porte in entrata per l'interfaccia CTI protetta
Abbonamento dell'organizzazione Webex agli eventi CTI di BroadWorks
Configurazione del server di applicazione per gli abbonamenti CTI
Aggiornare ClientIdentity su Application Server con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ciascun server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è |
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocol> |
Una specifica interfaccia CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocol> |
Su una nuova installazione, le seguenti crittografie sono installate per impostazione predefinita a livello di sistema. Se non è configurato nulla a livello di interfaccia (ad esempio, nell'interfaccia CTI o HTTP), si applica questo elenco di crittografia. Si noti che questo elenco può cambiare nel tempo:
|
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp>
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
Inserisci il
get
comando per visualizzare le crittografie già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, si utilizzerebbe:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Ancoraggi affidabili per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che le ADP XSP|siano rivolte verso Internet o rivolte verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy bridge (vedere Requisiti del certificato TLS per proxy bridge TLS).
Per ogni amministratore XSP|nell'infrastruttura che pubblica eventi CTI in Webex, effettuare le seguenti operazioni:
Accedere a Hub partner .
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.
Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
(Opzionale) Esecuzione
help updateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot2023
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
Consenti ai client di autenticarsi con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione BroadWorks in uso. Il comando crea un certificato server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. È necessario l'indirizzo IP dell'interfaccia CTI per questo; è possibile leggerlo dal seguente contesto:
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>
Riavviare XSP|ADP.
Abilitazione dell'accesso a BroadWorks CTI Events su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
Specificare l'indirizzo CTI in base al quale Webex può iscriversi a CTI Events di BroadWorks.
Gli abbonamenti CTI sono su base per abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato viene predisposto per Webex per Cisco BroadWorks.
Visualizzazione Webview Impostazioni chiamata
Call Settings Webview (CSWV) è un'applicazione ospitata su XSP|ADP per consentire agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview per le impostazioni di chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono native dell'app Webex.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, è necessario distribuire la funzione Webview impostazioni chiamata.
La vista Webview impostazioni chiamata presenta due componenti:
Applicazione Webview Impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
App Webex, che esegue il rendering delle impostazioni di chiamata in una vista Webview.
Esperienza utente
Utenti Windows: Fai clic su Impostazioni chiamata, quindi su .
Utenti Mac: Fare clic sull'immagine del profilo, quindi
.
Distribuzione di CSWV su BroadWorks
Installazione di Webview impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso ADP|XSP che ospita l'interfaccia Xsi-Actions nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
Accedere a cisco.com e cercare "BWCallSettingsWeb" nella sezione download software.
Trovare e scaricare la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) è stata la più recente al momento della stesura del presente documento.Installare, attivare e distribuire l'archivio Web in base alla Guida alla configurazione della piattaforma di servizi Xtended di Cisco BroadWorks per la versione XSP|ADP. (Versione R24 https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
.Passare al seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più necessario).Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario fornire anche un contextPath perché è un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio
/callsettings
.Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
Ora è possibile prevedere l'URL delle impostazioni di chiamata che si specificherà per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
L'|ADP-FQDN XSP deve corrispondere al FQDN azioni Xsi, perché CSWV deve utilizzare le azioni Xsi e CORS non è supportato.
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview Impostazioni chiamata è ora attiva sugli ADP|XSP.
Configura l'app Webex per utilizzare Webview impostazioni chiamata
Per ulteriori dettagli sulla configurazione del client, vedere la Guida alla configurazione di Webex per Cisco BroadWorks.
Nel file di configurazione dell'app Webex è presente un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti attraverso l'interfaccia dell'applicazione.
<config>
<services>
<web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%">
<url>%WEB_CALL_SETTINGS_URL_WXT%</url>
</web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel %WEB_CALL_SETTINGS_URL_WXT% tag.
Se non si specifica esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
Imposta la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
Il file di configurazione client risultante dovrebbe avere una voce come segue:
<web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push delle chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Call Notifications Push Server (CNPS) per descrivere un'applicazione ospitata XSP o ospitata ADP che viene eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti e invia le notifiche a Google Firebase Cloud Messaging (FCM) o Apple Push Notification Service (APN).
Tali servizi notificano ai dispositivi mobili degli abbonati Webex per Cisco BroadWorks la presenza di chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzione Notification Push Server.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi a loro volta notificano agli utenti mobili Webex le modifiche ai messaggi in arrivo o alla presenza.
In questa sezione viene descritto come configurare l'NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se è necessario eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPShttps://help.webex.com/nl5rir2/. |
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario aggiornare il CNPS per supportare la funzione proxy NPS, server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server di notifica push per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e i tasti di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend di Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APN Apple e i servizi FCM Google.
La funzione migliora anche la capacità del server push delle notifiche di eseguire notifiche push ai dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
Per ulteriori informazioni, vedere Server push per VoIP nella descrizione della funzione UCaaS.
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software e le patch NPS, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Cercare e scaricare la patch dalla pagina di download del software.
Ulteriori informazioni sul server ADP sono disponibili su https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio Apple Push Notification dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per APN. Questo aggiornamento richiede che XSP|ADP che ospita l'NPS esegua R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 | Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma di consegna dell'applicazione (ADP). | ||
2 | Installare le patch proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: | ||
3 | Attivare l'applicazione Notification Push Server. | ||
4 | (Per le notifiche Android) Abilitare l'API FCM v1 sull'NPS.
| ||
5 | (Per le notifiche Apple iOS) Abilitare HTTP/2 su NPS.
| ||
6 | Collegare un supporto tecnico dell'NPS XSP/ADP. | ||
7 | Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN UN 10.193.78.149
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configura NPS per utilizzare il proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Migra NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un server NPS condiviso con altre app mobili, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPS ( https://help.webex.com/nl5rir2).
1 | Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 | Creare l'account cliente su NPS:
Per verificare che i valori inseriti corrispondano a quanto ricevuto, eseguire
| |||||||||||||||||||
3 | Immettere l'URL proxy NPS e impostare l'intervallo di aggiornamento del token (consigliato 30 minuti):
| |||||||||||||||||||
4 | (Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 | (Per le notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, assicurandosi di omettere il tasto Auth – impostarlo su vuoto.
| |||||||||||||||||||
6 | Configurare i seguenti URL NPS:
| |||||||||||||||||||
7 | Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 | Verificare se il server applicazioni sta eseguendo lo screening degli ID applicazione, poiché potrebbe essere necessario aggiungere le app Webex all'elenco utenti autorizzati: | |||||||||||||||||||
9 | Riavviare XSP|ADP: | |||||||||||||||||||
10 | Esegui test delle notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migrazione di NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente che è necessario eseguire la migrazione a FCMv1. Sono previste tre procedure:
Esegui migrazione dei client UC-One a FCMv1: quando disponi di client UCaaS esistenti e devi migrarli per utilizzare FCMv1.
Migrazione dei client SaaS a FCMv1: quando si dispone di client SaaS esistenti e occorre migrarli per utilizzare FCMv1.
Aggiorna server ADP: quando si esegue la migrazione di NPS a un server ADP.
Migrazione dei client UC-One a FCMv1
Utilizzare la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere . L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile Connect su https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al
|
Accedere a SDK amministratore FCM su http://console.firebase.google.com.
Selezionare l'applicazione Android appropriata.
Nella scheda General (Generale), registrare l’ID del progetto
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
Fare clic sul pulsante blu per creare un nuovo account di servizio
Fai clic sul pulsante blu per generare una nuova chiave privata
Chiave di download per una posizione sicura
Per riutilizzare un account servizio esistente:
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
Identificare l'account servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
Copiare il file json su XSP|ADP.
Configurare l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== my_project ********
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Migrazione dei clienti SaaS a FCMv1
Se si desidera eseguire la migrazione dei client SaaS a FCMv1, attenersi alla procedura seguente su Google FCM Console.
Assicurarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione". |
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Aggiorna server ADP
Se si esegue la migrazione dell'NPS per utilizzare un server ADP, utilizzare i passaggi seguenti nella console Google FCM.
Ottenere il file JSON dalla console cloud di Google:
Su Google Cloud Console, andare alla pagina Account servizio.
Fare clic su Seleziona un progetto, scegliere il progetto e fare clic su Apri.
Trova la riga dell'account servizio per la quale desideri creare una chiave, fai clic sul pulsante Altro verticale, quindi fai clic su Crea chiave.
Selezionare un tipo di chiave e fare clic su Crea
Il file viene scaricato.
Aggiungere FCM al server ADP:
Importare il file JSON nel server ADP utilizzando il
/bw/install
comando.Accedere all'ADP CLI e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON
:Quindi, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò avviene per i seguenti motivi:
Per consentire a Webex cloud di autenticare i tuoi utenti rispetto a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
Per consentire alle app Webex di utilizzare l'interfaccia Xsi per il controllo delle chiamate.
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se alcune interfacce non vengono convalidate correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide. Ciò viene impedito poiché un cluster configurato in modo errato potrebbe causare problemi che sono difficili da risolvere. |
Cosa è necessario fare:
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
Assegna un nome al cluster e fai clic su Avanti.
Il concetto di cluster qui è semplicemente una raccolta di interfacce, solitamente situate su un server ADP XSP| o in un'azienda agricola, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il sistema BroadWorks non sono applicabili qui.
(Opzionale) Immettere un Nome account utente e una Password BroadWorks noti all'interno del sistema BroadWorks che si connette a Webex, quindi fare clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
Aggiungere gli URL XSI Actions e XSI Events.
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
Opzionale. Selezionare la casella di controllo Abilita autenticazione diretta BroadWorks se si desidera che gli accessi a BroadWorks siano diretti a BroadWorks. In caso contrario, l'autenticazione per BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo influisce su queste situazioni di accesso:
Accesso al portale di attivazione utente: gli utenti devono immettere le credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o attraverso il proxy IdP.
Accesso client: se l'autenticazione BroadWorks è configurata nel modello di onboarding, l'impostazione precedente determina se l'accesso del client all'app Webex è diretto a BroadWorks o viene proxy attraverso il proxy IdP.
Fai clic su Avanti.
Nella pagina CTI Interface (Interfaccia CTI) procedere come segue:
Aggiungere l'URL CTI e la porta per l'interfaccia CTI a cui si desidera connettersi.
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
Opzionale. Abilita il tasto di alternanza Non disturbare (NoDist) e inserisci l'ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurandosi che la funzione funzioni allo stesso modo su entrambe le piattaforme.
Fai clic su Avanti.
Aggiungere l'URL del servizio di autenticazione.
Selezionare Servizio autenticazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex poiché il servizio di autenticazione convalida correttamente il token utente rispetto al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
Controllare le voci sulla schermata finale, quindi fare clic su Crea. Dovrebbe essere visualizzato un messaggio di successo.
Partner Hub passa gli URL a vari microservizi Webex che testano le connessioni alle interfacce fornite.
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è riuscita.
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Abbiamo implementato questa verifica per prevenire errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, caricatore di bilanciamento o firewall) come illustrato in questa guida, prima di salvare il modello.
Verifica delle connessioni alle interfacce BroadWorks
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Visualizza cluster.
Partner Hub avvia i test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina dell'elenco dei cluster mostra il messaggio di stato accanto a ciascun cluster.
I messaggi verdi relativi al successo dovrebbero essere visualizzati. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio XSI-Actions, XSI-Events, DAS URL e le impostazioni dell'interfaccia CTI.
Configurazione dei modelli di onboarding
I modelli di onboarding sono il modo in cui verrà applicata la configurazione condivisa a uno o più clienti man mano che vengono caricati tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma solo un modello può essere associato a un cliente.
Accedere a Partner Hub e selezionare Clienti.
Fare clic sul pulsante Modelli di onboarding per visualizzare i modelli esistenti.
Fare clic su Crea modello.
Nella finestra Dettagli modello, aggiungere il nome del modello, il paese o la regione e la lingua e-mail predefinita.
Nella finestra Impostazione servizio, utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
Immettere un Nome modello, quindi fare clic su Avanti.
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per diverse modalità di provisioning Nome impostazione
Provisioning fluviale con e-mail attendibili
Provisioning flowthrough senza e-mail
Self-provisioning utente
Abilita flusso BroadWorks attraverso il provisioning (include le credenziali dell'account di provisioning se attivato**)
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il †
Il †
Il †
Indirizzo e-mail provider servizi
Selezionare un indirizzo e-mail dall'elenco a discesa (è possibile digitare alcuni caratteri per trovare l'indirizzo, se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello di onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature tra paese e regione in questo foglio di calcolo.
Il paese dell'organizzazione determina i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni consultare la sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questo interruttore spento.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note dalla tabella:
† Questo passaggio garantisce che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa opzione deve essere sempre attiva, a meno che non si utilizzi un processo manuale di ordinazione ed esecuzione (tramite Cisco Commerce Workspace) per creare le organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello di "provisioning ibrido" e non rientra nel campo di applicazione di questo documento.
** "Account di provisioning" si riferisce all'account di amministrazione a livello di sistema BroadWorks. Su BroadWorks, è necessario un account amministratore con questi attributi: Tipo amministratore=Provisioning, sola lettura=Disattivato.
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
Opzionale. Selezionare Disabilita chiamata gratuita Cisco Webex se si desidera disabilitare le chiamate Webex.
Per la configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
Numeri di chiamata in ingresso Cisco (PSTN)
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
Fai clic su Avanti.
Esistono due approcci per il provisioning degli abbonati relativamente a come vengono verificate le relative identità, utilizzando e-mail attendibili o e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile, gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. In qualità di partner, sei responsabile del provisioning dell'indirizzo e-mail come parte del metodo flow-through o API.
Si consiglia vivamente di utilizzare il metodo di provisioning attendibile poiché garantisce che tutti gli abbonati siano completamente predisposti dall'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso e-mail non attendibile, gli utenti devono verificare i relativi messaggi e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome impostazione
Provisioning flowthrough senza e-mail
Self-provisioning utente
Esegui prima provisioning amministratore
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
Note dalla tabella:
* Ciascuna organizzazione cliente in Webex deve disporre di almeno un utente con ruolo di amministratore. Il primo utente a cui assegnare IM&P integrato in BroadWorks assume il ruolo di amministratore del cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di fornitore di servizi è possibile avere il controllo su chi ottiene il ruolo. La verifica di questa impostazione impedisce agli utenti di completare l'attivazione fino a quando non viene attivato il primo utente fornito. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
Fai clic su Avanti.
Selezionare la modalità di autenticazione predefinita (autenticazione BroadWorks o autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.(Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
Fai clic su Avanti.
Per Preferenze, configurare quanto segue:
Scegliere se si desidera Precompilare gli indirizzi e-mail utente nella pagina di accesso.
Utilizzare questa opzione solo dopo aver selezionato Autenticazione BroadWorks e aver anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il nome utente BroadWorks. La pagina di accesso offre l'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
Se desideri abilitare la sincronizzazione delle rubriche, imposta l'opzione Abilita sincronizzazione rubrica telefonica per tutte le nuove organizzazioni clienti per attivare.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
Immettere un amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatico di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
Assicurati che l'opzione Consenti invito e-mail amministratore quando ti colleghi a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
Fai clic su Avanti.
Esaminare le voci nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Dovrebbe essere visualizzato un messaggio di successo.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con altri modelli.
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario immettere nuovamente i dettagli dell'account di provisioning. I campi Password vuota/Conferma password sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori forniti alla procedura guidata.
Aggiungi altri modelli se disponi di diverse configurazioni condivise che desideri fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbe essere necessario specificare i dettagli del modello per una delle attività seguenti.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning. |
Patch Application Server (solo R22, R23 e R24)
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
Per R22:
AP.as.22.0.1123.ap373197
Per R23:
AP.as.23.0.1075.ap373197
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che costituiscono il requisito per la distribuzione di Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.Modifica della
Maintenance/ContainerOptions
contesto.Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true
Scarica gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interfaccia > Messaggistica e Servizio > IM&P integrato) dei comandi AS.
Accedi a Partner Hub e vai a
.Fare clic su Visualizza modelli.
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro flyout a destra. Se non è stato ancora creato un modello, è necessario farlo prima di poter ottenere l'URL di provisioning.
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per altri modelli se si dispone di più modelli.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema su server applicazioni
Se si utilizza UC-One SaaS, potrebbe non essere necessario impostare il provisioning e il dominio del servizio a livello di sistema. Vedere i Punti di decisione nella sezione Preparazione dell’ambiente. |
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password
AS_CLI/Interface/Messaging> set enableSynchronization true
Attivare l'interfaccia IMP integrata:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
È necessario inserire il nome completo per il |
(Opzione) Configurazione dei parametri di provisioning per azienda su server applicazioni
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
Selezionare Usa dominio di servizio e immettere un valore fittizio (Webex ignora questo parametro). È possibile utilizzare
example.com
).Selezionare Usa server di messaggistica.
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
È necessario inserire il nome completo per il
provisioningURL
parametro, come è stato dato in Partner Hub. Se il server applicazioni non può accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel/etc/hosts
file su AS.Nel campo Nome utente, immettere un nome per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Immettere una password per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Per Identità utente predefinita per ID IM&P, selezionare Principale.
Fare clic su Applica.
Ripeti per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning utente, vedi Provisioning utente provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning aiuta amministratori e team di vendita controllando la presenza di errori prima di eseguire il provisioning di un cliente o abbonato per un pacchetto. Gli utenti o le integrazioni autorizzati da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per assicurarsi che non vi siano conflitti o errori con il provisioning del pacchetto per un determinato cliente o abbonato.
L'API verifica se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto a un cliente o partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, è possibile correggere gli errori prima del provisioning, aumentando la probabilità di un provisioning riuscito.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore Webex per la vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare di un provisioning abbonato all'ingrosso
Per accedere a Precontrolla un documento di provisioning abbonato Wholesale, devi accedere al portale https://developer.webex.com/. |
Partner SSO - SAML
Consente agli amministratori dei partner di configurare l'SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La seguente procedura SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere la funzionalità SSO del partner a un'organizzazione cliente esistente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso. Per aggiungere SSO partner a un'organizzazione esistente, è necessario aprire un ticket con Cisco TAC. |
Verificare che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'integrazione Single Sign-On in Control Hub.
Aprire una richiesta di servizio con Cisco TAC. TAC deve stabilire una relazione di trust tra il provider di identità di terze parti e il servizio Cisco Common Identity. .
Se l'IdP richiedepassEmailInRequest
da abilitare, accertarsi di includere questo requisito nella richiesta di servizio. Controlla con il tuo IdP se non sei sicuro che questa funzione sia necessaria.Carica il file di metadati CI fornito da TAC al provider di identità.
Configurare un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, immettere l'ID entità dall'XML metadati SAML del provider di identità di terze parti.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
Proprio che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori dei partner di configurare l'SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per impostare SSO OIDC partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già caricate utilizzando il modello. |
Aprire una richiesta di servizio con il centro TAC di Cisco con i dettagli dell'IDP di connessione OpenID. Sono obbligatori e facoltativi gli attributi IDP. TAC deve impostare l'IDP sul CI e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC, potrebbe consistere in lettere, numeri, trattini, sottolineature, inclinazioni e punti e la lunghezza massima è 128 caratteri.
Id client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Segreto client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco degli ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio, ad esempio "profilo e-mail openid" Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non fornito
URL dell'endpoint di autorizzazione OAuth 2.0 dell'IdP.
endpoint token
Sì se discoveryEndpoint non fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
endpoint infoutente
No
URL dell'endpoint UserInfo di IdP.
Endpoint set di tasti
No
URL dell'endpoint JSON Web Key Set dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
Configurare l'URI di reindirizzamento sull'IDP di connessione OpenID.
Configurare un modello di onboarding. Per l'impostazione della modalità di autenticazione, selezionare Autenticazione partner Con OpenID Connect e immettere il nome IDP fornito durante l'impostazione IDP come ID entità IDP OpenID Connect.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui registrazione chiamata, risposta per assente di gruppo, dirigente e assistente di direzione.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
Eseguire i seguenti comandi sulle interfacce AS. Ciò consentirà all’AS di inviare il c.d.
X-BroadWorks-Correlation-Info
Intestazione SIP:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true
Il
enableCallCorrelationID
Il parametro associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione delle informazioni di correlazione delle chiamate nei registri Xsi-Actions. Si raccomanda di avereenableCallCorrelationID
abilitato utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione dell'identificativo di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione della rubrica garantisce che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la directory di chiamata completa dal server BroadWorks viene sincronizzata con la directory Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione rubriche, vai a Sincronizzazione rubriche in Webex per Cisco BroadWorks.
Webex per Cisco BroadWorks flowthrough provisioning aggiunge utenti di messaggistica e informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, gli elenchi telefonici, gli utenti non di messaggistica e le entità non utenti non sono inclusi (ad esempio, un telefono della sala conferenze, un fax o un numero di gruppo di risposta). L'attivazione della sincronizzazione delle rubriche garantisce che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex. |
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia chiamate e riunioni unificate Webex visualizzata sull'app Webex. Gli utenti possono visualizzare la cronologia dettagliata delle chiamate e della riunione dall'app Webex.
La cronologia chiamate unificata può essere abilitata dagli amministratori a livello di partner in Partner Hub su base cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
Eventi cronologia chiamate: questi eventi vengono utilizzati per creare una cronologia chiamate unificata dettagliata
Eventi di stato hook: la cronologia chiamate unificata include ottimizzazioni dello stato hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di Telephony Presence
Requisiti della cronologia chiamate unificata
Prima di configurare la cronologia chiamate unificata, accertarsi di aver eseguito la patch del sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
AP.as.22.0.1123.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per R23:
AP.as.23.0.1075.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Se si utilizza XSP—
AP.xsp.23.0.1075.ap378585
In caso di utilizzo di ADP
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
AP.as.24.0.944.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per l'elenco completo delle patch BroadWorks che è necessario installare come prerequisito per l'esecuzione di Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella sezione Riferimento. |
Oltre alla patch del sistema, il file di configurazione del client ( config-wxt.xml
) deve avere il seguente set di tag: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altro reindirizzamento nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
AP.as.23.0.1075.ap383346
AP.as.23.0.1075.ap383994
Per R24:
AP.as.24.0.944.ap383346
AP.as.24.0.944.ap383994
Per avere informazioni Dirigente-Assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
AP.as.24.0.944.ap380052
AP.as.24.0.944.ap384239
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare anche la sincronizzazione delle rubriche per la cronologia chiamate unificata dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione NoDist, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti nel cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione di Broadworks durante la stessa finestra di manutenzione. |
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configura organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettuare le seguenti operazioni:
Accedi a Partner Hub su
admin.webex.com
.Andare a Impostazioni e selezionare un cluster esistente.
Verificare che la connessione al cluster sia buona. Nel pannello a destra viene visualizzato un segno di spunta verde con Connection stabilita.
Se questa opzione non viene visualizzata, in Check Connnections (Opzionale), immettere BroadWorks User Id e BroadWorks Password e fare clic su Check per verificare che la connessione sia corretta.
Selezionare la casella di controllo Abilita cronologia chiamate.
Fai clic su Salva.
Interazioni funzione
Per la cronologia chiamate unificata sono presenti le seguenti interazioni delle funzioni:
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando questa situazione esiste, gli eventi Cronologia chiamate e Stato hook non vengono inviati all'app Webex.
La cronologia chiamate unificate non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia chiamate unificata dall'app Webex. Per informazioni dettagliate, vedere: Webex | visualizza cronologia chiamate e riunioni.
Disabilita cronologia chiamate unificata
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visivo
L'app Webex supporta un'indicazione visiva delle chiamate spam nel avviso popup quando la chiamata viene presentata al destinatario e nei record della cronologia delle chiamate unificate quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per utilizzare questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- Le seguenti patch devono essere installate e attive:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o AS-25_Rel_2022.12 come minimo
- La funzione deve essere attivata tramite AS CLI:
- AS_CLI/System/ActivatableFeature> attivare 104112
- AS_CLI/System/StirShaken> imposta enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'etichettatura e la verifica STIR-SHAKEN come descritto in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste di invito inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti che vengono inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione di spam visivo nella presentazione della chiamata e nella cronologia chiamate unificata della chiamata.
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenta di identificare il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra di chiamata e una volta completata la chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante abbinando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se trova più istanze di un numero in un'origine, non tenterà di sceglierne una, in questo caso, non visualizzerà alcun ID chiamante. |
Webex Common Identity (CI) che contiene gli utenti della tua organizzazione.
Contatti personali e aziendali. I contatti personali sono visibili nella scheda Contatti.
Rubrica locale. In Windows - applicazione Outlook, in Mac - Contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non viene trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, utilizzerà la parte del nome utente dell'URI SIP dall'intestazione SIP From come ultima risorsa.
Per il controllo delle chiamate remote (ad esempio, modalità di controllo del telefono fisso) vengono utilizzate informazioni XSI, dove viene utilizzato ID BWKS o interno, estratte da informazioni di parte remota nell'evento XSI. Se l'informazione della parte remota non è disponibile, verrà utilizzata P-Asserted Identity (PAI) (se configurata).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica di chiamata e nella cronologia chiamate.
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
Coda Call Center: Visualizza il nome della coda che ha inoltrato la chiamata.
Dirigente-Assistente: Mostra il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
Per le chiamate nella coda chiamate interna, in cui un agente richiama una parte interna, la parte remota non visualizzerà il nome della coda chiamata, ma il nome dell'agente che le chiama.
Chiamata con risposta altrove:
Per gruppi di risposta o code chiamate impostate con indirizzamento simultaneo, gli agenti visualizzeranno una chiamata che ha ricevuto risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di risposta o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate perse nella cronologia chiamate se risposte da un altro agente.
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni da tavolo. Questa funzione specifica consente di assegnare gli indicatori di linea condivisa all'app Webex dell'utente finale.
Questa funzione consente agli utenti di gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente alle linee condivise.
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise dal client Webex
R23 senza ADP:
AP.as.23.0.1075.ap384179
AP.xsp.23.0.1075.ap384179
R23 con ADP:
AP.as.23.0.1075.ap384179
Xsi-Actions-23_2022.10
R24:
IN QUANTO: AP.as.24.0.944.ap384179
Xsi-Actions-24_2022.10
R25:
IN QUANTO: Versione RI Rel_2022.10_1.310
Xsi-Actions-25_2022.10
Cerotto 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo (in questo caso per il client desktop: Business Communicator).
Versione RI Rel_2022.10_1.310
Sincronizzazione Non disturbare (NoDist).
La sincronizzazione Non disturbare (NoDist) allinea le impostazioni NoDist tra Webex e BroadWorks sincronizzando lo stato NoDist tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato si sincronizza con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. Analogamente, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist da una piattaforma non vengono riconosciuti dall'altra piattaforma.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Se sono presenti molti clienti (>50) nel cluster BroadWorks, la sincronizzazione NoDist non è supportata. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza. |
Prerequisiti
Assicurarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione BroadWorks.
Per la versione 23:
<snipped>
- App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
<snipped>
- App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 su AS:
AS_CLI/System/ActivatableFeature> activate 25433
Se sono presenti molti clienti (>50) nel cluster BroadWorks, operazioni come l'aggiornamento di azioni XSI, eventi XSI, URL DAS, URL XSP|ADP o sincronizzazione NoDist non sono supportate. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza.
Configura sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto di eventi "as-feature-event". Per informazioni dettagliate, vedere Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
Accedi a Partner Hub
Fare clic su Impostazioni.
Fare clic su Visualizza cluster e selezionare il cluster BroadWorks appropriato.
Abilita il tasto di alternanza Non disturbare (NoDist).
Inserire l'ID utente BroadWorks e fare clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione NoDist. Se la convalida non riesce, il pulsante Salva viene disabilitato.
Se la convalida ha esito positivo, fare clic su Salva.
|
Abilita sincronizzazione NoDist (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per ulteriori dettagli, vedere "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Disabilita sincronizzazione NoDist
Non puoi disabilitare la sincronizzazione NoDist da solo. Per disabilitare la funzione, crea un caso BEMS di ingegneria con le seguenti informazioni:
Famiglia: Servizio Spark
Prodotto: Chiamata in Webex (Webex per BroadWorks)
Componente: Provisioning WxBW
Il caso BEMS deve indicare che la sincronizzazione non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterIdBroadWorks.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione delle chiamate.
Modalità di registrazione | Descrizione | Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta | La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente | La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Per R22: AP.as.22.0.1123.ap377718
Per R23: AP.as.23.0.1075.ap377718
Per R24: AP.as.24.0.944.ap377718
L'identificativo di correlazione chiamata deve essere attivato. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione delle chiamate Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, andare a help.webex.com
articolo Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla piattaforma di registrazione chiamate di terze parti.
Gruppo Parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione di parcheggio e recupero delle chiamate di gruppo. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti al dettaglio in un'impostazione di negozio possono utilizzare la funzione per parcheggiare una chiamata che può essere raccolta da qualcuno in un altro reparto.
Funzionamento funzione
Una volta configurata la funzione
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nell'app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nell'app Webex. L'utente quindi inserisce l'estensione della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per attivare questa funzione, verificare quanto segue:
Il file di configurazione client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
L'identificativo di correlazione chiamata deve essere abilitato su AS e XSP|ADP. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Il tuo SBC deve essere configurato per passare il ‘
x-broadworks-correlation-in
' Attributo SIP a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiungi gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo del server applicazioni Cisco BroadWorks - Parte 2. È necessario creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Parcheggio Webex | e Recupera chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzato
Il parcheggio chiamate regolare o indirizzato non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso funzione:
Immettere *68 per parcheggiare una chiamata
Immettere *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato negli ambienti del call center o in altre situazioni in cui può essere necessaria un'assistenza o un intervento immediati.
Quando un servizio di inclusione è abilitato, un utente o supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di tasti o pulsanti dedicati sul proprio telefono o dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o di partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in vari scenari. In un ambiente di call center, supervisori o formatori possono monitorare e assistere i rappresentanti del servizio clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire assistenza o prendere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può partecipare rapidamente a conversazioni in corso per fornire assistenza o prendere decisioni importanti.
Nell'app Webex per l'inclusione, viene inviata una notifica che la chiamata viene trasformata in una conferenza. In NOTIFY (informazioni sulla chiamata o conferenza) non sono disponibili ulteriori informazioni sul tipo di conferenza, pertanto è possibile trattarla in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Vengono introdotti i seguenti termini:
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore solitamente ha la possibilità di monitorare e intervenire nelle chiamate in corso dei clienti. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire assistenza agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può comprendere la formazione degli agenti, la gestione dei problemi dei clienti e l'ottimizzazione delle prestazioni del team.
Cliente: Per cliente si intende una persona fisica o giuridica che interagisce con un'azienda o un'organizzazione per ottenere prodotti, servizi o assistenza. Nel contesto dell'inclusione delle chiamate, un cliente è qualcuno che sta effettuando o ricevendo una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risolvere le loro richieste o problemi durante la chiamata. La funzione di inclusione chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
Agente: Un agente, anche noto come rappresentante del servizio clienti o agente del call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza telefonica o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare operazioni e offrire un'esperienza positiva al cliente. Nel contesto dell'inclusione delle chiamate, un agente è la persona che parla direttamente al cliente durante la telefonata. L'agente può ricevere indicazioni o feedback dal supervisore attraverso l'inclusione della chiamata, se necessario.
La chiamata nativa mobile viene inoltrata alla riunione
La funzione di escalation della chiamata nativa mobile alla riunione è dotata di due funzioni uniche:
Nuova notifica push
Gli utenti mobili su una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando si avvia una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si accede direttamente alla schermata in chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata utilizzando il controllo chiamate Cisco per le chiamate su cellulare, viene visualizzata la notifica Webex durante una chiamata su cellulare.
Trasferisci chiamata mobile a riunione
Quando sei nel mezzo di una chiamata con qualcuno, potresti voler trasferire la chiamata in una riunione per utilizzare alcune funzioni di riunione avanzate come video, condivisione o lavagna. In alternativa, invitare altre persone alla discussione e passare a una riunione.
Requisiti BroadWorks
Funzione attivabile 25239
R23 con XSP|ADP:
AS Patch AP.as.23.0.1075.ap383064
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
Patch AP.platform.23.0.1075.ap383064
R23 con ADP:
AS Patch AP.as.23.0.1075.ap383064
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R24:
Cerotto AS: AP.as.24.0.944.ap383064
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R25:
AS RI release Rel_2022.08_1.354
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e NPS versione > 2022.08_1.350
Configurazione chiamata URI per supportare lo spostamento della chiamata alla riunione
Criteri di chiamata Url NS
Definisci la regola per (.*)webex.com da indirizzare attraverso I-SBC
NS_CLI/Policy/UrlDialing> get WebexMeetings
Policy: UrlDialing Instance: Webex
unknownSipURIHandling = reject
disableSubscriberLookups = true
Enable = true
CallTypes:
Selection = {ALL}
From = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP}
lineportOnly = false
enableSipURIMatchingRules = true
NS_CLI/Policy/UrlDialing/Rules> get WebexMeetings
Policy: UrlDialing Instance: WebexCalling Table: Rules
id pattern routingNE cost weight dtg
===================================================================
1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE di indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> get ne WebexMeetings
Network Element WebexMeetings
Location = 1281465
Data Center =
Static Cost = 1
Static Weight = 99
Poll = false
OpState = enabled
State = OnLine
Profile = NIL_PROFILE
Remote Lookup Enabled = false
Signaling Attributes =
NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings
Routing NE Address Cost Weight Port Transport Route
=====================================================================
WebexMeetings sbc-address 1 99 - unspecified
Profilo di indirizzamento NS
Aggiunta dell'istanza della policy UrlDialing ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> get profile MyInst
Profile: Webex
Policy Instance
==========================================
…
UrlDialing WebexMeetings
AS Usa indirizzamento NS per chiamata NetworkURL
Consente all'AS di rispettare il percorso NS in modalità ibrida AS
AS_CLI/Interface/IMS> set queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un PSAP (Public Safety Answering Point), che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, è necessario integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Usa i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
Chiamata di emergenza E911 in Webex per BroadWorks: utilizzare questo articolo per configurare la chiamata di emergenza E911 in Webex per Cisco BroadWorks utilizzando uno dei seguenti provider E911 supportati:
Banda
Intrado
RedSky
Esclusione di responsabilità per chiamate di emergenza: se disponi di un servizio di posizione, puoi configurare la finestra Esclusione di responsabilità per i servizi di emergenza sull'app Webex in modo da includere un'opzione per gli utenti per aggiornare la propria posizione quando eseguono l'accesso.
Personalizzazione e provisioning dei clienti
Gli utenti scaricano e installano le relative app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedere Piattaforme app Webex). Una volta eseguita l'autenticazione dell'utente, il client si registra sul cloud Webex per messaggistica e riunioni, recupera le informazioni sul branding, scopre le informazioni del servizio BroadWorks e scarica la configurazione delle chiamate dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
Configurare i parametri di chiamata per le app Webex in BroadWorks (come di consueto). Configura i parametri di branding, messaggistica e riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Prepara il tuo ambiente).
Verificare di disporre dei set di tag corretti in BroadWorks System > Resources > Device Management Tag Sets.
Per ciascun client che si sta eseguendo il provisioning:
Scaricare ed estrarre il file zip DTAF per il client specifico.
Importare i file DTAF in BroadWorks all'indirizzo System > Resources > Identity/Device Profile Types
Apri il profilo dispositivo appena aggiunto per la modifica e:
Immettere il nome di dominio completo dell'azienda agricola XSP|ADP e il protocollo di accesso del dispositivo.
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per il funzionamento della condivisione desktop.
È inoltre possibile abilitare il supporto Parte remota eseguendo il seguente comando CLI sul server applicazioni:AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
Salvare il file.
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome | Descrizione |
Priorità codec | Configurazione dell'ordine di priorità per i codec audio e video per le chiamate VoIP |
TCP, UDP e TLS | Configurare i protocolli utilizzati per la segnalazione e il contenuto multimediale SIP |
Porte audio e video RTP | Configurazione degli intervalli di porte per audio e video RTP |
Opzioni SIP | Configurare diverse opzioni relative a SIP (SIP INFO, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti gestiti dal partner. Vedere Configurazione di personalizzazioni di branding avanzate.
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client. |
Personalizzazione dei report dei problemi e degli URL della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito Feedback e Guida", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con Flowthrough Provisioning
Prima di poter eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 | Assegna servizio in BroadWorks: |
2 | Verifica dell'organizzazione cliente e degli utenti in Control Hub: |
Test utente
1 | Scaricare l'app Webex su due diverse macchine. |
2 | Eseguire l'accesso come utenti di test sulle due macchine. |
3 | Effettuare chiamate di prova. |
Provisioning delle organizzazioni dei clienti
Nel modello corrente, eseguiamo automaticamente il provisioning dell'organizzazione del cliente quando si esegue l'onboarding del primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguito una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
Usa API per creare account Webex
Assegna il provisioning integrato IM&P (flowthrough provisioning) con e-mail attendibili per creare account Webex
Assegna provisioning integrato IM&P (flowthrough) senza e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per creare account Webex
Consenti agli utenti di autoattivarsi (invia loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex espone le API pubbliche per consentire ai provider di servizi di integrare il provisioning degli abbonati Webex per Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. Le specifiche per queste API sono disponibili su developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti wholesale verranno rifiutati da queste API. |
Provisioning del flusso
Su BroadWorks, è possibile eseguire il provisioning degli utenti con l'opzione Abilita IM&P integrato. Questa azione provoca l'adattatore di provisioning BroadWorks per effettuare una chiamata API per il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica del codice, ma solo una modifica della configurazione dell'endpoint API per l'adattatore di provisioning.
Il provisioning degli abbonati su Webex può richiedere molti minuti (diversi minuti per l'utente iniziale all'interno di un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il successo del provisioning flowthrough indica che il provisioning è stato avviato. Non indica il completamento. Per confermare che il provisioning di utenti e organizzazione cliente sia completo su Webex, devi accedere a Partner Hub e guardare nell'elenco dei clienti. Gli utenti di trunking BroadWorks possono disporre di Webex per BroadWorks tramite un identificativo di chiamata condiviso (SCA). L'utente che esegue il trunking dovrà disporre del servizio di autenticazione assegnato. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto Webex SCA dall'autenticazione del trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con le funzioni di elenco di indirizzamento o indirizzamento diretto assegnate. |
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata Modello di onboarding. |
Autoattivazione utente
Per eseguire il provisioning degli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
Accedere a Partner Hub e trovare la pagina Elenco clienti.
Fare clic su Visualizza modelli.
Seleziona il modello di onboarding di provisioning che desideri applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non si trova nel sistema BroadWorks associato a questo modello, non può attivarsi automaticamente con il collegamento.
Copiare il collegamento di provisioning e inviarlo all'utente.
È anche possibile includere il collegamento per il download del software e ricordare all'utente di cui ha bisogno di fornire e convalidare il proprio indirizzo e-mail per attivare l'account Webex.
È possibile monitorare lo stato di attivazione dell'utente nel modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi di attivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli all'interno della vista Stato utente che consentono agli amministratori dei provider di servizi Webex per Cisco BroadWorks di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Sposta gli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) |
|
Organizzazione cliente | Collega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge Webex per BroadWorks anche agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) | Se l'organizzazione Webex per BroadWorks non esiste (nessun utente predisposto):
Se esiste un'organizzazione Webex per BroadWorks (viene predisposto almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di autoiscrizione (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (con il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
Sposta utente (con e-mail attendibili): utilizza il provisioning con e-mail attendibili
Sposta utente (con e-mail non attendibili): utilizza il provisioning con e-mail non attendibili
Autoattivazione
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza messaggi e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
L'amministratore aggiunge l'utente.
L'utente viene spinto sul bridge di provisioning BroadWorks.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L’utente apre il messaggio e-mail e fa clic su Attiva account. L'utente viene reindirizzato al portale consumer Webex.
L'utente accede a Webex.
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza messaggi e-mail non attendibili, è necessario prima convalidare l’indirizzo e-mail dell’utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
L'amministratore aggiunge l'utente.
L'utente viene inviato automaticamente al bridge di provisioning BroadWorks.
All'utente viene inviato un testo con un collegamento di attivazione.
L'utente fa clic sul collegamento Attivazione e inserisce l'indirizzo e-mail.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L'utente apre il messaggio e-mail e fa clic su Accedi ora.
L'indirizzo e-mail viene convalidato.
L'utente viene reindirizzato all'accesso al portale consumer Webex.
L'utente accede a Webex.
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Flusso di autoattivazione
Se l'utente dispone di un account BroadWorks esistente, può utilizzare il processo di autoattivazione per spostare l'account.
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
L'utente inserisce il proprio indirizzo e-mail.
L'utente viene inviato al bridge di provisioning BroadWorks.
Viene inviata un'e-mail automatica all'indirizzo e-mail dell'utente.
L'utente apre il messaggio e-mail e fa clic sul collegamento Accedi ora, che convalida l'indirizzo e-mail.
CI rileva che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di poter continuare.
L'utente viene reindirizzato all'accesso a Webex.
L'utente accede al portale consumer.
L'utente fa clic su Elimina account.
L'account Webex precedente viene eliminato.
All'utente è stato predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
Collegamento di Webex per BroadWorks all'organizzazione esistente
Se sei un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, che non è ancora associata a un'azienda BroadWorks gestita da un partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso amministratore per la richiesta di provisioning riuscita.
È necessaria l'approvazione dell'amministratore dell'organizzazione se una delle seguenti affermazioni è vera:
L'organizzazione cliente esistente dispone di 100 utenti o più
L'organizzazione dispone di un dominio e-mail verificato
Dominio organizzazione richiesto
Se nessuno dei criteri di cui sopra è vero, può verificarsi un Attacco automatico.
In uno scenario di allegato automatico, un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner verranno concessi diritti di amministrazione provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà eseguito un amministratore completo. Con l'accesso amministratore di provisioning, la visibilità in Control Hub sarà limitata agli utenti nell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione. |
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che i messaggi e-mail di invito amministratore vengano collegati a organizzazioni esistenti (il tasto di alternanza è attivo per impostazione predefinita). |
1 | L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedere Provisioning delle organizzazioni dei clienti. Si verifica quanto segue:
| ||
2 | Con l'accesso amministratore completo, l'amministratore del partner può completare il processo di provisioning del cliente. Dovrai provare a eseguire nuovamente il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora come amministratore completo esterno, non si dovrebbe osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione cliente esistente sarà visibile come cliente sotto Webex per l'organizzazione partner BroadWorks.
|
Condizioni dell'allegato organizzazione
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione del cliente target. In caso contrario, verrà creata una nuova organizzazione cliente.
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato sul modello di provisioning Webex per BroadWorks. Di conseguenza, non vi sono modifiche alla modalità di accesso degli utenti esistenti.
Tuttavia, se l'organizzazione cliente esistente dispone di branding di base abilitato, una volta eseguito il collegamento, le impostazioni di branding avanzate del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
Il nome dell'organizzazione esistente non cambierà.
Non è stata apportata alcuna modifica all'impostazione del flag di soppressione e-mail nelle impostazioni dell'organizzazione esistente. Ciò può avere effetto sui nuovi utenti predisposti. A seconda di come è impostato il flag, i nuovi utenti possono o meno ricevere un'e-mail con un codice che deve essere immesso per completare l'attivazione.
La modalità di amministrazione con restrizioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
Accertarsi di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
Un'azienda BroadWorks può essere associata solo a una organziazione Webex. Non è possibile eseguire il provisioning degli abbonati da una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com
.
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo. |
L'indirizzo e-mail aggiunto dall'amministratore dell'organizzazione cliente come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore partner come configurato nel modello di onboarding su Partner Hub. Dopo aver aggiunto l'e-mail dal modello di onboarding in Partner Hub come amministratore completo, qualsiasi amministratore aggiuntivo del partner dovrà essere aggiunto anche come amministratore esterno con diritti di amministratore completo. |
Scollegare Webex per BroadWorks dall'organizzazione esistente
Effettuare le seguenti operazioni per scollegare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato accidentalmente Webex per BroadWorks a un'organizzazione esistente e si desidera rimuovere l'allegato.
In Flusso standard, il distacco di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati. |
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso all'amministratore esterno seguendo Approva richiesta amministratore esterno.
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Remove a BroadWorks Workspace.
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi abbonato BroadWorks.
Rimuovi gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se gli utenti sono stati predisposti tramite il flusso e-mail non attendibile e non sono stati ancora inseriti messaggi e-mail validi, gli utenti rimangono in stato di attesa. Segui Verifica provisioning utente con e-mail non attendibili per eliminare gli utenti.
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Hybrid, nella sezione BroadWorks Calling elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera collegare Webex per BroadWorks al cliente, seguire i processi di provisioning per collegarlo a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API Rimuovi abbonato BroadWorks è quella di accedere a BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati. |
Gestione di utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente sono in BroadWorks. Un'identità e-mail distinta per l'utente e le relative licenze per le funzioni Webex vengono conservate in Webex.
Verifica provisioning utente con e-mail non attendibili
Se si sta eseguendo il provisioning di utenti Webex per BroadWorks utilizzando il provisioning flow-through con e-mail non attendibili, gli utenti devono eseguire il provisioning automaticamente inserendo il relativo indirizzo e-mail nel portale di attivazione utente. Se l'utente riscontra un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riscontra nuovamente l'errore, l'amministratore può utilizzare i passaggi seguenti in Partner Hub per esaminare lo stato e caricare l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 | Accedere a Partner Hub e trovare la pagina Elenco clienti. |
2 | Fare clic su Visualizza modelli. Selezionare il modello di onboarding appropriato che si desidera applicare a questo utente. |
3 | In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con e-mail non attendibili sia configurato correttamente:
|
4 | In seguito al provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato del provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo stato corrente, che mostra se l'utente è predisposto o se è presente un requisito in sospeso.
|
5 | Per gli utenti con errori o requisiti in sospeso, fare clic sui tre punti a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili quando si visualizza l'elenco degli utenti:
Esporta: fare clic su questo pulsante se si desidera esportare l'elenco utenti in un file CSV.
Escludi utenti predisposti: abilita questo tasto di alternanza se desideri visualizzare solo gli utenti con requisiti o errori in sospeso.
Modifica ID utente o indirizzo e-mail
Modifiche a ID utente e indirizzo e-mail
L'ID e-mail e l'ID alternativo sono gli attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. La tabella seguente descrive gli scopi di questi diversi attributi e cosa fare se occorre cambiarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non puoi modificare questo identificativo e comunque collegare l'utente allo stesso account in Webex. È possibile eliminare l'utente e ricreare se non è corretto. |
ID e-mail | ID utente | Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si afferma che l'e-mail è attendibile Non richiesto in BroadWorks se non si asserisce di poter considerare attendibili i messaggi e-mail Non richiesto in BroadWorks se consenti agli abbonati di autoattivarsi | È presente un processo manuale per modificare questa opzione in entrambe le posizioni se all'utente è stato eseguito il provisioning con l'indirizzo e-mail errato:
Non modificare l'ID utente BroadWorks. Questa operazione non è supportata. |
ID alternativo | Nessuno | Consente di abilitare l'autenticazione dell'utente per e-mail e password rispetto all'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se Non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti dovranno inserire il proprio ID utente BroadWorks durante l'autenticazione. |
Modifica pacchetto utenti in Partner Hub
1 | Accedi a Partner Hub e fai clic su Clienti. |
2 | Individuare e selezionare l'organizzazione del cliente a cui è assegnato l'utente. Viene visualizzata la pagina di panoramica dell'organizzazione in un pannello a destra dello schermo. |
3 | Fare clic su Visualizza cliente. L'organizzazione del cliente si apre in Control Hub, mostrando la pagina Panoramica.
|
4 | Fare clic su Utenti, quindi individuare e fare clic sull'utente interessato. |
5 | Nei Servizi dell'utente, fare clic su Webex per i pacchetti BroadWorks (Abbonamenti). Si apre il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 | Nella scheda Profilo, cercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 | Seleziona il pacchetto che desideri per questo utente (Base, Standard, Premium o Softphone) e fai clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 | Puoi chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium hanno siti di riunione distinti associati a ciascun pacchetto. Quando un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato viene visualizzato con due siti di riunione in Control Hub. Le funzionalità di riunione organizzatore e il sito della riunione dell'abbonato vengono allineati al pacchetto corrente. Il sito della riunione del pacchetto precedente e qualsiasi contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili all'amministratore del sito della riunione. |
Potrebbero essere necessarie da due a tre ore per le nuove impostazioni PMR derivanti da una modifica del pacchetto da aggiornare. |
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si desidera eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto alcun trasferimento automatico del ruolo di amministratore nel caso in cui venga eliminato l'ultimo amministratore. |
API Cisco BroadWorks per Webex
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
Eseguire la richiesta API Remove a BroadWorks Subscriber su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento Webex per Cisco BroadWorks. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
Eseguire la richiesta Elimina una persona API su https://developer.webex.com/docs/api/v1/people/delete-a-person per eliminare completamente l'utente.
Provisioning flow-through
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – IM&P integrato in BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks - Parte 2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento Webex per Cisco BroadWorks dall'utente. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla propria organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 | Usa le API Persone per eliminare tutti gli utenti dall'organizzazione:
| ||
2 | Se la sincronizzazione rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione rubriche tramite Partner Hub: Per disabilitare la sincronizzazione rubriche tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API aziendale BroadWorks e disabilita l'impostazione enableDirSync. Tutti gli utenti correlati alla sincronizzazione rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione degli utenti (utilizzando entrambi i metodi) può richiedere del tempo a seconda della quantità di utenti. | ||
3 | Una volta rimossi tutti gli utenti, utilizza l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Gestione delle release
I controlli di gestione delle release in Partner Hub consentono a Webex per i provider di servizi Cisco BroadWorks di gestire facilmente le release consentendo loro di controllare la cadenza di rilascio in base alla quale le app Webex degli utenti vengono aggiornate all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza gli aggiornamenti automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
Configurazione di pianificazioni di rilascio personalizzate con rinvii dalla pianificazione di rilascio predefinita Cisco
Configurare una singola pianificazione della release e trasferirla a cascata a tutte le organizzazioni dei clienti che gestiscono
Assegna diverse pianificazioni di rilascio a diverse organizzazioni di clienti
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di rilascio personalizzate, vedere l'articolo Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
Aggiunta di un cluster BroadWorks in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
Aggiunta di un modello di onboarding in Partner Hub
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | ||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | ||
3 | Fare clic su Visualizza cluster. | ||
4 | Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro flyout a destra.
| ||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | |||||||||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | |||||||||
3 | Fare clic su Visualizza modelli. | |||||||||
4 | Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere a Webex Assistant di seguire le azioni, prendere nota di decisioni importanti ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant per Meetings è disponibile gratuitamente per i siti per riunioni con pacchetto Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilitazione di Webex Assistant per Meetings
Webex Assistant è abilitato per impostazione predefinita per i clienti Broadworks con pacchetto standard e premium.
Gli amministratori dei partner e gli amministratori delle organizzazioni dei clienti possono disabilitare la funzione per le organizzazioni dei clienti tramite Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
Il supporto è limitato ai siti per riunioni con pacchetto Premium e Standard e solo alle sale riunioni personali.
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
La condivisione di contenuto tramite e-mail è accessibile solo dagli utenti all'interno della tua organizzazione
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Il contenuto della riunione non è accessibile anche se condiviso tra utenti di pacchetti diversi dall'interno della stessa organizzazione.
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile, pertanto le trascrizioni post-riunione non sono disponibili se Webex Assistant è abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni utente su come utilizzare la funzione, vedere Uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
Webex Calling gratuito è abilitato per impostazione predefinita consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, che disabilita tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzione
Se Webex Calling è disabilitato, le seguenti condizioni si applicano a Webex per gli utenti Cisco BroadWorks:
Gli utenti non visualizzano più Chiamata con Webex come opzione di chiamata selezionabile sull'app Webex.
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, la cronologia chiamate, i contatti, inserendo l'URI dell'altro utente o l'indirizzo e-mail nella barra di ricerca.
Condivisione schermo all'interno di una chiamata BroadWorks.
Le riunioni Webex e la presenza in telefonia funzionano ancora, anche se le chiamate Webex sono disabilitate.
Disabilita chiamate Webex (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno di Aggiungi un nuovo modello guidata. Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti assegnate al modello.
Per informazioni dettagliate sulla configurazione di un nuovo modello di onboarding, vedere Configurazione dell'organizzazione partner in Partner Hub.
Disabilita chiamate Webex (modello di onboarding esistente)
Seguire questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
Accedere a Partner Hub all'indirizzo admin.webex.com.
Scegliere Impostazioni.
Fare clic su Visualizza modello e scegliere il modello di inserimento appropriato.
Fai clic su Disabilita chiamata gratuita Cisco Webex.
Fai clic su Salva.
Disabilita chiamate Webex (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare Webex Calls per un utente esistente, è possibile seguire una delle procedure seguenti per aggiornare l'utente.
Accertarsi di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigura l'utente con le chiamate Webex abilitate. |
Se si utilizza il provisioning flow-through, è possibile effettuare le seguenti operazioni:
Aprire CommPilot e passare alla configurazione utente.
Rimuovere il servizio Integrated IM+P dall'utente e fare clic su OK.
Aggiungere il servizio Integrated IM+P all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
Utilizzare Remove a BroadWorks Subscriber API per eliminare l'utente.
Utilizzare la Provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione della condivisione video o dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per informazioni dettagliate sulla configurazione e le opzioni complete, vedere Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è anche possibile configurare se il contenuto multimediale delle chiamate in ingresso utilizza per impostazione predefinita solo il video o l'audio. |
Indicatore di stato della linea / Notifica risposta per assente
L'indicatore di stato/notifica di risposta per assente utilizza le funzioni di risposta per assente indirizzata. Un utente con indicatore di stato riceve una notifica audio e visiva sull'app Webex quando un utente dell'elenco di indicatori di stato monitorato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può Ignorare o Rispondere alla chiamata dell'utente monitorato.
La notifica dell'indicatore di stato/risposta per assente consente di rispondere alle chiamate di altri membri del team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra chiamata multipla - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza dei membri del team Webex e non Webex. Per informazioni sull'abilitazione della chiamata multipla, vedere: Finestra multi-chiamata
I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati nella rubrica in Webex e avranno solo stati "sconosciuti" e "in chiamata" (lo stato suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
La presenza non è supportata per gli utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
Gli utenti CI senza autorizzazione cloud Webex o tipo di account macchina (spazi di lavoro) visualizzano solo la presenza "in chiamata" e "sconosciuta". Nessun stato attivo, suoneria, ecc.
Gli utenti non Webex dall'elenco di indicatori di stato, che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza "sconosciuta".
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
Se un utente non Webex dell'indicatore di stato detiene una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate su BroadWorks. Installare solo le patch valide per la versione in uso:
Per R22:
Piattaforma AP.22.0.1123.ap382053
AP.as.22.0.1123.ap382053
AP.as.22.0.1123.ap382362
AP.xsp.22.0.1123.ap382053
AP.xsp.22.0.1123.ap382362
AP.as.22.0.1123.ap383459
AP.as.22.0.1123.ap383520
Per R23:
Piattaforma AP.23.0.1075.ap382053
AP.as.23.0.1075.ap382053
AP.as.23.0.1075.ap382362
AP.as.23.0.1075.ap383459
AP.as.23.0.1075.ap383520
Se si utilizza XSP|ADP:
AP.xsp.23.0.1075.ap382053
AP.xsp.23.0.1075.ap382362
Se si utilizza ADP:
Xsi-Actions-23_2022.01_1.200.bwar
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
Per R24:
AP.as.24.0.944.ap382053
AP.as.24.0.944.ap382362
AP.as.24.0.944.ap383459
AP.as.24.0.944. ap383520
Xsi-Actions-24_2022.01_1.200.bwar
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
<busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare la funzione 101642 Enhanced Xsi Mechanism Per la telefonia del team su AS:
AS_CLI/System/ActivatableFeature> activate 101642
Abilita X-BroadWorks-Remote-Party-Info
in AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamata SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Accertarsi che i seguenti servizi siano assegnati agli utenti:
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP. |
Configurazione dell'indicatore di stato della linea su BroadWorks
Gli amministratori dei partner possono utilizzare la seguente procedura per impostare l'indicatore di stato della linea per un utente.
Accedere a BroadWorks CommPilot.
Per un utente selezionato, accedere ad Applicazioni client e configurare l'indicatore di stato della linea.
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
Utilizzare i parametri di ricerca per individuare e aggiungere utenti all'elenco Utenti monitorati.
Fai clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento di coinvolgimento del pubblico facile da usare. Consente alle persone di ottenere il massimo dalle riunioni colmando la distanza tra oratori e pubblico. Quando Slido è integrato nell'organizzazione Control Hub, gli utenti possono aggiungere l'Slido app alle riunioni nell'app Webex. Questa integrazione offre ulteriori funzionalità di Q&A e sondaggio alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando è stata accettata una riunione nel client Outlook che corrisponde a un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che hai assunto un impegno diverso e che la risposta potrebbe essere ritardata.
Per abilitare questa funzione:
andare alla scheda Generale della scheda Impostazioni su Windows o Preferenze su Mac.
Selezionare la casella per Mostra in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, "In una riunione di calendario" in Webex è associato a "Occupato" in Outlook. |
Avvertenza
Per utilizzare questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come funziona altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la sua presenza non verrà aggiornata fino al termine della riunione. A tale scopo, sarà necessario riavviare il client per rispondere.
Risposta automatica con tono
Con la risposta automatica con tono, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul desktop. Quando l'app Webex squilla sull'altra parte, l'utente sente un determinato segnale acustico che indica che la chiamata è in connessione.
Per utilizzare questa funzione per un utente Webex per Cisco BroadWorks:
La funzione è supportata solo sull'aspetto della linea principale
L'app Webex deve essere l'identificativo di linea principale
Il tag %ENABLE_AUTO_ANSWER_WXT% deve essere abilitato
Se l'utente dispone anche di indicatori di chiamata condivisa (ad esempio, un telefono da tavolo è configurato come uno degli indicatori di linea secondaria), la funzione è ancora supportata sull'aspetto principale, a condizione che gli indicatori di chiamata condivisa siano configurati per non ricevere chiamate in arrivo. Per effettuare questa operazione, è possibile configurare una delle tre condizioni seguenti su BroadWorks per tutte le chiamate condivise:
Avvisa tutti gli aspetti delle chiamate con clic è disabilitato nella configurazione dell'aspetto chiamata condivisa: questo è l'approccio consigliato
o
Consenti terminazione a questa posizione deve essere disabilitato per tutte le chiamate condivise o
o
Posizioni disabilitate per tutti gli indicatori di chiamata condivisi
Aumentare la capacità
Aziende agricole XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare quante risorse XSP|ADP aggiuntive sono necessarie per l'aumento proposto dei numeri di abbonati. Per le aziende NPS dedicate o Webex dedicato per le aziende Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
Fattoria dedicata in scala: Aggiungere uno o più server XSP|ADP all'azienda che ha bisogno di capacità extra. Installare e attivare lo stesso set di applicazioni e configurazioni dei nodi esistenti dell'azienda agricola.
Aggiungi azienda agricola dedicata: Aggiungi una nuova fattoria XSP|ADP dedicata. Dovrai creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti nella nuova fattoria, per ridurre la pressione sulla fattoria esistente.
Aggiungere azienda agricola specializzata: Se si verificano strozzature per un particolare servizio, è possibile creare un'azienda agricola ADP|XSP separata a tale scopo, tenendo conto dei requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster di Control Hub e le voci DNS se si modifica l'URL del servizio con una nuova azienda agricola.
In tutti i casi, è tua responsabilità monitorare e assegnare risorse all’ambiente BroadWorks. Se si desidera contattare l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare i servizi professionali.
Gestione dei certificati del server HTTP
È necessario gestire questi certificati per le applicazioni Web autenticate mTLS su XSP|ADP:
La nostra catena di certificati di attendibilità dal cloud Webex
Certificati delle interfacce del server HTTP di XSP|ADP
Catena di fiducia
È possibile scaricare la catena del certificato di attendibilità da Control Hub e installarlo sugli ADP|XSP durante la configurazione iniziale. Prevediamo di aggiornare il certificato prima della scadenza e di informarvi su come e quando modificarlo.
Interfacce del server HTTP
L'|ADP XSP deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Certificati ordine. Quando si protegge l'interfaccia, viene generato un certificato autofirmato per l'interfaccia. Questo certificato è valido per un anno da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione di Partner Hub che gli amministratori dei partner possono assegnare a organizzazioni di clienti specifiche per limitare le impostazioni dell'organizzazione che gli amministratori dei clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione del cliente, tutti gli amministratori del cliente di tale organizzazione, indipendentemente dalle autorizzazioni dei ruoli, non sono in grado di accedere a un set di controlli con limitazioni in Control Hub. Solo un amministratore partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner esiste un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita le autorizzazioni di ruolo specifiche per gli amministratori dei clienti nell'organizzazione a cui è applicata l'impostazione. |
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità con limitazioni per partner. Dopo l'accesso, vedrà un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner notifica all'amministratore del cliente che la Modalità con limitazioni è abilitata e che l'amministratore potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore del cliente in un'organizzazione in cui con limitazioni della modalità partner è abilitata, il livello di accesso di Control Hub è determinato con la formula seguente:
(Accesso a Control Hub) = (Entitlements Role Organization) - (Limitato dalle limitazioni della modalità partner)
Limitazioni
Quando è abilitata la modalità con limitazioni per partner per un'organizzazione del cliente, gli amministratori dei clienti di tale organizzazione non possono accedere alle seguenti impostazioni di Control Hub:
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
Pulsante Gestisci utenti: disattivato.
Aggiungi o modifica manualmente utenti: nessuna opzione per aggiungere o modificare gli utenti, né manualmente né tramite CSV.
Richiedi utenti: non disponibile
Assegna automaticamente licenze: non disponibile
Sincronizzazione rubriche —Impossibile modificare le impostazioni di sincronizzazione delle rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato ed e-mail principale* sono modificabili.
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, messaggi, riunioni, chiamate)
Visualizza stato servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
Numero di lavoro principale: questo campo è di sola lettura.
Nella vista Account, non sono disponibili le seguenti impostazioni:
Nome società: campo di sola lettura.
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
Dominio: accesso di sola lettura.
E-mail: le impostazioni Elimina inviti e-mail di amministrazione e Selezione impostazioni internazionali e-mail sono di sola lettura.
Autenticazione: nessuna opzione per la modifica delle impostazioni di autenticazione e SSO.
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
Impostazioni chiamata: le impostazioni di priorità della chiamata delle opzioni dell'app sono di sola lettura.
Funzionamento chiamata: le impostazioni sono di sola lettura.
Posizione > PSTN: le opzioni Gateway locale e Cisco PSTN sono nascoste.
Sotto SERVIZI, le opzioni di servizio Migrazioni e Connected UC vengono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori partner possono utilizzare la procedura seguente per l'abilitazione Con limitazioni della modalità partner per una determinata organizzazione cliente (l' impostazione predefinita è abilitata).
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
Seleziona l'organizzazione cliente applicabile.
Nella vista Impostazioni di destra, abilitare il Con limitazioni della modalità partner per attivare l'impostazione.
Se si desidera disattivare la modalità Con limitazioni per partner, disabilitare l'interruttore.
Se il partner rimuove la modalità amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà eseguire quanto segue:
|
Analisi dei partner
I miglioramenti di Control Hub consentono agli amministratori partner di visualizzare e aggiornare facilmente le informazioni sui pacchetti per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata di tutti i clienti e include i seguenti dettagli:
Utenti totali per pacchetto (Softphone, Base, Standard, Premium)
Tendenza utenti per pacchetto (giornaliero/settimanale/mensile)
Clienti con n. di pacchetti assegnati
Per informazioni dettagliate su come utilizzare Analisi dei partner, vedere l'articolo Webex Analisi per i pacchetti Webex per la vendita all'ingrosso e Webex per BroadWorks in Partner Hub .
API di report fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare report di fatturazione. Nella tabella seguente vengono elencate le API, il tipo di accesso richiesto e i requisiti di ruolo.
API di fatturazione | Scopo | Tipo di accesso | Requisiti di ruolo per API (L'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Creazione di un report di fatturazione BroadWorks | Utilizzato per generare un report di fatturazione. | Accesso in scrittura |
|
Elenca report di fatturazione BroadWorks | Consente di elencare i report disponibili per la visualizzazione. | Accesso in lettura |
|
Ottenere un report di fatturazione BroadWorks | Utilizzato per ottenere una copia di un report generato. | Accesso in lettura |
|
Eliminazione di un report di fatturazione BroadWorks | Utilizzato per eliminare un report generato. | Accesso scrittura |
|
Campi di fatturazione
Nella tabella seguente sono elencati i campi contenuti nel report generato.
Campo | Descrizione |
---|---|
nome rivenditore | Nome partner o ID organizzazione partner |
ID fatturazione | Identificativo di fatturazione univoco del partner o numero C |
IdImpresaSp | L'identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno | Stato versione di prova interna del cliente (Sì/No) |
ID utente | IDutente dell'abbonato su BroadWorks |
id abbonato | Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato | Sì/No |
Data iniziale | Data di provisioning dell'abbonato. |
dataInizioFatturazione | Data di inizio fatturazione in questo mese |
DataFineFatturazione | Data di fine fatturazione in questo mese |
pacchetto | Il tipo di confezione che viene caricata |
quantità | Quantità ripartita per fatturazione.
|
|
Risoluzione dei problemi di Webex per Cisco BroadWorks
Abbonamento alla pagina di stato Webex
Innanzitutto verificare https://status.webex.com quando si verifica un'interruzione imprevista del servizio. Se non hai modificato la tua configurazione in Control Hub o BroadWorks prima dell'interruzione, controlla la pagina di stato. Ulteriori informazioni sull'iscrizione per le notifiche di stato e incidenti al Centro assistenza Webex.
Usa analisi Control Hub
Webex monitora l'utilizzo e i dati di qualità per la tua organizzazione e le organizzazioni dei tuoi clienti. Ulteriori informazioni sulle analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
Clienti o utenti non vengono creati in Control Hub con provisioning flowthrough:
Il server applicazioni può raggiungere l'URL di provisioning?
L'account di provisioning e la password sono corretti? Tale account esiste in BroadWorks?
I cluster non riescono in modo coerente a eseguire i test di connettività:
La connessione mTLS al servizio di autenticazione non riesce quando si crea il primo cluster in Partner Hub, poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. In caso contrario, non è possibile creare un'ancora attendibile sul servizio di autenticazione XSP|ADPs, pertanto la connessione mTLS di prova da Partner Hub non viene eseguita correttamente. |
Le interfacce XSP|ADP sono accessibili pubblicamente?
Stai utilizzando le porte corrette? È possibile immettere una porta nella definizione dell'interfaccia sul cluster.
Convalida non riuscita interfacce
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Esaminare i consigli per la configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Rivedere i consigli sulla configurazione dell'interfaccia in questo documento, con particolare attenzione a:
- Accertarsi di aver condiviso le chiavi RSA tra tutti gli XSP|ADP.
- Accertarsi di aver fornito l'URL AuthService al contenitore Web su tutti gli XSP|ADP.
- Se è stata modificata la configurazione della crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'|ADP XSP richiede di immettere il formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento elencava erroneamente le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati sul proprio archivio attendibile XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere i certificati del client?
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere i certificati del client?
Problemi del cliente
Verificare che il client sia connesso a BroadWorks
Accedere all'app Webex.
Verificare che l'icona Opzioni di chiamata (un ricevitore con una marcia sopra) sia presente sulla barra laterale.
Se l'icona non è presente, l'utente potrebbe non essere ancora abilitato per il servizio di chiamata in Control Hub.
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici . Viene visualizzato lo stato Sessione SSO A cui è stato eseguito l'accesso.
Se viene visualizzato un servizio telefonico diverso, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Tale verifica comporta:
Il client ha eseguito correttamente il transveresed dei microservizi Webex richiesti.
Autenticazione dell'utente eseguita correttamente.
Il client ha ricevuto un token Web JSON di lunga durata dal sistema BroadWorks.
Il client ha recuperato il proprio profilo dispositivo e si è registrato su BroadWorks.
Registri client
Tutti i client dell'app Webex possono Inviare I Registri a Webex. Questa è l'opzione migliore per i client mobili. È inoltre necessario registrare l'indirizzo e-mail dell'utente e l'ora approssimativa in cui si è verificato il problema se si sta cercando assistenza da TAC. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se è necessario raccogliere manualmente i registri da un PC Windows, si trovano come segue:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac:/Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS configurata male
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
Verificare che la catena di certificati Webex sia installata come ancora affidabile.
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e firmato da una CA ben nota.
Messaggio di eccedenza licenza
Questo messaggio può apparire per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'utilizzo delle licenze supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Politica di supporto allo stato stazionario
Il provider di servizi è il primo punto di contatto per il supporto del cliente finale (aziendale). Inoltrare i problemi che il SP non è in grado di risolvere al centro TAC. Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Politica di escalation
Tu (provider di servizi/partner) sei il primo punto di contatto per il supporto clienti finali (aziendale).
I problemi che non possono essere risolti dal SP vengono inoltrati al centro TAC.
Versioni di BroadWorks
Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Risorse di autosupporto
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, dove è presente una pagina specifica di Webex per Cisco BroadWorks che elenca argomenti di Guida e supporto comuni dell'app Webex.
L'app Webex può essere personalizzata con questo URL della Guida e un URL di segnalazione problemi.
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I registri vengono inviati al cloud Webex, dove possono essere analizzati da Webex DevOps.
È disponibile anche una pagina Centro assistenza dedicata alla Guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccogliere informazioni per l'invio di una richiesta di assistenza
Quando vengono visualizzati errori in Control Hub, potrebbero essere allegate informazioni che possono aiutare TAC a indagare sul problema. Ad esempio, se viene visualizzato un ID di verifica per un particolare errore o un codice di errore, salvare il testo da condividere con noi.
Prova a includere almeno le seguenti informazioni quando invii una query o apri un caso:
ID organizzazione cliente e ID organizzazione partner (ogni ID è una stringa di 32 cifre esadecimali, separate da trattini)
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce uno
Indirizzo e-mail utente (se un particolare utente riscontra problemi)
Versioni del cliente (se il problema presenta sintomi notati attraverso il cliente)
Confronto UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > | SaaS UC-One | Webex per Cisco BroadWorks |
---|---|---|
Cloud | Cisco UC-One Cloud (GCP) | Webex Cloud (AWS) |
Client | UC-One: Mobile, desktop Receptionist, Supervisore | Webex: Mobile, desktop, Web |
Principale differenza tecnologica | Riunioni condotte sulla tecnologia BroadSoft Meet | Riunioni fornite sulla tecnologia Webex Meetings |
Prove sul campo iniziali | Contesto di stadiazione, clienti beta | Ambiente di produzione, clienti GA |
Identità utente | ID BroadWorks servito come ID principale, a meno che il provider di servizi non disponga già dell'integrazione SSO.
ID utente e segreto in BroadWorks | ID e-mail in Cisco CI serve come ID principale Integrazione SSO in BroadWorks provider di servizi in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks al momento.
L'utente fornisce le credenziali tramite SSO con BroadWorks e Secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e segreti in IdP |
Autenticazione client | Gli utenti forniscono le credenziali attraverso il client Token di lunga durata BroadWorks richiesti se si utilizza la messaggistica Webex | Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso a Webex e aggiornamento dei token |
Gestione / configurazione | I vostri sistemi OSS/BSS e Portale rivenditore | I tuoi sistemi OSS/BSS e Control Hub |
Attivazione partner/provider di servizi | Impostazione una tantum da Cisco Operations | Impostazione una tantum da Cisco Operations |
Attivazione cliente/azienda | Portale rivenditore | Control Hub Creato automaticamente alla prima iscrizione utente |
Opzioni di attivazione utente | Autoiscrizione Imposta IM&P esterno in BroadWorks
| Impostazione di IM&P integrato in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP | Azioni XSI
XSI-Eventi CTI (mTLS) AuthService (mTLS opzionale) DMS | Azioni XSI Azioni XSI (mTLS) XSI-Eventi CTI (mTLS) Servizio di autenticazione (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 | Scarica e installa Webex. Per informazioni dettagliate, vedi Webex | Download dell'app. |
2 | Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 | Inserisci l'indirizzo e-mail e fai clic su Avanti. |
4 | Una delle seguenti operazioni si verifica, a seconda del modo in cui l'organizzazione è configurata in Webex: Webex si carica dopo aver eseguito correttamente l'autenticazione su IdP o BroadWorks.
|
Scambio e archiviazione dati
Queste sezioni forniscono dettagli sullo scambio e la memorizzazione dei dati con Webex. Tutti i dati vengono crittografati sia in transito che a riposo. Per ulteriori informazioni, vedi Webex App Security.
Onboarding provider servizi
Quando si configurano cluster e modelli utente in Webex Control Hub durante l'onboarding di provider di servizi, è possibile scambiare i seguenti dati BroadWorks memorizzati in Webex:
URL Xsi-Actions
URL Xsi-Events
URL interfaccia CTI
URL servizio di autenticazione
Credenziali adattatore di provisioning BroadWorks
Provisioning utente provider di servizi
Questa tabella elenca i dati utente e aziendale che vengono scambiati come parte del provisioning utente attraverso le API Webex.
Trasferimento dei dati in Webex | Da | Attraverso | Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito da SP) | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito dall’utente) | Utente | Portale di attivazione utente | Sì |
Nome | BroadWorks, per API | API Webex | Sì |
Cognome | BroadWorks, per API | API Webex | Sì |
Numero di telefono principale | BroadWorks, per API | API Webex | Sì |
Numero telefono cellulare | BroadWorks, per API | API Webex | Sì |
Estensione principale | BroadWorks, per API | API Webex | Sì |
ID provider di servizi BroadWorks e ID gruppo | BroadWorks, per API | API Webex | Sì |
Lingua | BroadWorks, per API | API Webex | Sì |
Fuso orario | BroadWorks, per API | API Webex | Sì |
Rimozione utente
Le API Webex per Cisco BroadWorks supportano la rimozione parziale e completa dell'utente. Questa tabella elenca tutti i dati utente memorizzati durante il provisioning e ciò che viene eliminato in ogni scenario.
Dati utente | Eliminazione parziale | Eliminazione completa |
---|---|---|
ID utente BroadWorks | Sì | Sì |
No | Sì | |
Nome | No | Sì |
Cognome | No | Sì |
Numero di telefono principale | Sì | Sì |
Numero telefono cellulare | Sì | Sì |
Estensione | Sì | Sì |
ID provider di servizi BroadWorks e ID gruppo | Sì | Sì |
Lingua | No | Sì |
Accesso utente e recupero configurazione
Autenticazione Webex
L'autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da uno qualsiasi dei meccanismi di autenticazione del supporto Webex. (L'autenticazione BroadWorks è trattata separatamente.) Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (indipendente) | Webex | Browser utente |
Credenziali utente | Browser utente | Provider identità (che dispone già di identità utente) |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Autenticazione BroadWorks
L'autenticazione BroadWorks si riferisce all'accesso dell'utente a un'app Webex utilizzando le credenziali BroadWorks. Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (proxy Webex Bwks IdP) | Webex | Browser utente |
Informazioni sul branding e URL BroadWorks | Webex | Browser utente |
Credenziali utente BroadWorks | Utente tramite browser (pagina di accesso con marchio servita da Webex) | Webex |
Credenziali utente BroadWorks | Webex | BroadWorks |
Profilo utente BroadWorks | BroadWorks | Webex |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento dell'avviso di accesso e del messaggio di errore:
- Attualmente gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso poiché la password è già scaduta. Con questa funzione, se la password sta per scadere tra 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere, con l'indicazione di quanti giorni rimangono, e all'utente viene consigliato di contattare il partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su true, è stato emesso l'errore "nome utente e password errati", ma ora con questa funzione viene migliorato il messaggio di errore: Tentativo di accesso non riuscito. La combinazione di ID utente e password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice errore 100006
Controllo flusso di accesso:
- Il partner può limitare l'accesso abilitando un'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione in broadworks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, quindi viene visualizzato un errore che indica che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso può essere configurato dal partner come parte della funzione di personalizzazione avanzata. I partner solitamente configurano il collegamento per passare dall'utente a un portale partner per la gestione della password e la reimpostazione della password.
Questa funzione migliora l'esperienza di accesso utente solo durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se una password scade mentre l'utente è connesso all'app Webex. L'utente riceve la notifica di scadenza della password al successivo tentativo di accesso. |
Recupero configurazione cliente
Questa tabella illustra la tipologia di dati scambiati tra le diverse componenti in fase di recupero delle configurazioni del cliente.
Trasferimento dei dati | Da | Per |
---|---|---|
Iscrizione | Client | Webex |
Impostazioni organizzazione, inclusi URL BroadWorks | Webex | Client |
Token JWT BroadWorks | BroadWorks attraverso Webex | Client |
Token JWT BroadWorks | Client | BroadWorks |
Token dispositivo | BroadWorks | Client |
Token dispositivo | Client | BroadWorks |
File di configurazione | BroadWorks | Client |
Utilizzo allo stato stazionario
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione dopo la scadenza del token, tramite BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Trasferimento dei dati | Da | Per |
---|---|---|
Segnalazione SIP | Client | BroadWorks |
Supporto SRTP | Client | BroadWorks |
Segnalazione SIP | BroadWorks | Client |
Supporto SRTP | BroadWorks | Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Trasferimento dei dati | Da | Per |
---|---|---|
Messaggistica e presenza REST HTTPS | Client | Webex |
Messaggistica e presenza REST HTTPS | Webex | Client |
Segnalazione SIP | Client | Webex |
Supporto SRTP | Client | Webex |
Segnalazione SIP | Webex | Client |
Supporto SRTP | Webex | Client |
Uso dell'API di provisioning
Accesso sviluppatore
Le specifiche API sono disponibili su https://developer.webex.com e una guida all'uso è disponibile su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l' accedere per leggere la specifica API all'indirizzohttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Autenticazione e autorizzazione applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (ad esempio provisioning abbonato) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere l'aggiornamento e l'accesso ai token per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
Devi prima registrare la tua integrazione con Webex. Una volta eseguita la registrazione, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di accesso e aggiornamento necessari.
Per ulteriori dettagli sulle integrazioni e sulle modalità di creazione di questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli obbligatori per l'implementazione delle integrazioni: sviluppatore e utente autorizzatore, che possono essere svolti da persone/team separati nel proprio ambiente.
|
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning utilizzata:
Modalità Enterprise: il nome dell'organizzazione corrisponde esattamente a spEnterpriseId.
Modalità provider di servizi: il nome dell'organizzazione è la parte groupID di spEnterpriseId.
Il nome dell'organizzazione conterrà qualsiasi spazio vuoto, maiuscolo e caratteri speciali specificati in spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "attuale" con le ultime patch BroadWorks e le app Release Independent (RI). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Assicurarsi di rivedere le note di patch per queste patch software. Alcune patch potrebbero avere requisiti CLI aggiuntivi. |
Versione R22
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | ||
Richiesto per sincronizzazione rubrica | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per il server applicazioni | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per la funzione di registrazione chiamata | ||
Patch richiesta per il provisioning flow-through | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | Richiesto per proxy autenticazione NPS | |
Richiesto per il servizio di autenticazione con convalida token CI | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Obbligatorio per la cronologia chiamate unificata | ||
Altro | AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Richiesto per sincronizzazione rubrica | |
Configurazione server app | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Se si utilizza ADP... | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Versione R24
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per il provisioning flowthrough | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che è necessario configurare per Webex, fare riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utente e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. L'attivazione include la convalida e-mail e l'assegnazione del servizio in Webex. |
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se disponi di indirizzi e-mail affidabili per gli utenti, puoi scegliere di attivarli automaticamente quando esegui il provisioning automatico degli utenti. Questo processo è "provisioning automatico e attivazione automatica".
Provisioning utente automatizzato e attivazione automatica (flusso e-mail affidabile)
Prerequisiti
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase | Descrizione |
---|---|
1 | Citare e prendere ordini per il servizio con i clienti. |
2 | Si elabora l'ordine del cliente e si esegue il provisioning del cliente nei sistemi. |
3 | Il sistema di provisioning dei servizi attiva il provisioning di BroadWorks. Questo passaggio, in sintesi, crea l'azienda e gli utenti. Quindi assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM&P esterno. |
4 | Questo passaggio di provisioning attiva il provisioning automatico dell'organizzazione cliente e degli utenti in Webex. (L'assegnazione del servizio IM&P determina che l'adattatore di provisioning chiami l'API di provisioning Webex). |
5 | I sistemi devono utilizzare l'API di provisioning Webex se successivamente è necessario regolare il pacchetto per l'utente (per passare dall'impostazione predefinita). |
Flusso di accesso SSO
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, che consente l'autenticazione diretta a BroadWorks. L'immagine mostra gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresenta ciò che il client prevede per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizio BroadWorks che segue immediatamente il flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione BroadWorks diretta abilitata (condivisione risorse cross-origin). Di seguito sono riportati alcuni flussi di accesso SSO SAML alternativi:
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
L'unica differenza è nei punti 5 e 6 del flusso di accesso Webex. Nel passaggio 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
Il flusso procede attraverso i restanti passaggi dei due diagrammi.
Il token SSO non viene utilizzato in questo flusso.
Autenticazione SSO SAML Webex:
Nel passaggio 3 del flusso di accesso Webex, il servizio Common Identity restituisce il provider di identità utilizzato dall'autenticazione Webex.
A questo punto, viene invocato un flusso di accesso SSO SAML alternativo per Webex.
Interazioni utente
Accedi
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
CI rileva che l'organizzazione cliente associata dispone del proxy IDP BroadWorks (IDP) configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso (il provider di servizi può contrassegnare questa pagina di accesso).
L'utente inserisce le credenziali BroadWorks.
Broadworks esegue l'autenticazione dell'utente attraverso l'IDP. In caso di successo, l'IDP reindirizza il browser a CI con un SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
Una volta completata l'autenticazione, l'app Webex ottiene i token di accesso da CI (non mostrati nel diagramma). Il client li utilizza per richiedere un token Web Jason (JWT) di lunga durata BroadWorks.
L'app Webex rileva la configurazione di chiamata da BroadWorks e altri servizi da Webex.
L'app Webex si registra in BroadWorks.
Accesso dalla prospettiva dell'utente
Questo diagramma è il tipico flusso di accesso, visualizzato dall'utente finale o dall'abbonato:
Scarica e installa l'app Webex.
È possibile che tu abbia ricevuto il collegamento dal provider di servizi o che tu possa trovare il download nella pagina di download di Webex.
Inserire l'indirizzo e-mail nella schermata di accesso Webex. Fai clic su Avanti.
Solitamente, si viene reindirizzati a una pagina con il marchio del fornitore di servizi.
Questa pagina potrebbe accogliervi tramite il vostro indirizzo e-mail.
Se non è presente alcun indirizzo e-mail o se l'indirizzo e-mail è errato, inserisci il nome utente BroadWorks.
Inserisci la password BroadWorks.
Se è stato eseguito correttamente l'accesso, Webex si apre.
Flusso chiamate - Rubrica aziendale
Flusso chiamata: numero PSTN
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni con i clienti
Recupero del profilo dal registro DMS e SIP con AS
Il client chiama XSI per ottenere un token di gestione dispositivo e l'URL del DMS.
Il client richiede il proprio profilo dispositivo dal DMS presentando il token dal punto 1.
Il client legge il profilo del dispositivo e recupera le credenziali, gli indirizzi e le porte SIP.
Il Client invia un REGISTRO SIP a SBC utilizzando le informazioni dal punto 3.
SBC invia il REGISTRO SIP al SA (l'SBC può eseguire una ricerca nell'NS per individuare un SA se il SBC non conosce già l'utente SIP).
Linee guida per test e laboratorio
Le seguenti linee guida si applicano alle organizzazioni di test e laboratorio:
I partner provider di servizi sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
Tutti gli utenti oltre i primi 50 utenti di test verranno fatturati.
Per garantire un'elaborazione accurata sulla fattura, tutte le organizzazioni di test devono includere il "test" nel nome dell'organizzazione BroadWorks.
Le organizzazioni di test interni devono essere designate all'interno di Webex Control Hub. Ciò al fine di impedire agli utenti di test di essere fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di prova:
Accedi a Partner Hub e seleziona Clienti.
Selezionare il cliente appropriato.
Nella barra di controllo destra, abilitare il tasto di alternanza Organizzazione test interni.
Riproduzione casella vocale
Per la casella vocale, accertarsi di configurare il server multimediale per utilizzare uno dei seguenti codici:
mp3
wav: i file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android
Se si utilizzano i file wav, eseguire i seguenti comandi CLI per configurare il server applicazioni e il server multimediale:
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACIDITÀ
- Elenco di controllo accessi
- ALVEOLO
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APICI
- Servizio di notifica push Apple
- AS
- Server applicazioni
- ATA
- Adattatore per telefono analogico, adattatore che converte la telefonia analogica in VoIP
- BAMBOLA
- Gestione applicazioni BroadSoft
- Autenticazione base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- ALVEOLARE
- Server di messaggistica BroadSoft
- PALUDE
- Flussi bidirezionali Su HTTP sincrono
- BRI
- Basic Rate Interface BRI è un metodo di accesso ISDN
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico telefonico (cfr. partner, provider di servizi, rivenditore a valore aggiunto)
- CAPTCHA
- Test di Turing pubblico completamente automatizzato per distinguere Computer ed Esseri Umani
- CCXML
- Linguaggio di markup eXtensible controllo chiamate
- CIF
- Formato intermedio comune
- CLI
- Interfaccia riga di comando
- CN
- Nome comune
- CNPS
- Server push notifiche chiamate. Un server push notifiche che viene eseguito su un ADP XSP| nel proprio ambiente per eseguire notifiche di chiamata push su FCM e APNS. Vedere il proxy NPS.
- CPE
- Attrezzatura della sede del cliente
- CPR
- Regola presenza personalizzata
- CENERE
- Foglio stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione telefonia computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- NoDist
- Non disturbare
- DNS
- Sistema dei nomi di dominio
- DPG
- Chiama gruppo di pari
- DSCP
- Punto codice servizi differenziati
- DTAF
- File di archivio tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza a doppia tonalità
- Utente finale
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. Sottoscrittore)
- Aziendale
- Una raccolta di utenti finali (cfr. Organizzazione)
- FUSO
- Messaggistica cloud Firebase
- DI FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creare utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning completo flow-through
- Creare e verificare gli utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks e asserendo che ciascun utente BroadWorks dispone di un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. È la spina sul telefono o fax o i connettori sul sistema telefonico analogico. Fornisce un'indicazione di aggancio/aggancio sganciato (chiusura con loop). Poiché la porta FXO è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo FXO".
- FXS
- Foreign Exchange Subscriber è la porta che effettivamente fornisce la linea analogica all'abbonato. In altre parole, è la "spina nella parete" che fornisce un segnale di linea, corrente della batteria e tensione della suoneria.
- GABBIA
- Messaggio cloud Google
- GABBIA
- Modalità Galois/Counter (tecnologia di crittografia)
- HID
- Dispositivo interfaccia uomo
- HTTPS
- Prese protette da protocollo di trasferimento ipertestuale
- IAD
- Dispositivo di accesso integrato
- IM&P
- messaggistica istantanea e presenza
- PSTN IP
- Un provider di servizi che fornisce VoIP ai servizi PSTN, intercambiabile con ITSP, o un termine generale per la telefonia "pubblica" connessa a Internet, fornito collettivamente dai principali provider di telecomunicazioni (piuttosto che dai paesi, come è PSTN)
- ITSP
- Provider servizi di telefonia Internet
- IVR
- Risposta vocale/risponditore interattiva
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificatore Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notazione oggetto script Java
- JESS
- Java Secure Socket Extension; la tecnologia sottostante che fornisce funzioni di connettività sicure ai server BroadWorks
- KEM
- Modulo interno chiave (telefoni Cisco hardware)
- LLT
- Token di lunga durata (o Long Life): token di connessione autodescrittivo e sicuro che consente agli utenti di rimanere autenticati più a lungo e non è legato ad applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIGLIO
- Base di informazioni di gestione
- AVV.
- Server multimediale
- mTLS
- Autenticazione reciproca tra due parti, tramite scambio di certificati, quando si stabilisce una connessione TLS
- MUCO
- Chat con più utenti
- NAT
- Traduzioni dell'indirizzo di rete
- NPS
- Server push notifica; vedere CNPS
- Proxy NPS
-
Un servizio in Webex che fornisce token di autorizzazione di breve durata al CNPS, consentendo di eseguire notifiche di chiamata push a FCM e APN e, in ultima analisi, a dispositivi Android e iOS con Webex.
- ASSOCIAZIONE
- Apri interfaccia client
- Organizzazione
- Società o organizzazione che rappresentano un insieme di utenti finali (cfr. Impresa)
- OTG
- Gruppo di trunk in uscita
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- Partner
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. rivenditore a valore aggiunto, fornitore di servizi, gestore telefonico)
- PBX
- Borsa filiale privata
- DELLA SOCIETÀ
- E-mail avanzata per la privacy
- PIEDINO
- Rete mobile terrestre pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia per le telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- P.ES.
- Server profilo
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Sito web che consente all’amministratore del rivenditore di configurare la soluzione UC-One SaaS. Talvolta viene indicato come portale BAM, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Revisore di frontiera sessione
- CEMENTAZIONE
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; un'organizzazione che fornisce servizi di telefonia o correlati ad altre organizzazioni (cfr. vettore, partner, rivenditore a valore aggiunto)
- SIP
- Protocollo di avvio sessione
- SLITTA
- Token di breve durata (o Short Life) (chiamato anche BroadWorks SSO Token); token autenticato monouso utilizzato per accedere in sicurezza ad applicazioni Web.
- ODORE
- Piccole e medie imprese
- SNMP
- Protocollo di gestione di rete semplice
- sRTCP
- protocollo di controllo trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- sRTP
- protocollo di trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- SSL
- Strato di prese sicure
- Abbonato
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. utente finale)
- TCP
- Protocollo di controllo del cambio
- TDM
- Divisione Tempo Multiplexing
- TLS
- Sicurezza livello trasporto
- ToS
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Comunicazioni unificate
- UI
- Interfaccia utente
- U ID
- Identificativo univoco
- MUTI
- Server di messaggistica
- URI
- Identificativo risorsa uniforme
- URL
- Ricerca risorse uniformi
- DISTURBO
- Condivisione server
- UTC
- Coordinated Universal Time
- UVS.
- Server video
- Rivenditore a valore aggiunto (VAR)
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. vettore, partner, fornitore di servizi)
- VAMPATA
- Array di grafica video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Linguaggio di markup estensibile vocale
- WebDAV
- Creazione e versioni distribuite su Web
- WebRTC
- Comunicazioni Web in tempo reale
- WRS
- Server WebRTC
- XMPP
- Protocollo di presenza e messaggistica estendibile
Configurazione dei servizi (con mTLS per il servizio autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida token CI. Queste procedure sono obbligatorie se si stanno eseguendo più organizzazioni Webex dallo stesso server ADP XSP|. In caso contrario, sono facoltativi.
Se non si eseguono più organizzazioni Webex sullo stesso server ADP XSP|, si consiglia la convalida del token CI (con TLS) per il servizio di autenticazione. Fare riferimento a Configura servizi su Webex per Cisco BroadWorks XSP|ADPs per informazioni dettagliate su come configurare il servizio di autenticazione e altri servizi. |
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con mTLS)
I token longevi di BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sui tuoi XSP|ADP.
Requisiti
I server XSP|ADP che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
XSP|ADP devono condividere le stesse chiavi per crittografare/decrittografare token di lunga durata BroadWorks. Copiare queste chiavi in ogni XSP|ADP è un processo manuale.
Gli ADP XSP|devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli XSP|ADP include:
Distribuire il servizio di autenticazione.
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
Generare e condividere le chiavi RSA su XSP|ADP.
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ogni XSP|ADP utilizzato con Webex:
Attivare l'applicazione del servizio di autenticazione sul percorso
/authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService
(dove
<version>
è la versione BroadWorks).Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
deploy application /authService
Configurazione della durata del token
Verificare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
Impostare la durata su 60 giorni (max 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
set tokenDurationInHours 1440
Genera e condividi chiavi RSA
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori è necessario generare chiavi su un XSP|ADP quindi copiarle su tutti gli altri XSP|ADP.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP. |
Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web
Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token.
Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità per il servizio di autenticazione (con mTLS)
Accedi a Control Hub con l'account amministratore del partner.
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
.Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
.Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Esegui GuidaUpdateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot2023
,webexclientissuing
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte e quattro le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, è richiesto mTLS per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/HttpServer>
e eseguire ilget
comando per visualizzare le interfacce.Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che significa come mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. In sostanza, il primo
true
protegge l'interfaccia con TLS (il certificato del server viene creato se richiesto) e la secondatrue
forza l'interfaccia a richiedere l'autenticazione del certificato del client (insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Interface Port Name Secure Client Auth Req Cluster Fqdn
=======================================================
192.0.2.7 443 XSP|ADP01.collab.example.net true false
192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (autenticazione client richiesta = true) è abilitato il 192.0.2.7
porta 444
. TLS abilitato su 192.0.2.7
porta 443
.
(Opzione) Configurazione di mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, è necessario mTLS per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
e eseguire ilget
per visualizzare le applicazioni in esecuzione.Per aggiungere un'applicazione e richiederne l'autenticazione client (ovvero mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. I nomi delle applicazioni sono elencati qui. Il
true
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
add 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService a 192.0.2.7:443 e richiede di richiedere e autenticare i certificati dal client.
Verifica con get
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
get
Interface Ip Port Application Name Client Auth Req
===================================================
192.0.2.7 443 AuthenticationService true
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Dove andare Avanti
Per la configurazione, è possibile accedere nuovamente al flusso dei documenti principale all'interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca rispetto a AuthService
Webex interagisce con il servizio di autenticazione su una connessione TLS autenticata reciproca. Ciò significa che Webex presenta un certificato client e che XSP|ADP deve convalidarlo. Per garantire l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora attendibile su XSP|ADP (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
Vai a Impostazioni > BroadWorks Calling.
Fare clic sul collegamento del certificato di download.
È inoltre possibile scaricare la catena di certificati da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt. |
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il diagramma seguente riassume dove deve essere distribuita la catena di certificati CA Webex in questi tre casi.
Requisiti del certificato TLS reciproco per proxy bridge TLS
Webex presenta un certificato client firmato da CA Webex al proxy.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità proxy, pertanto il proxy considera attendibile il certificato del client.
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta un certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions:
X509v3 Extended Key Usage:
1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Requisiti di certificato TLS reciproco per proxy passthrough TLS o XSP in DMZ
Webex presenta un certificato client firmato da CA Webex agli XSP.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità degli XSP, pertanto gli XSP si affidano al certificato client.
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
Gli XSP presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i certificati server degli XSP.
Cronologia revisioni documenti
La tabella seguente mostra lo storico delle modifiche apportate a questo documento negli ultimi 12 mesi.
Data | Versione | Descrizione della modifica | |
---|---|---|---|
27 marzo 2024 | 2-113 |
| |
22 marzo 2024 | 2-112 |
| |
7 marzo 2024 | 2-111 |
| |
24 febbraio 2024 | 2-110 |
| |
20 febbraio 2024 | 2-109 |
| |
7 febbraio 2024 | 2-108 |
| |
25 gennaio 2024 | 2-107 |
| |
23 gennaio 2024 | 2-106 |
| |
10 gennaio 2024 | 2-105 |
| |
20 dicembre 2023 | 2-104 |
| |
13 dicembre 2023 | 2-103 |
| |
12 dicembre 2023 | 2-102 |
| |
8 dicembre 2023 | 2-101 |
| |
08 novembre 2023 | 2-100 |
| |
25 ottobre 2023 | 2-99 |
| |
13 settembre 2023 | 2-98 |
| |
04 settembre 2023 | 2-97 |
| |
08 agosto 2023 | 2-96 |
| |
23 giugno 2023 | 2-95 |
| |
30 maggio 2023 | 2-94 |
| |
26 maggio 2023 | 2-93 |
| |
24 maggio 2023 | 2-92 |
| |
10 maggio 2023 | 2-91 |
| |
09 maggio 2023 | 2-90 |
| |
4 maggio 2023 | 2-89 |
| |
27 aprile 2023 | 2-88 |
| |
14 aprile 2023 | 2-87 |
| |
17 marzo 2023 | 2-86 |
| |
11 marzo 2023 | 2-85 |
| |
10 marzo 2023 | 2-84 |
| |
7 marzo 2023 | 2-83 |
| |
28 febbraio 2023 | 2-82 |
| |
15 febbraio 2023 | 2-81 |
| |
10 febbraio 2023 | 2-80 |
| |
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione si rivolge agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei propri clienti o forniscono questa soluzione direttamente ai propri abbonati.
Scopo della soluzione
Fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che già dispongono del servizio di chiamata fornito dai provider di servizi BroadWorks.
Fornire il servizio di chiamata basato su BroadWorks a clienti Webex piccoli e medi.
Contesto
Stiamo evolvendo tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo sforzo consiste nello spostare le funzionalità di chiamata BroadWorks nell'app Webex e infine ridurre gli investimenti nei client UC-One.
Vantaggi
Prova futura: contro interruzione del servizio di UC-One Collaborate, spostamento di tutti i client verso Unified Client Framework (UCF)
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex mantenendo la chiamata BroadWorks sulla rete di telefonia
Ambito della soluzione
Clienti da piccoli a medi esistenti/nuovi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre di chiamate BroadWorks.
Clienti Webex esistenti di piccole e medie dimensioni che desiderano aggiungere BroadWorks Calling.
Non aziende più grandi (rivedere il nostro portfolio Enterprise per Webex).
Non utenti singoli (valutare le offerte Webex Online).
Le funzioni impostate in Webex per Cisco BroadWorks riguardano casi d'uso di piccole e medie imprese. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità per le PMI e ne valutiamo costantemente l'idoneità per questo segmento. Possiamo scegliere di nascondere o rimuovere funzioni che sarebbero altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# | Requisito | Note | ||
---|---|---|---|---|
1 | Patch BroadWorks R22 corrente o superiore | |||
2 | XSP|ADP per XSI, CTI, DMS e authService | XSP|ADP dedicato per Webex per Cisco BroadWorks | ||
3 | XSP|ADP separato per NPS, può essere condiviso con altre soluzioni che utilizzano NPS. | Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni XSP|ADP e NPS. | ||
4 | Convalida token CI (con TLS) configurata per le connessioni Webex al servizio di autenticazione. | |||
5 | mTLS configurato per le connessioni Webex all'interfaccia CTI. | Altre applicazioni non richiedono mTLS. | ||
6 | Gli utenti devono essere presenti in BroadWorks e necessitano dei seguenti attributi, a seconda della decisione di provisioning:
| Per i messaggi e-mail attendibili: Si consiglia di inserire lo stesso indirizzo e-mail anche nell'attributo ID alternativo, per consentire agli utenti di accedere con indirizzo e-mail rispetto a BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'uso di e-mail non attendibili può causare l'invio dell'e-mail alla cartella Posta indesiderata o SPAM dell'utente. L'amministratore potrebbe dover modificare le impostazioni e-mail dell'utente per consentire i domini | ||
7 | Webex per il file DTAF Cisco BroadWorks per l'app Webex | |||
8 | Utente BW Business Lic o Std Enterprise o Prem Enterprise Lic + Webex per abbonamento Cisco BroadWorks | Se si dispone di una distribuzione di collaborazione esistente, non è più necessario il pacchetto aggiuntivo UC-One, le porte per conferenze Collab Lic e Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non occorre apportare altre modifiche se non accettare i termini del pacchetto Premium. | ||
9 | IP/porte devono essere accessibili attraverso i servizi backend Webex e le app Webex su Internet pubblico. | Vedere la sezione "Preparazione della rete". | ||
10 | Configurazione TLS v1.2 su XSP|ADP | |||
11 | Per il provisioning Flowthrough, il server applicazioni deve connettersi all'adattatore di provisioning BroadWorks.
| Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è aiutarti a comprendere, preparare, distribuire e gestire la tua soluzione Webex per Cisco BroadWorks. Le principali sezioni del documento riflettono tale obiettivo.
Questa guida include materiale concettuale e di riferimento. In questo documento intendiamo trattare tutti gli aspetti della soluzione.
La serie minima di attività per distribuire la soluzione è la seguente:
Contatta il team dell'account per diventare un partner Cisco. È fondamentale esplorare i punti di contatto Cisco per acquisire familiarità (e ricevere formazione). Quando si diventa partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Onboarding partner in questo documento.
Configura i tuoi sistemi BroadWorks per l'integrazione con Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento.
Usa Partner Hub per connettere Webex a BroadWorks. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione partner in Partner Hub in questo documento.
Utilizzare Partner Hub per preparare i modelli di provisioning degli utenti. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento.
Testare e eseguire l'onboarding di un cliente mediante il provisioning di almeno un utente (vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
|
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. (Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto).
Come funziona
Webex per Cisco BroadWorks è un'offerta che integra BroadWorks Calling in Webex. Gli abbonati utilizzano una singola applicazione (l'app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
Gli utenti chiamano i numeri PSTN utilizzando l'infrastruttura BroadWorks.
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino numerico per introdurre i numeri).
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Chiamata Webex" sull'app Webex. (Queste chiamate sono da app Webex a app Webex, non da app Webex a PSTN).
Gli utenti possono organizzare e accedere a Webex Meetings.
Gli utenti possono scambiarsi messaggi uno a uno o in spazi (chat di gruppo persistente) e beneficiare di funzioni come ricerca e condivisione file (sull'infrastruttura Webex).
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
Una volta eseguito l'onboarding come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare la relazione tra l'istanza BroadWorks e Webex.
È possibile creare organizzazioni dei clienti in Control Hub e eseguire il provisioning degli utenti in tali organizzazioni.
Ogni abbonato in BroadWorks riceve un'identità Webex in base al proprio indirizzo e-mail (attributo ID e-mail in BroadWorks).
Gli utenti eseguono l'autenticazione su BroadWorks o su Webex.
Ai clienti vengono rilasciati token di lunga durata per autorizzarli per i servizi su BroadWorks e Webex.
L'app Webex al centro di questa soluzione, è un'applicazione personalizzabile disponibile su desktop Mac/Windows e dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzionalità di messaggistica, presenza e riunioni.
Il client esegue la registrazione ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i tuoi sistemi BroadWorks per garantire un'esperienza di provisioning utente perfetta.
Funzioni e limitazioni
Offriamo diversi pacchetti con diverse caratteristiche.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata, ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano nella rubrica un utente softphone, i risultati della ricerca non forniscono alcuna opzione per inviare un messaggio.
Gli utenti del softphone possono condividere lo schermo durante una chiamata.
Pacchetto "base"
Il pacchetto di base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti in riunioni a "spazio unificato" e riunioni nella sala riunioni personale. (** vedere la seguente nota a titolo di eccezione). In questo pacchetto le riunioni possono avere una durata massima di 40 minuti.
Pacchetto "Standard"
Questo pacchetto include anche tutto quello che è contenuto nel pacchetto Base, ad esempio fino a 100 partecipanti nelle riunioni "spazio unificato" e nelle riunioni nella sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è un ruolo inizialmente ricoperto solo dall'organizzatore della riunione, ma l'organizzatore può passare il "ruolo di relatore" a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può riprendere il ruolo di relatore senza che l'organizzatore corrente glielo passi.
Pacchetto "Premium"
Questo pacchetto include tutto nel pacchetto Standard più un massimo di 300 partecipanti in una riunione "spazio unificato" e fino a 1000 partecipanti in una sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è supportata per qualsiasi partecipante alla riunione.
Confronta pacchetti
Pacchetto | Chiamata | Messaggistica | Riunioni nello spazio Unified | PMR riunioni |
---|---|---|---|---|
Softphone | Incluso | Non incluso | Nessuno | Nessuno |
Base | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Standard | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Premium | Incluso | Incluso | 300 partecipanti | 1000 partecipanti |
Il limite della riunione nello spazio Unified per gli utenti Base è 100 partecipanti per riunione nello spazio Unified a meno che lo spazio non includa anche gli utenti a cui sono assegnati i pacchetti "Standard" o "Premium", nel qual caso il limite aumenta in base al pacchetto utente organizzatore. |
"Riunioni nello spazio Unified" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti "Riunione" o "Pianifica". "Riunioni PMR" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale (PMR) di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID). |
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per le differenze di supporto delle funzioni di riunione PMR per i pacchetti Base, Standard e Premium.
Funzione riunione | Supportato con il pacchetto base | Suported con pacchetto standard | Supportato con il pacchetto Preminum | Commento |
---|---|---|---|---|
Durata riunione | 40 minuti o meno | Illimitato | Illimitato | |
Condivisione desktop | Sì | Sì | Sì | Base: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione desktop solo da parte dell'organizzatore della riunione PMR. Premium: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. |
Condivisione applicazione | Sì | Sì | Sì | Base: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione delle applicazioni solo da parte dell'organizzatore della riunione PMR. Premium: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. |
Chat con più interlocutori | Sì | Sì | Sì | |
Lavagna | Sì | Sì | Sì | |
Protezione con password | Sì | Sì | Sì | |
App Web - nessun download o plug-in (Esperienza ospite) | Sì | Sì | Sì | |
Supporto dell'accoppiamento con i dispositivi Webex | Sì | Sì | Sì | |
Controllo del pavimento (disattivazione del microfono uno / espulsione tutti) | Sì | Sì | Sì | |
Collegamento Riunioni persistenti | Sì | Sì | Sì | |
Accesso sito riunioni | Sì | Sì | Sì | |
Accesso alla riunione tramite VoIP | Sì | Sì | Sì | |
Bloccaggio | Sì | Sì | Sì | |
Controlli relatore | No | No | Sì | |
Controllo desktop remoto | No | No | Sì | |
Numero di partecipanti | 100 | 100 | 1000 | |
Registrazione salvata in locale nel sistema | Sì | Sì | Sì | |
Registrazione nel cloud | No | No | Sì | |
Registrazione - Cloud Storage | No | No | 10 GB per sito | |
Trascrizione delle registrazioni | No | No | Sì | |
Pianificazione riunione | Sì | Sì | Sì | |
Abilita condivisione contenuto con integrazioni esterne | No | No | Sì | Base: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. Standard: condivisione di contenuto solo da parte dell'organizzatore della riunione PMR. Premium: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. |
Consenti modifica URL PMR | No | No | Sì | Base: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori dei partner e delle organizzazioni possono modificare l'URL da Control Hub. Standard: l'URL PMR può essere modificato solo da Partner Hub per Partner e amministratori organizzazione. Premium: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori partner e dell'organizzazione possono modificare l'URL da Partner Hub. |
Streaming in diretta riunioni (Ad Esempio, su Facebook, Youtube) | No | No | Sì | |
Consenti ad altri utenti di pianificare riunioni per loro conto | No | No | Sì | |
Aggiungi organizzatore alternativo | Sì | No | Sì | |
Integrazione app (es., Zendesk, Slack) | Dipende dall'integrazione | Dipende dall'integrazione | Sì | Per ulteriori informazioni sul supporto, vedere la sezione Integrazioni app riportata di seguito. |
Integrazione con il calendario Microsoft Office 365 | Sì | Sì | Sì | |
Integrazione con Google Calendaring per G Suite | Sì | Sì | Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione rivolta agli utenti per Webex su help.webex.com
. Per ulteriori informazioni sulle funzioni, leggere i seguenti articoli:
Funzioni di chiamata
L'esperienza di chiamata è simile alle soluzioni precedenti che utilizzano il motore di controllo delle chiamate BroadWorks. La differenza tra UC-One Collaborate e UC-One SaaS è che l'app Webex è il client software principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
Zendesk—Solo Premium
Slack: solo Premium
Microsoft Teams per Webex Meetings—Standard o Premium
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
Calendario Office 365—Standard o Premium
Google Calendaring per G Suite: standard o premium
Supporto dell'infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta gli ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione per Webex per l'infrastruttura desktop virtuale (VDI).
Supporto per IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Pro Pack per Control Hub
Il servizio componente aggiuntivo Pro Pack per Control Hub fornisce ad amministratori, professionisti della sicurezza delle informazioni e responsabili della conformità funzionalità avanzate in termini di sicurezza, conformità e analisi che possono essere integrate con il software.
Questi servizi aggiuntivi saranno disponibili solo per i pacchetti Standard e Premium.
Per ulteriori informazioni, vedi la Pagina della Guida di Pro Pack per Control Hub.
Tabella di marcia futura
Per informazioni sulle nostre intenzioni per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Le voci della roadmap non sono vincolanti in alcuna capacità. Cisco si riserva il diritto di sospendere o rivedere uno o tutti questi elementi dalle release future.
Limiti
Limitazioni di provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario del sito Webex Meetings creato per tale pacchetto.
Se nella richiesta di provisioning per il primo utente di ciascun pacchetto non viene specificato alcun fuso orario, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sull'impostazione predefinita regionale dell'organizzazione degli abbonati.
Se il cliente necessita di uno specifico fuso orario del sito di Webex Meetings, specificare timezone
parametro nella richiesta di provisioning per:
il primo abbonato predisposto per il pacchetto Standard nell'organizzazione.
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
il primo abbonato predisposto per il pacchetto base nell'organizzazione.
Limitazioni generali
Nessuna chiamata nella versione Web del client Webex (questa è una limitazione del client, non una limitazione della soluzione).
Webex potrebbe non disporre ancora di tutti i controlli dell'interfaccia utente per supportare alcune funzioni di controllo delle chiamate disponibili da BroadWorks.
Attualmente, il client Webex non può essere "White Labeled" (etichetta bianca).
Quando si creano le organizzazioni dei clienti utilizzando il metodo di provisioning scelto, vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. Ci aspettiamo che i partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
I report sull'utilizzo di riunioni e messaggi sono disponibili attraverso l'organizzazione del cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti di messaggistica
I seguenti limiti di archiviazione dei dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo storage massimo per messaggistica e file combinati.
Di base: 2 GB per utente per 3 anni
Standard 5 GB per utente per 3 anni
Premio: 10 GB per utente per 5 anni
Per ciascuna organizzazione del cliente, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti premium ha un limite totale di messaggistica e storage file di 50 GB. Un singolo utente può superare il limite per utente (10 GB), a condizione che la società sia ancora al di sotto del massimo aggregato (50 GB).
Per gli spazi team creati, i limiti di messaggistica vengono applicati al totale aggregato per l'organizzazione cliente che possiede lo spazio team. Puoi trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti generali di messaggistica applicabili agli spazi dei team di messaggistica Webex, fare riferimento a https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure le connessioni a Webex e BroadWorks. I dati memorizzati nel cloud Webex ed esposti all'utente attraverso l'interfaccia dell'app Webex sono crittografati sia in transito che a riposo.
Maggiori dettagli sullo scambio di dati sono disponibili nella sezione Riferimento del presente documento.
Ulteriori letture
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati che più si avvicina alla propria regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore del provider di servizi (utente): Per le attività di manutenzione quotidiane, si gestiscono le parti della soluzione in sede (chiamata) utilizzando i propri sistemi. Gestisci le parti Webex della soluzione attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale.
Il primo utente predisposto per un nuovo organizzatore partner viene assegnato automaticamente ai ruoli amministratore completo e amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi. |
Team operativo di Cisco cloud: Crea la tua "organizzazione partner" in Partner Hub, se non esiste, durante l'onboarding.
Una volta ottenuto l'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente, create "Onboarding templates" (Modelli di onboarding) per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Quindi si fornisce i vostri clienti o abbonati.
# | Compito tipico | SP | Cisco |
---|---|---|---|
1 | Onboarding partner - Creazione dell'organizzazione partner se non esiste e abilitazione dei tasti di alternanza funzione necessari | ● | |
2 | Configurazione BroadWorks nell'organizzazione partner tramite Partner Hub (cluster) | ● | |
3 | Configurazione delle impostazioni di integrazione in Organizzazione partner tramite Partner Hub (modelli di offerta, branding) | ● | |
4 | Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|ADP Patching, firewall, configurazione XSP|ADP, XSI, AuthService, CTI, NPS, applicazioni DMS su XSP|ADP) | ● | |
5 | Sviluppo dell'integrazione o del processo di provisioning | ● | |
6 | Preparare i materiali GTM | ● | |
7 | Migrazione o provisioning di nuovi utenti | ● |
Architettura
Cosa c'è nel diagramma?
Client
Il client dell'app Webex serve come applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di messaggistica nativa, presenza e riunioni audio/video multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per le chiamate SIP e PSTN.
I telefoni IP Cisco e i relativi accessori utilizzano anche l'infrastruttura BroadWorks per le chiamate SIP e PSTN. Ci aspettiamo di essere in grado di supportare telefoni di terze parti.
Portale di attivazione utente per gli utenti che accedono a Webex utilizzando le credenziali BroadWorks.
Partner Hub è un'interfaccia Web per l'amministrazione dell'organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. Puoi anche utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
Rete di provider di servizi
Il blocco verde a sinistra dello schema rappresenta la tua rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
XSP|ADP rivolto al pubblico, per Webex per Cisco BroadWorks: (La scatola rappresenta una o più fattorie XSP|ADP, eventualmente frontali da bilanciatori di carico).
Ospita l'interfaccia dei servizi Xtended (XSI-Actions & XSI-Events), il servizio di gestione dei dispositivi (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato del ricevitore dell'altro (presenza di telefonia) e la cronologia chiamate.
Pubblica la rubrica ai client Webex.
XSP|ADP rivolto al pubblico, con NPS in esecuzione:
server push notifiche chiamate organizzatore: Un server push di notifica su un ADP XSP| nel proprio ambiente. Si interfaccia tra il server applicazioni e il proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS & FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
Server applicazioni:
Fornisce il controllo delle chiamate e le interfacce ad altri sistemi BroadWorks (generalmente)
Per il provisioning flowthrough, l'AS viene utilizzato dall'amministratore del partner per il provisioning degli utenti in Webex
Inserisce il profilo utente in BroadWorks
OSS/BSS: Sistema di supporto alle operazioni/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nello schema rappresenta il cloud Webex. I microservizi Webex supportano l'intero spettro di funzionalità di collaborazione Webex:
Cisco Common Identity (CI) è il servizio identità all'interno di Webex.
Webex per Cisco BroadWorks rappresenta la serie di microservizi che supportano l'integrazione tra Webex e BroadWorks ospitato da provider di servizi:
API di provisioning utente
Configurazione provider di servizi
Accesso utente mediante credenziali BroadWorks
Casella di messaggistica Webex per microservizi correlati alla messaggistica.
Casella Webex Meetings che rappresenta server di elaborazione multimediale e SBC per riunioni video con più partecipanti (SIP e SRTP)
Servizi Web di terze parti
Nello schema sono rappresentati i seguenti componenti di terze parti:
APNS (Apple Push Notifications Service) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Apple.
FCM (messaggistica cloud FireBase) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Il ruolo dei server XSP|ADP aperti al pubblico in Webex per Cisco BroadWorks
L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste Webex per BroadWorks JWT (JSON Web Token) per conto dell'utente
Interfaccia CTI, protetta da mTLS, a cui Webex sottoscrive gli eventi della cronologia chiamate e lo stato della presenza di telefonia da BroadWorks (stato hook).
Interfacce azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate degli abbonati, rubriche di elenchi di contatti e chiamate e configurazione del servizio di telefonia per gli utenti finali
Servizio DM (Device Management) per il recupero dei file di configurazione delle chiamate da parte dei client
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedere Configurazione dei cluster BroadWorks in Partner Hub in questo documento. Per ciascun cluster, è possibile fornire un solo URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP
È necessario utilizzare un'istanza ADP XSP|dedicata o un'azienda agricola separata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile organizzare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso XSP|ADP che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/azienda agricola ADP XSP| dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
Ad esempio, se offri UC-One SaaS, ti consigliamo di creare una nuova fattoria XSP|ADP per Webex per Cisco BroadWorks. In questo modo i due servizi possono operare in modo indipendente durante la migrazione degli abbonati.
Se si collocano le applicazioni Webex per Cisco BroadWorks in una fattoria ADP|XSP utilizzata per altri scopi, è responsabilità dell'utente monitorare l'utilizzo, gestire la complessità risultante e pianificare l'aumento della scala.
Il pianificatore della capacità di sistema Cisco BroadWorks assume una fattoria ADP XSP| dedicata e potrebbe non essere preciso se la si utilizza per i calcoli della posizione.
Se non diversamente specificato, gli Webex dedicati per Cisco BroadWorks XSP|ADP devono ospitare le seguenti applicazioni:
AuthService (TLS con convalida token CI o mTLS)
CTI (mTLS)
Azioni XSI (TLS)
XSI-Events (TLS)
DMS (TLS): opzionale. Non è obbligatorio distribuire un'istanza DMS o un'azienda agricola separata specificamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
TLS (Call Settings Webview): opzionale. La vista Webview (CSW) delle impostazioni di chiamata è richiesta solo se si desidera che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso a CTI attraverso un'interfaccia protetta dall'autenticazione TLS reciproca. Per supportare questo requisito, raccomandiamo una delle seguenti opzioni:
(Diagramma etichettato Opzione 1) Una istanza XSP|ADP o un'azienda agricola per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
(Diagramma etichettato Opzione 2) Due istanze ADP XSP| o aziende agricole, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSP|ADP Se si dispone di una fattoria ADP XSP|esistente conforme a una delle architetture suggerite sopra (Opzione 1 o 2) ed è leggermente caricata, è possibile riutilizzare le ADP XSP|esistenti. Dovrai verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti dell'applicazione per Webex. Le due considerazioni principali sono:
Poiché gli XSP|ADP hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero esserci altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di XSP|ADP deve essere verificato in un laboratorio con la configurazione desiderata prima di impegnarsi per il riutilizzo. |
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione temporale per tutti gli XSP|ADP utilizzati con Webex.
Installare il ntp
pacchetto dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Quindi è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, consultare la Guida alla gestione del software BroadWorks.
Durante l'installazione interattiva del software XSP|ADP, è possibile configurare NTP. Procedere come segue:
Quando l'installatore chiede,
Do you want to configure NTP?
, immetterey
.Quando l'installatore chiede,
Is this server going to be a NTP server?
, immetteren
.Quando l'installatore chiede,
What is the NTP address, hostname, or FQDN?
, immettere l'indirizzo del server NTP o un servizio NTP pubblico, ad esempio,pool.ntp.org
.
Se gli ADP XSP|utilizzano un'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie Key=Value:
NTP
NTP_SERVER=<NTP Server address, e.g., pool.ntp.org>
Requisiti di identità e sicurezza XSP|ADP
Sfondo
I protocolli e le crittografie delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli vanno dal più generale (provider SSL) al più specifico (interfaccia singola). Un'impostazione più specifica sostituisce sempre un'impostazione più generale. Se non sono specificate, le impostazioni SSL di livello "inferiore" vengono ereditate da livelli "superiori".
Se non viene modificata alcuna impostazione rispetto alle impostazioni predefinite, tutti i livelli ereditano le impostazioni predefinite del provider SSL (JSSE Java Secure Sockets Extension).
Elenco dei requisiti
L'|ADP XSP deve autenticarsi sui client utilizzando un certificato firmato da CA in cui il nome comune o il nome alternativo oggetto corrispondono alla parte di dominio dell'interfaccia XSI.
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
Diffie-Hellman Effemeral (DHE) o curve ellittiche Diffie-Hellman Effemeral (ECDHE) chiave-scambio
Crittografia AES (Advanced Encryption Standard) con una dimensione minima di blocco di 128 bit (ad esempio, AES-128 o AES-256)
Modalità di codifica GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
Se viene utilizzata una crittografia CBC, solo la famiglia SHA2 di funzioni hash è consentita per derivazione chiave (SHA256, SHA384, SHA512).
Ad esempio, le seguenti crittografie soddisfano i requisiti:
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come illustrato sopra, non la convenzione openSSL. |
Crittografie TLS supportate per le interfacce AuthService e XSI
Questo elenco è soggetto a modifiche a mano a mano che evolvono i nostri requisiti di sicurezza del cloud. Seguire l'attuale raccomandazione sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento. |
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_128_GCM_SHA256
TLS_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA256
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_256_CBC_SHA
TLS_PSK_WITH_AES_256_CBC_SHA384
TLS_PSK_WITH_AES_256_CBC_SHA
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA
TLS_PSK_WITH_AES_128_CBC_SHA256
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri della scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il numero di thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi visualizzati come segue (non diminuirli se sono al di sopra di questi valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più |ADP XSP
Elemento bordo bilanciamento carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, deve gestire in modo trasparente la distribuzione del traffico tra più server XSP|ADP e il cloud e i client Webex per Cisco BroadWorks. In questo caso, è possibile fornire l'URL del bilanciatore di carico alla configurazione Webex per Cisco BroadWorks.
Note su questa architettura:
Configurare il DNS in modo che i client possano trovare il bilanciatore di carico quando si connettono all'interfaccia Xsi (vedere configurazione DNS).
Si consiglia di configurare l'elemento edge in modalità proxy SSL inversa per garantire la crittografia dei dati punto a punto.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Server XSP|ADP orientati verso Internet
Se si espongono direttamente le interfacce Xsi, utilizzare il DNS per distribuire il traffico ai più server XSP|ADP.
Note su questa architettura:
Per connettersi ai server XSP|ADP sono necessari due record:
Per i microservizi Webex: Per targetizzare più indirizzi IP XSP|ADP sono necessari record A/AAAA round-robin. Questo perché i microservizi Webex non possono effettuare ricerche SRV. Per esempi, vedere Servizi cloud Webex.
Per l'app Webex: Un record SRV che si risolve in record A in cui ogni record A si risolve in un singolo XSP|ADP. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per targetizzare il servizio XSI per più indirizzi XSP|ADP. Assegnare la priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (e all'indirizzo IP successivo) e passino al record A successivo (e all'indirizzo IP) solo se il primo indirizzo IP è inattivo. NON utilizzare un approccio round-robin per l'app Webex.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune.
È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL XSP|ADP di un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server XSP|ADP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.
Ordinazione e provisioning
L'ordine e il provisioning si applicano a questi livelli:
Provisioning di partner/provider di servizi:
Ogni onboarding di Webex per provider di servizi Cisco BroadWorks (o rivenditore) deve essere configurato come organizzazione partner in Webex e devono essere concesse le autorizzazioni necessarie. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per gestire Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le operazioni di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/aziendale.
Ordinazione e provisioning clienti/aziende:
Ogni BroadWorks Enterprise abilitato per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo si verifica automaticamente come parte del provisioning utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks vengono predisposti nella stessa organizzazione cliente Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
Ordinazione e provisioning utente/abbonato:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning degli utenti:
Provisioning fluviale con e-mail attendibili
Provisioning eseguibile senza e-mail attendibili
Self-provisioning utente
Provisioning API
Provisioning eseguibile con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile affermare che BroadWorks dispone di indirizzi e-mail abbonati validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Provisioning eseguibile senza e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non puoi contare sugli indirizzi e-mail degli abbonati detenuti da BroadWorks, questa opzione di provisioning crea account Webex ma non può attivarli fino a quando gli abbonati non forniscono e convalidano i relativi indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Self-provisioning utente
Con questa opzione, non è disponibile il provisioning flowthrough da BroadWorks a Webex. Una volta configurata l'integrazione tra Webex e il sistema BroadWorks, vengono visualizzati uno o più collegamenti specifici per il provisioning degli utenti all'interno dell'organizzazione partner Webex per Cisco BroadWorks.
Successivamente, si progettano le proprie comunicazioni (o si delegano ai clienti) per distribuire il collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account vengono predisposti nell'ambito dell'organizzazione partner, puoi regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare tale operazione.
Gli utenti devono esistere nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento. |
Provisioning provider di servizi per API
Webex presenta un set di API pubbliche che consentono di creare il provisioning utente/abbonato Webex per Cisco BroadWorks nel flusso di lavoro/negli strumenti di gestione utenti esistenti.
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti Webex per Cisco Broadworks di comporre altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella rubrica Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo dell'estensione di tutte le aree del metodo di avvio chiamata e del profilo dell'utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e gruppi diversi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due imprese che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Utenti Cisco BroadWorks
Provisioning API pubblica come 'interno
Il parametro dell'interno deve essere esplicitamente passato come parte della chiamata API. Per le imprese/gruppi con Location Dialing Code (LDC) configurato, il parametro dell'interno dovrebbe essere la combinazione di LDC e 'numero di interno.
Provisioning flusso o auto-attivazione
Estensione e LDC (se applicabile) saranno automaticamente recuperati da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione di codice di chiamata posizione (LDC) e numero di interno.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'interno |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'estensione deve essere passata come parametro |
Attraverso il flusso | Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Elenchi telefonici BroadWorks | Elenchi telefonici aziendali, di gruppo o personali | Sincronizzazione rubriche | Non applicabile |
Prerequisiti
La versione del client richiesta per supportare questa funzione è 42.11 o successiva.
Patch in cui i codici di chiamata di estensione e posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
AP.platform.23.0.1075.ap380045
AP.as.23.0.1075.ap380045
AP.xsp.23.0.1075.ap380045
AP.as.24.0.944.ap380045
Abilitare l'intestazione X-BroadWorks-Remote-Party-Info su AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP richiesto per il supporto della funzione di composizione dell'interno.
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata a interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità delle chiamate di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'estensione come seconda opzione in Partner Hub e Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con estensione attraverso uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione dell'interno sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Non verrà visualizzata un'estensione nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere visibile l'opzione di chiamata dell'interno per i clienti esistenti:
Se un partner desidera che tutte le organizzazioni dei clienti gestite siano dotate di un interno come una delle opzioni di chiamata, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
Se un partner desidera fornire un interno in opzioni di chiamata per una specifica organizzazione cliente, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e portarli alla pari con l'aumento di 30K contatti per l'elenco telefonico Enterprise, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per Organizzazione, che si applica alla somma degli elenchi telefonici Enterprise e Group in una singola azienda BroadWorks. Ad esempio, sarà supportato un'azienda BroadWorks che dispone di un elenco di telefoni aziendali con 30K e anche di 5 elenchi di telefoni di gruppo ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K totali).
Questa funzione è disponibile su richiesta. Contatta il team dell'account per abilitare questa opzione.
|
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks nello storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare a quale gruppo appartiene questo utente. L'associazione dell'utente con un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca dei contatti nello storage del gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning degli abbonati Webex per BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
È possibile eseguire il provisioning dell'ID gruppo aziendale BroadWorks per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Webex per gli utenti Cisco BroadWorks
Provisioning API pubblica come "spEnterpriseGroupId"
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
Provisioning flusso o auto-attivazione
L'ID gruppo aziendale BroadWorks verrà automaticamente recuperato da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Non applicabile. Non è necessario sincronizzare l'ID gruppo aziendale BroadWorks per questi utenti.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'ID gruppo aziendale BroadWorks deve essere superato come parametro spEnterpriseGroupId |
Attraverso il flusso | L'ID gruppo aziendale BroadWorks viene recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Non applicabile |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Non applicabile |
Elenchi telefonici BroadWorks | Contatti negli elenchi telefonici del gruppo BroadWorks | Sincronizzazione rubriche | I contatti di gruppo vengono memorizzati nel servizio Webex Contact associato al gruppo specifico |
Elenchi di telefoni BroadWorks Enterpsie o Persional | Contatti negli elenchi telefonici aziendali o personali | Sincronizzazione rubriche | Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. Impossibile completare la migrazione fino a quando QUESTA API non viene completata. L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march Una volta abilitata la funzione e a seguito della sincronizzazione della rubrica successiva, i gruppi di utenti aziendali verranno visualizzati anche in Control Hub. La visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativa in questa fase. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza a un gruppo in Control Hub poiché tali modifiche non verranno riportate nuovamente in BroadWorks. La gestione di gruppo in Control Hub è destinata all'uso da parte dei partner che adotteranno le prossime API di gestione contatti. |
Migrazione e prova del futuro
La progressione Cisco del client di comunicazione unificata BroadSoft deve spostarsi da UC-One a Webex. Si verifica una corrispondente progressione dei servizi di supporto dalla rete del provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che tu stia eseguendo UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita consiste nel distribuire nuovi ADP|XSP dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti in Webex e infine recuperare l'infrastruttura utilizzata per la soluzione precedente.
Sottoscrizioni di documenti consigliate
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Abbonati che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di eseguire l'abbonamento a ciascuno dei seguenti articoli per assicurarsi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per iscriversi, accedere a ciascuno dei link seguenti e nell'articolo che viene visualizzato fare clic sul pulsante Iscriviti.
Come minimo, si consiglia di iscriversi all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati in Documenti aggiuntivi dispone di un'opzione Sottoscrivi . Affinché questa opzione venga visualizzata, l'articolo deve essere visualizzato su help.webex.com.
Non esiste un'opzione di abbonamento per le landing page di documentazione. |
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Documenti Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
Porta la tua soluzione PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono di loro proprietà (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive come eseguire l'onboarding e il servizio dei dispositivi Room OS e MPP.
Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi di Webex per Cisco BroadWorks.
Articoli Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti siti opzionali per ulteriori informazioni su Webex per Cisco BroadWorks:
Documentazione Webex per Cisco BroadWorks: nella pagina di destinazione vengono elencati i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme a quelle presto disponibili.
Problemi noti e limitazioni: informazioni sui problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale: questo articolo descrive come assegnare i ruoli amministratore partner per le organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte della soluzione Cisco BroadWorks:
Articoli della Guida Webex
I seguenti siti della Guida Webex possono essere utilizzati per trovare gli articoli Webex che consentono agli amministratori dei clienti e agli utenti finali di utilizzare le funzioni Webex.
Webex da provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati comunemente per gli utenti dell'app Webex che hanno acquistato i servizi Webex da un provider di servizi.
Centro assistenza Webex: utilizzare la funzione di ricerca su help.webex.com per cercare altri articoli Webex che descrivono la funzionalità dell'app Webex e di Webex Meetings. È possibile ricercare gli articoli utente o amministratore.
Documentazione sviluppatore
Guida per sviluppatori Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Punti di decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastrutture
|
Quanti ADP XSP|? Come prendono l'mTLS? |
Pianificatore capacità di sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento CLI XSP|ADP Il presente documento |
Provisioning cliente e utente | Puoi affermare che ti fidi dei messaggi e-mail in BroadWorks? Vuoi che gli utenti forniscano indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Documenti API pubbliche su https://developer.webex.com Il presente documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo di branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso per i clienti? | Il presente documento |
Funzioni abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o Softphone. | Il presente documento Matrice caratteristiche/pacchetto |
autenticazione protetta | BroadWorks o Webex | Il presente documento |
Adattatore di provisioning (per opzioni di provisioning flowthrough) | Utilizzate già IM&P integrato, ad esempio per UC-One SaaS? Si desidera utilizzare più modelli? È previsto un caso d'uso più comune? |
Il presente documento Riferimento CLI server applicazioni |
Architettura e infrastrutture
Con che tipo di scala intende iniziare? È possibile scalare in futuro, ma la stima di utilizzo attuale dovrebbe guidare la pianificazione dell'infrastruttura.
Collaborare con il proprio account manager/rappresentante di vendita Cisco per dimensionare l'infrastruttura ADP XSP|, in base al Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
In che modo Webex renderà le connessioni TLS reciproche alle tue ADP XSP|? Direttamente a XSP|ADP in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce. (Non supportiamo connessioni TCP non crittografate al perimetro della rete).
Provisioning cliente e utente
Quale metodo di provisioning utente si adatta meglio?
Provisioning eseguibile con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene predisposto automaticamente in Webex.
Se puoi anche affermare che gli indirizzi e-mail dell'abbonato in BroadWorks sono validi e univoci per Webex, puoi utilizzare la variante "email attendibili" del provisioning flowthrough. Gli account Webex abbonati vengono creati e attivati senza il loro intervento; scaricano semplicemente il client e accedono.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto, il provider di servizi deve fornire un indirizzo e-mail valido all'utente per eseguire il provisioning dei servizi Webex. Questo deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo anche nell'attributo ID alternativo.
Provisioning eseguibile senza e-mail attendibili: Se non riesci a fidarti degli indirizzi e-mail degli abbonati, puoi comunque assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
Self-provisioning utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. Tu (o i tuoi clienti) distribuisci invece un collegamento di provisioning e i collegamenti per scaricare i diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare gli account Webex. Quindi, scaricano il client e accedono e Webex recupera una configurazione aggiuntiva su di essi da BroadWorks (inclusi i numeri principali).
Provisioning controllato da SP tramite API: Webex espone una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei propri flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti di sistema generali descritti in questa guida.
Metodo di provisioning | Requisiti |
---|---|
Provisioning del flusso (e-mail attendibili o non attendibili) | L'API di provisioning Webex aggiunge automaticamente gli utenti BroadWorks esistenti a Webex una volta che l'utente soddisfa i requisiti e si attiva il servizio Integrated IM+P. Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Self-provisioning utente | L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato il messaggio e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) | Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono previsti due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, vai a Utenti BroadWorks. |
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Impostazioni internazionali lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente di amministrazione con provisioning viene assegnata automaticamente come locale predefinita per l'organizzazione del cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti a riunioni all'interno dell'organizzazione del cliente.
Sono supportate le impostazioni internazionali in lingua a cinque caratteri (ISO-639-1)_(ISO-3166). Ad esempio, en_US corrisponde a English_UnitedStates. Se viene richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genera un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso internazionale dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, viene utilizzata l'impostazione locale ragionevole predefinita in base al codice della lingua richiesto.
Nella tabella riportata di seguito vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice lingua a due lettere in un'impostazione locale a cinque caratteri per le situazioni in cui un'impostazione locale a cinque caratteri non è disponibile.
Impostazioni internazionali lingua supportate (ISO-639-1)_(ISO-3166) | Se è disponibile solo un codice lingua a due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** | Usa impostazioni internazionali sensibili di default (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA | en en | en_USA |
fr_Fr fr_CA | Fr | fr_Fr |
cs_CZ | cs | cs_CZ |
da_DK | da | da_DK |
de_DE | DE | de_DE |
hu_HU | hu | hu_HU |
id_ID | ID | id_ID |
it_IT | IT | it_IT |
ja_JP | ja | ja_JP |
ko_KR | ko | ko_KR |
es_ES es_CO es_MX | ES | es_ES |
nl_NL | NL | nl_NL |
nb_NO | nb. | nb_NO |
pl_PL. | pl. | pl_PL. |
pt_PT pt_BR | pt | pt_PT |
ru_RU | RU | ru_RU |
ro_RO | ro | ro_RO |
zh_CN zh_TW | zh | zh_CN |
sv_SE | sv | sv_SE |
ar_SA | ar | ar_SA |
tr_TR | tr | tr_TR |
Le impostazioni internazionali es_CO, id_ID, nb_NO e pt_PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti Webex Meetings saranno solo in inglese. Inglese è la impostazioni internazionali predefinite per i siti se per il sito non sono richieste impostazioni internazionali non valide/non supportate. Questo campo lingua è applicabile durante la creazione di un'organizzazione e un sito Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, la lingua del modello verrà utilizzata come lingua predefinita. |
Branding
Gli amministratori partner possono utilizzare le personalizzazioni avanzate del branding per personalizzare l'aspetto dell'app Webex per le organizzazioni di clienti gestite dal partner. Gli amministratori partner possono personalizzare le seguenti impostazioni per garantire che l'app Webex rifletta il marchio e l'identità della società:
Loghi aziendali
Combinazioni di colori univoche per la modalità Chiaro o Scuro
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione delle personalizzazioni di branding avanzate.
|
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding come richiesto, ma quando si esegue l'onboarding di un cliente è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Alcuni parametri del modello principale sono elencati di seguito.
Pacchetto
È necessario selezionare un pacchetto predefinito quando si crea un modello (vedere Pacchetti nella sezione Panoramica per dettagli). Tutti gli utenti predisposti con tale modello, tramite flowthrough o self-provisioning, ricevono il pacchetto predefinito.
È possibile controllare la selezione dei pacchetti per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno di essi. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori di provisioning per azienda, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
È possibile modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedere Webex per la documentazione API Cisco BroadWorks o attraverso Partner Hub (vedere Modifica pacchetto utente in Partner Hub).
Non puoi modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è attivata o disattivata; se all'abbonato viene assegnato questo servizio in BroadWorks, il modello Partner Hub associato all'URL di provisioning aziendale di tale abbonato definisce il pacchetto.
Rivenditore e aziende o fornitore di servizi e gruppi?
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se sei un rivenditore con Enterprise, devi abilitare la modalità Enterprise quando crei un modello.
Se il sistema BroadWorks è configurato in modalità provider di servizi, è possibile lasciare disattivata la modalità Enterprise nei modelli.
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch BroadWorks richieste per il provisioning flow-through. Per ulteriori dettagli, vedere Patch richieste con provisioning flow-through. |
Modalità di autenticazione
Decidi come desideri che gli abbonati eseguano l'autenticazione quando accedono a Webex. È possibile assegnare la modalità utilizzando l'impostazione Modalità di autenticazione nel modello di onboarding. Nella tabella seguente sono riportate alcune opzioni.
Questa impostazione non ha effetto sull'accesso al portale di attivazione utente. Gli utenti che accedono al portale devono immettere l'ID utente e la password BroadWorks, come configurati su BroadWorks, indipendentemente da come si configura la modalità di autenticazione nel modello di onboarding. |
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | ID utente BroadWorks | Indirizzo e-mail |
Provider identità | BroadWorks.
| Identità comune Cisco |
Autenticazione a più fattori? | No | Richiede IdP del cliente che supporta l'autenticazione a più fattori. |
Percorso di convalida delle credenziali
|
|
|
Per una ripartizione più dettagliata del flusso di accesso SSO con autenticazione diretta a BroadWorks, vedere Flusso di accesso SSO. |
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che si può verificare con password che utilizzano caratteri speciali per cui il browser Web non codifica correttamente i caratteri. Utilizzando un'intestazione con codifica UTF-8, con codifica base 64, risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
Paese
Quando si crea un modello, è necessario selezionare un paese. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie S. | Posizione | Prefisso internazionale | Nome paese |
---|---|---|---|
1 | AMER | +1 | NOI, CA |
2 | APAC | +65 | Singapore |
3 | ANZ | +61 | Australia |
4 | EMEA | +44 | Regno Unito |
5 | EURO | +49 | Germania |
Accordi con più partner
Vuoi concedere in sublicenza Webex per Cisco BroadWorks a un altro provider di servizi? In questo caso, ciascun provider di servizi avrà bisogno di un'organizzazione partner distinta in Webex Control Hub per consentire loro di fornire la soluzione per la propria base clienti.
Adattatore di provisioning e modelli
Quando si utilizza il provisioning flowthrough, l'URL di provisioning inserito in BroadWorks viene derivato dal modello in Control Hub. È possibile disporre di più modelli e quindi di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati al momento della concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e quale modello si desidera utilizzare a tale scopo. In questo modo, è necessario impostare esplicitamente l'URL di provisioning per le aziende che necessitano di un modello diverso.
Inoltre, tenere presente che è possibile che si stia già utilizzando un URL di provisioning a livello di sistema, ad esempio con UC-One SaaS. In tal caso, è possibile scegliere di mantenere l'URL a livello di sistema per il provisioning degli utenti su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono dettagliate in Configura server applicazioni con URL servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning flowthrough tra AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server AS e Webex, annullando in tal modo la necessità di connettersi direttamente al servizio Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati che si sta eseguendo il provisioning per Webex devono esistere nel sistema BroadWorks integrato con Webex. È possibile integrare più sistemi BroadWorks, se necessario.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero o interno principale.
Webex utilizza gli indirizzi e-mail come identificatori principali per tutti gli utenti. Se si utilizza il provisioning flowthrough con e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail degli abbonati nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo di utenti di chiamata BroadWorks con un numero principale e/o interno. Se si utilizza il provisioning flowthrough, agli utenti deve essere assegnato anche il servizio IM&P integrato. |
Server nella rete e requisiti software
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Le istanze BroadWorks devono includere almeno i seguenti server:
Server applicazioni (AS) con versione BroadWorks come sopra
Server di rete (NS)
Server profilo (PS)
Server XSP|ADP o piattaforma di distribuzione delle applicazioni (ADP) di fronte al pubblico che soddisfano i seguenti requisiti:
Servizio di autenticazione (BWAuth)
Interfacce azioni ed eventi XSI
DMS (applicazione Web di gestione dispositivi)
Interfaccia CTI (Intergrazione Di Telefonia Informatica)
TLS 1.2 con certificato valido (non autofirmato) e qualsiasi intermediazione richiesta. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
Autenticazione Mutual TLS (mTLS) per il servizio di autenticazione (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Autenticazione Mutual TLS (mTLS) per l'interfaccia CTI (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Un server XSP/ADP separato che agisce come "Call Notifications Push Server" (un NPS nel tuo ambiente utilizzato per le notifiche di chiamata push per Apple/Google. Lo chiamiamo "CNPS" qui per distinguerlo dal servizio in Webex che fornisce notifiche push per messaggi e presenza).
Questo server deve essere su R22 o versione successiva.
Viene richiesto un server XSP/ADP separato per CNPS poiché l'imprevedibilità del carico da Webex per le connessioni cloud BWKS potrebbe influire negativamente sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSPADP, consultare la Guida tecnica di sistema Cisco BroadWorks|.
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, andare a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
PC/laptop Windows
PC/laptop Apple con MacOS
iOS (Apple Store)
Android (Play store)
Browser Web (vai a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (tradizionale cinese)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (italiano)
Telefoni e accessori fisici
Telefoni IP Cisco:
telefono IP Cisco serie 6800 con firmware multipiattaforma
telefono IP Cisco serie 7800 con firmware multipiattaforma
telefono IP Cisco serie 8800 con firmware multipiattaforma
Vedere https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html per i modelli e ulteriori informazioni.
I telefoni di terze parti sono supportati allo stesso modo di altre integrazioni BroadWorks. Tuttavia, non dispongono ancora dell'integrazione di contatti e presenza con Webex per Cisco BroadWorks.
Adattatori:
Adattatore per telefono analogico multipiattaforma Cisco ATA 191
Adattatore per telefono analogico multipiattaforma Cisco ATA 192
Vedere https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html per i modelli e ulteriori informazioni.
Cuffie:
cuffia Cisco serie 500
Vedi https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html per i modelli e ulteriori informazioni.
Dispositivi Room OS:
Serie Webex Room e Room Kit
Serie Webex Desk
Serie Webex Board
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e l'assistenza dei dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivo
Di seguito sono riportati i file DTAF che devi caricare sui server delle applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia c'è una nuova config-wxt.xml.template
file utilizzato per l'app Webex.
Per scaricare i profili dei dispositivi più recenti, andare al sito di Download software della piattaforma di consegna delle applicazioni per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che per XSP.
Nome del cliente | Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Comunicatore aziendale - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili del dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Genera una richiesta di servizio con l'agente di onboarding o con Cisco TAC per eseguire il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il titolo della richiesta per le rispettive funzioni:
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
'NPS Configuration for Auth Proxy Setup' (Configurazione NPS per impostazione proxy automatica) per configurare NPS per l'uso del proxy di autenticazione.
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori informazioni su questa funzione, vedere: Supporto di Cisco BroadWorks per CI UUID.
Configura BroadWorks per abilitare la fatturazione Cisco per BroadWorks e Webex Per abbonamenti BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento valido per 60 giorni. Se il token scade prima di utilizzarlo, è possibile presentare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali. |
Certificati ordine
Requisiti di certificato per l'autenticazione TLS
Per tutte le applicazioni richieste, saranno necessari i certificati di sicurezza, firmati da un'autorità di certificazione ben nota e distribuiti su ADP XSP|pubblico. Verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in entrata ai server XSP|ADP.
Questi certificati devono includere il nome di dominio pubblico XSP|ADP completo come Nome comune oggetto o Nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati del server dipendono da come vengono distribuiti gli ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume dove il certificato del server pubblico firmato da CA deve essere caricato in questi tre casi:
Le autorità di certificazione supportate pubblicamente dall'app Webex per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per proxy bridge TLS
Il certificato del server firmato pubblicamente viene caricato nel proxy.
Il proxy presenta questo certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Un certificato firmato CA interno può essere caricato su XSP|ADP.
L'|ADP XSP presenta questo certificato del server firmato internamente al proxy.
Il proxy si basa sulla CA interna che ha firmato il certificato del server XSP|ADP.
Requisiti di certificato TLS per proxy passthrough TLS o XSP|ADP in DMZ
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
Gli ADP XSP|presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca sull'interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione Mutual TLS. Il certificato CA/catena del certificato del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedi a Partner Hub, vai a
e fai clic sul collegamento del certificato di download.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume i requisiti del certificato in questi tre casi:
Requisiti del certificato (opzione) per proxy bridge TLS
Webex presenta un certificato client firmato pubblicamente al proxy.
Il proxy considera attendibile la CA interna di Cisco che ha firmato il certificato del client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta il certificato del server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions: X509v3 Extended Key Usage: 1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Il CN del certificato interno deve essere
bwcticlient.webex.com
.
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le autorità pubbliche di certificazione potrebbero non essere disposte a firmare i certificati con l'OIDE proprietario di BroadWorks richiesto. In caso di proxy di bridging, è possibile che sia necessario utilizzare una CA interna per firmare il certificato del client che il proxy presenta all'ADP XSP|.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Il ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XSP| dal proxy.
Requisiti di certificato (opzione) per proxy passthrough TLS o XSP|ADP in DMZ
Webex presenta un certificato client firmato da CA Cisco interno alle ADP XSP|.
Gli ADP XSP|si fidano delle autorità di certificazione interne di Cisco che hanno firmato il certificato client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XSP|.
Gli ADP XSP|presentano i certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Il server applicazioni ClientIdentity contiene il CN del certificato del client firmato Cisco presentato a XSP|ADP da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene l'elenco di indirizzi IP, porte e protocolli richiesti per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle dei firewall delle regole di ingresso e uscita precedenti documentano solo le connessioni specifiche di Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico per Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e la rilevanza di ciascuna sezione per Webex per Cisco BroadWorks.
Sezione Requisiti di Rete Art. | Rilevanza delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex | Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud | Informativo |
Da leggere | |
Da leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex | Da leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione | Opzionale |
Servizi Webex per clienti FedRAMP | N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedi il whitepaper del firewall dell'app Webex (PDF).
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza XSP|ADP di Broadworks fornita dal partner. Quando un ADP o un sito XSP|non è disponibile per manutenzione pianificata o motivo non pianificato, i servizi e le app Webex possono passare a un altro ADP o sito XSP|fornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP Broadworks XSP|possono essere distribuiti direttamente su Internet o possono risiedere in un DMZ frontale da un elemento di bilanciamento del carico come F5 BIG-IP. Per fornire ridondanza geografica, gli ADP XSP|possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un bilanciatore di carico, ognuno con un indirizzo IP pubblico. Se gli ADP XSP| sono dietro a un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e Broadworks sembra avere solo un XSP|ADP, anche se vi sono più ADP XSP| dietro.
Nell'esempio seguente, le ADP|XSP vengono distribuite in due siti, il Sito A e il Sito B. Esistono due ADP|XSP frontali di un bilanciatore di carico in ogni sito. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali di LB1 e il sito B ha XSP|ADP3 e XSP|ADP4 frontali di LB2. Solo i bilanciatori di carico sono esposti sulla rete pubblica e le ADP|XSP sono nelle reti private DMZ.
Servizi cloud Webex
Configurazione DNS
I microservizi cloud Webex devono essere in grado di trovare il server|ADP Broadworks XSP per la connessione alle interfacce Xsi, al servizio di autenticazione e al CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host XSP|ADP configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso. Se vengono restituiti più indirizzi IP, viene selezionato il primo IP nell'elenco. La ricerca SRV non è attualmente supportata.
Esempio: Il DNS A Record del partner per la scoperta del server XSP|ADP/Load Balancers bilanciato Round-Robin.
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Punti a LB1 (Sito A) |
R |
|
| Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Failover
Quando i microservizi Webex inviano una richiesta al servizio |di bilanciamento del carico/ADP XSP e la richiesta non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se non viene ricevuta alcuna risposta HTTP entro 2 secondi, la richiesta viene timeout e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento dell'indirizzamento all'IP successivo.
Ciascuna richiesta viene provata 3 volte prima di segnalare un errore al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco degli indirizzi da provare quando si invia una richiesta a un XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna nell'elenco per provare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco bloccato. Se l'operazione va a buon fine, tale indirizzo IP viene rimosso dall'elenco bloccato.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP|XSP o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster BroadWorks Calling, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
Azioni XSI
Eventi XSI
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Gli stati delle connessioni possono essere:
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
Rosso: Quando tutti gli IP nella ricerca di record sono irraggiungibili e l'interfaccia non è disponibile.
I seguenti servizi utilizzano i microservizi per connettersi agli XSP|ADP e sono interessati dalla disponibilità dell'interfaccia XSP|ADP:
Accesso all'app Webex
Aggiornamento token app Webex
E-mail/autoattivazione non attendibile
Controllo stato servizio Broadworks
App Webex
Configurazione DNS
L'app Webex accede ai servizi Xtended Services Interface (XSI-Actions & XSI-Events) e Device Management Service (DMS) su XSP|ADP.
Per trovare il servizio XSI, l'app Webex esegue la ricerca DNS SRV per _xsi-client._tcp.<webex app xsi domain>
. L'SRV punta all'URL configurato per gli host XSP|ADP o i bilanciatori di carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex torna alla ricerca A/AAAA.
L'SRV può risolversi in più target A/AAAA. Tuttavia, ogni record A/AAAA deve mappare solo a un singolo indirizzo IP. Se sono presenti più ADP|XSP in un DMZ dietro il dispositivo di bilanciamento del carico/bordo, è necessario che il bilanciatore di carico sia configurato per mantenere la persistenza della sessione in modo da indirizzare tutte le richieste della stessa sessione allo stesso XSP|ADP. Questa configurazione viene avviata perché i heartbeat dell'evento XSI del client devono andare allo stesso XSP|ADP utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non deve esistere. Se il DNS richiede che un record A/AAAA deve essere definito, allora deve essere restituito solo 1 indirizzo IP. Indipendentemente da ciò, l'SRV deve essere ancora definito per l'app Webex. Se l'app Webex utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client alla fine invia heartbeat a un XSP|ADP dove non ha stabilito un canale per eventi. Di conseguenza, il canale viene strappato e il traffico interno è notevolmente più intenso, il che pregiudica le prestazioni del cluster ADP|XSP. Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca di record A/AAAA, è necessario utilizzare un nome di dominio completo separato per Webex Cloud e l'app Webex per accedere agli ADP|XSP. Come mostrato negli esempi, Webex Cloud utilizza Un record |
Esempio 1: ADP|XSP multipli, ciascuno dietro bilanciatori di carico separati
In questo esempio, SRV punta a disattivare l'audio dei record A con ogni record A che punta a un bilanciatore di carico diverso su un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito un esempio di record SRV.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Esempio 2: più amministratori XSP| dietro un singolo bilanciatore di carico (con bridge TLS)
Per la richiesta iniziale, il bilanciatore di carico seleziona un XSP|ADP casuale. XSP|ADP restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il bilanciatore di carico utilizza il cookie per indirizzare la connessione all'ADP XSP|corretto, assicurandosi che il canale dell'evento non si interrompa.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Bilanciatore di carico |
R | LB.esempio.com |
| Indirizzo IP del bilanciatore di carico (XSP|ADP sono dietro al bilanciatore di carico) |
URL DMS
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il file di configurazione. Viene eseguita l'analisi dell'organizzatore nell'URL e l'app Webex esegue la ricerca DNS A/AAAA dell'organizzatore per connettersi all'ADP XSP|che ospita il servizio DMS.
Esempio: DNS Un record per la scoperta di Round-Robin bilanciato server XSP|ADP/Bilanciamento del carico di Webex App per scaricare i file di configurazione tramite DMS:
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Come l'app Webex trova gli indirizzi XSP|ADP
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (sono stati inseriti quando si crea il cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue la ricerca SRV nel modo seguente:
Il cliente esegue una ricerca SRV per _xsi-cliente._tcp.<xsi domain="">
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
Il cliente cerca gli obiettivi A/AAAA e memorizza nella cache gli indirizzi IP restituiti.
Il client si connette a uno dei target (e quindi al suo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi al peso (o a caso se sono tutti uguali).
Se la ricerca SRV non restituisce alcun obiettivo:
Il client esegue una ricerca A/AAAA del parametro principale Xsi e quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso.
Come indicato, il record A/AAAA deve risolversi in un indirizzo IP per le stesse ragioni.
(Opzionale) Successivamente, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocols> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
Se esistono, il client confronterà l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
Se viene rilevata una differenza, il client re-inizializzerà la connettività XSI Actions/XSI Events. La prima fase consiste nell'eseguire lo stesso processo di ricerca DNS elencato nella fase 1, richiedendo questa volta una ricerca del valore nel %XSI_ROOT_WXT% parametro dal file di configurazione.
Assicurarsi di creare i record SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
Failover
Durante l'accesso, l'app Webex esegue una ricerca DNS SRV per _xsi-client._tcp.<xsi domain="">, crea un elenco di organizzatori e si connette a uno degli organizzatori in base alla priorità SRV, quindi al peso. Questo organizzatore connesso diventa quello selezionato per tutte le richieste future. Viene quindi aperto un canale evento all'organizzatore selezionato e viene inviato regolarmente un heartbeat per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP, pertanto è importante che il bilanciatore di carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server XSP|ADP di backend.
Se una richiesta o una richiesta heartbeat a un organizzatore non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), l'indirizzamento dell'app Webex viene eseguito immediatamente all'organizzatore successivo nell'elenco.
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e l'indirizzamento passa all'organizzatore successivo nell'elenco.
Se una risposta non viene ricevuta entro un periodo di tempo, la richiesta viene considerata non riuscita a causa del timeout e le richieste successive vengono inviate al successivo organizzatore. Tuttavia, la richiesta scaduta viene considerata come non riuscita. Alcune richieste vengono riprovate dopo l'errore (con un tempo di riprova crescente). Le richieste che il presunto non vitale non sono riprovate.
Quando un nuovo organizzatore viene provato correttamente, diventa il nuovo organizzatore selezionato se l'organizzatore è presente nell'elenco. Una volta provato l'ultimo organizzatore nell'elenco, l'app Webex passa al primo.
In caso di heartbeat, se si verificano due errori di richiesta consecutivi, l'app Webex re-inizializzerà il canale eventi.
Tenere presente che l'app Webex non esegue il failback e che il rilevamento del servizio DNS viene eseguito solo una volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione attraverso l'interfaccia XSP|ADP/Dms. Esegue una ricerca di record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Innanzitutto, tenterà di inviare la richiesta per scaricare il file di configurazione utilizzando un token SSO. Se ciò non riesce per qualsiasi motivo, verrà riprovato ma con il nome utente e la password del dispositivo.
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning dell'utente. Molte delle attività sono comuni a tutte le modalità di provisioning.
Onboarding dei partner per Webex per Cisco BroadWorks
Ciascun provider o rivenditore di servizi Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, è necessario eseguire la documentazione Cisco BroadWorks di Webex e i nuovi partner devono accettare l'ICPA (Indirect Channel Partner Agreement) online. Al termine di queste operazioni, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, il tuo Partner Activation e/o Customer Success Program Manager ti contatterà per iniziare il tuo onboarding.
I partner Webex in una regione possono creare organizzazioni di clienti in qualsiasi regione in cui offriamo i servizi. Per informazioni, vedere: Residenza dati in Webex. |
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
È necessario eseguire l'applicazione NPS su un altro XSP|ADP. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi sugli ADP XSP|.
Servizio/Applicazione | Autenticazione richiesta | Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
autenticazione protetta |
Integrazione telefonia computer |
mTLS (client e server si autenticano a vicenda) |
Presenza di telefonia |
Applicazione Webview Impostazioni chiamata |
TLS (il server esegue l'autenticazione per i client) |
Mostra le impostazioni di chiamata utente nel portale Assistenza utente all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma occorre fare riferimento alla documentazione esistente per installare le applicazioni sugli ADP|XSP.
Requisiti di coresidenza
Il servizio di autenticazione deve essere coresidente con le applicazioni Xsi, perché tali interfacce devono accettare token di lunga durata per l'autorizzazione del servizio. Il servizio di autenticazione è richiesto per convalidare tali token.
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
È possibile separare gli altri servizi/applicazioni come richiesto per la propria bilancia (gestione dispositivi dedicata XSP|ADP farm, ad esempio).
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
Non installare altre applicazioni o servizi sugli ADP XSP| utilizzati per integrare BroadWorks con Webex.
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se è in esecuzione R22 o versione superiore e il sistema lo supporta.
Mutual TLS (mTLS) è supportato anche come metodo di autenticazione alternativo per il servizio Auth. Se più organizzazioni Webex eseguono lo stesso server ADP XSP|, è necessario utilizzare l'autenticazione mTLS poiché la convalida token CI non supporta più connessioni allo stesso servizio autenticazione ADP XSP|. Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida del token CI, fare riferimento all'Appendice per configurare i servizi (con mTLS per il servizio di autenticazione). |
Se attualmente si utilizza mTLS per il servizio autenticazione, non è obbligatorio riconfigurare l'uso della convalida token CI con TLS. |
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks.
Installare le seguenti patch su ciascun server ADP XSP|. Installare le patch appropriate alla release in uso:
Per R22:
Per R23:
Per R24: non è necessario alcun cerotto
Qualsiasi riferimento a XSP include XSP o ADP.Installare il
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP al percorso del contesto /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire il servizio di autenticazione su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
A partire da Broadworks build 2022.10, le autorità di certificazione in arrivo con Java non vengono più automaticamente incluse nel trust store BroadWorks quando si passa a una nuova versione di java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
Radice commerciale IdenTrust CA 1
autorità di certificazione radice Go Daddy - G2
Verificare che questi certificati siano presenti sotto la seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get
Se non presente, eseguire il seguente comando per importare i trust Java predefiniti:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come ancoraggi attendibili con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono automaticamente importate nella nuova release e continueranno a essere importate finché non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere la FD di convalida del certificato Cisco Broadworks X509.
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server ADP XSP|:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get
set clientId client-Id-From-Step1
set enabled true
set clientSecret client-Secret-From-Step1
set ciResponseBodyMaxSizeInBytes 65536
set issuerName <URL>
- Per ilURL
, immettere l'URL IssuerName che si applica al cluster CI. Vedere la tabella seguente.set issuerUrl <URL>
- Per ilURL
, immettere l'IssuerUrl che si applica al cluster CI. Vedere la tabella seguente.set tokenInfoUrl <IdPProxy URL>
—Inserire l'URL proxy IdP applicabile al cluster dei team. Si veda la seconda tabella che segue.
Tabella 1. Imposta nome emittente e URL emittente Se il cluster CI è... Imposta issuerName e issuerURL su... NOI-A
UE
NOI-B
Se non conosci il tuo cluster CI, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.Tabella 2. Imposta tokenInfoURL Se il cluster di Teams è... Imposta tokenInfoURL su...(URL proxy IdP) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AFRA
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
DOLORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.
Per il test, è possibile verificare che il tokenInfoURL sia valido sostituendo "
idp/authenticate
" parte dell'URL con "ping
".
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user
Configurare i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get
set flsUrl https://cifls.webex.com/federation
set refreshPeriodInMinutes 60
set refreshToken refresh-Token-From-Step1
Eseguire il seguente comando per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get
Configurare la gestione dei token utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
set tokenIssuer BroadWorks
set tokenDurationInHours 720
Genera e condividi chiavi RSA. È necessario generare chiavi su un XSP|ADP, quindi copiarle su tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP.Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web. Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token. Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Rimozione dei requisiti di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con la convalida del token CI su R24, è necessario rimuovere anche il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Interfaccia CTI e configurazione correlata
Di seguito viene elencato l'ordine di configurazione "da più a più". In seguito a questo ordine non è obbligatorio.
Configurazione del server di applicazione per gli abbonamenti CTI
Configurazione di XSP|ADPs per abbonamenti CTI autenticati mTLS
Apertura delle porte in entrata per l'interfaccia CTI protetta
Abbonamento dell'organizzazione Webex agli eventi CTI di BroadWorks
Configurazione del server di applicazione per gli abbonamenti CTI
Aggiornare ClientIdentity su Application Server con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ciascun server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è |
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocol> |
Una specifica interfaccia CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocol> |
Su una nuova installazione, le seguenti crittografie sono installate per impostazione predefinita a livello di sistema. Se non è configurato nulla a livello di interfaccia (ad esempio, nell'interfaccia CTI o HTTP), si applica questo elenco di crittografia. Si noti che questo elenco può cambiare nel tempo:
|
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp>
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
Inserisci il
get
comando per visualizzare le crittografie già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, si utilizzerebbe:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Ancoraggi affidabili per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che le ADP XSP|siano rivolte verso Internet o rivolte verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy bridge (vedere Requisiti del certificato TLS per proxy bridge TLS).
Per ogni amministratore XSP|nell'infrastruttura che pubblica eventi CTI in Webex, effettuare le seguenti operazioni:
Accedere a Hub partner .
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.
Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
(Opzionale) Esecuzione
help updateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot2023
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
Consenti ai client di autenticarsi con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione BroadWorks in uso. Il comando crea un certificato server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. È necessario l'indirizzo IP dell'interfaccia CTI per questo; è possibile leggerlo dal seguente contesto:
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>
Riavviare XSP|ADP.
Abilitazione dell'accesso a BroadWorks CTI Events su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
Specificare l'indirizzo CTI in base al quale Webex può iscriversi a CTI Events di BroadWorks.
Gli abbonamenti CTI sono su base per abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato viene predisposto per Webex per Cisco BroadWorks.
Visualizzazione Webview Impostazioni chiamata
Call Settings Webview (CSWV) è un'applicazione ospitata su XSP|ADP per consentire agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview per le impostazioni di chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono native dell'app Webex.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, è necessario distribuire la funzione Webview impostazioni chiamata.
La vista Webview impostazioni chiamata presenta due componenti:
Applicazione Webview Impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
App Webex, che esegue il rendering delle impostazioni di chiamata in una vista Webview.
Esperienza utente
Utenti Windows: Fai clic su Impostazioni chiamata, quindi su .
Utenti Mac: Fare clic sull'immagine del profilo, quindi
.
Distribuzione di CSWV su BroadWorks
Installazione di Webview impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso ADP|XSP che ospita l'interfaccia Xsi-Actions nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
Accedere a cisco.com e cercare "BWCallSettingsWeb" nella sezione download software.
Trovare e scaricare la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) è stata la più recente al momento della stesura del presente documento.Installare, attivare e distribuire l'archivio Web in base alla Guida alla configurazione della piattaforma di servizi Xtended di Cisco BroadWorks per la versione XSP|ADP. (Versione R24 https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
.Passare al seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più necessario).Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario fornire anche un contextPath perché è un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio
/callsettings
.Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
Ora è possibile prevedere l'URL delle impostazioni di chiamata che si specificherà per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
L'|ADP-FQDN XSP deve corrispondere al FQDN azioni Xsi, perché CSWV deve utilizzare le azioni Xsi e CORS non è supportato.
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview Impostazioni chiamata è ora attiva sugli ADP|XSP.
Configura l'app Webex per utilizzare Webview impostazioni chiamata
Per ulteriori dettagli sulla configurazione del client, vedere la Guida alla configurazione di Webex per Cisco BroadWorks.
Nel file di configurazione dell'app Webex è presente un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti attraverso l'interfaccia dell'applicazione.
<config>
<services>
<web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%">
<url>%WEB_CALL_SETTINGS_URL_WXT%</url>
</web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel %WEB_CALL_SETTINGS_URL_WXT% tag.
Se non si specifica esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
Imposta la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
Il file di configurazione client risultante dovrebbe avere una voce come segue:
<web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push delle chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Call Notifications Push Server (CNPS) per descrivere un'applicazione ospitata XSP o ospitata ADP che viene eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti e invia le notifiche a Google Firebase Cloud Messaging (FCM) o Apple Push Notification Service (APN).
Tali servizi notificano ai dispositivi mobili degli abbonati Webex per Cisco BroadWorks la presenza di chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzione Notification Push Server.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi a loro volta notificano agli utenti mobili Webex le modifiche ai messaggi in arrivo o alla presenza.
In questa sezione viene descritto come configurare l'NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se è necessario eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPShttps://help.webex.com/nl5rir2/. |
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario aggiornare il CNPS per supportare la funzione proxy NPS, server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server di notifica push per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e i tasti di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend di Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APN Apple e i servizi FCM Google.
La funzione migliora anche la capacità del server push delle notifiche di eseguire notifiche push ai dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
Per ulteriori informazioni, vedere Server push per VoIP nella descrizione della funzione UCaaS.
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software e le patch NPS, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Cercare e scaricare la patch dalla pagina di download del software.
Ulteriori informazioni sul server ADP sono disponibili su https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio Apple Push Notification dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per APN. Questo aggiornamento richiede che XSP|ADP che ospita l'NPS esegua R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 | Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma di consegna dell'applicazione (ADP). | ||
2 | Installare le patch proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: | ||
3 | Attivare l'applicazione Notification Push Server. | ||
4 | (Per le notifiche Android) Abilitare l'API FCM v1 sull'NPS.
| ||
5 | (Per le notifiche Apple iOS) Abilitare HTTP/2 su NPS.
| ||
6 | Collegare un supporto tecnico dell'NPS XSP/ADP. | ||
7 | Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN UN 10.193.78.149
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configura NPS per utilizzare il proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Migra NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un server NPS condiviso con altre app mobili, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPS ( https://help.webex.com/nl5rir2).
1 | Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 | Creare l'account cliente su NPS:
Per verificare che i valori inseriti corrispondano a quanto ricevuto, eseguire
| |||||||||||||||||||
3 | Immettere l'URL proxy NPS e impostare l'intervallo di aggiornamento del token (consigliato 30 minuti):
| |||||||||||||||||||
4 | (Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 | (Per le notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, assicurandosi di omettere il tasto Auth – impostarlo su vuoto.
| |||||||||||||||||||
6 | Configurare i seguenti URL NPS:
| |||||||||||||||||||
7 | Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 | Verificare se il server applicazioni sta eseguendo lo screening degli ID applicazione, poiché potrebbe essere necessario aggiungere le app Webex all'elenco utenti autorizzati: | |||||||||||||||||||
9 | Riavviare XSP|ADP: | |||||||||||||||||||
10 | Esegui test delle notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migrazione di NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente che è necessario eseguire la migrazione a FCMv1. Sono previste tre procedure:
Esegui migrazione dei client UC-One a FCMv1: quando disponi di client UCaaS esistenti e devi migrarli per utilizzare FCMv1.
Migrazione dei client SaaS a FCMv1: quando si dispone di client SaaS esistenti e occorre migrarli per utilizzare FCMv1.
Aggiorna server ADP: quando si esegue la migrazione di NPS a un server ADP.
Migrazione dei client UC-One a FCMv1
Utilizzare la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere . L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile Connect su https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al
|
Accedere a SDK amministratore FCM su http://console.firebase.google.com.
Selezionare l'applicazione Android appropriata.
Nella scheda General (Generale), registrare l’ID del progetto
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
Fare clic sul pulsante blu per creare un nuovo account di servizio
Fai clic sul pulsante blu per generare una nuova chiave privata
Chiave di download per una posizione sicura
Per riutilizzare un account servizio esistente:
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
Identificare l'account servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
Copiare il file json su XSP|ADP.
Configurare l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== my_project ********
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Migrazione dei clienti SaaS a FCMv1
Se si desidera eseguire la migrazione dei client SaaS a FCMv1, attenersi alla procedura seguente su Google FCM Console.
Assicurarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione". |
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Aggiorna server ADP
Se si esegue la migrazione dell'NPS per utilizzare un server ADP, utilizzare i passaggi seguenti nella console Google FCM.
Ottenere il file JSON dalla console cloud di Google:
Su Google Cloud Console, andare alla pagina Account servizio.
Fare clic su Seleziona un progetto, scegliere il progetto e fare clic su Apri.
Trova la riga dell'account servizio per la quale desideri creare una chiave, fai clic sul pulsante Altro verticale, quindi fai clic su Crea chiave.
Selezionare un tipo di chiave e fare clic su Crea
Il file viene scaricato.
Aggiungere FCM al server ADP:
Importare il file JSON nel server ADP utilizzando il
/bw/install
comando.Accedere all'ADP CLI e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON
:Quindi, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò avviene per i seguenti motivi:
Per consentire a Webex cloud di autenticare i tuoi utenti rispetto a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
Per consentire alle app Webex di utilizzare l'interfaccia Xsi per il controllo delle chiamate.
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se alcune interfacce non vengono convalidate correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide. Ciò viene impedito poiché un cluster configurato in modo errato potrebbe causare problemi che sono difficili da risolvere. |
Cosa è necessario fare:
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Se l'utente amministratore non ha visibilità delle impostazioni di BroadWorks Calling , si consiglia di aprire un caso con Cisco TAC.
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
Assegna un nome al cluster e fai clic su Avanti.
Il concetto di cluster qui è semplicemente una raccolta di interfacce, solitamente situate su un server ADP XSP| o in un'azienda agricola, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il sistema BroadWorks non sono applicabili qui.
(Opzionale) Immettere un Nome account utente e una Password BroadWorks noti all'interno del sistema BroadWorks che si connette a Webex, quindi fare clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
Aggiungere gli URL XSI Actions e XSI Events.
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
Opzionale. Selezionare la casella di controllo Abilita autenticazione diretta BroadWorks se si desidera che gli accessi a BroadWorks siano diretti a BroadWorks. In caso contrario, l'autenticazione per BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo influisce su queste situazioni di accesso:
Accesso al portale di attivazione utente: gli utenti devono immettere le credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o attraverso il proxy IdP.
Accesso client: se l'autenticazione BroadWorks è configurata nel modello di onboarding, l'impostazione precedente determina se l'accesso del client all'app Webex è diretto a BroadWorks o viene proxy attraverso il proxy IdP.
Fai clic su Avanti.
Nella pagina CTI Interface (Interfaccia CTI) procedere come segue:
Aggiungere l'URL CTI e la porta per l'interfaccia CTI a cui si desidera connettersi.
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
Opzionale. Abilita il tasto di alternanza Non disturbare (NoDist) e inserisci l'ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurandosi che la funzione funzioni allo stesso modo su entrambe le piattaforme.
Fai clic su Avanti.
Aggiungere l'URL del servizio di autenticazione.
Selezionare Servizio autenticazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex poiché il servizio di autenticazione convalida correttamente il token utente rispetto al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
Controllare le voci sulla schermata finale, quindi fare clic su Crea. Dovrebbe essere visualizzato un messaggio di successo.
Partner Hub passa gli URL a vari microservizi Webex che testano le connessioni alle interfacce fornite.
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è riuscita.
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Abbiamo implementato questa verifica per prevenire errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, caricatore di bilanciamento o firewall) come illustrato in questa guida, prima di salvare il modello.
Verifica delle connessioni alle interfacce BroadWorks
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Visualizza cluster.
Partner Hub avvia i test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina dell'elenco dei cluster mostra il messaggio di stato accanto a ciascun cluster.
I messaggi verdi relativi al successo dovrebbero essere visualizzati. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio XSI-Actions, XSI-Events, DAS URL e le impostazioni dell'interfaccia CTI.
Configurazione dei modelli di onboarding
I modelli di onboarding sono il modo in cui verrà applicata la configurazione condivisa a uno o più clienti man mano che vengono caricati tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma solo un modello può essere associato a un cliente.
Accedere a Partner Hub e selezionare Clienti.
Fare clic sul pulsante Modelli di onboarding per visualizzare i modelli esistenti.
Fare clic su Crea modello.
Nella finestra Dettagli modello, aggiungere il nome del modello, il paese o la regione e la lingua e-mail predefinita.
Nella finestra Impostazione servizio, utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
Immettere un Nome modello, quindi fare clic su Avanti.
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per diverse modalità di provisioning Nome impostazione
Provisioning fluviale con e-mail attendibili
Provisioning flowthrough senza e-mail
Self-provisioning utente
Abilita flusso BroadWorks attraverso il provisioning (include le credenziali dell'account di provisioning se attivato**)
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il †
Il †
Il †
Indirizzo e-mail provider servizi
Selezionare un indirizzo e-mail dall'elenco a discesa (è possibile digitare alcuni caratteri per trovare l'indirizzo, se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello di onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature tra paese e regione in questo foglio di calcolo.
Il paese dell'organizzazione determina i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni consultare la sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questo interruttore spento.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note dalla tabella:
† Questo passaggio garantisce che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa opzione deve essere sempre attiva, a meno che non si utilizzi un processo manuale di ordinazione ed esecuzione (tramite Cisco Commerce Workspace) per creare le organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello di "provisioning ibrido" e non rientra nel campo di applicazione di questo documento.
** "Account di provisioning" si riferisce all'account di amministrazione a livello di sistema BroadWorks. Su BroadWorks, è necessario un account amministratore con questi attributi: Tipo amministratore=Provisioning, sola lettura=Disattivato.
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
Opzionale. Selezionare Disabilita chiamata gratuita Cisco Webex se si desidera disabilitare le chiamate Webex.
Per la configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
Numeri di chiamata in ingresso Cisco (PSTN)
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
Fai clic su Avanti.
Esistono due approcci per il provisioning degli abbonati relativamente a come vengono verificate le relative identità, utilizzando e-mail attendibili o e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile, gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. In qualità di partner, sei responsabile del provisioning dell'indirizzo e-mail come parte del metodo flow-through o API.
Si consiglia vivamente di utilizzare il metodo di provisioning attendibile poiché garantisce che tutti gli abbonati siano completamente predisposti dall'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso e-mail non attendibile, gli utenti devono verificare i relativi messaggi e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome impostazione
Provisioning flowthrough senza e-mail
Self-provisioning utente
Esegui prima provisioning amministratore
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
Note dalla tabella:
* Ciascuna organizzazione cliente in Webex deve disporre di almeno un utente con ruolo di amministratore. Il primo utente a cui assegnare IM&P integrato in BroadWorks assume il ruolo di amministratore del cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di fornitore di servizi è possibile avere il controllo su chi ottiene il ruolo. La verifica di questa impostazione impedisce agli utenti di completare l'attivazione fino a quando non viene attivato il primo utente fornito. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
Fai clic su Avanti.
Selezionare la modalità di autenticazione predefinita (autenticazione BroadWorks o autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.(Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
Fai clic su Avanti.
Per Preferenze, configurare quanto segue:
Scegliere se si desidera Precompilare gli indirizzi e-mail utente nella pagina di accesso.
Utilizzare questa opzione solo dopo aver selezionato Autenticazione BroadWorks e aver anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il nome utente BroadWorks. La pagina di accesso offre l'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
Se desideri abilitare la sincronizzazione delle rubriche, imposta l'opzione Abilita sincronizzazione rubrica telefonica per tutte le nuove organizzazioni clienti per attivare.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
Immettere un amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatico di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
Assicurati che l'opzione Consenti invito e-mail amministratore quando ti colleghi a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
Fai clic su Avanti.
Esaminare le voci nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Dovrebbe essere visualizzato un messaggio di successo.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con altri modelli.
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario immettere nuovamente i dettagli dell'account di provisioning. I campi Password vuota/Conferma password sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori forniti alla procedura guidata.
Aggiungi altri modelli se disponi di diverse configurazioni condivise che desideri fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbe essere necessario specificare i dettagli del modello per una delle attività seguenti.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning. |
Patch Application Server (solo R22, R23 e R24)
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
Per R22:
AP.as.22.0.1123.ap373197
Per R23:
AP.as.23.0.1075.ap373197
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che costituiscono il requisito per la distribuzione di Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.Modifica della
Maintenance/ContainerOptions
contesto.Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true
Scarica gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interfaccia > Messaggistica e Servizio > IM&P integrato) dei comandi AS.
Accedi a Partner Hub e vai a
.Fare clic su Visualizza modelli.
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro flyout a destra. Se non è stato ancora creato un modello, è necessario farlo prima di poter ottenere l'URL di provisioning.
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per altri modelli se si dispone di più modelli.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema su server applicazioni
Se si utilizza UC-One SaaS, potrebbe non essere necessario impostare il provisioning e il dominio del servizio a livello di sistema. Vedere i Punti di decisione nella sezione Preparazione dell’ambiente. |
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password
AS_CLI/Interface/Messaging> set enableSynchronization true
Attivare l'interfaccia IMP integrata:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
È necessario inserire il nome completo per il |
(Opzione) Configurazione dei parametri di provisioning per azienda su server applicazioni
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
Selezionare Usa dominio di servizio e immettere un valore fittizio (Webex ignora questo parametro). È possibile utilizzare
example.com
).Selezionare Usa server di messaggistica.
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
È necessario inserire il nome completo per il
provisioningURL
parametro, come è stato dato in Partner Hub. Se il server applicazioni non può accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel/etc/hosts
file su AS.Nel campo Nome utente, immettere un nome per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Immettere una password per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Per Identità utente predefinita per ID IM&P, selezionare Principale.
Fare clic su Applica.
Ripeti per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning utente, vedi Provisioning utente provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning aiuta amministratori e team di vendita controllando la presenza di errori prima di eseguire il provisioning di un cliente o abbonato per un pacchetto. Gli utenti o le integrazioni autorizzati da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per assicurarsi che non vi siano conflitti o errori con il provisioning del pacchetto per un determinato cliente o abbonato.
L'API verifica se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto a un cliente o partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, è possibile correggere gli errori prima del provisioning, aumentando la probabilità di un provisioning riuscito.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore Webex per la vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare di un provisioning abbonato all'ingrosso
Per accedere a Precontrolla un documento di provisioning abbonato Wholesale, devi accedere al portale https://developer.webex.com/. |
Partner SSO - SAML
Consente agli amministratori dei partner di configurare l'SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La seguente procedura SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere la funzionalità SSO del partner a un'organizzazione cliente esistente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso. |
Verificare che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'integrazione Single Sign-On in Control Hub.
Carica il file di metadati CI con provider di identità.
Configurare un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, immettere l'ID entità dall'XML metadati SAML del provider di identità di terze parti.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
Proprio che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori dei partner di configurare l'SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per impostare SSO OIDC partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già caricate utilizzando il modello. |
Aprire una richiesta di servizio con il centro TAC di Cisco con i dettagli dell'IDP di connessione OpenID. Sono obbligatori e facoltativi gli attributi IDP. TAC deve impostare l'IDP sul CI e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC, potrebbe consistere in lettere, numeri, trattini, sottolineature, inclinazioni e punti e la lunghezza massima è 128 caratteri.
Id client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Segreto client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco degli ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio, ad esempio "profilo e-mail openid" Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non fornito
URL dell'endpoint di autorizzazione OAuth 2.0 dell'IdP.
endpoint token
Sì se discoveryEndpoint non fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
endpoint infoutente
No
URL dell'endpoint UserInfo di IdP.
Endpoint set di tasti
No
URL dell'endpoint JSON Web Key Set dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
Configurare l'URI di reindirizzamento sull'IDP di connessione OpenID.
Configurare un modello di onboarding. Per l'impostazione della modalità di autenticazione, selezionare Autenticazione partner Con OpenID Connect e immettere il nome IDP fornito durante l'impostazione IDP come ID entità IDP OpenID Connect.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui registrazione chiamata, risposta per assente di gruppo, dirigente e assistente di direzione.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
Eseguire i seguenti comandi sulle interfacce AS. Ciò consentirà all’AS di inviare il c.d.
X-BroadWorks-Correlation-Info
Intestazione SIP:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true
Il
enableCallCorrelationID
Il parametro associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione delle informazioni di correlazione delle chiamate nei registri Xsi-Actions. Si raccomanda di avereenableCallCorrelationID
abilitato utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione dell'identificativo di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione della rubrica garantisce che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la directory di chiamata completa dal server BroadWorks viene sincronizzata con la directory Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione rubriche, vai a Sincronizzazione rubriche in Webex per Cisco BroadWorks.
Webex per Cisco BroadWorks flowthrough provisioning aggiunge utenti di messaggistica e informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, gli elenchi telefonici, gli utenti non di messaggistica e le entità non utenti non sono inclusi (ad esempio, un telefono della sala conferenze, un fax o un numero di gruppo di risposta). L'attivazione della sincronizzazione delle rubriche garantisce che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex. |
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia chiamate e riunioni unificate Webex visualizzata sull'app Webex. Gli utenti possono visualizzare la cronologia dettagliata delle chiamate e della riunione dall'app Webex.
La cronologia chiamate unificata può essere abilitata dagli amministratori a livello di partner in Partner Hub su base cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
Eventi cronologia chiamate: questi eventi vengono utilizzati per creare una cronologia chiamate unificata dettagliata
Eventi di stato hook: la cronologia chiamate unificata include ottimizzazioni dello stato hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di Telephony Presence
Requisiti della cronologia chiamate unificata
Prima di configurare la cronologia chiamate unificata, accertarsi di aver eseguito la patch del sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
AP.as.22.0.1123.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per R23:
AP.as.23.0.1075.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Se si utilizza XSP—
AP.xsp.23.0.1075.ap378585
In caso di utilizzo di ADP
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
AP.as.24.0.944.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per l'elenco completo delle patch BroadWorks che è necessario installare come prerequisito per l'esecuzione di Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella sezione Riferimento. |
Oltre alla patch del sistema, il file di configurazione del client ( config-wxt.xml
) deve avere il seguente set di tag: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altro reindirizzamento nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
AP.as.23.0.1075.ap383346
AP.as.23.0.1075.ap383994
Per R24:
AP.as.24.0.944.ap383346
AP.as.24.0.944.ap383994
Per avere informazioni Dirigente-Assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
AP.as.24.0.944.ap380052
AP.as.24.0.944.ap384239
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare anche la sincronizzazione delle rubriche per la cronologia chiamate unificata dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione NoDist, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti nel cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione di Broadworks durante la stessa finestra di manutenzione. |
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configura organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettuare le seguenti operazioni:
Accedi a Partner Hub su
admin.webex.com
.Andare a Impostazioni e selezionare un cluster esistente.
Verificare che la connessione al cluster sia buona. Nel pannello a destra viene visualizzato un segno di spunta verde con Connection stabilita.
Se questa opzione non viene visualizzata, in Check Connnections (Opzionale), immettere BroadWorks User Id e BroadWorks Password e fare clic su Check per verificare che la connessione sia corretta.
Selezionare la casella di controllo Abilita cronologia chiamate.
Fai clic su Salva.
Interazioni funzione
Per la cronologia chiamate unificata sono presenti le seguenti interazioni delle funzioni:
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando questa situazione esiste, gli eventi Cronologia chiamate e Stato hook non vengono inviati all'app Webex.
La cronologia chiamate unificate non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia chiamate unificata dall'app Webex. Per informazioni dettagliate, vedere: Webex | visualizza cronologia chiamate e riunioni.
Disabilita cronologia chiamate unificata
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visivo
L'app Webex supporta un'indicazione visiva delle chiamate spam nel avviso popup quando la chiamata viene presentata al destinatario e nei record della cronologia delle chiamate unificate quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per utilizzare questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- Le seguenti patch devono essere installate e attive:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o AS-25_Rel_2022.12 come minimo
- La funzione deve essere attivata tramite AS CLI:
- AS_CLI/System/ActivatableFeature> attivare 104112
- AS_CLI/System/StirShaken> imposta enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'etichettatura e la verifica STIR-SHAKEN come descritto in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste di invito inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti che vengono inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione di spam visivo nella presentazione della chiamata e nella cronologia chiamate unificata della chiamata.
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenta di identificare il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra di chiamata e una volta completata la chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante abbinando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se trova più istanze di un numero in un'origine, non tenterà di sceglierne una, in questo caso, non visualizzerà alcun ID chiamante. |
Webex Common Identity (CI) che contiene gli utenti della tua organizzazione.
Contatti personali e aziendali. I contatti personali sono visibili nella scheda Contatti.
Rubrica locale. In Windows - applicazione Outlook, in Mac - Contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non viene trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, utilizzerà la parte del nome utente dell'URI SIP dall'intestazione SIP From come ultima risorsa.
Per il controllo delle chiamate remote (ad esempio, modalità di controllo del telefono fisso) vengono utilizzate informazioni XSI, dove viene utilizzato ID BWKS o interno, estratte da informazioni di parte remota nell'evento XSI. Se l'informazione della parte remota non è disponibile, verrà utilizzata P-Asserted Identity (PAI) (se configurata).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica di chiamata e nella cronologia chiamate.
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
Coda Call Center: Visualizza il nome della coda che ha inoltrato la chiamata.
Dirigente-Assistente: Mostra il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
Per le chiamate nella coda chiamate interna, in cui un agente richiama una parte interna, la parte remota non visualizzerà il nome della coda chiamata, ma il nome dell'agente che le chiama.
Chiamata con risposta altrove:
Per gruppi di risposta o code chiamate impostate con indirizzamento simultaneo, gli agenti visualizzeranno una chiamata che ha ricevuto risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di risposta o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate perse nella cronologia chiamate se risposte da un altro agente.
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni da tavolo. Questa funzione specifica consente di assegnare gli indicatori di linea condivisa all'app Webex dell'utente finale.
Questa funzione consente agli utenti di gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente alle linee condivise.
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise dal client Webex
R23 senza ADP:
AP.as.23.0.1075.ap384179
AP.xsp.23.0.1075.ap384179
R23 con ADP:
AP.as.23.0.1075.ap384179
Xsi-Actions-23_2022.10
R24:
IN QUANTO: AP.as.24.0.944.ap384179
Xsi-Actions-24_2022.10
R25:
IN QUANTO: Versione RI Rel_2022.10_1.310
Xsi-Actions-25_2022.10
Cerotto 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo. Esempio: Per il client desktop: Sistema>Tipo di profilo identità/dispositivo - Modifica> Business Communicator - PC: Profilo, opzioni standard, numero di porte:
- SE l'opzione 'Illimitato' è abilitata, non è richiesta alcuna modifica
- SE 'Limitato a' è <10, modificare il valore = 10 e salvarlo per utilizzare tutte le linee disponibili
Versione RI Rel_2022.10_1.310
Sincronizzazione Non disturbare (NoDist).
La sincronizzazione Non disturbare (NoDist) allinea le impostazioni NoDist tra Webex e BroadWorks sincronizzando lo stato NoDist tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato si sincronizza con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. Analogamente, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist da una piattaforma non vengono riconosciuti dall'altra piattaforma.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Se sono presenti molti clienti (>50) nel cluster BroadWorks, la sincronizzazione NoDist non è supportata. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza. |
Prerequisiti
Assicurarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione BroadWorks.
Per la versione 23:
<snipped>
- App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
<snipped>
- App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 su AS:
AS_CLI/System/ActivatableFeature> activate 25433
Se sono presenti molti clienti (>50) nel cluster BroadWorks, operazioni come l'aggiornamento di azioni XSI, eventi XSI, URL DAS, URL XSP|ADP o sincronizzazione NoDist non sono supportate. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza.
Configura sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto di eventi "as-feature-event". Per informazioni dettagliate, vedere Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
Accedi a Partner Hub
Fare clic su Impostazioni.
Fare clic su Visualizza cluster e selezionare il cluster BroadWorks appropriato.
Abilita il tasto di alternanza Non disturbare (NoDist).
Inserire l'ID utente BroadWorks e fare clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione NoDist. Se la convalida non riesce, il pulsante Salva viene disabilitato.
Se la convalida ha esito positivo, fare clic su Salva.
|
Abilita sincronizzazione NoDist (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per ulteriori dettagli, vedere "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Disabilita sincronizzazione NoDist
Non puoi disabilitare la sincronizzazione NoDist da solo. Per disabilitare la funzione, crea un caso BEMS di ingegneria con le seguenti informazioni:
Famiglia: Servizio Spark
Prodotto: Chiamata in Webex (Webex per BroadWorks)
Componente: Provisioning WxBW
Il caso BEMS deve indicare che la sincronizzazione non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterIdBroadWorks.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione delle chiamate.
Modalità di registrazione | Descrizione | Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta | La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente | La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Per R22: AP.as.22.0.1123.ap377718
Per R23: AP.as.23.0.1075.ap377718
Per R24: AP.as.24.0.944.ap377718
L'identificativo di correlazione chiamata deve essere attivato. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione delle chiamate Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, andare a help.webex.com
articolo Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla piattaforma di registrazione chiamate di terze parti.
Gruppo Parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione di parcheggio e recupero delle chiamate di gruppo. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti al dettaglio in un'impostazione di negozio possono utilizzare la funzione per parcheggiare una chiamata che può essere raccolta da qualcuno in un altro reparto.
Funzionamento funzione
Una volta configurata la funzione
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nell'app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nell'app Webex. L'utente quindi inserisce l'estensione della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per attivare questa funzione, verificare quanto segue:
Il file di configurazione client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
L'identificativo di correlazione chiamata deve essere abilitato su AS e XSP|ADP. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Il tuo SBC deve essere configurato per passare il ‘
x-broadworks-correlation-in
' Attributo SIP a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiungi gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo del server applicazioni Cisco BroadWorks - Parte 2. È necessario creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Parcheggio Webex | e Recupera chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzato
Il parcheggio chiamate regolare o indirizzato non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso funzione:
Immettere *68 per parcheggiare una chiamata
Immettere *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato negli ambienti del call center o in altre situazioni in cui può essere necessaria un'assistenza o un intervento immediati.
Quando un servizio di inclusione è abilitato, un utente o supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di tasti o pulsanti dedicati sul proprio telefono o dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o di partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in vari scenari. In un ambiente di call center, supervisori o formatori possono monitorare e assistere i rappresentanti del servizio clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire assistenza o prendere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può partecipare rapidamente a conversazioni in corso per fornire assistenza o prendere decisioni importanti.
Nell'app Webex per l'inclusione, viene inviata una notifica che la chiamata viene trasformata in una conferenza. In NOTIFY (informazioni sulla chiamata o conferenza) non sono disponibili ulteriori informazioni sul tipo di conferenza, pertanto è possibile trattarla in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Vengono introdotti i seguenti termini:
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore solitamente ha la possibilità di monitorare e intervenire nelle chiamate in corso dei clienti. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire assistenza agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può comprendere la formazione degli agenti, la gestione dei problemi dei clienti e l'ottimizzazione delle prestazioni del team.
Cliente: Per cliente si intende una persona fisica o giuridica che interagisce con un'azienda o un'organizzazione per ottenere prodotti, servizi o assistenza. Nel contesto dell'inclusione delle chiamate, un cliente è qualcuno che sta effettuando o ricevendo una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risolvere le loro richieste o problemi durante la chiamata. La funzione di inclusione chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
Agente: Un agente, anche noto come rappresentante del servizio clienti o agente del call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza telefonica o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare operazioni e offrire un'esperienza positiva al cliente. Nel contesto dell'inclusione delle chiamate, un agente è la persona che parla direttamente al cliente durante la telefonata. L'agente può ricevere indicazioni o feedback dal supervisore attraverso l'inclusione della chiamata, se necessario.
La chiamata nativa mobile viene inoltrata alla riunione
La funzione di escalation della chiamata nativa mobile alla riunione è dotata di due funzioni uniche:
Nuova notifica push
Gli utenti mobili su una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando si avvia una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si accede direttamente alla schermata in chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata utilizzando il controllo chiamate Cisco per le chiamate su cellulare, viene visualizzata la notifica Webex durante una chiamata su cellulare.
Trasferisci chiamata mobile a riunione
Quando sei nel mezzo di una chiamata con qualcuno, potresti voler trasferire la chiamata in una riunione per utilizzare alcune funzioni di riunione avanzate come video, condivisione o lavagna. In alternativa, invitare altre persone alla discussione e passare a una riunione.
Requisiti BroadWorks
Funzione attivabile 25239
R23 con XSP|ADP:
AS Patch AP.as.23.0.1075.ap383064
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
Patch AP.platform.23.0.1075.ap383064
R23 con ADP:
AS Patch AP.as.23.0.1075.ap383064
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R24:
Cerotto AS: AP.as.24.0.944.ap383064
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R25:
AS RI release Rel_2022.08_1.354
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e NPS versione > 2022.08_1.350
Configurazione chiamata URI per supportare lo spostamento della chiamata alla riunione
Criteri di chiamata Url NS
Definisci la regola per (.*)webex.com da indirizzare attraverso I-SBC
NS_CLI/Policy/UrlDialing> get WebexMeetings
Policy: UrlDialing Instance: Webex
unknownSipURIHandling = reject
disableSubscriberLookups = true
Enable = true
CallTypes:
Selection = {ALL}
From = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP}
lineportOnly = false
enableSipURIMatchingRules = true
NS_CLI/Policy/UrlDialing/Rules> get WebexMeetings
Policy: UrlDialing Instance: WebexCalling Table: Rules
id pattern routingNE cost weight dtg
===================================================================
1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE di indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> get ne WebexMeetings
Network Element WebexMeetings
Location = 1281465
Data Center =
Static Cost = 1
Static Weight = 99
Poll = false
OpState = enabled
State = OnLine
Profile = NIL_PROFILE
Remote Lookup Enabled = false
Signaling Attributes =
NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings
Routing NE Address Cost Weight Port Transport Route
=====================================================================
WebexMeetings sbc-address 1 99 - unspecified
Profilo di indirizzamento NS
Aggiunta dell'istanza della policy UrlDialing ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> get profile MyInst
Profile: Webex
Policy Instance
==========================================
…
UrlDialing WebexMeetings
AS Usa indirizzamento NS per chiamata NetworkURL
Consente all'AS di rispettare il percorso NS in modalità ibrida AS
AS_CLI/Interface/IMS> set queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un PSAP (Public Safety Answering Point), che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, è necessario integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Usa i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
Chiamata di emergenza E911 in Webex per BroadWorks: utilizzare questo articolo per configurare la chiamata di emergenza E911 in Webex per Cisco BroadWorks utilizzando uno dei seguenti provider E911 supportati:
Banda
Intrado
RedSky
Esclusione di responsabilità per chiamate di emergenza: se disponi di un servizio di posizione, puoi configurare la finestra Esclusione di responsabilità per i servizi di emergenza sull'app Webex in modo da includere un'opzione per gli utenti per aggiornare la propria posizione quando eseguono l'accesso.
Personalizzazione e provisioning dei clienti
Gli utenti scaricano e installano le relative app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedere Piattaforme app Webex). Una volta eseguita l'autenticazione dell'utente, il client si registra sul cloud Webex per messaggistica e riunioni, recupera le informazioni sul branding, scopre le informazioni del servizio BroadWorks e scarica la configurazione delle chiamate dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
Configurare i parametri di chiamata per le app Webex in BroadWorks (come di consueto). Configura i parametri di branding, messaggistica e riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Prepara il tuo ambiente).
Verificare di disporre dei set di tag corretti in BroadWorks System > Resources > Device Management Tag Sets.
Per ciascun client che si sta eseguendo il provisioning:
Scaricare ed estrarre il file zip DTAF per il client specifico.
Importare i file DTAF in BroadWorks all'indirizzo System > Resources > Identity/Device Profile Types
Apri il profilo dispositivo appena aggiunto per la modifica e:
Immettere il nome di dominio completo dell'azienda agricola XSP|ADP e il protocollo di accesso del dispositivo.
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per il funzionamento della condivisione desktop.
È inoltre possibile abilitare il supporto Parte remota eseguendo il seguente comando CLI sul server applicazioni:AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
Salvare il file.
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome | Descrizione |
Priorità codec | Configurazione dell'ordine di priorità per i codec audio e video per le chiamate VoIP |
TCP, UDP e TLS | Configurare i protocolli utilizzati per la segnalazione e il contenuto multimediale SIP |
Porte audio e video RTP | Configurazione degli intervalli di porte per audio e video RTP |
Opzioni SIP | Configurare diverse opzioni relative a SIP (SIP INFO, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti gestiti dal partner. Vedere Configurazione di personalizzazioni di branding avanzate.
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client. |
Personalizzazione dei report dei problemi e degli URL della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito Feedback e Guida", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con Flowthrough Provisioning
Prima di poter eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 | Assegna servizio in BroadWorks: |
2 | Verifica dell'organizzazione cliente e degli utenti in Control Hub: |
Test utente
1 | Scaricare l'app Webex su due diverse macchine. |
2 | Eseguire l'accesso come utenti di test sulle due macchine. |
3 | Effettuare chiamate di prova. |
Provisioning delle organizzazioni dei clienti
Nel modello corrente, eseguiamo automaticamente il provisioning dell'organizzazione del cliente quando si esegue l'onboarding del primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguito una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
Usa API per creare account Webex
Assegna il provisioning integrato IM&P (flowthrough provisioning) con e-mail attendibili per creare account Webex
Assegna provisioning integrato IM&P (flowthrough) senza e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per creare account Webex
Consenti agli utenti di autoattivarsi (invia loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex espone le API pubbliche per consentire ai provider di servizi di integrare il provisioning degli abbonati Webex per Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. Le specifiche per queste API sono disponibili su developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti wholesale verranno rifiutati da queste API. |
Provisioning del flusso
Su BroadWorks, è possibile eseguire il provisioning degli utenti con l'opzione Abilita IM&P integrato. Questa azione provoca l'adattatore di provisioning BroadWorks per effettuare una chiamata API per il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica del codice, ma solo una modifica della configurazione dell'endpoint API per l'adattatore di provisioning.
Il provisioning degli abbonati su Webex può richiedere molti minuti (diversi minuti per l'utente iniziale all'interno di un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il successo del provisioning flowthrough indica che il provisioning è stato avviato. Non indica il completamento. Per confermare che il provisioning di utenti e organizzazione cliente sia completo su Webex, devi accedere a Partner Hub e guardare nell'elenco dei clienti. Gli utenti di trunking BroadWorks possono disporre di Webex per BroadWorks tramite un identificativo di chiamata condiviso (SCA). L'utente che esegue il trunking dovrà disporre del servizio di autenticazione assegnato. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto Webex SCA dall'autenticazione del trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con le funzioni di elenco di indirizzamento o indirizzamento diretto assegnate. |
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata Modello di onboarding. |
Autoattivazione utente
Per eseguire il provisioning degli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
Accedere a Partner Hub e trovare la pagina Elenco clienti.
Fare clic su Visualizza modelli.
Seleziona il modello di onboarding di provisioning che desideri applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non si trova nel sistema BroadWorks associato a questo modello, non può attivarsi automaticamente con il collegamento.
Copiare il collegamento di provisioning e inviarlo all'utente.
È anche possibile includere il collegamento per il download del software e ricordare all'utente di cui ha bisogno di fornire e convalidare il proprio indirizzo e-mail per attivare l'account Webex.
È possibile monitorare lo stato di attivazione dell'utente nel modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi di attivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli all'interno della vista Stato utente che consentono agli amministratori dei provider di servizi Webex per Cisco BroadWorks di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Sposta gli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) |
|
Organizzazione cliente | Collega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge Webex per BroadWorks anche agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) | Se l'organizzazione Webex per BroadWorks non esiste (nessun utente predisposto):
Se esiste un'organizzazione Webex per BroadWorks (viene predisposto almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di autoiscrizione (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (con il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
Sposta utente (con e-mail attendibili): utilizza il provisioning con e-mail attendibili
Sposta utente (con e-mail non attendibili): utilizza il provisioning con e-mail non attendibili
Autoattivazione
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza messaggi e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
L'amministratore aggiunge l'utente.
L'utente viene spinto sul bridge di provisioning BroadWorks.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L’utente apre il messaggio e-mail e fa clic su Attiva account. L'utente viene reindirizzato al portale consumer Webex.
L'utente accede a Webex.
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza messaggi e-mail non attendibili, è necessario prima convalidare l’indirizzo e-mail dell’utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
L'amministratore aggiunge l'utente.
L'utente viene inviato automaticamente al bridge di provisioning BroadWorks.
All'utente viene inviato un testo con un collegamento di attivazione.
L'utente fa clic sul collegamento Attivazione e inserisce l'indirizzo e-mail.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L'utente apre il messaggio e-mail e fa clic su Accedi ora.
L'indirizzo e-mail viene convalidato.
L'utente viene reindirizzato all'accesso al portale consumer Webex.
L'utente accede a Webex.
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Flusso di autoattivazione
Se l'utente dispone di un account BroadWorks esistente, può utilizzare il processo di autoattivazione per spostare l'account.
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
L'utente inserisce il proprio indirizzo e-mail.
L'utente viene inviato al bridge di provisioning BroadWorks.
Viene inviata un'e-mail automatica all'indirizzo e-mail dell'utente.
L'utente apre il messaggio e-mail e fa clic sul collegamento Accedi ora, che convalida l'indirizzo e-mail.
CI rileva che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di poter continuare.
L'utente viene reindirizzato all'accesso a Webex.
L'utente accede al portale consumer.
L'utente fa clic su Elimina account.
L'account Webex precedente viene eliminato.
All'utente è stato predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
Collegamento di Webex per BroadWorks all'organizzazione esistente
Se sei un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, che non è ancora associata a un'azienda BroadWorks gestita da un partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso amministratore per la richiesta di provisioning riuscita.
È necessaria l'approvazione dell'amministratore dell'organizzazione se una delle seguenti affermazioni è vera:
L'organizzazione cliente esistente dispone di 100 utenti o più
L'organizzazione dispone di un dominio e-mail verificato
Dominio organizzazione richiesto
Se nessuno dei criteri di cui sopra è vero, può verificarsi un Attacco automatico.
In uno scenario di allegato automatico, un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner verranno concessi diritti di amministrazione provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà eseguito un amministratore completo. Con l'accesso amministratore di provisioning, la visibilità in Control Hub sarà limitata agli utenti nell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione. |
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che i messaggi e-mail di invito amministratore vengano collegati a organizzazioni esistenti (il tasto di alternanza è attivo per impostazione predefinita). |
1 | L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedere Provisioning delle organizzazioni dei clienti. Si verifica quanto segue:
| ||
2 | Con l'accesso amministratore completo, l'amministratore del partner può completare il processo di provisioning del cliente. Dovrai provare a eseguire nuovamente il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora come amministratore completo esterno, non si dovrebbe osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione cliente esistente sarà visibile come cliente sotto Webex per l'organizzazione partner BroadWorks.
|
Condizioni dell'allegato organizzazione
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione del cliente target. In caso contrario, verrà creata una nuova organizzazione cliente.
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato sul modello di provisioning Webex per BroadWorks. Di conseguenza, non vi sono modifiche alla modalità di accesso degli utenti esistenti.
Tuttavia, se l'organizzazione cliente esistente dispone di branding di base abilitato, una volta eseguito il collegamento, le impostazioni di branding avanzate del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
Il nome dell'organizzazione esistente non cambierà.
Non è stata apportata alcuna modifica all'impostazione del flag di soppressione e-mail nelle impostazioni dell'organizzazione esistente. Ciò può avere effetto sui nuovi utenti predisposti. A seconda di come è impostato il flag, i nuovi utenti possono o meno ricevere un'e-mail con un codice che deve essere immesso per completare l'attivazione.
La modalità di amministrazione con restrizioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
Accertarsi di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
Un'azienda BroadWorks può essere associata solo a una organziazione Webex. Non è possibile eseguire il provisioning degli abbonati da una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com
.
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo. |
L'indirizzo e-mail aggiunto dall'amministratore dell'organizzazione cliente come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore partner come configurato nel modello di onboarding su Partner Hub. Dopo aver aggiunto l'e-mail dal modello di onboarding in Partner Hub come amministratore completo, qualsiasi amministratore aggiuntivo del partner dovrà essere aggiunto anche come amministratore esterno con diritti di amministratore completo. |
Scollegare Webex per BroadWorks dall'organizzazione esistente
Effettuare le seguenti operazioni per scollegare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato accidentalmente Webex per BroadWorks a un'organizzazione esistente e si desidera rimuovere l'allegato.
In Flusso standard, il distacco di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati. |
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso all'amministratore esterno seguendo Approva richiesta amministratore esterno.
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Remove a BroadWorks Workspace.
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi abbonato BroadWorks.
Rimuovi gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se gli utenti sono stati predisposti tramite il flusso e-mail non attendibile e non sono stati ancora inseriti messaggi e-mail validi, gli utenti rimangono in stato di attesa. Segui Verifica provisioning utente con e-mail non attendibili per eliminare gli utenti.
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Hybrid, nella sezione BroadWorks Calling elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera collegare Webex per BroadWorks al cliente, seguire i processi di provisioning per collegarlo a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API Rimuovi abbonato BroadWorks è quella di accedere a BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati. |
Gestione di utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente sono in BroadWorks. Un'identità e-mail distinta per l'utente e le relative licenze per le funzioni Webex vengono conservate in Webex.
Verifica del provisioning utenti con indirizzi e-mail non attendibili
Se si sta eseguendo il provisioning di utenti Webex per BroadWorks utilizzando il provisioning flow-through con e-mail non attendibili, gli utenti devono eseguire il provisioning automaticamente inserendo il relativo indirizzo e-mail nel portale di attivazione utente. Se l'utente riscontra un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riscontra nuovamente l'errore, l'amministratore può utilizzare i passaggi seguenti in Partner Hub per esaminare lo stato e caricare l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 | Accedere a Partner Hub e trovare la pagina Elenco clienti. |
2 | Fare clic su Visualizza modelli. Selezionare il modello di onboarding appropriato che si desidera applicare a questo utente. |
3 | In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con e-mail non attendibili sia configurato correttamente:
|
4 | In seguito al provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato del provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo stato corrente, che mostra se l'utente è predisposto o se è presente un requisito in sospeso.
|
5 | Per gli utenti con errori o requisiti in sospeso, fare clic sui tre punti a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili quando si visualizza l'elenco degli utenti:
Esporta: fare clic su questo pulsante se si desidera esportare l'elenco utenti in un file CSV.
Escludi utenti predisposti: abilita questo tasto di alternanza se desideri visualizzare solo gli utenti con requisiti o errori in sospeso.
Modifica ID utente o indirizzo e-mail
Modifiche a ID utente e indirizzo e-mail
L'ID e-mail e l'ID alternativo sono gli attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. La tabella seguente descrive gli scopi di questi diversi attributi e cosa fare se occorre cambiarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non puoi modificare questo identificativo e comunque collegare l'utente allo stesso account in Webex. È possibile eliminare l'utente e ricreare se non è corretto. |
ID e-mail | ID utente | Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si afferma che l'e-mail è attendibile Non richiesto in BroadWorks se non si asserisce di poter considerare attendibili i messaggi e-mail Non richiesto in BroadWorks se consenti agli abbonati di autoattivarsi | È presente un processo manuale per modificare questa opzione in entrambe le posizioni se all'utente è stato eseguito il provisioning con l'indirizzo e-mail errato:
Non modificare l'ID utente BroadWorks. Questa operazione non è supportata. |
ID alternativo | Nessuno | Consente di abilitare l'autenticazione dell'utente per e-mail e password rispetto all'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se Non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti dovranno inserire il proprio ID utente BroadWorks durante l'autenticazione. |
Modifica pacchetto utenti in Partner Hub
1 | Accedi a Partner Hub e fai clic su Clienti. |
2 | Individuare e selezionare l'organizzazione del cliente a cui è assegnato l'utente. Viene visualizzata la pagina di panoramica dell'organizzazione in un pannello a destra dello schermo. |
3 | Fare clic su Visualizza cliente. L'organizzazione del cliente si apre in Control Hub, mostrando la pagina Panoramica.
|
4 | Fare clic su Utenti, quindi individuare e fare clic sull'utente interessato. |
5 | Nei Servizi dell'utente, fare clic su Webex per i pacchetti BroadWorks (Abbonamenti). Si apre il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 | Nella scheda Profilo, cercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 | Seleziona il pacchetto che desideri per questo utente (Base, Standard, Premium o Softphone) e fai clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 | Puoi chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium hanno siti di riunione distinti associati a ciascun pacchetto. Quando un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato viene visualizzato con due siti di riunione in Control Hub. Le funzionalità di riunione organizzatore e il sito della riunione dell'abbonato vengono allineati al pacchetto corrente. Il sito della riunione del pacchetto precedente e qualsiasi contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili all'amministratore del sito della riunione. |
Potrebbero essere necessarie da due a tre ore per le nuove impostazioni PMR derivanti da una modifica del pacchetto da aggiornare. |
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si desidera eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto alcun trasferimento automatico del ruolo di amministratore nel caso in cui venga eliminato l'ultimo amministratore. |
API Cisco BroadWorks per Webex
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
Eseguire la richiesta API Remove a BroadWorks Subscriber su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento Webex per Cisco BroadWorks. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
Eseguire la richiesta Elimina una persona API su https://developer.webex.com/docs/api/v1/people/delete-a-person per eliminare completamente l'utente.
Provisioning flow-through
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – IM&P integrato in BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks - Parte 2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento Webex per Cisco BroadWorks dall'utente. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla propria organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 | Usa le API Persone per eliminare tutti gli utenti dall'organizzazione:
| ||
2 | Se la sincronizzazione rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione rubriche tramite Partner Hub: Per disabilitare la sincronizzazione rubriche tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API aziendale BroadWorks e disabilita l'impostazione enableDirSync. Tutti gli utenti correlati alla sincronizzazione rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione degli utenti (utilizzando entrambi i metodi) può richiedere del tempo a seconda della quantità di utenti. | ||
3 | Una volta rimossi tutti gli utenti, utilizza l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Gestione delle release
I controlli di gestione delle release in Partner Hub consentono a Webex per i provider di servizi Cisco BroadWorks di gestire facilmente le release consentendo loro di controllare la cadenza di rilascio in base alla quale le app Webex degli utenti vengono aggiornate all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza gli aggiornamenti automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
Configurazione di pianificazioni di rilascio personalizzate con rinvii dalla pianificazione di rilascio predefinita Cisco
Configurare una singola pianificazione della release e trasferirla a cascata a tutte le organizzazioni dei clienti che gestiscono
Assegna diverse pianificazioni di rilascio a diverse organizzazioni di clienti
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di rilascio personalizzate, vedere l'articolo Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
Aggiunta di un cluster BroadWorks in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
Aggiunta di un modello di onboarding in Partner Hub
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | ||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | ||
3 | Fare clic su Visualizza cluster. | ||
4 | Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro flyout a destra.
| ||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | |||||||||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | |||||||||
3 | Fare clic su Visualizza modelli. | |||||||||
4 | Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere a Webex Assistant di seguire le azioni, prendere nota di decisioni importanti ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant per Meetings è disponibile gratuitamente per i siti per riunioni con pacchetto Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilitazione di Webex Assistant per Meetings
Webex Assistant è abilitato per impostazione predefinita per i clienti Broadworks con pacchetto standard e premium.
Gli amministratori dei partner e gli amministratori delle organizzazioni dei clienti possono disabilitare la funzione per le organizzazioni dei clienti tramite Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
Il supporto è limitato ai siti per riunioni con pacchetto Premium e Standard e solo alle sale riunioni personali.
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
La condivisione di contenuto tramite e-mail è accessibile solo dagli utenti all'interno della tua organizzazione
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Il contenuto della riunione non è accessibile anche se condiviso tra utenti di pacchetti diversi dall'interno della stessa organizzazione.
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile, pertanto le trascrizioni post-riunione non sono disponibili se Webex Assistant è abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni utente su come utilizzare la funzione, vedere Uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
Webex Calling gratuito è abilitato per impostazione predefinita consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, che disabilita tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzione
Se Webex Calling è disabilitato, le seguenti condizioni si applicano a Webex per gli utenti Cisco BroadWorks:
Gli utenti non visualizzano più Chiamata con Webex come opzione di chiamata selezionabile sull'app Webex.
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, la cronologia chiamate, i contatti, inserendo l'URI dell'altro utente o l'indirizzo e-mail nella barra di ricerca.
Condivisione schermo all'interno di una chiamata BroadWorks.
Le riunioni Webex e la presenza in telefonia funzionano ancora, anche se le chiamate Webex sono disabilitate.
Disabilita chiamate Webex (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno di Aggiungi un nuovo modello guidata. Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti assegnate al modello.
Per informazioni dettagliate sulla configurazione di un nuovo modello di onboarding, vedere Configurazione dell'organizzazione partner in Partner Hub.
Disabilita chiamate Webex (modello di onboarding esistente)
Seguire questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
Accedere a Partner Hub all'indirizzo admin.webex.com.
Scegliere Impostazioni.
Fare clic su Visualizza modello e scegliere il modello di inserimento appropriato.
Fai clic su Disabilita chiamata gratuita Cisco Webex.
Fai clic su Salva.
Disabilita chiamate Webex (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare Webex Calls per un utente esistente, è possibile seguire una delle procedure seguenti per aggiornare l'utente.
Accertarsi di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigura l'utente con le chiamate Webex abilitate. |
Se si utilizza il provisioning flow-through, è possibile effettuare le seguenti operazioni:
Aprire CommPilot e passare alla configurazione utente.
Rimuovere il servizio Integrated IM+P dall'utente e fare clic su OK.
Aggiungere il servizio Integrated IM+P all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
Utilizzare Remove a BroadWorks Subscriber API per eliminare l'utente.
Utilizzare la Provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione della condivisione video o dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per informazioni dettagliate sulla configurazione e le opzioni complete, vedere Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è anche possibile configurare se il contenuto multimediale delle chiamate in ingresso utilizza per impostazione predefinita solo il video o l'audio. |
Indicatore di stato della linea / Notifica risposta per assente
L'indicatore di stato/notifica di risposta per assente utilizza le funzioni di risposta per assente indirizzata. Un utente con indicatore di stato riceve una notifica audio e visiva sull'app Webex quando un utente dell'elenco di indicatori di stato monitorato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può Ignorare o Rispondere alla chiamata dell'utente monitorato.
La notifica dell'indicatore di stato/risposta per assente consente di rispondere alle chiamate di altri membri del team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra chiamata multipla - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza dei membri del team Webex e non Webex. Per informazioni sull'abilitazione della chiamata multipla, vedere: Finestra multi-chiamata
I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati nella rubrica in Webex e avranno solo stati "sconosciuti" e "in chiamata" (lo stato suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
La presenza non è supportata per gli utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
Gli utenti CI senza autorizzazione cloud Webex o tipo di account macchina (spazi di lavoro) visualizzano solo la presenza "in chiamata" e "sconosciuta". Nessun stato attivo, suoneria, ecc.
Gli utenti non Webex dall'elenco di indicatori di stato, che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza "sconosciuta".
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
Se un utente non Webex dell'indicatore di stato detiene una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate su BroadWorks. Installare solo le patch valide per la versione in uso:
Per R22:
Piattaforma AP.22.0.1123.ap382053
AP.as.22.0.1123.ap382053
AP.as.22.0.1123.ap382362
AP.xsp.22.0.1123.ap382053
AP.xsp.22.0.1123.ap382362
AP.as.22.0.1123.ap383459
AP.as.22.0.1123.ap383520
Per R23:
Piattaforma AP.23.0.1075.ap382053
AP.as.23.0.1075.ap382053
AP.as.23.0.1075.ap382362
AP.as.23.0.1075.ap383459
AP.as.23.0.1075.ap383520
Se si utilizza XSP|ADP:
AP.xsp.23.0.1075.ap382053
AP.xsp.23.0.1075.ap382362
Se si utilizza ADP:
Xsi-Actions-23_2022.01_1.200.bwar
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
Per R24:
AP.as.24.0.944.ap382053
AP.as.24.0.944.ap382362
AP.as.24.0.944.ap383459
AP.as.24.0.944. ap383520
Xsi-Actions-24_2022.01_1.200.bwar
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
<busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare la funzione 101642 Enhanced Xsi Mechanism Per la telefonia del team su AS:
AS_CLI/System/ActivatableFeature> activate 101642
Abilita X-BroadWorks-Remote-Party-Info
in AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamata SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Accertarsi che i seguenti servizi siano assegnati agli utenti:
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP. |
Configurazione dell'indicatore di stato della linea su BroadWorks
Gli amministratori dei partner possono utilizzare la seguente procedura per impostare l'indicatore di stato della linea per un utente.
Accedere a BroadWorks CommPilot.
Per un utente selezionato, accedere ad Applicazioni client e configurare l'indicatore di stato della linea.
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
Utilizzare i parametri di ricerca per individuare e aggiungere utenti all'elenco Utenti monitorati.
Fai clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento di coinvolgimento del pubblico facile da usare. Consente alle persone di ottenere il massimo dalle riunioni colmando la distanza tra oratori e pubblico. Quando Slido è integrato nell'organizzazione Control Hub, gli utenti possono aggiungere l'Slido app alle riunioni nell'app Webex. Questa integrazione offre ulteriori funzionalità di Q&A e sondaggio alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando è stata accettata una riunione nel client Outlook che corrisponde a un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che hai assunto un impegno diverso e che la risposta potrebbe essere ritardata.
Per abilitare questa funzione:
andare alla scheda Generale della scheda Impostazioni su Windows o Preferenze su Mac.
Selezionare la casella per Mostra in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, "In una riunione di calendario" in Webex è associato a "Occupato" in Outlook. |
Avvertenza
Per utilizzare questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come funziona altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la sua presenza non verrà aggiornata fino al termine della riunione. A tale scopo, sarà necessario riavviare il client per rispondere.
Risposta automatica con tono
Con la risposta automatica con tono, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul desktop. Quando l'app Webex squilla sull'altra parte, l'utente sente un determinato segnale acustico che indica che la chiamata è in connessione.
Per utilizzare questa funzione per un utente Webex per Cisco BroadWorks:
La funzione è supportata solo sull'aspetto della linea principale
L'app Webex deve essere l'identificativo di linea principale
Il tag %ENABLE_AUTO_ANSWER_WXT% deve essere abilitato
Se l'utente dispone anche di indicatori di chiamata condivisa (ad esempio, un telefono da tavolo è configurato come uno degli indicatori di linea secondaria), la funzione è ancora supportata sull'aspetto principale, a condizione che gli indicatori di chiamata condivisa siano configurati per non ricevere chiamate in arrivo. Per effettuare questa operazione, è possibile configurare una delle tre condizioni seguenti su BroadWorks per tutte le chiamate condivise:
Avvisa tutti gli aspetti delle chiamate con clic è disabilitato nella configurazione dell'aspetto chiamata condivisa: questo è l'approccio consigliato
o
Consenti terminazione a questa posizione deve essere disabilitato per tutte le chiamate condivise o
o
Posizioni disabilitate per tutti gli indicatori di chiamata condivisi
Aumentare la capacità
Aziende agricole XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare quante risorse XSP|ADP aggiuntive sono necessarie per l'aumento proposto dei numeri di abbonati. Per le aziende NPS dedicate o Webex dedicato per le aziende Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
Fattoria dedicata in scala: Aggiungere uno o più server XSP|ADP all'azienda che ha bisogno di capacità extra. Installare e attivare lo stesso set di applicazioni e configurazioni dei nodi esistenti dell'azienda agricola.
Aggiungi azienda agricola dedicata: Aggiungi una nuova fattoria XSP|ADP dedicata. Dovrai creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti nella nuova fattoria, per ridurre la pressione sulla fattoria esistente.
Aggiungere azienda agricola specializzata: Se si verificano strozzature per un particolare servizio, è possibile creare un'azienda agricola ADP|XSP separata a tale scopo, tenendo conto dei requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster di Control Hub e le voci DNS se si modifica l'URL del servizio con una nuova azienda agricola.
In tutti i casi, è tua responsabilità monitorare e assegnare risorse all’ambiente BroadWorks. Se si desidera contattare l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare i servizi professionali.
Gestione dei certificati del server HTTP
È necessario gestire questi certificati per le applicazioni Web autenticate mTLS su XSP|ADP:
La nostra catena di certificati di attendibilità dal cloud Webex
Certificati delle interfacce del server HTTP di XSP|ADP
Catena di fiducia
È possibile scaricare la catena del certificato di attendibilità da Control Hub e installarlo sugli ADP|XSP durante la configurazione iniziale. Prevediamo di aggiornare il certificato prima della scadenza e di informarvi su come e quando modificarlo.
Interfacce del server HTTP
L'|ADP XSP deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Certificati ordine. Quando si protegge l'interfaccia, viene generato un certificato autofirmato per l'interfaccia. Questo certificato è valido per un anno da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione di Partner Hub che gli amministratori dei partner possono assegnare a organizzazioni di clienti specifiche per limitare le impostazioni dell'organizzazione che gli amministratori dei clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione del cliente, tutti gli amministratori del cliente di tale organizzazione, indipendentemente dalle autorizzazioni dei ruoli, non sono in grado di accedere a un set di controlli con limitazioni in Control Hub. Solo un amministratore partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner esiste un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita le autorizzazioni di ruolo specifiche per gli amministratori dei clienti nell'organizzazione a cui è applicata l'impostazione. |
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità con limitazioni per partner. Dopo l'accesso, vedrà un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner notifica all'amministratore del cliente che la Modalità con limitazioni è abilitata e che l'amministratore potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore del cliente in un'organizzazione in cui con limitazioni della modalità partner è abilitata, il livello di accesso di Control Hub è determinato con la formula seguente:
(Accesso a Control Hub) = (Entitlements Role Organization) - (Limitato dalle limitazioni della modalità partner)
Limitazioni
Quando è abilitata la modalità con limitazioni per partner per un'organizzazione del cliente, gli amministratori dei clienti di tale organizzazione non possono accedere alle seguenti impostazioni di Control Hub:
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
Pulsante Gestisci utenti: disattivato.
Aggiungi o modifica manualmente utenti: nessuna opzione per aggiungere o modificare gli utenti, né manualmente né tramite CSV.
Richiedi utenti: non disponibile
Assegna automaticamente licenze: non disponibile
Sincronizzazione rubriche —Impossibile modificare le impostazioni di sincronizzazione delle rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato ed e-mail principale* sono modificabili.
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, messaggi, riunioni, chiamate)
Visualizza stato servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
Numero di lavoro principale: questo campo è di sola lettura.
Nella vista Account, non sono disponibili le seguenti impostazioni:
Nome società: campo di sola lettura.
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
Dominio: accesso di sola lettura.
E-mail: le impostazioni Elimina inviti e-mail di amministrazione e Selezione impostazioni internazionali e-mail sono di sola lettura.
Autenticazione: nessuna opzione per la modifica delle impostazioni di autenticazione e SSO.
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
Impostazioni chiamata: le impostazioni di priorità della chiamata delle opzioni dell'app sono di sola lettura.
Funzionamento chiamata: le impostazioni sono di sola lettura.
Posizione > PSTN: le opzioni Gateway locale e Cisco PSTN sono nascoste.
Sotto SERVIZI, le opzioni di servizio Migrazioni e Connected UC vengono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori partner possono utilizzare la procedura seguente per l'abilitazione Con limitazioni della modalità partner per una determinata organizzazione cliente (l' impostazione predefinita è abilitata).
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
Seleziona l'organizzazione cliente applicabile.
Nella vista Impostazioni di destra, abilitare il Con limitazioni della modalità partner per attivare l'impostazione.
Se si desidera disattivare la modalità Con limitazioni per partner, disabilitare l'interruttore.
Se il partner rimuove la modalità amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà eseguire quanto segue:
|
Analisi dei partner
I miglioramenti di Control Hub consentono agli amministratori partner di visualizzare e aggiornare facilmente le informazioni sui pacchetti per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata di tutti i clienti e include i seguenti dettagli:
Utenti totali per pacchetto (Softphone, Base, Standard, Premium)
Tendenza utenti per pacchetto (giornaliero/settimanale/mensile)
Clienti con n. di pacchetti assegnati
Per informazioni dettagliate su come utilizzare Analisi dei partner, vedere l'articolo Webex Analisi per i pacchetti Webex per la vendita all'ingrosso e Webex per BroadWorks in Partner Hub .
API di report fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare report di fatturazione. Nella tabella seguente vengono elencate le API, il tipo di accesso richiesto e i requisiti di ruolo.
API di fatturazione | Scopo | Tipo di accesso | Requisiti di ruolo per API (L'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Creazione di un report di fatturazione BroadWorks | Utilizzato per generare un report di fatturazione. | Accesso in scrittura |
|
Elenca report di fatturazione BroadWorks | Consente di elencare i report disponibili per la visualizzazione. | Accesso in lettura |
|
Ottenere un report di fatturazione BroadWorks | Utilizzato per ottenere una copia di un report generato. | Accesso in lettura |
|
Eliminazione di un report di fatturazione BroadWorks | Utilizzato per eliminare un report generato. | Accesso scrittura |
|
Campi di fatturazione
Nella tabella seguente sono elencati i campi contenuti nel report generato.
Campo | Descrizione |
---|---|
nome rivenditore | Nome partner o ID organizzazione partner |
ID fatturazione | Identificativo di fatturazione univoco del partner o numero C |
IdImpresaSp | L'identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno | Stato versione di prova interna del cliente (Sì/No) |
ID utente | IDutente dell'abbonato su BroadWorks |
id abbonato | Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato | Sì/No |
Data iniziale | Data di provisioning dell'abbonato. |
dataInizioFatturazione | Data di inizio fatturazione in questo mese |
DataFineFatturazione | Data di fine fatturazione in questo mese |
pacchetto | Il tipo di confezione che viene caricata |
quantità | Quantità ripartita per fatturazione.
|
|
Risoluzione dei problemi di Webex per Cisco BroadWorks
Abbonamento alla pagina di stato Webex
Innanzitutto verificare https://status.webex.com quando si verifica un'interruzione imprevista del servizio. Se non hai modificato la tua configurazione in Control Hub o BroadWorks prima dell'interruzione, controlla la pagina di stato. Ulteriori informazioni sull'iscrizione per le notifiche di stato e incidenti al Centro assistenza Webex.
Usa analisi Control Hub
Webex monitora l'utilizzo e i dati di qualità per la tua organizzazione e le organizzazioni dei tuoi clienti. Ulteriori informazioni sulle analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
Clienti o utenti non vengono creati in Control Hub con provisioning flowthrough:
Il server applicazioni può raggiungere l'URL di provisioning?
L'account di provisioning e la password sono corretti? Tale account esiste in BroadWorks?
I cluster non riescono in modo coerente a eseguire i test di connettività:
La connessione mTLS al servizio di autenticazione non riesce quando si crea il primo cluster in Partner Hub, poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. In caso contrario, non è possibile creare un'ancora attendibile sul servizio di autenticazione XSP|ADPs, pertanto la connessione mTLS di prova da Partner Hub non viene eseguita correttamente. |
Le interfacce XSP|ADP sono accessibili pubblicamente?
Stai utilizzando le porte corrette? È possibile immettere una porta nella definizione dell'interfaccia sul cluster.
Convalida non riuscita interfacce
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Esaminare i consigli per la configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Rivedere i consigli sulla configurazione dell'interfaccia in questo documento, con particolare attenzione a:
- Accertarsi di aver condiviso le chiavi RSA tra tutti gli XSP|ADP.
- Accertarsi di aver fornito l'URL AuthService al contenitore Web su tutti gli XSP|ADP.
- Se è stata modificata la configurazione della crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'|ADP XSP richiede di immettere il formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento elencava erroneamente le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati sul proprio archivio attendibile XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere i certificati del client?
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere i certificati del client?
Problemi del cliente
Verificare che il client sia connesso a BroadWorks
Accedere all'app Webex.
Verificare che l'icona Opzioni di chiamata (un ricevitore con una marcia sopra) sia presente sulla barra laterale.
Se l'icona non è presente, l'utente potrebbe non essere ancora abilitato per il servizio di chiamata in Control Hub.
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici . Viene visualizzato lo stato Sessione SSO A cui è stato eseguito l'accesso.
Se viene visualizzato un servizio telefonico diverso, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Tale verifica comporta:
Il client ha eseguito correttamente il transveresed dei microservizi Webex richiesti.
Autenticazione dell'utente eseguita correttamente.
Il client ha ricevuto un token Web JSON di lunga durata dal sistema BroadWorks.
Il client ha recuperato il proprio profilo dispositivo e si è registrato su BroadWorks.
Registri client
Tutti i client dell'app Webex possono Inviare I Registri a Webex. Questa è l'opzione migliore per i client mobili. È inoltre necessario registrare l'indirizzo e-mail dell'utente e l'ora approssimativa in cui si è verificato il problema se si sta cercando assistenza da TAC. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se è necessario raccogliere manualmente i registri da un PC Windows, si trovano come segue:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac:/Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS configurata male
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
Verificare che la catena di certificati Webex sia installata come ancora affidabile.
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e firmato da una CA ben nota.
Messaggio di eccedenza licenza
Questo messaggio può apparire per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'utilizzo delle licenze supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Politica di supporto allo stato stazionario
Il provider di servizi è il primo punto di contatto per il supporto del cliente finale (aziendale). Inoltrare i problemi che il SP non è in grado di risolvere al centro TAC. Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Politica di escalation
Tu (provider di servizi/partner) sei il primo punto di contatto per il supporto clienti finali (aziendale).
I problemi che non possono essere risolti dal SP vengono inoltrati al centro TAC.
Versioni di BroadWorks
Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Risorse di autosupporto
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, dove è presente una pagina specifica di Webex per Cisco BroadWorks che elenca argomenti di Guida e supporto comuni dell'app Webex.
L'app Webex può essere personalizzata con questo URL della Guida e un URL di segnalazione problemi.
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I registri vengono inviati al cloud Webex, dove possono essere analizzati da Webex DevOps.
È disponibile anche una pagina Centro assistenza dedicata alla Guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccogliere informazioni per l'invio di una richiesta di assistenza
Quando vengono visualizzati errori in Control Hub, potrebbero essere allegate informazioni che possono aiutare TAC a indagare sul problema. Ad esempio, se viene visualizzato un ID di verifica per un particolare errore o un codice di errore, salvare il testo da condividere con noi.
Prova a includere almeno le seguenti informazioni quando invii una query o apri un caso:
ID organizzazione cliente e ID organizzazione partner (ogni ID è una stringa di 32 cifre esadecimali, separate da trattini)
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce uno
Indirizzo e-mail utente (se un particolare utente riscontra problemi)
Versioni del cliente (se il problema presenta sintomi notati attraverso il cliente)
Confronto UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > | SaaS UC-One | Webex per Cisco BroadWorks |
---|---|---|
Cloud | Cisco UC-One Cloud (GCP) | Webex Cloud (AWS) |
Client | UC-One: Mobile, desktop Receptionist, Supervisore | Webex: Mobile, desktop, Web |
Principale differenza tecnologica | Riunioni condotte sulla tecnologia BroadSoft Meet | Riunioni fornite sulla tecnologia Webex Meetings |
Prove sul campo iniziali | Contesto di stadiazione, clienti beta | Ambiente di produzione, clienti GA |
Identità utente | ID BroadWorks servito come ID principale, a meno che il provider di servizi non disponga già dell'integrazione SSO.
ID utente e segreto in BroadWorks | ID e-mail in Cisco CI serve come ID principale Integrazione SSO in BroadWorks provider di servizi in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks al momento.
L'utente fornisce le credenziali tramite SSO con BroadWorks e Secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e segreti in IdP |
Autenticazione client | Gli utenti forniscono le credenziali attraverso il client Token di lunga durata BroadWorks richiesti se si utilizza la messaggistica Webex | Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso a Webex e aggiornamento dei token |
Gestione / configurazione | I vostri sistemi OSS/BSS e Portale rivenditore | I tuoi sistemi OSS/BSS e Control Hub |
Attivazione partner/provider di servizi | Impostazione una tantum da Cisco Operations | Impostazione una tantum da Cisco Operations |
Attivazione cliente/azienda | Portale rivenditore | Control Hub Creato automaticamente alla prima iscrizione utente |
Opzioni di attivazione utente | Autoiscrizione Imposta IM&P esterno in BroadWorks
| Impostazione di IM&P integrato in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP | Azioni XSI
XSI-Eventi CTI (mTLS) AuthService (mTLS opzionale) DMS | Azioni XSI Azioni XSI (mTLS) XSI-Eventi CTI (mTLS) Servizio di autenticazione (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 | Scarica e installa Webex. Per informazioni dettagliate, vedi Webex | Download dell'app. |
2 | Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 | Inserisci l'indirizzo e-mail e fai clic su Avanti. |
4 | Una delle seguenti operazioni si verifica, a seconda del modo in cui l'organizzazione è configurata in Webex: Webex si carica dopo aver eseguito correttamente l'autenticazione su IdP o BroadWorks.
|
Scambio e archiviazione dati
Queste sezioni forniscono dettagli sullo scambio e la memorizzazione dei dati con Webex. Tutti i dati vengono crittografati sia in transito che a riposo. Per ulteriori informazioni, vedi Webex App Security.
Onboarding provider servizi
Quando si configurano cluster e modelli utente in Webex Control Hub durante l'onboarding di provider di servizi, è possibile scambiare i seguenti dati BroadWorks memorizzati in Webex:
URL Xsi-Actions
URL Xsi-Events
URL interfaccia CTI
URL servizio di autenticazione
Credenziali adattatore di provisioning BroadWorks
Provisioning utente provider di servizi
Questa tabella elenca i dati utente e aziendale che vengono scambiati come parte del provisioning utente attraverso le API Webex.
Trasferimento dei dati in Webex | Da | Attraverso | Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito da SP) | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito dall’utente) | Utente | Portale di attivazione utente | Sì |
Nome | BroadWorks, per API | API Webex | Sì |
Cognome | BroadWorks, per API | API Webex | Sì |
Numero di telefono principale | BroadWorks, per API | API Webex | Sì |
Numero telefono cellulare | BroadWorks, per API | API Webex | Sì |
Estensione principale | BroadWorks, per API | API Webex | Sì |
ID provider di servizi BroadWorks e ID gruppo | BroadWorks, per API | API Webex | Sì |
Lingua | BroadWorks, per API | API Webex | Sì |
Fuso orario | BroadWorks, per API | API Webex | Sì |
Rimozione utente
Le API Webex per Cisco BroadWorks supportano la rimozione parziale e completa dell'utente. Questa tabella elenca tutti i dati utente memorizzati durante il provisioning e ciò che viene eliminato in ogni scenario.
Dati utente | Eliminazione parziale | Eliminazione completa |
---|---|---|
ID utente BroadWorks | Sì | Sì |
No | Sì | |
Nome | No | Sì |
Cognome | No | Sì |
Numero di telefono principale | Sì | Sì |
Numero telefono cellulare | Sì | Sì |
Estensione | Sì | Sì |
ID provider di servizi BroadWorks e ID gruppo | Sì | Sì |
Lingua | No | Sì |
Accesso utente e recupero configurazione
Autenticazione Webex
L'autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da uno qualsiasi dei meccanismi di autenticazione del supporto Webex. (L'autenticazione BroadWorks è trattata separatamente.) Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (indipendente) | Webex | Browser utente |
Credenziali utente | Browser utente | Provider identità (che dispone già di identità utente) |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Autenticazione BroadWorks
L'autenticazione BroadWorks si riferisce all'accesso dell'utente a un'app Webex utilizzando le credenziali BroadWorks. Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (proxy Webex Bwks IdP) | Webex | Browser utente |
Informazioni sul branding e URL BroadWorks | Webex | Browser utente |
Credenziali utente BroadWorks | Utente tramite browser (pagina di accesso con marchio servita da Webex) | Webex |
Credenziali utente BroadWorks | Webex | BroadWorks |
Profilo utente BroadWorks | BroadWorks | Webex |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento dell'avviso di accesso e del messaggio di errore:
- Attualmente gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso poiché la password è già scaduta. Con questa funzione, se la password sta per scadere tra 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere, con l'indicazione di quanti giorni rimangono, e all'utente viene consigliato di contattare il partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su true, è stato emesso l'errore "nome utente e password errati", ma ora con questa funzione viene migliorato il messaggio di errore: Tentativo di accesso non riuscito. La combinazione di ID utente e password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice errore 100006
Controllo flusso di accesso:
- Il partner può limitare l'accesso abilitando un'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione in broadworks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, quindi viene visualizzato un errore che indica che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso può essere configurato dal partner come parte della funzione di personalizzazione avanzata. I partner solitamente configurano il collegamento per passare dall'utente a un portale partner per la gestione della password e la reimpostazione della password.
Questa funzione migliora l'esperienza di accesso utente solo durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se una password scade mentre l'utente è connesso all'app Webex. L'utente riceve la notifica di scadenza della password al successivo tentativo di accesso. |
Recupero configurazione cliente
Questa tabella illustra la tipologia di dati scambiati tra le diverse componenti in fase di recupero delle configurazioni del cliente.
Trasferimento dei dati | Da | Per |
---|---|---|
Iscrizione | Client | Webex |
Impostazioni organizzazione, inclusi URL BroadWorks | Webex | Client |
Token JWT BroadWorks | BroadWorks attraverso Webex | Client |
Token JWT BroadWorks | Client | BroadWorks |
Token dispositivo | BroadWorks | Client |
Token dispositivo | Client | BroadWorks |
File di configurazione | BroadWorks | Client |
Utilizzo allo stato stazionario
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione dopo la scadenza del token, tramite BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Trasferimento dei dati | Da | Per |
---|---|---|
Segnalazione SIP | Client | BroadWorks |
Supporto SRTP | Client | BroadWorks |
Segnalazione SIP | BroadWorks | Client |
Supporto SRTP | BroadWorks | Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Trasferimento dei dati | Da | Per |
---|---|---|
Messaggistica e presenza REST HTTPS | Client | Webex |
Messaggistica e presenza REST HTTPS | Webex | Client |
Segnalazione SIP | Client | Webex |
Supporto SRTP | Client | Webex |
Segnalazione SIP | Webex | Client |
Supporto SRTP | Webex | Client |
Uso dell'API di provisioning
Accesso sviluppatore
Le specifiche API sono disponibili su https://developer.webex.com e una guida all'uso è disponibile su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l' accedere per leggere la specifica API all'indirizzohttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Autenticazione e autorizzazione applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (ad esempio provisioning abbonato) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere l'aggiornamento e l'accesso ai token per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
Devi prima registrare la tua integrazione con Webex. Una volta eseguita la registrazione, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di accesso e aggiornamento necessari.
Per ulteriori dettagli sulle integrazioni e sulle modalità di creazione di questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli obbligatori per l'implementazione delle integrazioni: sviluppatore e utente autorizzatore, che possono essere svolti da persone/team separati nel proprio ambiente.
|
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning utilizzata:
Modalità Enterprise: il nome dell'organizzazione corrisponde esattamente a spEnterpriseId.
Modalità provider di servizi: il nome dell'organizzazione è la parte groupID di spEnterpriseId.
Il nome dell'organizzazione conterrà qualsiasi spazio vuoto, maiuscolo e caratteri speciali specificati in spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "attuale" con le ultime patch BroadWorks e le app Release Independent (RI). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Assicurarsi di rivedere le note di patch per queste patch software. Alcune patch potrebbero avere requisiti CLI aggiuntivi. |
Versione R22
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | ||
Richiesto per sincronizzazione rubrica | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per il server applicazioni | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per la funzione di registrazione chiamata | ||
Patch richiesta per il provisioning flow-through | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | Richiesto per proxy autenticazione NPS | |
Richiesto per il servizio di autenticazione con convalida token CI | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Obbligatorio per la cronologia chiamate unificata | ||
Altro | AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Richiesto per sincronizzazione rubrica | |
Configurazione server app | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Se si utilizza ADP... | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Versione R24
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per il provisioning flowthrough | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che è necessario configurare per Webex, fare riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utente e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. L'attivazione include la convalida e-mail e l'assegnazione del servizio in Webex. |
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se disponi di indirizzi e-mail affidabili per gli utenti, puoi scegliere di attivarli automaticamente quando esegui il provisioning automatico degli utenti. Questo processo è "provisioning automatico e attivazione automatica".
Provisioning utente automatizzato e attivazione automatica (flusso e-mail affidabile)
Prerequisiti
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase | Descrizione |
---|---|
1 | Citare e prendere ordini per il servizio con i clienti. |
2 | Si elabora l'ordine del cliente e si esegue il provisioning del cliente nei sistemi. |
3 | Il sistema di provisioning dei servizi attiva il provisioning di BroadWorks. Questo passaggio, in sintesi, crea l'azienda e gli utenti. Quindi assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM&P esterno. |
4 | Questo passaggio di provisioning attiva il provisioning automatico dell'organizzazione cliente e degli utenti in Webex. (L'assegnazione del servizio IM&P determina che l'adattatore di provisioning chiami l'API di provisioning Webex). |
5 | I sistemi devono utilizzare l'API di provisioning Webex se successivamente è necessario regolare il pacchetto per l'utente (per passare dall'impostazione predefinita). |
Flusso di accesso SSO
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, che consente l'autenticazione diretta a BroadWorks. L'immagine mostra gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresenta ciò che il client prevede per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizio BroadWorks che segue immediatamente il flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione BroadWorks diretta abilitata (condivisione risorse cross-origin). Di seguito sono riportati alcuni flussi di accesso SSO SAML alternativi:
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
L'unica differenza è nei punti 5 e 6 del flusso di accesso Webex. Nel passaggio 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
Il flusso procede attraverso i restanti passaggi dei due diagrammi.
Il token SSO non viene utilizzato in questo flusso.
Autenticazione SSO SAML Webex:
Nel passaggio 3 del flusso di accesso Webex, il servizio Common Identity restituisce il provider di identità utilizzato dall'autenticazione Webex.
A questo punto, viene invocato un flusso di accesso SSO SAML alternativo per Webex.
Interazioni utente
Accedi
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
CI rileva che l'organizzazione cliente associata dispone del proxy IDP BroadWorks (IDP) configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso (il provider di servizi può contrassegnare questa pagina di accesso).
L'utente inserisce le credenziali BroadWorks.
Broadworks esegue l'autenticazione dell'utente attraverso l'IDP. In caso di successo, l'IDP reindirizza il browser a CI con un SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
Una volta completata l'autenticazione, l'app Webex ottiene i token di accesso da CI (non mostrati nel diagramma). Il client li utilizza per richiedere un token Web Jason (JWT) di lunga durata BroadWorks.
L'app Webex rileva la configurazione di chiamata da BroadWorks e altri servizi da Webex.
L'app Webex si registra in BroadWorks.
Accesso dalla prospettiva dell'utente
Questo diagramma è il tipico flusso di accesso, visualizzato dall'utente finale o dall'abbonato:
Scarica e installa l'app Webex.
È possibile che tu abbia ricevuto il collegamento dal provider di servizi o che tu possa trovare il download nella pagina di download di Webex.
Inserire l'indirizzo e-mail nella schermata di accesso Webex. Fai clic su Avanti.
Solitamente, si viene reindirizzati a una pagina con il marchio del fornitore di servizi.
Questa pagina potrebbe accogliervi tramite il vostro indirizzo e-mail.
Se non è presente alcun indirizzo e-mail o se l'indirizzo e-mail è errato, inserisci il nome utente BroadWorks.
Inserisci la password BroadWorks.
Se è stato eseguito correttamente l'accesso, Webex si apre.
Flusso chiamate - Rubrica aziendale
Flusso chiamata: numero PSTN
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni con i clienti
Recupero del profilo dal registro DMS e SIP con AS
Il client chiama XSI per ottenere un token di gestione dispositivo e l'URL del DMS.
Il client richiede il proprio profilo dispositivo dal DMS presentando il token dal punto 1.
Il client legge il profilo del dispositivo e recupera le credenziali, gli indirizzi e le porte SIP.
Il Client invia un REGISTRO SIP a SBC utilizzando le informazioni dal punto 3.
SBC invia il REGISTRO SIP al SA (l'SBC può eseguire una ricerca nell'NS per individuare un SA se il SBC non conosce già l'utente SIP).
Linee guida per test e laboratorio
Le seguenti linee guida si applicano alle organizzazioni di test e laboratorio:
I partner provider di servizi sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
Tutti gli utenti oltre i primi 50 utenti di test verranno fatturati.
Per garantire un'elaborazione accurata sulla fattura, tutte le organizzazioni di test devono includere il "test" nel nome dell'organizzazione BroadWorks.
Le organizzazioni di test interni devono essere designate all'interno di Webex Control Hub. Ciò al fine di impedire agli utenti di test di essere fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di prova:
Accedi a Partner Hub e seleziona Clienti.
Selezionare il cliente appropriato.
Nella barra di controllo destra, abilitare il tasto di alternanza Organizzazione test interni.
Riproduzione casella vocale
Per la casella vocale, accertarsi di configurare il server multimediale per utilizzare uno dei seguenti codici:
mp3
wav: i file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android
Se si utilizzano i file wav, eseguire i seguenti comandi CLI per configurare il server applicazioni e il server multimediale:
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACIDITÀ
- Elenco di controllo accessi
- ALVEOLO
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APICI
- Servizio di notifica push Apple
- AS
- Server applicazioni
- ATA
- Adattatore per telefono analogico, adattatore che converte la telefonia analogica in VoIP
- BAMBOLA
- Gestione applicazioni BroadSoft
- Autenticazione base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- ALVEOLARE
- Server di messaggistica BroadSoft
- PALUDE
- Flussi bidirezionali Su HTTP sincrono
- BRI
- Basic Rate Interface BRI è un metodo di accesso ISDN
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico telefonico (cfr. partner, provider di servizi, rivenditore a valore aggiunto)
- CAPTCHA
- Test di Turing pubblico completamente automatizzato per distinguere Computer ed Esseri Umani
- CCXML
- Linguaggio di markup eXtensible controllo chiamate
- CIF
- Formato intermedio comune
- CLI
- Interfaccia riga di comando
- CN
- Nome comune
- CNPS
- Server push notifiche chiamate. Un server push notifiche che viene eseguito su un ADP XSP| nel proprio ambiente per eseguire notifiche di chiamata push su FCM e APNS. Vedere il proxy NPS.
- CPE
- Attrezzatura della sede del cliente
- CPR
- Regola presenza personalizzata
- CENERE
- Foglio stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione telefonia computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- Non disturbare
- Non disturbare
- DNS
- Sistema dei nomi di dominio
- DPG
- Chiama gruppo di pari
- DSCP
- Punto codice servizi differenziati
- DTAF
- File di archivio tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza a doppia tonalità
- Utente finale
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. Sottoscrittore)
- Aziendale
- Una raccolta di utenti finali (cfr. Organizzazione)
- FUSO
- Messaggistica cloud Firebase
- DI FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creare utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning completo flow-through
- Creare e verificare gli utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks e asserendo che ciascun utente BroadWorks dispone di un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. È la spina sul telefono o fax o i connettori sul sistema telefonico analogico. Fornisce un'indicazione di aggancio/aggancio sganciato (chiusura con loop). Poiché la porta FXO è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo FXO".
- FXS
- Foreign Exchange Subscriber è la porta che effettivamente fornisce la linea analogica all'abbonato. In altre parole, è la "spina nella parete" che fornisce un segnale di linea, corrente della batteria e tensione della suoneria.
- GABBIA
- Messaggio cloud Google
- GABBIA
- Modalità Galois/Counter (tecnologia di crittografia)
- HID
- Dispositivo interfaccia uomo
- HTTPS
- Prese protette da protocollo di trasferimento ipertestuale
- IAD
- Dispositivo di accesso integrato
- IM&P
- messaggistica istantanea e presenza
- PSTN IP
- Un provider di servizi che fornisce VoIP ai servizi PSTN, intercambiabile con ITSP, o un termine generale per la telefonia "pubblica" connessa a Internet, fornito collettivamente dai principali provider di telecomunicazioni (piuttosto che dai paesi, come è PSTN)
- ITSP
- Provider servizi di telefonia Internet
- IVR
- Risposta vocale/risponditore interattiva
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificatore Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notazione oggetto script Java
- JESS
- Java Secure Socket Extension; la tecnologia sottostante che fornisce funzioni di connettività sicure ai server BroadWorks
- KEM
- Modulo interno chiave (telefoni Cisco hardware)
- LLT
- Token di lunga durata (o Long Life): token di connessione autodescrittivo e sicuro che consente agli utenti di rimanere autenticati più a lungo e non è legato ad applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIGLIO
- Base di informazioni di gestione
- AVV.
- Server multimediale
- mTLS
- Autenticazione reciproca tra due parti, tramite scambio di certificati, quando si stabilisce una connessione TLS
- MUCO
- Chat con più utenti
- NAT
- Traduzioni dell'indirizzo di rete
- NPS
- Server push notifica; vedere CNPS
- Proxy NPS
-
Un servizio in Webex che fornisce token di autorizzazione di breve durata al CNPS, consentendo di eseguire notifiche di chiamata push a FCM e APN e, in ultima analisi, a dispositivi Android e iOS con Webex.
- ASSOCIAZIONE
- Apri interfaccia client
- Organizzazione
- Società o organizzazione che rappresentano un insieme di utenti finali (cfr. Impresa)
- OTG
- Gruppo di trunk in uscita
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- Partner
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. rivenditore a valore aggiunto, fornitore di servizi, gestore telefonico)
- PBX
- Borsa filiale privata
- DELLA SOCIETÀ
- E-mail avanzata per la privacy
- PIEDINO
- Rete mobile terrestre pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia per le telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- P.ES.
- Server profilo
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Sito web che consente all’amministratore del rivenditore di configurare la soluzione UC-One SaaS. Talvolta viene indicato come portale BAM, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Revisore di frontiera sessione
- CEMENTAZIONE
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; un'organizzazione che fornisce servizi di telefonia o correlati ad altre organizzazioni (cfr. vettore, partner, rivenditore a valore aggiunto)
- SIP
- Protocollo di avvio sessione
- SLITTA
- Token di breve durata (o Short Life) (chiamato anche BroadWorks SSO Token); token autenticato monouso utilizzato per accedere in sicurezza ad applicazioni Web.
- ODORE
- Piccole e medie imprese
- SNMP
- Protocollo di gestione di rete semplice
- sRTCP
- protocollo di controllo trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- sRTP
- protocollo di trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- SSL
- Strato di prese sicure
- Abbonato
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. utente finale)
- TCP
- Protocollo di controllo del cambio
- TDM
- Divisione Tempo Multiplexing
- TLS
- Sicurezza livello trasporto
- ToS
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Comunicazioni unificate
- UI
- Interfaccia utente
- U ID
- Identificativo univoco
- MUTI
- Server di messaggistica
- URI
- Identificativo risorsa uniforme
- URL
- Ricerca risorse uniformi
- DISTURBO
- Condivisione server
- UTC
- Coordinated Universal Time
- UVS.
- Server video
- Rivenditore a valore aggiunto (VAR)
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. vettore, partner, fornitore di servizi)
- VAMPATA
- Array di grafica video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Linguaggio di markup estensibile vocale
- WebDAV
- Creazione e versioni distribuite su Web
- WebRTC
- Comunicazioni Web in tempo reale
- WRS
- Server WebRTC
- XMPP
- Protocollo di presenza e messaggistica estendibile
Configurazione dei servizi (con mTLS per il servizio autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida token CI. Queste procedure sono obbligatorie se si stanno eseguendo più organizzazioni Webex dallo stesso server ADP XSP|. In caso contrario, sono facoltativi.
Se non si eseguono più organizzazioni Webex sullo stesso server ADP XSP|, si consiglia la convalida del token CI (con TLS) per il servizio di autenticazione. Fare riferimento a Configura servizi su Webex per Cisco BroadWorks XSP|ADPs per informazioni dettagliate su come configurare il servizio di autenticazione e altri servizi. |
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con mTLS)
I token longevi di BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sui tuoi XSP|ADP.
Requisiti
I server XSP|ADP che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
XSP|ADP devono condividere le stesse chiavi per crittografare/decrittografare token di lunga durata BroadWorks. Copiare queste chiavi in ogni XSP|ADP è un processo manuale.
Gli ADP XSP|devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli XSP|ADP include:
Distribuire il servizio di autenticazione.
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
Generare e condividere le chiavi RSA su XSP|ADP.
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ogni XSP|ADP utilizzato con Webex:
Attivare l'applicazione del servizio di autenticazione sul percorso
/authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService
(dove
<version>
è la versione BroadWorks).Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
deploy application /authService
Configurazione della durata del token
Verificare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
Impostare la durata su 60 giorni (max 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
set tokenDurationInHours 1440
Genera e condividi chiavi RSA
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori è necessario generare chiavi su un XSP|ADP quindi copiarle su tutti gli altri XSP|ADP.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP. |
Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web
Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token.
Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità per il servizio di autenticazione (con mTLS)
Accedi a Control Hub con l'account amministratore del partner.
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
.Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
.Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Esegui GuidaUpdateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot2023
,webexclientissuing
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte e quattro le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, è richiesto mTLS per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/HttpServer>
e eseguire ilget
comando per visualizzare le interfacce.Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che significa come mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. In sostanza, il primo
true
protegge l'interfaccia con TLS (il certificato del server viene creato se richiesto) e la secondatrue
forza l'interfaccia a richiedere l'autenticazione del certificato del client (insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Interface Port Name Secure Client Auth Req Cluster Fqdn
=======================================================
192.0.2.7 443 XSP|ADP01.collab.example.net true false
192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (autenticazione client richiesta = true) è abilitato il 192.0.2.7
porta 444
. TLS abilitato su 192.0.2.7
porta 443
.
(Opzione) Configurazione di mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, è necessario mTLS per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
e eseguire ilget
per visualizzare le applicazioni in esecuzione.Per aggiungere un'applicazione e richiederne l'autenticazione client (ovvero mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. I nomi delle applicazioni sono elencati qui. Il
true
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
add 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService a 192.0.2.7:443 e richiede di richiedere e autenticare i certificati dal client.
Verifica con get
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
get
Interface Ip Port Application Name Client Auth Req
===================================================
192.0.2.7 443 AuthenticationService true
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Dove andare Avanti
Per la configurazione, è possibile accedere nuovamente al flusso dei documenti principale all'interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca rispetto a AuthService
Webex interagisce con il servizio di autenticazione su una connessione TLS autenticata reciproca. Ciò significa che Webex presenta un certificato client e che XSP|ADP deve convalidarlo. Per garantire l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora attendibile su XSP|ADP (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
Vai a Impostazioni > BroadWorks Calling.
Fare clic sul collegamento del certificato di download.
È inoltre possibile scaricare la catena di certificati da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt. |
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il diagramma seguente riassume dove deve essere distribuita la catena di certificati CA Webex in questi tre casi.
Requisiti del certificato TLS reciproco per proxy bridge TLS
Webex presenta un certificato client firmato da CA Webex al proxy.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità proxy, pertanto il proxy considera attendibile il certificato del client.
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta un certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions:
X509v3 Extended Key Usage:
1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Requisiti di certificato TLS reciproco per proxy passthrough TLS o XSP in DMZ
Webex presenta un certificato client firmato da CA Webex agli XSP.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità degli XSP, pertanto gli XSP si affidano al certificato client.
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
Gli XSP presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i certificati server degli XSP.
Cronologia revisioni documenti
La tabella seguente mostra lo storico delle modifiche apportate a questo documento negli ultimi 12 mesi.
Data | Versione | Descrizione della modifica | |
---|---|---|---|
13 maggio 2024 | 2-118 |
| |
10 maggio 2024 | 2-117 |
| |
6 maggio 2024 | 2-116 |
| |
2 maggio 2024 | 2-115 |
| |
10 aprile 2024 | 2-114 |
| |
27 marzo 2024 | 2-113 |
| |
22 marzo 2024 | 2-112 |
| |
7 marzo 2024 | 2-111 |
| |
24 febbraio 2024 | 2-110 |
| |
20 febbraio 2024 | 2-109 |
| |
7 febbraio 2024 | 2-108 |
| |
25 gennaio 2024 | 2-107 |
| |
23 gennaio 2024 | 2-106 |
| |
10 gennaio 2024 | 2-105 |
| |
20 dicembre 2023 | 2-104 |
| |
13 dicembre 2023 | 2-103 |
| |
12 dicembre 2023 | 2-102 |
| |
8 dicembre 2023 | 2-101 |
| |
08 novembre 2023 | 2-100 |
| |
25 ottobre 2023 | 2-99 |
| |
13 settembre 2023 | 2-98 |
| |
04 settembre 2023 | 2-97 |
| |
08 agosto 2023 | 2-96 |
| |
23 giugno 2023 | 2-95 |
| |
30 maggio 2023 | 2-94 |
| |
26 maggio 2023 | 2-93 |
| |
24 maggio 2023 | 2-92 |
| |
10 maggio 2023 | 2-91 |
| |
09 maggio 2023 | 2-90 |
| |
4 maggio 2023 | 2-89 |
| |
27 aprile 2023 | 2-88 |
| |
14 aprile 2023 | 2-87 |
| |
17 marzo 2023 | 2-86 |
| |
11 marzo 2023 | 2-85 |
| |
10 marzo 2023 | 2-84 |
| |
7 marzo 2023 | 2-83 |
| |
28 febbraio 2023 | 2-82 |
| |
15 febbraio 2023 | 2-81 |
| |
10 febbraio 2023 | 2-80 |
| |
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione si rivolge agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei propri clienti o forniscono questa soluzione direttamente ai propri abbonati.
Scopo della soluzione
Fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che già dispongono del servizio di chiamata fornito dai provider di servizi BroadWorks.
Fornire il servizio di chiamata basato su BroadWorks a clienti Webex piccoli e medi.
Contesto
Stiamo evolvendo tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo sforzo consiste nello spostare le funzionalità di chiamata BroadWorks nell'app Webex e infine ridurre gli investimenti nei client UC-One.
Vantaggi
Prova futura: contro interruzione del servizio di UC-One Collaborate, spostamento di tutti i client verso Unified Client Framework (UCF)
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex mantenendo la chiamata BroadWorks sulla rete di telefonia
Ambito della soluzione
Clienti da piccoli a medi esistenti/nuovi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre di chiamate BroadWorks.
Clienti Webex esistenti di piccole e medie dimensioni che desiderano aggiungere BroadWorks Calling.
Non aziende più grandi (rivedere il nostro portfolio Enterprise per Webex).
Non utenti singoli (valutare le offerte Webex Online).
Le funzioni impostate in Webex per Cisco BroadWorks riguardano casi d'uso di piccole e medie imprese. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità per le PMI e ne valutiamo costantemente l'idoneità per questo segmento. Possiamo scegliere di nascondere o rimuovere funzioni che sarebbero altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# | Requisito | Note | ||
---|---|---|---|---|
1 | Patch BroadWorks R22 corrente o superiore | |||
2 | XSP|ADP per XSI, CTI, DMS e authService | XSP|ADP dedicato per Webex per Cisco BroadWorks | ||
3 | XSP|ADP separato per NPS, può essere condiviso con altre soluzioni che utilizzano NPS. | Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni XSP|ADP e NPS. | ||
4 | Convalida token CI (con TLS) configurata per le connessioni Webex al servizio di autenticazione. | |||
5 | mTLS configurato per le connessioni Webex all'interfaccia CTI. | Altre applicazioni non richiedono mTLS. | ||
6 | Gli utenti devono essere presenti in BroadWorks e necessitano dei seguenti attributi, a seconda della decisione di provisioning:
| Per i messaggi e-mail attendibili: Si consiglia di inserire lo stesso indirizzo e-mail anche nell'attributo ID alternativo, per consentire agli utenti di accedere con indirizzo e-mail rispetto a BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'uso di e-mail non attendibili può causare l'invio dell'e-mail alla cartella Posta indesiderata o SPAM dell'utente. L'amministratore potrebbe dover modificare le impostazioni e-mail dell'utente per consentire i domini | ||
7 | Webex per il file DTAF Cisco BroadWorks per l'app Webex | |||
8 | Utente BW Business Lic o Std Enterprise o Prem Enterprise Lic + Webex per abbonamento Cisco BroadWorks | Se si dispone di una distribuzione di collaborazione esistente, non è più necessario il pacchetto aggiuntivo UC-One, le porte per conferenze Collab Lic e Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non occorre apportare altre modifiche se non accettare i termini del pacchetto Premium. | ||
9 | IP/porte devono essere accessibili attraverso i servizi backend Webex e le app Webex su Internet pubblico. | Vedere la sezione "Preparazione della rete". | ||
10 | Configurazione TLS v1.2 su XSP|ADP | |||
11 | Per il provisioning Flowthrough, il server applicazioni deve connettersi all'adattatore di provisioning BroadWorks.
| Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è aiutarti a comprendere, preparare, distribuire e gestire la tua soluzione Webex per Cisco BroadWorks. Le principali sezioni del documento riflettono tale obiettivo.
Questa guida include materiale concettuale e di riferimento. In questo documento intendiamo trattare tutti gli aspetti della soluzione.
La serie minima di attività per distribuire la soluzione è la seguente:
Contatta il team dell'account per diventare un partner Cisco. È fondamentale esplorare i punti di contatto Cisco per acquisire familiarità (e ricevere formazione). Quando si diventa partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Onboarding partner in questo documento.
Configura i tuoi sistemi BroadWorks per l'integrazione con Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento.
Usa Partner Hub per connettere Webex a BroadWorks. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione partner in Partner Hub in questo documento.
Utilizzare Partner Hub per preparare i modelli di provisioning degli utenti. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento.
Testare e eseguire l'onboarding di un cliente mediante il provisioning di almeno un utente (vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
|
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. (Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto).
Come funziona
Webex per Cisco BroadWorks è un'offerta che integra BroadWorks Calling in Webex. Gli abbonati utilizzano una singola applicazione (l'app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
Gli utenti chiamano i numeri PSTN utilizzando l'infrastruttura BroadWorks.
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino numerico per introdurre i numeri).
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Chiamata Webex" sull'app Webex. (Queste chiamate sono da app Webex a app Webex, non da app Webex a PSTN).
Gli utenti possono organizzare e accedere a Webex Meetings.
Gli utenti possono scambiarsi messaggi uno a uno o in spazi (chat di gruppo persistente) e beneficiare di funzioni come ricerca e condivisione file (sull'infrastruttura Webex).
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
Una volta eseguito l'onboarding come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare la relazione tra l'istanza BroadWorks e Webex.
È possibile creare organizzazioni dei clienti in Control Hub e eseguire il provisioning degli utenti in tali organizzazioni.
Ogni abbonato in BroadWorks riceve un'identità Webex in base al proprio indirizzo e-mail (attributo ID e-mail in BroadWorks).
Gli utenti eseguono l'autenticazione su BroadWorks o su Webex.
Ai clienti vengono rilasciati token di lunga durata per autorizzarli per i servizi su BroadWorks e Webex.
L'app Webex al centro di questa soluzione, è un'applicazione personalizzabile disponibile su desktop Mac/Windows e dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzionalità di messaggistica, presenza e riunioni.
Il client esegue la registrazione ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i tuoi sistemi BroadWorks per garantire un'esperienza di provisioning utente perfetta.
Funzioni e limitazioni
Offriamo diversi pacchetti con diverse caratteristiche.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata, ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano nella rubrica un utente softphone, i risultati della ricerca non forniscono alcuna opzione per inviare un messaggio.
Gli utenti del softphone possono condividere lo schermo durante una chiamata.
Pacchetto "base"
Il pacchetto di base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti in riunioni a "spazio unificato" e riunioni nella sala riunioni personale. (** vedere la seguente nota a titolo di eccezione). In questo pacchetto le riunioni possono avere una durata massima di 40 minuti.
Pacchetto "Standard"
Questo pacchetto include anche tutto quello che è contenuto nel pacchetto Base, ad esempio fino a 100 partecipanti nelle riunioni "spazio unificato" e nelle riunioni nella sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è un ruolo inizialmente ricoperto solo dall'organizzatore della riunione, ma l'organizzatore può passare il "ruolo di relatore" a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può riprendere il ruolo di relatore senza che l'organizzatore corrente glielo passi.
Pacchetto "Premium"
Questo pacchetto include tutto nel pacchetto Standard più un massimo di 300 partecipanti in una riunione "spazio unificato" e fino a 1000 partecipanti in una sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è supportata per qualsiasi partecipante alla riunione.
Confronta pacchetti
Pacchetto | Chiamata | Messaggistica | Riunioni nello spazio Unified | PMR riunioni |
---|---|---|---|---|
Softphone | Incluso | Non incluso | Nessuno | Nessuno |
Base | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Standard | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Premium | Incluso | Incluso | 300 partecipanti | 1000 partecipanti |
Il limite della riunione nello spazio Unified per gli utenti Base è 100 partecipanti per riunione nello spazio Unified a meno che lo spazio non includa anche gli utenti a cui sono assegnati i pacchetti "Standard" o "Premium", nel qual caso il limite aumenta in base al pacchetto utente organizzatore. |
"Riunioni nello spazio Unified" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti "Riunione" o "Pianifica". "Riunioni PMR" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale (PMR) di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID). |
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per le differenze di supporto delle funzioni di riunione PMR per i pacchetti Base, Standard e Premium.
Funzione riunione | Supportato con il pacchetto base | Suported con pacchetto standard | Supportato con il pacchetto Preminum | Commento |
---|---|---|---|---|
Durata riunione | 40 minuti o meno | Illimitato | Illimitato | |
Condivisione desktop | Sì | Sì | Sì | Base: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione desktop solo da parte dell'organizzatore della riunione PMR. Premium: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. |
Condivisione applicazione | Sì | Sì | Sì | Base: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione delle applicazioni solo da parte dell'organizzatore della riunione PMR. Premium: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. |
Chat con più interlocutori | Sì | Sì | Sì | |
Lavagna | Sì | Sì | Sì | |
Protezione con password | Sì | Sì | Sì | |
App Web - nessun download o plug-in (Esperienza ospite) | Sì | Sì | Sì | |
Supporto dell'accoppiamento con i dispositivi Webex | Sì | Sì | Sì | |
Controllo del pavimento (disattivazione del microfono uno / espulsione tutti) | Sì | Sì | Sì | |
Collegamento Riunioni persistenti | Sì | Sì | Sì | |
Accesso sito riunioni | Sì | Sì | Sì | |
Accesso alla riunione tramite VoIP | Sì | Sì | Sì | |
Bloccaggio | Sì | Sì | Sì | |
Controlli relatore | No | No | Sì | |
Controllo desktop remoto | No | No | Sì | |
Numero di partecipanti | 100 | 100 | 1000 | |
Registrazione salvata in locale nel sistema | Sì | Sì | Sì | |
Registrazione nel cloud | No | No | Sì | |
Registrazione - Cloud Storage | No | No | 10 GB per sito | |
Trascrizione delle registrazioni | No | No | Sì | |
Pianificazione riunione | Sì | Sì | Sì | |
Abilita condivisione contenuto con integrazioni esterne | No | No | Sì | Base: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. Standard: condivisione di contenuto solo da parte dell'organizzatore della riunione PMR. Premium: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. |
Consenti modifica URL PMR | No | No | Sì | Base: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori dei partner e delle organizzazioni possono modificare l'URL da Control Hub. Standard: l'URL PMR può essere modificato solo da Partner Hub per Partner e amministratori organizzazione. Premium: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori partner e dell'organizzazione possono modificare l'URL da Partner Hub. |
Streaming in diretta riunioni (Ad Esempio, su Facebook, Youtube) | No | No | Sì | |
Consenti ad altri utenti di pianificare riunioni per loro conto | No | No | Sì | |
Aggiungi organizzatore alternativo | Sì | No | Sì | |
Integrazione app (es., Zendesk, Slack) | Dipende dall'integrazione | Dipende dall'integrazione | Sì | Per ulteriori informazioni sul supporto, vedere la sezione Integrazioni app riportata di seguito. |
Integrazione con il calendario Microsoft Office 365 | Sì | Sì | Sì | |
Integrazione con Google Calendaring per G Suite | Sì | Sì | Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione rivolta agli utenti per Webex su help.webex.com
. Per ulteriori informazioni sulle funzioni, leggere i seguenti articoli:
Funzioni di chiamata
L'esperienza di chiamata è simile alle soluzioni precedenti che utilizzano il motore di controllo delle chiamate BroadWorks. La differenza tra UC-One Collaborate e UC-One SaaS è che l'app Webex è il client software principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
Zendesk—Solo Premium
Slack: solo Premium
Microsoft Teams per Webex Meetings—Standard o Premium
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
Calendario Office 365—Standard o Premium
Google Calendaring per G Suite: standard o premium
Supporto dell'infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta gli ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione per Webex per l'infrastruttura desktop virtuale (VDI).
Supporto per IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Pro Pack per Control Hub
Il servizio componente aggiuntivo Pro Pack per Control Hub fornisce ad amministratori, professionisti della sicurezza delle informazioni e responsabili della conformità funzionalità avanzate in termini di sicurezza, conformità e analisi che possono essere integrate con il software.
Questi servizi aggiuntivi saranno disponibili solo per i pacchetti Standard e Premium.
Per ulteriori informazioni, vedi la Pagina della Guida di Pro Pack per Control Hub.
Tabella di marcia futura
Per informazioni sulle nostre intenzioni per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Le voci della roadmap non sono vincolanti in alcuna capacità. Cisco si riserva il diritto di sospendere o rivedere uno o tutti questi elementi dalle release future.
Selezione ID chiamante esterno flessibile
Questa funzione, Selezione ID chiamante esterno flessibile, consente agli utenti di selezionare l'ID chiamante esterno desiderato quando effettuano chiamate in uscita. Questo miglioramento è disponibile sui telefoni da tavolo che richiedono un codice FAC.
Flessibilità utente: Gli utenti possono scegliere l'ID chiamante più appropriato per diverse chiamate, migliorando l'efficacia della comunicazione in base al contesto della chiamata.
Supporto piattaforma: I telefoni fissi necessitano di un codice FAC per questa funzionalità. Configurazione amministratore: Gli amministratori hanno la possibilità di configurare gli ID chiamante disponibili per gli utenti.
Requisiti di provisioning: La configurazione amministratore è necessaria su Cisco BroadWorks per rendere disponibili diversi ID chiamante.
Limiti
Limitazioni di provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario del sito Webex Meetings creato per tale pacchetto.
Se nella richiesta di provisioning per il primo utente di ciascun pacchetto non viene specificato alcun fuso orario, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sull'impostazione predefinita regionale dell'organizzazione degli abbonati.
Se il cliente necessita di uno specifico fuso orario del sito di Webex Meetings, specificare timezone
parametro nella richiesta di provisioning per:
il primo abbonato predisposto per il pacchetto Standard nell'organizzazione.
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
il primo abbonato predisposto per il pacchetto base nell'organizzazione.
Limitazioni generali
Nessuna chiamata nella versione Web del client Webex (questa è una limitazione del client, non una limitazione della soluzione).
Webex potrebbe non disporre ancora di tutti i controlli dell'interfaccia utente per supportare alcune funzioni di controllo delle chiamate disponibili da BroadWorks.
Attualmente, il client Webex non può essere "White Labeled" (etichetta bianca).
Quando si creano le organizzazioni dei clienti utilizzando il metodo di provisioning scelto, vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. Ci aspettiamo che i partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
I report sull'utilizzo di riunioni e messaggi sono disponibili attraverso l'organizzazione del cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti di messaggistica
I seguenti limiti di archiviazione dei dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo storage massimo per messaggistica e file combinati.
Di base: 2 GB per utente per 3 anni
Standard 5 GB per utente per 3 anni
Premio: 10 GB per utente per 5 anni
Per ciascuna organizzazione del cliente, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti premium ha un limite totale di messaggistica e storage file di 50 GB. Un singolo utente può superare il limite per utente (10 GB), a condizione che la società sia ancora al di sotto del massimo aggregato (50 GB).
Per gli spazi team creati, i limiti di messaggistica vengono applicati al totale aggregato per l'organizzazione cliente che possiede lo spazio team. Puoi trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti generali di messaggistica applicabili agli spazi dei team di messaggistica Webex, fare riferimento a https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure le connessioni a Webex e BroadWorks. I dati memorizzati nel cloud Webex ed esposti all'utente attraverso l'interfaccia dell'app Webex sono crittografati sia in transito che a riposo.
Maggiori dettagli sullo scambio di dati sono disponibili nella sezione Riferimento del presente documento.
Ulteriori letture
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati che più si avvicina alla propria regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore del provider di servizi (utente): Per le attività di manutenzione quotidiane, si gestiscono le parti della soluzione in sede (chiamata) utilizzando i propri sistemi. Gestisci le parti Webex della soluzione attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale.
Il primo utente predisposto per un nuovo organizzatore partner viene assegnato automaticamente ai ruoli amministratore completo e amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi. |
Team operativo di Cisco cloud: Crea la tua "organizzazione partner" in Partner Hub, se non esiste, durante l'onboarding.
Una volta ottenuto l'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente, create "Onboarding templates" (Modelli di onboarding) per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Quindi si fornisce i vostri clienti o abbonati.
# | Compito tipico | SP | Cisco |
---|---|---|---|
1 | Onboarding partner - Creazione dell'organizzazione partner se non esiste e abilitazione dei tasti di alternanza funzione necessari | ● | |
2 | Configurazione BroadWorks nell'organizzazione partner tramite Partner Hub (cluster) | ● | |
3 | Configurazione delle impostazioni di integrazione in Organizzazione partner tramite Partner Hub (modelli di offerta, branding) | ● | |
4 | Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|ADP Patching, firewall, configurazione XSP|ADP, XSI, AuthService, CTI, NPS, applicazioni DMS su XSP|ADP) | ● | |
5 | Sviluppo dell'integrazione o del processo di provisioning | ● | |
6 | Preparare i materiali GTM | ● | |
7 | Migrazione o provisioning di nuovi utenti | ● |
Architettura
Cosa c'è nel diagramma?
Client
Il client dell'app Webex serve come applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di messaggistica nativa, presenza e riunioni audio/video multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per le chiamate SIP e PSTN.
I telefoni IP Cisco e i relativi accessori utilizzano anche l'infrastruttura BroadWorks per le chiamate SIP e PSTN. Ci aspettiamo di essere in grado di supportare telefoni di terze parti.
Portale di attivazione utente per gli utenti che accedono a Webex utilizzando le credenziali BroadWorks.
Partner Hub è un'interfaccia Web per l'amministrazione dell'organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. Puoi anche utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
Rete di provider di servizi
Il blocco verde a sinistra dello schema rappresenta la tua rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
XSP|ADP rivolto al pubblico, per Webex per Cisco BroadWorks: (La scatola rappresenta una o più fattorie XSP|ADP, eventualmente frontali da bilanciatori di carico).
Ospita l'interfaccia dei servizi Xtended (XSI-Actions & XSI-Events), il servizio di gestione dei dispositivi (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato del ricevitore dell'altro (presenza di telefonia) e la cronologia chiamate.
Pubblica la rubrica ai client Webex.
XSP|ADP rivolto al pubblico, con NPS in esecuzione:
server push notifiche chiamate organizzatore: Un server push di notifica su un ADP XSP| nel proprio ambiente. Si interfaccia tra il server applicazioni e il proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS & FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
Server applicazioni:
Fornisce il controllo delle chiamate e le interfacce ad altri sistemi BroadWorks (generalmente)
Per il provisioning flowthrough, l'AS viene utilizzato dall'amministratore del partner per il provisioning degli utenti in Webex
Inserisce il profilo utente in BroadWorks
OSS/BSS: Sistema di supporto alle operazioni/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nello schema rappresenta il cloud Webex. I microservizi Webex supportano l'intero spettro di funzionalità di collaborazione Webex:
Cisco Common Identity (CI) è il servizio identità all'interno di Webex.
Webex per Cisco BroadWorks rappresenta la serie di microservizi che supportano l'integrazione tra Webex e BroadWorks ospitato da provider di servizi:
API di provisioning utente
Configurazione provider di servizi
Accesso utente mediante credenziali BroadWorks
Casella di messaggistica Webex per microservizi correlati alla messaggistica.
Casella Webex Meetings che rappresenta server di elaborazione multimediale e SBC per riunioni video con più partecipanti (SIP e SRTP)
Servizi Web di terze parti
Nello schema sono rappresentati i seguenti componenti di terze parti:
APNS (Apple Push Notifications Service) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Apple.
FCM (messaggistica cloud FireBase) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Il ruolo dei server XSP|ADP aperti al pubblico in Webex per Cisco BroadWorks
L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste Webex per BroadWorks JWT (JSON Web Token) per conto dell'utente
Interfaccia CTI, protetta da mTLS, a cui Webex sottoscrive gli eventi della cronologia chiamate e lo stato della presenza di telefonia da BroadWorks (stato hook).
Interfacce azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate degli abbonati, rubriche di elenchi di contatti e chiamate e configurazione del servizio di telefonia per gli utenti finali
Servizio DM (Device Management) per il recupero dei file di configurazione delle chiamate da parte dei client
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedere Configurazione dei cluster BroadWorks in Partner Hub in questo documento. Per ciascun cluster, è possibile fornire un solo URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP
È necessario utilizzare un'istanza ADP XSP|dedicata o un'azienda agricola separata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile organizzare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso XSP|ADP che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/azienda agricola ADP XSP| dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
Ad esempio, se offri UC-One SaaS, ti consigliamo di creare una nuova fattoria XSP|ADP per Webex per Cisco BroadWorks. In questo modo i due servizi possono operare in modo indipendente durante la migrazione degli abbonati.
Se si collocano le applicazioni Webex per Cisco BroadWorks in una fattoria ADP|XSP utilizzata per altri scopi, è responsabilità dell'utente monitorare l'utilizzo, gestire la complessità risultante e pianificare l'aumento della scala.
Il pianificatore della capacità di sistema Cisco BroadWorks assume una fattoria ADP XSP| dedicata e potrebbe non essere preciso se la si utilizza per i calcoli della posizione.
Se non diversamente specificato, gli Webex dedicati per Cisco BroadWorks XSP|ADP devono ospitare le seguenti applicazioni:
AuthService (TLS con convalida token CI o mTLS)
CTI (mTLS)
Azioni XSI (TLS)
XSI-Events (TLS)
DMS (TLS): opzionale. Non è obbligatorio distribuire un'istanza DMS o un'azienda agricola separata specificamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
TLS (Call Settings Webview): opzionale. La vista Webview (CSW) delle impostazioni di chiamata è richiesta solo se si desidera che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso a CTI attraverso un'interfaccia protetta dall'autenticazione TLS reciproca. Per supportare questo requisito, raccomandiamo una delle seguenti opzioni:
(Diagramma etichettato Opzione 1) Una istanza XSP|ADP o un'azienda agricola per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
(Diagramma etichettato Opzione 2) Due istanze ADP XSP| o aziende agricole, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSP|ADP Se si dispone di una fattoria ADP XSP|esistente conforme a una delle architetture suggerite sopra (Opzione 1 o 2) ed è leggermente caricata, è possibile riutilizzare le ADP XSP|esistenti. Dovrai verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti dell'applicazione per Webex. Le due considerazioni principali sono:
Poiché gli XSP|ADP hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero esserci altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di XSP|ADP deve essere verificato in un laboratorio con la configurazione desiderata prima di impegnarsi per il riutilizzo. |
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione temporale per tutti gli XSP|ADP utilizzati con Webex.
Installare il ntp
pacchetto dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Quindi è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, consultare la Guida alla gestione del software BroadWorks.
Durante l'installazione interattiva del software XSP|ADP, è possibile configurare NTP. Procedere come segue:
Quando l'installatore chiede,
Do you want to configure NTP?
, immetterey
.Quando l'installatore chiede,
Is this server going to be a NTP server?
, immetteren
.Quando l'installatore chiede,
What is the NTP address, hostname, or FQDN?
, immettere l'indirizzo del server NTP o un servizio NTP pubblico, ad esempio,pool.ntp.org
.
Se gli ADP XSP|utilizzano un'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie Key=Value:
NTP
NTP_SERVER=<NTP Server address, e.g., pool.ntp.org>
Requisiti di identità e sicurezza XSP|ADP
Sfondo
I protocolli e le crittografie delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli vanno dal più generale (provider SSL) al più specifico (interfaccia singola). Un'impostazione più specifica sostituisce sempre un'impostazione più generale. Se non sono specificate, le impostazioni SSL di livello "inferiore" vengono ereditate da livelli "superiori".
Se non viene modificata alcuna impostazione rispetto alle impostazioni predefinite, tutti i livelli ereditano le impostazioni predefinite del provider SSL (JSSE Java Secure Sockets Extension).
Elenco dei requisiti
L'|ADP XSP deve autenticarsi sui client utilizzando un certificato firmato da CA in cui il nome comune o il nome alternativo oggetto corrispondono alla parte di dominio dell'interfaccia XSI.
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
Diffie-Hellman Effemeral (DHE) o curve ellittiche Diffie-Hellman Effemeral (ECDHE) chiave-scambio
Crittografia AES (Advanced Encryption Standard) con una dimensione minima di blocco di 128 bit (ad esempio, AES-128 o AES-256)
Modalità di codifica GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
Se viene utilizzata una crittografia CBC, solo la famiglia SHA2 di funzioni hash è consentita per derivazione chiave (SHA256, SHA384, SHA512).
Ad esempio, le seguenti crittografie soddisfano i requisiti:
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come illustrato sopra, non la convenzione openSSL. |
Crittografie TLS supportate per le interfacce AuthService e XSI
Questo elenco è soggetto a modifiche a mano a mano che evolvono i nostri requisiti di sicurezza del cloud. Seguire l'attuale raccomandazione sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento. |
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_128_GCM_SHA256
TLS_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA256
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_256_CBC_SHA
TLS_PSK_WITH_AES_256_CBC_SHA384
TLS_PSK_WITH_AES_256_CBC_SHA
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA
TLS_PSK_WITH_AES_128_CBC_SHA256
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri della scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il numero di thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi visualizzati come segue (non diminuirli se sono al di sopra di questi valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più |ADP XSP
Elemento bordo bilanciamento carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, deve gestire in modo trasparente la distribuzione del traffico tra più server XSP|ADP e il cloud e i client Webex per Cisco BroadWorks. In questo caso, è possibile fornire l'URL del bilanciatore di carico alla configurazione Webex per Cisco BroadWorks.
Note su questa architettura:
Configurare il DNS in modo che i client possano trovare il bilanciatore di carico quando si connettono all'interfaccia Xsi (vedere configurazione DNS).
Si consiglia di configurare l'elemento edge in modalità proxy SSL inversa per garantire la crittografia dei dati punto a punto.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Server XSP|ADP orientati verso Internet
Se si espongono direttamente le interfacce Xsi, utilizzare il DNS per distribuire il traffico ai più server XSP|ADP.
Note su questa architettura:
Per connettersi ai server XSP|ADP sono necessari due record:
Per i microservizi Webex: Per targetizzare più indirizzi IP XSP|ADP sono necessari record A/AAAA round-robin. Questo perché i microservizi Webex non possono effettuare ricerche SRV. Per esempi, vedere Servizi cloud Webex.
Per l'app Webex: Un record SRV che si risolve in record A in cui ogni record A si risolve in un singolo XSP|ADP. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per targetizzare il servizio XSI per più indirizzi XSP|ADP. Assegnare la priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (e all'indirizzo IP successivo) e passino al record A successivo (e all'indirizzo IP) solo se il primo indirizzo IP è inattivo. NON utilizzare un approccio round-robin per l'app Webex.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune.
È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL XSP|ADP di un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server XSP|ADP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.
Ordinazione e provisioning
L'ordine e il provisioning si applicano a questi livelli:
Provisioning di partner/provider di servizi:
Ogni onboarding di Webex per provider di servizi Cisco BroadWorks (o rivenditore) deve essere configurato come organizzazione partner in Webex e devono essere concesse le autorizzazioni necessarie. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per gestire Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le operazioni di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/aziendale.
Ordinazione e provisioning clienti/aziende:
Ogni BroadWorks Enterprise abilitato per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo si verifica automaticamente come parte del provisioning utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks vengono predisposti nella stessa organizzazione cliente Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
Ordinazione e provisioning utente/abbonato:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning degli utenti:
Provisioning fluviale con e-mail attendibili
Provisioning eseguibile senza e-mail attendibili
Self-provisioning utente
Provisioning API
Provisioning eseguibile con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile affermare che BroadWorks dispone di indirizzi e-mail abbonati validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Provisioning eseguibile senza e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non puoi contare sugli indirizzi e-mail degli abbonati detenuti da BroadWorks, questa opzione di provisioning crea account Webex ma non può attivarli fino a quando gli abbonati non forniscono e convalidano i relativi indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Self-provisioning utente
Con questa opzione, non è disponibile il provisioning flowthrough da BroadWorks a Webex. Una volta configurata l'integrazione tra Webex e il sistema BroadWorks, vengono visualizzati uno o più collegamenti specifici per il provisioning degli utenti all'interno dell'organizzazione partner Webex per Cisco BroadWorks.
Successivamente, si progettano le proprie comunicazioni (o si delegano ai clienti) per distribuire il collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account vengono predisposti nell'ambito dell'organizzazione partner, puoi regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare tale operazione.
Gli utenti devono esistere nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento. |
Provisioning provider di servizi per API
Webex presenta un set di API pubbliche che consentono di creare il provisioning utente/abbonato Webex per Cisco BroadWorks nel flusso di lavoro/negli strumenti di gestione utenti esistenti.
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti Webex per Cisco Broadworks di comporre altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella rubrica Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo dell'estensione di tutte le aree del metodo di avvio chiamata e del profilo dell'utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e gruppi diversi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due imprese che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Utenti Cisco BroadWorks
Provisioning API pubblica come 'interno
Il parametro dell'interno deve essere esplicitamente passato come parte della chiamata API. Per le imprese/gruppi con Location Dialing Code (LDC) configurato, il parametro dell'interno dovrebbe essere la combinazione di LDC e 'numero di interno.
Provisioning flusso o auto-attivazione
Estensione e LDC (se applicabile) saranno automaticamente recuperati da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione di codice di chiamata posizione (LDC) e numero di interno.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'interno |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'estensione deve essere passata come parametro |
Attraverso il flusso | Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Elenchi telefonici BroadWorks | Elenchi telefonici aziendali, di gruppo o personali | Sincronizzazione rubriche | Non applicabile |
Prerequisiti
La versione del client richiesta per supportare questa funzione è 42.11 o successiva.
Patch in cui i codici di chiamata di estensione e posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
AP.platform.23.0.1075.ap380045
AP.as.23.0.1075.ap380045
AP.xsp.23.0.1075.ap380045
AP.as.24.0.944.ap380045
Abilitare l'intestazione X-BroadWorks-Remote-Party-Info su AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP richiesto per il supporto della funzione di composizione dell'interno.
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata a interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità delle chiamate di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'estensione come seconda opzione in Partner Hub e Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con estensione attraverso uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione dell'interno sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Non verrà visualizzata un'estensione nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere visibile l'opzione di chiamata dell'interno per i clienti esistenti:
Se un partner desidera che tutte le organizzazioni dei clienti gestite siano dotate di un interno come una delle opzioni di chiamata, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
Se un partner desidera fornire un interno in opzioni di chiamata per una specifica organizzazione cliente, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e portarli alla pari con l'aumento di 30K contatti per l'elenco telefonico Enterprise, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per Organizzazione, che si applica alla somma degli elenchi telefonici Enterprise e Group in una singola azienda BroadWorks. Ad esempio, sarà supportato un'azienda BroadWorks che dispone di un elenco di telefoni aziendali con 30K e anche di 5 elenchi di telefoni di gruppo ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K totali).
Questa funzione è disponibile su richiesta. Contatta il team dell'account per abilitare questa opzione.
|
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks nello storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare a quale gruppo appartiene questo utente. L'associazione dell'utente con un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca dei contatti nello storage del gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning degli abbonati Webex per BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
È possibile eseguire il provisioning dell'ID gruppo aziendale BroadWorks per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Webex per gli utenti Cisco BroadWorks
Provisioning API pubblica come "spEnterpriseGroupId"
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
Provisioning flusso o auto-attivazione
L'ID gruppo aziendale BroadWorks verrà automaticamente recuperato da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Non applicabile. Non è necessario sincronizzare l'ID gruppo aziendale BroadWorks per questi utenti.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'ID gruppo aziendale BroadWorks deve essere superato come parametro spEnterpriseGroupId |
Attraverso il flusso | L'ID gruppo aziendale BroadWorks viene recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Non applicabile |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Non applicabile |
Elenchi telefonici BroadWorks | Contatti negli elenchi telefonici del gruppo BroadWorks | Sincronizzazione rubriche | I contatti di gruppo vengono memorizzati nel servizio Webex Contact associato al gruppo specifico |
Elenchi di telefoni BroadWorks Enterpsie o Persional | Contatti negli elenchi telefonici aziendali o personali | Sincronizzazione rubriche | Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. Impossibile completare la migrazione fino a quando QUESTA API non viene completata. L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march Una volta abilitata la funzione e a seguito della sincronizzazione della rubrica successiva, i gruppi di utenti aziendali verranno visualizzati anche in Control Hub. La visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativa in questa fase. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza a un gruppo in Control Hub poiché tali modifiche non verranno riportate nuovamente in BroadWorks. La gestione di gruppo in Control Hub è destinata all'uso da parte dei partner che adotteranno le prossime API di gestione contatti. |
Migrazione e prova del futuro
La progressione Cisco del client di comunicazione unificata BroadSoft deve spostarsi da UC-One a Webex. Si verifica una corrispondente progressione dei servizi di supporto dalla rete del provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che tu stia eseguendo UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita consiste nel distribuire nuovi ADP|XSP dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti in Webex e infine recuperare l'infrastruttura utilizzata per la soluzione precedente.
Sottoscrizioni di documenti consigliate
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Abbonati che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di eseguire l'abbonamento a ciascuno dei seguenti articoli per assicurarsi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per iscriversi, accedere a ciascuno dei link seguenti e nell'articolo che viene visualizzato fare clic sul pulsante Iscriviti.
Come minimo, si consiglia di iscriversi all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati in Documenti aggiuntivi dispone di un'opzione Sottoscrivi . Affinché questa opzione venga visualizzata, l'articolo deve essere visualizzato su help.webex.com.
Non esiste un'opzione di abbonamento per le landing page di documentazione. |
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Documenti Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
Porta la tua soluzione PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono di loro proprietà (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive come eseguire l'onboarding e il servizio dei dispositivi Room OS e MPP.
Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi di Webex per Cisco BroadWorks.
Articoli Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti siti opzionali per ulteriori informazioni su Webex per Cisco BroadWorks:
Documentazione Webex per Cisco BroadWorks: nella pagina di destinazione vengono elencati i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme a quelle presto disponibili.
Problemi noti e limitazioni: informazioni sui problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale: questo articolo descrive come assegnare i ruoli amministratore partner per le organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte della soluzione Cisco BroadWorks:
Articoli della Guida Webex
I seguenti siti della Guida Webex possono essere utilizzati per trovare gli articoli Webex che consentono agli amministratori dei clienti e agli utenti finali di utilizzare le funzioni Webex.
Webex da provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati comunemente per gli utenti dell'app Webex che hanno acquistato i servizi Webex da un provider di servizi.
Centro assistenza Webex: utilizzare la funzione di ricerca su help.webex.com per cercare altri articoli Webex che descrivono la funzionalità dell'app Webex e di Webex Meetings. È possibile ricercare gli articoli utente o amministratore.
Documentazione sviluppatore
Guida per sviluppatori Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Punti di decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastrutture
|
Quanti ADP XSP|? Come prendono l'mTLS? |
Pianificatore capacità di sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento CLI XSP|ADP Il presente documento |
Provisioning cliente e utente | Puoi affermare che ti fidi dei messaggi e-mail in BroadWorks? Vuoi che gli utenti forniscano indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Documenti API pubbliche su https://developer.webex.com Il presente documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo di branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso per i clienti? | Il presente documento |
Funzioni abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o Softphone. | Il presente documento Matrice caratteristiche/pacchetto |
autenticazione protetta | BroadWorks o Webex | Il presente documento |
Adattatore di provisioning (per opzioni di provisioning flowthrough) | Utilizzate già IM&P integrato, ad esempio per UC-One SaaS? Si desidera utilizzare più modelli? È previsto un caso d'uso più comune? |
Il presente documento Riferimento CLI server applicazioni |
Architettura e infrastrutture
Con che tipo di scala intende iniziare? È possibile scalare in futuro, ma la stima di utilizzo attuale dovrebbe guidare la pianificazione dell'infrastruttura.
Collaborare con il proprio account manager/rappresentante di vendita Cisco per dimensionare l'infrastruttura ADP XSP|, in base al Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
In che modo Webex renderà le connessioni TLS reciproche alle tue ADP XSP|? Direttamente a XSP|ADP in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce. (Non supportiamo connessioni TCP non crittografate al perimetro della rete).
Provisioning cliente e utente
Quale metodo di provisioning utente si adatta meglio?
Provisioning eseguibile con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene predisposto automaticamente in Webex.
Se puoi anche affermare che gli indirizzi e-mail dell'abbonato in BroadWorks sono validi e univoci per Webex, puoi utilizzare la variante "email attendibili" del provisioning flowthrough. Gli account Webex abbonati vengono creati e attivati senza il loro intervento; scaricano semplicemente il client e accedono.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto, il provider di servizi deve fornire un indirizzo e-mail valido all'utente per eseguire il provisioning dei servizi Webex. Questo deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo anche nell'attributo ID alternativo.
Provisioning eseguibile senza e-mail attendibili: Se non riesci a fidarti degli indirizzi e-mail degli abbonati, puoi comunque assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
Self-provisioning utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. Tu (o i tuoi clienti) distribuisci invece un collegamento di provisioning e i collegamenti per scaricare i diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare gli account Webex. Quindi, scaricano il client e accedono e Webex recupera una configurazione aggiuntiva su di essi da BroadWorks (inclusi i numeri principali).
Provisioning controllato da SP tramite API: Webex espone una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei propri flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti di sistema generali descritti in questa guida.
Metodo di provisioning | Requisiti |
---|---|
Provisioning del flusso (e-mail attendibili o non attendibili) | L'API di provisioning Webex aggiunge automaticamente gli utenti BroadWorks esistenti a Webex una volta che l'utente soddisfa i requisiti e si attiva il servizio Integrated IM+P. Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Self-provisioning utente | L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato il messaggio e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) | Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono previsti due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, vai a Utenti BroadWorks. |
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Impostazioni internazionali lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente di amministrazione con provisioning viene assegnata automaticamente come locale predefinita per l'organizzazione del cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti a riunioni all'interno dell'organizzazione del cliente.
Sono supportate le impostazioni internazionali in lingua a cinque caratteri (ISO-639-1)_(ISO-3166). Ad esempio, en_US corrisponde a English_UnitedStates. Se viene richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genera un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso internazionale dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, viene utilizzata l'impostazione locale ragionevole predefinita in base al codice della lingua richiesto.
Nella tabella riportata di seguito vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice lingua a due lettere in un'impostazione locale a cinque caratteri per le situazioni in cui un'impostazione locale a cinque caratteri non è disponibile.
Impostazioni internazionali lingua supportate (ISO-639-1)_(ISO-3166) | Se è disponibile solo un codice lingua a due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** | Usa impostazioni internazionali sensibili di default (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA | en en | en_USA |
fr_Fr fr_CA | Fr | fr_Fr |
cs_CZ | cs | cs_CZ |
da_DK | da | da_DK |
de_DE | DE | de_DE |
hu_HU | hu | hu_HU |
id_ID | ID | id_ID |
it_IT | IT | it_IT |
ja_JP | ja | ja_JP |
ko_KR | ko | ko_KR |
es_ES es_CO es_MX | ES | es_ES |
nl_NL | NL | nl_NL |
nb_NO | nb. | nb_NO |
pl_PL. | pl. | pl_PL. |
pt_PT pt_BR | pt | pt_PT |
ru_RU | RU | ru_RU |
ro_RO | ro | ro_RO |
zh_CN zh_TW | zh | zh_CN |
sv_SE | sv | sv_SE |
ar_SA | ar | ar_SA |
tr_TR | tr | tr_TR |
Le impostazioni internazionali es_CO, id_ID, nb_NO e pt_PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti Webex Meetings saranno solo in inglese. Inglese è la impostazioni internazionali predefinite per i siti se per il sito non sono richieste impostazioni internazionali non valide/non supportate. Questo campo lingua è applicabile durante la creazione di un'organizzazione e un sito Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, la lingua del modello verrà utilizzata come lingua predefinita. |
Branding
Gli amministratori partner possono utilizzare le personalizzazioni avanzate del branding per personalizzare l'aspetto dell'app Webex per le organizzazioni di clienti gestite dal partner. Gli amministratori partner possono personalizzare le seguenti impostazioni per garantire che l'app Webex rifletta il marchio e l'identità della società:
Loghi aziendali
Combinazioni di colori univoche per la modalità Chiaro o Scuro
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione delle personalizzazioni di branding avanzate.
|
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding come richiesto, ma quando si esegue l'onboarding di un cliente è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Alcuni parametri del modello principale sono elencati di seguito.
Pacchetto
È necessario selezionare un pacchetto predefinito quando si crea un modello (vedere Pacchetti nella sezione Panoramica per dettagli). Tutti gli utenti predisposti con tale modello, tramite flowthrough o self-provisioning, ricevono il pacchetto predefinito.
È possibile controllare la selezione dei pacchetti per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno di essi. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori di provisioning per azienda, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
È possibile modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedere Webex per la documentazione API Cisco BroadWorks o attraverso Partner Hub (vedere Modifica pacchetto utente in Partner Hub).
Non puoi modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è attivata o disattivata; se all'abbonato viene assegnato questo servizio in BroadWorks, il modello Partner Hub associato all'URL di provisioning aziendale di tale abbonato definisce il pacchetto.
Rivenditore e aziende o fornitore di servizi e gruppi?
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se sei un rivenditore con Enterprise, devi abilitare la modalità Enterprise quando crei un modello.
Se il sistema BroadWorks è configurato in modalità provider di servizi, è possibile lasciare disattivata la modalità Enterprise nei modelli.
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch BroadWorks richieste per il provisioning flow-through. Per ulteriori dettagli, vedere Patch richieste con provisioning flow-through. |
Modalità di autenticazione
Decidi come desideri che gli abbonati eseguano l'autenticazione quando accedono a Webex. È possibile assegnare la modalità utilizzando l'impostazione Modalità di autenticazione nel modello di onboarding. Nella tabella seguente sono riportate alcune opzioni.
Questa impostazione non ha effetto sull'accesso al portale di attivazione utente. Gli utenti che accedono al portale devono immettere l'ID utente e la password BroadWorks, come configurati su BroadWorks, indipendentemente da come si configura la modalità di autenticazione nel modello di onboarding. |
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | ID utente BroadWorks | Indirizzo e-mail |
Provider identità | BroadWorks.
| Identità comune Cisco |
Autenticazione a più fattori? | No | Richiede IdP del cliente che supporta l'autenticazione a più fattori. |
Percorso di convalida delle credenziali
|
|
|
Per una ripartizione più dettagliata del flusso di accesso SSO con autenticazione diretta a BroadWorks, vedere Flusso di accesso SSO. |
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che si può verificare con password che utilizzano caratteri speciali per cui il browser Web non codifica correttamente i caratteri. Utilizzando un'intestazione con codifica UTF-8, con codifica base 64, risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
Paese
Quando si crea un modello, è necessario selezionare un paese. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie S. | Posizione | Prefisso internazionale | Nome paese |
---|---|---|---|
1 | AMER | +1 | NOI, CA |
2 | APAC | +65 | Singapore |
3 | ANZ | +61 | Australia |
4 | EMEA | +44 | Regno Unito |
5 | EURO | +49 | Germania |
Accordi con più partner
Vuoi concedere in sublicenza Webex per Cisco BroadWorks a un altro provider di servizi? In questo caso, ciascun provider di servizi avrà bisogno di un'organizzazione partner distinta in Webex Control Hub per consentire loro di fornire la soluzione per la propria base clienti.
Adattatore di provisioning e modelli
Quando si utilizza il provisioning flowthrough, l'URL di provisioning inserito in BroadWorks viene derivato dal modello in Control Hub. È possibile disporre di più modelli e quindi di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati al momento della concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e quale modello si desidera utilizzare a tale scopo. In questo modo, è necessario impostare esplicitamente l'URL di provisioning per le aziende che necessitano di un modello diverso.
Inoltre, tenere presente che è possibile che si stia già utilizzando un URL di provisioning a livello di sistema, ad esempio con UC-One SaaS. In tal caso, è possibile scegliere di mantenere l'URL a livello di sistema per il provisioning degli utenti su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono dettagliate in Configura server applicazioni con URL servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning flowthrough tra AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server AS e Webex, annullando in tal modo la necessità di connettersi direttamente al servizio Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati che si sta eseguendo il provisioning per Webex devono esistere nel sistema BroadWorks integrato con Webex. È possibile integrare più sistemi BroadWorks, se necessario.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero o interno principale.
Webex utilizza gli indirizzi e-mail come identificatori principali per tutti gli utenti. Se si utilizza il provisioning flowthrough con e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail degli abbonati nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo di utenti di chiamata BroadWorks con un numero principale e/o interno. Se si utilizza il provisioning flowthrough, agli utenti deve essere assegnato anche il servizio IM&P integrato. |
Server nella rete e requisiti software
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Le istanze BroadWorks devono includere almeno i seguenti server:
Server applicazioni (AS) con versione BroadWorks come sopra
Server di rete (NS)
Server profilo (PS)
Server XSP|ADP o piattaforma di distribuzione delle applicazioni (ADP) di fronte al pubblico che soddisfano i seguenti requisiti:
Servizio di autenticazione (BWAuth)
Interfacce azioni ed eventi XSI
DMS (applicazione Web di gestione dispositivi)
Interfaccia CTI (Intergrazione Di Telefonia Informatica)
TLS 1.2 con certificato valido (non autofirmato) e qualsiasi intermediazione richiesta. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
Autenticazione Mutual TLS (mTLS) per il servizio di autenticazione (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Autenticazione Mutual TLS (mTLS) per l'interfaccia CTI (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Un server XSP/ADP separato che agisce come "Call Notifications Push Server" (un NPS nel tuo ambiente utilizzato per le notifiche di chiamata push per Apple/Google. Lo chiamiamo "CNPS" qui per distinguerlo dal servizio in Webex che fornisce notifiche push per messaggi e presenza).
Questo server deve essere su R22 o versione successiva.
Viene richiesto un server XSP/ADP separato per CNPS poiché l'imprevedibilità del carico da Webex per le connessioni cloud BWKS potrebbe influire negativamente sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSPADP, consultare la Guida tecnica di sistema Cisco BroadWorks|.
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, andare a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
PC/laptop Windows
PC/laptop Apple con MacOS
iOS (Apple Store)
Android (Play store)
Browser Web (vai a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (tradizionale cinese)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (italiano)
Telefoni e accessori fisici
Telefoni IP Cisco:
telefono IP Cisco serie 6800 con firmware multipiattaforma
telefono IP Cisco serie 7800 con firmware multipiattaforma
telefono IP Cisco serie 8800 con firmware multipiattaforma
Vedere https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html per i modelli e ulteriori informazioni.
I telefoni di terze parti sono supportati allo stesso modo di altre integrazioni BroadWorks. Tuttavia, non dispongono ancora dell'integrazione di contatti e presenza con Webex per Cisco BroadWorks.
Adattatori:
Adattatore per telefono analogico multipiattaforma Cisco ATA 191
Adattatore per telefono analogico multipiattaforma Cisco ATA 192
Vedere https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html per i modelli e ulteriori informazioni.
Cuffie:
cuffia Cisco serie 500
Vedi https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html per i modelli e ulteriori informazioni.
Dispositivi Room OS:
Serie Webex Room e Room Kit
Serie Webex Desk
Serie Webex Board
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e l'assistenza dei dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivo
Di seguito sono riportati i file DTAF che devi caricare sui server delle applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia c'è una nuova config-wxt.xml.template
file utilizzato per l'app Webex.
Per scaricare i profili dei dispositivi più recenti, andare al sito di Download software della piattaforma di consegna delle applicazioni per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che per XSP.
Nome del cliente | Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Comunicatore aziendale - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili del dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Genera una richiesta di servizio con l'agente di onboarding o con Cisco TAC per eseguire il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il titolo della richiesta per le rispettive funzioni:
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
'NPS Configuration for Auth Proxy Setup' (Configurazione NPS per impostazione proxy automatica) per configurare NPS per l'uso del proxy di autenticazione.
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori informazioni su questa funzione, vedere: Supporto di Cisco BroadWorks per CI UUID.
Configura BroadWorks per abilitare la fatturazione Cisco per BroadWorks e Webex Per abbonamenti BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento valido per 60 giorni. Se il token scade prima di utilizzarlo, è possibile presentare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali. |
Certificati ordine
Requisiti di certificato per l'autenticazione TLS
Per tutte le applicazioni richieste, saranno necessari i certificati di sicurezza, firmati da un'autorità di certificazione ben nota e distribuiti su ADP XSP|pubblico. Verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in entrata ai server XSP|ADP.
Questi certificati devono includere il nome di dominio pubblico XSP|ADP completo come Nome comune oggetto o Nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati del server dipendono da come vengono distribuiti gli ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume dove il certificato del server pubblico firmato da CA deve essere caricato in questi tre casi:
Le autorità di certificazione supportate pubblicamente dall'app Webex per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per proxy bridge TLS
Il certificato del server firmato pubblicamente viene caricato nel proxy.
Il proxy presenta questo certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Un certificato firmato CA interno può essere caricato su XSP|ADP.
L'|ADP XSP presenta questo certificato del server firmato internamente al proxy.
Il proxy si basa sulla CA interna che ha firmato il certificato del server XSP|ADP.
Requisiti di certificato TLS per proxy passthrough TLS o XSP|ADP in DMZ
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
Gli ADP XSP|presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca sull'interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione Mutual TLS. Il certificato CA/catena del certificato del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedi a Partner Hub, vai a
e fai clic sul collegamento del certificato di download.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume i requisiti del certificato in questi tre casi:
Requisiti del certificato (opzione) per proxy bridge TLS
Webex presenta un certificato client firmato pubblicamente al proxy.
Il proxy considera attendibile la CA interna di Cisco che ha firmato il certificato del client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta il certificato del server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions: X509v3 Extended Key Usage: 1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Il CN del certificato interno deve essere
bwcticlient.webex.com
.
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le autorità pubbliche di certificazione potrebbero non essere disposte a firmare i certificati con l'OIDE proprietario di BroadWorks richiesto. In caso di proxy di bridging, è possibile che sia necessario utilizzare una CA interna per firmare il certificato del client che il proxy presenta all'ADP XSP|.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Il ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XSP| dal proxy.
Requisiti di certificato (opzione) per proxy passthrough TLS o XSP|ADP in DMZ
Webex presenta un certificato client firmato da CA Cisco interno alle ADP XSP|.
Gli ADP XSP|si fidano delle autorità di certificazione interne di Cisco che hanno firmato il certificato client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XSP|.
Gli ADP XSP|presentano i certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Il server applicazioni ClientIdentity contiene il CN del certificato del client firmato Cisco presentato a XSP|ADP da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene l'elenco di indirizzi IP, porte e protocolli richiesti per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle dei firewall delle regole di ingresso e uscita precedenti documentano solo le connessioni specifiche di Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico per Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e la rilevanza di ciascuna sezione per Webex per Cisco BroadWorks.
Sezione Requisiti di Rete Art. | Rilevanza delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex | Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud | Informativo |
Da leggere | |
Da leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex | Da leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione | Opzionale |
Servizi Webex per clienti FedRAMP | N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedi il whitepaper del firewall dell'app Webex (PDF).
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza XSP|ADP di Broadworks fornita dal partner. Quando un ADP o un sito XSP|non è disponibile per manutenzione pianificata o motivo non pianificato, i servizi e le app Webex possono passare a un altro ADP o sito XSP|fornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP Broadworks XSP|possono essere distribuiti direttamente su Internet o possono risiedere in un DMZ frontale da un elemento di bilanciamento del carico come F5 BIG-IP. Per fornire ridondanza geografica, gli ADP XSP|possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un bilanciatore di carico, ognuno con un indirizzo IP pubblico. Se gli ADP XSP| sono dietro a un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e Broadworks sembra avere solo un XSP|ADP, anche se vi sono più ADP XSP| dietro.
Nell'esempio seguente, le ADP|XSP vengono distribuite in due siti, il Sito A e il Sito B. Esistono due ADP|XSP frontali di un bilanciatore di carico in ogni sito. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali di LB1 e il sito B ha XSP|ADP3 e XSP|ADP4 frontali di LB2. Solo i bilanciatori di carico sono esposti sulla rete pubblica e le ADP|XSP sono nelle reti private DMZ.
Servizi cloud Webex
Configurazione DNS
I microservizi cloud Webex devono essere in grado di trovare il server|ADP Broadworks XSP per la connessione alle interfacce Xsi, al servizio di autenticazione e al CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host XSP|ADP configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso. Se vengono restituiti più indirizzi IP, viene selezionato il primo IP nell'elenco. La ricerca SRV non è attualmente supportata.
Esempio: Il DNS A Record del partner per la scoperta del server XSP|ADP/Load Balancers bilanciato Round-Robin.
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
A |
|
| Punti a LB1 (Sito A) |
A |
|
| Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Failover
Quando i microservizi Webex inviano una richiesta al servizio |di bilanciamento del carico/ADP XSP e la richiesta non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se non viene ricevuta alcuna risposta HTTP entro 2 secondi, la richiesta viene timeout e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento dell'indirizzamento all'IP successivo.
Ciascuna richiesta viene provata 3 volte prima di segnalare un errore al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco degli indirizzi da provare quando si invia una richiesta a un XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna nell'elenco per provare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco bloccato. Se l'operazione va a buon fine, tale indirizzo IP viene rimosso dall'elenco bloccato.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP|XSP o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster BroadWorks Calling, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
Azioni XSI
Eventi XSI
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Gli stati delle connessioni possono essere:
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
Rosso: Quando tutti gli IP nella ricerca di record sono irraggiungibili e l'interfaccia non è disponibile.
I seguenti servizi utilizzano i microservizi per connettersi agli XSP|ADP e sono interessati dalla disponibilità dell'interfaccia XSP|ADP:
Accesso all'app Webex
Aggiornamento token app Webex
E-mail/autoattivazione non attendibile
Controllo stato servizio Broadworks
App Webex
Configurazione DNS
L'app Webex accede ai servizi Xtended Services Interface (XSI-Actions & XSI-Events) e Device Management Service (DMS) su XSP|ADP.
Per trovare il servizio XSI, l'app Webex esegue la ricerca DNS SRV per _xsi-client._tcp.<webex app xsi domain>
. L'SRV punta all'URL configurato per gli host XSP|ADP o i bilanciatori di carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex torna alla ricerca A/AAAA.
L'SRV può risolversi in più target A/AAAA. Tuttavia, ogni record A/AAAA deve mappare solo a un singolo indirizzo IP. Se sono presenti più ADP|XSP in un DMZ dietro il dispositivo di bilanciamento del carico/bordo, è necessario che il bilanciatore di carico sia configurato per mantenere la persistenza della sessione in modo da indirizzare tutte le richieste della stessa sessione allo stesso XSP|ADP. Questa configurazione viene avviata perché i heartbeat dell'evento XSI del client devono andare allo stesso XSP|ADP utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non deve esistere. Se il DNS richiede che un record A/AAAA deve essere definito, allora deve essere restituito solo 1 indirizzo IP. Indipendentemente da ciò, l'SRV deve essere ancora definito per l'app Webex. Se l'app Webex utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client alla fine invia heartbeat a un XSP|ADP dove non ha stabilito un canale per eventi. Di conseguenza, il canale viene strappato e il traffico interno è notevolmente più intenso, il che pregiudica le prestazioni del cluster ADP|XSP. Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca di record A/AAAA, è necessario utilizzare un nome di dominio completo separato per Webex Cloud e l'app Webex per accedere agli ADP|XSP. Come mostrato negli esempi, Webex Cloud utilizza Un record |
Esempio 1: ADP|XSP multipli, ciascuno dietro bilanciatori di carico separati
In questo esempio, SRV punta a disattivare l'audio dei record A con ogni record A che punta a un bilanciatore di carico diverso su un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito un esempio di record SRV.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
A |
|
| Indica LB1 (sito A) |
A |
|
| Punti a LB2 (sito B) |
Esempio 2: più amministratori XSP| dietro un singolo bilanciatore di carico (con bridge TLS)
Per la richiesta iniziale, il bilanciatore di carico seleziona un XSP|ADP casuale. XSP|ADP restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il bilanciatore di carico utilizza il cookie per indirizzare la connessione all'ADP XSP|corretto, assicurandosi che il canale dell'evento non si interrompa.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Bilanciatore di carico |
A | LB.esempio.com |
| Indirizzo IP del bilanciatore di carico (XSP|ADP sono dietro al bilanciatore di carico) |
URL DMS
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il file di configurazione. Viene eseguita l'analisi dell'organizzatore nell'URL e l'app Webex esegue la ricerca DNS A/AAAA dell'organizzatore per connettersi all'ADP XSP|che ospita il servizio DMS.
Esempio: DNS Un record per la scoperta di Round-Robin bilanciato server XSP|ADP/Bilanciamento del carico di Webex App per scaricare i file di configurazione tramite DMS:
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
A |
|
| Indica LB1 (sito A) |
A |
|
| Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Come l'app Webex trova gli indirizzi XSP|ADP
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (sono stati inseriti quando si crea il cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue la ricerca SRV nel modo seguente:
Il cliente esegue una ricerca SRV per _xsi-cliente._tcp.<xsi domain="">
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
Il cliente cerca gli obiettivi A/AAAA e memorizza nella cache gli indirizzi IP restituiti.
Il client si connette a uno dei target (e quindi al suo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi al peso (o a caso se sono tutti uguali).
Se la ricerca SRV non restituisce alcun obiettivo:
Il client esegue una ricerca A/AAAA del parametro principale Xsi e quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso.
Come indicato, il record A/AAAA deve risolversi in un indirizzo IP per le stesse ragioni.
(Opzionale) Successivamente, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocols> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
Se esistono, il client confronterà l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
Se viene rilevata una differenza, il client re-inizializzerà la connettività XSI Actions/XSI Events. La prima fase consiste nell'eseguire lo stesso processo di ricerca DNS elencato nella fase 1, richiedendo questa volta una ricerca del valore nel %XSI_ROOT_WXT% parametro dal file di configurazione.
Assicurarsi di creare i record SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
Failover
Durante l'accesso, l'app Webex esegue una ricerca DNS SRV per _xsi-client._tcp.<xsi domain="">, crea un elenco di organizzatori e si connette a uno degli organizzatori in base alla priorità SRV, quindi al peso. Questo organizzatore connesso diventa quello selezionato per tutte le richieste future. Viene quindi aperto un canale evento all'organizzatore selezionato e viene inviato regolarmente un heartbeat per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP, pertanto è importante che il bilanciatore di carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server XSP|ADP di backend.
Se una richiesta o una richiesta heartbeat a un organizzatore non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), l'indirizzamento dell'app Webex viene eseguito immediatamente all'organizzatore successivo nell'elenco.
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e l'indirizzamento passa all'organizzatore successivo nell'elenco.
Se una risposta non viene ricevuta entro un periodo di tempo, la richiesta viene considerata non riuscita a causa del timeout e le richieste successive vengono inviate al successivo organizzatore. Tuttavia, la richiesta scaduta viene considerata come non riuscita. Alcune richieste vengono riprovate dopo l'errore (con un tempo di riprova crescente). Le richieste che il presunto non vitale non sono riprovate.
Quando un nuovo organizzatore viene provato correttamente, diventa il nuovo organizzatore selezionato se l'organizzatore è presente nell'elenco. Una volta provato l'ultimo organizzatore nell'elenco, l'app Webex passa al primo.
In caso di heartbeat, se si verificano due errori di richiesta consecutivi, l'app Webex re-inizializzerà il canale eventi.
Tenere presente che l'app Webex non esegue il failback e che il rilevamento del servizio DNS viene eseguito solo una volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione attraverso l'interfaccia XSP|ADP/Dms. Esegue una ricerca di record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Innanzitutto, tenterà di inviare la richiesta per scaricare il file di configurazione utilizzando un token SSO. Se ciò non riesce per qualsiasi motivo, verrà riprovato ma con il nome utente e la password del dispositivo.
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning dell'utente. Molte delle attività sono comuni a tutte le modalità di provisioning.
Onboarding dei partner per Webex per Cisco BroadWorks
Ciascun provider o rivenditore di servizi Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, è necessario eseguire la documentazione Cisco BroadWorks di Webex e i nuovi partner devono accettare l'ICPA (Indirect Channel Partner Agreement) online. Al termine di queste operazioni, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, il tuo Partner Activation e/o Customer Success Program Manager ti contatterà per iniziare il tuo onboarding.
I partner Webex in una regione possono creare organizzazioni di clienti in qualsiasi regione in cui offriamo i servizi. Per informazioni, vedere: Residenza dati in Webex. |
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
È necessario eseguire l'applicazione NPS su un altro XSP|ADP. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi sugli ADP XSP|.
Servizio/Applicazione | Autenticazione richiesta | Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
autenticazione protetta |
Integrazione telefonia computer |
mTLS (client e server si autenticano a vicenda) |
Presenza di telefonia |
Applicazione Webview Impostazioni chiamata |
TLS (il server esegue l'autenticazione per i client) |
Mostra le impostazioni di chiamata utente nel portale Assistenza utente all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma occorre fare riferimento alla documentazione esistente per installare le applicazioni sugli ADP|XSP.
Requisiti di coresidenza
Il servizio di autenticazione deve essere coresidente con le applicazioni Xsi, perché tali interfacce devono accettare token di lunga durata per l'autorizzazione del servizio. Il servizio di autenticazione è richiesto per convalidare tali token.
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
È possibile separare gli altri servizi/applicazioni come richiesto per la propria bilancia (gestione dispositivi dedicata XSP|ADP farm, ad esempio).
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
Non installare altre applicazioni o servizi sugli ADP XSP| utilizzati per integrare BroadWorks con Webex.
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se è in esecuzione R22 o versione superiore e il sistema lo supporta.
Mutual TLS (mTLS) è supportato anche come metodo di autenticazione alternativo per il servizio Auth. Se più organizzazioni Webex eseguono lo stesso server ADP XSP|, è necessario utilizzare l'autenticazione mTLS poiché la convalida token CI non supporta più connessioni allo stesso servizio autenticazione ADP XSP|. Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida del token CI, fare riferimento all'Appendice per configurare i servizi (con mTLS per il servizio di autenticazione). |
Se attualmente si utilizza mTLS per il servizio autenticazione, non è obbligatorio riconfigurare l'uso della convalida token CI con TLS. |
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks.
Installare le seguenti patch su ciascun server ADP XSP|. Installare le patch appropriate alla release in uso:
Per R22:
Per R23:
Per R24: non è necessario alcun cerotto
Qualsiasi riferimento a XSP include XSP o ADP.Installare il
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP al percorso del contesto /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire il servizio di autenticazione su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
A partire da Broadworks build 2022.10, le autorità di certificazione in arrivo con Java non vengono più automaticamente incluse nel trust store BroadWorks quando si passa a una nuova versione di java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
Radice commerciale IdenTrust CA 1
autorità di certificazione radice Go Daddy - G2
Verificare che questi certificati siano presenti sotto la seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get
Se non presente, eseguire il seguente comando per importare i trust Java predefiniti:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come ancoraggi attendibili con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono automaticamente importate nella nuova release e continueranno a essere importate finché non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere la FD di convalida del certificato Cisco Broadworks X509.
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server ADP XSP|:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get
set clientId client-Id-From-Step1
set enabled true
set clientSecret client-Secret-From-Step1
set ciResponseBodyMaxSizeInBytes 65536
set issuerName <URL>
- Per ilURL
, immettere l'URL IssuerName che si applica al cluster CI. Vedere la tabella seguente.set issuerUrl <URL>
- Per ilURL
, immettere l'IssuerUrl che si applica al cluster CI. Vedere la tabella seguente.set tokenInfoUrl <IdPProxy URL>
—Inserire l'URL proxy IdP applicabile al cluster dei team. Si veda la seconda tabella che segue.
Tabella 1. Imposta nome emittente e URL emittente Se il cluster CI è... Imposta issuerName e issuerURL su... NOI-A
UE
NOI-B
Se non conosci il tuo cluster CI, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.Tabella 2. Imposta tokenInfoURL Se il cluster di Teams è... Imposta tokenInfoURL su...(URL proxy IdP) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AFRA
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
DOLORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.
Per il test, è possibile verificare che il tokenInfoURL sia valido sostituendo "
idp/authenticate
" parte dell'URL con "ping
".
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user
Configurare i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get
set flsUrl https://cifls.webex.com/federation
set refreshPeriodInMinutes 60
set refreshToken refresh-Token-From-Step1
Eseguire il seguente comando per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get
Configurare la gestione dei token utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
set tokenIssuer BroadWorks
set tokenDurationInHours 720
Genera e condividi chiavi RSA. È necessario generare chiavi su un XSP|ADP, quindi copiarle su tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP.Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web. Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token. Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Rimozione dei requisiti di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con la convalida del token CI su R24, è necessario rimuovere anche il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Interfaccia CTI e configurazione correlata
Di seguito viene elencato l'ordine di configurazione "da più a più". In seguito a questo ordine non è obbligatorio.
Configurazione del server di applicazione per gli abbonamenti CTI
Configurazione di XSP|ADPs per abbonamenti CTI autenticati mTLS
Apertura delle porte in entrata per l'interfaccia CTI protetta
Abbonamento dell'organizzazione Webex agli eventi CTI di BroadWorks
Configurazione del server di applicazione per gli abbonamenti CTI
Aggiornare ClientIdentity su Application Server con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ciascun server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è |
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocol> |
Una specifica interfaccia CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocol> |
Su una nuova installazione, le seguenti crittografie sono installate per impostazione predefinita a livello di sistema. Se non è configurato nulla a livello di interfaccia (ad esempio, nell'interfaccia CTI o HTTP), si applica questo elenco di crittografia. Si noti che questo elenco può cambiare nel tempo:
|
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp>
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
Inserisci il
get
comando per visualizzare le crittografie già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, si utilizzerebbe:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Ancoraggi affidabili per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che le ADP XSP|siano rivolte verso Internet o rivolte verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy bridge (vedere Requisiti del certificato TLS per proxy bridge TLS).
Per ogni amministratore XSP|nell'infrastruttura che pubblica eventi CTI in Webex, effettuare le seguenti operazioni:
Accedere a Hub partner .
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.
Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
(Opzionale) Esecuzione
help updateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot2023
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
Consenti ai client di autenticarsi con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione BroadWorks in uso. Il comando crea un certificato server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. È necessario l'indirizzo IP dell'interfaccia CTI per questo; è possibile leggerlo dal seguente contesto:
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>
Riavviare XSP|ADP.
Abilitazione dell'accesso a BroadWorks CTI Events su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
Specificare l'indirizzo CTI in base al quale Webex può iscriversi a CTI Events di BroadWorks.
Gli abbonamenti CTI sono su base per abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato viene predisposto per Webex per Cisco BroadWorks.
Visualizzazione Webview Impostazioni chiamata
Call Settings Webview (CSWV) è un'applicazione ospitata su XSP|ADP per consentire agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview per le impostazioni di chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono native dell'app Webex.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, è necessario distribuire la funzione Webview impostazioni chiamata.
La vista Webview impostazioni chiamata presenta due componenti:
Applicazione Webview Impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
App Webex, che esegue il rendering delle impostazioni di chiamata in una vista Webview.
Esperienza utente
Utenti Windows: Fai clic su Impostazioni chiamata, quindi su .
Utenti Mac: Fare clic sull'immagine del profilo, quindi
.
Distribuzione di CSWV su BroadWorks
Installazione di Webview impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso ADP|XSP che ospita l'interfaccia Xsi-Actions nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
Accedere a cisco.com e cercare "BWCallSettingsWeb" nella sezione download software.
Trovare e scaricare la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) è stata la più recente al momento della stesura del presente documento.Installare, attivare e distribuire l'archivio Web in base alla Guida alla configurazione della piattaforma di servizi Xtended di Cisco BroadWorks per la versione XSP|ADP. (Versione R24 https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
.Passare al seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più necessario).Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario fornire anche un contextPath perché è un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio
/callsettings
.Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
Ora è possibile prevedere l'URL delle impostazioni di chiamata che si specificherà per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
L'|ADP-FQDN XSP deve corrispondere al FQDN azioni Xsi, perché CSWV deve utilizzare le azioni Xsi e CORS non è supportato.
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview Impostazioni chiamata è ora attiva sugli ADP|XSP.
Configura l'app Webex per utilizzare Webview impostazioni chiamata
Per ulteriori dettagli sulla configurazione del client, vedere la Guida alla configurazione di Webex per Cisco BroadWorks.
Nel file di configurazione dell'app Webex è presente un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti attraverso l'interfaccia dell'applicazione.
<config>
<services>
<web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%">
<url>%WEB_CALL_SETTINGS_URL_WXT%</url>
</web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel %WEB_CALL_SETTINGS_URL_WXT% tag.
Se non si specifica esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
Imposta la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
Il file di configurazione client risultante dovrebbe avere una voce come segue:
<web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push delle chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Call Notifications Push Server (CNPS) per descrivere un'applicazione ospitata XSP o ospitata ADP che viene eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti e invia le notifiche a Google Firebase Cloud Messaging (FCM) o Apple Push Notification Service (APN).
Tali servizi notificano ai dispositivi mobili degli abbonati Webex per Cisco BroadWorks la presenza di chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzione Notification Push Server.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi a loro volta notificano agli utenti mobili Webex le modifiche ai messaggi in arrivo o alla presenza.
In questa sezione viene descritto come configurare l'NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se è necessario eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPShttps://help.webex.com/nl5rir2/. |
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario aggiornare il CNPS per supportare la funzione proxy NPS, server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server di notifica push per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e i tasti di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend di Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APN Apple e i servizi FCM Google.
La funzione migliora anche la capacità del server push delle notifiche di eseguire notifiche push ai dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
Per ulteriori informazioni, vedere Server push per VoIP nella descrizione della funzione UCaaS.
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software e le patch NPS, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Cercare e scaricare la patch dalla pagina di download del software.
Ulteriori informazioni sul server ADP sono disponibili su https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio Apple Push Notification dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per APN. Questo aggiornamento richiede che XSP|ADP che ospita l'NPS esegua R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 | Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma di consegna dell'applicazione (ADP). | ||
2 | Installare le patch proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: | ||
3 | Attivare l'applicazione Notification Push Server. | ||
4 | (Per le notifiche Android) Abilitare l'API FCM v1 sull'NPS.
| ||
5 | (Per le notifiche Apple iOS) Abilitare HTTP/2 su NPS.
| ||
6 | Collegare un supporto tecnico dell'NPS XSP/ADP. | ||
7 | Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN UN 10.193.78.149
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configura NPS per utilizzare il proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Migra NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un server NPS condiviso con altre app mobili, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPS ( https://help.webex.com/nl5rir2).
1 | Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 | Creare l'account cliente su NPS:
Per verificare che i valori inseriti corrispondano a quanto ricevuto, eseguire
| |||||||||||||||||||
3 | Immettere l'URL proxy NPS e impostare l'intervallo di aggiornamento del token (consigliato 30 minuti):
| |||||||||||||||||||
4 | (Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 | (Per le notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, assicurandosi di omettere il tasto Auth – impostarlo su vuoto.
| |||||||||||||||||||
6 | Configurare i seguenti URL NPS:
| |||||||||||||||||||
7 | Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 | Verificare se il server applicazioni sta eseguendo lo screening degli ID applicazione, poiché potrebbe essere necessario aggiungere le app Webex all'elenco utenti autorizzati: | |||||||||||||||||||
9 | Riavviare XSP|ADP: | |||||||||||||||||||
10 | Esegui test delle notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migrazione di NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente che è necessario eseguire la migrazione a FCMv1. Sono previste tre procedure:
Esegui migrazione dei client UC-One a FCMv1: quando disponi di client UCaaS esistenti e devi migrarli per utilizzare FCMv1.
Migrazione dei client SaaS a FCMv1: quando si dispone di client SaaS esistenti e occorre migrarli per utilizzare FCMv1.
Aggiorna server ADP: quando si esegue la migrazione di NPS a un server ADP.
Migrazione dei client UC-One a FCMv1
Utilizzare la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere . L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile Connect su https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al
|
Accedere a SDK amministratore FCM su http://console.firebase.google.com.
Selezionare l'applicazione Android appropriata.
Nella scheda General (Generale), registrare l’ID del progetto
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
Fare clic sul pulsante blu per creare un nuovo account di servizio
Fai clic sul pulsante blu per generare una nuova chiave privata
Chiave di download per una posizione sicura
Per riutilizzare un account servizio esistente:
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
Identificare l'account servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
Copiare il file json su XSP|ADP.
Configurare l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== my_project ********
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Migrazione dei clienti SaaS a FCMv1
Se si desidera eseguire la migrazione dei client SaaS a FCMv1, attenersi alla procedura seguente su Google FCM Console.
Assicurarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione". |
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Aggiorna server ADP
Se si esegue la migrazione dell'NPS per utilizzare un server ADP, utilizzare i passaggi seguenti nella console Google FCM.
Ottenere il file JSON dalla console cloud di Google:
Su Google Cloud Console, andare alla pagina Account servizio.
Fare clic su Seleziona un progetto, scegliere il progetto e fare clic su Apri.
Trova la riga dell'account servizio per la quale desideri creare una chiave, fai clic sul pulsante Altro verticale, quindi fai clic su Crea chiave.
Selezionare un tipo di chiave e fare clic su Crea
Il file viene scaricato.
Aggiungere FCM al server ADP:
Importare il file JSON nel server ADP utilizzando il
/bw/install
comando.Accedere all'ADP CLI e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON
:Quindi, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò avviene per i seguenti motivi:
Per consentire a Webex cloud di autenticare i tuoi utenti rispetto a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
Per consentire alle app Webex di utilizzare l'interfaccia Xsi per il controllo delle chiamate.
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se alcune interfacce non vengono convalidate correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide. Ciò viene impedito poiché un cluster configurato in modo errato potrebbe causare problemi che sono difficili da risolvere. |
Cosa è necessario fare:
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Se l'utente amministratore non ha visibilità delle impostazioni di BroadWorks Calling , si consiglia di aprire un caso con Cisco TAC.
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
Assegna un nome al cluster e fai clic su Avanti.
Il concetto di cluster qui è semplicemente una raccolta di interfacce, solitamente situate su un server ADP XSP| o in un'azienda agricola, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il sistema BroadWorks non sono applicabili qui.
(Opzionale) Immettere un Nome account utente e una Password BroadWorks noti all'interno del sistema BroadWorks che si connette a Webex, quindi fare clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
Aggiungere gli URL XSI Actions e XSI Events.
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
Opzionale. Selezionare la casella di controllo Abilita autenticazione diretta BroadWorks se si desidera che gli accessi a BroadWorks siano diretti a BroadWorks. In caso contrario, l'autenticazione per BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo influisce su queste situazioni di accesso:
Accesso al portale di attivazione utente: gli utenti devono immettere le credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o attraverso il proxy IdP.
Accesso client: se l'autenticazione BroadWorks è configurata nel modello di onboarding, l'impostazione precedente determina se l'accesso del client all'app Webex è diretto a BroadWorks o viene proxy attraverso il proxy IdP.
Fai clic su Avanti.
Nella pagina CTI Interface (Interfaccia CTI) procedere come segue:
Aggiungere l'URL CTI e la porta per l'interfaccia CTI a cui si desidera connettersi.
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
Opzionale. Abilita il tasto di alternanza Non disturbare (NoDist) e inserisci l'ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurandosi che la funzione funzioni allo stesso modo su entrambe le piattaforme.
Fai clic su Avanti.
Aggiungere l'URL del servizio di autenticazione.
Selezionare Servizio autenticazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex poiché il servizio di autenticazione convalida correttamente il token utente rispetto al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
Controllare le voci sulla schermata finale, quindi fare clic su Crea. Dovrebbe essere visualizzato un messaggio di successo.
Partner Hub passa gli URL a vari microservizi Webex che testano le connessioni alle interfacce fornite.
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è riuscita.
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Abbiamo implementato questa verifica per prevenire errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, caricatore di bilanciamento o firewall) come illustrato in questa guida, prima di salvare il modello.
Verifica delle connessioni alle interfacce BroadWorks
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Visualizza cluster.
Partner Hub avvia i test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina dell'elenco dei cluster mostra il messaggio di stato accanto a ciascun cluster.
I messaggi verdi relativi al successo dovrebbero essere visualizzati. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio XSI-Actions, XSI-Events, DAS URL e le impostazioni dell'interfaccia CTI.
Configurazione dei modelli di onboarding
I modelli di onboarding sono il modo in cui verrà applicata la configurazione condivisa a uno o più clienti man mano che vengono caricati tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma solo un modello può essere associato a un cliente.
Accedere a Partner Hub e selezionare Clienti.
Fare clic sul pulsante Modelli di onboarding per visualizzare i modelli esistenti.
Fare clic su Crea modello.
Nella finestra Dettagli modello, aggiungere il nome del modello, il paese o la regione e la lingua e-mail predefinita.
Fare clic sull'elenco a discesa per l'ID abbonamento CCW, individuare gli abbonamenti elencati per il partner e selezionare l'abbonamento applicabile.
Questo campo viene visualizzato solo per i partner migrati da Webex per BroadWorks a Webex.Nella finestra Impostazione servizio, utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
Immettere un Nome modello, quindi fare clic su Avanti.
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per diverse modalità di provisioning Nome impostazione
Provisioning fluviale con e-mail attendibili
Provisioning flowthrough senza e-mail
Self-provisioning utente
Abilita flusso BroadWorks attraverso il provisioning (include le credenziali dell'account di provisioning se attivato**)
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il †
Il †
Il †
Indirizzo e-mail provider servizi
Selezionare un indirizzo e-mail dall'elenco a discesa (è possibile digitare alcuni caratteri per trovare l'indirizzo, se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello di onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature tra paese e regione in questo foglio di calcolo.
Il paese dell'organizzazione determina i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni consultare la sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questo interruttore spento.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note dalla tabella:
† Questo passaggio garantisce che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa opzione deve essere sempre attiva, a meno che non si utilizzi un processo manuale di ordinazione ed esecuzione (tramite Cisco Commerce Workspace) per creare le organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello di "provisioning ibrido" e non rientra nel campo di applicazione di questo documento.
** "Account di provisioning" si riferisce all'account di amministrazione a livello di sistema BroadWorks. Su BroadWorks, è necessario un account amministratore con questi attributi: Tipo amministratore=Provisioning, sola lettura=Disattivato.
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
Opzionale. Selezionare Disabilita chiamata gratuita Cisco Webex se si desidera disabilitare le chiamate Webex.
Per la configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
Numeri di chiamata in ingresso Cisco (PSTN)
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
Fai clic su Avanti.
Esistono due approcci per il provisioning degli abbonati relativamente a come vengono verificate le relative identità, utilizzando e-mail attendibili o e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile, gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. In qualità di partner, sei responsabile del provisioning dell'indirizzo e-mail come parte del metodo flow-through o API.
Si consiglia vivamente di utilizzare il metodo di provisioning attendibile poiché garantisce che tutti gli abbonati siano completamente predisposti dall'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso e-mail non attendibile, gli utenti devono verificare i relativi messaggi e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome impostazione
Provisioning flowthrough senza e-mail
Self-provisioning utente
Esegui prima provisioning amministratore
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
Note dalla tabella:
* Ciascuna organizzazione cliente in Webex deve disporre di almeno un utente con ruolo di amministratore. Il primo utente a cui assegnare IM&P integrato in BroadWorks assume il ruolo di amministratore del cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di fornitore di servizi è possibile avere il controllo su chi ottiene il ruolo. La verifica di questa impostazione impedisce agli utenti di completare l'attivazione fino a quando non viene attivato il primo utente fornito. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
Fai clic su Avanti.
Selezionare la modalità di autenticazione predefinita (autenticazione BroadWorks o autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.(Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
Fai clic su Avanti.
Per Preferenze, configurare quanto segue:
Scegliere se si desidera Precompilare gli indirizzi e-mail utente nella pagina di accesso.
Utilizzare questa opzione solo dopo aver selezionato Autenticazione BroadWorks e aver anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il nome utente BroadWorks. La pagina di accesso offre l'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
Se desideri abilitare la sincronizzazione delle rubriche, imposta l'opzione Abilita sincronizzazione rubrica telefonica per tutte le nuove organizzazioni clienti per attivare.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
Immettere un amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatico di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
Assicurati che l'opzione Consenti invito e-mail amministratore quando ti colleghi a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
Fai clic su Avanti.
Esaminare le voci nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Dovrebbe essere visualizzato un messaggio di successo.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con altri modelli.
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario immettere nuovamente i dettagli dell'account di provisioning. I campi Password vuota/Conferma password sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori forniti alla procedura guidata.
Aggiungi altri modelli se disponi di diverse configurazioni condivise che desideri fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbe essere necessario specificare i dettagli del modello per una delle attività seguenti.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning. |
Patch Application Server (solo R22, R23 e R24)
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
Per R22:
AP.as.22.0.1123.ap373197
Per R23:
AP.as.23.0.1075.ap373197
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che costituiscono il requisito per la distribuzione di Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.Modifica della
Maintenance/ContainerOptions
contesto.Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true
Scarica gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interfaccia > Messaggistica e Servizio > IM&P integrato) dei comandi AS.
Accedi a Partner Hub e vai a
.Fare clic su Visualizza modelli.
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro flyout a destra. Se non è stato ancora creato un modello, è necessario farlo prima di poter ottenere l'URL di provisioning.
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per altri modelli se si dispone di più modelli.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema su server applicazioni
Se si utilizza UC-One SaaS, potrebbe non essere necessario impostare il provisioning e il dominio del servizio a livello di sistema. Vedere i Punti di decisione nella sezione Preparazione dell’ambiente. |
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password
AS_CLI/Interface/Messaging> set enableSynchronization true
Attivare l'interfaccia IMP integrata:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
È necessario inserire il nome completo per il |
(Opzione) Configurazione dei parametri di provisioning per azienda su server applicazioni
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
Selezionare Usa dominio di servizio e immettere un valore fittizio (Webex ignora questo parametro). È possibile utilizzare
example.com
).Selezionare Usa server di messaggistica.
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
È necessario inserire il nome completo per il
provisioningURL
parametro, come è stato dato in Partner Hub. Se il server applicazioni non può accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel/etc/hosts
file su AS.Nel campo Nome utente, immettere un nome per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Immettere una password per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Per Identità utente predefinita per ID IM&P, selezionare Principale.
Fare clic su Applica.
Ripeti per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning utente, vedi Provisioning utente provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning aiuta amministratori e team di vendita controllando la presenza di errori prima di eseguire il provisioning di un cliente o abbonato per un pacchetto. Gli utenti o le integrazioni autorizzati da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per assicurarsi che non vi siano conflitti o errori con il provisioning del pacchetto per un determinato cliente o abbonato.
L'API verifica se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto a un cliente o partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, è possibile correggere gli errori prima del provisioning, aumentando la probabilità di un provisioning riuscito.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore Webex per la vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare di un provisioning abbonato all'ingrosso
Per accedere a Precontrolla un documento di provisioning abbonato Wholesale, devi accedere al portale https://developer.webex.com/. |
Partner SSO - SAML
Consente agli amministratori dei partner di configurare l'SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La seguente procedura SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere la funzionalità SSO del partner a un'organizzazione cliente esistente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso. |
Verificare che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'integrazione Single Sign-On in Control Hub.
Carica il file di metadati CI con provider di identità.
Configurare un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, immettere l'ID entità dall'XML metadati SAML del provider di identità di terze parti.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
Proprio che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori dei partner di configurare l'SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per impostare SSO OIDC partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già caricate utilizzando il modello. |
Aprire una richiesta di servizio con il centro TAC di Cisco con i dettagli dell'IDP di connessione OpenID. Sono obbligatori e facoltativi gli attributi IDP. TAC deve impostare l'IDP sul CI e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC, potrebbe consistere in lettere, numeri, trattini, sottolineature, inclinazioni e punti e la lunghezza massima è 128 caratteri.
Id client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Segreto client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco degli ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio, ad esempio "profilo e-mail openid" Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non fornito
URL dell'endpoint di autorizzazione OAuth 2.0 dell'IdP.
endpoint token
Sì se discoveryEndpoint non fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
endpoint infoutente
No
URL dell'endpoint UserInfo di IdP.
Endpoint set di tasti
No
URL dell'endpoint JSON Web Key Set dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
Configurare l'URI di reindirizzamento sull'IDP di connessione OpenID.
Configurare un modello di onboarding. Per l'impostazione della modalità di autenticazione, selezionare Autenticazione partner Con OpenID Connect e immettere il nome IDP fornito durante l'impostazione IDP come ID entità IDP OpenID Connect.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui registrazione chiamata, risposta per assente di gruppo, dirigente e assistente di direzione.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
Eseguire i seguenti comandi sulle interfacce AS. Ciò consentirà all’AS di inviare il c.d.
X-BroadWorks-Correlation-Info
Intestazione SIP:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true
Il
enableCallCorrelationID
Il parametro associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione delle informazioni di correlazione delle chiamate nei registri Xsi-Actions. Si raccomanda di avereenableCallCorrelationID
abilitato utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione dell'identificativo di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione della rubrica garantisce che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la directory di chiamata completa dal server BroadWorks viene sincronizzata con la directory Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione rubriche, vai a Sincronizzazione rubriche in Webex per Cisco BroadWorks.
Webex per Cisco BroadWorks flowthrough provisioning aggiunge utenti di messaggistica e informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, gli elenchi telefonici, gli utenti non di messaggistica e le entità non utenti non sono inclusi (ad esempio, un telefono della sala conferenze, un fax o un numero di gruppo di risposta). L'attivazione della sincronizzazione delle rubriche garantisce che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex. |
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia chiamate e riunioni unificate Webex visualizzata sull'app Webex. Gli utenti possono visualizzare la cronologia dettagliata delle chiamate e della riunione dall'app Webex.
La cronologia chiamate unificata può essere abilitata dagli amministratori a livello di partner in Partner Hub su base cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
Eventi cronologia chiamate: questi eventi vengono utilizzati per creare una cronologia chiamate unificata dettagliata
Eventi di stato hook: la cronologia chiamate unificata include ottimizzazioni dello stato hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di Telephony Presence
Requisiti della cronologia chiamate unificata
Prima di configurare la cronologia chiamate unificata, accertarsi di aver eseguito la patch del sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
AP.as.22.0.1123.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per R23:
AP.as.23.0.1075.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Se si utilizza XSP—
AP.xsp.23.0.1075.ap378585
In caso di utilizzo di ADP
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
AP.as.24.0.944.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per l'elenco completo delle patch BroadWorks che è necessario installare come prerequisito per l'esecuzione di Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella sezione Riferimento. |
Oltre alla patch del sistema, il file di configurazione del client ( config-wxt.xml
) deve avere il seguente set di tag: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altro reindirizzamento nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
AP.as.23.0.1075.ap383346
AP.as.23.0.1075.ap383994
Per R24:
AP.as.24.0.944.ap383346
AP.as.24.0.944.ap383994
Per avere informazioni Dirigente-Assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
AP.as.24.0.944.ap380052
AP.as.24.0.944.ap384239
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare anche la sincronizzazione delle rubriche per la cronologia chiamate unificata dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione NoDist, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti nel cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione di Broadworks durante la stessa finestra di manutenzione. |
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configura organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettuare le seguenti operazioni:
Accedi a Partner Hub su
admin.webex.com
.Andare a Impostazioni e selezionare un cluster esistente.
Verificare che la connessione al cluster sia buona. Nel pannello a destra viene visualizzato un segno di spunta verde con Connection stabilita.
Se questa opzione non viene visualizzata, in Check Connnections (Opzionale), immettere BroadWorks User Id e BroadWorks Password e fare clic su Check per verificare che la connessione sia corretta.
Selezionare la casella di controllo Abilita cronologia chiamate.
Fai clic su Salva.
Interazioni funzione
Per la cronologia chiamate unificata sono presenti le seguenti interazioni delle funzioni:
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando questa situazione esiste, gli eventi Cronologia chiamate e Stato hook non vengono inviati all'app Webex.
La cronologia chiamate unificate non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia chiamate unificata dall'app Webex. Per informazioni dettagliate, vedere: Webex | visualizza cronologia chiamate e riunioni.
Disabilita cronologia chiamate unificata
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visivo
L'app Webex supporta un'indicazione visiva delle chiamate spam nel avviso popup quando la chiamata viene presentata al destinatario e nei record della cronologia delle chiamate unificate quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per utilizzare questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- Le seguenti patch devono essere installate e attive:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o AS-25_Rel_2022.12 come minimo
- La funzione deve essere attivata tramite AS CLI:
- AS_CLI/System/ActivatableFeature> attivare 104112
- AS_CLI/System/StirShaken> imposta enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'etichettatura e la verifica STIR-SHAKEN come descritto in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste di invito inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti che vengono inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione di spam visivo nella presentazione della chiamata e nella cronologia chiamate unificata della chiamata.
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenta di identificare il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra di chiamata e una volta completata la chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante abbinando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se trova più istanze di un numero in un'origine, non tenterà di sceglierne una, in questo caso, non visualizzerà alcun ID chiamante. |
Webex Common Identity (CI) che contiene gli utenti della tua organizzazione.
Contatti personali e aziendali. I contatti personali sono visibili nella scheda Contatti.
Rubrica locale. In Windows - applicazione Outlook, in Mac - Contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non viene trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, utilizzerà la parte del nome utente dell'URI SIP dall'intestazione SIP From come ultima risorsa.
Per il controllo delle chiamate remote (ad esempio, modalità di controllo del telefono fisso) vengono utilizzate informazioni XSI, dove viene utilizzato ID BWKS o interno, estratte da informazioni di parte remota nell'evento XSI. Se l'informazione della parte remota non è disponibile, verrà utilizzata P-Asserted Identity (PAI) (se configurata).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica di chiamata e nella cronologia chiamate.
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
Coda Call Center: Visualizza il nome della coda che ha inoltrato la chiamata.
Dirigente-Assistente: Mostra il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
Per le chiamate nella coda chiamate interna, in cui un agente richiama una parte interna, la parte remota non visualizzerà il nome della coda chiamata, ma il nome dell'agente che le chiama.
Chiamata con risposta altrove:
Per gruppi di risposta o code chiamate impostate con indirizzamento simultaneo, gli agenti visualizzeranno una chiamata che ha ricevuto risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di risposta o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate perse nella cronologia chiamate se risposte da un altro agente.
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni da tavolo. Questa funzione specifica consente di assegnare gli indicatori di linea condivisa all'app Webex dell'utente finale.
Questa funzione consente agli utenti di gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente alle linee condivise.
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise dal client Webex
R23 senza ADP:
AP.as.23.0.1075.ap384179
AP.xsp.23.0.1075.ap384179
R23 con ADP:
AP.as.23.0.1075.ap384179
Xsi-Actions-23_2022.10
R24:
IN QUANTO: AP.as.24.0.944.ap384179
Xsi-Actions-24_2022.10
R25:
IN QUANTO: Versione RI Rel_2022.10_1.310
Xsi-Actions-25_2022.10
Cerotto 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo. Esempio: Per il client desktop: Sistema>Tipo di profilo identità/dispositivo - Modifica> Business Communicator - PC: Profilo, opzioni standard, numero di porte:
- SE l'opzione 'Illimitato' è abilitata, non è richiesta alcuna modifica
- SE 'Limitato a' è <10, modificare il valore = 10 e salvarlo per utilizzare tutte le linee disponibili
Versione RI Rel_2022.10_1.310
Sincronizzazione Non disturbare (NoDist).
La sincronizzazione Non disturbare (NoDist) allinea le impostazioni NoDist tra Webex e BroadWorks sincronizzando lo stato NoDist tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato si sincronizza con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. Analogamente, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist da una piattaforma non vengono riconosciuti dall'altra piattaforma.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Se sono presenti molti clienti (>50) nel cluster BroadWorks, la sincronizzazione NoDist non è supportata. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza. |
Prerequisiti
Assicurarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione BroadWorks.
Per la versione 23:
<snipped>
- App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
<snipped>
- App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 su AS:
AS_CLI/System/ActivatableFeature> activate 25433
Se sono presenti molti clienti (>50) nel cluster BroadWorks, operazioni come l'aggiornamento di azioni XSI, eventi XSI, URL DAS, URL XSP|ADP o sincronizzazione NoDist non sono supportate. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza.
Configura sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto di eventi "as-feature-event". Per informazioni dettagliate, vedere Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
Accedi a Partner Hub
Fare clic su Impostazioni.
Fare clic su Visualizza cluster e selezionare il cluster BroadWorks appropriato.
Abilita il tasto di alternanza Non disturbare (NoDist).
Inserire l'ID utente BroadWorks e fare clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione NoDist. Se la convalida non riesce, il pulsante Salva viene disabilitato.
Se la convalida ha esito positivo, fare clic su Salva.
|
Abilita sincronizzazione NoDist (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per ulteriori dettagli, vedere "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Disabilita sincronizzazione NoDist
Non puoi disabilitare la sincronizzazione NoDist da solo. Per disabilitare la funzione, crea un caso BEMS di ingegneria con le seguenti informazioni:
Famiglia: Servizio Spark
Prodotto: Chiamata in Webex (Webex per BroadWorks)
Componente: Provisioning WxBW
Il caso BEMS deve indicare che la sincronizzazione non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterIdBroadWorks.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione delle chiamate.
Modalità di registrazione | Descrizione | Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta | La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente | La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Per R22: AP.as.22.0.1123.ap377718
Per R23: AP.as.23.0.1075.ap377718
Per R24: AP.as.24.0.944.ap377718
L'identificativo di correlazione chiamata deve essere attivato. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione delle chiamate Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, andare a help.webex.com
articolo Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla piattaforma di registrazione chiamate di terze parti.
Gruppo Parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione di parcheggio e recupero delle chiamate di gruppo. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti al dettaglio in un'impostazione di negozio possono utilizzare la funzione per parcheggiare una chiamata che può essere raccolta da qualcuno in un altro reparto.
Funzionamento funzione
Una volta configurata la funzione
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nell'app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nell'app Webex. L'utente quindi inserisce l'estensione della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per attivare questa funzione, verificare quanto segue:
Il file di configurazione client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
L'identificativo di correlazione chiamata deve essere abilitato su AS e XSP|ADP. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Il tuo SBC deve essere configurato per passare il ‘
x-broadworks-correlation-in
' Attributo SIP a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiungi gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo del server applicazioni Cisco BroadWorks - Parte 2. È necessario creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Parcheggio Webex | e Recupera chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzato
Il parcheggio chiamate regolare o indirizzato non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso funzione:
Immettere *68 per parcheggiare una chiamata
Immettere *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato negli ambienti del call center o in altre situazioni in cui può essere necessaria un'assistenza o un intervento immediati.
Quando un servizio di inclusione è abilitato, un utente o supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di tasti o pulsanti dedicati sul proprio telefono o dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o di partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in vari scenari. In un ambiente di call center, supervisori o formatori possono monitorare e assistere i rappresentanti del servizio clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire assistenza o prendere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può partecipare rapidamente a conversazioni in corso per fornire assistenza o prendere decisioni importanti.
Nell'app Webex per l'inclusione, viene inviata una notifica che la chiamata viene trasformata in una conferenza. In NOTIFY (informazioni sulla chiamata o conferenza) non sono disponibili ulteriori informazioni sul tipo di conferenza, pertanto è possibile trattarla in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Vengono introdotti i seguenti termini:
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore solitamente ha la possibilità di monitorare e intervenire nelle chiamate in corso dei clienti. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire assistenza agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può comprendere la formazione degli agenti, la gestione dei problemi dei clienti e l'ottimizzazione delle prestazioni del team.
Cliente: Per cliente si intende una persona fisica o giuridica che interagisce con un'azienda o un'organizzazione per ottenere prodotti, servizi o assistenza. Nel contesto dell'inclusione delle chiamate, un cliente è qualcuno che sta effettuando o ricevendo una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risolvere le loro richieste o problemi durante la chiamata. La funzione di inclusione chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
Agente: Un agente, anche noto come rappresentante del servizio clienti o agente del call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza telefonica o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare operazioni e offrire un'esperienza positiva al cliente. Nel contesto dell'inclusione delle chiamate, un agente è la persona che parla direttamente al cliente durante la telefonata. L'agente può ricevere indicazioni o feedback dal supervisore attraverso l'inclusione della chiamata, se necessario.
La chiamata nativa mobile viene inoltrata alla riunione
La funzione di escalation della chiamata nativa mobile alla riunione è dotata di due funzioni uniche:
Nuova notifica push
Gli utenti mobili su una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando si avvia una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si accede direttamente alla schermata in chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata utilizzando il controllo chiamate Cisco per le chiamate su cellulare, viene visualizzata la notifica Webex durante una chiamata su cellulare.
Trasferisci chiamata mobile a riunione
Quando sei nel mezzo di una chiamata con qualcuno, potresti voler trasferire la chiamata in una riunione per utilizzare alcune funzioni di riunione avanzate come video, condivisione o lavagna. In alternativa, invitare altre persone alla discussione e passare a una riunione.
Requisiti BroadWorks
Funzione attivabile 25239
R23 con XSP|ADP:
AS Patch AP.as.23.0.1075.ap383064
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
Patch AP.platform.23.0.1075.ap383064
R23 con ADP:
AS Patch AP.as.23.0.1075.ap383064
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R24:
Cerotto AS: AP.as.24.0.944.ap383064
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R25:
AS RI release Rel_2022.08_1.354
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e NPS versione > 2022.08_1.350
Configurazione chiamata URI per supportare lo spostamento della chiamata alla riunione
Criteri di chiamata Url NS
Definisci la regola per (.*)webex.com da indirizzare attraverso I-SBC
NS_CLI/Policy/UrlDialing> get WebexMeetings
Policy: UrlDialing Instance: Webex
unknownSipURIHandling = reject
disableSubscriberLookups = true
Enable = true
CallTypes:
Selection = {ALL}
From = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP}
lineportOnly = false
enableSipURIMatchingRules = true
NS_CLI/Policy/UrlDialing/Rules> get WebexMeetings
Policy: UrlDialing Instance: WebexCalling Table: Rules
id pattern routingNE cost weight dtg
===================================================================
1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE di indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> get ne WebexMeetings
Network Element WebexMeetings
Location = 1281465
Data Center =
Static Cost = 1
Static Weight = 99
Poll = false
OpState = enabled
State = OnLine
Profile = NIL_PROFILE
Remote Lookup Enabled = false
Signaling Attributes =
NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings
Routing NE Address Cost Weight Port Transport Route
=====================================================================
WebexMeetings sbc-address 1 99 - unspecified
Profilo di indirizzamento NS
Aggiunta dell'istanza della policy UrlDialing ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> get profile MyInst
Profile: Webex
Policy Instance
==========================================
…
UrlDialing WebexMeetings
AS Usa indirizzamento NS per chiamata NetworkURL
Consente all'AS di rispettare il percorso NS in modalità ibrida AS
AS_CLI/Interface/IMS> set queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un PSAP (Public Safety Answering Point), che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, è necessario integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Usa i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
Chiamata di emergenza E911 in Webex per BroadWorks: utilizzare questo articolo per configurare la chiamata di emergenza E911 in Webex per Cisco BroadWorks utilizzando uno dei seguenti provider E911 supportati:
Banda
Intrado
RedSky
Esclusione di responsabilità per chiamate di emergenza: se disponi di un servizio di posizione, puoi configurare la finestra Esclusione di responsabilità per i servizi di emergenza sull'app Webex in modo da includere un'opzione per gli utenti per aggiornare la propria posizione quando eseguono l'accesso.
Personalizzazione e provisioning dei clienti
Gli utenti scaricano e installano le relative app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedere Piattaforme app Webex). Una volta eseguita l'autenticazione dell'utente, il client si registra sul cloud Webex per messaggistica e riunioni, recupera le informazioni sul branding, scopre le informazioni del servizio BroadWorks e scarica la configurazione delle chiamate dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
Configurare i parametri di chiamata per le app Webex in BroadWorks (come di consueto). Configura i parametri di branding, messaggistica e riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Prepara il tuo ambiente).
Verificare di disporre dei set di tag corretti in BroadWorks System > Resources > Device Management Tag Sets.
Per ciascun client che si sta eseguendo il provisioning:
Scaricare ed estrarre il file zip DTAF per il client specifico.
Importare i file DTAF in BroadWorks all'indirizzo System > Resources > Identity/Device Profile Types
Apri il profilo dispositivo appena aggiunto per la modifica e:
Immettere il nome di dominio completo dell'azienda agricola XSP|ADP e il protocollo di accesso del dispositivo.
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per il funzionamento della condivisione desktop.
È inoltre possibile abilitare il supporto Parte remota eseguendo il seguente comando CLI sul server applicazioni:AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
Salvare il file.
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome | Descrizione |
Priorità codec | Configurazione dell'ordine di priorità per i codec audio e video per le chiamate VoIP |
TCP, UDP e TLS | Configurare i protocolli utilizzati per la segnalazione e il contenuto multimediale SIP |
Porte audio e video RTP | Configurazione degli intervalli di porte per audio e video RTP |
Opzioni SIP | Configurare diverse opzioni relative a SIP (SIP INFO, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti gestiti dal partner. Vedere Configurazione di personalizzazioni di branding avanzate.
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client. |
Personalizzazione dei report dei problemi e degli URL della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito Feedback e Guida", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con Flowthrough Provisioning
Prima di poter eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 | Assegna servizio in BroadWorks: |
2 | Verifica dell'organizzazione cliente e degli utenti in Control Hub: |
Test utente
1 | Scaricare l'app Webex su due diverse macchine. |
2 | Eseguire l'accesso come utenti di test sulle due macchine. |
3 | Effettuare chiamate di prova. |
Provisioning delle organizzazioni dei clienti
Nel modello corrente, eseguiamo automaticamente il provisioning dell'organizzazione del cliente quando si esegue l'onboarding del primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguito una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
Usa API per creare account Webex
Assegna il provisioning integrato IM&P (flowthrough provisioning) con e-mail attendibili per creare account Webex
Assegna provisioning integrato IM&P (flowthrough) senza e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per creare account Webex
Consenti agli utenti di autoattivarsi (invia loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex espone le API pubbliche per consentire ai provider di servizi di integrare il provisioning degli abbonati Webex per Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. Le specifiche per queste API sono disponibili su developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti wholesale verranno rifiutati da queste API. |
Provisioning del flusso
Su BroadWorks, è possibile eseguire il provisioning degli utenti con l'opzione Abilita IM&P integrato. Questa azione provoca l'adattatore di provisioning BroadWorks per effettuare una chiamata API per il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica del codice, ma solo una modifica della configurazione dell'endpoint API per l'adattatore di provisioning.
Il provisioning degli abbonati su Webex può richiedere molti minuti (diversi minuti per l'utente iniziale all'interno di un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il successo del provisioning flowthrough indica che il provisioning è stato avviato. Non indica il completamento. Per confermare che il provisioning di utenti e organizzazione cliente sia completo su Webex, devi accedere a Partner Hub e guardare nell'elenco dei clienti. Gli utenti di trunking BroadWorks possono disporre di Webex per BroadWorks tramite un identificativo di chiamata condiviso (SCA). L'utente che esegue il trunking dovrà disporre del servizio di autenticazione assegnato. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto Webex SCA dall'autenticazione del trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con le funzioni di elenco di indirizzamento o indirizzamento diretto assegnate. |
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata Modello di onboarding. |
Autoattivazione utente
Per eseguire il provisioning degli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
Accedere a Partner Hub e trovare la pagina Elenco clienti.
Fare clic su Visualizza modelli.
Seleziona il modello di onboarding di provisioning che desideri applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non si trova nel sistema BroadWorks associato a questo modello, non può attivarsi automaticamente con il collegamento.
Copiare il collegamento di provisioning e inviarlo all'utente.
È anche possibile includere il collegamento per il download del software e ricordare all'utente di cui ha bisogno di fornire e convalidare il proprio indirizzo e-mail per attivare l'account Webex.
È possibile monitorare lo stato di attivazione dell'utente nel modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi di attivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli all'interno della vista Stato utente che consentono agli amministratori dei provider di servizi Webex per Cisco BroadWorks di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Sposta gli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) |
|
Organizzazione cliente | Collega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge Webex per BroadWorks anche agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) | Se l'organizzazione Webex per BroadWorks non esiste (nessun utente predisposto):
Se esiste un'organizzazione Webex per BroadWorks (viene predisposto almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di autoiscrizione (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (con il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
Sposta utente (con e-mail attendibili): utilizza il provisioning con e-mail attendibili
Sposta utente (con e-mail non attendibili): utilizza il provisioning con e-mail non attendibili
Autoattivazione
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza messaggi e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
L'amministratore aggiunge l'utente.
L'utente viene spinto sul bridge di provisioning BroadWorks.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L’utente apre il messaggio e-mail e fa clic su Attiva account. L'utente viene reindirizzato al portale consumer Webex.
L'utente accede a Webex.
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza messaggi e-mail non attendibili, è necessario prima convalidare l’indirizzo e-mail dell’utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
L'amministratore aggiunge l'utente.
L'utente viene inviato automaticamente al bridge di provisioning BroadWorks.
All'utente viene inviato un testo con un collegamento di attivazione.
L'utente fa clic sul collegamento Attivazione e inserisce l'indirizzo e-mail.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L'utente apre il messaggio e-mail e fa clic su Accedi ora.
L'indirizzo e-mail viene convalidato.
L'utente viene reindirizzato all'accesso al portale consumer Webex.
L'utente accede a Webex.
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Flusso di autoattivazione
Se l'utente dispone di un account BroadWorks esistente, può utilizzare il processo di autoattivazione per spostare l'account.
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
L'utente inserisce il proprio indirizzo e-mail.
L'utente viene inviato al bridge di provisioning BroadWorks.
Viene inviata un'e-mail automatica all'indirizzo e-mail dell'utente.
L'utente apre il messaggio e-mail e fa clic sul collegamento Accedi ora, che convalida l'indirizzo e-mail.
CI rileva che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di poter continuare.
L'utente viene reindirizzato all'accesso a Webex.
L'utente accede al portale consumer.
L'utente fa clic su Elimina account.
L'account Webex precedente viene eliminato.
All'utente è stato predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
Collegamento di Webex per BroadWorks all'organizzazione esistente
Se sei un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, che non è ancora associata a un'azienda BroadWorks gestita da un partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso amministratore per la richiesta di provisioning riuscita.
È necessaria l'approvazione dell'amministratore dell'organizzazione se una delle seguenti affermazioni è vera:
L'organizzazione cliente esistente dispone di 100 utenti o più
L'organizzazione dispone di un dominio e-mail verificato
Dominio organizzazione richiesto
Se nessuno dei criteri di cui sopra è vero, può verificarsi un Attacco automatico.
In uno scenario di allegato automatico, un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner verranno concessi diritti di amministrazione provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà eseguito un amministratore completo. Con l'accesso amministratore di provisioning, la visibilità in Control Hub sarà limitata agli utenti nell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione. |
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che i messaggi e-mail di invito amministratore vengano collegati a organizzazioni esistenti (il tasto di alternanza è attivo per impostazione predefinita). |
1 | L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedere Provisioning delle organizzazioni dei clienti. Si verifica quanto segue:
| ||
2 | Con l'accesso amministratore completo, l'amministratore del partner può completare il processo di provisioning del cliente. Dovrai provare a eseguire nuovamente il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora come amministratore completo esterno, non si dovrebbe osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione cliente esistente sarà visibile come cliente sotto Webex per l'organizzazione partner BroadWorks.
|
Condizioni dell'allegato organizzazione
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione del cliente target. In caso contrario, verrà creata una nuova organizzazione cliente.
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato sul modello di provisioning Webex per BroadWorks. Di conseguenza, non vi sono modifiche alla modalità di accesso degli utenti esistenti.
Tuttavia, se l'organizzazione cliente esistente dispone di branding di base abilitato, una volta eseguito il collegamento, le impostazioni di branding avanzate del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
Il nome dell'organizzazione esistente non cambierà.
Non è stata apportata alcuna modifica all'impostazione del flag di soppressione e-mail nelle impostazioni dell'organizzazione esistente. Ciò può avere effetto sui nuovi utenti predisposti. A seconda di come è impostato il flag, i nuovi utenti possono o meno ricevere un'e-mail con un codice che deve essere immesso per completare l'attivazione.
La modalità di amministrazione con restrizioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
Accertarsi di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
Un'azienda BroadWorks può essere associata solo a una organziazione Webex. Non è possibile eseguire il provisioning degli abbonati da una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com
.
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo. |
L'indirizzo e-mail aggiunto dall'amministratore dell'organizzazione cliente come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore partner come configurato nel modello di onboarding su Partner Hub. Dopo aver aggiunto l'e-mail dal modello di onboarding in Partner Hub come amministratore completo, qualsiasi amministratore aggiuntivo del partner dovrà essere aggiunto anche come amministratore esterno con diritti di amministratore completo. |
Scollegare Webex per BroadWorks dall'organizzazione esistente
Effettuare le seguenti operazioni per scollegare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato accidentalmente Webex per BroadWorks a un'organizzazione esistente e si desidera rimuovere l'allegato.
In Flusso standard, il distacco di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati. |
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso all'amministratore esterno seguendo Approva richiesta amministratore esterno.
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Remove a BroadWorks Workspace.
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi abbonato BroadWorks.
Rimuovi gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se gli utenti sono stati predisposti tramite il flusso e-mail non attendibile e non sono stati ancora inseriti messaggi e-mail validi, gli utenti rimangono in stato di attesa. Segui Verifica provisioning utente con e-mail non attendibili per eliminare gli utenti.
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Hybrid, nella sezione BroadWorks Calling elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera collegare Webex per BroadWorks al cliente, seguire i processi di provisioning per collegarlo a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API Rimuovi abbonato BroadWorks è quella di accedere a BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati. |
Gestione di utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente sono in BroadWorks. Un'identità e-mail distinta per l'utente e le relative licenze per le funzioni Webex vengono conservate in Webex.
Verifica del provisioning utenti con indirizzi e-mail non attendibili
Se si sta eseguendo il provisioning di utenti Webex per BroadWorks utilizzando il provisioning flow-through con e-mail non attendibili, gli utenti devono eseguire il provisioning automaticamente inserendo il relativo indirizzo e-mail nel portale di attivazione utente. Se l'utente riscontra un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riscontra nuovamente l'errore, l'amministratore può utilizzare i passaggi seguenti in Partner Hub per esaminare lo stato e caricare l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 | Accedere a Partner Hub e trovare la pagina Elenco clienti. |
2 | Fare clic su Visualizza modelli. Selezionare il modello di onboarding appropriato che si desidera applicare a questo utente. |
3 | In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con e-mail non attendibili sia configurato correttamente:
|
4 | In seguito al provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato del provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo stato corrente, che mostra se l'utente è predisposto o se è presente un requisito in sospeso.
|
5 | Per gli utenti con errori o requisiti in sospeso, fare clic sui tre punti a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili quando si visualizza l'elenco degli utenti:
Esporta: fare clic su questo pulsante se si desidera esportare l'elenco utenti in un file CSV.
Escludi utenti predisposti: abilita questo tasto di alternanza se desideri visualizzare solo gli utenti con requisiti o errori in sospeso.
Modifica ID utente o indirizzo e-mail
Modifiche a ID utente e indirizzo e-mail
L'ID e-mail e l'ID alternativo sono gli attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. La tabella seguente descrive gli scopi di questi diversi attributi e cosa fare se occorre cambiarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non puoi modificare questo identificativo e comunque collegare l'utente allo stesso account in Webex. È possibile eliminare l'utente e ricreare se non è corretto. |
ID e-mail | ID utente | Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si afferma che l'e-mail è attendibile Non richiesto in BroadWorks se non si asserisce di poter considerare attendibili i messaggi e-mail Non richiesto in BroadWorks se consenti agli abbonati di autoattivarsi | È presente un processo manuale per modificare questa opzione in entrambe le posizioni se all'utente è stato eseguito il provisioning con l'indirizzo e-mail errato:
Non modificare l'ID utente BroadWorks. Questa operazione non è supportata. |
ID alternativo | Nessuno | Consente di abilitare l'autenticazione dell'utente per e-mail e password rispetto all'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se Non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti dovranno inserire il proprio ID utente BroadWorks durante l'autenticazione. |
Modifica pacchetto utenti in Partner Hub
1 | Accedi a Partner Hub e fai clic su Clienti. |
2 | Individuare e selezionare l'organizzazione del cliente a cui è assegnato l'utente. Viene visualizzata la pagina di panoramica dell'organizzazione in un pannello a destra dello schermo. |
3 | Fare clic su Visualizza cliente. L'organizzazione del cliente si apre in Control Hub, mostrando la pagina Panoramica.
|
4 | Fare clic su Utenti, quindi individuare e fare clic sull'utente interessato. |
5 | Nei Servizi dell'utente, fare clic su Webex per i pacchetti BroadWorks (Abbonamenti). Si apre il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 | Nella scheda Profilo, cercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 | Seleziona il pacchetto che desideri per questo utente (Base, Standard, Premium o Softphone) e fai clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 | Puoi chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium hanno siti di riunione distinti associati a ciascun pacchetto. Quando un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato viene visualizzato con due siti di riunione in Control Hub. Le funzionalità di riunione organizzatore e il sito della riunione dell'abbonato vengono allineati al pacchetto corrente. Il sito della riunione del pacchetto precedente e qualsiasi contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili all'amministratore del sito della riunione. |
Potrebbero essere necessarie da due a tre ore per le nuove impostazioni PMR derivanti da una modifica del pacchetto da aggiornare. |
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si desidera eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto alcun trasferimento automatico del ruolo di amministratore nel caso in cui venga eliminato l'ultimo amministratore. |
API Cisco BroadWorks per Webex
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
Eseguire la richiesta API Remove a BroadWorks Subscriber su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento Webex per Cisco BroadWorks. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
Eseguire la richiesta Elimina una persona API su https://developer.webex.com/docs/api/v1/people/delete-a-person per eliminare completamente l'utente.
Provisioning flow-through
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – IM&P integrato in BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks - Parte 2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento Webex per Cisco BroadWorks dall'utente. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla propria organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 | Usa le API Persone per eliminare tutti gli utenti dall'organizzazione:
| ||
2 | Se la sincronizzazione rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione rubriche tramite Partner Hub: Per disabilitare la sincronizzazione rubriche tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API aziendale BroadWorks e disabilita l'impostazione enableDirSync. Tutti gli utenti correlati alla sincronizzazione rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione degli utenti (utilizzando entrambi i metodi) può richiedere del tempo a seconda della quantità di utenti. | ||
3 | Una volta rimossi tutti gli utenti, utilizza l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Annullamento di un abbonamento da Control Hub
Poiché l'API è privata, i clienti non avranno accesso ad essa. Al contrario, le seguenti operazioni mostrano come i clienti possono annullare il proprio abbonamento da Control Hub:
L'amministratore del partner può passare alla pagina dei servizi "Hybrid" sul Control Hub del cliente.
Individua la scheda "BroadWorks Calling".
Una volta eseguito il provisioning di tutti gli utenti da Webex per BroadWorks per tale cliente, il partner deve visualizzare un pulsante "Cancella configurazione" (ad esempio, eliminare la customer_config voce in BPB).
Gestione delle release
I controlli di gestione delle release in Partner Hub consentono a Webex per i provider di servizi Cisco BroadWorks di gestire facilmente le release consentendo loro di controllare la cadenza di rilascio in base alla quale le app Webex degli utenti vengono aggiornate all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza gli aggiornamenti automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
Configurazione di pianificazioni di rilascio personalizzate con rinvii dalla pianificazione di rilascio predefinita Cisco
Configurare una singola pianificazione della release e trasferirla a cascata a tutte le organizzazioni dei clienti che gestiscono
Assegna diverse pianificazioni di rilascio a diverse organizzazioni di clienti
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di rilascio personalizzate, vedere l'articolo Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
Aggiunta di un cluster BroadWorks in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
Aggiunta di un modello di onboarding in Partner Hub
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | ||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | ||
3 | Fare clic su Visualizza cluster. | ||
4 | Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro flyout a destra.
| ||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | |||||||||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | |||||||||
3 | Fare clic su Visualizza modelli. | |||||||||
4 | Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere a Webex Assistant di seguire le azioni, prendere nota di decisioni importanti ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant per Meetings è disponibile gratuitamente per i siti per riunioni con pacchetto Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilitazione di Webex Assistant per Meetings
Webex Assistant è abilitato per impostazione predefinita per i clienti Broadworks con pacchetto standard e premium.
Gli amministratori dei partner e gli amministratori delle organizzazioni dei clienti possono disabilitare la funzione per le organizzazioni dei clienti tramite Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
Il supporto è limitato ai siti per riunioni con pacchetto Premium e Standard e solo alle sale riunioni personali.
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
La condivisione di contenuto tramite e-mail è accessibile solo dagli utenti all'interno della tua organizzazione
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Il contenuto della riunione non è accessibile anche se condiviso tra utenti di pacchetti diversi dall'interno della stessa organizzazione.
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile, pertanto le trascrizioni post-riunione non sono disponibili se Webex Assistant è abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni utente su come utilizzare la funzione, vedere Uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
Webex Calling gratuito è abilitato per impostazione predefinita consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, che disabilita tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzione
Se Webex Calling è disabilitato, le seguenti condizioni si applicano a Webex per gli utenti Cisco BroadWorks:
Gli utenti non visualizzano più Chiamata con Webex come opzione di chiamata selezionabile sull'app Webex.
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, la cronologia chiamate, i contatti, inserendo l'URI dell'altro utente o l'indirizzo e-mail nella barra di ricerca.
Condivisione schermo all'interno di una chiamata BroadWorks.
Le riunioni Webex e la presenza in telefonia funzionano ancora, anche se le chiamate Webex sono disabilitate.
Disabilita chiamate Webex (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno di Aggiungi un nuovo modello guidata. Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti assegnate al modello.
Per informazioni dettagliate sulla configurazione di un nuovo modello di onboarding, vedere Configurazione dell'organizzazione partner in Partner Hub.
Disabilita chiamate Webex (modello di onboarding esistente)
Seguire questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
Accedere a Partner Hub all'indirizzo admin.webex.com.
Scegliere Impostazioni.
Fare clic su Visualizza modello e scegliere il modello di inserimento appropriato.
Fai clic su Disabilita chiamata gratuita Cisco Webex.
Fai clic su Salva.
Disabilita chiamate Webex (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare Webex Calls per un utente esistente, è possibile seguire una delle procedure seguenti per aggiornare l'utente.
Accertarsi di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigura l'utente con le chiamate Webex abilitate. |
Se si utilizza il provisioning flow-through, è possibile effettuare le seguenti operazioni:
Aprire CommPilot e passare alla configurazione utente.
Rimuovere il servizio Integrated IM+P dall'utente e fare clic su OK.
Aggiungere il servizio Integrated IM+P all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
Utilizzare Remove a BroadWorks Subscriber API per eliminare l'utente.
Utilizzare la Provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione della condivisione video o dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per informazioni dettagliate sulla configurazione e le opzioni complete, vedere Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è anche possibile configurare se il contenuto multimediale delle chiamate in ingresso utilizza per impostazione predefinita solo il video o l'audio. |
Indicatore di stato della linea / Notifica risposta per assente
L'indicatore di stato/notifica di risposta per assente utilizza le funzioni di risposta per assente indirizzata. Un utente con indicatore di stato riceve una notifica audio e visiva sull'app Webex quando un utente dell'elenco di indicatori di stato monitorato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può Ignorare o Rispondere alla chiamata dell'utente monitorato.
La notifica dell'indicatore di stato/risposta per assente consente di rispondere alle chiamate di altri membri del team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra chiamata multipla - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza dei membri del team Webex e non Webex. Per informazioni sull'abilitazione della chiamata multipla, vedere: Finestra multi-chiamata
I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati nella rubrica in Webex e avranno solo stati "sconosciuti" e "in chiamata" (lo stato suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
La presenza non è supportata per gli utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
Gli utenti CI senza autorizzazione cloud Webex o tipo di account macchina (spazi di lavoro) visualizzano solo la presenza "in chiamata" e "sconosciuta". Nessun stato attivo, suoneria, ecc.
Gli utenti non Webex dall'elenco di indicatori di stato, che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza "sconosciuta".
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
Se un utente non Webex dell'indicatore di stato detiene una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate su BroadWorks. Installare solo le patch valide per la versione in uso:
Per R22:
Piattaforma AP.22.0.1123.ap382053
AP.as.22.0.1123.ap382053
AP.as.22.0.1123.ap382362
AP.xsp.22.0.1123.ap382053
AP.xsp.22.0.1123.ap382362
AP.as.22.0.1123.ap383459
AP.as.22.0.1123.ap383520
Per R23:
Piattaforma AP.23.0.1075.ap382053
AP.as.23.0.1075.ap382053
AP.as.23.0.1075.ap382362
AP.as.23.0.1075.ap383459
AP.as.23.0.1075.ap383520
Se si utilizza XSP|ADP:
AP.xsp.23.0.1075.ap382053
AP.xsp.23.0.1075.ap382362
Se si utilizza ADP:
Xsi-Actions-23_2022.01_1.200.bwar
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
Per R24:
AP.as.24.0.944.ap382053
AP.as.24.0.944.ap382362
AP.as.24.0.944.ap383459
AP.as.24.0.944. ap383520
Xsi-Actions-24_2022.01_1.200.bwar
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
<busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare la funzione 101642 Enhanced Xsi Mechanism Per la telefonia del team su AS:
AS_CLI/System/ActivatableFeature> activate 101642
Abilita X-BroadWorks-Remote-Party-Info
in AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamata SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Accertarsi che i seguenti servizi siano assegnati agli utenti:
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP. |
Configurazione dell'indicatore di stato della linea su BroadWorks
Gli amministratori dei partner possono utilizzare la seguente procedura per impostare l'indicatore di stato della linea per un utente.
Accedere a BroadWorks CommPilot.
Per un utente selezionato, accedere ad Applicazioni client e configurare l'indicatore di stato della linea.
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
Utilizzare i parametri di ricerca per individuare e aggiungere utenti all'elenco Utenti monitorati.
Fai clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento di coinvolgimento del pubblico facile da usare. Consente alle persone di ottenere il massimo dalle riunioni colmando la distanza tra oratori e pubblico. Quando Slido è integrato nell'organizzazione Control Hub, gli utenti possono aggiungere l'Slido app alle riunioni nell'app Webex. Questa integrazione offre ulteriori funzionalità di Q&A e sondaggio alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando è stata accettata una riunione nel client Outlook che corrisponde a un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che hai assunto un impegno diverso e che la risposta potrebbe essere ritardata.
Per abilitare questa funzione:
andare alla scheda Generale della scheda Impostazioni su Windows o Preferenze su Mac.
Selezionare la casella per Mostra in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, "In una riunione di calendario" in Webex è associato a "Occupato" in Outlook. |
Avvertenza
Per utilizzare questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come funziona altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la sua presenza non verrà aggiornata fino al termine della riunione. A tale scopo, sarà necessario riavviare il client per rispondere.
Risposta automatica con tono
Con la risposta automatica con tono, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul desktop. Quando l'app Webex squilla sull'altra parte, l'utente sente un determinato segnale acustico che indica che la chiamata è in connessione.
Per utilizzare questa funzione per un utente Webex per Cisco BroadWorks:
La funzione è supportata solo sull'aspetto della linea principale
L'app Webex deve essere l'identificativo di linea principale
Il tag %ENABLE_AUTO_ANSWER_WXT% deve essere abilitato
Se l'utente dispone anche di indicatori di chiamata condivisa (ad esempio, un telefono da tavolo è configurato come uno degli indicatori di linea secondaria), la funzione è ancora supportata sull'aspetto principale, a condizione che gli indicatori di chiamata condivisa siano configurati per non ricevere chiamate in arrivo. Per effettuare questa operazione, è possibile configurare una delle tre condizioni seguenti su BroadWorks per tutte le chiamate condivise:
Avvisa tutti gli aspetti delle chiamate con clic è disabilitato nella configurazione dell'aspetto chiamata condivisa: questo è l'approccio consigliato
o
Consenti terminazione a questa posizione deve essere disabilitato per tutte le chiamate condivise o
o
Posizioni disabilitate per tutti gli indicatori di chiamata condivisi
Aumentare la capacità
Aziende agricole XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare quante risorse XSP|ADP aggiuntive sono necessarie per l'aumento proposto dei numeri di abbonati. Per le aziende NPS dedicate o Webex dedicato per le aziende Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
Fattoria dedicata in scala: Aggiungere uno o più server XSP|ADP all'azienda che ha bisogno di capacità extra. Installare e attivare lo stesso set di applicazioni e configurazioni dei nodi esistenti dell'azienda agricola.
Aggiungi azienda agricola dedicata: Aggiungi una nuova fattoria XSP|ADP dedicata. Dovrai creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti nella nuova fattoria, per ridurre la pressione sulla fattoria esistente.
Aggiungere azienda agricola specializzata: Se si verificano strozzature per un particolare servizio, è possibile creare un'azienda agricola ADP|XSP separata a tale scopo, tenendo conto dei requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster di Control Hub e le voci DNS se si modifica l'URL del servizio con una nuova azienda agricola.
In tutti i casi, è tua responsabilità monitorare e assegnare risorse all’ambiente BroadWorks. Se si desidera contattare l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare i servizi professionali.
Gestione dei certificati del server HTTP
È necessario gestire questi certificati per le applicazioni Web autenticate mTLS su XSP|ADP:
La nostra catena di certificati di attendibilità dal cloud Webex
Certificati delle interfacce del server HTTP di XSP|ADP
Catena di fiducia
È possibile scaricare la catena del certificato di attendibilità da Control Hub e installarlo sugli ADP|XSP durante la configurazione iniziale. Prevediamo di aggiornare il certificato prima della scadenza e di informarvi su come e quando modificarlo.
Interfacce del server HTTP
L'|ADP XSP deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Certificati ordine. Quando si protegge l'interfaccia, viene generato un certificato autofirmato per l'interfaccia. Questo certificato è valido per un anno da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione di Partner Hub che gli amministratori dei partner possono assegnare a organizzazioni di clienti specifiche per limitare le impostazioni dell'organizzazione che gli amministratori dei clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione del cliente, tutti gli amministratori del cliente di tale organizzazione, indipendentemente dalle autorizzazioni dei ruoli, non sono in grado di accedere a un set di controlli con limitazioni in Control Hub. Solo un amministratore partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner esiste un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita le autorizzazioni di ruolo specifiche per gli amministratori dei clienti nell'organizzazione a cui è applicata l'impostazione. |
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità con limitazioni per partner. Dopo l'accesso, vedrà un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner notifica all'amministratore del cliente che la Modalità con limitazioni è abilitata e che l'amministratore potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore del cliente in un'organizzazione in cui con limitazioni della modalità partner è abilitata, il livello di accesso di Control Hub è determinato con la formula seguente:
(Accesso a Control Hub) = (Entitlements Role Organization) - (Limitato dalle limitazioni della modalità partner)
Limitazioni
Quando è abilitata la modalità con limitazioni per partner per un'organizzazione del cliente, gli amministratori dei clienti di tale organizzazione non possono accedere alle seguenti impostazioni di Control Hub:
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
Pulsante Gestisci utenti: disattivato.
Aggiungi o modifica manualmente utenti: nessuna opzione per aggiungere o modificare gli utenti, né manualmente né tramite CSV.
Richiedi utenti: non disponibile
Assegna automaticamente licenze: non disponibile
Sincronizzazione rubriche —Impossibile modificare le impostazioni di sincronizzazione delle rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato ed e-mail principale* sono modificabili.
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, messaggi, riunioni, chiamate)
Visualizza stato servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
Numero di lavoro principale: questo campo è di sola lettura.
Nella vista Account, non sono disponibili le seguenti impostazioni:
Nome società: campo di sola lettura.
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
Dominio: accesso di sola lettura.
E-mail: le impostazioni Elimina inviti e-mail di amministrazione e Selezione impostazioni internazionali e-mail sono di sola lettura.
Autenticazione: nessuna opzione per la modifica delle impostazioni di autenticazione e SSO.
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
Impostazioni chiamata: le impostazioni di priorità della chiamata delle opzioni dell'app sono di sola lettura.
Funzionamento chiamata: le impostazioni sono di sola lettura.
Posizione > PSTN: le opzioni Gateway locale e Cisco PSTN sono nascoste.
Sotto SERVIZI, le opzioni di servizio Migrazioni e Connected UC vengono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori partner possono utilizzare la procedura seguente per l'abilitazione Con limitazioni della modalità partner per una determinata organizzazione cliente (l' impostazione predefinita è abilitata).
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
Seleziona l'organizzazione cliente applicabile.
Nella vista Impostazioni di destra, abilitare il Con limitazioni della modalità partner per attivare l'impostazione.
Se si desidera disattivare la modalità Con limitazioni per partner, disabilitare l'interruttore.
Se il partner rimuove la modalità amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà eseguire quanto segue:
|
Analisi dei partner
I miglioramenti di Control Hub consentono agli amministratori partner di visualizzare e aggiornare facilmente le informazioni sui pacchetti per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata di tutti i clienti e include i seguenti dettagli:
Utenti totali per pacchetto (Softphone, Base, Standard, Premium)
Tendenza utenti per pacchetto (giornaliero/settimanale/mensile)
Clienti con n. di pacchetti assegnati
Per informazioni dettagliate su come utilizzare Analisi dei partner, vedere l'articolo Webex Analisi per i pacchetti Webex per la vendita all'ingrosso e Webex per BroadWorks in Partner Hub .
API di report fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare report di fatturazione. Nella tabella seguente vengono elencate le API, il tipo di accesso richiesto e i requisiti di ruolo.
API di fatturazione | Scopo | Tipo di accesso | Requisiti di ruolo per API (L'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Creazione di un report di fatturazione BroadWorks | Utilizzato per generare un report di fatturazione. | Accesso in scrittura |
|
Elenca report di fatturazione BroadWorks | Consente di elencare i report disponibili per la visualizzazione. | Accesso in lettura |
|
Ottenere un report di fatturazione BroadWorks | Utilizzato per ottenere una copia di un report generato. | Accesso in lettura |
|
Eliminazione di un report di fatturazione BroadWorks | Utilizzato per eliminare un report generato. | Accesso scrittura |
|
Campi di fatturazione
Nella tabella seguente sono elencati i campi contenuti nel report generato.
Campo | Descrizione |
---|---|
nome rivenditore | Nome partner o ID organizzazione partner |
ID fatturazione | Identificativo di fatturazione univoco del partner o numero C |
IdImpresaSp | L'identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno | Stato versione di prova interna del cliente (Sì/No) |
ID utente | IDutente dell'abbonato su BroadWorks |
id abbonato | Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato | Sì/No |
Data iniziale | Data di provisioning dell'abbonato. |
dataInizioFatturazione | Data di inizio fatturazione in questo mese |
DataFineFatturazione | Data di fine fatturazione in questo mese |
pacchetto | Il tipo di confezione che viene caricata |
quantità | Quantità ripartita per fatturazione.
|
|
Risoluzione dei problemi di Webex per Cisco BroadWorks
Abbonamento alla pagina di stato Webex
Innanzitutto verificare https://status.webex.com quando si verifica un'interruzione imprevista del servizio. Se non hai modificato la tua configurazione in Control Hub o BroadWorks prima dell'interruzione, controlla la pagina di stato. Ulteriori informazioni sull'iscrizione per le notifiche di stato e incidenti al Centro assistenza Webex.
Usa analisi Control Hub
Webex monitora l'utilizzo e i dati di qualità per la tua organizzazione e le organizzazioni dei tuoi clienti. Ulteriori informazioni sulle analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
Clienti o utenti non vengono creati in Control Hub con provisioning flowthrough:
Il server applicazioni può raggiungere l'URL di provisioning?
L'account di provisioning e la password sono corretti? Tale account esiste in BroadWorks?
I cluster non riescono in modo coerente a eseguire i test di connettività:
La connessione mTLS al servizio di autenticazione non riesce quando si crea il primo cluster in Partner Hub, poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. In caso contrario, non è possibile creare un'ancora attendibile sul servizio di autenticazione XSP|ADPs, pertanto la connessione mTLS di prova da Partner Hub non viene eseguita correttamente. |
Le interfacce XSP|ADP sono accessibili pubblicamente?
Stai utilizzando le porte corrette? È possibile immettere una porta nella definizione dell'interfaccia sul cluster.
Convalida non riuscita interfacce
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Esaminare i consigli per la configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Rivedere i consigli sulla configurazione dell'interfaccia in questo documento, con particolare attenzione a:
- Accertarsi di aver condiviso le chiavi RSA tra tutti gli XSP|ADP.
- Accertarsi di aver fornito l'URL AuthService al contenitore Web su tutti gli XSP|ADP.
- Se è stata modificata la configurazione della crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'|ADP XSP richiede di immettere il formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento elencava erroneamente le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati sul proprio archivio attendibile XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere i certificati del client?
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere i certificati del client?
Problemi del cliente
Verificare che il client sia connesso a BroadWorks
Accedere all'app Webex.
Verificare che l'icona Opzioni di chiamata (un ricevitore con una marcia sopra) sia presente sulla barra laterale.
Se l'icona non è presente, l'utente potrebbe non essere ancora abilitato per il servizio di chiamata in Control Hub.
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici . Viene visualizzato lo stato Sessione SSO A cui è stato eseguito l'accesso.
Se viene visualizzato un servizio telefonico diverso, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Tale verifica comporta:
Il client ha eseguito correttamente il transveresed dei microservizi Webex richiesti.
Autenticazione dell'utente eseguita correttamente.
Il client ha ricevuto un token Web JSON di lunga durata dal sistema BroadWorks.
Il client ha recuperato il proprio profilo dispositivo e si è registrato su BroadWorks.
Registri client
Tutti i client dell'app Webex possono Inviare I Registri a Webex. Questa è l'opzione migliore per i client mobili. È inoltre necessario registrare l'indirizzo e-mail dell'utente e l'ora approssimativa in cui si è verificato il problema se si sta cercando assistenza da TAC. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se è necessario raccogliere manualmente i registri da un PC Windows, si trovano come segue:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac:/Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS configurata male
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
Verificare che la catena di certificati Webex sia installata come ancora affidabile.
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e firmato da una CA ben nota.
Messaggio di eccedenza licenza
Questo messaggio può apparire per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'utilizzo delle licenze supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Politica di supporto allo stato stazionario
Il provider di servizi è il primo punto di contatto per il supporto del cliente finale (aziendale). Inoltrare i problemi che il SP non è in grado di risolvere al centro TAC. Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Politica di escalation
Tu (provider di servizi/partner) sei il primo punto di contatto per il supporto clienti finali (aziendale).
I problemi che non possono essere risolti dal SP vengono inoltrati al centro TAC.
Versioni di BroadWorks
Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Risorse di autosupporto
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, dove è presente una pagina specifica di Webex per Cisco BroadWorks che elenca argomenti di Guida e supporto comuni dell'app Webex.
L'app Webex può essere personalizzata con questo URL della Guida e un URL di segnalazione problemi.
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I registri vengono inviati al cloud Webex, dove possono essere analizzati da Webex DevOps.
È disponibile anche una pagina Centro assistenza dedicata alla Guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccogliere informazioni per l'invio di una richiesta di assistenza
Quando vengono visualizzati errori in Control Hub, potrebbero essere allegate informazioni che possono aiutare TAC a indagare sul problema. Ad esempio, se viene visualizzato un ID di verifica per un particolare errore o un codice di errore, salvare il testo da condividere con noi.
Prova a includere almeno le seguenti informazioni quando invii una query o apri un caso:
ID organizzazione cliente e ID organizzazione partner (ogni ID è una stringa di 32 cifre esadecimali, separate da trattini)
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce uno
Indirizzo e-mail utente (se un particolare utente riscontra problemi)
Versioni del cliente (se il problema presenta sintomi notati attraverso il cliente)
Confronto UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > | SaaS UC-One | Webex per Cisco BroadWorks |
---|---|---|
Cloud | Cisco UC-One Cloud (GCP) | Webex Cloud (AWS) |
Client | UC-One: Mobile, desktop Receptionist, Supervisore | Webex: Mobile, desktop, Web |
Principale differenza tecnologica | Riunioni condotte sulla tecnologia BroadSoft Meet | Riunioni fornite sulla tecnologia Webex Meetings |
Prove sul campo iniziali | Contesto di stadiazione, clienti beta | Ambiente di produzione, clienti GA |
Identità utente | ID BroadWorks servito come ID principale, a meno che il provider di servizi non disponga già dell'integrazione SSO.
ID utente e segreto in BroadWorks | ID e-mail in Cisco CI serve come ID principale Integrazione SSO in BroadWorks provider di servizi in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks al momento.
L'utente fornisce le credenziali tramite SSO con BroadWorks e Secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e segreti in IdP |
Autenticazione client | Gli utenti forniscono le credenziali attraverso il client Token di lunga durata BroadWorks richiesti se si utilizza la messaggistica Webex | Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso a Webex e aggiornamento dei token |
Gestione / configurazione | I vostri sistemi OSS/BSS e Portale rivenditore | I tuoi sistemi OSS/BSS e Control Hub |
Attivazione partner/provider di servizi | Impostazione una tantum da Cisco Operations | Impostazione una tantum da Cisco Operations |
Attivazione cliente/azienda | Portale rivenditore | Control Hub Creato automaticamente alla prima iscrizione utente |
Opzioni di attivazione utente | Autoiscrizione Imposta IM&P esterno in BroadWorks
| Impostazione di IM&P integrato in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP | Azioni XSI
XSI-Eventi CTI (mTLS) AuthService (mTLS opzionale) DMS | Azioni XSI Azioni XSI (mTLS) XSI-Eventi CTI (mTLS) Servizio di autenticazione (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 | Scarica e installa Webex. Per informazioni dettagliate, vedi Webex | Download dell'app. |
2 | Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 | Inserisci l'indirizzo e-mail e fai clic su Avanti. |
4 | Una delle seguenti operazioni si verifica, a seconda del modo in cui l'organizzazione è configurata in Webex: Webex si carica dopo aver eseguito correttamente l'autenticazione su IdP o BroadWorks.
|
Scambio e archiviazione dati
Queste sezioni forniscono dettagli sullo scambio e la memorizzazione dei dati con Webex. Tutti i dati vengono crittografati sia in transito che a riposo. Per ulteriori informazioni, vedi Webex App Security.
Onboarding provider servizi
Quando si configurano cluster e modelli utente in Webex Control Hub durante l'onboarding di provider di servizi, è possibile scambiare i seguenti dati BroadWorks memorizzati in Webex:
URL Xsi-Actions
URL Xsi-Events
URL interfaccia CTI
URL servizio di autenticazione
Credenziali adattatore di provisioning BroadWorks
Provisioning utente provider di servizi
Questa tabella elenca i dati utente e aziendale che vengono scambiati come parte del provisioning utente attraverso le API Webex.
Trasferimento dei dati in Webex | Da | Attraverso | Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito da SP) | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito dall’utente) | Utente | Portale di attivazione utente | Sì |
Nome | BroadWorks, per API | API Webex | Sì |
Cognome | BroadWorks, per API | API Webex | Sì |
Numero di telefono principale | BroadWorks, per API | API Webex | Sì |
Numero telefono cellulare | BroadWorks, per API | API Webex | Sì |
Estensione principale | BroadWorks, per API | API Webex | Sì |
ID provider di servizi BroadWorks e ID gruppo | BroadWorks, per API | API Webex | Sì |
Lingua | BroadWorks, per API | API Webex | Sì |
Fuso orario | BroadWorks, per API | API Webex | Sì |
Rimozione utente
Le API Webex per Cisco BroadWorks supportano la rimozione parziale e completa dell'utente. Questa tabella elenca tutti i dati utente memorizzati durante il provisioning e ciò che viene eliminato in ogni scenario.
Dati utente | Eliminazione parziale | Eliminazione completa |
---|---|---|
ID utente BroadWorks | Sì | Sì |
No | Sì | |
Nome | No | Sì |
Cognome | No | Sì |
Numero di telefono principale | Sì | Sì |
Numero telefono cellulare | Sì | Sì |
Estensione | Sì | Sì |
ID provider di servizi BroadWorks e ID gruppo | Sì | Sì |
Lingua | No | Sì |
Accesso utente e recupero configurazione
Autenticazione Webex
L'autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da uno qualsiasi dei meccanismi di autenticazione del supporto Webex. (L'autenticazione BroadWorks è trattata separatamente.) Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (indipendente) | Webex | Browser utente |
Credenziali utente | Browser utente | Provider identità (che dispone già di identità utente) |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Autenticazione BroadWorks
L'autenticazione BroadWorks si riferisce all'accesso dell'utente a un'app Webex utilizzando le credenziali BroadWorks. Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (proxy Webex Bwks IdP) | Webex | Browser utente |
Informazioni sul branding e URL BroadWorks | Webex | Browser utente |
Credenziali utente BroadWorks | Utente tramite browser (pagina di accesso con marchio servita da Webex) | Webex |
Credenziali utente BroadWorks | Webex | BroadWorks |
Profilo utente BroadWorks | BroadWorks | Webex |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento dell'avviso di accesso e del messaggio di errore:
- Attualmente gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso poiché la password è già scaduta. Con questa funzione, se la password sta per scadere tra 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere, con l'indicazione di quanti giorni rimangono, e all'utente viene consigliato di contattare il partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su true, è stato emesso l'errore "nome utente e password errati", ma ora con questa funzione viene migliorato il messaggio di errore: Tentativo di accesso non riuscito. La combinazione di ID utente e password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice errore 100006
Controllo flusso di accesso:
- Il partner può limitare l'accesso abilitando un'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione in broadworks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, quindi viene visualizzato un errore che indica che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso può essere configurato dal partner come parte della funzione di personalizzazione avanzata. I partner solitamente configurano il collegamento per passare dall'utente a un portale partner per la gestione della password e la reimpostazione della password.
Questa funzione migliora l'esperienza di accesso utente solo durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se una password scade mentre l'utente è connesso all'app Webex. L'utente riceve la notifica di scadenza della password al successivo tentativo di accesso. |
Recupero configurazione cliente
Questa tabella illustra la tipologia di dati scambiati tra le diverse componenti in fase di recupero delle configurazioni del cliente.
Trasferimento dei dati | Da | Per |
---|---|---|
Iscrizione | Client | Webex |
Impostazioni organizzazione, inclusi URL BroadWorks | Webex | Client |
Token JWT BroadWorks | BroadWorks attraverso Webex | Client |
Token JWT BroadWorks | Client | BroadWorks |
Token dispositivo | BroadWorks | Client |
Token dispositivo | Client | BroadWorks |
File di configurazione | BroadWorks | Client |
Utilizzo allo stato stazionario
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione dopo la scadenza del token, tramite BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Trasferimento dei dati | Da | Per |
---|---|---|
Segnalazione SIP | Client | BroadWorks |
Supporto SRTP | Client | BroadWorks |
Segnalazione SIP | BroadWorks | Client |
Supporto SRTP | BroadWorks | Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Trasferimento dei dati | Da | Per |
---|---|---|
Messaggistica e presenza REST HTTPS | Client | Webex |
Messaggistica e presenza REST HTTPS | Webex | Client |
Segnalazione SIP | Client | Webex |
Supporto SRTP | Client | Webex |
Segnalazione SIP | Webex | Client |
Supporto SRTP | Webex | Client |
Uso dell'API di provisioning
Accesso sviluppatore
Le specifiche API sono disponibili su https://developer.webex.com e una guida all'uso è disponibile su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l' accedere per leggere la specifica API all'indirizzohttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Autenticazione e autorizzazione applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (ad esempio provisioning abbonato) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere l'aggiornamento e l'accesso ai token per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
Devi prima registrare la tua integrazione con Webex. Una volta eseguita la registrazione, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di accesso e aggiornamento necessari.
Per ulteriori dettagli sulle integrazioni e sulle modalità di creazione di questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli obbligatori per l'implementazione delle integrazioni: sviluppatore e utente autorizzatore, che possono essere svolti da persone/team separati nel proprio ambiente.
|
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning utilizzata:
Modalità Enterprise: il nome dell'organizzazione corrisponde esattamente a spEnterpriseId.
Modalità provider di servizi: il nome dell'organizzazione è la parte groupID di spEnterpriseId.
Il nome dell'organizzazione conterrà qualsiasi spazio vuoto, maiuscolo e caratteri speciali specificati in spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "attuale" con le ultime patch BroadWorks e le app Release Independent (RI). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Assicurarsi di rivedere le note di patch per queste patch software. Alcune patch potrebbero avere requisiti CLI aggiuntivi. |
Versione R22
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | ||
Richiesto per sincronizzazione rubrica | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per il server applicazioni | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per la funzione di registrazione chiamata | ||
Patch richiesta per il provisioning flow-through | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | Richiesto per proxy autenticazione NPS | |
Richiesto per il servizio di autenticazione con convalida token CI | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Obbligatorio per la cronologia chiamate unificata | ||
Altro | AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Richiesto per sincronizzazione rubrica | |
Configurazione server app | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Se si utilizza ADP... | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Versione R24
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per il provisioning flowthrough | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che è necessario configurare per Webex, fare riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utente e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. L'attivazione include la convalida e-mail e l'assegnazione del servizio in Webex. |
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se disponi di indirizzi e-mail affidabili per gli utenti, puoi scegliere di attivarli automaticamente quando esegui il provisioning automatico degli utenti. Questo processo è "provisioning automatico e attivazione automatica".
Provisioning utente automatizzato e attivazione automatica (flusso e-mail affidabile)
Prerequisiti
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase | Descrizione |
---|---|
1 | Citare e prendere ordini per il servizio con i clienti. |
2 | Si elabora l'ordine del cliente e si esegue il provisioning del cliente nei sistemi. |
3 | Il sistema di provisioning dei servizi attiva il provisioning di BroadWorks. Questo passaggio, in sintesi, crea l'azienda e gli utenti. Quindi assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM&P esterno. |
4 | Questo passaggio di provisioning attiva il provisioning automatico dell'organizzazione cliente e degli utenti in Webex. (L'assegnazione del servizio IM&P determina che l'adattatore di provisioning chiami l'API di provisioning Webex). |
5 | I sistemi devono utilizzare l'API di provisioning Webex se successivamente è necessario regolare il pacchetto per l'utente (per passare dall'impostazione predefinita). |
Flusso di accesso SSO
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, che consente l'autenticazione diretta a BroadWorks. L'immagine mostra gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresenta ciò che il client prevede per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizio BroadWorks che segue immediatamente il flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione BroadWorks diretta abilitata (condivisione risorse cross-origin). Di seguito sono riportati alcuni flussi di accesso SSO SAML alternativi:
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
L'unica differenza è nei punti 5 e 6 del flusso di accesso Webex. Nel passaggio 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
Il flusso procede attraverso i restanti passaggi dei due diagrammi.
Il token SSO non viene utilizzato in questo flusso.
Autenticazione SSO SAML Webex:
Nel passaggio 3 del flusso di accesso Webex, il servizio Common Identity restituisce il provider di identità utilizzato dall'autenticazione Webex.
A questo punto, viene invocato un flusso di accesso SSO SAML alternativo per Webex.
Interazioni utente
Accedi
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
CI rileva che l'organizzazione cliente associata dispone del proxy IDP BroadWorks (IDP) configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso (il provider di servizi può contrassegnare questa pagina di accesso).
L'utente inserisce le credenziali BroadWorks.
Broadworks esegue l'autenticazione dell'utente attraverso l'IDP. In caso di successo, l'IDP reindirizza il browser a CI con un SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
Una volta completata l'autenticazione, l'app Webex ottiene i token di accesso da CI (non mostrati nel diagramma). Il client li utilizza per richiedere un token Web Jason (JWT) di lunga durata BroadWorks.
L'app Webex rileva la configurazione di chiamata da BroadWorks e altri servizi da Webex.
L'app Webex si registra in BroadWorks.
Accesso dalla prospettiva dell'utente
Questo diagramma è il tipico flusso di accesso, visualizzato dall'utente finale o dall'abbonato:
Scarica e installa l'app Webex.
È possibile che tu abbia ricevuto il collegamento dal provider di servizi o che tu possa trovare il download nella pagina di download di Webex.
Inserire l'indirizzo e-mail nella schermata di accesso Webex. Fai clic su Avanti.
Solitamente, si viene reindirizzati a una pagina con il marchio del fornitore di servizi.
Questa pagina potrebbe accogliervi tramite il vostro indirizzo e-mail.
Se non è presente alcun indirizzo e-mail o se l'indirizzo e-mail è errato, inserisci il nome utente BroadWorks.
Inserisci la password BroadWorks.
Se è stato eseguito correttamente l'accesso, Webex si apre.
Flusso chiamate - Rubrica aziendale
Flusso chiamata: numero PSTN
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni con i clienti
Recupero del profilo dal registro DMS e SIP con AS
Il client chiama XSI per ottenere un token di gestione dispositivo e l'URL del DMS.
Il client richiede il proprio profilo dispositivo dal DMS presentando il token dal punto 1.
Il client legge il profilo del dispositivo e recupera le credenziali, gli indirizzi e le porte SIP.
Il Client invia un REGISTRO SIP a SBC utilizzando le informazioni dal punto 3.
SBC invia il REGISTRO SIP al SA (l'SBC può eseguire una ricerca nell'NS per individuare un SA se il SBC non conosce già l'utente SIP).
Linee guida per test e laboratorio
Le seguenti linee guida si applicano alle organizzazioni di test e laboratorio:
I partner provider di servizi sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
Tutti gli utenti oltre i primi 50 utenti di test verranno fatturati.
Per garantire un'elaborazione accurata sulla fattura, tutte le organizzazioni di test devono includere il "test" nel nome dell'organizzazione BroadWorks.
Le organizzazioni di test interni devono essere designate all'interno di Webex Control Hub. Ciò al fine di impedire agli utenti di test di essere fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di prova:
Accedi a Partner Hub e seleziona Clienti.
Selezionare il cliente appropriato.
Nella barra di controllo destra, abilitare il tasto di alternanza Organizzazione test interni.
Riproduzione casella vocale
Per la casella vocale, accertarsi di configurare il server multimediale per utilizzare uno dei seguenti codici:
mp3
wav: i file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android
Se si utilizzano i file wav, eseguire i seguenti comandi CLI per configurare il server applicazioni e il server multimediale:
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACIDITÀ
- Elenco di controllo accessi
- ALVEOLO
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APICI
- Servizio di notifica push Apple
- AS
- Server applicazioni
- ATA
- Adattatore per telefono analogico, adattatore che converte la telefonia analogica in VoIP
- BAMBOLA
- Gestione applicazioni BroadSoft
- Autenticazione base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- ALVEOLARE
- Server di messaggistica BroadSoft
- PALUDE
- Flussi bidirezionali Su HTTP sincrono
- BRI
- Basic Rate Interface BRI è un metodo di accesso ISDN
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico telefonico (cfr. partner, provider di servizi, rivenditore a valore aggiunto)
- CAPTCHA
- Test di Turing pubblico completamente automatizzato per distinguere Computer ed Esseri Umani
- CCXML
- Linguaggio di markup eXtensible controllo chiamate
- CIF
- Formato intermedio comune
- CLI
- Interfaccia riga di comando
- CN
- Nome comune
- CNPS
- Server push notifiche chiamate. Un server push notifiche che viene eseguito su un ADP XSP| nel proprio ambiente per eseguire notifiche di chiamata push su FCM e APNS. Vedere il proxy NPS.
- CPE
- Attrezzatura della sede del cliente
- CPR
- Regola presenza personalizzata
- CENERE
- Foglio stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione telefonia computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- NoDist
- Non disturbare
- DNS
- Sistema dei nomi di dominio
- DPG
- Chiama gruppo di pari
- DSCP
- Punto codice servizi differenziati
- DTAF
- File di archivio tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza a doppia tonalità
- Utente finale
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. Sottoscrittore)
- Aziendale
- Una raccolta di utenti finali (cfr. Organizzazione)
- FUSO
- Messaggistica cloud Firebase
- DI FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creare utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning completo flow-through
- Creare e verificare gli utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks e asserendo che ciascun utente BroadWorks dispone di un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. È la spina sul telefono o fax o i connettori sul sistema telefonico analogico. Fornisce un'indicazione di aggancio/aggancio sganciato (chiusura con loop). Poiché la porta FXO è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo FXO".
- FXS
- Foreign Exchange Subscriber è la porta che effettivamente fornisce la linea analogica all'abbonato. In altre parole, è la "spina nella parete" che fornisce un segnale di linea, corrente della batteria e tensione della suoneria.
- GABBIA
- Messaggio cloud Google
- GABBIA
- Modalità Galois/Counter (tecnologia di crittografia)
- HID
- Dispositivo interfaccia uomo
- HTTPS
- Prese protette da protocollo di trasferimento ipertestuale
- IAD
- Dispositivo di accesso integrato
- IM&P
- messaggistica istantanea e presenza
- PSTN IP
- Un provider di servizi che fornisce VoIP ai servizi PSTN, intercambiabile con ITSP, o un termine generale per la telefonia "pubblica" connessa a Internet, fornito collettivamente dai principali provider di telecomunicazioni (piuttosto che dai paesi, come è PSTN)
- ITSP
- Provider servizi di telefonia Internet
- IVR
- Risposta vocale/risponditore interattiva
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificatore Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notazione oggetto script Java
- JESS
- Java Secure Socket Extension; la tecnologia sottostante che fornisce funzioni di connettività sicure ai server BroadWorks
- KEM
- Modulo interno chiave (telefoni Cisco hardware)
- LLT
- Token di lunga durata (o Long Life): token di connessione autodescrittivo e sicuro che consente agli utenti di rimanere autenticati più a lungo e non è legato ad applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIGLIO
- Base di informazioni di gestione
- AVV.
- Server multimediale
- mTLS
- Autenticazione reciproca tra due parti, tramite scambio di certificati, quando si stabilisce una connessione TLS
- MUCO
- Chat con più utenti
- NAT
- Traduzioni dell'indirizzo di rete
- NPS
- Server push notifica; vedere CNPS
- Proxy NPS
-
Un servizio in Webex che fornisce token di autorizzazione di breve durata al CNPS, consentendo di eseguire notifiche di chiamata push a FCM e APN e, in ultima analisi, a dispositivi Android e iOS con Webex.
- ASSOCIAZIONE
- Apri interfaccia client
- Organizzazione
- Società o organizzazione che rappresentano un insieme di utenti finali (cfr. Impresa)
- OTG
- Gruppo di trunk in uscita
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- Partner
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. rivenditore a valore aggiunto, fornitore di servizi, gestore telefonico)
- PBX
- Borsa filiale privata
- DELLA SOCIETÀ
- E-mail avanzata per la privacy
- PIEDINO
- Rete mobile terrestre pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia per le telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- P.ES.
- Server profilo
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Sito web che consente all’amministratore del rivenditore di configurare la soluzione UC-One SaaS. Talvolta viene indicato come portale BAM, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Revisore di frontiera sessione
- CEMENTAZIONE
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; un'organizzazione che fornisce servizi di telefonia o correlati ad altre organizzazioni (cfr. vettore, partner, rivenditore a valore aggiunto)
- SIP
- Protocollo di avvio sessione
- SLITTA
- Token di breve durata (o Short Life) (chiamato anche BroadWorks SSO Token); token autenticato monouso utilizzato per accedere in sicurezza ad applicazioni Web.
- ODORE
- Piccole e medie imprese
- SNMP
- Protocollo di gestione di rete semplice
- sRTCP
- protocollo di controllo trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- sRTP
- protocollo di trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- SSL
- Strato di prese sicure
- Abbonato
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. utente finale)
- TCP
- Protocollo di controllo del cambio
- TDM
- Divisione Tempo Multiplexing
- TLS
- Sicurezza livello trasporto
- ToS
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Comunicazioni unificate
- UI
- Interfaccia utente
- U ID
- Identificativo univoco
- MUTI
- Server di messaggistica
- URI
- Identificativo risorsa uniforme
- URL
- Ricerca risorse uniformi
- DISTURBO
- Condivisione server
- UTC
- Coordinated Universal Time
- UVS.
- Server video
- Rivenditore a valore aggiunto (VAR)
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. vettore, partner, fornitore di servizi)
- VAMPATA
- Array di grafica video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Linguaggio di markup estensibile vocale
- WebDAV
- Creazione e versioni distribuite su Web
- WebRTC
- Comunicazioni Web in tempo reale
- WRS
- Server WebRTC
- XMPP
- Protocollo di presenza e messaggistica estendibile
Configurazione dei servizi (con mTLS per il servizio autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida token CI. Queste procedure sono obbligatorie se si stanno eseguendo più organizzazioni Webex dallo stesso server ADP XSP|. In caso contrario, sono facoltativi.
Se non si eseguono più organizzazioni Webex sullo stesso server ADP XSP|, si consiglia la convalida del token CI (con TLS) per il servizio di autenticazione. Fare riferimento a Configura servizi su Webex per Cisco BroadWorks XSP|ADPs per informazioni dettagliate su come configurare il servizio di autenticazione e altri servizi. |
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con mTLS)
I token longevi di BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sui tuoi XSP|ADP.
Requisiti
I server XSP|ADP che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
XSP|ADP devono condividere le stesse chiavi per crittografare/decrittografare token di lunga durata BroadWorks. Copiare queste chiavi in ogni XSP|ADP è un processo manuale.
Gli ADP XSP|devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli XSP|ADP include:
Distribuire il servizio di autenticazione.
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
Generare e condividere le chiavi RSA su XSP|ADP.
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ogni XSP|ADP utilizzato con Webex:
Attivare l'applicazione del servizio di autenticazione sul percorso
/authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService
(dove
<version>
è la versione BroadWorks).Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
deploy application /authService
Configurazione della durata del token
Verificare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
Impostare la durata su 60 giorni (max 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
set tokenDurationInHours 1440
Genera e condividi chiavi RSA
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori è necessario generare chiavi su un XSP|ADP quindi copiarle su tutti gli altri XSP|ADP.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP. |
Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web
Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token.
Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità per il servizio di autenticazione (con mTLS)
Accedi a Control Hub con l'account amministratore del partner.
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
.Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
.Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Esegui GuidaUpdateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot2023
,webexclientissuing
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte e quattro le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, è richiesto mTLS per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/HttpServer>
e eseguire ilget
comando per visualizzare le interfacce.Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che significa come mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. In sostanza, il primo
true
protegge l'interfaccia con TLS (il certificato del server viene creato se richiesto) e la secondatrue
forza l'interfaccia a richiedere l'autenticazione del certificato del client (insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Interface Port Name Secure Client Auth Req Cluster Fqdn
=======================================================
192.0.2.7 443 XSP|ADP01.collab.example.net true false
192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (autenticazione client richiesta = true) è abilitato il 192.0.2.7
porta 444
. TLS abilitato su 192.0.2.7
porta 443
.
(Opzione) Configurazione di mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, è necessario mTLS per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
e eseguire ilget
per visualizzare le applicazioni in esecuzione.Per aggiungere un'applicazione e richiederne l'autenticazione client (ovvero mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. I nomi delle applicazioni sono elencati qui. Il
true
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
add 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService a 192.0.2.7:443 e richiede di richiedere e autenticare i certificati dal client.
Verifica con get
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
get
Interface Ip Port Application Name Client Auth Req
===================================================
192.0.2.7 443 AuthenticationService true
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Dove andare Avanti
Per la configurazione, è possibile accedere nuovamente al flusso dei documenti principale all'interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca rispetto a AuthService
Webex interagisce con il servizio di autenticazione su una connessione TLS autenticata reciproca. Ciò significa che Webex presenta un certificato client e che XSP|ADP deve convalidarlo. Per garantire l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora attendibile su XSP|ADP (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
Vai a Impostazioni > BroadWorks Calling.
Fare clic sul collegamento del certificato di download.
È inoltre possibile scaricare la catena di certificati da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt. |
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il diagramma seguente riassume dove deve essere distribuita la catena di certificati CA Webex in questi tre casi.
Requisiti del certificato TLS reciproco per proxy bridge TLS
Webex presenta un certificato client firmato da CA Webex al proxy.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità proxy, pertanto il proxy considera attendibile il certificato del client.
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta un certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions:
X509v3 Extended Key Usage:
1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Requisiti di certificato TLS reciproco per proxy passthrough TLS o XSP in DMZ
Webex presenta un certificato client firmato da CA Webex agli XSP.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità degli XSP, pertanto gli XSP si affidano al certificato client.
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
Gli XSP presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i certificati server degli XSP.
Cronologia revisioni documenti
La tabella seguente mostra lo storico delle modifiche apportate a questo documento negli ultimi 12 mesi.
Data | Versione | Descrizione della modifica | |
---|---|---|---|
14 giugno 2024 | 2-119 |
| |
13 maggio 2024 | 2-118 |
| |
10 maggio 2024 | 2-117 |
| |
6 maggio 2024 | 2-116 |
| |
2 maggio 2024 | 2-115 |
| |
10 aprile 2024 | 2-114 |
| |
27 marzo 2024 | 2-113 |
| |
22 marzo 2024 | 2-112 |
| |
7 marzo 2024 | 2-111 |
| |
24 febbraio 2024 | 2-110 |
| |
20 febbraio 2024 | 2-109 |
| |
7 febbraio 2024 | 2-108 |
| |
25 gennaio 2024 | 2-107 |
| |
23 gennaio 2024 | 2-106 |
| |
10 gennaio 2024 | 2-105 |
| |
20 dicembre 2023 | 2-104 |
| |
13 dicembre 2023 | 2-103 |
| |
12 dicembre 2023 | 2-102 |
| |
8 dicembre 2023 | 2-101 |
| |
08 novembre 2023 | 2-100 |
| |
25 ottobre 2023 | 2-99 |
| |
13 settembre 2023 | 2-98 |
| |
04 settembre 2023 | 2-97 |
| |
08 agosto 2023 | 2-96 |
| |
23 giugno 2023 | 2-95 |
| |
30 maggio 2023 | 2-94 |
| |
26 maggio 2023 | 2-93 |
| |
24 maggio 2023 | 2-92 |
| |
10 maggio 2023 | 2-91 |
| |
09 maggio 2023 | 2-90 |
| |
4 maggio 2023 | 2-89 |
| |
27 aprile 2023 | 2-88 |
| |
14 aprile 2023 | 2-87 |
| |
17 marzo 2023 | 2-86 |
| |
11 marzo 2023 | 2-85 |
| |
10 marzo 2023 | 2-84 |
| |
7 marzo 2023 | 2-83 |
| |
28 febbraio 2023 | 2-82 |
| |
15 febbraio 2023 | 2-81 |
| |
10 febbraio 2023 | 2-80 |
| |
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione si rivolge agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei propri clienti o forniscono questa soluzione direttamente ai propri abbonati.
Scopo della soluzione
Fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che già dispongono del servizio di chiamata fornito dai provider di servizi BroadWorks.
Fornire il servizio di chiamata basato su BroadWorks a clienti Webex piccoli e medi.
Contesto
Stiamo evolvendo tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo sforzo consiste nello spostare le funzionalità di chiamata BroadWorks nell'app Webex e infine ridurre gli investimenti nei client UC-One.
Vantaggi
Prova futura: contro interruzione del servizio di UC-One Collaborate, spostamento di tutti i client verso Unified Client Framework (UCF)
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex mantenendo la chiamata BroadWorks sulla rete di telefonia
Ambito della soluzione
Clienti da piccoli a medi esistenti/nuovi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre di chiamate BroadWorks.
Clienti Webex esistenti di piccole e medie dimensioni che desiderano aggiungere BroadWorks Calling.
Non aziende più grandi (rivedere il nostro portfolio Enterprise per Webex).
Non utenti singoli (valutare le offerte Webex Online).
Le funzioni impostate in Webex per Cisco BroadWorks riguardano casi d'uso di piccole e medie imprese. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità per le PMI e ne valutiamo costantemente l'idoneità per questo segmento. Possiamo scegliere di nascondere o rimuovere funzioni che sarebbero altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# | Requisito | Note | ||
---|---|---|---|---|
1 | Patch BroadWorks R22 corrente o superiore | |||
2 | XSP|ADP per XSI, CTI, DMS e authService | XSP|ADP dedicato per Webex per Cisco BroadWorks | ||
3 | XSP|ADP separato per NPS, può essere condiviso con altre soluzioni che utilizzano NPS. | Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni XSP|ADP e NPS. | ||
4 | Convalida token CI (con TLS) configurata per le connessioni Webex al servizio di autenticazione. | |||
5 | mTLS configurato per le connessioni Webex all'interfaccia CTI. | Altre applicazioni non richiedono mTLS. | ||
6 | Gli utenti devono essere presenti in BroadWorks e necessitano dei seguenti attributi, a seconda della decisione di provisioning:
| Per i messaggi e-mail attendibili: Si consiglia di inserire lo stesso indirizzo e-mail anche nell'attributo ID alternativo, per consentire agli utenti di accedere con indirizzo e-mail rispetto a BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'uso di e-mail non attendibili può causare l'invio dell'e-mail alla cartella Posta indesiderata o SPAM dell'utente. L'amministratore potrebbe dover modificare le impostazioni e-mail dell'utente per consentire i domini | ||
7 | Webex per il file DTAF Cisco BroadWorks per l'app Webex | |||
8 | Utente BW Business Lic o Std Enterprise o Prem Enterprise Lic + Webex per abbonamento Cisco BroadWorks | Se si dispone di una distribuzione di collaborazione esistente, non è più necessario il pacchetto aggiuntivo UC-One, le porte per conferenze Collab Lic e Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non occorre apportare altre modifiche se non accettare i termini del pacchetto Premium. | ||
9 | IP/porte devono essere accessibili attraverso i servizi backend Webex e le app Webex su Internet pubblico. | Vedere la sezione "Preparazione della rete". | ||
10 | Configurazione TLS v1.2 su XSP|ADP | |||
11 | Per il provisioning Flowthrough, il server applicazioni deve connettersi all'adattatore di provisioning BroadWorks.
| Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è aiutarti a comprendere, preparare, distribuire e gestire la tua soluzione Webex per Cisco BroadWorks. Le principali sezioni del documento riflettono tale obiettivo.
Questa guida include materiale concettuale e di riferimento. In questo documento intendiamo trattare tutti gli aspetti della soluzione.
La serie minima di attività per distribuire la soluzione è la seguente:
Contatta il team dell'account per diventare un partner Cisco. È fondamentale esplorare i punti di contatto Cisco per acquisire familiarità (e ricevere formazione). Quando si diventa partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Onboarding partner in questo documento.
Configura i tuoi sistemi BroadWorks per l'integrazione con Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento.
Usa Partner Hub per connettere Webex a BroadWorks. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione partner in Partner Hub in questo documento.
Utilizzare Partner Hub per preparare i modelli di provisioning degli utenti. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento.
Testare e eseguire l'onboarding di un cliente mediante il provisioning di almeno un utente (vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
|
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. (Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto).
Come funziona
Webex per Cisco BroadWorks è un'offerta che integra BroadWorks Calling in Webex. Gli abbonati utilizzano una singola applicazione (l'app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
Gli utenti chiamano i numeri PSTN utilizzando l'infrastruttura BroadWorks.
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino numerico per introdurre i numeri).
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Chiamata Webex" sull'app Webex. (Queste chiamate sono da app Webex a app Webex, non da app Webex a PSTN).
Gli utenti possono organizzare e accedere a Webex Meetings.
Gli utenti possono scambiarsi messaggi uno a uno o in spazi (chat di gruppo persistente) e beneficiare di funzioni come ricerca e condivisione file (sull'infrastruttura Webex).
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
Una volta eseguito l'onboarding come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare la relazione tra l'istanza BroadWorks e Webex.
È possibile creare organizzazioni dei clienti in Control Hub e eseguire il provisioning degli utenti in tali organizzazioni.
Ogni abbonato in BroadWorks riceve un'identità Webex in base al proprio indirizzo e-mail (attributo ID e-mail in BroadWorks).
Gli utenti eseguono l'autenticazione su BroadWorks o su Webex.
Ai clienti vengono rilasciati token di lunga durata per autorizzarli per i servizi su BroadWorks e Webex.
L'app Webex al centro di questa soluzione, è un'applicazione personalizzabile disponibile su desktop Mac/Windows e dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzionalità di messaggistica, presenza e riunioni.
Il client esegue la registrazione ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i tuoi sistemi BroadWorks per garantire un'esperienza di provisioning utente perfetta.
Funzioni e limitazioni
Offriamo diversi pacchetti con diverse caratteristiche.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata, ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano nella rubrica un utente softphone, i risultati della ricerca non forniscono alcuna opzione per inviare un messaggio.
Gli utenti del softphone possono condividere lo schermo durante una chiamata.
Pacchetto "base"
Il pacchetto di base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti in riunioni a "spazio unificato" e riunioni nella sala riunioni personale. (** vedere la seguente nota a titolo di eccezione). In questo pacchetto le riunioni possono avere una durata massima di 40 minuti.
Pacchetto "Standard"
Questo pacchetto include anche tutto quello che è contenuto nel pacchetto Base, ad esempio fino a 100 partecipanti nelle riunioni "spazio unificato" e nelle riunioni nella sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è un ruolo inizialmente ricoperto solo dall'organizzatore della riunione, ma l'organizzatore può passare il "ruolo di relatore" a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può riprendere il ruolo di relatore senza che l'organizzatore corrente glielo passi.
Pacchetto "Premium"
Questo pacchetto include tutto nel pacchetto Standard più un massimo di 300 partecipanti in una riunione "spazio unificato" e fino a 1000 partecipanti in una sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è supportata per qualsiasi partecipante alla riunione.
Confronta pacchetti
Pacchetto | Chiamata | Messaggistica | Riunioni nello spazio Unified | PMR riunioni |
---|---|---|---|---|
Softphone | Incluso | Non incluso | Nessuno | Nessuno |
Base | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Standard | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Premium | Incluso | Incluso | 300 partecipanti | 1000 partecipanti |
Il limite della riunione nello spazio Unified per gli utenti Base è 100 partecipanti per riunione nello spazio Unified a meno che lo spazio non includa anche gli utenti a cui sono assegnati i pacchetti "Standard" o "Premium", nel qual caso il limite aumenta in base al pacchetto utente organizzatore. |
"Riunioni nello spazio Unified" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti "Riunione" o "Pianifica". "Riunioni PMR" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale (PMR) di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID). |
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per le differenze di supporto delle funzioni di riunione PMR per i pacchetti Base, Standard e Premium.
Funzione riunione | Supportato con il pacchetto base | Suported con pacchetto standard | Supportato con il pacchetto Preminum | Commento |
---|---|---|---|---|
Durata riunione | 40 minuti o meno | Illimitato | Illimitato | |
Condivisione desktop | Sì | Sì | Sì | Base: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione desktop solo da parte dell'organizzatore della riunione PMR. Premium: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. |
Condivisione applicazione | Sì | Sì | Sì | Base: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione delle applicazioni solo da parte dell'organizzatore della riunione PMR. Premium: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. |
Chat con più interlocutori | Sì | Sì | Sì | |
Lavagna | Sì | Sì | Sì | |
Protezione con password | Sì | Sì | Sì | |
App Web - nessun download o plug-in (Esperienza ospite) | Sì | Sì | Sì | |
Supporto dell'accoppiamento con i dispositivi Webex | Sì | Sì | Sì | |
Controllo del pavimento (disattivazione del microfono uno / espulsione tutti) | Sì | Sì | Sì | |
Collegamento Riunioni persistenti | Sì | Sì | Sì | |
Accesso sito riunioni | Sì | Sì | Sì | |
Accesso alla riunione tramite VoIP | Sì | Sì | Sì | |
Bloccaggio | Sì | Sì | Sì | |
Controlli relatore | No | No | Sì | |
Controllo desktop remoto | No | No | Sì | |
Numero di partecipanti | 100 | 100 | 1000 | |
Registrazione salvata in locale nel sistema | Sì | Sì | Sì | |
Registrazione nel cloud | No | No | Sì | |
Registrazione - Cloud Storage | No | No | 10 GB per sito | |
Trascrizione delle registrazioni | No | No | Sì | |
Pianificazione riunione | Sì | Sì | Sì | |
Abilita condivisione contenuto con integrazioni esterne | No | No | Sì | Base: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. Standard: condivisione di contenuto solo da parte dell'organizzatore della riunione PMR. Premium: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. |
Consenti modifica URL PMR | No | No | Sì | Base: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori dei partner e delle organizzazioni possono modificare l'URL da Control Hub. Standard: l'URL PMR può essere modificato solo da Partner Hub per Partner e amministratori organizzazione. Premium: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori partner e dell'organizzazione possono modificare l'URL da Partner Hub. |
Streaming in diretta riunioni (Ad Esempio, su Facebook, Youtube) | No | No | Sì | |
Consenti ad altri utenti di pianificare riunioni per loro conto | No | No | Sì | |
Aggiungi organizzatore alternativo | Sì | No | Sì | |
Integrazione app (es., Zendesk, Slack) | Dipende dall'integrazione | Dipende dall'integrazione | Sì | Per ulteriori informazioni sul supporto, vedere la sezione Integrazioni app riportata di seguito. |
Integrazione con il calendario Microsoft Office 365 | Sì | Sì | Sì | |
Integrazione con Google Calendaring per G Suite | Sì | Sì | Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione rivolta agli utenti per Webex su help.webex.com
. Per ulteriori informazioni sulle funzioni, leggere i seguenti articoli:
Funzioni di chiamata
L'esperienza di chiamata è simile alle soluzioni precedenti che utilizzano il motore di controllo delle chiamate BroadWorks. La differenza tra UC-One Collaborate e UC-One SaaS è che l'app Webex è il client software principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
Zendesk—Solo Premium
Slack: solo Premium
Microsoft Teams per Webex Meetings—Standard o Premium
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
Calendario Office 365—Standard o Premium
Google Calendaring per G Suite: standard o premium
Supporto dell'infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta gli ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione per Webex per l'infrastruttura desktop virtuale (VDI).
Supporto per IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Tabella di marcia futura
Per informazioni sulle nostre intenzioni per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Le voci della roadmap non sono vincolanti in alcuna capacità. Cisco si riserva il diritto di sospendere o rivedere uno o tutti questi elementi dalle release future.
Limiti
Limitazioni di provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario del sito Webex Meetings creato per tale pacchetto.
Se nella richiesta di provisioning per il primo utente di ciascun pacchetto non viene specificato alcun fuso orario, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sull'impostazione predefinita regionale dell'organizzazione degli abbonati.
Se il cliente necessita di uno specifico fuso orario del sito di Webex Meetings, specificare timezone
parametro nella richiesta di provisioning per:
il primo abbonato predisposto per il pacchetto Standard nell'organizzazione.
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
il primo abbonato predisposto per il pacchetto base nell'organizzazione.
Limitazioni generali
Nessuna chiamata nella versione Web del client Webex (questa è una limitazione del client, non una limitazione della soluzione).
Webex potrebbe non disporre ancora di tutti i controlli dell'interfaccia utente per supportare alcune funzioni di controllo delle chiamate disponibili da BroadWorks.
Attualmente, il client Webex non può essere "White Labeled" (etichetta bianca).
Quando si creano le organizzazioni dei clienti utilizzando il metodo di provisioning scelto, vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. Ci aspettiamo che i partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
I report sull'utilizzo di riunioni e messaggi sono disponibili attraverso l'organizzazione del cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti di messaggistica
I seguenti limiti di archiviazione dei dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo storage massimo per messaggistica e file combinati.
Di base: 2 GB per utente per 3 anni
Standard 5 GB per utente per 3 anni
Premio: 10 GB per utente per 5 anni
Per ciascuna organizzazione del cliente, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti premium ha un limite totale di messaggistica e storage file di 50 GB. Un singolo utente può superare il limite per utente (10 GB), a condizione che la società sia ancora al di sotto del massimo aggregato (50 GB).
Per gli spazi team creati, i limiti di messaggistica vengono applicati al totale aggregato per l'organizzazione cliente che possiede lo spazio team. Puoi trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti generali di messaggistica applicabili agli spazi dei team di messaggistica Webex, fare riferimento a https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure le connessioni a Webex e BroadWorks. I dati memorizzati nel cloud Webex ed esposti all'utente attraverso l'interfaccia dell'app Webex sono crittografati sia in transito che a riposo.
Maggiori dettagli sullo scambio di dati sono disponibili nella sezione Riferimento del presente documento.
Ulteriori letture
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati che più si avvicina alla propria regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore del provider di servizi (utente): Per le attività di manutenzione quotidiane, si gestiscono le parti della soluzione in sede (chiamata) utilizzando i propri sistemi. Gestisci le parti Webex della soluzione attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale.
Il primo utente predisposto per un nuovo organizzatore partner viene assegnato automaticamente ai ruoli amministratore completo e amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi. |
Team operativo di Cisco cloud: Crea la tua "organizzazione partner" in Partner Hub, se non esiste, durante l'onboarding.
Una volta ottenuto l'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente, create "Onboarding templates" (Modelli di onboarding) per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Quindi si fornisce i vostri clienti o abbonati.
# | Compito tipico | SP | Cisco |
---|---|---|---|
1 | Onboarding partner - Creazione dell'organizzazione partner se non esiste e abilitazione dei tasti di alternanza funzione necessari | ● | |
2 | Configurazione BroadWorks nell'organizzazione partner tramite Partner Hub (cluster) | ● | |
3 | Configurazione delle impostazioni di integrazione in Organizzazione partner tramite Partner Hub (modelli di offerta, branding) | ● | |
4 | Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|ADP Patching, firewall, configurazione XSP|ADP, XSI, AuthService, CTI, NPS, applicazioni DMS su XSP|ADP) | ● | |
5 | Sviluppo dell'integrazione o del processo di provisioning | ● | |
6 | Preparare i materiali GTM | ● | |
7 | Migrazione o provisioning di nuovi utenti | ● |
Architettura
Cosa c'è nel diagramma?
Client
Il client dell'app Webex serve come applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di messaggistica nativa, presenza e riunioni audio/video multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per le chiamate SIP e PSTN.
I telefoni IP Cisco e i relativi accessori utilizzano anche l'infrastruttura BroadWorks per le chiamate SIP e PSTN. Ci aspettiamo di essere in grado di supportare telefoni di terze parti.
Portale di attivazione utente per gli utenti che accedono a Webex utilizzando le credenziali BroadWorks.
Partner Hub è un'interfaccia Web per l'amministrazione dell'organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. Puoi anche utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
Rete di provider di servizi
Il blocco verde a sinistra dello schema rappresenta la tua rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
XSP|ADP rivolto al pubblico, per Webex per Cisco BroadWorks: (La scatola rappresenta una o più fattorie XSP|ADP, eventualmente frontali da bilanciatori di carico).
Ospita l'interfaccia dei servizi Xtended (XSI-Actions & XSI-Events), il servizio di gestione dei dispositivi (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato del ricevitore dell'altro (presenza di telefonia) e la cronologia chiamate.
Pubblica la rubrica ai client Webex.
XSP|ADP rivolto al pubblico, con NPS in esecuzione:
server push notifiche chiamate organizzatore: Un server push di notifica su un ADP XSP| nel proprio ambiente. Si interfaccia tra il server applicazioni e il proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS & FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
Server applicazioni:
Fornisce il controllo delle chiamate e le interfacce ad altri sistemi BroadWorks (generalmente)
Per il provisioning flowthrough, l'AS viene utilizzato dall'amministratore del partner per il provisioning degli utenti in Webex
Inserisce il profilo utente in BroadWorks
OSS/BSS: Sistema di supporto alle operazioni/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nello schema rappresenta il cloud Webex. I microservizi Webex supportano l'intero spettro di funzionalità di collaborazione Webex:
Cisco Common Identity (CI) è il servizio identità all'interno di Webex.
Webex per Cisco BroadWorks rappresenta la serie di microservizi che supportano l'integrazione tra Webex e BroadWorks ospitato da provider di servizi:
API di provisioning utente
Configurazione provider di servizi
Accesso utente mediante credenziali BroadWorks
Casella di messaggistica Webex per microservizi correlati alla messaggistica.
Casella Webex Meetings che rappresenta server di elaborazione multimediale e SBC per riunioni video con più partecipanti (SIP e SRTP)
Servizi Web di terze parti
Nello schema sono rappresentati i seguenti componenti di terze parti:
APNS (Apple Push Notifications Service) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Apple.
FCM (messaggistica cloud FireBase) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Il ruolo dei server XSP|ADP aperti al pubblico in Webex per Cisco BroadWorks
L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste Webex per BroadWorks JWT (JSON Web Token) per conto dell'utente
Interfaccia CTI, protetta da mTLS, a cui Webex sottoscrive gli eventi della cronologia chiamate e lo stato della presenza di telefonia da BroadWorks (stato hook).
Interfacce azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate degli abbonati, rubriche di elenchi di contatti e chiamate e configurazione del servizio di telefonia per gli utenti finali
Servizio DM (Device Management) per il recupero dei file di configurazione delle chiamate da parte dei client
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedere Configurazione dei cluster BroadWorks in Partner Hub in questo documento. Per ciascun cluster, è possibile fornire un solo URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP
È necessario utilizzare un'istanza ADP XSP|dedicata o un'azienda agricola separata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile organizzare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso XSP|ADP che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/azienda agricola ADP XSP| dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
Ad esempio, se offri UC-One SaaS, ti consigliamo di creare una nuova fattoria XSP|ADP per Webex per Cisco BroadWorks. In questo modo i due servizi possono operare in modo indipendente durante la migrazione degli abbonati.
Se si collocano le applicazioni Webex per Cisco BroadWorks in una fattoria ADP|XSP utilizzata per altri scopi, è responsabilità dell'utente monitorare l'utilizzo, gestire la complessità risultante e pianificare l'aumento della scala.
Il pianificatore della capacità di sistema Cisco BroadWorks assume una fattoria ADP XSP| dedicata e potrebbe non essere preciso se la si utilizza per i calcoli della posizione.
Se non diversamente specificato, gli Webex dedicati per Cisco BroadWorks XSP|ADP devono ospitare le seguenti applicazioni:
AuthService (TLS con convalida token CI o mTLS)
CTI (mTLS)
Azioni XSI (TLS)
XSI-Events (TLS)
DMS (TLS): opzionale. Non è obbligatorio distribuire un'istanza DMS o un'azienda agricola separata specificamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
TLS (Call Settings Webview): opzionale. La vista Webview (CSW) delle impostazioni di chiamata è richiesta solo se si desidera che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso a CTI attraverso un'interfaccia protetta dall'autenticazione TLS reciproca. Per supportare questo requisito, raccomandiamo una delle seguenti opzioni:
(Diagramma etichettato Opzione 1) Una istanza XSP|ADP o un'azienda agricola per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
(Diagramma etichettato Opzione 2) Due istanze ADP XSP| o aziende agricole, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSP|ADP Se si dispone di una fattoria ADP XSP|esistente conforme a una delle architetture suggerite sopra (Opzione 1 o 2) ed è leggermente caricata, è possibile riutilizzare le ADP XSP|esistenti. Dovrai verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti dell'applicazione per Webex. Le due considerazioni principali sono:
Poiché gli XSP|ADP hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero esserci altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di XSP|ADP deve essere verificato in un laboratorio con la configurazione desiderata prima di impegnarsi per il riutilizzo. |
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione temporale per tutti gli XSP|ADP utilizzati con Webex.
Installare il ntp
pacchetto dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Quindi è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, consultare la Guida alla gestione del software BroadWorks.
Durante l'installazione interattiva del software XSP|ADP, è possibile configurare NTP. Procedere come segue:
Quando l'installatore chiede,
Do you want to configure NTP?
, immetterey
.Quando l'installatore chiede,
Is this server going to be a NTP server?
, immetteren
.Quando l'installatore chiede,
What is the NTP address, hostname, or FQDN?
, immettere l'indirizzo del server NTP o un servizio NTP pubblico, ad esempio,pool.ntp.org
.
Se gli ADP XSP|utilizzano un'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie Key=Value:
NTP
NTP_SERVER=<NTP Server address, e.g., pool.ntp.org>
Requisiti di identità e sicurezza XSP|ADP
Sfondo
I protocolli e le crittografie delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli vanno dal più generale (provider SSL) al più specifico (interfaccia singola). Un'impostazione più specifica sostituisce sempre un'impostazione più generale. Se non sono specificate, le impostazioni SSL di livello "inferiore" vengono ereditate da livelli "superiori".
Se non viene modificata alcuna impostazione rispetto alle impostazioni predefinite, tutti i livelli ereditano le impostazioni predefinite del provider SSL (JSSE Java Secure Sockets Extension).
Elenco dei requisiti
L'|ADP XSP deve autenticarsi sui client utilizzando un certificato firmato da CA in cui il nome comune o il nome alternativo oggetto corrispondono alla parte di dominio dell'interfaccia XSI.
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
Diffie-Hellman Effemeral (DHE) o curve ellittiche Diffie-Hellman Effemeral (ECDHE) chiave-scambio
Crittografia AES (Advanced Encryption Standard) con una dimensione minima di blocco di 128 bit (ad esempio, AES-128 o AES-256)
Modalità di codifica GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
Se viene utilizzata una crittografia CBC, solo la famiglia SHA2 di funzioni hash è consentita per derivazione chiave (SHA256, SHA384, SHA512).
Ad esempio, le seguenti crittografie soddisfano i requisiti:
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come illustrato sopra, non la convenzione openSSL. |
Crittografie TLS supportate per le interfacce AuthService e XSI
Questo elenco è soggetto a modifiche a mano a mano che evolvono i nostri requisiti di sicurezza del cloud. Seguire l'attuale raccomandazione sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento. |
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_128_GCM_SHA256
TLS_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA256
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_256_CBC_SHA
TLS_PSK_WITH_AES_256_CBC_SHA384
TLS_PSK_WITH_AES_256_CBC_SHA
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA
TLS_PSK_WITH_AES_128_CBC_SHA256
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri della scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il numero di thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi visualizzati come segue (non diminuirli se sono al di sopra di questi valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più |ADP XSP
Elemento bordo bilanciamento carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, deve gestire in modo trasparente la distribuzione del traffico tra più server XSP|ADP e il cloud e i client Webex per Cisco BroadWorks. In questo caso, è possibile fornire l'URL del bilanciatore di carico alla configurazione Webex per Cisco BroadWorks.
Note su questa architettura:
Configurare il DNS in modo che i client possano trovare il bilanciatore di carico quando si connettono all'interfaccia Xsi (vedere configurazione DNS).
Si consiglia di configurare l'elemento edge in modalità proxy SSL inversa per garantire la crittografia dei dati punto a punto.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Server XSP|ADP orientati verso Internet
Se si espongono direttamente le interfacce Xsi, utilizzare il DNS per distribuire il traffico ai più server XSP|ADP.
Note su questa architettura:
Per connettersi ai server XSP|ADP sono necessari due record:
Per i microservizi Webex: Per targetizzare più indirizzi IP XSP|ADP sono necessari record A/AAAA round-robin. Questo perché i microservizi Webex non possono effettuare ricerche SRV. Per esempi, vedere Servizi cloud Webex.
Per l'app Webex: Un record SRV che si risolve in record A in cui ogni record A si risolve in un singolo XSP|ADP. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per targetizzare il servizio XSI per più indirizzi XSP|ADP. Assegnare la priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (e all'indirizzo IP successivo) e passino al record A successivo (e all'indirizzo IP) solo se il primo indirizzo IP è inattivo. NON utilizzare un approccio round-robin per l'app Webex.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune.
È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL XSP|ADP di un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server XSP|ADP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.
Ordinazione e provisioning
L'ordine e il provisioning si applicano a questi livelli:
Provisioning di partner/provider di servizi:
Ogni onboarding di Webex per provider di servizi Cisco BroadWorks (o rivenditore) deve essere configurato come organizzazione partner in Webex e devono essere concesse le autorizzazioni necessarie. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per gestire Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le operazioni di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/aziendale.
Ordinazione e provisioning clienti/aziende:
Ogni BroadWorks Enterprise abilitato per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo si verifica automaticamente come parte del provisioning utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks vengono predisposti nella stessa organizzazione cliente Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
Ordinazione e provisioning utente/abbonato:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning degli utenti:
Provisioning fluviale con e-mail attendibili
Provisioning eseguibile senza e-mail attendibili
Self-provisioning utente
Provisioning API
Provisioning eseguibile con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile affermare che BroadWorks dispone di indirizzi e-mail abbonati validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Provisioning eseguibile senza e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non puoi contare sugli indirizzi e-mail degli abbonati detenuti da BroadWorks, questa opzione di provisioning crea account Webex ma non può attivarli fino a quando gli abbonati non forniscono e convalidano i relativi indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Self-provisioning utente
Con questa opzione, non è disponibile il provisioning flowthrough da BroadWorks a Webex. Una volta configurata l'integrazione tra Webex e il sistema BroadWorks, vengono visualizzati uno o più collegamenti specifici per il provisioning degli utenti all'interno dell'organizzazione partner Webex per Cisco BroadWorks.
Successivamente, si progettano le proprie comunicazioni (o si delegano ai clienti) per distribuire il collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account vengono predisposti nell'ambito dell'organizzazione partner, puoi regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare tale operazione.
Gli utenti devono esistere nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento. |
Provisioning provider di servizi per API
Webex presenta un set di API pubbliche che consentono di creare il provisioning utente/abbonato Webex per Cisco BroadWorks nel flusso di lavoro/negli strumenti di gestione utenti esistenti.
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti Webex per Cisco Broadworks di comporre altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella rubrica Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo dell'estensione di tutte le aree del metodo di avvio chiamata e del profilo dell'utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e gruppi diversi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due imprese che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Utenti Cisco BroadWorks
Provisioning API pubblica come 'interno
Il parametro dell'interno deve essere esplicitamente passato come parte della chiamata API. Per le imprese/gruppi con Location Dialing Code (LDC) configurato, il parametro dell'interno dovrebbe essere la combinazione di LDC e 'numero di interno.
Provisioning flusso o auto-attivazione
Estensione e LDC (se applicabile) saranno automaticamente recuperati da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione di codice di chiamata posizione (LDC) e numero di interno.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'interno |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'estensione deve essere passata come parametro |
Attraverso il flusso | Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Elenchi telefonici BroadWorks | Elenchi telefonici aziendali, di gruppo o personali | Sincronizzazione rubriche | Non applicabile |
Prerequisiti
La versione del client richiesta per supportare questa funzione è 42.11 o successiva.
Patch in cui i codici di chiamata di estensione e posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
AP.platform.23.0.1075.ap380045
AP.as.23.0.1075.ap380045
AP.xsp.23.0.1075.ap380045
AP.as.24.0.944.ap380045
Abilitare l'intestazione X-BroadWorks-Remote-Party-Info su AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP richiesto per il supporto della funzione di composizione dell'interno.
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata a interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità delle chiamate di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'estensione come seconda opzione in Partner Hub e Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con estensione attraverso uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione dell'interno sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Non verrà visualizzata un'estensione nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere visibile l'opzione di chiamata dell'interno per i clienti esistenti:
Se un partner desidera che tutte le organizzazioni dei clienti gestite siano dotate di un interno come una delle opzioni di chiamata, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
Se un partner desidera fornire un interno in opzioni di chiamata per una specifica organizzazione cliente, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e portarli alla pari con l'aumento di 30K contatti per l'elenco telefonico Enterprise, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per Organizzazione, che si applica alla somma degli elenchi telefonici Enterprise e Group in una singola azienda BroadWorks. Ad esempio, sarà supportato un'azienda BroadWorks che dispone di un elenco di telefoni aziendali con 30K e anche di 5 elenchi di telefoni di gruppo ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K totali).
Questa funzione è disponibile su richiesta. Contatta il team dell'account per abilitare questa opzione.
|
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks nello storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare a quale gruppo appartiene questo utente. L'associazione dell'utente con un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca dei contatti nello storage del gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning degli abbonati Webex per BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
È possibile eseguire il provisioning dell'ID gruppo aziendale BroadWorks per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Webex per gli utenti Cisco BroadWorks
Provisioning API pubblica come "spEnterpriseGroupId"
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
Provisioning flusso o auto-attivazione
L'ID gruppo aziendale BroadWorks verrà automaticamente recuperato da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Non applicabile. Non è necessario sincronizzare l'ID gruppo aziendale BroadWorks per questi utenti.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'ID gruppo aziendale BroadWorks deve essere superato come parametro spEnterpriseGroupId |
Attraverso il flusso | L'ID gruppo aziendale BroadWorks viene recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Non applicabile |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Non applicabile |
Elenchi telefonici BroadWorks | Contatti negli elenchi telefonici del gruppo BroadWorks | Sincronizzazione rubriche | I contatti di gruppo vengono memorizzati nel servizio Webex Contact associato al gruppo specifico |
Elenchi di telefoni BroadWorks Enterpsie o Persional | Contatti negli elenchi telefonici aziendali o personali | Sincronizzazione rubriche | Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. Impossibile completare la migrazione fino a quando QUESTA API non viene completata. L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march Una volta abilitata la funzione e a seguito della sincronizzazione della rubrica successiva, i gruppi di utenti aziendali verranno visualizzati anche in Control Hub. La visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativa in questa fase. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza a un gruppo in Control Hub poiché tali modifiche non verranno riportate nuovamente in BroadWorks. La gestione di gruppo in Control Hub è destinata all'uso da parte dei partner che adotteranno le prossime API di gestione contatti. |
Migrazione e prova del futuro
La progressione Cisco del client di comunicazione unificata BroadSoft deve spostarsi da UC-One a Webex. Si verifica una corrispondente progressione dei servizi di supporto dalla rete del provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che tu stia eseguendo UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita consiste nel distribuire nuovi ADP|XSP dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti in Webex e infine recuperare l'infrastruttura utilizzata per la soluzione precedente.
Sottoscrizioni di documenti consigliate
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Abbonati che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di eseguire l'abbonamento a ciascuno dei seguenti articoli per assicurarsi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per iscriversi, accedere a ciascuno dei link seguenti e nell'articolo che viene visualizzato fare clic sul pulsante Iscriviti.
Come minimo, si consiglia di iscriversi all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati in Documenti aggiuntivi dispone di un'opzione Sottoscrivi . Affinché questa opzione venga visualizzata, l'articolo deve essere visualizzato su help.webex.com.
Non esiste un'opzione di abbonamento per le landing page di documentazione. |
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Documenti Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
Porta la tua soluzione PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono di loro proprietà (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive come eseguire l'onboarding e il servizio dei dispositivi Room OS e MPP.
Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi di Webex per Cisco BroadWorks.
Articoli Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti siti opzionali per ulteriori informazioni su Webex per Cisco BroadWorks:
Documentazione Webex per Cisco BroadWorks: nella pagina di destinazione vengono elencati i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme a quelle presto disponibili.
Problemi noti e limitazioni: informazioni sui problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale: questo articolo descrive come assegnare i ruoli amministratore partner per le organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte della soluzione Cisco BroadWorks:
Articoli della Guida Webex
I seguenti siti della Guida Webex possono essere utilizzati per trovare gli articoli Webex che consentono agli amministratori dei clienti e agli utenti finali di utilizzare le funzioni Webex.
Webex da provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati comunemente per gli utenti dell'app Webex che hanno acquistato i servizi Webex da un provider di servizi.
Centro assistenza Webex: utilizzare la funzione di ricerca su help.webex.com per cercare altri articoli Webex che descrivono la funzionalità dell'app Webex e di Webex Meetings. È possibile ricercare gli articoli utente o amministratore.
Documentazione sviluppatore
Guida per sviluppatori Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Punti di decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastrutture
|
Quanti ADP XSP|? Come prendono l'mTLS? |
Pianificatore capacità di sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento CLI XSP|ADP Il presente documento |
Provisioning cliente e utente | Puoi affermare che ti fidi dei messaggi e-mail in BroadWorks? Vuoi che gli utenti forniscano indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Documenti API pubbliche su https://developer.webex.com Il presente documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo di branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso per i clienti? | Il presente documento |
Funzioni abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o Softphone. | Il presente documento Matrice caratteristiche/pacchetto |
autenticazione protetta | BroadWorks o Webex | Il presente documento |
Adattatore di provisioning (per opzioni di provisioning flowthrough) | Utilizzate già IM&P integrato, ad esempio per UC-One SaaS? Si desidera utilizzare più modelli? È previsto un caso d'uso più comune? |
Il presente documento Riferimento CLI server applicazioni |
Architettura e infrastrutture
Con che tipo di scala intende iniziare? È possibile scalare in futuro, ma la stima di utilizzo attuale dovrebbe guidare la pianificazione dell'infrastruttura.
Collaborare con il proprio account manager/rappresentante di vendita Cisco per dimensionare l'infrastruttura ADP XSP|, in base al Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
In che modo Webex renderà le connessioni TLS reciproche alle tue ADP XSP|? Direttamente a XSP|ADP in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce. (Non supportiamo connessioni TCP non crittografate al perimetro della rete).
Provisioning cliente e utente
Quale metodo di provisioning utente si adatta meglio?
Provisioning eseguibile con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene predisposto automaticamente in Webex.
Se puoi anche affermare che gli indirizzi e-mail dell'abbonato in BroadWorks sono validi e univoci per Webex, puoi utilizzare la variante "email attendibili" del provisioning flowthrough. Gli account Webex abbonati vengono creati e attivati senza il loro intervento; scaricano semplicemente il client e accedono.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto, il provider di servizi deve fornire un indirizzo e-mail valido all'utente per eseguire il provisioning dei servizi Webex. Questo deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo anche nell'attributo ID alternativo.
Provisioning eseguibile senza e-mail attendibili: Se non riesci a fidarti degli indirizzi e-mail degli abbonati, puoi comunque assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
Self-provisioning utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. Tu (o i tuoi clienti) distribuisci invece un collegamento di provisioning e i collegamenti per scaricare i diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare gli account Webex. Quindi, scaricano il client e accedono e Webex recupera una configurazione aggiuntiva su di essi da BroadWorks (inclusi i numeri principali).
Provisioning controllato da SP tramite API: Webex espone una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei propri flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti di sistema generali descritti in questa guida.
Metodo di provisioning | Requisiti |
---|---|
Provisioning del flusso (e-mail attendibili o non attendibili) | L'API di provisioning Webex aggiunge automaticamente gli utenti BroadWorks esistenti a Webex una volta che l'utente soddisfa i requisiti e si attiva il servizio Integrated IM+P. Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Self-provisioning utente | L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato il messaggio e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) | Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono previsti due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, vai a Utenti BroadWorks. |
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Impostazioni internazionali lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente di amministrazione con provisioning viene assegnata automaticamente come locale predefinita per l'organizzazione del cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti a riunioni all'interno dell'organizzazione del cliente.
Sono supportate le impostazioni internazionali in lingua a cinque caratteri (ISO-639-1)_(ISO-3166). Ad esempio, en_US corrisponde a English_UnitedStates. Se viene richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genera un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso internazionale dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, viene utilizzata l'impostazione locale ragionevole predefinita in base al codice della lingua richiesto.
Nella tabella riportata di seguito vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice lingua a due lettere in un'impostazione locale a cinque caratteri per le situazioni in cui un'impostazione locale a cinque caratteri non è disponibile.
Impostazioni internazionali lingua supportate (ISO-639-1)_(ISO-3166) | Se è disponibile solo un codice lingua a due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** | Usa impostazioni internazionali sensibili di default (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA | en en | en_USA |
fr_Fr fr_CA | Fr | fr_Fr |
cs_CZ | cs | cs_CZ |
da_DK | da | da_DK |
de_DE | DE | de_DE |
hu_HU | hu | hu_HU |
id_ID | ID | id_ID |
it_IT | IT | it_IT |
ja_JP | ja | ja_JP |
ko_KR | ko | ko_KR |
es_ES es_CO es_MX | ES | es_ES |
nl_NL | NL | nl_NL |
nb_NO | nb. | nb_NO |
pl_PL. | pl. | pl_PL. |
pt_PT pt_BR | pt | pt_PT |
ru_RU | RU | ru_RU |
ro_RO | ro | ro_RO |
zh_CN zh_TW | zh | zh_CN |
sv_SE | sv | sv_SE |
ar_SA | ar | ar_SA |
tr_TR | tr | tr_TR |
Le impostazioni internazionali es_CO, id_ID, nb_NO e pt_PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti Webex Meetings saranno solo in inglese. Inglese è la impostazioni internazionali predefinite per i siti se per il sito non sono richieste impostazioni internazionali non valide/non supportate. Questo campo lingua è applicabile durante la creazione di un'organizzazione e un sito Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, la lingua del modello verrà utilizzata come lingua predefinita. |
Branding
Gli amministratori partner possono utilizzare le personalizzazioni avanzate del branding per personalizzare l'aspetto dell'app Webex per le organizzazioni di clienti gestite dal partner. Gli amministratori partner possono personalizzare le seguenti impostazioni per garantire che l'app Webex rifletta il marchio e l'identità della società:
Loghi aziendali
Combinazioni di colori univoche per la modalità Chiaro o Scuro
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione delle personalizzazioni di branding avanzate.
|
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding come richiesto, ma quando si esegue l'onboarding di un cliente è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Alcuni parametri del modello principale sono elencati di seguito.
Pacchetto
È necessario selezionare un pacchetto predefinito quando si crea un modello (vedere Pacchetti nella sezione Panoramica per dettagli). Tutti gli utenti predisposti con tale modello, tramite flowthrough o self-provisioning, ricevono il pacchetto predefinito.
È possibile controllare la selezione dei pacchetti per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno di essi. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori di provisioning per azienda, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
È possibile modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedere Webex per la documentazione API Cisco BroadWorks o attraverso Partner Hub (vedere Modifica pacchetto utente in Partner Hub).
Non puoi modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è attivata o disattivata; se all'abbonato viene assegnato questo servizio in BroadWorks, il modello Partner Hub associato all'URL di provisioning aziendale di tale abbonato definisce il pacchetto.
Rivenditore e aziende o fornitore di servizi e gruppi?
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se sei un rivenditore con Enterprise, devi abilitare la modalità Enterprise quando crei un modello.
Se il sistema BroadWorks è configurato in modalità provider di servizi, è possibile lasciare disattivata la modalità Enterprise nei modelli.
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch BroadWorks richieste per il provisioning flow-through. Per ulteriori dettagli, vedere Patch richieste con provisioning flow-through. |
Modalità di autenticazione
Decidi come desideri che gli abbonati eseguano l'autenticazione quando accedono a Webex. È possibile assegnare la modalità utilizzando l'impostazione Modalità di autenticazione nel modello di onboarding. Nella tabella seguente sono riportate alcune opzioni.
Questa impostazione non ha effetto sull'accesso al portale di attivazione utente. Gli utenti che accedono al portale devono immettere l'ID utente e la password BroadWorks, come configurati su BroadWorks, indipendentemente da come si configura la modalità di autenticazione nel modello di onboarding. |
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | ID utente BroadWorks | Indirizzo e-mail |
Provider identità | BroadWorks.
| Identità comune Cisco |
Autenticazione a più fattori? | No | Richiede IdP del cliente che supporta l'autenticazione a più fattori. |
Percorso di convalida delle credenziali
|
|
|
Per una ripartizione più dettagliata del flusso di accesso SSO con autenticazione diretta a BroadWorks, vedere Flusso di accesso SSO. |
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che si può verificare con password che utilizzano caratteri speciali per cui il browser Web non codifica correttamente i caratteri. Utilizzando un'intestazione con codifica UTF-8, con codifica base 64, risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
Paese
Quando si crea un modello, è necessario selezionare un paese. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie S. | Posizione | Prefisso internazionale | Nome paese |
---|---|---|---|
1 | AMER | +1 | NOI, CA |
2 | APAC | +65 | Singapore |
3 | ANZ | +61 | Australia |
4 | EMEA | +44 | Regno Unito |
5 | EURO | +49 | Germania |
Accordi con più partner
Vuoi concedere in sublicenza Webex per Cisco BroadWorks a un altro provider di servizi? In questo caso, ciascun provider di servizi avrà bisogno di un'organizzazione partner distinta in Webex Control Hub per consentire loro di fornire la soluzione per la propria base clienti.
Adattatore di provisioning e modelli
Quando si utilizza il provisioning flowthrough, l'URL di provisioning inserito in BroadWorks viene derivato dal modello in Control Hub. È possibile disporre di più modelli e quindi di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati al momento della concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e quale modello si desidera utilizzare a tale scopo. In questo modo, è necessario impostare esplicitamente l'URL di provisioning per le aziende che necessitano di un modello diverso.
Inoltre, tenere presente che è possibile che si stia già utilizzando un URL di provisioning a livello di sistema, ad esempio con UC-One SaaS. In tal caso, è possibile scegliere di mantenere l'URL a livello di sistema per il provisioning degli utenti su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono dettagliate in Configura server applicazioni con URL servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning flowthrough tra AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server AS e Webex, annullando in tal modo la necessità di connettersi direttamente al servizio Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati che si sta eseguendo il provisioning per Webex devono esistere nel sistema BroadWorks integrato con Webex. È possibile integrare più sistemi BroadWorks, se necessario.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero o interno principale.
Webex utilizza gli indirizzi e-mail come identificatori principali per tutti gli utenti. Se si utilizza il provisioning flowthrough con e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail degli abbonati nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo di utenti di chiamata BroadWorks con un numero principale e/o interno. Se si utilizza il provisioning flowthrough, agli utenti deve essere assegnato anche il servizio IM&P integrato. |
Server nella rete e requisiti software
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Le istanze BroadWorks devono includere almeno i seguenti server:
Server applicazioni (AS) con versione BroadWorks come sopra
Server di rete (NS)
Server profilo (PS)
Server XSP|ADP o piattaforma di distribuzione delle applicazioni (ADP) di fronte al pubblico che soddisfano i seguenti requisiti:
Servizio di autenticazione (BWAuth)
Interfacce azioni ed eventi XSI
DMS (applicazione Web di gestione dispositivi)
Interfaccia CTI (Intergrazione Di Telefonia Informatica)
TLS 1.2 con certificato valido (non autofirmato) e qualsiasi intermediazione richiesta. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
Autenticazione Mutual TLS (mTLS) per il servizio di autenticazione (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Autenticazione Mutual TLS (mTLS) per l'interfaccia CTI (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Un server XSP/ADP separato che agisce come "Call Notifications Push Server" (un NPS nel tuo ambiente utilizzato per le notifiche di chiamata push per Apple/Google. Lo chiamiamo "CNPS" qui per distinguerlo dal servizio in Webex che fornisce notifiche push per messaggi e presenza).
Questo server deve essere su R22 o versione successiva.
Viene richiesto un server XSP/ADP separato per CNPS poiché l'imprevedibilità del carico da Webex per le connessioni cloud BWKS potrebbe influire negativamente sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSPADP, consultare la Guida tecnica di sistema Cisco BroadWorks|.
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, andare a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
PC/laptop Windows
PC/laptop Apple con MacOS
iOS (Apple Store)
Android (Play store)
Browser Web (vai a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (tradizionale cinese)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (italiano)
Telefoni e accessori fisici
Telefoni IP Cisco:
telefono IP Cisco serie 6800 con firmware multipiattaforma
telefono IP Cisco serie 7800 con firmware multipiattaforma
telefono IP Cisco serie 8800 con firmware multipiattaforma
Vedere https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html per i modelli e ulteriori informazioni.
I telefoni di terze parti sono supportati allo stesso modo di altre integrazioni BroadWorks. Tuttavia, non dispongono ancora dell'integrazione di contatti e presenza con Webex per Cisco BroadWorks.
Adattatori:
Adattatore per telefono analogico multipiattaforma Cisco ATA 191
Adattatore per telefono analogico multipiattaforma Cisco ATA 192
Vedere https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html per i modelli e ulteriori informazioni.
Cuffie:
cuffia Cisco serie 500
Vedi https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html per i modelli e ulteriori informazioni.
Dispositivi Room OS:
Serie Webex Room e Room Kit
Serie Webex Desk
Serie Webex Board
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e l'assistenza dei dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivo
Di seguito sono riportati i file DTAF che devi caricare sui server delle applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia c'è una nuova config-wxt.xml.template
file utilizzato per l'app Webex.
Per scaricare i profili dei dispositivi più recenti, andare al sito di Download software della piattaforma di consegna delle applicazioni per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che per XSP.
Nome del cliente | Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Comunicatore aziendale - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili del dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Genera una richiesta di servizio con l'agente di onboarding o con Cisco TAC per eseguire il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il titolo della richiesta per le rispettive funzioni:
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
'NPS Configuration for Auth Proxy Setup' (Configurazione NPS per impostazione proxy automatica) per configurare NPS per l'uso del proxy di autenticazione.
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori informazioni su questa funzione, vedere: Supporto di Cisco BroadWorks per CI UUID.
Configura BroadWorks per abilitare la fatturazione Cisco per BroadWorks e Webex Per abbonamenti BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento valido per 60 giorni. Se il token scade prima di utilizzarlo, è possibile presentare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali. |
Certificati ordine
Requisiti di certificato per l'autenticazione TLS
Per tutte le applicazioni richieste, saranno necessari i certificati di sicurezza, firmati da un'autorità di certificazione ben nota e distribuiti su ADP XSP|pubblico. Verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in entrata ai server XSP|ADP.
Questi certificati devono includere il nome di dominio pubblico XSP|ADP completo come Nome comune oggetto o Nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati del server dipendono da come vengono distribuiti gli ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume dove il certificato del server pubblico firmato da CA deve essere caricato in questi tre casi:
Le autorità di certificazione supportate pubblicamente dall'app Webex per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per proxy bridge TLS
Il certificato del server firmato pubblicamente viene caricato nel proxy.
Il proxy presenta questo certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Un certificato firmato CA interno può essere caricato su XSP|ADP.
L'|ADP XSP presenta questo certificato del server firmato internamente al proxy.
Il proxy si basa sulla CA interna che ha firmato il certificato del server XSP|ADP.
Requisiti di certificato TLS per proxy passthrough TLS o XSP|ADP in DMZ
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
Gli ADP XSP|presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca sull'interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione Mutual TLS. Il certificato CA/catena del certificato del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedi a Partner Hub, vai a
e fai clic sul collegamento del certificato di download.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume i requisiti del certificato in questi tre casi:
Requisiti del certificato (opzione) per proxy bridge TLS
Webex presenta un certificato client firmato pubblicamente al proxy.
Il proxy considera attendibile la CA interna di Cisco che ha firmato il certificato del client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta il certificato del server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions: X509v3 Extended Key Usage: 1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Il CN del certificato interno deve essere
bwcticlient.webex.com
.
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le autorità pubbliche di certificazione potrebbero non essere disposte a firmare i certificati con l'OIDE proprietario di BroadWorks richiesto. In caso di proxy di bridging, è possibile che sia necessario utilizzare una CA interna per firmare il certificato del client che il proxy presenta all'ADP XSP|.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Il ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XSP| dal proxy.
Requisiti di certificato (opzione) per proxy passthrough TLS o XSP|ADP in DMZ
Webex presenta un certificato client firmato da CA Cisco interno alle ADP XSP|.
Gli ADP XSP|si fidano delle autorità di certificazione interne di Cisco che hanno firmato il certificato client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XSP|.
Gli ADP XSP|presentano i certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Il server applicazioni ClientIdentity contiene il CN del certificato del client firmato Cisco presentato a XSP|ADP da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene l'elenco di indirizzi IP, porte e protocolli richiesti per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle dei firewall delle regole di ingresso e uscita precedenti documentano solo le connessioni specifiche di Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico per Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e la rilevanza di ciascuna sezione per Webex per Cisco BroadWorks.
Sezione Requisiti di Rete Art. | Rilevanza delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex | Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud | Informativo |
Da leggere | |
Da leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex | Da leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione | Opzionale |
Servizi Webex per clienti FedRAMP | N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedi il whitepaper del firewall dell'app Webex (PDF).
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza XSP|ADP di Broadworks fornita dal partner. Quando un ADP o un sito XSP|non è disponibile per manutenzione pianificata o motivo non pianificato, i servizi e le app Webex possono passare a un altro ADP o sito XSP|fornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP Broadworks XSP|possono essere distribuiti direttamente su Internet o possono risiedere in un DMZ frontale da un elemento di bilanciamento del carico come F5 BIG-IP. Per fornire ridondanza geografica, gli ADP XSP|possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un bilanciatore di carico, ognuno con un indirizzo IP pubblico. Se gli ADP XSP| sono dietro a un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e Broadworks sembra avere solo un XSP|ADP, anche se vi sono più ADP XSP| dietro.
Nell'esempio seguente, le ADP|XSP vengono distribuite in due siti, il Sito A e il Sito B. Esistono due ADP|XSP frontali di un bilanciatore di carico in ogni sito. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali di LB1 e il sito B ha XSP|ADP3 e XSP|ADP4 frontali di LB2. Solo i bilanciatori di carico sono esposti sulla rete pubblica e le ADP|XSP sono nelle reti private DMZ.
Servizi cloud Webex
Configurazione DNS
I microservizi cloud Webex devono essere in grado di trovare il server|ADP Broadworks XSP per la connessione alle interfacce Xsi, al servizio di autenticazione e al CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host XSP|ADP configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso. Se vengono restituiti più indirizzi IP, viene selezionato il primo IP nell'elenco. La ricerca SRV non è attualmente supportata.
Esempio: Il DNS A Record del partner per la scoperta del server XSP|ADP/Load Balancers bilanciato Round-Robin.
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Punti a LB1 (Sito A) |
R |
|
| Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Failover
Quando i microservizi Webex inviano una richiesta al servizio |di bilanciamento del carico/ADP XSP e la richiesta non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se non viene ricevuta alcuna risposta HTTP entro 2 secondi, la richiesta viene timeout e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento dell'indirizzamento all'IP successivo.
Ciascuna richiesta viene provata 3 volte prima di segnalare un errore al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco degli indirizzi da provare quando si invia una richiesta a un XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna nell'elenco per provare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco bloccato. Se l'operazione va a buon fine, tale indirizzo IP viene rimosso dall'elenco bloccato.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP|XSP o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster BroadWorks Calling, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
Azioni XSI
Eventi XSI
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Gli stati delle connessioni possono essere:
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
Rosso: Quando tutti gli IP nella ricerca di record sono irraggiungibili e l'interfaccia non è disponibile.
I seguenti servizi utilizzano i microservizi per connettersi agli XSP|ADP e sono interessati dalla disponibilità dell'interfaccia XSP|ADP:
Accesso all'app Webex
Aggiornamento token app Webex
E-mail/autoattivazione non attendibile
Controllo stato servizio Broadworks
App Webex
Configurazione DNS
L'app Webex accede ai servizi Xtended Services Interface (XSI-Actions & XSI-Events) e Device Management Service (DMS) su XSP|ADP.
Per trovare il servizio XSI, l'app Webex esegue la ricerca DNS SRV per _xsi-client._tcp.<webex app xsi domain>
. L'SRV punta all'URL configurato per gli host XSP|ADP o i bilanciatori di carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex torna alla ricerca A/AAAA.
L'SRV può risolversi in più target A/AAAA. Tuttavia, ogni record A/AAAA deve mappare solo a un singolo indirizzo IP. Se sono presenti più ADP|XSP in un DMZ dietro il dispositivo di bilanciamento del carico/bordo, è necessario che il bilanciatore di carico sia configurato per mantenere la persistenza della sessione in modo da indirizzare tutte le richieste della stessa sessione allo stesso XSP|ADP. Questa configurazione viene avviata perché i heartbeat dell'evento XSI del client devono andare allo stesso XSP|ADP utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non deve esistere. Se il DNS richiede che un record A/AAAA deve essere definito, allora deve essere restituito solo 1 indirizzo IP. Indipendentemente da ciò, l'SRV deve essere ancora definito per l'app Webex. Se l'app Webex utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client alla fine invia heartbeat a un XSP|ADP dove non ha stabilito un canale per eventi. Di conseguenza, il canale viene strappato e il traffico interno è notevolmente più intenso, il che pregiudica le prestazioni del cluster ADP|XSP. Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca di record A/AAAA, è necessario utilizzare un nome di dominio completo separato per Webex Cloud e l'app Webex per accedere agli ADP|XSP. Come mostrato negli esempi, Webex Cloud utilizza Un record |
Esempio 1: ADP|XSP multipli, ciascuno dietro bilanciatori di carico separati
In questo esempio, SRV punta a disattivare l'audio dei record A con ogni record A che punta a un bilanciatore di carico diverso su un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito un esempio di record SRV.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Esempio 2: più amministratori XSP| dietro un singolo bilanciatore di carico (con bridge TLS)
Per la richiesta iniziale, il bilanciatore di carico seleziona un XSP|ADP casuale. XSP|ADP restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il bilanciatore di carico utilizza il cookie per indirizzare la connessione all'ADP XSP|corretto, assicurandosi che il canale dell'evento non si interrompa.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Bilanciatore di carico |
R | LB.esempio.com |
| Indirizzo IP del bilanciatore di carico (XSP|ADP sono dietro al bilanciatore di carico) |
URL DMS
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il file di configurazione. Viene eseguita l'analisi dell'organizzatore nell'URL e l'app Webex esegue la ricerca DNS A/AAAA dell'organizzatore per connettersi all'ADP XSP|che ospita il servizio DMS.
Esempio: DNS Un record per la scoperta di Round-Robin bilanciato server XSP|ADP/Bilanciamento del carico di Webex App per scaricare i file di configurazione tramite DMS:
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
R |
|
| Indica LB1 (sito A) |
R |
|
| Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Come l'app Webex trova gli indirizzi XSP|ADP
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (sono stati inseriti quando si crea il cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue la ricerca SRV nel modo seguente:
Il cliente esegue una ricerca SRV per _xsi-cliente._tcp.<xsi domain="">
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
Il cliente cerca gli obiettivi A/AAAA e memorizza nella cache gli indirizzi IP restituiti.
Il client si connette a uno dei target (e quindi al suo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi al peso (o a caso se sono tutti uguali).
Se la ricerca SRV non restituisce alcun obiettivo:
Il client esegue una ricerca A/AAAA del parametro principale Xsi e quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso.
Come indicato, il record A/AAAA deve risolversi in un indirizzo IP per le stesse ragioni.
(Opzionale) Successivamente, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocols> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
Se esistono, il client confronterà l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
Se viene rilevata una differenza, il client re-inizializzerà la connettività XSI Actions/XSI Events. La prima fase consiste nell'eseguire lo stesso processo di ricerca DNS elencato nella fase 1, richiedendo questa volta una ricerca del valore nel %XSI_ROOT_WXT% parametro dal file di configurazione.
Assicurarsi di creare i record SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
Failover
Durante l'accesso, l'app Webex esegue una ricerca DNS SRV per _xsi-client._tcp.<xsi domain="">, crea un elenco di organizzatori e si connette a uno degli organizzatori in base alla priorità SRV, quindi al peso. Questo organizzatore connesso diventa quello selezionato per tutte le richieste future. Viene quindi aperto un canale evento all'organizzatore selezionato e viene inviato regolarmente un heartbeat per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP, pertanto è importante che il bilanciatore di carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server XSP|ADP di backend.
Se una richiesta o una richiesta heartbeat a un organizzatore non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), l'indirizzamento dell'app Webex viene eseguito immediatamente all'organizzatore successivo nell'elenco.
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e l'indirizzamento passa all'organizzatore successivo nell'elenco.
Se una risposta non viene ricevuta entro un periodo di tempo, la richiesta viene considerata non riuscita a causa del timeout e le richieste successive vengono inviate al successivo organizzatore. Tuttavia, la richiesta scaduta viene considerata come non riuscita. Alcune richieste vengono riprovate dopo l'errore (con un tempo di riprova crescente). Le richieste che il presunto non vitale non sono riprovate.
Quando un nuovo organizzatore viene provato correttamente, diventa il nuovo organizzatore selezionato se l'organizzatore è presente nell'elenco. Una volta provato l'ultimo organizzatore nell'elenco, l'app Webex passa al primo.
In caso di heartbeat, se si verificano due errori di richiesta consecutivi, l'app Webex re-inizializzerà il canale eventi.
Tenere presente che l'app Webex non esegue il failback e che il rilevamento del servizio DNS viene eseguito solo una volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione attraverso l'interfaccia XSP|ADP/Dms. Esegue una ricerca di record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Innanzitutto, tenterà di inviare la richiesta per scaricare il file di configurazione utilizzando un token SSO. Se ciò non riesce per qualsiasi motivo, verrà riprovato ma con il nome utente e la password del dispositivo.
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning dell'utente. Molte delle attività sono comuni a tutte le modalità di provisioning.
Onboarding dei partner per Webex per Cisco BroadWorks
Ciascun provider o rivenditore di servizi Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, è necessario eseguire la documentazione Cisco BroadWorks di Webex e i nuovi partner devono accettare l'ICPA (Indirect Channel Partner Agreement) online. Al termine di queste operazioni, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, il tuo Partner Activation e/o Customer Success Program Manager ti contatterà per iniziare il tuo onboarding.
I partner Webex in una regione possono creare organizzazioni di clienti in qualsiasi regione in cui offriamo i servizi. Per informazioni, vedere: Residenza dati in Webex. |
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
È necessario eseguire l'applicazione NPS su un altro XSP|ADP. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi sugli ADP XSP|.
Servizio/Applicazione | Autenticazione richiesta | Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
autenticazione protetta |
Integrazione telefonia computer |
mTLS (client e server si autenticano a vicenda) |
Presenza di telefonia |
Applicazione Webview Impostazioni chiamata |
TLS (il server esegue l'autenticazione per i client) |
Mostra le impostazioni di chiamata utente nel portale Assistenza utente all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma occorre fare riferimento alla documentazione esistente per installare le applicazioni sugli ADP|XSP.
Requisiti di coresidenza
Il servizio di autenticazione deve essere coresidente con le applicazioni Xsi, perché tali interfacce devono accettare token di lunga durata per l'autorizzazione del servizio. Il servizio di autenticazione è richiesto per convalidare tali token.
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
È possibile separare gli altri servizi/applicazioni come richiesto per la propria bilancia (gestione dispositivi dedicata XSP|ADP farm, ad esempio).
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
Non installare altre applicazioni o servizi sugli ADP XSP| utilizzati per integrare BroadWorks con Webex.
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se è in esecuzione R22 o versione superiore e il sistema lo supporta.
Mutual TLS (mTLS) è supportato anche come metodo di autenticazione alternativo per il servizio Auth. Se più organizzazioni Webex eseguono lo stesso server ADP XSP|, è necessario utilizzare l'autenticazione mTLS poiché la convalida token CI non supporta più connessioni allo stesso servizio autenticazione ADP XSP|. Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida del token CI, fare riferimento all'Appendice per configurare i servizi (con mTLS per il servizio di autenticazione). |
Se attualmente si utilizza mTLS per il servizio autenticazione, non è obbligatorio riconfigurare l'uso della convalida token CI con TLS. |
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks.
Installare le seguenti patch su ciascun server ADP XSP|. Installare le patch appropriate alla release in uso:
Per R22:
Per R23:
Per R24: non è necessario alcun cerotto
Qualsiasi riferimento a XSP include XSP o ADP.Installare il
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP al percorso del contesto /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire il servizio di autenticazione su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
A partire da Broadworks build 2022.10, le autorità di certificazione in arrivo con Java non vengono più automaticamente incluse nel trust store BroadWorks quando si passa a una nuova versione di java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
Radice commerciale IdenTrust CA 1
autorità di certificazione radice Go Daddy - G2
Verificare che questi certificati siano presenti sotto la seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get
Se non presente, eseguire il seguente comando per importare i trust Java predefiniti:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come ancoraggi attendibili con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono automaticamente importate nella nuova release e continueranno a essere importate finché non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere la FD di convalida del certificato Cisco Broadworks X509.
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server ADP XSP|:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get
set clientId client-Id-From-Step1
set enabled true
set clientSecret client-Secret-From-Step1
set ciResponseBodyMaxSizeInBytes 65536
set issuerName <URL>
- Per ilURL
, immettere l'URL IssuerName che si applica al cluster CI. Vedere la tabella seguente.set issuerUrl <URL>
- Per ilURL
, immettere l'IssuerUrl che si applica al cluster CI. Vedere la tabella seguente.set tokenInfoUrl <IdPProxy URL>
—Inserire l'URL proxy IdP applicabile al cluster dei team. Si veda la seconda tabella che segue.
Tabella 1. Imposta nome emittente e URL emittente Se il cluster CI è... Imposta issuerName e issuerURL su... NOI-A
UE
NOI-B
Se non conosci il tuo cluster CI, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.Tabella 2. Imposta tokenInfoURL Se il cluster di Teams è... Imposta tokenInfoURL su...(URL proxy IdP) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AFRA
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
DOLORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.
Per il test, è possibile verificare che il tokenInfoURL sia valido sostituendo "
idp/authenticate
" parte dell'URL con "ping
".
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user
Configurare i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get
set flsUrl https://cifls.webex.com/federation
set refreshPeriodInMinutes 60
set refreshToken refresh-Token-From-Step1
Eseguire il seguente comando per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get
Configurare la gestione dei token utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
set tokenIssuer BroadWorks
set tokenDurationInHours 720
Genera e condividi chiavi RSA. È necessario generare chiavi su un XSP|ADP, quindi copiarle su tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP.Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web. Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token. Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Rimozione dei requisiti di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con la convalida del token CI su R24, è necessario rimuovere anche il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Interfaccia CTI e configurazione correlata
Di seguito viene elencato l'ordine di configurazione "da più a più". In seguito a questo ordine non è obbligatorio.
Configurazione del server di applicazione per gli abbonamenti CTI
Configurazione di XSP|ADPs per abbonamenti CTI autenticati mTLS
Apertura delle porte in entrata per l'interfaccia CTI protetta
Abbonamento dell'organizzazione Webex agli eventi CTI di BroadWorks
Configurazione del server di applicazione per gli abbonamenti CTI
Aggiornare ClientIdentity su Application Server con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ciascun server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è |
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocol> |
Una specifica interfaccia CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocol> |
Su una nuova installazione, le seguenti crittografie sono installate per impostazione predefinita a livello di sistema. Se non è configurato nulla a livello di interfaccia (ad esempio, nell'interfaccia CTI o HTTP), si applica questo elenco di crittografia. Si noti che questo elenco può cambiare nel tempo:
|
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp>
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
Inserisci il
get
comando per visualizzare le crittografie già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, si utilizzerebbe:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Ancoraggi affidabili per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che le ADP XSP|siano rivolte verso Internet o rivolte verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy bridge (vedere Requisiti del certificato TLS per proxy bridge TLS).
Per ogni amministratore XSP|nell'infrastruttura che pubblica eventi CTI in Webex, effettuare le seguenti operazioni:
Accedere a Hub partner .
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.
Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
(Opzionale) Esecuzione
help updateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot2023
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
Consenti ai client di autenticarsi con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione BroadWorks in uso. Il comando crea un certificato server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. È necessario l'indirizzo IP dell'interfaccia CTI per questo; è possibile leggerlo dal seguente contesto:
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>
Riavviare XSP|ADP.
Abilitazione dell'accesso a BroadWorks CTI Events su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
Specificare l'indirizzo CTI in base al quale Webex può iscriversi a CTI Events di BroadWorks.
Gli abbonamenti CTI sono su base per abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato viene predisposto per Webex per Cisco BroadWorks.
Visualizzazione Webview Impostazioni chiamata
Call Settings Webview (CSWV) è un'applicazione ospitata su XSP|ADP per consentire agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview per le impostazioni di chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono native dell'app Webex.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, è necessario distribuire la funzione Webview impostazioni chiamata.
La vista Webview impostazioni chiamata presenta due componenti:
Applicazione Webview Impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
App Webex, che esegue il rendering delle impostazioni di chiamata in una vista Webview.
Esperienza utente
Utenti Windows: Fai clic su Impostazioni chiamata, quindi su .
Utenti Mac: Fare clic sull'immagine del profilo, quindi
.
Distribuzione di CSWV su BroadWorks
Installazione di Webview impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso ADP|XSP che ospita l'interfaccia Xsi-Actions nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
Accedere a cisco.com e cercare "BWCallSettingsWeb" nella sezione download software.
Trovare e scaricare la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) è stata la più recente al momento della stesura del presente documento.Installare, attivare e distribuire l'archivio Web in base alla Guida alla configurazione della piattaforma di servizi Xtended di Cisco BroadWorks per la versione XSP|ADP. (Versione R24 https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
.Passare al seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più necessario).Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario fornire anche un contextPath perché è un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio
/callsettings
.Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
Ora è possibile prevedere l'URL delle impostazioni di chiamata che si specificherà per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
L'|ADP-FQDN XSP deve corrispondere al FQDN azioni Xsi, perché CSWV deve utilizzare le azioni Xsi e CORS non è supportato.
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview Impostazioni chiamata è ora attiva sugli ADP|XSP.
Configura l'app Webex per utilizzare Webview impostazioni chiamata
Per ulteriori dettagli sulla configurazione del client, vedere la Guida alla configurazione di Webex per Cisco BroadWorks.
Nel file di configurazione dell'app Webex è presente un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti attraverso l'interfaccia dell'applicazione.
<config>
<services>
<web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%">
<url>%WEB_CALL_SETTINGS_URL_WXT%</url>
</web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel %WEB_CALL_SETTINGS_URL_WXT% tag.
Se non si specifica esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
Imposta la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
Il file di configurazione client risultante dovrebbe avere una voce come segue:
<web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push delle chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Call Notifications Push Server (CNPS) per descrivere un'applicazione ospitata XSP o ospitata ADP che viene eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti e invia le notifiche a Google Firebase Cloud Messaging (FCM) o Apple Push Notification Service (APN).
Tali servizi notificano ai dispositivi mobili degli abbonati Webex per Cisco BroadWorks la presenza di chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzione Notification Push Server.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi a loro volta notificano agli utenti mobili Webex le modifiche ai messaggi in arrivo o alla presenza.
In questa sezione viene descritto come configurare l'NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se è necessario eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPShttps://help.webex.com/nl5rir2/. |
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario aggiornare il CNPS per supportare la funzione proxy NPS, server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server di notifica push per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e i tasti di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend di Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APN Apple e i servizi FCM Google.
La funzione migliora anche la capacità del server push delle notifiche di eseguire notifiche push ai dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
Per ulteriori informazioni, vedere Server push per VoIP nella descrizione della funzione UCaaS.
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software e le patch NPS, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Cercare e scaricare la patch dalla pagina di download del software.
Ulteriori informazioni sul server ADP sono disponibili su https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio Apple Push Notification dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per APN. Questo aggiornamento richiede che XSP|ADP che ospita l'NPS esegua R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 | Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma di consegna dell'applicazione (ADP). | ||
2 | Installare le patch proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: | ||
3 | Attivare l'applicazione Notification Push Server. | ||
4 | (Per le notifiche Android) Abilitare l'API FCM v1 sull'NPS.
| ||
5 | (Per le notifiche Apple iOS) Abilitare HTTP/2 su NPS.
| ||
6 | Collegare un supporto tecnico dell'NPS XSP/ADP. | ||
7 | Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN UN 10.193.78.149
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configura NPS per utilizzare il proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Migra NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un server NPS condiviso con altre app mobili, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPS ( https://help.webex.com/nl5rir2).
1 | Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 | Creare l'account cliente su NPS:
Per verificare che i valori inseriti corrispondano a quanto ricevuto, eseguire
| |||||||||||||||||||
3 | Immettere l'URL proxy NPS e impostare l'intervallo di aggiornamento del token (consigliato 30 minuti):
| |||||||||||||||||||
4 | (Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 | (Per le notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, assicurandosi di omettere il tasto Auth – impostarlo su vuoto.
| |||||||||||||||||||
6 | Configurare i seguenti URL NPS:
| |||||||||||||||||||
7 | Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 | Verificare se il server applicazioni sta eseguendo lo screening degli ID applicazione, poiché potrebbe essere necessario aggiungere le app Webex all'elenco utenti autorizzati: | |||||||||||||||||||
9 | Riavviare XSP|ADP: | |||||||||||||||||||
10 | Esegui test delle notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migrazione di NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente che è necessario eseguire la migrazione a FCMv1. Sono previste tre procedure:
Esegui migrazione dei client UC-One a FCMv1: quando disponi di client UCaaS esistenti e devi migrarli per utilizzare FCMv1.
Migrazione dei client SaaS a FCMv1: quando si dispone di client SaaS esistenti e occorre migrarli per utilizzare FCMv1.
Aggiorna server ADP: quando si esegue la migrazione di NPS a un server ADP.
Migrazione dei client UC-One a FCMv1
Utilizzare la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere . L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile Connect su https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al
|
Accedere a SDK amministratore FCM su http://console.firebase.google.com.
Selezionare l'applicazione Android appropriata.
Nella scheda General (Generale), registrare l’ID del progetto
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
Fare clic sul pulsante blu per creare un nuovo account di servizio
Fai clic sul pulsante blu per generare una nuova chiave privata
Chiave di download per una posizione sicura
Per riutilizzare un account servizio esistente:
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
Identificare l'account servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
Copiare il file json su XSP|ADP.
Configurare l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== my_project ********
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Migrazione dei clienti SaaS a FCMv1
Se si desidera eseguire la migrazione dei client SaaS a FCMv1, attenersi alla procedura seguente su Google FCM Console.
Assicurarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione". |
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Aggiorna server ADP
Se si esegue la migrazione dell'NPS per utilizzare un server ADP, utilizzare i passaggi seguenti nella console Google FCM.
Ottenere il file JSON dalla console cloud di Google:
Su Google Cloud Console, andare alla pagina Account servizio.
Fare clic su Seleziona un progetto, scegliere il progetto e fare clic su Apri.
Trova la riga dell'account servizio per la quale desideri creare una chiave, fai clic sul pulsante Altro verticale, quindi fai clic su Crea chiave.
Selezionare un tipo di chiave e fare clic su Crea
Il file viene scaricato.
Aggiungere FCM al server ADP:
Importare il file JSON nel server ADP utilizzando il
/bw/install
comando.Accedere all'ADP CLI e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON
:Quindi, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò avviene per i seguenti motivi:
Per consentire a Webex cloud di autenticare i tuoi utenti rispetto a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
Per consentire alle app Webex di utilizzare l'interfaccia Xsi per il controllo delle chiamate.
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se alcune interfacce non vengono convalidate correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide. Ciò viene impedito poiché un cluster configurato in modo errato potrebbe causare problemi che sono difficili da risolvere. |
Cosa è necessario fare:
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Se l'utente amministratore non ha visibilità delle impostazioni di BroadWorks Calling , si consiglia di aprire un caso con Cisco TAC.
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
Assegna un nome al cluster e fai clic su Avanti.
Il concetto di cluster qui è semplicemente una raccolta di interfacce, solitamente situate su un server ADP XSP| o in un'azienda agricola, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il sistema BroadWorks non sono applicabili qui.
(Opzionale) Immettere un Nome account utente e una Password BroadWorks noti all'interno del sistema BroadWorks che si connette a Webex, quindi fare clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
Aggiungere gli URL XSI Actions e XSI Events.
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
Opzionale. Selezionare la casella di controllo Abilita autenticazione diretta BroadWorks se si desidera che gli accessi a BroadWorks siano diretti a BroadWorks. In caso contrario, l'autenticazione per BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo influisce su queste situazioni di accesso:
Accesso al portale di attivazione utente: gli utenti devono immettere le credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o attraverso il proxy IdP.
Accesso client: se l'autenticazione BroadWorks è configurata nel modello di onboarding, l'impostazione precedente determina se l'accesso del client all'app Webex è diretto a BroadWorks o viene proxy attraverso il proxy IdP.
Fai clic su Avanti.
Nella pagina CTI Interface (Interfaccia CTI) procedere come segue:
Aggiungere l'URL CTI e la porta per l'interfaccia CTI a cui si desidera connettersi.
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
Opzionale. Abilita il tasto di alternanza Non disturbare (NoDist) e inserisci l'ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurandosi che la funzione funzioni allo stesso modo su entrambe le piattaforme.
Fai clic su Avanti.
Aggiungere l'URL del servizio di autenticazione.
Selezionare Servizio autenticazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex poiché il servizio di autenticazione convalida correttamente il token utente rispetto al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
Controllare le voci sulla schermata finale, quindi fare clic su Crea. Dovrebbe essere visualizzato un messaggio di successo.
Partner Hub passa gli URL a vari microservizi Webex che testano le connessioni alle interfacce fornite.
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è riuscita.
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Abbiamo implementato questa verifica per prevenire errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, caricatore di bilanciamento o firewall) come illustrato in questa guida, prima di salvare il modello.
Verifica delle connessioni alle interfacce BroadWorks
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Visualizza cluster.
Partner Hub avvia i test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina dell'elenco dei cluster mostra il messaggio di stato accanto a ciascun cluster.
I messaggi verdi relativi al successo dovrebbero essere visualizzati. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio XSI-Actions, XSI-Events, DAS URL e le impostazioni dell'interfaccia CTI.
Configurazione dei modelli di onboarding
I modelli di onboarding sono il modo in cui verrà applicata la configurazione condivisa a uno o più clienti man mano che vengono caricati tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma solo un modello può essere associato a un cliente.
Accedere a Partner Hub e selezionare Clienti.
Fare clic sul pulsante Modelli di onboarding per visualizzare i modelli esistenti.
Fare clic su Crea modello.
Nella finestra Dettagli modello, aggiungere il nome del modello, il paese o la regione e la lingua e-mail predefinita.
Nella finestra Impostazione servizio, utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
Immettere un Nome modello, quindi fare clic su Avanti.
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per diverse modalità di provisioning Nome impostazione
Provisioning fluviale con e-mail attendibili
Provisioning flowthrough senza e-mail
Self-provisioning utente
Abilita flusso BroadWorks attraverso il provisioning (include le credenziali dell'account di provisioning se attivato**)
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il †
Il †
Il †
Indirizzo e-mail provider servizi
Selezionare un indirizzo e-mail dall'elenco a discesa (è possibile digitare alcuni caratteri per trovare l'indirizzo, se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello di onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature tra paese e regione in questo foglio di calcolo.
Il paese dell'organizzazione determina i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni consultare la sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questo interruttore spento.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note dalla tabella:
† Questo passaggio garantisce che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa opzione deve essere sempre attiva, a meno che non si utilizzi un processo manuale di ordinazione ed esecuzione (tramite Cisco Commerce Workspace) per creare le organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello di "provisioning ibrido" e non rientra nel campo di applicazione di questo documento.
** "Account di provisioning" si riferisce all'account di amministrazione a livello di sistema BroadWorks. Su BroadWorks, è necessario un account amministratore con questi attributi: Tipo amministratore=Provisioning, sola lettura=Disattivato.
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
Opzionale. Selezionare Disabilita chiamata gratuita Cisco Webex se si desidera disabilitare le chiamate Webex.
Per la configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
Numeri di chiamata in ingresso Cisco (PSTN)
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
Fai clic su Avanti.
Esistono due approcci per il provisioning degli abbonati relativamente a come vengono verificate le relative identità, utilizzando e-mail attendibili o e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile, gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. In qualità di partner, sei responsabile del provisioning dell'indirizzo e-mail come parte del metodo flow-through o API.
Si consiglia vivamente di utilizzare il metodo di provisioning attendibile poiché garantisce che tutti gli abbonati siano completamente predisposti dall'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso e-mail non attendibile, gli utenti devono verificare i relativi messaggi e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome impostazione
Provisioning flowthrough senza e-mail
Self-provisioning utente
Esegui prima provisioning amministratore
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
Note dalla tabella:
* Ciascuna organizzazione cliente in Webex deve disporre di almeno un utente con ruolo di amministratore. Il primo utente a cui assegnare IM&P integrato in BroadWorks assume il ruolo di amministratore del cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di fornitore di servizi è possibile avere il controllo su chi ottiene il ruolo. La verifica di questa impostazione impedisce agli utenti di completare l'attivazione fino a quando non viene attivato il primo utente fornito. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
Fai clic su Avanti.
Selezionare la modalità di autenticazione predefinita (autenticazione BroadWorks o autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.(Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
Fai clic su Avanti.
Per Preferenze, configurare quanto segue:
Scegliere se si desidera Precompilare gli indirizzi e-mail utente nella pagina di accesso.
Utilizzare questa opzione solo dopo aver selezionato Autenticazione BroadWorks e aver anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il nome utente BroadWorks. La pagina di accesso offre l'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
Se desideri abilitare la sincronizzazione delle rubriche, imposta l'opzione Abilita sincronizzazione rubrica telefonica per tutte le nuove organizzazioni clienti per attivare.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
Immettere un amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatico di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
Assicurati che l'opzione Consenti invito e-mail amministratore quando ti colleghi a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
Fai clic su Avanti.
Esaminare le voci nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Dovrebbe essere visualizzato un messaggio di successo.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con altri modelli.
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario immettere nuovamente i dettagli dell'account di provisioning. I campi Password vuota/Conferma password sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori forniti alla procedura guidata.
Aggiungi altri modelli se disponi di diverse configurazioni condivise che desideri fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbe essere necessario specificare i dettagli del modello per una delle attività seguenti.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning. |
Patch Application Server (solo R22, R23 e R24)
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
Per R22:
AP.as.22.0.1123.ap373197
Per R23:
AP.as.23.0.1075.ap373197
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che costituiscono il requisito per la distribuzione di Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.Modifica della
Maintenance/ContainerOptions
contesto.Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true
Scarica gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interfaccia > Messaggistica e Servizio > IM&P integrato) dei comandi AS.
Accedi a Partner Hub e vai a
.Fare clic su Visualizza modelli.
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro flyout a destra. Se non è stato ancora creato un modello, è necessario farlo prima di poter ottenere l'URL di provisioning.
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per altri modelli se si dispone di più modelli.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema su server applicazioni
Se si utilizza UC-One SaaS, potrebbe non essere necessario impostare il provisioning e il dominio del servizio a livello di sistema. Vedere i Punti di decisione nella sezione Preparazione dell’ambiente. |
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password
AS_CLI/Interface/Messaging> set enableSynchronization true
Attivare l'interfaccia IMP integrata:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
È necessario inserire il nome completo per il |
(Opzione) Configurazione dei parametri di provisioning per azienda su server applicazioni
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
Selezionare Usa dominio di servizio e immettere un valore fittizio (Webex ignora questo parametro). È possibile utilizzare
example.com
).Selezionare Usa server di messaggistica.
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
È necessario inserire il nome completo per il
provisioningURL
parametro, come è stato dato in Partner Hub. Se il server applicazioni non può accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel/etc/hosts
file su AS.Nel campo Nome utente, immettere un nome per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Immettere una password per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Per Identità utente predefinita per ID IM&P, selezionare Principale.
Fare clic su Applica.
Ripeti per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning utente, vedi Provisioning utente provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning aiuta amministratori e team di vendita controllando la presenza di errori prima di eseguire il provisioning di un cliente o abbonato per un pacchetto. Gli utenti o le integrazioni autorizzati da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per assicurarsi che non vi siano conflitti o errori con il provisioning del pacchetto per un determinato cliente o abbonato.
L'API verifica se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto a un cliente o partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, è possibile correggere gli errori prima del provisioning, aumentando la probabilità di un provisioning riuscito.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore Webex per la vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare di un provisioning abbonato all'ingrosso
Per accedere a Precontrolla un documento di provisioning abbonato Wholesale, devi accedere al portale https://developer.webex.com/. |
Partner SSO - SAML
Consente agli amministratori dei partner di configurare l'SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La seguente procedura SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere la funzionalità SSO del partner a un'organizzazione cliente esistente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso. Per aggiungere SSO partner a un'organizzazione esistente, è necessario aprire un ticket con Cisco TAC. |
Verificare che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'integrazione Single Sign-On in Control Hub.
Aprire una richiesta di servizio con Cisco TAC. TAC deve stabilire una relazione di trust tra il provider di identità di terze parti e il servizio Cisco Common Identity. .
Se l'IdP richiedepassEmailInRequest
da abilitare, accertarsi di includere questo requisito nella richiesta di servizio. Controlla con il tuo IdP se non sei sicuro che questa funzione sia necessaria.Carica il file di metadati CI fornito da TAC al provider di identità.
Configurare un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, immettere l'ID entità dall'XML metadati SAML del provider di identità di terze parti.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
Proprio che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori dei partner di configurare l'SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per impostare SSO OIDC partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già caricate utilizzando il modello. |
Aprire una richiesta di servizio con il centro TAC di Cisco con i dettagli dell'IDP di connessione OpenID. Sono obbligatori e facoltativi gli attributi IDP. TAC deve impostare l'IDP sul CI e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC, potrebbe consistere in lettere, numeri, trattini, sottolineature, inclinazioni e punti e la lunghezza massima è 128 caratteri.
Id client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Segreto client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco degli ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio, ad esempio "profilo e-mail openid" Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non fornito
URL dell'endpoint di autorizzazione OAuth 2.0 dell'IdP.
endpoint token
Sì se discoveryEndpoint non fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
endpoint infoutente
No
URL dell'endpoint UserInfo di IdP.
Endpoint set di tasti
No
URL dell'endpoint JSON Web Key Set dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
Configurare l'URI di reindirizzamento sull'IDP di connessione OpenID.
Configurare un modello di onboarding. Per l'impostazione della modalità di autenticazione, selezionare Autenticazione partner Con OpenID Connect e immettere il nome IDP fornito durante l'impostazione IDP come ID entità IDP OpenID Connect.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui registrazione chiamata, risposta per assente di gruppo, dirigente e assistente di direzione.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
Eseguire i seguenti comandi sulle interfacce AS. Ciò consentirà all’AS di inviare il c.d.
X-BroadWorks-Correlation-Info
Intestazione SIP:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true
Il
enableCallCorrelationID
Il parametro associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione delle informazioni di correlazione delle chiamate nei registri Xsi-Actions. Si raccomanda di avereenableCallCorrelationID
abilitato utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione dell'identificativo di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione della rubrica garantisce che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la directory di chiamata completa dal server BroadWorks viene sincronizzata con la directory Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione rubriche, vai a Sincronizzazione rubriche in Webex per Cisco BroadWorks.
Webex per Cisco BroadWorks flowthrough provisioning aggiunge utenti di messaggistica e informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, gli elenchi telefonici, gli utenti non di messaggistica e le entità non utenti non sono inclusi (ad esempio, un telefono della sala conferenze, un fax o un numero di gruppo di risposta). L'attivazione della sincronizzazione delle rubriche garantisce che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex. |
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia chiamate e riunioni unificate Webex visualizzata sull'app Webex. Gli utenti possono visualizzare la cronologia dettagliata delle chiamate e della riunione dall'app Webex.
La cronologia chiamate unificata può essere abilitata dagli amministratori a livello di partner in Partner Hub su base cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
Eventi cronologia chiamate: questi eventi vengono utilizzati per creare una cronologia chiamate unificata dettagliata
Eventi di stato hook: la cronologia chiamate unificata include ottimizzazioni dello stato hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di Telephony Presence
Requisiti della cronologia chiamate unificata
Prima di configurare la cronologia chiamate unificata, accertarsi di aver eseguito la patch del sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
AP.as.22.0.1123.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per R23:
AP.as.23.0.1075.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Se si utilizza XSP—
AP.xsp.23.0.1075.ap378585
In caso di utilizzo di ADP
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
AP.as.24.0.944.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per l'elenco completo delle patch BroadWorks che è necessario installare come prerequisito per l'esecuzione di Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella sezione Riferimento. |
Oltre alla patch del sistema, il file di configurazione del client ( config-wxt.xml
) deve avere il seguente set di tag: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altro reindirizzamento nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
AP.as.23.0.1075.ap383346
AP.as.23.0.1075.ap383994
Per R24:
AP.as.24.0.944.ap383346
AP.as.24.0.944.ap383994
Per avere informazioni Dirigente-Assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
AP.as.24.0.944.ap380052
AP.as.24.0.944.ap384239
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare anche la sincronizzazione delle rubriche per la cronologia chiamate unificata dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione NoDist, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti nel cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione di Broadworks durante la stessa finestra di manutenzione. |
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configura organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettuare le seguenti operazioni:
Accedi a Partner Hub su
admin.webex.com
.Andare a Impostazioni e selezionare un cluster esistente.
Verificare che la connessione al cluster sia buona. Nel pannello a destra viene visualizzato un segno di spunta verde con Connection stabilita.
Se questa opzione non viene visualizzata, in Check Connnections (Opzionale), immettere BroadWorks User Id e BroadWorks Password e fare clic su Check per verificare che la connessione sia corretta.
Selezionare la casella di controllo Abilita cronologia chiamate.
Fai clic su Salva.
Interazioni funzione
Per la cronologia chiamate unificata sono presenti le seguenti interazioni delle funzioni:
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando questa situazione esiste, gli eventi Cronologia chiamate e Stato hook non vengono inviati all'app Webex.
La cronologia chiamate unificate non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia chiamate unificata dall'app Webex. Per informazioni dettagliate, vedere: Webex | visualizza cronologia chiamate e riunioni.
Disabilita cronologia chiamate unificata
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visivo
L'app Webex supporta un'indicazione visiva delle chiamate spam nel avviso popup quando la chiamata viene presentata al destinatario e nei record della cronologia delle chiamate unificate quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per utilizzare questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- Le seguenti patch devono essere installate e attive:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o AS-25_Rel_2022.12 come minimo
- La funzione deve essere attivata tramite AS CLI:
- AS_CLI/System/ActivatableFeature> attivare 104112
- AS_CLI/System/StirShaken> imposta enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'etichettatura e la verifica STIR-SHAKEN come descritto in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste di invito inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti che vengono inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione di spam visivo nella presentazione della chiamata e nella cronologia chiamate unificata della chiamata.
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenta di identificare il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra di chiamata e una volta completata la chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante abbinando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se trova più istanze di un numero in un'origine, non tenterà di sceglierne una, in questo caso, non visualizzerà alcun ID chiamante. |
Webex Common Identity (CI) che contiene gli utenti della tua organizzazione.
Contatti personali e aziendali. I contatti personali sono visibili nella scheda Contatti.
Rubrica locale. In Windows - applicazione Outlook, in Mac - Contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non viene trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, utilizzerà la parte del nome utente dell'URI SIP dall'intestazione SIP From come ultima risorsa.
Per il controllo delle chiamate remote (ad esempio, modalità di controllo del telefono fisso) vengono utilizzate informazioni XSI, dove viene utilizzato ID BWKS o interno, estratte da informazioni di parte remota nell'evento XSI. Se l'informazione della parte remota non è disponibile, verrà utilizzata P-Asserted Identity (PAI) (se configurata).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica di chiamata e nella cronologia chiamate.
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
Coda Call Center: Visualizza il nome della coda che ha inoltrato la chiamata.
Dirigente-Assistente: Mostra il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
Per le chiamate nella coda chiamate interna, in cui un agente richiama una parte interna, la parte remota non visualizzerà il nome della coda chiamata, ma il nome dell'agente che le chiama.
Chiamata con risposta altrove:
Per gruppi di risposta o code chiamate impostate con indirizzamento simultaneo, gli agenti visualizzeranno una chiamata che ha ricevuto risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di risposta o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate perse nella cronologia chiamate se risposte da un altro agente.
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni da tavolo. Questa funzione specifica consente di assegnare gli indicatori di linea condivisa all'app Webex dell'utente finale.
Questa funzione consente agli utenti di gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente alle linee condivise.
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise dal client Webex
R23 senza ADP:
AP.as.23.0.1075.ap384179
AP.xsp.23.0.1075.ap384179
R23 con ADP:
AP.as.23.0.1075.ap384179
Xsi-Actions-23_2022.10
R24:
IN QUANTO: AP.as.24.0.944.ap384179
Xsi-Actions-24_2022.10
R25:
IN QUANTO: Versione RI Rel_2022.10_1.310
Xsi-Actions-25_2022.10
Cerotto 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo. Esempio: Per il client desktop: Sistema>Tipo di profilo identità/dispositivo - Modifica> Business Communicator - PC: Profilo, opzioni standard, numero di porte:
- SE l'opzione 'Illimitato' è abilitata, non è richiesta alcuna modifica
- SE 'Limitato a' è <10, modificare il valore = 10 e salvarlo per utilizzare tutte le linee disponibili
Versione RI Rel_2022.10_1.310
Sincronizzazione Non disturbare (NoDist).
La sincronizzazione Non disturbare (NoDist) allinea le impostazioni NoDist tra Webex e BroadWorks sincronizzando lo stato NoDist tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato si sincronizza con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. Analogamente, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist da una piattaforma non vengono riconosciuti dall'altra piattaforma.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Se sono presenti molti clienti (>50) nel cluster BroadWorks, la sincronizzazione NoDist non è supportata. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza. |
Prerequisiti
Assicurarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione BroadWorks.
Per la versione 23:
<snipped>
- App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
<snipped>
- App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 su AS:
AS_CLI/System/ActivatableFeature> activate 25433
Se sono presenti molti clienti (>50) nel cluster BroadWorks, operazioni come l'aggiornamento di azioni XSI, eventi XSI, URL DAS, URL XSP|ADP o sincronizzazione NoDist non sono supportate. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza.
Configura sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto di eventi "as-feature-event". Per informazioni dettagliate, vedere Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
Accedi a Partner Hub
Fare clic su Impostazioni.
Fare clic su Visualizza cluster e selezionare il cluster BroadWorks appropriato.
Abilita il tasto di alternanza Non disturbare (NoDist).
Inserire l'ID utente BroadWorks e fare clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione NoDist. Se la convalida non riesce, il pulsante Salva viene disabilitato.
Se la convalida ha esito positivo, fare clic su Salva.
|
Abilita sincronizzazione NoDist (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per ulteriori dettagli, vedere "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Disabilita sincronizzazione NoDist
Non puoi disabilitare la sincronizzazione NoDist da solo. Per disabilitare la funzione, crea un caso BEMS di ingegneria con le seguenti informazioni:
Famiglia: Servizio Spark
Prodotto: Chiamata in Webex (Webex per BroadWorks)
Componente: Provisioning WxBW
Il caso BEMS deve indicare che la sincronizzazione non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterIdBroadWorks.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione delle chiamate.
Modalità di registrazione | Descrizione | Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta | La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente | La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Per R22: AP.as.22.0.1123.ap377718
Per R23: AP.as.23.0.1075.ap377718
Per R24: AP.as.24.0.944.ap377718
L'identificativo di correlazione chiamata deve essere attivato. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione delle chiamate Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, andare a help.webex.com
articolo Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla piattaforma di registrazione chiamate di terze parti.
Gruppo Parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione di parcheggio e recupero delle chiamate di gruppo. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti al dettaglio in un'impostazione di negozio possono utilizzare la funzione per parcheggiare una chiamata che può essere raccolta da qualcuno in un altro reparto.
Funzionamento funzione
Una volta configurata la funzione
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nell'app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nell'app Webex. L'utente quindi inserisce l'estensione della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per attivare questa funzione, verificare quanto segue:
Il file di configurazione client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
L'identificativo di correlazione chiamata deve essere abilitato su AS e XSP|ADP. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Il tuo SBC deve essere configurato per passare il ‘
x-broadworks-correlation-in
' Attributo SIP a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiungi gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo del server applicazioni Cisco BroadWorks - Parte 2. È necessario creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Parcheggio Webex | e Recupera chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzato
Il parcheggio chiamate regolare o indirizzato non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso funzione:
Immettere *68 per parcheggiare una chiamata
Immettere *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato negli ambienti del call center o in altre situazioni in cui può essere necessaria un'assistenza o un intervento immediati.
Quando un servizio di inclusione è abilitato, un utente o supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di tasti o pulsanti dedicati sul proprio telefono o dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o di partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in vari scenari. In un ambiente di call center, supervisori o formatori possono monitorare e assistere i rappresentanti del servizio clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire assistenza o prendere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può partecipare rapidamente a conversazioni in corso per fornire assistenza o prendere decisioni importanti.
Nell'app Webex per l'inclusione, viene inviata una notifica che la chiamata viene trasformata in una conferenza. In NOTIFY (informazioni sulla chiamata o conferenza) non sono disponibili ulteriori informazioni sul tipo di conferenza, pertanto è possibile trattarla in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Vengono introdotti i seguenti termini:
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore solitamente ha la possibilità di monitorare e intervenire nelle chiamate in corso dei clienti. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire assistenza agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può comprendere la formazione degli agenti, la gestione dei problemi dei clienti e l'ottimizzazione delle prestazioni del team.
Cliente: Per cliente si intende una persona fisica o giuridica che interagisce con un'azienda o un'organizzazione per ottenere prodotti, servizi o assistenza. Nel contesto dell'inclusione delle chiamate, un cliente è qualcuno che sta effettuando o ricevendo una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risolvere le loro richieste o problemi durante la chiamata. La funzione di inclusione chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
Agente: Un agente, anche noto come rappresentante del servizio clienti o agente del call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza telefonica o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare operazioni e offrire un'esperienza positiva al cliente. Nel contesto dell'inclusione delle chiamate, un agente è la persona che parla direttamente al cliente durante la telefonata. L'agente può ricevere indicazioni o feedback dal supervisore attraverso l'inclusione della chiamata, se necessario.
La chiamata nativa mobile viene inoltrata alla riunione
La funzione di escalation della chiamata nativa mobile alla riunione è dotata di due funzioni uniche:
Nuova notifica push
Gli utenti mobili su una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando si avvia una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si accede direttamente alla schermata in chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata utilizzando il controllo chiamate Cisco per le chiamate su cellulare, viene visualizzata la notifica Webex durante una chiamata su cellulare.
Trasferisci chiamata mobile a riunione
Quando sei nel mezzo di una chiamata con qualcuno, potresti voler trasferire la chiamata in una riunione per utilizzare alcune funzioni di riunione avanzate come video, condivisione o lavagna. In alternativa, invitare altre persone alla discussione e passare a una riunione.
Requisiti BroadWorks
Funzione attivabile 25239
R23 con XSP|ADP:
AS Patch AP.as.23.0.1075.ap383064
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
Patch AP.platform.23.0.1075.ap383064
R23 con ADP:
AS Patch AP.as.23.0.1075.ap383064
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R24:
Cerotto AS: AP.as.24.0.944.ap383064
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R25:
AS RI release Rel_2022.08_1.354
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e NPS versione > 2022.08_1.350
Configurazione chiamata URI per supportare lo spostamento della chiamata alla riunione
Criteri di chiamata Url NS
Definisci la regola per (.*)webex.com da indirizzare attraverso I-SBC
NS_CLI/Policy/UrlDialing> get WebexMeetings
Policy: UrlDialing Instance: Webex
unknownSipURIHandling = reject
disableSubscriberLookups = true
Enable = true
CallTypes:
Selection = {ALL}
From = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP}
lineportOnly = false
enableSipURIMatchingRules = true
NS_CLI/Policy/UrlDialing/Rules> get WebexMeetings
Policy: UrlDialing Instance: WebexCalling Table: Rules
id pattern routingNE cost weight dtg
===================================================================
1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE di indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> get ne WebexMeetings
Network Element WebexMeetings
Location = 1281465
Data Center =
Static Cost = 1
Static Weight = 99
Poll = false
OpState = enabled
State = OnLine
Profile = NIL_PROFILE
Remote Lookup Enabled = false
Signaling Attributes =
NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings
Routing NE Address Cost Weight Port Transport Route
=====================================================================
WebexMeetings sbc-address 1 99 - unspecified
Profilo di indirizzamento NS
Aggiunta dell'istanza della policy UrlDialing ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> get profile MyInst
Profile: Webex
Policy Instance
==========================================
…
UrlDialing WebexMeetings
AS Usa indirizzamento NS per chiamata NetworkURL
Consente all'AS di rispettare il percorso NS in modalità ibrida AS
AS_CLI/Interface/IMS> set queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un PSAP (Public Safety Answering Point), che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, è necessario integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Usa i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
Chiamata di emergenza E911 in Webex per BroadWorks: utilizzare questo articolo per configurare la chiamata di emergenza E911 in Webex per Cisco BroadWorks utilizzando uno dei seguenti provider E911 supportati:
Banda
Intrado
RedSky
Esclusione di responsabilità per chiamate di emergenza: se disponi di un servizio di posizione, puoi configurare la finestra Esclusione di responsabilità per i servizi di emergenza sull'app Webex in modo da includere un'opzione per gli utenti per aggiornare la propria posizione quando eseguono l'accesso.
Personalizzazione e provisioning dei clienti
Gli utenti scaricano e installano le relative app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedere Piattaforme app Webex). Una volta eseguita l'autenticazione dell'utente, il client si registra sul cloud Webex per messaggistica e riunioni, recupera le informazioni sul branding, scopre le informazioni del servizio BroadWorks e scarica la configurazione delle chiamate dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
Configurare i parametri di chiamata per le app Webex in BroadWorks (come di consueto). Configura i parametri di branding, messaggistica e riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Prepara il tuo ambiente).
Verificare di disporre dei set di tag corretti in BroadWorks System > Resources > Device Management Tag Sets.
Per ciascun client che si sta eseguendo il provisioning:
Scaricare ed estrarre il file zip DTAF per il client specifico.
Importare i file DTAF in BroadWorks all'indirizzo System > Resources > Identity/Device Profile Types
Apri il profilo dispositivo appena aggiunto per la modifica e:
Immettere il nome di dominio completo dell'azienda agricola XSP|ADP e il protocollo di accesso del dispositivo.
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per il funzionamento della condivisione desktop.
È inoltre possibile abilitare il supporto Parte remota eseguendo il seguente comando CLI sul server applicazioni:AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
Salvare il file.
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome | Descrizione |
Priorità codec | Configurazione dell'ordine di priorità per i codec audio e video per le chiamate VoIP |
TCP, UDP e TLS | Configurare i protocolli utilizzati per la segnalazione e il contenuto multimediale SIP |
Porte audio e video RTP | Configurazione degli intervalli di porte per audio e video RTP |
Opzioni SIP | Configurare diverse opzioni relative a SIP (SIP INFO, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti gestiti dal partner. Vedere Configurazione di personalizzazioni di branding avanzate.
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client. |
Personalizzazione dei report dei problemi e degli URL della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito Feedback e Guida", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con Flowthrough Provisioning
Prima di poter eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 | Assegna servizio in BroadWorks: |
2 | Verifica dell'organizzazione cliente e degli utenti in Control Hub: |
Test utente
1 | Scaricare l'app Webex su due diverse macchine. |
2 | Eseguire l'accesso come utenti di test sulle due macchine. |
3 | Effettuare chiamate di prova. |
Provisioning delle organizzazioni dei clienti
Nel modello corrente, eseguiamo automaticamente il provisioning dell'organizzazione del cliente quando si esegue l'onboarding del primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguito una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
Usa API per creare account Webex
Assegna il provisioning integrato IM&P (flowthrough provisioning) con e-mail attendibili per creare account Webex
Assegna provisioning integrato IM&P (flowthrough) senza e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per creare account Webex
Consenti agli utenti di autoattivarsi (invia loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex espone le API pubbliche per consentire ai provider di servizi di integrare il provisioning degli abbonati Webex per Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. Le specifiche per queste API sono disponibili su developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti wholesale verranno rifiutati da queste API. |
Provisioning del flusso
Su BroadWorks, è possibile eseguire il provisioning degli utenti con l'opzione Abilita IM&P integrato. Questa azione provoca l'adattatore di provisioning BroadWorks per effettuare una chiamata API per il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica del codice, ma solo una modifica della configurazione dell'endpoint API per l'adattatore di provisioning.
Il provisioning degli abbonati su Webex può richiedere molti minuti (diversi minuti per l'utente iniziale all'interno di un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il successo del provisioning flowthrough indica che il provisioning è stato avviato. Non indica il completamento. Per confermare che il provisioning di utenti e organizzazione cliente sia completo su Webex, devi accedere a Partner Hub e guardare nell'elenco dei clienti. Gli utenti di trunking BroadWorks possono disporre di Webex per BroadWorks tramite un identificativo di chiamata condiviso (SCA). L'utente che esegue il trunking dovrà disporre del servizio di autenticazione assegnato. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto Webex SCA dall'autenticazione del trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con le funzioni di elenco di indirizzamento o indirizzamento diretto assegnate. |
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata Modello di onboarding. |
Autoattivazione utente
Per eseguire il provisioning degli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
Accedere a Partner Hub e trovare la pagina Elenco clienti.
Fare clic su Visualizza modelli.
Seleziona il modello di onboarding di provisioning che desideri applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non si trova nel sistema BroadWorks associato a questo modello, non può attivarsi automaticamente con il collegamento.
Copiare il collegamento di provisioning e inviarlo all'utente.
È anche possibile includere il collegamento per il download del software e ricordare all'utente di cui ha bisogno di fornire e convalidare il proprio indirizzo e-mail per attivare l'account Webex.
È possibile monitorare lo stato di attivazione dell'utente nel modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi di attivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli all'interno della vista Stato utente che consentono agli amministratori dei provider di servizi Webex per Cisco BroadWorks di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Sposta gli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) |
|
Organizzazione cliente | Collega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge Webex per BroadWorks anche agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) | Se l'organizzazione Webex per BroadWorks non esiste (nessun utente predisposto):
Se esiste un'organizzazione Webex per BroadWorks (viene predisposto almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di autoiscrizione (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (con il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
Sposta utente (con e-mail attendibili): utilizza il provisioning con e-mail attendibili
Sposta utente (con e-mail non attendibili): utilizza il provisioning con e-mail non attendibili
Autoattivazione
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza messaggi e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
L'amministratore aggiunge l'utente.
L'utente viene spinto sul bridge di provisioning BroadWorks.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L’utente apre il messaggio e-mail e fa clic su Attiva account. L'utente viene reindirizzato al portale consumer Webex.
L'utente accede a Webex.
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza messaggi e-mail non attendibili, è necessario prima convalidare l’indirizzo e-mail dell’utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
L'amministratore aggiunge l'utente.
L'utente viene inviato automaticamente al bridge di provisioning BroadWorks.
All'utente viene inviato un testo con un collegamento di attivazione.
L'utente fa clic sul collegamento Attivazione e inserisce l'indirizzo e-mail.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L'utente apre il messaggio e-mail e fa clic su Accedi ora.
L'indirizzo e-mail viene convalidato.
L'utente viene reindirizzato all'accesso al portale consumer Webex.
L'utente accede a Webex.
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Flusso di autoattivazione
Se l'utente dispone di un account BroadWorks esistente, può utilizzare il processo di autoattivazione per spostare l'account.
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
L'utente inserisce il proprio indirizzo e-mail.
L'utente viene inviato al bridge di provisioning BroadWorks.
Viene inviata un'e-mail automatica all'indirizzo e-mail dell'utente.
L'utente apre il messaggio e-mail e fa clic sul collegamento Accedi ora, che convalida l'indirizzo e-mail.
CI rileva che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di poter continuare.
L'utente viene reindirizzato all'accesso a Webex.
L'utente accede al portale consumer.
L'utente fa clic su Elimina account.
L'account Webex precedente viene eliminato.
All'utente è stato predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
Collegamento di Webex per BroadWorks all'organizzazione esistente
Se sei un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, che non è ancora associata a un'azienda BroadWorks gestita da un partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso amministratore per la richiesta di provisioning riuscita.
È necessaria l'approvazione dell'amministratore dell'organizzazione se una delle seguenti affermazioni è vera:
L'organizzazione cliente esistente dispone di 100 utenti o più
L'organizzazione dispone di un dominio e-mail verificato
Dominio organizzazione richiesto
Se nessuno dei criteri di cui sopra è vero, può verificarsi un Attacco automatico.
In uno scenario di allegato automatico, un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner verranno concessi diritti di amministrazione provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà eseguito un amministratore completo. Con l'accesso amministratore di provisioning, la visibilità in Control Hub sarà limitata agli utenti nell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione. |
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che i messaggi e-mail di invito amministratore vengano collegati a organizzazioni esistenti (il tasto di alternanza è attivo per impostazione predefinita). |
1 | L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedere Provisioning delle organizzazioni dei clienti. Si verifica quanto segue:
| ||
2 | Con l'accesso amministratore completo, l'amministratore del partner può completare il processo di provisioning del cliente. Dovrai provare a eseguire nuovamente il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora come amministratore completo esterno, non si dovrebbe osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione cliente esistente sarà visibile come cliente sotto Webex per l'organizzazione partner BroadWorks.
|
Condizioni dell'allegato organizzazione
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione del cliente target. In caso contrario, verrà creata una nuova organizzazione cliente.
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato sul modello di provisioning Webex per BroadWorks. Di conseguenza, non vi sono modifiche alla modalità di accesso degli utenti esistenti.
Tuttavia, se l'organizzazione cliente esistente dispone di branding di base abilitato, una volta eseguito il collegamento, le impostazioni di branding avanzate del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
Il nome dell'organizzazione esistente non cambierà.
Non è stata apportata alcuna modifica all'impostazione del flag di soppressione e-mail nelle impostazioni dell'organizzazione esistente. Ciò può avere effetto sui nuovi utenti predisposti. A seconda di come è impostato il flag, i nuovi utenti possono o meno ricevere un'e-mail con un codice che deve essere immesso per completare l'attivazione.
La modalità di amministrazione con restrizioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
Accertarsi di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
Un'azienda BroadWorks può essere associata solo a una organziazione Webex. Non è possibile eseguire il provisioning degli abbonati da una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com
.
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo. |
L'indirizzo e-mail aggiunto dall'amministratore dell'organizzazione cliente come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore partner come configurato nel modello di onboarding su Partner Hub. Dopo aver aggiunto l'e-mail dal modello di onboarding in Partner Hub come amministratore completo, qualsiasi amministratore aggiuntivo del partner dovrà essere aggiunto anche come amministratore esterno con diritti di amministratore completo. |
Scollegare Webex per BroadWorks dall'organizzazione esistente
Effettuare le seguenti operazioni per scollegare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato accidentalmente Webex per BroadWorks a un'organizzazione esistente e si desidera rimuovere l'allegato.
In Flusso standard, il distacco di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati. |
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso all'amministratore esterno seguendo Approva richiesta amministratore esterno.
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Remove a BroadWorks Workspace.
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi abbonato BroadWorks.
Rimuovi gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se gli utenti sono stati predisposti tramite il flusso e-mail non attendibile e non sono stati ancora inseriti messaggi e-mail validi, gli utenti rimangono in stato di attesa. Segui Verifica provisioning utente con e-mail non attendibili per eliminare gli utenti.
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Hybrid, nella sezione BroadWorks Calling elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera collegare Webex per BroadWorks al cliente, seguire i processi di provisioning per collegarlo a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API Rimuovi abbonato BroadWorks è quella di accedere a BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati. |
Gestione di utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente sono in BroadWorks. Un'identità e-mail distinta per l'utente e le relative licenze per le funzioni Webex vengono conservate in Webex.
Verifica del provisioning utenti con indirizzi e-mail non attendibili
Se si sta eseguendo il provisioning di utenti Webex per BroadWorks utilizzando il provisioning flow-through con e-mail non attendibili, gli utenti devono eseguire il provisioning automaticamente inserendo il relativo indirizzo e-mail nel portale di attivazione utente. Se l'utente riscontra un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riscontra nuovamente l'errore, l'amministratore può utilizzare i passaggi seguenti in Partner Hub per esaminare lo stato e caricare l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 | Accedere a Partner Hub e trovare la pagina Elenco clienti. |
2 | Fare clic su Visualizza modelli. Selezionare il modello di onboarding appropriato che si desidera applicare a questo utente. |
3 | In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con e-mail non attendibili sia configurato correttamente:
|
4 | In seguito al provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato del provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo stato corrente, che mostra se l'utente è predisposto o se è presente un requisito in sospeso.
|
5 | Per gli utenti con errori o requisiti in sospeso, fare clic sui tre punti a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili quando si visualizza l'elenco degli utenti:
Esporta: fare clic su questo pulsante se si desidera esportare l'elenco utenti in un file CSV.
Escludi utenti predisposti: abilita questo tasto di alternanza se desideri visualizzare solo gli utenti con requisiti o errori in sospeso.
Modifica ID utente o indirizzo e-mail
Modifiche a ID utente e indirizzo e-mail
L'ID e-mail e l'ID alternativo sono gli attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. La tabella seguente descrive gli scopi di questi diversi attributi e cosa fare se occorre cambiarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non puoi modificare questo identificativo e comunque collegare l'utente allo stesso account in Webex. È possibile eliminare l'utente e ricreare se non è corretto. |
ID e-mail | ID utente | Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si afferma che l'e-mail è attendibile Non richiesto in BroadWorks se non si asserisce di poter considerare attendibili i messaggi e-mail Non richiesto in BroadWorks se consenti agli abbonati di autoattivarsi | È presente un processo manuale per modificare questa opzione in entrambe le posizioni se all'utente è stato eseguito il provisioning con l'indirizzo e-mail errato:
Non modificare l'ID utente BroadWorks. Questa operazione non è supportata. |
ID alternativo | Nessuno | Consente di abilitare l'autenticazione dell'utente per e-mail e password rispetto all'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se Non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti dovranno inserire il proprio ID utente BroadWorks durante l'autenticazione. |
Modifica pacchetto utenti in Partner Hub
1 | Accedi a Partner Hub e fai clic su Clienti. |
2 | Individuare e selezionare l'organizzazione del cliente a cui è assegnato l'utente. Viene visualizzata la pagina di panoramica dell'organizzazione in un pannello a destra dello schermo. |
3 | Fare clic su Visualizza cliente. L'organizzazione del cliente si apre in Control Hub, mostrando la pagina Panoramica.
|
4 | Fare clic su Utenti, quindi individuare e fare clic sull'utente interessato. |
5 | Nei Servizi dell'utente, fare clic su Webex per i pacchetti BroadWorks (Abbonamenti). Si apre il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 | Nella scheda Profilo, cercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 | Seleziona il pacchetto che desideri per questo utente (Base, Standard, Premium o Softphone) e fai clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 | Puoi chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium hanno siti di riunione distinti associati a ciascun pacchetto. Quando un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato viene visualizzato con due siti di riunione in Control Hub. Le funzionalità di riunione organizzatore e il sito della riunione dell'abbonato vengono allineati al pacchetto corrente. Il sito della riunione del pacchetto precedente e qualsiasi contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili all'amministratore del sito della riunione. |
Potrebbero essere necessarie da due a tre ore per le nuove impostazioni PMR derivanti da una modifica del pacchetto da aggiornare. |
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si desidera eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto alcun trasferimento automatico del ruolo di amministratore nel caso in cui venga eliminato l'ultimo amministratore. |
API Cisco BroadWorks per Webex
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
Eseguire la richiesta API Remove a BroadWorks Subscriber su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento Webex per Cisco BroadWorks. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
Eseguire la richiesta Elimina una persona API su https://developer.webex.com/docs/api/v1/people/delete-a-person per eliminare completamente l'utente.
Provisioning flow-through
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – IM&P integrato in BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks - Parte 2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento Webex per Cisco BroadWorks dall'utente. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla propria organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 | Usa le API Persone per eliminare tutti gli utenti dall'organizzazione:
| ||
2 | Se la sincronizzazione rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione rubriche tramite Partner Hub: Per disabilitare la sincronizzazione rubriche tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API aziendale BroadWorks e disabilita l'impostazione enableDirSync. Tutti gli utenti correlati alla sincronizzazione rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione degli utenti (utilizzando entrambi i metodi) può richiedere del tempo a seconda della quantità di utenti. | ||
3 | Una volta rimossi tutti gli utenti, utilizza l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Gestione delle release
I controlli di gestione delle release in Partner Hub consentono a Webex per i provider di servizi Cisco BroadWorks di gestire facilmente le release consentendo loro di controllare la cadenza di rilascio in base alla quale le app Webex degli utenti vengono aggiornate all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza gli aggiornamenti automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
Configurazione di pianificazioni di rilascio personalizzate con rinvii dalla pianificazione di rilascio predefinita Cisco
Configurare una singola pianificazione della release e trasferirla a cascata a tutte le organizzazioni dei clienti che gestiscono
Assegna diverse pianificazioni di rilascio a diverse organizzazioni di clienti
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di rilascio personalizzate, vedere l'articolo Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
Aggiunta di un cluster BroadWorks in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
Aggiunta di un modello di onboarding in Partner Hub
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | ||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | ||
3 | Fare clic su Visualizza cluster. | ||
4 | Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro flyout a destra.
| ||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | |||||||||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | |||||||||
3 | Fare clic su Visualizza modelli. | |||||||||
4 | Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere a Webex Assistant di seguire le azioni, prendere nota di decisioni importanti ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant per Meetings è disponibile gratuitamente per i siti per riunioni con pacchetto Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilitazione di Webex Assistant per Meetings
Webex Assistant è abilitato per impostazione predefinita per i clienti Broadworks con pacchetto standard e premium.
Gli amministratori dei partner e gli amministratori delle organizzazioni dei clienti possono disabilitare la funzione per le organizzazioni dei clienti tramite Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
Il supporto è limitato ai siti per riunioni con pacchetto Premium e Standard e solo alle sale riunioni personali.
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
La condivisione di contenuto tramite e-mail è accessibile solo dagli utenti all'interno della tua organizzazione
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Il contenuto della riunione non è accessibile anche se condiviso tra utenti di pacchetti diversi dall'interno della stessa organizzazione.
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile, pertanto le trascrizioni post-riunione non sono disponibili se Webex Assistant è abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni utente su come utilizzare la funzione, vedere Uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
Webex Calling gratuito è abilitato per impostazione predefinita consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, che disabilita tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzione
Se Webex Calling è disabilitato, le seguenti condizioni si applicano a Webex per gli utenti Cisco BroadWorks:
Gli utenti non visualizzano più Chiamata con Webex come opzione di chiamata selezionabile sull'app Webex.
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, la cronologia chiamate, i contatti, inserendo l'URI dell'altro utente o l'indirizzo e-mail nella barra di ricerca.
Condivisione schermo all'interno di una chiamata BroadWorks.
Le riunioni Webex e la presenza in telefonia funzionano ancora, anche se le chiamate Webex sono disabilitate.
Disabilita chiamate Webex (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno di Aggiungi un nuovo modello guidata. Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti assegnate al modello.
Per informazioni dettagliate sulla configurazione di un nuovo modello di onboarding, vedere Configurazione dell'organizzazione partner in Partner Hub.
Disabilita chiamate Webex (modello di onboarding esistente)
Seguire questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
Accedere a Partner Hub all'indirizzo admin.webex.com.
Scegliere Impostazioni.
Fare clic su Visualizza modello e scegliere il modello di inserimento appropriato.
Fai clic su Disabilita chiamata gratuita Cisco Webex.
Fai clic su Salva.
Disabilita chiamate Webex (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare Webex Calls per un utente esistente, è possibile seguire una delle procedure seguenti per aggiornare l'utente.
Accertarsi di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigura l'utente con le chiamate Webex abilitate. |
Se si utilizza il provisioning flow-through, è possibile effettuare le seguenti operazioni:
Aprire CommPilot e passare alla configurazione utente.
Rimuovere il servizio Integrated IM+P dall'utente e fare clic su OK.
Aggiungere il servizio Integrated IM+P all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
Utilizzare Remove a BroadWorks Subscriber API per eliminare l'utente.
Utilizzare la Provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione della condivisione video o dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per informazioni dettagliate sulla configurazione e le opzioni complete, vedere Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è anche possibile configurare se il contenuto multimediale delle chiamate in ingresso utilizza per impostazione predefinita solo il video o l'audio. |
Indicatore di stato della linea / Notifica risposta per assente
L'indicatore di stato/notifica di risposta per assente utilizza le funzioni di risposta per assente indirizzata. Un utente con indicatore di stato riceve una notifica audio e visiva sull'app Webex quando un utente dell'elenco di indicatori di stato monitorato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può Ignorare o Rispondere alla chiamata dell'utente monitorato.
La notifica dell'indicatore di stato/risposta per assente consente di rispondere alle chiamate di altri membri del team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra chiamata multipla - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza dei membri del team Webex e non Webex. Per informazioni sull'abilitazione della chiamata multipla, vedere: Finestra multi-chiamata
I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati nella rubrica in Webex e avranno solo stati "sconosciuti" e "in chiamata" (lo stato suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
La presenza non è supportata per gli utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
Gli utenti CI senza autorizzazione cloud Webex o tipo di account macchina (spazi di lavoro) visualizzano solo la presenza "in chiamata" e "sconosciuta". Nessun stato attivo, suoneria, ecc.
Gli utenti non Webex dall'elenco di indicatori di stato, che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza "sconosciuta".
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
Se un utente non Webex dell'indicatore di stato detiene una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate su BroadWorks. Installare solo le patch valide per la versione in uso:
Per R22:
Piattaforma AP.22.0.1123.ap382053
AP.as.22.0.1123.ap382053
AP.as.22.0.1123.ap382362
AP.xsp.22.0.1123.ap382053
AP.xsp.22.0.1123.ap382362
AP.as.22.0.1123.ap383459
AP.as.22.0.1123.ap383520
Per R23:
Piattaforma AP.23.0.1075.ap382053
AP.as.23.0.1075.ap382053
AP.as.23.0.1075.ap382362
AP.as.23.0.1075.ap383459
AP.as.23.0.1075.ap383520
Se si utilizza XSP|ADP:
AP.xsp.23.0.1075.ap382053
AP.xsp.23.0.1075.ap382362
Se si utilizza ADP:
Xsi-Actions-23_2022.01_1.200.bwar
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
Per R24:
AP.as.24.0.944.ap382053
AP.as.24.0.944.ap382362
AP.as.24.0.944.ap383459
AP.as.24.0.944. ap383520
Xsi-Actions-24_2022.01_1.200.bwar
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
<busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare la funzione 101642 Enhanced Xsi Mechanism Per la telefonia del team su AS:
AS_CLI/System/ActivatableFeature> activate 101642
Abilita X-BroadWorks-Remote-Party-Info
in AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamata SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Accertarsi che i seguenti servizi siano assegnati agli utenti:
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP. |
Configurazione dell'indicatore di stato della linea su BroadWorks
Gli amministratori dei partner possono utilizzare la seguente procedura per impostare l'indicatore di stato della linea per un utente.
Accedere a BroadWorks CommPilot.
Per un utente selezionato, accedere ad Applicazioni client e configurare l'indicatore di stato della linea.
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
Utilizzare i parametri di ricerca per individuare e aggiungere utenti all'elenco Utenti monitorati.
Fai clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento di coinvolgimento del pubblico facile da usare. Consente alle persone di ottenere il massimo dalle riunioni colmando la distanza tra oratori e pubblico. Quando Slido è integrato nell'organizzazione Control Hub, gli utenti possono aggiungere l'Slido app alle riunioni nell'app Webex. Questa integrazione offre ulteriori funzionalità di Q&A e sondaggio alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando è stata accettata una riunione nel client Outlook che corrisponde a un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che hai assunto un impegno diverso e che la risposta potrebbe essere ritardata.
Per abilitare questa funzione:
andare alla scheda Generale della scheda Impostazioni su Windows o Preferenze su Mac.
Selezionare la casella per Mostra in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, "In una riunione di calendario" in Webex è associato a "Occupato" in Outlook. |
Avvertenza
Per utilizzare questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come funziona altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la sua presenza non verrà aggiornata fino al termine della riunione. A tale scopo, sarà necessario riavviare il client per rispondere.
Risposta automatica con tono
Con la risposta automatica con tono, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul desktop. Quando l'app Webex squilla sull'altra parte, l'utente sente un determinato segnale acustico che indica che la chiamata è in connessione.
Per utilizzare questa funzione per un utente Webex per Cisco BroadWorks:
La funzione è supportata solo sull'aspetto della linea principale
L'app Webex deve essere l'identificativo di linea principale
Il tag %ENABLE_AUTO_ANSWER_WXT% deve essere abilitato
Se l'utente dispone anche di indicatori di chiamata condivisa (ad esempio, un telefono da tavolo è configurato come uno degli indicatori di linea secondaria), la funzione è ancora supportata sull'aspetto principale, a condizione che gli indicatori di chiamata condivisa siano configurati per non ricevere chiamate in arrivo. Per effettuare questa operazione, è possibile configurare una delle tre condizioni seguenti su BroadWorks per tutte le chiamate condivise:
Avvisa tutti gli aspetti delle chiamate con clic è disabilitato nella configurazione dell'aspetto chiamata condivisa: questo è l'approccio consigliato
o
Consenti terminazione a questa posizione deve essere disabilitato per tutte le chiamate condivise o
o
Posizioni disabilitate per tutti gli indicatori di chiamata condivisi
Aumentare la capacità
Aziende agricole XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare quante risorse XSP|ADP aggiuntive sono necessarie per l'aumento proposto dei numeri di abbonati. Per le aziende NPS dedicate o Webex dedicato per le aziende Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
Fattoria dedicata in scala: Aggiungere uno o più server XSP|ADP all'azienda che ha bisogno di capacità extra. Installare e attivare lo stesso set di applicazioni e configurazioni dei nodi esistenti dell'azienda agricola.
Aggiungi azienda agricola dedicata: Aggiungi una nuova fattoria XSP|ADP dedicata. Dovrai creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti nella nuova fattoria, per ridurre la pressione sulla fattoria esistente.
Aggiungere azienda agricola specializzata: Se si verificano strozzature per un particolare servizio, è possibile creare un'azienda agricola ADP|XSP separata a tale scopo, tenendo conto dei requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster di Control Hub e le voci DNS se si modifica l'URL del servizio con una nuova azienda agricola.
In tutti i casi, è tua responsabilità monitorare e assegnare risorse all’ambiente BroadWorks. Se si desidera contattare l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare i servizi professionali.
Gestione dei certificati del server HTTP
È necessario gestire questi certificati per le applicazioni Web autenticate mTLS su XSP|ADP:
La nostra catena di certificati di attendibilità dal cloud Webex
Certificati delle interfacce del server HTTP di XSP|ADP
Catena di fiducia
È possibile scaricare la catena del certificato di attendibilità da Control Hub e installarlo sugli ADP|XSP durante la configurazione iniziale. Prevediamo di aggiornare il certificato prima della scadenza e di informarvi su come e quando modificarlo.
Interfacce del server HTTP
L'|ADP XSP deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Certificati ordine. Quando si protegge l'interfaccia, viene generato un certificato autofirmato per l'interfaccia. Questo certificato è valido per un anno da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione di Partner Hub che gli amministratori dei partner possono assegnare a organizzazioni di clienti specifiche per limitare le impostazioni dell'organizzazione che gli amministratori dei clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione del cliente, tutti gli amministratori del cliente di tale organizzazione, indipendentemente dalle autorizzazioni dei ruoli, non sono in grado di accedere a un set di controlli con limitazioni in Control Hub. Solo un amministratore partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner esiste un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita le autorizzazioni di ruolo specifiche per gli amministratori dei clienti nell'organizzazione a cui è applicata l'impostazione. |
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità con limitazioni per partner. Dopo l'accesso, vedrà un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner notifica all'amministratore del cliente che la Modalità con limitazioni è abilitata e che l'amministratore potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore del cliente in un'organizzazione in cui con limitazioni della modalità partner è abilitata, il livello di accesso di Control Hub è determinato con la formula seguente:
(Accesso a Control Hub) = (Entitlements Role Organization) - (Limitato dalle limitazioni della modalità partner)
Limitazioni
Quando è abilitata la modalità con limitazioni per partner per un'organizzazione del cliente, gli amministratori dei clienti di tale organizzazione non possono accedere alle seguenti impostazioni di Control Hub:
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
Pulsante Gestisci utenti: disattivato.
Aggiungi o modifica manualmente utenti: nessuna opzione per aggiungere o modificare gli utenti, né manualmente né tramite CSV.
Richiedi utenti: non disponibile
Assegna automaticamente licenze: non disponibile
Sincronizzazione rubriche —Impossibile modificare le impostazioni di sincronizzazione delle rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato ed e-mail principale* sono modificabili.
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, messaggi, riunioni, chiamate)
Visualizza stato servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
Numero di lavoro principale: questo campo è di sola lettura.
Nella vista Account, non sono disponibili le seguenti impostazioni:
Nome società: campo di sola lettura.
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
Dominio: accesso di sola lettura.
E-mail: le impostazioni Elimina inviti e-mail di amministrazione e Selezione impostazioni internazionali e-mail sono di sola lettura.
Autenticazione: nessuna opzione per la modifica delle impostazioni di autenticazione e SSO.
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
Impostazioni chiamata: le impostazioni di priorità della chiamata delle opzioni dell'app sono di sola lettura.
Funzionamento chiamata: le impostazioni sono di sola lettura.
Posizione > PSTN: le opzioni Gateway locale e Cisco PSTN sono nascoste.
Sotto SERVIZI, le opzioni di servizio Migrazioni e Connected UC vengono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori partner possono utilizzare la procedura seguente per l'abilitazione Con limitazioni della modalità partner per una determinata organizzazione cliente (l' impostazione predefinita è abilitata).
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
Seleziona l'organizzazione cliente applicabile.
Nella vista Impostazioni di destra, abilitare il Con limitazioni della modalità partner per attivare l'impostazione.
Se si desidera disattivare la modalità Con limitazioni per partner, disabilitare l'interruttore.
Se il partner rimuove la modalità amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà eseguire quanto segue:
|
Analisi dei partner
I miglioramenti di Control Hub consentono agli amministratori partner di visualizzare e aggiornare facilmente le informazioni sui pacchetti per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata di tutti i clienti e include i seguenti dettagli:
Utenti totali per pacchetto (Softphone, Base, Standard, Premium)
Tendenza utenti per pacchetto (giornaliero/settimanale/mensile)
Clienti con n. di pacchetti assegnati
Per informazioni dettagliate su come utilizzare Analisi dei partner, vedere l'articolo Webex Analisi per i pacchetti Webex per la vendita all'ingrosso e Webex per BroadWorks in Partner Hub .
API di report fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare report di fatturazione. Nella tabella seguente vengono elencate le API, il tipo di accesso richiesto e i requisiti di ruolo.
API di fatturazione | Scopo | Tipo di accesso | Requisiti di ruolo per API (L'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Creazione di un report di fatturazione BroadWorks | Utilizzato per generare un report di fatturazione. | Accesso in scrittura |
|
Elenca report di fatturazione BroadWorks | Consente di elencare i report disponibili per la visualizzazione. | Accesso in lettura |
|
Ottenere un report di fatturazione BroadWorks | Utilizzato per ottenere una copia di un report generato. | Accesso in lettura |
|
Eliminazione di un report di fatturazione BroadWorks | Utilizzato per eliminare un report generato. | Accesso scrittura |
|
Campi di fatturazione
Nella tabella seguente sono elencati i campi contenuti nel report generato.
Campo | Descrizione |
---|---|
nome rivenditore | Nome partner o ID organizzazione partner |
ID fatturazione | Identificativo di fatturazione univoco del partner o numero C |
IdImpresaSp | L'identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno | Stato versione di prova interna del cliente (Sì/No) |
ID utente | IDutente dell'abbonato su BroadWorks |
id abbonato | Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato | Sì/No |
Data iniziale | Data di provisioning dell'abbonato. |
dataInizioFatturazione | Data di inizio fatturazione in questo mese |
DataFineFatturazione | Data di fine fatturazione in questo mese |
pacchetto | Il tipo di confezione che viene caricata |
quantità | Quantità ripartita per fatturazione.
|
|
Risoluzione dei problemi di Webex per Cisco BroadWorks
Abbonamento alla pagina di stato Webex
Innanzitutto verificare https://status.webex.com quando si verifica un'interruzione imprevista del servizio. Se non hai modificato la tua configurazione in Control Hub o BroadWorks prima dell'interruzione, controlla la pagina di stato. Ulteriori informazioni sull'iscrizione per le notifiche di stato e incidenti al Centro assistenza Webex.
Usa analisi Control Hub
Webex monitora l'utilizzo e i dati di qualità per la tua organizzazione e le organizzazioni dei tuoi clienti. Ulteriori informazioni sulle analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
Clienti o utenti non vengono creati in Control Hub con provisioning flowthrough:
Il server applicazioni può raggiungere l'URL di provisioning?
L'account di provisioning e la password sono corretti? Tale account esiste in BroadWorks?
I cluster non riescono in modo coerente a eseguire i test di connettività:
La connessione mTLS al servizio di autenticazione non riesce quando si crea il primo cluster in Partner Hub, poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. In caso contrario, non è possibile creare un'ancora attendibile sul servizio di autenticazione XSP|ADPs, pertanto la connessione mTLS di prova da Partner Hub non viene eseguita correttamente. |
Le interfacce XSP|ADP sono accessibili pubblicamente?
Stai utilizzando le porte corrette? È possibile immettere una porta nella definizione dell'interfaccia sul cluster.
Convalida non riuscita interfacce
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Esaminare i consigli per la configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Rivedere i consigli sulla configurazione dell'interfaccia in questo documento, con particolare attenzione a:
- Accertarsi di aver condiviso le chiavi RSA tra tutti gli XSP|ADP.
- Accertarsi di aver fornito l'URL AuthService al contenitore Web su tutti gli XSP|ADP.
- Se è stata modificata la configurazione della crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'|ADP XSP richiede di immettere il formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento elencava erroneamente le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati sul proprio archivio attendibile XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere i certificati del client?
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere i certificati del client?
Problemi del cliente
Verificare che il client sia connesso a BroadWorks
Accedere all'app Webex.
Verificare che l'icona Opzioni di chiamata (un ricevitore con una marcia sopra) sia presente sulla barra laterale.
Se l'icona non è presente, l'utente potrebbe non essere ancora abilitato per il servizio di chiamata in Control Hub.
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici . Viene visualizzato lo stato Sessione SSO A cui è stato eseguito l'accesso.
Se viene visualizzato un servizio telefonico diverso, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Tale verifica comporta:
Il client ha eseguito correttamente il transveresed dei microservizi Webex richiesti.
Autenticazione dell'utente eseguita correttamente.
Il client ha ricevuto un token Web JSON di lunga durata dal sistema BroadWorks.
Il client ha recuperato il proprio profilo dispositivo e si è registrato su BroadWorks.
Registri client
Tutti i client dell'app Webex possono Inviare I Registri a Webex. Questa è l'opzione migliore per i client mobili. È inoltre necessario registrare l'indirizzo e-mail dell'utente e l'ora approssimativa in cui si è verificato il problema se si sta cercando assistenza da TAC. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se è necessario raccogliere manualmente i registri da un PC Windows, si trovano come segue:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac:/Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS configurata male
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
Verificare che la catena di certificati Webex sia installata come ancora affidabile.
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e firmato da una CA ben nota.
Messaggio di eccedenza licenza
Questo messaggio può apparire per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'utilizzo delle licenze supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Politica di supporto allo stato stazionario
Il provider di servizi è il primo punto di contatto per il supporto del cliente finale (aziendale). Inoltrare i problemi che il SP non è in grado di risolvere al centro TAC. Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Politica di escalation
Tu (provider di servizi/partner) sei il primo punto di contatto per il supporto clienti finali (aziendale).
I problemi che non possono essere risolti dal SP vengono inoltrati al centro TAC.
Versioni di BroadWorks
Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Risorse di autosupporto
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, dove è presente una pagina specifica di Webex per Cisco BroadWorks che elenca argomenti di Guida e supporto comuni dell'app Webex.
L'app Webex può essere personalizzata con questo URL della Guida e un URL di segnalazione problemi.
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I registri vengono inviati al cloud Webex, dove possono essere analizzati da Webex DevOps.
È disponibile anche una pagina Centro assistenza dedicata alla Guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccogliere informazioni per l'invio di una richiesta di assistenza
Quando vengono visualizzati errori in Control Hub, potrebbero essere allegate informazioni che possono aiutare TAC a indagare sul problema. Ad esempio, se viene visualizzato un ID di verifica per un particolare errore o un codice di errore, salvare il testo da condividere con noi.
Prova a includere almeno le seguenti informazioni quando invii una query o apri un caso:
ID organizzazione cliente e ID organizzazione partner (ogni ID è una stringa di 32 cifre esadecimali, separate da trattini)
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce uno
Indirizzo e-mail utente (se un particolare utente riscontra problemi)
Versioni del cliente (se il problema presenta sintomi notati attraverso il cliente)
Confronto UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > | SaaS UC-One | Webex per Cisco BroadWorks |
---|---|---|
Cloud | Cisco UC-One Cloud (GCP) | Webex Cloud (AWS) |
Client | UC-One: Mobile, desktop Receptionist, Supervisore | Webex: Mobile, desktop, Web |
Principale differenza tecnologica | Riunioni condotte sulla tecnologia BroadSoft Meet | Riunioni fornite sulla tecnologia Webex Meetings |
Prove sul campo iniziali | Contesto di stadiazione, clienti beta | Ambiente di produzione, clienti GA |
Identità utente | ID BroadWorks servito come ID principale, a meno che il provider di servizi non disponga già dell'integrazione SSO.
ID utente e segreto in BroadWorks | ID e-mail in Cisco CI serve come ID principale Integrazione SSO in BroadWorks provider di servizi in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks al momento.
L'utente fornisce le credenziali tramite SSO con BroadWorks e Secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e segreti in IdP |
Autenticazione client | Gli utenti forniscono le credenziali attraverso il client Token di lunga durata BroadWorks richiesti se si utilizza la messaggistica Webex | Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso a Webex e aggiornamento dei token |
Gestione / configurazione | I vostri sistemi OSS/BSS e Portale rivenditore | I tuoi sistemi OSS/BSS e Control Hub |
Attivazione partner/provider di servizi | Impostazione una tantum da Cisco Operations | Impostazione una tantum da Cisco Operations |
Attivazione cliente/azienda | Portale rivenditore | Control Hub Creato automaticamente alla prima iscrizione utente |
Opzioni di attivazione utente | Autoiscrizione Imposta IM&P esterno in BroadWorks
| Impostazione di IM&P integrato in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP | Azioni XSI
XSI-Eventi CTI (mTLS) AuthService (mTLS opzionale) DMS | Azioni XSI Azioni XSI (mTLS) XSI-Eventi CTI (mTLS) Servizio di autenticazione (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 | Scarica e installa Webex. Per informazioni dettagliate, vedi Webex | Download dell'app. |
2 | Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 | Inserisci l'indirizzo e-mail e fai clic su Avanti. |
4 | Una delle seguenti operazioni si verifica, a seconda del modo in cui l'organizzazione è configurata in Webex: Webex si carica dopo aver eseguito correttamente l'autenticazione su IdP o BroadWorks.
|
Scambio e archiviazione dati
Queste sezioni forniscono dettagli sullo scambio e la memorizzazione dei dati con Webex. Tutti i dati vengono crittografati sia in transito che a riposo. Per ulteriori informazioni, vedi Webex App Security.
Onboarding provider servizi
Quando si configurano cluster e modelli utente in Webex Control Hub durante l'onboarding di provider di servizi, è possibile scambiare i seguenti dati BroadWorks memorizzati in Webex:
URL Xsi-Actions
URL Xsi-Events
URL interfaccia CTI
URL servizio di autenticazione
Credenziali adattatore di provisioning BroadWorks
Provisioning utente provider di servizi
Questa tabella elenca i dati utente e aziendale che vengono scambiati come parte del provisioning utente attraverso le API Webex.
Trasferimento dei dati in Webex | Da | Attraverso | Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito da SP) | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito dall’utente) | Utente | Portale di attivazione utente | Sì |
Nome | BroadWorks, per API | API Webex | Sì |
Cognome | BroadWorks, per API | API Webex | Sì |
Numero di telefono principale | BroadWorks, per API | API Webex | Sì |
Numero telefono cellulare | BroadWorks, per API | API Webex | Sì |
Estensione principale | BroadWorks, per API | API Webex | Sì |
ID provider di servizi BroadWorks e ID gruppo | BroadWorks, per API | API Webex | Sì |
Lingua | BroadWorks, per API | API Webex | Sì |
Fuso orario | BroadWorks, per API | API Webex | Sì |
Rimozione utente
Le API Webex per Cisco BroadWorks supportano la rimozione parziale e completa dell'utente. Questa tabella elenca tutti i dati utente memorizzati durante il provisioning e ciò che viene eliminato in ogni scenario.
Dati utente | Eliminazione parziale | Eliminazione completa |
---|---|---|
ID utente BroadWorks | Sì | Sì |
No | Sì | |
Nome | No | Sì |
Cognome | No | Sì |
Numero di telefono principale | Sì | Sì |
Numero telefono cellulare | Sì | Sì |
Estensione | Sì | Sì |
ID provider di servizi BroadWorks e ID gruppo | Sì | Sì |
Lingua | No | Sì |
Accesso utente e recupero configurazione
Autenticazione Webex
L'autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da uno qualsiasi dei meccanismi di autenticazione del supporto Webex. (L'autenticazione BroadWorks è trattata separatamente.) Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (indipendente) | Webex | Browser utente |
Credenziali utente | Browser utente | Provider identità (che dispone già di identità utente) |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Autenticazione BroadWorks
L'autenticazione BroadWorks si riferisce all'accesso dell'utente a un'app Webex utilizzando le credenziali BroadWorks. Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (proxy Webex Bwks IdP) | Webex | Browser utente |
Informazioni sul branding e URL BroadWorks | Webex | Browser utente |
Credenziali utente BroadWorks | Utente tramite browser (pagina di accesso con marchio servita da Webex) | Webex |
Credenziali utente BroadWorks | Webex | BroadWorks |
Profilo utente BroadWorks | BroadWorks | Webex |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento dell'avviso di accesso e del messaggio di errore:
- Attualmente gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso poiché la password è già scaduta. Con questa funzione, se la password sta per scadere tra 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere, con l'indicazione di quanti giorni rimangono, e all'utente viene consigliato di contattare il partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su true, è stato emesso l'errore "nome utente e password errati", ma ora con questa funzione viene migliorato il messaggio di errore: Tentativo di accesso non riuscito. La combinazione di ID utente e password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice errore 100006
Controllo flusso di accesso:
- Il partner può limitare l'accesso abilitando un'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione in broadworks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, quindi viene visualizzato un errore che indica che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso può essere configurato dal partner come parte della funzione di personalizzazione avanzata. I partner solitamente configurano il collegamento per passare dall'utente a un portale partner per la gestione della password e la reimpostazione della password.
Questa funzione migliora l'esperienza di accesso utente solo durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se una password scade mentre l'utente è connesso all'app Webex. L'utente riceve la notifica di scadenza della password al successivo tentativo di accesso. |
Recupero configurazione cliente
Questa tabella illustra la tipologia di dati scambiati tra le diverse componenti in fase di recupero delle configurazioni del cliente.
Trasferimento dei dati | Da | Per |
---|---|---|
Iscrizione | Client | Webex |
Impostazioni organizzazione, inclusi URL BroadWorks | Webex | Client |
Token JWT BroadWorks | BroadWorks attraverso Webex | Client |
Token JWT BroadWorks | Client | BroadWorks |
Token dispositivo | BroadWorks | Client |
Token dispositivo | Client | BroadWorks |
File di configurazione | BroadWorks | Client |
Utilizzo allo stato stazionario
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione dopo la scadenza del token, tramite BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Trasferimento dei dati | Da | Per |
---|---|---|
Segnalazione SIP | Client | BroadWorks |
Supporto SRTP | Client | BroadWorks |
Segnalazione SIP | BroadWorks | Client |
Supporto SRTP | BroadWorks | Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Trasferimento dei dati | Da | Per |
---|---|---|
Messaggistica e presenza REST HTTPS | Client | Webex |
Messaggistica e presenza REST HTTPS | Webex | Client |
Segnalazione SIP | Client | Webex |
Supporto SRTP | Client | Webex |
Segnalazione SIP | Webex | Client |
Supporto SRTP | Webex | Client |
Uso dell'API di provisioning
Accesso sviluppatore
Le specifiche API sono disponibili su https://developer.webex.com e una guida all'uso è disponibile su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l' accedere per leggere la specifica API all'indirizzohttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Autenticazione e autorizzazione applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (ad esempio provisioning abbonato) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere l'aggiornamento e l'accesso ai token per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
Devi prima registrare la tua integrazione con Webex. Una volta eseguita la registrazione, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di accesso e aggiornamento necessari.
Per ulteriori dettagli sulle integrazioni e sulle modalità di creazione di questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli obbligatori per l'implementazione delle integrazioni: sviluppatore e utente autorizzatore, che possono essere svolti da persone/team separati nel proprio ambiente.
|
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning utilizzata:
Modalità Enterprise: il nome dell'organizzazione corrisponde esattamente a spEnterpriseId.
Modalità provider di servizi: il nome dell'organizzazione è la parte groupID di spEnterpriseId.
Il nome dell'organizzazione conterrà qualsiasi spazio vuoto, maiuscolo e caratteri speciali specificati in spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "attuale" con le ultime patch BroadWorks e le app Release Independent (RI). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Assicurarsi di rivedere le note di patch per queste patch software. Alcune patch potrebbero avere requisiti CLI aggiuntivi. |
Versione R22
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | ||
Richiesto per sincronizzazione rubrica | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per il server applicazioni | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per la funzione di registrazione chiamata | ||
Patch richiesta per il provisioning flow-through | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | Richiesto per proxy autenticazione NPS | |
Richiesto per il servizio di autenticazione con convalida token CI | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Obbligatorio per la cronologia chiamate unificata | ||
Altro | AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Richiesto per sincronizzazione rubrica | |
Configurazione server app | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Se si utilizza ADP... | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Versione R24
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per il provisioning flowthrough | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che è necessario configurare per Webex, fare riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utente e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. L'attivazione include la convalida e-mail e l'assegnazione del servizio in Webex. |
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se disponi di indirizzi e-mail affidabili per gli utenti, puoi scegliere di attivarli automaticamente quando esegui il provisioning automatico degli utenti. Questo processo è "provisioning automatico e attivazione automatica".
Provisioning utente automatizzato e attivazione automatica (flusso e-mail affidabile)
Prerequisiti
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase | Descrizione |
---|---|
1 | Citare e prendere ordini per il servizio con i clienti. |
2 | Si elabora l'ordine del cliente e si esegue il provisioning del cliente nei sistemi. |
3 | Il sistema di provisioning dei servizi attiva il provisioning di BroadWorks. Questo passaggio, in sintesi, crea l'azienda e gli utenti. Quindi assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM&P esterno. |
4 | Questo passaggio di provisioning attiva il provisioning automatico dell'organizzazione cliente e degli utenti in Webex. (L'assegnazione del servizio IM&P determina che l'adattatore di provisioning chiami l'API di provisioning Webex). |
5 | I sistemi devono utilizzare l'API di provisioning Webex se successivamente è necessario regolare il pacchetto per l'utente (per passare dall'impostazione predefinita). |
Flusso di accesso SSO
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, che consente l'autenticazione diretta a BroadWorks. L'immagine mostra gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresenta ciò che il client prevede per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizio BroadWorks che segue immediatamente il flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione BroadWorks diretta abilitata (condivisione risorse cross-origin). Di seguito sono riportati alcuni flussi di accesso SSO SAML alternativi:
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
L'unica differenza è nei punti 5 e 6 del flusso di accesso Webex. Nel passaggio 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
Il flusso procede attraverso i restanti passaggi dei due diagrammi.
Il token SSO non viene utilizzato in questo flusso.
Autenticazione SSO SAML Webex:
Nel passaggio 3 del flusso di accesso Webex, il servizio Common Identity restituisce il provider di identità utilizzato dall'autenticazione Webex.
A questo punto, viene invocato un flusso di accesso SSO SAML alternativo per Webex.
Interazioni utente
Accedi
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
CI rileva che l'organizzazione cliente associata dispone del proxy IDP BroadWorks (IDP) configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso (il provider di servizi può contrassegnare questa pagina di accesso).
L'utente inserisce le credenziali BroadWorks.
Broadworks esegue l'autenticazione dell'utente attraverso l'IDP. In caso di successo, l'IDP reindirizza il browser a CI con un SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
Una volta completata l'autenticazione, l'app Webex ottiene i token di accesso da CI (non mostrati nel diagramma). Il client li utilizza per richiedere un token Web Jason (JWT) di lunga durata BroadWorks.
L'app Webex rileva la configurazione di chiamata da BroadWorks e altri servizi da Webex.
L'app Webex si registra in BroadWorks.
Accesso dalla prospettiva dell'utente
Questo diagramma è il tipico flusso di accesso, visualizzato dall'utente finale o dall'abbonato:
Scarica e installa l'app Webex.
È possibile che tu abbia ricevuto il collegamento dal provider di servizi o che tu possa trovare il download nella pagina di download di Webex.
Inserire l'indirizzo e-mail nella schermata di accesso Webex. Fai clic su Avanti.
Solitamente, si viene reindirizzati a una pagina con il marchio del fornitore di servizi.
Questa pagina potrebbe accogliervi tramite il vostro indirizzo e-mail.
Se non è presente alcun indirizzo e-mail o se l'indirizzo e-mail è errato, inserisci il nome utente BroadWorks.
Inserisci la password BroadWorks.
Se è stato eseguito correttamente l'accesso, Webex si apre.
Flusso chiamate - Rubrica aziendale
Flusso chiamata: numero PSTN
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni con i clienti
Recupero del profilo dal registro DMS e SIP con AS
Il client chiama XSI per ottenere un token di gestione dispositivo e l'URL del DMS.
Il client richiede il proprio profilo dispositivo dal DMS presentando il token dal punto 1.
Il client legge il profilo del dispositivo e recupera le credenziali, gli indirizzi e le porte SIP.
Il Client invia un REGISTRO SIP a SBC utilizzando le informazioni dal punto 3.
SBC invia il REGISTRO SIP al SA (l'SBC può eseguire una ricerca nell'NS per individuare un SA se il SBC non conosce già l'utente SIP).
Linee guida per test e laboratorio
Le seguenti linee guida si applicano alle organizzazioni di test e laboratorio:
I partner provider di servizi sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
Tutti gli utenti oltre i primi 50 utenti di test verranno fatturati.
Per garantire un'elaborazione accurata sulla fattura, tutte le organizzazioni di test devono includere il "test" nel nome dell'organizzazione BroadWorks.
Le organizzazioni di test interni devono essere designate all'interno di Webex Control Hub. Ciò al fine di impedire agli utenti di test di essere fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di prova:
Accedi a Partner Hub e seleziona Clienti.
Selezionare il cliente appropriato.
Nella barra di controllo destra, abilitare il tasto di alternanza Organizzazione test interni.
Riproduzione casella vocale
Per la casella vocale, accertarsi di configurare il server multimediale per utilizzare uno dei seguenti codici:
mp3
wav: i file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android
Se si utilizzano i file wav, eseguire i seguenti comandi CLI per configurare il server applicazioni e il server multimediale:
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACIDITÀ
- Elenco di controllo accessi
- ALVEOLO
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APICI
- Servizio di notifica push Apple
- AS
- Server applicazioni
- ATA
- Adattatore per telefono analogico, adattatore che converte la telefonia analogica in VoIP
- BAMBOLA
- Gestione applicazioni BroadSoft
- Autenticazione base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- ALVEOLARE
- Server di messaggistica BroadSoft
- PALUDE
- Flussi bidirezionali Su HTTP sincrono
- BRI
- Basic Rate Interface BRI è un metodo di accesso ISDN
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico telefonico (cfr. partner, provider di servizi, rivenditore a valore aggiunto)
- CAPTCHA
- Test di Turing pubblico completamente automatizzato per distinguere Computer ed Esseri Umani
- CCXML
- Linguaggio di markup eXtensible controllo chiamate
- CIF
- Formato intermedio comune
- CLI
- Interfaccia riga di comando
- CN
- Nome comune
- CNPS
- Server push notifiche chiamate. Un server push notifiche che viene eseguito su un ADP XSP| nel proprio ambiente per eseguire notifiche di chiamata push su FCM e APNS. Vedere il proxy NPS.
- CPE
- Attrezzatura della sede del cliente
- CPR
- Regola presenza personalizzata
- CENERE
- Foglio stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione telefonia computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- NoDist
- Non disturbare
- DNS
- Sistema dei nomi di dominio
- DPG
- Chiama gruppo di pari
- DSCP
- Punto codice servizi differenziati
- DTAF
- File di archivio tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza a doppia tonalità
- Utente finale
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. Sottoscrittore)
- Aziendale
- Una raccolta di utenti finali (cfr. Organizzazione)
- FUSO
- Messaggistica cloud Firebase
- DI FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creare utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning completo flow-through
- Creare e verificare gli utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks e asserendo che ciascun utente BroadWorks dispone di un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. È la spina sul telefono o fax o i connettori sul sistema telefonico analogico. Fornisce un'indicazione di aggancio/aggancio sganciato (chiusura con loop). Poiché la porta FXO è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo FXO".
- FXS
- Foreign Exchange Subscriber è la porta che effettivamente fornisce la linea analogica all'abbonato. In altre parole, è la "spina nella parete" che fornisce un segnale di linea, corrente della batteria e tensione della suoneria.
- GABBIA
- Messaggio cloud Google
- GABBIA
- Modalità Galois/Counter (tecnologia di crittografia)
- HID
- Dispositivo interfaccia uomo
- HTTPS
- Prese protette da protocollo di trasferimento ipertestuale
- IAD
- Dispositivo di accesso integrato
- IM&P
- messaggistica istantanea e presenza
- PSTN IP
- Un provider di servizi che fornisce VoIP ai servizi PSTN, intercambiabile con ITSP, o un termine generale per la telefonia "pubblica" connessa a Internet, fornito collettivamente dai principali provider di telecomunicazioni (piuttosto che dai paesi, come è PSTN)
- ITSP
- Provider servizi di telefonia Internet
- IVR
- Risposta vocale/risponditore interattiva
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificatore Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notazione oggetto script Java
- JESS
- Java Secure Socket Extension; la tecnologia sottostante che fornisce funzioni di connettività sicure ai server BroadWorks
- KEM
- Modulo interno chiave (telefoni Cisco hardware)
- LLT
- Token di lunga durata (o Long Life): token di connessione autodescrittivo e sicuro che consente agli utenti di rimanere autenticati più a lungo e non è legato ad applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIGLIO
- Base di informazioni di gestione
- AVV.
- Server multimediale
- mTLS
- Autenticazione reciproca tra due parti, tramite scambio di certificati, quando si stabilisce una connessione TLS
- MUCO
- Chat con più utenti
- NAT
- Traduzioni dell'indirizzo di rete
- NPS
- Server push notifica; vedere CNPS
- Proxy NPS
-
Un servizio in Webex che fornisce token di autorizzazione di breve durata al CNPS, consentendo di eseguire notifiche di chiamata push a FCM e APN e, in ultima analisi, a dispositivi Android e iOS con Webex.
- ASSOCIAZIONE
- Apri interfaccia client
- Organizzazione
- Società o organizzazione che rappresentano un insieme di utenti finali (cfr. Impresa)
- OTG
- Gruppo di trunk in uscita
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- Partner
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. rivenditore a valore aggiunto, fornitore di servizi, gestore telefonico)
- PBX
- Borsa filiale privata
- DELLA SOCIETÀ
- E-mail avanzata per la privacy
- PIEDINO
- Rete mobile terrestre pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia per le telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- P.ES.
- Server profilo
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Sito web che consente all’amministratore del rivenditore di configurare la soluzione UC-One SaaS. Talvolta viene indicato come portale BAM, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Revisore di frontiera sessione
- CEMENTAZIONE
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; un'organizzazione che fornisce servizi di telefonia o correlati ad altre organizzazioni (cfr. vettore, partner, rivenditore a valore aggiunto)
- SIP
- Protocollo di avvio sessione
- SLITTA
- Token di breve durata (o Short Life) (chiamato anche BroadWorks SSO Token); token autenticato monouso utilizzato per accedere in sicurezza ad applicazioni Web.
- ODORE
- Piccole e medie imprese
- SNMP
- Protocollo di gestione di rete semplice
- sRTCP
- protocollo di controllo trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- sRTP
- protocollo di trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- SSL
- Strato di prese sicure
- Abbonato
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. utente finale)
- TCP
- Protocollo di controllo del cambio
- TDM
- Divisione Tempo Multiplexing
- TLS
- Sicurezza livello trasporto
- ToS
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Comunicazioni unificate
- UI
- Interfaccia utente
- U ID
- Identificativo univoco
- MUTI
- Server di messaggistica
- URI
- Identificativo risorsa uniforme
- URL
- Ricerca risorse uniformi
- DISTURBO
- Condivisione server
- UTC
- Coordinated Universal Time
- UVS.
- Server video
- Rivenditore a valore aggiunto (VAR)
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. vettore, partner, fornitore di servizi)
- VAMPATA
- Array di grafica video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Linguaggio di markup estensibile vocale
- WebDAV
- Creazione e versioni distribuite su Web
- WebRTC
- Comunicazioni Web in tempo reale
- WRS
- Server WebRTC
- XMPP
- Protocollo di presenza e messaggistica estendibile
Configurazione dei servizi (con mTLS per il servizio autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida token CI. Queste procedure sono obbligatorie se si stanno eseguendo più organizzazioni Webex dallo stesso server ADP XSP|. In caso contrario, sono facoltativi.
Se non si eseguono più organizzazioni Webex sullo stesso server ADP XSP|, si consiglia la convalida del token CI (con TLS) per il servizio di autenticazione. Fare riferimento a Configura servizi su Webex per Cisco BroadWorks XSP|ADPs per informazioni dettagliate su come configurare il servizio di autenticazione e altri servizi. |
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con mTLS)
I token longevi di BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sui tuoi XSP|ADP.
Requisiti
I server XSP|ADP che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
XSP|ADP devono condividere le stesse chiavi per crittografare/decrittografare token di lunga durata BroadWorks. Copiare queste chiavi in ogni XSP|ADP è un processo manuale.
Gli ADP XSP|devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli XSP|ADP include:
Distribuire il servizio di autenticazione.
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
Generare e condividere le chiavi RSA su XSP|ADP.
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ogni XSP|ADP utilizzato con Webex:
Attivare l'applicazione del servizio di autenticazione sul percorso
/authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService
(dove
<version>
è la versione BroadWorks).Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
deploy application /authService
Configurazione della durata del token
Verificare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
Impostare la durata su 60 giorni (max 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
set tokenDurationInHours 1440
Genera e condividi chiavi RSA
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori è necessario generare chiavi su un XSP|ADP quindi copiarle su tutti gli altri XSP|ADP.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP. |
Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web
Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token.
Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità per il servizio di autenticazione (con mTLS)
Accedi a Control Hub con l'account amministratore del partner.
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
.Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
.Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Esegui GuidaUpdateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot2023
,webexclientissuing
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte e quattro le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, è richiesto mTLS per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/HttpServer>
e eseguire ilget
comando per visualizzare le interfacce.Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che significa come mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. In sostanza, il primo
true
protegge l'interfaccia con TLS (il certificato del server viene creato se richiesto) e la secondatrue
forza l'interfaccia a richiedere l'autenticazione del certificato del client (insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Interface Port Name Secure Client Auth Req Cluster Fqdn
=======================================================
192.0.2.7 443 XSP|ADP01.collab.example.net true false
192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (autenticazione client richiesta = true) è abilitato il 192.0.2.7
porta 444
. TLS abilitato su 192.0.2.7
porta 443
.
(Opzione) Configurazione di mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, è necessario mTLS per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
e eseguire ilget
per visualizzare le applicazioni in esecuzione.Per aggiungere un'applicazione e richiederne l'autenticazione client (ovvero mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. I nomi delle applicazioni sono elencati qui. Il
true
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
add 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService a 192.0.2.7:443 e richiede di richiedere e autenticare i certificati dal client.
Verifica con get
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
get
Interface Ip Port Application Name Client Auth Req
===================================================
192.0.2.7 443 AuthenticationService true
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Dove andare Avanti
Per la configurazione, è possibile accedere nuovamente al flusso dei documenti principale all'interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca rispetto a AuthService
Webex interagisce con il servizio di autenticazione su una connessione TLS autenticata reciproca. Ciò significa che Webex presenta un certificato client e che XSP|ADP deve convalidarlo. Per garantire l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora attendibile su XSP|ADP (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
Vai a Impostazioni > BroadWorks Calling.
Fare clic sul collegamento del certificato di download.
È inoltre possibile scaricare la catena di certificati da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt. |
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il diagramma seguente riassume dove deve essere distribuita la catena di certificati CA Webex in questi tre casi.
Requisiti del certificato TLS reciproco per proxy bridge TLS
Webex presenta un certificato client firmato da CA Webex al proxy.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità proxy, pertanto il proxy considera attendibile il certificato del client.
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta un certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions:
X509v3 Extended Key Usage:
1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Requisiti di certificato TLS reciproco per proxy passthrough TLS o XSP in DMZ
Webex presenta un certificato client firmato da CA Webex agli XSP.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità degli XSP, pertanto gli XSP si affidano al certificato client.
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
Gli XSP presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i certificati server degli XSP.
Cronologia revisioni documenti
La tabella seguente mostra lo storico delle modifiche apportate a questo documento negli ultimi 12 mesi.
Data | Versione | Descrizione della modifica | |
---|---|---|---|
2 maggio 2024 | 2-115 |
| |
10 aprile 2024 | 2-114 |
| |
27 marzo 2024 | 2-113 |
| |
22 marzo 2024 | 2-112 |
| |
7 marzo 2024 | 2-111 |
| |
24 febbraio 2024 | 2-110 |
| |
20 febbraio 2024 | 2-109 |
| |
7 febbraio 2024 | 2-108 |
| |
25 gennaio 2024 | 2-107 |
| |
23 gennaio 2024 | 2-106 |
| |
10 gennaio 2024 | 2-105 |
| |
20 dicembre 2023 | 2-104 |
| |
13 dicembre 2023 | 2-103 |
| |
12 dicembre 2023 | 2-102 |
| |
8 dicembre 2023 | 2-101 |
| |
08 novembre 2023 | 2-100 |
| |
25 ottobre 2023 | 2-99 |
| |
13 settembre 2023 | 2-98 |
| |
04 settembre 2023 | 2-97 |
| |
08 agosto 2023 | 2-96 |
| |
23 giugno 2023 | 2-95 |
| |
30 maggio 2023 | 2-94 |
| |
26 maggio 2023 | 2-93 |
| |
24 maggio 2023 | 2-92 |
| |
10 maggio 2023 | 2-91 |
| |
09 maggio 2023 | 2-90 |
| |
4 maggio 2023 | 2-89 |
| |
27 aprile 2023 | 2-88 |
| |
14 aprile 2023 | 2-87 |
| |
17 marzo 2023 | 2-86 |
| |
11 marzo 2023 | 2-85 |
| |
10 marzo 2023 | 2-84 |
| |
7 marzo 2023 | 2-83 |
| |
28 febbraio 2023 | 2-82 |
| |
15 febbraio 2023 | 2-81 |
| |
10 febbraio 2023 | 2-80 |
| |
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione si rivolge agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei propri clienti o forniscono questa soluzione direttamente ai propri abbonati.
Scopo della soluzione
Fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che già dispongono del servizio di chiamata fornito dai provider di servizi BroadWorks.
Fornire il servizio di chiamata basato su BroadWorks a clienti Webex piccoli e medi.
Contesto
Stiamo evolvendo tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo sforzo consiste nello spostare le funzionalità di chiamata BroadWorks nell'app Webex e infine ridurre gli investimenti nei client UC-One.
Vantaggi
Prova futura: contro interruzione del servizio di UC-One Collaborate, spostamento di tutti i client verso Unified Client Framework (UCF)
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex mantenendo la chiamata BroadWorks sulla rete di telefonia
Ambito della soluzione
Clienti da piccoli a medi esistenti/nuovi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre di chiamate BroadWorks.
Clienti Webex esistenti di piccole e medie dimensioni che desiderano aggiungere BroadWorks Calling.
Non aziende più grandi (rivedere il nostro portfolio Enterprise per Webex).
Non utenti singoli (valutare le offerte Webex Online).
Le funzioni impostate in Webex per Cisco BroadWorks riguardano casi d'uso di piccole e medie imprese. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità per le PMI e ne valutiamo costantemente l'idoneità per questo segmento. Possiamo scegliere di nascondere o rimuovere funzioni che sarebbero altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# | Requisito | Note | ||
---|---|---|---|---|
1 | Patch BroadWorks R22 corrente o superiore | |||
2 | XSP|ADP per XSI, CTI, DMS e authService | XSP|ADP dedicato per Webex per Cisco BroadWorks | ||
3 | XSP|ADP separato per NPS, può essere condiviso con altre soluzioni che utilizzano NPS. | Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni XSP|ADP e NPS. | ||
4 | Convalida token CI (con TLS) configurata per le connessioni Webex al servizio di autenticazione. | |||
5 | mTLS configurato per le connessioni Webex all'interfaccia CTI. | Altre applicazioni non richiedono mTLS. | ||
6 | Gli utenti devono essere presenti in BroadWorks e necessitano dei seguenti attributi, a seconda della decisione di provisioning:
| Per i messaggi e-mail attendibili: Si consiglia di inserire lo stesso indirizzo e-mail anche nell'attributo ID alternativo, per consentire agli utenti di accedere con indirizzo e-mail rispetto a BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'uso di e-mail non attendibili può causare l'invio dell'e-mail alla cartella Posta indesiderata o SPAM dell'utente. L'amministratore potrebbe dover modificare le impostazioni e-mail dell'utente per consentire i domini | ||
7 | Webex per il file DTAF Cisco BroadWorks per l'app Webex | |||
8 | Utente BW Business Lic o Std Enterprise o Prem Enterprise Lic + Webex per abbonamento Cisco BroadWorks | Se si dispone di una distribuzione di collaborazione esistente, non è più necessario il pacchetto aggiuntivo UC-One, le porte per conferenze Collab Lic e Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non occorre apportare altre modifiche se non accettare i termini del pacchetto Premium. | ||
9 | IP/porte devono essere accessibili attraverso i servizi backend Webex e le app Webex su Internet pubblico. | Vedere la sezione "Preparazione della rete". | ||
10 | Configurazione TLS v1.2 su XSP|ADP | |||
11 | Per il provisioning Flowthrough, il server applicazioni deve connettersi all'adattatore di provisioning BroadWorks.
| Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è aiutarti a comprendere, preparare, distribuire e gestire la tua soluzione Webex per Cisco BroadWorks. Le principali sezioni del documento riflettono tale obiettivo.
Questa guida include materiale concettuale e di riferimento. In questo documento intendiamo trattare tutti gli aspetti della soluzione.
La serie minima di attività per distribuire la soluzione è la seguente:
Contatta il team dell'account per diventare un partner Cisco. È fondamentale esplorare i punti di contatto Cisco per acquisire familiarità (e ricevere formazione). Quando si diventa partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Onboarding partner in questo documento.
Configura i tuoi sistemi BroadWorks per l'integrazione con Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento.
Usa Partner Hub per connettere Webex a BroadWorks. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione partner in Partner Hub in questo documento.
Utilizzare Partner Hub per preparare i modelli di provisioning degli utenti. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento.
Testare e eseguire l'onboarding di un cliente mediante il provisioning di almeno un utente (vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
|
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. (Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto).
Come funziona
Webex per Cisco BroadWorks è un'offerta che integra BroadWorks Calling in Webex. Gli abbonati utilizzano una singola applicazione (l'app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
Gli utenti chiamano i numeri PSTN utilizzando l'infrastruttura BroadWorks.
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino numerico per introdurre i numeri).
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Chiamata Webex" sull'app Webex. (Queste chiamate sono da app Webex a app Webex, non da app Webex a PSTN).
Gli utenti possono organizzare e accedere a Webex Meetings.
Gli utenti possono scambiarsi messaggi uno a uno o in spazi (chat di gruppo persistente) e beneficiare di funzioni come ricerca e condivisione file (sull'infrastruttura Webex).
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
Una volta eseguito l'onboarding come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare la relazione tra l'istanza BroadWorks e Webex.
È possibile creare organizzazioni dei clienti in Control Hub e eseguire il provisioning degli utenti in tali organizzazioni.
Ogni abbonato in BroadWorks riceve un'identità Webex in base al proprio indirizzo e-mail (attributo ID e-mail in BroadWorks).
Gli utenti eseguono l'autenticazione su BroadWorks o su Webex.
Ai clienti vengono rilasciati token di lunga durata per autorizzarli per i servizi su BroadWorks e Webex.
L'app Webex al centro di questa soluzione, è un'applicazione personalizzabile disponibile su desktop Mac/Windows e dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzionalità di messaggistica, presenza e riunioni.
Il client esegue la registrazione ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i tuoi sistemi BroadWorks per garantire un'esperienza di provisioning utente perfetta.
Funzioni e limitazioni
Offriamo diversi pacchetti con diverse caratteristiche.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata, ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano nella rubrica un utente softphone, i risultati della ricerca non forniscono alcuna opzione per inviare un messaggio.
Gli utenti del softphone possono condividere lo schermo durante una chiamata.
Pacchetto "base"
Il pacchetto di base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti in riunioni a "spazio unificato" e riunioni nella sala riunioni personale. (** vedere la seguente nota a titolo di eccezione). In questo pacchetto le riunioni possono avere una durata massima di 40 minuti.
Pacchetto "Standard"
Questo pacchetto include anche tutto quello che è contenuto nel pacchetto Base, ad esempio fino a 100 partecipanti nelle riunioni "spazio unificato" e nelle riunioni nella sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è un ruolo inizialmente ricoperto solo dall'organizzatore della riunione, ma l'organizzatore può passare il "ruolo di relatore" a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può riprendere il ruolo di relatore senza che l'organizzatore corrente glielo passi.
Pacchetto "Premium"
Questo pacchetto include tutto nel pacchetto Standard più un massimo di 300 partecipanti in una riunione "spazio unificato" e fino a 1000 partecipanti in una sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è supportata per qualsiasi partecipante alla riunione.
Confronta pacchetti
Pacchetto | Chiamata | Messaggistica | Riunioni nello spazio Unified | PMR riunioni |
---|---|---|---|---|
Softphone | Incluso | Non incluso | Nessuno | Nessuno |
Base | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Standard | Incluso | Incluso | 100 partecipanti | 100 partecipanti |
Premium | Incluso | Incluso | 300 partecipanti | 1000 partecipanti |
Il limite della riunione nello spazio Unified per gli utenti Base è 100 partecipanti per riunione nello spazio Unified a meno che lo spazio non includa anche gli utenti a cui sono assegnati i pacchetti "Standard" o "Premium", nel qual caso il limite aumenta in base al pacchetto utente organizzatore. |
"Riunioni nello spazio Unified" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti "Riunione" o "Pianifica". "Riunioni PMR" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale (PMR) di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID). |
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per le differenze di supporto delle funzioni di riunione PMR per i pacchetti Base, Standard e Premium.
Funzione riunione | Supportato con il pacchetto base | Suported con pacchetto standard | Supportato con il pacchetto Preminum | Commento |
---|---|---|---|---|
Durata riunione | 40 minuti o meno | Illimitato | Illimitato | |
Condivisione desktop | Sì | Sì | Sì | Base: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione desktop solo da parte dell'organizzatore della riunione PMR. Premium: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. |
Condivisione applicazione | Sì | Sì | Sì | Base: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione delle applicazioni solo da parte dell'organizzatore della riunione PMR. Premium: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. |
Chat con più interlocutori | Sì | Sì | Sì | |
Lavagna | Sì | Sì | Sì | |
Protezione con password | Sì | Sì | Sì | |
App Web - nessun download o plug-in (Esperienza ospite) | Sì | Sì | Sì | |
Supporto dell'accoppiamento con i dispositivi Webex | Sì | Sì | Sì | |
Controllo del pavimento (disattivazione del microfono uno / espulsione tutti) | Sì | Sì | Sì | |
Collegamento Riunioni persistenti | Sì | Sì | Sì | |
Accesso sito riunioni | Sì | Sì | Sì | |
Accesso alla riunione tramite VoIP | Sì | Sì | Sì | |
Bloccaggio | Sì | Sì | Sì | |
Controlli relatore | No | No | Sì | |
Controllo desktop remoto | No | No | Sì | |
Numero di partecipanti | 100 | 100 | 1000 | |
Registrazione salvata in locale nel sistema | Sì | Sì | Sì | |
Registrazione nel cloud | No | No | Sì | |
Registrazione - Cloud Storage | No | No | 10 GB per sito | |
Trascrizione delle registrazioni | No | No | Sì | |
Pianificazione riunione | Sì | Sì | Sì | |
Abilita condivisione contenuto con integrazioni esterne | No | No | Sì | Base: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. Standard: condivisione di contenuto solo da parte dell'organizzatore della riunione PMR. Premium: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. |
Consenti modifica URL PMR | No | No | Sì | Base: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori dei partner e delle organizzazioni possono modificare l'URL da Control Hub. Standard: l'URL PMR può essere modificato solo da Partner Hub per Partner e amministratori organizzazione. Premium: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori partner e dell'organizzazione possono modificare l'URL da Partner Hub. |
Streaming in diretta riunioni (Ad Esempio, su Facebook, Youtube) | No | No | Sì | |
Consenti ad altri utenti di pianificare riunioni per loro conto | No | No | Sì | |
Aggiungi organizzatore alternativo | Sì | No | Sì | |
Integrazione app (es., Zendesk, Slack) | Dipende dall'integrazione | Dipende dall'integrazione | Sì | Per ulteriori informazioni sul supporto, vedere la sezione Integrazioni app riportata di seguito. |
Integrazione con il calendario Microsoft Office 365 | Sì | Sì | Sì | |
Integrazione con Google Calendaring per G Suite | Sì | Sì | Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione rivolta agli utenti per Webex su help.webex.com
. Per ulteriori informazioni sulle funzioni, leggere i seguenti articoli:
Funzioni di chiamata
L'esperienza di chiamata è simile alle soluzioni precedenti che utilizzano il motore di controllo delle chiamate BroadWorks. La differenza tra UC-One Collaborate e UC-One SaaS è che l'app Webex è il client software principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
Zendesk—Solo Premium
Slack: solo Premium
Microsoft Teams per Webex Meetings—Standard o Premium
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
Calendario Office 365—Standard o Premium
Google Calendaring per G Suite: standard o premium
Supporto dell'infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta gli ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione per Webex per l'infrastruttura desktop virtuale (VDI).
Supporto per IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Pro Pack per Control Hub
Il servizio componente aggiuntivo Pro Pack per Control Hub fornisce ad amministratori, professionisti della sicurezza delle informazioni e responsabili della conformità funzionalità avanzate in termini di sicurezza, conformità e analisi che possono essere integrate con il software.
Questi servizi aggiuntivi saranno disponibili solo per i pacchetti Standard e Premium.
Per ulteriori informazioni, vedi la Pagina della Guida di Pro Pack per Control Hub.
Tabella di marcia futura
Per informazioni sulle nostre intenzioni per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Le voci della roadmap non sono vincolanti in alcuna capacità. Cisco si riserva il diritto di sospendere o rivedere uno o tutti questi elementi dalle release future.
Selezione ID chiamante esterno flessibile
Questa funzione, Selezione ID chiamante esterno flessibile, consente agli utenti di selezionare l'ID chiamante esterno desiderato quando effettuano chiamate in uscita. Questo miglioramento è disponibile sui telefoni da tavolo che richiedono un codice FAC.
Flessibilità utente: Gli utenti possono scegliere l'ID chiamante più appropriato per diverse chiamate, migliorando l'efficacia della comunicazione in base al contesto della chiamata.
Supporto piattaforma: I telefoni fissi necessitano di un codice FAC per questa funzionalità. Configurazione amministratore: Gli amministratori hanno la possibilità di configurare gli ID chiamante disponibili per gli utenti.
Requisiti di provisioning: La configurazione amministratore è necessaria su Cisco BroadWorks per rendere disponibili diversi ID chiamante.
Limiti
Limitazioni di provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario del sito Webex Meetings creato per tale pacchetto.
Se nella richiesta di provisioning per il primo utente di ciascun pacchetto non viene specificato alcun fuso orario, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sull'impostazione predefinita regionale dell'organizzazione degli abbonati.
Se il cliente necessita di uno specifico fuso orario del sito di Webex Meetings, specificare timezone
parametro nella richiesta di provisioning per:
il primo abbonato predisposto per il pacchetto Standard nell'organizzazione.
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
il primo abbonato predisposto per il pacchetto base nell'organizzazione.
Limitazioni generali
Nessuna chiamata nella versione Web del client Webex (questa è una limitazione del client, non una limitazione della soluzione).
Webex potrebbe non disporre ancora di tutti i controlli dell'interfaccia utente per supportare alcune funzioni di controllo delle chiamate disponibili da BroadWorks.
Attualmente, il client Webex non può essere "White Labeled" (etichetta bianca).
Quando si creano le organizzazioni dei clienti utilizzando il metodo di provisioning scelto, vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. Ci aspettiamo che i partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
I report sull'utilizzo di riunioni e messaggi sono disponibili attraverso l'organizzazione del cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti di messaggistica
I seguenti limiti di archiviazione dei dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo storage massimo per messaggistica e file combinati.
Di base: 2 GB per utente per 3 anni
Standard 5 GB per utente per 3 anni
Premio: 10 GB per utente per 5 anni
Per ciascuna organizzazione del cliente, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti premium ha un limite totale di messaggistica e storage file di 50 GB. Un singolo utente può superare il limite per utente (10 GB), a condizione che la società sia ancora al di sotto del massimo aggregato (50 GB).
Per gli spazi team creati, i limiti di messaggistica vengono applicati al totale aggregato per l'organizzazione cliente che possiede lo spazio team. Puoi trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti generali di messaggistica applicabili agli spazi dei team di messaggistica Webex, fare riferimento a https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure le connessioni a Webex e BroadWorks. I dati memorizzati nel cloud Webex ed esposti all'utente attraverso l'interfaccia dell'app Webex sono crittografati sia in transito che a riposo.
Maggiori dettagli sullo scambio di dati sono disponibili nella sezione Riferimento del presente documento.
Ulteriori letture
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati che più si avvicina alla propria regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore del provider di servizi (utente): Per le attività di manutenzione quotidiane, si gestiscono le parti della soluzione in sede (chiamata) utilizzando i propri sistemi. Gestisci le parti Webex della soluzione attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale.
Il primo utente predisposto per un nuovo organizzatore partner viene assegnato automaticamente ai ruoli amministratore completo e amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi. |
Team operativo di Cisco cloud: Crea la tua "organizzazione partner" in Partner Hub, se non esiste, durante l'onboarding.
Una volta ottenuto l'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente, create "Onboarding templates" (Modelli di onboarding) per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Quindi si fornisce i vostri clienti o abbonati.
# | Compito tipico | SP | Cisco |
---|---|---|---|
1 | Onboarding partner - Creazione dell'organizzazione partner se non esiste e abilitazione dei tasti di alternanza funzione necessari | ● | |
2 | Configurazione BroadWorks nell'organizzazione partner tramite Partner Hub (cluster) | ● | |
3 | Configurazione delle impostazioni di integrazione in Organizzazione partner tramite Partner Hub (modelli di offerta, branding) | ● | |
4 | Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|ADP Patching, firewall, configurazione XSP|ADP, XSI, AuthService, CTI, NPS, applicazioni DMS su XSP|ADP) | ● | |
5 | Sviluppo dell'integrazione o del processo di provisioning | ● | |
6 | Preparare i materiali GTM | ● | |
7 | Migrazione o provisioning di nuovi utenti | ● |
Architettura
Cosa c'è nel diagramma?
Client
Il client dell'app Webex serve come applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di messaggistica nativa, presenza e riunioni audio/video multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per le chiamate SIP e PSTN.
I telefoni IP Cisco e i relativi accessori utilizzano anche l'infrastruttura BroadWorks per le chiamate SIP e PSTN. Ci aspettiamo di essere in grado di supportare telefoni di terze parti.
Portale di attivazione utente per gli utenti che accedono a Webex utilizzando le credenziali BroadWorks.
Partner Hub è un'interfaccia Web per l'amministrazione dell'organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. Puoi anche utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
Rete di provider di servizi
Il blocco verde a sinistra dello schema rappresenta la tua rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
XSP|ADP rivolto al pubblico, per Webex per Cisco BroadWorks: (La scatola rappresenta una o più fattorie XSP|ADP, eventualmente frontali da bilanciatori di carico).
Ospita l'interfaccia dei servizi Xtended (XSI-Actions & XSI-Events), il servizio di gestione dei dispositivi (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato del ricevitore dell'altro (presenza di telefonia) e la cronologia chiamate.
Pubblica la rubrica ai client Webex.
XSP|ADP rivolto al pubblico, con NPS in esecuzione:
server push notifiche chiamate organizzatore: Un server push di notifica su un ADP XSP| nel proprio ambiente. Si interfaccia tra il server applicazioni e il proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS & FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
Server applicazioni:
Fornisce il controllo delle chiamate e le interfacce ad altri sistemi BroadWorks (generalmente)
Per il provisioning flowthrough, l'AS viene utilizzato dall'amministratore del partner per il provisioning degli utenti in Webex
Inserisce il profilo utente in BroadWorks
OSS/BSS: Sistema di supporto alle operazioni/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nello schema rappresenta il cloud Webex. I microservizi Webex supportano l'intero spettro di funzionalità di collaborazione Webex:
Cisco Common Identity (CI) è il servizio identità all'interno di Webex.
Webex per Cisco BroadWorks rappresenta la serie di microservizi che supportano l'integrazione tra Webex e BroadWorks ospitato da provider di servizi:
API di provisioning utente
Configurazione provider di servizi
Accesso utente mediante credenziali BroadWorks
Casella di messaggistica Webex per microservizi correlati alla messaggistica.
Casella Webex Meetings che rappresenta server di elaborazione multimediale e SBC per riunioni video con più partecipanti (SIP e SRTP)
Servizi Web di terze parti
Nello schema sono rappresentati i seguenti componenti di terze parti:
APNS (Apple Push Notifications Service) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Apple.
FCM (messaggistica cloud FireBase) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Il ruolo dei server XSP|ADP aperti al pubblico in Webex per Cisco BroadWorks
L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste Webex per BroadWorks JWT (JSON Web Token) per conto dell'utente
Interfaccia CTI, protetta da mTLS, a cui Webex sottoscrive gli eventi della cronologia chiamate e lo stato della presenza di telefonia da BroadWorks (stato hook).
Interfacce azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate degli abbonati, rubriche di elenchi di contatti e chiamate e configurazione del servizio di telefonia per gli utenti finali
Servizio DM (Device Management) per il recupero dei file di configurazione delle chiamate da parte dei client
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedere Configurazione dei cluster BroadWorks in Partner Hub in questo documento. Per ciascun cluster, è possibile fornire un solo URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP
È necessario utilizzare un'istanza ADP XSP|dedicata o un'azienda agricola separata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile organizzare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso XSP|ADP che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/azienda agricola ADP XSP| dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
Ad esempio, se offri UC-One SaaS, ti consigliamo di creare una nuova fattoria XSP|ADP per Webex per Cisco BroadWorks. In questo modo i due servizi possono operare in modo indipendente durante la migrazione degli abbonati.
Se si collocano le applicazioni Webex per Cisco BroadWorks in una fattoria ADP|XSP utilizzata per altri scopi, è responsabilità dell'utente monitorare l'utilizzo, gestire la complessità risultante e pianificare l'aumento della scala.
Il pianificatore della capacità di sistema Cisco BroadWorks assume una fattoria ADP XSP| dedicata e potrebbe non essere preciso se la si utilizza per i calcoli della posizione.
Se non diversamente specificato, gli Webex dedicati per Cisco BroadWorks XSP|ADP devono ospitare le seguenti applicazioni:
AuthService (TLS con convalida token CI o mTLS)
CTI (mTLS)
Azioni XSI (TLS)
XSI-Events (TLS)
DMS (TLS): opzionale. Non è obbligatorio distribuire un'istanza DMS o un'azienda agricola separata specificamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
TLS (Call Settings Webview): opzionale. La vista Webview (CSW) delle impostazioni di chiamata è richiesta solo se si desidera che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso a CTI attraverso un'interfaccia protetta dall'autenticazione TLS reciproca. Per supportare questo requisito, raccomandiamo una delle seguenti opzioni:
(Diagramma etichettato Opzione 1) Una istanza XSP|ADP o un'azienda agricola per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
(Diagramma etichettato Opzione 2) Due istanze ADP XSP| o aziende agricole, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSP|ADP Se si dispone di una fattoria ADP XSP|esistente conforme a una delle architetture suggerite sopra (Opzione 1 o 2) ed è leggermente caricata, è possibile riutilizzare le ADP XSP|esistenti. Dovrai verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti dell'applicazione per Webex. Le due considerazioni principali sono:
Poiché gli XSP|ADP hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero esserci altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di XSP|ADP deve essere verificato in un laboratorio con la configurazione desiderata prima di impegnarsi per il riutilizzo. |
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione temporale per tutti gli XSP|ADP utilizzati con Webex.
Installare il ntp
pacchetto dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Quindi è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, consultare la Guida alla gestione del software BroadWorks.
Durante l'installazione interattiva del software XSP|ADP, è possibile configurare NTP. Procedere come segue:
Quando l'installatore chiede,
Do you want to configure NTP?
, immetterey
.Quando l'installatore chiede,
Is this server going to be a NTP server?
, immetteren
.Quando l'installatore chiede,
What is the NTP address, hostname, or FQDN?
, immettere l'indirizzo del server NTP o un servizio NTP pubblico, ad esempio,pool.ntp.org
.
Se gli ADP XSP|utilizzano un'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie Key=Value:
NTP
NTP_SERVER=<NTP Server address, e.g., pool.ntp.org>
Requisiti di identità e sicurezza XSP|ADP
Sfondo
I protocolli e le crittografie delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli vanno dal più generale (provider SSL) al più specifico (interfaccia singola). Un'impostazione più specifica sostituisce sempre un'impostazione più generale. Se non sono specificate, le impostazioni SSL di livello "inferiore" vengono ereditate da livelli "superiori".
Se non viene modificata alcuna impostazione rispetto alle impostazioni predefinite, tutti i livelli ereditano le impostazioni predefinite del provider SSL (JSSE Java Secure Sockets Extension).
Elenco dei requisiti
L'|ADP XSP deve autenticarsi sui client utilizzando un certificato firmato da CA in cui il nome comune o il nome alternativo oggetto corrispondono alla parte di dominio dell'interfaccia XSI.
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
Diffie-Hellman Effemeral (DHE) o curve ellittiche Diffie-Hellman Effemeral (ECDHE) chiave-scambio
Crittografia AES (Advanced Encryption Standard) con una dimensione minima di blocco di 128 bit (ad esempio, AES-128 o AES-256)
Modalità di codifica GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
Se viene utilizzata una crittografia CBC, solo la famiglia SHA2 di funzioni hash è consentita per derivazione chiave (SHA256, SHA384, SHA512).
Ad esempio, le seguenti crittografie soddisfano i requisiti:
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come illustrato sopra, non la convenzione openSSL. |
Crittografie TLS supportate per le interfacce AuthService e XSI
Questo elenco è soggetto a modifiche a mano a mano che evolvono i nostri requisiti di sicurezza del cloud. Seguire l'attuale raccomandazione sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento. |
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_AES_256_GCM_SHA384
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_128_GCM_SHA256
TLS_PSK_WITH_AES_128_GCM_SHA256
TLS_RSA_WITH_AES_256_CBC_SHA256
TLS_RSA_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
TLS_RSA_WITH_AES_256_CBC_SHA
TLS_PSK_WITH_AES_256_CBC_SHA384
TLS_PSK_WITH_AES_256_CBC_SHA
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA
TLS_PSK_WITH_AES_128_CBC_SHA256
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri della scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il numero di thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi visualizzati come segue (non diminuirli se sono al di sopra di questi valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più |ADP XSP
Elemento bordo bilanciamento carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, deve gestire in modo trasparente la distribuzione del traffico tra più server XSP|ADP e il cloud e i client Webex per Cisco BroadWorks. In questo caso, è possibile fornire l'URL del bilanciatore di carico alla configurazione Webex per Cisco BroadWorks.
Note su questa architettura:
Configurare il DNS in modo che i client possano trovare il bilanciatore di carico quando si connettono all'interfaccia Xsi (vedere configurazione DNS).
Si consiglia di configurare l'elemento edge in modalità proxy SSL inversa per garantire la crittografia dei dati punto a punto.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Server XSP|ADP orientati verso Internet
Se si espongono direttamente le interfacce Xsi, utilizzare il DNS per distribuire il traffico ai più server XSP|ADP.
Note su questa architettura:
Per connettersi ai server XSP|ADP sono necessari due record:
Per i microservizi Webex: Per targetizzare più indirizzi IP XSP|ADP sono necessari record A/AAAA round-robin. Questo perché i microservizi Webex non possono effettuare ricerche SRV. Per esempi, vedere Servizi cloud Webex.
Per l'app Webex: Un record SRV che si risolve in record A in cui ogni record A si risolve in un singolo XSP|ADP. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per targetizzare il servizio XSI per più indirizzi XSP|ADP. Assegnare la priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (e all'indirizzo IP successivo) e passino al record A successivo (e all'indirizzo IP) solo se il primo indirizzo IP è inattivo. NON utilizzare un approccio round-robin per l'app Webex.
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune.
È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL XSP|ADP di un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server XSP|ADP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.
Ordinazione e provisioning
L'ordine e il provisioning si applicano a questi livelli:
Provisioning di partner/provider di servizi:
Ogni onboarding di Webex per provider di servizi Cisco BroadWorks (o rivenditore) deve essere configurato come organizzazione partner in Webex e devono essere concesse le autorizzazioni necessarie. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per gestire Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le operazioni di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/aziendale.
Ordinazione e provisioning clienti/aziende:
Ogni BroadWorks Enterprise abilitato per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo si verifica automaticamente come parte del provisioning utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks vengono predisposti nella stessa organizzazione cliente Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
Ordinazione e provisioning utente/abbonato:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning degli utenti:
Provisioning fluviale con e-mail attendibili
Provisioning eseguibile senza e-mail attendibili
Self-provisioning utente
Provisioning API
Provisioning eseguibile con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile affermare che BroadWorks dispone di indirizzi e-mail abbonati validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Provisioning eseguibile senza e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non puoi contare sugli indirizzi e-mail degli abbonati detenuti da BroadWorks, questa opzione di provisioning crea account Webex ma non può attivarli fino a quando gli abbonati non forniscono e convalidano i relativi indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Self-provisioning utente
Con questa opzione, non è disponibile il provisioning flowthrough da BroadWorks a Webex. Una volta configurata l'integrazione tra Webex e il sistema BroadWorks, vengono visualizzati uno o più collegamenti specifici per il provisioning degli utenti all'interno dell'organizzazione partner Webex per Cisco BroadWorks.
Successivamente, si progettano le proprie comunicazioni (o si delegano ai clienti) per distribuire il collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account vengono predisposti nell'ambito dell'organizzazione partner, puoi regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare tale operazione.
Gli utenti devono esistere nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento. |
Provisioning provider di servizi per API
Webex presenta un set di API pubbliche che consentono di creare il provisioning utente/abbonato Webex per Cisco BroadWorks nel flusso di lavoro/negli strumenti di gestione utenti esistenti.
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti Webex per Cisco Broadworks di comporre altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella rubrica Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo dell'estensione di tutte le aree del metodo di avvio chiamata e del profilo dell'utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e gruppi diversi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due imprese che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Utenti Cisco BroadWorks
Provisioning API pubblica come 'interno
Il parametro dell'interno deve essere esplicitamente passato come parte della chiamata API. Per le imprese/gruppi con Location Dialing Code (LDC) configurato, il parametro dell'interno dovrebbe essere la combinazione di LDC e 'numero di interno.
Provisioning flusso o auto-attivazione
Estensione e LDC (se applicabile) saranno automaticamente recuperati da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione di codice di chiamata posizione (LDC) e numero di interno.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'interno |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'estensione deve essere passata come parametro |
Attraverso il flusso | Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Interno sincronizzato da sincronizzazione rubrica |
Elenchi telefonici BroadWorks | Elenchi telefonici aziendali, di gruppo o personali | Sincronizzazione rubriche | Non applicabile |
Prerequisiti
La versione del client richiesta per supportare questa funzione è 42.11 o successiva.
Patch in cui i codici di chiamata di estensione e posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
AP.platform.23.0.1075.ap380045
AP.as.23.0.1075.ap380045
AP.xsp.23.0.1075.ap380045
AP.as.24.0.944.ap380045
Abilitare l'intestazione X-BroadWorks-Remote-Party-Info su AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP richiesto per il supporto della funzione di composizione dell'interno.
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata a interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità delle chiamate di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'estensione come seconda opzione in Partner Hub e Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con estensione attraverso uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione dell'interno sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Non verrà visualizzata un'estensione nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere visibile l'opzione di chiamata dell'interno per i clienti esistenti:
Se un partner desidera che tutte le organizzazioni dei clienti gestite siano dotate di un interno come una delle opzioni di chiamata, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
Se un partner desidera fornire un interno in opzioni di chiamata per una specifica organizzazione cliente, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e portarli alla pari con l'aumento di 30K contatti per l'elenco telefonico Enterprise, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per Organizzazione, che si applica alla somma degli elenchi telefonici Enterprise e Group in una singola azienda BroadWorks. Ad esempio, sarà supportato un'azienda BroadWorks che dispone di un elenco di telefoni aziendali con 30K e anche di 5 elenchi di telefoni di gruppo ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K totali).
Questa funzione è disponibile su richiesta. Contatta il team dell'account per abilitare questa opzione.
|
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks nello storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare a quale gruppo appartiene questo utente. L'associazione dell'utente con un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca dei contatti nello storage del gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning degli abbonati Webex per BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
È possibile eseguire il provisioning dell'ID gruppo aziendale BroadWorks per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
Webex per gli utenti Cisco BroadWorks
Provisioning API pubblica come "spEnterpriseGroupId"
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
Provisioning flusso o auto-attivazione
L'ID gruppo aziendale BroadWorks verrà automaticamente recuperato da BroadWorks.
Utenti o entità di chiamata solo BroadWorks
Non applicabile. Non è necessario sincronizzare l'ID gruppo aziendale BroadWorks per questi utenti.
Record di chiamata BroadWorks | Descrizione | Metodo di provisioning | Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per gli utenti Cisco BroadWorks | Gli utenti sono abilitati per Webex per Cisco BroadWorks | API pubblica | L'ID gruppo aziendale BroadWorks deve essere superato come parametro spEnterpriseGroupId |
Attraverso il flusso | L'ID gruppo aziendale BroadWorks viene recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks | Utenti di chiamata che non hanno eseguito l'onboarding in Webex | Sincronizzazione rubriche | Non applicabile |
Entità chiamanti non utenti | Ad esempio, un telefono di una sala conferenze, un fax, un numero di gruppo di ricerca | Sincronizzazione rubriche | Non applicabile |
Elenchi telefonici BroadWorks | Contatti negli elenchi telefonici del gruppo BroadWorks | Sincronizzazione rubriche | I contatti di gruppo vengono memorizzati nel servizio Webex Contact associato al gruppo specifico |
Elenchi di telefoni BroadWorks Enterpsie o Persional | Contatti negli elenchi telefonici aziendali o personali | Sincronizzazione rubriche | Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. Impossibile completare la migrazione fino a quando QUESTA API non viene completata. L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march Una volta abilitata la funzione e a seguito della sincronizzazione della rubrica successiva, i gruppi di utenti aziendali verranno visualizzati anche in Control Hub. La visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativa in questa fase. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza a un gruppo in Control Hub poiché tali modifiche non verranno riportate nuovamente in BroadWorks. La gestione di gruppo in Control Hub è destinata all'uso da parte dei partner che adotteranno le prossime API di gestione contatti. |
Migrazione e prova del futuro
La progressione Cisco del client di comunicazione unificata BroadSoft deve spostarsi da UC-One a Webex. Si verifica una corrispondente progressione dei servizi di supporto dalla rete del provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che tu stia eseguendo UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita consiste nel distribuire nuovi ADP|XSP dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti in Webex e infine recuperare l'infrastruttura utilizzata per la soluzione precedente.
Sottoscrizioni di documenti consigliate
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Abbonati che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di eseguire l'abbonamento a ciascuno dei seguenti articoli per assicurarsi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per iscriversi, accedere a ciascuno dei link seguenti e nell'articolo che viene visualizzato fare clic sul pulsante Iscriviti.
Come minimo, si consiglia di iscriversi all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati in Documenti aggiuntivi dispone di un'opzione Sottoscrivi . Affinché questa opzione venga visualizzata, l'articolo deve essere visualizzato su help.webex.com.
Non esiste un'opzione di abbonamento per le landing page di documentazione. |
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Documenti Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
Porta la tua soluzione PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono di loro proprietà (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive come eseguire l'onboarding e il servizio dei dispositivi Room OS e MPP.
Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi di Webex per Cisco BroadWorks.
Articoli Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti siti opzionali per ulteriori informazioni su Webex per Cisco BroadWorks:
Documentazione Webex per Cisco BroadWorks: nella pagina di destinazione vengono elencati i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme a quelle presto disponibili.
Problemi noti e limitazioni: informazioni sui problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale: questo articolo descrive come assegnare i ruoli amministratore partner per le organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte della soluzione Cisco BroadWorks:
Articoli della Guida Webex
I seguenti siti della Guida Webex possono essere utilizzati per trovare gli articoli Webex che consentono agli amministratori dei clienti e agli utenti finali di utilizzare le funzioni Webex.
Webex da provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati comunemente per gli utenti dell'app Webex che hanno acquistato i servizi Webex da un provider di servizi.
Centro assistenza Webex: utilizzare la funzione di ricerca su help.webex.com per cercare altri articoli Webex che descrivono la funzionalità dell'app Webex e di Webex Meetings. È possibile ricercare gli articoli utente o amministratore.
Documentazione sviluppatore
Guida per sviluppatori Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Punti di decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastrutture
|
Quanti ADP XSP|? Come prendono l'mTLS? |
Pianificatore capacità di sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento CLI XSP|ADP Il presente documento |
Provisioning cliente e utente | Puoi affermare che ti fidi dei messaggi e-mail in BroadWorks? Vuoi che gli utenti forniscano indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Documenti API pubbliche su https://developer.webex.com Il presente documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo di branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso per i clienti? | Il presente documento |
Funzioni abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o Softphone. | Il presente documento Matrice caratteristiche/pacchetto |
autenticazione protetta | BroadWorks o Webex | Il presente documento |
Adattatore di provisioning (per opzioni di provisioning flowthrough) | Utilizzate già IM&P integrato, ad esempio per UC-One SaaS? Si desidera utilizzare più modelli? È previsto un caso d'uso più comune? |
Il presente documento Riferimento CLI server applicazioni |
Architettura e infrastrutture
Con che tipo di scala intende iniziare? È possibile scalare in futuro, ma la stima di utilizzo attuale dovrebbe guidare la pianificazione dell'infrastruttura.
Collaborare con il proprio account manager/rappresentante di vendita Cisco per dimensionare l'infrastruttura ADP XSP|, in base al Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
In che modo Webex renderà le connessioni TLS reciproche alle tue ADP XSP|? Direttamente a XSP|ADP in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce. (Non supportiamo connessioni TCP non crittografate al perimetro della rete).
Provisioning cliente e utente
Quale metodo di provisioning utente si adatta meglio?
Provisioning eseguibile con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene predisposto automaticamente in Webex.
Se puoi anche affermare che gli indirizzi e-mail dell'abbonato in BroadWorks sono validi e univoci per Webex, puoi utilizzare la variante "email attendibili" del provisioning flowthrough. Gli account Webex abbonati vengono creati e attivati senza il loro intervento; scaricano semplicemente il client e accedono.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto, il provider di servizi deve fornire un indirizzo e-mail valido all'utente per eseguire il provisioning dei servizi Webex. Questo deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo anche nell'attributo ID alternativo.
Provisioning eseguibile senza e-mail attendibili: Se non riesci a fidarti degli indirizzi e-mail degli abbonati, puoi comunque assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
Self-provisioning utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. Tu (o i tuoi clienti) distribuisci invece un collegamento di provisioning e i collegamenti per scaricare i diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare gli account Webex. Quindi, scaricano il client e accedono e Webex recupera una configurazione aggiuntiva su di essi da BroadWorks (inclusi i numeri principali).
Provisioning controllato da SP tramite API: Webex espone una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei propri flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti di sistema generali descritti in questa guida.
Metodo di provisioning | Requisiti |
---|---|
Provisioning del flusso (e-mail attendibili o non attendibili) | L'API di provisioning Webex aggiunge automaticamente gli utenti BroadWorks esistenti a Webex una volta che l'utente soddisfa i requisiti e si attiva il servizio Integrated IM+P. Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Self-provisioning utente | L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato il messaggio e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) | Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono previsti due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, vai a Utenti BroadWorks. |
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
Installare AP.as.22.0.1123.ap376508.
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
Installare AP.as.23.0.1075.ap376509
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
Installazione di AP.as.24.0.944.ap375100
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
atrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Impostazioni internazionali lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente di amministrazione con provisioning viene assegnata automaticamente come locale predefinita per l'organizzazione del cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti a riunioni all'interno dell'organizzazione del cliente.
Sono supportate le impostazioni internazionali in lingua a cinque caratteri (ISO-639-1)_(ISO-3166). Ad esempio, en_US corrisponde a English_UnitedStates. Se viene richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genera un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso internazionale dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, viene utilizzata l'impostazione locale ragionevole predefinita in base al codice della lingua richiesto.
Nella tabella riportata di seguito vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice lingua a due lettere in un'impostazione locale a cinque caratteri per le situazioni in cui un'impostazione locale a cinque caratteri non è disponibile.
Impostazioni internazionali lingua supportate (ISO-639-1)_(ISO-3166) | Se è disponibile solo un codice lingua a due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** | Usa impostazioni internazionali sensibili di default (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA | en en | en_USA |
fr_Fr fr_CA | Fr | fr_Fr |
cs_CZ | cs | cs_CZ |
da_DK | da | da_DK |
de_DE | DE | de_DE |
hu_HU | hu | hu_HU |
id_ID | ID | id_ID |
it_IT | IT | it_IT |
ja_JP | ja | ja_JP |
ko_KR | ko | ko_KR |
es_ES es_CO es_MX | ES | es_ES |
nl_NL | NL | nl_NL |
nb_NO | nb. | nb_NO |
pl_PL. | pl. | pl_PL. |
pt_PT pt_BR | pt | pt_PT |
ru_RU | RU | ru_RU |
ro_RO | ro | ro_RO |
zh_CN zh_TW | zh | zh_CN |
sv_SE | sv | sv_SE |
ar_SA | ar | ar_SA |
tr_TR | tr | tr_TR |
Le impostazioni internazionali es_CO, id_ID, nb_NO e pt_PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti Webex Meetings saranno solo in inglese. Inglese è la impostazioni internazionali predefinite per i siti se per il sito non sono richieste impostazioni internazionali non valide/non supportate. Questo campo lingua è applicabile durante la creazione di un'organizzazione e un sito Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, la lingua del modello verrà utilizzata come lingua predefinita. |
Branding
Gli amministratori partner possono utilizzare le personalizzazioni avanzate del branding per personalizzare l'aspetto dell'app Webex per le organizzazioni di clienti gestite dal partner. Gli amministratori partner possono personalizzare le seguenti impostazioni per garantire che l'app Webex rifletta il marchio e l'identità della società:
Loghi aziendali
Combinazioni di colori univoche per la modalità Chiaro o Scuro
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione delle personalizzazioni di branding avanzate.
|
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding come richiesto, ma quando si esegue l'onboarding di un cliente è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Alcuni parametri del modello principale sono elencati di seguito.
Pacchetto
È necessario selezionare un pacchetto predefinito quando si crea un modello (vedere Pacchetti nella sezione Panoramica per dettagli). Tutti gli utenti predisposti con tale modello, tramite flowthrough o self-provisioning, ricevono il pacchetto predefinito.
È possibile controllare la selezione dei pacchetti per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno di essi. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori di provisioning per azienda, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
È possibile modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedere Webex per la documentazione API Cisco BroadWorks o attraverso Partner Hub (vedere Modifica pacchetto utente in Partner Hub).
Non puoi modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è attivata o disattivata; se all'abbonato viene assegnato questo servizio in BroadWorks, il modello Partner Hub associato all'URL di provisioning aziendale di tale abbonato definisce il pacchetto.
Rivenditore e aziende o fornitore di servizi e gruppi?
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se sei un rivenditore con Enterprise, devi abilitare la modalità Enterprise quando crei un modello.
Se il sistema BroadWorks è configurato in modalità provider di servizi, è possibile lasciare disattivata la modalità Enterprise nei modelli.
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch BroadWorks richieste per il provisioning flow-through. Per ulteriori dettagli, vedere Patch richieste con provisioning flow-through. |
Modalità di autenticazione
Decidi come desideri che gli abbonati eseguano l'autenticazione quando accedono a Webex. È possibile assegnare la modalità utilizzando l'impostazione Modalità di autenticazione nel modello di onboarding. Nella tabella seguente sono riportate alcune opzioni.
Questa impostazione non ha effetto sull'accesso al portale di attivazione utente. Gli utenti che accedono al portale devono immettere l'ID utente e la password BroadWorks, come configurati su BroadWorks, indipendentemente da come si configura la modalità di autenticazione nel modello di onboarding. |
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | ID utente BroadWorks | Indirizzo e-mail |
Provider identità | BroadWorks.
| Identità comune Cisco |
Autenticazione a più fattori? | No | Richiede IdP del cliente che supporta l'autenticazione a più fattori. |
Percorso di convalida delle credenziali
|
|
|
Per una ripartizione più dettagliata del flusso di accesso SSO con autenticazione diretta a BroadWorks, vedere Flusso di accesso SSO. |
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che si può verificare con password che utilizzano caratteri speciali per cui il browser Web non codifica correttamente i caratteri. Utilizzando un'intestazione con codifica UTF-8, con codifica base 64, risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
Paese
Quando si crea un modello, è necessario selezionare un paese. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie S. | Posizione | Prefisso internazionale | Nome paese |
---|---|---|---|
1 | AMER | +1 | NOI, CA |
2 | APAC | +65 | Singapore |
3 | ANZ | +61 | Australia |
4 | EMEA | +44 | Regno Unito |
5 | EURO | +49 | Germania |
Accordi con più partner
Vuoi concedere in sublicenza Webex per Cisco BroadWorks a un altro provider di servizi? In questo caso, ciascun provider di servizi avrà bisogno di un'organizzazione partner distinta in Webex Control Hub per consentire loro di fornire la soluzione per la propria base clienti.
Adattatore di provisioning e modelli
Quando si utilizza il provisioning flowthrough, l'URL di provisioning inserito in BroadWorks viene derivato dal modello in Control Hub. È possibile disporre di più modelli e quindi di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati al momento della concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e quale modello si desidera utilizzare a tale scopo. In questo modo, è necessario impostare esplicitamente l'URL di provisioning per le aziende che necessitano di un modello diverso.
Inoltre, tenere presente che è possibile che si stia già utilizzando un URL di provisioning a livello di sistema, ad esempio con UC-One SaaS. In tal caso, è possibile scegliere di mantenere l'URL a livello di sistema per il provisioning degli utenti su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono dettagliate in Configura server applicazioni con URL servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning flowthrough tra AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server AS e Webex, annullando in tal modo la necessità di connettersi direttamente al servizio Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati che si sta eseguendo il provisioning per Webex devono esistere nel sistema BroadWorks integrato con Webex. È possibile integrare più sistemi BroadWorks, se necessario.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero o interno principale.
Webex utilizza gli indirizzi e-mail come identificatori principali per tutti gli utenti. Se si utilizza il provisioning flowthrough con e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail degli abbonati nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo di utenti di chiamata BroadWorks con un numero principale e/o interno. Se si utilizza il provisioning flowthrough, agli utenti deve essere assegnato anche il servizio IM&P integrato. |
Server nella rete e requisiti software
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Le istanze BroadWorks devono includere almeno i seguenti server:
Server applicazioni (AS) con versione BroadWorks come sopra
Server di rete (NS)
Server profilo (PS)
Server XSP|ADP o piattaforma di distribuzione delle applicazioni (ADP) di fronte al pubblico che soddisfano i seguenti requisiti:
Servizio di autenticazione (BWAuth)
Interfacce azioni ed eventi XSI
DMS (applicazione Web di gestione dispositivi)
Interfaccia CTI (Intergrazione Di Telefonia Informatica)
TLS 1.2 con certificato valido (non autofirmato) e qualsiasi intermediazione richiesta. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
Autenticazione Mutual TLS (mTLS) per il servizio di autenticazione (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Autenticazione Mutual TLS (mTLS) per l'interfaccia CTI (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
Un server XSP/ADP separato che agisce come "Call Notifications Push Server" (un NPS nel tuo ambiente utilizzato per le notifiche di chiamata push per Apple/Google. Lo chiamiamo "CNPS" qui per distinguerlo dal servizio in Webex che fornisce notifiche push per messaggi e presenza).
Questo server deve essere su R22 o versione successiva.
Viene richiesto un server XSP/ADP separato per CNPS poiché l'imprevedibilità del carico da Webex per le connessioni cloud BWKS potrebbe influire negativamente sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSPADP, consultare la Guida tecnica di sistema Cisco BroadWorks|.
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, andare a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
PC/laptop Windows
PC/laptop Apple con MacOS
iOS (Apple Store)
Android (Play store)
Browser Web (vai a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (tradizionale cinese)
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (italiano)
Telefoni e accessori fisici
Telefoni IP Cisco:
telefono IP Cisco serie 6800 con firmware multipiattaforma
telefono IP Cisco serie 7800 con firmware multipiattaforma
telefono IP Cisco serie 8800 con firmware multipiattaforma
Vedere https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html per i modelli e ulteriori informazioni.
I telefoni di terze parti sono supportati allo stesso modo di altre integrazioni BroadWorks. Tuttavia, non dispongono ancora dell'integrazione di contatti e presenza con Webex per Cisco BroadWorks.
Adattatori:
Adattatore per telefono analogico multipiattaforma Cisco ATA 191
Adattatore per telefono analogico multipiattaforma Cisco ATA 192
Vedere https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html per i modelli e ulteriori informazioni.
Cuffie:
cuffia Cisco serie 500
Vedi https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html per i modelli e ulteriori informazioni.
Dispositivi Room OS:
Serie Webex Room e Room Kit
Serie Webex Desk
Serie Webex Board
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e l'assistenza dei dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivo
Di seguito sono riportati i file DTAF che devi caricare sui server delle applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia c'è una nuova config-wxt.xml.template
file utilizzato per l'app Webex.
Per scaricare i profili dei dispositivi più recenti, andare al sito di Download software della piattaforma di consegna delle applicazioni per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che per XSP.
Nome del cliente | Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Comunicatore aziendale - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili del dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Genera una richiesta di servizio con l'agente di onboarding o con Cisco TAC per eseguire il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il titolo della richiesta per le rispettive funzioni:
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
'NPS Configuration for Auth Proxy Setup' (Configurazione NPS per impostazione proxy automatica) per configurare NPS per l'uso del proxy di autenticazione.
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori informazioni su questa funzione, vedere: Supporto di Cisco BroadWorks per CI UUID.
Configura BroadWorks per abilitare la fatturazione Cisco per BroadWorks e Webex Per abbonamenti BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento valido per 60 giorni. Se il token scade prima di utilizzarlo, è possibile presentare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali. |
Certificati ordine
Requisiti di certificato per l'autenticazione TLS
Per tutte le applicazioni richieste, saranno necessari i certificati di sicurezza, firmati da un'autorità di certificazione ben nota e distribuiti su ADP XSP|pubblico. Verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in entrata ai server XSP|ADP.
Questi certificati devono includere il nome di dominio pubblico XSP|ADP completo come Nome comune oggetto o Nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati del server dipendono da come vengono distribuiti gli ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume dove il certificato del server pubblico firmato da CA deve essere caricato in questi tre casi:
Le autorità di certificazione supportate pubblicamente dall'app Webex per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per proxy bridge TLS
Il certificato del server firmato pubblicamente viene caricato nel proxy.
Il proxy presenta questo certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Un certificato firmato CA interno può essere caricato su XSP|ADP.
L'|ADP XSP presenta questo certificato del server firmato internamente al proxy.
Il proxy si basa sulla CA interna che ha firmato il certificato del server XSP|ADP.
Requisiti di certificato TLS per proxy passthrough TLS o XSP|ADP in DMZ
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
Gli ADP XSP|presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca sull'interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione Mutual TLS. Il certificato CA/catena del certificato del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedi a Partner Hub, vai a
e fai clic sul collegamento del certificato di download.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il seguente diagramma riassume i requisiti del certificato in questi tre casi:
Requisiti del certificato (opzione) per proxy bridge TLS
Webex presenta un certificato client firmato pubblicamente al proxy.
Il proxy considera attendibile la CA interna di Cisco che ha firmato il certificato del client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta il certificato del server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions: X509v3 Extended Key Usage: 1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Il CN del certificato interno deve essere
bwcticlient.webex.com
.
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le autorità pubbliche di certificazione potrebbero non essere disposte a firmare i certificati con l'OIDE proprietario di BroadWorks richiesto. In caso di proxy di bridging, è possibile che sia necessario utilizzare una CA interna per firmare il certificato del client che il proxy presenta all'ADP XSP|.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Il ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XSP| dal proxy.
Requisiti di certificato (opzione) per proxy passthrough TLS o XSP|ADP in DMZ
Webex presenta un certificato client firmato da CA Cisco interno alle ADP XSP|.
Gli ADP XSP|si fidano delle autorità di certificazione interne di Cisco che hanno firmato il certificato client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XSP|.
Gli ADP XSP|presentano i certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Il server applicazioni ClientIdentity contiene il CN del certificato del client firmato Cisco presentato a XSP|ADP da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene l'elenco di indirizzi IP, porte e protocolli richiesti per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle dei firewall delle regole di ingresso e uscita precedenti documentano solo le connessioni specifiche di Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico per Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e la rilevanza di ciascuna sezione per Webex per Cisco BroadWorks.
Sezione Requisiti di Rete Art. | Rilevanza delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex | Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud | Informativo |
Da leggere | |
Da leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex | Da leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione | Opzionale |
Servizi Webex per clienti FedRAMP | N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedi il whitepaper del firewall dell'app Webex (PDF).
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza XSP|ADP di Broadworks fornita dal partner. Quando un ADP o un sito XSP|non è disponibile per manutenzione pianificata o motivo non pianificato, i servizi e le app Webex possono passare a un altro ADP o sito XSP|fornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP Broadworks XSP|possono essere distribuiti direttamente su Internet o possono risiedere in un DMZ frontale da un elemento di bilanciamento del carico come F5 BIG-IP. Per fornire ridondanza geografica, gli ADP XSP|possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un bilanciatore di carico, ognuno con un indirizzo IP pubblico. Se gli ADP XSP| sono dietro a un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e Broadworks sembra avere solo un XSP|ADP, anche se vi sono più ADP XSP| dietro.
Nell'esempio seguente, le ADP|XSP vengono distribuite in due siti, il Sito A e il Sito B. Esistono due ADP|XSP frontali di un bilanciatore di carico in ogni sito. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali di LB1 e il sito B ha XSP|ADP3 e XSP|ADP4 frontali di LB2. Solo i bilanciatori di carico sono esposti sulla rete pubblica e le ADP|XSP sono nelle reti private DMZ.
Servizi cloud Webex
Configurazione DNS
I microservizi cloud Webex devono essere in grado di trovare il server|ADP Broadworks XSP per la connessione alle interfacce Xsi, al servizio di autenticazione e al CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host XSP|ADP configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso. Se vengono restituiti più indirizzi IP, viene selezionato il primo IP nell'elenco. La ricerca SRV non è attualmente supportata.
Esempio: Il DNS A Record del partner per la scoperta del server XSP|ADP/Load Balancers bilanciato Round-Robin.
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
A |
|
| Punti a LB1 (Sito A) |
A |
|
| Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Failover
Quando i microservizi Webex inviano una richiesta al servizio |di bilanciamento del carico/ADP XSP e la richiesta non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
Se non viene ricevuta alcuna risposta HTTP entro 2 secondi, la richiesta viene timeout e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento dell'indirizzamento all'IP successivo.
Ciascuna richiesta viene provata 3 volte prima di segnalare un errore al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco degli indirizzi da provare quando si invia una richiesta a un XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna nell'elenco per provare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco bloccato. Se l'operazione va a buon fine, tale indirizzo IP viene rimosso dall'elenco bloccato.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP|XSP o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster BroadWorks Calling, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
Azioni XSI
Eventi XSI
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Gli stati delle connessioni possono essere:
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
Rosso: Quando tutti gli IP nella ricerca di record sono irraggiungibili e l'interfaccia non è disponibile.
I seguenti servizi utilizzano i microservizi per connettersi agli XSP|ADP e sono interessati dalla disponibilità dell'interfaccia XSP|ADP:
Accesso all'app Webex
Aggiornamento token app Webex
E-mail/autoattivazione non attendibile
Controllo stato servizio Broadworks
App Webex
Configurazione DNS
L'app Webex accede ai servizi Xtended Services Interface (XSI-Actions & XSI-Events) e Device Management Service (DMS) su XSP|ADP.
Per trovare il servizio XSI, l'app Webex esegue la ricerca DNS SRV per _xsi-client._tcp.<webex app xsi domain>
. L'SRV punta all'URL configurato per gli host XSP|ADP o i bilanciatori di carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex torna alla ricerca A/AAAA.
L'SRV può risolversi in più target A/AAAA. Tuttavia, ogni record A/AAAA deve mappare solo a un singolo indirizzo IP. Se sono presenti più ADP|XSP in un DMZ dietro il dispositivo di bilanciamento del carico/bordo, è necessario che il bilanciatore di carico sia configurato per mantenere la persistenza della sessione in modo da indirizzare tutte le richieste della stessa sessione allo stesso XSP|ADP. Questa configurazione viene avviata perché i heartbeat dell'evento XSI del client devono andare allo stesso XSP|ADP utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non deve esistere. Se il DNS richiede che un record A/AAAA deve essere definito, allora deve essere restituito solo 1 indirizzo IP. Indipendentemente da ciò, l'SRV deve essere ancora definito per l'app Webex. Se l'app Webex utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client alla fine invia heartbeat a un XSP|ADP dove non ha stabilito un canale per eventi. Di conseguenza, il canale viene strappato e il traffico interno è notevolmente più intenso, il che pregiudica le prestazioni del cluster ADP|XSP. Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca di record A/AAAA, è necessario utilizzare un nome di dominio completo separato per Webex Cloud e l'app Webex per accedere agli ADP|XSP. Come mostrato negli esempi, Webex Cloud utilizza Un record |
Esempio 1: ADP|XSP multipli, ciascuno dietro bilanciatori di carico separati
In questo esempio, SRV punta a disattivare l'audio dei record A con ogni record A che punta a un bilanciatore di carico diverso su un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito un esempio di record SRV.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
SRV |
|
| Rilevamento client dell'interfaccia Xsi |
A |
|
| Indica LB1 (sito A) |
A |
|
| Punti a LB2 (sito B) |
Esempio 2: più amministratori XSP| dietro un singolo bilanciatore di carico (con bridge TLS)
Per la richiesta iniziale, il bilanciatore di carico seleziona un XSP|ADP casuale. XSP|ADP restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il bilanciatore di carico utilizza il cookie per indirizzare la connessione all'ADP XSP|corretto, assicurandosi che il canale dell'evento non si interrompa.
Tipo di record | Registra | Destinazione | Scopo |
---|---|---|---|
SRV |
|
| Bilanciatore di carico |
A | LB.esempio.com |
| Indirizzo IP del bilanciatore di carico (XSP|ADP sono dietro al bilanciatore di carico) |
URL DMS
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il file di configurazione. Viene eseguita l'analisi dell'organizzatore nell'URL e l'app Webex esegue la ricerca DNS A/AAAA dell'organizzatore per connettersi all'ADP XSP|che ospita il servizio DMS.
Esempio: DNS Un record per la scoperta di Round-Robin bilanciato server XSP|ADP/Bilanciamento del carico di Webex App per scaricare i file di configurazione tramite DMS:
Tipo di record | Nome | Destinazione | Scopo |
---|---|---|---|
A |
|
| Indica LB1 (sito A) |
A |
|
| Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Come l'app Webex trova gli indirizzi XSP|ADP
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (sono stati inseriti quando si crea il cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue la ricerca SRV nel modo seguente:
Il cliente esegue una ricerca SRV per _xsi-cliente._tcp.<xsi domain="">
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
Il cliente cerca gli obiettivi A/AAAA e memorizza nella cache gli indirizzi IP restituiti.
Il client si connette a uno dei target (e quindi al suo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi al peso (o a caso se sono tutti uguali).
Se la ricerca SRV non restituisce alcun obiettivo:
Il client esegue una ricerca A/AAAA del parametro principale Xsi e quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso.
Come indicato, il record A/AAAA deve risolversi in un indirizzo IP per le stesse ragioni.
(Opzionale) Successivamente, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocols> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
Se esistono, il client confronterà l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
Se viene rilevata una differenza, il client re-inizializzerà la connettività XSI Actions/XSI Events. La prima fase consiste nell'eseguire lo stesso processo di ricerca DNS elencato nella fase 1, richiedendo questa volta una ricerca del valore nel %XSI_ROOT_WXT% parametro dal file di configurazione.
Assicurarsi di creare i record SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
Failover
Durante l'accesso, l'app Webex esegue una ricerca DNS SRV per _xsi-client._tcp.<xsi domain="">, crea un elenco di organizzatori e si connette a uno degli organizzatori in base alla priorità SRV, quindi al peso. Questo organizzatore connesso diventa quello selezionato per tutte le richieste future. Viene quindi aperto un canale evento all'organizzatore selezionato e viene inviato regolarmente un heartbeat per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP, pertanto è importante che il bilanciatore di carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server XSP|ADP di backend.
Se una richiesta o una richiesta heartbeat a un organizzatore non riesce, possono verificarsi diverse cose:
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), l'indirizzamento dell'app Webex viene eseguito immediatamente all'organizzatore successivo nell'elenco.
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e l'indirizzamento passa all'organizzatore successivo nell'elenco.
Se una risposta non viene ricevuta entro un periodo di tempo, la richiesta viene considerata non riuscita a causa del timeout e le richieste successive vengono inviate al successivo organizzatore. Tuttavia, la richiesta scaduta viene considerata come non riuscita. Alcune richieste vengono riprovate dopo l'errore (con un tempo di riprova crescente). Le richieste che il presunto non vitale non sono riprovate.
Quando un nuovo organizzatore viene provato correttamente, diventa il nuovo organizzatore selezionato se l'organizzatore è presente nell'elenco. Una volta provato l'ultimo organizzatore nell'elenco, l'app Webex passa al primo.
In caso di heartbeat, se si verificano due errori di richiesta consecutivi, l'app Webex re-inizializzerà il canale eventi.
Tenere presente che l'app Webex non esegue il failback e che il rilevamento del servizio DNS viene eseguito solo una volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione attraverso l'interfaccia XSP|ADP/Dms. Esegue una ricerca di record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Innanzitutto, tenterà di inviare la richiesta per scaricare il file di configurazione utilizzando un token SSO. Se ciò non riesce per qualsiasi motivo, verrà riprovato ma con il nome utente e la password del dispositivo.
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning dell'utente. Molte delle attività sono comuni a tutte le modalità di provisioning.
Onboarding dei partner per Webex per Cisco BroadWorks
Ciascun provider o rivenditore di servizi Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, è necessario eseguire la documentazione Cisco BroadWorks di Webex e i nuovi partner devono accettare l'ICPA (Indirect Channel Partner Agreement) online. Al termine di queste operazioni, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, il tuo Partner Activation e/o Customer Success Program Manager ti contatterà per iniziare il tuo onboarding.
I partner Webex in una regione possono creare organizzazioni di clienti in qualsiasi regione in cui offriamo i servizi. Per informazioni, vedere: Residenza dati in Webex. |
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
È necessario eseguire l'applicazione NPS su un altro XSP|ADP. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi sugli ADP XSP|.
Servizio/Applicazione | Autenticazione richiesta | Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
autenticazione protetta |
Integrazione telefonia computer |
mTLS (client e server si autenticano a vicenda) |
Presenza di telefonia |
Applicazione Webview Impostazioni chiamata |
TLS (il server esegue l'autenticazione per i client) |
Mostra le impostazioni di chiamata utente nel portale Assistenza utente all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma occorre fare riferimento alla documentazione esistente per installare le applicazioni sugli ADP|XSP.
Requisiti di coresidenza
Il servizio di autenticazione deve essere coresidente con le applicazioni Xsi, perché tali interfacce devono accettare token di lunga durata per l'autorizzazione del servizio. Il servizio di autenticazione è richiesto per convalidare tali token.
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
È possibile separare gli altri servizi/applicazioni come richiesto per la propria bilancia (gestione dispositivi dedicata XSP|ADP farm, ad esempio).
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
Non installare altre applicazioni o servizi sugli ADP XSP| utilizzati per integrare BroadWorks con Webex.
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se è in esecuzione R22 o versione superiore e il sistema lo supporta.
Mutual TLS (mTLS) è supportato anche come metodo di autenticazione alternativo per il servizio Auth. Se più organizzazioni Webex eseguono lo stesso server ADP XSP|, è necessario utilizzare l'autenticazione mTLS poiché la convalida token CI non supporta più connessioni allo stesso servizio autenticazione ADP XSP|. Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida del token CI, fare riferimento all'Appendice per configurare i servizi (con mTLS per il servizio di autenticazione). |
Se attualmente si utilizza mTLS per il servizio autenticazione, non è obbligatorio riconfigurare l'uso della convalida token CI con TLS. |
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks.
Installare le seguenti patch su ciascun server ADP XSP|. Installare le patch appropriate alla release in uso:
Per R22:
Per R23:
Per R24: non è necessario alcun cerotto
Qualsiasi riferimento a XSP include XSP o ADP.Installare il
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP al percorso del contesto /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire il servizio di autenticazione su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
A partire da Broadworks build 2022.10, le autorità di certificazione in arrivo con Java non vengono più automaticamente incluse nel trust store BroadWorks quando si passa a una nuova versione di java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
Radice commerciale IdenTrust CA 1
autorità di certificazione radice Go Daddy - G2
Verificare che questi certificati siano presenti sotto la seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get
Se non presente, eseguire il seguente comando per importare i trust Java predefiniti:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come ancoraggi attendibili con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono automaticamente importate nella nuova release e continueranno a essere importate finché non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere la FD di convalida del certificato Cisco Broadworks X509.
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server ADP XSP|:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get
set clientId client-Id-From-Step1
set enabled true
set clientSecret client-Secret-From-Step1
set ciResponseBodyMaxSizeInBytes 65536
set issuerName <URL>
- Per ilURL
, immettere l'URL IssuerName che si applica al cluster CI. Vedere la tabella seguente.set issuerUrl <URL>
- Per ilURL
, immettere l'IssuerUrl che si applica al cluster CI. Vedere la tabella seguente.set tokenInfoUrl <IdPProxy URL>
—Inserire l'URL proxy IdP applicabile al cluster dei team. Si veda la seconda tabella che segue.
Tabella 1. Imposta nome emittente e URL emittente Se il cluster CI è... Imposta issuerName e issuerURL su... NOI-A
UE
NOI-B
Se non conosci il tuo cluster CI, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.Tabella 2. Imposta tokenInfoURL Se il cluster di Teams è... Imposta tokenInfoURL su...(URL proxy IdP) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AFRA
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
DOLORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.
Per il test, è possibile verificare che il tokenInfoURL sia valido sostituendo "
idp/authenticate
" parte dell'URL con "ping
".
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user
Configurare i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get
set flsUrl https://cifls.webex.com/federation
set refreshPeriodInMinutes 60
set refreshToken refresh-Token-From-Step1
Eseguire il seguente comando per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get
Configurare la gestione dei token utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
set tokenIssuer BroadWorks
set tokenDurationInHours 720
Genera e condividi chiavi RSA. È necessario generare chiavi su un XSP|ADP, quindi copiarle su tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP.Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web. Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token. Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Rimozione dei requisiti di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con la convalida del token CI su R24, è necessario rimuovere anche il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Interfaccia CTI e configurazione correlata
Di seguito viene elencato l'ordine di configurazione "da più a più". In seguito a questo ordine non è obbligatorio.
Configurazione del server di applicazione per gli abbonamenti CTI
Configurazione di XSP|ADPs per abbonamenti CTI autenticati mTLS
Apertura delle porte in entrata per l'interfaccia CTI protetta
Abbonamento dell'organizzazione Webex agli eventi CTI di BroadWorks
Configurazione del server di applicazione per gli abbonamenti CTI
Aggiornare ClientIdentity su Application Server con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ciascun server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è |
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) | XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocol> |
Una specifica interfaccia CTI su questo sistema (R22 e versioni successive) | XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocol> |
Su una nuova installazione, le seguenti crittografie sono installate per impostazione predefinita a livello di sistema. Se non è configurato nulla a livello di interfaccia (ad esempio, nell'interfaccia CTI o HTTP), si applica questo elenco di crittografia. Si noti che questo elenco può cambiare nel tempo:
|
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp>
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
Inserisci il
get
comando per visualizzare le crittografie già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, si utilizzerebbe:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Ancoraggi affidabili per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che le ADP XSP|siano rivolte verso Internet o rivolte verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy bridge (vedere Requisiti del certificato TLS per proxy bridge TLS).
Per ogni amministratore XSP|nell'infrastruttura che pubblica eventi CTI in Webex, effettuare le seguenti operazioni:
Accedere a Hub partner .
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.
Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
(Opzionale) Esecuzione
help updateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot2023
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
Consenti ai client di autenticarsi con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione BroadWorks in uso. Il comando crea un certificato server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. È necessario l'indirizzo IP dell'interfaccia CTI per questo; è possibile leggerlo dal seguente contesto:
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>
Riavviare XSP|ADP.
Abilitazione dell'accesso a BroadWorks CTI Events su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
Specificare l'indirizzo CTI in base al quale Webex può iscriversi a CTI Events di BroadWorks.
Gli abbonamenti CTI sono su base per abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato viene predisposto per Webex per Cisco BroadWorks.
Visualizzazione Webview Impostazioni chiamata
Call Settings Webview (CSWV) è un'applicazione ospitata su XSP|ADP per consentire agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview per le impostazioni di chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono native dell'app Webex.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, è necessario distribuire la funzione Webview impostazioni chiamata.
La vista Webview impostazioni chiamata presenta due componenti:
Applicazione Webview Impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
App Webex, che esegue il rendering delle impostazioni di chiamata in una vista Webview.
Esperienza utente
Utenti Windows: Fai clic su Impostazioni chiamata, quindi su .
Utenti Mac: Fare clic sull'immagine del profilo, quindi
.
Distribuzione di CSWV su BroadWorks
Installazione di Webview impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso ADP|XSP che ospita l'interfaccia Xsi-Actions nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
Accedere a cisco.com e cercare "BWCallSettingsWeb" nella sezione download software.
Trovare e scaricare la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) è stata la più recente al momento della stesura del presente documento.Installare, attivare e distribuire l'archivio Web in base alla Guida alla configurazione della piattaforma di servizi Xtended di Cisco BroadWorks per la versione XSP|ADP. (Versione R24 https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
.Passare al seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più necessario).Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario fornire anche un contextPath perché è un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio
/callsettings
.Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
Ora è possibile prevedere l'URL delle impostazioni di chiamata che si specificherà per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
L'|ADP-FQDN XSP deve corrispondere al FQDN azioni Xsi, perché CSWV deve utilizzare le azioni Xsi e CORS non è supportato.
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview Impostazioni chiamata è ora attiva sugli ADP|XSP.
Configura l'app Webex per utilizzare Webview impostazioni chiamata
Per ulteriori dettagli sulla configurazione del client, vedere la Guida alla configurazione di Webex per Cisco BroadWorks.
Nel file di configurazione dell'app Webex è presente un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti attraverso l'interfaccia dell'applicazione.
<config>
<services>
<web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%">
<url>%WEB_CALL_SETTINGS_URL_WXT%</url>
</web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel %WEB_CALL_SETTINGS_URL_WXT% tag.
Se non si specifica esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
Imposta la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
Il file di configurazione client risultante dovrebbe avere una voce come segue:
<web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push delle chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Call Notifications Push Server (CNPS) per descrivere un'applicazione ospitata XSP o ospitata ADP che viene eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti e invia le notifiche a Google Firebase Cloud Messaging (FCM) o Apple Push Notification Service (APN).
Tali servizi notificano ai dispositivi mobili degli abbonati Webex per Cisco BroadWorks la presenza di chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzione Notification Push Server.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi a loro volta notificano agli utenti mobili Webex le modifiche ai messaggi in arrivo o alla presenza.
In questa sezione viene descritto come configurare l'NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se è necessario eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPShttps://help.webex.com/nl5rir2/. |
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario aggiornare il CNPS per supportare la funzione proxy NPS, server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server di notifica push per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e i tasti di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend di Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APN Apple e i servizi FCM Google.
La funzione migliora anche la capacità del server push delle notifiche di eseguire notifiche push ai dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
Per ulteriori informazioni, vedere Server push per VoIP nella descrizione della funzione UCaaS.
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software e le patch NPS, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Cercare e scaricare la patch dalla pagina di download del software.
Ulteriori informazioni sul server ADP sono disponibili su https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio Apple Push Notification dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per APN. Questo aggiornamento richiede che XSP|ADP che ospita l'NPS esegua R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 | Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma di consegna dell'applicazione (ADP). | ||
2 | Installare le patch proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: | ||
3 | Attivare l'applicazione Notification Push Server. | ||
4 | (Per le notifiche Android) Abilitare l'API FCM v1 sull'NPS.
| ||
5 | (Per le notifiche Apple iOS) Abilitare HTTP/2 su NPS.
| ||
6 | Collegare un supporto tecnico dell'NPS XSP/ADP. | ||
7 | Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN UN 10.193.78.149
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configura NPS per utilizzare il proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Migra NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un server NPS condiviso con altre app mobili, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPS ( https://help.webex.com/nl5rir2).
1 | Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 | Creare l'account cliente su NPS:
Per verificare che i valori inseriti corrispondano a quanto ricevuto, eseguire
| |||||||||||||||||||
3 | Immettere l'URL proxy NPS e impostare l'intervallo di aggiornamento del token (consigliato 30 minuti):
| |||||||||||||||||||
4 | (Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 | (Per le notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, assicurandosi di omettere il tasto Auth – impostarlo su vuoto.
| |||||||||||||||||||
6 | Configurare i seguenti URL NPS:
| |||||||||||||||||||
7 | Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 | Verificare se il server applicazioni sta eseguendo lo screening degli ID applicazione, poiché potrebbe essere necessario aggiungere le app Webex all'elenco utenti autorizzati: | |||||||||||||||||||
9 | Riavviare XSP|ADP: | |||||||||||||||||||
10 | Esegui test delle notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migrazione di NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente che è necessario eseguire la migrazione a FCMv1. Sono previste tre procedure:
Esegui migrazione dei client UC-One a FCMv1: quando disponi di client UCaaS esistenti e devi migrarli per utilizzare FCMv1.
Migrazione dei client SaaS a FCMv1: quando si dispone di client SaaS esistenti e occorre migrarli per utilizzare FCMv1.
Aggiorna server ADP: quando si esegue la migrazione di NPS a un server ADP.
Migrazione dei client UC-One a FCMv1
Utilizzare la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere . L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile Connect su https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al
|
Accedere a SDK amministratore FCM su http://console.firebase.google.com.
Selezionare l'applicazione Android appropriata.
Nella scheda General (Generale), registrare l’ID del progetto
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
Fare clic sul pulsante blu per creare un nuovo account di servizio
Fai clic sul pulsante blu per generare una nuova chiave privata
Chiave di download per una posizione sicura
Per riutilizzare un account servizio esistente:
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
Identificare l'account servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
Copiare il file json su XSP|ADP.
Configurare l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== my_project ********
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Migrazione dei clienti SaaS a FCMv1
Se si desidera eseguire la migrazione dei client SaaS a FCMv1, attenersi alla procedura seguente su Google FCM Console.
Assicurarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione". |
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
Esegui il file di installazione
bwrestart
comando per riavviare XSP|ADP.
Aggiorna server ADP
Se si esegue la migrazione dell'NPS per utilizzare un server ADP, utilizzare i passaggi seguenti nella console Google FCM.
Ottenere il file JSON dalla console cloud di Google:
Su Google Cloud Console, andare alla pagina Account servizio.
Fare clic su Seleziona un progetto, scegliere il progetto e fare clic su Apri.
Trova la riga dell'account servizio per la quale desideri creare una chiave, fai clic sul pulsante Altro verticale, quindi fai clic su Crea chiave.
Selezionare un tipo di chiave e fare clic su Crea
Il file viene scaricato.
Aggiungere FCM al server ADP:
Importare il file JSON nel server ADP utilizzando il
/bw/install
comando.Accedere all'ADP CLI e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON
:Quindi, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò avviene per i seguenti motivi:
Per consentire a Webex cloud di autenticare i tuoi utenti rispetto a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
Per consentire alle app Webex di utilizzare l'interfaccia Xsi per il controllo delle chiamate.
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se alcune interfacce non vengono convalidate correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide. Ciò viene impedito poiché un cluster configurato in modo errato potrebbe causare problemi che sono difficili da risolvere. |
Cosa è necessario fare:
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Se l'utente amministratore non ha visibilità delle impostazioni di BroadWorks Calling , si consiglia di aprire un caso con Cisco TAC.
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
Assegna un nome al cluster e fai clic su Avanti.
Il concetto di cluster qui è semplicemente una raccolta di interfacce, solitamente situate su un server ADP XSP| o in un'azienda agricola, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il sistema BroadWorks non sono applicabili qui.
(Opzionale) Immettere un Nome account utente e una Password BroadWorks noti all'interno del sistema BroadWorks che si connette a Webex, quindi fare clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
Aggiungere gli URL XSI Actions e XSI Events.
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
Opzionale. Selezionare la casella di controllo Abilita autenticazione diretta BroadWorks se si desidera che gli accessi a BroadWorks siano diretti a BroadWorks. In caso contrario, l'autenticazione per BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo influisce su queste situazioni di accesso:
Accesso al portale di attivazione utente: gli utenti devono immettere le credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o attraverso il proxy IdP.
Accesso client: se l'autenticazione BroadWorks è configurata nel modello di onboarding, l'impostazione precedente determina se l'accesso del client all'app Webex è diretto a BroadWorks o viene proxy attraverso il proxy IdP.
Fai clic su Avanti.
Nella pagina CTI Interface (Interfaccia CTI) procedere come segue:
Aggiungere l'URL CTI e la porta per l'interfaccia CTI a cui si desidera connettersi.
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
Opzionale. Abilita il tasto di alternanza Non disturbare (NoDist) e inserisci l'ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurandosi che la funzione funzioni allo stesso modo su entrambe le piattaforme.
Fai clic su Avanti.
Aggiungere l'URL del servizio di autenticazione.
Selezionare Servizio autenticazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex poiché il servizio di autenticazione convalida correttamente il token utente rispetto al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
Controllare le voci sulla schermata finale, quindi fare clic su Crea. Dovrebbe essere visualizzato un messaggio di successo.
Partner Hub passa gli URL a vari microservizi Webex che testano le connessioni alle interfacce fornite.
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è riuscita.
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Abbiamo implementato questa verifica per prevenire errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, caricatore di bilanciamento o firewall) come illustrato in questa guida, prima di salvare il modello.
Verifica delle connessioni alle interfacce BroadWorks
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Fare clic su Visualizza cluster.
Partner Hub avvia i test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina dell'elenco dei cluster mostra il messaggio di stato accanto a ciascun cluster.
I messaggi verdi relativi al successo dovrebbero essere visualizzati. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio XSI-Actions, XSI-Events, DAS URL e le impostazioni dell'interfaccia CTI.
Configurazione dei modelli di onboarding
I modelli di onboarding sono il modo in cui verrà applicata la configurazione condivisa a uno o più clienti man mano che vengono caricati tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma solo un modello può essere associato a un cliente.
Accedere a Partner Hub e selezionare Clienti.
Fare clic sul pulsante Modelli di onboarding per visualizzare i modelli esistenti.
Fare clic su Crea modello.
Nella finestra Dettagli modello, aggiungere il nome del modello, il paese o la regione e la lingua e-mail predefinita.
Fare clic sull'elenco a discesa per l'ID abbonamento CCW, individuare gli abbonamenti elencati per il partner e selezionare l'abbonamento applicabile.
Questo campo viene visualizzato solo per i partner migrati da Webex per BroadWorks a Webex.Nella finestra Impostazione servizio, utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
Immettere un Nome modello, quindi fare clic su Avanti.
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per diverse modalità di provisioning Nome impostazione
Provisioning fluviale con e-mail attendibili
Provisioning flowthrough senza e-mail
Self-provisioning utente
Abilita flusso BroadWorks attraverso il provisioning (include le credenziali dell'account di provisioning se attivato**)
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il †
Il †
Il †
Indirizzo e-mail provider servizi
Selezionare un indirizzo e-mail dall'elenco a discesa (è possibile digitare alcuni caratteri per trovare l'indirizzo, se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello di onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature tra paese e regione in questo foglio di calcolo.
Il paese dell'organizzazione determina i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni consultare la sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questo interruttore spento.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note dalla tabella:
† Questo passaggio garantisce che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa opzione deve essere sempre attiva, a meno che non si utilizzi un processo manuale di ordinazione ed esecuzione (tramite Cisco Commerce Workspace) per creare le organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello di "provisioning ibrido" e non rientra nel campo di applicazione di questo documento.
** "Account di provisioning" si riferisce all'account di amministrazione a livello di sistema BroadWorks. Su BroadWorks, è necessario un account amministratore con questi attributi: Tipo amministratore=Provisioning, sola lettura=Disattivato.
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
Opzionale. Selezionare Disabilita chiamata gratuita Cisco Webex se si desidera disabilitare le chiamate Webex.
Per la configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
Numeri di chiamata in ingresso Cisco (PSTN)
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
Fai clic su Avanti.
Esistono due approcci per il provisioning degli abbonati relativamente a come vengono verificate le relative identità, utilizzando e-mail attendibili o e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile, gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. In qualità di partner, sei responsabile del provisioning dell'indirizzo e-mail come parte del metodo flow-through o API.
Si consiglia vivamente di utilizzare il metodo di provisioning attendibile poiché garantisce che tutti gli abbonati siano completamente predisposti dall'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso e-mail non attendibile, gli utenti devono verificare i relativi messaggi e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome impostazione
Provisioning flowthrough senza e-mail
Self-provisioning utente
Esegui prima provisioning amministratore
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
Note dalla tabella:
* Ciascuna organizzazione cliente in Webex deve disporre di almeno un utente con ruolo di amministratore. Il primo utente a cui assegnare IM&P integrato in BroadWorks assume il ruolo di amministratore del cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di fornitore di servizi è possibile avere il controllo su chi ottiene il ruolo. La verifica di questa impostazione impedisce agli utenti di completare l'attivazione fino a quando non viene attivato il primo utente fornito. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
Fai clic su Avanti.
Selezionare la modalità di autenticazione predefinita (autenticazione BroadWorks o autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.(Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
Fai clic su Avanti.
Per Preferenze, configurare quanto segue:
Scegliere se si desidera Precompilare gli indirizzi e-mail utente nella pagina di accesso.
Utilizzare questa opzione solo dopo aver selezionato Autenticazione BroadWorks e aver anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il nome utente BroadWorks. La pagina di accesso offre l'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
Se desideri abilitare la sincronizzazione delle rubriche, imposta l'opzione Abilita sincronizzazione rubrica telefonica per tutte le nuove organizzazioni clienti per attivare.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
Immettere un amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatico di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
Assicurati che l'opzione Consenti invito e-mail amministratore quando ti colleghi a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
Fai clic su Avanti.
Esaminare le voci nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Dovrebbe essere visualizzato un messaggio di successo.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con altri modelli.
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario immettere nuovamente i dettagli dell'account di provisioning. I campi Password vuota/Conferma password sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori forniti alla procedura guidata.
Aggiungi altri modelli se disponi di diverse configurazioni condivise che desideri fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbe essere necessario specificare i dettagli del modello per una delle attività seguenti.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning. |
Patch Application Server (solo R22, R23 e R24)
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
Per R22:
AP.as.22.0.1123.ap373197
Per R23:
AP.as.23.0.1075.ap373197
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che costituiscono il requisito per la distribuzione di Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.Modifica della
Maintenance/ContainerOptions
contesto.Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true
Scarica gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interfaccia > Messaggistica e Servizio > IM&P integrato) dei comandi AS.
Accedi a Partner Hub e vai a
.Fare clic su Visualizza modelli.
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro flyout a destra. Se non è stato ancora creato un modello, è necessario farlo prima di poter ottenere l'URL di provisioning.
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per altri modelli se si dispone di più modelli.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema su server applicazioni
Se si utilizza UC-One SaaS, potrebbe non essere necessario impostare il provisioning e il dominio del servizio a livello di sistema. Vedere i Punti di decisione nella sezione Preparazione dell’ambiente. |
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password
AS_CLI/Interface/Messaging> set enableSynchronization true
Attivare l'interfaccia IMP integrata:
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
È necessario inserire il nome completo per il |
(Opzione) Configurazione dei parametri di provisioning per azienda su server applicazioni
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
Selezionare Usa dominio di servizio e immettere un valore fittizio (Webex ignora questo parametro). È possibile utilizzare
example.com
).Selezionare Usa server di messaggistica.
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
È necessario inserire il nome completo per il
provisioningURL
parametro, come è stato dato in Partner Hub. Se il server applicazioni non può accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel/etc/hosts
file su AS.Nel campo Nome utente, immettere un nome per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Immettere una password per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
Per Identità utente predefinita per ID IM&P, selezionare Principale.
Fare clic su Applica.
Ripeti per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning utente, vedi Provisioning utente provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning aiuta amministratori e team di vendita controllando la presenza di errori prima di eseguire il provisioning di un cliente o abbonato per un pacchetto. Gli utenti o le integrazioni autorizzati da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per assicurarsi che non vi siano conflitti o errori con il provisioning del pacchetto per un determinato cliente o abbonato.
L'API verifica se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto a un cliente o partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, è possibile correggere gli errori prima del provisioning, aumentando la probabilità di un provisioning riuscito.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore Webex per la vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare di un provisioning abbonato all'ingrosso
Per accedere a Precontrolla un documento di provisioning abbonato Wholesale, devi accedere al portale https://developer.webex.com/. |
Partner SSO - SAML
Consente agli amministratori dei partner di configurare l'SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La seguente procedura SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere la funzionalità SSO del partner a un'organizzazione cliente esistente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso. |
Verificare che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'integrazione Single Sign-On in Control Hub.
Carica il file di metadati CI con provider di identità.
Configurare un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, immettere l'ID entità dall'XML metadati SAML del provider di identità di terze parti.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
Proprio che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori dei partner di configurare l'SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per impostare SSO OIDC partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già caricate utilizzando il modello. |
Aprire una richiesta di servizio con il centro TAC di Cisco con i dettagli dell'IDP di connessione OpenID. Sono obbligatori e facoltativi gli attributi IDP. TAC deve impostare l'IDP sul CI e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC, potrebbe consistere in lettere, numeri, trattini, sottolineature, inclinazioni e punti e la lunghezza massima è 128 caratteri.
Id client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Segreto client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco degli ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio, ad esempio "profilo e-mail openid" Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non fornito
URL dell'endpoint di autorizzazione OAuth 2.0 dell'IdP.
endpoint token
Sì se discoveryEndpoint non fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
endpoint infoutente
No
URL dell'endpoint UserInfo di IdP.
Endpoint set di tasti
No
URL dell'endpoint JSON Web Key Set dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
Configurare l'URI di reindirizzamento sull'IDP di connessione OpenID.
Configurare un modello di onboarding. Per l'impostazione della modalità di autenticazione, selezionare Autenticazione partner Con OpenID Connect e immettere il nome IDP fornito durante l'impostazione IDP come ID entità IDP OpenID Connect.
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui registrazione chiamata, risposta per assente di gruppo, dirigente e assistente di direzione.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
Eseguire i seguenti comandi sulle interfacce AS. Ciò consentirà all’AS di inviare il c.d.
X-BroadWorks-Correlation-Info
Intestazione SIP:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true
Il
enableCallCorrelationID
Il parametro associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione delle informazioni di correlazione delle chiamate nei registri Xsi-Actions. Si raccomanda di avereenableCallCorrelationID
abilitato utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione dell'identificativo di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione della rubrica garantisce che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la directory di chiamata completa dal server BroadWorks viene sincronizzata con la directory Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione rubriche, vai a Sincronizzazione rubriche in Webex per Cisco BroadWorks.
Webex per Cisco BroadWorks flowthrough provisioning aggiunge utenti di messaggistica e informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, gli elenchi telefonici, gli utenti non di messaggistica e le entità non utenti non sono inclusi (ad esempio, un telefono della sala conferenze, un fax o un numero di gruppo di risposta). L'attivazione della sincronizzazione delle rubriche garantisce che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex. |
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia chiamate e riunioni unificate Webex visualizzata sull'app Webex. Gli utenti possono visualizzare la cronologia dettagliata delle chiamate e della riunione dall'app Webex.
La cronologia chiamate unificata può essere abilitata dagli amministratori a livello di partner in Partner Hub su base cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
Eventi cronologia chiamate: questi eventi vengono utilizzati per creare una cronologia chiamate unificata dettagliata
Eventi di stato hook: la cronologia chiamate unificata include ottimizzazioni dello stato hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di Telephony Presence
Requisiti della cronologia chiamate unificata
Prima di configurare la cronologia chiamate unificata, accertarsi di aver eseguito la patch del sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
AP.as.22.0.1123.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per R23:
AP.as.23.0.1075.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Se si utilizza XSP—
AP.xsp.23.0.1075.ap378585
In caso di utilizzo di ADP
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
AP.as.24.0.944.ap378585
-dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per l'elenco completo delle patch BroadWorks che è necessario installare come prerequisito per l'esecuzione di Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella sezione Riferimento. |
Oltre alla patch del sistema, il file di configurazione del client ( config-wxt.xml
) deve avere il seguente set di tag: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altro reindirizzamento nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
AP.as.23.0.1075.ap383346
AP.as.23.0.1075.ap383994
Per R24:
AP.as.24.0.944.ap383346
AP.as.24.0.944.ap383994
Per avere informazioni Dirigente-Assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
AP.as.24.0.944.ap380052
AP.as.24.0.944.ap384239
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare anche la sincronizzazione delle rubriche per la cronologia chiamate unificata dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione NoDist, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti nel cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione di Broadworks durante la stessa finestra di manutenzione. |
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configura organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettuare le seguenti operazioni:
Accedi a Partner Hub su
admin.webex.com
.Andare a Impostazioni e selezionare un cluster esistente.
Verificare che la connessione al cluster sia buona. Nel pannello a destra viene visualizzato un segno di spunta verde con Connection stabilita.
Se questa opzione non viene visualizzata, in Check Connnections (Opzionale), immettere BroadWorks User Id e BroadWorks Password e fare clic su Check per verificare che la connessione sia corretta.
Selezionare la casella di controllo Abilita cronologia chiamate.
Fai clic su Salva.
Interazioni funzione
Per la cronologia chiamate unificata sono presenti le seguenti interazioni delle funzioni:
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando questa situazione esiste, gli eventi Cronologia chiamate e Stato hook non vengono inviati all'app Webex.
La cronologia chiamate unificate non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia chiamate unificata dall'app Webex. Per informazioni dettagliate, vedere: Webex | visualizza cronologia chiamate e riunioni.
Disabilita cronologia chiamate unificata
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visivo
L'app Webex supporta un'indicazione visiva delle chiamate spam nel avviso popup quando la chiamata viene presentata al destinatario e nei record della cronologia delle chiamate unificate quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per utilizzare questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- Le seguenti patch devono essere installate e attive:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o AS-25_Rel_2022.12 come minimo
- La funzione deve essere attivata tramite AS CLI:
- AS_CLI/System/ActivatableFeature> attivare 104112
- AS_CLI/System/StirShaken> imposta enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'etichettatura e la verifica STIR-SHAKEN come descritto in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste di invito inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti che vengono inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione di spam visivo nella presentazione della chiamata e nella cronologia chiamate unificata della chiamata.
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenta di identificare il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra di chiamata e una volta completata la chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante abbinando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se trova più istanze di un numero in un'origine, non tenterà di sceglierne una, in questo caso, non visualizzerà alcun ID chiamante. |
Webex Common Identity (CI) che contiene gli utenti della tua organizzazione.
Contatti personali e aziendali. I contatti personali sono visibili nella scheda Contatti.
Rubrica locale. In Windows - applicazione Outlook, in Mac - Contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non viene trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, utilizzerà la parte del nome utente dell'URI SIP dall'intestazione SIP From come ultima risorsa.
Per il controllo delle chiamate remote (ad esempio, modalità di controllo del telefono fisso) vengono utilizzate informazioni XSI, dove viene utilizzato ID BWKS o interno, estratte da informazioni di parte remota nell'evento XSI. Se l'informazione della parte remota non è disponibile, verrà utilizzata P-Asserted Identity (PAI) (se configurata).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica di chiamata e nella cronologia chiamate.
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
Coda Call Center: Visualizza il nome della coda che ha inoltrato la chiamata.
Dirigente-Assistente: Mostra il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
Per le chiamate nella coda chiamate interna, in cui un agente richiama una parte interna, la parte remota non visualizzerà il nome della coda chiamata, ma il nome dell'agente che le chiama.
Chiamata con risposta altrove:
Per gruppi di risposta o code chiamate impostate con indirizzamento simultaneo, gli agenti visualizzeranno una chiamata che ha ricevuto risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di risposta o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate perse nella cronologia chiamate se risposte da un altro agente.
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni da tavolo. Questa funzione specifica consente di assegnare gli indicatori di linea condivisa all'app Webex dell'utente finale.
Questa funzione consente agli utenti di gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente alle linee condivise.
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise dal client Webex
R23 senza ADP:
AP.as.23.0.1075.ap384179
AP.xsp.23.0.1075.ap384179
R23 con ADP:
AP.as.23.0.1075.ap384179
Xsi-Actions-23_2022.10
R24:
IN QUANTO: AP.as.24.0.944.ap384179
Xsi-Actions-24_2022.10
R25:
IN QUANTO: Versione RI Rel_2022.10_1.310
Xsi-Actions-25_2022.10
Cerotto 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo. Esempio: Per il client desktop: Sistema>Tipo di profilo identità/dispositivo - Modifica> Business Communicator - PC: Profilo, opzioni standard, numero di porte:
- SE l'opzione 'Illimitato' è abilitata, non è richiesta alcuna modifica
- SE 'Limitato a' è <10, modificare il valore = 10 e salvarlo per utilizzare tutte le linee disponibili
Versione RI Rel_2022.10_1.310
Sincronizzazione Non disturbare (NoDist).
La sincronizzazione Non disturbare (NoDist) allinea le impostazioni NoDist tra Webex e BroadWorks sincronizzando lo stato NoDist tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato si sincronizza con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. Analogamente, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist da una piattaforma non vengono riconosciuti dall'altra piattaforma.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Se sono presenti molti clienti (>50) nel cluster BroadWorks, la sincronizzazione NoDist non è supportata. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza. |
Prerequisiti
Assicurarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione BroadWorks.
Per la versione 23:
<snipped>
- App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
<snipped>
- App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 su AS:
AS_CLI/System/ActivatableFeature> activate 25433
Se sono presenti molti clienti (>50) nel cluster BroadWorks, operazioni come l'aggiornamento di azioni XSI, eventi XSI, URL DAS, URL XSP|ADP o sincronizzazione NoDist non sono supportate. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza.
Configura sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto di eventi "as-feature-event". Per informazioni dettagliate, vedere Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
Accedi a Partner Hub
Fare clic su Impostazioni.
Fare clic su Visualizza cluster e selezionare il cluster BroadWorks appropriato.
Abilita il tasto di alternanza Non disturbare (NoDist).
Inserire l'ID utente BroadWorks e fare clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione NoDist. Se la convalida non riesce, il pulsante Salva viene disabilitato.
Se la convalida ha esito positivo, fare clic su Salva.
|
Abilita sincronizzazione NoDist (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per ulteriori dettagli, vedere "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Disabilita sincronizzazione NoDist
Non puoi disabilitare la sincronizzazione NoDist da solo. Per disabilitare la funzione, crea un caso BEMS di ingegneria con le seguenti informazioni:
Famiglia: Servizio Spark
Prodotto: Chiamata in Webex (Webex per BroadWorks)
Componente: Provisioning WxBW
Il caso BEMS deve indicare che la sincronizzazione non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterIdBroadWorks.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione delle chiamate.
Modalità di registrazione | Descrizione | Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi | La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta | La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente | La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Per R22: AP.as.22.0.1123.ap377718
Per R23: AP.as.23.0.1075.ap377718
Per R24: AP.as.24.0.944.ap377718
L'identificativo di correlazione chiamata deve essere attivato. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione delle chiamate Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, andare a help.webex.com
articolo Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla piattaforma di registrazione chiamate di terze parti.
Gruppo Parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione di parcheggio e recupero delle chiamate di gruppo. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti al dettaglio in un'impostazione di negozio possono utilizzare la funzione per parcheggiare una chiamata che può essere raccolta da qualcuno in un altro reparto.
Funzionamento funzione
Una volta configurata la funzione
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nell'app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nell'app Webex. L'utente quindi inserisce l'estensione della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per attivare questa funzione, verificare quanto segue:
Il file di configurazione client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
L'identificativo di correlazione chiamata deve essere abilitato su AS e XSP|ADP. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Il tuo SBC deve essere configurato per passare il ‘
x-broadworks-correlation-in
' Attributo SIP a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiungi gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo del server applicazioni Cisco BroadWorks - Parte 2. È necessario creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Parcheggio Webex | e Recupera chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzato
Il parcheggio chiamate regolare o indirizzato non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso funzione:
Immettere *68 per parcheggiare una chiamata
Immettere *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato negli ambienti del call center o in altre situazioni in cui può essere necessaria un'assistenza o un intervento immediati.
Quando un servizio di inclusione è abilitato, un utente o supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di tasti o pulsanti dedicati sul proprio telefono o dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o di partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in vari scenari. In un ambiente di call center, supervisori o formatori possono monitorare e assistere i rappresentanti del servizio clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire assistenza o prendere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può partecipare rapidamente a conversazioni in corso per fornire assistenza o prendere decisioni importanti.
Nell'app Webex per l'inclusione, viene inviata una notifica che la chiamata viene trasformata in una conferenza. In NOTIFY (informazioni sulla chiamata o conferenza) non sono disponibili ulteriori informazioni sul tipo di conferenza, pertanto è possibile trattarla in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Vengono introdotti i seguenti termini:
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore solitamente ha la possibilità di monitorare e intervenire nelle chiamate in corso dei clienti. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire assistenza agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può comprendere la formazione degli agenti, la gestione dei problemi dei clienti e l'ottimizzazione delle prestazioni del team.
Cliente: Per cliente si intende una persona fisica o giuridica che interagisce con un'azienda o un'organizzazione per ottenere prodotti, servizi o assistenza. Nel contesto dell'inclusione delle chiamate, un cliente è qualcuno che sta effettuando o ricevendo una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risolvere le loro richieste o problemi durante la chiamata. La funzione di inclusione chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
Agente: Un agente, anche noto come rappresentante del servizio clienti o agente del call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza telefonica o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare operazioni e offrire un'esperienza positiva al cliente. Nel contesto dell'inclusione delle chiamate, un agente è la persona che parla direttamente al cliente durante la telefonata. L'agente può ricevere indicazioni o feedback dal supervisore attraverso l'inclusione della chiamata, se necessario.
Per qualsiasi richiesta avviata dal client, come CallStartRequest, CallPickupRequest, DirectedCallPickupRequest, DirectedCallPickupWithBargeInRequest, ecc., se <Webex Client=""> (scegliere il nome giusto anziché il client Webex, se non è appropriato) viene fornito come dispositivo di aspetto chiamata condivisa, è necessario abilitare la configurazione 'Avvisa tutti gli aspetti delle chiamate con clic' nell'impostazione di aspetto chiamata condivisa per consentire al client di ricevere una chiamata, a meno che la posizione non sia esplicitamente fornita dal client che avvia la richiesta.
La chiamata nativa mobile viene inoltrata alla riunione
La funzione di escalation della chiamata nativa mobile alla riunione è dotata di due funzioni uniche:
Nuova notifica push
Gli utenti mobili su una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando si avvia una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si accede direttamente alla schermata in chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata utilizzando il controllo chiamate Cisco per le chiamate su cellulare, viene visualizzata la notifica Webex durante una chiamata su cellulare.
Trasferisci chiamata mobile a riunione
Quando sei nel mezzo di una chiamata con qualcuno, potresti voler trasferire la chiamata in una riunione per utilizzare alcune funzioni di riunione avanzate come video, condivisione o lavagna. In alternativa, invitare altre persone alla discussione e passare a una riunione.
Requisiti BroadWorks
Funzione attivabile 25239
R23 con XSP|ADP:
AS Patch AP.as.23.0.1075.ap383064
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
Patch AP.platform.23.0.1075.ap383064
R23 con ADP:
AS Patch AP.as.23.0.1075.ap383064
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R24:
Cerotto AS: AP.as.24.0.944.ap383064
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e NPS versione > 2022.08_1.350
R25:
AS RI release Rel_2022.08_1.354
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e NPS versione > 2022.08_1.350
Configurazione chiamata URI per supportare lo spostamento della chiamata alla riunione
Criteri di chiamata Url NS
Definisci la regola per (.*)webex.com da indirizzare attraverso I-SBC
NS_CLI/Policy/UrlDialing> get WebexMeetings
Policy: UrlDialing Instance: Webex
unknownSipURIHandling = reject
disableSubscriberLookups = true
Enable = true
CallTypes:
Selection = {ALL}
From = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP}
lineportOnly = false
enableSipURIMatchingRules = true
NS_CLI/Policy/UrlDialing/Rules> get WebexMeetings
Policy: UrlDialing Instance: WebexCalling Table: Rules
id pattern routingNE cost weight dtg
===================================================================
1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE di indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> get ne WebexMeetings
Network Element WebexMeetings
Location = 1281465
Data Center =
Static Cost = 1
Static Weight = 99
Poll = false
OpState = enabled
State = OnLine
Profile = NIL_PROFILE
Remote Lookup Enabled = false
Signaling Attributes =
NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings
Routing NE Address Cost Weight Port Transport Route
=====================================================================
WebexMeetings sbc-address 1 99 - unspecified
Profilo di indirizzamento NS
Aggiunta dell'istanza della policy UrlDialing ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> get profile MyInst
Profile: Webex
Policy Instance
==========================================
…
UrlDialing WebexMeetings
AS Usa indirizzamento NS per chiamata NetworkURL
Consente all'AS di rispettare il percorso NS in modalità ibrida AS
AS_CLI/Interface/IMS> set queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un PSAP (Public Safety Answering Point), che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, è necessario integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Usa i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
Chiamata di emergenza E911 in Webex per BroadWorks: utilizzare questo articolo per configurare la chiamata di emergenza E911 in Webex per Cisco BroadWorks utilizzando uno dei seguenti provider E911 supportati:
Banda
Intrado
RedSky
Esclusione di responsabilità per chiamate di emergenza: se disponi di un servizio di posizione, puoi configurare la finestra Esclusione di responsabilità per i servizi di emergenza sull'app Webex in modo da includere un'opzione per gli utenti per aggiornare la propria posizione quando eseguono l'accesso.
Personalizzazione e provisioning dei clienti
Gli utenti scaricano e installano le relative app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedere Piattaforme app Webex). Una volta eseguita l'autenticazione dell'utente, il client si registra sul cloud Webex per messaggistica e riunioni, recupera le informazioni sul branding, scopre le informazioni del servizio BroadWorks e scarica la configurazione delle chiamate dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
Configurare i parametri di chiamata per le app Webex in BroadWorks (come di consueto). Configura i parametri di branding, messaggistica e riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Prepara il tuo ambiente).
Verificare di disporre dei set di tag corretti in BroadWorks System > Resources > Device Management Tag Sets.
Per ciascun client che si sta eseguendo il provisioning:
Scaricare ed estrarre il file zip DTAF per il client specifico.
Importare i file DTAF in BroadWorks all'indirizzo System > Resources > Identity/Device Profile Types
Apri il profilo dispositivo appena aggiunto per la modifica e:
Immettere il nome di dominio completo dell'azienda agricola XSP|ADP e il protocollo di accesso del dispositivo.
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per il funzionamento della condivisione desktop.
È inoltre possibile abilitare il supporto Parte remota eseguendo il seguente comando CLI sul server applicazioni:AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
Salvare il file.
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome | Descrizione |
Priorità codec | Configurazione dell'ordine di priorità per i codec audio e video per le chiamate VoIP |
TCP, UDP e TLS | Configurare i protocolli utilizzati per la segnalazione e il contenuto multimediale SIP |
Porte audio e video RTP | Configurazione degli intervalli di porte per audio e video RTP |
Opzioni SIP | Configurare diverse opzioni relative a SIP (SIP INFO, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti gestiti dal partner. Vedere Configurazione di personalizzazioni di branding avanzate.
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client. |
Personalizzazione dei report dei problemi e degli URL della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito Feedback e Guida", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con Flowthrough Provisioning
Prima di poter eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 | Assegna servizio in BroadWorks: |
2 | Verifica dell'organizzazione cliente e degli utenti in Control Hub: |
Test utente
1 | Scaricare l'app Webex su due diverse macchine. |
2 | Eseguire l'accesso come utenti di test sulle due macchine. |
3 | Effettuare chiamate di prova. |
Provisioning delle organizzazioni dei clienti
Nel modello corrente, eseguiamo automaticamente il provisioning dell'organizzazione del cliente quando si esegue l'onboarding del primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguito una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
Usa API per creare account Webex
Assegna il provisioning integrato IM&P (flowthrough provisioning) con e-mail attendibili per creare account Webex
Assegna provisioning integrato IM&P (flowthrough) senza e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per creare account Webex
Consenti agli utenti di autoattivarsi (invia loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex espone le API pubbliche per consentire ai provider di servizi di integrare il provisioning degli abbonati Webex per Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. Le specifiche per queste API sono disponibili su developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti wholesale verranno rifiutati da queste API. |
Provisioning del flusso
Su BroadWorks, è possibile eseguire il provisioning degli utenti con l'opzione Abilita IM&P integrato. Questa azione provoca l'adattatore di provisioning BroadWorks per effettuare una chiamata API per il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica del codice, ma solo una modifica della configurazione dell'endpoint API per l'adattatore di provisioning.
Il provisioning degli abbonati su Webex può richiedere molti minuti (diversi minuti per l'utente iniziale all'interno di un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il successo del provisioning flowthrough indica che il provisioning è stato avviato. Non indica il completamento. Per confermare che il provisioning di utenti e organizzazione cliente sia completo su Webex, devi accedere a Partner Hub e guardare nell'elenco dei clienti. Gli utenti di trunking BroadWorks possono disporre di Webex per BroadWorks tramite un identificativo di chiamata condiviso (SCA). L'utente che esegue il trunking dovrà disporre del servizio di autenticazione assegnato. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto Webex SCA dall'autenticazione del trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con le funzioni di elenco di indirizzamento o indirizzamento diretto assegnate. |
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata Modello di onboarding. |
Autoattivazione utente
Per eseguire il provisioning degli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
Accedere a Partner Hub e trovare la pagina Elenco clienti.
Fare clic su Visualizza modelli.
Seleziona il modello di onboarding di provisioning che desideri applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non si trova nel sistema BroadWorks associato a questo modello, non può attivarsi automaticamente con il collegamento.
Copiare il collegamento di provisioning e inviarlo all'utente.
È anche possibile includere il collegamento per il download del software e ricordare all'utente di cui ha bisogno di fornire e convalidare il proprio indirizzo e-mail per attivare l'account Webex.
È possibile monitorare lo stato di attivazione dell'utente nel modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi di attivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli all'interno della vista Stato utente che consentono agli amministratori dei provider di servizi Webex per Cisco BroadWorks di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Sposta gli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) |
|
Organizzazione cliente | Collega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge Webex per BroadWorks anche agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a… | Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) | Se l'organizzazione Webex per BroadWorks non esiste (nessun utente predisposto):
Se esiste un'organizzazione Webex per BroadWorks (viene predisposto almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di autoiscrizione (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (con il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
Sposta utente (con e-mail attendibili): utilizza il provisioning con e-mail attendibili
Sposta utente (con e-mail non attendibili): utilizza il provisioning con e-mail non attendibili
Autoattivazione
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza messaggi e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
L'amministratore aggiunge l'utente.
L'utente viene spinto sul bridge di provisioning BroadWorks.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L’utente apre il messaggio e-mail e fa clic su Attiva account. L'utente viene reindirizzato al portale consumer Webex.
L'utente accede a Webex.
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza messaggi e-mail non attendibili, è necessario prima convalidare l’indirizzo e-mail dell’utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
L'amministratore aggiunge l'utente.
L'utente viene inviato automaticamente al bridge di provisioning BroadWorks.
All'utente viene inviato un testo con un collegamento di attivazione.
L'utente fa clic sul collegamento Attivazione e inserisce l'indirizzo e-mail.
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
All'utente viene inviato un messaggio e-mail automatico.
L'utente apre il messaggio e-mail e fa clic su Accedi ora.
L'indirizzo e-mail viene convalidato.
L'utente viene reindirizzato all'accesso al portale consumer Webex.
L'utente accede a Webex.
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
Il vecchio account Webex viene eliminato.
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
L'utente viene indirizzato alla pagina Download.
Flusso di autoattivazione
Se l'utente dispone di un account BroadWorks esistente, può utilizzare il processo di autoattivazione per spostare l'account.
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
L'utente inserisce il proprio indirizzo e-mail.
L'utente viene inviato al bridge di provisioning BroadWorks.
Viene inviata un'e-mail automatica all'indirizzo e-mail dell'utente.
L'utente apre il messaggio e-mail e fa clic sul collegamento Accedi ora, che convalida l'indirizzo e-mail.
CI rileva che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di poter continuare.
L'utente viene reindirizzato all'accesso a Webex.
L'utente accede al portale consumer.
L'utente fa clic su Elimina account.
L'account Webex precedente viene eliminato.
All'utente è stato predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
Collegamento di Webex per BroadWorks all'organizzazione esistente
Se sei un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, che non è ancora associata a un'azienda BroadWorks gestita da un partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso amministratore per la richiesta di provisioning riuscita.
È necessaria l'approvazione dell'amministratore dell'organizzazione se una delle seguenti affermazioni è vera:
L'organizzazione cliente esistente dispone di 100 utenti o più
L'organizzazione dispone di un dominio e-mail verificato
Dominio organizzazione richiesto
Se nessuno dei criteri di cui sopra è vero, può verificarsi un Attacco automatico.
In uno scenario di allegato automatico, un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner verranno concessi diritti di amministrazione provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà eseguito un amministratore completo. Con l'accesso amministratore di provisioning, la visibilità in Control Hub sarà limitata agli utenti nell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione. |
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che i messaggi e-mail di invito amministratore vengano collegati a organizzazioni esistenti (il tasto di alternanza è attivo per impostazione predefinita). |
1 | L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedere Provisioning delle organizzazioni dei clienti. Si verifica quanto segue:
| ||
2 | Con l'accesso amministratore completo, l'amministratore del partner può completare il processo di provisioning del cliente. Dovrai provare a eseguire nuovamente il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora come amministratore completo esterno, non si dovrebbe osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione cliente esistente sarà visibile come cliente sotto Webex per l'organizzazione partner BroadWorks.
|
Condizioni dell'allegato organizzazione
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione del cliente target. In caso contrario, verrà creata una nuova organizzazione cliente.
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato sul modello di provisioning Webex per BroadWorks. Di conseguenza, non vi sono modifiche alla modalità di accesso degli utenti esistenti.
Tuttavia, se l'organizzazione cliente esistente dispone di branding di base abilitato, una volta eseguito il collegamento, le impostazioni di branding avanzate del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
Il nome dell'organizzazione esistente non cambierà.
Non è stata apportata alcuna modifica all'impostazione del flag di soppressione e-mail nelle impostazioni dell'organizzazione esistente. Ciò può avere effetto sui nuovi utenti predisposti. A seconda di come è impostato il flag, i nuovi utenti possono o meno ricevere un'e-mail con un codice che deve essere immesso per completare l'attivazione.
La modalità di amministrazione con restrizioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
Accertarsi di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
Un'azienda BroadWorks può essere associata solo a una organziazione Webex. Non è possibile eseguire il provisioning degli abbonati da una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com
.
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo. |
L'indirizzo e-mail aggiunto dall'amministratore dell'organizzazione cliente come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore partner come configurato nel modello di onboarding su Partner Hub. Dopo aver aggiunto l'e-mail dal modello di onboarding in Partner Hub come amministratore completo, qualsiasi amministratore aggiuntivo del partner dovrà essere aggiunto anche come amministratore esterno con diritti di amministratore completo. |
Scollegare Webex per BroadWorks dall'organizzazione esistente
Effettuare le seguenti operazioni per scollegare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato accidentalmente Webex per BroadWorks a un'organizzazione esistente e si desidera rimuovere l'allegato.
In Flusso standard, il distacco di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati. |
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso all'amministratore esterno seguendo Approva richiesta amministratore esterno.
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Remove a BroadWorks Workspace.
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi abbonato BroadWorks.
Rimuovi gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se gli utenti sono stati predisposti tramite il flusso e-mail non attendibile e non sono stati ancora inseriti messaggi e-mail validi, gli utenti rimangono in stato di attesa. Segui Verifica provisioning utente con e-mail non attendibili per eliminare gli utenti.
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Hybrid, nella sezione BroadWorks Calling elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera collegare Webex per BroadWorks al cliente, seguire i processi di provisioning per collegarlo a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API Rimuovi abbonato BroadWorks è quella di accedere a BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati. |
Gestione di utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente sono in BroadWorks. Un'identità e-mail distinta per l'utente e le relative licenze per le funzioni Webex vengono conservate in Webex.
Verifica del provisioning utenti con indirizzi e-mail non attendibili
Se si sta eseguendo il provisioning di utenti Webex per BroadWorks utilizzando il provisioning flow-through con e-mail non attendibili, gli utenti devono eseguire il provisioning automaticamente inserendo il relativo indirizzo e-mail nel portale di attivazione utente. Se l'utente riscontra un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riscontra nuovamente l'errore, l'amministratore può utilizzare i passaggi seguenti in Partner Hub per esaminare lo stato e caricare l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 | Accedere a Partner Hub e trovare la pagina Elenco clienti. |
2 | Fare clic su Visualizza modelli. Selezionare il modello di onboarding appropriato che si desidera applicare a questo utente. |
3 | In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con e-mail non attendibili sia configurato correttamente:
|
4 | In seguito al provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato del provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo stato corrente, che mostra se l'utente è predisposto o se è presente un requisito in sospeso.
|
5 | Per gli utenti con errori o requisiti in sospeso, fare clic sui tre punti a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili quando si visualizza l'elenco degli utenti:
Esporta: fare clic su questo pulsante se si desidera esportare l'elenco utenti in un file CSV.
Escludi utenti predisposti: abilita questo tasto di alternanza se desideri visualizzare solo gli utenti con requisiti o errori in sospeso.
Modifica ID utente o indirizzo e-mail
Modifiche a ID utente e indirizzo e-mail
L'ID e-mail e l'ID alternativo sono gli attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. La tabella seguente descrive gli scopi di questi diversi attributi e cosa fare se occorre cambiarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non puoi modificare questo identificativo e comunque collegare l'utente allo stesso account in Webex. È possibile eliminare l'utente e ricreare se non è corretto. |
ID e-mail | ID utente | Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si afferma che l'e-mail è attendibile Non richiesto in BroadWorks se non si asserisce di poter considerare attendibili i messaggi e-mail Non richiesto in BroadWorks se consenti agli abbonati di autoattivarsi | È presente un processo manuale per modificare questa opzione in entrambe le posizioni se all'utente è stato eseguito il provisioning con l'indirizzo e-mail errato:
Non modificare l'ID utente BroadWorks. Questa operazione non è supportata. |
ID alternativo | Nessuno | Consente di abilitare l'autenticazione dell'utente per e-mail e password rispetto all'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se Non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti dovranno inserire il proprio ID utente BroadWorks durante l'autenticazione. |
Modifica pacchetto utenti in Partner Hub
1 | Accedi a Partner Hub e fai clic su Clienti. |
2 | Individuare e selezionare l'organizzazione del cliente a cui è assegnato l'utente. Viene visualizzata la pagina di panoramica dell'organizzazione in un pannello a destra dello schermo. |
3 | Fare clic su Visualizza cliente. L'organizzazione del cliente si apre in Control Hub, mostrando la pagina Panoramica.
|
4 | Fare clic su Utenti, quindi individuare e fare clic sull'utente interessato. |
5 | Nei Servizi dell'utente, fare clic su Webex per i pacchetti BroadWorks (Abbonamenti). Si apre il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 | Nella scheda Profilo, cercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 | Seleziona il pacchetto che desideri per questo utente (Base, Standard, Premium o Softphone) e fai clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 | Puoi chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium hanno siti di riunione distinti associati a ciascun pacchetto. Quando un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato viene visualizzato con due siti di riunione in Control Hub. Le funzionalità di riunione organizzatore e il sito della riunione dell'abbonato vengono allineati al pacchetto corrente. Il sito della riunione del pacchetto precedente e qualsiasi contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili all'amministratore del sito della riunione. |
Potrebbero essere necessarie da due a tre ore per le nuove impostazioni PMR derivanti da una modifica del pacchetto da aggiornare. |
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si desidera eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto alcun trasferimento automatico del ruolo di amministratore nel caso in cui venga eliminato l'ultimo amministratore. |
API Cisco BroadWorks per Webex
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
Eseguire la richiesta API Remove a BroadWorks Subscriber su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento Webex per Cisco BroadWorks. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
Eseguire la richiesta Elimina una persona API su https://developer.webex.com/docs/api/v1/people/delete-a-person per eliminare completamente l'utente.
Provisioning flow-through
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – IM&P integrato in BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks - Parte 2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento Webex per Cisco BroadWorks dall'utente. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla propria organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 | Usa le API Persone per eliminare tutti gli utenti dall'organizzazione:
| ||
2 | Se la sincronizzazione rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione rubriche tramite Partner Hub: Per disabilitare la sincronizzazione rubriche tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API aziendale BroadWorks e disabilita l'impostazione enableDirSync. Tutti gli utenti correlati alla sincronizzazione rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione degli utenti (utilizzando entrambi i metodi) può richiedere del tempo a seconda della quantità di utenti. | ||
3 | Una volta rimossi tutti gli utenti, utilizza l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Annullamento di un abbonamento da Control Hub
Poiché l'API è privata, i clienti non avranno accesso ad essa. Al contrario, le seguenti operazioni mostrano come i clienti possono annullare il proprio abbonamento da Control Hub:
L'amministratore del partner può passare alla pagina dei servizi "Hybrid" sul Control Hub del cliente.
Individua la scheda "BroadWorks Calling".
Una volta eseguito il provisioning di tutti gli utenti da Webex per BroadWorks per tale cliente, il partner deve visualizzare un pulsante "Cancella configurazione" (ad esempio, eliminare la customer_config voce in BPB).
Gestione delle release
I controlli di gestione delle release in Partner Hub consentono a Webex per i provider di servizi Cisco BroadWorks di gestire facilmente le release consentendo loro di controllare la cadenza di rilascio in base alla quale le app Webex degli utenti vengono aggiornate all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza gli aggiornamenti automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
Configurazione di pianificazioni di rilascio personalizzate con rinvii dalla pianificazione di rilascio predefinita Cisco
Configurare una singola pianificazione della release e trasferirla a cascata a tutte le organizzazioni dei clienti che gestiscono
Assegna diverse pianificazioni di rilascio a diverse organizzazioni di clienti
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di rilascio personalizzate, vedere l'articolo Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
Aggiunta di un cluster BroadWorks in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
Aggiunta di un modello di onboarding in Partner Hub
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | ||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | ||
3 | Fare clic su Visualizza cluster. | ||
4 | Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro flyout a destra.
| ||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 | Accedere a Partner Hub con le credenziali di amministratore del partner su | |||||||||
2 | Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | |||||||||
3 | Fare clic su Visualizza modelli. | |||||||||
4 | Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 | Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere a Webex Assistant di seguire le azioni, prendere nota di decisioni importanti ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant per Meetings è disponibile gratuitamente per i siti per riunioni con pacchetto Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilitazione di Webex Assistant per Meetings
Webex Assistant è abilitato per impostazione predefinita per i clienti Broadworks con pacchetto standard e premium.
Gli amministratori dei partner e gli amministratori delle organizzazioni dei clienti possono disabilitare la funzione per le organizzazioni dei clienti tramite Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
Il supporto è limitato ai siti per riunioni con pacchetto Premium e Standard e solo alle sale riunioni personali.
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
La condivisione di contenuto tramite e-mail è accessibile solo dagli utenti all'interno della tua organizzazione
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Il contenuto della riunione non è accessibile anche se condiviso tra utenti di pacchetti diversi dall'interno della stessa organizzazione.
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile, pertanto le trascrizioni post-riunione non sono disponibili se Webex Assistant è abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni utente su come utilizzare la funzione, vedere Uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
Webex Calling gratuito è abilitato per impostazione predefinita consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, che disabilita tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzione
Se Webex Calling è disabilitato, le seguenti condizioni si applicano a Webex per gli utenti Cisco BroadWorks:
Gli utenti non visualizzano più Chiamata con Webex come opzione di chiamata selezionabile sull'app Webex.
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, la cronologia chiamate, i contatti, inserendo l'URI dell'altro utente o l'indirizzo e-mail nella barra di ricerca.
Condivisione schermo all'interno di una chiamata BroadWorks.
Le riunioni Webex e la presenza in telefonia funzionano ancora, anche se le chiamate Webex sono disabilitate.
Disabilita chiamate Webex (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno di Aggiungi un nuovo modello guidata. Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti assegnate al modello.
Per informazioni dettagliate sulla configurazione di un nuovo modello di onboarding, vedere Configurazione dell'organizzazione partner in Partner Hub.
Disabilita chiamate Webex (modello di onboarding esistente)
Seguire questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
Accedere a Partner Hub all'indirizzo admin.webex.com.
Scegliere Impostazioni.
Fare clic su Visualizza modello e scegliere il modello di inserimento appropriato.
Fai clic su Disabilita chiamata gratuita Cisco Webex.
Fai clic su Salva.
Disabilita chiamate Webex (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare Webex Calls per un utente esistente, è possibile seguire una delle procedure seguenti per aggiornare l'utente.
Accertarsi di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigura l'utente con le chiamate Webex abilitate. |
Se si utilizza il provisioning flow-through, è possibile effettuare le seguenti operazioni:
Aprire CommPilot e passare alla configurazione utente.
Rimuovere il servizio Integrated IM+P dall'utente e fare clic su OK.
Aggiungere il servizio Integrated IM+P all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
Utilizzare Remove a BroadWorks Subscriber API per eliminare l'utente.
Utilizzare la Provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione della condivisione video o dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per informazioni dettagliate sulla configurazione e le opzioni complete, vedere Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è anche possibile configurare se il contenuto multimediale delle chiamate in ingresso utilizza per impostazione predefinita solo il video o l'audio. |
Indicatore di stato della linea / Notifica risposta per assente
L'indicatore di stato/notifica di risposta per assente utilizza le funzioni di risposta per assente indirizzata. Un utente con indicatore di stato riceve una notifica audio e visiva sull'app Webex quando un utente dell'elenco di indicatori di stato monitorato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può Ignorare o Rispondere alla chiamata dell'utente monitorato.
La notifica dell'indicatore di stato/risposta per assente consente di rispondere alle chiamate di altri membri del team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra chiamata multipla - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza dei membri del team Webex e non Webex. Per informazioni sull'abilitazione della chiamata multipla, vedere: Finestra multi-chiamata
I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati nella rubrica in Webex e avranno solo stati "sconosciuti" e "in chiamata" (lo stato suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
La presenza non è supportata per gli utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
Gli utenti CI senza autorizzazione cloud Webex o tipo di account macchina (spazi di lavoro) visualizzano solo la presenza "in chiamata" e "sconosciuta". Nessun stato attivo, suoneria, ecc.
Gli utenti non Webex dall'elenco di indicatori di stato, che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza "sconosciuta".
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
Se un utente non Webex dell'indicatore di stato detiene una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate su BroadWorks. Installare solo le patch valide per la versione in uso:
Per R22:
Piattaforma AP.22.0.1123.ap382053
AP.as.22.0.1123.ap382053
AP.as.22.0.1123.ap382362
AP.xsp.22.0.1123.ap382053
AP.xsp.22.0.1123.ap382362
AP.as.22.0.1123.ap383459
AP.as.22.0.1123.ap383520
Per R23:
Piattaforma AP.23.0.1075.ap382053
AP.as.23.0.1075.ap382053
AP.as.23.0.1075.ap382362
AP.as.23.0.1075.ap383459
AP.as.23.0.1075.ap383520
Se si utilizza XSP|ADP:
AP.xsp.23.0.1075.ap382053
AP.xsp.23.0.1075.ap382362
Se si utilizza ADP:
Xsi-Actions-23_2022.01_1.200.bwar
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
Per R24:
AP.as.24.0.944.ap382053
AP.as.24.0.944.ap382362
AP.as.24.0.944.ap383459
AP.as.24.0.944. ap383520
Xsi-Actions-24_2022.01_1.200.bwar
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
<busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare la funzione 101642 Enhanced Xsi Mechanism Per la telefonia del team su AS:
AS_CLI/System/ActivatableFeature> activate 101642
Abilita X-BroadWorks-Remote-Party-Info
in AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamata SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Accertarsi che i seguenti servizi siano assegnati agli utenti:
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP. |
Configurazione dell'indicatore di stato della linea su BroadWorks
Gli amministratori dei partner possono utilizzare la seguente procedura per impostare l'indicatore di stato della linea per un utente.
Accedere a BroadWorks CommPilot.
Per un utente selezionato, accedere ad Applicazioni client e configurare l'indicatore di stato della linea.
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
Utilizzare i parametri di ricerca per individuare e aggiungere utenti all'elenco Utenti monitorati.
Fai clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento di coinvolgimento del pubblico facile da usare. Consente alle persone di ottenere il massimo dalle riunioni colmando la distanza tra oratori e pubblico. Quando Slido è integrato nell'organizzazione Control Hub, gli utenti possono aggiungere l'Slido app alle riunioni nell'app Webex. Questa integrazione offre ulteriori funzionalità di Q&A e sondaggio alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando è stata accettata una riunione nel client Outlook che corrisponde a un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che hai assunto un impegno diverso e che la risposta potrebbe essere ritardata.
Per abilitare questa funzione:
andare alla scheda Generale della scheda Impostazioni su Windows o Preferenze su Mac.
Selezionare la casella per Mostra in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, "In una riunione di calendario" in Webex è associato a "Occupato" in Outlook. |
Avvertenza
Per utilizzare questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come funziona altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la sua presenza non verrà aggiornata fino al termine della riunione. A tale scopo, sarà necessario riavviare il client per rispondere.
Risposta automatica con tono
Con la risposta automatica con tono, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul desktop. Quando l'app Webex squilla sull'altra parte, l'utente sente un determinato segnale acustico che indica che la chiamata è in connessione.
Per utilizzare questa funzione per un utente Webex per Cisco BroadWorks:
La funzione è supportata solo sull'aspetto della linea principale
L'app Webex deve essere l'identificativo di linea principale
Il tag %ENABLE_AUTO_ANSWER_WXT% deve essere abilitato
Se l'utente dispone anche di indicatori di chiamata condivisa (ad esempio, un telefono da tavolo è configurato come uno degli indicatori di linea secondaria), la funzione è ancora supportata sull'aspetto principale, a condizione che gli indicatori di chiamata condivisa siano configurati per non ricevere chiamate in arrivo. Per effettuare questa operazione, è possibile configurare una delle tre condizioni seguenti su BroadWorks per tutte le chiamate condivise:
Avvisa tutti gli aspetti delle chiamate con clic è disabilitato nella configurazione dell'aspetto chiamata condivisa: questo è l'approccio consigliato
o
Consenti terminazione a questa posizione deve essere disabilitato per tutte le chiamate condivise o
o
Posizioni disabilitate per tutti gli indicatori di chiamata condivisi
Aumentare la capacità
Aziende agricole XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare quante risorse XSP|ADP aggiuntive sono necessarie per l'aumento proposto dei numeri di abbonati. Per le aziende NPS dedicate o Webex dedicato per le aziende Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
Fattoria dedicata in scala: Aggiungere uno o più server XSP|ADP all'azienda che ha bisogno di capacità extra. Installare e attivare lo stesso set di applicazioni e configurazioni dei nodi esistenti dell'azienda agricola.
Aggiungi azienda agricola dedicata: Aggiungi una nuova fattoria XSP|ADP dedicata. Dovrai creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti nella nuova fattoria, per ridurre la pressione sulla fattoria esistente.
Aggiungere azienda agricola specializzata: Se si verificano strozzature per un particolare servizio, è possibile creare un'azienda agricola ADP|XSP separata a tale scopo, tenendo conto dei requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster di Control Hub e le voci DNS se si modifica l'URL del servizio con una nuova azienda agricola.
In tutti i casi, è tua responsabilità monitorare e assegnare risorse all’ambiente BroadWorks. Se si desidera contattare l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare i servizi professionali.
Gestione dei certificati del server HTTP
È necessario gestire questi certificati per le applicazioni Web autenticate mTLS su XSP|ADP:
La nostra catena di certificati di attendibilità dal cloud Webex
Certificati delle interfacce del server HTTP di XSP|ADP
Catena di fiducia
È possibile scaricare la catena del certificato di attendibilità da Control Hub e installarlo sugli ADP|XSP durante la configurazione iniziale. Prevediamo di aggiornare il certificato prima della scadenza e di informarvi su come e quando modificarlo.
Interfacce del server HTTP
L'|ADP XSP deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Certificati ordine. Quando si protegge l'interfaccia, viene generato un certificato autofirmato per l'interfaccia. Questo certificato è valido per un anno da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione di Partner Hub che gli amministratori dei partner possono assegnare a organizzazioni di clienti specifiche per limitare le impostazioni dell'organizzazione che gli amministratori dei clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione del cliente, tutti gli amministratori del cliente di tale organizzazione, indipendentemente dalle autorizzazioni dei ruoli, non sono in grado di accedere a un set di controlli con limitazioni in Control Hub. Solo un amministratore partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner esiste un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita le autorizzazioni di ruolo specifiche per gli amministratori dei clienti nell'organizzazione a cui è applicata l'impostazione. |
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità con limitazioni per partner. Dopo l'accesso, vedrà un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner notifica all'amministratore del cliente che la Modalità con limitazioni è abilitata e che l'amministratore potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore del cliente in un'organizzazione in cui con limitazioni della modalità partner è abilitata, il livello di accesso di Control Hub è determinato con la formula seguente:
(Accesso a Control Hub) = (Entitlements Role Organization) - (Limitato dalle limitazioni della modalità partner)
Limitazioni
Quando è abilitata la modalità con limitazioni per partner per un'organizzazione del cliente, gli amministratori dei clienti di tale organizzazione non possono accedere alle seguenti impostazioni di Control Hub:
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
Pulsante Gestisci utenti: disattivato.
Aggiungi o modifica manualmente utenti: nessuna opzione per aggiungere o modificare gli utenti, né manualmente né tramite CSV.
Richiedi utenti: non disponibile
Assegna automaticamente licenze: non disponibile
Sincronizzazione rubriche —Impossibile modificare le impostazioni di sincronizzazione delle rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato ed e-mail principale* sono modificabili.
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, messaggi, riunioni, chiamate)
Visualizza stato servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
Numero di lavoro principale: questo campo è di sola lettura.
Nella vista Account, non sono disponibili le seguenti impostazioni:
Nome società: campo di sola lettura.
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
Dominio: accesso di sola lettura.
E-mail: le impostazioni Elimina inviti e-mail di amministrazione e Selezione impostazioni internazionali e-mail sono di sola lettura.
Autenticazione: nessuna opzione per la modifica delle impostazioni di autenticazione e SSO.
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
Impostazioni chiamata: le impostazioni di priorità della chiamata delle opzioni dell'app sono di sola lettura.
Funzionamento chiamata: le impostazioni sono di sola lettura.
Posizione > PSTN: le opzioni Gateway locale e Cisco PSTN sono nascoste.
Sotto SERVIZI, le opzioni di servizio Migrazioni e Connected UC vengono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori partner possono utilizzare la procedura seguente per l'abilitazione Con limitazioni della modalità partner per una determinata organizzazione cliente (l' impostazione predefinita è abilitata).
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
Seleziona l'organizzazione cliente applicabile.
Nella vista Impostazioni di destra, abilitare il Con limitazioni della modalità partner per attivare l'impostazione.
Se si desidera disattivare la modalità Con limitazioni per partner, disabilitare l'interruttore.
Se il partner rimuove la modalità amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà eseguire quanto segue:
|
Analisi dei partner
I miglioramenti di Control Hub consentono agli amministratori partner di visualizzare e aggiornare facilmente le informazioni sui pacchetti per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata di tutti i clienti e include i seguenti dettagli:
Utenti totali per pacchetto (Softphone, Base, Standard, Premium)
Tendenza utenti per pacchetto (giornaliero/settimanale/mensile)
Clienti con n. di pacchetti assegnati
Per informazioni dettagliate su come utilizzare Analisi dei partner, vedere l'articolo Webex Analisi per i pacchetti Webex per la vendita all'ingrosso e Webex per BroadWorks in Partner Hub .
API di report fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare report di fatturazione. Nella tabella seguente vengono elencate le API, il tipo di accesso richiesto e i requisiti di ruolo.
API di fatturazione | Scopo | Tipo di accesso | Requisiti di ruolo per API (L'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Creazione di un report di fatturazione BroadWorks | Utilizzato per generare un report di fatturazione. | Accesso in scrittura |
|
Elenca report di fatturazione BroadWorks | Consente di elencare i report disponibili per la visualizzazione. | Accesso in lettura |
|
Ottenere un report di fatturazione BroadWorks | Utilizzato per ottenere una copia di un report generato. | Accesso in lettura |
|
Eliminazione di un report di fatturazione BroadWorks | Utilizzato per eliminare un report generato. | Accesso scrittura |
|
Campi di fatturazione
Nella tabella seguente sono elencati i campi contenuti nel report generato.
Campo | Descrizione |
---|---|
nome rivenditore | Nome partner o ID organizzazione partner |
ID fatturazione | Identificativo di fatturazione univoco del partner o numero C |
IdImpresaSp | L'identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno | Stato versione di prova interna del cliente (Sì/No) |
ID utente | IDutente dell'abbonato su BroadWorks |
id abbonato | Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato | Sì/No |
Data iniziale | Data di provisioning dell'abbonato. |
dataInizioFatturazione | Data di inizio fatturazione in questo mese |
DataFineFatturazione | Data di fine fatturazione in questo mese |
pacchetto | Il tipo di confezione che viene caricata |
quantità | Quantità ripartita per fatturazione.
|
|
Risoluzione dei problemi di Webex per Cisco BroadWorks
Abbonamento alla pagina di stato Webex
Innanzitutto verificare https://status.webex.com quando si verifica un'interruzione imprevista del servizio. Se non hai modificato la tua configurazione in Control Hub o BroadWorks prima dell'interruzione, controlla la pagina di stato. Ulteriori informazioni sull'iscrizione per le notifiche di stato e incidenti al Centro assistenza Webex.
Usa analisi Control Hub
Webex monitora l'utilizzo e i dati di qualità per la tua organizzazione e le organizzazioni dei tuoi clienti. Ulteriori informazioni sulle analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
Clienti o utenti non vengono creati in Control Hub con provisioning flowthrough:
Il server applicazioni può raggiungere l'URL di provisioning?
L'account di provisioning e la password sono corretti? Tale account esiste in BroadWorks?
I cluster non riescono in modo coerente a eseguire i test di connettività:
La connessione mTLS al servizio di autenticazione non riesce quando si crea il primo cluster in Partner Hub, poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. In caso contrario, non è possibile creare un'ancora attendibile sul servizio di autenticazione XSP|ADPs, pertanto la connessione mTLS di prova da Partner Hub non viene eseguita correttamente. |
Le interfacce XSP|ADP sono accessibili pubblicamente?
Stai utilizzando le porte corrette? È possibile immettere una porta nella definizione dell'interfaccia sul cluster.
Convalida non riuscita interfacce
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Esaminare i consigli per la configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso il
/v2.0/
alla fine degli URL. Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
Rivedere i consigli sulla configurazione dell'interfaccia in questo documento, con particolare attenzione a:
- Accertarsi di aver condiviso le chiavi RSA tra tutti gli XSP|ADP.
- Accertarsi di aver fornito l'URL AuthService al contenitore Web su tutti gli XSP|ADP.
- Se è stata modificata la configurazione della crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'|ADP XSP richiede di immettere il formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento elencava erroneamente le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati sul proprio archivio attendibile XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere i certificati del client?
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere i certificati del client?
Problemi del cliente
Verificare che il client sia connesso a BroadWorks
Accedere all'app Webex.
Verificare che l'icona Opzioni di chiamata (un ricevitore con una marcia sopra) sia presente sulla barra laterale.
Se l'icona non è presente, l'utente potrebbe non essere ancora abilitato per il servizio di chiamata in Control Hub.
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici . Viene visualizzato lo stato Sessione SSO A cui è stato eseguito l'accesso.
Se viene visualizzato un servizio telefonico diverso, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Tale verifica comporta:
Il client ha eseguito correttamente il transveresed dei microservizi Webex richiesti.
Autenticazione dell'utente eseguita correttamente.
Il client ha ricevuto un token Web JSON di lunga durata dal sistema BroadWorks.
Il client ha recuperato il proprio profilo dispositivo e si è registrato su BroadWorks.
Registri client
Tutti i client dell'app Webex possono Inviare I Registri a Webex. Questa è l'opzione migliore per i client mobili. È inoltre necessario registrare l'indirizzo e-mail dell'utente e l'ora approssimativa in cui si è verificato il problema se si sta cercando assistenza da TAC. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se è necessario raccogliere manualmente i registri da un PC Windows, si trovano come segue:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac:/Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS configurata male
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
Verificare che la catena di certificati Webex sia installata come ancora affidabile.
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e firmato da una CA ben nota.
Messaggio di eccedenza licenza
Questo messaggio può apparire per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'utilizzo delle licenze supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Politica di supporto allo stato stazionario
Il provider di servizi è il primo punto di contatto per il supporto del cliente finale (aziendale). Inoltrare i problemi che il SP non è in grado di risolvere al centro TAC. Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Politica di escalation
Tu (provider di servizi/partner) sei il primo punto di contatto per il supporto clienti finali (aziendale).
I problemi che non possono essere risolti dal SP vengono inoltrati al centro TAC.
Versioni di BroadWorks
Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Ulteriori informazioni su Politica sul ciclo di vita dei prodotti BroadSoft sezione in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
Risorse di autosupporto
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, dove è presente una pagina specifica di Webex per Cisco BroadWorks che elenca argomenti di Guida e supporto comuni dell'app Webex.
L'app Webex può essere personalizzata con questo URL della Guida e un URL di segnalazione problemi.
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I registri vengono inviati al cloud Webex, dove possono essere analizzati da Webex DevOps.
È disponibile anche una pagina Centro assistenza dedicata alla Guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccogliere informazioni per l'invio di una richiesta di assistenza
Quando vengono visualizzati errori in Control Hub, potrebbero essere allegate informazioni che possono aiutare TAC a indagare sul problema. Ad esempio, se viene visualizzato un ID di verifica per un particolare errore o un codice di errore, salvare il testo da condividere con noi.
Prova a includere almeno le seguenti informazioni quando invii una query o apri un caso:
ID organizzazione cliente e ID organizzazione partner (ogni ID è una stringa di 32 cifre esadecimali, separate da trattini)
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce uno
Indirizzo e-mail utente (se un particolare utente riscontra problemi)
Versioni del cliente (se il problema presenta sintomi notati attraverso il cliente)
Confronto UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > | SaaS UC-One | Webex per Cisco BroadWorks |
---|---|---|
Cloud | Cisco UC-One Cloud (GCP) | Webex Cloud (AWS) |
Client | UC-One: Mobile, desktop Receptionist, Supervisore | Webex: Mobile, desktop, Web |
Principale differenza tecnologica | Riunioni condotte sulla tecnologia BroadSoft Meet | Riunioni fornite sulla tecnologia Webex Meetings |
Prove sul campo iniziali | Contesto di stadiazione, clienti beta | Ambiente di produzione, clienti GA |
Identità utente | ID BroadWorks servito come ID principale, a meno che il provider di servizi non disponga già dell'integrazione SSO.
ID utente e segreto in BroadWorks | ID e-mail in Cisco CI serve come ID principale Integrazione SSO in BroadWorks provider di servizi in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks al momento.
L'utente fornisce le credenziali tramite SSO con BroadWorks e Secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e segreti in IdP |
Autenticazione client | Gli utenti forniscono le credenziali attraverso il client Token di lunga durata BroadWorks richiesti se si utilizza la messaggistica Webex | Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso a Webex e aggiornamento dei token |
Gestione / configurazione | I vostri sistemi OSS/BSS e Portale rivenditore | I tuoi sistemi OSS/BSS e Control Hub |
Attivazione partner/provider di servizi | Impostazione una tantum da Cisco Operations | Impostazione una tantum da Cisco Operations |
Attivazione cliente/azienda | Portale rivenditore | Control Hub Creato automaticamente alla prima iscrizione utente |
Opzioni di attivazione utente | Autoiscrizione Imposta IM&P esterno in BroadWorks
| Impostazione di IM&P integrato in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP | Azioni XSI
XSI-Eventi CTI (mTLS) AuthService (mTLS opzionale) DMS | Azioni XSI Azioni XSI (mTLS) XSI-Eventi CTI (mTLS) Servizio di autenticazione (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 | Scarica e installa Webex. Per informazioni dettagliate, vedi Webex | Download dell'app. |
2 | Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 | Inserisci l'indirizzo e-mail e fai clic su Avanti. |
4 | Una delle seguenti operazioni si verifica, a seconda del modo in cui l'organizzazione è configurata in Webex: Webex si carica dopo aver eseguito correttamente l'autenticazione su IdP o BroadWorks.
|
Scambio e archiviazione dati
Queste sezioni forniscono dettagli sullo scambio e la memorizzazione dei dati con Webex. Tutti i dati vengono crittografati sia in transito che a riposo. Per ulteriori informazioni, vedi Webex App Security.
Onboarding provider servizi
Quando si configurano cluster e modelli utente in Webex Control Hub durante l'onboarding di provider di servizi, è possibile scambiare i seguenti dati BroadWorks memorizzati in Webex:
URL Xsi-Actions
URL Xsi-Events
URL interfaccia CTI
URL servizio di autenticazione
Credenziali adattatore di provisioning BroadWorks
Provisioning utente provider di servizi
Questa tabella elenca i dati utente e aziendale che vengono scambiati come parte del provisioning utente attraverso le API Webex.
Trasferimento dei dati in Webex | Da | Attraverso | Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito da SP) | BroadWorks, per API | API Webex | Sì |
E-mail (se fornito dall’utente) | Utente | Portale di attivazione utente | Sì |
Nome | BroadWorks, per API | API Webex | Sì |
Cognome | BroadWorks, per API | API Webex | Sì |
Numero di telefono principale | BroadWorks, per API | API Webex | Sì |
Numero telefono cellulare | BroadWorks, per API | API Webex | Sì |
Estensione principale | BroadWorks, per API | API Webex | Sì |
ID provider di servizi BroadWorks e ID gruppo | BroadWorks, per API | API Webex | Sì |
Lingua | BroadWorks, per API | API Webex | Sì |
Fuso orario | BroadWorks, per API | API Webex | Sì |
Rimozione utente
Le API Webex per Cisco BroadWorks supportano la rimozione parziale e completa dell'utente. Questa tabella elenca tutti i dati utente memorizzati durante il provisioning e ciò che viene eliminato in ogni scenario.
Dati utente | Eliminazione parziale | Eliminazione completa |
---|---|---|
ID utente BroadWorks | Sì | Sì |
No | Sì | |
Nome | No | Sì |
Cognome | No | Sì |
Numero di telefono principale | Sì | Sì |
Numero telefono cellulare | Sì | Sì |
Estensione | Sì | Sì |
ID provider di servizi BroadWorks e ID gruppo | Sì | Sì |
Lingua | No | Sì |
Accesso utente e recupero configurazione
Autenticazione Webex
L'autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da uno qualsiasi dei meccanismi di autenticazione del supporto Webex. (L'autenticazione BroadWorks è trattata separatamente.) Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (indipendente) | Webex | Browser utente |
Credenziali utente | Browser utente | Provider identità (che dispone già di identità utente) |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Autenticazione BroadWorks
L'autenticazione BroadWorks si riferisce all'accesso dell'utente a un'app Webex utilizzando le credenziali BroadWorks. Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati | Da | Per |
---|---|---|
Indirizzo e-mail | Utente attraverso l'app Webex | Webex |
Token di accesso limitato e URL IdP (proxy Webex Bwks IdP) | Webex | Browser utente |
Informazioni sul branding e URL BroadWorks | Webex | Browser utente |
Credenziali utente BroadWorks | Utente tramite browser (pagina di accesso con marchio servita da Webex) | Webex |
Credenziali utente BroadWorks | Webex | BroadWorks |
Profilo utente BroadWorks | BroadWorks | Webex |
asserzione SAML | Browser utente | Webex |
Codice di autenticazione | Webex | Browser utente |
Codice di autenticazione | Browser utente | Webex |
Token di accesso e aggiornamento | Webex | Browser utente |
Token di accesso e aggiornamento | Browser utente | App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento dell'avviso di accesso e del messaggio di errore:
- Attualmente gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso poiché la password è già scaduta. Con questa funzione, se la password sta per scadere tra 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere, con l'indicazione di quanti giorni rimangono, e all'utente viene consigliato di contattare il partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su true, è stato emesso l'errore "nome utente e password errati", ma ora con questa funzione viene migliorato il messaggio di errore: Tentativo di accesso non riuscito. La combinazione di ID utente e password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice errore 100006
Controllo flusso di accesso:
- Il partner può limitare l'accesso abilitando un'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione in broadworks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, quindi viene visualizzato un errore che indica che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso può essere configurato dal partner come parte della funzione di personalizzazione avanzata. I partner solitamente configurano il collegamento per passare dall'utente a un portale partner per la gestione della password e la reimpostazione della password.
Questa funzione migliora l'esperienza di accesso utente solo durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se una password scade mentre l'utente è connesso all'app Webex. L'utente riceve la notifica di scadenza della password al successivo tentativo di accesso. |
Recupero configurazione cliente
Questa tabella illustra la tipologia di dati scambiati tra le diverse componenti in fase di recupero delle configurazioni del cliente.
Trasferimento dei dati | Da | Per |
---|---|---|
Iscrizione | Client | Webex |
Impostazioni organizzazione, inclusi URL BroadWorks | Webex | Client |
Token JWT BroadWorks | BroadWorks attraverso Webex | Client |
Token JWT BroadWorks | Client | BroadWorks |
Token dispositivo | BroadWorks | Client |
Token dispositivo | Client | BroadWorks |
File di configurazione | BroadWorks | Client |
Utilizzo allo stato stazionario
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione dopo la scadenza del token, tramite BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Trasferimento dei dati | Da | Per |
---|---|---|
Segnalazione SIP | Client | BroadWorks |
Supporto SRTP | Client | BroadWorks |
Segnalazione SIP | BroadWorks | Client |
Supporto SRTP | BroadWorks | Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Trasferimento dei dati | Da | Per |
---|---|---|
Messaggistica e presenza REST HTTPS | Client | Webex |
Messaggistica e presenza REST HTTPS | Webex | Client |
Segnalazione SIP | Client | Webex |
Supporto SRTP | Client | Webex |
Segnalazione SIP | Webex | Client |
Supporto SRTP | Webex | Client |
Uso dell'API di provisioning
Accesso sviluppatore
Le specifiche API sono disponibili su https://developer.webex.com e una guida all'uso è disponibile su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l' accedere per leggere la specifica API all'indirizzohttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Autenticazione e autorizzazione applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (ad esempio provisioning abbonato) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere l'aggiornamento e l'accesso ai token per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
Devi prima registrare la tua integrazione con Webex. Una volta eseguita la registrazione, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di accesso e aggiornamento necessari.
Per ulteriori dettagli sulle integrazioni e sulle modalità di creazione di questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli obbligatori per l'implementazione delle integrazioni: sviluppatore e utente autorizzatore, che possono essere svolti da persone/team separati nel proprio ambiente.
|
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning utilizzata:
Modalità Enterprise: il nome dell'organizzazione corrisponde esattamente a spEnterpriseId.
Modalità provider di servizi: il nome dell'organizzazione è la parte groupID di spEnterpriseId.
Il nome dell'organizzazione conterrà qualsiasi spazio vuoto, maiuscolo e caratteri speciali specificati in spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "attuale" con le ultime patch BroadWorks e le app Release Independent (RI). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Assicurarsi di rivedere le note di patch per queste patch software. Alcune patch potrebbero avere requisiti CLI aggiuntivi. |
Versione R22
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | ||
Richiesto per sincronizzazione rubrica | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per il server applicazioni | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per la funzione di registrazione chiamata | ||
Patch richiesta per il provisioning flow-through | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | Richiesto per proxy autenticazione NPS | |
Richiesto per il servizio di autenticazione con convalida token CI | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Obbligatorio per la cronologia chiamate unificata | ||
Altro | AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Richiesto per sincronizzazione rubrica | |
Configurazione server app | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Server profilo | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
XSP|ADP | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Se si utilizza ADP... | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Versione R24
Server | Cerotto | Informazioni aggiuntive |
---|---|---|
Server applicazioni | Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per il provisioning flowthrough | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato hook (Presence) e cronologia chiamate unificate | ||
Altro | Patch richiesta per stato hook (Presence) e cronologia chiamate unificate |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che è necessario configurare per Webex, fare riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utente e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. L'attivazione include la convalida e-mail e l'assegnazione del servizio in Webex. |
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se disponi di indirizzi e-mail affidabili per gli utenti, puoi scegliere di attivarli automaticamente quando esegui il provisioning automatico degli utenti. Questo processo è "provisioning automatico e attivazione automatica".
Provisioning utente automatizzato e attivazione automatica (flusso e-mail affidabile)
Prerequisiti
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase | Descrizione |
---|---|
1 | Citare e prendere ordini per il servizio con i clienti. |
2 | Si elabora l'ordine del cliente e si esegue il provisioning del cliente nei sistemi. |
3 | Il sistema di provisioning dei servizi attiva il provisioning di BroadWorks. Questo passaggio, in sintesi, crea l'azienda e gli utenti. Quindi assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM&P esterno. |
4 | Questo passaggio di provisioning attiva il provisioning automatico dell'organizzazione cliente e degli utenti in Webex. (L'assegnazione del servizio IM&P determina che l'adattatore di provisioning chiami l'API di provisioning Webex). |
5 | I sistemi devono utilizzare l'API di provisioning Webex se successivamente è necessario regolare il pacchetto per l'utente (per passare dall'impostazione predefinita). |
Flusso di accesso SSO
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, che consente l'autenticazione diretta a BroadWorks. L'immagine mostra gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresenta ciò che il client prevede per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizio BroadWorks che segue immediatamente il flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione BroadWorks diretta abilitata (condivisione risorse cross-origin). Di seguito sono riportati alcuni flussi di accesso SSO SAML alternativi:
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
L'unica differenza è nei punti 5 e 6 del flusso di accesso Webex. Nel passaggio 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
Il flusso procede attraverso i restanti passaggi dei due diagrammi.
Il token SSO non viene utilizzato in questo flusso.
Autenticazione SSO SAML Webex:
Nel passaggio 3 del flusso di accesso Webex, il servizio Common Identity restituisce il provider di identità utilizzato dall'autenticazione Webex.
A questo punto, viene invocato un flusso di accesso SSO SAML alternativo per Webex.
Interazioni utente
Accedi
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
CI rileva che l'organizzazione cliente associata dispone del proxy IDP BroadWorks (IDP) configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso (il provider di servizi può contrassegnare questa pagina di accesso).
L'utente inserisce le credenziali BroadWorks.
Broadworks esegue l'autenticazione dell'utente attraverso l'IDP. In caso di successo, l'IDP reindirizza il browser a CI con un SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
Una volta completata l'autenticazione, l'app Webex ottiene i token di accesso da CI (non mostrati nel diagramma). Il client li utilizza per richiedere un token Web Jason (JWT) di lunga durata BroadWorks.
L'app Webex rileva la configurazione di chiamata da BroadWorks e altri servizi da Webex.
L'app Webex si registra in BroadWorks.
Accesso dalla prospettiva dell'utente
Questo diagramma è il tipico flusso di accesso, visualizzato dall'utente finale o dall'abbonato:
Scarica e installa l'app Webex.
È possibile che tu abbia ricevuto il collegamento dal provider di servizi o che tu possa trovare il download nella pagina di download di Webex.
Inserire l'indirizzo e-mail nella schermata di accesso Webex. Fai clic su Avanti.
Solitamente, si viene reindirizzati a una pagina con il marchio del fornitore di servizi.
Questa pagina potrebbe accogliervi tramite il vostro indirizzo e-mail.
Se non è presente alcun indirizzo e-mail o se l'indirizzo e-mail è errato, inserisci il nome utente BroadWorks.
Inserisci la password BroadWorks.
Se è stato eseguito correttamente l'accesso, Webex si apre.
Flusso chiamate - Rubrica aziendale
Flusso chiamata: numero PSTN
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni con i clienti
Recupero del profilo dal registro DMS e SIP con AS
Il client chiama XSI per ottenere un token di gestione dispositivo e l'URL del DMS.
Il client richiede il proprio profilo dispositivo dal DMS presentando il token dal punto 1.
Il client legge il profilo del dispositivo e recupera le credenziali, gli indirizzi e le porte SIP.
Il Client invia un REGISTRO SIP a SBC utilizzando le informazioni dal punto 3.
SBC invia il REGISTRO SIP al SA (l'SBC può eseguire una ricerca nell'NS per individuare un SA se il SBC non conosce già l'utente SIP).
Linee guida per test e laboratorio
Le seguenti linee guida si applicano alle organizzazioni di test e laboratorio:
I partner provider di servizi sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
Tutti gli utenti oltre i primi 50 utenti di test verranno fatturati.
Per garantire un'elaborazione accurata sulla fattura, tutte le organizzazioni di test devono includere il "test" nel nome dell'organizzazione BroadWorks.
Le organizzazioni di test interni devono essere designate all'interno di Webex Control Hub. Ciò al fine di impedire agli utenti di test di essere fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di prova:
Accedi a Partner Hub e seleziona Clienti.
Selezionare il cliente appropriato.
Nella barra di controllo destra, abilitare il tasto di alternanza Organizzazione test interni.
Riproduzione casella vocale
Per la casella vocale, accertarsi di configurare il server multimediale per utilizzare uno dei seguenti codici:
mp3
wav: i file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android
Se si utilizzano i file wav, eseguire i seguenti comandi CLI per configurare il server applicazioni e il server multimediale:
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACIDITÀ
- Elenco di controllo accessi
- ALVEOLO
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APICI
- Servizio di notifica push Apple
- AS
- Server applicazioni
- ATA
- Adattatore per telefono analogico, adattatore che converte la telefonia analogica in VoIP
- BAMBOLA
- Gestione applicazioni BroadSoft
- Autenticazione base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- ALVEOLARE
- Server di messaggistica BroadSoft
- PALUDE
- Flussi bidirezionali Su HTTP sincrono
- BRI
- Basic Rate Interface BRI è un metodo di accesso ISDN
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico telefonico (cfr. partner, provider di servizi, rivenditore a valore aggiunto)
- CAPTCHA
- Test di Turing pubblico completamente automatizzato per distinguere Computer ed Esseri Umani
- CCXML
- Linguaggio di markup eXtensible controllo chiamate
- CIF
- Formato intermedio comune
- CLI
- Interfaccia riga di comando
- CN
- Nome comune
- CNPS
- Server push notifiche chiamate. Un server push notifiche che viene eseguito su un ADP XSP| nel proprio ambiente per eseguire notifiche di chiamata push su FCM e APNS. Vedere il proxy NPS.
- CPE
- Attrezzatura della sede del cliente
- CPR
- Regola presenza personalizzata
- CENERE
- Foglio stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione telefonia computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- NoDist
- Non disturbare
- DNS
- Sistema dei nomi di dominio
- DPG
- Chiama gruppo di pari
- DSCP
- Punto codice servizi differenziati
- DTAF
- File di archivio tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza a doppia tonalità
- Utente finale
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. Sottoscrittore)
- Aziendale
- Una raccolta di utenti finali (cfr. Organizzazione)
- FUSO
- Messaggistica cloud Firebase
- DI FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creare utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning completo flow-through
- Creare e verificare gli utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks e asserendo che ciascun utente BroadWorks dispone di un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. È la spina sul telefono o fax o i connettori sul sistema telefonico analogico. Fornisce un'indicazione di aggancio/aggancio sganciato (chiusura con loop). Poiché la porta FXO è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo FXO".
- FXS
- Foreign Exchange Subscriber è la porta che effettivamente fornisce la linea analogica all'abbonato. In altre parole, è la "spina nella parete" che fornisce un segnale di linea, corrente della batteria e tensione della suoneria.
- GABBIA
- Messaggio cloud Google
- GABBIA
- Modalità Galois/Counter (tecnologia di crittografia)
- HID
- Dispositivo interfaccia uomo
- HTTPS
- Prese protette da protocollo di trasferimento ipertestuale
- IAD
- Dispositivo di accesso integrato
- IM&P
- messaggistica istantanea e presenza
- PSTN IP
- Un provider di servizi che fornisce VoIP ai servizi PSTN, intercambiabile con ITSP, o un termine generale per la telefonia "pubblica" connessa a Internet, fornito collettivamente dai principali provider di telecomunicazioni (piuttosto che dai paesi, come è PSTN)
- ITSP
- Provider servizi di telefonia Internet
- IVR
- Risposta vocale/risponditore interattiva
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificatore Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notazione oggetto script Java
- JESS
- Java Secure Socket Extension; la tecnologia sottostante che fornisce funzioni di connettività sicure ai server BroadWorks
- KEM
- Modulo interno chiave (telefoni Cisco hardware)
- LLT
- Token di lunga durata (o Long Life): token di connessione autodescrittivo e sicuro che consente agli utenti di rimanere autenticati più a lungo e non è legato ad applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIGLIO
- Base di informazioni di gestione
- AVV.
- Server multimediale
- mTLS
- Autenticazione reciproca tra due parti, tramite scambio di certificati, quando si stabilisce una connessione TLS
- MUCO
- Chat con più utenti
- NAT
- Traduzioni dell'indirizzo di rete
- NPS
- Server push notifica; vedere CNPS
- Proxy NPS
-
Un servizio in Webex che fornisce token di autorizzazione di breve durata al CNPS, consentendo di eseguire notifiche di chiamata push a FCM e APN e, in ultima analisi, a dispositivi Android e iOS con Webex.
- ASSOCIAZIONE
- Apri interfaccia client
- Organizzazione
- Società o organizzazione che rappresentano un insieme di utenti finali (cfr. Impresa)
- OTG
- Gruppo di trunk in uscita
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- Partner
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. rivenditore a valore aggiunto, fornitore di servizi, gestore telefonico)
- PBX
- Borsa filiale privata
- DELLA SOCIETÀ
- E-mail avanzata per la privacy
- PIEDINO
- Rete mobile terrestre pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia per le telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- P.ES.
- Server profilo
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Sito web che consente all’amministratore del rivenditore di configurare la soluzione UC-One SaaS. Talvolta viene indicato come portale BAM, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Revisore di frontiera sessione
- CEMENTAZIONE
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; un'organizzazione che fornisce servizi di telefonia o correlati ad altre organizzazioni (cfr. vettore, partner, rivenditore a valore aggiunto)
- SIP
- Protocollo di avvio sessione
- SLITTA
- Token di breve durata (o Short Life) (chiamato anche BroadWorks SSO Token); token autenticato monouso utilizzato per accedere in sicurezza ad applicazioni Web.
- ODORE
- Piccole e medie imprese
- SNMP
- Protocollo di gestione di rete semplice
- sRTCP
- protocollo di controllo trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- sRTP
- protocollo di trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- SSL
- Strato di prese sicure
- Abbonato
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. utente finale)
- TCP
- Protocollo di controllo del cambio
- TDM
- Divisione Tempo Multiplexing
- TLS
- Sicurezza livello trasporto
- ToS
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Comunicazioni unificate
- UI
- Interfaccia utente
- U ID
- Identificativo univoco
- MUTI
- Server di messaggistica
- URI
- Identificativo risorsa uniforme
- URL
- Ricerca risorse uniformi
- DISTURBO
- Condivisione server
- UTC
- Coordinated Universal Time
- UVS.
- Server video
- Rivenditore a valore aggiunto (VAR)
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. vettore, partner, fornitore di servizi)
- VAMPATA
- Array di grafica video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Linguaggio di markup estensibile vocale
- WebDAV
- Creazione e versioni distribuite su Web
- WebRTC
- Comunicazioni Web in tempo reale
- WRS
- Server WebRTC
- XMPP
- Protocollo di presenza e messaggistica estendibile
Configurazione dei servizi (con mTLS per il servizio autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida token CI. Queste procedure sono obbligatorie se si stanno eseguendo più organizzazioni Webex dallo stesso server ADP XSP|. In caso contrario, sono facoltativi.
Se non si eseguono più organizzazioni Webex sullo stesso server ADP XSP|, si consiglia la convalida del token CI (con TLS) per il servizio di autenticazione. Fare riferimento a Configura servizi su Webex per Cisco BroadWorks XSP|ADPs per informazioni dettagliate su come configurare il servizio di autenticazione e altri servizi. |
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con mTLS)
I token longevi di BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sui tuoi XSP|ADP.
Requisiti
I server XSP|ADP che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
XSP|ADP devono condividere le stesse chiavi per crittografare/decrittografare token di lunga durata BroadWorks. Copiare queste chiavi in ogni XSP|ADP è un processo manuale.
Gli ADP XSP|devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli XSP|ADP include:
Distribuire il servizio di autenticazione.
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
Generare e condividere le chiavi RSA su XSP|ADP.
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ogni XSP|ADP utilizzato con Webex:
Attivare l'applicazione del servizio di autenticazione sul percorso
/authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService
(dove
<version>
è la versione BroadWorks).Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
deploy application /authService
Configurazione della durata del token
Verificare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
Impostare la durata su 60 giorni (max 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
set tokenDurationInHours 1440
Genera e condividi chiavi RSA
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori è necessario generare chiavi su un XSP|ADP quindi copiarle su tutti gli altri XSP|ADP.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP. |
Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
Copia il file esportato
/var/broadworks/tmp/authService.keys
alla stessa posizione sulle altre ADP XSP|, sovrascrivendo una vecchia.keys
file, se necessario.Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web
Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token.
Su ciascuna delle ADP XSP|:
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
Controllare il parametro con
get
.Riavviare XSP|ADP.
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
Inserisci il
get
comandare e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
Inserisci il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati su questa interfaccia.Inserisci il comando
add <interfaceIp> 443 TLSv1.2
per garantire che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
Inserisci il comando
get <interfaceIp> 443
per vedere quali crittografie sono già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview).Inserisci il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizzerebbe:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità per il servizio di autenticazione (con mTLS)
Accedi a Control Hub con l'account amministratore del partner.
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori.Suddividere la catena dei certificati in due certificati:
combinedcertchain2023.txt
.Apri
combinedcertchain2023.txt
in un editor di testo.Selezionare e tagliare il primo blocco di testo, incluse le linee
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file.Salva il nuovo file come
root2023.txt
.Salvare il file originale come
issuing2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
.Accedere a XSP|ADP e andare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Esegui GuidaUpdateTrust
per visualizzare i parametri e il formato di comando.Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot2023
,webexclientissuing
ewebexclientissuing2023
sono esempi di alias per gli ancoraggi di fiducia; è possibile utilizzare il proprio purché tutte e quattro le voci siano uniche.Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, è richiesto mTLS per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/HttpServer>
e eseguire ilget
comando per visualizzare le interfacce.Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che significa come mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. In sostanza, il primo
true
protegge l'interfaccia con TLS (il certificato del server viene creato se richiesto) e la secondatrue
forza l'interfaccia a richiedere l'autenticazione del certificato del client (insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Interface Port Name Secure Client Auth Req Cluster Fqdn
=======================================================
192.0.2.7 443 XSP|ADP01.collab.example.net true false
192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (autenticazione client richiesta = true) è abilitato il 192.0.2.7
porta 444
. TLS abilitato su 192.0.2.7
porta 443
.
(Opzione) Configurazione di mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, è necessario mTLS per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
Passa a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
e eseguire ilget
per visualizzare le applicazioni in esecuzione.Per aggiungere un'applicazione e richiederne l'autenticazione client (ovvero mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. I nomi delle applicazioni sono elencati qui. Il
true
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
add 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService a 192.0.2.7:443 e richiede di richiedere e autenticare i certificati dal client.
Verifica con get
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
get
Interface Ip Port Application Name Client Auth Req
===================================================
192.0.2.7 443 AuthenticationService true
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Dove andare Avanti
Per la configurazione, è possibile accedere nuovamente al flusso dei documenti principale all'interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca rispetto a AuthService
Webex interagisce con il servizio di autenticazione su una connessione TLS autenticata reciproca. Ciò significa che Webex presenta un certificato client e che XSP|ADP deve convalidarlo. Per garantire l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora attendibile su XSP|ADP (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
Vai a Impostazioni > BroadWorks Calling.
Fare clic sul collegamento del certificato di download.
È inoltre possibile scaricare la catena di certificati da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt. |
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
Tramite un proxy di bridging TLS
Tramite un proxy passante TLS
Direttamente a XSP|ADP
Il diagramma seguente riassume dove deve essere distribuita la catena di certificati CA Webex in questi tre casi.
Requisiti del certificato TLS reciproco per proxy bridge TLS
Webex presenta un certificato client firmato da CA Webex al proxy.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità proxy, pertanto il proxy considera attendibile il certificato del client.
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
Il proxy presenta un certificato server firmato pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
X509v3 extensions:
X509v3 Extended Key Usage:
1.3.6.1.4.1.6431.1.1.8.2.1.3, TLS Web Client Authentication
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
Le ADP XSP|si fidano delle autorità di certificazione interne.
Gli ADP XSP|presentano un certificato del server firmato internamente.
Il proxy si fida della CA interna.
Requisiti di certificato TLS reciproco per proxy passthrough TLS o XSP in DMZ
Webex presenta un certificato client firmato da CA Webex agli XSP.
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità degli XSP, pertanto gli XSP si affidano al certificato client.
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
Gli XSP presentano certificati server firmati pubblicamente a Webex.
Webex considera attendibile la CA pubblica che ha firmato i certificati server degli XSP.
Cronologia revisioni documenti
La tabella seguente mostra lo storico delle modifiche apportate a questo documento negli ultimi 12 mesi.
Data | Versione | Descrizione della modifica | |
---|---|---|---|
25 giugno 2024 | 2-120 |
| |
14 giugno 2024 | 2-119 |
| |
13 maggio 2024 | 2-118 |
| |
10 maggio 2024 | 2-117 |
| |
6 maggio 2024 | 2-116 |
| |
2 maggio 2024 | 2-115 |
| |
10 aprile 2024 | 2-114 |
| |
27 marzo 2024 | 2-113 |
| |
22 marzo 2024 | 2-112 |
| |
7 marzo 2024 | 2-111 |
| |
24 febbraio 2024 | 2-110 |
| |
20 febbraio 2024 | 2-109 |
| |
7 febbraio 2024 | 2-108 |
| |
25 gennaio 2024 | 2-107 |
| |
23 gennaio 2024 | 2-106 |
| |
10 gennaio 2024 | 2-105 |
| |
20 dicembre 2023 | 2-104 |
| |
13 dicembre 2023 | 2-103 |
| |
12 dicembre 2023 | 2-102 |
| |
8 dicembre 2023 | 2-101 |
| |
08 novembre 2023 | 2-100 |
| |
25 ottobre 2023 | 2-99 |
| |
13 settembre 2023 | 2-98 |
| |
04 settembre 2023 | 2-97 |
| |
08 agosto 2023 | 2-96 |
| |
23 giugno 2023 | 2-95 |
| |
30 maggio 2023 | 2-94 |
| |
26 maggio 2023 | 2-93 |
| |
24 maggio 2023 | 2-92 |
| |
10 maggio 2023 | 2-91 |
| |
09 maggio 2023 | 2-90 |
| |
4 maggio 2023 | 2-89 |
| |
27 aprile 2023 | 2-88 |
| |
14 aprile 2023 | 2-87 |
| |
17 marzo 2023 | 2-86 |
| |
11 marzo 2023 | 2-85 |
| |
10 marzo 2023 | 2-84 |
| |
7 marzo 2023 | 2-83 |
| |
28 febbraio 2023 | 2-82 |
| |
15 febbraio 2023 | 2-81 |
| |
10 febbraio 2023 | 2-80 |
| |
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione fornisce agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei clienti o forniscono questa soluzione direttamente ai relativi abbonati.
Scopo soluzione
-
Per fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che dispongono già del servizio di chiamata fornito dai provider di servizi BroadWorks.
-
Per fornire il servizio di chiamata basato a BroadWorks a clienti Webex piccoli e medi.
Contesto
In continua continua evoluzione di tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo impegno è spostare le funzionalità di chiamata BroadWorks nell'app Webex e ridurre l'investimento nei client UC-One.
Benefici
-
Prova futura: di fronte all'end-of-life di UC-One Collaborate, movimento di tutti i clienti verso il Unified Client Framework (UCF)
-
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex e conservazione delle chiamate BroadWorks sulla rete di telefonia
Ambito soluzione
-
I clienti esistenti/nuovi e medi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre della chiamata BroadWorks.
-
I clienti Webex esistenti, da piccoli a medi, desiderano aggiungere la chiamata BroadWorks.
-
Non aziende più grandi (ti prego di esaminare il nostro portfolio Enterprise per Webex).
-
Non i singoli utenti (valutare le offerte Webex online).
Le serie di funzioni in Webex per Cisco BroadWorks hanno come obiettivo casi d'uso di piccola e media attività. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità dei sistemi SME e ne valutiamo costantemente l'idoneità per questo segmento. È possibile scegliere di nascondere o rimuovere funzioni altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# |
Requisito |
Note | ||
---|---|---|---|---|
1 |
Patch Current BroadWorks R22 or above | |||
2 |
XSP|ADP for XSI, CTI, DMS, and authService |
Dedicated XSP|ADP for Webex for Cisco BroadWorks | ||
3 |
Separate XSP|ADP for NPS, can be shared with other solutions that use NPS. |
If you have an existing collaborate deployment, then review recommendations on XSP|ADP and NPS configurations. | ||
4 |
Convalida token CI (con TLS) configurato per connessioni Webex al servizio di autenticazione. | |||
5 |
mTLS configurato per le connessioni Webex all'interfaccia CTI. |
Altre applicazioni non richiedono mTLS. | ||
6 |
Gli utenti devono esistere in BroadWorks e necessitano dei seguenti attributi, in base alla propria decisione di provisioning:
|
Per e-mail affidabili: Si consiglia di inserire lo stesso indirizzo e-mail nell'attributo ID alternativo anche per consentire agli utenti di accedere con indirizzo e-mail per BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'utilizzo di messaggi e-mail non attendibili può inviare il messaggio e-mail alla cartella della posta indesiderata o dello SPAM dell'utente. L'amministratore potrebbe aver modificato le impostazioni e-mail dell'utente per consentire i domini | ||
7 |
File DTAF Webex per Cisco BroadWorks per l'app Webex | |||
8 |
BW Business Lic o Std Enterprise o Prem Enterprise User Lic + Webex per l'abbonamento Cisco BroadWorks |
Se è già presente una distribuzione di collaborazione esistente, non è più necessario il bundle aggiuntivo UC-One, la collaborazione Lic e le porte della conferenza Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non è necessario apportare ulteriori modifiche se non si accettano i termini del pacchetto Premium. | ||
9 |
L'indirizzo IP/porte deve essere accessibile attraverso i servizi back-end Webex e le app Webex su Internet pubblico. |
Vedere la sezione "Preparazione della rete". | ||
10 |
TLS v1.2 Configuration on XSP|ADPs | |||
11 |
Per il provisioning Flowworks, il server dell'applicazione deve connettersi all'adattatore di provisioning BroadWorks.
|
Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è comprendere, preparare, distribuire e gestire la soluzione Webex per Cisco BroadWorks. Le sezioni principali del documento riflettono questo scopo.
Questa guida include informazioni concettuali e materiale di riferimento. Intendiamo coprire tutti gli aspetti della soluzione in questo documento.
La serie minima di attività per la distribuzione della soluzione è la seguente:
-
Raggiungere il team dell'account per diventare un partner Cisco. È obbligatorio esplorare i punti di contatto Cisco per acquisire familiarità (ed essere addestrati). Quando si diventa un partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuire Webex per Cisco BroadWorks > onboarding dei partner in questo documento).
-
Configurare i sistemi BroadWorks per l'integrazione con Webex. (See Deploy Webex for Cisco BroadWorks > Configure Services on Your Webex for Cisco BroadWorks XSP|ADPs in this document.)
-
Utilizzare Partner Hub per collegare Webex a BroadWorks. Vedere Distribuire Webex per Cisco BroadWorks > l'organizzazione partner in Partner Hub in questo documento.
-
Utilizzare Partner Hub per preparare i modelli di provisioning utente. (See Deploy Webex for Cisco BroadWorks > Configure your Onboarding templates in this document.)
-
Test and onboard a customer by provisioning at least one user. (See Deploy Webex for Cisco BroadWorks > Configure Your Test Organization.)
|
Terminologia
We try to limit the jargon and acronyms used in this document, and to explain each term when it’s first used. (See Webex for Cisco BroadWorks Reference > Terminology if a term isn’t explained in context.)
Funzionamento
Webex per Cisco BroadWorks è un'offerta che integra la chiamata BroadWorks in Webex. Gli abbonati utilizzano una singola applicazione (app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
-
Gli utenti chiamano PSTN numeri di telefono utilizzando l'infrastruttura BroadWorks.
-
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino per introdurre i numeri).
-
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Webex Call" nell'app Webex ( queste chiamate sono app Webex all'app Webex, non all'app Webex PSTN).
-
Gli utenti possono ospitare e partecipare Webex Meetings.
-
Gli utenti possono inviare messaggi l'uno all'altro o negli spazi (chat di gruppo persistente) e usufruire delle funzioni di ricerca e condivisione di file (su infrastruttura Webex).
-
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
-
Dopo averci asserto come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare il rapporto tra l'istanza BroadWorks e Webex.
-
È possibile creare organizzazioni dei clienti in Control Hub e pres effettuare il provisioning degli utenti in tali organizzazioni.
-
Ciascun abbonato in BroadWorks ottiene un'identità Webex in base al relativo indirizzo e-mail (attributo ID e-mail in BroadWorks).
-
Gli utenti eseguono l'autenticazione per BroadWorks o per Webex.
-
I client vengono emessi con token a lungo termine per autorizzarli per i servizi presso BroadWorks e Webex.
L'app Webex al centro di questa soluzione; è un'applicazione che può essere brandable disponibile su desktop Mac/Windows e su dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include le funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzioni di messaggistica, presenza e riunione.
Il client si registra ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i sistemi BroadWorks per garantire un'esperienza di provisioning utente ottimale.
Funzioni e limitazioni
Sono disponibili diversi pacchetti con diverse funzioni.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano un utente tramite softphone, i risultati della ricerca non forniscono alcuna opzione per l'invio di un messaggio.
Gli utenti softphone possono condividere lo schermo durante una chiamata.
Pacchetto "Base"
The basic package includes Calling, Messaging, and Meeting features. It includes 100 participants in “unified space” meetings and Personal Meeting Room (PMR) meetings. (** see the below Note for exception). In this package the meetings can have a maximum duration of 40 minutes.
Pacchetto "standard"
This package also includes everything in the Basic package such as up to 100 participants in “unified space” meetings and Personal Meeting Room (PMR) meetings.
La condivisione dello schermo all'interno di una riunione PMR ha inizialmente un ruolo svolto solo dall'organizzatore della riunione, ma l'organizzatore può passare il 'ruolo di relatore' a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può assumere nuovamente il ruolo di relatore senza che venga passato dall'ospite corrente.
Pacchetto "Premium"
This package includes everything in the Standard package plus up to 300 participants in “unified space” meeting and up to 1000 participants in a Personal Meeting Room (PMR).
La condivisione dello schermo all'PMR di un evento è supportata per qualsiasi partecipante.
Confronta pacchetti
Pacchetto |
Chiamata |
Messaggistica |
Unified Space Meetings |
PMR riunioni |
---|---|---|---|---|
Softphone |
Incluso |
Non incluso |
Nessuno |
Nessuno |
Base |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Standard |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Premium |
Incluso |
Incluso |
300 partecipanti |
1000 partecipanti |
The Unified Space Meeting limit for Basic users is 100 participants per Unified Space Meeting unless the space also includes users assigned the “Standard” or “Premium” packages, in which case the limit increases based on host user package. |
"Unified Space Meetings" refers to a Webex meeting (scheduled or unscheduled) that takes place in a Webex space. For example, a user initiates a meeting from the space via the "Meet" or "Schedule" buttons. "PMR Meetings" refers to a Webex Meeting (scheduled or unscheduled) that takes place in a user's Personal Meeting Room (PMR). These meetings use a dedicated URL (for example: cisco.webex.com/meet/roomOwnerUserID). |
Funzioni di messaggistica e riunione
Refer to the following table for PMR meeting feature support differences for Basic, Standard and Premium packages.
Funzione riunione |
Supported with Basic Package |
Soportato con il pacchetto standard |
Supportato con pacchetto Preminum |
Commento |
---|---|---|---|---|
Durata riunione |
40 Minutes or less |
Illimitato |
Illimitato | |
Condivisione desktop |
Sì |
Sì |
Sì |
Basic—Desktop sharing by any PMR meeting participant. Standard —Desktop sharing by PMR meeting host only. Premium—Desktop sharing by any PMR meeting participant. |
Condivisione di un'applicazione |
Sì |
Sì |
Sì |
Basic—Application sharing by any PMR meeting participant. Standard —Application sharing by PMR meeting host only. Premium—Application sharing by any PMR meeting participant. |
Chat tra più parti |
Sì |
Sì |
Sì | |
Lavagna |
Sì |
Sì |
Sì | |
Protezione password |
Sì |
Sì |
Sì | |
App Web - nessun download o plug-in (esperienza ospite) |
Sì |
Sì |
Sì | |
Supporta accoppiamento con dispositivi Webex |
Sì |
Sì |
Sì | |
Controllo piano (disattiva audio di uno / Espelle tutti) |
Sì |
Sì |
Sì | |
Collegamento Riunioni permanenti |
Sì |
Sì |
Sì | |
Acces. sito per riunioni |
Sì |
Sì |
Sì | |
Accesso alla riunione tramite VoIP |
Sì |
Sì |
Sì | |
Blocco |
Sì |
Sì |
Sì | |
Controlli relatore |
No |
No |
Sì | |
Controllo desktop remoto |
No |
No |
Sì | |
Numero di partecipanti |
100 |
100 |
1000 | |
Registrazione salvata in locale nel sistema |
Sì |
Sì |
Sì | |
Registrazione nel cloud |
No |
No |
Sì | |
Registrazione - Storage su cloud |
No |
No |
10GB per site | |
Trascrizione delle registrazioni |
No |
No |
Sì | |
Pianificazione riunione |
Sì |
Sì |
Sì | |
Abilita condivisione del contenuto con integrazioni esterne |
No |
No |
Sì |
Basic— Content sharing by any PMR meeting participant. Standard—Content sharing by PMR meeting host only. Premium—Content sharing by any PMR meeting participant. |
Consenti PMR modifica dell'URL |
No |
No |
Sì |
Basic— Users can modify the PMR URL from the Webex site. Partner and org admins can modify the URL from Control Hub. Standard—The PMR URL can be changed only from Partner Hub by Partner and org admins. Premium—Users can modify the PMR URL from the Webex site. Gli amministratori di partner e organizzazioni possono modificare l'URL da Partner Hub. |
Riunioni in streaming in diretta (ad esempio, su Facebook, Youtube) |
No |
No |
Sì | |
Consentire ad altri utenti di pianificare le riunioni per proprio conto |
No |
No |
Sì | |
Aggiungi organizzatore alternativo |
Sì |
No |
Sì | |
Integrazione delle app (es. Zendesk, Slack) |
Dipende dall'integrazione |
Dipende dall'integrazione |
Sì |
Vedere la sezione Integrazioni delle app di seguito per ulteriori informazioni sul supporto. |
Integrazione con il calendario Microsoft Office 365 |
Sì |
Sì |
Sì | |
Integrazione con Google Calendaring per G Suite |
Sì |
Sì |
Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione per l'utente per Webex all'help.webex.com
. Leggere i seguenti articoli per ulteriori informazioni sulle funzioni:
Funzioni di chiamata
L'esperienza di chiamata è simile a quelle precedenti che utilizzano il motore di controllo chiamate BroadWorks. La differenza rispetto a UC-One Collaborate e UC-One SaaS è che l'app Webex è il soft client principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
-
Zendesk—Premium only
-
Slack—Premium only
-
Microsoft Teams for Webex Meetings—Standard or Premium
-
Microsoft Teams for Calling—Supported with all packages
-
Office 365 Calendaring—Standard or Premium
-
Google Calendaring for G Suite—Standard or Premium
Supporto infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta ambienti con infrastruttura desktop virtuale (VDI). For details on how to deploy VDI infrastructure, refer to Deployment Guide for Webex for Virtual Desktop Infrastructure (VDI).
IPv6 Support
Webex for Cisco BroadWorks supports IPv6 addressing for the Webex App.
Pro Pack per Control Hub
Il servizio aggiuntivo Pro Pack per Control Hub fornisce agli amministratori, alle informazioni di sicurezza e ai funzionari di conformità funzionalità avanzate in sicurezza, conformità e analisi in grado di integrare il software.
These add-on services will be only available for Standard and Premium packages.
For more information, see the Help Page of Pro Pack for Control Hub.
Roadmap futuro
Per informazioni sulle nostre intenzione per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Gli elementi della roadmap non sono associabili ad alcuna capacità. Cisco si riserva il diritto di disattivare o revisionare uno o tutti di questi elementi nelle release future.
Limiti
Limitazioni provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario per il Webex Meetings sito creato per tale pacchetto.
Se non viene specificato alcun fuso orario nella richiesta di provisioning per il primo utente di ciascun pacchetto, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sul valore predefinito regionale dell'organizzazione degli abbonati.
Se il cliente richiede un fuso orario Webex Meetings sito specifico, specificare il parametro di fuso orario nella richiesta di provisioning
per:
-
il primo abbonato predisposto per il pacchetto standard nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
-
the first subscriber provisioned for Basic package in the organization.
Limitazioni generali
-
Nessuna chiamata nella versione Web del client Webex (si tratta di una limitazione del client, non di una limitazione di soluzione).
-
Webex potrebbe non disporre ancora di tutti i controlli UI per supportare alcune funzioni di controllo chiamate disponibili da BroadWorks.
-
Il client Webex non può essere attualmente con etichetta "White labeled".
-
Quando si creano organizzazioni cliente utilizzando il metodo di provisioning scelto, tali organizzazioni vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. È previsto che partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
-
La generazione di report sulle riunioni e sull'utilizzo dei messaggi è disponibile attraverso l'organizzazione cliente in Control Hub.
Problemi noti e limitazioni
For an up to date list of known issues and limitations with the Webex for Cisco BroadWorks offer, see Known Issues and Limitations.
Limiti messaggistica
I seguenti limiti di storage dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo spazio di storage massimo per la messaggistica e i file combinati.
-
Base: 2 GB per utente per 3 anni
-
5 GB standard per utente per 3 anni
-
Premium: 10 GB per utente per 5 anni
Per ciascuna organizzazione di clienti, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti Premium può utilizzare un limite di messaggistica e storage file totale di 50 GB. Un singolo utente può superare il limite per utente (10 GB) a condizione che la società sia ancora sotto il valore massimo aggregato (50 GB).
Per gli spazi del team creati, i limiti di messaggistica si applicano al totale aggregato per l'organizzazione del cliente che possiede lo spazio del team. È possibile trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti di messaggistica generali che si applicano agli spazi del team di messaggistica Webex, vedere https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure connessioni a Webex e BroadWorks. I dati archiviati nel cloud Webex e esposti all'utente attraverso l'interfaccia dell'app Webex vengono crittografati sia in viaggio che a riposo.
Ulteriori dettagli sullo scambio dei dati sono disponibili nella sezione Riferimento di questo documento.
Lettura aggiuntiva
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati più vicino alla regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore provider di servizi (utente): Per le attività di manutenzione giornaliere, è possibile gestire le parti in locale (di chiamata) della soluzione utilizzando i propri sistemi. Le parti Webex della soluzione vengono gestite attraverso Partner Hub.
For information on the roles that are available to partners, the access privileges that accompany those roles, and how to assign roles, see Partner Administrator Roles for Webex for BroadWorks and Wholesale RTM.
The first user provisioned to a new partner organizaiton is assigned automatically to the Full Administrator and Full Partner Administrator roles. That administrator can use the above article to assign additional roles. |
Team operativo Cisco Cloud: Crea l'organizzazione partner in Partner Hub, se non esiste, durante il processo di onboarding.
Una volta che si dispone dell'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. You next create “Onboarding templates” to represent the suites or packages served through those systems. Si eservi quindi il provisioning dei propri clienti o abbonati.
# |
Attività tipica |
SP |
Cisco |
---|---|---|---|
1 |
Onboarding del partner: creazione dell'organizzazione partner, se presente, e abilitazione delle attivazioni/disattivazioni delle funzioni necessarie |
● | |
2 |
Configurazione BroadWorks nell'organizzazione partner tramite Hub partner (cluster) |
● | |
3 |
Configurazione delle impostazioni di integrazione nell'organizzazione partner tramite Partner Hub (modelli di offerta, branding) |
● | |
4 |
Preparing BroadWorks environment for Integration (AS, XSP|ADP Patching, firewalls, XSP|ADP configuration, XSI, AuthService, CTI, NPS, DMS applications on XSP|ADP) |
● | |
5 |
Sviluppo di un'integrazione o di un processo di provisioning |
● | |
6 |
Prepara materiali GTM |
● | |
7 |
Esegui migrazione o provisioning di nuovi utenti |
● |
Architettura
Che cos'è nel diagramma?
Client
-
Il client Webex App svolge la funzione di applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di riunioni audio/video native di messaggistica, presenza e multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per chiamate SIP PSTN chiamate.
-
I telefoni Cisco IP e relativi accessori utilizzano anche l'infrastruttura BroadWorks per SIP e chiamate PSTN telefoniche. Ci vediamo in grado di supportare telefoni di terze parti.
-
Portale di attivazione utente per consentire agli utenti di accedere a Webex utilizzando le credenziali BroadWorks.
-
Partner Hub è un'interfaccia Web per l'amministrazione della propria organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. È anche possibile utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
provider di servizi di rete
Il blocco verde a sinistra del diagramma rappresenta la rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
-
Public-facing XSP|ADP, for Webex for Cisco BroadWorks: (The box represents one or multiple XSP|ADP farms, possibly fronted by load balancers.)
-
Ospita l'interfaccia XSI-Actions &XSI-Events, Device Servizio di gestione (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato di hook degli altri (presenza di telefonia) e cronologia chiamate.
-
Pubblica la directory sui client Webex.
-
-
Public-facing XSP|ADP, running NPS:
-
Server push notifiche chiamate host: A Notification Push Server on an XSP|ADP in your environment. Interfaccia tra il server applicazioni e il nostro proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS &FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
-
-
Server applicazione:
-
Fornisce il controllo e le interfacce delle chiamate ad altri sistemi BroadWorks (in genere)
-
Per il provisioning flowre, l'AS viene utilizzato dall'amministratore del partner per eseguire il provisioning degli utenti in Webex
-
Inserisce profilo utente in BroadWorks
-
-
SISTEMA SISTEMA AVAIO/BSS: Sistema di supporto operativo/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nel diagramma rappresenta il cloud Webex. I microservizi Webex supportano tutte le funzionalità di collaborazione Webex:
-
Cisco Common Identity (CI) è il servizio di identità all'interno di Webex.
-
Webex per Cisco BroadWorks rappresenta l'insieme di microservizi che supportano l'integrazione tra Webex e provider di servizi BroadWorks ospitate:
-
API di provisioning utenti
-
provider di servizi configurazione
-
Accesso utente tramite credenziali BroadWorks
-
-
casella Messaggistica Webex per microservizi correlati alla messaggistica.
-
Webex Meetings che rappresenta i server di elaborazione multimediale e i controller SBC per le riunioni video con più partecipanti (SIP & SRTP)
Servizi Web di terze parti
I seguenti componenti di terze parti vengono rappresentati nel diagramma:
-
APNS (Apple Push Notifications Service) inserisce le notifiche di chiamate e messaggi nelle applicazioni Webex sui dispositivi Apple.
-
FCM (FireBase Cloud Messaging) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
XSP|ADP Architecture Considerations
The Role of Public-Facing XSP|ADP Servers in Webex for Cisco BroadWorks
The public-facing XSP|ADP in your environment provides the following interfaces/services to Webex and clients:
-
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste di BroadWorks J JSON (Token Web JSON) per conto dell'utente
-
Interfaccia CTI protetta da mTLS, a cui Webex esegue l'abbonamento per eventi cronologia chiamate e stato della presenza di telefonia da BroadWorks (stato hook).
-
Interfacce di azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate, le directory di contatto e di elenco delle chiamate e la configurazione del servizio di telefonia dell'utente finale
-
Servizio DM (Device Management) per i client per recuperare i file di configurazione delle chiamate
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. (See Configure your BroadWorks Clusters in Partner Hub in this document.) For each cluster, you can only provide one URL for each interface. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
XSP|ADP Architecture
We require that you use a separate, dedicated XSP|ADP instance or farm to host your NPS (Notification Push Server) application. È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. However, you may not host the other applications required for Webex for Cisco BroadWorks on the same XSP|ADP that hosts the NPS application.
We recommend that you use a dedicated XSP|ADP instance/farm to host the required applications for Webex integration for the following reasons
-
For example, if you’re offering UC-One SaaS, we recommend creating a new XSP|ADP farm for Webex for Cisco BroadWorks. In questo modo i due servizi possono funzionare in modo indipendente durante la migrazione degli abbonati.
-
If you collocate the Webex for Cisco BroadWorks applications on an XSP|ADP farm that is used for other purposes, it's your responsibility to monitor usage, manage the resulting complexity, and plan for the increased scale.
-
The Cisco BroadWorks System Capacity Planner assumes a dedicated XSP|ADP farm and may not be accurate if you use it for collocation calculations.
Unless noted otherwise, the dedicated Webex for Cisco BroadWorks XSP|ADPs must host the following applications:
-
AuthService (TLS con convalida token CI o mTLS)
-
CTI (mTLS)
-
Azioni XSI (TLS)
-
XSI-Events (TLS)
-
DMS (TLS)—Optional. It's not mandatory that you deploy a separate DMS instance or farm specifically for Webex for Cisco BroadWorks. You can use the same DMS instance that you use for UC-One SaaS or UC-One Collaborate.
-
Call Settings Webview (TLS)—Optional. Call Settings Webview (CSW) is required only if you want Webex for Cisco BroadWorks users to be able to configure calling features on the Webex App.
Webex richiede l'accesso al CTI attraverso un'interfaccia protetta (autenticazione) TLS reciproca autenticazione. Per supportare questo requisito, si consiglia una di queste opzioni:
-
(Diagram labelled Option 1) One XSP|ADP instance or farm for all applications, with two interfaces configured on each server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
-
(Diagram labelled Option 2) Two XSP|ADP instances or farms, one with an mTLS interface for CTI, and the other with a TLS interface for other apps, such as the AuthService.
XSP|ADP Reuse If you have an existing XSP|ADP farm that conforms to one of the suggested architectures above (Option 1 or 2) and it is lightly loaded, then it is possible to reuse your existing XSP|ADPs. You will need to verify that there are no conflicting configuration requirements between existing applications and the new application requirements for Webex. Le due considerazioni principali sono:
Because the XSP|ADP’s have many applications and the number of permutations of these applications is large, there may be other unidentified conflicts. For this reason, any potential reuse of XSP|ADP’s should be verified in a lab with the intended configuration prior to committing to the reuse. |
Configure NTP Synchronization on XSP|ADP
The deployment requires time synchronization for all XSP|ADPs that you use with Webex.
Installare il pacchetto ntp
dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Then you can configure NTP during the XSP|ADP software installation. Per ulteriori informazioni, vedere la Guida alla gestione software BroadWorks.
During the interactive installation of the XSP|ADP software, you’re given the option to configure NTP. Procedere come segue:
-
Quando viene visualizzato il programma di installazione,
configurare NTP?
, inserire y.
-
Quando il programma di installazione richiede,
questo server deve essere un server NTP? , inserire n
.
-
Quando il programma di installazione richiede, Qual è l'indirizzo NTP, il nome host o nome di dominio completo? , inserire l'indirizzo del server NTP o un servizio
NTP pubblico, ad esempio,
pool.ntp.org
.
If your XSP|ADPs use silent (noninteractive) installation, the installer configuration file must include the following Key=Value pairs:
NTP
NTP_SERVER=<NTP Server address, e.g., pool.ntp.org>
XSP|ADP Identity and Security Requirements
Sfondo
I protocolli e i tipi di crittografia delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli variano dal più generale (provider SSL) alla più specifica (singola interfaccia). Un'impostazione più specifica sovrascrive sempre un'impostazione più generale. Se non vengono specificate, le impostazioni SSL di livello 'inferiore' vengono ereditano dai livelli superiori.
Se non viene modificata alcuna impostazione dai valori predefiniti, tutti i livelli ereditano le impostazioni predefinite del provider SSL (estensione JSSE Java Secure Sockets).
Elenco requisiti
-
The XSP|ADP must authenticate itself to clients using a CA-signed certificate in which the Common Name or Subject Alternate Name matches the domain portion of the XSI interface.
-
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
-
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
-
Diffie-Hellman Ephemeral (DHE) o Curve ellittiche Diffie-Hellman Ephemeral (ECDHE) key-exchange
-
Crittografia AES (Advanced Encryption Standard) con una dimensione di blocco minima di 128 bit (ad esempio, AES-128 o AES-256)
-
Modalità di crittografia GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
-
Se viene utilizzata la crittografia CBC, solo la famiglia di funzioni hash SHA2 è consentita per la derivazione chiave (SHA256, SHA384, SHA512).
-
-
Ad esempio, i seguenti tipi di crittografia soddisfano i requisiti:
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
The XSP|ADP CLI requires the IANA naming convention for cipher suites, as shown above, not the openSSL convention. |
Tipi di crittografia TLS supportati per le interfacce AuthService e XSI
Questo elenco è soggetto a modifica quando i requisiti di sicurezza del cloud cambiano. Seguire i suggerimenti sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento. |
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
-
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
-
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_128_GCM_SHA256
-
TLS_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_256_CBC_SHA256
-
TLS_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_WITH_AES_256_CBC_SHA
-
TLS_PSK_WITH_AES_256_CBC_SHA384
-
TLS_PSK_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_WITH_AES_128_CBC_SHA
-
TLS_PSK_WITH_AES_128_CBC_SHA256
-
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il conteggio dei thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi mostrati, come segue (non diminuire, se sono superiori ai valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Multiple XSP|ADPs
Elemento Edge di bilanciamento del carico
If you have a load balancing element on your network edge, it must transparently handle the distribution of traffic between your multiple XSP|ADP servers and the Webex for Cisco BroadWorks cloud and clients. In questo caso, si fornisce l'URL del servizio di bilanciamento del carico a Webex per la configurazione Cisco BroadWorks.
Note su questa architettura:
-
Configurare DNS in modo che i client possano trovare il servizio di bilanciamento del carico quando si connettono all'interfaccia Xsi (vedere Configurazione DNS).
-
Si consiglia di configurare l'elemento Edge in modalità proxy SSL inverso per accertarsi che la crittografia dati point-to-point.
-
Certificates from XSP|ADP01 and XSP|ADP02 should both have the XSP|ADP domain, for example your-XSP|ADP.example.com, in the Subject Alternate Name. They should have their own FQDNs, for example XSP|ADP01.example.com, in the Common Name. È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Internet-Facing XSP|ADP Servers
If you expose the Xsi interfaces directly, use DNS to distribute the traffic to the multiple XSP|ADP servers.
Note su questa architettura:
-
Two records are required to connect to the XSP|ADP servers:
-
For Webex microservices: Round-robin A/AAAA records are required to target the multiple XSP|ADP IP addresses. This is because the Webex microservices can’t do SRV lookups. For examples, see Webex Cloud Services.
-
For Webex App: An SRV record that resolves to A records where each A record resolves to a single XSP|ADP. For examples, see Webex App.
Use prioritized SRV records to target the XSI service for the multiple XSP|ADP addresses. Prioritize your SRV records so that the microservices will always go to the same A record (and subsequent IP address) and will only move to the next A record (and IP address) if the first IP address is down. DO NOT use a round-robin approach for the Webex App.
-
-
Certificates from XSP|ADP01 and XSP|ADP02 should both have the XSP|ADP domain, for example your-XSP|ADP.example.com, in the Subject Alternate Name. They should have their own FQDNs, for example XSP|ADP01.example.com, in the Common Name.
-
È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Sometimes, DNS is configured to resolve the XSP|ADP URL to an HTTP load balancer, and the load balancer is configured to redirect through a reverse proxy to the XSP|ADP servers.
Webex does not follow a redirect when connecting to the URLs you supply, so this configuration does not work.
Ordinazione e provisioning
Ordinazione e provisioning si applicano a questi livelli:
-
Partner/Service Provider provisioning:
Ciascun Webex per Cisco BroadWorks provider di servizi (o rivenditore) presente deve essere configurato come organizzazione partner in Webex e disporre dei diritti necessari. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per la gestione di Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le attività di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/Enterprise.
-
Customer/Enterprise ordering and provisioning:
Ciascuna azienda BroadWorks abilitata per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo viene eseguito automaticamente come parte del provisioning dell'utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks sono predisposti nella stessa organizzazione clienti Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
-
User/Subscriber ordering and provisioning:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning utente:
-
Provisioning Flow con e-mail attendibili
-
Provisioning flow senza messaggi e-mail attendibili
-
Self-provisioning utente
-
Provisioning API
-
Flowthrough Provisioning with Trusted Emails
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile asserre che BroadWorks abbia indirizzi e-mail dell'abbonato validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Provisioning flow senza messaggi e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non si può contare sugli indirizzi e-mail dell'abbonato tenuti da BroadWorks, questa opzione di provisioning crea account Webex, ma non può attivarli fino a quando gli abbonati non forniscono e convalidano gli indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Self-Provisioning utente
Con questa opzione, non esiste provisioning flowworks da BroadWorks a Webex. Dopo aver configurato l'integrazione tra Webex e il sistema BroadWorks, si ottengono uno o più collegamenti specifici per il provisioning degli utenti all'interno di Webex per l'organizzazione partner Cisco BroadWorks.
Si progettare quindi le proprie comunicazioni (o delegare ai clienti) la distribuzione del collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account sono predisposti nell'ambito dell'organizzazione partner, è possibile regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare questa operazione.
Gli utenti devono essere presenti nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento. |
provider di servizi provisioning da PARTE delle API
Webex sono esposti una serie di API pubbliche che consentono di creare Webex per il provisioning di utenti/abbonati Cisco BroadWorks nel flusso di lavoro/strumenti di gestione degli utenti esistenti.
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Install AP.as.22.0.1123.ap376508.
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Install AP.as.23.0.1075.ap376509
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Install AP.as.24.0.944.ap375100
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning di nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per utenti Cisco BroadWorks. |
Extension Dialing
Extension Dialing feature support allows Webex for Cisco Broadworks users to dial other users with an extension similar to the primary phone number within the same enterprise. This is especially useful for users who do not have DID numbers.
During provisioning, the extension of the users gets stored in the Webex directory as the user’s extension. For BroadWorks calling, the extension appears on the Webex App in the extension field of all the call initiation method areas and the user’s profile. Webex for Cisco BroadWorks supports extension-only calls between users within the same group and different groups of the same enterprise with the combination of location dialing code and extension. However, calling between two enterprises using only extensions is not supported.
An extension can be provisioned for the Cisco BroadWorks users through the following methods:
-
Cisco BroadWorks users
-
Public API provisioning as ‘extension
-
The extension parameter should be explicitly passed as part of the API call. For enterprises/groups that have Location Dialing Code (LDC) configured, the extension parameter should be the combination of LDC and 'extension number.
-
-
Flowthrough or Self-Activation provisioning
-
Extension and LDC (where applicable) will be automatically retrieved from BroadWorks.
-
-
-
BroadWorks-only Calling users or entities
-
Synced automatically from BroadWorks by Directory Sync using the combination of Location Dialing Code (LDC) and extension number.
-
Record chiamata BroadWorks |
Descrizione |
Provisioning method |
Managing Extension |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
Public API |
Extension needs to be passed as parameter |
Flowthrough |
Extension retrieved from BroadWorks automatically | ||
Utenti che chiamano solo BroadWorks |
Calling users who are not onboarded to Webex |
Sincronizzazione rubriche |
Extension synced by Directory sync |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sincronizzazione rubriche | Extension synced by Directory sync |
Elenchi telefonici BroadWorks |
Enterprise, Group or Personal Phone Lists |
Sincronizzazione rubriche |
Non applicabile |
Prerequisiti
-
Client version required for supporting this feature is 42.11 or later.
-
Patch where extension and location dialing codes are added to XSI and Provisioning Adapter February 2022 for version 23 or above as part of :
-
AP.platform.23.0.1075.ap380045
-
AP.as.23.0.1075.ap380045
-
AP.xsp.23.0.1075.ap380045
-
AP.as.24.0.944.ap380045
-
-
Enable the header X-BroadWorks-Remote-Party-Info on the AS using the below CLI command for this SIP call flow which is required for extension dialing feature support.
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
App Call Options Priority
As part of the Extension Dialing feature support, The app call options priority setting is also provided at the partner level for all the Webex for Cisco Broadworks partners. Using this setting, the partner can control the call priority settings of all its managed customers from Partner Hub. The app call options priority setting for a customer can also be modified at a customer level from Control Hub.
The app call options priority setting contains extension as second option in both Partner Hub and Control Hub when a Webex for Cisco Broadworks user is newly provisioned with extension through any of the above-mentioned provisioning methods.
For all the existing provisioned Orgs, the extension option will be in the hidden state (by default) in the app call options priority setting. This will not show an extension in the audio/video call option of the user in the Webex App.
Following are the options to make the extension call option visible for the existing customers:
-
If a partner wants all its managed customer orgs to be provided with an extension as one of the call options, it is recommended for the Partner Admin to move the Extension from hidden to available in Partner Hub. This will let the managed customer orgs inherit the setting from their partner.
-
If a Partner wants to provide an extension in call options for a specific customer org, it is recommended for the Partner Admin to move the extension from hidden to available in Control Hub.
Group Contacts Support
This feature enhances the Webex for BroadWorks DirSync service by removing the limitation for syncing up to 1500 contacts from the Group phone lists on BroadWorks and allowing partners to sync up to 30K contacts from a single Group phone list and bring it on par with the 30K contacts increase for Enterprise phone list, which was released separately.
There is an overall limit of 200K for all external contacts per Organization, which would apply to the sum of Enterprise and Group phone lists in a single BroadWorks enterprise. For example, a BroadWorks enterprise that has Enterprise phone list with 30K and also 5 Group phone lists each with 30K will be supported (180K total per Org). However, if there are 6 group phone lists each with 30K, this will not be supported (210K total).
This feature is available on request. Please contact your account team to have it enabled.
|
After the feature is enabled, the DirSync service starts syncing BroadWorks Group phone list contacts into dedicated per group contact storage in the Webex Contact Service.
During provisioning, the enterprise group of the user needs to be stored in the Webex directory to indicate the group this user belongs to. The association of the user with a BroadWorks group in the Webex Directory allows the Webex app to do contact search in the Contact Service group storage for the specific group of the user.
The feature requires the Webex for BroadWorks subscribers to be provisioned in Webex with the BroadWorks enterprise Group Id.
The BroadWorks enterprise Group Id can be provisioned for the Cisco BroadWorks users through the following methods:
-
Webex per utenti Cisco BroadWorks
-
Public API provisioning as ‘spEnterpriseGroupId’
-
The BroadWorks enterprise Group Id should be explicitly passed in spEnterpriseGroupId parameter of the API call.
-
-
Flowthrough or Self-Activation provisioning
-
BroadWorks enterprise Group Id will be automatically retrieved from BroadWorks.
-
-
BroadWorks-only Calling users or entities
-
Not applicable. It’s not required to sync BroadWorks enterprise Group Id for these users.
-
-
Record chiamata BroadWorks |
Descrizione |
Provisioning method |
Managing Enterprise Group ID |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
Public API |
BroadWorks enterprise Group Id needs to be passed as parameter spEnterpriseGroupId |
Flowthrough |
BroadWorks enterprise Group Id is retrieved from BroadWorks automatically | ||
Utenti che chiamano solo BroadWorks |
Calling users who are not onboarded to Webex |
Sincronizzazione rubriche |
Non applicabile |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sincronizzazione rubriche |
Non applicabile |
Elenchi telefonici BroadWorks |
Contacts in the BroadWorks Group Phone Lists |
Sincronizzazione rubriche |
Group contacts are stored in Webex Contact Service associated with the specific group |
BroadWorks Enterpsie or Persional phone lists |
Contacts in the Enterprise or Personal Phone Lists |
Sincronizzazione rubriche |
Non applicabile |
Public API must be updated PRIOR to the MIGRATION. Migration cannot be completed until THIS API is completed The BroadWorks enterprise Group Id should be explicitly passed in spEnterpriseGroupId parameter of the API call https://developer.webex.com/docs/api/changelog#2023-march After the feature is enabled and as a result of the next directory sync the enterprise user groups will also be displayed in Control Hub. Visualizing the groups in Control Hub for Webex for BroadWorks is purely informational at this stage. Partner and customer admins should not make any modifications to groups or group membership in Control Hub as these changes will not be reflected back to BroadWorks. Group Management in Control Hub is intended for use by partners who will be adopting the upcoming Contact Management APIs. |
Migrazione e prova futura
Cisco il client BroadSoft unified Communications deve passare da UC-One a Webex. Esiste una corrispondente lingua dei servizi di supporto lontani dalla rete provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Whether you’re running UC-One SaaS, or BroadWorks Collaborate, the preferred migration strategy is to deploy new, dedicated XSP|ADPs for integration with Webex for Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti a Webex e, infine, recuperare l'infrastruttura utilizzata per la soluzione precedente.
Recommended Document Subscriptions
Webex Help Center articles (on help.webex.com) have a Subscribe option that lets you receive an email notification whenever that article gets updated.
We recommend that you subscribe to each of the following articles to ensure that you don't miss out on critical updates that affect network connectivity. To subscribe, go to each of the below links and in the article that launches, click the Subscribe button.
At a minimum, we recommend that you subscribe to the above list. However, most of the Webex articles and documents listed under Additional Documents have a Subscribe option. For this option to appear, the article must appear on help.webex.com.
There is no subscription option for documentation landing pages. |
Additional Documents
Refer to the following related documentation for more information about Webex for Cisco BroadWorks:
Webex for Cisco BroadWorks Documents
Partner administrators can use the following documents and sites to obtain information on Webex for Cisco BroadWorks.
-
Bring Your Own PSTN Solution for Webex for Cisco BroadWorks—This solution lets Service Providers provision phone numbers that they own (rather than Cisco-provided numbers) for users to use when joining Webex Meetings.
-
Webex for Cisco BroadWorks Configuration Guide—Describes how to configure the Webex App for Webex for Cisco BroadWorks.
- Device Integration Guide for Webex for Cisco BroadWorks—Describes how to onboard and service Room OS and MPP devices.
-
Webex for Cisco BroadWorks Troubleshooting Guide—Contains troubleshooting information for Webex for Cisco BroadWorks.
Webex for Cisco BroadWorks Articles
Partner administrators can use the following optional sites to learn more about Webex for Cisco BroadWorks:
-
Webex for Cisco BroadWorks Documentation—The landing page lists technical documents and optional Webex articles targeted to partner administrators of Webex for Cisco BroadWorks.
-
What's New with Webex for Cisco BroadWorks—Read about the latest released features along with what's coming soon.
-
Known Issues and Limitations—Read about known issues that we've identified in the Webex for Cisco BroadWorks solution.
-
Partner Administrator Roles for Webex for BroadWorks and Wholesale RTM—This article describes how to assign partner administrator roles for partner organizations that offer Webex for Cisco BroadWorks. Roles get used to assign administration access to settings in Partner Hub and Control Hub.
Cisco BroadWorks Documents
Partner administrators can refer to the Cisco BroadWorks site on cisco.com for technical documents that describe how to deploy the Cisco BroadWorks part of the solution:
Webex Help Articles
The following Webex Help sites can be used to find Webex articles that help customer administrators and end users to use Webex features.
-
Webex from Service Providers—This landing page contains links with getting started info and commonly used articles for Webex App users who purchased Webex services from a Service Provider.
-
Webex Help Center—Use the search feature at help.webex.com to search for additional Webex articles that describe Webex App and Webex Meetings functionality. You can search for either user or administrator articles.
Developer Documentation
-
Webex for BroadWorks Developer Guide—Provides information for developers who create applications that use the Webex for BroadWorks APIs.
Punti decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastruttura
|
How many XSP|ADPs? Come prendono mTLS? |
Pianificatore capacità sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks XSP|ADP CLI Reference Questo documento |
Provisioning clienti e utenti |
Si può asserre che si considera attendibili i messaggi e-mail in BroadWorks? Si desidera che gli utenti forniranno gli indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Doc API pubblici su https://developer.webex.com Questo documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo sul branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso dei clienti? | Questo documento |
Funzioni dell'abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o softphone. |
Questo documento Matrice funzioni/pacchetto |
Autenticazione utente | BroadWorks o Webex | Questo documento |
Adattatore di provisioning (per le opzioni di provisioning flow) |
Utilizzi già IM&P integrato, ad esempio per UC-One SaaS? Utilizzare più modelli? Esiste un caso d'uso più comune previsto? |
Questo documento Riferimento CLI server applicazione |
Architettura e infrastruttura
-
Con quale scala intendete iniziare? È possibile aumentare la scalabilità in futuro, ma la stima d'uso corrente deve guidare la pianificazione dell'infrastruttura.
-
Work with your Cisco account manager / sales representative to size your XSP|ADP infrastructure, according to the Cisco BroadWorks System Capacity Planner and the Cisco BroadWorks System Engineering Guide.
-
How will Webex make Mutual TLS connections to your XSP|ADPs? Directly to the XSP|ADP in a DMZ, or via TLS proxy? This affects your certificate management, and the URLs you use for the interfaces. (We do not support unencrypted TCP connections to the edge of your network).
Provisioning clienti e utenti
Quale metodo di provisioning utente si adatta meglio alle esigenze?
-
Flowthrough Provisioning With Trusted Emails: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene automaticamente predisposto in Webex.
Se è anche possibile asserre che gli indirizzi e-mail dell'abbonato nella BroadWorks siano validi e univoci per Webex, è possibile utilizzare la varianti "e-mail attendibile" del provisioning flow provisioning. Gli account Webex del sottoscrittore vengono creati e attivati senza il loro intervento; semplicemente scaricare il client ed eseguire l'accesso.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto l provider di servizi deve specificare un indirizzo e-mail valido per l'utente per potervi fornire i servizi Webex. Deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo nell'attributo ID alternativo.
-
Flowthrough Provisioning Without Trusted Emails: Se non si riesce a verificare l'attendibilità degli indirizzi e-mail dell'abbonato, è comunque possibile assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
-
User Self-Provisioning: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. L'utente (o i clienti) distribuiscono invece un collegamento di provisioning e i collegamenti per scaricare diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex. Quindi scaricano il client e a quel punto Webex recuperano alcune configurazioni aggiuntive su di esse da BroadWorks (inclusi i numeri principali).
-
SP Controlled Provisioning via APIs: Webex sono esposti una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei flussi di lavoro esistenti.
Provisioning Requirements
The following table summarizes the requirements for each provisioning method. In addition to these requirements, your deployment must meet the general system requirements that are described in this guide.
Provisioning Method |
Requisiti |
---|---|
Provisioning Flow (Trusted or Untrusted emails) |
The Webex provisioning API adds existing BroadWorks users to Webex automatically once the user meets requirements and you toggle the Integrated IM+P service to on. There are two flows (trusted emails or untrusted emails) which you assign via the Onboarding template on Webex. BroadWorks requirements:
Webex requirements: The Onboarding template includes the following settings:
|
Self-Provisioning utente |
Admin provides an existing BroadWorks user with a link to the User Activation Portal. The user must log in to the portal using BroadWorks credentials and provide a valid email address. After the email is validated, Webex fetches additional user information to complete provisioning. BroadWorks requirements:
Webex requirements: The Onboarding template includes the following settings:
|
SP controlled provisioning via API (Trusted or Untrusted emails) |
Webex exposes a set of public APIs that enable you to build user provisioning into your existing workflows and tools. There are two flows:
BroadWorks Requirements:
Webex Requirements:
To use the APIs, go to BroadWorks Subscribers. |
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Install AP.as.22.0.1123.ap376508.
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Install AP.as.23.0.1075.ap376509
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Install AP.as.24.0.944.ap375100
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning di nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per utenti Cisco BroadWorks. |
Supported Language Locales
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente amministrativo predisposto viene assegnata automaticamente come impostazioni internazionali predefinite per tale organizzazione cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti alle riunioni in tale organizzazione del cliente.
Five character language locales in (ISO-639-1)_(ISO-3166) format are supported. For example, en_US corresponds to English_UnitedStates. If only a two letter language is requested (using ISO-639-1 format), the service will generate a five character language locale by combining the requested language with a country code from the template i.e. "requestedLanguage_CountryCode", if unable to get a valid locale, then the default sensible locale used based on the required language code.
The following table lists the supported locales, and the mapping that converts a two-letter language code to a five-character locale for situations where a five-character locale is not available.
Supported Language Locales (ISO-639-1)_(ISO-3166) |
If only a two-letter language code is available... | |
---|---|---|
Language code (ISO-639-1) ** |
Use Default Sensible Locale instead (ISO-639-1)_(ISO-3166) | |
en_US en_AU en_GB en_Ca |
en |
en_US |
fr_Fr fr_Ca |
Fr |
fr_Fr |
cs_CZ |
cs |
cs_CZ |
da_Dk |
da |
da_Dk |
de_DE |
DE |
de_DE |
hu_Hu |
hu |
hu_Hu |
id_ID |
Identificativo |
id_ID |
it_IT |
IT |
it_IT |
ja_JP |
ja |
ja_JP |
ko_Kr |
ko |
ko_Kr |
es_ES es_CO es_MX |
ES |
es_ES |
nl_NL |
NL |
nl_NL |
nb_NO |
nb |
nb_NO |
pl_PL |
pl |
pl_PL |
pt_PT pt_Br |
pt |
pt_PT |
ru_RU |
RU |
ru_RU |
ro_RO |
ro |
ro_RO |
zh_Cn zh_TW |
zh |
zh_Cn |
sv_SE |
sv |
sv_SE |
ar_Sa |
ar |
ar_Sa |
tr_Tr |
tr |
tr_Tr |
The locales es_CO, id_ID, nb_NO and pt_PT are not supported by Webex Meeting Sites. For these locales, The Webex Meetings sites will be in English only. English is the default locale for sites if no/invalid/unsupported locale is required for the site. This language field is applicable while creating an Organization and Webex Meetings site. If no language is mentioned in a post or in the subscriber's API then language from the template will be used as a default language. |
Branding
Gli amministratori dei partner possono utilizzare personalizzazioni di branding avanzate per personalizzare il modo in cui l'app Webex cerca le organizzazioni dei clienti gestite dal partner. Gli amministratori dei partner possono personalizzare le seguenti impostazioni per assicurarsi che l'app Webex rifletta il marchio e l'identità della propria società:
-
Loghi aziendali
-
Schemi di colore univoci per la modalità chiaro o la modalità scura
-
URL di supporto personalizzati
For details on how to customize branding, refer to Configure Advanced Branding Customizations.
|
Onboarding templates
Onboarding templates allow you to define the parameters by which customers and associated subscribers are automatically provisioned on Webex for Cisco BroadWorks. You may configure multiple Onboarding templates as required, but when you onboard a customer it is associated with only one template (you cannot apply multiple templates to one customer).
Di seguito sono elencati alcuni parametri del modello principale.
Pacchetto
-
È necessario selezionare un pacchetto predefinito quando si crea un modello (per informazioni dettagliate, vedere Pacchetti nella sezione Panoramica). Tutti gli utenti predisposti con tale modello, mediante flusso o auto-provisioning, ricevono il pacchetto predefinito.
-
È possibile controllare la selezione del pacchetto per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori per provisioning aziendali, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
-
You can change the package of specific subscribers from this default, using the provisioning API (see Webex for Cisco BroadWorks API documentation or through Partner Hub (see Change User Package in Partner Hub).
-
Non è possibile modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è disattivata; se l'abbonato è assegnato a questo servizio in BroadWorks, il modello Hub partner associato all'URL di provisioning di tale azienda definisce il pacchetto.
Rivenditori e aziende o provider di servizi e gruppi?
-
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se si è un rivenditore con Aziende, è necessario abilitare la modalità Enterprise quando si crea un modello.
-
Se il sistema BroadWorks è configurato in provider di servizi modalità aziendale, è possibile lasciare disattivata la modalità Enterprise nei modelli.
-
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch broadworks richieste per il provisioning flow-through. Per informazioni dettagliate, vedere Patch richieste con provisioning flow-through. |
Modalità di autenticazione
Decide how you want subscribers to authenticate when they log in to Webex. You can assign the mode using the Authentication Mode setting in the Onboarding template. The following table outlines some of the options.
This setting has no effect on login to the User Activation Portal. Users who sign in to the portal must enter their BroadWorks user ID and password, as configured on BroadWorks, irrespective of how you configure Authentication Mode on the Onboarding template. |
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | File BroadWorks ID utente | Indirizzo e-mail |
provider di identità |
BroadWorks.
| Cisco Common Identity |
Autenticazione multi-fattori? | No | Richiede un IdP cliente che supporti l'autenticazione a più fattori. |
Percorso di convalida credenziali
|
|
|
Per una descrizione dettagliata del flusso SSO accesso con autenticazione diretta a BroadWorks, vedere SSO login flow. |
UTF-8 Encoding with BroadWorks Authentication
With BroadWorks authentication, we recommend that you configure UTF-8 encoding for the authentication header. UTF-8 resolves an issue that can occur with passwords that use special characters whereby the web browser does not encode the characters properly. Using a UTF-8 encoded, base 64-encoded header resolves this issue.
You can configure UTF-8 encoding by running one of the following CLI commands on the XSP or ADP:
-
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
-
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
Paese
You must select a country when you create a template. This country will be automatically assigned as the organisation country for all the customers that are provisioned with the template in Common Identity. Additionally, the organization country will determine the default global call-in numbers for Cisco PSTN in Webex Meeting Sites.
The site's default global call-in numbers will be set to the first available dial-in number defined in the telephony domain based on the organization's country. If the organization's country is not found in the dial-in number defined in the telephony domain, the default number of that location will be used.
S No. |
Sede |
Prefisso internazionale |
Nome paese |
---|---|---|---|
1 |
AMER |
+1 |
US, CA |
2 |
APAC |
+65 |
Singapore |
3 |
Anz |
+61 |
Australia |
4 |
EMEA |
+44 |
REGNO UNITO |
5 |
EURO |
+49 |
Germania |
Accordi con più partner
Si desidera utilizzare la licenza secondaria di Webex per Cisco BroadWorks con un altro provider di servizi? In tal caso, ciascun fornitore di servizi avrà bisogno di un'organizzazione partner distinta Webex Control Hub permettere loro di fornire la soluzione per la propria base clienti.
Adattatore e modelli di provisioning
Quando si utilizza il provisioning flowre, l'URL di provisioning inserito in BroadWorks è derivato dal modello in Control Hub. È possibile disporre di più modelli e, quindi, di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati quando hanno ottenuto la concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e il modello che si desidera utilizzare. In questo modo, è necessario solo impostare in modo esplicito l'URL di provisioning per le aziende che necessitano di un modello diverso.
Tenere presente, inoltre, che potrebbe essere stato già utilizzato un URL di provisioning a livello di sistema, ad esempio UC-One SaaS. If that is the case, you may opt to preserve the system level URL for provisioning users on UC-One SaaS, and override for those enterprises moving to Webex for Cisco BroadWorks. In alternativa, è possibile passare al percorso alternativo e impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
The configuration choices related to this decision are detailed in Configure Application Server with Provisioning Service URL.
Provisioning Adapter Proxy
For added security, the Provisioning Adapter Proxy lets you use an HTTP(S) proxy on the Application Delivery Platform for flowthrough provisioning between the AS and Webex. The proxy connection creates an end-to-end TCP tunnel that relays traffic between the AS and Webex, thereby negating the need for the AS to connect to the public internet directly. For secure connections, TLS can be used.
This feature requires that you set up the proxy on BroadWorks. For details, see Cisco BroadWorks Provisioning Adapter Proxy Feature Description.
Requisiti minimi
Account
Tutti gli abbonati disponibili per Webex devono esistere nel sistema BroadWorks integrato con Webex. Se necessario, è possibile integrare più sistemi BroadWorks.
All subscribers must have BroadWorks licenses and a primary number or extension.
Webex utilizza gli indirizzi e-mail come identificativi principali per tutti gli utenti. Se si utilizza il provisioning flow con messaggi e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail dell'abbonato nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le relative password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
It is not supported to onboard a BroadWorks administrator to Webex for Cisco BroadWorks. You can only onboard BroadWorks calling users who have a primary number and/or extension. If you are using flowthrough provisioning, users must also be assigned the Integrated IM&P service. |
Server nella rete e requisiti software
-
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. For more information, see BroadSoft products lifecycle policy section in BroadSoft Lifecycle Policy and BroadWorks Software Compatibility Matrix.
-
Le istanze BroadWorks devono includere almeno i seguenti server:
-
Server applicazioni (AS) con versione BroadWorks come indicato sopra
-
Server di rete (NS)
-
Server di profilo (PS)
-
-
Public-facing XSP|ADP Server(s) or Application Delivery Platform (ADP) meeting the following requirements:
-
Servizio di autenticazione (BWAuth)
-
Interfacce azioni ed eventi XSI
-
DMS (applicazione Web di gestione dispositivi)
-
Interfaccia CTI (integrazione di telefonia su computer)
-
TLS 1.2 con un certificato valido (non autofirmato) ed eventuali intermedie richiesti. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
-
Autenticazione TLS reciproca (mTLS) per il servizio di autenticazione (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
Autenticazione TLS reciproca (mTLS) per interfaccia CTI (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
-
Un server XSP/ADP separato funge da "server push notifiche di chiamata" (un server NPS nel proprio ambiente utilizzato per eseguire il push delle notifiche di chiamata ad Apple/Google. Questo tipo di chiamata "CNPS" viene chiamata qui per distinguerlo dal servizio in Webex che offre notifiche push per messaggistica e presenza).
Questo server deve essere su R22 o versioni successive.
-
È obbligatorio creare un server XSP/ADP separato per CNPS poiché l'impossibilità di caricare da Webex per connessioni cloud BWKS potrebbe avere un impatto negativo sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. See the Cisco BroadWorks System Engineering Guide for more on XSP|ADP scale.
Piattaforme app Webex
To download the English version of the Webex App, go to https://www.webex.com/webexfromserviceproviders-downloads.html. The Webex App is available on:
-
PC/laptop Windows
-
PC Apple / laptop con MacOS
-
iOS (Apple store)
-
Android (Play store)
-
Web browsers (go to https://teams.webex.com/)
Localized Versions
To download a localized version of the Webex App, use one of these links:
-
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (Korean)
-
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (French)
-
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (Portuguese)
-
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (Chinese Traditional)
-
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (Chinese Simplified)
-
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Japan)
-
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spain)
-
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (German)
-
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (Italian)
Telefoni e accessori fisici
-
Telefoni IP Cisco:
-
Cisco IP Phone serie 6800 con firmware Multitform
-
Cisco IP Phone serie 7800 con firmware Multitform
-
Cisco IP Phone serie 8800 con firmware Multitform
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html modelli e ulteriori informazioni, vedere .
-
-
I telefoni di terze parti sono supportati allo stesso modo delle altre integrazioni BroadWorks. Tuttavia, non dispongono ancora di contatti e integrazione di presenza con Webex per Cisco BroadWorks.
-
Adapters:
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 191
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 192 Multiplatform
Per https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html modelli e ulteriori informazioni, vedere .
-
-
Headsets:
-
Cisco Headset serie 500
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html modelli e ulteriori informazioni, vedere .
-
-
Room OS Devices:
-
Webex Room and Room Kit Series
-
Serie Webex Desk
-
Serie Webex Board
-
Device Integration
For details on how to onboard and service Room OS and MPP devices for Webex for Cisco BroadWorks, see Device Integration Guide for Webex for Cisco BroadWorks.
Profili dispositivi
Following are the DTAF files you need to load onto your Application Servers to support the Webex App as a calling client. They are the same DTAF files as used for UC-One SaaS, however there is a new config-wxt.xml.template
file that is used for the Webex App.
To download the latest device profiles, go to the Application Delivery Platform Software Downloads site to get the latest DTAF files. These downloads work for both ADP and XSP.
Nome client |
Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Business Communicator - PC DTAF: File di configurazione: |
Identify/Device Profile
All Webex for Cisco BroadWorks users must have an Identity/Device Profile assigned in BroadWorks that uses one of the above device profiles in order to make calls using the Webex App. The profile provides the configuration that allows the user to place calls.
Obtaining OAuth credentials for your Webex for Cisco BroadWorks
Raise a service request with your onboarding agent or with Cisco TAC to provision Cisco OAuth for your Cisco Identity Provider Federation account.
Use the following request title for respective features:
-
XSP|ADP AuthService Configuration' to configure service on XSP|ADP.
-
'NPS Configuration for Auth Proxy Setup' to configure NPS to use authentication proxy.
-
CI User UUID Sync' for CI user UUID sync. For more details on this feature, see: Cisco BroadWorks support for CI UUID.
-
Configure BroadWorks to enable Cisco Billing for BroadWorks and Webex For BroadWorks Subscriptions.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento validi per 60 giorni. If the token expires before you use it, you can raise another request.
If you already obtained Cisco OAuth Identity Provider credentials, complete a new service request to update your credentials. |
Ordina certificati
Requisiti di certificato per l'autenticazione TLS
You will need Security Certificates, signed by a well-known Certificate Authority and deployed on your Public facing XSP|ADPs, for all required applications. These will be used to support TLS certificate verification for all inbound connectivity to your XSP|ADP servers.
These certificates should include your XSP|ADP public fully qualified domain name as Subject Common Name or Subject Alternate Name.
The exact requirements for deploying these server certificates depends on how your public facing XSP|ADPs are deployed:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Directly to the XSP|ADP
Il diagramma seguente riepiloga dove deve essere caricato il certificato del server pubblico firmato da CA in questi tre casi:
Le CA pubblicamente supportate che l'app Webex supporta per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per il proxy con bridge TLS
-
Il certificato del server firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta questo certificato server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
An internal CA signed certificate can be loaded onto the XSP|ADP.
-
The XSP|ADP presents this internally signed server certificate to the proxy.
-
The proxy trusts the internal CA that signed the XSP|ADP server certificate.
TLS Certificate Requirements for TLS-passthrough Proxy or XSP|ADP in DMZ
-
The publicly signed server certificate is loaded into the XSP|ADPs.
-
The XSP|ADPs present publicly signed server certificates to Webex.
-
Webex trusts the public CA that signed the XSP|ADPs’ server certificates.
Ulteriori requisiti di certificato per l'autenticazione TLS reciproca su interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione TLS reciproca. Il certificato CA/catena di certificati del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedere a Partner Hub, andare a Impostazioni >
collegamento di download del certificato.The exact requirements for deploying this Webex CA certificate chain depends on how your public facing XSP|ADPs are deployed:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Directly to the XSP|ADP
Il diagramma seguente riepiloga i requisiti dei certificati in questi tre casi:
(Opzione) Requisiti di certificato per proxy tls-bridge
-
Webex presenta un certificato client firmato pubblicamente al proxy.
-
Il proxy considera attendibile la CA interna Cisco che ha firmato il certificato client. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. The publicly signed XSP|ADP server certificate is also loaded into the proxy.
-
Il proxy presenta il certificato del server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
The proxy presents an internally signed client certificate to the XSP|ADPs.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3: Uso chiave estesa X509v3: 1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Il CN del certificato interno deve essere
bwcticlient.webex.com
.
-
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. Internal server certificates for the XSP|ADP can be SAN.
-
Le autorità di certificazione pubbliche potrebbero non voler firmare i certificati con il OID broadworks proprietario richiesto. In the case of a bridging proxy, you may be forced to use an internal CA to sign the client certificate that the proxy presents to the XSP|ADP.
-
-
The XSP|ADPs trust the internal CA.
-
The XSP|ADPs present an internally signed server certificate.
-
Il proxy considera attendibile la CA interna.
-
The Application Server’s ClientIdentity contains the CN of the internally signed client certificate presented to the XSP|ADP by the proxy.
(Option) Certificate Requirements for TLS-passthrough Proxy or XSP|ADP in DMZ
-
Webex presents a Cisco internal CA-signed client certificate to the XSP|ADPs.
-
The XSP|ADPs trust the Cisco internal CA that signed the client certificate. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. The publicly signed XSP|ADP server certificate is also loaded into the XSP|ADPs.
-
The XSP|ADPs present the publicly signed server certificates to Webex.
-
Webex trusts the public CA that signed the XSP|ADPs’ server certificates.
-
The Application Server ClientIdentity contains the CN of the Cisco-signed client certificate presented to the XSP|ADP by Webex.
Preparazione della rete
For more information on connections that are used by Webex for Cisco BroadWorks, see: Network Requirements for Webex for Cisco BroadWorks. This article has the list of IP addresses, ports and protocols required to configure your firewall Ingress and Egress rules.
Requisiti di rete per i servizi Webex
Le tabelle del firewall in entrata ed uscita precedenti documenta solo le connessioni specifiche per Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico a Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e come ciascuna sezione è relativa a Webex per Cisco BroadWorks.
Sezione dell'articolo requisiti di rete |
Gestione delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex |
Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud |
Informativo |
È necessario leggere | |
È necessario leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex |
È necessario leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione |
Opzionale |
Servizi Webex per clienti FedRAMP |
N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedere Whitepaper (PDF) del firewall appWebex.
Supporto ridondanza BroadWorks
The Webex Cloud Services and the Webex Client Apps that need to access the partner’s network fully support the Broadworks XSP|ADP redundancy provided by the partner. When an XSP|ADP or site is unavailable for planned maintenance or unplanned reason, the Webex services & apps are able to advance to another XSP|ADP or site provided by the partner in order to complete a request.
Topologia di rete
The Broadworks XSP|ADPs can be deployed directly on the Internet, or can reside in a DMZ fronted by a load balancing element such as the F5 BIG-IP. To provide geo-redundancy, the XSP|ADPs can be deployed in two (or more) datacenters, each can be fronted by a load balancer, each having a public IP address. If the XSP|ADPs are behind a load balancer, the Webex microservices and App see only the IP address of the load balancer and Broadworks appears to have just one XSP|ADP, even if there are multiple XSP|ADPs behind.
In the example below, the XSP|ADPs are deployed at two sites, Site A and Site B. There are two XSP|ADPs fronted by a Load Balancer at each site. Site A has XSP|ADP1 and XSP|ADP2 fronted by LB1, and Site B has XSP|ADP3 and XSP|ADP4 fronted by LB2. Only the Load Balancers are exposed on the public network, and the XSP|ADPs are in the DMZ private networks.
Servizi Cloud Webex
Configurazione DNS
The Webex Cloud microservices must be able to find the Broadworks XSP|ADP server(s) for connecting to the Xsi interfaces, authentication service and CTI.
Webex Cloud microservices will perform DNS A/AAAA lookup of the configured XSP|ADP hostname and connect to the returned IP Address. This could be a load balancing edge element, or it could be the XSP|ADP server itself. Se vengono restituiti più indirizzi IP, verrà selezionato il primo IP nell'elenco. SRV ricerca non sono attualmente supportate.
Esempio: The partner’s DNS A Record for discovery of Round-Robin balanced internet-facing XSP|ADP server/Load Balancers.
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (Sito A) |
R |
|
|
Punti a LB2 (Sito B) |
Any reference to XSP includes either XSP or ADP. |
Failover
When the Webex microservices send a request to the XSP|ADP/Load Balancer and the request fails, several things can happen:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un avanzamento di route al successivo IP.
-
If an error code (HTTP 5xx) is returned, the Webex microservices mark the IP as blocked and immediately perform a route advance to the next IP.
-
Se non si riceve alcuna risposta HTTP entro 2 secondi, si verifica un timeout della richiesta e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento all'IP successivo.
Ogni richiesta viene provata 3 volte prima che un problema venga segnalato al microservizio.
When an IP is in the blocked list, it will not be included in the list of addresses to try when sending a request to a XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna all'elenco per riprovare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco dei contatti bloccati. Se tale indirizzo IP viene rimosso dall'elenco dei contatti bloccati.
Stato
The status of the connectivity of the Webex Cloud services to the XSP|ADPs or Load Balancers can be seen in Control Hub. In un cluster di chiamata BroadWorks, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
-
Azioni XSI
-
Eventi XSI
-
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Lo stato delle connessioni può essere:
-
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
-
Rosso: Quando tutti gli IP nella ricerca dei record A sono irraggiungibili e l'interfaccia non è disponibile.
The following services use the microservices to connect to the XSP|ADPs and are impacted by the XSP|ADP interface availability:
-
Accesso all'app Webex
-
Aggiornamento token app Webex
-
E-mail/attivazione automatica non attendibile
-
Controllo stato servizio Broadworks
Webex App
Configurazione DNS
The Webex App accesses the Xtended Services Interface (XSI-Actions & XSI-Events) and Device Management Service (DMS) services on the XSP|ADP.
To find the XSI service, the Webex App performs DNS SRV lookup for _xsi-client._tcp.<webex app xsi domain>
. The SRV points to the configured URL for the XSP|ADP hosts or load balancers for the XSI service. If SRV lookup is not available, the Webex App falls back to A/AAAA lookup.
The SRV can resolve to multiple A/AAAA targets. However, each A/AAAA record must map to a single IP address only. If there are multiple XSP|ADPs in a DMZ behind the load balancer/edge device, it is required that the load balancer be configured to maintain session persistence to route all requests of the same session to the same XSP|ADP. We mandate this configuration because the client's XSI-event heartbeats must go to the same XSP|ADP that is used to establish the event channel.
In Example 1, the A/AAAA record for webex-app-XSP|ADP.example.com does not exist, and does not need to. If your DNS requires that one A/AAAA record must be defined, then only 1 IP address should be returned. Regardless, the SRV must still be defined for the Webex App. If the Webex App uses the A/AAAA name that resolves to more than one IP address, or if the load balancer/edge element does not maintain session persistence, the client eventually sends heartbeats to an XSP|ADP where it did not establish an event channel. This results in the channel being torn down, and also in significantly more internal traffic which impairs your XSP|ADP cluster performance. Because the Webex Cloud and Webex App have different requirements in A/AAAA record lookup, you must use a separate FQDN for the Webex Cloud and Webex App to access your XSP|ADPs. As shown in the examples, Webex Cloud uses A record |
Example 1—Multiple XSP|ADPs, each behind separate load balancers
In this example, the SRV points to mutiple A records with each A record pointing to a different load balancer at a different site. The Webex App will always use the first IP address in the list and will only move to the next record if the first is down.
Di seguito è riportato un esempio di SRV record.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Example 2—Multiple XSP|ADPs behind a single load balancer (with TLS Bridge)
For the initial request, the load balancer selects a random XSP|ADP. That XSP|ADP returns a cookie that the Webex App includes in future requests. For future requests, the load balancer uses the cookie to route the connection to the correct XSP|ADP, ensuring that the event channel doesn't break.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Load balancer |
R |
LB.example.com |
|
IP address of load balancer (XSP|ADPs are behind load balancer) |
DMS URL
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il relativo file di configurazione. The host in the URL will parsed and the Webex App will perform DNS A/AAAA lookup of the host to connect to the XSP|ADP that hosts the DMS service.
Esempio: DNS A Record for discovery of Round-Robin balanced internet-facing XSP|ADP server/Load Balancers by Webex App to download config files through DMS:
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Any reference to XSP includes either XSP or ADP. |
How Webex App Finds XSP|ADP Addresses
The client attempts to locate the XSP|ADP nodes using the following DNS flow:
-
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (inserito durante la creazione del cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue SRV ricerca nel modo seguente:
-
Client performs an SRV lookup for _xsi-client._tcp.<xsi domain>
-
If the SRV lookup returns one or more A/AAAA targets:
-
Il client esegue una ricerca A/AAAA di tali destinazioni e memorizza nella cache gli indirizzi IP restituiti.
-
Il client si connette a uno dei destinazioni (e pertanto, il relativo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi avere lo stesso peso (o a caso se tutti sono uguali).
-
-
Se la ricerca SRV ricerca non restituisce eventuali obiettivi:
Il client esegue una ricerca A/AAAA del parametro radice Xsi, quindi tenta di connettersi all'indirizzo IP restituito. This could be a load balancing edge element, or it could be the XSP|ADP server itself.
Come specificato, il record A/AAAA deve risolversi in un indirizzo IP per gli stessi motivi.
-
-
(Opzionale) In un secondo tempo, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocols> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
-
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
-
Se esistono, il client verrà confrontato con l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
-
Se vengono rilevate eventuali differenze, il client inizializza nuovamente la connettività XSI Actions/ XSI Events. The first step in this is to perform the same DNS lookup process listed under step 1 – this time requesting a lookup for the value in the %XSI_ROOT_WXT% parameter from its configuration file.
Creare i record delle SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
-
Failover
During login, the Webex App performs a DNS SRV lookup for _xsi-client._tcp.<xsi domain>, builds a list of hosts, and connects to one of the hosts based on the SRV priority, then weight. Questo ospite connesso diventa il selezionato per tutte le richieste future. Un canale di evento viene quindi aperto all'organizzatore selezionato e un heartbeat viene inviato regolarmente per verificare il canale. All requests sent after the first one include a cookie that is returned in the HTTP response, therefore, it’s important that the load balancer keeps session persistence (affinity) and always sends requests to the same backend XSP|ADP server.
In caso di errore di una richiesta o di una richiesta heartbeat a un host, si possono verificare diverse operazioni:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), l'instradazione dell'app Webex avanza immediatamente al successivo organizzatore nell'elenco.
-
If an error code (HTTP 5xx) is returned, the Webex App marks that IP address as blocked and route advances to the next host on the list.
-
Se non si riceve una risposta entro un determinato periodo di tempo, la richiesta viene considerata non riuscita a causa di un timeout e le successive richieste vengono inviate all'organizzatore successivo. Tuttavia, la richiesta di timeout viene considerata come non riuscita. Si è verificato un tentativo in seguito ad alcune richieste in seguito a un errore (con un aumento del tempo di tentativo). Non si sono effettuate nuovamente richieste che presupponete non vitali.
Quando si prova correttamente un nuovo organizzatore, diventa il nuovo organizzatore selezionato, se è presente nell'elenco. Una volta tentato l'ultimo organizzatore nell'elenco, l'app Webex viene rollover a quella del primo.
In caso di heartbeat, se ci sono due errori di richiesta consecutivi, l'app Webex inizializza nuovamente il canale dell'evento.
Tenere presente che l'app Webex non esegue il fail-back e il rilevamento del servizio DNS viene eseguito una sola volta all'accesso.
During sign-in, the Webex App tries to download the config file through the XSP|ADP/Dms interface. Esegue una ricerca dei record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Si tenterà prima di inviare la richiesta di download del file di configurazione utilizzando un token SSO configurazione. Se questo non riesce, verrà riprovare ma con il nome utente e la password del dispositivo.
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning utente. Molte attività sono comuni a tutte le modalità di provisioning.
Accesso ai partner per Webex per Cisco BroadWorks
Ogni Webex per Cisco BroadWorks provider di servizi o rivenditore necessita di un da impostare come organizzazione partner per Webex per Cisco BroadWorks. È possibile utilizzare questa opzione se si dispone di un'organizzazione partner Webex esistente.
Per completare il necessario onboarding, è necessario eseguire i documenti di Webex Cisco BroadWorks e i nuovi partner devono accettare il Contratto di partner per i canali indiretti online (ICPA). Al termine di questa procedura, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore del record come richiesto. Contemporaneamente, si verrà contattati dal Proprio Partner Activation e/o Customer Success Program Manager per avviare il proprio onboarding.
Webex Partners in one region can create customer organizations in any region that we offer the services. Per informazioni, vedere: Data residency in Webex. |
Configure Services on Your Webex for Cisco BroadWorks XSP|ADPs
We require that the NPS application be run on a different XSP|ADP. Requirements for that XSP|ADP are described in Configure Call Notifications from your Network.
You need the following applications / services on your XSP|ADPs.
Servizio/Applicazione |
Autenticazione richiesta |
Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
Autenticazione utente |
Integrazione di telefonia su computer |
mTLS (client e server si autenticano l'un l'altro) |
Presenza in telefonia |
Impostazioni chiamata Applicazione vista Web |
TLS (il server esegue l'autenticazione per i client) |
Sono esposti le impostazioni di chiamata dell'utente nel portale auto assistenza all'interno dell'app Webex |
This section describes how to apply the required configurations for TLS and mTLS on these interfaces, but you should reference existing documentation to get the applications installed on your XSP|ADPs.
Requisiti di co-residenza
-
Il servizio di autenticazione deve risiedere insieme ad applicazioni Xsi, poiché tali interfacce devono accettare token lunghi per l'autorizzazione del servizio. Il servizio di autenticazione è necessario per convalidare tali token.
-
Il servizio di autenticazione e Xsi possono essere eseguiti sulla stessa porta, se richiesta.
-
You may separate the other services/applications as required for your scale (dedicated device management XSP|ADP farm, for example).
-
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
-
Do not install other applications or services on the XSP|ADPs that are used for integrating BroadWorks with Webex.
-
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi connettori Cisco BroadWorks.
Only one instance of the Xsi-Events applications should be deployed on the XSP|ADP used for the CTI interface.
All Xsi-Events used for integrating Broadworks with Webex must have the same callControlApplicationName defined under Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
When a user is onboarded to Webex, Webex creates a subscription for the user on the AS in order to receive telephony events for presence and call history. The subscription is associated with the callControlApplicationName and the AS uses it to know to which Xsi-Events to send the telephony events.
Changing the callControlApplicationName, or not having the same name on all Xsi-Events webapps will impact subscriptions and telephony events functionality. |
Configurazione del servizio di autenticazione (con convalida token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida di token CI con TLS. Questo metodo di autenticazione è consigliato se si utilizza R22 o superiore e il sistema supporta tale opzione.
L'autenticazione TLS reciproca (mTLS) è supportata anche come metodo di autenticazione alternativo per il servizio di autenticazione. If you have multiple Webex organizations running off the same XSP|ADP server, you must use mTLS authentication because CI Token Validation does not support multiple connections to the same XSP|ADP Auth Service. Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida di token CI, fare riferimento all'Appendice per la configurazione dei servizi (con mTLS per il servizio diautenticazione). |
Se attualmente si utilizza mTLS per il servizio di autenticazione, non è obbligatorio riconfigurare l'uso della convalida del token CI con TLS. |
-
Obtaining OAuth credentials for your Webex for Cisco BroadWorks.
-
Install the following patches on each XSP|ADP server. Installare le patch appropriate alla release in oggetto:
-
Per R22:
-
Per R23:
-
Per R24— nessuna patch richiesta
Any reference to XSP includes either XSP or ADP. -
-
Install the
AuthenticationService
application on each XSP|ADP service.Run the following command to activate the AuthenticationService application on the XSP|ADP to the /authService context path.
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
Run this command to deploy the AuthenticationService on the XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
-
Starting with Broadworks build 2022.10, the certificates authorities that are coming with Java are no longer automatically included to the BroadWorks trust store when switching to a new version of java. The AuthenticationService opens a TLS connection to Webex to fetch the access token, and needs to have the following in its truststore to validate the IDBroker and Webex URL:
-
Radice commerciale IdenTrust CA 1
-
Autorità di certificazione radice di Go Daddy-G2
Verify that these certificates are present under the following CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get
If not present, run the following command to import the default Java trusts:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
Alternatively, you can manually add these certificates as trust anchors with the following command:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
If the ADP is upgraded from a previous release, then the certificate authorities from the old release are automatically imported to the new release and will continue to be imported until they are manually removed.
The AuthenticationService application is exempt from the validatePeerIdentity setting under ADP_CLI/System/SSLCommonSettings/GeneralSettings, and always validates the peer Identity. See the Cisco Broadworks X509 Certificate Validation FD for more info on this setting.
-
-
Configure the Identity Providers by running the following commands on each XSP|ADP server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get
-
set clientId client-Id-From-Step1
-
set enabled true (impostazione abilitata) vero
-
set clientSecret client-Secret-From-Step1
-
impostazione di ciResponseBodyMaxSizeInBytes 65536
-
set issuerName <URL>
—For theURL
, enter the IssuerName URL that applies to your CI Cluster. See following table. -
set issuerUrl <URL>
—For theURL
, enter the IssuerUrl that applies to your CI Cluster. See the following table. -
set tokenInfoUrl <IdPProxy URL>
—Enter the IdP Proxy URL that applies to your Teams Cluster. See the second table that follows.
Tabella 1. Set issuerName and issuerURL Se Cluster CI è... Set issuerName and issuerURL to... USA-A
UE
USA-B
If you don't know your CI Cluster, you can obtain the information from the Customer details in Help Desk view of Control Hub.Tabella 2. Set tokenInfoURL Se Cluster Teams è... Set tokenInfoURL to...(IdP Proxy URL) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Afra
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
-
If you don't know your Teams Cluster, you can obtain the information from the Customer details in the Help Desk view of Control Hub.
-
For testing, you can verify that the tokenInfoURL is valid by replacing the "
idp/authenticate
" portion of the URL with "ping
".
-
-
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user
-
Configure Identity Providers for Cisco Federation using the following commands on each XSP|ADP server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get
-
impostazione flsUrl https://cifls.webex.com/federation
-
impostare refreshPeriodInMinutes 60
-
set refreshToken refresh-Token-From-Step1
-
-
Eseguire il comando seguente per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get
-
Configure Token Management using the following commands on each XSP|ADP server:
-
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
-
set tokenIsshe BroadWorks
-
impostare tokenDurationInHours 720
-
-
Generare e condividere le chiavi RSA. You must generate keys on one XSP|ADP then copy them to all other XSP|ADPs. Ciò è dovuto ai seguenti fattori:
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittografia di token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
If you cycle keys or change the key length, you need to repeat the following configuration and restart all the XSP|ADPs.-
Select one XSP|ADP to use for generating a key pair.
-
Use a client to request an encrypted token from that XSP|ADP, by requesting the following URL from the client’s browser:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(This generates a private / public key pair on the XSP|ADP, if there wasn’t one already)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
-
Copy the exported file
/var/broadworks/tmp/authService.keys
to the same location on the other XSP|ADPs, overwriting an older.keys
file if necessary. -
Import the keys on each of the other XSP|ADPs:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
-
-
Fornire l'URL authService al contenitore Web. The XSP|ADP’s web container needs the authService URL so it can validate tokens. On each of the XSP|ADPs:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per lo strumento di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Controllare il parametro con
get
. -
Restart the XSP|ADP.
-
Rimozione del requisito di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con convalida token CI su R24, occorre anche rimuovere il requisito di autenticazione del client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e della crittografia sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurazione TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > trasporto > http > interfaccia Server HTTP = Più specifico
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Reading HTTP Server TLS Interface Configuration on the XSP|ADP
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il
comando get e leggere i
risultati. Dovrebbero essere presenti le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Tomcat obbligatorio un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
È necessario configurare l'interfaccia HTTP che interagisce con Webex Cloud per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Enter the command
get <interfaceIp> 443
to see which protocols are already used on this interface. -
Enter the command
add <interfaceIp> 443 TLSv1.2
to ensure that interface can use TLS 1.2 when communicating with the cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia del server HTTP
Per configurare i crittografia richiesti:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Enter the command
get <interfaceIp> 443
to see which ciphers are already used on this interface. There must be at least one from the Cisco recommended suites (see XSP|ADP Identity and Security Requirements in the Overview section). -
Enter the command
add <interfaceIp> 443 <cipherName>
to add a cipher to the HTTP Server interface.
The XSP|ADP CLI requires the IANA standard cipher suite name, not the openSSL cipher suite name. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
del server HTTP, utilizzare:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configure Device Management on XSP|ADP, Application Server, and Profile Server
Profile Server and XSP|ADP are mandatory for Device Management. Tali impostazioni devono essere configurate in base alle istruzioni nella Guida alla configurazione di Gestione dispositivi BroadWorks.
Interfaccia CTI e configurazione correlata
L'ordine di configurazione "in primo piano" è elencato di seguito. I seguenti ordini non sono obbligatori.
-
Configurazione del server applicazioni per sottoscrizioni CTI
-
Configure XSP|ADPs for mTLS Authenticated CTI Subscriptions
-
Porte in entrata aperte per interfaccia CTI sicura
-
Sottoscrizione della propria organizzazione Webex a BroadWorks CTI Events
Configurazione del server applicazioni per sottoscrizioni CTI
Aggiornare clientIdentity sul server applicazioni con il nome comune (CN) del Webex per il certificato client CTI Cisco BroadWorks.
Per ogni server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity nel modo seguente:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
The common name of the Webex for Cisco BroadWorks client certificate is |
Configurare TLS e i tipi di crittografia sull'interfaccia CTI
The levels of configurability for the XSP|ADP CTI interface are as follows:
Più generale = Sistema > trasporto > CTI > interfaccia CTI = Più specifiche
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità |
Contesto CLI |
---|---|
Sistema (globale) (R22 e successive) |
XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e successive) |
XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e successive) |
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocols> |
Un'interfaccia CTI specifica su questo sistema (R22 e successive) |
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocols> |
On a fresh install, the following ciphers are installed by default at the system level. If nothing is configured at the interface level (for example, at the CTI interface or HTTP interface), this cipher list applies. Note that this list may change over time:
|
Reading CTI TLS Interface Configuration on the XSP|ADP
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserire il
comando get e leggere i
risultati. Dovrebbero essere disponibili le interfacce (indirizzi IP) e, per ciascuna, se richiedono un certificato del server e se richiedono o meno l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
The XSP|ADP CTI interface that is interacting with the Webex Cloud must be configured for TLS v1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
-
Enter the command
get <interfaceIp>
to see which protocols are already used on this interface. -
Enter the command
add <interfaceIp> TLSv1.2
to ensure that interface can use TLS 1.2 when communicating with the cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia CTI
Per configurare i tipi di crittografia richiesti sull'interfaccia CTI:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
-
Immettere il
comando get per visualizzare i tipi di crittografia già utilizzati su questa
interfaccia. There must be at least one from the Cisco recommended suites (see XSP|ADP Identity and Security Requirements in the Overview section). -
Enter the command
add <interfaceIp> <cipherName>
to add a cipher to the CTI interface.
The XSP|ADP CLI requires the IANA standard cipher suite name, not the openSSL cipher suite name. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
CTI, utilizzare:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Trust Anchors for CTI Interface (R22 and later)
This procedure assumes the XSP|ADPs are either internet-facing or face the internet via pass-through proxy. La configurazione del certificato è diversa per un proxy di bridging (vedere Requisiti di certificato TLS per proxy TLS-bridge).
For each XSP|ADP in your infrastructure that is publishing CTI events to Webex, do the following:
-
Accedere all'hub partner.
-
Go to Settings > BroadWorks Calling and click Download Webex CA Certificate to get
CombinedCertChain2023.txt
on your local computer.
These files contain two sets of two certificates. You need to split the files before you upload them to the XSP|ADPs. All files are required.
-
Split the certificate chain into two certificates -
combinedcertchain2023.txt
-
Open
combinedcertchain2023.txt
in a text editor. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e -----END CERTIFICATE----- , e incollare il blocco di testo in un nuovo
file. -
Save the new file as
root2023.txt
. -
Save the original file as
issuing2023.txt
. Il file originale ora deve contenere solo un blocco di testo, racchiuso tra lerighe -----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copy both text files to a temporary location on the XSP|ADP you are securing, e.g.
/var/broadworks/tmp/root2023.txt
and/var/broadworks/tmp/issuing2023.txt
-
Sign in to the XSP|ADP and navigate to
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
-
(Opzionale) Eseguire
help updateTrust
per visualizzare i parametri e il formato del comando. -
Upload the certificate files to new trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
All aliases must have a different name.
webexclientroot2023
, andwebexclientissuing2023
are example aliases for the trust anchors; you can use your own as long as all entries are unique. -
Confermare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
-
Consenti ai client di eseguire l'autenticazione con certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Aggiungi interfaccia CTI e abilita mTLS
-
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione di BroadWorks. Il comando crea un certificato del server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
-
-
Replace the server certificate and key on the XSP|ADP's CTI interfaces. A tale scopo, è necessario l'indirizzo IP dell'interfaccia CTI. è possibile leggerla dal contesto seguente:
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Quindi, eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>
-
-
Restart the XSP|ADP.
Abilitazione dell'accesso agli eventi CTI BroadWorks su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Vedere Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Vedere Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
-
Specificare l'indirizzo CTI tramite il quale Webex può eseguire la sottoscrizione a BroadWorks CTI Events.
-
Gli abbonamenti CTI sono su base per-abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato è predisposto per Webex per Cisco BroadWorks.
Vista Web impostazioni chiamata
Call Settings Webview (CSWV) is an application hosted on XSP|ADP to enable users to modify their BroadWorks call settings through a webview that they see in the soft client. See the Cisco BroadWorks Call Settings Webview Solution Guide.
Webex makes use of this feature to provide users with access to common BroadWorks call settings that are not native to the Webex App.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedono alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, distribuire la funzione di visualizzazione Webview Impostazioni chiamata.
La vista Webview Impostazioni chiamata presenta due componenti:
-
Call Settings Webview application, hosted on a Cisco BroadWorks XSP|ADP.
-
The Webex App, which renders the call settings in a Webview.
Esperienza utente
-
Utenti Windows: Click Call Settings and then click .
-
Utenti Mac: Click profile picture, then
.
Distribuzione di CSWV su BroadWorks
Install Call Settings Webview on XSP|ADPs
CSWV application must be on the same XSP|ADP(s) that host the Xsi-Actions interface in your environment. It is an unmanaged application on XSP|ADP, so you need to install and deploy a web archive file.
-
Sign in to cisco.com and search for "BWCallSettingsWeb" in the software download section.
-
Individuare e scaricare la versione più recente del file.
For example,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) was the most recent at the time of writing. -
Install, activate, and deploy the web archive according to the Cisco BroadWorks Xtended Service Platform Configuration Guide for your XSP|ADP version. (Versione R24 è https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
-
Copy the .war file to a temporary location on the XSP|ADP, such as
/tmp/
. -
Passare al seguente contesto CLI ed eseguire il comando install:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war
Il software manager BroadWorks convalida e installa il file.
-
[Optional] Delete
/tmp/BWCallSettingsWeb_1.7.5_1.war
(this file is no longer required). -
Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario anche fornire un contextPath poiché è un'applicazione supportata. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione; ad esempio,
/callsettings
. -
Distribuire l'applicazione Impostazioni chiamata nel percorso del contesto selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
-
-
Ora è possibile prevedere l'URL delle impostazioni di chiamata che verrà specificato per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
-
Specificare la barra finale su questo URL quando questo viene immesso nel file di configurazione del client.
-
The XSP|ADP-FQDN must match the Xsi-Actions FQDN, because CSWV needs to use Xsi-Actions, and CORS is not supported.
-
-
Repeat this procedure for other XSP|ADPs in your Webex for Cisco BroadWorks environment (if necessary).
The Call Settings Webview application is now active on the XSP|ADPs.
Configure the Webex App to use Call Settings Webview
For more detail on client configuration, see Webex for Cisco BroadWorks Configuration Guide.
Il file di configurazione dell'app Webex contiene un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. This URL shows the call settings to the users through the application interface.
<config> <services> <web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%"> <url>%WEB_CALL_SETTINGS_URL_WXT%</url> </web-call-settings>
In the Webex app configuration template on BroadWorks, configure the CSWV URL in the %WEB_CALL_SETTINGS_URL_WXT% tag.
If you don't explicitly specify the URL, the default is empty and the call settings page isn't visible to the users.
-
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
-
Impostare la destinazione per le impostazioni di chiamata Web
su
csw:%WEB_CALL_SETTINGS_TARGET_WXT% csw
-
Impostare l'URL delle impostazioni di chiamata Web per il proprio ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/
You derived this value when deploying the CSWV application.
-
The resulting client configuration file should have an entry as follows:
<web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>
Any reference to XSP includes either XSP or ADP.
Configurazione delle notifiche push di chiamata in Webex per Cisco BroadWorks
In questo documento, viene utilizzato il termine Server push di notifiche di chiamata (CNPS) per descrivere un'applicazione ospitata da XSP o ospitata ad ADP che viene eseguita nel proprio ambiente. IL CNPS collabora con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti ed invia le notifiche di tali notifiche ai servizi di notifica FCM (Google Firebase Cloud Messaging) o APNs (Apple Push Notification).
Tali servizi notificano ai dispositivi mobili di Webex per gli abbonati Cisco BroadWorks la loro chiamata in arrivo su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzionalità del server push dinotifica.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi notificano, a loro volta, gli utenti Webex mobili dei messaggi in arrivo o delle modifiche alla presenza.
In questa sezione viene descritto come configurare NPS per il proxy di autenticazione quando il server NPS non supporta già altre app. Se occorre eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di NPS Cisco BroadWorks per l'uso del proxy https://help.webex.com/nl5rir2/NPS. |
Panoramica proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, il CNPS deve essere patchto per supportare la funzione proxy NPS, Push Server per le VoIP in UCaaS.
La funzione implementa un nuovo design nel server push di notifica per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private del certificato di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e le chiavi di notifica push con il provider di servizi, il server NPS utilizza una nuova API per ottenere un token di notifica push breve da Webex per il backend Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APNs Apple e i servizi Google FCM.
La funzione migliora anche la funzionalità del server push di notifica per eseguire il push delle notifiche sui dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
-
Per ulteriori informazioni, vedere il Server push per VoIP funzionalità in Descrizione funzionalità UCaaS.
-
The BroadWorks patches for the feature are available on: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
For NPS software and patches, see the section Prepare Your NPS for Webex for Cisco BroadWorks.
Search and download the patch from the software download page.
-
Ulteriori informazioni sul server ADP sono disponibili su https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni su APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio di notifica push Apple dopo il 31 marzo 2021. We recommend that you configure your XSP|ADP to use the HTTP/2-based interface for APNs. This update requires that your XSP|ADP hosting the NPS be running R22 or later.
Preparazione del sistema NPS per Webex per Cisco BroadWorks
1 |
Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma ADP (Application Delivery Platform). | ||
2 |
Installare le patch del proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: | ||
3 |
Attivare l'applicazione server push di notifica. | ||
4 |
(Per le notifiche Android) Abilitare l'API FCM v1 su NPS.
| ||
5 |
(Per notifiche Apple iOS) Abilitare HTTP/2 su NPS.
| ||
6 |
Allegare un supporto tecnico da NPS XSP/ADP. | ||
7 |
On each AS server, the namedefs file in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN A 10.193.78.149
|
Operazione successivi
For fresh installs of an NPS, go to Configure NPS to Use Authentication Proxy
To migrate an existing Android deployment to FCMv1, go to Migrate NPS to FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicato a Webex per Cisco BroadWorks.
If you want to configure the authentication proxy on an NPS that is shared with other mobile apps, see Updating Cisco BroadWorks NPS to Use NPS Proxy ( https://help.webex.com/nl5rir2).
1 |
Obtaining OAuth credentials for your Webex for Cisco BroadWorks. | |||||||||||||||||||
2 |
Creare l'account client su NPS:
To verify the values you entered match with what you were given, run
| |||||||||||||||||||
3 |
Inserire l'URL del proxy NPS e impostare l'intervallo di aggiornamento del token (è consigliato 30 minuti):
| |||||||||||||||||||
4 |
(Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 |
(Per notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, facendo in modo di omettere la chiave di autenticazione, impostarlo come vuoto.
| |||||||||||||||||||
6 |
Configurare i seguenti URL NPS:
| |||||||||||||||||||
7 |
Configurare i seguenti parametri di connessione NPS in base ai valori consigliati riportati:
| |||||||||||||||||||
8 |
Controllare se il server dell'applicazione è un ID applicazione elettronica, poiché potrebbe essere necessario aggiungere le app Webex all'elenco dei consentiti: | |||||||||||||||||||
9 |
Restart the XSP|ADP: | |||||||||||||||||||
10 |
Testare le notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migra NPS in FCMv1
Questo argomento contiene le procedure opzionali che è possibile utilizzare nella console FCM di Google quando si dispone di una distribuzione NPS esistente che occorre eseguire la migrazione a FCMv1. Sono disponibili tre procedure:
-
Migrate UC-One clients to FCMv1—When you have existing UCaaS clients and need to migrate them to use FCMv1.
-
Migrate SaaS Clients to FCMv1—When you have existing SaaS clients and need to migrate them to use FCMv1.
-
Update ADP Server—When you are migrating the NPS to an ADP server.
Migrate UC-One Clients to FCMv1
Use the below steps in Google FCM Console to migrate UC-One clients to Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere Impostazioni progetto > . L'impostazione viene visualizzata nella tabella delle credenziali del progetto.For details, see the Connect Mobile Branding Guide at https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Refer to the
|
-
Accedere all'SDK di amministrazione FCM su http://console.firebase.google.com.
-
Selezionare l'applicazione Android appropriata.
-
Nella scheda Generale, registrare l'ID progetto
-
Passare alla scheda degli account di servizio per configurare un account di servizio. È possibile creare un nuovo account di servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
-
Fare clic sul pulsante blu per creare un nuovo account di servizio
-
Fare clic sul pulsante blu per generare una nuova chiave privata
-
Scarica chiave in una posizione protetta
Per riutilizzare un account di servizio esistente:
-
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
-
Identificare l'account del servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
-
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
-
Scaricare il file json contenente la chiave e salvarlo in una posizione protetta.
-
-
Copy the json file onto the XSP|ADP.
-
Configurare ID progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== my_project ********
-
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project
-
Abilitare FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
-
Run the
bwrestart
command to restart the XSP|ADP.
Migrare i client SaaS in FCMv1
Utilizzare le operazioni seguenti su Google FCM Console se si desidera migrare i client SaaS a FCMv1.
Accertarsi di aver già completato la procedura "Configurazione di NPS per l'uso del proxy di autenticazione". |
-
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done
-
Run the
bwrestart
command to restart the XSP|ADP. -
Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
-
Run the
bwrestart
command to restart the XSP|ADP.
Aggiorna server ADP
Utilizzare la procedura seguente in Google FCM Console se si sta migrando il server NPS per l'uso di un server ADP.
-
Ottenere il file JSON dalla console di Google Cloud:
-
Nella console di Google Cloud, andare alla pagina Account di servizio.
-
Fare clic su Seleziona un progetto , scegliere il progetto e fare clic su Apri .
-
Find the row of the service account that you want to create a key for, click the More vertical button, then click Create key.
-
Select a Key type and click Create
Il file viene scaricato.
-
-
Aggiungere FCM al server ADP:
-
Importare il file JSON nel server ADP utilizzando il
comando /bw/install.
-
Accedere alla CLI ADP e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON
: -
Successivamente, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
-
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
-
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Questa operazione viene eseguita per i seguenti motivi:
-
To enable Webex cloud to authenticate your users against BroadWorks (via XSP|ADP-hosted authentication service).
-
Per abilitare le app Webex per l'uso dell'interfaccia Xsi per il controllo chiamate.
-
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza in telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiungete. È possibile continuare a modificare il cluster se una delle interfacce non viene convalidata correttamente, ma non è possibile salvare un cluster se sono presenti voci nonvalide. Questo problema è impedito poiché un cluster configurato non correttamente può provocare problemi che sono difficili da risolvere. |
Cosa è necessario fare:
-
Accedere all'hub del partner (admin.webex.com) con le credenziali dell'amministratore del partner.
-
Aprire la pagina Impostazioni dal menu laterale e individuare le impostazioni per la chiamata BroadWorks.
If the admin user does not have visibility of the BroadWorks Calling settings, it is recommended that you must open a case with Cisco TAC.
-
Fare clic su Add Cluster (Aggiungicluster).
This launches a wizard where you supply your XSP|ADP interfaces (URLs). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
-
Assegnare un nome a questo cluster e fare clic su Next(Avanti).
The cluster concept here is simply a collection of interfaces, typically collocated on an XSP|ADP server or farm, that enable Webex to read information from your Application Server (AS). You may have one XSP|ADP per AS cluster, or multiple XSP|ADPs per cluster, or multiple AS clusters per XSP|ADP. I requisiti di scalabilità per il sistema BroadWorks non sono disponibili qui.
-
(Opzionale) Inserire un nome account utente BroadWorks e una password all'interno del sistema BroadWorks che si sta collegando a Webex, quindi fare clic su Next(Avanti).
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
-
Aggiungere gli URL delle azioni XSI e degli eventi XSI.
-
Opzionale. Update the DAS URL with the URL of the Device Activation Service.
-
Opzionale. Check the Enable direct BroadWorks authentication check box if you want logins to BroadWorks to be direct to BroadWorks. Otherwise, authentication to BroadWorks is proxied through the Webex-hosted IdP proxy service.
This check box affects these login situations:
-
User Activation Portal login—Users must enter their BroadWorks credentials when logging in to the portal. The above setting determines if the login is direct to BroadWorks or is through the IdP Proxy.
-
Client Login—If BroadWorks Authentication is configured in the Onboarding template, the above setting determines if client login to the Webex App is direct to BroadWorks or is proxied through the IdP Proxy.
-
-
Fare clic su Avanti.
-
Nella pagina Interfaccia CTI, effettuare le seguenti operazioni:
-
Aggiungere l'URL E la porta CTI per l'interfaccia CTI a cui si desidera eseguire la connessione.
-
Opzionale. Enable the Call History toggle and then enter your BroadWorks user ID. When this option is selected, BroadWorks call history events get synced to the Webex cloud. Gli utenti possono visualizzare le cronologia chiamate nell'app Webex.
-
Opzionale. Enable the Do not disturb (DND) sync toggle and then enter your BroadWorks user ID. This option syncs DND events between Webex and BroadWorks, ensuring that the feature works the same on both platforms.
-
Fare clic su Avanti.
-
-
Aggiungere l'URL del servizio di autenticazione.
-
Selezionare Servizio autenticazione con convalida token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex, poiché il servizio di autenticazione convalida correttamente il token utente in base al servizio di identità Webex prima di elacere il token di lungo termine all'utente.
-
Esaminare le voci visualizzate nella schermata finale e fare clic su Crea. Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Partner Hub passa gli URL a diversi microservizi Webex che verificano le connessioni alle interfacce fornite.
-
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è stata eseguita correttamente.
-
Il pulsante Crea potrebbe essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, si verifica un problema con una delle integrazioni appena configurate.
Questo controllo è stato implementato per evitare errori nelle attività successive. You can go back through the wizard as you configure your deployment, which may require modifications to your infrastructure (e.g. XSP|ADP, load balancer, or firewall) as documented in this guide, before you can save the template.
Verifica delle connessioni alle interfacce BroadWorks
-
Accedere all'hub del partner (admin.webex.com) con le credenziali dell'amministratore del partner.
-
Aprire la pagina Impostazioni dal menu laterale e individuare le impostazioni per la chiamata BroadWorks.
-
Fare clic su View Clusters (Visualizzacluster).
-
Partner Hub avvia test di connettività da diversi microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina di elenco dei cluster mostra un messaggio di stato accanto a ciascun cluster.
Dovrebbero essere visualizzati messaggi di Operazione riuscita in verde. Se viene visualizzato un messaggio di errore rosso, fare clic sul nome del cluster interessato per visualizzare quale impostazione causa il problema.
-
Opzionale. Select a cluster if you want to see existing settings for that cluster, such as XSI-Actions, XSI-Events, DAS URL and the CTI interface settings.
Configure your Onboarding templates
Onboarding templates are the way that you will apply shared configuration to one or more customers as you onboard them via the provisioning methods. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma a un cliente può essere associato un solo modello.
-
Sign in to the Partner Hub and select Customers.
-
Click the Onboarding templates button to view the existing templates.
-
Click Create Template.
-
In the Template Details window, add the Template name, Country or Region and Default email Language.
-
Click the drop-down for the CCW Subscription ID, find the listed subscriptions for the partner, and select the applicable subscription.
This field is shown only for partners migrated from Webex for BroadWorks to Webex. -
In the Service Setting window, use the Cluster dropdown to choose the cluster you want to use with this template.
-
Inserire un Nomemodello, quindi fare clic su Avanti.
-
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per diverse modalità di provisioning Nome impostazione
Provisioning Flow con e-mail attendibili
Provisioning flow senza messaggi e-mail
Self-provisioning utente
Enable BroadWorks Flow Through Provisioning (include provisioning account credentials if On**)
Attivato
Specificare il nome account e la password di provisioning in base alla configurazione BroadWorks.
Attivato
Specificare il nome account e la password di provisioning in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
On†
On†
On†
Indirizzo e-mail provider servizi
Selezionare un indirizzo e-mail dal menu a discesa (è possibile digitare alcuni caratteri per individuare l'indirizzo se è un elenco lungo).
This email address identifies the administrator within your Partner organization who will be granted delegated admin access to any new customer organizations created with the Onboarding template.
Paese
Scegliere il paese utilizzato per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione può essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature paese-regione in questo foglio dicalcolo.
The organization country will determine the default global call-in numbers for Cisco PSTN in Webex Meeting Sites. Refer to the Country section of help page for more information.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti predisposti con questo modello sono aziende in BroadWorks.
Se sono gruppi, uscire da questo interruttore.
Se si dispone di una combinazione di aziende e gruppi nella broadworks, è necessario creare modelli diversi per i diversi casi.
Note della tabella:
-
† questo switch assicura che viene creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questo valore deve essere sempre attivo, a meno che non si utilizzi un processo di ordinazione e ordinazione manuale (tramite Cisco Commerce Workspace) per creare organizzazioni cliente in Webex (prima di iniziare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso definita come modello di provisioning ibrido ed è fuori dall'ambito di questo documento.
-
** "Provisioning account" refers to the BroadWorks system-level admin account. On BroadWorks, you need an admin account with these attributes: Administrator Type=Provisioning, Read-only=Off.
-
-
Selezionare il pacchetto dei servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Basic , Standard , Premium o Softphone.
È possibile ignorare questa impostazione per i singoli utenti tramite Partner Hub.
-
Opzionale. Check Disable Cisco Webex Free Calling if you want to disable Webex Calls,.
-
Per Configurazione partecipazione ariunione, selezionare una delle seguenti opzioni:
-
Numeri chiamata in accesso Cisco (PSTN)
-
Partner-provided Call-in Numbers (BYoPSTN)—If you select this option, refer the Bring Your Own PSTN Solution Guide for Webex for Cisco BroadWorks for detailed information on how to configure this option.
-
-
Fare clic su Avanti.
-
There are two approaches for provisioning subscribers with regards to how their identities are verified – using Trusted Emails or Untrusted Emails.
In the Trusted Email workflow users provide email addresses to the partner who adds them in BroadWorks. You as a partner are responsible for provisioning the email address as part of either the flow-through or API method.
It is highly recommended to use the Trusted provisioning method because it ensures that all subscribers are fully provisioned by you as a partner and there is no action required from the end users.
In the Untrusted email case users need to verify their emails before provisioning, or users can self-activate themselves.
In the Untrusted case there are several provisioning modes based on the verification settings in the table below:
Tabella 4. Recommended User Verification Settings for Untrusted Provisioning Modes Nome impostazione
Provisioning flow senza messaggi e-mail
Self-provisioning utente
Provision Admin First
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
-
Note della tabella:
-
* Each customer organization in Webex is required to have at least one user with administrator role. The first user to whom you assign Integrated IM&P in BroadWorks takes the customer administrator role if a new customer organization is created in Webex. As a Service Provider you may want to have control over who gets the role. Checking this setting blocks users from completing activation until the first user you provisioned is activated. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
-
-
Fare clic su Avanti.
-
Select the default authentication mode (either BroadWorks Authentication or Webex Authentication) for user login to Webex.
This setting has no effect on user login to the User Activation Portal. Users must use their BroadWorks user ID and password when logging in to the portal, irrespective of how the Onboarding template is configured.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena creati. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
-
Fare clic su Avanti.
-
Per Preferenze , configurare quantosegue:
-
Scegliere se si desidera inserire automaticamente gli indirizzi e-mail degli utenti nella pagina diaccesso.
Utilizzare questa opzione solo se è stata selezionata l'autenticazione BroadWorks e gli indirizzi e-mail degli utenti sono stati inseriti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il relativo nome utente BroadWorks. La pagina di accesso fornisce un'opzione per modificare l'utente, se necessario, ma ciò potrebbe provocare problemi di accesso.
-
Se si desidera abilitare la sincronizzazione delle directory, impostare l'opzione Abilita sincronizzazione rubrica telefonica per tutte le organizzazioni dei nuovi clienti attivata.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente, in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
-
Inserire un Amministratore partner.
Questo nome viene utilizzato nel modulo di messaggio e-mail da Webex, che invita gli utenti a convalidare gli indirizzi e-mail.
-
Make sure the Allow admin-invite emails when attaching to existing orgs toggle is On (the default setting is On).
-
Fare clic su Avanti.
-
Esaminare le voci visualizzate nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con qualsiasi altro modello.
-
Fare clic sul nome del modello per modificarlo o eliminarlo, se necessario.
Non è necessario inserire nuovamente i dettagli dell'account di provisioning. I campi di conferma password/password vuoti sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori specificati alla procedura guidata.
Aggiungere altri modelli se si dispone di diverse configurazioni condivise da fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbero essere necessari i dettagli del modello per una attività seguente.
Configurazione del server dell'applicazione con URL del servizio di provisioning
Questa attività è necessaria solo per il flusso attraverso il provisioning. |
Patch Application Server (R22, R23, and R24 only)
-
If you haven't yet done so, apply the following patch that applies to your release:.
-
Per R22:
AP.as.22.0.1123.ap373197
-
Per R23:
AP.as.23.0.1075.ap373197
-
Per R24:
AP.as.24.0.944.ap384177
For a complete list of BroadWorks patches that form the requirement for deploying Webex for Cisco BroadWorks, See BroadWorks Software Requirements in the Reference section. -
-
Passare al contesto
Maintenance/ContainerOptions.
-
Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true
Ottieni gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interface > Messaging and Service > Integrated IM&P) dei comandi AS.
-
Accedere a Partner Hub e andare a
. -
Fare clic su View Templates (Visualizzamodelli).
-
Selezionare il modello in uso per il provisioning degli abbonati di questo gruppo/aziendale in Webex.
I dettagli del modello vengono visualizzati in un riquadro a comparsa a destra. Se non è stato ancora creato un modello, è necessario effettuare questa operazione prima di ottenere l'URL di provisioning.
-
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per gli altri modelli se ne sono disponibili più di uno.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema sul server applicazioni
È possibile che non si desideri impostare il provisioning e il dominio del servizio a livello di sistema se si utilizza UC-One SaaS. Vedere Punti decisione nella sezione Preparazione dell'ambiente. |
-
Accedere al server dell'applicazione e configurare l'interfaccia di messaggistica.
-
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL
-
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name
-
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password
-
AS_CLI/Interface/Messaging> set enableSynchronization true
-
-
Attivare l'interfaccia IMP integrato:
-
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com
-
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
-
È necessario inserire il nome completo per il |
(Opzione) Configurazione dei parametri di provisioning per-enterprise sul server applicazioni
-
In BroadWorks UI, aprire l'azienda che si desidera configurare e andare a Servizi > IM integrato&P.
-
Selezionare Usa dominio servizio e inserire un valore fittizio (Webex ignora questo parametro. È possibile utilizzare
example.com
). -
Selezionare Usa server di messaggistica.
-
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
È necessario inserire il nome completo per il
parametro
provisioningURL, come fornito in Partner Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare il mapping nelfile /etc/hosts
su AS. -
Nel campo Nome utente, inserire un nome per l'amministratore del provisioning. Questo deve corrispondere al valore nel modello in Partner Hub.
-
Inserire una password per l'amministratore del provisioning. Questo deve corrispondere al valore nel modello in Partner Hub.
-
Per Identità utente predefinita per IM&PID, selezionare Principale .
-
Fare clic su Applica.
-
Ripetere questa operazione per le altre aziende che si desidera configurare per il flusso attraverso il provisioning.
User Provisioning Data
For information on the user data that gets exchanged between BroadWorks and Webex during user provisioning, see Service Provider User Provisioning.
Partner Pre-Provisioning Check API
The Pre-Provisioning Check API helps administrators and sales teams by checking for errors before you provision a customer or subscriber for a package. Users or Integrations authorised by a User with the Partner Full Administrator role can use this API to ensure that there are no conflicts or errors with package provisioning for a given customer or subscriber.
The API checks to see if there are conflicts between this customer/subscriber and existing customers/subscribers on Webex. For example, the API may throw errors if the subscriber is already provisioned to a different customer or partner, if the email address exists already for another subscriber, or if there are conflicts between the provisioning parameters and what exists already on Webex. This gives you the opportunity to fix those errors before you provision, increasing the likelihood of successful provisioning.
For more information on the API, see: Webex for Wholesale Developer Guide
To use the API, go to : Precheck a Wholesale Subscriber Provisioning
To access Precheck a Wholesale Subscriber Provisioning document you need to log in to https://developer.webex.com/ portal. |
Partner SSO - SAML
Allows partner administrators to configure SAML SSO for newly created customer organizations. I partner possono configurare un singolo rapporto di SSO predefinito e applicare tale configurazione alle organizzazioni dei clienti da loro gestite, così come ai propri dipendenti.
La seguente procedura SSO partner si applica solo alle organizzazioni dei clienti create di recente. Se gli amministratori dei partner tentano di aggiungere l SSO di un partner a un'organizzazione cliente esistente, il metodo di autenticazione esistente viene conservato per evitare che gli utenti esistenti perdano l'accesso. |
-
Verificare che il provider di provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per i provider di identità dell'integrazione Single Sign-On in Control Hub.
-
Upload the CI metadata file that has Identity Provider.
-
Configure a Onboarding Template. Per l'impostazione della Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, inserire EntityID dal file XML dei metadati SAML del provider di identità di terze parti.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
-
In questo modo l'utente può eseguire l'accesso.
Partner SSO - OpenID Connect (OIDC)
Allows partner administrators to configure OIDC SSO for newly created customer organizations. I partner possono configurare un singolo rapporto di SSO predefinito e applicare tale configurazione alle organizzazioni dei clienti da loro gestite, così come ai propri dipendenti.
The below steps to set up Partner SSO OIDC apply to newly created customer organizations only. If partner administrators try to modify the default authentication type to Partner SSO OIDC in an existing temple, the changes will not apply to the customer organizations already onboarded using the template. |
-
Open a Service Request with Cisco TAC with the details of the OpenID Connect IDP. The following are mandatory and optional IDP attributes. TAC must set up the IDP on the CI and provide the redirect URI to be configured on the IDP.
Attributo
Richiesto
Descrizione
IDP Name
Sì
Unique but case-insensitive name for OIDC IdP config, could consist of letters, numbers, hyphens, underlines, tildes, and dots and max length is 128 characters.
OAuth client Id
Sì
Used to request OIDC IdP Authentication.
OAuth client Secret
Sì
Used to request OIDC IdP Authentication.
List of scopes
Sì
List of scopes which will be used to request OIDC IdP authentication, split by space, e.g. 'openid email profile' Must including openid and email.
Authorization Endpoint
Yes if discoveryEndpoint not provided
URL of the IdP's OAuth 2.0 Authorization Endpoint.
tokenEndpoint
Yes if discoveryEndpoint not provided
URL of the IdP's OAuth 2.0 Token Endpoint.
Discovery Endpoint
No
URL of the IdP's Discovery Endpoint for OpenID endpoints discovery.
userInfoEndpoint
No
URL of the IdP's UserInfo Endpoint.
Key Set Endpoint
No
URL of the IdP's JSON Web Key Set Endpoint.
In addition to the above IDP attributes, the partner organization ID needs to be specified in the TAC request.
-
Configure the redirect URI on the OpenID connect IDP.
-
Configure a Onboarding template. For the Authentication Mode setting, select Partner Authentication With OpenID Connect and enter the IDP Name provided during the IDP setup as the OpenID Connect IDP Entity ID.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
-
Very that the user can log in using the SSO authentication flow.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è necessaria per diverse funzioni di chiamata, inclusi la registrazione della chiamata, il gruppo di risposta per risposta per chiamate di gruppo, esecutivi e l'assistente esecutivo.
Use the CLI to enable the feature on all AS and XSP|ADP interfaces.
-
Run the following commands on AS interfaces. This will enable the AS to send the
X-BroadWorks-Correlation-Info
SIP header:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true
-
The
enableCallCorrelationID
parameter associated with the Xsi-Actions application is used to control the inclusion of call correlation information in Xsi-Actions logs. It is recommended to haveenableCallCorrelationID
enabled using the following command on XSP|ADP interfaces:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione di identificativo correlazione chiamata CiscoBroadWorks.
Sinc rubrica
La sincronizzazione delle directory assicura che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la rubrica chiamate completa dal server BroadWorks viene sincronizzata con la rubrica Webex. Gli utenti possono accedere alla rubrica dall'app Webex e chiamare qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione delle rubrica, andare a Sincronizzazione rubrica in Webex per Cisco BroadWorks.
Webex for Cisco BroadWorks flowthrough provisioning adds messaging users and associated calling information from the BroadWorks server to the Webex platform. However, phone lists, non-messaging users, and non-user entities are not included (for example, a conference room phone, fax machine or hunt group number). L'attivazione della sincronizzazione delle directory assicura che tutte le entità chiamanti vengono aggiunte alla piattaforma Webex. |
Cronologia chiamate Unified
Quando la Cronologia chiamate Unified è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia delle chiamate e delle riunioni Webex che viene visualizzata nell'app Webex. Gli utenti possono visualizzare la cronologia delle chiamate e la cronologia delle riunioni dettagliate dall'app Webex.
La cronologia delle chiamate Unified può essere abilitata dagli amministratori a livello di partner in Hub partner su base cluster per cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
-
Eventi della cronologia delle chiamate: questi eventi vengono utilizzati per creare una cronologia delle chiamate Unified dettagliata
-
Eventi di stato hook: la cronologia delle chiamate Unified include ottimizzazioni dello stato degli hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti della presenza telefonica
Requisiti cronologia chiamate Unified
Prima di configurare Unified Call History, verificare di aver patchato il sistema. Questa funzione dipende dalle seguenti patch di BroadWorks installate:
Per R22:
-
AP.as.22.0.1123.ap378585
—after patch installation, you must activate feature 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per R23:
-
AP.as.23.0.1075.ap378585
—after patch installation, you must activate feature 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
-
If using XSP—
AP.xsp.23.0.1075.ap378585
-
If using ADP—
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
-
AP.as.24.0.944.ap378585
—after patch installation, you must activate feature 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
For the full list of BroadWorks patches that you must install as a prerequisite to running Webex for Cisco BroadWorks, See BroadWorks Software Requirements in the Reference section. |
In addition to patching your system, the client config file (config-wxt.xml
) must have the following tag set: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
To have Hunt Group, Call Center and other redirection info in Unified Call History, the following Broadworks patches must be installed and active:
Per R23:
-
AP.as.23.0.1075.ap383346
-
AP.as.23.0.1075.ap383994
Per R24:
-
AP.as.24.0.944.ap383346
-
AP.as.24.0.944.ap383994
To have Executive-Assistant info in Unified Call History, the following Broadworks patches must be installed and active:
Per R24:
-
AP.as.24.0.944.ap380052
-
AP.as.24.0.944.ap384239
-
ADP running Xsi-Events-24_2022.06 or later
In addition to the Broadworks patches, Directory Sync must also be enabled for the Executive-Assistant Unified Call History.
When you enable Call History or DND Sync, Webex will send CTI subscription refresh requests for all users under the cluster. Depending on the number of users, this may last up to a few hours. It is recommended to not perform any Broadworks maintenance activity during the same maintenance window. |
Abilita cronologia chiamate (nuovo cluster)
To enable Call History on a new cluster, see the steps for adding a cluster in Configure Your Partner Organization in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia delle chiamate su un cluster esistente, effettuare le seguenti operazioni:
-
Sign in to Partner Hub at
admin.webex.com
. -
Andare a Impostazioni e selezionare un cluster esistente.
-
Verificare che la connessione del cluster sia buona. Il pannello destro deve visualizzare un segno di spunta verde con la connessionestabilita.
Se non viene visualizzato, in Verifica connessioni (Opzionale) , inserire l'ID utente BroadWorks e la password BroadWorks e fare clic su Verifica per verificare che la connessione sia buona.
-
Selezionare la casella di cronologia chiamate controllo.
-
Fare clic su Salva.
Interazioni funzioni
Le seguenti interazioni tra le funzioni esistono per Unified Call History:
-
La cronologia delle chiamate Unified non è supportata per gli utenti configurati in BroadWorks con elenchi di inoltro o indirizzari diretti. Quando esiste questa situazione, gli eventi di cronologia delle chiamate e stato di hook non vengono inviati all'app Webex.
-
La cronologia delle chiamate Unified non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella Cronologia chiamate.
Visualizzazione della cronologia delle chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia delle chiamate Unified dall'app Webex. Per informazioni dettagliate, vedere: Webex | View Call and Meeting History.
Disabilitazione di Unified Call History
Una volta abilitata la Cronologia chiamate Unified su un cluster, non è possibile disabilitare la funzione per proprio conto. If you need to disable the feature, contact Cisco Technical Assistance Center (TAC).
Visual Spam Indication
The Webex App supports a visual indication of spam calls in the call toast when the call is presented to the callee and in the Unified Call History records when BroadWorks is updated to perform Caller ID validation via the STIR/SHAKEN framework. To have this feature:
- Enable Unified Call History as described in the previous section.
- The following patches must be installed and active:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- or AS-25_Rel_2022.12 at a minimum
- The feature must be activated via the AS CLI:
- AS_CLI/System/ActivatableFeature> activate 104112
- AS_CLI/System/StirShaken> set enableVerification true
- Broadworks must be configured to perform STIR-SHAKEN signing, tagging, and verification as described in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification
When BroadWorks is properly configured, a new header X-Cisco-CallerId-Disposition will be added in INVITE requests sent to Cisco clients and a new field callerIdDisposition will be added to the existing Call History Events that are sent to Webex Cloud via the CTI interface. Webex devices will use this information to provide a visual spam indication in the call presentation and the Unified Call History of the callee.
Caller Identification and Call Redirection
Caller Identification
When the Webex App receives a call, it will attempt to identify who the caller is and display this information in the incoming call notification, the in-call window, and after the call is complete, in the call history and voicemail.
The Webex App will attempt to find the caller ID by matching the incoming phone number with the phone numbers of contacts found in various sources. The Webex App will use the following sources in this order. Once it finds it in one source it will not attempt to search anywhere else.
If it finds multiple instances of a number in one source, it will not try to choose one of them, in this case, it will not display any caller ID. |
-
Webex Common Identity (CI) which contains your organization users.
-
Personal and Organization Contacts. Personal Contacts are visible under the Contacts tab.
-
Local Address Book. In Windows - Outlook application, in Mac - Mac Contacts, in iOS - iPhone contacts, in Android - Android contacts.
If there is no match found with the incoming phone number, then the app will use the display name in the SIP FROM header if available. Otherwise, it will use the username part of the SIP URI from the SIP From header as a last resort.
For remote call control (i.e., Deskphone Control Mode) XSI info is used, where BWKS ID or extension is used, extracted from remote-party-info in the XSI event. If remote-party-info is not available, then P-Asserted Identity (PAI) (if configured) will be used.
Call Redirection
In the case where a call has been redirected or forwarded, then the app will attempt to show who the caller is and how it was forwarded in the call notification and call history.
-
Call Forwarded: Shows number that forwarded the call.
-
Hunt Group: Shows name of the hunt group that forwarded the call.
-
Call Center Queue: Shows name of the queue that forwarded the call.
-
Executive-Assistant: Shows name of Executive the call is coming in for.
Eccezioni:
-
For internal call queue calls, where an agent calls back an internal party, the remote party will not see the name of the call queue but will see the name of the agent calling them.
Call Answered Elsewhere:
For Hunt Groups or Call Queues that are set up with simultaneous routing, agents will see a call answered elsewhere in call history if another agent picks up the call. For Hunt Groups or Call Queues with sequential routing, or in an overflow, calls will show as missed call in call history if answered by another agent.
Select Caller ID
Panoramica
The "Select Caller ID" feature enables users to switch between different Calling Line IDs for external calls. If enabled by the admin, users can choose from the following options for their Calling Line Identity:
-
User number ("Use user phone number for Calling Line Identity")
-
Configurable CLID ("Use configurable CLID for Calling Line Identity")
-
Group CLID ("Use group/department phone number for Calling Line Identity")
Funzionalità
Users have two methods to change their Caller ID as provisioned by the administrator:
- Feature Access Codes (FAC): Specific codes for each of the three Caller ID options.
- Webex App Interface: A user-friendly view within the Webex desktop and mobile apps that display the available Caller ID options enabled by the administrator, allowing users to select their preferred ID.
Ulteriori funzioni
- The Webex apps will also include options for Call Center queues DNIS.
- Mobile app users will have Dual Persona options available for Mobility users.
Preconditions
The following conditions must be met on the BroadWorks server for the user to be able to control their choice of external CLID policy:
- The system flag 'EnableUserSelectionOfExternalCLIDPolicy' is enabled.
- User level Call Processing Policy Calling Line ID scope is set to "Use User Calling Line Id Policy" for this user.
- The User level Call Processing Policies flag 'Allow User Selection of External CLID Policy' is enabled for the user.
- If no number is defined for the "Use configurable CLID for Calling Line Identity" or "Use group/department phone number for Calling Line Identity" options, the FACs or app display will have no effect. This setting must be configured by the administrator prior to user selection.
BroadWorks Patches
This feature requires two specific BroadWorks patches to function correctly:
Refer to Section 8 Release Independent and Service Patch Information. |
- BWKS-5230 was the original user-selectable CLID feature - it lets users (if the system is configured properly) change which CLID policy is applicable. See FD here: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/UserSelectionOfExternalCallingLineIDOptionFD-R250.pdf
- BWKS-9510 is an XSI enhancement requested by the Webex client team to make it easier to discover which options are available for a user. This is necessary because the choice of CLID policy isn't a simple user-level feature (like CFA) that is directly controllable. Rather it depends on various system configuration options and the "call processing policies" hierarchy. You can see details here: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/XSIEnhancementToSupportUserSelectableCLIDFD-R250.pdf
Webex App Configuration
These tag needs to be enabled in the desktop, tablet, and mobile configurations:
<config> <services> <calls> <caller-id> <outgoing-calls enabled="%ENABLE_CLID_OUTGOING_CALLS_WXT%">
Shared line appearance
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. The shared line configuration for the Webex App is similar to the shared line configuration for desk phones. This specific feature allows you to assign shared line appearances to the end user's Webex App.
This feature benefits the users to handle calls on other user's extension directly from the Webex App.
-
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
-
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
-
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
-
A user cannot be provisioned with Executive-Assistant service at the same time as having Shared Lines.
-
A user's primary line port should not be changed to a Shared Line.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Owner Flag in Device List to Support Webex Client Shared Lines
R23 without ADP:
-
AP.as.23.0.1075.ap384179
-
AP.xsp.23.0.1075.ap384179
R23 with ADP:
-
AP.as.23.0.1075.ap384179
-
Xsi-Actions-23_2022.10
R24:
-
AS: AP.as.24.0.944.ap384179
-
Xsi-Actions-24_2022.10
R25:
-
AS: RI release Rel_2022.10_1.310
-
Xsi-Actions-25_2022.10
Patch 2: Patches for increasing port count on device profile types. Esempio: For the desktop client: System>Identity/Device Profile Type Modify> Business Communicator - PC: Profile , Standard Options, Number of Ports:
- IF 'Unlimited' is enabled, no change is required
- IF 'Limited To' is <10, change the value = 10 and save to utilize all available lines
-
RI release Rel_2022.10_1.310
Non disturbare (DND) sincronizzazione
Do Not Disturb (DND) Sync aligns DND settings between Webex and BroadWorks by synchronizing DND status between the two platforms. For example, if a user turns on DND from the Webex App, that status syncs to BroadWorks calling devices. As a result, the user’s BroadWorks-registered desk phone does not ring when someone attempts to call it. Similarly, if a user sets DND from a desk phone, the status syncs to the Webex App. Without this feature, DND updates from one platform don't get recognized by the other platform.
DND Sync gets applied at the BroadWorks cluster level and can be enabled in Partner Hub by a partner administrator.
If there are many customers (>50) in the BroadWorks cluster, DND sync is not supported. In such instances, it is recommended to contact a Cisco TAC support engineer for assistance. |
Prerequisiti
Make sure that the following patches are applied to the AS and XSP|ADP. Apply only the patches for your BroadWorks version.
For Release 23:
<snipped>
- ADP apps: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
For Release 24:
<snipped>
- ADP apps: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
After you apply the patches, activate feature 25433 on the AS:
AS_CLI/System/ActivatableFeature> activate 25433
If there are many customers (>50) in the BroadWorks cluster, operations such as updating XSI Actions, XSI Events, DAS URL, XSP|ADP URL, or DND sync are not supported. In such instances, it is recommended to contact a Cisco TAC support engineer for assistance.
Configure Device Feature Key Synchronization on BroadWorks. Make sure that the phone supports SIP SUBSCRIBE/NOTIFY for the “as-feature-event” event package. For details, see Cisco BroadWorks Device Feature Key Synchronization.
Enable DND Sync (Existing cluster)
-
Sign in to Partner Hub
-
Fare clic su Impostazioni.
-
Click View Cluster and select the appropriate BroadWorks cluster.
-
Enable the Do not disturb (DND) sync toggle.
-
Enter your BroadWorks user ID and click Enable.
The system validates that the BroadWorks cluster has the appropriate patches to support DND Sync. If validation fails, the Save button gets disabled.
-
If validation succeeds, click Save.
|
Enable DND Sync (New cluster)
You can also enable the feature during cluster creation. For details, see “Configure Your BroadWorks Clusters” in Configure Your Partner Organization in Partner Hub.
Disable DND Sync
You can’t disable DND Sync on your own. To disable the feature, create an engineering BEMS case with the following information:
-
Famiglia: Servizio Spark
-
Prodotto: Chiamata in Webex (Webex per BroadWorks)
-
Componente: WxBW- Provisioning
-
The BEMS case must state that Do Not Disturb Sync is to be disabled for a partner. The case must contain partnerId and BroadWorks clusterId.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione della chiamata.
Modalità di registrazione |
Descrizione |
Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Ondemand |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma la registrazione viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente |
La registrazione non viene avviata a meno che l'utente non seleziona l'opzione Avvia registrazione nell'app Webex. L'utente può avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
-
Per R22: AP.as.22.0.1123.ap377718
-
Per R23: AP.as.23.0.1075.ap377718
-
Per R24: AP.as.24.0.944.ap377718
The Call Correlation Identifier must be turned on. For details, see Enable Call Correlation Identifier.
The following configuration tag must be enabled in order to use this feature: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamata di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, vedere l'help.webex.com Webex | Registra lechiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono accedere alla piattaforma di registrazione delle chiamate di terze parti.
Enabling Voicemail for Microsoft Teams Integration
You can enable voicemail for Microsoft Teams users in the Webex for BroadWorks solution. This integration allows users to retrieve their voicemails directly through Microsoft Teams, enhancing the overall user experience.
Steps to Enable Voicemail
-
Configure Voicemail Settings: Follow the steps provided in the Webex Calling documentation to configure and manage voicemail settings. This includes setting up voicemail for users, enabling notifications, and configuring voicemail to email.
For detailed instructions, see: Configure and manage voicemail settings for a Webex Calling user.
-
Integrate with Microsoft Teams: Ensure that the integration between Webex for BroadWorks and Microsoft Teams is properly configured. This will enable users to access their voicemails through the Microsoft Teams interface.
For integration details, see: Configure Microsoft Teams for Webex Calling.
Esperienza utente
Once the integration is set up, users can:
- Retrieve voicemails directly within the Microsoft Teams application.
- Receive notifications for new voicemails.
- Manage voicemail settings from the Webex interface.
Requisiti
To support voicemail retrieval in the Microsoft Teams integration with the Webex for BroadWorks offer, additional network changes are required. BroadWorks partners should enable Cross-Origin Resource Sharing (CORS) for the following URLs on their BroadWorks platform:
- https://jabber-integration-a.wbx2.com/
- https://jabber-integration-r.wbx2.com/
- https://jabber-integration-k.wbx2.com/
- https://msteams-calling.webex.com/
For more details on the configuration steps, please refer to section 8.5.1.2 of the BW Application Delivery Platform Configuration Guide, which requires version 2024.05 on the ADP.
Gestione e Parcheggio chiamata gruppo
Webex per Cisco BroadWorks supporta l'accesso Parcheggio chiamata e Retrieve. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono poi essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti del retail in un'impostazione di store possono utilizzare la funzione per parcheggiare una chiamata che può essere poi selezionata da qualcuno in un altro reparto.
Operazione funzione
Una volta configurata la funzione
-
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nella relativa app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
-
Un altro utente del gruppo fa clic sull'opzione Recupera chiamata nella relativa app Webex. L'utente inserisce il interno della chiamata in parcheggio per continuare la chiamata.
Requisiti
Per utilizzare questa funzione, verificare quanto segue:
-
Il file di configurazione del client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
-
The Call Correlation Identifier must be enabled on the AS and XSP|ADP. For details, see Enable Call Correlation Identifier.
-
Your SBC must be configured to pass the ‘
x-broadworks-correlation-in
' SIP attribute to and from the Application Server.
Configurazione
Per informazioni su come configurare la funzionalità Parcheggio chiamata gruppo su BroadWorks, vedere "Aggiunta di un gruppo Parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte2. È necessario creare un gruppo e aggiungere gli utenti al gruppo.
Per informazioni su come configurare l'identificativo di correlazione chiamata su BroadWorks, vedere Descrizione della funzione di identificativo correlazione chiamata CiscoBroadWorks.
Ulteriori informazioni
Per informazioni utente sull'uso delle chiamate di Parcheggio chiamata, vedere Parcheggio Webex | e recupero dellechiamate.
Parcheggio chiamata/indirizzati Parcheggio chiamata
Il parcheggio di chiamate normali o indirizzate non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso funzioni:
-
Inserire *68 per parcheggiare una chiamata
-
Inserire *88 per recuperare una chiamata
Inclusione
Barge-in service is commonly used in call center environments or other situations where immediate assistance or intervention may be required.
When a barge-in service is enabled, a designated user or supervisor can enter an active call by initiating a specific command or by using a dedicated button or key combination on their phone or communication device. Once the barge-in request is made, the system establishes a connection with the ongoing call, allowing the authorized person to listen to the conversation or join the call as an active participant.
Barge-in service can be useful in various scenarios. In a call center setting, supervisors or trainers can monitor and coach customer service representatives by listening to their calls in real-time. If necessary, they can intervene to provide guidance or take over the call if the representative is struggling. In emergency situations or critical discussions, authorized personnel can quickly join ongoing conversations to provide assistance or make important decisions.
In the Webex app for Barge in, we get a notification that the call is transformed into a conference. There is no additional information in the NOTIFY (call-info or conference-info) what is the type of conference, so we can treat it in a different way.
When a barge-in occurs, a three-way call is established between the parties. The following terms are introduced:
-
Supervisor: A supervisor is a person who oversees and manages a team of customer service agents or call center representatives. In the context of call barge-in, a supervisor typically has the ability to monitor and intervene in ongoing customer calls. They may use call monitoring tools or software to listen in on calls, provide guidance to agents, and ensure quality control. The supervisor's role may involve training agents, addressing customer concerns, and optimizing the performance of the team.
-
Customer: A customer refers to an individual or entity that engages with a company or organization to obtain products, services, or support. In the context of call barge-in, a customer is someone who is making or receiving a phone call with a customer service agent. Customers may seek assistance, information, or resolution to their queries or issues during the call. The call barge-in feature allows supervisors or authorized personnel to join the ongoing call between the customer and the agent.
-
Agent: An agent, also known as a customer service representative or call center agent, is a person responsible for handling customer interactions and providing support or assistance over the phone or other communication channels. Agents are trained to address customer inquiries, resolve problems, process transactions, and deliver a positive customer experience. In the context of call barge-in, an agent is the individual speaking directly to the customer during the phone call. The agent may receive guidance or feedback from the supervisor through call barge-in if necessary.
For any client initiated requests such as CallStartRequest, CallPickupRequest, DirectedCallPickupRequest, DirectedCallPickupWithBargeInRequest, etc, if <Webex Client> (please choose the right name instead of Webex client, if it is not appropriate) is provisioned as a Shared Call Appearance device, 'Alert all appearances for Click-to-Dial calls' configuration should be enabled on Shared Call Appearance setting for the client to receive a call, unless the location is explicitly provided by the client initiating the request.
Mobile Native Call Escalate to Meeting
The Mobile Native Call Escalate to Meeting comes with two unique features:
-
New Push Notification
Mobile users on a native call can now switch to the Webex App by tapping on the New push notification. When you start a native call screen a New push notification appears on the screen and tapping the notification takes you straight to the Webex App in-call screen.
You see the Webex notification during a mobile phone call if you use Webex Go or your mobile network operator (MNO) has call signaling using Cisco call control for your mobile phone calls.
-
Move Mobile Call to Meeting
When you're in the middle of a call with someone, you may want to move that call into a meeting to make use of some advanced meetings features like video, share, or whiteboarding. Or invite other people into the discussion and move to a meeting.
BroadWorks Requirements
-
Activatable feature 25239
-
R23 with XSP|ADP:
-
AS Patch AP.as.23.0.1075.ap383064
-
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
-
Patch AP.platform.23.0.1075.ap383064
-
-
R23 with ADP:
-
AS Patch AP.as.23.0.1075.ap383064
-
ADP with Xsi-Actions-23, CommPilot-23 version > 2022.05_1.303 and NPS version > 2022.08_1.350
-
-
R24:
-
AS patch: AP.as.24.0.944.ap383064
-
ADP with Xsi-Actions-24, CommPilot-24 version > 2022.05_1.303 and NPS version > 2022.08_1.350
-
-
R25:
-
AS RI release Rel_2022.08_1.354
-
ADP with Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 and NPS version > 2022.08_1.350
-
URI Dialing Configuration to support Move Call to Meeting
NS UrlDialing Policy
Define rule for (.*)webex.com to route through I-SBC
NS_CLI/Policy/UrlDialing> get WebexMeetings Policy: UrlDialing Instance: Webex unknownSipURIHandling = reject disableSubscriberLookups = true Enable = true CallTypes: Selection = {ALL} From = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP} lineportOnly = false enableSipURIMatchingRules = true NS_CLI/Policy/UrlDialing/Rules> get WebexMeetings Policy: UrlDialing Instance: WebexCalling Table: Rules id pattern routingNE cost weight dtg =================================================================== 1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NS Routing NE for I-SBC
Example configuration
NS_CLI/System/Device/RoutingNE> get ne WebexMeetings Network Element WebexMeetings Location = 1281465 Data Center = Static Cost = 1 Static Weight = 99 Poll = false OpState = enabled State = OnLine Profile = NIL_PROFILE Remote Lookup Enabled = false Signaling Attributes = NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings Routing NE Address Cost Weight Port Transport Route ===================================================================== WebexMeetings sbc-address 1 99 - unspecified
NS Routing Profile
UrlDialing policy instance added to appropriate routing profile(s)
NS_CLI/Policy/Profile> get profile MyInst Profile: Webex Policy Instance ========================================== … UrlDialing WebexMeetings
AS Use NS Route for NetworkURL call
Enable the AS to honor the NS route in Hybrid AS mode
AS_CLI/Interface/IMS> set queryNSForNetworkURL true
E911 Emergency Calling
Webex for Cisco BroadWorks supports E911 emergency services calling. With this feature, emergency calls get routed to a Public Safety Answering Point (PSAP) who can then direct emergency services to the caller’s location. To use this feature, you must integrate Webex for Cisco BroadWorks with an E911 emergency call provider.
Use the following Webex articles to configure support for E911 emergency calling services:
-
E911 Emergency Calling in Webex for BroadWorks—Use this article to configure E911 emergency calling in Webex for Cisco BroadWorks using one of the following supported E911 providers:
-
Banda
-
Intrado
-
RedSky
-
-
Emergency Call Disclaimer—If you have a location service, you can configure the Emergency Services Disclaimer window on the Webex App to include an option for users to update their location when logging in.
Personalizzazione e provisioning dei client
Users download and install their generic Webex apps, for desktop or mobile (for download links, see Webex App Platforms). Once the user authenticates, the client registers against theWebex Cloud for messaging and meetings, retrieves its branding info, discovers its BroadWorks service info and downloads its calling configuration from BroadWorks Application Server (via DMS on XSP|ADP).
I parametri di chiamata per le app Webex vengono configurare in BroadWorks (normalmente). È possibile configurare branding, messaggistica e parametri della riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Queste due serie di configurazioni possono sovrapporsi, in tal caso la configurazione Webex ha la priorità sulla configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server dell'applicazione BroadWorks
Le app Webex sono configurate con i file DTAF. The clients download a configuration XML file from the Application Server, via the Device Management service on the XSP|ADP.
-
Recuperare i file DTAF richiesti (vedere Profili dispositivo nella sezione Preparazione dell'ambiente).
-
Verificare di disporre dei set di tag giuste in BroadWorks System > alle > tag di gestione dispositivi.
-
Per ciascun client di cui si è in corso il provisioning:
-
Scaricare ed estrarre il file zip DTAF per il particolare client.
-
Import DTAF files to BroadWorks at System > Resources > Identity/Device Profile Types
-
Aprire il profilo del dispositivo appena aggiunto per la modifica e:
-
Enter the XSP|ADP farm FQDN and Device Access Protocol.
-
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per condivisione del desktop per il funzionamento.
È possibile anche abilitare il supporto delle parti remote eseguendo il seguente comando CLI sul server dell'applicazione:AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
-
-
Modificare i modelli in base all'ambiente in uso (vedere la tabella seguente).
-
Salvare il profilo.
-
-
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome |
Descrizione |
Priorità codec |
Configurare l'ordine di priorità per i codec audio e video per VoIP chiamate |
TCP, UDP e TLS |
Configurare i protocolli utilizzati per segnali SIP e multimediali |
Porte audio e video RTP |
Configurare gli intervalli di porte per audio e video RTP |
Opzioni SIP |
Configurare varie opzioni correlate a SIP (INFORMAZIONI SIP, uso di rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e sottoscrizione, ecc.) |
Customize Branding for Webex App
-
Partner customizations—Partner administrators can apply advanced branding customizations that apply to the partner organization and/or customers that the partner manages. See Configure Advanced Branding Customizations.
-
Customer customizations—If the partner allows customers to apply their own Branding customizations, customer administrators can follow the procedures at Add Your Company Branding to Webex.
The User Activation Portal uses the same logo that you add for client Branding. |
Personalizzazione della segnalazione dei problemi e degli URL di assistenza
To customize these options, administators can follow the procedure "Add Feedback and Help Site URLs", which can be found in both of the above Branding articles.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con provisioning Flowfluire
You must configure all the XSP|ADP services, and the partner organization in Control Hub, before you can perform this task.
1 |
Assegnazione del servizio in BroadWorks: |
2 |
Verifica l'organizzazione e gli utenti del cliente in Control Hub: |
Test utenti
1 |
Scaricare l'app Webex su due macchine diverse. |
2 |
Accedere come utenti di test sulle due macchine. |
3 |
Effettua chiamate di prova. |
Pre provisioning organizzazioni clienti
Nel modello corrente, viene eseguito automaticamente il provisioning dell'organizzazione del cliente quando si onboard il primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguita una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
-
Usa API per creare account Webex
-
Assegnare i messaggi e-mail integrati IM&P (provisioning flow) con e-mail affidabili per la creazione di account Webex
-
Assegna IM&P integrato (provisioning FLOW) senza messaggi e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per la creazione di account Webex
-
Consenti agli utenti l'attivazione autonoma (inviando loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex sono esposti API pubbliche per consentire ai provider di servizi di integrare Webex per il provisioning del sottoscrittore Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. La specifica per queste API è disponibile developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
Wholesale customers will be rejected by these APIs. |
Provisioning Flow
Su BroadWorks, è possibile fornire agli utenti l'opzione Abilita IM integrato&P. Questa azione causa il provisioning dell'adattatore BroadWorks per rendere chiamata API di eseguire il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile retrocompatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica di codice, ma solo una modifica di configurazione all'endpoint API per l'adattatore di provisioning.
La fornitura del sottoscrittore su Webex può richiedere una notevole quantità di tempo (diversi minuti per l'utente iniziale in un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il completamento del provisioning di flusso indica che il provisioning è stato avviato. Non indica il completamento. Per verificare che gli utenti e l'organizzazione del cliente siano completamente predisposti su Webex, è necessario accedere a Partner Hub e ricercare l'elenco dei clienti. BroadWorks trunking users can have Webex for BroadWorks via a shared call appearance (SCA). The trunking user will need to have the Authentication service assigned. As described in the BroadWorks Trunking Solution Guide Section 8, this allows the authentication of the SCA Webex appearance to be separate from the common trunk authentication. Webex for BroadWorks cannot be provisioned for trunking users with the Route List or Direct Route features assigned. |
The location of templates has been moved from BroadWorks Calling in Org Settings to the Customer List section and it is now called the Onboarding template. |
Attivazione automatica utente
Per fornire gli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
-
Sign in to Partner Hub, and find the Customer List page.
-
Fare clic su View Templates (Visualizzamodelli).
-
Select the provisioning Onboarding template you want to apply to this user.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non è nel sistema BroadWorks associato a questo modello, l'utente non può attivare automaticamente con il collegamento.
-
Copiare il collegamento per il provisioning e inviarlo all'utente.
È possibile anche includere il collegamento di download del software e ricordare all'utente che deve fornire e convalidare il relativo indirizzo e-mail per attivare l'account Webex.
-
È possibile monitorare lo stato di attivazione dell'utente sul modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi diattivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli nella vista Stato utente che consentono agli amministratori di Cisco BroadWorks provider di servizi di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Spostamento degli utenti Webex in Webex per Cisco BroadWorks
To move existing Webex users to Webex for Cisco BroadWorks, refer to the below table to determine which procedure to follow.
Existing Webex user belongs to a… |
Follow these processes to move the user |
---|---|
Consumer organization or self-signup (e.g., free account, trial account) |
|
Organizzazione cliente |
Attach Webex for BroadWorks to Existing Organization—The organization attachment (for the first user) also adds Webex for BroadWorks to subsequent users, so long as they are assigned to the correct organization. |
Existing Webex user belongs to a… |
Follow these processes to move the user |
---|---|
Consumer organization or self-signup (e.g., free account, trial account) |
If Webex for BroadWorks organization does not exist (no users are provisioned):
If Webex for BroadWorks organization exists (at least one user is provisioned):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Use this procedure to move an existing Webex user who is in a consumer organization or has a self-signup account (free account or trial account) to Webex for Cisco BroadWorks. Note that the Webex for Cisco BroadWorks organization must exist (with the first user provisioned). In this case, you can use one of these options to move users:
-
Move User (with Trusted Email)—Uses provisioning with trusted emails
-
Move User (with Untrusted Email)—Uses provisioning with untrusted emails
-
Attivazione automatica
If the Webex for Cisco BroadWorks organization is not yet created (no users are provisioned), follow normal provisioning processes ( Provision Users) to create the organization and add the first user as an administration user. After the first user is provisioned into the organization, follow the consent-based methods in this procedure to move subsequent users. |
Sposta utente (con e-mail attendibile)
If the Onboarding template uses Trusted Emails, the partner administrator can move subsequent users with this process:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Activate Account (Attivaaccount). L'utente viene reindirizzato al portale consumer Webex.
-
L'utente accede a Webex.
-
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Sposta utente (con e-mail non attendibile)
If the Onboarding template uses Untrusted Emails, the user’s email address must first be validated. L'amministratore può seguire questo processo per spostare gli utenti successivi:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito automaticamente sul bridge di provisioning BroadWorks.
-
All'utente viene inviato un testo con un collegamento di attivazione.
-
-
L'utente fa clic sul collegamento Attivazione e inserisce il relativo indirizzo e-mail.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Partecipaora.
-
Indirizzo e-mail convalidato.
-
L'utente viene reindirizzato per accedere al portale Webex Consumer.
-
-
L'utente accede a Webex.
-
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Flusso di attivazione automatica
Se l'utente dispone di un account BroadWorks esistente, potrà utilizzare il processo di attivazione automatica per spostare l'account.
-
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
-
L'utente inserisce il relativo indirizzo e-mail.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
Viene inviato un messaggio e-mail automatico all'indirizzo e-mail dell'utente.
-
-
L'utente apre il messaggio e-mail e fa clic sul collegamento Partecipa ora, che convalida l'indirizzo e-mail.
-
CI ha rilevato che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di continuare.
-
L'utente viene reindirizzato per accedere a Webex.
-
-
L'utente accede al portale consumer.
-
L'utente fa clic su Delete Account (Eliminaaccount).
-
L'account Webex precedente viene eliminato.
-
L'utente ha predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
Attach Webex for BroadWorks to Existing Organization
If you are a partner administrator adding Webex for BroadWorks services to an existing Webex customer organization, which is not yet associated with a partner managed BroadWorks enterprise, the customer organization administrator MUST approve administrator access for the provisioning request to succeed.
Organization administrator approval is needed if any of the following are true:
-
The existing customer organization has 100 users or more
-
The organization has a verified email domain
-
The organization domain is claimed
If none of the criteria above are true, then an Automatic Attach may occur.
In an Automatic Attachment scenario, a Webex for BroadWorks subscription is added to an existing customer organization without any notification to the existing org administrator or end user. In most cases your Partner Org will be given Provisioning Admin rights. However, if the customer org has no licenses or only suspended/canceled licenses, then you will be made a Full Admin. With Provisioning Admin access, you will have limited visibility in Control Hub to the users in the existing org. It is recommended that you contact the customer admin and request Full Admin access to the org. |
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Make sure the Allow admin-invite emails when attaching to existing orgs (the toggle is on by default). |
1 |
L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. For help, see Provision Customer Organizations. Si verifica quanto segue:
| ||
2 |
With full administrator access, the partner administrator can complete the process of provisioning the customer. You will need to re-attempt the Provisioning of the customer starting from Step 1 above. However, now as an external Full Admin, you should not observe the error 2017. Once the provisioning of calling services is completed, the existing customer org will be visible as a customer underneath the Webex for BroadWorks Partner Org.
|
Conditions of Org Attachment
-
The email address of the first BroadWorks subscriber provisioned must match the email address of an existing user in the targeted customer org. Otherwise, a new customer org will be created.
-
The first user from the existing org who is provisioned for Webex for BroadWorks is not provisioned as an admin user. Settings and entitlements from the existing org are retained.
-
The organization’s existing authentication settings take precedence over what is configured on the Webex for BroadWorks provisioning template. As a result, there is no change to how existing users log in.
-
However, if the existing customer organization has basic branding enabled, after the attach occurs the Partner's Advanced branding settings will take precedence. If the customer wants the basic branding to remain intact, then the partner must configure the customer organization to override branding in the Advanced Branding settings.
-
-
The name of the existing organization will not change.
-
There is no change to the email suppression flag setting in the existing org’s settings. This may affect newly provisioned users. Depending on how the flag is set, new users may or may not receive an email with a code that must be entered in order to complete activation.
-
Restricted Admin Mode (set by the Restricted by Partner Mode toggle) is turned off for the attached org.
-
Make sure to complete the organization attachment process (moving existing users and updating the organization ID), before you provision new users into the Webex for Cisco BroadWorks organization.
-
A BroadWorks enterprise can be associated with one Webex organziation only. You cannot provision subscribers from a single BroadWorks enterprise into separate Webex organizations.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com .
The customer admin must provide the external admin with the Full Administrator rights and privileges. |
The email address that the customer organization administrator adds as an external administrator must match the partner administrator's email address as configured in the Onboarding template on Partner Hub. After adding the email from the Onboarding template on Partner Hub as a Full Administrator, any additional partner admins will also need to be added as an external admin with Full Administrator rights. |
Detach Webex for BroadWorks from Existing Organization
Follow these steps to detach Webex for BroadWorks from an existing Webex organization. For example, if you attached Webex for BroadWorks to an existing organization by accident and want to remove the attachment.
In Standard flow detaching Webex for BroadWorks from an existing Webex organization (standard flow only) will delete all associated subscriber data and deactivate the customer’s Webex for BroadWorks subscription. Also, you will lose access to the customer organization if this is the only associated subscription. In Hybrid flow the customer subscriptions are not modified. |
-
If you don’t have access to the customer settings in Control Hub, have the customer administrator grant you external administrator access by following Approve External Administrator Request.
-
Remove all Webex for BroadWorks workspaces from the organization. Use the Remove a BroadWorks Workspace API.
-
Remove all Webex for BroadWorks subscribers from the organization. Use the Remove a BroadWorks Subscriber API.
-
Remove pending Webex for BroadWorks users from the organization. For example, if users were provisioned via the untrusted email flow, and valid emails have not yet been entered, the users are left in a pending state. Follow Verify User Provisioning with Untrusted Emails to delete the users.
-
Delete the BroadWorks Calling configuration for this customer. Open the customer's Control Hub instance, click Hybrid, under BroadWorks Calling section delete all configurations.
After completing the detachment, if you want to attach Webex for BroadWorks to the customer, follow the provisioning processes to attach to an existing customer.
An alternative option to remove subscribers if you don't want to use the Remove a BroadWorks Subscriber API is to go into BroadWorks CommPilot and remove the Integrated IM&P service for the affected users. |
Manage Users and Organizations
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente vengono tenuti in BroadWorks. Un'identità e-mail distinta per l'utente e relative licenze per le funzioni Webex sono tenute in Webex.
Verifica del provisioning utenti con indirizzi e-mail non attendibili
Se si sta predis facendo il provisioning di Webex per utenti BroadWorks utilizzando il provisioning flow-through con messaggi e-mail non attendibili, gli utenti devono autoproducersi inserendo il proprio indirizzo e-mail nel portale di attivazione utenti. Se l'utente rileva un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riconorà l'errore, l'amministratore può utilizzare la procedura seguente in Partner Hub per esaminare lo stato e onboardre l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 |
Sign in to Partner Hub and find the Customer List page. |
2 |
Fare clic su View Templates (Visualizzamodelli). Select the appropriate Onboarding template you want to apply to this user. |
3 |
In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con messaggi e-mail non attendibili sia configurato correttamente:
|
4 |
Dopo il provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato di provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo Stato corrente, che mostra se l'utente è stato predisposto o se è presente un requisito in sospeso.
|
5 |
Per gli utenti con errori o requisiti in sospeso, fare clic sui tre puntini a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili durante la visualizzazione dell'elenco di utenti:
-
Export—Click this button if you want to export the user list to a CSV file.
-
Exclude provisioned users—Enable this toggle if you want to view only users with pending requirements or errors.
Modifica ID utente o indirizzo e-mail
Modifiche dell'ID utente e dell'indirizzo e-mail
ID e-mail e ID alternativo sono attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. Nella tabella seguente vengono descritti gli scopi di questi diversi attributi e le operazioni da eseguire per modificarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non è possibile modificare questo identificativo e collegare comunque l'utente allo stesso account in Webex. È possibile eliminare l'utente e crearla nuovamente se è errata. |
ID e-mail | ID utente |
Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si asserzione di attendibilità dell'e-mail Non richiesto in BroadWorks se non si asserzione di affidabilità dei messaggi e-mail Non richiesto in BroadWorks se si consente agli abbonati di attivare automaticamente |
Se l'utente è predisposto con l'indirizzo e-mail errato, è necessario effettuare un processo manuale per modificare questa impostazione in entrambi i punti:
Non modificare l'ID utente BroadWorks. Operazione non supportata. |
ID alternativo | Nessuno | Abilita autorizzazione utente, tramite e-mail e password, a fronte dell'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti devono immettere il relativo ID utente BroadWorks durante l'autenticazione. |
Modifica del pacchetto utente nell'hub partner
1 |
Accedere all'hub partner e fare clic su Clienti. |
2 |
Individuare e selezionare l'organizzazione del cliente in cui si trova l'utente. La pagina di panoramica dell'organizzazione viene visualizzata in un pannello a destra dello schermo. |
3 |
Fare clic su View Customer (Visualizzacliente). L'organizzazione del cliente viene aperta in Control Hub, che mostra la pagina Panoramica.
|
4 |
Fare clic suUtenti, quindi individuare e fare clic sull'utente interessato. |
5 |
In Servizi dell'utente, fare clicsu Webex per pacchetti BroadWorks (Sottoscrizioni). Viene visualizzato il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 |
In the Profile tab, look in the Package section and click the arrow (>) to expand the view. |
7 |
Select the package you want for this user (Basic, Standard, Premium or Softphone) and click Save. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 |
È possibile chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium dispongono di siti per riunioni distinti associati a ciascun pacchetto. Se un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato visualizza due siti per riunioni in Control Hub. Le funzionalità di riunione e il sito della riunione dell'abbonato si allineano al pacchetto corrente. Il sito per riunioni del pacchetto precedente e tutto il contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili ad Amministrazione sito riunione. |
Potrebbero essere necessario da due a tre ore per le PMR di aggiornamento che sono risultate da una modifica del pacchetto all'aggiornamento. |
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
If the user that you are going to delete has administrator privileges, assign a new administrator before you delete the user. There is no automatic transfer of the administrator role should the last administrator be deleted. |
Webex per API Cisco BroadWorks
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
-
Eseguire la richiesta di rimozione dell'API di un abbonato BroadWorks su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento a Webex per Cisco BroadWorks. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
Eseguire la richiesta DI ELIMINAZIONE DI una persona su per eliminare completamente https://developer.webex.com/docs/api/v1/people/delete-a-person l'utente.
Flow-through Provisioning
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
-
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – PAGINA IM&P integrata su BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte2.
After the service is disabled, flow-through provisioning removes the Webex for Cisco BroadWorks subscription from the user. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori dei clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla relativa organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Delete Organization
1 |
Use the People APIs to delete all users from the organization:
| ||
2 |
If Directory Sync is turned on, disable it. This can be done via Partner Hub or via the public API. To disable Directory Sync via Partner Hub: To disable Directory Sync via API, use the Update Directory Sync for a BroadWorks Enterprise API and disable the enableDirSync setting. All users related to BroadWorks Directory Sync for this organization will be deleted. Note that the removal of users (using either method) may take some time depending on the quantity of users. | ||
3 |
After all of the users are removed, use the Delete an Organization API to delete the organization. |
Canceling a Subscription from Control Hub
As the API is private, customers won't have access to it. Instead, the following steps show how customers can cancel their own subscription from Control Hub:
-
The Partner Admin can navigate to the "Hybrid" Services page on the Customer's Control Hub.
-
Locate the "BroadWorks Calling" card.
-
Once all users have been de-provisioned from Webex for BroadWorks for that Customer, the Partner should see a button to "Clear Configuration" (i.e., delete their customer_config entry in BPB).
Release Management
I controlli di gestione delle release in Partner Hub consentono ai provider di servizi Cisco BroadWorks di gestire le release fornendo loro la possibilità di controllare la data di rilascio in base alla quale le app Webex degli utenti ese upgrade all'ultimo software.
By default, the Webex App uses Automatic upgrades (Cisco-controlled monthly releases). However, with this feature, partner administrators can:
-
Configure customized release schedules with deferrals from the Cisco-default release schedule
-
Configure a single release schedule and cascade that schedule to all of the customer organizations that they manage
-
Assign different release schedules to different customer organizations
For more information about Release Management, including information on how to configure and apply customized release schedules, see the Webex article Release Management Customizations.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
-
Aggiunta di un cluster BroadWorks in Hub partner
-
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
-
Add a Onboarding template in Partner Hub
-
Edit or Delete a Onboarding template in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su | ||
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. | ||
3 |
Fare clic su View Clusters (Visualizzacluster). | ||
4 |
Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro a destra.
| ||
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Edit or Delete a Onboarding template in Partner Hub
You can edit or delete Onboarding templates in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su | |||||||||
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. | |||||||||
3 |
Fare clic su View Templates (Visualizzamodelli). | |||||||||
4 |
Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere Assistente Webex follow-up su attività, prendere nota di importanti decisioni ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant for Meetings is available for free for Premium and Standard package meeting sites and Personal Meeting Rooms. Il supporto include sia i siti nuovi che quelli esistenti.
Enable Webex Assistant for Meetings
Webex Assistant is by default enabled for both Standard and Premium package Broadworks Customers.
Partner Administrators and Customer Organization Administrators can disable the feature for Customer Organizations through Control Hub.
Limiti
The following limitations exist for Webex for Cisco BroadWorks:
-
Support is limited to Premium and Standard package meeting sites and Personal Meeting Rooms only.
-
Closed captioning transcriptions are supported in English, Spanish, French, and German only.
-
Content sharing via email can be accessed only by users within your organization
-
Meeting content is not accessible to users outside your organization. Meeting content is also not accessible when shared between users of different packages from within the same organization.
-
With the Premium package, post-meeting transcriptions are available whether Webex Assistant is enabled or disabled. However, if local recording is selected, post-meeting transcripts or highlights are not captured.
-
With the Standard package, Record meeting on cloud option is not available and so post-meeting transcriptions are not available whether Webex Assistant is enabled or disabled. However, if local recording is selected, even then post-meeting transcripts or highlights are not captured.
Additional Information About Webex Assistant
For user information on how to use the feature, see Use Webex Assistant in Webex Meetings and Events.
Disabilita Webex Calls
Free Webex calling is enabled by default letting users place free calls to any Webex-enabled device. However, if you want all calls to use the BroadWorks infrastructure, you can disable Webex calls within a Onboarding template, which disables that option for the customer organizations that use the template.
Supporto funzioni
When Webex Calling is disabled, the following conditions apply to Webex for Cisco BroadWorks users:
-
Users no longer see Call with Webex as a selectable call option on the Webex App.
-
Users cannot place or receive free Webex calls to non-Webex for Cisco BroadWorks users. This includes calls initiated from a Webex team space, Call History, Contacts, by entering the other user's URI or email address in the Search bar.
-
Screen sharing works within a BroadWorks call.
-
Webex meetings, and telephony presence still work, even if Webex Calls are disabled.
Disable Webex Calls (New Onboarding template)
While configuring a new Onboarding template, you can configure whether Webex calls are enabled or disabled by checking or unchecking the Disable Cisco Webex Free Calling check box within the Add a new template wizard. This setting will be picked up for users in customer organizations that you assign to the template.
For details on configuring a new Onboarding template, see Configure Your Partner Organization in Partner Hub.
Disable Webex Calls (Existing Onboarding template)
Follow this procedure to disable Webex calls from an existing Onboarding template. This will disable the feature for all new users in customer organizations that use this template.
-
Sign in to Partner Hub at admin.webex.com.
-
Choose Settings.
-
Click View Template and choose the appropriate Onboarding template.
-
Click Disable Cisco Webex Free Calling.
-
Fare clic su Salva.
Disable Webex Calls (Existing User)
Disabling this feature on a Onboarding template changes the setting only for new users who are assigned to the template. To disable Webex Calls for an existing user, you can follow one of the below procedures to update the user.
Make sure that you have already completed one of the above procedures to disable Webex Calls from the Onboarding template to which the user is assigned. Otherwise, either of the below procedures will reconfigure the user with Webex Calls enabled. |
If you are using flow-through provisioning, you can do the following:
-
Open CommPilot and go to the user configuration.
-
Remove the Integrated IM+P service from the user and click OK.
-
Add the Integrated IM+P service to the user and click OK.
Otherwise, you can use the API to update the user.
-
Use the Remove a BroadWorks Subscriber API to delete the user.
-
Use the Provision a BroadWorks Subscriber API to add the user.
Disable Video or Screen Sharing within Calls
Partner administrators can use configuration tags to disable video calls and/or screen sharing within a call from the Webex App (by default, both media types are enabled for calls).
For full configuration details and options, see Disable Video Calls and Disable Screen Sharing in the Webex for Cisco BroadWorks Configuration Guide.
For video, you can also configure whether incoming call media defaults to video or audio only. |
Busy Lamp Field / Call Pickup Notification
Busy Lamp Field (BLF) / Call Pickup Notification leverages the BLF and Directed Call Pickup features. A BLF user receives an audio and visual notification on the Webex App when a user from the BLF monitored list receives an incoming call. The BLF user can Ignore or Pick up the monitored user’s call.
BLF / Call Pickup Notification helps in situations where a user needs to answer calls for other team members who may be working in a different location.
Users can also see their BLF monitored list in the Multi-Call Window - Watchlist section - (Windows only, Mac not supported) to see the presence of their Webex and non-Webex team members. For help with enabling multi-call, see: Multi-Call Window
Webex members will have a full Webex presence. Non-Webex members must be directory synced into Webex, and they will only have "unknown" and "in-a-call" states (ringing state will trigger the call pickup dialog).
Limitations of Presence for Non-Webex users:
-
Presence is not supported for non-CI broadworks users, even if they are in the BLF list.
-
CI users without Webex cloud entitlement or machine type of accounts (workspaces) only show ‘in-call’ and ‘unknown’ presence. There is no active, ringing, etc. status.
-
Non-Webex users from the BLF watch list, who started a call before the Webex client was started or while it was offline will be shown with an ‘unknown’ presence.
-
Losing your connection means all the non-Webex in-call states will be reset to ‘unknown’ upon reconnecting.
-
If a non-Webex user from the BLF holds a call they will continue to be shown as ‘in a call’.
Requisiti
Make sure that the following patches are applied on BroadWorks. Install only the patches that apply to your release:
Per R22:
-
AP.platform.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382362
-
AP.xsp.22.0.1123.ap382053
-
AP.xsp.22.0.1123.ap382362
-
AP.as.22.0.1123.ap383459
-
AP.as.22.0.1123.ap383520
Per R23:
-
AP.platform.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382362
-
AP.as.23.0.1075.ap383459
-
AP.as.23.0.1075.ap383520
-
If you're using XSP|ADP:
-
AP.xsp.23.0.1075.ap382053
-
AP.xsp.23.0.1075.ap382362
-
-
If you're using ADP:
-
Xsi-Actions-23_2022.01_1.200.bwar
-
Xsi-Events-23_2022.01_1.201.bwar (or later)
-
Per R24:
-
AP.as.24.0.944.ap382053
-
AP.as.24.0.944.ap382362
-
AP.as.24.0.944.ap383459
-
AP.as.24.0.944. ap383520
-
Xsi-Actions-24_2022.01_1.200.bwar
-
Xsi-Events-24_2022.01_1.201.bwar (or later)
Make sure that the following configuration tags are enabled on the Webex App:
-
<busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">
-
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
-
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(this tag is optional)
You must activate feature 101642 Enhanced Xsi Mechanism For Team Telephony on the AS:
AS_CLI/System/ActivatableFeature> activate 101642
Enable X-BroadWorks-Remote-Party-Info
on the AS using the below CLI command as some SIP call flows require this feature:
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Make sure that the following services are assigned to users:
-
Assign the Directed Call Pickup service for all users
-
Set up the Busy Lamp Field for users
Any reference to XSP includes either XSP or ADP. |
Configure Busy Lamp Field on BroadWorks
Partner administrators can use the following procedure to set up the Busy Lamp Field for a user.
-
Sign in to BroadWorks CommPilot.
-
For a selected user, go to Client Applications and configure the Busy Lamp Field.
-
Add the URL of the BLF list that will be monitored.
-
Use the search parameters to locate and add users to the Monitored Users list.
-
Fare clic su OK.
Slido Integration Support
Webex for Cisco BroadWorks supports Webex App integration with Slido.
Slido è uno strumento facile da utilizzare per il coinvolgimento del pubblico. Consente alle persone di ottenere il massimo dalle riunioni colmando la differenza tra gli oratori e i partecipanti. Se Slido questa funzione è integrata nell'organizzazione Control Hub, gli utenti possono aggiungere l'app Slido alle relative riunioni nell'app Webex. Questa integrazione aggiunge funzionalità Q&A di sondaggi e di sondaggi aggiuntivi alla riunione.
For additional information on how to deploy and use Slido with the Webex App, see Integrate Slido with Webex App.
Webex Availability: In a Calendar Meeting
When you have accepted a meeting in your Outlook client that is an appointment, ad hoc meeting, or a non-Webex meeting, your Webex availability appears as “In a calendar meeting”. This availability lets your colleagues know that you are otherwise engaged and that a response may be delayed.
Per abilitare questa funzione:
-
navigate to the General tab of your Settings tab on Windows or Preferences on Mac.
-
Check the box to Show when in a calendar meeting.
For users with the Outlook presence integration enabled, “In a calendar meeting” in Webex maps to “Busy” in Outlook. |
Caveat
For this feature to work you must have the Webex app and Outlook client running at the same time.
We are currently working to support the ‘Show as Working Elsewhere’ option in Outlook to not show a user as “In a calendar meeting” in Webex.
If a user chooses to disable “Show when in a calendar meeting” while they are currently in a calendar meeting, their presence will not update until the meeting has ended. This will require a client restart to pick up.
Automatic Answer with Tone
With automatic answer with tone, users can make a call from a third-party app, such as Contact Center, and the call is routed automatically through the Webex App on their desktop. When the Webex App rings the other party, the user hears a certain tone, advising them that the call is connecting.
For a Webex for Cisco BroadWorks user to use this feature:
-
The feature is supported on the primary line appearance only
-
The Webex App must be the primary line appearance
-
The %ENABLE_AUTO_ANSWER_WXT% tag must be enabled
If the user also has Shared Call Appearances (for example, a desk phone is configured as one of the secondary line appearances), the feature is still supported on the primary appearance so long as the shared call appearances are configured to not to receive incoming calls. This can be accomplished by configuring either of the following three conditions on BroadWorks for all shared call appearances:
-
Alert all appearances for Click-to-Dial calls is disabled in the Shared Call Appearance configuration—this is the recommended approach
o
-
Allow Termination to this location must be disabled for all shared call appearances or
o
-
Locations are disabled for all shared call appearances
Aumento della capacità
XSP|ADP Farms
We recommend you use the capacity planner to determine how many additional XSP|ADP resources you need for the proposed increase in subscriber numbers. Per uno dei server NPS dedicati o dedicati a Webex per Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
-
Scale dedicated farm: Add one or more XSP|ADP servers to the farm that needs extra capacity. Installare e attivare la stessa serie di applicazioni e configurazioni dei nodi esistenti del sistema.
-
Add dedicated farm: Add a new, dedicated XSP|ADP farm. Sarà necessario creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti sul nuovo registro, per esitare gli utenti a essere presenti nell'hub esistente.
-
Add specialized farm: If you are experiencing bottlenecks for a particular service, you may want to create a separate XSP|ADP farm for that purpose, taking into consideration the co-residency requirements listed in this document. Potrebbe essere necessario riconfigurare i cluster Control Hub e le voci DNS se si modifica l'URL del servizio con un nuovo registro.
In tutti i casi, il monitoraggio e la risorsa dell'ambiente BroadWorks è di responsabilità. Se si desidera coinvolgere l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare servizi professionali.
Gestione dei certificati del server HTTP
You must manage these certificates for mTLS authenticated web applications on your XSP|ADPs:
-
Certificato di catena di fiducia del cloud Webex
-
Your XSP|ADP’s HTTP server interfaces’ certificates
Catena di fiducia
You download the chain of trust certificate from Control Hub and install it on your XSP|ADPs during your initial configuration. Si prevede di aggiornare il certificato prima della scadenza e di notificare come e quando modificarlo.
Interfacce server HTTP
The XSP|ADP must present a publicly signed server certificate to Webex, as described in Order Certificates. Quando si protegge per la prima volta l'interfaccia, viene generato un certificato autofirmato. Questo certificato è valido per un anno a partire da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Restricted by Partner Mode is a Partner Hub setting that partner administrators can assign to specific customer organizations to limit the organization settings that customer administrators can update in Control Hub. When this setting is enabled for a given customer organization, all of that organization's customer administrators, irrespective of their role entitlements, are unable to access a set of restricted controls in Control Hub. Only a partner administrator can update the restricted settings.
Restricted by Partner Mode is an organization-level setting rather than a role. However, the setting restricts specific role entitlements for customer administrators in the organization to which the setting is applied. |
Accesso amministratore cliente
Customer administrators receive a notification when Restricted-by-Partner Mode is applied. After login, they will see a notification banner at the top of the screen, immediately under the Control Hub header. The banner notifies the customer administrator that Restricted Mode is enabled and they may not be able to update some calling settings.
For a customer administrator in an organization where Restricted by Partner Mode is enabled, the level of Control Hub access is determined with the following formula:
(Control Hub access) = (Organization Role entitlements) - (Restricted by Partner Mode restrictions)
Customer administrators will face several restrictions, regardless of the Restricted-by-Partner Mode. These restrictions include:
- Call Settings: The 'App Options Call Priority' settings in the Calling menu are read-only.
- Location Setup: Setting up calling after location creation will be hidden.
- PSTN Management and Call Recording: These options will be greyed out for the location.
- Phone Number Management: In the Calling menu, phone number management is disabled, and the 'App Options Call Priority' settings, as well as call recordings, are read-only.
Restrictions
When Restricted-by-Partner Mode is enabled for a customer organization, customer administrators in that organization are restricted from accessing the following Control Hub settings:
-
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
-
Manage Users button is greyed out.
-
Manually Add or Modify Users—No option to add or modify users, either manually or via CSV.
-
Claim Users—not available
-
Auto-assign Licenses—not available
-
Directory Synchronization—Unable to edit directory sync settings (this setting is available to Partner-level admins only).
-
User details—User settings such as First Name, Last Name, Display Name and Primary Email* are editable.
-
Reset Package—No option to reset the package type.
-
Edit Services—No option to edit the services that are enabled for a user (e.g., Messages, Meetings, Calling)
-
View Services status—Unable to see full status of Hybrid Services or Software Upgrade Channel
-
Primary Work Number—This field is read-only.
-
-
Nella vista Account, non sono disponibili le seguenti impostazioni:
-
Company Name is read-only.
-
-
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
-
Domain—Access is read-only.
-
Email—The Suppress Admin Invite Email and Email Locale Selection settings are read-only.
-
Authentication—No option to edit Authentication and SSO settings.
-
-
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
-
Call Settings—The App Options Call Priority settings are read-only.
-
Calling Behavior—Settings are read-only.
-
Location > PSTN—The Local Gateway and Cisco PSTN options are hidden.
-
-
Under SERVICES, the Migrations and Connected UC service options are suppressed.
Abilita limitato dalla modalità partner
Partner administrators can use the below procedure to enable Restricted by Partner Mode for a given customer organization (the default setting is enabled).
-
Sign in to Partner Hub ( https://admin.webex.com) and select Customers.
-
Selezionare l'organizzazione del cliente applicabile.
-
Nella vista delle impostazioni a destra, abilitare l'interruttore Limitato dalla modalità partner per attivare l'impostazione.
Se si desidera disattivare Limitazione della modalità partner, disabilitare l'interruttore.
If the partner removes the restricted administrator mode for a customer administrator, the customer administrator will be able to perform the following:
|
For more information on list of time zones supported for Wholesale Provisioning, see the List of Time Zones supported for Wholesale Provisioning.
Partner Analytics
I miglioramenti apportati a Control Hub rendono semplice agli amministratori dei partner visualizzare e aggiornare le informazioni del pacchetto per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata tra tutti i clienti e include i seguenti dettagli:
-
Totale utenti per pacchetto (Softphone, Basic, Standard, Premium)
-
Tendenza utenti per pacchetto (giornaliera/settimanale/mensile)
-
Clienti con n. di pacchetti assegnati
Per dettagli completi sull'uso della funzionalità di analisi dei partner, vedere l'articolo Webex Analytics per Webex per i pacchetti Eseeme e Webex per pacchetti Broadworks in Partner Hub.
Billing Report APIs
Webex for Developers provides public APIs that can be used for monthly billing reports. Partner administrators can use these APIs to create, list, get and delete billing reports. The following table lists the APIs, the type of access required and the role requirements.
Billing API |
Scopo |
Type of Access |
Role Requirement for API (Admin requires at least one of these roles) |
---|---|---|---|
Create a BroadWorks Billing Report |
Used to generate a billing report. |
Write access |
|
List BroadWorks Billing Reports |
Used to list the reports that are available to view. |
Read Access |
|
Get a BroadWorks Billing Report |
Used to obtain a copy of a generated report. |
Read Access |
|
Delete a BroadWorks Billing Report |
Used to delete a generated report. |
Write Access |
|
Billing Fields
The following table lists the fields that are contained in the generated report.
Campo |
Descrizione |
---|---|
resellerName |
Partner name or Partner Org Id |
billingId |
Partner Unique Billing Identifier or C-Number |
spEnterpriseId |
The Service Provider-supplied unique identifier for the subscriber's enterprise. |
Interno |
The Customer Internal Trial Status (Yes/No) |
userId |
The userID of the subscriber on BroadWorks |
subscriberId |
A unique identifier for the subscriber in question in Webex |
selfActivated |
Yes/No |
firstStartDate |
Date when subscriber was provisioned. |
billingStartDate |
Date when billing starts in this month |
billingEndDate |
Date when billing ends in this month |
pacchetto |
The package type that is being charged |
quantity |
Prorated quantity for billing.
|
|
Risoluzione dei problemi di Webex per Cisco BroadWorks
Iscrizione alla pagina di stato Webex
Innanzitutto, https://status.webex.com verificare se si verifica un'interruzione imprevista del servizio. Se non è stata modificata la configurazione in Control Hub o BroadWorks prima dell'interruzione, controllare la pagina di stato. Per ulteriori informazioni sulla sottoscrizione per lo stato e le notifiche di incidenti, vedere il Centro di assistenza Webex.
Uso della funzionalità di analisi di Control Hub
Webex tiene traccia dei dati di utilizzo e qualità per la propria organizzazione e per le organizzazioni dei clienti. Ulteriori informazioni sulla funzionalità di analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
I clienti o gli utenti non vengono creati in Control Hub con provisioning flow provisioning:
-
Il server dell'applicazione può raggiungere l'URL di provisioning?
-
L'account di provisioning e la password sono corretti, se esistono in BroadWorks?
I cluster non riescono regolarmente con i test di connettività:
La connessione mTLS al servizio di autenticazione dovrebbe non riuscire quando si crea il primo cluster in Partner Hub poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. Without that, you cannot create a trust anchor on the authentication service XSP|ADPs, so the test mTLS connection from Partner Hub is not successful. |
-
Are the XSP|ADP interfaces publicly accessible?
-
Si stanno utilizzando le porte corrette? È possibile inserire una porta nella definizione dell'interfaccia sul cluster.
Convalida interfacce non riuscita
Interfacce Xsi-Actions e Xsi-Events:
- Controllare che gli URL di interfaccia siano immessi correttamente sul cluster in Partner Hub, incluso
/v2.0/
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Esaminare l'avviso di configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Controllare che gli URL di interfaccia siano immessi correttamente sul cluster in Partner Hub, incluso
/v2.0/
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Rivedere i consigli di configurazione dell'interfaccia in questo documento, con particolare attenzione su:
- Make sure you shared RSA keys across all XSP|ADPs.
- Make sure you provided AuthService URL to the web container on all XSP|ADPs.
- Se è stata modificata la configurazione di crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. The XSP|ADP requires that you enter the IANA name format for the TLS ciphers. Una versione precedente di questo documento indicava in modo errato le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
-
If you are using mTLS with Authentication Service, are the Webex client certificates loaded on your XSP|ADP/ADP trust store? L'app (o l'interfaccia) è configurata per richiedere certificati client?
-
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere certificati client?
Problemi del client
Verificare che il client sia connesso a BroadWorks
-
Accedere all'app Webex.
-
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.
-
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici. Viene visualizzato lo stato della SSO è stato eseguito l'accesso.
Se viene visualizzato un altro servizio telefonico, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Ciò significa:
-
Il client ha transverso correttamente i microservizi Webex richiesti.
-
L'utente è stato autenticato correttamente.
-
Il client è stato emesso un token Web JSON a lungo termine dal sistema BroadWorks.
-
Il client ha recuperato il profilo del dispositivo ed è registrato per BroadWorks.
Registri client
Tutti i client app Webex possono inviare log a Webex. Questa è l'opzione migliore per client mobili. È necessario registrare anche l'indirizzo e-mail dell'utente e l'ora approssimativa del problema, se si desidera assistenza dal Tac. For more information, see Where Do I Find Support for Webex?
Se occorre raccogliere manualmente i registri da un PC Windows, si trovano nel seguente modo:
Windows PC: C:\Users\{username}\AppData\Local\CiscoSpark
Mac: /Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS non configurata correttamente
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
-
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
-
Verificare che la catena di certificati Webex sia installata come trust anchor.
-
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e che sia firmato da un'autorità di certificazione attendibile.
Messaggio interruzione licenza
Questo messaggio può essere visualizzato per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'uso della licenza supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
For detailed information on troubleshooting Webex for Cisco BroadWorks, refer to the Webex for Cisco BroadWorks Troubleshooting Guide.
Supporto
Criteri di supporto stato originale
Il provider di servizi è il primo punto di contatto per il supporto clienti finale (enterprise). Inoltrare i problemi che il SP non può risolvere al TAC. Il supporto della versione server BroadWorks segue i criteri della Versione corrente e delle due precedenti versioni principali (N-2). Read more at BroadSoft products lifecycle policy section in BroadSoft Lifecycle Policy and BroadWorks Software Compatibility Matrix.
Criteri di escalation
-
L'utente (provider di servizi/partner) è il primo punto di contatto per il supporto dei clienti finali (enterprise).
-
I problemi che non possono essere risolti dal SP vengono inoltrati al TAC.
Versioni BroadWorks
-
Il supporto della versione server BroadWorks segue i criteri di BroadSoft, della versione corrente e delle due versioni principali precedenti (N-2). Read more at BroadSoft products lifecycle policy section in BroadSoft Lifecycle Policy and BroadWorks Software Compatibility Matrix.
Risorse di self-support
-
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, in cui è disponibile una pagina specifica di Webex per Cisco BroadWorks che elenca la Guida per l'app Webex comune e gli argomenti di supporto.
-
È possibile personalizzare l'app Webex con questo URL della Guida e un URL per la segnalazione di problemi.
-
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I log vengono nel cloud Webex, dove possono essere analizzati da Webex DevOps.
-
È disponibile anche una pagina del Centro assistenza dedicata alla guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccolta delle informazioni per l'invio di una richiesta di assistenza
Quando si visualizzano errori in Control Hub, è possibile che siano state allegati informazioni che consentono al Tac di ricercare la causa del problema. Ad esempio, se viene visualizzato un ID di verifica per un determinato errore o un codice di errore, salvare il testo da condividere con noi.
Provare a includere almeno le seguenti informazioni quando si invia una query o si apre un caso:
-
ID organizzazione cliente e ID organizzazione partner (ciascun ID è una stringa di 32 cifre esadecimali, separate da trattini)
-
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce una
-
Indirizzo e-mail utente (se si verificano problemi con un determinato utente)
-
Versioni del client (se il problema presenta sintomi notati attraverso il client)
Confronto DI UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > |
UC-One SaaS |
Webex per Cisco BroadWorks |
---|---|---|
Cloud |
Cisco UC-One Cloud (GCP) |
Cloud Webex (APPLICAZIONI WEBEX) |
Client |
UC-One: Mobile, Desktop Receptionist, Supervisore |
Webex: Mobile, Desktop, Web |
Principale differenza tecnologia |
Riunioni consegnate su Broadsoft Meet Technology |
Riunioni consegnate su Webex Meetings Technology |
Versioni di prova sul campo iniziali |
Ambiente di gestione temporanea, client Beta |
Ambiente di produzione, client GA |
Identità utente |
BroadWorks ID utilizzato come ID principale, a meno che provider di servizi sito non SSO già.
ID utente e segreto in BroadWorks |
ID e-mail in Cisco CI serve come ID principale SSO integrazioni in provider di servizi BroadWorks in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks in quel momento.
L'utente fornisce le credenziali tramite SSO broadworks e secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e autenticazione nel provider di identità |
Autenticazione client |
Gli utenti forniscono le credenziali tramite il client Token a lungo accesso BroadWorks richiesti se si utilizza la messaggistica Webex |
Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso e aggiornamento dei token Webex |
Gestione/configurazione |
I sistemi ANDR E BSS e Portale rivenditore |
SISTEMI CUI/BSS e Control Hub |
Attivazione partner/provider di servizi partner |
Una sola impostazione per Cisco Operations |
Una sola impostazione per Cisco Operations |
Attivazione cliente/aziendale |
Portale rivenditore |
Control Hub Creazione automatica alla prima iscrizione utente |
Opzioni di attivazione utente |
Auto iscrizione Impostazione di IM&P esterno in BroadWorks
|
Impostazione di Integrated IM&P in BroadWorks (solitamente aziende) |
XSP|ADP service interfaces |
Azioni XSI
Eventi XSI CTI (mTLS) AuthService (mTLS opzionale) DMS |
Azioni XSI Azioni XSI (mTLS) Eventi XSI CTI (mTLS) AuthService (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 |
Scaricare e installare Webex. Per dettagli, vedere Webex | Download dell'app. |
2 |
Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 |
Inserire il proprio indirizzo e-mail e fare clic su Next(Avanti). |
4 |
In base alla configurazione dell'organizzazione in Webex, si verificano le seguenti operazioni: Webex viene caricato dopo aver eseguito correttamente l'autenticazione per IdP o BroadWorks.
|
Scambio dati e storage
Queste sezioni forniscono dettagli sullo scambio di dati e sullo storage con Webex. Tutti i dati sono crittografati sia in viaggio che a riposo. Per ulteriori dettagli, vedere Sicurezza app Webex.
provider di servizi ilboarding
Quando si configurano cluster e modelli utente in Webex Control Hub durante provider di servizi onboarding, si scambiano i seguenti dati BroadWorks memorizzati da Webex:
-
URL azioni Xsi
-
Xsi-Events URL
-
URL interfaccia CTI
-
URL servizio di autenticazione
-
Credenziali dell'adattatore provisioning BroadWorks
provider di servizi provisioning utente
Questa tabella elenca i dati utente ed aziendale s scambiati come parte del provisioning degli utenti attraverso le API Webex.
Trasferimento dati a Webex |
Da |
Attraverso |
Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito da SP) |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito dall'utente) |
Utente |
Portale di attivazione utente |
Sì |
Nome |
BroadWorks, per API |
API Webex |
Sì |
Cognome |
BroadWorks, per API |
API Webex |
Sì |
Numero di telefono principale |
BroadWorks, per API |
API Webex |
Sì |
Numero telefono cellulare |
BroadWorks, per API |
API Webex |
Sì |
Estensione principale |
BroadWorks, per API |
API Webex |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
BroadWorks, per API |
API Webex |
Sì |
Lingua |
BroadWorks, per API |
API Webex |
Sì |
Fuso orario |
BroadWorks, per API |
API Webex |
Sì |
Rimozione utente
Webex per api Cisco BroadWorks supporta la rimozione parziale e completa degli utenti. Questa tabella elenca tutti i dati utente archiviati durante il provisioning e ciò che viene eliminato in ciascuno scenario.
Dati utente |
Eliminazione parziale |
Eliminazione completa |
---|---|---|
ID utente BroadWorks |
Sì |
Sì |
|
No |
Sì |
Nome |
No |
Sì |
Cognome |
No |
Sì |
Numero di telefono principale |
Sì |
Sì |
Numero telefono cellulare |
Sì |
Sì |
Estensione |
Sì |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
Sì |
Sì |
LANGUAGE |
No |
Sì |
Recupero accesso utente e configurazione
Autenticazione Webex
Webex authentication refers to user sign-in to a Webex app by any of the Webex support authentication mechanisms. ( BroadWorks authentication is covered separately.) This table illustrates the type of data exchanged between the different components on the authentication flow.
Spostamento dei dati |
Da |
a |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (indipendente) |
Webex |
Browser utente |
Credenziali utente |
Browser utente |
Provider di identità (che dispone già di identità utente) |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Autenticazione BroadWorks
BroadWorks authentication refers to user sign-in to a Webex app using their BroadWorks credentials. Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti del flusso di autenticazione.
Spostamento dei dati |
Da |
a |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (proxy IdP Webex Bwks) |
Webex |
Browser utente |
Informazioni sul branding e URL BroadWorks |
Webex |
Browser utente |
Credenziali utente BroadWorks |
Utente attraverso il browser (pagina di accesso con branded servita da Webex) |
Webex |
Credenziali utente BroadWorks |
Webex |
BroadWorks |
File BroadWorks profilo utente |
BroadWorks |
Webex |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
BroadWorks Password Expiration Notification During Login
This feature enhances the login process and controls the login flow based:
Login warning and error message enhancement:
- At present the Wexbex for BWKS users who use BroadWorks authentication and login through the UAP do not get notification that their password is about to expire or that they are unable to login because the password has already expired. With this feature, if the password is about to expire in 10 days or less - the user receives warning that password is about to expire with indication how many days are left, and the user is advised to contact the Partner, or to follow the Forgot Password link on the login screen to reset their password.
- If the password has expired and the configuration in BroadWorks ‘enforcePasswordChangeOnExpiry’ is set to true then error “incorrect username and password” was thrown but now with this feature the error message is enhanced: The login attempt failed. The combination of the User ID and password provided does not match our records or your password needs to be updated. Try again or contact your administrator to update the password. Error code 100006
Control login flow:
- Partner can restrict the login by enabling a setting “w4bwks-password-expiry-fail-login". This setting “can be enabled by Cisco upon request from a partner. If BroadWorks password has expired, the configuration in BroadWorks ‘enforcePasswordChangeOnExpiry’ is set to false and the setting ‘w4bwks-password-expiry-fail-login' is enabled then error is thrown saying password got expired x days ago whereas if setting service is disabled, then login is allowed. By default, the setting is disabled.
The Forgot Password link on the login page can be configured by the partner as part of the Advanced Customization feature. Partners would typically configure the link to navigate the user to a partner portal for password management and password reset.
This feature only improves the user login experience during login of activated user when the password is about to expire or has already expired. The feature does not handle if a password expires while the user is logged in the Webex app. The user will get notification for password expiration on their next login attempt. |
Recupero configurazione client
Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti nel recupero delle configurazioni del client.
Spostamento dei dati |
Da |
a |
---|---|---|
Iscrizione |
Client |
Webex |
Impostazioni dell'organizzazione, inclusi gli URL BroadWorks |
Webex |
Client |
Token BroadWorks JWORKS |
BroadWorks attraverso Webex |
Client |
Token BroadWorks JWORKS |
Client |
BroadWorks |
Token dispositivo |
BroadWorks |
Client |
Token dispositivo |
Client |
BroadWorks |
File di configurazione |
BroadWorks |
Client |
Utilizzo stato originale
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione in seguito alla scadenza del token attraverso BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Spostamento dei dati |
Da |
a |
---|---|---|
Segnalazione SIP |
Client |
BroadWorks |
Contenuto multimediale SRTP |
Client |
BroadWorks |
Segnalazione SIP |
BroadWorks |
Client |
Contenuto multimediale SRTP |
BroadWorks |
Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Spostamento dei dati |
Da |
a |
---|---|---|
Messaggistica e presenza HTTPS REST |
Client |
Webex |
Messaggistica e presenza HTTPS REST |
Webex |
Client |
Segnalazione SIP |
Client |
Webex |
Contenuto multimediale SRTP |
Client |
Webex |
Segnalazione SIP |
Webex |
Client |
Contenuto multimediale SRTP |
Webex |
Client |
Uso dell'API di provisioning
Accesso sviluppatore
La specifica API è disponibile su https://developer.webex.com e una guida all'uso è su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l'accesso per leggere la specifica API su https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Autenticazione e autorizzazione dell'applicazione
Your application integrates with Webex as an Integration. Questo meccanismo consente all'applicazione di eseguire attività amministrative (come il provisioning del sottoscrittore) per un amministratore all'interno dell'organizzazione partner.
Webex APIs follow the OAuth 2 standard ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere i token di aggiornamento e di accesso per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
È necessario prima registrare l'integrazione con Webex. Una volta registrata, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di aggiornamento e accesso necessari.
Per ulteriori informazioni sulle integrazioni e su come creare questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli richiesti per l'implementazione delle integrazioni, lo sviluppatore e l'utente che ha autorizzato, e possono essere tenute da persone/team separati nel proprio ambiente.
|
Nome organizzazione
The Organization Name depends on which provisioning mode you use:
-
Enterprise mode—The Organization Name is an exact match of spEnterpriseId.
-
Service Provider mode—The Organization Name is the groupID portion of the spEnterpriseId.
The Organization Name will contain any whitespace, uppercase and special characters specified in the original spEnterpriseId.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
We expect the Service Provider to be "patch current" with the latest BroadWorks patches and Release Independent (RI) apps. L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Accertarsi di esaminare le note di patch per queste patch software. Alcune patch potrebbero richiedere ulteriori requisiti CLI. |
Versione R22
Server |
Patch |
Additional Info |
---|---|---|
Server applicazione | ||
Required for Directory Sync | ||
Required to upgrade from V1 to V2 Push Notifications | ||
Required patch for Application Server | ||
Required to upgrade from V1 to V2 Push Notifications | ||
Required patch for Call Recording feature | ||
Required Patch for Flow-through Provisioning | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
Server dei profili | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
Piattaforma | ||
Required for NPS Authentication Proxy | ||
Required for NPS Authentication Proxy | ||
Required for the Auth Service with CI Token Validation | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
XSP|ADP |
Required for NPS Authentication Proxy | |
Required for the Auth Service with CI Token Validation | ||
Required for NPS Authentication Proxy | ||
Required to upgrade from V1 to V2 Push Notifications | ||
Required for NPS Authentication Proxy | ||
Required for NPS Authentication Proxy | ||
Required for the Auth Service with CI Token Validation | ||
Required for Unified Call History | ||
Altro |
AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server |
Patch |
Additional Info |
---|---|---|
Server applicazione |
Required for Directory Sync | |
Config App Server | ||
Required to upgrade from V1 to V2 Push Notifications | ||
Required for Call Recording | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
Server dei profili | ||
Piattaforma | ||
Required for NPS Authentication Proxy | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
XSP|ADP | ||
Required for NPS Authentication Proxy | ||
Required to upgrade from V1 to V2 Push Notifications | ||
Required for NPS Authentication Proxy | ||
Required for NPS Authentication Proxy | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
Altro |
Se si utilizza ADP... |
Required Patch for Hook Status (Presence) and Unified Call History |
Versione R24
Server |
Patch |
Additional Info |
---|---|---|
Server applicazione |
Required for Unified Messaging Server (UMS) | |
Required for flowthrough provisioning | ||
Required for Call Recording | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
Altro |
Required Patch for Hook Status (Presence) and Unified Call History |
Tag BroadWorks richiesti per Webex
For information on the BroadWorks system tags and custom tags that you must configure for Webex, refer to the Webex for Cisco BroadWorks Configuration Guide.
Provisioning utenti e flussi di attivazione
Provisioning describes adding the user to Webex. Activation includes email validation and service assignment in Webex. |
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se si dispone di indirizzi e-mail attendibili per gli utenti, è possibile scegliere di attivarli automaticamente quando vengono predisposti automaticamente. Questo processo è di "provisioning automatico e attivazione automatica".
Provisioning utenti automatizzato e attivazione automatica (flusso e-mail attendibile)
Prerequisiti
-
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
-
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
-
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase |
Descrizione |
---|---|
1 |
Si preventiva ed si eserviranno gli ordini per il servizio con i clienti. |
2 |
L'ordine del cliente viene processato ed è stato predisposto il cliente nel sistema. |
3 |
Il sistema di provisioning del servizio attiva il provisioning di BroadWorks. Questa operazione, in riepilogo, crea l'azienda e gli utenti. Quindi, assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM esterno. |
4 |
Questa operazione di provisioning attiva il provisioning automatico dell'organizzazione e degli utenti del cliente in Webex. (L'assegnazione del servizio IM&P causa la chiamata dell'adattatore di provisioning all'API di provisioning Webex). |
5 |
I sistemi devono utilizzare l'API di provisioning Webex se in seguito occorre regolare il pacchetto per l'utente (per effettuare una modifica rispetto al valore predefinito). |
SSO di accesso
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, consentendo l'autenticazione diretta a BroadWorks. L'immagine visualizza gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresentano ciò che il client fornisce per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizi BroadWorks che segue immediatamente dal flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione diretta BroadWorks abilitata (condivisione risorse multi-origine). Di seguito sono riportati alcuni flussi di SSO SAML alternativi:
-
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
-
L'unica differenza è nel punto 5 e 6 del flusso di accesso Webex. Nel punto 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
-
Il flusso procede attraverso le operazioni restanti nei due diagrammi.
-
Il SSO di registrazione non è utilizzato in questo flusso.
-
-
Autenticazione Webex SSO SAML:
-
Al punto 3 del flusso di accesso Webex, il servizio Common Identity servizi restituisce il provider di identità utilizzato dall'autenticazione Webex.
-
A questo punto, viene richiamato un flusso di SSO SAML alternativo per Webex.
-
Interazioni utente
Accedi
-
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
-
CI rileva che l'organizzazione cliente associata ha il proxy IDP BroadWorks configurato come IDP SAML. CI redirects to the IDP which presents the user with a sign-in page. (The Service Provider can brand this sign-in page.)
-
L'utente inserisce le proprie credenziali BroadWorks.
-
Broadworks autentica l'utente attraverso l'IDP. In caso positivo, IDP reindirizza il browser a CI con un SISTEMA SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
-
In caso di autenticazione eseguita correttamente, l'app Webex ottiene i token di accesso da CI (non mostrato nel diagramma). Il client le utilizza per richiedere un token JNTASSI (Jason Web Token) BroadWorks.
-
L'app Webex rileva la configurazione di chiamata da BroadWorks e da altri servizi di Webex.
-
L'app Webex si registra con BroadWorks.
Accesso dal punto di vista dell'utente
Questo diagramma è il flusso di accesso tipico, visualizzato dall'utente finale o dall'abbonato:
-
L'app Webex viene scaricata e installata.
-
È possibile che sia stato ricevuto il collegamento dal proprio provider di servizi oppure il download potrebbe essere trovato sulla pagina di download di Webex.
-
L'indirizzo e-mail viene inserito nella schermata di accesso di Webex. Fare clic su Avanti.
-
Solitamente, si viene reindirizzati a una provider di servizi a cui viene visualizzata una pagina con marchio.
-
Questa pagina potrebbe dare il benvenuto mediante il proprio indirizzo e-mail.
Se non si dispone di un indirizzo e-mail o se l'indirizzo e-mail è errato, inserire l'indirizzo nome utente BroadWorks.
-
Inserire la password BroadWorks.
-
Se è stato eseguito correttamente l'accesso, Webex si apre.
flusso chiamata: rubrica aziendale
flusso chiamata—PSTN cliente
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni client
Recupera profilo da REGISTRAZIONE DMS e SIP con AS
-
Il client chiama XSI per ottenere un token di gestione dispositivi e l'URL sul DMS.
-
Il client richiede il profilo del dispositivo dal DMS presentando il token dal punto 1.
-
Il client legge il profilo del dispositivo e recupera le credenziali SIP, gli indirizzi e le porte.
-
Il client invia un SIP REGISTER al controller SBC utilizzando le informazioni del punto 3.
-
SBC invia il SIP REGISTER ad AS (il controller SBC può eseguire una ricerca in NS per individuare un AS se SBC non conosce già l'utente SIP).
Linee guida di test e laboratorio
Le seguenti linee guida si applicano a organizzazioni di test e laboratorio:
-
provider di servizi partner sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
-
La fatturazione verrà addebitata a qualsiasi utente oltre i primi 50 utenti di prova.
-
Per assicurare un'elaborazione precisa della fattura, tutte le organizzazioni di test devono includere 'test' nel nome dell'organizzazione BroadWorks.
-
Le organizzazioni di test interne devono essere designate all'interno Webex Control Hub. Al fine di evitare che gli utenti di prova vengano fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di test:
-
Accedere all'hub partner e selezionare Clienti.
-
Selezionare il cliente appropriato.
-
Nella barra di controllo a destra, abilitare l'interruttore Organizzazione test interna.
Riproduzione segreteria telefonica
Per la segreteria telefonica, accertarsi di configurare il server multimediale per l'uso di uno dei seguenti codici:
-
mp3
-
wav— I file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android)
Se si utilizzano file wav, eseguire i seguenti comandi CLI per verificare il server dell'applicazione e server multimediale:
-
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
-
MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACL
- Elenco di controllo accessi
- ALG
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APNS
- Utenti Apple servizio di notifica push
- AS
- Server applicazione
- ATA
- Adattatore telefono analogico, adattatore per la conversione della telefonia analogica VoIP
- BAM
- Gestione applicazioni BroadSoft
- Autenticazione di base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- BMS
- Server di messaggistica BroadSoft
- BOSH
- Flussi bidirezionale su HTTP sincrono
- BRI
- L'interfaccia BRI (Basic Rate Interface) è un metodo di accesso ISDN
- Bundle
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico di telefonia (cf. partner, provider di servizi, rivenditore aggiunto valore)
- CAPTCHA
- Test del turing pubblico completamente automatizzato per incisire sui computer e sull'humans apart
- CODICE CCXML
- Controllo chiamata EXtensible Markup Language
- CIF
- Formato intermedio comune
- CLI
- Interfaccia della riga di comando
- CN
- Nome comune
- CSP
- Server push notifiche chiamate. A Notification Push Server that runs on an XSP|ADP in your environment, to push call notifications to FCM and APNS. Vedere Proxy NPS.
- CPE
- Apparecchiatura locale del cliente
- CPR
- Regola di presenza personalizzata
- CSS
- Foglio di stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione di telefonia su computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- Non disturbare
- Non disturbare
- DNS
- Sistema di nomi di dominio
- DPG
- Chiama gruppo peer
- DSCP
- Punto codici servizi differenziati
- DTAF
- File di archivio del tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza dual-tone
- Utente finale
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. per l'abbonato)
- Aziendale
- Un gruppo di utenti finali (cf. organizzazione)
- FCM
- Messaggistica cloud Firebase
- FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creazione di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning flow-through completo
- Creazione e verifica di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks e l'asserzione che ciascun utente BroadWorks ha un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. Il plug-on del telefono o del fax o i plug-in sul sistema telefonico analogico. Fornisce un'indicazione di hook/off-hook (chiusura loop). Poiché la porta BLUETOOTH è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo BLUETOOTH".
- FXS
- Foreign Exchange Subscriber è la porta che consegna effettivamente la linea analogica al sottoscrittore. In altre parole, è il plug-in alla parete che offre un segnale di chiamata, una corrente a batteria e una suoneria.
- GCM
- Messaggio Google Cloud
- GCM
- Modalità Galois/Counter Mode (tecnologia di crittografia)
- NASCOSTO
- Dispositivo interfaccia utente
- HTTPS
- Protocollo di trasferimento ipertestuale socket sicuri
- IAD
- Dispositivo di accesso integrato
- IM&P
- Messaggistica immediata e presenza
- IP PSTN
- Un provider di servizi che fornisce VoIP servizi PSTN, intercambiabili con ITSP, o un termine generale per la telefonia 'pubblica' collegata da Internet, collettivamente fornito dai principali fornitori di telecomunicazioni (anziché tramite paesi, come PSTN è)
- ITSP
- Servizi di telefonia Internet provider di servizi
- IVR
- Risposta vocale interattiva/Risponditore
- JID
- The native address of an XMPP entity is called a Jabber Identifier or JID localpart@domain.part.example.com/resourcepart (@ . / are separators)
- JSON
- Notifica oggetto Java Script
- JSSE
- Estensione socket sicura Java; la tecnologia sottostante che fornisce funzioni di connettività sicura ai server BroadWorks
- KEM
- Modulo di estensione chiave (telefoni Cisco hardware)
- LLT
- Token lungo(o long life); una forma di auto-descrizione, sicura di token di connessione che consente agli utenti di rimanere autenticati per più tempo e non è legata a applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIB
- Base informazioni di gestione
- MS
- Server multimediale
- Mtls
- Autenticazione reciproca tra due parti, mediante lo scambio di certificati, quando si stabilisce una connessione TLS
- MUC
- Chat multi-utente
- NAZ
- Traduzioni indirizzi di rete
- NPS
- Server push di notifica; vedere CNPS
- NPS Proxy
-
Servizio in Webex che fornisce token di autorizzazione breve al CNPS, abilitando il push delle notifiche di chiamata su FCM e APNs e, infine, sui dispositivi Android e iOS che eseguono Webex.
- OCI
- Apri interfaccia client
- Organizzazione
- Una società o un'organizzazione che rappresenta un gruppo di utenti finali (cf. Enterprise)
- OTG
- Gruppo trunk in uscita
- Pacchetto
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. Bundle)
- Partner
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. Valore aggiunto rivenditore, provider di servizi, vettore)
- PBX
- Exchange su succursale privato
- PEM
- Messaggio e-mail avanzato sulla privacy
- PLMN
- Rete mobile su rete pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia di telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- PS
- Server dei profili
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Un sito Web che consente all'amministratore del rivenditore di configurare la propria soluzione UC-One SaaS. Talvolta è noto come portale BANG, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Controllo bordo sessione
- SCA
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; Un'organizzazione che fornisce servizi telefonici o correlati ad altre organizzazioni (cf. Gestore telefonico, partner, rivenditore aggiunto valore)
- SIP
- SIP (Session Initiation Protocol)
- SLT
- Token breve (o breve durata) (denominato anche token SSO BroadWorks); un token autenticato a uso singolo utilizzato per ottenere l'accesso protetto alle applicazioni Web.
- SMB
- Piccola e media azienda
- SNMP
- Semplice protocollo di gestione della rete
- sRTCP
- protocollo Secure Realtime Transfer Control Protocol (VoIP multimediale per chiamate in tempo reale)
- sRTP
- protocollo Secure Realtime Transfer Protocol (VoIP multimediale di chiamata)
- SSL
- Livello socket sicuri
- Abbonato
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. Utente finale)
- TCP
- Protocollo di controllo trasmissione
- TDM
- Multiplexing divisione temporale
- TLS
- Sicurezza livello di trasporto
- Tos
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Unified Communications
- UI
- Interfaccia utente
- UID
- Identificativo univoco
- UMS
- Server di messaggistica
- URI
- Uniform Resource Identifier
- URL
- Localizzatore risorse uniforme
- USS
- Server di condivisione
- UTC
- Ora universale universale
- UV
- Video Server
- Rivenditore aggiunto valore (VAR)
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. vettore, partner, provider di servizi)
- VGA
- Array di elementi grafici video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Voice Extensible Markup Language
- Webdav
- Creazione e versione per Web distributed authoring
- WebRTC
- Comunicazioni in tempo reale Web
- WRS
- WebRTC Server
- XMPP
- Protocollo di messaggistica e presenza Estendi
Configurazione dei servizi (con mTLS per il servizio di autenticazione)
The below procedures replace the procedures in the topic Configure Services on Your Webex for Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida di token CI. These procedures are mandatory if you are running multiple Webex organizations off the same XSP|ADP server. Altrimenti, sono opzionali.
If you aren't running multiple Webex organizations off the same XSP|ADP server, CI Token Validation (with TLS) is recommended for the Auth Service. Refer to Configure Services on Your Webex for Cisco BroadWorks XSP|ADPs for details on how to configure the Authentication service and other services. |
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi connettori Cisco BroadWorks.
Only one instance of the Xsi-Events applications should be deployed on the XSP|ADP used for the CTI interface.
All Xsi-Events used for integrating Broadworks with Webex must have the same callControlApplicationName defined under Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
When a user is onboarded to Webex, Webex creates a subscription for the user on the AS in order to receive telephony events for presence and call history. The subscription is associated with the callControlApplicationName and the AS uses it to know to which Xsi-Events to send the telephony events.
Changing the callControlApplicationName, or not having the same name on all Xsi-Events webapps will impact subscriptions and telephony events functionality. |
Configurazione del servizio di autenticazione (con mTLS)
BroadWorks long-lived tokens are generated and validated by the authentication service hosted on your XSP|ADPs.
Requisiti
-
The XSP|ADP servers hosting the Authentication Service must have an mTLS interface configured.
-
XSP|ADPs must share the same keys for encrypting/decrypting BroadWorks long lived tokens. Copying these keys to each XSP|ADP is a manual process.
-
XSP|ADPs must be synchronized with NTP.
Panoramica sulla configurazione
The essential configuration on your XSP|ADPs includes:
-
Distribuire il servizio di autenticazione.
-
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
-
Generate and share RSA keys across XSP|ADPs.
-
Fornire l'URL authService al contenitore Web.
Deploy the Authentication Service on XSP|ADP
On each XSP|ADP used with Webex:
-
Attivare l'applicazione del servizio di autenticazione sul
percorso /authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService
(where
<version>
is your BroadWorks version). -
Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
deploy application /authService
Configurazione della durata del token
-
Controllare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
-
Impostare la durata su 60 giorni (il massimo è 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
set tokenDurationInHours 1440
Genera e condividi chiavi RSA
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittografia di token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
Because of these two factors you need to generate keys on one XSP|ADP then copy them to all other XSP|ADPs.
If you cycle keys or change the key length, you need to repeat the following configuration and restart all the XSP|ADPs. |
-
Select one XSP|ADP to use for generating a key pair.
-
Use a client to request an encrypted token from that XSP|ADP, by requesting the following URL from the client’s browser:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(This generates a private / public key pair on the XSP|ADP, if there wasn’t one already)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
-
Copy the exported file
/var/broadworks/tmp/authService.keys
to the same location on the other XSP|ADPs, overwriting an older.keys
file if necessary. -
Import the keys on each of the other XSP|ADPs:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al container Web
The XSP|ADP’s web container needs the authService URL so it can validate tokens.
On each of the XSP|ADPs:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per lo strumento di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Controllare il parametro con
get
. -
Restart the XSP|ADP.
Configurazione di TLS e della crittografia sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurazione TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > trasporto > http > interfaccia Server HTTP = Più specifico
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Reading HTTP Server TLS Interface Configuration on the XSP|ADP
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il
comando get e leggere i
risultati. Dovrebbero essere presenti le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Tomcat obbligatorio un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
È necessario configurare l'interfaccia HTTP che interagisce con Webex Cloud per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Enter the command
get <interfaceIp> 443
to see which protocols are already used on this interface. -
Enter the command
add <interfaceIp> 443 TLSv1.2
to ensure that interface can use TLS 1.2 when communicating with the cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia del server HTTP
Per configurare i crittografia richiesti:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Enter the command
get <interfaceIp> 443
to see which ciphers are already used on this interface. There must be at least one from the Cisco recommended suites (see XSP|ADP Identity and Security Requirements in the Overview section). -
Enter the command
add <interfaceIp> 443 <cipherName>
to add a cipher to the HTTP Server interface.
The XSP|ADP CLI requires the IANA standard cipher suite name, not the openSSL cipher suite name. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
del server HTTP, utilizzare:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità del servizio di autenticazione (con mTLS)
-
Accedere a Control Hub con l'account dell'amministratore del partner.
-
Go to Download Webex CA Certificate to get
and clickCombinedCertChain2023.txt
on your local computer.
These files contain two sets of two certificates. You need to split the files before you upload them to the XSP|ADPs. All files are required. -
Split the certificate chain into two certificates -
combinedcertchain2023.txt
.-
Open
combinedcertchain2023.txt
in a text editor. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e -----END CERTIFICATE----- , e incollare il blocco di testo in un nuovo
file. -
Save the new file as
root2023.txt
. -
Save the original file as
issuing2023.txt
. Il file originale ora deve contenere solo un blocco di testo, racchiuso tra lerighe -----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copy both text files to a temporary location on the XSP|ADP you are securing, e.g.
/var/broadworks/tmp/root2023.txt
and/var/broadworks/tmp/issuing2023.txt
. -
Sign in to the XSP|ADP and navigate to
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Optional) Run helpUpdateTrust
to see the parameters and command format. -
Upload the certificate files to new trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
All aliases must have a different name.
webexclientroot
,webexclientroot2023
,webexclientissuing
, andwebexclientissuing2023
are example aliases for the trust anchors; you can use your own as long as all four entries are unique. -
Confermare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
The way you enable mTLS for your application depends on the applications you are hosting on the XSP|ADP. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, mTLS è richiesto per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
-
Sign in to the XSP|ADP whose interface you're configuring.
-
Navigate to
XSP|ADP_CLI/Interface/Http/HttpServer>
and run theget
command to see the interfaces. -
Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che corrisponde a mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true
See the XSP|ADP CLI documentation for detail. Essenzialmente, la prima true protegge l'interfaccia con TLS (il certificato server viene creato se richiesto) e la seconda forza true l'interfaccia a richiedere l'autenticazione del certificato
client
(insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Interface Port Name Secure Client Auth Req Cluster Fqdn ======================================================= 192.0.2.7 443 XSP|ADP01.collab.example.net true false 192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (Client Auth Req = true) è abilitato sulla porta 192.0.2.7
444.
TLS è abilitato sulla porta 192.0.2.7
443.
(Opzione) Configurare mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
The way you enable mTLS for your application depends on the applications you are hosting on the XSP|ADP. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, mTLS è richiesto per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
-
Sign in to the XSP|ADP whose interface you're configuring.
-
Navigate to
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
and run theget
command to see which applications are running. -
Per aggiungere un'applicazione e richiedere l'autenticazione del client (che significa lo stesso di mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true
See the XSP|ADP CLI documentation for detail. I nomi delle applicazioni sono elencati in questo elenco. Vero
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService alla versione 192.0.2.7:443 e richiede che a tale applicazione sia richiesta e autenticata dal client.
Controlla con ottieni
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> get
Interfaccia Porta IP Nome applicazione Client Autenticazione ======================================================
192.0.2.7 443 AuthenticationService true
Configure Device Management on XSP|ADP, Application Server, and Profile Server
Profile Server and XSP|ADP are mandatory for Device Management. Tali impostazioni devono essere configurate in base alle istruzioni nella Guida alla configurazione di Gestione dispositivi BroadWorks.
Dove andare avanti
For configuration, you can rejoin the main document flow at CTI Interface and Related Configuration.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca con AuthService
Webex interagisce con il servizio di autenticazione su (autenticazione) TLS reciproca connessione autenticata. This means Webex presents a client certificate and the XSP|ADP must validate it. In order to trust this certificate, use the Webex CA certificate chain to create a trust anchor on XSP|ADP (or proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
-
Andare a Impostazioni > Chiamata BroadWorks.
-
Fare clic sul collegamento per il download del certificato.
È possibile ottenere la catena di certificati anche da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt. |
The exact requirements for deploying this Webex CA certificate chain depends on how your public facing XSP|ADPs are deployed:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Directly to the XSP|ADP
Il diagramma seguente riepiloga i punti in cui la catena di certificati CA Webex deve essere distribuita in questi tre casi.
Requisiti del certificato TLS reciproca per il proxy con bridge TLS
-
Webex presenta un certificato client firmato dall'autorità di certificazione Webex nel proxy.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità del proxy, pertanto il proxy considera attendibile il certificato client.
-
The publicly signed XSP|ADP server certificate is also loaded into the proxy.
-
Il proxy presenta un certificato server firmato pubblicamente con Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
The proxy presents an internally signed client certificate to the XSP|ADPs.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3:
Uso chiave estesa X509v3:
1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. Internal server certificates for the XSP|ADP can be SAN.
-
The XSP|ADPs trust the internal CA.
-
The XSP|ADPs present an internally signed server certificate.
-
Il proxy considera attendibile la CA interna.
Requisiti del certificato TLS reciproca per proxy tls passizzato o XSP in DMZ
-
Webex presenta un certificato client firmato ca Webex agli XSP.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità degli XSP, pertanto gli XSP considerano attendibile il certificato client.
-
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
-
Gli XSP presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP.
Cronologia revisioni documenti
The following table shows a history of changes to this document over the past 12 months.
Data |
Versione | Descrizione della modifica | |
---|---|---|---|
August 09, 2024 |
2-122 |
| |
August 01, 2024 |
2-121 |
| |
25 giugno 2024 |
2-120 |
| |
June 14, 2024 |
2-119 |
| |
May 13, 2024 |
2-118 |
| |
May 10, 2024 |
2-117 |
| |
May 6, 2024 |
2-116 |
| |
May 2, 2024 |
2-115 |
| |
April 10, 2024 |
2-114 |
| |
March 27, 2024 |
2-113 |
| |
March 22, 2024 |
2-112 |
| |
March 07, 2024 |
2-111 |
| |
February 24, 2024 |
2-110 |
| |
February 20, 2024 |
2-109 |
| |
February 07, 2024 |
2-108 |
| |
January 25, 2024 |
2-107 |
| |
January 23, 2024 |
2-106 |
| |
January 10, 2024 |
2-105 |
| |
December 20, 2023 |
2-104 |
| |
December 13, 2023 |
2-103 |
| |
December 12, 2023 |
2-102 |
| |
December 08, 2023 |
2-101 |
| |
November 08, 2023 |
2-100 |
| |
October 25, 2023 |
2-99 |
| |
September 13, 2023 |
2-98 |
| |
September 04, 2023 |
2-97 |
| |
August 08, 2023 |
2-96 |
| |
June 23, 2023 |
2-95 |
| |
May 30, 2023 |
2-94 |
| |
May 26, 2023 |
2-93 |
| |
24 maggio 2023 |
2-92 |
| |
May 10, 2023 |
2-91 |
| |
May 09, 2023 |
2-90 |
| |
May 04, 2023 |
2-89 |
| |
27 aprile 2023 |
2-88 |
| |
14 aprile 2023 |
2-87 |
| |
17 marzo 2023 |
2-86 |
| |
March 11, 2023 |
2-85 |
| |
March 10, 2023 |
2-84 |
| |
March 07, 2023 |
2-83 |
| |
28 febbraio 2023 |
2-82 |
| |
February 15, 2023 |
2-81 |
| |
February 10, 2023 |
2-80 |
| |
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione fornisce agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei clienti o forniscono questa soluzione direttamente ai relativi abbonati.
Scopo soluzione
-
Per fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che dispongono già del servizio di chiamata fornito dai provider di servizi BroadWorks.
-
Per fornire il servizio di chiamata basato a BroadWorks a clienti Webex piccoli e medi.
Contesto
In continua continua evoluzione di tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo impegno è spostare le funzionalità di chiamata BroadWorks nell'app Webex e ridurre l'investimento nei client UC-One.
Benefici
-
Prova futura: di fronte all'end-of-life di UC-One Collaborate, movimento di tutti i clienti verso il Unified Client Framework (UCF)
-
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex e conservazione delle chiamate BroadWorks sulla rete di telefonia
Ambito soluzione
-
I clienti esistenti/nuovi e medi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre della chiamata BroadWorks.
-
I clienti Webex esistenti, da piccoli a medi, desiderano aggiungere la chiamata BroadWorks.
-
Non aziende più grandi (ti prego di esaminare il nostro portfolio Enterprise per Webex).
-
Non i singoli utenti (valutare le offerte Webex online).
Le serie di funzioni in Webex per Cisco BroadWorks hanno come obiettivo casi d'uso di piccola e media attività. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità dei sistemi SME e ne valutiamo costantemente l'idoneità per questo segmento. È possibile scegliere di nascondere o rimuovere funzioni altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# |
Requisito |
Note |
---|---|---|
1 |
Patch Current BroadWorks R22 or above | |
2 |
XSP|ADP for XSI, CTI, DMS, and authService |
Dedicated XSP|ADP for Webex for Cisco BroadWorks |
3 |
Separate XSP|ADP for NPS, can be shared with other solutions that use NPS. |
If you have an existing collaborate deployment, then review recommendations on XSP|ADP and NPS configurations. |
4 |
Convalida token CI (con TLS) configurato per connessioni Webex al servizio di autenticazione. | |
5 |
mTLS configurato per le connessioni Webex all'interfaccia CTI. |
Altre applicazioni non richiedono mTLS. |
6 |
Gli utenti devono esistere in BroadWorks e necessitano dei seguenti attributi, in base alla propria decisione di provisioning:
|
Per e-mail affidabili: Si consiglia di inserire lo stesso indirizzo e-mail nell'attributo ID alternativo anche per consentire agli utenti di accedere con indirizzo e-mail per BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'utilizzo di messaggi e-mail non attendibili può inviare il messaggio e-mail alla cartella della posta indesiderata o dello SPAM dell'utente. L'amministratore potrebbe aver modificato le impostazioni e-mail dell'utente per consentire i domini |
7 |
File DTAF Webex per Cisco BroadWorks per l'app Webex | |
8 |
BW Business Lic o Std Enterprise o Prem Enterprise User Lic + Webex per l'abbonamento Cisco BroadWorks |
Se è già presente una distribuzione di collaborazione esistente, non è più necessario il bundle aggiuntivo UC-One, la collaborazione Lic e le porte della conferenza Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non è necessario apportare ulteriori modifiche se non si accettano i termini del pacchetto Premium. |
9 |
L'indirizzo IP/porte deve essere accessibile attraverso i servizi back-end Webex e le app Webex su Internet pubblico. |
Vedere la sezione "Preparazione della rete". |
10 |
TLS v1.2 Configuration on XSP|ADPs | |
11 |
Per il provisioning Flowworks, il server dell'applicazione deve connettersi all'adattatore di provisioning BroadWorks. La configurazione del proxy in uscita non viene testata o supportato. Se si utilizza un proxy in uscita, si accetta la responsabilità di supportarlo con Webex per Cisco BroadWorks. |
Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è comprendere, preparare, distribuire e gestire la soluzione Webex per Cisco BroadWorks. Le sezioni principali del documento riflettono questo scopo.
Questa guida include informazioni concettuali e materiale di riferimento. Intendiamo coprire tutti gli aspetti della soluzione in questo documento.
La serie minima di attività per la distribuzione della soluzione è la seguente:
-
Raggiungere il team dell'account per diventare un partner Cisco. È obbligatorio esplorare i punti di contatto Cisco per acquisire familiarità (ed essere addestrati). Quando si diventa un partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuire Webex per Cisco BroadWorks > onboarding dei partner in questo documento).
-
Configurare i sistemi BroadWorks per l'integrazione con Webex. (See Deploy Webex for Cisco BroadWorks > Configure Services on Your Webex for Cisco BroadWorks XSP|ADPs in this document.)
-
Utilizzare Partner Hub per collegare Webex a BroadWorks. Vedere Distribuire Webex per Cisco BroadWorks > l'organizzazione partner in Partner Hub in questo documento.
-
Utilizzare Partner Hub per preparare i modelli di provisioning utente. (See Deploy Webex for Cisco BroadWorks > Configure your Onboarding templates in this document.)
-
Test and onboard a customer by provisioning at least one user. (See Deploy Webex for Cisco BroadWorks > Configure Your Test Organization.)
-
Operazioni di alto livello, nell'ordine tipico. Esistono diverse attività determinanti che non è possibile ignorare.
-
Se si desidera creare le proprie applicazioni per gestire Webex per abbonati Cisco BroadWorks, leggere Uso dell'API di provisioning nella sezione Di riferimento di questa guida.
Terminologia
We try to limit the jargon and acronyms used in this document, and to explain each term when it’s first used. (See Webex for Cisco BroadWorks Reference > Terminology if a term isn’t explained in context.)
Funzionamento
Webex per Cisco BroadWorks è un'offerta che integra la chiamata BroadWorks in Webex. Gli abbonati utilizzano una singola applicazione (app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
-
Gli utenti chiamano PSTN numeri di telefono utilizzando l'infrastruttura BroadWorks.
-
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino per introdurre i numeri).
-
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Webex Call" nell'app Webex ( queste chiamate sono app Webex all'app Webex, non all'app Webex PSTN).
-
Gli utenti possono ospitare e partecipare Webex Meetings.
-
Gli utenti possono inviare messaggi l'uno all'altro o negli spazi (chat di gruppo persistente) e usufruire delle funzioni di ricerca e condivisione di file (su infrastruttura Webex).
-
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
-
Dopo averci asserto come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare il rapporto tra l'istanza BroadWorks e Webex.
-
È possibile creare organizzazioni dei clienti in Control Hub e pres effettuare il provisioning degli utenti in tali organizzazioni.
-
Ciascun abbonato in BroadWorks ottiene un'identità Webex in base al relativo indirizzo e-mail (attributo ID e-mail in BroadWorks).
-
Gli utenti eseguono l'autenticazione per BroadWorks o per Webex.
-
I client vengono emessi con token a lungo termine per autorizzarli per i servizi presso BroadWorks e Webex.
L'app Webex al centro di questa soluzione; è un'applicazione che può essere brandable disponibile su desktop Mac/Windows e su dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include le funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzioni di messaggistica, presenza e riunione.
Il client si registra ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i sistemi BroadWorks per garantire un'esperienza di provisioning utente ottimale.
Funzioni e limitazioni
Sono disponibili diversi pacchetti con diverse funzioni.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano un utente tramite softphone, i risultati della ricerca non forniscono alcuna opzione per l'invio di un messaggio.
Gli utenti softphone possono condividere lo schermo durante una chiamata.
Pacchetto "Base"
The basic package includes Calling, Messaging, and Meeting features. It includes 100 participants in “unified space” meetings and Personal Meeting Room (PMR) meetings. (** see the below Note for exception). In this package the meetings can have a maximum duration of 40 minutes.
Pacchetto "standard"
This package also includes everything in the Basic package such as up to 100 participants in “unified space” meetings and Personal Meeting Room (PMR) meetings.
La condivisione dello schermo all'interno di una riunione PMR ha inizialmente un ruolo svolto solo dall'organizzatore della riunione, ma l'organizzatore può passare il 'ruolo di relatore' a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può assumere nuovamente il ruolo di relatore senza che venga passato dall'ospite corrente.
Pacchetto "Premium"
This package includes everything in the Standard package plus up to 300 participants in “unified space” meeting and up to 1000 participants in a Personal Meeting Room (PMR).
La condivisione dello schermo all'PMR di un evento è supportata per qualsiasi partecipante.
Confronta pacchetti
Pacchetto |
Chiamata |
Messaggistica |
Unified Space Meetings |
PMR riunioni |
---|---|---|---|---|
Softphone |
Incluso |
Non incluso |
Nessuno |
Nessuno |
Base |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Standard |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Premium |
Incluso |
Incluso |
300 partecipanti |
1000 partecipanti |
"Unified Space Meetings" refers to a Webex meeting (scheduled or unscheduled) that takes place in a Webex space. For example, a user initiates a meeting from the space via the "Meet" or "Schedule" buttons.
"PMR Meetings" refers to a Webex Meeting (scheduled or unscheduled) that takes place in a user's Personal Meeting Room (PMR). These meetings use a dedicated URL (for example: cisco.webex.com/meet/roomOwnerUserID).
Funzioni di messaggistica e riunione
Refer to the following table for PMR meeting feature support differences for Basic, Standard and Premium packages.
Funzione riunione |
Supported with Basic Package |
Soportato con il pacchetto standard |
Supportato con pacchetto Preminum |
Commento |
---|---|---|---|---|
Durata riunione |
40 Minutes or less |
Illimitato |
Illimitato | |
Condivisione desktop |
Sì |
Sì |
Sì |
Basic—Desktop sharing by any PMR meeting participant. Standard —Desktop sharing by PMR meeting host only. Premium—Desktop sharing by any PMR meeting participant. |
Condivisione di un'applicazione |
Sì |
Sì |
Sì |
Basic—Application sharing by any PMR meeting participant. Standard —Application sharing by PMR meeting host only. Premium—Application sharing by any PMR meeting participant. |
Chat tra più parti |
Sì |
Sì |
Sì | |
Lavagna |
Sì |
Sì |
Sì | |
Protezione password |
Sì |
Sì |
Sì | |
App Web - nessun download o plug-in (esperienza ospite) |
Sì |
Sì |
Sì | |
Supporta accoppiamento con dispositivi Webex |
Sì |
Sì |
Sì | |
Controllo piano (disattiva audio di uno / Espelle tutti) |
Sì |
Sì |
Sì | |
Collegamento Riunioni permanenti |
Sì |
Sì |
Sì | |
Acces. sito per riunioni |
Sì |
Sì |
Sì | |
Accesso alla riunione tramite VoIP |
Sì |
Sì |
Sì | |
Blocco |
Sì |
Sì |
Sì | |
Controlli relatore |
No |
No |
Sì | |
Controllo desktop remoto |
No |
No |
Sì | |
Numero di partecipanti |
100 |
100 |
1000 | |
Registrazione salvata in locale nel sistema |
Sì |
Sì |
Sì | |
Registrazione nel cloud |
No |
No |
Sì | |
Registrazione - Storage su cloud |
No |
No |
10GB per site | |
Trascrizione delle registrazioni |
No |
No |
Sì | |
Pianificazione riunione |
Sì |
Sì |
Sì | |
Abilita condivisione del contenuto con integrazioni esterne |
No |
No |
Sì |
Basic— Content sharing by any PMR meeting participant. Standard—Content sharing by PMR meeting host only. Premium—Content sharing by any PMR meeting participant. |
Consenti PMR modifica dell'URL |
No |
No |
Sì |
Basic— Users can modify the PMR URL from the Webex site. Partner and org admins can modify the URL from Control Hub. Standard—The PMR URL can be changed only from Partner Hub by Partner and org admins. Premium—Users can modify the PMR URL from the Webex site. Gli amministratori di partner e organizzazioni possono modificare l'URL da Partner Hub. |
Riunioni in streaming in diretta (ad esempio, su Facebook, Youtube) |
No |
No |
Sì | |
Consentire ad altri utenti di pianificare le riunioni per proprio conto |
No |
No |
Sì | |
Aggiungi organizzatore alternativo |
Sì |
No |
Sì | |
Integrazione delle app (es. Zendesk, Slack) |
Dipende dall'integrazione |
Dipende dall'integrazione |
Sì |
Vedere la sezione Integrazioni delle app di seguito per ulteriori informazioni sul supporto. |
Integrazione con il calendario Microsoft Office 365 |
Sì |
Sì |
Sì | |
Integrazione con Google Calendaring per G Suite |
Sì |
Sì |
Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione per l'utente per Webex all'help.webex.com
. Leggere i seguenti articoli per ulteriori informazioni sulle funzioni:
Funzioni di chiamata
L'esperienza di chiamata è simile a quelle precedenti che utilizzano il motore di controllo chiamate BroadWorks. La differenza rispetto a UC-One Collaborate e UC-One SaaS è che l'app Webex è il soft client principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
-
Zendesk—Premium only
-
Slack—Premium only
-
Microsoft Teams for Webex Meetings—Standard or Premium
-
Microsoft Teams for Calling—Supported with all packages
-
Office 365 Calendaring—Standard or Premium
-
Google Calendaring for G Suite—Standard or Premium
Supporto infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta ambienti con infrastruttura desktop virtuale (VDI). For details on how to deploy VDI infrastructure, refer to Deployment Guide for Webex for Virtual Desktop Infrastructure (VDI).
IPv6 Support
Webex for Cisco BroadWorks supports IPv6 addressing for the Webex App.
Pro Pack per Control Hub
Il servizio aggiuntivo Pro Pack per Control Hub fornisce agli amministratori, alle informazioni di sicurezza e ai funzionari di conformità funzionalità avanzate in sicurezza, conformità e analisi in grado di integrare il software.
These add-on services will be only available for Standard and Premium packages.
For more information, see the Help Page of Pro Pack for Control Hub.
Roadmap futuro
Per informazioni sulle nostre intenzione per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Gli elementi della roadmap non sono associabili ad alcuna capacità. Cisco si riserva il diritto di disattivare o revisionare uno o tutti di questi elementi nelle release future.
Limiti
Limitazioni provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario per il Webex Meetings sito creato per tale pacchetto.
Se non viene specificato alcun fuso orario nella richiesta di provisioning per il primo utente di ciascun pacchetto, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sul valore predefinito regionale dell'organizzazione degli abbonati.
Se il cliente richiede un fuso orario Webex Meetings sito specifico, specificare il parametro di fuso orario nella richiesta di provisioning
per:
-
il primo abbonato predisposto per il pacchetto standard nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
-
the first subscriber provisioned for Basic package in the organization.
Limitazioni generali
-
Nessuna chiamata nella versione Web del client Webex (si tratta di una limitazione del client, non di una limitazione di soluzione).
-
Webex potrebbe non disporre ancora di tutti i controlli UI per supportare alcune funzioni di controllo chiamate disponibili da BroadWorks.
-
Il client Webex non può essere attualmente con etichetta "White labeled".
-
Quando si creano organizzazioni cliente utilizzando il metodo di provisioning scelto, tali organizzazioni vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. È previsto che partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
-
La generazione di report sulle riunioni e sull'utilizzo dei messaggi è disponibile attraverso l'organizzazione cliente in Control Hub.
Problemi noti e limitazioni
For an up to date list of known issues and limitations with the Webex for Cisco BroadWorks offer, see Known Issues and Limitations.
Limiti messaggistica
I seguenti limiti di storage dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo spazio di storage massimo per la messaggistica e i file combinati.
-
Base: 2 GB per utente per 3 anni
-
5 GB standard per utente per 3 anni
-
Premium: 10 GB per utente per 5 anni
Per ciascuna organizzazione di clienti, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti Premium può utilizzare un limite di messaggistica e storage file totale di 50 GB. Un singolo utente può superare il limite per utente (10 GB) a condizione che la società sia ancora sotto il valore massimo aggregato (50 GB).
Per gli spazi del team creati, i limiti di messaggistica si applicano al totale aggregato per l'organizzazione del cliente che possiede lo spazio del team. È possibile trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti di messaggistica generali che si applicano agli spazi del team di messaggistica Webex, vedere https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure connessioni a Webex e BroadWorks. I dati archiviati nel cloud Webex e esposti all'utente attraverso l'interfaccia dell'app Webex vengono crittografati sia in viaggio che a riposo.
Ulteriori dettagli sullo scambio dei dati sono disponibili nella sezione Riferimento di questo documento.
Lettura aggiuntiva
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati più vicino alla regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore provider di servizi (utente): Per le attività di manutenzione giornaliere, è possibile gestire le parti in locale (di chiamata) della soluzione utilizzando i propri sistemi. Le parti Webex della soluzione vengono gestite attraverso Partner Hub.
For information on the roles that are available to partners, the access privileges that accompany those roles, and how to assign roles, see Partner Administrator Roles for Webex for BroadWorks and Wholesale RTM.
Team operativo Cisco Cloud: Crea l'organizzazione partner in Partner Hub, se non esiste, durante il processo di onboarding.
Una volta che si dispone dell'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. You next create “Onboarding templates” to represent the suites or packages served through those systems. Si eservi quindi il provisioning dei propri clienti o abbonati.
# |
Attività tipica |
SP |
Cisco |
---|---|---|---|
1 |
Onboarding del partner: creazione dell'organizzazione partner, se presente, e abilitazione delle attivazioni/disattivazioni delle funzioni necessarie |
● | |
2 |
Configurazione BroadWorks nell'organizzazione partner tramite Hub partner (cluster) |
● | |
3 |
Configurazione delle impostazioni di integrazione nell'organizzazione partner tramite Partner Hub (modelli di offerta, branding) |
● | |
4 |
Preparing BroadWorks environment for Integration (AS, XSP|ADP Patching, firewalls, XSP|ADP configuration, XSI, AuthService, CTI, NPS, DMS applications on XSP|ADP) |
● | |
5 |
Sviluppo di un'integrazione o di un processo di provisioning |
● | |
6 |
Prepara materiali GTM |
● | |
7 |
Esegui migrazione o provisioning di nuovi utenti |
● |
Architettura
Che cos'è nel diagramma?
Client
-
Il client Webex App svolge la funzione di applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di riunioni audio/video native di messaggistica, presenza e multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per chiamate SIP PSTN chiamate.
-
I telefoni Cisco IP e relativi accessori utilizzano anche l'infrastruttura BroadWorks per SIP e chiamate PSTN telefoniche. Ci vediamo in grado di supportare telefoni di terze parti.
-
Portale di attivazione utente per consentire agli utenti di accedere a Webex utilizzando le credenziali BroadWorks.
-
Partner Hub è un'interfaccia Web per l'amministrazione della propria organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. È anche possibile utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
provider di servizi di rete
Il blocco verde a sinistra del diagramma rappresenta la rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
-
Public-facing XSP|ADP, for Webex for Cisco BroadWorks: (The box represents one or multiple XSP|ADP farms, possibly fronted by load balancers.)
-
Ospita l'interfaccia XSI-Actions &XSI-Events, Device Servizio di gestione (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato di hook degli altri (presenza di telefonia) e cronologia chiamate.
-
Pubblica la directory sui client Webex.
-
-
Public-facing XSP|ADP, running NPS:
-
Server push notifiche chiamate host: A Notification Push Server on an XSP|ADP in your environment. Interfaccia tra il server applicazioni e il nostro proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS &FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
-
-
Server applicazione:
-
Fornisce il controllo e le interfacce delle chiamate ad altri sistemi BroadWorks (in genere)
-
Per il provisioning flowre, l'AS viene utilizzato dall'amministratore del partner per eseguire il provisioning degli utenti in Webex
-
Inserisce profilo utente in BroadWorks
-
-
SISTEMA SISTEMA AVAIO/BSS: Sistema di supporto operativo/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nel diagramma rappresenta il cloud Webex. I microservizi Webex supportano tutte le funzionalità di collaborazione Webex:
-
Cisco Common Identity (CI) è il servizio di identità all'interno di Webex.
-
Webex per Cisco BroadWorks rappresenta l'insieme di microservizi che supportano l'integrazione tra Webex e provider di servizi BroadWorks ospitate:
-
API di provisioning utenti
-
provider di servizi configurazione
-
Accesso utente tramite credenziali BroadWorks
-
-
casella Messaggistica Webex per microservizi correlati alla messaggistica.
-
Webex Meetings che rappresenta i server di elaborazione multimediale e i controller SBC per le riunioni video con più partecipanti (SIP & SRTP)
Servizi Web di terze parti
I seguenti componenti di terze parti vengono rappresentati nel diagramma:
-
APNS (Apple Push Notifications Service) inserisce le notifiche di chiamate e messaggi nelle applicazioni Webex sui dispositivi Apple.
-
FCM (FireBase Cloud Messaging) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
XSP|ADP Architecture Considerations
The Role of Public-Facing XSP|ADP Servers in Webex for Cisco BroadWorks
The public-facing XSP|ADP in your environment provides the following interfaces/services to Webex and clients:
-
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste di BroadWorks J JSON (Token Web JSON) per conto dell'utente
-
Interfaccia CTI protetta da mTLS, a cui Webex esegue l'abbonamento per eventi cronologia chiamate e stato della presenza di telefonia da BroadWorks (stato hook).
-
Interfacce di azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate, le directory di contatto e di elenco delle chiamate e la configurazione del servizio di telefonia dell'utente finale
-
Servizio DM (Device Management) per i client per recuperare i file di configurazione delle chiamate
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. (See Configure your BroadWorks Clusters in Partner Hub in this document.) For each cluster, you can only provide one URL for each interface. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
XSP|ADP Architecture
We require that you use a separate, dedicated XSP|ADP instance or farm to host your NPS (Notification Push Server) application. È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. However, you may not host the other applications required for Webex for Cisco BroadWorks on the same XSP|ADP that hosts the NPS application.
We recommend that you use a dedicated XSP|ADP instance/farm to host the required applications for Webex integration for the following reasons
-
For example, if you’re offering UC-One SaaS, we recommend creating a new XSP|ADP farm for Webex for Cisco BroadWorks. In questo modo i due servizi possono funzionare in modo indipendente durante la migrazione degli abbonati.
-
If you collocate the Webex for Cisco BroadWorks applications on an XSP|ADP farm that is used for other purposes, it's your responsibility to monitor usage, manage the resulting complexity, and plan for the increased scale.
-
The Cisco BroadWorks System Capacity Planner assumes a dedicated XSP|ADP farm and may not be accurate if you use it for collocation calculations.
Unless noted otherwise, the dedicated Webex for Cisco BroadWorks XSP|ADPs must host the following applications:
-
AuthService (TLS con convalida token CI o mTLS)
-
CTI (mTLS)
-
Azioni XSI (TLS)
-
XSI-Events (TLS)
-
DMS (TLS)—Optional. It's not mandatory that you deploy a separate DMS instance or farm specifically for Webex for Cisco BroadWorks. You can use the same DMS instance that you use for UC-One SaaS or UC-One Collaborate.
-
Call Settings Webview (TLS)—Optional. Call Settings Webview (CSW) is required only if you want Webex for Cisco BroadWorks users to be able to configure calling features on the Webex App.
Webex richiede l'accesso al CTI attraverso un'interfaccia protetta (autenticazione) TLS reciproca autenticazione. Per supportare questo requisito, si consiglia una di queste opzioni:
-
(Diagram labelled Option 1) One XSP|ADP instance or farm for all applications, with two interfaces configured on each server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
-
(Diagram labelled Option 2) Two XSP|ADP instances or farms, one with an mTLS interface for CTI, and the other with a TLS interface for other apps, such as the AuthService.
XSP|ADP Reuse
If you have an existing XSP|ADP farm that conforms to one of the suggested architectures above (Option 1 or 2) and it is lightly loaded, then it is possible to reuse your existing XSP|ADPs. You will need to verify that there are no conflicting configuration requirements between existing applications and the new application requirements for Webex. Le due considerazioni principali sono:
-
If you need to support multiple webex partner organizations on the XSP|ADP, then that means you must use mTLS on the Auth Service (CI Token Validation is only supported for a single partner organization on an XSP|ADP). Se si utilizza mTLS sul servizio di autenticazione, ciò significa che non è possibile avere client che stanno utilizzando l'autenticazione di base sul servizio di autenticazione allo stesso tempo. This situation would prevent reuse of the XSP|ADP.
-
If the existing CTI Service configured to be used by clients with the secure port (typically 8012) but without mTLS (i.e., client authentication) then that will conflict with the webex requirement to have mTLS.
Because the XSP|ADP’s have many applications and the number of permutations of these applications is large, there may be other unidentified conflicts. For this reason, any potential reuse of XSP|ADP’s should be verified in a lab with the intended configuration prior to committing to the reuse.
Configure NTP Synchronization on XSP|ADP
The deployment requires time synchronization for all XSP|ADPs that you use with Webex.
Installare il pacchetto ntp
dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Then you can configure NTP during the XSP|ADP software installation. Per ulteriori informazioni, vedere la Guida alla gestione software BroadWorks.
During the interactive installation of the XSP|ADP software, you’re given the option to configure NTP. Procedere come segue:
-
Quando viene visualizzato il programma di installazione,
configurare NTP?
, inserire y.
-
Quando il programma di installazione richiede,
questo server deve essere un server NTP? , inserire n
.
-
Quando il programma di installazione richiede, Qual è l'indirizzo NTP, il nome host o nome di dominio completo? , inserire l'indirizzo del server NTP o un servizio
NTP pubblico, ad esempio,
pool.ntp.org
.
If your XSP|ADPs use silent (noninteractive) installation, the installer configuration file must include the following Key=Value pairs:
NTP
NTP_SERVER=<NTP Server address, e.g., pool.ntp.org>
XSP|ADP Identity and Security Requirements
Sfondo
I protocolli e i tipi di crittografia delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli variano dal più generale (provider SSL) alla più specifica (singola interfaccia). Un'impostazione più specifica sovrascrive sempre un'impostazione più generale. Se non vengono specificate, le impostazioni SSL di livello 'inferiore' vengono ereditano dai livelli superiori.
Se non viene modificata alcuna impostazione dai valori predefiniti, tutti i livelli ereditano le impostazioni predefinite del provider SSL (estensione JSSE Java Secure Sockets).
Elenco requisiti
-
The XSP|ADP must authenticate itself to clients using a CA-signed certificate in which the Common Name or Subject Alternate Name matches the domain portion of the XSI interface.
-
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
-
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
-
Diffie-Hellman Ephemeral (DHE) o Curve ellittiche Diffie-Hellman Ephemeral (ECDHE) key-exchange
-
Crittografia AES (Advanced Encryption Standard) con una dimensione di blocco minima di 128 bit (ad esempio, AES-128 o AES-256)
-
Modalità di crittografia GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
-
Se viene utilizzata la crittografia CBC, solo la famiglia di funzioni hash SHA2 è consentita per la derivazione chiave (SHA256, SHA384, SHA512).
-
-
Ad esempio, i seguenti tipi di crittografia soddisfano i requisiti:
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
The XSP|ADP CLI requires the IANA naming convention for cipher suites, as shown above, not the openSSL convention.
Tipi di crittografia TLS supportati per le interfacce AuthService e XSI
Questo elenco è soggetto a modifica quando i requisiti di sicurezza del cloud cambiano. Seguire i suggerimenti sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento.
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
-
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
-
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_128_GCM_SHA256
-
TLS_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_256_CBC_SHA256
-
TLS_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_WITH_AES_256_CBC_SHA
-
TLS_PSK_WITH_AES_256_CBC_SHA384
-
TLS_PSK_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_WITH_AES_128_CBC_SHA
-
TLS_PSK_WITH_AES_128_CBC_SHA256
-
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il conteggio dei thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi mostrati, come segue (non diminuire, se sono superiori ai valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Multiple XSP|ADPs
Elemento Edge di bilanciamento del carico
If you have a load balancing element on your network edge, it must transparently handle the distribution of traffic between your multiple XSP|ADP servers and the Webex for Cisco BroadWorks cloud and clients. In questo caso, si fornisce l'URL del servizio di bilanciamento del carico a Webex per la configurazione Cisco BroadWorks.
Note su questa architettura:
-
Configurare DNS in modo che i client possano trovare il servizio di bilanciamento del carico quando si connettono all'interfaccia Xsi (vedere Configurazione DNS).
-
Si consiglia di configurare l'elemento Edge in modalità proxy SSL inverso per accertarsi che la crittografia dati point-to-point.
-
Certificates from XSP|ADP01 and XSP|ADP02 should both have the XSP|ADP domain, for example your-XSP|ADP.example.com, in the Subject Alternate Name. They should have their own FQDNs, for example XSP|ADP01.example.com, in the Common Name. È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Internet-Facing XSP|ADP Servers
If you expose the Xsi interfaces directly, use DNS to distribute the traffic to the multiple XSP|ADP servers.
Note su questa architettura:
-
Two records are required to connect to the XSP|ADP servers:
-
For Webex microservices: Round-robin A/AAAA records are required to target the multiple XSP|ADP IP addresses. This is because the Webex microservices can’t do SRV lookups. For examples, see Webex Cloud Services.
-
For Webex App: An SRV record that resolves to A records where each A record resolves to a single XSP|ADP. For examples, see Webex App.
Use prioritized SRV records to target the XSI service for the multiple XSP|ADP addresses. Prioritize your SRV records so that the microservices will always go to the same A record (and subsequent IP address) and will only move to the next A record (and IP address) if the first IP address is down. DO NOT use a round-robin approach for the Webex App.
-
-
Certificates from XSP|ADP01 and XSP|ADP02 should both have the XSP|ADP domain, for example your-XSP|ADP.example.com, in the Subject Alternate Name. They should have their own FQDNs, for example XSP|ADP01.example.com, in the Common Name.
-
È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Sometimes, DNS is configured to resolve the XSP|ADP URL to an HTTP load balancer, and the load balancer is configured to redirect through a reverse proxy to the XSP|ADP servers.
Webex does not follow a redirect when connecting to the URLs you supply, so this configuration does not work.
Ordinazione e provisioning
Ordinazione e provisioning si applicano a questi livelli:
-
Partner/Service Provider provisioning:
Ciascun Webex per Cisco BroadWorks provider di servizi (o rivenditore) presente deve essere configurato come organizzazione partner in Webex e disporre dei diritti necessari. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per la gestione di Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le attività di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/Enterprise.
-
Customer/Enterprise ordering and provisioning:
Ciascuna azienda BroadWorks abilitata per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo viene eseguito automaticamente come parte del provisioning dell'utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks sono predisposti nella stessa organizzazione clienti Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
-
User/Subscriber ordering and provisioning:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning utente:
-
Provisioning Flow con e-mail attendibili
-
Provisioning flow senza messaggi e-mail attendibili
-
Self-provisioning utente
-
Provisioning API
-
Flowthrough Provisioning with Trusted Emails
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile asserre che BroadWorks abbia indirizzi e-mail dell'abbonato validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Provisioning flow senza messaggi e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non si può contare sugli indirizzi e-mail dell'abbonato tenuti da BroadWorks, questa opzione di provisioning crea account Webex, ma non può attivarli fino a quando gli abbonati non forniscono e convalidano gli indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Self-Provisioning utente
Con questa opzione, non esiste provisioning flowworks da BroadWorks a Webex. Dopo aver configurato l'integrazione tra Webex e il sistema BroadWorks, si ottengono uno o più collegamenti specifici per il provisioning degli utenti all'interno di Webex per l'organizzazione partner Cisco BroadWorks.
Si progettare quindi le proprie comunicazioni (o delegare ai clienti) la distribuzione del collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account sono predisposti nell'ambito dell'organizzazione partner, è possibile regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare questa operazione.
Gli utenti devono essere presenti nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento.
provider di servizi provisioning da PARTE delle API
Webex sono esposti una serie di API pubbliche che consentono di creare Webex per il provisioning di utenti/abbonati Cisco BroadWorks nel flusso di lavoro/strumenti di gestione degli utenti esistenti.
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Install AP.as.22.0.1123.ap376508.
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Install AP.as.23.0.1075.ap376509
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Install AP.as.24.0.944.ap375100
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Extension Dialing
Extension Dialing feature support allows Webex for Cisco Broadworks users to dial other users with an extension similar to the primary phone number within the same enterprise. This is especially useful for users who do not have DID numbers.
During provisioning, the extension of the users gets stored in the Webex directory as the user’s extension. For BroadWorks calling, the extension appears on the Webex App in the extension field of all the call initiation method areas and the user’s profile. Webex for Cisco BroadWorks supports extension-only calls between users within the same group and different groups of the same enterprise with the combination of location dialing code and extension. However, calling between two enterprises using only extensions is not supported.
An extension can be provisioned for the Cisco BroadWorks users through the following methods:
-
Cisco BroadWorks users
-
Public API provisioning as ‘extension
-
The extension parameter should be explicitly passed as part of the API call. For enterprises/groups that have Location Dialing Code (LDC) configured, the extension parameter should be the combination of LDC and 'extension number.
-
-
Flowthrough or Self-Activation provisioning
-
Extension and LDC (where applicable) will be automatically retrieved from BroadWorks.
-
-
-
BroadWorks-only Calling users or entities
-
Synced automatically from BroadWorks by Directory Sync using the combination of Location Dialing Code (LDC) and extension number.
-
Record chiamata BroadWorks |
Descrizione |
Provisioning method |
Managing Extension |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
Public API |
Extension needs to be passed as parameter |
Flowthrough |
Extension retrieved from BroadWorks automatically | ||
Utenti che chiamano solo BroadWorks |
Calling users who are not onboarded to Webex |
Sincronizzazione rubriche |
Extension synced by Directory sync |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sincronizzazione rubriche | Extension synced by Directory sync |
Elenchi telefonici BroadWorks |
Enterprise, Group or Personal Phone Lists |
Sincronizzazione rubriche |
Non applicabile |
Prerequisiti
-
Client version required for supporting this feature is 42.11 or later.
-
Patch where extension and location dialing codes are added to XSI and Provisioning Adapter February 2022 for version 23 or above as part of :
-
AP.platform.23.0.1075.ap380045
-
AP.as.23.0.1075.ap380045
-
AP.xsp.23.0.1075.ap380045
-
AP.as.24.0.944.ap380045
-
-
Enable the header X-BroadWorks-Remote-Party-Info on the AS using the below CLI command for this SIP call flow which is required for extension dialing feature support.
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
App Call Options Priority
As part of the Extension Dialing feature support, The app call options priority setting is also provided at the partner level for all the Webex for Cisco Broadworks partners. Using this setting, the partner can control the call priority settings of all its managed customers from Partner Hub. The app call options priority setting for a customer can also be modified at a customer level from Control Hub.
The app call options priority setting contains extension as second option in both Partner Hub and Control Hub when a Webex for Cisco Broadworks user is newly provisioned with extension through any of the above-mentioned provisioning methods.
For all the existing provisioned Orgs, the extension option will be in the hidden state (by default) in the app call options priority setting. This will not show an extension in the audio/video call option of the user in the Webex App.
Following are the options to make the extension call option visible for the existing customers:
-
If a partner wants all its managed customer orgs to be provided with an extension as one of the call options, it is recommended for the Partner Admin to move the Extension from hidden to available in Partner Hub. This will let the managed customer orgs inherit the setting from their partner.
-
If a Partner wants to provide an extension in call options for a specific customer org, it is recommended for the Partner Admin to move the extension from hidden to available in Control Hub.
Group Contacts Support
This feature enhances the Webex for BroadWorks DirSync service by removing the limitation for syncing up to 1500 contacts from the Group phone lists on BroadWorks and allowing partners to sync up to 30K contacts from a single Group phone list and bring it on par with the 30K contacts increase for Enterprise phone list, which was released separately.
There is an overall limit of 200K for all external contacts per Organization, which would apply to the sum of Enterprise and Group phone lists in a single BroadWorks enterprise. For example, a BroadWorks enterprise that has Enterprise phone list with 30K and also 5 Group phone lists each with 30K will be supported (180K total per Org). However, if there are 6 group phone lists each with 30K, this will not be supported (210K total).
This feature is available on request. Please contact your account team to have it enabled.
-
Before enabling the feature, a prerequisite migration is to be run to provision and associate groups for all the existing provisioned users.
-
Cisco team will run an internal API to migrate any existing provisioned users to associate them with the correct group. NOTA: This can take up to one week to process.
-
Once the migration is completed for the partner and the feature is enabled, any newly provisioned users will be 'grouped' appropriately.
After the feature is enabled, the DirSync service starts syncing BroadWorks Group phone list contacts into dedicated per group contact storage in the Webex Contact Service.
During provisioning, the enterprise group of the user needs to be stored in the Webex directory to indicate the group this user belongs to. The association of the user with a BroadWorks group in the Webex Directory allows the Webex app to do contact search in the Contact Service group storage for the specific group of the user.
The feature requires the Webex for BroadWorks subscribers to be provisioned in Webex with the BroadWorks enterprise Group Id.
The BroadWorks enterprise Group Id can be provisioned for the Cisco BroadWorks users through the following methods:
-
Webex per utenti Cisco BroadWorks
-
Public API provisioning as ‘spEnterpriseGroupId’
-
The BroadWorks enterprise Group Id should be explicitly passed in spEnterpriseGroupId parameter of the API call.
-
-
Flowthrough or Self-Activation provisioning
-
BroadWorks enterprise Group Id will be automatically retrieved from BroadWorks.
-
-
BroadWorks-only Calling users or entities
-
Not applicable. It’s not required to sync BroadWorks enterprise Group Id for these users.
-
-
Record chiamata BroadWorks |
Descrizione |
Provisioning method |
Managing Enterprise Group ID |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
Public API |
BroadWorks enterprise Group Id needs to be passed as parameter spEnterpriseGroupId |
Flowthrough |
BroadWorks enterprise Group Id is retrieved from BroadWorks automatically | ||
Utenti che chiamano solo BroadWorks |
Calling users who are not onboarded to Webex |
Sincronizzazione rubriche |
Non applicabile |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sincronizzazione rubriche |
Non applicabile |
Elenchi telefonici BroadWorks |
Contacts in the BroadWorks Group Phone Lists |
Sincronizzazione rubriche |
Group contacts are stored in Webex Contact Service associated with the specific group |
BroadWorks Enterpsie or Persional phone lists |
Contacts in the Enterprise or Personal Phone Lists |
Sincronizzazione rubriche |
Non applicabile |
Public API must be updated PRIOR to the MIGRATION. Migration cannot be completed until THIS API is completed The BroadWorks enterprise Group Id should be explicitly passed in spEnterpriseGroupId parameter of the API call https://developer.webex.com/docs/api/changelog#2023-march
After the feature is enabled and as a result of the next directory sync the enterprise user groups will also be displayed in Control Hub. Visualizing the groups in Control Hub for Webex for BroadWorks is purely informational at this stage. Partner and customer admins should not make any modifications to groups or group membership in Control Hub as these changes will not be reflected back to BroadWorks. Group Management in Control Hub is intended for use by partners who will be adopting the upcoming Contact Management APIs.
Migrazione e prova futura
Cisco il client BroadSoft unified Communications deve passare da UC-One a Webex. Esiste una corrispondente lingua dei servizi di supporto lontani dalla rete provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Whether you’re running UC-One SaaS, or BroadWorks Collaborate, the preferred migration strategy is to deploy new, dedicated XSP|ADPs for integration with Webex for Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti a Webex e, infine, recuperare l'infrastruttura utilizzata per la soluzione precedente.
Recommended Document Subscriptions
Webex Help Center articles (on help.webex.com) have a Subscribe option that lets you receive an email notification whenever that article gets updated.
We recommend that you subscribe to each of the following articles to ensure that you don't miss out on critical updates that affect network connectivity. To subscribe, go to each of the below links and in the article that launches, click the Subscribe button.
At a minimum, we recommend that you subscribe to the above list. However, most of the Webex articles and documents listed under Additional Documents have a Subscribe option. For this option to appear, the article must appear on help.webex.com.
Additional Documents
Refer to the following related documentation for more information about Webex for Cisco BroadWorks:
Webex for Cisco BroadWorks Documents
Partner administrators can use the following documents and sites to obtain information on Webex for Cisco BroadWorks.
-
Bring Your Own PSTN Solution for Webex for Cisco BroadWorks—This solution lets Service Providers provision phone numbers that they own (rather than Cisco-provided numbers) for users to use when joining Webex Meetings.
-
Webex for Cisco BroadWorks Configuration Guide—Describes how to configure the Webex App for Webex for Cisco BroadWorks.
- Device Integration Guide for Webex for Cisco BroadWorks—Describes how to onboard and service Room OS and MPP devices.
-
Webex for Cisco BroadWorks Troubleshooting Guide—Contains troubleshooting information for Webex for Cisco BroadWorks.
Webex for Cisco BroadWorks Articles
Partner administrators can use the following optional sites to learn more about Webex for Cisco BroadWorks:
-
Webex for Cisco BroadWorks Documentation—The landing page lists technical documents and optional Webex articles targeted to partner administrators of Webex for Cisco BroadWorks.
-
What's New with Webex for Cisco BroadWorks—Read about the latest released features along with what's coming soon.
-
Known Issues and Limitations—Read about known issues that we've identified in the Webex for Cisco BroadWorks solution.
-
Partner Administrator Roles for Webex for BroadWorks and Wholesale RTM—This article describes how to assign partner administrator roles for partner organizations that offer Webex for Cisco BroadWorks. Roles get used to assign administration access to settings in Partner Hub and Control Hub.
Cisco BroadWorks Documents
Partner administrators can refer to the Cisco BroadWorks site on cisco.com for technical documents that describe how to deploy the Cisco BroadWorks part of the solution:
Webex Help Articles
The following Webex Help sites can be used to find Webex articles that help customer administrators and end users to use Webex features.
-
Webex from Service Providers—This landing page contains links with getting started info and commonly used articles for Webex App users who purchased Webex services from a Service Provider.
-
Webex Help Center—Use the search feature at help.webex.com to search for additional Webex articles that describe Webex App and Webex Meetings functionality. You can search for either user or administrator articles.
Developer Documentation
-
Webex for BroadWorks Developer Guide—Provides information for developers who create applications that use the Webex for BroadWorks APIs.
Punti decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastruttura
|
How many XSP|ADPs? Come prendono mTLS? |
Pianificatore capacità sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks XSP|ADP CLI Reference Questo documento |
Provisioning clienti e utenti |
Si può asserre che si considera attendibili i messaggi e-mail in BroadWorks? Si desidera che gli utenti forniranno gli indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Doc API pubblici su https://developer.webex.com Questo documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo sul branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso dei clienti? | Questo documento |
Funzioni dell'abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o softphone. |
Questo documento Matrice funzioni/pacchetto |
Autenticazione utente | BroadWorks o Webex | Questo documento |
Adattatore di provisioning (per le opzioni di provisioning flow) |
Utilizzi già IM&P integrato, ad esempio per UC-One SaaS? Utilizzare più modelli? Esiste un caso d'uso più comune previsto? |
Questo documento Riferimento CLI server applicazione |
Architettura e infrastruttura
-
Con quale scala intendete iniziare? È possibile aumentare la scalabilità in futuro, ma la stima d'uso corrente deve guidare la pianificazione dell'infrastruttura.
-
Work with your Cisco account manager / sales representative to size your XSP|ADP infrastructure, according to the Cisco BroadWorks System Capacity Planner and the Cisco BroadWorks System Engineering Guide.
-
How will Webex make Mutual TLS connections to your XSP|ADPs? Directly to the XSP|ADP in a DMZ, or via TLS proxy? This affects your certificate management, and the URLs you use for the interfaces. (We do not support unencrypted TCP connections to the edge of your network).
Provisioning clienti e utenti
Quale metodo di provisioning utente si adatta meglio alle esigenze?
-
Flowthrough Provisioning With Trusted Emails: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene automaticamente predisposto in Webex.
Se è anche possibile asserre che gli indirizzi e-mail dell'abbonato nella BroadWorks siano validi e univoci per Webex, è possibile utilizzare la varianti "e-mail attendibile" del provisioning flow provisioning. Gli account Webex del sottoscrittore vengono creati e attivati senza il loro intervento; semplicemente scaricare il client ed eseguire l'accesso.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto l provider di servizi deve specificare un indirizzo e-mail valido per l'utente per potervi fornire i servizi Webex. Deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo nell'attributo ID alternativo.
-
Flowthrough Provisioning Without Trusted Emails: Se non si riesce a verificare l'attendibilità degli indirizzi e-mail dell'abbonato, è comunque possibile assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
-
User Self-Provisioning: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. L'utente (o i clienti) distribuiscono invece un collegamento di provisioning e i collegamenti per scaricare diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex. Quindi scaricano il client e a quel punto Webex recuperano alcune configurazioni aggiuntive su di esse da BroadWorks (inclusi i numeri principali).
-
SP Controlled Provisioning via APIs: Webex sono esposti una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei flussi di lavoro esistenti.
Provisioning Requirements
The following table summarizes the requirements for each provisioning method. In addition to these requirements, your deployment must meet the general system requirements that are described in this guide.
Provisioning Method |
Requisiti |
---|---|
Provisioning Flow (Trusted or Untrusted emails) |
The Webex provisioning API adds existing BroadWorks users to Webex automatically once the user meets requirements and you toggle the Integrated IM+P service to on. There are two flows (trusted emails or untrusted emails) which you assign via the Onboarding template on Webex. BroadWorks requirements:
Webex requirements: The Onboarding template includes the following settings:
|
Self-Provisioning utente |
Admin provides an existing BroadWorks user with a link to the User Activation Portal. The user must log in to the portal using BroadWorks credentials and provide a valid email address. After the email is validated, Webex fetches additional user information to complete provisioning. BroadWorks requirements:
Webex requirements: The Onboarding template includes the following settings:
|
SP controlled provisioning via API (Trusted or Untrusted emails) |
Webex exposes a set of public APIs that enable you to build user provisioning into your existing workflows and tools. There are two flows:
BroadWorks Requirements:
Webex Requirements:
To use the APIs, go to BroadWorks Subscribers. |
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Install AP.as.22.0.1123.ap376508.
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Install AP.as.23.0.1075.ap376509
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Install AP.as.24.0.944.ap375100
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Supported Language Locales
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente amministrativo predisposto viene assegnata automaticamente come impostazioni internazionali predefinite per tale organizzazione cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti alle riunioni in tale organizzazione del cliente.
Five character language locales in (ISO-639-1)_(ISO-3166) format are supported. For example, en_US corresponds to English_UnitedStates. If only a two letter language is requested (using ISO-639-1 format), the service will generate a five character language locale by combining the requested language with a country code from the template i.e. "requestedLanguage_CountryCode", if unable to get a valid locale, then the default sensible locale used based on the required language code.
The following table lists the supported locales, and the mapping that converts a two-letter language code to a five-character locale for situations where a five-character locale is not available.
Supported Language Locales (ISO-639-1)_(ISO-3166) |
If only a two-letter language code is available... | |
---|---|---|
Language code (ISO-639-1) ** |
Use Default Sensible Locale instead (ISO-639-1)_(ISO-3166) | |
en_US en_AU en_GB en_Ca |
en |
en_US |
fr_Fr fr_Ca |
Fr |
fr_Fr |
cs_CZ |
cs |
cs_CZ |
da_Dk |
da |
da_Dk |
de_DE |
DE |
de_DE |
hu_Hu |
hu |
hu_Hu |
id_ID |
Identificativo |
id_ID |
it_IT |
IT |
it_IT |
ja_JP |
ja |
ja_JP |
ko_Kr |
ko |
ko_Kr |
es_ES es_CO es_MX |
ES |
es_ES |
nl_NL |
NL |
nl_NL |
nb_NO |
nb |
nb_NO |
pl_PL |
pl |
pl_PL |
pt_PT pt_Br |
pt |
pt_PT |
ru_RU |
RU |
ru_RU |
ro_RO |
ro |
ro_RO |
zh_Cn zh_TW |
zh |
zh_Cn |
sv_SE |
sv |
sv_SE |
ar_Sa |
ar |
ar_Sa |
tr_Tr |
tr |
tr_Tr |
The locales es_CO, id_ID, nb_NO and pt_PT are not supported by Webex Meeting Sites. For these locales, The Webex Meetings sites will be in English only. English is the default locale for sites if no/invalid/unsupported locale is required for the site. This language field is applicable while creating an Organization and Webex Meetings site. If no language is mentioned in a post or in the subscriber's API then language from the template will be used as a default language.
Branding
Gli amministratori dei partner possono utilizzare personalizzazioni di branding avanzate per personalizzare il modo in cui l'app Webex cerca le organizzazioni dei clienti gestite dal partner. Gli amministratori dei partner possono personalizzare le seguenti impostazioni per assicurarsi che l'app Webex rifletta il marchio e l'identità della propria società:
-
Loghi aziendali
-
Schemi di colore univoci per la modalità chiaro o la modalità scura
-
URL di supporto personalizzati
For details on how to customize branding, refer to Configure Advanced Branding Customizations.
-
Basic Branding customizations are in the process of being deprecated. We recommend that you deploy Advanced Branding, which offers a wider range of customizations.
-
For details on how branding is applied when attaching to a pre-existing Customer Organization, refer to Conditions of Org Attachment under the Attach Webex for BroadWorks to Existing Organization section.
Onboarding templates
Onboarding templates allow you to define the parameters by which customers and associated subscribers are automatically provisioned on Webex for Cisco BroadWorks. You may configure multiple Onboarding templates as required, but when you onboard a customer it is associated with only one template (you cannot apply multiple templates to one customer).
Di seguito sono elencati alcuni parametri del modello principale.
Pacchetto
-
È necessario selezionare un pacchetto predefinito quando si crea un modello (per informazioni dettagliate, vedere Pacchetti nella sezione Panoramica). Tutti gli utenti predisposti con tale modello, mediante flusso o auto-provisioning, ricevono il pacchetto predefinito.
-
È possibile controllare la selezione del pacchetto per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori per provisioning aziendali, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
-
You can change the package of specific subscribers from this default, using the provisioning API (see Webex for Cisco BroadWorks API documentation or through Partner Hub (see Change User Package in Partner Hub).
-
Non è possibile modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è disattivata; se l'abbonato è assegnato a questo servizio in BroadWorks, il modello Hub partner associato all'URL di provisioning di tale azienda definisce il pacchetto.
Rivenditori e aziende o provider di servizi e gruppi?
-
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se si è un rivenditore con Aziende, è necessario abilitare la modalità Enterprise quando si crea un modello.
-
Se il sistema BroadWorks è configurato in provider di servizi modalità aziendale, è possibile lasciare disattivata la modalità Enterprise nei modelli.
-
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Modalità di autenticazione
Decide how you want subscribers to authenticate when they log in to Webex. You can assign the mode using the Authentication Mode setting in the Onboarding template. The following table outlines some of the options.
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | File BroadWorks ID utente | Indirizzo e-mail |
provider di identità |
BroadWorks.
| Cisco Common Identity |
Autenticazione multi-fattori? | No | Richiede un IdP cliente che supporti l'autenticazione a più fattori. |
Percorso di convalida credenziali
|
|
|
UTF-8 Encoding with BroadWorks Authentication
With BroadWorks authentication, we recommend that you configure UTF-8 encoding for the authentication header. UTF-8 resolves an issue that can occur with passwords that use special characters whereby the web browser does not encode the characters properly. Using a UTF-8 encoded, base 64-encoded header resolves this issue.
You can configure UTF-8 encoding by running one of the following CLI commands on the XSP or ADP:
-
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
-
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
Paese
You must select a country when you create a template. This country will be automatically assigned as the organisation country for all the customers that are provisioned with the template in Common Identity. Additionally, the organization country will determine the default global call-in numbers for Cisco PSTN in Webex Meeting Sites.
The site's default global call-in numbers will be set to the first available dial-in number defined in the telephony domain based on the organization's country. If the organization's country is not found in the dial-in number defined in the telephony domain, the default number of that location will be used.
S No. |
Sede |
Prefisso internazionale |
Nome paese |
---|---|---|---|
1 |
AMER |
+1 |
US, CA |
2 |
APAC |
+65 |
Singapore |
3 |
Anz |
+61 |
Australia |
4 |
EMEA |
+44 |
REGNO UNITO |
5 |
EURO |
+49 |
Germania |
Accordi con più partner
Si desidera utilizzare la licenza secondaria di Webex per Cisco BroadWorks con un altro provider di servizi? In tal caso, ciascun fornitore di servizi avrà bisogno di un'organizzazione partner distinta Webex Control Hub permettere loro di fornire la soluzione per la propria base clienti.
Adattatore e modelli di provisioning
Quando si utilizza il provisioning flowre, l'URL di provisioning inserito in BroadWorks è derivato dal modello in Control Hub. È possibile disporre di più modelli e, quindi, di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati quando hanno ottenuto la concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e il modello che si desidera utilizzare. In questo modo, è necessario solo impostare in modo esplicito l'URL di provisioning per le aziende che necessitano di un modello diverso.
Tenere presente, inoltre, che potrebbe essere stato già utilizzato un URL di provisioning a livello di sistema, ad esempio UC-One SaaS. If that is the case, you may opt to preserve the system level URL for provisioning users on UC-One SaaS, and override for those enterprises moving to Webex for Cisco BroadWorks. In alternativa, è possibile passare al percorso alternativo e impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
The configuration choices related to this decision are detailed in Configure Application Server with Provisioning Service URL.
Provisioning Adapter Proxy
For added security, the Provisioning Adapter Proxy lets you use an HTTP(S) proxy on the Application Delivery Platform for flowthrough provisioning between the AS and Webex. The proxy connection creates an end-to-end TCP tunnel that relays traffic between the AS and Webex, thereby negating the need for the AS to connect to the public internet directly. For secure connections, TLS can be used.
This feature requires that you set up the proxy on BroadWorks. For details, see Cisco BroadWorks Provisioning Adapter Proxy Feature Description.
Requisiti minimi
Account
Tutti gli abbonati disponibili per Webex devono esistere nel sistema BroadWorks integrato con Webex. Se necessario, è possibile integrare più sistemi BroadWorks.
All subscribers must have BroadWorks licenses and a primary number or extension.
Webex utilizza gli indirizzi e-mail come identificativi principali per tutti gli utenti. Se si utilizza il provisioning flow con messaggi e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail dell'abbonato nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le relative password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Server nella rete e requisiti software
-
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. For more information, see BroadSoft products lifecycle policy section in BroadSoft Lifecycle Policy and BroadWorks Software Compatibility Matrix.
-
Le istanze BroadWorks devono includere almeno i seguenti server:
-
Server applicazioni (AS) con versione BroadWorks come indicato sopra
-
Server di rete (NS)
-
Server di profilo (PS)
-
-
Public-facing XSP|ADP Server(s) or Application Delivery Platform (ADP) meeting the following requirements:
-
Servizio di autenticazione (BWAuth)
-
Interfacce azioni ed eventi XSI
-
DMS (applicazione Web di gestione dispositivi)
-
Interfaccia CTI (integrazione di telefonia su computer)
-
TLS 1.2 con un certificato valido (non autofirmato) ed eventuali intermedie richiesti. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
-
Autenticazione TLS reciproca (mTLS) per il servizio di autenticazione (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
Autenticazione TLS reciproca (mTLS) per interfaccia CTI (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
-
Un server XSP/ADP separato funge da "server push notifiche di chiamata" (un server NPS nel proprio ambiente utilizzato per eseguire il push delle notifiche di chiamata ad Apple/Google. Questo tipo di chiamata "CNPS" viene chiamata qui per distinguerlo dal servizio in Webex che offre notifiche push per messaggistica e presenza).
Questo server deve essere su R22 o versioni successive.
-
È obbligatorio creare un server XSP/ADP separato per CNPS poiché l'impossibilità di caricare da Webex per connessioni cloud BWKS potrebbe avere un impatto negativo sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. See the Cisco BroadWorks System Engineering Guide for more on XSP|ADP scale.
Piattaforme app Webex
To download the English version of the Webex App, go to https://www.webex.com/webexfromserviceproviders-downloads.html. The Webex App is available on:
-
PC/laptop Windows
-
PC Apple / laptop con MacOS
-
iOS (Apple store)
-
Android (Play store)
-
Web browsers (go to https://teams.webex.com/)
Localized Versions
To download a localized version of the Webex App, use one of these links:
-
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (Korean)
-
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (French)
-
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (Portuguese)
-
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (Chinese Traditional)
-
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (Chinese Simplified)
-
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Japan)
-
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spain)
-
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (German)
-
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (Italian)
Telefoni e accessori fisici
-
Telefoni IP Cisco:
-
Cisco IP Phone serie 6800 con firmware Multitform
-
Cisco IP Phone serie 7800 con firmware Multitform
-
Cisco IP Phone serie 8800 con firmware Multitform
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html modelli e ulteriori informazioni, vedere .
-
-
I telefoni di terze parti sono supportati allo stesso modo delle altre integrazioni BroadWorks. Tuttavia, non dispongono ancora di contatti e integrazione di presenza con Webex per Cisco BroadWorks.
-
Adapters:
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 191
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 192 Multiplatform
Per https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html modelli e ulteriori informazioni, vedere .
-
-
Headsets:
-
Cisco Headset serie 500
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html modelli e ulteriori informazioni, vedere .
-
-
Room OS Devices:
-
Webex Room and Room Kit Series
-
Serie Webex Desk
-
Serie Webex Board
-
Device Integration
For details on how to onboard and service Room OS and MPP devices for Webex for Cisco BroadWorks, see Device Integration Guide for Webex for Cisco BroadWorks.
Profili dispositivi
Following are the DTAF files you need to load onto your Application Servers to support the Webex App as a calling client. They are the same DTAF files as used for UC-One SaaS, however there is a new config-wxt.xml.template
file that is used for the Webex App.
To download the latest device profiles, go to the Application Delivery Platform Software Downloads site to get the latest DTAF files. These downloads work for both ADP and XSP.
Nome client |
Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Business Communicator - PC DTAF: File di configurazione: |
Identify/Device Profile
All Webex for Cisco BroadWorks users must have an Identity/Device Profile assigned in BroadWorks that uses one of the above device profiles in order to make calls using the Webex App. The profile provides the configuration that allows the user to place calls.
Obtaining OAuth credentials for your Webex for Cisco BroadWorks
Raise a service request with your onboarding agent or with Cisco TAC to provision Cisco OAuth for your Cisco Identity Provider Federation account.
Use the following request title for respective features:
-
XSP|ADP AuthService Configuration' to configure service on XSP|ADP.
-
'NPS Configuration for Auth Proxy Setup' to configure NPS to use authentication proxy.
-
CI User UUID Sync' for CI user UUID sync. For more details on this feature, see: Cisco BroadWorks support for CI UUID.
-
Configure BroadWorks to enable Cisco Billing for BroadWorks and Webex For BroadWorks Subscriptions.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento validi per 60 giorni. If the token expires before you use it, you can raise another request.
If you already obtained Cisco OAuth Identity Provider credentials, complete a new service request to update your credentials.
Ordina certificati
Requisiti di certificato per l'autenticazione TLS
You will need Security Certificates, signed by a well-known Certificate Authority and deployed on your Public facing XSP|ADPs, for all required applications. These will be used to support TLS certificate verification for all inbound connectivity to your XSP|ADP servers.
These certificates should include your XSP|ADP public fully qualified domain name as Subject Common Name or Subject Alternate Name.
The exact requirements for deploying these server certificates depends on how your public facing XSP|ADPs are deployed:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Directly to the XSP|ADP
Il diagramma seguente riepiloga dove deve essere caricato il certificato del server pubblico firmato da CA in questi tre casi:
Le CA pubblicamente supportate che l'app Webex supporta per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per il proxy con bridge TLS
-
Il certificato del server firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta questo certificato server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
An internal CA signed certificate can be loaded onto the XSP|ADP.
-
The XSP|ADP presents this internally signed server certificate to the proxy.
-
The proxy trusts the internal CA that signed the XSP|ADP server certificate.
TLS Certificate Requirements for TLS-passthrough Proxy or XSP|ADP in DMZ
-
The publicly signed server certificate is loaded into the XSP|ADPs.
-
The XSP|ADPs present publicly signed server certificates to Webex.
-
Webex trusts the public CA that signed the XSP|ADPs’ server certificates.
Ulteriori requisiti di certificato per l'autenticazione TLS reciproca su interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione TLS reciproca. Il certificato CA/catena di certificati del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedere a Partner Hub, andare a Impostazioni >
collegamento di download del certificato.The exact requirements for deploying this Webex CA certificate chain depends on how your public facing XSP|ADPs are deployed:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Directly to the XSP|ADP
Il diagramma seguente riepiloga i requisiti dei certificati in questi tre casi:
(Opzione) Requisiti di certificato per proxy tls-bridge
-
Webex presenta un certificato client firmato pubblicamente al proxy.
-
Il proxy considera attendibile la CA interna Cisco che ha firmato il certificato client. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. The publicly signed XSP|ADP server certificate is also loaded into the proxy.
-
Il proxy presenta il certificato del server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
The proxy presents an internally signed client certificate to the XSP|ADPs.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3: Uso chiave estesa X509v3: 1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Il CN del certificato interno deve essere
bwcticlient.webex.com
.-
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. Internal server certificates for the XSP|ADP can be SAN.
-
Le autorità di certificazione pubbliche potrebbero non voler firmare i certificati con il OID broadworks proprietario richiesto. In the case of a bridging proxy, you may be forced to use an internal CA to sign the client certificate that the proxy presents to the XSP|ADP.
-
-
The XSP|ADPs trust the internal CA.
-
The XSP|ADPs present an internally signed server certificate.
-
Il proxy considera attendibile la CA interna.
-
The Application Server’s ClientIdentity contains the CN of the internally signed client certificate presented to the XSP|ADP by the proxy.
(Option) Certificate Requirements for TLS-passthrough Proxy or XSP|ADP in DMZ
-
Webex presents a Cisco internal CA-signed client certificate to the XSP|ADPs.
-
The XSP|ADPs trust the Cisco internal CA that signed the client certificate. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. The publicly signed XSP|ADP server certificate is also loaded into the XSP|ADPs.
-
The XSP|ADPs present the publicly signed server certificates to Webex.
-
Webex trusts the public CA that signed the XSP|ADPs’ server certificates.
-
The Application Server ClientIdentity contains the CN of the Cisco-signed client certificate presented to the XSP|ADP by Webex.
Preparazione della rete
For more information on connections that are used by Webex for Cisco BroadWorks, see: Network Requirements for Webex for Cisco BroadWorks. This article has the list of IP addresses, ports and protocols required to configure your firewall Ingress and Egress rules.
Requisiti di rete per i servizi Webex
Le tabelle del firewall in entrata ed uscita precedenti documenta solo le connessioni specifiche per Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico a Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e come ciascuna sezione è relativa a Webex per Cisco BroadWorks.
Sezione dell'articolo requisiti di rete |
Gestione delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex |
Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud |
Informativo |
È necessario leggere | |
È necessario leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex |
È necessario leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione |
Opzionale |
Servizi Webex per clienti FedRAMP |
N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedere Whitepaper (PDF) del firewall appWebex.
Supporto ridondanza BroadWorks
The Webex Cloud Services and the Webex Client Apps that need to access the partner’s network fully support the Broadworks XSP|ADP redundancy provided by the partner. When an XSP|ADP or site is unavailable for planned maintenance or unplanned reason, the Webex services & apps are able to advance to another XSP|ADP or site provided by the partner in order to complete a request.
Topologia di rete
The Broadworks XSP|ADPs can be deployed directly on the Internet, or can reside in a DMZ fronted by a load balancing element such as the F5 BIG-IP. To provide geo-redundancy, the XSP|ADPs can be deployed in two (or more) datacenters, each can be fronted by a load balancer, each having a public IP address. If the XSP|ADPs are behind a load balancer, the Webex microservices and App see only the IP address of the load balancer and Broadworks appears to have just one XSP|ADP, even if there are multiple XSP|ADPs behind.
In the example below, the XSP|ADPs are deployed at two sites, Site A and Site B. There are two XSP|ADPs fronted by a Load Balancer at each site. Site A has XSP|ADP1 and XSP|ADP2 fronted by LB1, and Site B has XSP|ADP3 and XSP|ADP4 fronted by LB2. Only the Load Balancers are exposed on the public network, and the XSP|ADPs are in the DMZ private networks.
Servizi Cloud Webex
Configurazione DNS
The Webex Cloud microservices must be able to find the Broadworks XSP|ADP server(s) for connecting to the Xsi interfaces, authentication service and CTI.
Webex Cloud microservices will perform DNS A/AAAA lookup of the configured XSP|ADP hostname and connect to the returned IP Address. This could be a load balancing edge element, or it could be the XSP|ADP server itself. Se vengono restituiti più indirizzi IP, verrà selezionato il primo IP nell'elenco. SRV ricerca non sono attualmente supportate.
Esempio: The partner’s DNS A Record for discovery of Round-Robin balanced internet-facing XSP|ADP server/Load Balancers.
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (Sito A) |
R |
|
|
Punti a LB2 (Sito B) |
Any reference to XSP includes either XSP or ADP.
Failover
When the Webex microservices send a request to the XSP|ADP/Load Balancer and the request fails, several things can happen:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un avanzamento di route al successivo IP.
-
If an error code (HTTP 5xx) is returned, the Webex microservices mark the IP as blocked and immediately perform a route advance to the next IP.
-
Se non si riceve alcuna risposta HTTP entro 2 secondi, si verifica un timeout della richiesta e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento all'IP successivo.
Ogni richiesta viene provata 3 volte prima che un problema venga segnalato al microservizio.
When an IP is in the blocked list, it will not be included in the list of addresses to try when sending a request to a XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna all'elenco per riprovare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco dei contatti bloccati. Se tale indirizzo IP viene rimosso dall'elenco dei contatti bloccati.
Stato
The status of the connectivity of the Webex Cloud services to the XSP|ADPs or Load Balancers can be seen in Control Hub. In un cluster di chiamata BroadWorks, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
-
Azioni XSI
-
Eventi XSI
-
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Lo stato delle connessioni può essere:
-
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
-
Rosso: Quando tutti gli IP nella ricerca dei record A sono irraggiungibili e l'interfaccia non è disponibile.
The following services use the microservices to connect to the XSP|ADPs and are impacted by the XSP|ADP interface availability:
-
Accesso all'app Webex
-
Aggiornamento token app Webex
-
E-mail/attivazione automatica non attendibile
-
Controllo stato servizio Broadworks
Webex App
Configurazione DNS
The Webex App accesses the Xtended Services Interface (XSI-Actions & XSI-Events) and Device Management Service (DMS) services on the XSP|ADP.
To find the XSI service, the Webex App performs DNS SRV lookup for _xsi-client._tcp.<webex app xsi domain>
. The SRV points to the configured URL for the XSP|ADP hosts or load balancers for the XSI service. If SRV lookup is not available, the Webex App falls back to A/AAAA lookup.
The SRV can resolve to multiple A/AAAA targets. However, each A/AAAA record must map to a single IP address only. If there are multiple XSP|ADPs in a DMZ behind the load balancer/edge device, it is required that the load balancer be configured to maintain session persistence to route all requests of the same session to the same XSP|ADP. We mandate this configuration because the client's XSI-event heartbeats must go to the same XSP|ADP that is used to establish the event channel.
In Example 1, the A/AAAA record for webex-app-XSP|ADP.example.com does not exist, and does not need to. If your DNS requires that one A/AAAA record must be defined, then only 1 IP address should be returned. Regardless, the SRV must still be defined for the Webex App.
If the Webex App uses the A/AAAA name that resolves to more than one IP address, or if the load balancer/edge element does not maintain session persistence, the client eventually sends heartbeats to an XSP|ADP where it did not establish an event channel. This results in the channel being torn down, and also in significantly more internal traffic which impairs your XSP|ADP cluster performance.
Because the Webex Cloud and Webex App have different requirements in A/AAAA record lookup, you must use a separate FQDN for the Webex Cloud and Webex App to access your XSP|ADPs. As shown in the examples, Webex Cloud uses A record webex-cloud-xsp.example.com
, and Webex App uses SRV _xsi-client._tcp.webex-app-xsp.example.com
.
Example 1—Multiple XSP|ADPs, each behind separate load balancers
In this example, the SRV points to mutiple A records with each A record pointing to a different load balancer at a different site. The Webex App will always use the first IP address in the list and will only move to the next record if the first is down.
Di seguito è riportato un esempio di SRV record.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Example 2—Multiple XSP|ADPs behind a single load balancer (with TLS Bridge)
For the initial request, the load balancer selects a random XSP|ADP. That XSP|ADP returns a cookie that the Webex App includes in future requests. For future requests, the load balancer uses the cookie to route the connection to the correct XSP|ADP, ensuring that the event channel doesn't break.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Load balancer |
R |
LB.example.com |
|
IP address of load balancer (XSP|ADPs are behind load balancer) |
DMS URL
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il relativo file di configurazione. The host in the URL will parsed and the Webex App will perform DNS A/AAAA lookup of the host to connect to the XSP|ADP that hosts the DMS service.
Esempio: DNS A Record for discovery of Round-Robin balanced internet-facing XSP|ADP server/Load Balancers by Webex App to download config files through DMS:
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
How Webex App Finds XSP|ADP Addresses
The client attempts to locate the XSP|ADP nodes using the following DNS flow:
-
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (inserito durante la creazione del cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue SRV ricerca nel modo seguente:
-
Client performs an SRV lookup for _xsi-client._tcp.<xsi domain>
-
If the SRV lookup returns one or more A/AAAA targets:
-
Il client esegue una ricerca A/AAAA di tali destinazioni e memorizza nella cache gli indirizzi IP restituiti.
-
Il client si connette a uno dei destinazioni (e pertanto, il relativo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi avere lo stesso peso (o a caso se tutti sono uguali).
-
-
Se la ricerca SRV ricerca non restituisce eventuali obiettivi:
Il client esegue una ricerca A/AAAA del parametro radice Xsi, quindi tenta di connettersi all'indirizzo IP restituito. This could be a load balancing edge element, or it could be the XSP|ADP server itself.
Come specificato, il record A/AAAA deve risolversi in un indirizzo IP per gli stessi motivi.
-
-
(Opzionale) In un secondo tempo, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocols> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
-
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
-
Se esistono, il client verrà confrontato con l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
-
Se vengono rilevate eventuali differenze, il client inizializza nuovamente la connettività XSI Actions/ XSI Events. The first step in this is to perform the same DNS lookup process listed under step 1 – this time requesting a lookup for the value in the %XSI_ROOT_WXT% parameter from its configuration file.
Creare i record delle SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
-
Failover
During login, the Webex App performs a DNS SRV lookup for _xsi-client._tcp.<xsi domain>, builds a list of hosts, and connects to one of the hosts based on the SRV priority, then weight. Questo ospite connesso diventa il selezionato per tutte le richieste future. Un canale di evento viene quindi aperto all'organizzatore selezionato e un heartbeat viene inviato regolarmente per verificare il canale. All requests sent after the first one include a cookie that is returned in the HTTP response, therefore, it’s important that the load balancer keeps session persistence (affinity) and always sends requests to the same backend XSP|ADP server.
In caso di errore di una richiesta o di una richiesta heartbeat a un host, si possono verificare diverse operazioni:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), l'instradazione dell'app Webex avanza immediatamente al successivo organizzatore nell'elenco.
-
If an error code (HTTP 5xx) is returned, the Webex App marks that IP address as blocked and route advances to the next host on the list.
-
Se non si riceve una risposta entro un determinato periodo di tempo, la richiesta viene considerata non riuscita a causa di un timeout e le successive richieste vengono inviate all'organizzatore successivo. Tuttavia, la richiesta di timeout viene considerata come non riuscita. Si è verificato un tentativo in seguito ad alcune richieste in seguito a un errore (con un aumento del tempo di tentativo). Non si sono effettuate nuovamente richieste che presupponete non vitali.
Quando si prova correttamente un nuovo organizzatore, diventa il nuovo organizzatore selezionato, se è presente nell'elenco. Una volta tentato l'ultimo organizzatore nell'elenco, l'app Webex viene rollover a quella del primo.
In caso di heartbeat, se ci sono due errori di richiesta consecutivi, l'app Webex inizializza nuovamente il canale dell'evento.
Tenere presente che l'app Webex non esegue il fail-back e il rilevamento del servizio DNS viene eseguito una sola volta all'accesso.
During sign-in, the Webex App tries to download the config file through the XSP|ADP/Dms interface. Esegue una ricerca dei record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Si tenterà prima di inviare la richiesta di download del file di configurazione utilizzando un token SSO configurazione. Se questo non riesce, verrà riprovare ma con il nome utente e la password del dispositivo.
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning utente. Molte attività sono comuni a tutte le modalità di provisioning.
Accesso ai partner per Webex per Cisco BroadWorks
Ogni Webex per Cisco BroadWorks provider di servizi o rivenditore necessita di un da impostare come organizzazione partner per Webex per Cisco BroadWorks. È possibile utilizzare questa opzione se si dispone di un'organizzazione partner Webex esistente.
Per completare il necessario onboarding, è necessario eseguire i documenti di Webex Cisco BroadWorks e i nuovi partner devono accettare il Contratto di partner per i canali indiretti online (ICPA). Al termine di questa procedura, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore del record come richiesto. Contemporaneamente, si verrà contattati dal Proprio Partner Activation e/o Customer Success Program Manager per avviare il proprio onboarding.
Webex Partners in one region can create customer organizations in any region that we offer the services. Per informazioni, vedere: Data residency in Webex.
Configure Services on Your Webex for Cisco BroadWorks XSP|ADPs
We require that the NPS application be run on a different XSP|ADP. Requirements for that XSP|ADP are described in Configure Call Notifications from your Network.
You need the following applications / services on your XSP|ADPs.
Servizio/Applicazione |
Autenticazione richiesta |
Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
Autenticazione utente |
Integrazione di telefonia su computer |
mTLS (client e server si autenticano l'un l'altro) |
Presenza in telefonia |
Impostazioni chiamata Applicazione vista Web |
TLS (il server esegue l'autenticazione per i client) |
Sono esposti le impostazioni di chiamata dell'utente nel portale auto assistenza all'interno dell'app Webex |
This section describes how to apply the required configurations for TLS and mTLS on these interfaces, but you should reference existing documentation to get the applications installed on your XSP|ADPs.
Requisiti di co-residenza
-
Il servizio di autenticazione deve risiedere insieme ad applicazioni Xsi, poiché tali interfacce devono accettare token lunghi per l'autorizzazione del servizio. Il servizio di autenticazione è necessario per convalidare tali token.
-
Il servizio di autenticazione e Xsi possono essere eseguiti sulla stessa porta, se richiesta.
-
You may separate the other services/applications as required for your scale (dedicated device management XSP|ADP farm, for example).
-
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
-
Do not install other applications or services on the XSP|ADPs that are used for integrating BroadWorks with Webex.
-
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi connettori Cisco BroadWorks.
Only one instance of the Xsi-Events applications should be deployed on the XSP|ADP used for the CTI interface.
All Xsi-Events used for integrating Broadworks with Webex must have the same callControlApplicationName defined under Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
When a user is onboarded to Webex, Webex creates a subscription for the user on the AS in order to receive telephony events for presence and call history. The subscription is associated with the callControlApplicationName and the AS uses it to know to which Xsi-Events to send the telephony events.
Changing the callControlApplicationName, or not having the same name on all Xsi-Events webapps will impact subscriptions and telephony events functionality.
Configurazione del servizio di autenticazione (con convalida token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida di token CI con TLS. Questo metodo di autenticazione è consigliato se si utilizza R22 o superiore e il sistema supporta tale opzione.
L'autenticazione TLS reciproca (mTLS) è supportata anche come metodo di autenticazione alternativo per il servizio di autenticazione. If you have multiple Webex organizations running off the same XSP|ADP server, you must use mTLS authentication because CI Token Validation does not support multiple connections to the same XSP|ADP Auth Service.
Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida di token CI, fare riferimento all'Appendice per la configurazione dei servizi (con mTLS per il servizio diautenticazione).
-
Obtaining OAuth credentials for your Webex for Cisco BroadWorks.
-
Install the following patches on each XSP|ADP server. Installare le patch appropriate alla release in oggetto:
-
Per R22:
-
Per R23:
-
Per R24— nessuna patch richiesta
Any reference to XSP includes either XSP or ADP. -
-
Install the
AuthenticationService
application on each XSP|ADP service.Run the following command to activate the AuthenticationService application on the XSP|ADP to the /authService context path.
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
Run this command to deploy the AuthenticationService on the XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
-
Starting with Broadworks build 2022.10, the certificates authorities that are coming with Java are no longer automatically included to the BroadWorks trust store when switching to a new version of java. The AuthenticationService opens a TLS connection to Webex to fetch the access token, and needs to have the following in its truststore to validate the IDBroker and Webex URL:
-
Radice commerciale IdenTrust CA 1
-
Autorità di certificazione radice di Go Daddy-G2
Verify that these certificates are present under the following CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get
If not present, run the following command to import the default Java trusts:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
Alternatively, you can manually add these certificates as trust anchors with the following command:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
If the ADP is upgraded from a previous release, then the certificate authorities from the old release are automatically imported to the new release and will continue to be imported until they are manually removed.
The AuthenticationService application is exempt from the validatePeerIdentity setting under ADP_CLI/System/SSLCommonSettings/GeneralSettings, and always validates the peer Identity. See the Cisco Broadworks X509 Certificate Validation FD for more info on this setting.
-
-
Configure the Identity Providers by running the following commands on each XSP|ADP server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get
-
set clientId client-Id-From-Step1
-
set enabled true (impostazione abilitata) vero
-
set clientSecret client-Secret-From-Step1
-
impostazione di ciResponseBodyMaxSizeInBytes 65536
-
set issuerName <URL>
—For theURL
, enter the IssuerName URL that applies to your CI Cluster. See following table. -
set issuerUrl <URL>
—For theURL
, enter the IssuerUrl that applies to your CI Cluster. See the following table. -
set tokenInfoUrl <IdPProxy URL>
—Enter the IdP Proxy URL that applies to your Teams Cluster. See the second table that follows.
Tabella 1. Set issuerName and issuerURL Se Cluster CI è... Set issuerName and issuerURL to... USA-A
UE
USA-B
If you don't know your CI Cluster, you can obtain the information from the Customer details in Help Desk view of Control Hub.Tabella 2. Set tokenInfoURL Se Cluster Teams è... Set tokenInfoURL to...(IdP Proxy URL) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Afra
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
-
If you don't know your Teams Cluster, you can obtain the information from the Customer details in the Help Desk view of Control Hub.
-
For testing, you can verify that the tokenInfoURL is valid by replacing the "
idp/authenticate
" portion of the URL with "ping
".
-
-
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user
-
Configure Identity Providers for Cisco Federation using the following commands on each XSP|ADP server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get
-
impostazione flsUrl https://cifls.webex.com/federation
-
impostare refreshPeriodInMinutes 60
-
set refreshToken refresh-Token-From-Step1
-
-
Eseguire il comando seguente per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get
-
Configure Token Management using the following commands on each XSP|ADP server:
-
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
-
set tokenIsshe BroadWorks
-
impostare tokenDurationInHours 720
-
-
Generare e condividere le chiavi RSA. You must generate keys on one XSP|ADP then copy them to all other XSP|ADPs. Ciò è dovuto ai seguenti fattori:
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittografia di token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
If you cycle keys or change the key length, you need to repeat the following configuration and restart all the XSP|ADPs.-
Select one XSP|ADP to use for generating a key pair.
-
Use a client to request an encrypted token from that XSP|ADP, by requesting the following URL from the client’s browser:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(This generates a private / public key pair on the XSP|ADP, if there wasn’t one already)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
-
Copy the exported file
/var/broadworks/tmp/authService.keys
to the same location on the other XSP|ADPs, overwriting an older.keys
file if necessary. -
Import the keys on each of the other XSP|ADPs:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
-
-
Fornire l'URL authService al contenitore Web. The XSP|ADP’s web container needs the authService URL so it can validate tokens. On each of the XSP|ADPs:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per lo strumento di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Controllare il parametro con
get
. -
Restart the XSP|ADP.
-
Rimozione del requisito di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con convalida token CI su R24, occorre anche rimuovere il requisito di autenticazione del client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e della crittografia sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurazione TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > trasporto > http > interfaccia Server HTTP = Più specifico
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Reading HTTP Server TLS Interface Configuration on the XSP|ADP
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il
comando get e leggere i
risultati. Dovrebbero essere presenti le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Tomcat obbligatorio un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
È necessario configurare l'interfaccia HTTP che interagisce con Webex Cloud per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Enter the command
get <interfaceIp> 443
to see which protocols are already used on this interface. -
Enter the command
add <interfaceIp> 443 TLSv1.2
to ensure that interface can use TLS 1.2 when communicating with the cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia del server HTTP
Per configurare i crittografia richiesti:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Enter the command
get <interfaceIp> 443
to see which ciphers are already used on this interface. There must be at least one from the Cisco recommended suites (see XSP|ADP Identity and Security Requirements in the Overview section). -
Enter the command
add <interfaceIp> 443 <cipherName>
to add a cipher to the HTTP Server interface.The XSP|ADP CLI requires the IANA standard cipher suite name, not the openSSL cipher suite name. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
del server HTTP, utilizzare:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configure Device Management on XSP|ADP, Application Server, and Profile Server
Profile Server and XSP|ADP are mandatory for Device Management. Tali impostazioni devono essere configurate in base alle istruzioni nella Guida alla configurazione di Gestione dispositivi BroadWorks.
Interfaccia CTI e configurazione correlata
L'ordine di configurazione "in primo piano" è elencato di seguito. I seguenti ordini non sono obbligatori.
-
Configurazione del server applicazioni per sottoscrizioni CTI
-
Configure XSP|ADPs for mTLS Authenticated CTI Subscriptions
-
Porte in entrata aperte per interfaccia CTI sicura
-
Sottoscrizione della propria organizzazione Webex a BroadWorks CTI Events
Configurazione del server applicazioni per sottoscrizioni CTI
Aggiornare clientIdentity sul server applicazioni con il nome comune (CN) del Webex per il certificato client CTI Cisco BroadWorks.
Per ogni server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity nel modo seguente:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
The common name of the Webex for Cisco BroadWorks client certificate is bwcticlient.webex.com
.
Configurare TLS e i tipi di crittografia sull'interfaccia CTI
The levels of configurability for the XSP|ADP CTI interface are as follows:
Più generale = Sistema > trasporto > CTI > interfaccia CTI = Più specifiche
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità |
Contesto CLI |
---|---|
Sistema (globale) (R22 e successive) |
XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e successive) |
XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e successive) |
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocols> |
Un'interfaccia CTI specifica su questo sistema (R22 e successive) |
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocols> |
On a fresh install, the following ciphers are installed by default at the system level. If nothing is configured at the interface level (for example, at the CTI interface or HTTP interface), this cipher list applies. Note that this list may change over time:
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
-
TLS_DHE_DSS_WITH_AES_128_GCM_SHA256
-
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_DHE_DSS_WITH_AES_128_CBC_SHA256
-
TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256
Reading CTI TLS Interface Configuration on the XSP|ADP
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserire il
comando get e leggere i
risultati. Dovrebbero essere disponibili le interfacce (indirizzi IP) e, per ciascuna, se richiedono un certificato del server e se richiedono o meno l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
The XSP|ADP CTI interface that is interacting with the Webex Cloud must be configured for TLS v1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
-
Enter the command
get <interfaceIp>
to see which protocols are already used on this interface. -
Enter the command
add <interfaceIp> TLSv1.2
to ensure that interface can use TLS 1.2 when communicating with the cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia CTI
Per configurare i tipi di crittografia richiesti sull'interfaccia CTI:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
-
Immettere il
comando get per visualizzare i tipi di crittografia già utilizzati su questa
interfaccia. There must be at least one from the Cisco recommended suites (see XSP|ADP Identity and Security Requirements in the Overview section). -
Enter the command
add <interfaceIp> <cipherName>
to add a cipher to the CTI interface.The XSP|ADP CLI requires the IANA standard cipher suite name, not the openSSL cipher suite name. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
CTI, utilizzare:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Trust Anchors for CTI Interface (R22 and later)
This procedure assumes the XSP|ADPs are either internet-facing or face the internet via pass-through proxy. La configurazione del certificato è diversa per un proxy di bridging (vedere Requisiti di certificato TLS per proxy TLS-bridge).
For each XSP|ADP in your infrastructure that is publishing CTI events to Webex, do the following:
-
Accedere all'hub partner.
-
Go to Settings > BroadWorks Calling and click Download Webex CA Certificate to get
CombinedCertChain2023.txt
on your local computer.These files contain two sets of two certificates. You need to split the files before you upload them to the XSP|ADPs. All files are required.
-
Split the certificate chain into two certificates -
combinedcertchain2023.txt
-
Open
combinedcertchain2023.txt
in a text editor. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e -----END CERTIFICATE----- , e incollare il blocco di testo in un nuovo
file. -
Save the new file as
root2023.txt
. -
Save the original file as
issuing2023.txt
. Il file originale ora deve contenere solo un blocco di testo, racchiuso tra lerighe -----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copy both text files to a temporary location on the XSP|ADP you are securing, e.g.
/var/broadworks/tmp/root2023.txt
and/var/broadworks/tmp/issuing2023.txt
-
Sign in to the XSP|ADP and navigate to
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
-
(Opzionale) Eseguire
help updateTrust
per visualizzare i parametri e il formato del comando. -
Upload the certificate files to new trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
All aliases must have a different name.
webexclientroot2023
, andwebexclientissuing2023
are example aliases for the trust anchors; you can use your own as long as all entries are unique. -
Confermare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
-
Consenti ai client di eseguire l'autenticazione con certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Aggiungi interfaccia CTI e abilita mTLS
-
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione di BroadWorks. Il comando crea un certificato del server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
-
-
Replace the server certificate and key on the XSP|ADP's CTI interfaces. A tale scopo, è necessario l'indirizzo IP dell'interfaccia CTI. è possibile leggerla dal contesto seguente:
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Quindi, eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>
-
-
Restart the XSP|ADP.
Abilitazione dell'accesso agli eventi CTI BroadWorks su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Vedere Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Vedere Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
-
Specificare l'indirizzo CTI tramite il quale Webex può eseguire la sottoscrizione a BroadWorks CTI Events.
-
Gli abbonamenti CTI sono su base per-abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato è predisposto per Webex per Cisco BroadWorks.
Vista Web impostazioni chiamata
Call Settings Webview (CSWV) is an application hosted on XSP|ADP to enable users to modify their BroadWorks call settings through a webview that they see in the soft client. See the Cisco BroadWorks Call Settings Webview Solution Guide.
Webex makes use of this feature to provide users with access to common BroadWorks call settings that are not native to the Webex App.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedono alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, distribuire la funzione di visualizzazione Webview Impostazioni chiamata.
La vista Webview Impostazioni chiamata presenta due componenti:
-
Call Settings Webview application, hosted on a Cisco BroadWorks XSP|ADP.
-
The Webex App, which renders the call settings in a Webview.
Esperienza utente
-
Utenti Windows: Click Call Settings and then click .
-
Utenti Mac: Click profile picture, then
.
Distribuzione di CSWV su BroadWorks
Install Call Settings Webview on XSP|ADPs
CSWV application must be on the same XSP|ADP(s) that host the Xsi-Actions interface in your environment. It is an unmanaged application on XSP|ADP, so you need to install and deploy a web archive file.
-
Sign in to cisco.com and search for "BWCallSettingsWeb" in the software download section.
-
Individuare e scaricare la versione più recente del file.
For example,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) was the most recent at the time of writing. -
Install, activate, and deploy the web archive according to the Cisco BroadWorks Xtended Service Platform Configuration Guide for your XSP|ADP version. (Versione R24 è https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
-
Copy the .war file to a temporary location on the XSP|ADP, such as
/tmp/
. -
Passare al seguente contesto CLI ed eseguire il comando install:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war
Il software manager BroadWorks convalida e installa il file.
-
[Optional] Delete
/tmp/BWCallSettingsWeb_1.7.5_1.war
(this file is no longer required). -
Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario anche fornire un contextPath poiché è un'applicazione supportata. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione; ad esempio,
/callsettings
. -
Distribuire l'applicazione Impostazioni chiamata nel percorso del contesto selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
-
-
Ora è possibile prevedere l'URL delle impostazioni di chiamata che verrà specificato per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
-
Specificare la barra finale su questo URL quando questo viene immesso nel file di configurazione del client.
-
The XSP|ADP-FQDN must match the Xsi-Actions FQDN, because CSWV needs to use Xsi-Actions, and CORS is not supported.
-
-
Repeat this procedure for other XSP|ADPs in your Webex for Cisco BroadWorks environment (if necessary).
The Call Settings Webview application is now active on the XSP|ADPs.
Configure the Webex App to use Call Settings Webview
For more detail on client configuration, see Webex for Cisco BroadWorks Configuration Guide.
Il file di configurazione dell'app Webex contiene un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. This URL shows the call settings to the users through the application interface.
<config> <services> <web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%"> <url>%WEB_CALL_SETTINGS_URL_WXT%</url> </web-call-settings>
In the Webex app configuration template on BroadWorks, configure the CSWV URL in the %WEB_CALL_SETTINGS_URL_WXT% tag.
If you don't explicitly specify the URL, the default is empty and the call settings page isn't visible to the users.
-
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
-
Impostare la destinazione per le impostazioni di chiamata Web
su
csw:%WEB_CALL_SETTINGS_TARGET_WXT% csw
-
Impostare l'URL delle impostazioni di chiamata Web per il proprio ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/
You derived this value when deploying the CSWV application.
-
The resulting client configuration file should have an entry as follows:
<web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>
Any reference to XSP includes either XSP or ADP.
Configurazione delle notifiche push di chiamata in Webex per Cisco BroadWorks
In questo documento, viene utilizzato il termine Server push di notifiche di chiamata (CNPS) per descrivere un'applicazione ospitata da XSP o ospitata ad ADP che viene eseguita nel proprio ambiente. IL CNPS collabora con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti ed invia le notifiche di tali notifiche ai servizi di notifica FCM (Google Firebase Cloud Messaging) o APNs (Apple Push Notification).
Tali servizi notificano ai dispositivi mobili di Webex per gli abbonati Cisco BroadWorks la loro chiamata in arrivo su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzionalità del server push dinotifica.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi notificano, a loro volta, gli utenti Webex mobili dei messaggi in arrivo o delle modifiche alla presenza.
In questa sezione viene descritto come configurare NPS per il proxy di autenticazione quando il server NPS non supporta già altre app. Se occorre eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di NPS Cisco BroadWorks per l'uso del proxy https://help.webex.com/nl5rir2/NPS.
Panoramica proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, il CNPS deve essere patchto per supportare la funzione proxy NPS, Push Server per le VoIP in UCaaS.
La funzione implementa un nuovo design nel server push di notifica per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private del certificato di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e le chiavi di notifica push con il provider di servizi, il server NPS utilizza una nuova API per ottenere un token di notifica push breve da Webex per il backend Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APNs Apple e i servizi Google FCM.
La funzione migliora anche la funzionalità del server push di notifica per eseguire il push delle notifiche sui dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
-
Per ulteriori informazioni, vedere il Server push per VoIP funzionalità in Descrizione funzionalità UCaaS.
-
The BroadWorks patches for the feature are available on: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
For NPS software and patches, see the section Prepare Your NPS for Webex for Cisco BroadWorks.
Search and download the patch from the software download page.
-
Ulteriori informazioni sul server ADP sono disponibili su https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni su APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio di notifica push Apple dopo il 31 marzo 2021. We recommend that you configure your XSP|ADP to use the HTTP/2-based interface for APNs. This update requires that your XSP|ADP hosting the NPS be running R22 or later.
Preparazione del sistema NPS per Webex per Cisco BroadWorks
1 |
Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma ADP (Application Delivery Platform). |
2 |
Installare le patch del proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: |
3 |
Attivare l'applicazione server push di notifica. |
4 |
(Per le notifiche Android) Abilitare l'API FCM v1 su NPS.
|
5 |
(Per notifiche Apple iOS) Abilitare HTTP/2 su NPS.
This is exclusive to Release 22 and earlier versions; it is not available in Release 23 and above versions, which only support HTTP/2. |
6 |
Allegare un supporto tecnico da NPS XSP/ADP. |
7 |
On each AS server, the namedefs file in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN A 10.193.78.149 Once set, one of the following is required to pickup the changes:
|
Operazione successivi
For fresh installs of an NPS, go to Configure NPS to Use Authentication Proxy
To migrate an existing Android deployment to FCMv1, go to Migrate NPS to FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicato a Webex per Cisco BroadWorks.
If you want to configure the authentication proxy on an NPS that is shared with other mobile apps, see Updating Cisco BroadWorks NPS to Use NPS Proxy ( https://help.webex.com/nl5rir2).
1 |
Obtaining OAuth credentials for your Webex for Cisco BroadWorks. | |||||||||||||||||||
2 |
Creare l'account client su NPS:
To verify the values you entered match with what you were given, run The CiscoCI issuerUrl should ALWAYS be US CI cluster irrespective of your location and the default should be:
| |||||||||||||||||||
3 |
Inserire l'URL del proxy NPS e impostare l'intervallo di aggiornamento del token (è consigliato 30 minuti):
| |||||||||||||||||||
4 |
(Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 |
(Per notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, facendo in modo di omettere la chiave di autenticazione, impostarlo come vuoto.
| |||||||||||||||||||
6 |
Configurare i seguenti URL NPS:
| |||||||||||||||||||
7 |
Configurare i seguenti parametri di connessione NPS in base ai valori consigliati riportati:
| |||||||||||||||||||
8 |
Controllare se il server dell'applicazione è un ID applicazione elettronica, poiché potrebbe essere necessario aggiungere le app Webex all'elenco dei consentiti: | |||||||||||||||||||
9 |
Restart the XSP|ADP: | |||||||||||||||||||
10 |
Testare le notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migra NPS in FCMv1
Questo argomento contiene le procedure opzionali che è possibile utilizzare nella console FCM di Google quando si dispone di una distribuzione NPS esistente che occorre eseguire la migrazione a FCMv1. Sono disponibili tre procedure:
-
Migrate UC-One clients to FCMv1—When you have existing UCaaS clients and need to migrate them to use FCMv1.
-
Migrate SaaS Clients to FCMv1—When you have existing SaaS clients and need to migrate them to use FCMv1.
-
Update ADP Server—When you are migrating the NPS to an ADP server.
Migrate UC-One Clients to FCMv1
Use the below steps in Google FCM Console to migrate UC-One clients to Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere Impostazioni progetto >
. L'impostazione viene visualizzata nella tabella delle credenziali del progetto.For details, see the Connect Mobile Branding Guide at https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Refer to the gcm_defaultSenderId
parameter, which is located in the Branding Kit, Resource folder, branding.xml file with the below syntax:
<string name="gcm_defaultSenderId">xxxxxxxxxxxxx</string>
-
Accedere all'SDK di amministrazione FCM su http://console.firebase.google.com.
-
Selezionare l'applicazione Android appropriata.
-
Nella scheda Generale, registrare l'ID progetto
-
Passare alla scheda degli account di servizio per configurare un account di servizio. È possibile creare un nuovo account di servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
-
Fare clic sul pulsante blu per creare un nuovo account di servizio
-
Fare clic sul pulsante blu per generare una nuova chiave privata
-
Scarica chiave in una posizione protetta
Per riutilizzare un account di servizio esistente:
-
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
-
Identificare l'account del servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
-
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
-
Scaricare il file json contenente la chiave e salvarlo in una posizione protetta.
-
-
Copy the json file onto the XSP|ADP.
-
Configurare ID progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== my_project ********
-
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project
-
Abilitare FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
-
Run the
bwrestart
command to restart the XSP|ADP.
Migrare i client SaaS in FCMv1
Utilizzare le operazioni seguenti su Google FCM Console se si desidera migrare i client SaaS a FCMv1.
-
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done
-
Run the
bwrestart
command to restart the XSP|ADP. -
Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
-
Run the
bwrestart
command to restart the XSP|ADP.
Aggiorna server ADP
Utilizzare la procedura seguente in Google FCM Console se si sta migrando il server NPS per l'uso di un server ADP.
-
Ottenere il file JSON dalla console di Google Cloud:
-
Nella console di Google Cloud, andare alla pagina Account di servizio.
-
Fare clic su Seleziona un progetto , scegliere il progetto e fare clic su Apri .
-
Find the row of the service account that you want to create a key for, click the More vertical button, then click Create key.
-
Select a Key type and click Create
Il file viene scaricato.
-
-
Aggiungere FCM al server ADP:
-
Importare il file JSON nel server ADP utilizzando il
comando /bw/install.
-
Accedere alla CLI ADP e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON
: -
Successivamente, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
-
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
-
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Questa operazione viene eseguita per i seguenti motivi:
-
To enable Webex cloud to authenticate your users against BroadWorks (via XSP|ADP-hosted authentication service).
-
Per abilitare le app Webex per l'uso dell'interfaccia Xsi per il controllo chiamate.
-
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza in telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiungete. È possibile continuare a modificare il cluster se una delle interfacce non viene convalidata correttamente, ma non è possibile salvare un cluster se sono presenti voci nonvalide.
Questo problema è impedito poiché un cluster configurato non correttamente può provocare problemi che sono difficili da risolvere.
Cosa è necessario fare:
-
Accedere all'hub del partner (admin.webex.com) con le credenziali dell'amministratore del partner.
-
Aprire la pagina Impostazioni dal menu laterale e individuare le impostazioni per la chiamata BroadWorks.
If the admin user does not have visibility of the BroadWorks Calling settings, it is recommended that you must open a case with Cisco TAC.
-
Fare clic su Add Cluster (Aggiungicluster).
This launches a wizard where you supply your XSP|ADP interfaces (URLs). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
-
Assegnare un nome a questo cluster e fare clic su Next(Avanti).
The cluster concept here is simply a collection of interfaces, typically collocated on an XSP|ADP server or farm, that enable Webex to read information from your Application Server (AS). You may have one XSP|ADP per AS cluster, or multiple XSP|ADPs per cluster, or multiple AS clusters per XSP|ADP. I requisiti di scalabilità per il sistema BroadWorks non sono disponibili qui.
-
(Opzionale) Inserire un nome account utente BroadWorks e una password all'interno del sistema BroadWorks che si sta collegando a Webex, quindi fare clic su Next(Avanti).
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
-
Aggiungere gli URL delle azioni XSI e degli eventi XSI.
-
Opzionale. Update the DAS URL with the URL of the Device Activation Service.
-
Opzionale. Check the Enable direct BroadWorks authentication check box if you want logins to BroadWorks to be direct to BroadWorks. Otherwise, authentication to BroadWorks is proxied through the Webex-hosted IdP proxy service.
This check box affects these login situations:
-
User Activation Portal login—Users must enter their BroadWorks credentials when logging in to the portal. The above setting determines if the login is direct to BroadWorks or is through the IdP Proxy.
-
Client Login—If BroadWorks Authentication is configured in the Onboarding template, the above setting determines if client login to the Webex App is direct to BroadWorks or is proxied through the IdP Proxy.
-
-
Fare clic su Avanti.
-
Nella pagina Interfaccia CTI, effettuare le seguenti operazioni:
-
Aggiungere l'URL E la porta CTI per l'interfaccia CTI a cui si desidera eseguire la connessione.
-
Opzionale. Enable the Call History toggle and then enter your BroadWorks user ID. When this option is selected, BroadWorks call history events get synced to the Webex cloud. Gli utenti possono visualizzare le cronologia chiamate nell'app Webex.
-
Opzionale. Enable the Do not disturb (DND) sync toggle and then enter your BroadWorks user ID. This option syncs DND events between Webex and BroadWorks, ensuring that the feature works the same on both platforms.
-
Fare clic su Avanti.
-
-
Aggiungere l'URL del servizio di autenticazione.
-
Selezionare Servizio autenticazione con convalida token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex, poiché il servizio di autenticazione convalida correttamente il token utente in base al servizio di identità Webex prima di elacere il token di lungo termine all'utente.
-
Esaminare le voci visualizzate nella schermata finale e fare clic su Crea. Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Partner Hub passa gli URL a diversi microservizi Webex che verificano le connessioni alle interfacce fornite.
-
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è stata eseguita correttamente.
-
Il pulsante Crea potrebbe essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, si verifica un problema con una delle integrazioni appena configurate.
Questo controllo è stato implementato per evitare errori nelle attività successive. You can go back through the wizard as you configure your deployment, which may require modifications to your infrastructure (e.g. XSP|ADP, load balancer, or firewall) as documented in this guide, before you can save the template.
Verifica delle connessioni alle interfacce BroadWorks
-
Accedere all'hub del partner (admin.webex.com) con le credenziali dell'amministratore del partner.
-
Aprire la pagina Impostazioni dal menu laterale e individuare le impostazioni per la chiamata BroadWorks.
-
Fare clic su View Clusters (Visualizzacluster).
-
Partner Hub avvia test di connettività da diversi microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina di elenco dei cluster mostra un messaggio di stato accanto a ciascun cluster.
Dovrebbero essere visualizzati messaggi di Operazione riuscita in verde. Se viene visualizzato un messaggio di errore rosso, fare clic sul nome del cluster interessato per visualizzare quale impostazione causa il problema.
-
Opzionale. Select a cluster if you want to see existing settings for that cluster, such as XSI-Actions, XSI-Events, DAS URL and the CTI interface settings.
Configure your Onboarding templates
Onboarding templates are the way that you will apply shared configuration to one or more customers as you onboard them via the provisioning methods. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma a un cliente può essere associato un solo modello.
-
Sign in to the Partner Hub and select Customers.
-
Click the Onboarding templates button to view the existing templates.
-
Click Create Template.
-
In the Template Details window, add the Template name, Country or Region and Default email Language.
-
Click the drop-down for the CCW Subscription ID, find the listed subscriptions for the partner, and select the applicable subscription.
This field is shown only for partners migrated from Webex for BroadWorks to Webex. -
In the Service Setting window, use the Cluster dropdown to choose the cluster you want to use with this template.
-
Inserire un Nomemodello, quindi fare clic su Avanti.
-
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per diverse modalità di provisioning Nome impostazione
Provisioning Flow con e-mail attendibili
Provisioning flow senza messaggi e-mail
Self-provisioning utente
Enable BroadWorks Flow Through Provisioning (include provisioning account credentials if On**)
Attivato
Specificare il nome account e la password di provisioning in base alla configurazione BroadWorks.
Attivato
Specificare il nome account e la password di provisioning in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
On†
On†
On†
Indirizzo e-mail provider servizi
Selezionare un indirizzo e-mail dal menu a discesa (è possibile digitare alcuni caratteri per individuare l'indirizzo se è un elenco lungo).
This email address identifies the administrator within your Partner organization who will be granted delegated admin access to any new customer organizations created with the Onboarding template.
Paese
Scegliere il paese utilizzato per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione può essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature paese-regione in questo foglio dicalcolo.
The organization country will determine the default global call-in numbers for Cisco PSTN in Webex Meeting Sites. Refer to the Country section of help page for more information.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti predisposti con questo modello sono aziende in BroadWorks.
Se sono gruppi, uscire da questo interruttore.
Se si dispone di una combinazione di aziende e gruppi nella broadworks, è necessario creare modelli diversi per i diversi casi.
Note della tabella:
-
† questo switch assicura che viene creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questo valore deve essere sempre attivo, a meno che non si utilizzi un processo di ordinazione e ordinazione manuale (tramite Cisco Commerce Workspace) per creare organizzazioni cliente in Webex (prima di iniziare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso definita come modello di provisioning ibrido ed è fuori dall'ambito di questo documento.
-
** "Provisioning account" refers to the BroadWorks system-level admin account. On BroadWorks, you need an admin account with these attributes: Administrator Type=Provisioning, Read-only=Off.
-
-
Selezionare il pacchetto dei servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Basic , Standard , Premium o Softphone.
È possibile ignorare questa impostazione per i singoli utenti tramite Partner Hub.
-
Opzionale. Check Disable Cisco Webex Free Calling if you want to disable Webex Calls,.
-
Per Configurazione partecipazione ariunione, selezionare una delle seguenti opzioni:
-
Numeri chiamata in accesso Cisco (PSTN)
-
Partner-provided Call-in Numbers (BYoPSTN)—If you select this option, refer the Bring Your Own PSTN Solution Guide for Webex for Cisco BroadWorks for detailed information on how to configure this option.
-
-
Fare clic su Avanti.
-
There are two approaches for provisioning subscribers with regards to how their identities are verified – using Trusted Emails or Untrusted Emails.
In the Trusted Email workflow users provide email addresses to the partner who adds them in BroadWorks. You as a partner are responsible for provisioning the email address as part of either the flow-through or API method.
It is highly recommended to use the Trusted provisioning method because it ensures that all subscribers are fully provisioned by you as a partner and there is no action required from the end users.
In the Untrusted email case users need to verify their emails before provisioning, or users can self-activate themselves.
In the Untrusted case there are several provisioning modes based on the verification settings in the table below:
Tabella 4. Recommended User Verification Settings for Untrusted Provisioning Modes Nome impostazione
Provisioning flow senza messaggi e-mail
Self-provisioning utente
Provision Admin First
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
-
Note della tabella:
-
* Each customer organization in Webex is required to have at least one user with administrator role. The first user to whom you assign Integrated IM&P in BroadWorks takes the customer administrator role if a new customer organization is created in Webex. As a Service Provider you may want to have control over who gets the role. Checking this setting blocks users from completing activation until the first user you provisioned is activated. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
-
-
Fare clic su Avanti.
-
Select the default authentication mode (either BroadWorks Authentication or Webex Authentication) for user login to Webex.
This setting has no effect on user login to the User Activation Portal. Users must use their BroadWorks user ID and password when logging in to the portal, irrespective of how the Onboarding template is configured.Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena creati. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
-
Fare clic su Avanti.
-
Per Preferenze , configurare quantosegue:
-
Scegliere se si desidera inserire automaticamente gli indirizzi e-mail degli utenti nella pagina diaccesso.
Utilizzare questa opzione solo se è stata selezionata l'autenticazione BroadWorks e gli indirizzi e-mail degli utenti sono stati inseriti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il relativo nome utente BroadWorks. La pagina di accesso fornisce un'opzione per modificare l'utente, se necessario, ma ciò potrebbe provocare problemi di accesso.
-
Se si desidera abilitare la sincronizzazione delle directory, impostare l'opzione Abilita sincronizzazione rubrica telefonica per tutte le organizzazioni dei nuovi clienti attivata.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente, in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
-
Inserire un Amministratore partner.
Questo nome viene utilizzato nel modulo di messaggio e-mail da Webex, che invita gli utenti a convalidare gli indirizzi e-mail.
-
Make sure the Allow admin-invite emails when attaching to existing orgs toggle is On (the default setting is On).
-
Fare clic su Avanti.
-
Esaminare le voci visualizzate nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con qualsiasi altro modello.
-
Fare clic sul nome del modello per modificarlo o eliminarlo, se necessario.
Non è necessario inserire nuovamente i dettagli dell'account di provisioning. I campi di conferma password/password vuoti sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori specificati alla procedura guidata.
Aggiungere altri modelli se si dispone di diverse configurazioni condivise da fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbero essere necessari i dettagli del modello per una attività seguente.
Configurazione del server dell'applicazione con URL del servizio di provisioning
Questa attività è necessaria solo per il flusso attraverso il provisioning.
Patch Application Server (R22, R23, and R24 only)
-
If you haven't yet done so, apply the following patch that applies to your release:.
-
Per R22:
AP.as.22.0.1123.ap373197
-
Per R23:
AP.as.23.0.1075.ap373197
-
Per R24:
AP.as.24.0.944.ap384177
For a complete list of BroadWorks patches that form the requirement for deploying Webex for Cisco BroadWorks, See BroadWorks Software Requirements in the Reference section. -
-
Passare al contesto
Maintenance/ContainerOptions.
-
Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true
Ottieni gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interface > Messaging and Service > Integrated IM&P) dei comandi AS.
-
Accedere a Partner Hub e andare a
. -
Fare clic su View Templates (Visualizzamodelli).
-
Selezionare il modello in uso per il provisioning degli abbonati di questo gruppo/aziendale in Webex.
I dettagli del modello vengono visualizzati in un riquadro a comparsa a destra. Se non è stato ancora creato un modello, è necessario effettuare questa operazione prima di ottenere l'URL di provisioning.
-
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per gli altri modelli se ne sono disponibili più di uno.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema sul server applicazioni
È possibile che non si desideri impostare il provisioning e il dominio del servizio a livello di sistema se si utilizza UC-One SaaS. Vedere Punti decisione nella sezione Preparazione dell'ambiente.
-
Accedere al server dell'applicazione e configurare l'interfaccia di messaggistica.
-
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL
-
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name
-
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password
-
AS_CLI/Interface/Messaging> set enableSynchronization true
-
-
Attivare l'interfaccia IMP integrato:
-
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com
-
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
-
È necessario inserire il nome completo per il parametro provisioningURL, come fornito in Control
Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare il mapping nel file /etc/hosts
su AS.
(Opzione) Configurazione dei parametri di provisioning per-enterprise sul server applicazioni
-
In BroadWorks UI, aprire l'azienda che si desidera configurare e andare a Servizi > IM integrato&P.
-
Selezionare Usa dominio servizio e inserire un valore fittizio (Webex ignora questo parametro. È possibile utilizzare
example.com
). -
Selezionare Usa server di messaggistica.
-
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
È necessario inserire il nome completo per il
parametro
provisioningURL, come fornito in Partner Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare il mapping nelfile /etc/hosts
su AS. -
Nel campo Nome utente, inserire un nome per l'amministratore del provisioning. Questo deve corrispondere al valore nel modello in Partner Hub.
-
Inserire una password per l'amministratore del provisioning. Questo deve corrispondere al valore nel modello in Partner Hub.
-
Per Identità utente predefinita per IM&PID, selezionare Principale .
-
Fare clic su Applica.
-
Ripetere questa operazione per le altre aziende che si desidera configurare per il flusso attraverso il provisioning.
User Provisioning Data
For information on the user data that gets exchanged between BroadWorks and Webex during user provisioning, see Service Provider User Provisioning.
Partner Pre-Provisioning Check API
The Pre-Provisioning Check API helps administrators and sales teams by checking for errors before you provision a customer or subscriber for a package. Users or Integrations authorised by a User with the Partner Full Administrator role can use this API to ensure that there are no conflicts or errors with package provisioning for a given customer or subscriber.
The API checks to see if there are conflicts between this customer/subscriber and existing customers/subscribers on Webex. For example, the API may throw errors if the subscriber is already provisioned to a different customer or partner, if the email address exists already for another subscriber, or if there are conflicts between the provisioning parameters and what exists already on Webex. This gives you the opportunity to fix those errors before you provision, increasing the likelihood of successful provisioning.
For more information on the API, see: Webex for Wholesale Developer Guide
To use the API, go to : Precheck a Wholesale Subscriber Provisioning
To access Precheck a Wholesale Subscriber Provisioning document you need to log in to https://developer.webex.com/ portal.
Partner SSO - SAML
Allows partner administrators to configure SAML SSO for newly created customer organizations. I partner possono configurare un singolo rapporto di SSO predefinito e applicare tale configurazione alle organizzazioni dei clienti da loro gestite, così come ai propri dipendenti.
-
Verificare che il provider di provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per i provider di identità dell'integrazione Single Sign-On in Control Hub.
-
Upload the CI metadata file that has Identity Provider.
-
Configure a Onboarding Template. Per l'impostazione della Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, inserire EntityID dal file XML dei metadati SAML del provider di identità di terze parti.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
-
In questo modo l'utente può eseguire l'accesso.
Partner SSO - OpenID Connect (OIDC)
Allows partner administrators to configure OIDC SSO for newly created customer organizations. I partner possono configurare un singolo rapporto di SSO predefinito e applicare tale configurazione alle organizzazioni dei clienti da loro gestite, così come ai propri dipendenti.
The below steps to set up Partner SSO OIDC apply to newly created customer organizations only. If partner administrators try to modify the default authentication type to Partner SSO OIDC in an existing temple, the changes will not apply to the customer organizations already onboarded using the template.
-
Open a Service Request with Cisco TAC with the details of the OpenID Connect IDP. The following are mandatory and optional IDP attributes. TAC must set up the IDP on the CI and provide the redirect URI to be configured on the IDP.
Attributo
Richiesto
Descrizione
IDP Name
Sì
Unique but case-insensitive name for OIDC IdP config, could consist of letters, numbers, hyphens, underlines, tildes, and dots and max length is 128 characters.
OAuth client Id
Sì
Used to request OIDC IdP Authentication.
OAuth client Secret
Sì
Used to request OIDC IdP Authentication.
List of scopes
Sì
List of scopes which will be used to request OIDC IdP authentication, split by space, e.g. 'openid email profile' Must including openid and email.
Authorization Endpoint
Yes if discoveryEndpoint not provided
URL of the IdP's OAuth 2.0 Authorization Endpoint.
tokenEndpoint
Yes if discoveryEndpoint not provided
URL of the IdP's OAuth 2.0 Token Endpoint.
Discovery Endpoint
No
URL of the IdP's Discovery Endpoint for OpenID endpoints discovery.
userInfoEndpoint
No
URL of the IdP's UserInfo Endpoint.
Key Set Endpoint
No
URL of the IdP's JSON Web Key Set Endpoint.
In addition to the above IDP attributes, the partner organization ID needs to be specified in the TAC request.
-
Configure the redirect URI on the OpenID connect IDP.
-
Configure a Onboarding template. For the Authentication Mode setting, select Partner Authentication With OpenID Connect and enter the IDP Name provided during the IDP setup as the OpenID Connect IDP Entity ID.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
-
Very that the user can log in using the SSO authentication flow.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è necessaria per diverse funzioni di chiamata, inclusi la registrazione della chiamata, il gruppo di risposta per risposta per chiamate di gruppo, esecutivi e l'assistente esecutivo.
Use the CLI to enable the feature on all AS and XSP|ADP interfaces.
-
Run the following commands on AS interfaces. This will enable the AS to send the
X-BroadWorks-Correlation-Info
SIP header:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true
-
The
enableCallCorrelationID
parameter associated with the Xsi-Actions application is used to control the inclusion of call correlation information in Xsi-Actions logs. It is recommended to haveenableCallCorrelationID
enabled using the following command on XSP|ADP interfaces:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione di identificativo correlazione chiamata CiscoBroadWorks.
Sinc rubrica
La sincronizzazione delle directory assicura che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la rubrica chiamate completa dal server BroadWorks viene sincronizzata con la rubrica Webex. Gli utenti possono accedere alla rubrica dall'app Webex e chiamare qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione delle rubrica, andare a Sincronizzazione rubrica in Webex per Cisco BroadWorks.
Cronologia chiamate Unified
Quando la Cronologia chiamate Unified è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia delle chiamate e delle riunioni Webex che viene visualizzata nell'app Webex. Gli utenti possono visualizzare la cronologia delle chiamate e la cronologia delle riunioni dettagliate dall'app Webex.
La cronologia delle chiamate Unified può essere abilitata dagli amministratori a livello di partner in Hub partner su base cluster per cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
-
Eventi della cronologia delle chiamate: questi eventi vengono utilizzati per creare una cronologia delle chiamate Unified dettagliata
-
Eventi di stato hook: la cronologia delle chiamate Unified include ottimizzazioni dello stato degli hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti della presenza telefonica
Requisiti cronologia chiamate Unified
Prima di configurare Unified Call History, verificare di aver patchato il sistema. Questa funzione dipende dalle seguenti patch di BroadWorks installate:
Per R22:
-
AP.as.22.0.1123.ap378585
—after patch installation, you must activate feature 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per R23:
-
AP.as.23.0.1075.ap378585
—after patch installation, you must activate feature 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
-
If using XSP—
AP.xsp.23.0.1075.ap378585
-
If using ADP—
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
-
AP.as.24.0.944.ap378585
—after patch installation, you must activate feature 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
In addition to patching your system, the client config file (config-wxt.xml
) must have the following tag set: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
To have Hunt Group, Call Center and other redirection info in Unified Call History, the following Broadworks patches must be installed and active:
Per R23:
-
AP.as.23.0.1075.ap383346
-
AP.as.23.0.1075.ap383994
Per R24:
-
AP.as.24.0.944.ap383346
-
AP.as.24.0.944.ap383994
To have Executive-Assistant info in Unified Call History, the following Broadworks patches must be installed and active:
Per R24:
-
AP.as.24.0.944.ap380052
-
AP.as.24.0.944.ap384239
-
ADP running Xsi-Events-24_2022.06 or later
In addition to the Broadworks patches, Directory Sync must also be enabled for the Executive-Assistant Unified Call History.
When you enable Call History or DND Sync, Webex will send CTI subscription refresh requests for all users under the cluster. Depending on the number of users, this may last up to a few hours. It is recommended to not perform any Broadworks maintenance activity during the same maintenance window.
Abilita cronologia chiamate (nuovo cluster)
To enable Call History on a new cluster, see the steps for adding a cluster in Configure Your Partner Organization in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia delle chiamate su un cluster esistente, effettuare le seguenti operazioni:
-
Sign in to Partner Hub at
admin.webex.com
. -
Andare a Impostazioni e selezionare un cluster esistente.
-
Verificare che la connessione del cluster sia buona. Il pannello destro deve visualizzare un segno di spunta verde con la connessionestabilita.
Se non viene visualizzato, in Verifica connessioni (Opzionale) , inserire l'ID utente BroadWorks e la password BroadWorks e fare clic su Verifica per verificare che la connessione sia buona.
-
Selezionare la casella di cronologia chiamate controllo.
-
Fare clic su Salva.
Interazioni funzioni
Le seguenti interazioni tra le funzioni esistono per Unified Call History:
-
La cronologia delle chiamate Unified non è supportata per gli utenti configurati in BroadWorks con elenchi di inoltro o indirizzari diretti. Quando esiste questa situazione, gli eventi di cronologia delle chiamate e stato di hook non vengono inviati all'app Webex.
-
La cronologia delle chiamate Unified non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella Cronologia chiamate.
Visualizzazione della cronologia delle chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia delle chiamate Unified dall'app Webex. Per informazioni dettagliate, vedere: Webex | View Call and Meeting History.
Disabilitazione di Unified Call History
Una volta abilitata la Cronologia chiamate Unified su un cluster, non è possibile disabilitare la funzione per proprio conto. If you need to disable the feature, contact Cisco Technical Assistance Center (TAC).
Visual Spam Indication
The Webex App supports a visual indication of spam calls in the call toast when the call is presented to the callee and in the Unified Call History records when BroadWorks is updated to perform Caller ID validation via the STIR/SHAKEN framework. To have this feature:
- Enable Unified Call History as described in the previous section.
- The following patches must be installed and active:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- or AS-25_Rel_2022.12 at a minimum
- The feature must be activated via the AS CLI:
- AS_CLI/System/ActivatableFeature> activate 104112
- AS_CLI/System/StirShaken> set enableVerification true
- Broadworks must be configured to perform STIR-SHAKEN signing, tagging, and verification as described in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification
When BroadWorks is properly configured, a new header X-Cisco-CallerId-Disposition will be added in INVITE requests sent to Cisco clients and a new field callerIdDisposition will be added to the existing Call History Events that are sent to Webex Cloud via the CTI interface. Webex devices will use this information to provide a visual spam indication in the call presentation and the Unified Call History of the callee.
Caller Identification and Call Redirection
Caller Identification
When the Webex App receives a call, it will attempt to identify who the caller is and display this information in the incoming call notification, the in-call window, and after the call is complete, in the call history and voicemail.
The Webex App will attempt to find the caller ID by matching the incoming phone number with the phone numbers of contacts found in various sources. The Webex App will use the following sources in this order. Once it finds it in one source it will not attempt to search anywhere else.
If it finds multiple instances of a number in one source, it will not try to choose one of them, in this case, it will not display any caller ID.
-
Webex Common Identity (CI) which contains your organization users.
-
Personal and Organization Contacts. Personal Contacts are visible under the Contacts tab.
-
Local Address Book. In Windows - Outlook application, in Mac - Mac Contacts, in iOS - iPhone contacts, in Android - Android contacts.
If there is no match found with the incoming phone number, then the app will use the display name in the SIP FROM header if available. Otherwise, it will use the username part of the SIP URI from the SIP From header as a last resort.
For remote call control (i.e., Deskphone Control Mode) XSI info is used, where BWKS ID or extension is used, extracted from remote-party-info in the XSI event. If remote-party-info is not available, then P-Asserted Identity (PAI) (if configured) will be used.
Call Redirection
In the case where a call has been redirected or forwarded, then the app will attempt to show who the caller is and how it was forwarded in the call notification and call history.
-
Call Forwarded: Shows number that forwarded the call.
-
Hunt Group: Shows name of the hunt group that forwarded the call.
-
Call Center Queue: Shows name of the queue that forwarded the call.
-
Executive-Assistant: Shows name of Executive the call is coming in for.
Eccezioni:
-
For internal call queue calls, where an agent calls back an internal party, the remote party will not see the name of the call queue but will see the name of the agent calling them.
Call Answered Elsewhere:
For Hunt Groups or Call Queues that are set up with simultaneous routing, agents will see a call answered elsewhere in call history if another agent picks up the call. For Hunt Groups or Call Queues with sequential routing, or in an overflow, calls will show as missed call in call history if answered by another agent.
Select Caller ID
Panoramica
The "Select Caller ID" feature enables users to switch between different Calling Line IDs for external calls. If enabled by the admin, users can choose from the following options for their Calling Line Identity:
-
User number ("Use user phone number for Calling Line Identity")
-
Configurable CLID ("Use configurable CLID for Calling Line Identity")
-
Group CLID ("Use group/department phone number for Calling Line Identity")
Funzionalità
Users have two methods to change their Caller ID as provisioned by the administrator:
- Feature Access Codes (FAC): Specific codes for each of the three Caller ID options.
- Webex App Interface: A user-friendly view within the Webex desktop and mobile apps that display the available Caller ID options enabled by the administrator, allowing users to select their preferred ID.
Ulteriori funzioni
- The Webex apps will also include options for Call Center queues DNIS.
- Mobile app users will have Dual Persona options available for Mobility users.
Preconditions
The following conditions must be met on the BroadWorks server for the user to be able to control their choice of external CLID policy:
- The system flag 'EnableUserSelectionOfExternalCLIDPolicy' is enabled.
- User level Call Processing Policy Calling Line ID scope is set to "Use User Calling Line Id Policy" for this user.
- The User level Call Processing Policies flag 'Allow User Selection of External CLID Policy' is enabled for the user.
- If no number is defined for the "Use configurable CLID for Calling Line Identity" or "Use group/department phone number for Calling Line Identity" options, the FACs or app display will have no effect. This setting must be configured by the administrator prior to user selection.
BroadWorks Patches
This feature requires two specific BroadWorks patches to function correctly:
- BWKS-5230 was the original user-selectable CLID feature - it lets users (if the system is configured properly) change which CLID policy is applicable. See FD here: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/UserSelectionOfExternalCallingLineIDOptionFD-R250.pdf
- BWKS-9510 is an XSI enhancement requested by the Webex client team to make it easier to discover which options are available for a user. This is necessary because the choice of CLID policy isn't a simple user-level feature (like CFA) that is directly controllable. Rather it depends on various system configuration options and the "call processing policies" hierarchy. You can see details here: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/XSIEnhancementToSupportUserSelectableCLIDFD-R250.pdf
Webex App Configuration
These tag needs to be enabled in the desktop, tablet, and mobile configurations:
<config> <services> <calls> <caller-id> <outgoing-calls enabled="%ENABLE_CLID_OUTGOING_CALLS_WXT%">
Shared line appearance
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. The shared line configuration for the Webex App is similar to the shared line configuration for desk phones. This specific feature allows you to assign shared line appearances to the end user's Webex App.
This feature benefits the users to handle calls on other user's extension directly from the Webex App.
-
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
-
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
-
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
-
A user cannot be provisioned with Executive-Assistant service at the same time as having Shared Lines.
-
A user's primary line port should not be changed to a Shared Line.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Owner Flag in Device List to Support Webex Client Shared Lines
R23 without ADP:
-
AP.as.23.0.1075.ap384179
-
AP.xsp.23.0.1075.ap384179
R23 with ADP:
-
AP.as.23.0.1075.ap384179
-
Xsi-Actions-23_2022.10
R24:
-
AS: AP.as.24.0.944.ap384179
-
Xsi-Actions-24_2022.10
R25:
-
AS: RI release Rel_2022.10_1.310
-
Xsi-Actions-25_2022.10
Patch 2: Patches for increasing port count on device profile types. Esempio: For the desktop client: System>Identity/Device Profile Type Modify> Business Communicator - PC: Profile , Standard Options, Number of Ports:
- IF 'Unlimited' is enabled, no change is required
- IF 'Limited To' is <10, change the value = 10 and save to utilize all available lines
-
RI release Rel_2022.10_1.310
Non disturbare (DND) sincronizzazione
Do Not Disturb (DND) Sync aligns DND settings between Webex and BroadWorks by synchronizing DND status between the two platforms. For example, if a user turns on DND from the Webex App, that status syncs to BroadWorks calling devices. As a result, the user’s BroadWorks-registered desk phone does not ring when someone attempts to call it. Similarly, if a user sets DND from a desk phone, the status syncs to the Webex App. Without this feature, DND updates from one platform don't get recognized by the other platform.
DND Sync gets applied at the BroadWorks cluster level and can be enabled in Partner Hub by a partner administrator.
If there are many customers (>50) in the BroadWorks cluster, DND sync is not supported. In such instances, it is recommended to contact a Cisco TAC support engineer for assistance.
Prerequisiti
Make sure that the following patches are applied to the AS and XSP|ADP. Apply only the patches for your BroadWorks version.
For Release 23:
<snipped>
- ADP apps: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
For Release 24:
<snipped>
- ADP apps: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
After you apply the patches, activate feature 25433 on the AS:
AS_CLI/System/ActivatableFeature> activate 25433
If there are many customers (>50) in the BroadWorks cluster, operations such as updating XSI Actions, XSI Events, DAS URL, XSP|ADP URL, or DND sync are not supported. In such instances, it is recommended to contact a Cisco TAC support engineer for assistance.
Configure Device Feature Key Synchronization on BroadWorks. Make sure that the phone supports SIP SUBSCRIBE/NOTIFY for the “as-feature-event” event package. For details, see Cisco BroadWorks Device Feature Key Synchronization.
Enable DND Sync (Existing cluster)
-
Sign in to Partner Hub
-
Fare clic su Impostazioni.
-
Click View Cluster and select the appropriate BroadWorks cluster.
-
Enable the Do not disturb (DND) sync toggle.
-
Enter your BroadWorks user ID and click Enable.
The system validates that the BroadWorks cluster has the appropriate patches to support DND Sync. If validation fails, the Save button gets disabled.
-
If validation succeeds, click Save.
-
Once DND Sync gets enabled, Webex refreshes all user subscriptions to include the Do not disturb event package. Depending on the number of users, this process may take a few hours to complete.
-
Enabling DND Sync is a one-way toggle. Once the feature is enabled, you can’t disable it on your own.
Enable DND Sync (New cluster)
You can also enable the feature during cluster creation. For details, see “Configure Your BroadWorks Clusters” in Configure Your Partner Organization in Partner Hub.
Disable DND Sync
You can’t disable DND Sync on your own. To disable the feature, create an engineering BEMS case with the following information:
-
Famiglia: Servizio Spark
-
Prodotto: Chiamata in Webex (Webex per BroadWorks)
-
Componente: WxBW- Provisioning
-
The BEMS case must state that Do Not Disturb Sync is to be disabled for a partner. The case must contain partnerId and BroadWorks clusterId.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione della chiamata.
Modalità di registrazione |
Descrizione |
Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Ondemand |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma la registrazione viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente |
La registrazione non viene avviata a meno che l'utente non seleziona l'opzione Avvia registrazione nell'app Webex. L'utente può avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
-
Per R22: AP.as.22.0.1123.ap377718
-
Per R23: AP.as.23.0.1075.ap377718
-
Per R24: AP.as.24.0.944.ap377718
The Call Correlation Identifier must be turned on. For details, see Enable Call Correlation Identifier.
The following configuration tag must be enabled in order to use this feature: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamata di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, vedere l'help.webex.com Webex | Registra lechiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono accedere alla piattaforma di registrazione delle chiamate di terze parti.
Enabling Voicemail for Microsoft Teams Integration
You can enable voicemail for Microsoft Teams users in the Webex for BroadWorks solution. This integration allows users to retrieve their voicemails directly through Microsoft Teams, enhancing the overall user experience.
Steps to Enable Voicemail
-
Configure Voicemail Settings: Follow the steps provided in the Webex Calling documentation to configure and manage voicemail settings. This includes setting up voicemail for users, enabling notifications, and configuring voicemail to email.
For detailed instructions, see: Configure and manage voicemail settings for a Webex Calling user.
-
Integrate with Microsoft Teams: Ensure that the integration between Webex for BroadWorks and Microsoft Teams is properly configured. This will enable users to access their voicemails through the Microsoft Teams interface.
For integration details, see: Configure Microsoft Teams for Webex Calling.
Esperienza utente
Once the integration is set up, users can:
- Retrieve voicemails directly within the Microsoft Teams application.
- Receive notifications for new voicemails.
- Manage voicemail settings from the Webex interface.
Requisiti
To support voicemail retrieval in the Microsoft Teams integration with the Webex for BroadWorks offer, additional network changes are required. BroadWorks partners should enable Cross-Origin Resource Sharing (CORS) for the following URLs on their BroadWorks platform:
- https://jabber-integration-a.wbx2.com/
- https://jabber-integration-r.wbx2.com/
- https://jabber-integration-k.wbx2.com/
- https://msteams-calling.webex.com/
For more details on the configuration steps, please refer to section 8.5.1.2 of the BW Application Delivery Platform Configuration Guide, which requires version 2024.05 on the ADP.
Gestione e Parcheggio chiamata gruppo
Webex per Cisco BroadWorks supporta l'accesso Parcheggio chiamata e Retrieve. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono poi essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti del retail in un'impostazione di store possono utilizzare la funzione per parcheggiare una chiamata che può essere poi selezionata da qualcuno in un altro reparto.
Operazione funzione
Una volta configurata la funzione
-
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nella relativa app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
-
Un altro utente del gruppo fa clic sull'opzione Recupera chiamata nella relativa app Webex. L'utente inserisce il interno della chiamata in parcheggio per continuare la chiamata.
Requisiti
Per utilizzare questa funzione, verificare quanto segue:
-
Il file di configurazione del client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
-
The Call Correlation Identifier must be enabled on the AS and XSP|ADP. For details, see Enable Call Correlation Identifier.
-
Your SBC must be configured to pass the ‘
x-broadworks-correlation-in
' SIP attribute to and from the Application Server.
Configurazione
Per informazioni su come configurare la funzionalità Parcheggio chiamata gruppo su BroadWorks, vedere "Aggiunta di un gruppo Parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte2. È necessario creare un gruppo e aggiungere gli utenti al gruppo.
Per informazioni su come configurare l'identificativo di correlazione chiamata su BroadWorks, vedere Descrizione della funzione di identificativo correlazione chiamata CiscoBroadWorks.
Ulteriori informazioni
Per informazioni utente sull'uso delle chiamate di Parcheggio chiamata, vedere Parcheggio Webex | e recupero dellechiamate.
Parcheggio chiamata/indirizzati Parcheggio chiamata
Il parcheggio di chiamate normali o indirizzate non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso funzioni:
-
Inserire *68 per parcheggiare una chiamata
-
Inserire *88 per recuperare una chiamata
Inclusione
Barge-in service is commonly used in call center environments or other situations where immediate assistance or intervention may be required.
When a barge-in service is enabled, a designated user or supervisor can enter an active call by initiating a specific command or by using a dedicated button or key combination on their phone or communication device. Once the barge-in request is made, the system establishes a connection with the ongoing call, allowing the authorized person to listen to the conversation or join the call as an active participant.
Barge-in service can be useful in various scenarios. In a call center setting, supervisors or trainers can monitor and coach customer service representatives by listening to their calls in real-time. If necessary, they can intervene to provide guidance or take over the call if the representative is struggling. In emergency situations or critical discussions, authorized personnel can quickly join ongoing conversations to provide assistance or make important decisions.
In the Webex app for Barge in, we get a notification that the call is transformed into a conference. There is no additional information in the NOTIFY (call-info or conference-info) what is the type of conference, so we can treat it in a different way.
When a barge-in occurs, a three-way call is established between the parties. The following terms are introduced:
-
Supervisor: A supervisor is a person who oversees and manages a team of customer service agents or call center representatives. In the context of call barge-in, a supervisor typically has the ability to monitor and intervene in ongoing customer calls. They may use call monitoring tools or software to listen in on calls, provide guidance to agents, and ensure quality control. The supervisor's role may involve training agents, addressing customer concerns, and optimizing the performance of the team.
-
Customer: A customer refers to an individual or entity that engages with a company or organization to obtain products, services, or support. In the context of call barge-in, a customer is someone who is making or receiving a phone call with a customer service agent. Customers may seek assistance, information, or resolution to their queries or issues during the call. The call barge-in feature allows supervisors or authorized personnel to join the ongoing call between the customer and the agent.
-
Agent: An agent, also known as a customer service representative or call center agent, is a person responsible for handling customer interactions and providing support or assistance over the phone or other communication channels. Agents are trained to address customer inquiries, resolve problems, process transactions, and deliver a positive customer experience. In the context of call barge-in, an agent is the individual speaking directly to the customer during the phone call. The agent may receive guidance or feedback from the supervisor through call barge-in if necessary.
For any client initiated requests such as CallStartRequest, CallPickupRequest, DirectedCallPickupRequest, DirectedCallPickupWithBargeInRequest, etc, if <Webex Client> (please choose the right name instead of Webex client, if it is not appropriate) is provisioned as a Shared Call Appearance device, 'Alert all appearances for Click-to-Dial calls' configuration should be enabled on Shared Call Appearance setting for the client to receive a call, unless the location is explicitly provided by the client initiating the request.
Mobile Native Call Escalate to Meeting
The Mobile Native Call Escalate to Meeting comes with two unique features:
-
New Push Notification
Mobile users on a native call can now switch to the Webex App by tapping on the New push notification. When you start a native call screen a New push notification appears on the screen and tapping the notification takes you straight to the Webex App in-call screen.
You see the Webex notification during a mobile phone call if you use Webex Go or your mobile network operator (MNO) has call signaling using Cisco call control for your mobile phone calls.
-
Move Mobile Call to Meeting
When you're in the middle of a call with someone, you may want to move that call into a meeting to make use of some advanced meetings features like video, share, or whiteboarding. Or invite other people into the discussion and move to a meeting.
BroadWorks Requirements
-
Activatable feature 25239
-
R23 with XSP|ADP:
-
AS Patch AP.as.23.0.1075.ap383064
-
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
-
Patch AP.platform.23.0.1075.ap383064
-
-
R23 with ADP:
-
AS Patch AP.as.23.0.1075.ap383064
-
ADP with Xsi-Actions-23, CommPilot-23 version > 2022.05_1.303 and NPS version > 2022.08_1.350
-
-
R24:
-
AS patch: AP.as.24.0.944.ap383064
-
ADP with Xsi-Actions-24, CommPilot-24 version > 2022.05_1.303 and NPS version > 2022.08_1.350
-
-
R25:
-
AS RI release Rel_2022.08_1.354
-
ADP with Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 and NPS version > 2022.08_1.350
-
URI Dialing Configuration to support Move Call to Meeting
NS UrlDialing Policy
Define rule for (.*)webex.com to route through I-SBC
NS_CLI/Policy/UrlDialing> get WebexMeetings Policy: UrlDialing Instance: Webex unknownSipURIHandling = reject disableSubscriberLookups = true Enable = true CallTypes: Selection = {ALL} From = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP} lineportOnly = false enableSipURIMatchingRules = true NS_CLI/Policy/UrlDialing/Rules> get WebexMeetings Policy: UrlDialing Instance: WebexCalling Table: Rules id pattern routingNE cost weight dtg =================================================================== 1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NS Routing NE for I-SBC
Example configuration
NS_CLI/System/Device/RoutingNE> get ne WebexMeetings Network Element WebexMeetings Location = 1281465 Data Center = Static Cost = 1 Static Weight = 99 Poll = false OpState = enabled State = OnLine Profile = NIL_PROFILE Remote Lookup Enabled = false Signaling Attributes = NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings Routing NE Address Cost Weight Port Transport Route ===================================================================== WebexMeetings sbc-address 1 99 - unspecified
NS Routing Profile
UrlDialing policy instance added to appropriate routing profile(s)
NS_CLI/Policy/Profile> get profile MyInst Profile: Webex Policy Instance ========================================== … UrlDialing WebexMeetings
AS Use NS Route for NetworkURL call
Enable the AS to honor the NS route in Hybrid AS mode
AS_CLI/Interface/IMS> set queryNSForNetworkURL true
E911 Emergency Calling
Webex for Cisco BroadWorks supports E911 emergency services calling. With this feature, emergency calls get routed to a Public Safety Answering Point (PSAP) who can then direct emergency services to the caller’s location. To use this feature, you must integrate Webex for Cisco BroadWorks with an E911 emergency call provider.
Use the following Webex articles to configure support for E911 emergency calling services:
-
E911 Emergency Calling in Webex for BroadWorks—Use this article to configure E911 emergency calling in Webex for Cisco BroadWorks using one of the following supported E911 providers:
-
Banda
-
Intrado
-
RedSky
-
-
Emergency Call Disclaimer—If you have a location service, you can configure the Emergency Services Disclaimer window on the Webex App to include an option for users to update their location when logging in.
Personalizzazione e provisioning dei client
Users download and install their generic Webex apps, for desktop or mobile (for download links, see Webex App Platforms). Once the user authenticates, the client registers against theWebex Cloud for messaging and meetings, retrieves its branding info, discovers its BroadWorks service info and downloads its calling configuration from BroadWorks Application Server (via DMS on XSP|ADP).
I parametri di chiamata per le app Webex vengono configurare in BroadWorks (normalmente). È possibile configurare branding, messaggistica e parametri della riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Queste due serie di configurazioni possono sovrapporsi, in tal caso la configurazione Webex ha la priorità sulla configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server dell'applicazione BroadWorks
Le app Webex sono configurate con i file DTAF. The clients download a configuration XML file from the Application Server, via the Device Management service on the XSP|ADP.
-
Recuperare i file DTAF richiesti (vedere Profili dispositivo nella sezione Preparazione dell'ambiente).
-
Verificare di disporre dei set di tag giuste in BroadWorks System > alle > tag di gestione dispositivi.
-
Per ciascun client di cui si è in corso il provisioning:
-
Scaricare ed estrarre il file zip DTAF per il particolare client.
-
Import DTAF files to BroadWorks at System > Resources > Identity/Device Profile Types
-
Aprire il profilo del dispositivo appena aggiunto per la modifica e:
-
Enter the XSP|ADP farm FQDN and Device Access Protocol.
-
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per condivisione del desktop per il funzionamento.
È possibile anche abilitare il supporto delle parti remote eseguendo il seguente comando CLI sul server dell'applicazione:AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
-
-
Modificare i modelli in base all'ambiente in uso (vedere la tabella seguente).
-
Salvare il profilo.
-
-
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome |
Descrizione |
Priorità codec |
Configurare l'ordine di priorità per i codec audio e video per VoIP chiamate |
TCP, UDP e TLS |
Configurare i protocolli utilizzati per segnali SIP e multimediali |
Porte audio e video RTP |
Configurare gli intervalli di porte per audio e video RTP |
Opzioni SIP |
Configurare varie opzioni correlate a SIP (INFORMAZIONI SIP, uso di rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e sottoscrizione, ecc.) |
Customize Branding for Webex App
-
Partner customizations—Partner administrators can apply advanced branding customizations that apply to the partner organization and/or customers that the partner manages. See Configure Advanced Branding Customizations.
-
Customer customizations—If the partner allows customers to apply their own Branding customizations, customer administrators can follow the procedures at Add Your Company Branding to Webex.
The User Activation Portal uses the same logo that you add for client Branding.
Personalizzazione della segnalazione dei problemi e degli URL di assistenza
To customize these options, administators can follow the procedure "Add Feedback and Help Site URLs", which can be found in both of the above Branding articles.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con provisioning Flowfluire
You must configure all the XSP|ADP services, and the partner organization in Control Hub, before you can perform this task.
1 |
Assegnazione del servizio in BroadWorks: |
2 |
Verifica l'organizzazione e gli utenti del cliente in Control Hub: |
Test utenti
1 |
Scaricare l'app Webex su due macchine diverse. |
2 |
Accedere come utenti di test sulle due macchine. |
3 |
Effettua chiamate di prova. |
Pre provisioning organizzazioni clienti
Nel modello corrente, viene eseguito automaticamente il provisioning dell'organizzazione del cliente quando si onboard il primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguita una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
-
Usa API per creare account Webex
-
Assegnare i messaggi e-mail integrati IM&P (provisioning flow) con e-mail affidabili per la creazione di account Webex
-
Assegna IM&P integrato (provisioning FLOW) senza messaggi e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per la creazione di account Webex
-
Consenti agli utenti l'attivazione autonoma (inviando loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex sono esposti API pubbliche per consentire ai provider di servizi di integrare Webex per il provisioning del sottoscrittore Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. La specifica per queste API è disponibile developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
Wholesale customers will be rejected by these APIs.
Provisioning Flow
Su BroadWorks, è possibile fornire agli utenti l'opzione Abilita IM integrato&P. Questa azione causa il provisioning dell'adattatore BroadWorks per rendere chiamata API di eseguire il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile retrocompatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica di codice, ma solo una modifica di configurazione all'endpoint API per l'adattatore di provisioning.
La fornitura del sottoscrittore su Webex può richiedere una notevole quantità di tempo (diversi minuti per l'utente iniziale in un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il completamento del provisioning di flusso indica che il provisioning è stato avviato. Non indica il completamento.
Per verificare che gli utenti e l'organizzazione del cliente siano completamente predisposti su Webex, è necessario accedere a Partner Hub e ricercare l'elenco dei clienti.
BroadWorks trunking users can have Webex for BroadWorks via a shared call appearance (SCA). The trunking user will need to have the Authentication service assigned. As described in the BroadWorks Trunking Solution Guide Section 8, this allows the authentication of the SCA Webex appearance to be separate from the common trunk authentication. Webex for BroadWorks cannot be provisioned for trunking users with the Route List or Direct Route features assigned.
Attivazione automatica utente
Per fornire gli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
-
Sign in to Partner Hub, and find the Customer List page.
-
Fare clic su View Templates (Visualizzamodelli).
-
Select the provisioning Onboarding template you want to apply to this user.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non è nel sistema BroadWorks associato a questo modello, l'utente non può attivare automaticamente con il collegamento.
-
Copiare il collegamento per il provisioning e inviarlo all'utente.
È possibile anche includere il collegamento di download del software e ricordare all'utente che deve fornire e convalidare il relativo indirizzo e-mail per attivare l'account Webex.
-
È possibile monitorare lo stato di attivazione dell'utente sul modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi diattivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli nella vista Stato utente che consentono agli amministratori di Cisco BroadWorks provider di servizi di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Spostamento degli utenti Webex in Webex per Cisco BroadWorks
To move existing Webex users to Webex for Cisco BroadWorks, refer to the below table to determine which procedure to follow.
Existing Webex user belongs to a… |
Follow these processes to move the user |
---|---|
Consumer organization or self-signup (e.g., free account, trial account) |
|
Organizzazione cliente |
Attach Webex for BroadWorks to Existing Organization—The organization attachment (for the first user) also adds Webex for BroadWorks to subsequent users, so long as they are assigned to the correct organization. |
Existing Webex user belongs to a… |
Follow these processes to move the user |
---|---|
Consumer organization or self-signup (e.g., free account, trial account) |
If Webex for BroadWorks organization does not exist (no users are provisioned):
If Webex for BroadWorks organization exists (at least one user is provisioned):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Use this procedure to move an existing Webex user who is in a consumer organization or has a self-signup account (free account or trial account) to Webex for Cisco BroadWorks. Note that the Webex for Cisco BroadWorks organization must exist (with the first user provisioned). In this case, you can use one of these options to move users:
-
Move User (with Trusted Email)—Uses provisioning with trusted emails
-
Move User (with Untrusted Email)—Uses provisioning with untrusted emails
-
Attivazione automatica
Sposta utente (con e-mail attendibile)
If the Onboarding template uses Trusted Emails, the partner administrator can move subsequent users with this process:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Activate Account (Attivaaccount). L'utente viene reindirizzato al portale consumer Webex.
-
L'utente accede a Webex.
-
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Sposta utente (con e-mail non attendibile)
If the Onboarding template uses Untrusted Emails, the user’s email address must first be validated. L'amministratore può seguire questo processo per spostare gli utenti successivi:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito automaticamente sul bridge di provisioning BroadWorks.
-
All'utente viene inviato un testo con un collegamento di attivazione.
-
-
L'utente fa clic sul collegamento Attivazione e inserisce il relativo indirizzo e-mail.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Partecipaora.
-
Indirizzo e-mail convalidato.
-
L'utente viene reindirizzato per accedere al portale Webex Consumer.
-
-
L'utente accede a Webex.
-
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Flusso di attivazione automatica
Se l'utente dispone di un account BroadWorks esistente, potrà utilizzare il processo di attivazione automatica per spostare l'account.
-
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
-
L'utente inserisce il relativo indirizzo e-mail.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
Viene inviato un messaggio e-mail automatico all'indirizzo e-mail dell'utente.
-
-
L'utente apre il messaggio e-mail e fa clic sul collegamento Partecipa ora, che convalida l'indirizzo e-mail.
-
CI ha rilevato che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di continuare.
-
L'utente viene reindirizzato per accedere a Webex.
-
-
L'utente accede al portale consumer.
-
L'utente fa clic su Delete Account (Eliminaaccount).
-
L'account Webex precedente viene eliminato.
-
L'utente ha predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
Attach Webex for BroadWorks to Existing Organization
If you are a partner administrator adding Webex for BroadWorks services to an existing Webex customer organization, which is not yet associated with a partner managed BroadWorks enterprise, the customer organization administrator MUST approve administrator access for the provisioning request to succeed.
Organization administrator approval is needed if any of the following are true:
-
The existing customer organization has 100 users or more
-
The organization has a verified email domain
-
The organization domain is claimed
If none of the criteria above are true, then an Automatic Attach may occur.
With Provisioning Admin access, you will have limited visibility in Control Hub to the users in the existing org. It is recommended that you contact the customer admin and request Full Admin access to the org.
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
1 |
L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. For help, see Provision Customer Organizations. Si verifica quanto segue:
Suppose the customer administrator does not receive an email. In that case, the customer administrator can manually add the partner administrator (specified in the template) as the external administrator of the customer org from the Control Hub. Then retry provisioning the user, which will trigger the Webex for Cisco BroadWorks customer provision. |
2 |
With full administrator access, the partner administrator can complete the process of provisioning the customer. You will need to re-attempt the Provisioning of the customer starting from Step 1 above. However, now as an external Full Admin, you should not observe the error 2017. Once the provisioning of calling services is completed, the existing customer org will be visible as a customer underneath the Webex for BroadWorks Partner Org. The attached org’s name will not change to the BroadWorks enterprise name. The name of the attached org will be remain as it was prior to the attach process. |
Conditions of Org Attachment
-
The email address of the first BroadWorks subscriber provisioned must match the email address of an existing user in the targeted customer org. Otherwise, a new customer org will be created.
-
The first user from the existing org who is provisioned for Webex for BroadWorks is not provisioned as an admin user. Settings and entitlements from the existing org are retained.
-
The organization’s existing authentication settings take precedence over what is configured on the Webex for BroadWorks provisioning template. As a result, there is no change to how existing users log in.
-
However, if the existing customer organization has basic branding enabled, after the attach occurs the Partner's Advanced branding settings will take precedence. If the customer wants the basic branding to remain intact, then the partner must configure the customer organization to override branding in the Advanced Branding settings.
-
-
The name of the existing organization will not change.
-
There is no change to the email suppression flag setting in the existing org’s settings. This may affect newly provisioned users. Depending on how the flag is set, new users may or may not receive an email with a code that must be entered in order to complete activation.
-
Restricted Admin Mode (set by the Restricted by Partner Mode toggle) is turned off for the attached org.
-
Make sure to complete the organization attachment process (moving existing users and updating the organization ID), before you provision new users into the Webex for Cisco BroadWorks organization.
-
A BroadWorks enterprise can be associated with one Webex organziation only. You cannot provision subscribers from a single BroadWorks enterprise into separate Webex organizations.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com .
After adding the email from the Onboarding template on Partner Hub as a Full Administrator, any additional partner admins will also need to be added as an external admin with Full Administrator rights.
Detach Webex for BroadWorks from Existing Organization
Follow these steps to detach Webex for BroadWorks from an existing Webex organization. For example, if you attached Webex for BroadWorks to an existing organization by accident and want to remove the attachment.
In Standard flow detaching Webex for BroadWorks from an existing Webex organization (standard flow only) will delete all associated subscriber data and deactivate the customer’s Webex for BroadWorks subscription. Also, you will lose access to the customer organization if this is the only associated subscription. In Hybrid flow the customer subscriptions are not modified.
-
If you don’t have access to the customer settings in Control Hub, have the customer administrator grant you external administrator access by following Approve External Administrator Request.
-
Remove all Webex for BroadWorks workspaces from the organization. Use the Remove a BroadWorks Workspace API.
-
Remove all Webex for BroadWorks subscribers from the organization. Use the Remove a BroadWorks Subscriber API.
-
Remove pending Webex for BroadWorks users from the organization. For example, if users were provisioned via the untrusted email flow, and valid emails have not yet been entered, the users are left in a pending state. Follow Verify User Provisioning with Untrusted Emails to delete the users.
-
Delete the BroadWorks Calling configuration for this customer. Open the customer's Control Hub instance, click Hybrid, under BroadWorks Calling section delete all configurations.
After completing the detachment, if you want to attach Webex for BroadWorks to the customer, follow the provisioning processes to attach to an existing customer.
Manage Users and Organizations
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente vengono tenuti in BroadWorks. Un'identità e-mail distinta per l'utente e relative licenze per le funzioni Webex sono tenute in Webex.
Verifica del provisioning utenti con indirizzi e-mail non attendibili
Se si sta predis facendo il provisioning di Webex per utenti BroadWorks utilizzando il provisioning flow-through con messaggi e-mail non attendibili, gli utenti devono autoproducersi inserendo il proprio indirizzo e-mail nel portale di attivazione utenti. Se l'utente rileva un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riconorà l'errore, l'amministratore può utilizzare la procedura seguente in Partner Hub per esaminare lo stato e onboardre l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 |
Sign in to Partner Hub and find the Customer List page. |
2 |
Fare clic su View Templates (Visualizzamodelli). Select the appropriate Onboarding template you want to apply to this user. |
3 |
In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con messaggi e-mail non attendibili sia configurato correttamente:
|
4 |
Dopo il provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato di provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo Stato corrente, che mostra se l'utente è stato predisposto o se è presente un requisito in sospeso.
|
5 |
Per gli utenti con errori o requisiti in sospeso, fare clic sui tre puntini a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili durante la visualizzazione dell'elenco di utenti:
-
Export—Click this button if you want to export the user list to a CSV file.
-
Exclude provisioned users—Enable this toggle if you want to view only users with pending requirements or errors.
Modifica ID utente o indirizzo e-mail
Modifiche dell'ID utente e dell'indirizzo e-mail
ID e-mail e ID alternativo sono attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. Nella tabella seguente vengono descritti gli scopi di questi diversi attributi e le operazioni da eseguire per modificarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non è possibile modificare questo identificativo e collegare comunque l'utente allo stesso account in Webex. È possibile eliminare l'utente e crearla nuovamente se è errata. |
ID e-mail | ID utente |
Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si asserzione di attendibilità dell'e-mail Non richiesto in BroadWorks se non si asserzione di affidabilità dei messaggi e-mail Non richiesto in BroadWorks se si consente agli abbonati di attivare automaticamente |
Se l'utente è predisposto con l'indirizzo e-mail errato, è necessario effettuare un processo manuale per modificare questa impostazione in entrambi i punti:
Non modificare l'ID utente BroadWorks. Operazione non supportata. |
ID alternativo | Nessuno | Abilita autorizzazione utente, tramite e-mail e password, a fronte dell'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti devono immettere il relativo ID utente BroadWorks durante l'autenticazione. |
Modifica del pacchetto utente nell'hub partner
1 |
Accedere all'hub partner e fare clic su Clienti. |
2 |
Individuare e selezionare l'organizzazione del cliente in cui si trova l'utente. La pagina di panoramica dell'organizzazione viene visualizzata in un pannello a destra dello schermo. |
3 |
Fare clic su View Customer (Visualizzacliente). L'organizzazione del cliente viene aperta in Control Hub, che mostra la pagina Panoramica.
|
4 |
Fare clic suUtenti, quindi individuare e fare clic sull'utente interessato. |
5 |
In Servizi dell'utente, fare clicsu Webex per pacchetti BroadWorks (Sottoscrizioni). Viene visualizzato il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 |
In the Profile tab, look in the Package section and click the arrow (>) to expand the view. |
7 |
Select the package you want for this user (Basic, Standard, Premium or Softphone) and click Save. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 |
È possibile chiudere i dettagli utente e la scheda Control Hub. |
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Webex per API Cisco BroadWorks
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
-
Eseguire la richiesta di rimozione dell'API di un abbonato BroadWorks su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento a Webex per Cisco BroadWorks. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
Eseguire la richiesta DI ELIMINAZIONE DI una persona su per eliminare completamente https://developer.webex.com/docs/api/v1/people/delete-a-person l'utente.
Flow-through Provisioning
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
-
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – PAGINA IM&P integrata su BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte2.
After the service is disabled, flow-through provisioning removes the Webex for Cisco BroadWorks subscription from the user. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori dei clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla relativa organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Delete Organization
1 |
Use the People APIs to delete all users from the organization: The Remove a BroadWorks Subscriber API removes Webex for Cisco BroadWorks entitlements from a user, but does not delete the user. |
2 |
If Directory Sync is turned on, disable it. This can be done via Partner Hub or via the public API. To disable Directory Sync via Partner Hub: To disable Directory Sync via API, use the Update Directory Sync for a BroadWorks Enterprise API and disable the enableDirSync setting. All users related to BroadWorks Directory Sync for this organization will be deleted. Note that the removal of users (using either method) may take some time depending on the quantity of users. |
3 |
After all of the users are removed, use the Delete an Organization API to delete the organization. |
Canceling a Subscription from Control Hub
As the API is private, customers won't have access to it. Instead, the following steps show how customers can cancel their own subscription from Control Hub:
-
The Partner Admin can navigate to the "Hybrid" Services page on the Customer's Control Hub.
-
Locate the "BroadWorks Calling" card.
-
Once all users have been de-provisioned from Webex for BroadWorks for that Customer, the Partner should see a button to "Clear Configuration" (i.e., delete their customer_config entry in BPB).
Release Management
I controlli di gestione delle release in Partner Hub consentono ai provider di servizi Cisco BroadWorks di gestire le release fornendo loro la possibilità di controllare la data di rilascio in base alla quale le app Webex degli utenti ese upgrade all'ultimo software.
By default, the Webex App uses Automatic upgrades (Cisco-controlled monthly releases). However, with this feature, partner administrators can:
-
Configure customized release schedules with deferrals from the Cisco-default release schedule
-
Configure a single release schedule and cascade that schedule to all of the customer organizations that they manage
-
Assign different release schedules to different customer organizations
For more information about Release Management, including information on how to configure and apply customized release schedules, see the Webex article Release Management Customizations.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
-
Aggiunta di un cluster BroadWorks in Hub partner
-
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
-
Add a Onboarding template in Partner Hub
-
Edit or Delete a Onboarding template in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su |
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. |
3 |
Fare clic su View Clusters (Visualizzacluster). |
4 |
Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro a destra.
|
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Edit or Delete a Onboarding template in Partner Hub
You can edit or delete Onboarding templates in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su | |||||||||
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. | |||||||||
3 |
Fare clic su View Templates (Visualizzamodelli). | |||||||||
4 |
Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere Assistente Webex follow-up su attività, prendere nota di importanti decisioni ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant for Meetings is available for free for Premium and Standard package meeting sites and Personal Meeting Rooms. Il supporto include sia i siti nuovi che quelli esistenti.
Enable Webex Assistant for Meetings
Webex Assistant is by default enabled for both Standard and Premium package Broadworks Customers.
Partner Administrators and Customer Organization Administrators can disable the feature for Customer Organizations through Control Hub.
Limiti
The following limitations exist for Webex for Cisco BroadWorks:
-
Support is limited to Premium and Standard package meeting sites and Personal Meeting Rooms only.
-
Closed captioning transcriptions are supported in English, Spanish, French, and German only.
-
Content sharing via email can be accessed only by users within your organization
-
Meeting content is not accessible to users outside your organization. Meeting content is also not accessible when shared between users of different packages from within the same organization.
-
With the Premium package, post-meeting transcriptions are available whether Webex Assistant is enabled or disabled. However, if local recording is selected, post-meeting transcripts or highlights are not captured.
-
With the Standard package, Record meeting on cloud option is not available and so post-meeting transcriptions are not available whether Webex Assistant is enabled or disabled. However, if local recording is selected, even then post-meeting transcripts or highlights are not captured.
Additional Information About Webex Assistant
For user information on how to use the feature, see Use Webex Assistant in Webex Meetings and Events.
Disabilita Webex Calls
Free Webex calling is enabled by default letting users place free calls to any Webex-enabled device. However, if you want all calls to use the BroadWorks infrastructure, you can disable Webex calls within a Onboarding template, which disables that option for the customer organizations that use the template.
Supporto funzioni
When Webex Calling is disabled, the following conditions apply to Webex for Cisco BroadWorks users:
-
Users no longer see Call with Webex as a selectable call option on the Webex App.
-
Users cannot place or receive free Webex calls to non-Webex for Cisco BroadWorks users. This includes calls initiated from a Webex team space, Call History, Contacts, by entering the other user's URI or email address in the Search bar.
-
Screen sharing works within a BroadWorks call.
-
Webex meetings, and telephony presence still work, even if Webex Calls are disabled.
Disable Webex Calls (New Onboarding template)
While configuring a new Onboarding template, you can configure whether Webex calls are enabled or disabled by checking or unchecking the Disable Cisco Webex Free Calling check box within the Add a new template wizard. This setting will be picked up for users in customer organizations that you assign to the template.
For details on configuring a new Onboarding template, see Configure Your Partner Organization in Partner Hub.
Disable Webex Calls (Existing Onboarding template)
Follow this procedure to disable Webex calls from an existing Onboarding template. This will disable the feature for all new users in customer organizations that use this template.
-
Sign in to Partner Hub at admin.webex.com.
-
Choose Settings.
-
Click View Template and choose the appropriate Onboarding template.
-
Click Disable Cisco Webex Free Calling.
-
Fare clic su Salva.
Disable Webex Calls (Existing User)
Disabling this feature on a Onboarding template changes the setting only for new users who are assigned to the template. To disable Webex Calls for an existing user, you can follow one of the below procedures to update the user.
If you are using flow-through provisioning, you can do the following:
-
Open CommPilot and go to the user configuration.
-
Remove the Integrated IM+P service from the user and click OK.
-
Add the Integrated IM+P service to the user and click OK.
Otherwise, you can use the API to update the user.
-
Use the Remove a BroadWorks Subscriber API to delete the user.
-
Use the Provision a BroadWorks Subscriber API to add the user.
Disable Video or Screen Sharing within Calls
Partner administrators can use configuration tags to disable video calls and/or screen sharing within a call from the Webex App (by default, both media types are enabled for calls).
For full configuration details and options, see Disable Video Calls and Disable Screen Sharing in the Webex for Cisco BroadWorks Configuration Guide.
Busy Lamp Field / Call Pickup Notification
Busy Lamp Field (BLF) / Call Pickup Notification leverages the BLF and Directed Call Pickup features. A BLF user receives an audio and visual notification on the Webex App when a user from the BLF monitored list receives an incoming call. The BLF user can Ignore or Pick up the monitored user’s call.
BLF / Call Pickup Notification helps in situations where a user needs to answer calls for other team members who may be working in a different location.
Users can also see their BLF monitored list in the Multi-Call Window - Watchlist section - (Windows only, Mac not supported) to see the presence of their Webex and non-Webex team members. For help with enabling multi-call, see: Multi-Call Window
Webex members will have a full Webex presence. Non-Webex members must be directory synced into Webex, and they will only have "unknown" and "in-a-call" states (ringing state will trigger the call pickup dialog).
Limitations of Presence for Non-Webex users:
-
Presence is not supported for non-CI broadworks users, even if they are in the BLF list.
-
CI users without Webex cloud entitlement or machine type of accounts (workspaces) only show ‘in-call’ and ‘unknown’ presence. There is no active, ringing, etc. status.
-
Non-Webex users from the BLF watch list, who started a call before the Webex client was started or while it was offline will be shown with an ‘unknown’ presence.
-
Losing your connection means all the non-Webex in-call states will be reset to ‘unknown’ upon reconnecting.
-
If a non-Webex user from the BLF holds a call they will continue to be shown as ‘in a call’.
Requisiti
Make sure that the following patches are applied on BroadWorks. Install only the patches that apply to your release:
Per R22:
-
AP.platform.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382362
-
AP.xsp.22.0.1123.ap382053
-
AP.xsp.22.0.1123.ap382362
-
AP.as.22.0.1123.ap383459
-
AP.as.22.0.1123.ap383520
Per R23:
-
AP.platform.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382362
-
AP.as.23.0.1075.ap383459
-
AP.as.23.0.1075.ap383520
-
If you're using XSP|ADP:
-
AP.xsp.23.0.1075.ap382053
-
AP.xsp.23.0.1075.ap382362
-
-
If you're using ADP:
-
Xsi-Actions-23_2022.01_1.200.bwar
-
Xsi-Events-23_2022.01_1.201.bwar (or later)
-
Per R24:
-
AP.as.24.0.944.ap382053
-
AP.as.24.0.944.ap382362
-
AP.as.24.0.944.ap383459
-
AP.as.24.0.944. ap383520
-
Xsi-Actions-24_2022.01_1.200.bwar
-
Xsi-Events-24_2022.01_1.201.bwar (or later)
Make sure that the following configuration tags are enabled on the Webex App:
-
<busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">
-
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
-
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(this tag is optional)
You must activate feature 101642 Enhanced Xsi Mechanism For Team Telephony on the AS:
AS_CLI/System/ActivatableFeature> activate 101642
Enable X-BroadWorks-Remote-Party-Info
on the AS using the below CLI command as some SIP call flows require this feature:
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Make sure that the following services are assigned to users:
-
Assign the Directed Call Pickup service for all users
-
Set up the Busy Lamp Field for users
Configure Busy Lamp Field on BroadWorks
Partner administrators can use the following procedure to set up the Busy Lamp Field for a user.
-
Sign in to BroadWorks CommPilot.
-
For a selected user, go to Client Applications and configure the Busy Lamp Field.
-
Add the URL of the BLF list that will be monitored.
-
Use the search parameters to locate and add users to the Monitored Users list.
-
Fare clic su OK.
Slido Integration Support
Webex for Cisco BroadWorks supports Webex App integration with Slido.
Slido è uno strumento facile da utilizzare per il coinvolgimento del pubblico. Consente alle persone di ottenere il massimo dalle riunioni colmando la differenza tra gli oratori e i partecipanti. Se Slido questa funzione è integrata nell'organizzazione Control Hub, gli utenti possono aggiungere l'app Slido alle relative riunioni nell'app Webex. Questa integrazione aggiunge funzionalità Q&A di sondaggi e di sondaggi aggiuntivi alla riunione.
For additional information on how to deploy and use Slido with the Webex App, see Integrate Slido with Webex App.
Webex Availability: In a Calendar Meeting
When you have accepted a meeting in your Outlook client that is an appointment, ad hoc meeting, or a non-Webex meeting, your Webex availability appears as “In a calendar meeting”. This availability lets your colleagues know that you are otherwise engaged and that a response may be delayed.
Per abilitare questa funzione:
-
navigate to the General tab of your Settings tab on Windows or Preferences on Mac.
-
Check the box to Show when in a calendar meeting.
Caveat
For this feature to work you must have the Webex app and Outlook client running at the same time.
We are currently working to support the ‘Show as Working Elsewhere’ option in Outlook to not show a user as “In a calendar meeting” in Webex.
If a user chooses to disable “Show when in a calendar meeting” while they are currently in a calendar meeting, their presence will not update until the meeting has ended. This will require a client restart to pick up.
Automatic Answer with Tone
With automatic answer with tone, users can make a call from a third-party app, such as Contact Center, and the call is routed automatically through the Webex App on their desktop. When the Webex App rings the other party, the user hears a certain tone, advising them that the call is connecting.
For a Webex for Cisco BroadWorks user to use this feature:
-
The feature is supported on the primary line appearance only
-
The Webex App must be the primary line appearance
-
The %ENABLE_AUTO_ANSWER_WXT% tag must be enabled
If the user also has Shared Call Appearances (for example, a desk phone is configured as one of the secondary line appearances), the feature is still supported on the primary appearance so long as the shared call appearances are configured to not to receive incoming calls. This can be accomplished by configuring either of the following three conditions on BroadWorks for all shared call appearances:
-
Alert all appearances for Click-to-Dial calls is disabled in the Shared Call Appearance configuration—this is the recommended approach
o
-
Allow Termination to this location must be disabled for all shared call appearances or
o
-
Locations are disabled for all shared call appearances
Aumento della capacità
XSP|ADP Farms
We recommend you use the capacity planner to determine how many additional XSP|ADP resources you need for the proposed increase in subscriber numbers. Per uno dei server NPS dedicati o dedicati a Webex per Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
-
Scale dedicated farm: Add one or more XSP|ADP servers to the farm that needs extra capacity. Installare e attivare la stessa serie di applicazioni e configurazioni dei nodi esistenti del sistema.
-
Add dedicated farm: Add a new, dedicated XSP|ADP farm. Sarà necessario creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti sul nuovo registro, per esitare gli utenti a essere presenti nell'hub esistente.
-
Add specialized farm: If you are experiencing bottlenecks for a particular service, you may want to create a separate XSP|ADP farm for that purpose, taking into consideration the co-residency requirements listed in this document. Potrebbe essere necessario riconfigurare i cluster Control Hub e le voci DNS se si modifica l'URL del servizio con un nuovo registro.
In tutti i casi, il monitoraggio e la risorsa dell'ambiente BroadWorks è di responsabilità. Se si desidera coinvolgere l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare servizi professionali.
Gestione dei certificati del server HTTP
You must manage these certificates for mTLS authenticated web applications on your XSP|ADPs:
-
Certificato di catena di fiducia del cloud Webex
-
Your XSP|ADP’s HTTP server interfaces’ certificates
Catena di fiducia
You download the chain of trust certificate from Control Hub and install it on your XSP|ADPs during your initial configuration. Si prevede di aggiornare il certificato prima della scadenza e di notificare come e quando modificarlo.
Interfacce server HTTP
The XSP|ADP must present a publicly signed server certificate to Webex, as described in Order Certificates. Quando si protegge per la prima volta l'interfaccia, viene generato un certificato autofirmato. Questo certificato è valido per un anno a partire da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Restricted by Partner Mode is a Partner Hub setting that partner administrators can assign to specific customer organizations to limit the organization settings that customer administrators can update in Control Hub. When this setting is enabled for a given customer organization, all of that organization's customer administrators, irrespective of their role entitlements, are unable to access a set of restricted controls in Control Hub. Only a partner administrator can update the restricted settings.
Accesso amministratore cliente
Customer administrators receive a notification when Restricted-by-Partner Mode is applied. After login, they will see a notification banner at the top of the screen, immediately under the Control Hub header. The banner notifies the customer administrator that Restricted Mode is enabled and they may not be able to update some calling settings.
For a customer administrator in an organization where Restricted by Partner Mode is enabled, the level of Control Hub access is determined with the following formula:
(Control Hub access) = (Organization Role entitlements) - (Restricted by Partner Mode restrictions)
Customer administrators will face several restrictions, regardless of the Restricted-by-Partner Mode. These restrictions include:
- Call Settings: The 'App Options Call Priority' settings in the Calling menu are read-only.
- Location Setup: Setting up calling after location creation will be hidden.
- PSTN Management and Call Recording: These options will be greyed out for the location.
- Phone Number Management: In the Calling menu, phone number management is disabled, and the 'App Options Call Priority' settings, as well as call recordings, are read-only.
Restrictions
When Restricted-by-Partner Mode is enabled for a customer organization, customer administrators in that organization are restricted from accessing the following Control Hub settings:
-
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
-
Manage Users button is greyed out.
-
Manually Add or Modify Users—No option to add or modify users, either manually or via CSV.
-
Claim Users—not available
-
Auto-assign Licenses—not available
-
Directory Synchronization—Unable to edit directory sync settings (this setting is available to Partner-level admins only).
-
User details—User settings such as First Name, Last Name, Display Name and Primary Email* are editable.
-
Reset Package—No option to reset the package type.
-
Edit Services—No option to edit the services that are enabled for a user (e.g., Messages, Meetings, Calling)
-
View Services status—Unable to see full status of Hybrid Services or Software Upgrade Channel
-
Primary Work Number—This field is read-only.
-
-
Nella vista Account, non sono disponibili le seguenti impostazioni:
-
Company Name is read-only.
-
-
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
-
Domain—Access is read-only.
-
Email—The Suppress Admin Invite Email and Email Locale Selection settings are read-only.
-
Authentication—No option to edit Authentication and SSO settings.
-
-
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
-
Call Settings—The App Options Call Priority settings are read-only.
-
Calling Behavior—Settings are read-only.
-
Location > PSTN—The Local Gateway and Cisco PSTN options are hidden.
-
-
Under SERVICES, the Migrations and Connected UC service options are suppressed.
Abilita limitato dalla modalità partner
Partner administrators can use the below procedure to enable Restricted by Partner Mode for a given customer organization (the default setting is enabled).
-
Sign in to Partner Hub ( https://admin.webex.com) and select Customers.
-
Selezionare l'organizzazione del cliente applicabile.
-
Nella vista delle impostazioni a destra, abilitare l'interruttore Limitato dalla modalità partner per attivare l'impostazione.
Se si desidera disattivare Limitazione della modalità partner, disabilitare l'interruttore.
If the partner removes the restricted administrator mode for a customer administrator, the customer administrator will be able to perform the following:
-
Add Webex for Wholesale users (with the button)
-
Change packages for a user
For more information on list of time zones supported for Wholesale Provisioning, see the List of Time Zones supported for Wholesale Provisioning.
Partner Analytics
I miglioramenti apportati a Control Hub rendono semplice agli amministratori dei partner visualizzare e aggiornare le informazioni del pacchetto per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata tra tutti i clienti e include i seguenti dettagli:
-
Totale utenti per pacchetto (Softphone, Basic, Standard, Premium)
-
Tendenza utenti per pacchetto (giornaliera/settimanale/mensile)
-
Clienti con n. di pacchetti assegnati
Per dettagli completi sull'uso della funzionalità di analisi dei partner, vedere l'articolo Webex Analytics per Webex per i pacchetti Eseeme e Webex per pacchetti Broadworks in Partner Hub.
Billing Report APIs
Webex for Developers provides public APIs that can be used for monthly billing reports. Partner administrators can use these APIs to create, list, get and delete billing reports. The following table lists the APIs, the type of access required and the role requirements.
Billing API |
Scopo |
Type of Access |
Role Requirement for API (Admin requires at least one of these roles) |
---|---|---|---|
Create a BroadWorks Billing Report |
Used to generate a billing report. |
Write access |
|
List BroadWorks Billing Reports |
Used to list the reports that are available to view. |
Read Access |
|
Get a BroadWorks Billing Report |
Used to obtain a copy of a generated report. |
Read Access |
|
Delete a BroadWorks Billing Report |
Used to delete a generated report. |
Write Access |
|
Billing Fields
The following table lists the fields that are contained in the generated report.
Campo |
Descrizione |
---|---|
resellerName |
Partner name or Partner Org Id |
billingId |
Partner Unique Billing Identifier or C-Number |
spEnterpriseId |
The Service Provider-supplied unique identifier for the subscriber's enterprise. |
Interno |
The Customer Internal Trial Status (Yes/No) |
userId |
The userID of the subscriber on BroadWorks |
subscriberId |
A unique identifier for the subscriber in question in Webex |
selfActivated |
Yes/No |
firstStartDate |
Date when subscriber was provisioned. |
billingStartDate |
Date when billing starts in this month |
billingEndDate |
Date when billing ends in this month |
pacchetto |
The package type that is being charged |
quantity |
Prorated quantity for billing.
|
-
Once you generate a billing report for a specific period, you cannot regenerate that report unless you first delete the existing report.
-
If you change either the package type or BroadWorks userID for a given user, the report for the month where the change occurred shows multiple entries for that user with separate prorated entries before and after the change.
Risoluzione dei problemi di Webex per Cisco BroadWorks
Iscrizione alla pagina di stato Webex
Innanzitutto, https://status.webex.com verificare se si verifica un'interruzione imprevista del servizio. Se non è stata modificata la configurazione in Control Hub o BroadWorks prima dell'interruzione, controllare la pagina di stato. Per ulteriori informazioni sulla sottoscrizione per lo stato e le notifiche di incidenti, vedere il Centro di assistenza Webex.
Uso della funzionalità di analisi di Control Hub
Webex tiene traccia dei dati di utilizzo e qualità per la propria organizzazione e per le organizzazioni dei clienti. Ulteriori informazioni sulla funzionalità di analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
I clienti o gli utenti non vengono creati in Control Hub con provisioning flow provisioning:
-
Il server dell'applicazione può raggiungere l'URL di provisioning?
-
L'account di provisioning e la password sono corretti, se esistono in BroadWorks?
I cluster non riescono regolarmente con i test di connettività:
La connessione mTLS al servizio di autenticazione dovrebbe non riuscire quando si crea il primo cluster in Partner Hub poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. Without that, you cannot create a trust anchor on the authentication service XSP|ADPs, so the test mTLS connection from Partner Hub is not successful.
-
Are the XSP|ADP interfaces publicly accessible?
-
Si stanno utilizzando le porte corrette? È possibile inserire una porta nella definizione dell'interfaccia sul cluster.
Convalida interfacce non riuscita
Interfacce Xsi-Actions e Xsi-Events:
- Controllare che gli URL di interfaccia siano immessi correttamente sul cluster in Partner Hub, incluso
/v2.0/
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Esaminare l'avviso di configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Controllare che gli URL di interfaccia siano immessi correttamente sul cluster in Partner Hub, incluso
/v2.0/
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Rivedere i consigli di configurazione dell'interfaccia in questo documento, con particolare attenzione su:
- Make sure you shared RSA keys across all XSP|ADPs.
- Make sure you provided AuthService URL to the web container on all XSP|ADPs.
- Se è stata modificata la configurazione di crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. The XSP|ADP requires that you enter the IANA name format for the TLS ciphers. Una versione precedente di questo documento indicava in modo errato le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
-
If you are using mTLS with Authentication Service, are the Webex client certificates loaded on your XSP|ADP/ADP trust store? L'app (o l'interfaccia) è configurata per richiedere certificati client?
-
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere certificati client?
Problemi del client
Verificare che il client sia connesso a BroadWorks
-
Accedere all'app Webex.
-
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.
-
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici. Viene visualizzato lo stato della SSO è stato eseguito l'accesso.
Se viene visualizzato un altro servizio telefonico, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Ciò significa:
-
Il client ha transverso correttamente i microservizi Webex richiesti.
-
L'utente è stato autenticato correttamente.
-
Il client è stato emesso un token Web JSON a lungo termine dal sistema BroadWorks.
-
Il client ha recuperato il profilo del dispositivo ed è registrato per BroadWorks.
Registri client
Tutti i client app Webex possono inviare log a Webex. Questa è l'opzione migliore per client mobili. È necessario registrare anche l'indirizzo e-mail dell'utente e l'ora approssimativa del problema, se si desidera assistenza dal Tac. For more information, see Where Do I Find Support for Webex?
Se occorre raccogliere manualmente i registri da un PC Windows, si trovano nel seguente modo:
Windows PC: C:\Users\{username}\AppData\Local\CiscoSpark
Mac: /Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS non configurata correttamente
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
-
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
-
Verificare che la catena di certificati Webex sia installata come trust anchor.
-
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e che sia firmato da un'autorità di certificazione attendibile.
Messaggio interruzione licenza
Questo messaggio può essere visualizzato per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'uso della licenza supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
For detailed information on troubleshooting Webex for Cisco BroadWorks, refer to the Webex for Cisco BroadWorks Troubleshooting Guide.
Supporto
Criteri di supporto stato originale
Il provider di servizi è il primo punto di contatto per il supporto clienti finale (enterprise). Inoltrare i problemi che il SP non può risolvere al TAC. Il supporto della versione server BroadWorks segue i criteri della Versione corrente e delle due precedenti versioni principali (N-2). Read more at BroadSoft products lifecycle policy section in BroadSoft Lifecycle Policy and BroadWorks Software Compatibility Matrix.
Criteri di escalation
-
L'utente (provider di servizi/partner) è il primo punto di contatto per il supporto dei clienti finali (enterprise).
-
I problemi che non possono essere risolti dal SP vengono inoltrati al TAC.
Versioni BroadWorks
-
Il supporto della versione server BroadWorks segue i criteri di BroadSoft, della versione corrente e delle due versioni principali precedenti (N-2). Read more at BroadSoft products lifecycle policy section in BroadSoft Lifecycle Policy and BroadWorks Software Compatibility Matrix.
Risorse di self-support
-
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, in cui è disponibile una pagina specifica di Webex per Cisco BroadWorks che elenca la Guida per l'app Webex comune e gli argomenti di supporto.
-
È possibile personalizzare l'app Webex con questo URL della Guida e un URL per la segnalazione di problemi.
-
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I log vengono nel cloud Webex, dove possono essere analizzati da Webex DevOps.
-
È disponibile anche una pagina del Centro assistenza dedicata alla guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccolta delle informazioni per l'invio di una richiesta di assistenza
Quando si visualizzano errori in Control Hub, è possibile che siano state allegati informazioni che consentono al Tac di ricercare la causa del problema. Ad esempio, se viene visualizzato un ID di verifica per un determinato errore o un codice di errore, salvare il testo da condividere con noi.
Provare a includere almeno le seguenti informazioni quando si invia una query o si apre un caso:
-
ID organizzazione cliente e ID organizzazione partner (ciascun ID è una stringa di 32 cifre esadecimali, separate da trattini)
-
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce una
-
Indirizzo e-mail utente (se si verificano problemi con un determinato utente)
-
Versioni del client (se il problema presenta sintomi notati attraverso il client)
Confronto DI UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > |
UC-One SaaS |
Webex per Cisco BroadWorks |
---|---|---|
Cloud |
Cisco UC-One Cloud (GCP) |
Cloud Webex (APPLICAZIONI WEBEX) |
Client |
UC-One: Mobile, Desktop Receptionist, Supervisore |
Webex: Mobile, Desktop, Web |
Principale differenza tecnologia |
Riunioni consegnate su Broadsoft Meet Technology |
Riunioni consegnate su Webex Meetings Technology |
Versioni di prova sul campo iniziali |
Ambiente di gestione temporanea, client Beta |
Ambiente di produzione, client GA |
Identità utente |
BroadWorks ID utilizzato come ID principale, a meno che provider di servizi sito non SSO già.
ID utente e segreto in BroadWorks |
ID e-mail in Cisco CI serve come ID principale SSO integrazioni in provider di servizi BroadWorks in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks in quel momento.
L'utente fornisce le credenziali tramite SSO broadworks e secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e autenticazione nel provider di identità |
Autenticazione client |
Gli utenti forniscono le credenziali tramite il client Token a lungo accesso BroadWorks richiesti se si utilizza la messaggistica Webex |
Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso e aggiornamento dei token Webex |
Gestione/configurazione |
I sistemi ANDR E BSS e Portale rivenditore |
SISTEMI CUI/BSS e Control Hub |
Attivazione partner/provider di servizi partner |
Una sola impostazione per Cisco Operations |
Una sola impostazione per Cisco Operations |
Attivazione cliente/aziendale |
Portale rivenditore |
Control Hub Creazione automatica alla prima iscrizione utente |
Opzioni di attivazione utente |
Auto iscrizione Impostazione di IM&P esterno in BroadWorks
|
Impostazione di Integrated IM&P in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP |
Azioni XSI
Eventi XSI CTI (mTLS) AuthService (mTLS opzionale) DMS |
Azioni XSI Azioni XSI (mTLS) Eventi XSI CTI (mTLS) AuthService (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 |
Scaricare e installare Webex. Per dettagli, vedere Webex | Download dell'app. |
2 |
Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 |
Inserire il proprio indirizzo e-mail e fare clic su Next(Avanti). |
4 |
In base alla configurazione dell'organizzazione in Webex, si verificano le seguenti operazioni: Webex viene caricato dopo aver eseguito correttamente l'autenticazione per IdP o BroadWorks.
|
Scambio dati e storage
Queste sezioni forniscono dettagli sullo scambio di dati e sullo storage con Webex. Tutti i dati sono crittografati sia in viaggio che a riposo. Per ulteriori dettagli, vedere Sicurezza app Webex.
provider di servizi ilboarding
Quando si configurano cluster e modelli utente in Webex Control Hub durante provider di servizi onboarding, si scambiano i seguenti dati BroadWorks memorizzati da Webex:
-
URL azioni Xsi
-
Xsi-Events URL
-
URL interfaccia CTI
-
URL servizio di autenticazione
-
Credenziali dell'adattatore provisioning BroadWorks
provider di servizi provisioning utente
Questa tabella elenca i dati utente ed aziendale s scambiati come parte del provisioning degli utenti attraverso le API Webex.
Trasferimento dati a Webex |
Da |
Attraverso |
Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito da SP) |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito dall'utente) |
Utente |
Portale di attivazione utente |
Sì |
Nome |
BroadWorks, per API |
API Webex |
Sì |
Cognome |
BroadWorks, per API |
API Webex |
Sì |
Numero di telefono principale |
BroadWorks, per API |
API Webex |
Sì |
Numero telefono cellulare |
BroadWorks, per API |
API Webex |
Sì |
Estensione principale |
BroadWorks, per API |
API Webex |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
BroadWorks, per API |
API Webex |
Sì |
Lingua |
BroadWorks, per API |
API Webex |
Sì |
Fuso orario |
BroadWorks, per API |
API Webex |
Sì |
Rimozione utente
Webex per api Cisco BroadWorks supporta la rimozione parziale e completa degli utenti. Questa tabella elenca tutti i dati utente archiviati durante il provisioning e ciò che viene eliminato in ciascuno scenario.
Dati utente |
Eliminazione parziale |
Eliminazione completa |
---|---|---|
ID utente BroadWorks |
Sì |
Sì |
|
No |
Sì |
Nome |
No |
Sì |
Cognome |
No |
Sì |
Numero di telefono principale |
Sì |
Sì |
Numero telefono cellulare |
Sì |
Sì |
Estensione |
Sì |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
Sì |
Sì |
LANGUAGE |
No |
Sì |
Recupero accesso utente e configurazione
Autenticazione Webex
L'autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da uno qualsiasi dei meccanismi di autenticazione del supporto Webex. ( l'autenticazione BroadWorks è trattata separatamente) Questa tabella illustra il tipo di dati scambiati tra i diversi componenti sul flusso di autenticazione.
Spostamento dei dati |
Da |
a |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (indipendente) |
Webex |
Browser utente |
Credenziali utente |
Browser utente |
Provider di identità (che dispone già di identità utente) |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Autenticazione BroadWorks
L'autenticazione BroadWorks si riferisce all'accesso dell'utente a un'app Webex utilizzando le credenziali BroadWorks. Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti del flusso di autenticazione.
Spostamento dei dati |
Da |
a |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (proxy IdP Webex Bwks) |
Webex |
Browser utente |
Informazioni sul branding e URL BroadWorks |
Webex |
Browser utente |
Credenziali utente BroadWorks |
Utente attraverso il browser (pagina di accesso con branded servita da Webex) |
Webex |
Credenziali utente BroadWorks |
Webex |
BroadWorks |
File BroadWorks profilo utente |
BroadWorks |
Webex |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento dell'avviso di accesso e del messaggio di errore:
- Attualmente gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso poiché la password è già scaduta. Con questa funzione, se la password sta per scadere tra 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere, con l'indicazione di quanti giorni rimangono, e all'utente viene consigliato di contattare il partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su true, è stato emesso l'errore "nome utente e password errati", ma ora con questa funzione viene migliorato il messaggio di errore: Tentativo di accesso non riuscito. La combinazione di ID utente e password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprovare o contattare l'amministratore per aggiornare la password. Codice errore 100006
Controllo flusso di accesso:
- Il partner può limitare l'accesso abilitando un'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, quindi viene visualizzato un errore che indica che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso può essere configurato dal partner come parte della funzione di personalizzazione avanzata. I partner solitamente configurano il collegamento per passare dall'utente a un portale partner per la gestione della password e la reimpostazione della password.
Questa funzione migliora l'esperienza di accesso dell'utente solo durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se una password scade mentre l'utente è connesso all'app Webex. L'utente riceve la notifica di scadenza della password al successivo tentativo di accesso.
Recupero configurazione client
Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti nel recupero delle configurazioni del client.
Spostamento dei dati |
Da |
a |
---|---|---|
Iscrizione |
Client |
Webex |
Impostazioni dell'organizzazione, inclusi gli URL BroadWorks |
Webex |
Client |
Token BroadWorks JWORKS |
BroadWorks attraverso Webex |
Client |
Token BroadWorks JWORKS |
Client |
BroadWorks |
Token dispositivo |
BroadWorks |
Client |
Token dispositivo |
Client |
BroadWorks |
File di configurazione |
BroadWorks |
Client |
Utilizzo stato originale
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione in seguito alla scadenza del token attraverso BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Spostamento dei dati |
Da |
a |
---|---|---|
Segnalazione SIP |
Client |
BroadWorks |
Contenuto multimediale SRTP |
Client |
BroadWorks |
Segnalazione SIP |
BroadWorks |
Client |
Contenuto multimediale SRTP |
BroadWorks |
Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Spostamento dei dati |
Da |
a |
---|---|---|
Messaggistica e presenza HTTPS REST |
Client |
Webex |
Messaggistica e presenza HTTPS REST |
Webex |
Client |
Segnalazione SIP |
Client |
Webex |
Contenuto multimediale SRTP |
Client |
Webex |
Segnalazione SIP |
Webex |
Client |
Contenuto multimediale SRTP |
Webex |
Client |
Uso dell'API di provisioning
Accesso sviluppatore
La specifica API è disponibile su https://developer.webex.com e una guida all'uso è su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l'accesso per leggere la specifica API su https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Autenticazione e autorizzazione dell'applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (come il provisioning del sottoscrittore) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere i token di aggiornamento e di accesso per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
È necessario prima registrare l'integrazione con Webex. Una volta registrata, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di aggiornamento e accesso necessari.
Per ulteriori informazioni sulle integrazioni e su come creare questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli richiesti per l'implementazione delle integrazioni, lo sviluppatore e l'utente che ha autorizzato, e possono essere tenute da persone/team separati nel proprio ambiente.
-
Lo sviluppatore crea l'app e la registra su per generare il ClientID/Secret OAuth richiesto con gli ambito previsti per https://developer.webex.com l'applicazione. Se l'applicazione è stata creata da terze parti, potrebbe registrare l'applicazione (se è stato richiesto l'accesso) o è possibile farlo con il proprio accesso.
-
L'utente autorizzato è l'account che l'applicazione utilizza per autorizzare le chiamate API, per modificare l'organizzazione partner, le organizzazioni dei clienti o i relativi abbonati. Questo account deve avere il ruolo di amministratore completo o amministratore completo di vendite nell'organizzazione partner. Questo account non deve essere mantenuto da terze parti.
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning utilizzata:
-
Modalità Enterprise: il nome dell'organizzazione corrisponde esattamente a spEnterpriseId.
-
Modalità provider di servizi: il nome dell'organizzazione è la parte groupID di spEnterpriseId.
Il nome dell'organizzazione conterrà gli spazi vuoti, i maiuscoli e i caratteri speciali specificati in spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "attuale" con le ultime patch BroadWorks e le app Release Independent (RI). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Versione R22
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione | ||
Richiesto per sincronizzazione rubrica | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per il server applicazioni | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per la funzione di registrazione chiamata | ||
Patch richiesta per il provisioning flow-through | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Server dei profili | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
XSP|ADP |
Richiesto per proxy autenticazione NPS | |
Richiesto per il servizio di autenticazione con convalida token CI | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Obbligatorio per la cronologia chiamate unificata | ||
Altro |
AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione |
Richiesto per sincronizzazione rubrica | |
Configurazione server app | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Server dei profili | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
XSP|ADP | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Altro |
Se si utilizza ADP... |
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate |
Versione R24
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione |
Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per il provisioning flowthrough | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Altro |
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che è necessario configurare per Webex, fare riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utenti e flussi di attivazione
Provisioning descrive l'aggiunta dell'utente a Webex. L'attivazione include la convalida e-mail e l'assegnazione del servizio in Webex.
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se si dispone di indirizzi e-mail attendibili per gli utenti, è possibile scegliere di attivarli automaticamente quando vengono predisposti automaticamente. Questo processo è di "provisioning automatico e attivazione automatica".
Provisioning utenti automatizzato e attivazione automatica (flusso e-mail attendibile)
Prerequisiti
-
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
-
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
-
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase |
Descrizione |
---|---|
1 |
Si preventiva ed si eserviranno gli ordini per il servizio con i clienti. |
2 |
L'ordine del cliente viene processato ed è stato predisposto il cliente nel sistema. |
3 |
Il sistema di provisioning del servizio attiva il provisioning di BroadWorks. Questa operazione, in riepilogo, crea l'azienda e gli utenti. Quindi, assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM esterno. |
4 |
Questa operazione di provisioning attiva il provisioning automatico dell'organizzazione e degli utenti del cliente in Webex. (L'assegnazione del servizio IM&P causa la chiamata dell'adattatore di provisioning all'API di provisioning Webex). |
5 |
I sistemi devono utilizzare l'API di provisioning Webex se in seguito occorre regolare il pacchetto per l'utente (per effettuare una modifica rispetto al valore predefinito). |
SSO di accesso
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, consentendo l'autenticazione diretta a BroadWorks. L'immagine visualizza gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresentano ciò che il client fornisce per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizi BroadWorks che segue immediatamente dal flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione diretta BroadWorks abilitata (condivisione risorse multi-origine). Di seguito sono riportati alcuni flussi di SSO SAML alternativi:
-
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
-
L'unica differenza è nel punto 5 e 6 del flusso di accesso Webex. Nel punto 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
-
Il flusso procede attraverso le operazioni restanti nei due diagrammi.
-
Il SSO di registrazione non è utilizzato in questo flusso.
-
-
Autenticazione Webex SSO SAML:
-
Al punto 3 del flusso di accesso Webex, il servizio Common Identity servizi restituisce il provider di identità utilizzato dall'autenticazione Webex.
-
A questo punto, viene richiamato un flusso di SSO SAML alternativo per Webex.
-
Interazioni utente
Accedi
-
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
-
CI rileva che l'organizzazione cliente associata ha il proxy IDP BroadWorks configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso. (Il provider di servizi può contrassegnare questa pagina di accesso).
-
L'utente inserisce le proprie credenziali BroadWorks.
-
Broadworks autentica l'utente attraverso l'IDP. In caso positivo, IDP reindirizza il browser a CI con un SISTEMA SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
-
In caso di autenticazione eseguita correttamente, l'app Webex ottiene i token di accesso da CI (non mostrato nel diagramma). Il client le utilizza per richiedere un token JNTASSI (Jason Web Token) BroadWorks.
-
L'app Webex rileva la configurazione di chiamata da BroadWorks e da altri servizi di Webex.
-
L'app Webex si registra con BroadWorks.
Accesso dal punto di vista dell'utente
Questo diagramma è il flusso di accesso tipico, visualizzato dall'utente finale o dall'abbonato:
-
L'app Webex viene scaricata e installata.
-
È possibile che sia stato ricevuto il collegamento dal proprio provider di servizi oppure il download potrebbe essere trovato sulla pagina di download di Webex.
-
L'indirizzo e-mail viene inserito nella schermata di accesso di Webex. Fare clic su Avanti.
-
Solitamente, si viene reindirizzati a una provider di servizi a cui viene visualizzata una pagina con marchio.
-
Questa pagina potrebbe dare il benvenuto mediante il proprio indirizzo e-mail.
Se non si dispone di un indirizzo e-mail o se l'indirizzo e-mail è errato, inserire l'indirizzo nome utente BroadWorks.
-
Inserire la password BroadWorks.
-
Se è stato eseguito correttamente l'accesso, Webex si apre.
flusso chiamata: rubrica aziendale
flusso chiamata—PSTN cliente
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni client
Recupera profilo da REGISTRAZIONE DMS e SIP con AS
-
Il client chiama XSI per ottenere un token di gestione dispositivi e l'URL sul DMS.
-
Il client richiede il profilo del dispositivo dal DMS presentando il token dal punto 1.
-
Il client legge il profilo del dispositivo e recupera le credenziali SIP, gli indirizzi e le porte.
-
Il client invia un SIP REGISTER al controller SBC utilizzando le informazioni del punto 3.
-
SBC invia il SIP REGISTER ad AS (il controller SBC può eseguire una ricerca in NS per individuare un AS se SBC non conosce già l'utente SIP).
Linee guida di test e laboratorio
Le seguenti linee guida si applicano a organizzazioni di test e laboratorio:
-
provider di servizi partner sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
-
La fatturazione verrà addebitata a qualsiasi utente oltre i primi 50 utenti di prova.
-
Per assicurare un'elaborazione precisa della fattura, tutte le organizzazioni di test devono includere 'test' nel nome dell'organizzazione BroadWorks.
-
Le organizzazioni di test interne devono essere designate all'interno Webex Control Hub. Al fine di evitare che gli utenti di prova vengano fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di test:
-
Accedere all'hub partner e selezionare Clienti.
-
Selezionare il cliente appropriato.
-
Nella barra di controllo a destra, abilitare l'interruttore Organizzazione test interna.
Riproduzione segreteria telefonica
Per la segreteria telefonica, accertarsi di configurare il server multimediale per l'uso di uno dei seguenti codici:
-
mp3
-
wav— I file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android)
Se si utilizzano file wav, eseguire i seguenti comandi CLI per verificare il server dell'applicazione e server multimediale:
-
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
-
MS_CLI/Applications/MediaStreaming/Services/IVR> impostare sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACL
- Elenco di controllo accessi
- ALG
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APNS
- Utenti Apple servizio di notifica push
- AS
- Server applicazione
- ATA
- Adattatore telefono analogico, adattatore per la conversione della telefonia analogica VoIP
- BAM
- Gestione applicazioni BroadSoft
- Autenticazione di base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- BMS
- Server di messaggistica BroadSoft
- BOSH
- Flussi bidirezionale su HTTP sincrono
- BRI
- L'interfaccia BRI (Basic Rate Interface) è un metodo di accesso ISDN
- Bundle
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico di telefonia (cf. partner, provider di servizi, rivenditore aggiunto valore)
- CAPTCHA
- Test del turing pubblico completamente automatizzato per incisire sui computer e sull'humans apart
- CODICE CCXML
- Controllo chiamata EXtensible Markup Language
- CIF
- Formato intermedio comune
- CLI
- Interfaccia della riga di comando
- CN
- Nome comune
- CSP
- Server push notifiche chiamate. Un server push notifiche che viene eseguito su un ADP XSP| nel proprio ambiente per eseguire notifiche di chiamata push su FCM e APNS. Vedere Proxy NPS.
- CPE
- Apparecchiatura locale del cliente
- CPR
- Regola di presenza personalizzata
- CSS
- Foglio di stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione di telefonia su computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- Non disturbare
- Non disturbare
- DNS
- Sistema di nomi di dominio
- DPG
- Chiama gruppo peer
- DSCP
- Punto codici servizi differenziati
- DTAF
- File di archivio del tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza dual-tone
- Utente finale
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. per l'abbonato)
- Aziendale
- Un gruppo di utenti finali (cf. organizzazione)
- FCM
- Messaggistica cloud Firebase
- FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creazione di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning flow-through completo
- Creazione e verifica di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks e l'asserzione che ciascun utente BroadWorks ha un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. Il plug-on del telefono o del fax o i plug-in sul sistema telefonico analogico. Fornisce un'indicazione di hook/off-hook (chiusura loop). Poiché la porta BLUETOOTH è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo BLUETOOTH".
- FXS
- Foreign Exchange Subscriber è la porta che consegna effettivamente la linea analogica al sottoscrittore. In altre parole, è il plug-in alla parete che offre un segnale di chiamata, una corrente a batteria e una suoneria.
- GCM
- Messaggio Google Cloud
- GCM
- Modalità Galois/Counter Mode (tecnologia di crittografia)
- NASCOSTO
- Dispositivo interfaccia utente
- HTTPS
- Protocollo di trasferimento ipertestuale socket sicuri
- IAD
- Dispositivo di accesso integrato
- IM&P
- Messaggistica immediata e presenza
- IP PSTN
- Un provider di servizi che fornisce VoIP servizi PSTN, intercambiabili con ITSP, o un termine generale per la telefonia 'pubblica' collegata da Internet, collettivamente fornito dai principali fornitori di telecomunicazioni (anziché tramite paesi, come PSTN è)
- ITSP
- Servizi di telefonia Internet provider di servizi
- IVR
- Risposta vocale interattiva/Risponditore
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificatore Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notifica oggetto Java Script
- JSSE
- Estensione socket sicura Java; la tecnologia sottostante che fornisce funzioni di connettività sicura ai server BroadWorks
- KEM
- Modulo di estensione chiave (telefoni Cisco hardware)
- LLT
- Token lungo(o long life); una forma di auto-descrizione, sicura di token di connessione che consente agli utenti di rimanere autenticati per più tempo e non è legata a applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIB
- Base informazioni di gestione
- MS
- Server multimediale
- Mtls
- Autenticazione reciproca tra due parti, mediante lo scambio di certificati, quando si stabilisce una connessione TLS
- MUC
- Chat multi-utente
- NAZ
- Traduzioni indirizzi di rete
- NPS
- Server push di notifica; vedere CNPS
- NPS Proxy
-
Servizio in Webex che fornisce token di autorizzazione breve al CNPS, abilitando il push delle notifiche di chiamata su FCM e APNs e, infine, sui dispositivi Android e iOS che eseguono Webex.
- OCI
- Apri interfaccia client
- Organizzazione
- Una società o un'organizzazione che rappresenta un gruppo di utenti finali (cf. Enterprise)
- OTG
- Gruppo trunk in uscita
- Pacchetto
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. Bundle)
- Partner
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. Valore aggiunto rivenditore, provider di servizi, vettore)
- PBX
- Exchange su succursale privato
- PEM
- Messaggio e-mail avanzato sulla privacy
- PLMN
- Rete mobile su rete pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia di telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- PS
- Server dei profili
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Un sito Web che consente all'amministratore del rivenditore di configurare la propria soluzione UC-One SaaS. Talvolta è noto come portale BANG, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Controllo bordo sessione
- SCA
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; Un'organizzazione che fornisce servizi telefonici o correlati ad altre organizzazioni (cf. Gestore telefonico, partner, rivenditore aggiunto valore)
- SIP
- SIP (Session Initiation Protocol)
- SLT
- Token breve (o breve durata) (denominato anche token SSO BroadWorks); un token autenticato a uso singolo utilizzato per ottenere l'accesso protetto alle applicazioni Web.
- SMB
- Piccola e media azienda
- SNMP
- Semplice protocollo di gestione della rete
- sRTCP
- protocollo Secure Realtime Transfer Control Protocol (VoIP multimediale per chiamate in tempo reale)
- sRTP
- protocollo Secure Realtime Transfer Protocol (VoIP multimediale di chiamata)
- SSL
- Livello socket sicuri
- Abbonato
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. Utente finale)
- TCP
- Protocollo di controllo trasmissione
- TDM
- Multiplexing divisione temporale
- TLS
- Sicurezza livello di trasporto
- Tos
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Unified Communications
- UI
- Interfaccia utente
- UID
- Identificativo univoco
- UMS
- Server di messaggistica
- URI
- Uniform Resource Identifier
- URL
- Localizzatore risorse uniforme
- USS
- Server di condivisione
- UTC
- Ora universale universale
- UV
- Video Server
- Rivenditore aggiunto valore (VAR)
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. vettore, partner, provider di servizi)
- VGA
- Array di elementi grafici video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Voice Extensible Markup Language
- Webdav
- Creazione e versione per Web distributed authoring
- WebRTC
- Comunicazioni in tempo reale Web
- WRS
- WebRTC Server
- XMPP
- Protocollo di messaggistica e presenza Estendi
Configurazione dei servizi (con mTLS per il servizio di autenticazione)
The below procedures replace the procedures in the topic Configure Services on Your Webex for Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida di token CI. These procedures are mandatory if you are running multiple Webex organizations off the same XSP|ADP server. Altrimenti, sono opzionali.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi connettori Cisco BroadWorks.
Only one instance of the Xsi-Events applications should be deployed on the XSP|ADP used for the CTI interface.
All Xsi-Events used for integrating Broadworks with Webex must have the same callControlApplicationName defined under Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
When a user is onboarded to Webex, Webex creates a subscription for the user on the AS in order to receive telephony events for presence and call history. The subscription is associated with the callControlApplicationName and the AS uses it to know to which Xsi-Events to send the telephony events.
Changing the callControlApplicationName, or not having the same name on all Xsi-Events webapps will impact subscriptions and telephony events functionality.
Configurazione del servizio di autenticazione (con mTLS)
BroadWorks long-lived tokens are generated and validated by the authentication service hosted on your XSP|ADPs.
Requisiti
-
The XSP|ADP servers hosting the Authentication Service must have an mTLS interface configured.
-
XSP|ADPs must share the same keys for encrypting/decrypting BroadWorks long lived tokens. Copying these keys to each XSP|ADP is a manual process.
-
XSP|ADPs must be synchronized with NTP.
Panoramica sulla configurazione
The essential configuration on your XSP|ADPs includes:
-
Distribuire il servizio di autenticazione.
-
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
-
Generate and share RSA keys across XSP|ADPs.
-
Fornire l'URL authService al contenitore Web.
Deploy the Authentication Service on XSP|ADP
On each XSP|ADP used with Webex:
-
Attivare l'applicazione del servizio di autenticazione sul
percorso /authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> activate application authenticationService <version> /authService
(where
<version>
is your BroadWorks version). -
Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
deploy application /authService
Configurazione della durata del token
-
Controllare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
-
Impostare la durata su 60 giorni (il massimo è 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
set tokenDurationInHours 1440
Genera e condividi chiavi RSA
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittografia di token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
Because of these two factors you need to generate keys on one XSP|ADP then copy them to all other XSP|ADPs.
If you cycle keys or change the key length, you need to repeat the following configuration and restart all the XSP|ADPs.
-
Select one XSP|ADP to use for generating a key pair.
-
Use a client to request an encrypted token from that XSP|ADP, by requesting the following URL from the client’s browser:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(This generates a private / public key pair on the XSP|ADP, if there wasn’t one already)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
-
Copy the exported file
/var/broadworks/tmp/authService.keys
to the same location on the other XSP|ADPs, overwriting an older.keys
file if necessary. -
Import the keys on each of the other XSP|ADPs:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al container Web
The XSP|ADP’s web container needs the authService URL so it can validate tokens.
On each of the XSP|ADPs:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per lo strumento di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Controllare il parametro con
get
. -
Restart the XSP|ADP.
Configurazione di TLS e della crittografia sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurazione TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > trasporto > http > interfaccia Server HTTP = Più specifico
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Reading HTTP Server TLS Interface Configuration on the XSP|ADP
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il
comando get e leggere i
risultati. Dovrebbero essere presenti le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Tomcat obbligatorio un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
È necessario configurare l'interfaccia HTTP che interagisce con Webex Cloud per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Enter the command
get <interfaceIp> 443
to see which protocols are already used on this interface. -
Enter the command
add <interfaceIp> 443 TLSv1.2
to ensure that interface can use TLS 1.2 when communicating with the cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia del server HTTP
Per configurare i crittografia richiesti:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Enter the command
get <interfaceIp> 443
to see which ciphers are already used on this interface. There must be at least one from the Cisco recommended suites (see XSP|ADP Identity and Security Requirements in the Overview section). -
Enter the command
add <interfaceIp> 443 <cipherName>
to add a cipher to the HTTP Server interface.The XSP|ADP CLI requires the IANA standard cipher suite name, not the openSSL cipher suite name. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
del server HTTP, utilizzare:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità del servizio di autenticazione (con mTLS)
-
Accedere a Control Hub con l'account dell'amministratore del partner.
-
Go to Download Webex CA Certificate to get
and clickCombinedCertChain2023.txt
on your local computer.These files contain two sets of two certificates. You need to split the files before you upload them to the XSP|ADPs. All files are required. -
Split the certificate chain into two certificates -
combinedcertchain2023.txt
.-
Open
combinedcertchain2023.txt
in a text editor. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e -----END CERTIFICATE----- , e incollare il blocco di testo in un nuovo
file. -
Save the new file as
root2023.txt
. -
Save the original file as
issuing2023.txt
. Il file originale ora deve contenere solo un blocco di testo, racchiuso tra lerighe -----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copy both text files to a temporary location on the XSP|ADP you are securing, e.g.
/var/broadworks/tmp/root2023.txt
and/var/broadworks/tmp/issuing2023.txt
. -
Sign in to the XSP|ADP and navigate to
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Optional) Run helpUpdateTrust
to see the parameters and command format. -
Upload the certificate files to new trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
All aliases must have a different name.
webexclientroot
,webexclientroot2023
,webexclientissuing
, andwebexclientissuing2023
are example aliases for the trust anchors; you can use your own as long as all four entries are unique. -
Confermare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
The way you enable mTLS for your application depends on the applications you are hosting on the XSP|ADP. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, mTLS è richiesto per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
-
Sign in to the XSP|ADP whose interface you're configuring.
-
Navigate to
XSP|ADP_CLI/Interface/Http/HttpServer>
and run theget
command to see the interfaces. -
Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che corrisponde a mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> add IPAddress Port Name true true
See the XSP|ADP CLI documentation for detail. Essenzialmente, la prima true protegge l'interfaccia con TLS (il certificato server viene creato se richiesto) e la seconda forza true l'interfaccia a richiedere l'autenticazione del certificato
client
(insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Interface Port Name Secure Client Auth Req Cluster Fqdn ======================================================= 192.0.2.7 443 XSP|ADP01.collab.example.net true false 192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (Client Auth Req = true) è abilitato sulla porta 192.0.2.7
444.
TLS è abilitato sulla porta 192.0.2.7
443.
(Opzione) Configurare mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
The way you enable mTLS for your application depends on the applications you are hosting on the XSP|ADP. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, mTLS è richiesto per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
-
Sign in to the XSP|ADP whose interface you're configuring.
-
Navigate to
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
and run theget
command to see which applications are running. -
Per aggiungere un'applicazione e richiedere l'autenticazione del client (che significa lo stesso di mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add IPAddress Port ApplicationName true
See the XSP|ADP CLI documentation for detail. I nomi delle applicazioni sono elencati in questo elenco. Vero
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> add 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService alla versione 192.0.2.7:443 e richiede che a tale applicazione sia richiesta e autenticata dal client.
Controlla con ottieni
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> get
Interfaccia Porta IP Nome applicazione Client Autenticazione ======================================================
192.0.2.7 443 AuthenticationService true
Configure Device Management on XSP|ADP, Application Server, and Profile Server
Profile Server and XSP|ADP are mandatory for Device Management. Tali impostazioni devono essere configurate in base alle istruzioni nella Guida alla configurazione di Gestione dispositivi BroadWorks.
Dove andare avanti
For configuration, you can rejoin the main document flow at CTI Interface and Related Configuration.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca con AuthService
Webex interagisce con il servizio di autenticazione su (autenticazione) TLS reciproca connessione autenticata. This means Webex presents a client certificate and the XSP|ADP must validate it. In order to trust this certificate, use the Webex CA certificate chain to create a trust anchor on XSP|ADP (or proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
-
Andare a Impostazioni > Chiamata BroadWorks.
-
Fare clic sul collegamento per il download del certificato.
È possibile ottenere la catena di certificati anche da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt.
The exact requirements for deploying this Webex CA certificate chain depends on how your public facing XSP|ADPs are deployed:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Directly to the XSP|ADP
Il diagramma seguente riepiloga i punti in cui la catena di certificati CA Webex deve essere distribuita in questi tre casi.
Requisiti del certificato TLS reciproca per il proxy con bridge TLS
-
Webex presenta un certificato client firmato dall'autorità di certificazione Webex nel proxy.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità del proxy, pertanto il proxy considera attendibile il certificato client.
-
The publicly signed XSP|ADP server certificate is also loaded into the proxy.
-
Il proxy presenta un certificato server firmato pubblicamente con Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
The proxy presents an internally signed client certificate to the XSP|ADPs.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3:
Uso chiave estesa X509v3:
1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. Internal server certificates for the XSP|ADP can be SAN.
-
The XSP|ADPs trust the internal CA.
-
The XSP|ADPs present an internally signed server certificate.
-
Il proxy considera attendibile la CA interna.
Requisiti del certificato TLS reciproca per proxy tls passizzato o XSP in DMZ
-
Webex presenta un certificato client firmato ca Webex agli XSP.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità degli XSP, pertanto gli XSP considerano attendibile il certificato client.
-
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
-
Gli XSP presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP.
Cronologia revisioni documenti
The following table shows a history of changes to this document over the past 12 months.
Data |
Versione | Descrizione della modifica | |
---|---|---|---|
August 09, 2024 |
2-122 |
| |
August 01, 2024 |
2-121 |
| |
25 giugno 2024 |
2-120 |
| |
June 14, 2024 |
2-119 |
| |
May 13, 2024 |
2-118 |
| |
May 10, 2024 |
2-117 |
| |
May 6, 2024 |
2-116 |
| |
May 2, 2024 |
2-115 |
| |
April 10, 2024 |
2-114 |
| |
March 27, 2024 |
2-113 |
| |
March 22, 2024 |
2-112 |
| |
March 07, 2024 |
2-111 |
| |
February 24, 2024 |
2-110 |
| |
February 20, 2024 |
2-109 |
| |
February 07, 2024 |
2-108 |
| |
January 25, 2024 |
2-107 |
| |
January 23, 2024 |
2-106 |
| |
January 10, 2024 |
2-105 |
| |
December 20, 2023 |
2-104 |
| |
December 13, 2023 |
2-103 |
| |
December 12, 2023 |
2-102 |
| |
December 08, 2023 |
2-101 |
| |
November 08, 2023 |
2-100 |
| |
October 25, 2023 |
2-99 |
| |
September 13, 2023 |
2-98 |
| |
September 04, 2023 |
2-97 |
| |
August 08, 2023 |
2-96 |
| |
June 23, 2023 |
2-95 |
| |
May 30, 2023 |
2-94 |
| |
May 26, 2023 |
2-93 |
| |
24 maggio 2023 |
2-92 |
| |
May 10, 2023 |
2-91 |
| |
May 09, 2023 |
2-90 |
| |
May 04, 2023 |
2-89 |
| |
27 aprile 2023 |
2-88 |
| |
14 aprile 2023 |
2-87 |
| |
17 marzo 2023 |
2-86 |
| |
March 11, 2023 |
2-85 |
| |
March 10, 2023 |
2-84 |
| |
March 07, 2023 |
2-83 |
| |
28 febbraio 2023 |
2-82 |
| |
February 15, 2023 |
2-81 |
| |
February 10, 2023 |
2-80 |
| |
Panoramica di Webex per Cisco BroadWorks
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione fornisce agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei clienti o forniscono questa soluzione direttamente ai relativi abbonati.
Scopo soluzione
-
Per fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che dispongono già del servizio di chiamata fornito dai provider di servizi BroadWorks.
-
Per fornire il servizio di chiamata basato a BroadWorks a clienti Webex piccoli e medi.
Contesto
In continua continua evoluzione di tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo impegno è spostare le funzionalità di chiamata BroadWorks nell'app Webex e ridurre l'investimento nei client UC-One.
Benefici
-
Prova futura: di fronte all'end-of-life di UC-One Collaborate, movimento di tutti i clienti verso il Unified Client Framework (UCF)
-
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex e conservazione delle chiamate BroadWorks sulla rete di telefonia
Ambito soluzione
-
I clienti esistenti/nuovi e medi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre della chiamata BroadWorks.
-
I clienti Webex esistenti, da piccoli a medi, desiderano aggiungere la chiamata BroadWorks.
-
Non aziende più grandi (ti prego di esaminare il nostro portfolio Enterprise per Webex).
-
Non i singoli utenti (valutare le offerte Webex online).
Le serie di funzioni in Webex per Cisco BroadWorks hanno come obiettivo casi d'uso di piccola e media attività. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità dei sistemi SME e ne valutiamo costantemente l'idoneità per questo segmento. È possibile scegliere di nascondere o rimuovere funzioni altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# |
Requisito |
Note |
---|---|---|
1 |
Patch Current BroadWorks R22 or above | |
2 |
XSP|ADP for XSI, CTI, DMS, and authService |
Dedicated XSP|ADP for Webex for Cisco BroadWorks |
3 |
Separate XSP|ADP for NPS, can be shared with other solutions that use NPS. |
If you have an existing collaborate deployment, then review recommendations on XSP|ADP and NPS configurations. |
4 |
Convalida token CI (con TLS) configurato per connessioni Webex al servizio di autenticazione. | |
5 |
mTLS configurato per le connessioni Webex all'interfaccia CTI. |
Altre applicazioni non richiedono mTLS. |
6 |
Gli utenti devono esistere in BroadWorks e necessitano dei seguenti attributi, in base alla propria decisione di provisioning:
|
Per e-mail affidabili: Si consiglia di inserire lo stesso indirizzo e-mail nell'attributo ID alternativo anche per consentire agli utenti di accedere con indirizzo e-mail per BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'utilizzo di messaggi e-mail non attendibili può inviare il messaggio e-mail alla cartella della posta indesiderata o dello SPAM dell'utente. L'amministratore potrebbe aver modificato le impostazioni e-mail dell'utente per consentire i domini |
7 |
File DTAF Webex per Cisco BroadWorks per l'app Webex | |
8 |
BW Business Lic o Std Enterprise o Prem Enterprise User Lic + Webex per l'abbonamento Cisco BroadWorks |
Se è già presente una distribuzione di collaborazione esistente, non è più necessario il bundle aggiuntivo UC-One, la collaborazione Lic e le porte della conferenza Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non è necessario apportare ulteriori modifiche se non si accettano i termini del pacchetto Premium. |
9 |
L'indirizzo IP/porte deve essere accessibile attraverso i servizi back-end Webex e le app Webex su Internet pubblico. |
Vedere la sezione "Preparazione della rete". |
10 |
TLS v1.2 Configuration on XSP|ADPs | |
11 |
Per il provisioning Flowworks, il server dell'applicazione deve connettersi all'adattatore di provisioning BroadWorks. La configurazione del proxy in uscita non viene testata o supportato. Se si utilizza un proxy in uscita, si accetta la responsabilità di supportarlo con Webex per Cisco BroadWorks. |
Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è comprendere, preparare, distribuire e gestire la soluzione Webex per Cisco BroadWorks. Le sezioni principali del documento riflettono questo scopo.
Questa guida include informazioni concettuali e materiale di riferimento. Intendiamo coprire tutti gli aspetti della soluzione in questo documento.
La serie minima di attività per la distribuzione della soluzione è la seguente:
-
Raggiungere il team dell'account per diventare un partner Cisco. È obbligatorio esplorare i punti di contatto Cisco per acquisire familiarità (ed essere addestrati). Quando si diventa un partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuire Webex per Cisco BroadWorks > onboarding dei partner in questo documento).
-
Configurare i sistemi BroadWorks per l'integrazione con Webex. (See Deploy Webex for Cisco BroadWorks > Configure Services on Your Webex for Cisco BroadWorks XSP|ADPs in this document.)
-
Utilizzare Partner Hub per collegare Webex a BroadWorks. Vedere Distribuire Webex per Cisco BroadWorks > l'organizzazione partner in Partner Hub in questo documento.
-
Utilizzare Partner Hub per preparare i modelli di provisioning utente. (See Deploy Webex for Cisco BroadWorks > Configure your Onboarding templates in this document.)
-
Test and onboard a customer by provisioning at least one user. (See Deploy Webex for Cisco BroadWorks > Configure Your Test Organization.)
-
Operazioni di alto livello, nell'ordine tipico. Esistono diverse attività determinanti che non è possibile ignorare.
-
Se si desidera creare le proprie applicazioni per gestire Webex per abbonati Cisco BroadWorks, leggere Uso dell'API di provisioning nella sezione Di riferimento di questa guida.
Terminologia
We try to limit the jargon and acronyms used in this document, and to explain each term when it’s first used. (See Webex for Cisco BroadWorks Reference > Terminology if a term isn’t explained in context.)
Funzionamento
Webex per Cisco BroadWorks è un'offerta che integra la chiamata BroadWorks in Webex. Gli abbonati utilizzano una singola applicazione (app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
-
Gli utenti chiamano PSTN numeri di telefono utilizzando l'infrastruttura BroadWorks.
-
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino per introdurre i numeri).
-
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Webex Call" nell'app Webex ( queste chiamate sono app Webex all'app Webex, non all'app Webex PSTN).
-
Gli utenti possono ospitare e partecipare Webex Meetings.
-
Gli utenti possono inviare messaggi l'uno all'altro o negli spazi (chat di gruppo persistente) e usufruire delle funzioni di ricerca e condivisione di file (su infrastruttura Webex).
-
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
-
Dopo averci asserto come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare il rapporto tra l'istanza BroadWorks e Webex.
-
È possibile creare organizzazioni dei clienti in Control Hub e pres effettuare il provisioning degli utenti in tali organizzazioni.
-
Ciascun abbonato in BroadWorks ottiene un'identità Webex in base al relativo indirizzo e-mail (attributo ID e-mail in BroadWorks).
-
Gli utenti eseguono l'autenticazione per BroadWorks o per Webex.
-
I client vengono emessi con token a lungo termine per autorizzarli per i servizi presso BroadWorks e Webex.
L'app Webex al centro di questa soluzione; è un'applicazione che può essere brandable disponibile su desktop Mac/Windows e su dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include le funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzioni di messaggistica, presenza e riunione.
Il client si registra ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i sistemi BroadWorks per garantire un'esperienza di provisioning utente ottimale.
Funzioni e limitazioni
Sono disponibili diversi pacchetti con diverse funzioni.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano un utente tramite softphone, i risultati della ricerca non forniscono alcuna opzione per l'invio di un messaggio.
Gli utenti softphone possono condividere lo schermo durante una chiamata.
Pacchetto "Base"
The basic package includes Calling, Messaging, and Meeting features. It includes 100 participants in “unified space” meetings and Personal Meeting Room (PMR) meetings. (** see the below Note for exception). In this package the meetings can have a maximum duration of 40 minutes.
Pacchetto "standard"
This package also includes everything in the Basic package such as up to 100 participants in “unified space” meetings and Personal Meeting Room (PMR) meetings.
La condivisione dello schermo all'interno di una riunione PMR ha inizialmente un ruolo svolto solo dall'organizzatore della riunione, ma l'organizzatore può passare il 'ruolo di relatore' a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può assumere nuovamente il ruolo di relatore senza che venga passato dall'ospite corrente.
Pacchetto "Premium"
This package includes everything in the Standard package plus up to 300 participants in “unified space” meeting and up to 1000 participants in a Personal Meeting Room (PMR).
La condivisione dello schermo all'PMR di un evento è supportata per qualsiasi partecipante.
Confronta pacchetti
Pacchetto |
Chiamata |
Messaggistica |
Unified Space Meetings |
PMR riunioni |
---|---|---|---|---|
Softphone |
Incluso |
Non incluso |
Nessuno |
Nessuno |
Base |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Standard |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Premium |
Incluso |
Incluso |
300 partecipanti |
1000 partecipanti |
"Unified Space Meetings" refers to a Webex meeting (scheduled or unscheduled) that takes place in a Webex space. For example, a user initiates a meeting from the space via the "Meet" or "Schedule" buttons.
"PMR Meetings" refers to a Webex Meeting (scheduled or unscheduled) that takes place in a user's Personal Meeting Room (PMR). These meetings use a dedicated URL (for example: cisco.webex.com/meet/roomOwnerUserID).
Funzioni di messaggistica e riunione
Refer to the following table for PMR meeting feature support differences for Basic, Standard and Premium packages.
Funzione riunione |
Supported with Basic Package |
Soportato con il pacchetto standard |
Supportato con pacchetto Preminum |
Commento |
---|---|---|---|---|
Durata riunione |
40 Minutes or less |
Illimitato |
Illimitato | |
Condivisione desktop |
Sì |
Sì |
Sì |
Basic—Desktop sharing by any PMR meeting participant. Standard —Desktop sharing by PMR meeting host only. Premium—Desktop sharing by any PMR meeting participant. |
Condivisione di un'applicazione |
Sì |
Sì |
Sì |
Basic—Application sharing by any PMR meeting participant. Standard —Application sharing by PMR meeting host only. Premium—Application sharing by any PMR meeting participant. |
Chat tra più parti |
Sì |
Sì |
Sì | |
Lavagna |
Sì |
Sì |
Sì | |
Protezione password |
Sì |
Sì |
Sì | |
App Web - nessun download o plug-in (esperienza ospite) |
Sì |
Sì |
Sì | |
Supporta accoppiamento con dispositivi Webex |
Sì |
Sì |
Sì | |
Controllo piano (disattiva audio di uno / Espelle tutti) |
Sì |
Sì |
Sì | |
Collegamento Riunioni permanenti |
Sì |
Sì |
Sì | |
Acces. sito per riunioni |
Sì |
Sì |
Sì | |
Accesso alla riunione tramite VoIP |
Sì |
Sì |
Sì | |
Blocco |
Sì |
Sì |
Sì | |
Controlli relatore |
No |
No |
Sì | |
Controllo desktop remoto |
No |
No |
Sì | |
Numero di partecipanti |
100 |
100 |
1000 | |
Registrazione salvata in locale nel sistema |
Sì |
Sì |
Sì | |
Registrazione nel cloud |
No |
No |
Sì | |
Registrazione - Storage su cloud |
No |
No |
10GB per site | |
Trascrizione delle registrazioni |
No |
No |
Sì | |
Pianificazione riunione |
Sì |
Sì |
Sì | |
Abilita condivisione del contenuto con integrazioni esterne |
No |
No |
Sì |
Basic— Content sharing by any PMR meeting participant. Standard—Content sharing by PMR meeting host only. Premium—Content sharing by any PMR meeting participant. |
Consenti PMR modifica dell'URL |
No |
No |
Sì |
Basic— Users can modify the PMR URL from the Webex site. Partner and org admins can modify the URL from Control Hub. Standard—The PMR URL can be changed only from Partner Hub by Partner and org admins. Premium—Users can modify the PMR URL from the Webex site. Gli amministratori di partner e organizzazioni possono modificare l'URL da Partner Hub. |
Riunioni in streaming in diretta (ad esempio, su Facebook, Youtube) |
No |
No |
Sì | |
Consentire ad altri utenti di pianificare le riunioni per proprio conto |
No |
No |
Sì | |
Aggiungi organizzatore alternativo |
Sì |
No |
Sì | |
Integrazione delle app (es. Zendesk, Slack) |
Dipende dall'integrazione |
Dipende dall'integrazione |
Sì |
Vedere la sezione Integrazioni delle app di seguito per ulteriori informazioni sul supporto. |
Integrazione con il calendario Microsoft Office 365 |
Sì |
Sì |
Sì | |
Integrazione con Google Calendaring per G Suite |
Sì |
Sì |
Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione per l'utente per Webex all'help.webex.com
. Leggere i seguenti articoli per ulteriori informazioni sulle funzioni:
Funzioni di chiamata
L'esperienza di chiamata è simile a quelle precedenti che utilizzano il motore di controllo chiamate BroadWorks. La differenza rispetto a UC-One Collaborate e UC-One SaaS è che l'app Webex è il soft client principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
-
Zendesk—Premium only
-
Slack—Premium only
-
Microsoft Teams for Webex Meetings—Standard or Premium
-
Microsoft Teams for Calling—Supported with all packages
-
Office 365 Calendaring—Standard or Premium
-
Google Calendaring for G Suite—Standard or Premium
Supporto infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta ambienti con infrastruttura desktop virtuale (VDI). For details on how to deploy VDI infrastructure, refer to Deployment Guide for Webex for Virtual Desktop Infrastructure (VDI).
IPv6 Support
Webex for Cisco BroadWorks supports IPv6 addressing for the Webex App.
Pro Pack per Control Hub
Il servizio aggiuntivo Pro Pack per Control Hub fornisce agli amministratori, alle informazioni di sicurezza e ai funzionari di conformità funzionalità avanzate in sicurezza, conformità e analisi in grado di integrare il software.
These add-on services will be only available for Standard and Premium packages.
For more information, see the Help Page of Pro Pack for Control Hub.
Roadmap futuro
Per informazioni sulle nostre intenzione per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Gli elementi della roadmap non sono associabili ad alcuna capacità. Cisco si riserva il diritto di disattivare o revisionare uno o tutti di questi elementi nelle release future.
Limiti
Limitazioni provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario per il Webex Meetings sito creato per tale pacchetto.
Se non viene specificato alcun fuso orario nella richiesta di provisioning per il primo utente di ciascun pacchetto, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sul valore predefinito regionale dell'organizzazione degli abbonati.
Se il cliente richiede un fuso orario Webex Meetings sito specifico, specificare il parametro di fuso orario nella richiesta di provisioning
per:
-
il primo abbonato predisposto per il pacchetto standard nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
-
the first subscriber provisioned for Basic package in the organization.
Limitazioni generali
-
Nessuna chiamata nella versione Web del client Webex (si tratta di una limitazione del client, non di una limitazione di soluzione).
-
Webex potrebbe non disporre ancora di tutti i controlli UI per supportare alcune funzioni di controllo chiamate disponibili da BroadWorks.
-
Il client Webex non può essere attualmente con etichetta "White labeled".
-
Quando si creano organizzazioni cliente utilizzando il metodo di provisioning scelto, tali organizzazioni vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. È previsto che partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
-
La generazione di report sulle riunioni e sull'utilizzo dei messaggi è disponibile attraverso l'organizzazione cliente in Control Hub.
Problemi noti e limitazioni
For an up to date list of known issues and limitations with the Webex for Cisco BroadWorks offer, see Known Issues and Limitations.
Limiti messaggistica
I seguenti limiti di storage dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo spazio di storage massimo per la messaggistica e i file combinati.
-
Base: 2 GB per utente per 3 anni
-
5 GB standard per utente per 3 anni
-
Premium: 10 GB per utente per 5 anni
Per ciascuna organizzazione di clienti, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti Premium può utilizzare un limite di messaggistica e storage file totale di 50 GB. Un singolo utente può superare il limite per utente (10 GB) a condizione che la società sia ancora sotto il valore massimo aggregato (50 GB).
Per gli spazi del team creati, i limiti di messaggistica si applicano al totale aggregato per l'organizzazione del cliente che possiede lo spazio del team. È possibile trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti di messaggistica generali che si applicano agli spazi del team di messaggistica Webex, vedere https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure connessioni a Webex e BroadWorks. I dati archiviati nel cloud Webex e esposti all'utente attraverso l'interfaccia dell'app Webex vengono crittografati sia in viaggio che a riposo.
Ulteriori dettagli sullo scambio dei dati sono disponibili nella sezione Riferimento di questo documento.
Lettura aggiuntiva
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati più vicino alla regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore provider di servizi (utente): Per le attività di manutenzione giornaliere, è possibile gestire le parti in locale (di chiamata) della soluzione utilizzando i propri sistemi. Le parti Webex della soluzione vengono gestite attraverso Partner Hub.
For information on the roles that are available to partners, the access privileges that accompany those roles, and how to assign roles, see Partner Administrator Roles for Webex for BroadWorks and Wholesale RTM.
Team operativo Cisco Cloud: Crea l'organizzazione partner in Partner Hub, se non esiste, durante il processo di onboarding.
Una volta che si dispone dell'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. You next create “Onboarding templates” to represent the suites or packages served through those systems. Si eservi quindi il provisioning dei propri clienti o abbonati.
# |
Attività tipica |
SP |
Cisco |
---|---|---|---|
1 |
Onboarding del partner: creazione dell'organizzazione partner, se presente, e abilitazione delle attivazioni/disattivazioni delle funzioni necessarie |
● | |
2 |
Configurazione BroadWorks nell'organizzazione partner tramite Hub partner (cluster) |
● | |
3 |
Configurazione delle impostazioni di integrazione nell'organizzazione partner tramite Partner Hub (modelli di offerta, branding) |
● | |
4 |
Preparing BroadWorks environment for Integration (AS, XSP|ADP Patching, firewalls, XSP|ADP configuration, XSI, AuthService, CTI, NPS, DMS applications on XSP|ADP) |
● | |
5 |
Sviluppo di un'integrazione o di un processo di provisioning |
● | |
6 |
Prepara materiali GTM |
● | |
7 |
Esegui migrazione o provisioning di nuovi utenti |
● |
Architettura
Che cos'è nel diagramma?
Client
-
Il client Webex App svolge la funzione di applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di riunioni audio/video native di messaggistica, presenza e multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per chiamate SIP PSTN chiamate.
-
I telefoni Cisco IP e relativi accessori utilizzano anche l'infrastruttura BroadWorks per SIP e chiamate PSTN telefoniche. Ci vediamo in grado di supportare telefoni di terze parti.
-
Portale di attivazione utente per consentire agli utenti di accedere a Webex utilizzando le credenziali BroadWorks.
-
Partner Hub è un'interfaccia Web per l'amministrazione della propria organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. È anche possibile utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
provider di servizi di rete
Il blocco verde a sinistra del diagramma rappresenta la rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
-
Public-facing XSP|ADP, for Webex for Cisco BroadWorks: (The box represents one or multiple XSP|ADP farms, possibly fronted by load balancers.)
-
Ospita l'interfaccia XSI-Actions &XSI-Events, Device Servizio di gestione (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato di hook degli altri (presenza di telefonia) e cronologia chiamate.
-
Pubblica la directory sui client Webex.
-
-
Public-facing XSP|ADP, running NPS:
-
Server push notifiche chiamate host: A Notification Push Server on an XSP|ADP in your environment. Interfaccia tra il server applicazioni e il nostro proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS &FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
-
-
Server applicazione:
-
Fornisce il controllo e le interfacce delle chiamate ad altri sistemi BroadWorks (in genere)
-
Per il provisioning flowre, l'AS viene utilizzato dall'amministratore del partner per eseguire il provisioning degli utenti in Webex
-
Inserisce profilo utente in BroadWorks
-
-
SISTEMA SISTEMA AVAIO/BSS: Sistema di supporto operativo/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nel diagramma rappresenta il cloud Webex. I microservizi Webex supportano tutte le funzionalità di collaborazione Webex:
-
Cisco Common Identity (CI) è il servizio di identità all'interno di Webex.
-
Webex per Cisco BroadWorks rappresenta l'insieme di microservizi che supportano l'integrazione tra Webex e provider di servizi BroadWorks ospitate:
-
API di provisioning utenti
-
provider di servizi configurazione
-
Accesso utente tramite credenziali BroadWorks
-
-
casella Messaggistica Webex per microservizi correlati alla messaggistica.
-
Webex Meetings che rappresenta i server di elaborazione multimediale e i controller SBC per le riunioni video con più partecipanti (SIP & SRTP)
Servizi Web di terze parti
I seguenti componenti di terze parti vengono rappresentati nel diagramma:
-
APNS (Apple Push Notifications Service) inserisce le notifiche di chiamate e messaggi nelle applicazioni Webex sui dispositivi Apple.
-
FCM (FireBase Cloud Messaging) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
XSP|ADP Architecture Considerations
The Role of Public-Facing XSP|ADP Servers in Webex for Cisco BroadWorks
The public-facing XSP|ADP in your environment provides the following interfaces/services to Webex and clients:
-
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste di BroadWorks J JSON (Token Web JSON) per conto dell'utente
-
Interfaccia CTI protetta da mTLS, a cui Webex esegue l'abbonamento per eventi cronologia chiamate e stato della presenza di telefonia da BroadWorks (stato hook).
-
Interfacce di azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate, le directory di contatto e di elenco delle chiamate e la configurazione del servizio di telefonia dell'utente finale
-
Servizio DM (Device Management) per i client per recuperare i file di configurazione delle chiamate
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. (See Configure your BroadWorks Clusters in Partner Hub in this document.) For each cluster, you can only provide one URL for each interface. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
XSP|ADP Architecture
We require that you use a separate, dedicated XSP|ADP instance or farm to host your NPS (Notification Push Server) application. È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. However, you may not host the other applications required for Webex for Cisco BroadWorks on the same XSP|ADP that hosts the NPS application.
We recommend that you use a dedicated XSP|ADP instance/farm to host the required applications for Webex integration for the following reasons
-
For example, if you’re offering UC-One SaaS, we recommend creating a new XSP|ADP farm for Webex for Cisco BroadWorks. In questo modo i due servizi possono funzionare in modo indipendente durante la migrazione degli abbonati.
-
If you collocate the Webex for Cisco BroadWorks applications on an XSP|ADP farm that is used for other purposes, it's your responsibility to monitor usage, manage the resulting complexity, and plan for the increased scale.
-
The Cisco BroadWorks System Capacity Planner assumes a dedicated XSP|ADP farm and may not be accurate if you use it for collocation calculations.
Unless noted otherwise, the dedicated Webex for Cisco BroadWorks XSP|ADPs must host the following applications:
-
AuthService (TLS con convalida token CI o mTLS)
-
CTI (mTLS)
-
Azioni XSI (TLS)
-
XSI-Events (TLS)
-
DMS (TLS)—Optional. It's not mandatory that you deploy a separate DMS instance or farm specifically for Webex for Cisco BroadWorks. You can use the same DMS instance that you use for UC-One SaaS or UC-One Collaborate.
-
Call Settings Webview (TLS)—Optional. Call Settings Webview (CSW) is required only if you want Webex for Cisco BroadWorks users to be able to configure calling features on the Webex App.
Webex richiede l'accesso al CTI attraverso un'interfaccia protetta (autenticazione) TLS reciproca autenticazione. Per supportare questo requisito, si consiglia una di queste opzioni:
-
(Diagram labelled Option 1) One XSP|ADP instance or farm for all applications, with two interfaces configured on each server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
-
(Diagram labelled Option 2) Two XSP|ADP instances or farms, one with an mTLS interface for CTI, and the other with a TLS interface for other apps, such as the AuthService.
XSP|ADP Reuse
If you have an existing XSP|ADP farm that conforms to one of the suggested architectures above (Option 1 or 2) and it is lightly loaded, then it is possible to reuse your existing XSP|ADPs. You will need to verify that there are no conflicting configuration requirements between existing applications and the new application requirements for Webex. Le due considerazioni principali sono:
-
If you need to support multiple webex partner organizations on the XSP|ADP, then that means you must use mTLS on the Auth Service (CI Token Validation is only supported for a single partner organization on an XSP|ADP). Se si utilizza mTLS sul servizio di autenticazione, ciò significa che non è possibile avere client che stanno utilizzando l'autenticazione di base sul servizio di autenticazione allo stesso tempo. This situation would prevent reuse of the XSP|ADP.
-
If the existing CTI Service configured to be used by clients with the secure port (typically 8012) but without mTLS (i.e., client authentication) then that will conflict with the webex requirement to have mTLS.
Because the XSP|ADP’s have many applications and the number of permutations of these applications is large, there may be other unidentified conflicts. For this reason, any potential reuse of XSP|ADP’s should be verified in a lab with the intended configuration prior to committing to the reuse.
Configure NTP Synchronization on XSP|ADP
The deployment requires time synchronization for all XSP|ADPs that you use with Webex.
Installare il pacchetto ntp
dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Then you can configure NTP during the XSP|ADP software installation. Per ulteriori informazioni, vedere la Guida alla gestione software BroadWorks.
During the interactive installation of the XSP|ADP software, you’re given the option to configure NTP. Procedere come segue:
-
Quando viene visualizzato il programma di installazione,
configurare NTP?
, inserire y.
-
Quando il programma di installazione richiede,
questo server deve essere un server NTP? , inserire n
.
-
Quando il programma di installazione richiede, Qual è l'indirizzo NTP, il nome host o nome di dominio completo? , inserire l'indirizzo del server NTP o un servizio
NTP pubblico, ad esempio,
pool.ntp.org
.
If your XSP|ADPs use silent (noninteractive) installation, the installer configuration file must include the following Key=Value pairs:
NTP
NTP_SERVER=<NTP Server address, e.g., pool.ntp.org>
XSP|ADP Identity and Security Requirements
Sfondo
I protocolli e i tipi di crittografia delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli variano dal più generale (provider SSL) alla più specifica (singola interfaccia). Un'impostazione più specifica sovrascrive sempre un'impostazione più generale. Se non vengono specificate, le impostazioni SSL di livello 'inferiore' vengono ereditano dai livelli superiori.
Se non viene modificata alcuna impostazione dai valori predefiniti, tutti i livelli ereditano le impostazioni predefinite del provider SSL (estensione JSSE Java Secure Sockets).
Elenco requisiti
-
The XSP|ADP must authenticate itself to clients using a CA-signed certificate in which the Common Name or Subject Alternate Name matches the domain portion of the XSI interface.
-
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
-
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
-
Diffie-Hellman Ephemeral (DHE) o Curve ellittiche Diffie-Hellman Ephemeral (ECDHE) key-exchange
-
Crittografia AES (Advanced Encryption Standard) con una dimensione di blocco minima di 128 bit (ad esempio, AES-128 o AES-256)
-
Modalità di crittografia GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
-
Se viene utilizzata la crittografia CBC, solo la famiglia di funzioni hash SHA2 è consentita per la derivazione chiave (SHA256, SHA384, SHA512).
-
-
Ad esempio, i seguenti tipi di crittografia soddisfano i requisiti:
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
The XSP|ADP CLI requires the IANA naming convention for cipher suites, as shown above, not the openSSL convention.
Tipi di crittografia TLS supportati per le interfacce AuthService e XSI
Questo elenco è soggetto a modifica quando i requisiti di sicurezza del cloud cambiano. Seguire i suggerimenti sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento.
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
-
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
-
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_128_GCM_SHA256
-
TLS_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_256_CBC_SHA256
-
TLS_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_WITH_AES_256_CBC_SHA
-
TLS_PSK_WITH_AES_256_CBC_SHA384
-
TLS_PSK_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_WITH_AES_128_CBC_SHA
-
TLS_PSK_WITH_AES_128_CBC_SHA256
-
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il conteggio dei thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi mostrati, come segue (non diminuire, se sono superiori ai valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Multiple XSP|ADPs
Elemento Edge di bilanciamento del carico
If you have a load balancing element on your network edge, it must transparently handle the distribution of traffic between your multiple XSP|ADP servers and the Webex for Cisco BroadWorks cloud and clients. In questo caso, si fornisce l'URL del servizio di bilanciamento del carico a Webex per la configurazione Cisco BroadWorks.
Note su questa architettura:
-
Configurare DNS in modo che i client possano trovare il servizio di bilanciamento del carico quando si connettono all'interfaccia Xsi (vedere Configurazione DNS).
-
Si consiglia di configurare l'elemento Edge in modalità proxy SSL inverso per accertarsi che la crittografia dati point-to-point.
-
Certificates from XSP|ADP01 and XSP|ADP02 should both have the XSP|ADP domain, for example your-XSP|ADP.example.com, in the Subject Alternate Name. They should have their own FQDNs, for example XSP|ADP01.example.com, in the Common Name. È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Internet-Facing XSP|ADP Servers
If you expose the Xsi interfaces directly, use DNS to distribute the traffic to the multiple XSP|ADP servers.
Note su questa architettura:
-
Two records are required to connect to the XSP|ADP servers:
-
For Webex microservices: Round-robin A/AAAA records are required to target the multiple XSP|ADP IP addresses. This is because the Webex microservices can’t do SRV lookups. For examples, see Webex Cloud Services.
-
For Webex App: An SRV record that resolves to A records where each A record resolves to a single XSP|ADP. For examples, see Webex App.
Use prioritized SRV records to target the XSI service for the multiple XSP|ADP addresses. Prioritize your SRV records so that the microservices will always go to the same A record (and subsequent IP address) and will only move to the next A record (and IP address) if the first IP address is down. DO NOT use a round-robin approach for the Webex App.
-
-
Certificates from XSP|ADP01 and XSP|ADP02 should both have the XSP|ADP domain, for example your-XSP|ADP.example.com, in the Subject Alternate Name. They should have their own FQDNs, for example XSP|ADP01.example.com, in the Common Name.
-
È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Sometimes, DNS is configured to resolve the XSP|ADP URL to an HTTP load balancer, and the load balancer is configured to redirect through a reverse proxy to the XSP|ADP servers.
Webex does not follow a redirect when connecting to the URLs you supply, so this configuration does not work.
Ordinazione e provisioning
Ordinazione e provisioning si applicano a questi livelli:
-
Partner/Service Provider provisioning:
Ciascun Webex per Cisco BroadWorks provider di servizi (o rivenditore) presente deve essere configurato come organizzazione partner in Webex e disporre dei diritti necessari. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per la gestione di Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le attività di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/Enterprise.
-
Customer/Enterprise ordering and provisioning:
Ciascuna azienda BroadWorks abilitata per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo viene eseguito automaticamente come parte del provisioning dell'utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks sono predisposti nella stessa organizzazione clienti Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
-
User/Subscriber ordering and provisioning:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning utente:
-
Provisioning Flow con e-mail attendibili
-
Provisioning flow senza messaggi e-mail attendibili
-
Self-provisioning utente
-
Provisioning API
-
Flowthrough Provisioning with Trusted Emails
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile asserre che BroadWorks abbia indirizzi e-mail dell'abbonato validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Provisioning flow senza messaggi e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non si può contare sugli indirizzi e-mail dell'abbonato tenuti da BroadWorks, questa opzione di provisioning crea account Webex, ma non può attivarli fino a quando gli abbonati non forniscono e convalidano gli indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Self-Provisioning utente
Con questa opzione, non esiste provisioning flowworks da BroadWorks a Webex. Dopo aver configurato l'integrazione tra Webex e il sistema BroadWorks, si ottengono uno o più collegamenti specifici per il provisioning degli utenti all'interno di Webex per l'organizzazione partner Cisco BroadWorks.
Si progettare quindi le proprie comunicazioni (o delegare ai clienti) la distribuzione del collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account sono predisposti nell'ambito dell'organizzazione partner, è possibile regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare questa operazione.
Gli utenti devono essere presenti nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento.
provider di servizi provisioning da PARTE delle API
Webex sono esposti una serie di API pubbliche che consentono di creare Webex per il provisioning di utenti/abbonati Cisco BroadWorks nel flusso di lavoro/strumenti di gestione degli utenti esistenti.
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Install AP.as.22.0.1123.ap376508.
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Install AP.as.23.0.1075.ap376509
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Install AP.as.24.0.944.ap375100
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Extension Dialing
Extension Dialing feature support allows Webex for Cisco Broadworks users to dial other users with an extension similar to the primary phone number within the same enterprise. This is especially useful for users who do not have DID numbers.
During provisioning, the extension of the users gets stored in the Webex directory as the user’s extension. For BroadWorks calling, the extension appears on the Webex App in the extension field of all the call initiation method areas and the user’s profile. Webex for Cisco BroadWorks supports extension-only calls between users within the same group and different groups of the same enterprise with the combination of location dialing code and extension. However, calling between two enterprises using only extensions is not supported.
An extension can be provisioned for the Cisco BroadWorks users through the following methods:
-
Cisco BroadWorks users
-
Public API provisioning as ‘extension
-
The extension parameter should be explicitly passed as part of the API call. For enterprises/groups that have Location Dialing Code (LDC) configured, the extension parameter should be the combination of LDC and 'extension number.
-
-
Flowthrough or Self-Activation provisioning
-
Extension and LDC (where applicable) will be automatically retrieved from BroadWorks.
-
-
-
BroadWorks-only Calling users or entities
-
Synced automatically from BroadWorks by Directory Sync using the combination of Location Dialing Code (LDC) and extension number.
-
Record chiamata BroadWorks |
Descrizione |
Provisioning method |
Managing Extension |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
Public API |
Extension needs to be passed as parameter |
Flowthrough |
Extension retrieved from BroadWorks automatically | ||
Utenti che chiamano solo BroadWorks |
Calling users who are not onboarded to Webex |
Sincronizzazione rubriche |
Extension synced by Directory sync |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sincronizzazione rubriche | Extension synced by Directory sync |
Elenchi telefonici BroadWorks |
Enterprise, Group or Personal Phone Lists |
Sincronizzazione rubriche |
Non applicabile |
Prerequisiti
-
Client version required for supporting this feature is 42.11 or later.
-
Patch where extension and location dialing codes are added to XSI and Provisioning Adapter February 2022 for version 23 or above as part of :
-
AP.platform.23.0.1075.ap380045
-
AP.as.23.0.1075.ap380045
-
AP.xsp.23.0.1075.ap380045
-
AP.as.24.0.944.ap380045
-
-
Enable the header X-BroadWorks-Remote-Party-Info on the AS using the below CLI command for this SIP call flow which is required for extension dialing feature support.
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
App Call Options Priority
As part of the Extension Dialing feature support, The app call options priority setting is also provided at the partner level for all the Webex for Cisco Broadworks partners. Using this setting, the partner can control the call priority settings of all its managed customers from Partner Hub. The app call options priority setting for a customer can also be modified at a customer level from Control Hub.
The app call options priority setting contains extension as second option in both Partner Hub and Control Hub when a Webex for Cisco Broadworks user is newly provisioned with extension through any of the above-mentioned provisioning methods.
For all the existing provisioned Orgs, the extension option will be in the hidden state (by default) in the app call options priority setting. This will not show an extension in the audio/video call option of the user in the Webex App.
Following are the options to make the extension call option visible for the existing customers:
-
If a partner wants all its managed customer orgs to be provided with an extension as one of the call options, it is recommended for the Partner Admin to move the Extension from hidden to available in Partner Hub. This will let the managed customer orgs inherit the setting from their partner.
-
If a Partner wants to provide an extension in call options for a specific customer org, it is recommended for the Partner Admin to move the extension from hidden to available in Control Hub.
Group Contacts Support
This feature enhances the Webex for BroadWorks DirSync service by removing the limitation for syncing up to 1500 contacts from the Group phone lists on BroadWorks and allowing partners to sync up to 30K contacts from a single Group phone list and bring it on par with the 30K contacts increase for Enterprise phone list, which was released separately.
There is an overall limit of 200K for all external contacts per Organization, which would apply to the sum of Enterprise and Group phone lists in a single BroadWorks enterprise. For example, a BroadWorks enterprise that has Enterprise phone list with 30K and also 5 Group phone lists each with 30K will be supported (180K total per Org). However, if there are 6 group phone lists each with 30K, this will not be supported (210K total).
This feature is available on request. Please contact your account team to have it enabled.
-
Before enabling the feature, a prerequisite migration is to be run to provision and associate groups for all the existing provisioned users.
-
Cisco team will run an internal API to migrate any existing provisioned users to associate them with the correct group. NOTA: This can take up to one week to process.
-
Once the migration is completed for the partner and the feature is enabled, any newly provisioned users will be 'grouped' appropriately.
After the feature is enabled, the DirSync service starts syncing BroadWorks Group phone list contacts into dedicated per group contact storage in the Webex Contact Service.
During provisioning, the enterprise group of the user needs to be stored in the Webex directory to indicate the group this user belongs to. The association of the user with a BroadWorks group in the Webex Directory allows the Webex app to do contact search in the Contact Service group storage for the specific group of the user.
The feature requires the Webex for BroadWorks subscribers to be provisioned in Webex with the BroadWorks enterprise Group Id.
The BroadWorks enterprise Group Id can be provisioned for the Cisco BroadWorks users through the following methods:
-
Webex per utenti Cisco BroadWorks
-
Public API provisioning as ‘spEnterpriseGroupId’
-
The BroadWorks enterprise Group Id should be explicitly passed in spEnterpriseGroupId parameter of the API call.
-
-
Flowthrough or Self-Activation provisioning
-
BroadWorks enterprise Group Id will be automatically retrieved from BroadWorks.
-
-
BroadWorks-only Calling users or entities
-
Not applicable. It’s not required to sync BroadWorks enterprise Group Id for these users.
-
-
Record chiamata BroadWorks |
Descrizione |
Provisioning method |
Managing Enterprise Group ID |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
Public API |
BroadWorks enterprise Group Id needs to be passed as parameter spEnterpriseGroupId |
Flowthrough |
BroadWorks enterprise Group Id is retrieved from BroadWorks automatically | ||
Utenti che chiamano solo BroadWorks |
Calling users who are not onboarded to Webex |
Sincronizzazione rubriche |
Non applicabile |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sincronizzazione rubriche |
Non applicabile |
Elenchi telefonici BroadWorks |
Contacts in the BroadWorks Group Phone Lists |
Sincronizzazione rubriche |
Group contacts are stored in Webex Contact Service associated with the specific group |
BroadWorks Enterpsie or Persional phone lists |
Contacts in the Enterprise or Personal Phone Lists |
Sincronizzazione rubriche |
Non applicabile |
Public API must be updated PRIOR to the MIGRATION. Migration cannot be completed until THIS API is completed The BroadWorks enterprise Group Id should be explicitly passed in spEnterpriseGroupId parameter of the API call https://developer.webex.com/docs/api/changelog#2023-march
After the feature is enabled and as a result of the next directory sync the enterprise user groups will also be displayed in Control Hub. Visualizing the groups in Control Hub for Webex for BroadWorks is purely informational at this stage. Partner and customer admins should not make any modifications to groups or group membership in Control Hub as these changes will not be reflected back to BroadWorks. Group Management in Control Hub is intended for use by partners who will be adopting the upcoming Contact Management APIs.
Migrazione e prova futura
Cisco il client BroadSoft unified Communications deve passare da UC-One a Webex. Esiste una corrispondente lingua dei servizi di supporto lontani dalla rete provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Whether you’re running UC-One SaaS, or BroadWorks Collaborate, the preferred migration strategy is to deploy new, dedicated XSP|ADPs for integration with Webex for Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti a Webex e, infine, recuperare l'infrastruttura utilizzata per la soluzione precedente.
Recommended Document Subscriptions
Webex Help Center articles (on help.webex.com) have a Subscribe option that lets you receive an email notification whenever that article gets updated.
We recommend that you subscribe to each of the following articles to ensure that you don't miss out on critical updates that affect network connectivity. To subscribe, go to each of the below links and in the article that launches, click the Subscribe button.
At a minimum, we recommend that you subscribe to the above list. However, most of the Webex articles and documents listed under Additional Documents have a Subscribe option. For this option to appear, the article must appear on help.webex.com.
Additional Documents
Refer to the following related documentation for more information about Webex for Cisco BroadWorks:
Webex for Cisco BroadWorks Documents
Partner administrators can use the following documents and sites to obtain information on Webex for Cisco BroadWorks.
-
Bring Your Own PSTN Solution for Webex for Cisco BroadWorks—This solution lets Service Providers provision phone numbers that they own (rather than Cisco-provided numbers) for users to use when joining Webex Meetings.
-
Webex for Cisco BroadWorks Configuration Guide—Describes how to configure the Webex App for Webex for Cisco BroadWorks.
- Device Integration Guide for Webex for Cisco BroadWorks—Describes how to onboard and service Room OS and MPP devices.
-
Webex for Cisco BroadWorks Troubleshooting Guide—Contains troubleshooting information for Webex for Cisco BroadWorks.
Webex for Cisco BroadWorks Articles
Partner administrators can use the following optional sites to learn more about Webex for Cisco BroadWorks:
-
Webex for Cisco BroadWorks Documentation—The landing page lists technical documents and optional Webex articles targeted to partner administrators of Webex for Cisco BroadWorks.
-
What's New with Webex for Cisco BroadWorks—Read about the latest released features along with what's coming soon.
-
Known Issues and Limitations—Read about known issues that we've identified in the Webex for Cisco BroadWorks solution.
-
Partner Administrator Roles for Webex for BroadWorks and Wholesale RTM—This article describes how to assign partner administrator roles for partner organizations that offer Webex for Cisco BroadWorks. Roles get used to assign administration access to settings in Partner Hub and Control Hub.
Cisco BroadWorks Documents
Partner administrators can refer to the Cisco BroadWorks site on cisco.com for technical documents that describe how to deploy the Cisco BroadWorks part of the solution:
Webex Help Articles
The following Webex Help sites can be used to find Webex articles that help customer administrators and end users to use Webex features.
-
Webex from Service Providers—This landing page contains links with getting started info and commonly used articles for Webex App users who purchased Webex services from a Service Provider.
-
Webex Help Center—Use the search feature at help.webex.com to search for additional Webex articles that describe Webex App and Webex Meetings functionality. You can search for either user or administrator articles.
Developer Documentation
-
Webex for BroadWorks Developer Guide—Provides information for developers who create applications that use the Webex for BroadWorks APIs.
Preparazione dell'ambiente
Punti decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastruttura
|
How many XSP|ADPs? Come prendono mTLS? |
Pianificatore capacità sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks XSP|ADP CLI Reference Questo documento |
Provisioning clienti e utenti |
Si può asserre che si considera attendibili i messaggi e-mail in BroadWorks? Si desidera che gli utenti forniranno gli indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Doc API pubblici su https://developer.webex.com Questo documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo sul branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso dei clienti? | Questo documento |
Funzioni dell'abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o softphone. |
Questo documento Matrice funzioni/pacchetto |
Autenticazione utente | BroadWorks o Webex | Questo documento |
Adattatore di provisioning (per le opzioni di provisioning flow) |
Utilizzi già IM&P integrato, ad esempio per UC-One SaaS? Utilizzare più modelli? Esiste un caso d'uso più comune previsto? |
Questo documento Riferimento CLI server applicazione |
Architettura e infrastruttura
-
Con quale scala intendete iniziare? È possibile aumentare la scalabilità in futuro, ma la stima d'uso corrente deve guidare la pianificazione dell'infrastruttura.
-
Work with your Cisco account manager / sales representative to size your XSP|ADP infrastructure, according to the Cisco BroadWorks System Capacity Planner and the Cisco BroadWorks System Engineering Guide.
-
How will Webex make Mutual TLS connections to your XSP|ADPs? Directly to the XSP|ADP in a DMZ, or via TLS proxy? This affects your certificate management, and the URLs you use for the interfaces. (We do not support unencrypted TCP connections to the edge of your network).
Provisioning clienti e utenti
Quale metodo di provisioning utente si adatta meglio alle esigenze?
-
Flowthrough Provisioning With Trusted Emails: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene automaticamente predisposto in Webex.
Se è anche possibile asserre che gli indirizzi e-mail dell'abbonato nella BroadWorks siano validi e univoci per Webex, è possibile utilizzare la varianti "e-mail attendibile" del provisioning flow provisioning. Gli account Webex del sottoscrittore vengono creati e attivati senza il loro intervento; semplicemente scaricare il client ed eseguire l'accesso.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto l provider di servizi deve specificare un indirizzo e-mail valido per l'utente per potervi fornire i servizi Webex. Deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo nell'attributo ID alternativo.
-
Flowthrough Provisioning Without Trusted Emails: Se non si riesce a verificare l'attendibilità degli indirizzi e-mail dell'abbonato, è comunque possibile assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
-
User Self-Provisioning: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. L'utente (o i clienti) distribuiscono invece un collegamento di provisioning e i collegamenti per scaricare diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex. Quindi scaricano il client e a quel punto Webex recuperano alcune configurazioni aggiuntive su di esse da BroadWorks (inclusi i numeri principali).
-
SP Controlled Provisioning via APIs: Webex sono esposti una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei flussi di lavoro esistenti.
Provisioning Requirements
The following table summarizes the requirements for each provisioning method. In addition to these requirements, your deployment must meet the general system requirements that are described in this guide.
Provisioning Method |
Requisiti |
---|---|
Provisioning Flow (Trusted or Untrusted emails) |
The Webex provisioning API adds existing BroadWorks users to Webex automatically once the user meets requirements and you toggle the Integrated IM+P service to on. There are two flows (trusted emails or untrusted emails) which you assign via the Onboarding template on Webex. BroadWorks requirements:
Webex requirements: The Onboarding template includes the following settings:
|
Self-Provisioning utente |
Admin provides an existing BroadWorks user with a link to the User Activation Portal. The user must log in to the portal using BroadWorks credentials and provide a valid email address. After the email is validated, Webex fetches additional user information to complete provisioning. BroadWorks requirements:
Webex requirements: The Onboarding template includes the following settings:
|
SP controlled provisioning via API (Trusted or Untrusted emails) |
Webex exposes a set of public APIs that enable you to build user provisioning into your existing workflows and tools. There are two flows:
BroadWorks Requirements:
Webex Requirements:
To use the APIs, go to BroadWorks Subscribers. |
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Install AP.as.22.0.1123.ap376508.
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Install AP.as.23.0.1075.ap376509
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Install AP.as.24.0.944.ap375100
-
After installation, set the property
bw.msg.includeIsEnterpriseInOSSschema
totrue
from the CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Supported Language Locales
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente amministrativo predisposto viene assegnata automaticamente come impostazioni internazionali predefinite per tale organizzazione cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti alle riunioni in tale organizzazione del cliente.
Five character language locales in (ISO-639-1)_(ISO-3166) format are supported. For example, en_US corresponds to English_UnitedStates. If only a two letter language is requested (using ISO-639-1 format), the service will generate a five character language locale by combining the requested language with a country code from the template i.e. "requestedLanguage_CountryCode", if unable to get a valid locale, then the default sensible locale used based on the required language code.
The following table lists the supported locales, and the mapping that converts a two-letter language code to a five-character locale for situations where a five-character locale is not available.
Supported Language Locales (ISO-639-1)_(ISO-3166) |
If only a two-letter language code is available... | |
---|---|---|
Language code (ISO-639-1) ** |
Use Default Sensible Locale instead (ISO-639-1)_(ISO-3166) | |
en_US en_AU en_GB en_Ca |
en |
en_US |
fr_Fr fr_Ca |
Fr |
fr_Fr |
cs_CZ |
cs |
cs_CZ |
da_Dk |
da |
da_Dk |
de_DE |
DE |
de_DE |
hu_Hu |
hu |
hu_Hu |
id_ID |
Identificativo |
id_ID |
it_IT |
IT |
it_IT |
ja_JP |
ja |
ja_JP |
ko_Kr |
ko |
ko_Kr |
es_ES es_CO es_MX |
ES |
es_ES |
nl_NL |
NL |
nl_NL |
nb_NO |
nb |
nb_NO |
pl_PL |
pl |
pl_PL |
pt_PT pt_Br |
pt |
pt_PT |
ru_RU |
RU |
ru_RU |
ro_RO |
ro |
ro_RO |
zh_Cn zh_TW |
zh |
zh_Cn |
sv_SE |
sv |
sv_SE |
ar_Sa |
ar |
ar_Sa |
tr_Tr |
tr |
tr_Tr |
The locales es_CO, id_ID, nb_NO and pt_PT are not supported by Webex Meeting Sites. For these locales, The Webex Meetings sites will be in English only. English is the default locale for sites if no/invalid/unsupported locale is required for the site. This language field is applicable while creating an Organization and Webex Meetings site. If no language is mentioned in a post or in the subscriber's API then language from the template will be used as a default language.
Branding
Gli amministratori dei partner possono utilizzare personalizzazioni di branding avanzate per personalizzare il modo in cui l'app Webex cerca le organizzazioni dei clienti gestite dal partner. Gli amministratori dei partner possono personalizzare le seguenti impostazioni per assicurarsi che l'app Webex rifletta il marchio e l'identità della propria società:
-
Loghi aziendali
-
Schemi di colore univoci per la modalità chiaro o la modalità scura
-
URL di supporto personalizzati
For details on how to customize branding, refer to Configure Advanced Branding Customizations.
-
Basic Branding customizations are in the process of being deprecated. We recommend that you deploy Advanced Branding, which offers a wider range of customizations.
-
For details on how branding is applied when attaching to a pre-existing Customer Organization, refer to Conditions of Org Attachment under the Attach Webex for BroadWorks to Existing Organization section.
Onboarding templates
Onboarding templates allow you to define the parameters by which customers and associated subscribers are automatically provisioned on Webex for Cisco BroadWorks. You may configure multiple Onboarding templates as required, but when you onboard a customer it is associated with only one template (you cannot apply multiple templates to one customer).
Di seguito sono elencati alcuni parametri del modello principale.
Pacchetto
-
È necessario selezionare un pacchetto predefinito quando si crea un modello (per informazioni dettagliate, vedere Pacchetti nella sezione Panoramica). Tutti gli utenti predisposti con tale modello, mediante flusso o auto-provisioning, ricevono il pacchetto predefinito.
-
È possibile controllare la selezione del pacchetto per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori per provisioning aziendali, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
-
You can change the package of specific subscribers from this default, using the provisioning API (see Webex for Cisco BroadWorks API documentation or through Partner Hub (see Change User Package in Partner Hub).
-
Non è possibile modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è disattivata; se l'abbonato è assegnato a questo servizio in BroadWorks, il modello Hub partner associato all'URL di provisioning di tale azienda definisce il pacchetto.
Rivenditori e aziende o provider di servizi e gruppi?
-
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se si è un rivenditore con Aziende, è necessario abilitare la modalità Enterprise quando si crea un modello.
-
Se il sistema BroadWorks è configurato in provider di servizi modalità aziendale, è possibile lasciare disattivata la modalità Enterprise nei modelli.
-
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Modalità di autenticazione
Decide how you want subscribers to authenticate when they log in to Webex. You can assign the mode using the Authentication Mode setting in the Onboarding template. The following table outlines some of the options.
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | File BroadWorks ID utente | Indirizzo e-mail |
provider di identità |
BroadWorks.
| Cisco Common Identity |
Autenticazione multi-fattori? | No | Richiede un IdP cliente che supporti l'autenticazione a più fattori. |
Percorso di convalida credenziali
|
|
|
UTF-8 Encoding with BroadWorks Authentication
With BroadWorks authentication, we recommend that you configure UTF-8 encoding for the authentication header. UTF-8 resolves an issue that can occur with passwords that use special characters whereby the web browser does not encode the characters properly. Using a UTF-8 encoded, base 64-encoded header resolves this issue.
You can configure UTF-8 encoding by running one of the following CLI commands on the XSP or ADP:
-
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
-
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
Paese
You must select a country when you create a template. This country will be automatically assigned as the organisation country for all the customers that are provisioned with the template in Common Identity. Additionally, the organization country will determine the default global call-in numbers for Cisco PSTN in Webex Meeting Sites.
The site's default global call-in numbers will be set to the first available dial-in number defined in the telephony domain based on the organization's country. If the organization's country is not found in the dial-in number defined in the telephony domain, the default number of that location will be used.
S No. |
Sede |
Prefisso internazionale |
Nome paese |
---|---|---|---|
1 |
AMER |
+1 |
US, CA |
2 |
APAC |
+65 |
Singapore |
3 |
Anz |
+61 |
Australia |
4 |
EMEA |
+44 |
REGNO UNITO |
5 |
EURO |
+49 |
Germania |
Accordi con più partner
Si desidera utilizzare la licenza secondaria di Webex per Cisco BroadWorks con un altro provider di servizi? In tal caso, ciascun fornitore di servizi avrà bisogno di un'organizzazione partner distinta Webex Control Hub permettere loro di fornire la soluzione per la propria base clienti.
Adattatore e modelli di provisioning
Quando si utilizza il provisioning flowre, l'URL di provisioning inserito in BroadWorks è derivato dal modello in Control Hub. È possibile disporre di più modelli e, quindi, di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati quando hanno ottenuto la concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e il modello che si desidera utilizzare. In questo modo, è necessario solo impostare in modo esplicito l'URL di provisioning per le aziende che necessitano di un modello diverso.
Tenere presente, inoltre, che potrebbe essere stato già utilizzato un URL di provisioning a livello di sistema, ad esempio UC-One SaaS. If that is the case, you may opt to preserve the system level URL for provisioning users on UC-One SaaS, and override for those enterprises moving to Webex for Cisco BroadWorks. In alternativa, è possibile passare al percorso alternativo e impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
The configuration choices related to this decision are detailed in Configure Application Server with Provisioning Service URL.
Provisioning Adapter Proxy
For added security, the Provisioning Adapter Proxy lets you use an HTTP(S) proxy on the Application Delivery Platform for flowthrough provisioning between the AS and Webex. The proxy connection creates an end-to-end TCP tunnel that relays traffic between the AS and Webex, thereby negating the need for the AS to connect to the public internet directly. For secure connections, TLS can be used.
This feature requires that you set up the proxy on BroadWorks. For details, see Cisco BroadWorks Provisioning Adapter Proxy Feature Description.
Requisiti minimi
Account
Tutti gli abbonati disponibili per Webex devono esistere nel sistema BroadWorks integrato con Webex. Se necessario, è possibile integrare più sistemi BroadWorks.
All subscribers must have BroadWorks licenses and a primary number or extension.
Webex utilizza gli indirizzi e-mail come identificativi principali per tutti gli utenti. Se si utilizza il provisioning flow con messaggi e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail dell'abbonato nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le relative password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Server nella rete e requisiti software
-
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. For more information, see BroadSoft products lifecycle policy section in BroadSoft Lifecycle Policy and BroadWorks Software Compatibility Matrix.
-
Le istanze BroadWorks devono includere almeno i seguenti server:
-
Server applicazioni (AS) con versione BroadWorks come indicato sopra
-
Server di rete (NS)
-
Server di profilo (PS)
-
-
Public-facing XSP|ADP Server(s) or Application Delivery Platform (ADP) meeting the following requirements:
-
Servizio di autenticazione (BWAuth)
-
Interfacce azioni ed eventi XSI
-
DMS (applicazione Web di gestione dispositivi)
-
Interfaccia CTI (integrazione di telefonia su computer)
-
TLS 1.2 con un certificato valido (non autofirmato) ed eventuali intermedie richiesti. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
-
Autenticazione TLS reciproca (mTLS) per il servizio di autenticazione (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
Autenticazione TLS reciproca (mTLS) per interfaccia CTI (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
-
Un server XSP/ADP separato funge da "server push notifiche di chiamata" (un server NPS nel proprio ambiente utilizzato per eseguire il push delle notifiche di chiamata ad Apple/Google. Questo tipo di chiamata "CNPS" viene chiamata qui per distinguerlo dal servizio in Webex che offre notifiche push per messaggistica e presenza).
Questo server deve essere su R22 o versioni successive.
-
È obbligatorio creare un server XSP/ADP separato per CNPS poiché l'impossibilità di caricare da Webex per connessioni cloud BWKS potrebbe avere un impatto negativo sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. See the Cisco BroadWorks System Engineering Guide for more on XSP|ADP scale.
Piattaforme app Webex
To download the English version of the Webex App, go to https://www.webex.com/webexfromserviceproviders-downloads.html. The Webex App is available on:
-
PC/laptop Windows
-
PC Apple / laptop con MacOS
-
iOS (Apple store)
-
Android (Play store)
-
Web browsers (go to https://teams.webex.com/)
Localized Versions
To download a localized version of the Webex App, use one of these links:
-
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (Korean)
-
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (French)
-
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (Portuguese)
-
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (Chinese Traditional)
-
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (Chinese Simplified)
-
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Japan)
-
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spain)
-
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (German)
-
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (Italian)
Telefoni e accessori fisici
-
Telefoni IP Cisco:
-
Cisco IP Phone serie 6800 con firmware Multitform
-
Cisco IP Phone serie 7800 con firmware Multitform
-
Cisco IP Phone serie 8800 con firmware Multitform
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html modelli e ulteriori informazioni, vedere .
-
-
I telefoni di terze parti sono supportati allo stesso modo delle altre integrazioni BroadWorks. Tuttavia, non dispongono ancora di contatti e integrazione di presenza con Webex per Cisco BroadWorks.
-
Adapters:
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 191
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 192 Multiplatform
Per https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html modelli e ulteriori informazioni, vedere .
-
-
Headsets:
-
Cisco Headset serie 500
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html modelli e ulteriori informazioni, vedere .
-
-
Room OS Devices:
-
Webex Room and Room Kit Series
-
Serie Webex Desk
-
Serie Webex Board
-
Device Integration
For details on how to onboard and service Room OS and MPP devices for Webex for Cisco BroadWorks, see Device Integration Guide for Webex for Cisco BroadWorks.
Profili dispositivi
Following are the DTAF files you need to load onto your Application Servers to support the Webex App as a calling client. They are the same DTAF files as used for UC-One SaaS, however there is a new config-wxt.xml.template
file that is used for the Webex App.
To download the latest device profiles, go to the Application Delivery Platform Software Downloads site to get the latest DTAF files. These downloads work for both ADP and XSP.
Nome client |
Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Business Communicator - PC DTAF: File di configurazione: |
Identify/Device Profile
All Webex for Cisco BroadWorks users must have an Identity/Device Profile assigned in BroadWorks that uses one of the above device profiles in order to make calls using the Webex App. The profile provides the configuration that allows the user to place calls.
Obtaining OAuth credentials for your Webex for Cisco BroadWorks
Raise a service request with your onboarding agent or with Cisco TAC to provision Cisco OAuth for your Cisco Identity Provider Federation account.
Use the following request title for respective features:
-
XSP|ADP AuthService Configuration' to configure service on XSP|ADP.
-
'NPS Configuration for Auth Proxy Setup' to configure NPS to use authentication proxy.
-
CI User UUID Sync' for CI user UUID sync. For more details on this feature, see: Cisco BroadWorks support for CI UUID.
-
Configure BroadWorks to enable Cisco Billing for BroadWorks and Webex For BroadWorks Subscriptions.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento validi per 60 giorni. If the token expires before you use it, you can raise another request.
If you already obtained Cisco OAuth Identity Provider credentials, complete a new service request to update your credentials.
Ordina certificati
Requisiti di certificato per l'autenticazione TLS
You will need Security Certificates, signed by a well-known Certificate Authority and deployed on your Public facing XSP|ADPs, for all required applications. These will be used to support TLS certificate verification for all inbound connectivity to your XSP|ADP servers.
These certificates should include your XSP|ADP public fully qualified domain name as Subject Common Name or Subject Alternate Name.
The exact requirements for deploying these server certificates depends on how your public facing XSP|ADPs are deployed:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Directly to the XSP|ADP
Il diagramma seguente riepiloga dove deve essere caricato il certificato del server pubblico firmato da CA in questi tre casi:
Le CA pubblicamente supportate che l'app Webex supporta per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per il proxy con bridge TLS
-
Il certificato del server firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta questo certificato server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
An internal CA signed certificate can be loaded onto the XSP|ADP.
-
The XSP|ADP presents this internally signed server certificate to the proxy.
-
The proxy trusts the internal CA that signed the XSP|ADP server certificate.
TLS Certificate Requirements for TLS-passthrough Proxy or XSP|ADP in DMZ
-
The publicly signed server certificate is loaded into the XSP|ADPs.
-
The XSP|ADPs present publicly signed server certificates to Webex.
-
Webex trusts the public CA that signed the XSP|ADPs’ server certificates.
Ulteriori requisiti di certificato per l'autenticazione TLS reciproca su interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione TLS reciproca. Il certificato CA/catena di certificati del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedere a Partner Hub, andare a Impostazioni >
collegamento di download del certificato.The exact requirements for deploying this Webex CA certificate chain depends on how your public facing XSP|ADPs are deployed:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Directly to the XSP|ADP
Il diagramma seguente riepiloga i requisiti dei certificati in questi tre casi:
(Opzione) Requisiti di certificato per proxy tls-bridge
-
Webex presenta un certificato client firmato pubblicamente al proxy.
-
Il proxy considera attendibile la CA interna Cisco che ha firmato il certificato client. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. The publicly signed XSP|ADP server certificate is also loaded into the proxy.
-
Il proxy presenta il certificato del server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
The proxy presents an internally signed client certificate to the XSP|ADPs.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3: Uso chiave estesa X509v3: 1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Il CN del certificato interno deve essere
bwcticlient.webex.com
.-
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. Internal server certificates for the XSP|ADP can be SAN.
-
Le autorità di certificazione pubbliche potrebbero non voler firmare i certificati con il OID broadworks proprietario richiesto. In the case of a bridging proxy, you may be forced to use an internal CA to sign the client certificate that the proxy presents to the XSP|ADP.
-
-
The XSP|ADPs trust the internal CA.
-
The XSP|ADPs present an internally signed server certificate.
-
Il proxy considera attendibile la CA interna.
-
The Application Server’s ClientIdentity contains the CN of the internally signed client certificate presented to the XSP|ADP by the proxy.
(Option) Certificate Requirements for TLS-passthrough Proxy or XSP|ADP in DMZ
-
Webex presents a Cisco internal CA-signed client certificate to the XSP|ADPs.
-
The XSP|ADPs trust the Cisco internal CA that signed the client certificate. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. The publicly signed XSP|ADP server certificate is also loaded into the XSP|ADPs.
-
The XSP|ADPs present the publicly signed server certificates to Webex.
-
Webex trusts the public CA that signed the XSP|ADPs’ server certificates.
-
The Application Server ClientIdentity contains the CN of the Cisco-signed client certificate presented to the XSP|ADP by Webex.
Preparazione della rete
For more information on connections that are used by Webex for Cisco BroadWorks, see: Network Requirements for Webex for Cisco BroadWorks. This article has the list of IP addresses, ports and protocols required to configure your firewall Ingress and Egress rules.
Requisiti di rete per i servizi Webex
Le tabelle del firewall in entrata ed uscita precedenti documenta solo le connessioni specifiche per Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico a Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e come ciascuna sezione è relativa a Webex per Cisco BroadWorks.
Sezione dell'articolo requisiti di rete |
Gestione delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex |
Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud |
Informativo |
È necessario leggere | |
È necessario leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex |
È necessario leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione |
Opzionale |
Servizi Webex per clienti FedRAMP |
N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedere Whitepaper (PDF) del firewall appWebex.
Supporto ridondanza BroadWorks
The Webex Cloud Services and the Webex Client Apps that need to access the partner’s network fully support the Broadworks XSP|ADP redundancy provided by the partner. When an XSP|ADP or site is unavailable for planned maintenance or unplanned reason, the Webex services & apps are able to advance to another XSP|ADP or site provided by the partner in order to complete a request.
Topologia di rete
The Broadworks XSP|ADPs can be deployed directly on the Internet, or can reside in a DMZ fronted by a load balancing element such as the F5 BIG-IP. To provide geo-redundancy, the XSP|ADPs can be deployed in two (or more) datacenters, each can be fronted by a load balancer, each having a public IP address. If the XSP|ADPs are behind a load balancer, the Webex microservices and App see only the IP address of the load balancer and Broadworks appears to have just one XSP|ADP, even if there are multiple XSP|ADPs behind.
In the example below, the XSP|ADPs are deployed at two sites, Site A and Site B. There are two XSP|ADPs fronted by a Load Balancer at each site. Site A has XSP|ADP1 and XSP|ADP2 fronted by LB1, and Site B has XSP|ADP3 and XSP|ADP4 fronted by LB2. Only the Load Balancers are exposed on the public network, and the XSP|ADPs are in the DMZ private networks.
Servizi Cloud Webex
Configurazione DNS
The Webex Cloud microservices must be able to find the Broadworks XSP|ADP server(s) for connecting to the Xsi interfaces, authentication service and CTI.
Webex Cloud microservices will perform DNS A/AAAA lookup of the configured XSP|ADP hostname and connect to the returned IP Address. This could be a load balancing edge element, or it could be the XSP|ADP server itself. Se vengono restituiti più indirizzi IP, verrà selezionato il primo IP nell'elenco. SRV ricerca non sono attualmente supportate.
Esempio: The partner’s DNS A Record for discovery of Round-Robin balanced internet-facing XSP|ADP server/Load Balancers.
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (Sito A) |
R |
|
|
Punti a LB2 (Sito B) |
Any reference to XSP includes either XSP or ADP.
Failover
When the Webex microservices send a request to the XSP|ADP/Load Balancer and the request fails, several things can happen:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un avanzamento di route al successivo IP.
-
If an error code (HTTP 5xx) is returned, the Webex microservices mark the IP as blocked and immediately perform a route advance to the next IP.
-
Se non si riceve alcuna risposta HTTP entro 2 secondi, si verifica un timeout della richiesta e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento all'IP successivo.
Ogni richiesta viene provata 3 volte prima che un problema venga segnalato al microservizio.
When an IP is in the blocked list, it will not be included in the list of addresses to try when sending a request to a XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna all'elenco per riprovare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco dei contatti bloccati. Se tale indirizzo IP viene rimosso dall'elenco dei contatti bloccati.
Stato
The status of the connectivity of the Webex Cloud services to the XSP|ADPs or Load Balancers can be seen in Control Hub. In un cluster di chiamata BroadWorks, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
-
Azioni XSI
-
Eventi XSI
-
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Lo stato delle connessioni può essere:
-
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
-
Rosso: Quando tutti gli IP nella ricerca dei record A sono irraggiungibili e l'interfaccia non è disponibile.
The following services use the microservices to connect to the XSP|ADPs and are impacted by the XSP|ADP interface availability:
-
Accesso all'app Webex
-
Aggiornamento token app Webex
-
E-mail/attivazione automatica non attendibile
-
Controllo stato servizio Broadworks
Webex App
Configurazione DNS
The Webex App accesses the Xtended Services Interface (XSI-Actions & XSI-Events) and Device Management Service (DMS) services on the XSP|ADP.
To find the XSI service, the Webex App performs DNS SRV lookup for _xsi-client._tcp.<webex app xsi domain>
. The SRV points to the configured URL for the XSP|ADP hosts or load balancers for the XSI service. If SRV lookup is not available, the Webex App falls back to A/AAAA lookup.
The SRV can resolve to multiple A/AAAA targets. However, each A/AAAA record must map to a single IP address only. If there are multiple XSP|ADPs in a DMZ behind the load balancer/edge device, it is required that the load balancer be configured to maintain session persistence to route all requests of the same session to the same XSP|ADP. We mandate this configuration because the client's XSI-event heartbeats must go to the same XSP|ADP that is used to establish the event channel.
In Example 1, the A/AAAA record for webex-app-XSP|ADP.example.com does not exist, and does not need to. If your DNS requires that one A/AAAA record must be defined, then only 1 IP address should be returned. Regardless, the SRV must still be defined for the Webex App.
If the Webex App uses the A/AAAA name that resolves to more than one IP address, or if the load balancer/edge element does not maintain session persistence, the client eventually sends heartbeats to an XSP|ADP where it did not establish an event channel. This results in the channel being torn down, and also in significantly more internal traffic which impairs your XSP|ADP cluster performance.
Because the Webex Cloud and Webex App have different requirements in A/AAAA record lookup, you must use a separate FQDN for the Webex Cloud and Webex App to access your XSP|ADPs. As shown in the examples, Webex Cloud uses A record webex-cloud-xsp.example.com
, and Webex App uses SRV _xsi-client._tcp.webex-app-xsp.example.com
.
Example 1—Multiple XSP|ADPs, each behind separate load balancers
In this example, the SRV points to mutiple A records with each A record pointing to a different load balancer at a different site. The Webex App will always use the first IP address in the list and will only move to the next record if the first is down.
Di seguito è riportato un esempio di SRV record.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Example 2—Multiple XSP|ADPs behind a single load balancer (with TLS Bridge)
For the initial request, the load balancer selects a random XSP|ADP. That XSP|ADP returns a cookie that the Webex App includes in future requests. For future requests, the load balancer uses the cookie to route the connection to the correct XSP|ADP, ensuring that the event channel doesn't break.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Load balancer |
R |
LB.example.com |
|
IP address of load balancer (XSP|ADPs are behind load balancer) |
DMS URL
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il relativo file di configurazione. The host in the URL will parsed and the Webex App will perform DNS A/AAAA lookup of the host to connect to the XSP|ADP that hosts the DMS service.
Esempio: DNS A Record for discovery of Round-Robin balanced internet-facing XSP|ADP server/Load Balancers by Webex App to download config files through DMS:
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
How Webex App Finds XSP|ADP Addresses
The client attempts to locate the XSP|ADP nodes using the following DNS flow:
-
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (inserito durante la creazione del cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue SRV ricerca nel modo seguente:
-
Client performs an SRV lookup for _xsi-client._tcp.<xsi domain>
-
If the SRV lookup returns one or more A/AAAA targets:
-
Il client esegue una ricerca A/AAAA di tali destinazioni e memorizza nella cache gli indirizzi IP restituiti.
-
Il client si connette a uno dei destinazioni (e pertanto, il relativo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi avere lo stesso peso (o a caso se tutti sono uguali).
-
-
Se la ricerca SRV ricerca non restituisce eventuali obiettivi:
Il client esegue una ricerca A/AAAA del parametro radice Xsi, quindi tenta di connettersi all'indirizzo IP restituito. This could be a load balancing edge element, or it could be the XSP|ADP server itself.
Come specificato, il record A/AAAA deve risolversi in un indirizzo IP per gli stessi motivi.
-
-
(Opzionale) In un secondo tempo, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocols> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
-
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
-
Se esistono, il client verrà confrontato con l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
-
Se vengono rilevate eventuali differenze, il client inizializza nuovamente la connettività XSI Actions/ XSI Events. The first step in this is to perform the same DNS lookup process listed under step 1 – this time requesting a lookup for the value in the %XSI_ROOT_WXT% parameter from its configuration file.
Creare i record delle SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
-
Failover
During login, the Webex App performs a DNS SRV lookup for _xsi-client._tcp.<xsi domain>, builds a list of hosts, and connects to one of the hosts based on the SRV priority, then weight. Questo ospite connesso diventa il selezionato per tutte le richieste future. Un canale di evento viene quindi aperto all'organizzatore selezionato e un heartbeat viene inviato regolarmente per verificare il canale. All requests sent after the first one include a cookie that is returned in the HTTP response, therefore, it’s important that the load balancer keeps session persistence (affinity) and always sends requests to the same backend XSP|ADP server.
In caso di errore di una richiesta o di una richiesta heartbeat a un host, si possono verificare diverse operazioni:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), l'instradazione dell'app Webex avanza immediatamente al successivo organizzatore nell'elenco.
-
If an error code (HTTP 5xx) is returned, the Webex App marks that IP address as blocked and route advances to the next host on the list.
-
Se non si riceve una risposta entro un determinato periodo di tempo, la richiesta viene considerata non riuscita a causa di un timeout e le successive richieste vengono inviate all'organizzatore successivo. Tuttavia, la richiesta di timeout viene considerata come non riuscita. Si è verificato un tentativo in seguito ad alcune richieste in seguito a un errore (con un aumento del tempo di tentativo). Non si sono effettuate nuovamente richieste che presupponete non vitali.
Quando si prova correttamente un nuovo organizzatore, diventa il nuovo organizzatore selezionato, se è presente nell'elenco. Una volta tentato l'ultimo organizzatore nell'elenco, l'app Webex viene rollover a quella del primo.
In caso di heartbeat, se ci sono due errori di richiesta consecutivi, l'app Webex inizializza nuovamente il canale dell'evento.
Tenere presente che l'app Webex non esegue il fail-back e il rilevamento del servizio DNS viene eseguito una sola volta all'accesso.
During sign-in, the Webex App tries to download the config file through the XSP|ADP/Dms interface. Esegue una ricerca dei record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Si tenterà prima di inviare la richiesta di download del file di configurazione utilizzando un token SSO configurazione. Se questo non riesce, verrà riprovare ma con il nome utente e la password del dispositivo.
Distribuisci Webex per BroadWorks
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning utente. Molte attività sono comuni a tutte le modalità di provisioning.
Accesso ai partner per Webex per Cisco BroadWorks
Ogni Webex per Cisco BroadWorks provider di servizi o rivenditore necessita di un da impostare come organizzazione partner per Webex per Cisco BroadWorks. È possibile utilizzare questa opzione se si dispone di un'organizzazione partner Webex esistente.
Per completare il necessario onboarding, è necessario eseguire i documenti di Webex Cisco BroadWorks e i nuovi partner devono accettare il Contratto di partner per i canali indiretti online (ICPA). Al termine di questa procedura, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore del record come richiesto. Contemporaneamente, si verrà contattati dal Proprio Partner Activation e/o Customer Success Program Manager per avviare il proprio onboarding.
Webex Partners in one region can create customer organizations in any region that we offer the services. Per informazioni, vedere: Data residency in Webex.
Configure Services on Your Webex for Cisco BroadWorks XSP|ADPs
We require that the NPS application be run on a different XSP|ADP. Requirements for that XSP|ADP are described in Configure Call Notifications from your Network.
You need the following applications / services on your XSP|ADPs.
Servizio/Applicazione |
Autenticazione richiesta |
Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
Autenticazione utente |
Integrazione di telefonia su computer |
mTLS (client e server si autenticano l'un l'altro) |
Presenza in telefonia |
Impostazioni chiamata Applicazione vista Web |
TLS (il server esegue l'autenticazione per i client) |
Sono esposti le impostazioni di chiamata dell'utente nel portale auto assistenza all'interno dell'app Webex |
This section describes how to apply the required configurations for TLS and mTLS on these interfaces, but you should reference existing documentation to get the applications installed on your XSP|ADPs.
Requisiti di co-residenza
-
Il servizio di autenticazione deve risiedere insieme ad applicazioni Xsi, poiché tali interfacce devono accettare token lunghi per l'autorizzazione del servizio. Il servizio di autenticazione è necessario per convalidare tali token.
-
Il servizio di autenticazione e Xsi possono essere eseguiti sulla stessa porta, se richiesta.
-
You may separate the other services/applications as required for your scale (dedicated device management XSP|ADP farm, for example).
-
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
-
Do not install other applications or services on the XSP|ADPs that are used for integrating BroadWorks with Webex.
-
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi connettori Cisco BroadWorks.
Only one instance of the Xsi-Events applications should be deployed on the XSP|ADP used for the CTI interface.
All Xsi-Events used for integrating Broadworks with Webex must have the same callControlApplicationName defined under Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
When a user is onboarded to Webex, Webex creates a subscription for the user on the AS in order to receive telephony events for presence and call history. The subscription is associated with the callControlApplicationName and the AS uses it to know to which Xsi-Events to send the telephony events.
Changing the callControlApplicationName, or not having the same name on all Xsi-Events webapps will impact subscriptions and telephony events functionality.
Configurazione del servizio di autenticazione (con convalida token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida di token CI con TLS. Questo metodo di autenticazione è consigliato se si utilizza R22 o superiore e il sistema supporta tale opzione.
L'autenticazione TLS reciproca (mTLS) è supportata anche come metodo di autenticazione alternativo per il servizio di autenticazione. If you have multiple Webex organizations running off the same XSP|ADP server, you must use mTLS authentication because CI Token Validation does not support multiple connections to the same XSP|ADP Auth Service.
Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida di token CI, fare riferimento all'Appendice per la configurazione dei servizi (con mTLS per il servizio diautenticazione).
-
Obtaining OAuth credentials for your Webex for Cisco BroadWorks.
-
Install the following patches on each XSP|ADP server. Installare le patch appropriate alla release in oggetto:
-
Per R22:
-
Per R23:
-
Per R24— nessuna patch richiesta
Any reference to XSP includes either XSP or ADP. -
-
Install the
AuthenticationService
application on each XSP|ADP service.Run the following command to activate the AuthenticationService application on the XSP|ADP to the /authService context path.
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService
Run this command to deploy the AuthenticationService on the XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...
-
Starting with Broadworks build 2022.10, the certificates authorities that are coming with Java are no longer automatically included to the BroadWorks trust store when switching to a new version of java. The AuthenticationService opens a TLS connection to Webex to fetch the access token, and needs to have the following in its truststore to validate the IDBroker and Webex URL:
-
Radice commerciale IdenTrust CA 1
-
Autorità di certificazione radice di Go Daddy-G2
Verify that these certificates are present under the following CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get
If not present, run the following command to import the default Java trusts:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
Alternatively, you can manually add these certificates as trust anchors with the following command:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
If the ADP is upgraded from a previous release, then the certificate authorities from the old release are automatically imported to the new release and will continue to be imported until they are manually removed.
The AuthenticationService application is exempt from the validatePeerIdentity setting under ADP_CLI/System/SSLCommonSettings/GeneralSettings, and always validates the peer Identity. See the Cisco Broadworks X509 Certificate Validation FD for more info on this setting.
-
-
Configure the Identity Providers by running the following commands on each XSP|ADP server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get
-
set clientId client-Id-From-Step1
-
set enabled true (impostazione abilitata) vero
-
set clientSecret client-Secret-From-Step1
-
impostazione di ciResponseBodyMaxSizeInBytes 65536
-
set issuerName <URL>
—For theURL
, enter the IssuerName URL that applies to your CI Cluster. See following table. -
set issuerUrl <URL>
—For theURL
, enter the IssuerUrl that applies to your CI Cluster. See the following table. -
set tokenInfoUrl <IdPProxy URL>
—Enter the IdP Proxy URL that applies to your Teams Cluster. See the second table that follows.
Tabella 1. Set issuerName and issuerURL Se Cluster CI è... Set issuerName and issuerURL to... USA-A
UE
USA-B
If you don't know your CI Cluster, you can obtain the information from the Customer details in Help Desk view of Control Hub.Tabella 2. Set tokenInfoURL Se Cluster Teams è... Set tokenInfoURL to...(IdP Proxy URL) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Afra
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
-
If you don't know your Teams Cluster, you can obtain the information from the Customer details in the Help Desk view of Control Hub.
-
For testing, you can verify that the tokenInfoURL is valid by replacing the "
idp/authenticate
" portion of the URL with "ping
".
-
-
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user
-
Configure Identity Providers for Cisco Federation using the following commands on each XSP|ADP server:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get
-
impostazione flsUrl https://cifls.webex.com/federation
-
impostare refreshPeriodInMinutes 60
-
set refreshToken refresh-Token-From-Step1
-
-
Eseguire il comando seguente per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get
-
Configure Token Management using the following commands on each XSP|ADP server:
-
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
-
set tokenIsshe BroadWorks
-
impostare tokenDurationInHours 720
-
-
Generare e condividere le chiavi RSA. You must generate keys on one XSP|ADP then copy them to all other XSP|ADPs. Ciò è dovuto ai seguenti fattori:
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittografia di token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
If you cycle keys or change the key length, you need to repeat the following configuration and restart all the XSP|ADPs.-
Select one XSP|ADP to use for generating a key pair.
-
Use a client to request an encrypted token from that XSP|ADP, by requesting the following URL from the client’s browser:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(This generates a private / public key pair on the XSP|ADP, if there wasn’t one already)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
-
Copy the exported file
/var/broadworks/tmp/authService.keys
to the same location on the other XSP|ADPs, overwriting an older.keys
file if necessary. -
Import the keys on each of the other XSP|ADPs:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
-
-
Fornire l'URL authService al contenitore Web. The XSP|ADP’s web container needs the authService URL so it can validate tokens. On each of the XSP|ADPs:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per lo strumento di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
set url http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Controllare il parametro con
get
. -
Restart the XSP|ADP.
-
Rimozione del requisito di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con convalida token CI su R24, occorre anche rimuovere il requisito di autenticazione del client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e della crittografia sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurazione TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > trasporto > http > interfaccia Server HTTP = Più specifico
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Reading HTTP Server TLS Interface Configuration on the XSP|ADP
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il
comando get e leggere i
risultati. Dovrebbero essere presenti le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Tomcat obbligatorio un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
È necessario configurare l'interfaccia HTTP che interagisce con Webex Cloud per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Enter the command
get <interfaceIp> 443
to see which protocols are already used on this interface. -
Enter the command
add <interfaceIp> 443 TLSv1.2
to ensure that interface can use TLS 1.2 when communicating with the cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia del server HTTP
Per configurare i crittografia richiesti:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Enter the command
get <interfaceIp> 443
to see which ciphers are already used on this interface. There must be at least one from the Cisco recommended suites (see XSP|ADP Identity and Security Requirements in the Overview section). -
Enter the command
add <interfaceIp> 443 <cipherName>
to add a cipher to the HTTP Server interface.The XSP|ADP CLI requires the IANA standard cipher suite name, not the openSSL cipher suite name. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
del server HTTP, utilizzare:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configure Device Management on XSP|ADP, Application Server, and Profile Server
Profile Server and XSP|ADP are mandatory for Device Management. Tali impostazioni devono essere configurate in base alle istruzioni nella Guida alla configurazione di Gestione dispositivi BroadWorks.
Interfaccia CTI e configurazione correlata
L'ordine di configurazione "in primo piano" è elencato di seguito. I seguenti ordini non sono obbligatori.
-
Configurazione del server applicazioni per sottoscrizioni CTI
-
Configure XSP|ADPs for mTLS Authenticated CTI Subscriptions
-
Porte in entrata aperte per interfaccia CTI sicura
-
Sottoscrizione della propria organizzazione Webex a BroadWorks CTI Events
Configurazione del server applicazioni per sottoscrizioni CTI
Aggiornare clientIdentity sul server applicazioni con il nome comune (CN) del Webex per il certificato client CTI Cisco BroadWorks.
Per ogni server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity nel modo seguente:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
The common name of the Webex for Cisco BroadWorks client certificate is bwcticlient.webex.com
.
Configurare TLS e i tipi di crittografia sull'interfaccia CTI
The levels of configurability for the XSP|ADP CTI interface are as follows:
Più generale = Sistema > trasporto > CTI > interfaccia CTI = Più specifiche
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità |
Contesto CLI |
---|---|
Sistema (globale) (R22 e successive) |
XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e successive) |
XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e successive) |
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocols> |
Un'interfaccia CTI specifica su questo sistema (R22 e successive) |
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocols> |
On a fresh install, the following ciphers are installed by default at the system level. If nothing is configured at the interface level (for example, at the CTI interface or HTTP interface), this cipher list applies. Note that this list may change over time:
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
-
TLS_DHE_DSS_WITH_AES_128_GCM_SHA256
-
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_DHE_DSS_WITH_AES_128_CBC_SHA256
-
TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256
Reading CTI TLS Interface Configuration on the XSP|ADP
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserire il
comando get e leggere i
risultati. Dovrebbero essere disponibili le interfacce (indirizzi IP) e, per ciascuna, se richiedono un certificato del server e se richiedono o meno l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
The XSP|ADP CTI interface that is interacting with the Webex Cloud must be configured for TLS v1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
-
Enter the command
get <interfaceIp>
to see which protocols are already used on this interface. -
Enter the command
add <interfaceIp> TLSv1.2
to ensure that interface can use TLS 1.2 when communicating with the cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia CTI
Per configurare i tipi di crittografia richiesti sull'interfaccia CTI:
-
Sign in to the XSP|ADP and navigate to
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
-
Immettere il
comando get per visualizzare i tipi di crittografia già utilizzati su questa
interfaccia. There must be at least one from the Cisco recommended suites (see XSP|ADP Identity and Security Requirements in the Overview section). -
Enter the command
add <interfaceIp> <cipherName>
to add a cipher to the CTI interface.The XSP|ADP CLI requires the IANA standard cipher suite name, not the openSSL cipher suite name. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
CTI, utilizzare:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Trust Anchors for CTI Interface (R22 and later)
This procedure assumes the XSP|ADPs are either internet-facing or face the internet via pass-through proxy. La configurazione del certificato è diversa per un proxy di bridging (vedere Requisiti di certificato TLS per proxy TLS-bridge).
For each XSP|ADP in your infrastructure that is publishing CTI events to Webex, do the following:
-
Accedere all'hub partner.
-
Go to Settings > BroadWorks Calling and click Download Webex CA Certificate to get
CombinedCertChain2023.txt
on your local computer.These files contain two sets of two certificates. You need to split the files before you upload them to the XSP|ADPs. All files are required.
-
Split the certificate chain into two certificates -
combinedcertchain2023.txt
-
Open
combinedcertchain2023.txt
in a text editor. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e -----END CERTIFICATE----- , e incollare il blocco di testo in un nuovo
file. -
Save the new file as
root2023.txt
. -
Save the original file as
issuing2023.txt
. Il file originale ora deve contenere solo un blocco di testo, racchiuso tra lerighe -----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copy both text files to a temporary location on the XSP|ADP you are securing, e.g.
/var/broadworks/tmp/root2023.txt
and/var/broadworks/tmp/issuing2023.txt
-
Sign in to the XSP|ADP and navigate to
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
-
(Opzionale) Eseguire
help updateTrust
per visualizzare i parametri e il formato del comando. -
Upload the certificate files to new trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
All aliases must have a different name.
webexclientroot2023
, andwebexclientissuing2023
are example aliases for the trust anchors; you can use your own as long as all entries are unique. -
Confermare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed]
-
Consenti ai client di eseguire l'autenticazione con certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Aggiungi interfaccia CTI e abilita mTLS
-
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione di BroadWorks. Il comando crea un certificato del server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
-
-
Replace the server certificate and key on the XSP|ADP's CTI interfaces. A tale scopo, è necessario l'indirizzo IP dell'interfaccia CTI. è possibile leggerla dal contesto seguente:
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Quindi, eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>
-
-
Restart the XSP|ADP.
Abilitazione dell'accesso agli eventi CTI BroadWorks su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Vedere Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Vedere Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
-
Specificare l'indirizzo CTI tramite il quale Webex può eseguire la sottoscrizione a BroadWorks CTI Events.
-
Gli abbonamenti CTI sono su base per-abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato è predisposto per Webex per Cisco BroadWorks.
Vista Web impostazioni chiamata
Call Settings Webview (CSWV) is an application hosted on XSP|ADP to enable users to modify their BroadWorks call settings through a webview that they see in the soft client. See the Cisco BroadWorks Call Settings Webview Solution Guide.
Webex makes use of this feature to provide users with access to common BroadWorks call settings that are not native to the Webex App.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedono alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, distribuire la funzione di visualizzazione Webview Impostazioni chiamata.
La vista Webview Impostazioni chiamata presenta due componenti:
-
Call Settings Webview application, hosted on a Cisco BroadWorks XSP|ADP.
-
The Webex App, which renders the call settings in a Webview.
Esperienza utente
-
Utenti Windows: Click Call Settings and then click .
-
Utenti Mac: Click profile picture, then
.
Distribuzione di CSWV su BroadWorks
Install Call Settings Webview on XSP|ADPs
CSWV application must be on the same XSP|ADP(s) that host the Xsi-Actions interface in your environment. It is an unmanaged application on XSP|ADP, so you need to install and deploy a web archive file.
-
Sign in to cisco.com and search for "BWCallSettingsWeb" in the software download section.
-
Individuare e scaricare la versione più recente del file.
For example,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) was the most recent at the time of writing. -
Install, activate, and deploy the web archive according to the Cisco BroadWorks Xtended Service Platform Configuration Guide for your XSP|ADP version. (Versione R24 è https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
-
Copy the .war file to a temporary location on the XSP|ADP, such as
/tmp/
. -
Passare al seguente contesto CLI ed eseguire il comando install:
XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war
Il software manager BroadWorks convalida e installa il file.
-
[Optional] Delete
/tmp/BWCallSettingsWeb_1.7.5_1.war
(this file is no longer required). -
Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario anche fornire un contextPath poiché è un'applicazione supportata. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione; ad esempio,
/callsettings
. -
Distribuire l'applicazione Impostazioni chiamata nel percorso del contesto selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings
-
-
Ora è possibile prevedere l'URL delle impostazioni di chiamata che verrà specificato per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
-
Specificare la barra finale su questo URL quando questo viene immesso nel file di configurazione del client.
-
The XSP|ADP-FQDN must match the Xsi-Actions FQDN, because CSWV needs to use Xsi-Actions, and CORS is not supported.
-
-
Repeat this procedure for other XSP|ADPs in your Webex for Cisco BroadWorks environment (if necessary).
The Call Settings Webview application is now active on the XSP|ADPs.
Configure the Webex App to use Call Settings Webview
For more detail on client configuration, see Webex for Cisco BroadWorks Configuration Guide.
Il file di configurazione dell'app Webex contiene un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. This URL shows the call settings to the users through the application interface.
<config> <services> <web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%"> <url>%WEB_CALL_SETTINGS_URL_WXT%</url> </web-call-settings>
In the Webex app configuration template on BroadWorks, configure the CSWV URL in the %WEB_CALL_SETTINGS_URL_WXT% tag.
If you don't explicitly specify the URL, the default is empty and the call settings page isn't visible to the users.
-
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
-
Impostare la destinazione per le impostazioni di chiamata Web
su
csw:%WEB_CALL_SETTINGS_TARGET_WXT% csw
-
Impostare l'URL delle impostazioni di chiamata Web per il proprio ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/
You derived this value when deploying the CSWV application.
-
The resulting client configuration file should have an entry as follows:
<web-call-settings target="csw"> <url>https://yourxsp.example.com/callsettings/</url> </web-call-settings>
Any reference to XSP includes either XSP or ADP.
Configurazione delle notifiche push di chiamata in Webex per Cisco BroadWorks
In questo documento, viene utilizzato il termine Server push di notifiche di chiamata (CNPS) per descrivere un'applicazione ospitata da XSP o ospitata ad ADP che viene eseguita nel proprio ambiente. IL CNPS collabora con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti ed invia le notifiche di tali notifiche ai servizi di notifica FCM (Google Firebase Cloud Messaging) o APNs (Apple Push Notification).
Tali servizi notificano ai dispositivi mobili di Webex per gli abbonati Cisco BroadWorks la loro chiamata in arrivo su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzionalità del server push dinotifica.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi notificano, a loro volta, gli utenti Webex mobili dei messaggi in arrivo o delle modifiche alla presenza.
In questa sezione viene descritto come configurare NPS per il proxy di autenticazione quando il server NPS non supporta già altre app. Se occorre eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di NPS Cisco BroadWorks per l'uso del proxy https://help.webex.com/nl5rir2/NPS.
Panoramica proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, il CNPS deve essere patchto per supportare la funzione proxy NPS, Push Server per le VoIP in UCaaS.
La funzione implementa un nuovo design nel server push di notifica per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private del certificato di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e le chiavi di notifica push con il provider di servizi, il server NPS utilizza una nuova API per ottenere un token di notifica push breve da Webex per il backend Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APNs Apple e i servizi Google FCM.
La funzione migliora anche la funzionalità del server push di notifica per eseguire il push delle notifiche sui dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
-
Per ulteriori informazioni, vedere il Server push per VoIP funzionalità in Descrizione funzionalità UCaaS.
-
The BroadWorks patches for the feature are available on: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
For NPS software and patches, see the section Prepare Your NPS for Webex for Cisco BroadWorks.
Search and download the patch from the software download page.
-
Ulteriori informazioni sul server ADP sono disponibili su https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni su APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio di notifica push Apple dopo il 31 marzo 2021. We recommend that you configure your XSP|ADP to use the HTTP/2-based interface for APNs. This update requires that your XSP|ADP hosting the NPS be running R22 or later.
Preparazione del sistema NPS per Webex per Cisco BroadWorks
1 |
Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma ADP (Application Delivery Platform). |
2 |
Installare le patch del proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: |
3 |
Attivare l'applicazione server push di notifica. |
4 |
(Per le notifiche Android) Abilitare l'API FCM v1 su NPS.
|
5 |
(Per notifiche Apple iOS) Abilitare HTTP/2 su NPS.
This is exclusive to Release 22 and earlier versions; it is not available in Release 23 and above versions, which only support HTTP/2. |
6 |
Allegare un supporto tecnico da NPS XSP/ADP. |
7 |
On each AS server, the namedefs file in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN A 10.193.78.149 Once set, one of the following is required to pickup the changes:
|
Operazione successivi
For fresh installs of an NPS, go to Configure NPS to Use Authentication Proxy
To migrate an existing Android deployment to FCMv1, go to Migrate NPS to FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicato a Webex per Cisco BroadWorks.
If you want to configure the authentication proxy on an NPS that is shared with other mobile apps, see Updating Cisco BroadWorks NPS to Use NPS Proxy ( https://help.webex.com/nl5rir2).
1 |
Obtaining OAuth credentials for your Webex for Cisco BroadWorks. | |||||||||||||||||||
2 |
Creare l'account client su NPS:
To verify the values you entered match with what you were given, run The CiscoCI issuerUrl should ALWAYS be US CI cluster irrespective of your location and the default should be:
| |||||||||||||||||||
3 |
Inserire l'URL del proxy NPS e impostare l'intervallo di aggiornamento del token (è consigliato 30 minuti):
| |||||||||||||||||||
4 |
(Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 |
(Per notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, facendo in modo di omettere la chiave di autenticazione, impostarlo come vuoto.
| |||||||||||||||||||
6 |
Configurare i seguenti URL NPS:
| |||||||||||||||||||
7 |
Configurare i seguenti parametri di connessione NPS in base ai valori consigliati riportati:
| |||||||||||||||||||
8 |
Controllare se il server dell'applicazione è un ID applicazione elettronica, poiché potrebbe essere necessario aggiungere le app Webex all'elenco dei consentiti: | |||||||||||||||||||
9 |
Restart the XSP|ADP: | |||||||||||||||||||
10 |
Testare le notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migra NPS in FCMv1
Questo argomento contiene le procedure opzionali che è possibile utilizzare nella console FCM di Google quando si dispone di una distribuzione NPS esistente che occorre eseguire la migrazione a FCMv1. Sono disponibili tre procedure:
-
Migrate UC-One clients to FCMv1—When you have existing UCaaS clients and need to migrate them to use FCMv1.
-
Migrate SaaS Clients to FCMv1—When you have existing SaaS clients and need to migrate them to use FCMv1.
-
Update ADP Server—When you are migrating the NPS to an ADP server.
Migrate UC-One Clients to FCMv1
Use the below steps in Google FCM Console to migrate UC-One clients to Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere Impostazioni progetto >
. L'impostazione viene visualizzata nella tabella delle credenziali del progetto.For details, see the Connect Mobile Branding Guide at https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Refer to the gcm_defaultSenderId
parameter, which is located in the Branding Kit, Resource folder, branding.xml file with the below syntax:
<string name="gcm_defaultSenderId">xxxxxxxxxxxxx</string>
-
Accedere all'SDK di amministrazione FCM su http://console.firebase.google.com.
-
Selezionare l'applicazione Android appropriata.
-
Nella scheda Generale, registrare l'ID progetto
-
Passare alla scheda degli account di servizio per configurare un account di servizio. È possibile creare un nuovo account di servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
-
Fare clic sul pulsante blu per creare un nuovo account di servizio
-
Fare clic sul pulsante blu per generare una nuova chiave privata
-
Scarica chiave in una posizione protetta
Per riutilizzare un account di servizio esistente:
-
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
-
Identificare l'account del servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
-
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
-
Scaricare il file json contenente la chiave e salvarlo in una posizione protetta.
-
-
Copy the json file onto the XSP|ADP.
-
Configurare ID progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== my_project ********
-
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID ============================== my_app my_project
-
Abilitare FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
-
Run the
bwrestart
command to restart the XSP|ADP.
Migrare i client SaaS in FCMv1
Utilizzare le operazioni seguenti su Google FCM Console se si desidera migrare i client SaaS a FCMv1.
-
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done
-
Run the
bwrestart
command to restart the XSP|ADP. -
Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done
-
Run the
bwrestart
command to restart the XSP|ADP.
Aggiorna server ADP
Utilizzare la procedura seguente in Google FCM Console se si sta migrando il server NPS per l'uso di un server ADP.
-
Ottenere il file JSON dalla console di Google Cloud:
-
Nella console di Google Cloud, andare alla pagina Account di servizio.
-
Fare clic su Seleziona un progetto , scegliere il progetto e fare clic su Apri .
-
Find the row of the service account that you want to create a key for, click the More vertical button, then click Create key.
-
Select a Key type and click Create
Il file viene scaricato.
-
-
Aggiungere FCM al server ADP:
-
Importare il file JSON nel server ADP utilizzando il
comando /bw/install.
-
Accedere alla CLI ADP e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON
: -
Successivamente, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done
-
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
-
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Questa operazione viene eseguita per i seguenti motivi:
-
To enable Webex cloud to authenticate your users against BroadWorks (via XSP|ADP-hosted authentication service).
-
Per abilitare le app Webex per l'uso dell'interfaccia Xsi per il controllo chiamate.
-
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza in telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiungete. È possibile continuare a modificare il cluster se una delle interfacce non viene convalidata correttamente, ma non è possibile salvare un cluster se sono presenti voci nonvalide.
Questo problema è impedito poiché un cluster configurato non correttamente può provocare problemi che sono difficili da risolvere.
Cosa è necessario fare:
-
Accedere all'hub del partner (admin.webex.com) con le credenziali dell'amministratore del partner.
-
Aprire la pagina Impostazioni dal menu laterale e individuare le impostazioni per la chiamata BroadWorks.
If the admin user does not have visibility of the BroadWorks Calling settings, it is recommended that you must open a case with Cisco TAC.
-
Fare clic su Add Cluster (Aggiungicluster).
This launches a wizard where you supply your XSP|ADP interfaces (URLs). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
-
Assegnare un nome a questo cluster e fare clic su Next(Avanti).
The cluster concept here is simply a collection of interfaces, typically collocated on an XSP|ADP server or farm, that enable Webex to read information from your Application Server (AS). You may have one XSP|ADP per AS cluster, or multiple XSP|ADPs per cluster, or multiple AS clusters per XSP|ADP. I requisiti di scalabilità per il sistema BroadWorks non sono disponibili qui.
-
(Opzionale) Inserire un nome account utente BroadWorks e una password all'interno del sistema BroadWorks che si sta collegando a Webex, quindi fare clic su Next(Avanti).
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
-
Aggiungere gli URL delle azioni XSI e degli eventi XSI.
-
Opzionale. Update the DAS URL with the URL of the Device Activation Service.
-
Opzionale. Check the Enable direct BroadWorks authentication check box if you want logins to BroadWorks to be direct to BroadWorks. Otherwise, authentication to BroadWorks is proxied through the Webex-hosted IdP proxy service.
This check box affects these login situations:
-
User Activation Portal login—Users must enter their BroadWorks credentials when logging in to the portal. The above setting determines if the login is direct to BroadWorks or is through the IdP Proxy.
-
Client Login—If BroadWorks Authentication is configured in the Onboarding template, the above setting determines if client login to the Webex App is direct to BroadWorks or is proxied through the IdP Proxy.
-
-
Fare clic su Avanti.
-
Nella pagina Interfaccia CTI, effettuare le seguenti operazioni:
-
Aggiungere l'URL E la porta CTI per l'interfaccia CTI a cui si desidera eseguire la connessione.
-
Opzionale. Enable the Call History toggle and then enter your BroadWorks user ID. When this option is selected, BroadWorks call history events get synced to the Webex cloud. Gli utenti possono visualizzare le cronologia chiamate nell'app Webex.
-
Opzionale. Enable the Do not disturb (DND) sync toggle and then enter your BroadWorks user ID. This option syncs DND events between Webex and BroadWorks, ensuring that the feature works the same on both platforms.
-
Fare clic su Avanti.
-
-
Aggiungere l'URL del servizio di autenticazione.
-
Selezionare Servizio autenticazione con convalida token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex, poiché il servizio di autenticazione convalida correttamente il token utente in base al servizio di identità Webex prima di elacere il token di lungo termine all'utente.
-
Esaminare le voci visualizzate nella schermata finale e fare clic su Crea. Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Partner Hub passa gli URL a diversi microservizi Webex che verificano le connessioni alle interfacce fornite.
-
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è stata eseguita correttamente.
-
Il pulsante Crea potrebbe essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, si verifica un problema con una delle integrazioni appena configurate.
Questo controllo è stato implementato per evitare errori nelle attività successive. You can go back through the wizard as you configure your deployment, which may require modifications to your infrastructure (e.g. XSP|ADP, load balancer, or firewall) as documented in this guide, before you can save the template.
Verifica delle connessioni alle interfacce BroadWorks
-
Accedere all'hub del partner (admin.webex.com) con le credenziali dell'amministratore del partner.
-
Aprire la pagina Impostazioni dal menu laterale e individuare le impostazioni per la chiamata BroadWorks.
-
Fare clic su View Clusters (Visualizzacluster).
-
Partner Hub avvia test di connettività da diversi microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina di elenco dei cluster mostra un messaggio di stato accanto a ciascun cluster.
Dovrebbero essere visualizzati messaggi di Operazione riuscita in verde. Se viene visualizzato un messaggio di errore rosso, fare clic sul nome del cluster interessato per visualizzare quale impostazione causa il problema.
-
Opzionale. Select a cluster if you want to see existing settings for that cluster, such as XSI-Actions, XSI-Events, DAS URL and the CTI interface settings.
Configure your Onboarding templates
Onboarding templates are the way that you will apply shared configuration to one or more customers as you onboard them via the provisioning methods. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma a un cliente può essere associato un solo modello.
-
Sign in to the Partner Hub and select Customers.
-
Click the Onboarding templates button to view the existing templates.
-
Click Create Template.
-
In the Template Details window, add the Template name, Country or Region and Default email Language.
-
Click the drop-down for the CCW Subscription ID, find the listed subscriptions for the partner, and select the applicable subscription.
This field is shown only for partners migrated from Webex for BroadWorks to Webex. -
In the Service Setting window, use the Cluster dropdown to choose the cluster you want to use with this template.
-
Inserire un Nomemodello, quindi fare clic su Avanti.
-
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per diverse modalità di provisioning Nome impostazione
Provisioning Flow con e-mail attendibili
Provisioning flow senza messaggi e-mail
Self-provisioning utente
Enable BroadWorks Flow Through Provisioning (include provisioning account credentials if On**)
Attivato
Specificare il nome account e la password di provisioning in base alla configurazione BroadWorks.
Attivato
Specificare il nome account e la password di provisioning in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
On†
On†
On†
Indirizzo e-mail provider servizi
Selezionare un indirizzo e-mail dal menu a discesa (è possibile digitare alcuni caratteri per individuare l'indirizzo se è un elenco lungo).
This email address identifies the administrator within your Partner organization who will be granted delegated admin access to any new customer organizations created with the Onboarding template.
Paese
Scegliere il paese utilizzato per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione può essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature paese-regione in questo foglio dicalcolo.
The organization country will determine the default global call-in numbers for Cisco PSTN in Webex Meeting Sites. Refer to the Country section of help page for more information.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti predisposti con questo modello sono aziende in BroadWorks.
Se sono gruppi, uscire da questo interruttore.
Se si dispone di una combinazione di aziende e gruppi nella broadworks, è necessario creare modelli diversi per i diversi casi.
Note della tabella:
-
† questo switch assicura che viene creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questo valore deve essere sempre attivo, a meno che non si utilizzi un processo di ordinazione e ordinazione manuale (tramite Cisco Commerce Workspace) per creare organizzazioni cliente in Webex (prima di iniziare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso definita come modello di provisioning ibrido ed è fuori dall'ambito di questo documento.
-
** "Provisioning account" refers to the BroadWorks system-level admin account. On BroadWorks, you need an admin account with these attributes: Administrator Type=Provisioning, Read-only=Off.
-
-
Selezionare il pacchetto dei servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Basic , Standard , Premium o Softphone.
È possibile ignorare questa impostazione per i singoli utenti tramite Partner Hub.
-
Opzionale. Check Disable Cisco Webex Free Calling if you want to disable Webex Calls,.
-
Per Configurazione partecipazione ariunione, selezionare una delle seguenti opzioni:
-
Numeri chiamata in accesso Cisco (PSTN)
-
Partner-provided Call-in Numbers (BYoPSTN)—If you select this option, refer the Bring Your Own PSTN Solution Guide for Webex for Cisco BroadWorks for detailed information on how to configure this option.
-
-
Fare clic su Avanti.
-
There are two approaches for provisioning subscribers with regards to how their identities are verified – using Trusted Emails or Untrusted Emails.
In the Trusted Email workflow users provide email addresses to the partner who adds them in BroadWorks. You as a partner are responsible for provisioning the email address as part of either the flow-through or API method.
It is highly recommended to use the Trusted provisioning method because it ensures that all subscribers are fully provisioned by you as a partner and there is no action required from the end users.
In the Untrusted email case users need to verify their emails before provisioning, or users can self-activate themselves.
In the Untrusted case there are several provisioning modes based on the verification settings in the table below:
Tabella 4. Recommended User Verification Settings for Untrusted Provisioning Modes Nome impostazione
Provisioning flow senza messaggi e-mail
Self-provisioning utente
Provision Admin First
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
-
Note della tabella:
-
* Each customer organization in Webex is required to have at least one user with administrator role. The first user to whom you assign Integrated IM&P in BroadWorks takes the customer administrator role if a new customer organization is created in Webex. As a Service Provider you may want to have control over who gets the role. Checking this setting blocks users from completing activation until the first user you provisioned is activated. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
-
-
Fare clic su Avanti.
-
Select the default authentication mode (either BroadWorks Authentication or Webex Authentication) for user login to Webex.
This setting has no effect on user login to the User Activation Portal. Users must use their BroadWorks user ID and password when logging in to the portal, irrespective of how the Onboarding template is configured.Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena creati. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
-
Fare clic su Avanti.
-
Per Preferenze , configurare quantosegue:
-
Scegliere se si desidera inserire automaticamente gli indirizzi e-mail degli utenti nella pagina diaccesso.
Utilizzare questa opzione solo se è stata selezionata l'autenticazione BroadWorks e gli indirizzi e-mail degli utenti sono stati inseriti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il relativo nome utente BroadWorks. La pagina di accesso fornisce un'opzione per modificare l'utente, se necessario, ma ciò potrebbe provocare problemi di accesso.
-
Se si desidera abilitare la sincronizzazione delle directory, impostare l'opzione Abilita sincronizzazione rubrica telefonica per tutte le organizzazioni dei nuovi clienti attivata.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente, in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
-
Inserire un Amministratore partner.
Questo nome viene utilizzato nel modulo di messaggio e-mail da Webex, che invita gli utenti a convalidare gli indirizzi e-mail.
-
Make sure the Allow admin-invite emails when attaching to existing orgs toggle is On (the default setting is On).
-
Fare clic su Avanti.
-
Esaminare le voci visualizzate nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con qualsiasi altro modello.
-
Fare clic sul nome del modello per modificarlo o eliminarlo, se necessario.
Non è necessario inserire nuovamente i dettagli dell'account di provisioning. I campi di conferma password/password vuoti sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori specificati alla procedura guidata.
Aggiungere altri modelli se si dispone di diverse configurazioni condivise da fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbero essere necessari i dettagli del modello per una attività seguente.
Configurazione del server dell'applicazione con URL del servizio di provisioning
Questa attività è necessaria solo per il flusso attraverso il provisioning.
Patch Application Server (R22, R23, and R24 only)
-
If you haven't yet done so, apply the following patch that applies to your release:.
-
Per R22:
AP.as.22.0.1123.ap373197
-
Per R23:
AP.as.23.0.1075.ap373197
-
Per R24:
AP.as.24.0.944.ap384177
For a complete list of BroadWorks patches that form the requirement for deploying Webex for Cisco BroadWorks, See BroadWorks Software Requirements in the Reference section. -
-
Passare al contesto
Maintenance/ContainerOptions.
-
Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true
Ottieni gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interface > Messaging and Service > Integrated IM&P) dei comandi AS.
-
Accedere a Partner Hub e andare a
. -
Fare clic su View Templates (Visualizzamodelli).
-
Selezionare il modello in uso per il provisioning degli abbonati di questo gruppo/aziendale in Webex.
I dettagli del modello vengono visualizzati in un riquadro a comparsa a destra. Se non è stato ancora creato un modello, è necessario effettuare questa operazione prima di ottenere l'URL di provisioning.
-
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per gli altri modelli se ne sono disponibili più di uno.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema sul server applicazioni
È possibile che non si desideri impostare il provisioning e il dominio del servizio a livello di sistema se si utilizza UC-One SaaS. Vedere Punti decisione nella sezione Preparazione dell'ambiente.
-
Accedere al server dell'applicazione e configurare l'interfaccia di messaggistica.
-
AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL
-
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name
-
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password
-
AS_CLI/Interface/Messaging> set enableSynchronization true
-
-
Attivare l'interfaccia IMP integrato:
-
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com
-
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true
-
È necessario inserire il nome completo per il parametro provisioningURL, come fornito in Control
Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare il mapping nel file /etc/hosts
su AS.
(Opzione) Configurazione dei parametri di provisioning per-enterprise sul server applicazioni
-
In BroadWorks UI, aprire l'azienda che si desidera configurare e andare a Servizi > IM integrato&P.
-
Selezionare Usa dominio servizio e inserire un valore fittizio (Webex ignora questo parametro. È possibile utilizzare
example.com
). -
Selezionare Usa server di messaggistica.
-
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
È necessario inserire il nome completo per il
parametro
provisioningURL, come fornito in Partner Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare il mapping nelfile /etc/hosts
su AS. -
Nel campo Nome utente, inserire un nome per l'amministratore del provisioning. Questo deve corrispondere al valore nel modello in Partner Hub.
-
Inserire una password per l'amministratore del provisioning. Questo deve corrispondere al valore nel modello in Partner Hub.
-
Per Identità utente predefinita per IM&PID, selezionare Principale .
-
Fare clic su Applica.
-
Ripetere questa operazione per le altre aziende che si desidera configurare per il flusso attraverso il provisioning.
User Provisioning Data
For information on the user data that gets exchanged between BroadWorks and Webex during user provisioning, see Service Provider User Provisioning.
Partner Pre-Provisioning Check API
The Pre-Provisioning Check API helps administrators and sales teams by checking for errors before you provision a customer or subscriber for a package. Users or Integrations authorised by a User with the Partner Full Administrator role can use this API to ensure that there are no conflicts or errors with package provisioning for a given customer or subscriber.
The API checks to see if there are conflicts between this customer/subscriber and existing customers/subscribers on Webex. For example, the API may throw errors if the subscriber is already provisioned to a different customer or partner, if the email address exists already for another subscriber, or if there are conflicts between the provisioning parameters and what exists already on Webex. This gives you the opportunity to fix those errors before you provision, increasing the likelihood of successful provisioning.
For more information on the API, see: Webex for Wholesale Developer Guide
To use the API, go to : Precheck a Wholesale Subscriber Provisioning
To access Precheck a Wholesale Subscriber Provisioning document you need to log in to https://developer.webex.com/ portal.
Partner SSO - SAML
Allows partner administrators to configure SAML SSO for newly created customer organizations. I partner possono configurare un singolo rapporto di SSO predefinito e applicare tale configurazione alle organizzazioni dei clienti da loro gestite, così come ai propri dipendenti.
-
Verificare che il provider di provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per i provider di identità dell'integrazione Single Sign-On in Control Hub.
-
Upload the CI metadata file that has Identity Provider.
-
Configure a Onboarding Template. Per l'impostazione della Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, inserire EntityID dal file XML dei metadati SAML del provider di identità di terze parti.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
-
In questo modo l'utente può eseguire l'accesso.
Partner SSO - OpenID Connect (OIDC)
Allows partner administrators to configure OIDC SSO for newly created customer organizations. I partner possono configurare un singolo rapporto di SSO predefinito e applicare tale configurazione alle organizzazioni dei clienti da loro gestite, così come ai propri dipendenti.
The below steps to set up Partner SSO OIDC apply to newly created customer organizations only. If partner administrators try to modify the default authentication type to Partner SSO OIDC in an existing temple, the changes will not apply to the customer organizations already onboarded using the template.
-
Open a Service Request with Cisco TAC with the details of the OpenID Connect IDP. The following are mandatory and optional IDP attributes. TAC must set up the IDP on the CI and provide the redirect URI to be configured on the IDP.
Attributo
Richiesto
Descrizione
IDP Name
Sì
Unique but case-insensitive name for OIDC IdP config, could consist of letters, numbers, hyphens, underlines, tildes, and dots and max length is 128 characters.
OAuth client Id
Sì
Used to request OIDC IdP Authentication.
OAuth client Secret
Sì
Used to request OIDC IdP Authentication.
List of scopes
Sì
List of scopes which will be used to request OIDC IdP authentication, split by space, e.g. 'openid email profile' Must including openid and email.
Authorization Endpoint
Yes if discoveryEndpoint not provided
URL of the IdP's OAuth 2.0 Authorization Endpoint.
tokenEndpoint
Yes if discoveryEndpoint not provided
URL of the IdP's OAuth 2.0 Token Endpoint.
Discovery Endpoint
No
URL of the IdP's Discovery Endpoint for OpenID endpoints discovery.
userInfoEndpoint
No
URL of the IdP's UserInfo Endpoint.
Key Set Endpoint
No
URL of the IdP's JSON Web Key Set Endpoint.
In addition to the above IDP attributes, the partner organization ID needs to be specified in the TAC request.
-
Configure the redirect URI on the OpenID connect IDP.
-
Configure a Onboarding template. For the Authentication Mode setting, select Partner Authentication With OpenID Connect and enter the IDP Name provided during the IDP setup as the OpenID Connect IDP Entity ID.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
-
Very that the user can log in using the SSO authentication flow.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è necessaria per diverse funzioni di chiamata, inclusi la registrazione della chiamata, il gruppo di risposta per risposta per chiamate di gruppo, esecutivi e l'assistente esecutivo.
Use the CLI to enable the feature on all AS and XSP|ADP interfaces.
-
Run the following commands on AS interfaces. This will enable the AS to send the
X-BroadWorks-Correlation-Info
SIP header:AS_CLI/Interface/SIP> set sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> set sendCallCorrelationIDAccess true
-
The
enableCallCorrelationID
parameter associated with the Xsi-Actions application is used to control the inclusion of call correlation information in Xsi-Actions logs. It is recommended to haveenableCallCorrelationID
enabled using the following command on XSP|ADP interfaces:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>set enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione di identificativo correlazione chiamata CiscoBroadWorks.
Sinc rubrica
La sincronizzazione delle directory assicura che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la rubrica chiamate completa dal server BroadWorks viene sincronizzata con la rubrica Webex. Gli utenti possono accedere alla rubrica dall'app Webex e chiamare qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione delle rubrica, andare a Sincronizzazione rubrica in Webex per Cisco BroadWorks.
Cronologia chiamate Unified
Quando la Cronologia chiamate Unified è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia delle chiamate e delle riunioni Webex che viene visualizzata nell'app Webex. Gli utenti possono visualizzare la cronologia delle chiamate e la cronologia delle riunioni dettagliate dall'app Webex.
La cronologia delle chiamate Unified può essere abilitata dagli amministratori a livello di partner in Hub partner su base cluster per cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
-
Eventi della cronologia delle chiamate: questi eventi vengono utilizzati per creare una cronologia delle chiamate Unified dettagliata
-
Eventi di stato hook: la cronologia delle chiamate Unified include ottimizzazioni dello stato degli hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti della presenza telefonica
Requisiti cronologia chiamate Unified
Prima di configurare Unified Call History, verificare di aver patchato il sistema. Questa funzione dipende dalle seguenti patch di BroadWorks installate:
Per R22:
-
AP.as.22.0.1123.ap378585
—after patch installation, you must activate feature 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
Per R23:
-
AP.as.23.0.1075.ap378585
—after patch installation, you must activate feature 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
-
If using XSP—
AP.xsp.23.0.1075.ap378585
-
If using ADP—
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
-
AP.as.24.0.944.ap378585
—after patch installation, you must activate feature 25433. Ad esempio:AS_CLI/System/ActivatableFeature> activate 25433
In addition to patching your system, the client config file (config-wxt.xml
) must have the following tag set: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
To have Hunt Group, Call Center and other redirection info in Unified Call History, the following Broadworks patches must be installed and active:
Per R23:
-
AP.as.23.0.1075.ap383346
-
AP.as.23.0.1075.ap383994
Per R24:
-
AP.as.24.0.944.ap383346
-
AP.as.24.0.944.ap383994
To have Executive-Assistant info in Unified Call History, the following Broadworks patches must be installed and active:
Per R24:
-
AP.as.24.0.944.ap380052
-
AP.as.24.0.944.ap384239
-
ADP running Xsi-Events-24_2022.06 or later
In addition to the Broadworks patches, Directory Sync must also be enabled for the Executive-Assistant Unified Call History.
When you enable Call History or DND Sync, Webex will send CTI subscription refresh requests for all users under the cluster. Depending on the number of users, this may last up to a few hours. It is recommended to not perform any Broadworks maintenance activity during the same maintenance window.
Abilita cronologia chiamate (nuovo cluster)
To enable Call History on a new cluster, see the steps for adding a cluster in Configure Your Partner Organization in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia delle chiamate su un cluster esistente, effettuare le seguenti operazioni:
-
Sign in to Partner Hub at
admin.webex.com
. -
Andare a Impostazioni e selezionare un cluster esistente.
-
Verificare che la connessione del cluster sia buona. Il pannello destro deve visualizzare un segno di spunta verde con la connessionestabilita.
Se non viene visualizzato, in Verifica connessioni (Opzionale) , inserire l'ID utente BroadWorks e la password BroadWorks e fare clic su Verifica per verificare che la connessione sia buona.
-
Selezionare la casella di cronologia chiamate controllo.
-
Fare clic su Salva.
Interazioni funzioni
Le seguenti interazioni tra le funzioni esistono per Unified Call History:
-
La cronologia delle chiamate Unified non è supportata per gli utenti configurati in BroadWorks con elenchi di inoltro o indirizzari diretti. Quando esiste questa situazione, gli eventi di cronologia delle chiamate e stato di hook non vengono inviati all'app Webex.
-
La cronologia delle chiamate Unified non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella Cronologia chiamate.
Visualizzazione della cronologia delle chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia delle chiamate Unified dall'app Webex. Per informazioni dettagliate, vedere: Webex | View Call and Meeting History.
Disabilitazione di Unified Call History
Una volta abilitata la Cronologia chiamate Unified su un cluster, non è possibile disabilitare la funzione per proprio conto. If you need to disable the feature, contact Cisco Technical Assistance Center (TAC).
Visual Spam Indication
The Webex App supports a visual indication of spam calls in the call toast when the call is presented to the callee and in the Unified Call History records when BroadWorks is updated to perform Caller ID validation via the STIR/SHAKEN framework. To have this feature:
- Enable Unified Call History as described in the previous section.
- The following patches must be installed and active:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- or AS-25_Rel_2022.12 at a minimum
- The feature must be activated via the AS CLI:
- AS_CLI/System/ActivatableFeature> activate 104112
- AS_CLI/System/StirShaken> set enableVerification true
- Broadworks must be configured to perform STIR-SHAKEN signing, tagging, and verification as described in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification
When BroadWorks is properly configured, a new header X-Cisco-CallerId-Disposition will be added in INVITE requests sent to Cisco clients and a new field callerIdDisposition will be added to the existing Call History Events that are sent to Webex Cloud via the CTI interface. Webex devices will use this information to provide a visual spam indication in the call presentation and the Unified Call History of the callee.
Caller Identification and Call Redirection
Caller Identification
When the Webex App receives a call, it will attempt to identify who the caller is and display this information in the incoming call notification, the in-call window, and after the call is complete, in the call history and voicemail.
The Webex App will attempt to find the caller ID by matching the incoming phone number with the phone numbers of contacts found in various sources. The Webex App will use the following sources in this order. Once it finds it in one source it will not attempt to search anywhere else.
If it finds multiple instances of a number in one source, it will not try to choose one of them, in this case, it will not display any caller ID.
-
Webex Common Identity (CI) which contains your organization users.
-
Personal and Organization Contacts. Personal Contacts are visible under the Contacts tab.
-
Local Address Book. In Windows - Outlook application, in Mac - Mac Contacts, in iOS - iPhone contacts, in Android - Android contacts.
If there is no match found with the incoming phone number, then the app will use the display name in the SIP FROM header if available. Otherwise, it will use the username part of the SIP URI from the SIP From header as a last resort.
For remote call control (i.e., Deskphone Control Mode) XSI info is used, where BWKS ID or extension is used, extracted from remote-party-info in the XSI event. If remote-party-info is not available, then P-Asserted Identity (PAI) (if configured) will be used.
Call Redirection
In the case where a call has been redirected or forwarded, then the app will attempt to show who the caller is and how it was forwarded in the call notification and call history.
-
Call Forwarded: Shows number that forwarded the call.
-
Hunt Group: Shows name of the hunt group that forwarded the call.
-
Call Center Queue: Shows name of the queue that forwarded the call.
-
Executive-Assistant: Shows name of Executive the call is coming in for.
Eccezioni:
-
For internal call queue calls, where an agent calls back an internal party, the remote party will not see the name of the call queue but will see the name of the agent calling them.
Call Answered Elsewhere:
For Hunt Groups or Call Queues that are set up with simultaneous routing, agents will see a call answered elsewhere in call history if another agent picks up the call. For Hunt Groups or Call Queues with sequential routing, or in an overflow, calls will show as missed call in call history if answered by another agent.
Select Caller ID
Panoramica
The "Select Caller ID" feature enables users to switch between different Calling Line IDs for external calls. If enabled by the admin, users can choose from the following options for their Calling Line Identity:
-
User number ("Use user phone number for Calling Line Identity")
-
Configurable CLID ("Use configurable CLID for Calling Line Identity")
-
Group CLID ("Use group/department phone number for Calling Line Identity")
Funzionalità
Users have two methods to change their Caller ID as provisioned by the administrator:
- Feature Access Codes (FAC): Specific codes for each of the three Caller ID options.
- Webex App Interface: A user-friendly view within the Webex desktop and mobile apps that display the available Caller ID options enabled by the administrator, allowing users to select their preferred ID.
Ulteriori funzioni
- The Webex apps will also include options for Call Center queues DNIS.
- Mobile app users will have Dual Persona options available for Mobility users.
Preconditions
The following conditions must be met on the BroadWorks server for the user to be able to control their choice of external CLID policy:
- The system flag 'EnableUserSelectionOfExternalCLIDPolicy' is enabled.
- User level Call Processing Policy Calling Line ID scope is set to "Use User Calling Line Id Policy" for this user.
- The User level Call Processing Policies flag 'Allow User Selection of External CLID Policy' is enabled for the user.
- If no number is defined for the "Use configurable CLID for Calling Line Identity" or "Use group/department phone number for Calling Line Identity" options, the FACs or app display will have no effect. This setting must be configured by the administrator prior to user selection.
BroadWorks Patches
This feature requires two specific BroadWorks patches to function correctly:
- BWKS-5230 was the original user-selectable CLID feature - it lets users (if the system is configured properly) change which CLID policy is applicable. See FD here: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/UserSelectionOfExternalCallingLineIDOptionFD-R250.pdf
- BWKS-9510 is an XSI enhancement requested by the Webex client team to make it easier to discover which options are available for a user. This is necessary because the choice of CLID policy isn't a simple user-level feature (like CFA) that is directly controllable. Rather it depends on various system configuration options and the "call processing policies" hierarchy. You can see details here: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/XSIEnhancementToSupportUserSelectableCLIDFD-R250.pdf
Webex App Configuration
These tag needs to be enabled in the desktop, tablet, and mobile configurations:
<config> <services> <calls> <caller-id> <outgoing-calls enabled="%ENABLE_CLID_OUTGOING_CALLS_WXT%">
Shared line appearance
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. The shared line configuration for the Webex App is similar to the shared line configuration for desk phones. This specific feature allows you to assign shared line appearances to the end user's Webex App.
This feature benefits the users to handle calls on other user's extension directly from the Webex App.
-
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
-
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
-
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
-
A user cannot be provisioned with Executive-Assistant service at the same time as having Shared Lines.
-
A user's primary line port should not be changed to a Shared Line.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Owner Flag in Device List to Support Webex Client Shared Lines
R23 without ADP:
-
AP.as.23.0.1075.ap384179
-
AP.xsp.23.0.1075.ap384179
R23 with ADP:
-
AP.as.23.0.1075.ap384179
-
Xsi-Actions-23_2022.10
R24:
-
AS: AP.as.24.0.944.ap384179
-
Xsi-Actions-24_2022.10
R25:
-
AS: RI release Rel_2022.10_1.310
-
Xsi-Actions-25_2022.10
Patch 2: Patches for increasing port count on device profile types. Esempio: For the desktop client: System>Identity/Device Profile Type Modify> Business Communicator - PC: Profile , Standard Options, Number of Ports:
- IF 'Unlimited' is enabled, no change is required
- IF 'Limited To' is <10, change the value = 10 and save to utilize all available lines
-
RI release Rel_2022.10_1.310
Non disturbare (DND) sincronizzazione
Do Not Disturb (DND) Sync aligns DND settings between Webex and BroadWorks by synchronizing DND status between the two platforms. For example, if a user turns on DND from the Webex App, that status syncs to BroadWorks calling devices. As a result, the user’s BroadWorks-registered desk phone does not ring when someone attempts to call it. Similarly, if a user sets DND from a desk phone, the status syncs to the Webex App. Without this feature, DND updates from one platform don't get recognized by the other platform.
DND Sync gets applied at the BroadWorks cluster level and can be enabled in Partner Hub by a partner administrator.
If there are many customers (>50) in the BroadWorks cluster, DND sync is not supported. In such instances, it is recommended to contact a Cisco TAC support engineer for assistance.
Prerequisiti
Make sure that the following patches are applied to the AS and XSP|ADP. Apply only the patches for your BroadWorks version.
For Release 23:
<snipped>
- ADP apps: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
For Release 24:
<snipped>
- ADP apps: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
After you apply the patches, activate feature 25433 on the AS:
AS_CLI/System/ActivatableFeature> activate 25433
If there are many customers (>50) in the BroadWorks cluster, operations such as updating XSI Actions, XSI Events, DAS URL, XSP|ADP URL, or DND sync are not supported. In such instances, it is recommended to contact a Cisco TAC support engineer for assistance.
Configure Device Feature Key Synchronization on BroadWorks. Make sure that the phone supports SIP SUBSCRIBE/NOTIFY for the “as-feature-event” event package. For details, see Cisco BroadWorks Device Feature Key Synchronization.
Enable DND Sync (Existing cluster)
-
Sign in to Partner Hub
-
Fare clic su Impostazioni.
-
Click View Cluster and select the appropriate BroadWorks cluster.
-
Enable the Do not disturb (DND) sync toggle.
-
Enter your BroadWorks user ID and click Enable.
The system validates that the BroadWorks cluster has the appropriate patches to support DND Sync. If validation fails, the Save button gets disabled.
-
If validation succeeds, click Save.
-
Once DND Sync gets enabled, Webex refreshes all user subscriptions to include the Do not disturb event package. Depending on the number of users, this process may take a few hours to complete.
-
Enabling DND Sync is a one-way toggle. Once the feature is enabled, you can’t disable it on your own.
Enable DND Sync (New cluster)
You can also enable the feature during cluster creation. For details, see “Configure Your BroadWorks Clusters” in Configure Your Partner Organization in Partner Hub.
Disable DND Sync
You can’t disable DND Sync on your own. To disable the feature, create an engineering BEMS case with the following information:
-
Famiglia: Servizio Spark
-
Prodotto: Chiamata in Webex (Webex per BroadWorks)
-
Componente: WxBW- Provisioning
-
The BEMS case must state that Do Not Disturb Sync is to be disabled for a partner. The case must contain partnerId and BroadWorks clusterId.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione della chiamata.
Modalità di registrazione |
Descrizione |
Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Ondemand |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma la registrazione viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente |
La registrazione non viene avviata a meno che l'utente non seleziona l'opzione Avvia registrazione nell'app Webex. L'utente può avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
-
Per R22: AP.as.22.0.1123.ap377718
-
Per R23: AP.as.23.0.1075.ap377718
-
Per R24: AP.as.24.0.944.ap377718
The Call Correlation Identifier must be turned on. For details, see Enable Call Correlation Identifier.
The following configuration tag must be enabled in order to use this feature: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamata di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, vedere l'help.webex.com Webex | Registra lechiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono accedere alla piattaforma di registrazione delle chiamate di terze parti.
Enabling Voicemail for Microsoft Teams Integration
You can enable voicemail for Microsoft Teams users in the Webex for BroadWorks solution. This integration allows users to retrieve their voicemails directly through Microsoft Teams, enhancing the overall user experience.
Steps to Enable Voicemail
-
Configure Voicemail Settings: Follow the steps provided in the Webex Calling documentation to configure and manage voicemail settings. This includes setting up voicemail for users, enabling notifications, and configuring voicemail to email.
For detailed instructions, see: Configure and manage voicemail settings for a Webex Calling user.
-
Integrate with Microsoft Teams: Ensure that the integration between Webex for BroadWorks and Microsoft Teams is properly configured. This will enable users to access their voicemails through the Microsoft Teams interface.
For integration details, see: Configure Microsoft Teams for Webex Calling.
Esperienza utente
Once the integration is set up, users can:
- Retrieve voicemails directly within the Microsoft Teams application.
- Receive notifications for new voicemails.
- Manage voicemail settings from the Webex interface.
Requisiti
To support voicemail retrieval in the Microsoft Teams integration with the Webex for BroadWorks offer, additional network changes are required. BroadWorks partners should enable Cross-Origin Resource Sharing (CORS) for the following URLs on their BroadWorks platform:
- https://jabber-integration-a.wbx2.com/
- https://jabber-integration-r.wbx2.com/
- https://jabber-integration-k.wbx2.com/
- https://msteams-calling.webex.com/
For more details on the configuration steps, please refer to section 8.5.1.2 of the BW Application Delivery Platform Configuration Guide, which requires version 2024.05 on the ADP.
Gestione e Parcheggio chiamata gruppo
Webex per Cisco BroadWorks supporta l'accesso Parcheggio chiamata e Retrieve. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono poi essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti del retail in un'impostazione di store possono utilizzare la funzione per parcheggiare una chiamata che può essere poi selezionata da qualcuno in un altro reparto.
Operazione funzione
Una volta configurata la funzione
-
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nella relativa app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
-
Un altro utente del gruppo fa clic sull'opzione Recupera chiamata nella relativa app Webex. L'utente inserisce il interno della chiamata in parcheggio per continuare la chiamata.
Requisiti
Per utilizzare questa funzione, verificare quanto segue:
-
Il file di configurazione del client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
-
The Call Correlation Identifier must be enabled on the AS and XSP|ADP. For details, see Enable Call Correlation Identifier.
-
Your SBC must be configured to pass the ‘
x-broadworks-correlation-in
' SIP attribute to and from the Application Server.
Configurazione
Per informazioni su come configurare la funzionalità Parcheggio chiamata gruppo su BroadWorks, vedere "Aggiunta di un gruppo Parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte2. È necessario creare un gruppo e aggiungere gli utenti al gruppo.
Per informazioni su come configurare l'identificativo di correlazione chiamata su BroadWorks, vedere Descrizione della funzione di identificativo correlazione chiamata CiscoBroadWorks.
Ulteriori informazioni
Per informazioni utente sull'uso delle chiamate di Parcheggio chiamata, vedere Parcheggio Webex | e recupero dellechiamate.
Parcheggio chiamata/indirizzati Parcheggio chiamata
Il parcheggio di chiamate normali o indirizzate non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso funzioni:
-
Inserire *68 per parcheggiare una chiamata
-
Inserire *88 per recuperare una chiamata
Inclusione
Barge-in service is commonly used in call center environments or other situations where immediate assistance or intervention may be required.
When a barge-in service is enabled, a designated user or supervisor can enter an active call by initiating a specific command or by using a dedicated button or key combination on their phone or communication device. Once the barge-in request is made, the system establishes a connection with the ongoing call, allowing the authorized person to listen to the conversation or join the call as an active participant.
Barge-in service can be useful in various scenarios. In a call center setting, supervisors or trainers can monitor and coach customer service representatives by listening to their calls in real-time. If necessary, they can intervene to provide guidance or take over the call if the representative is struggling. In emergency situations or critical discussions, authorized personnel can quickly join ongoing conversations to provide assistance or make important decisions.
In the Webex app for Barge in, we get a notification that the call is transformed into a conference. There is no additional information in the NOTIFY (call-info or conference-info) what is the type of conference, so we can treat it in a different way.
When a barge-in occurs, a three-way call is established between the parties. The following terms are introduced:
-
Supervisor: A supervisor is a person who oversees and manages a team of customer service agents or call center representatives. In the context of call barge-in, a supervisor typically has the ability to monitor and intervene in ongoing customer calls. They may use call monitoring tools or software to listen in on calls, provide guidance to agents, and ensure quality control. The supervisor's role may involve training agents, addressing customer concerns, and optimizing the performance of the team.
-
Customer: A customer refers to an individual or entity that engages with a company or organization to obtain products, services, or support. In the context of call barge-in, a customer is someone who is making or receiving a phone call with a customer service agent. Customers may seek assistance, information, or resolution to their queries or issues during the call. The call barge-in feature allows supervisors or authorized personnel to join the ongoing call between the customer and the agent.
-
Agent: An agent, also known as a customer service representative or call center agent, is a person responsible for handling customer interactions and providing support or assistance over the phone or other communication channels. Agents are trained to address customer inquiries, resolve problems, process transactions, and deliver a positive customer experience. In the context of call barge-in, an agent is the individual speaking directly to the customer during the phone call. The agent may receive guidance or feedback from the supervisor through call barge-in if necessary.
For any client initiated requests such as CallStartRequest, CallPickupRequest, DirectedCallPickupRequest, DirectedCallPickupWithBargeInRequest, etc, if <Webex Client> (please choose the right name instead of Webex client, if it is not appropriate) is provisioned as a Shared Call Appearance device, 'Alert all appearances for Click-to-Dial calls' configuration should be enabled on Shared Call Appearance setting for the client to receive a call, unless the location is explicitly provided by the client initiating the request.
Mobile Native Call Escalate to Meeting
The Mobile Native Call Escalate to Meeting comes with two unique features:
-
New Push Notification
Mobile users on a native call can now switch to the Webex App by tapping on the New push notification. When you start a native call screen a New push notification appears on the screen and tapping the notification takes you straight to the Webex App in-call screen.
You see the Webex notification during a mobile phone call if you use Webex Go or your mobile network operator (MNO) has call signaling using Cisco call control for your mobile phone calls.
-
Move Mobile Call to Meeting
When you're in the middle of a call with someone, you may want to move that call into a meeting to make use of some advanced meetings features like video, share, or whiteboarding. Or invite other people into the discussion and move to a meeting.
BroadWorks Requirements
-
Activatable feature 25239
-
R23 with XSP|ADP:
-
AS Patch AP.as.23.0.1075.ap383064
-
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
-
Patch AP.platform.23.0.1075.ap383064
-
-
R23 with ADP:
-
AS Patch AP.as.23.0.1075.ap383064
-
ADP with Xsi-Actions-23, CommPilot-23 version > 2022.05_1.303 and NPS version > 2022.08_1.350
-
-
R24:
-
AS patch: AP.as.24.0.944.ap383064
-
ADP with Xsi-Actions-24, CommPilot-24 version > 2022.05_1.303 and NPS version > 2022.08_1.350
-
-
R25:
-
AS RI release Rel_2022.08_1.354
-
ADP with Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 and NPS version > 2022.08_1.350
-
URI Dialing Configuration to support Move Call to Meeting
NS UrlDialing Policy
Define rule for (.*)webex.com to route through I-SBC
NS_CLI/Policy/UrlDialing> get WebexMeetings Policy: UrlDialing Instance: Webex unknownSipURIHandling = reject disableSubscriberLookups = true Enable = true CallTypes: Selection = {ALL} From = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP} lineportOnly = false enableSipURIMatchingRules = true NS_CLI/Policy/UrlDialing/Rules> get WebexMeetings Policy: UrlDialing Instance: WebexCalling Table: Rules id pattern routingNE cost weight dtg =================================================================== 1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NS Routing NE for I-SBC
Example configuration
NS_CLI/System/Device/RoutingNE> get ne WebexMeetings Network Element WebexMeetings Location = 1281465 Data Center = Static Cost = 1 Static Weight = 99 Poll = false OpState = enabled State = OnLine Profile = NIL_PROFILE Remote Lookup Enabled = false Signaling Attributes = NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings Routing NE Address Cost Weight Port Transport Route ===================================================================== WebexMeetings sbc-address 1 99 - unspecified
NS Routing Profile
UrlDialing policy instance added to appropriate routing profile(s)
NS_CLI/Policy/Profile> get profile MyInst Profile: Webex Policy Instance ========================================== … UrlDialing WebexMeetings
AS Use NS Route for NetworkURL call
Enable the AS to honor the NS route in Hybrid AS mode
AS_CLI/Interface/IMS> set queryNSForNetworkURL true
E911 Emergency Calling
Webex for Cisco BroadWorks supports E911 emergency services calling. With this feature, emergency calls get routed to a Public Safety Answering Point (PSAP) who can then direct emergency services to the caller’s location. To use this feature, you must integrate Webex for Cisco BroadWorks with an E911 emergency call provider.
Use the following Webex articles to configure support for E911 emergency calling services:
-
E911 Emergency Calling in Webex for BroadWorks—Use this article to configure E911 emergency calling in Webex for Cisco BroadWorks using one of the following supported E911 providers:
-
Banda
-
Intrado
-
RedSky
-
-
Emergency Call Disclaimer—If you have a location service, you can configure the Emergency Services Disclaimer window on the Webex App to include an option for users to update their location when logging in.
Personalizzazione e provisioning dei client
Users download and install their generic Webex apps, for desktop or mobile (for download links, see Webex App Platforms). Once the user authenticates, the client registers against theWebex Cloud for messaging and meetings, retrieves its branding info, discovers its BroadWorks service info and downloads its calling configuration from BroadWorks Application Server (via DMS on XSP|ADP).
I parametri di chiamata per le app Webex vengono configurare in BroadWorks (normalmente). È possibile configurare branding, messaggistica e parametri della riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Queste due serie di configurazioni possono sovrapporsi, in tal caso la configurazione Webex ha la priorità sulla configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server dell'applicazione BroadWorks
Le app Webex sono configurate con i file DTAF. The clients download a configuration XML file from the Application Server, via the Device Management service on the XSP|ADP.
-
Recuperare i file DTAF richiesti (vedere Profili dispositivo nella sezione Preparazione dell'ambiente).
-
Verificare di disporre dei set di tag giuste in BroadWorks System > alle > tag di gestione dispositivi.
-
Per ciascun client di cui si è in corso il provisioning:
-
Scaricare ed estrarre il file zip DTAF per il particolare client.
-
Import DTAF files to BroadWorks at System > Resources > Identity/Device Profile Types
-
Aprire il profilo del dispositivo appena aggiunto per la modifica e:
-
Enter the XSP|ADP farm FQDN and Device Access Protocol.
-
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per condivisione del desktop per il funzionamento.
È possibile anche abilitare il supporto delle parti remote eseguendo il seguente comando CLI sul server dell'applicazione:AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
-
-
Modificare i modelli in base all'ambiente in uso (vedere la tabella seguente).
-
Salvare il profilo.
-
-
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome |
Descrizione |
Priorità codec |
Configurare l'ordine di priorità per i codec audio e video per VoIP chiamate |
TCP, UDP e TLS |
Configurare i protocolli utilizzati per segnali SIP e multimediali |
Porte audio e video RTP |
Configurare gli intervalli di porte per audio e video RTP |
Opzioni SIP |
Configurare varie opzioni correlate a SIP (INFORMAZIONI SIP, uso di rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e sottoscrizione, ecc.) |
Customize Branding for Webex App
-
Partner customizations—Partner administrators can apply advanced branding customizations that apply to the partner organization and/or customers that the partner manages. See Configure Advanced Branding Customizations.
-
Customer customizations—If the partner allows customers to apply their own Branding customizations, customer administrators can follow the procedures at Add Your Company Branding to Webex.
The User Activation Portal uses the same logo that you add for client Branding.
Personalizzazione della segnalazione dei problemi e degli URL di assistenza
To customize these options, administators can follow the procedure "Add Feedback and Help Site URLs", which can be found in both of the above Branding articles.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con provisioning Flowfluire
You must configure all the XSP|ADP services, and the partner organization in Control Hub, before you can perform this task.
1 |
Assegnazione del servizio in BroadWorks: |
2 |
Verifica l'organizzazione e gli utenti del cliente in Control Hub: |
Test utenti
1 |
Scaricare l'app Webex su due macchine diverse. |
2 |
Accedere come utenti di test sulle due macchine. |
3 |
Effettua chiamate di prova. |
Gestione di Webex per BroadWorks
Pre provisioning organizzazioni clienti
Nel modello corrente, viene eseguito automaticamente il provisioning dell'organizzazione del cliente quando si onboard il primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguita una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
-
Usa API per creare account Webex
-
Assegnare i messaggi e-mail integrati IM&P (provisioning flow) con e-mail affidabili per la creazione di account Webex
-
Assegna IM&P integrato (provisioning FLOW) senza messaggi e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per la creazione di account Webex
-
Consenti agli utenti l'attivazione autonoma (inviando loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex sono esposti API pubbliche per consentire ai provider di servizi di integrare Webex per il provisioning del sottoscrittore Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. La specifica per queste API è disponibile developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
Wholesale customers will be rejected by these APIs.
Provisioning Flow
Su BroadWorks, è possibile fornire agli utenti l'opzione Abilita IM integrato&P. Questa azione causa il provisioning dell'adattatore BroadWorks per rendere chiamata API di eseguire il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile retrocompatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica di codice, ma solo una modifica di configurazione all'endpoint API per l'adattatore di provisioning.
La fornitura del sottoscrittore su Webex può richiedere una notevole quantità di tempo (diversi minuti per l'utente iniziale in un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il completamento del provisioning di flusso indica che il provisioning è stato avviato. Non indica il completamento.
Per verificare che gli utenti e l'organizzazione del cliente siano completamente predisposti su Webex, è necessario accedere a Partner Hub e ricercare l'elenco dei clienti.
BroadWorks trunking users can have Webex for BroadWorks via a shared call appearance (SCA). The trunking user will need to have the Authentication service assigned. As described in the BroadWorks Trunking Solution Guide Section 8, this allows the authentication of the SCA Webex appearance to be separate from the common trunk authentication. Webex for BroadWorks cannot be provisioned for trunking users with the Route List or Direct Route features assigned.
Attivazione automatica utente
Per fornire gli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
-
Sign in to Partner Hub, and find the Customer List page.
-
Fare clic su View Templates (Visualizzamodelli).
-
Select the provisioning Onboarding template you want to apply to this user.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non è nel sistema BroadWorks associato a questo modello, l'utente non può attivare automaticamente con il collegamento.
-
Copiare il collegamento per il provisioning e inviarlo all'utente.
È possibile anche includere il collegamento di download del software e ricordare all'utente che deve fornire e convalidare il relativo indirizzo e-mail per attivare l'account Webex.
-
È possibile monitorare lo stato di attivazione dell'utente sul modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi diattivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli nella vista Stato utente che consentono agli amministratori di Cisco BroadWorks provider di servizi di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Spostamento degli utenti Webex in Webex per Cisco BroadWorks
To move existing Webex users to Webex for Cisco BroadWorks, refer to the below table to determine which procedure to follow.
Existing Webex user belongs to a… |
Follow these processes to move the user |
---|---|
Consumer organization or self-signup (e.g., free account, trial account) |
|
Organizzazione cliente |
Attach Webex for BroadWorks to Existing Organization—The organization attachment (for the first user) also adds Webex for BroadWorks to subsequent users, so long as they are assigned to the correct organization. |
Existing Webex user belongs to a… |
Follow these processes to move the user |
---|---|
Consumer organization or self-signup (e.g., free account, trial account) |
If Webex for BroadWorks organization does not exist (no users are provisioned):
If Webex for BroadWorks organization exists (at least one user is provisioned):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Use this procedure to move an existing Webex user who is in a consumer organization or has a self-signup account (free account or trial account) to Webex for Cisco BroadWorks. Note that the Webex for Cisco BroadWorks organization must exist (with the first user provisioned). In this case, you can use one of these options to move users:
-
Move User (with Trusted Email)—Uses provisioning with trusted emails
-
Move User (with Untrusted Email)—Uses provisioning with untrusted emails
-
Attivazione automatica
Sposta utente (con e-mail attendibile)
If the Onboarding template uses Trusted Emails, the partner administrator can move subsequent users with this process:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Activate Account (Attivaaccount). L'utente viene reindirizzato al portale consumer Webex.
-
L'utente accede a Webex.
-
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Sposta utente (con e-mail non attendibile)
If the Onboarding template uses Untrusted Emails, the user’s email address must first be validated. L'amministratore può seguire questo processo per spostare gli utenti successivi:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito automaticamente sul bridge di provisioning BroadWorks.
-
All'utente viene inviato un testo con un collegamento di attivazione.
-
-
L'utente fa clic sul collegamento Attivazione e inserisce il relativo indirizzo e-mail.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Partecipaora.
-
Indirizzo e-mail convalidato.
-
L'utente viene reindirizzato per accedere al portale Webex Consumer.
-
-
L'utente accede a Webex.
-
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Flusso di attivazione automatica
Se l'utente dispone di un account BroadWorks esistente, potrà utilizzare il processo di attivazione automatica per spostare l'account.
-
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
-
L'utente inserisce il relativo indirizzo e-mail.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
Viene inviato un messaggio e-mail automatico all'indirizzo e-mail dell'utente.
-
-
L'utente apre il messaggio e-mail e fa clic sul collegamento Partecipa ora, che convalida l'indirizzo e-mail.
-
CI ha rilevato che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di continuare.
-
L'utente viene reindirizzato per accedere a Webex.
-
-
L'utente accede al portale consumer.
-
L'utente fa clic su Delete Account (Eliminaaccount).
-
L'account Webex precedente viene eliminato.
-
L'utente ha predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
Attach Webex for BroadWorks to Existing Organization
If you are a partner administrator adding Webex for BroadWorks services to an existing Webex customer organization, which is not yet associated with a partner managed BroadWorks enterprise, the customer organization administrator MUST approve administrator access for the provisioning request to succeed.
Organization administrator approval is needed if any of the following are true:
-
The existing customer organization has 100 users or more
-
The organization has a verified email domain
-
The organization domain is claimed
If none of the criteria above are true, then an Automatic Attach may occur.
With Provisioning Admin access, you will have limited visibility in Control Hub to the users in the existing org. It is recommended that you contact the customer admin and request Full Admin access to the org.
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
1 |
L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. For help, see Provision Customer Organizations. Si verifica quanto segue:
Suppose the customer administrator does not receive an email. In that case, the customer administrator can manually add the partner administrator (specified in the template) as the external administrator of the customer org from the Control Hub. Then retry provisioning the user, which will trigger the Webex for Cisco BroadWorks customer provision. |
2 |
With full administrator access, the partner administrator can complete the process of provisioning the customer. You will need to re-attempt the Provisioning of the customer starting from Step 1 above. However, now as an external Full Admin, you should not observe the error 2017. Once the provisioning of calling services is completed, the existing customer org will be visible as a customer underneath the Webex for BroadWorks Partner Org. The attached org’s name will not change to the BroadWorks enterprise name. The name of the attached org will be remain as it was prior to the attach process. |
Conditions of Org Attachment
-
The email address of the first BroadWorks subscriber provisioned must match the email address of an existing user in the targeted customer org. Otherwise, a new customer org will be created.
-
The first user from the existing org who is provisioned for Webex for BroadWorks is not provisioned as an admin user. Settings and entitlements from the existing org are retained.
-
The organization’s existing authentication settings take precedence over what is configured on the Webex for BroadWorks provisioning template. As a result, there is no change to how existing users log in.
-
However, if the existing customer organization has basic branding enabled, after the attach occurs the Partner's Advanced branding settings will take precedence. If the customer wants the basic branding to remain intact, then the partner must configure the customer organization to override branding in the Advanced Branding settings.
-
-
The name of the existing organization will not change.
-
There is no change to the email suppression flag setting in the existing org’s settings. This may affect newly provisioned users. Depending on how the flag is set, new users may or may not receive an email with a code that must be entered in order to complete activation.
-
Restricted Admin Mode (set by the Restricted by Partner Mode toggle) is turned off for the attached org.
-
Make sure to complete the organization attachment process (moving existing users and updating the organization ID), before you provision new users into the Webex for Cisco BroadWorks organization.
-
A BroadWorks enterprise can be associated with one Webex organziation only. You cannot provision subscribers from a single BroadWorks enterprise into separate Webex organizations.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com .
After adding the email from the Onboarding template on Partner Hub as a Full Administrator, any additional partner admins will also need to be added as an external admin with Full Administrator rights.
Detach Webex for BroadWorks from Existing Organization
Follow these steps to detach Webex for BroadWorks from an existing Webex organization. For example, if you attached Webex for BroadWorks to an existing organization by accident and want to remove the attachment.
In Standard flow detaching Webex for BroadWorks from an existing Webex organization (standard flow only) will delete all associated subscriber data and deactivate the customer’s Webex for BroadWorks subscription. Also, you will lose access to the customer organization if this is the only associated subscription. In Hybrid flow the customer subscriptions are not modified.
-
If you don’t have access to the customer settings in Control Hub, have the customer administrator grant you external administrator access by following Approve External Administrator Request.
-
Remove all Webex for BroadWorks workspaces from the organization. Use the Remove a BroadWorks Workspace API.
-
Remove all Webex for BroadWorks subscribers from the organization. Use the Remove a BroadWorks Subscriber API.
-
Remove pending Webex for BroadWorks users from the organization. For example, if users were provisioned via the untrusted email flow, and valid emails have not yet been entered, the users are left in a pending state. Follow Verify User Provisioning with Untrusted Emails to delete the users.
-
Delete the BroadWorks Calling configuration for this customer. Open the customer's Control Hub instance, click Hybrid, under BroadWorks Calling section delete all configurations.
After completing the detachment, if you want to attach Webex for BroadWorks to the customer, follow the provisioning processes to attach to an existing customer.
Manage Users and Organizations
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente vengono tenuti in BroadWorks. Un'identità e-mail distinta per l'utente e relative licenze per le funzioni Webex sono tenute in Webex.
Verifica del provisioning utenti con indirizzi e-mail non attendibili
Se si sta predis facendo il provisioning di Webex per utenti BroadWorks utilizzando il provisioning flow-through con messaggi e-mail non attendibili, gli utenti devono autoproducersi inserendo il proprio indirizzo e-mail nel portale di attivazione utenti. Se l'utente rileva un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riconorà l'errore, l'amministratore può utilizzare la procedura seguente in Partner Hub per esaminare lo stato e onboardre l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 |
Sign in to Partner Hub and find the Customer List page. |
2 |
Fare clic su View Templates (Visualizzamodelli). Select the appropriate Onboarding template you want to apply to this user. |
3 |
In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con messaggi e-mail non attendibili sia configurato correttamente:
|
4 |
Dopo il provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato di provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo Stato corrente, che mostra se l'utente è stato predisposto o se è presente un requisito in sospeso.
|
5 |
Per gli utenti con errori o requisiti in sospeso, fare clic sui tre puntini a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili durante la visualizzazione dell'elenco di utenti:
-
Export—Click this button if you want to export the user list to a CSV file.
-
Exclude provisioned users—Enable this toggle if you want to view only users with pending requirements or errors.
Modifica ID utente o indirizzo e-mail
Modifiche dell'ID utente e dell'indirizzo e-mail
ID e-mail e ID alternativo sono attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. Nella tabella seguente vengono descritti gli scopi di questi diversi attributi e le operazioni da eseguire per modificarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non è possibile modificare questo identificativo e collegare comunque l'utente allo stesso account in Webex. È possibile eliminare l'utente e crearla nuovamente se è errata. |
ID e-mail | ID utente |
Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si asserzione di attendibilità dell'e-mail Non richiesto in BroadWorks se non si asserzione di affidabilità dei messaggi e-mail Non richiesto in BroadWorks se si consente agli abbonati di attivare automaticamente |
Se l'utente è predisposto con l'indirizzo e-mail errato, è necessario effettuare un processo manuale per modificare questa impostazione in entrambi i punti:
Non modificare l'ID utente BroadWorks. Operazione non supportata. |
ID alternativo | Nessuno | Abilita autorizzazione utente, tramite e-mail e password, a fronte dell'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti devono immettere il relativo ID utente BroadWorks durante l'autenticazione. |
Modifica del pacchetto utente nell'hub partner
1 |
Accedere all'hub partner e fare clic su Clienti. |
2 |
Individuare e selezionare l'organizzazione del cliente in cui si trova l'utente. La pagina di panoramica dell'organizzazione viene visualizzata in un pannello a destra dello schermo. |
3 |
Fare clic su View Customer (Visualizzacliente). L'organizzazione del cliente viene aperta in Control Hub, che mostra la pagina Panoramica.
|
4 |
Fare clic suUtenti, quindi individuare e fare clic sull'utente interessato. |
5 |
In Servizi dell'utente, fare clicsu Webex per pacchetti BroadWorks (Sottoscrizioni). Viene visualizzato il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 |
In the Profile tab, look in the Package section and click the arrow (>) to expand the view. |
7 |
Select the package you want for this user (Basic, Standard, Premium or Softphone) and click Save. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 |
È possibile chiudere i dettagli utente e la scheda Control Hub. |
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Webex per API Cisco BroadWorks
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
-
Eseguire la richiesta di rimozione dell'API di un abbonato BroadWorks su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento a Webex per Cisco BroadWorks. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
Eseguire la richiesta DI ELIMINAZIONE DI una persona su per eliminare completamente https://developer.webex.com/docs/api/v1/people/delete-a-person l'utente.
Flow-through Provisioning
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
-
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – PAGINA IM&P integrata su BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte2.
After the service is disabled, flow-through provisioning removes the Webex for Cisco BroadWorks subscription from the user. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori dei clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla relativa organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Delete Organization
1 |
Use the People APIs to delete all users from the organization: The Remove a BroadWorks Subscriber API removes Webex for Cisco BroadWorks entitlements from a user, but does not delete the user. |
2 |
If Directory Sync is turned on, disable it. This can be done via Partner Hub or via the public API. To disable Directory Sync via Partner Hub: To disable Directory Sync via API, use the Update Directory Sync for a BroadWorks Enterprise API and disable the enableDirSync setting. All users related to BroadWorks Directory Sync for this organization will be deleted. Note that the removal of users (using either method) may take some time depending on the quantity of users. |
3 |
After all of the users are removed, use the Delete an Organization API to delete the organization. |
Canceling a Subscription from Control Hub
As the API is private, customers won't have access to it. Instead, the following steps show how customers can cancel their own subscription from Control Hub:
-
The Partner Admin can navigate to the "Hybrid" Services page on the Customer's Control Hub.
-
Locate the "BroadWorks Calling" card.
-
Once all users have been de-provisioned from Webex for BroadWorks for that Customer, the Partner should see a button to "Clear Configuration" (i.e., delete their customer_config entry in BPB).
Release Management
I controlli di gestione delle release in Partner Hub consentono ai provider di servizi Cisco BroadWorks di gestire le release fornendo loro la possibilità di controllare la data di rilascio in base alla quale le app Webex degli utenti ese upgrade all'ultimo software.
By default, the Webex App uses Automatic upgrades (Cisco-controlled monthly releases). However, with this feature, partner administrators can:
-
Configure customized release schedules with deferrals from the Cisco-default release schedule
-
Configure a single release schedule and cascade that schedule to all of the customer organizations that they manage
-
Assign different release schedules to different customer organizations
For more information about Release Management, including information on how to configure and apply customized release schedules, see the Webex article Release Management Customizations.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
-
Aggiunta di un cluster BroadWorks in Hub partner
-
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
-
Add a Onboarding template in Partner Hub
-
Edit or Delete a Onboarding template in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su |
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. |
3 |
Fare clic su View Clusters (Visualizzacluster). |
4 |
Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro a destra.
|
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Edit or Delete a Onboarding template in Partner Hub
You can edit or delete Onboarding templates in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su | |||||||||
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. | |||||||||
3 |
Fare clic su View Templates (Visualizzamodelli). | |||||||||
4 |
Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere Assistente Webex follow-up su attività, prendere nota di importanti decisioni ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant for Meetings is available for free for Premium and Standard package meeting sites and Personal Meeting Rooms. Il supporto include sia i siti nuovi che quelli esistenti.
Enable Webex Assistant for Meetings
Webex Assistant is by default enabled for both Standard and Premium package Broadworks Customers.
Partner Administrators and Customer Organization Administrators can disable the feature for Customer Organizations through Control Hub.
Limiti
The following limitations exist for Webex for Cisco BroadWorks:
-
Support is limited to Premium and Standard package meeting sites and Personal Meeting Rooms only.
-
Closed captioning transcriptions are supported in English, Spanish, French, and German only.
-
Content sharing via email can be accessed only by users within your organization
-
Meeting content is not accessible to users outside your organization. Meeting content is also not accessible when shared between users of different packages from within the same organization.
-
With the Premium package, post-meeting transcriptions are available whether Webex Assistant is enabled or disabled. However, if local recording is selected, post-meeting transcripts or highlights are not captured.
-
With the Standard package, Record meeting on cloud option is not available and so post-meeting transcriptions are not available whether Webex Assistant is enabled or disabled. However, if local recording is selected, even then post-meeting transcripts or highlights are not captured.
Additional Information About Webex Assistant
For user information on how to use the feature, see Use Webex Assistant in Webex Meetings and Events.
Disabilita Webex Calls
Free Webex calling is enabled by default letting users place free calls to any Webex-enabled device. However, if you want all calls to use the BroadWorks infrastructure, you can disable Webex calls within a Onboarding template, which disables that option for the customer organizations that use the template.
Supporto funzioni
When Webex Calling is disabled, the following conditions apply to Webex for Cisco BroadWorks users:
-
Users no longer see Call with Webex as a selectable call option on the Webex App.
-
Users cannot place or receive free Webex calls to non-Webex for Cisco BroadWorks users. This includes calls initiated from a Webex team space, Call History, Contacts, by entering the other user's URI or email address in the Search bar.
-
Screen sharing works within a BroadWorks call.
-
Webex meetings, and telephony presence still work, even if Webex Calls are disabled.
Disable Webex Calls (New Onboarding template)
While configuring a new Onboarding template, you can configure whether Webex calls are enabled or disabled by checking or unchecking the Disable Cisco Webex Free Calling check box within the Add a new template wizard. This setting will be picked up for users in customer organizations that you assign to the template.
For details on configuring a new Onboarding template, see Configure Your Partner Organization in Partner Hub.
Disable Webex Calls (Existing Onboarding template)
Follow this procedure to disable Webex calls from an existing Onboarding template. This will disable the feature for all new users in customer organizations that use this template.
-
Sign in to Partner Hub at admin.webex.com.
-
Choose Settings.
-
Click View Template and choose the appropriate Onboarding template.
-
Click Disable Cisco Webex Free Calling.
-
Fare clic su Salva.
Disable Webex Calls (Existing User)
Disabling this feature on a Onboarding template changes the setting only for new users who are assigned to the template. To disable Webex Calls for an existing user, you can follow one of the below procedures to update the user.
If you are using flow-through provisioning, you can do the following:
-
Open CommPilot and go to the user configuration.
-
Remove the Integrated IM+P service from the user and click OK.
-
Add the Integrated IM+P service to the user and click OK.
Otherwise, you can use the API to update the user.
-
Use the Remove a BroadWorks Subscriber API to delete the user.
-
Use the Provision a BroadWorks Subscriber API to add the user.
Disable Video or Screen Sharing within Calls
Partner administrators can use configuration tags to disable video calls and/or screen sharing within a call from the Webex App (by default, both media types are enabled for calls).
For full configuration details and options, see Disable Video Calls and Disable Screen Sharing in the Webex for Cisco BroadWorks Configuration Guide.
Busy Lamp Field / Call Pickup Notification
Busy Lamp Field (BLF) / Call Pickup Notification leverages the BLF and Directed Call Pickup features. A BLF user receives an audio and visual notification on the Webex App when a user from the BLF monitored list receives an incoming call. The BLF user can Ignore or Pick up the monitored user’s call.
BLF / Call Pickup Notification helps in situations where a user needs to answer calls for other team members who may be working in a different location.
Users can also see their BLF monitored list in the Multi-Call Window - Watchlist section - (Windows only, Mac not supported) to see the presence of their Webex and non-Webex team members. For help with enabling multi-call, see: Multi-Call Window
Webex members will have a full Webex presence. Non-Webex members must be directory synced into Webex, and they will only have "unknown" and "in-a-call" states (ringing state will trigger the call pickup dialog).
Limitations of Presence for Non-Webex users:
-
Presence is not supported for non-CI broadworks users, even if they are in the BLF list.
-
CI users without Webex cloud entitlement or machine type of accounts (workspaces) only show ‘in-call’ and ‘unknown’ presence. There is no active, ringing, etc. status.
-
Non-Webex users from the BLF watch list, who started a call before the Webex client was started or while it was offline will be shown with an ‘unknown’ presence.
-
Losing your connection means all the non-Webex in-call states will be reset to ‘unknown’ upon reconnecting.
-
If a non-Webex user from the BLF holds a call they will continue to be shown as ‘in a call’.
Requisiti
Make sure that the following patches are applied on BroadWorks. Install only the patches that apply to your release:
Per R22:
-
AP.platform.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382362
-
AP.xsp.22.0.1123.ap382053
-
AP.xsp.22.0.1123.ap382362
-
AP.as.22.0.1123.ap383459
-
AP.as.22.0.1123.ap383520
Per R23:
-
AP.platform.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382362
-
AP.as.23.0.1075.ap383459
-
AP.as.23.0.1075.ap383520
-
If you're using XSP|ADP:
-
AP.xsp.23.0.1075.ap382053
-
AP.xsp.23.0.1075.ap382362
-
-
If you're using ADP:
-
Xsi-Actions-23_2022.01_1.200.bwar
-
Xsi-Events-23_2022.01_1.201.bwar (or later)
-
Per R24:
-
AP.as.24.0.944.ap382053
-
AP.as.24.0.944.ap382362
-
AP.as.24.0.944.ap383459
-
AP.as.24.0.944. ap383520
-
Xsi-Actions-24_2022.01_1.200.bwar
-
Xsi-Events-24_2022.01_1.201.bwar (or later)
Make sure that the following configuration tags are enabled on the Webex App:
-
<busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">
-
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
-
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(this tag is optional)
You must activate feature 101642 Enhanced Xsi Mechanism For Team Telephony on the AS:
AS_CLI/System/ActivatableFeature> activate 101642
Enable X-BroadWorks-Remote-Party-Info
on the AS using the below CLI command as some SIP call flows require this feature:
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Make sure that the following services are assigned to users:
-
Assign the Directed Call Pickup service for all users
-
Set up the Busy Lamp Field for users
Configure Busy Lamp Field on BroadWorks
Partner administrators can use the following procedure to set up the Busy Lamp Field for a user.
-
Sign in to BroadWorks CommPilot.
-
For a selected user, go to Client Applications and configure the Busy Lamp Field.
-
Add the URL of the BLF list that will be monitored.
-
Use the search parameters to locate and add users to the Monitored Users list.
-
Fare clic su OK.
Slido Integration Support
Webex for Cisco BroadWorks supports Webex App integration with Slido.
Slido è uno strumento facile da utilizzare per il coinvolgimento del pubblico. Consente alle persone di ottenere il massimo dalle riunioni colmando la differenza tra gli oratori e i partecipanti. Se Slido questa funzione è integrata nell'organizzazione Control Hub, gli utenti possono aggiungere l'app Slido alle relative riunioni nell'app Webex. Questa integrazione aggiunge funzionalità Q&A di sondaggi e di sondaggi aggiuntivi alla riunione.
For additional information on how to deploy and use Slido with the Webex App, see Integrate Slido with Webex App.
Webex Availability: In a Calendar Meeting
When you have accepted a meeting in your Outlook client that is an appointment, ad hoc meeting, or a non-Webex meeting, your Webex availability appears as “In a calendar meeting”. This availability lets your colleagues know that you are otherwise engaged and that a response may be delayed.
Per abilitare questa funzione:
-
navigate to the General tab of your Settings tab on Windows or Preferences on Mac.
-
Check the box to Show when in a calendar meeting.
Caveat
For this feature to work you must have the Webex app and Outlook client running at the same time.
We are currently working to support the ‘Show as Working Elsewhere’ option in Outlook to not show a user as “In a calendar meeting” in Webex.
If a user chooses to disable “Show when in a calendar meeting” while they are currently in a calendar meeting, their presence will not update until the meeting has ended. This will require a client restart to pick up.
Automatic Answer with Tone
With automatic answer with tone, users can make a call from a third-party app, such as Contact Center, and the call is routed automatically through the Webex App on their desktop. When the Webex App rings the other party, the user hears a certain tone, advising them that the call is connecting.
For a Webex for Cisco BroadWorks user to use this feature:
-
The feature is supported on the primary line appearance only
-
The Webex App must be the primary line appearance
-
The %ENABLE_AUTO_ANSWER_WXT% tag must be enabled
If the user also has Shared Call Appearances (for example, a desk phone is configured as one of the secondary line appearances), the feature is still supported on the primary appearance so long as the shared call appearances are configured to not to receive incoming calls. This can be accomplished by configuring either of the following three conditions on BroadWorks for all shared call appearances:
-
Alert all appearances for Click-to-Dial calls is disabled in the Shared Call Appearance configuration—this is the recommended approach
o
-
Allow Termination to this location must be disabled for all shared call appearances or
o
-
Locations are disabled for all shared call appearances
Aumento della capacità
XSP|ADP Farms
We recommend you use the capacity planner to determine how many additional XSP|ADP resources you need for the proposed increase in subscriber numbers. Per uno dei server NPS dedicati o dedicati a Webex per Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
-
Scale dedicated farm: Add one or more XSP|ADP servers to the farm that needs extra capacity. Installare e attivare la stessa serie di applicazioni e configurazioni dei nodi esistenti del sistema.
-
Add dedicated farm: Add a new, dedicated XSP|ADP farm. Sarà necessario creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti sul nuovo registro, per esitare gli utenti a essere presenti nell'hub esistente.
-
Add specialized farm: If you are experiencing bottlenecks for a particular service, you may want to create a separate XSP|ADP farm for that purpose, taking into consideration the co-residency requirements listed in this document. Potrebbe essere necessario riconfigurare i cluster Control Hub e le voci DNS se si modifica l'URL del servizio con un nuovo registro.
In tutti i casi, il monitoraggio e la risorsa dell'ambiente BroadWorks è di responsabilità. Se si desidera coinvolgere l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare servizi professionali.
Gestione dei certificati del server HTTP
You must manage these certificates for mTLS authenticated web applications on your XSP|ADPs:
-
Certificato di catena di fiducia del cloud Webex
-
Your XSP|ADP’s HTTP server interfaces’ certificates
Catena di fiducia
You download the chain of trust certificate from Control Hub and install it on your XSP|ADPs during your initial configuration. Si prevede di aggiornare il certificato prima della scadenza e di notificare come e quando modificarlo.
Interfacce server HTTP
The XSP|ADP must present a publicly signed server certificate to Webex, as described in Order Certificates. Quando si protegge per la prima volta l'interfaccia, viene generato un certificato autofirmato. Questo certificato è valido per un anno a partire da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Restricted by Partner Mode is a Partner Hub setting that partner administrators can assign to specific customer organizations to limit the organization settings that customer administrators can update in Control Hub. When this setting is enabled for a given customer organization, all of that organization's customer administrators, irrespective of their role entitlements, are unable to access a set of restricted controls in Control Hub. Only a partner administrator can update the restricted settings.
Accesso amministratore cliente
Customer administrators receive a notification when Restricted-by-Partner Mode is applied. After login, they will see a notification banner at the top of the screen, immediately under the Control Hub header. The banner notifies the customer administrator that Restricted Mode is enabled and they may not be able to update some calling settings.
For a customer administrator in an organization where Restricted by Partner Mode is enabled, the level of Control Hub access is determined with the following formula:
(Control Hub access) = (Organization Role entitlements) - (Restricted by Partner Mode restrictions)
Customer administrators will face several restrictions, regardless of the Restricted-by-Partner Mode. These restrictions include:
- Call Settings: The 'App Options Call Priority' settings in the Calling menu are read-only.
- Location Setup: Setting up calling after location creation will be hidden.
- PSTN Management and Call Recording: These options will be greyed out for the location.
- Phone Number Management: In the Calling menu, phone number management is disabled, and the 'App Options Call Priority' settings, as well as call recordings, are read-only.
Restrictions
When Restricted-by-Partner Mode is enabled for a customer organization, customer administrators in that organization are restricted from accessing the following Control Hub settings:
-
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
-
Manage Users button is greyed out.
-
Manually Add or Modify Users—No option to add or modify users, either manually or via CSV.
-
Claim Users—not available
-
Auto-assign Licenses—not available
-
Directory Synchronization—Unable to edit directory sync settings (this setting is available to Partner-level admins only).
-
User details—User settings such as First Name, Last Name, Display Name and Primary Email* are editable.
-
Reset Package—No option to reset the package type.
-
Edit Services—No option to edit the services that are enabled for a user (e.g., Messages, Meetings, Calling)
-
View Services status—Unable to see full status of Hybrid Services or Software Upgrade Channel
-
Primary Work Number—This field is read-only.
-
-
Nella vista Account, non sono disponibili le seguenti impostazioni:
-
Company Name is read-only.
-
-
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
-
Domain—Access is read-only.
-
Email—The Suppress Admin Invite Email and Email Locale Selection settings are read-only.
-
Authentication—No option to edit Authentication and SSO settings.
-
-
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
-
Call Settings—The App Options Call Priority settings are read-only.
-
Calling Behavior—Settings are read-only.
-
Location > PSTN—The Local Gateway and Cisco PSTN options are hidden.
-
-
Under SERVICES, the Migrations and Connected UC service options are suppressed.
Abilita limitato dalla modalità partner
Partner administrators can use the below procedure to enable Restricted by Partner Mode for a given customer organization (the default setting is enabled).
-
Sign in to Partner Hub ( https://admin.webex.com) and select Customers.
-
Selezionare l'organizzazione del cliente applicabile.
-
Nella vista delle impostazioni a destra, abilitare l'interruttore Limitato dalla modalità partner per attivare l'impostazione.
Se si desidera disattivare Limitazione della modalità partner, disabilitare l'interruttore.
If the partner removes the restricted administrator mode for a customer administrator, the customer administrator will be able to perform the following:
-
Add Webex for Wholesale users (with the button)
-
Change packages for a user
For more information on list of time zones supported for Wholesale Provisioning, see the List of Time Zones supported for Wholesale Provisioning.
Partner Analytics
I miglioramenti apportati a Control Hub rendono semplice agli amministratori dei partner visualizzare e aggiornare le informazioni del pacchetto per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata tra tutti i clienti e include i seguenti dettagli:
-
Totale utenti per pacchetto (Softphone, Basic, Standard, Premium)
-
Tendenza utenti per pacchetto (giornaliera/settimanale/mensile)
-
Clienti con n. di pacchetti assegnati
Per dettagli completi sull'uso della funzionalità di analisi dei partner, vedere l'articolo Webex Analytics per Webex per i pacchetti Eseeme e Webex per pacchetti Broadworks in Partner Hub.
Billing Report APIs
Webex for Developers provides public APIs that can be used for monthly billing reports. Partner administrators can use these APIs to create, list, get and delete billing reports. The following table lists the APIs, the type of access required and the role requirements.
Billing API |
Scopo |
Type of Access |
Role Requirement for API (Admin requires at least one of these roles) |
---|---|---|---|
Create a BroadWorks Billing Report |
Used to generate a billing report. |
Write access |
|
List BroadWorks Billing Reports |
Used to list the reports that are available to view. |
Read Access |
|
Get a BroadWorks Billing Report |
Used to obtain a copy of a generated report. |
Read Access |
|
Delete a BroadWorks Billing Report |
Used to delete a generated report. |
Write Access |
|
Billing Fields
The following table lists the fields that are contained in the generated report.
Campo |
Descrizione |
---|---|
resellerName |
Partner name or Partner Org Id |
billingId |
Partner Unique Billing Identifier or C-Number |
spEnterpriseId |
The Service Provider-supplied unique identifier for the subscriber's enterprise. |
Interno |
The Customer Internal Trial Status (Yes/No) |
userId |
The userID of the subscriber on BroadWorks |
subscriberId |
A unique identifier for the subscriber in question in Webex |
selfActivated |
Yes/No |
firstStartDate |
Date when subscriber was provisioned. |
billingStartDate |
Date when billing starts in this month |
billingEndDate |
Date when billing ends in this month |
pacchetto |
The package type that is being charged |
quantity |
Prorated quantity for billing.
|
-
Once you generate a billing report for a specific period, you cannot regenerate that report unless you first delete the existing report.
-
If you change either the package type or BroadWorks userID for a given user, the report for the month where the change occurred shows multiple entries for that user with separate prorated entries before and after the change.
Risoluzione dei problemi di Webex per Cisco BroadWorks
Iscrizione alla pagina di stato Webex
Innanzitutto, https://status.webex.com verificare se si verifica un'interruzione imprevista del servizio. Se non è stata modificata la configurazione in Control Hub o BroadWorks prima dell'interruzione, controllare la pagina di stato. Per ulteriori informazioni sulla sottoscrizione per lo stato e le notifiche di incidenti, vedere il Centro di assistenza Webex.
Uso della funzionalità di analisi di Control Hub
Webex tiene traccia dei dati di utilizzo e qualità per la propria organizzazione e per le organizzazioni dei clienti. Ulteriori informazioni sulla funzionalità di analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
I clienti o gli utenti non vengono creati in Control Hub con provisioning flow provisioning:
-
Il server dell'applicazione può raggiungere l'URL di provisioning?
-
L'account di provisioning e la password sono corretti, se esistono in BroadWorks?
I cluster non riescono regolarmente con i test di connettività:
La connessione mTLS al servizio di autenticazione dovrebbe non riuscire quando si crea il primo cluster in Partner Hub poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. Without that, you cannot create a trust anchor on the authentication service XSP|ADPs, so the test mTLS connection from Partner Hub is not successful.
-
Are the XSP|ADP interfaces publicly accessible?
-
Si stanno utilizzando le porte corrette? È possibile inserire una porta nella definizione dell'interfaccia sul cluster.
Convalida interfacce non riuscita
Interfacce Xsi-Actions e Xsi-Events:
- Controllare che gli URL di interfaccia siano immessi correttamente sul cluster in Partner Hub, incluso
/v2.0/
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Esaminare l'avviso di configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Controllare che gli URL di interfaccia siano immessi correttamente sul cluster in Partner Hub, incluso
/v2.0/
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Rivedere i consigli di configurazione dell'interfaccia in questo documento, con particolare attenzione su:
- Make sure you shared RSA keys across all XSP|ADPs.
- Make sure you provided AuthService URL to the web container on all XSP|ADPs.
- Se è stata modificata la configurazione di crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. The XSP|ADP requires that you enter the IANA name format for the TLS ciphers. Una versione precedente di questo documento indicava in modo errato le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
-
If you are using mTLS with Authentication Service, are the Webex client certificates loaded on your XSP|ADP/ADP trust store? L'app (o l'interfaccia) è configurata per richiedere certificati client?
-
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere certificati client?
Problemi del client
Verificare che il client sia connesso a BroadWorks
-
Accedere all'app Webex.
-
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.
-
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici. Viene visualizzato lo stato della SSO è stato eseguito l'accesso.
Se viene visualizzato un altro servizio telefonico, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Ciò significa:
-
Il client ha transverso correttamente i microservizi Webex richiesti.
-
L'utente è stato autenticato correttamente.
-
Il client è stato emesso un token Web JSON a lungo termine dal sistema BroadWorks.
-
Il client ha recuperato il profilo del dispositivo ed è registrato per BroadWorks.
Registri client
Tutti i client app Webex possono inviare log a Webex. Questa è l'opzione migliore per client mobili. È necessario registrare anche l'indirizzo e-mail dell'utente e l'ora approssimativa del problema, se si desidera assistenza dal Tac. For more information, see Where Do I Find Support for Webex?
Se occorre raccogliere manualmente i registri da un PC Windows, si trovano nel seguente modo:
Windows PC: C:\Users\{username}\AppData\Local\CiscoSpark
Mac: /Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS non configurata correttamente
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
-
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
-
Verificare che la catena di certificati Webex sia installata come trust anchor.
-
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e che sia firmato da un'autorità di certificazione attendibile.
Messaggio interruzione licenza
Questo messaggio può essere visualizzato per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'uso della licenza supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
For detailed information on troubleshooting Webex for Cisco BroadWorks, refer to the Webex for Cisco BroadWorks Troubleshooting Guide.
Supporto
Criteri di supporto stato originale
Il provider di servizi è il primo punto di contatto per il supporto clienti finale (enterprise). Inoltrare i problemi che il SP non può risolvere al TAC. Il supporto della versione server BroadWorks segue i criteri della Versione corrente e delle due precedenti versioni principali (N-2). Read more at BroadSoft products lifecycle policy section in BroadSoft Lifecycle Policy and BroadWorks Software Compatibility Matrix.
Criteri di escalation
-
L'utente (provider di servizi/partner) è il primo punto di contatto per il supporto dei clienti finali (enterprise).
-
I problemi che non possono essere risolti dal SP vengono inoltrati al TAC.
Versioni BroadWorks
-
Il supporto della versione server BroadWorks segue i criteri di BroadSoft, della versione corrente e delle due versioni principali precedenti (N-2). Read more at BroadSoft products lifecycle policy section in BroadSoft Lifecycle Policy and BroadWorks Software Compatibility Matrix.
Risorse di self-support
-
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, in cui è disponibile una pagina specifica di Webex per Cisco BroadWorks che elenca la Guida per l'app Webex comune e gli argomenti di supporto.
-
È possibile personalizzare l'app Webex con questo URL della Guida e un URL per la segnalazione di problemi.
-
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I log vengono nel cloud Webex, dove possono essere analizzati da Webex DevOps.
-
È disponibile anche una pagina del Centro assistenza dedicata alla guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccolta delle informazioni per l'invio di una richiesta di assistenza
Quando si visualizzano errori in Control Hub, è possibile che siano state allegati informazioni che consentono al Tac di ricercare la causa del problema. Ad esempio, se viene visualizzato un ID di verifica per un determinato errore o un codice di errore, salvare il testo da condividere con noi.
Provare a includere almeno le seguenti informazioni quando si invia una query o si apre un caso:
-
ID organizzazione cliente e ID organizzazione partner (ciascun ID è una stringa di 32 cifre esadecimali, separate da trattini)
-
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce una
-
Indirizzo e-mail utente (se si verificano problemi con un determinato utente)
-
Versioni del client (se il problema presenta sintomi notati attraverso il client)
Webex per riferimento a BroadWorks
Confronto DI UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > |
UC-One SaaS |
Webex per Cisco BroadWorks |
---|---|---|
Cloud |
Cisco UC-One Cloud (GCP) |
Cloud Webex (APPLICAZIONI WEBEX) |
Client |
UC-One: Mobile, Desktop Receptionist, Supervisore |
Webex: Mobile, Desktop, Web |
Principale differenza tecnologia |
Riunioni consegnate su Broadsoft Meet Technology |
Riunioni consegnate su Webex Meetings Technology |
Versioni di prova sul campo iniziali |
Ambiente di gestione temporanea, client Beta |
Ambiente di produzione, client GA |
Identità utente |
BroadWorks ID utilizzato come ID principale, a meno che provider di servizi sito non SSO già.
ID utente e segreto in BroadWorks |
ID e-mail in Cisco CI serve come ID principale SSO integrazioni in provider di servizi BroadWorks in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks in quel momento.
L'utente fornisce le credenziali tramite SSO broadworks e secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e autenticazione nel provider di identità |
Autenticazione client |
Gli utenti forniscono le credenziali tramite il client Token a lungo accesso BroadWorks richiesti se si utilizza la messaggistica Webex |
Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso e aggiornamento dei token Webex |
Gestione/configurazione |
I sistemi ANDR E BSS e Portale rivenditore |
SISTEMI CUI/BSS e Control Hub |
Attivazione partner/provider di servizi partner |
Una sola impostazione per Cisco Operations |
Una sola impostazione per Cisco Operations |
Attivazione cliente/aziendale |
Portale rivenditore |
Control Hub Creazione automatica alla prima iscrizione utente |
Opzioni di attivazione utente |
Auto iscrizione Impostazione di IM&P esterno in BroadWorks
|
Impostazione di Integrated IM&P in BroadWorks (solitamente aziende) |
XSP|ADP service interfaces |
Azioni XSI
Eventi XSI CTI (mTLS) AuthService (mTLS opzionale) DMS |
Azioni XSI Azioni XSI (mTLS) Eventi XSI CTI (mTLS) AuthService (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 |
Scaricare e installare Webex. Per dettagli, vedere Webex | Download dell'app. |
2 |
Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 |
Inserire il proprio indirizzo e-mail e fare clic su Next(Avanti). |
4 |
In base alla configurazione dell'organizzazione in Webex, si verificano le seguenti operazioni: Webex viene caricato dopo aver eseguito correttamente l'autenticazione per IdP o BroadWorks.
|
Scambio dati e storage
Queste sezioni forniscono dettagli sullo scambio di dati e sullo storage con Webex. Tutti i dati sono crittografati sia in viaggio che a riposo. Per ulteriori dettagli, vedere Sicurezza app Webex.
provider di servizi ilboarding
Quando si configurano cluster e modelli utente in Webex Control Hub durante provider di servizi onboarding, si scambiano i seguenti dati BroadWorks memorizzati da Webex:
-
URL azioni Xsi
-
Xsi-Events URL
-
URL interfaccia CTI
-
URL servizio di autenticazione
-
Credenziali dell'adattatore provisioning BroadWorks
provider di servizi provisioning utente
Questa tabella elenca i dati utente ed aziendale s scambiati come parte del provisioning degli utenti attraverso le API Webex.
Trasferimento dati a Webex |
Da |
Attraverso |
Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito da SP) |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito dall'utente) |
Utente |
Portale di attivazione utente |
Sì |
Nome |
BroadWorks, per API |
API Webex |
Sì |
Cognome |
BroadWorks, per API |
API Webex |
Sì |
Numero di telefono principale |
BroadWorks, per API |
API Webex |
Sì |
Numero telefono cellulare |
BroadWorks, per API |
API Webex |
Sì |
Estensione principale |
BroadWorks, per API |
API Webex |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
BroadWorks, per API |
API Webex |
Sì |
Lingua |
BroadWorks, per API |
API Webex |
Sì |
Fuso orario |
BroadWorks, per API |
API Webex |
Sì |
Rimozione utente
Webex per api Cisco BroadWorks supporta la rimozione parziale e completa degli utenti. Questa tabella elenca tutti i dati utente archiviati durante il provisioning e ciò che viene eliminato in ciascuno scenario.
Dati utente |
Eliminazione parziale |
Eliminazione completa |
---|---|---|
ID utente BroadWorks |
Sì |
Sì |
|
No |
Sì |
Nome |
No |
Sì |
Cognome |
No |
Sì |
Numero di telefono principale |
Sì |
Sì |
Numero telefono cellulare |
Sì |
Sì |
Estensione |
Sì |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
Sì |
Sì |
LANGUAGE |
No |
Sì |
Recupero accesso utente e configurazione
Autenticazione Webex
Webex authentication refers to user sign-in to a Webex app by any of the Webex support authentication mechanisms. ( BroadWorks authentication is covered separately.) This table illustrates the type of data exchanged between the different components on the authentication flow.
Spostamento dei dati |
Da |
a |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (indipendente) |
Webex |
Browser utente |
Credenziali utente |
Browser utente |
Provider di identità (che dispone già di identità utente) |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Autenticazione BroadWorks
BroadWorks authentication refers to user sign-in to a Webex app using their BroadWorks credentials. Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti del flusso di autenticazione.
Spostamento dei dati |
Da |
a |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (proxy IdP Webex Bwks) |
Webex |
Browser utente |
Informazioni sul branding e URL BroadWorks |
Webex |
Browser utente |
Credenziali utente BroadWorks |
Utente attraverso il browser (pagina di accesso con branded servita da Webex) |
Webex |
Credenziali utente BroadWorks |
Webex |
BroadWorks |
File BroadWorks profilo utente |
BroadWorks |
Webex |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
BroadWorks Password Expiration Notification During Login
This feature enhances the login process and controls the login flow based:
Login warning and error message enhancement:
- At present the Wexbex for BWKS users who use BroadWorks authentication and login through the UAP do not get notification that their password is about to expire or that they are unable to login because the password has already expired. With this feature, if the password is about to expire in 10 days or less - the user receives warning that password is about to expire with indication how many days are left, and the user is advised to contact the Partner, or to follow the Forgot Password link on the login screen to reset their password.
- If the password has expired and the configuration in BroadWorks ‘enforcePasswordChangeOnExpiry’ is set to true then error “incorrect username and password” was thrown but now with this feature the error message is enhanced: The login attempt failed. The combination of the User ID and password provided does not match our records or your password needs to be updated. Try again or contact your administrator to update the password. Error code 100006
Control login flow:
- Partner can restrict the login by enabling a setting “w4bwks-password-expiry-fail-login". This setting “can be enabled by Cisco upon request from a partner. If BroadWorks password has expired, the configuration in BroadWorks ‘enforcePasswordChangeOnExpiry’ is set to false and the setting ‘w4bwks-password-expiry-fail-login' is enabled then error is thrown saying password got expired x days ago whereas if setting service is disabled, then login is allowed. By default, the setting is disabled.
The Forgot Password link on the login page can be configured by the partner as part of the Advanced Customization feature. Partners would typically configure the link to navigate the user to a partner portal for password management and password reset.
This feature only improves the user login experience during login of activated user when the password is about to expire or has already expired. The feature does not handle if a password expires while the user is logged in the Webex app. The user will get notification for password expiration on their next login attempt.
Recupero configurazione client
Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti nel recupero delle configurazioni del client.
Spostamento dei dati |
Da |
a |
---|---|---|
Iscrizione |
Client |
Webex |
Impostazioni dell'organizzazione, inclusi gli URL BroadWorks |
Webex |
Client |
Token BroadWorks JWORKS |
BroadWorks attraverso Webex |
Client |
Token BroadWorks JWORKS |
Client |
BroadWorks |
Token dispositivo |
BroadWorks |
Client |
Token dispositivo |
Client |
BroadWorks |
File di configurazione |
BroadWorks |
Client |
Utilizzo stato originale
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione in seguito alla scadenza del token attraverso BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Spostamento dei dati |
Da |
a |
---|---|---|
Segnalazione SIP |
Client |
BroadWorks |
Contenuto multimediale SRTP |
Client |
BroadWorks |
Segnalazione SIP |
BroadWorks |
Client |
Contenuto multimediale SRTP |
BroadWorks |
Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Spostamento dei dati |
Da |
a |
---|---|---|
Messaggistica e presenza HTTPS REST |
Client |
Webex |
Messaggistica e presenza HTTPS REST |
Webex |
Client |
Segnalazione SIP |
Client |
Webex |
Contenuto multimediale SRTP |
Client |
Webex |
Segnalazione SIP |
Webex |
Client |
Contenuto multimediale SRTP |
Webex |
Client |
Uso dell'API di provisioning
Accesso sviluppatore
La specifica API è disponibile su https://developer.webex.com e una guida all'uso è su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l'accesso per leggere la specifica API su https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Autenticazione e autorizzazione dell'applicazione
Your application integrates with Webex as an Integration. Questo meccanismo consente all'applicazione di eseguire attività amministrative (come il provisioning del sottoscrittore) per un amministratore all'interno dell'organizzazione partner.
Webex APIs follow the OAuth 2 standard ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere i token di aggiornamento e di accesso per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
È necessario prima registrare l'integrazione con Webex. Una volta registrata, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di aggiornamento e accesso necessari.
Per ulteriori informazioni sulle integrazioni e su come creare questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli richiesti per l'implementazione delle integrazioni, lo sviluppatore e l'utente che ha autorizzato, e possono essere tenute da persone/team separati nel proprio ambiente.
-
Lo sviluppatore crea l'app e la registra su per generare il ClientID/Secret OAuth richiesto con gli ambito previsti per https://developer.webex.com l'applicazione. Se l'applicazione è stata creata da terze parti, potrebbe registrare l'applicazione (se è stato richiesto l'accesso) o è possibile farlo con il proprio accesso.
-
L'utente autorizzato è l'account che l'applicazione utilizza per autorizzare le chiamate API, per modificare l'organizzazione partner, le organizzazioni dei clienti o i relativi abbonati. Questo account deve avere il ruolo di amministratore completo o amministratore completo di vendite nell'organizzazione partner. Questo account non deve essere mantenuto da terze parti.
Nome organizzazione
The Organization Name depends on which provisioning mode you use:
-
Enterprise mode—The Organization Name is an exact match of spEnterpriseId.
-
Service Provider mode—The Organization Name is the groupID portion of the spEnterpriseId.
The Organization Name will contain any whitespace, uppercase and special characters specified in the original spEnterpriseId.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
We expect the Service Provider to be "patch current" with the latest BroadWorks patches and Release Independent (RI) apps. L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Versione R22
Server |
Patch |
Additional Info |
---|---|---|
Server applicazione | ||
Required for Directory Sync | ||
Required to upgrade from V1 to V2 Push Notifications | ||
Required patch for Application Server | ||
Required to upgrade from V1 to V2 Push Notifications | ||
Required patch for Call Recording feature | ||
Required Patch for Flow-through Provisioning | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
Server dei profili | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
Piattaforma | ||
Required for NPS Authentication Proxy | ||
Required for NPS Authentication Proxy | ||
Required for the Auth Service with CI Token Validation | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
XSP|ADP |
Required for NPS Authentication Proxy | |
Required for the Auth Service with CI Token Validation | ||
Required for NPS Authentication Proxy | ||
Required to upgrade from V1 to V2 Push Notifications | ||
Required for NPS Authentication Proxy | ||
Required for NPS Authentication Proxy | ||
Required for the Auth Service with CI Token Validation | ||
Required for Unified Call History | ||
Altro |
AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server |
Patch |
Additional Info |
---|---|---|
Server applicazione |
Required for Directory Sync | |
Config App Server | ||
Required to upgrade from V1 to V2 Push Notifications | ||
Required for Call Recording | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
Server dei profili | ||
Piattaforma | ||
Required for NPS Authentication Proxy | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
XSP|ADP | ||
Required for NPS Authentication Proxy | ||
Required to upgrade from V1 to V2 Push Notifications | ||
Required for NPS Authentication Proxy | ||
Required for NPS Authentication Proxy | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
Altro |
Se si utilizza ADP... |
Required Patch for Hook Status (Presence) and Unified Call History |
Versione R24
Server |
Patch |
Additional Info |
---|---|---|
Server applicazione |
Required for Unified Messaging Server (UMS) | |
Required for flowthrough provisioning | ||
Required for Call Recording | ||
Required Patch for Hook Status (Presence) and Unified Call History | ||
Altro |
Required Patch for Hook Status (Presence) and Unified Call History |
Tag BroadWorks richiesti per Webex
For information on the BroadWorks system tags and custom tags that you must configure for Webex, refer to the Webex for Cisco BroadWorks Configuration Guide.
Provisioning utenti e flussi di attivazione
Provisioning describes adding the user to Webex. Activation includes email validation and service assignment in Webex.
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se si dispone di indirizzi e-mail attendibili per gli utenti, è possibile scegliere di attivarli automaticamente quando vengono predisposti automaticamente. Questo processo è di "provisioning automatico e attivazione automatica".
Provisioning utenti automatizzato e attivazione automatica (flusso e-mail attendibile)
Prerequisiti
-
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
-
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
-
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase |
Descrizione |
---|---|
1 |
Si preventiva ed si eserviranno gli ordini per il servizio con i clienti. |
2 |
L'ordine del cliente viene processato ed è stato predisposto il cliente nel sistema. |
3 |
Il sistema di provisioning del servizio attiva il provisioning di BroadWorks. Questa operazione, in riepilogo, crea l'azienda e gli utenti. Quindi, assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM esterno. |
4 |
Questa operazione di provisioning attiva il provisioning automatico dell'organizzazione e degli utenti del cliente in Webex. (L'assegnazione del servizio IM&P causa la chiamata dell'adattatore di provisioning all'API di provisioning Webex). |
5 |
I sistemi devono utilizzare l'API di provisioning Webex se in seguito occorre regolare il pacchetto per l'utente (per effettuare una modifica rispetto al valore predefinito). |
SSO di accesso
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, consentendo l'autenticazione diretta a BroadWorks. L'immagine visualizza gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresentano ciò che il client fornisce per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizi BroadWorks che segue immediatamente dal flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione diretta BroadWorks abilitata (condivisione risorse multi-origine). Di seguito sono riportati alcuni flussi di SSO SAML alternativi:
-
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
-
L'unica differenza è nel punto 5 e 6 del flusso di accesso Webex. Nel punto 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
-
Il flusso procede attraverso le operazioni restanti nei due diagrammi.
-
Il SSO di registrazione non è utilizzato in questo flusso.
-
-
Autenticazione Webex SSO SAML:
-
Al punto 3 del flusso di accesso Webex, il servizio Common Identity servizi restituisce il provider di identità utilizzato dall'autenticazione Webex.
-
A questo punto, viene richiamato un flusso di SSO SAML alternativo per Webex.
-
Interazioni utente
Accedi
-
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
-
CI rileva che l'organizzazione cliente associata ha il proxy IDP BroadWorks configurato come IDP SAML. CI redirects to the IDP which presents the user with a sign-in page. (The Service Provider can brand this sign-in page.)
-
L'utente inserisce le proprie credenziali BroadWorks.
-
Broadworks autentica l'utente attraverso l'IDP. In caso positivo, IDP reindirizza il browser a CI con un SISTEMA SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
-
In caso di autenticazione eseguita correttamente, l'app Webex ottiene i token di accesso da CI (non mostrato nel diagramma). Il client le utilizza per richiedere un token JNTASSI (Jason Web Token) BroadWorks.
-
L'app Webex rileva la configurazione di chiamata da BroadWorks e da altri servizi di Webex.
-
L'app Webex si registra con BroadWorks.
Accesso dal punto di vista dell'utente
Questo diagramma è il flusso di accesso tipico, visualizzato dall'utente finale o dall'abbonato:
-
L'app Webex viene scaricata e installata.
-
È possibile che sia stato ricevuto il collegamento dal proprio provider di servizi oppure il download potrebbe essere trovato sulla pagina di download di Webex.
-
L'indirizzo e-mail viene inserito nella schermata di accesso di Webex. Fare clic su Avanti.
-
Solitamente, si viene reindirizzati a una provider di servizi a cui viene visualizzata una pagina con marchio.
-
Questa pagina potrebbe dare il benvenuto mediante il proprio indirizzo e-mail.
Se non si dispone di un indirizzo e-mail o se l'indirizzo e-mail è errato, inserire l'indirizzo nome utente BroadWorks.
-
Inserire la password BroadWorks.
-
Se è stato eseguito correttamente l'accesso, Webex si apre.
flusso chiamata: rubrica aziendale
flusso chiamata—PSTN cliente
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni client
Recupera profilo da REGISTRAZIONE DMS e SIP con AS
-
Il client chiama XSI per ottenere un token di gestione dispositivi e l'URL sul DMS.
-
Il client richiede il profilo del dispositivo dal DMS presentando il token dal punto 1.
-
Il client legge il profilo del dispositivo e recupera le credenziali SIP, gli indirizzi e le porte.
-
Il client invia un SIP REGISTER al controller SBC utilizzando le informazioni del punto 3.
-
SBC invia il SIP REGISTER ad AS (il controller SBC può eseguire una ricerca in NS per individuare un AS se SBC non conosce già l'utente SIP).
Linee guida di test e laboratorio
Le seguenti linee guida si applicano a organizzazioni di test e laboratorio:
-
provider di servizi partner sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
-
La fatturazione verrà addebitata a qualsiasi utente oltre i primi 50 utenti di prova.
-
Per assicurare un'elaborazione precisa della fattura, tutte le organizzazioni di test devono includere 'test' nel nome dell'organizzazione BroadWorks.
-
Le organizzazioni di test interne devono essere designate all'interno Webex Control Hub. Al fine di evitare che gli utenti di prova vengano fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di test:
-
Accedere all'hub partner e selezionare Clienti.
-
Selezionare il cliente appropriato.
-
Nella barra di controllo a destra, abilitare l'interruttore Organizzazione test interna.
Riproduzione segreteria telefonica
Per la segreteria telefonica, accertarsi di configurare il server multimediale per l'uso di uno dei seguenti codici:
-
mp3
-
wav— I file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android)
Se si utilizzano file wav, eseguire i seguenti comandi CLI per verificare il server dell'applicazione e server multimediale:
-
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
-
MS_CLI/Applications/MediaStreaming/Services/IVR> set sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACL
- Elenco di controllo accessi
- ALG
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APNS
- Utenti Apple servizio di notifica push
- AS
- Server applicazione
- ATA
- Adattatore telefono analogico, adattatore per la conversione della telefonia analogica VoIP
- BAM
- Gestione applicazioni BroadSoft
- Autenticazione di base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- BMS
- Server di messaggistica BroadSoft
- BOSH
- Flussi bidirezionale su HTTP sincrono
- BRI
- L'interfaccia BRI (Basic Rate Interface) è un metodo di accesso ISDN
- Bundle
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico di telefonia (cf. partner, provider di servizi, rivenditore aggiunto valore)
- CAPTCHA
- Test del turing pubblico completamente automatizzato per incisire sui computer e sull'humans apart
- CODICE CCXML
- Controllo chiamata EXtensible Markup Language
- CIF
- Formato intermedio comune
- CLI
- Interfaccia della riga di comando
- CN
- Nome comune
- CSP
- Server push notifiche chiamate. A Notification Push Server that runs on an XSP|ADP in your environment, to push call notifications to FCM and APNS. Vedere Proxy NPS.
- CPE
- Apparecchiatura locale del cliente
- CPR
- Regola di presenza personalizzata
- CSS
- Foglio di stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione di telefonia su computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- Non disturbare
- Non disturbare
- DNS
- Sistema di nomi di dominio
- DPG
- Chiama gruppo peer
- DSCP
- Punto codici servizi differenziati
- DTAF
- File di archivio del tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza dual-tone
- Utente finale
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. per l'abbonato)
- Aziendale
- Un gruppo di utenti finali (cf. organizzazione)
- FCM
- Messaggistica cloud Firebase
- FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creazione di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning flow-through completo
- Creazione e verifica di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks e l'asserzione che ciascun utente BroadWorks ha un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. Il plug-on del telefono o del fax o i plug-in sul sistema telefonico analogico. Fornisce un'indicazione di hook/off-hook (chiusura loop). Poiché la porta BLUETOOTH è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo BLUETOOTH".
- FXS
- Foreign Exchange Subscriber è la porta che consegna effettivamente la linea analogica al sottoscrittore. In altre parole, è il plug-in alla parete che offre un segnale di chiamata, una corrente a batteria e una suoneria.
- GCM
- Messaggio Google Cloud
- GCM
- Modalità Galois/Counter Mode (tecnologia di crittografia)
- NASCOSTO
- Dispositivo interfaccia utente
- HTTPS
- Protocollo di trasferimento ipertestuale socket sicuri
- IAD
- Dispositivo di accesso integrato
- IM&P
- Messaggistica immediata e presenza
- IP PSTN
- Un provider di servizi che fornisce VoIP servizi PSTN, intercambiabili con ITSP, o un termine generale per la telefonia 'pubblica' collegata da Internet, collettivamente fornito dai principali fornitori di telecomunicazioni (anziché tramite paesi, come PSTN è)
- ITSP
- Servizi di telefonia Internet provider di servizi
- IVR
- Risposta vocale interattiva/Risponditore
- JID
- The native address of an XMPP entity is called a Jabber Identifier or JID localpart@domain.part.example.com/resourcepart (@ . / are separators)
- JSON
- Notifica oggetto Java Script
- JSSE
- Estensione socket sicura Java; la tecnologia sottostante che fornisce funzioni di connettività sicura ai server BroadWorks
- KEM
- Modulo di estensione chiave (telefoni Cisco hardware)
- LLT
- Token lungo(o long life); una forma di auto-descrizione, sicura di token di connessione che consente agli utenti di rimanere autenticati per più tempo e non è legata a applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIB
- Base informazioni di gestione
- MS
- Server multimediale
- Mtls
- Autenticazione reciproca tra due parti, mediante lo scambio di certificati, quando si stabilisce una connessione TLS
- MUC
- Chat multi-utente
- NAZ
- Traduzioni indirizzi di rete
- NPS
- Server push di notifica; vedere CNPS
- NPS Proxy
-
Servizio in Webex che fornisce token di autorizzazione breve al CNPS, abilitando il push delle notifiche di chiamata su FCM e APNs e, infine, sui dispositivi Android e iOS che eseguono Webex.
- OCI
- Apri interfaccia client
- Organizzazione
- Una società o un'organizzazione che rappresenta un gruppo di utenti finali (cf. Enterprise)
- OTG
- Gruppo trunk in uscita
- Pacchetto
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. Bundle)
- Partner
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. Valore aggiunto rivenditore, provider di servizi, vettore)
- PBX
- Exchange su succursale privato
- PEM
- Messaggio e-mail avanzato sulla privacy
- PLMN
- Rete mobile su rete pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia di telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- PS
- Server dei profili
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Un sito Web che consente all'amministratore del rivenditore di configurare la propria soluzione UC-One SaaS. Talvolta è noto come portale BANG, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Controllo bordo sessione
- SCA
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; Un'organizzazione che fornisce servizi telefonici o correlati ad altre organizzazioni (cf. Gestore telefonico, partner, rivenditore aggiunto valore)
- SIP
- SIP (Session Initiation Protocol)
- SLT
- Token breve (o breve durata) (denominato anche token SSO BroadWorks); un token autenticato a uso singolo utilizzato per ottenere l'accesso protetto alle applicazioni Web.
- SMB
- Piccola e media azienda
- SNMP
- Semplice protocollo di gestione della rete
- sRTCP
- protocollo Secure Realtime Transfer Control Protocol (VoIP multimediale per chiamate in tempo reale)
- sRTP
- protocollo Secure Realtime Transfer Protocol (VoIP multimediale di chiamata)
- SSL
- Livello socket sicuri
- Abbonato
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. Utente finale)
- TCP
- Protocollo di controllo trasmissione
- TDM
- Multiplexing divisione temporale
- TLS
- Sicurezza livello di trasporto
- Tos
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Unified Communications
- UI
- Interfaccia utente
- UID
- Identificativo univoco
- UMS
- Server di messaggistica
- URI
- Uniform Resource Identifier
- URL
- Localizzatore risorse uniforme
- USS
- Server di condivisione
- UTC
- Ora universale universale
- UV
- Video Server
- Rivenditore aggiunto valore (VAR)
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. vettore, partner, provider di servizi)
- VGA
- Array di elementi grafici video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Voice Extensible Markup Language
- Webdav
- Creazione e versione per Web distributed authoring
- WebRTC
- Comunicazioni in tempo reale Web
- WRS
- WebRTC Server
- XMPP
- Protocollo di messaggistica e presenza Estendi
Appendice
Configurazione dei servizi (con mTLS per il servizio di autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida di token CI. Queste procedure sono obbligatorie se si stanno eseguendo più organizzazioni Webex dallo stesso server ADP XSP|. Altrimenti, sono opzionali.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi connettori Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione chiamataControl definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> ottenere
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia.
Configurazione del servizio di autenticazione (con mTLS)
I token longevi di BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sui tuoi XSP|ADP.
Requisiti
-
I server XSP|ADP che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
-
XSP|ADP devono condividere le stesse chiavi per crittografare/decrittografare token di lunga durata BroadWorks. Copiare queste chiavi in ogni XSP|ADP è un processo manuale.
-
Gli ADP XSP|devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli XSP|ADP include:
-
Distribuire il servizio di autenticazione.
-
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
-
Generare e condividere le chiavi RSA su XSP|ADP.
-
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ogni XSP|ADP utilizzato con Webex:
-
Attivare l'applicazione del servizio di autenticazione sul
percorso /authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> attivare application authenticationService /authService
(dove
è la versione di BroadWorks).
-
Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
Distribuzione applicazione/authService
Configurazione della durata del token
-
Controllare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
-
Impostare la durata su 60 giorni (il massimo è 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
impostazione tokenDurationInHours 1440
Genera e condividi chiavi RSA
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittografia di token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori è necessario generare chiavi su un XSP|ADP quindi copiarle su tutti gli altri XSP|ADP.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP.
-
Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
-
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
ExportKeys
-
Copiare il file esportato
/var/broadworks/tmp/authService.keys
nella stessa posizione sugli altri ADP XSP|, sovrascrivendo un file old.keys
se necessario. -
Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al container Web
Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token.
Su ciascuna delle ADP XSP|:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per lo strumento di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
imposta url http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> aggiungi tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Controllare il parametro con
get
. -
Riavviare XSP|ADP.
Configurazione di TLS e della crittografia sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurazione TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > trasporto > http > interfaccia Server HTTP = Più specifico
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il
comando get e leggere i
risultati. Dovrebbero essere presenti le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Tomcat obbligatorio un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
È necessario configurare l'interfaccia HTTP che interagisce con Webex Cloud per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocol>
-
Immettere il comando
get 443
per vedere quali protocolli sono già utilizzati in questa interfaccia. -
Immettere il comando
Aggiungi 443 TLSv1.2
per assicurarsi che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia del server HTTP
Per configurare i crittografia richiesti:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Immettere il comando
get 443
per visualizzare le crittografie già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview). -
Immettere il comando
Aggiungi 443
per aggiungere una crittografia all'interfaccia server HTTP.L'XSP|ADP CLI richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
del server HTTP, utilizzare:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>aggiungere 192.0.2.7 443 TLS_ECDHE_ECDSA_CON_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità del servizio di autenticazione (con mTLS)
-
Accedere a Control Hub con l'account dell'amministratore del partner.
-
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain2023.txt
sul computer locale.Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP|XSP. Tutti i file sono obbligatori. -
Suddividere la catena del certificato in due certificati -
combinedcertchain2023.txt
.-
Aprire
combinedcertchain2023.txt
in un editor di testo. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e -----END CERTIFICATE----- , e incollare il blocco di testo in un nuovo
file. -
Salvare il nuovo file come
root2023.txt
. -
Salvare il file originale come
emissione2023.txt
. Il file originale ora deve contenere solo un blocco di testo, racchiuso tra lerighe -----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
. -
Accedere a XSP|ADP e passare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Eseguire la GuidaUpdateTrust
per visualizzare i parametri e il formato di comando. -
Carica i file del certificato in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot2023
,webexclientissuing
ewebexclientissuing2023
sono esempi di alias per i trust anchor; è possibile utilizzare il proprio purché tutte e quattro le voci siano univoche. -
Confermare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[autofirmato]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, mTLS è richiesto per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
-
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
ed eseguire il comandoget
per visualizzare le interfacce. -
Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che corrisponde a mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> aggiungi nome porta IPAddress vero vero
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. Essenzialmente, la prima true protegge l'interfaccia con TLS (il certificato server viene creato se richiesto) e la seconda forza true l'interfaccia a richiedere l'autenticazione del certificato
client
(insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Nome porta interfaccia Secure Client Auth Req Cluster Fqdn ======================================================= 192.0.2.7 443 XSP|ADP01.collab.example.net true false 192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (Client Auth Req = true) è abilitato sulla porta 192.0.2.7
444.
TLS è abilitato sulla porta 192.0.2.7
443.
(Opzione) Configurare mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, mTLS è richiesto per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
-
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
ed eseguire il comandoget
per visualizzare le applicazioni in esecuzione. -
Per aggiungere un'applicazione e richiedere l'autenticazione del client (che significa lo stesso di mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiungere IPAddress Port ApplicationName true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. I nomi delle applicazioni sono elencati in questo elenco. Vero
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiungi 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService alla versione 192.0.2.7:443 e richiede che a tale applicazione sia richiesta e autenticata dal client.
Controlla con ottieni
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> richiedere
Interfaccia Porta IP Nome applicazione Client Autenticazione ======================================================
192.0.2.7 443 AuthenticationService true
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Tali impostazioni devono essere configurate in base alle istruzioni nella Guida alla configurazione di Gestione dispositivi BroadWorks.
Dove andare avanti
Per la configurazione, è possibile accedere nuovamente al flusso dei documenti principale su Interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca con AuthService
Webex interagisce con il servizio di autenticazione su (autenticazione) TLS reciproca connessione autenticata. Ciò significa che Webex presenta un certificato client e che XSP|ADP deve convalidarlo. Per garantire l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora attendibile su XSP|ADP (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
-
Andare a Impostazioni > Chiamata BroadWorks.
-
Fare clic sul collegamento per il download del certificato.
È possibile ottenere la catena di certificati anche da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt.
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente a XSP|ADP
Il diagramma seguente riepiloga i punti in cui la catena di certificati CA Webex deve essere distribuita in questi tre casi.
Requisiti del certificato TLS reciproca per il proxy con bridge TLS
-
Webex presenta un certificato client firmato dall'autorità di certificazione Webex nel proxy.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità del proxy, pertanto il proxy considera attendibile il certificato client.
-
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta un certificato server firmato pubblicamente con Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3:
Uso chiave estesa X509v3:
1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
-
Le ADP XSP|si fidano delle autorità di certificazione interne.
-
Gli ADP XSP|presentano un certificato del server firmato internamente.
-
Il proxy considera attendibile la CA interna.
Requisiti del certificato TLS reciproca per proxy tls passizzato o XSP in DMZ
-
Webex presenta un certificato client firmato ca Webex agli XSP.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità degli XSP, pertanto gli XSP considerano attendibile il certificato client.
-
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
-
Gli XSP presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP.
Cronologia revisioni documenti
La tabella seguente mostra lo storico delle modifiche apportate a questo documento negli ultimi 12 mesi.
Data |
Versione | Descrizione della modifica | |
---|---|---|---|
09 agosto 2024 |
2-122 |
| |
01 agosto 2024 |
2-121 |
| |
25 giugno 2024 |
2-120 |
| |
14 giugno 2024 |
2-119 |
| |
13 maggio 2024 |
2-118 |
| |
10 maggio 2024 |
2-117 |
| |
6 maggio 2024 |
2-116 |
| |
2 maggio 2024 |
2-115 |
| |
10 aprile 2024 |
2-114 |
| |
27 marzo 2024 |
2-113 |
| |
22 marzo 2024 |
2-112 |
| |
7 marzo 2024 |
2-111 |
| |
24 febbraio 2024 |
2-110 |
| |
20 febbraio 2024 |
2-109 |
| |
7 febbraio 2024 |
2-108 |
| |
25 gennaio 2024 |
2-107 |
| |
23 gennaio 2024 |
2-106 |
| |
10 gennaio 2024 |
2-105 |
| |
20 dicembre 2023 |
2-104 |
| |
13 dicembre 2023 |
2-103 |
| |
12 dicembre 2023 |
2-102 |
| |
8 dicembre 2023 |
2-101 |
| |
08 novembre 2023 |
2-100 |
| |
25 ottobre 2023 |
2-99 |
| |
13 settembre 2023 |
2-98 |
| |
04 settembre 2023 |
2-97 |
| |
08 agosto 2023 |
2-96 |
| |
23 giugno 2023 |
2-95 |
| |
30 maggio 2023 |
2-94 |
| |
26 maggio 2023 |
2-93 |
| |
24 maggio 2023 |
2-92 |
| |
10 maggio 2023 |
2-91 |
| |
9 maggio 2023 |
2-90 |
| |
4 maggio 2023 |
2-89 |
| |
27 aprile 2023 |
2-88 |
| |
14 aprile 2023 |
2-87 |
| |
17 marzo 2023 |
2-86 |
| |
11 marzo 2023 |
2-85 |
| |
10 marzo 2023 |
2-84 |
| |
7 marzo 2023 |
2-83 |
| |
28 febbraio 2023 |
2-82 |
| |
15 febbraio 2023 |
2-81 |
| |
10 febbraio 2023 |
2-80 |
| |
Panoramica di Webex per Cisco BroadWorks
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione fornisce agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei clienti o forniscono questa soluzione direttamente ai relativi abbonati.
Scopo soluzione
-
Per fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che dispongono già del servizio di chiamata fornito dai provider di servizi BroadWorks.
-
Per fornire il servizio di chiamata basato a BroadWorks a clienti Webex piccoli e medi.
Contesto
In continua continua evoluzione di tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo impegno è spostare le funzionalità di chiamata BroadWorks nell'app Webex e ridurre l'investimento nei client UC-One.
Benefici
-
Prova futura: di fronte all'end-of-life di UC-One Collaborate, movimento di tutti i clienti verso il Unified Client Framework (UCF)
-
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex e conservazione delle chiamate BroadWorks sulla rete di telefonia
Ambito soluzione
-
I clienti esistenti/nuovi e medi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre della chiamata BroadWorks.
-
I clienti Webex esistenti, da piccoli a medi, desiderano aggiungere la chiamata BroadWorks.
-
Non aziende più grandi (ti prego di esaminare il nostro portfolio Enterprise per Webex).
-
Non i singoli utenti (valutare le offerte Webex online).
Le serie di funzioni in Webex per Cisco BroadWorks hanno come obiettivo casi d'uso di piccola e media attività. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità dei sistemi SME e ne valutiamo costantemente l'idoneità per questo segmento. È possibile scegliere di nascondere o rimuovere funzioni altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# |
Requisito |
Note |
---|---|---|
1 |
Patch BroadWorks corrente R22 o superiore | |
2 |
ADP XSP| per XSI, CTI, DMS e authService |
ADP XSP|dedicato per Webex per Cisco BroadWorks |
3 |
ADP XSP|separato per NPS può essere condiviso con altre soluzioni che utilizzano NPS. |
Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni ADP e NPS XSP|. |
4 |
Convalida token CI (con TLS) configurato per connessioni Webex al servizio di autenticazione. | |
5 |
mTLS configurato per le connessioni Webex all'interfaccia CTI. |
Altre applicazioni non richiedono mTLS. |
6 |
Gli utenti devono esistere in BroadWorks e necessitano dei seguenti attributi, in base alla propria decisione di provisioning:
|
Per e-mail affidabili: Si consiglia di inserire lo stesso indirizzo e-mail nell'attributo ID alternativo anche per consentire agli utenti di accedere con indirizzo e-mail per BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'utilizzo di messaggi e-mail non attendibili può inviare il messaggio e-mail alla cartella della posta indesiderata o dello SPAM dell'utente. L'amministratore potrebbe aver modificato le impostazioni e-mail dell'utente per consentire i domini |
7 |
File DTAF Webex per Cisco BroadWorks per l'app Webex | |
8 |
BW Business Lic o Std Enterprise o Prem Enterprise User Lic + Webex per l'abbonamento Cisco BroadWorks |
Se è già presente una distribuzione di collaborazione esistente, non è più necessario il bundle aggiuntivo UC-One, la collaborazione Lic e le porte della conferenza Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non è necessario apportare ulteriori modifiche se non si accettano i termini del pacchetto Premium. |
9 |
L'indirizzo IP/porte deve essere accessibile attraverso i servizi back-end Webex e le app Webex su Internet pubblico. |
Vedere la sezione "Preparazione della rete". |
10 |
Configurazione TLS v1.2 su ADP XSP| | |
11 |
Per il provisioning Flowworks, il server dell'applicazione deve connettersi all'adattatore di provisioning BroadWorks. La configurazione del proxy in uscita non viene testata o supportato. Se si utilizza un proxy in uscita, si accetta la responsabilità di supportarlo con Webex per Cisco BroadWorks. |
Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è comprendere, preparare, distribuire e gestire la soluzione Webex per Cisco BroadWorks. Le sezioni principali del documento riflettono questo scopo.
Questa guida include informazioni concettuali e materiale di riferimento. Intendiamo coprire tutti gli aspetti della soluzione in questo documento.
La serie minima di attività per la distribuzione della soluzione è la seguente:
-
Raggiungere il team dell'account per diventare un partner Cisco. È obbligatorio esplorare i punti di contatto Cisco per acquisire familiarità (ed essere addestrati). Quando si diventa un partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuire Webex per Cisco BroadWorks > onboarding dei partner in questo documento).
-
Configurare i sistemi BroadWorks per l'integrazione con Webex. (Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento).
-
Utilizzare Partner Hub per collegare Webex a BroadWorks. Vedere Distribuire Webex per Cisco BroadWorks > l'organizzazione partner in Partner Hub in questo documento.
-
Utilizzare Partner Hub per preparare i modelli di provisioning utente. (Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento).
-
Esegui test ed esegui l'onboarding di un cliente eseguendo il provisioning di almeno un utente. (Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
-
Operazioni di alto livello, nell'ordine tipico. Esistono diverse attività determinanti che non è possibile ignorare.
-
Se si desidera creare le proprie applicazioni per gestire Webex per abbonati Cisco BroadWorks, leggere Uso dell'API di provisioning nella sezione Di riferimento di questa guida.
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto.
Funzionamento
Webex per Cisco BroadWorks è un'offerta che integra la chiamata BroadWorks in Webex. Gli abbonati utilizzano una singola applicazione (app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
-
Gli utenti chiamano PSTN numeri di telefono utilizzando l'infrastruttura BroadWorks.
-
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino per introdurre i numeri).
-
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Webex Call" nell'app Webex ( queste chiamate sono app Webex all'app Webex, non all'app Webex PSTN).
-
Gli utenti possono ospitare e partecipare Webex Meetings.
-
Gli utenti possono inviare messaggi l'uno all'altro o negli spazi (chat di gruppo persistente) e usufruire delle funzioni di ricerca e condivisione di file (su infrastruttura Webex).
-
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
-
Dopo averci asserto come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare il rapporto tra l'istanza BroadWorks e Webex.
-
È possibile creare organizzazioni dei clienti in Control Hub e pres effettuare il provisioning degli utenti in tali organizzazioni.
-
Ciascun abbonato in BroadWorks ottiene un'identità Webex in base al relativo indirizzo e-mail (attributo ID e-mail in BroadWorks).
-
Gli utenti eseguono l'autenticazione per BroadWorks o per Webex.
-
I client vengono emessi con token a lungo termine per autorizzarli per i servizi presso BroadWorks e Webex.
L'app Webex al centro di questa soluzione; è un'applicazione che può essere brandable disponibile su desktop Mac/Windows e su dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include le funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzioni di messaggistica, presenza e riunione.
Il client si registra ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i sistemi BroadWorks per garantire un'esperienza di provisioning utente ottimale.
Funzioni e limitazioni
Sono disponibili diversi pacchetti con diverse funzioni.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano un utente tramite softphone, i risultati della ricerca non forniscono alcuna opzione per l'invio di un messaggio.
Gli utenti softphone possono condividere lo schermo durante una chiamata.
Pacchetto "Base"
Il pacchetto base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti in riunioni "spazio unificato" e riunioni nella sala riunioni personale. (** vedere la Nota seguente per eccezione). In questo pacchetto, la durata massima delle riunioni è di 40 minuti.
Pacchetto "standard"
Questo pacchetto include anche tutto quello che è previsto dal pacchetto Base, ad esempio fino a 100 partecipanti in riunioni "spazio unificato" e riunioni nella sala riunioni personale.
La condivisione dello schermo all'interno di una riunione PMR ha inizialmente un ruolo svolto solo dall'organizzatore della riunione, ma l'organizzatore può passare il 'ruolo di relatore' a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può assumere nuovamente il ruolo di relatore senza che venga passato dall'ospite corrente.
Pacchetto "Premium"
Questo pacchetto include tutto quello che è previsto dal pacchetto Standard più fino a 300 partecipanti in una riunione "spazio unificato" e fino a 1000 partecipanti in una sala riunioni personale.
La condivisione dello schermo all'PMR di un evento è supportata per qualsiasi partecipante.
Confronta pacchetti
Pacchetto |
Chiamata in corso |
Messaggistica |
Riunioni spazio unificato |
PMR riunioni |
---|---|---|---|---|
Softphone |
Incluso |
Non incluso |
Nessuno |
Nessuno |
Base |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Standard |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Premium |
Incluso |
Incluso |
300 partecipanti |
1000 partecipanti |
Il limite di riunioni nello spazio Unified per gli utenti Base è di 100 partecipanti per riunione nello spazio Unified, a meno che lo spazio non includa anche gli utenti a cui sono stati assegnati i pacchetti "Standard" o "Premium", nel qual caso il limite aumenta in base al pacchetto utente organizzatore.
Per "Riunioni spazio unificate" si intende una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti "Riunione" o "Pianifica".
Per "riunioni PMR" si intende una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID).
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per conoscere le differenze di supporto delle funzioni per le riunioni nella sala riunioni personale per i pacchetti Base, Standard e Premium.
Funzione riunione |
Supportato con pacchetto base |
Soportato con il pacchetto standard |
Supportato con pacchetto Preminum |
Commento |
---|---|---|---|---|
Durata riunione |
40 Minuti o meno |
Illimitato |
Illimitato | |
Condivisione desktop |
Sì |
Sì |
Sì |
Base: condivisione del desktop da parte di qualsiasi partecipante alla riunione della sala riunioni personale. Standard: condivisione del desktop solo da parte dell'organizzatore della riunione nella sala riunioni personale. Premium: condivisione del desktop da parte di qualsiasi partecipante alla riunione della sala riunioni personale. |
Condivisione di un'applicazione |
Sì |
Sì |
Sì |
Base: condivisione delle applicazioni da parte di qualsiasi partecipante alla riunione della sala riunioni personale. Standard: condivisione dell'applicazione solo da parte dell'organizzatore della riunione nella sala riunioni personale. Premium: condivisione delle applicazioni da parte di qualsiasi partecipante alla riunione della sala riunioni personale. |
Chat tra più parti |
Sì |
Sì |
Sì | |
Lavagna |
Sì |
Sì |
Sì | |
Protezione password |
Sì |
Sì |
Sì | |
App Web - nessun download o plug-in (esperienza ospite) |
Sì |
Sì |
Sì | |
Supporta accoppiamento con dispositivi Webex |
Sì |
Sì |
Sì | |
Controllo piano (disattiva audio di uno / Espelle tutti) |
Sì |
Sì |
Sì | |
Collegamento Riunioni permanenti |
Sì |
Sì |
Sì | |
Acces. sito per riunioni |
Sì |
Sì |
Sì | |
Accesso alla riunione tramite VoIP |
Sì |
Sì |
Sì | |
Blocco |
Sì |
Sì |
Sì | |
Controlli relatore |
No |
No |
Sì | |
Controllo desktop remoto |
No |
No |
Sì | |
Numero di partecipanti |
100 |
100 |
1000 | |
Registrazione salvata in locale nel sistema |
Sì |
Sì |
Sì | |
Registrazione nel cloud |
No |
No |
Sì | |
Registrazione - Storage su cloud |
No |
No |
10 GB per sito | |
Trascrizione delle registrazioni |
No |
No |
Sì | |
Pianificazione riunione |
Sì |
Sì |
Sì | |
Abilita condivisione del contenuto con integrazioni esterne |
No |
No |
Sì |
Base: condivisione di contenuto da parte di qualsiasi partecipante alla riunione della sala riunioni personale. Standard: condivisione del contenuto solo da parte dell'organizzatore della riunione nella sala riunioni personale. Premium: condivisione di contenuto da parte di qualsiasi partecipante alla riunione della sala riunioni personale. |
Consenti PMR modifica dell'URL |
No |
No |
Sì |
Base: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori dei partner e delle organizzazioni possono modificare l'URL da Control Hub. Standard: l'URL PMR può essere modificato solo da Partner Hub dagli amministratori dei partner e dell'organizzazione. Premium: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori di partner e organizzazioni possono modificare l'URL da Partner Hub. |
Riunioni in streaming in diretta (ad esempio, su Facebook, Youtube) |
No |
No |
Sì | |
Consentire ad altri utenti di pianificare le riunioni per proprio conto |
No |
No |
Sì | |
Aggiungi organizzatore alternativo |
Sì |
No |
Sì | |
Integrazione delle app (es. Zendesk, Slack) |
Dipende dall'integrazione |
Dipende dall'integrazione |
Sì |
Vedere la sezione Integrazioni delle app di seguito per ulteriori informazioni sul supporto. |
Integrazione con il calendario Microsoft Office 365 |
Sì |
Sì |
Sì | |
Integrazione con Google Calendaring per G Suite |
Sì |
Sì |
Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione per l'utente per Webex all'help.webex.com
. Leggere i seguenti articoli per ulteriori informazioni sulle funzioni:
Funzioni di chiamata
L'esperienza di chiamata è simile a quelle precedenti che utilizzano il motore di controllo chiamate BroadWorks. La differenza rispetto a UC-One Collaborate e UC-One SaaS è che l'app Webex è il soft client principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
-
Zendesk: solo Premium
-
Slack: solo Premium
-
Microsoft Teams per Webex Meetings: standard o premium
-
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
-
Calendario Office 365: standard o premium
-
Google Calendaring per G Suite: standard o premium
Supporto infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione di Webex per l'infrastruttura desktop virtuale (VDI).
Supporto IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Pro Pack per Control Hub
Il servizio aggiuntivo Pro Pack per Control Hub fornisce agli amministratori, alle informazioni di sicurezza e ai funzionari di conformità funzionalità avanzate in sicurezza, conformità e analisi in grado di integrare il software.
Questi servizi aggiuntivi saranno disponibili solo per i pacchetti Standard e Premium.
Per ulteriori informazioni, vedi la Pagina della Guida di Pro Pack per Control Hub.
Roadmap futuro
Per informazioni sulle nostre intenzione per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Gli elementi della roadmap non sono associabili ad alcuna capacità. Cisco si riserva il diritto di disattivare o revisionare uno o tutti di questi elementi nelle release future.
Limiti
Limitazioni provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario per il Webex Meetings sito creato per tale pacchetto.
Se non viene specificato alcun fuso orario nella richiesta di provisioning per il primo utente di ciascun pacchetto, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sul valore predefinito regionale dell'organizzazione degli abbonati.
Se il cliente richiede un fuso orario Webex Meetings sito specifico, specificare il parametro di fuso orario nella richiesta di provisioning
per:
-
il primo abbonato predisposto per il pacchetto standard nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto Base nell'organizzazione.
Limitazioni generali
-
Nessuna chiamata nella versione Web del client Webex (si tratta di una limitazione del client, non di una limitazione di soluzione).
-
Webex potrebbe non disporre ancora di tutti i controlli UI per supportare alcune funzioni di controllo chiamate disponibili da BroadWorks.
-
Il client Webex non può essere attualmente con etichetta "White labeled".
-
Quando si creano organizzazioni cliente utilizzando il metodo di provisioning scelto, tali organizzazioni vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. È previsto che partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
-
La generazione di report sulle riunioni e sull'utilizzo dei messaggi è disponibile attraverso l'organizzazione cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti messaggistica
I seguenti limiti di storage dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo spazio di storage massimo per la messaggistica e i file combinati.
-
Base: 2 GB per utente per 3 anni
-
5 GB standard per utente per 3 anni
-
Premium: 10 GB per utente per 5 anni
Per ciascuna organizzazione di clienti, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti Premium può utilizzare un limite di messaggistica e storage file totale di 50 GB. Un singolo utente può superare il limite per utente (10 GB) a condizione che la società sia ancora sotto il valore massimo aggregato (50 GB).
Per gli spazi del team creati, i limiti di messaggistica si applicano al totale aggregato per l'organizzazione del cliente che possiede lo spazio del team. È possibile trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti di messaggistica generali che si applicano agli spazi del team di messaggistica Webex, vedere https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure connessioni a Webex e BroadWorks. I dati archiviati nel cloud Webex e esposti all'utente attraverso l'interfaccia dell'app Webex vengono crittografati sia in viaggio che a riposo.
Ulteriori dettagli sullo scambio dei dati sono disponibili nella sezione Riferimento di questo documento.
Lettura aggiuntiva
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati più vicino alla regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore provider di servizi (utente): Per le attività di manutenzione giornaliere, è possibile gestire le parti in locale (di chiamata) della soluzione utilizzando i propri sistemi. Le parti Webex della soluzione vengono gestite attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e Wholesale RTM.
Il primo utente predisposto a un nuovo organizzazione partner viene assegnato automaticamente ai ruoli Amministratore completo e Amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi.
Team operativo Cisco Cloud: Crea l'organizzazione partner in Partner Hub, se non esiste, durante il processo di onboarding.
Una volta che si dispone dell'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente si creano "Modelli di onboarding" per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Si eservi quindi il provisioning dei propri clienti o abbonati.
# |
Attività tipica |
SP |
Cisco |
---|---|---|---|
1 |
Onboarding del partner: creazione dell'organizzazione partner, se presente, e abilitazione delle attivazioni/disattivazioni delle funzioni necessarie |
● | |
2 |
Configurazione BroadWorks nell'organizzazione partner tramite Hub partner (cluster) |
● | |
3 |
Configurazione delle impostazioni di integrazione nell'organizzazione partner tramite Partner Hub (modelli di offerta, branding) |
● | |
4 |
Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|Patch ADP, firewall, configurazione ADP XSP|, XSI, AuthService, CTI, NPS, applicazioni DMS su XSP|ADP) |
● | |
5 |
Sviluppo di un'integrazione o di un processo di provisioning |
● | |
6 |
Prepara materiali GTM |
● | |
7 |
Esegui migrazione o provisioning di nuovi utenti |
● |
Architettura
Che cos'è nel diagramma?
Client
-
Il client Webex App svolge la funzione di applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di riunioni audio/video native di messaggistica, presenza e multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per chiamate SIP PSTN chiamate.
-
I telefoni Cisco IP e relativi accessori utilizzano anche l'infrastruttura BroadWorks per SIP e chiamate PSTN telefoniche. Ci vediamo in grado di supportare telefoni di terze parti.
-
Portale di attivazione utente per consentire agli utenti di accedere a Webex utilizzando le credenziali BroadWorks.
-
Partner Hub è un'interfaccia Web per l'amministrazione della propria organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. È anche possibile utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
provider di servizi di rete
Il blocco verde a sinistra del diagramma rappresenta la rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
-
ADP XSP|rivolto al pubblico, per Webex per Cisco BroadWorks: (La casella rappresenta uno o più farm XSP|ADP, possibilmente frontali da bilanciatori del carico).
-
Ospita l'interfaccia XSI-Actions &XSI-Events, Device Servizio di gestione (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato di hook degli altri (presenza di telefonia) e cronologia chiamate.
-
Pubblica la directory sui client Webex.
-
-
ADP XSP|rivolto al pubblico, con NPS:
-
Server push notifiche chiamate host: Un server push di notifica su un ADP XSP| nel tuo ambiente. Interfaccia tra il server applicazioni e il nostro proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS &FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
-
-
Server applicazione:
-
Fornisce il controllo e le interfacce delle chiamate ad altri sistemi BroadWorks (in genere)
-
Per il provisioning flowre, l'AS viene utilizzato dall'amministratore del partner per eseguire il provisioning degli utenti in Webex
-
Inserisce profilo utente in BroadWorks
-
-
SISTEMA SISTEMA AVAIO/BSS: Sistema di supporto operativo/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nel diagramma rappresenta il cloud Webex. I microservizi Webex supportano tutte le funzionalità di collaborazione Webex:
-
Cisco Common Identity (CI) è il servizio di identità all'interno di Webex.
-
Webex per Cisco BroadWorks rappresenta l'insieme di microservizi che supportano l'integrazione tra Webex e provider di servizi BroadWorks ospitate:
-
API di provisioning utenti
-
provider di servizi configurazione
-
Accesso utente tramite credenziali BroadWorks
-
-
casella Messaggistica Webex per microservizi correlati alla messaggistica.
-
Webex Meetings che rappresenta i server di elaborazione multimediale e i controller SBC per le riunioni video con più partecipanti (SIP & SRTP)
Servizi Web di terze parti
I seguenti componenti di terze parti vengono rappresentati nel diagramma:
-
APNS (Apple Push Notifications Service) inserisce le notifiche di chiamate e messaggi nelle applicazioni Webex sui dispositivi Apple.
-
FCM (FireBase Cloud Messaging) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Ruolo dei server ADP XSP|rivolti al pubblico in Webex per Cisco BroadWorks
L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
-
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste di BroadWorks J JSON (Token Web JSON) per conto dell'utente
-
Interfaccia CTI protetta da mTLS, a cui Webex esegue l'abbonamento per eventi cronologia chiamate e stato della presenza di telefonia da BroadWorks (stato hook).
-
Interfacce di azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate, le directory di contatto e di elenco delle chiamate e la configurazione del servizio di telefonia dell'utente finale
-
Servizio DM (Device Management) per i client per recuperare i file di configurazione delle chiamate
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedi Configurazione dei cluster BroadWorks in Partner Hub in questo documento) Per ciascun cluster, puoi fornire solo un URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP
Si richiede di utilizzare un'istanza ADP XSP|separata e dedicata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile ospitare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso ADP XSP| che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/farm XSP|ADP dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
-
Ad esempio, se stai offrendo UC-One SaaS, ti consigliamo di creare un nuovo farm ADP XSP|per Webex per Cisco BroadWorks. In questo modo i due servizi possono funzionare in modo indipendente durante la migrazione degli abbonati.
-
Se si posizionano le applicazioni Webex per Cisco BroadWorks su un farm XSP|ADP utilizzato per altri scopi, è responsabilità del cliente monitorare l'uso, gestire la complessità risultante e pianificare l'aumento di scala.
-
Il Strumento di pianificazione della capacità del sistema Cisco BroadWorks utilizza un farm ADP XSP| dedicato e potrebbe non essere accurato se lo si utilizza per calcoli di collocazione.
Se non diversamente specificato, il Webex dedicato per Cisco BroadWorks XSP ADP| deve ospitare le seguenti applicazioni:
-
AuthService (TLS con convalida token CI o mTLS)
-
CTI (mTLS)
-
Azioni XSI (TLS)
-
XSI-Events (TLS)
-
DMS (TLS): facoltativo. Non è obbligatorio distribuire un'istanza DMS o un farm separati specificatamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
-
Impostazioni chiamata Webview (TLS): opzionale. La vista Web impostazioni chiamata (CSW) è richiesta solo se desideri che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso al CTI attraverso un'interfaccia protetta (autenticazione) TLS reciproca autenticazione. Per supportare questo requisito, si consiglia una di queste opzioni:
-
(Diagramma etichettato Opzione 1) Un'istanza o un farm XSP|ADP per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
-
(Diagramma etichettato Opzione 2) Due istanze o farm XSP| ADP, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSP|ADP
Se si dispone di un farm ADP XSP|esistente conforme a una delle architetture suggerite sopra (opzione 1 o 2) e carico leggero, è possibile riutilizzare gli ADP XSP|esistenti. Sarà necessario verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti delle applicazioni per Webex. Le due considerazioni principali sono:
-
Se è necessario supportare più organizzazioni partner Webex su XSP|ADP, ciò significa che è necessario utilizzare mTLS sul servizio di autorizzazione (la convalida del token CI è supportata solo per una singola organizzazione partner su un XSP|ADP). Se si utilizza mTLS sul servizio di autenticazione, ciò significa che non è possibile avere client che stanno utilizzando l'autenticazione di base sul servizio di autenticazione allo stesso tempo. Questa situazione impedirebbe il riutilizzo dell'ADP XSP|.
-
Se il servizio CTI esistente è configurato per essere utilizzato dai client con la porta protetta (in genere 8012) ma senza mTLS (ossia, autenticazione client), tale servizio è in conflitto con il requisito webex di disporre di mTLS.
Poiché gli ADP XSP| hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero verificarsi altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di ADP XSP| deve essere verificato in un laboratorio con la configurazione prevista prima di impegnarsi per il riutilizzo.
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione dell'orario per tutti gli ADP XSP| utilizzati con Webex.
Installare il pacchetto ntp
dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Successivamente, è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, vedere la Guida alla gestione software BroadWorks.
Durante l'installazione interattiva del software ADP XSP|, è possibile configurare NTP. Procedere come segue:
-
Quando viene visualizzato il programma di installazione,
configurare NTP?
, inserire y.
-
Quando il programma di installazione richiede,
questo server deve essere un server NTP? , inserire n
.
-
Quando il programma di installazione richiede, Qual è l'indirizzo NTP, il nome host o nome di dominio completo? , inserire l'indirizzo del server NTP o un servizio
NTP pubblico, ad esempio,
pool.ntp.org
.
Se le ADP XSP| utilizzano l'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie chiave=valore:
NTP
NTP_SERVER=
Requisiti di sicurezza e identità ADP XSP|
Sfondo
I protocolli e i tipi di crittografia delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli variano dal più generale (provider SSL) alla più specifica (singola interfaccia). Un'impostazione più specifica sovrascrive sempre un'impostazione più generale. Se non vengono specificate, le impostazioni SSL di livello 'inferiore' vengono ereditano dai livelli superiori.
Se non viene modificata alcuna impostazione dai valori predefiniti, tutti i livelli ereditano le impostazioni predefinite del provider SSL (estensione JSSE Java Secure Sockets).
Elenco requisiti
-
L'ADP XSP| deve autenticarsi ai client utilizzando un certificato firmato da un'autorità di certificazione in cui il nome comune o il nome alternativo oggetto corrisponde alla parte di dominio dell'interfaccia XSI.
-
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
-
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
-
Diffie-Hellman Ephemeral (DHE) o Curve ellittiche Diffie-Hellman Ephemeral (ECDHE) key-exchange
-
Crittografia AES (Advanced Encryption Standard) con una dimensione di blocco minima di 128 bit (ad esempio, AES-128 o AES-256)
-
Modalità di crittografia GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
-
Se viene utilizzata la crittografia CBC, solo la famiglia di funzioni hash SHA2 è consentita per la derivazione chiave (SHA256, SHA384, SHA512).
-
-
Ad esempio, i seguenti tipi di crittografia soddisfano i requisiti:
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come mostrato sopra, non la convenzione openSSL.
Tipi di crittografia TLS supportati per le interfacce AuthService e XSI
Questo elenco è soggetto a modifica quando i requisiti di sicurezza del cloud cambiano. Seguire i suggerimenti sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento.
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
-
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
-
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_128_GCM_SHA256
-
TLS_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_256_CBC_SHA256
-
TLS_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_WITH_AES_256_CBC_SHA
-
TLS_PSK_WITH_AES_256_CBC_SHA384
-
TLS_PSK_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_WITH_AES_128_CBC_SHA
-
TLS_PSK_WITH_AES_128_CBC_SHA256
-
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il conteggio dei thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi mostrati, come segue (non diminuire, se sono superiori ai valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più ADP XSP|
Elemento Edge di bilanciamento del carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, tale elemento deve gestire in modo trasparente la distribuzione del traffico tra più server ADP XSP|e il cloud e i client Webex per Cisco BroadWorks. In questo caso, si fornisce l'URL del servizio di bilanciamento del carico a Webex per la configurazione Cisco BroadWorks.
Note su questa architettura:
-
Configurare DNS in modo che i client possano trovare il servizio di bilanciamento del carico quando si connettono all'interfaccia Xsi (vedere Configurazione DNS).
-
Si consiglia di configurare l'elemento Edge in modalità proxy SSL inverso per accertarsi che la crittografia dati point-to-point.
-
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio tuo-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri nomi di domini completi, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Server ADP XSP|rivolti a Internet
Se si espongono direttamente le interfacce XSI, utilizzare il DNS per distribuire il traffico a più server ADP XSP|.
Note su questa architettura:
-
Sono necessari due record per la connessione ai server ADP XSP|:
-
Per i microservizi Webex: I record a turni A/AAAA sono richiesti per indirizzare più indirizzi IP ADP XSP|. Questo perché i microservizi Webex non possono eseguire ricerche SRV. Per esempi, vedere Servizi cloud Webex.
-
Per l'app Webex: Un record SRV che si risolve in record A e ciascun record A si risolve in un singolo ADP XSP|. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per indirizzare il servizio XSI per più indirizzi ADP XSP|. Assegnare una priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (E l'indirizzo IP successivo) e passino al record A successivo (e indirizzo IP) solo se il primo indirizzo IP non è attivo. NON utilizzare un approccio a tutto tondo per Webex App.
-
-
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio tuo-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri nomi di domini completi, ad esempio XSP|ADP01.example.com, nel nome comune.
-
È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL ADP XSP|in un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server ADP XSP|XSP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.
Ordinazione e provisioning
Ordinazione e provisioning si applicano a questi livelli:
-
Provisioning partner/provider di servizi:
Ciascun Webex per Cisco BroadWorks provider di servizi (o rivenditore) presente deve essere configurato come organizzazione partner in Webex e disporre dei diritti necessari. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per la gestione di Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le attività di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/Enterprise.
-
Ordini e provisioning cliente/Enterprise:
Ciascuna azienda BroadWorks abilitata per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo viene eseguito automaticamente come parte del provisioning dell'utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks sono predisposti nella stessa organizzazione clienti Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
-
Ordinazione e provisioning di utenti/abbonati:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning utente:
-
Provisioning Flow con e-mail attendibili
-
Provisioning flow senza messaggi e-mail attendibili
-
Self-provisioning utente
-
Provisioning API
-
Provisioning a flusso costante con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile asserre che BroadWorks abbia indirizzi e-mail dell'abbonato validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Provisioning flow senza messaggi e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non si può contare sugli indirizzi e-mail dell'abbonato tenuti da BroadWorks, questa opzione di provisioning crea account Webex, ma non può attivarli fino a quando gli abbonati non forniscono e convalidano gli indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Self-Provisioning utente
Con questa opzione, non esiste provisioning flowworks da BroadWorks a Webex. Dopo aver configurato l'integrazione tra Webex e il sistema BroadWorks, si ottengono uno o più collegamenti specifici per il provisioning degli utenti all'interno di Webex per l'organizzazione partner Cisco BroadWorks.
Si progettare quindi le proprie comunicazioni (o delegare ai clienti) la distribuzione del collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account sono predisposti nell'ambito dell'organizzazione partner, è possibile regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare questa operazione.
Gli utenti devono essere presenti nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento.
provider di servizi provisioning da PARTE delle API
Webex sono esposti una serie di API pubbliche che consentono di creare Webex per il provisioning di utenti/abbonati Cisco BroadWorks nel flusso di lavoro/strumenti di gestione degli utenti esistenti.
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Installare AP.as.22.0.1123.ap376508.
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Installare AP.as.23.0.1075.ap376509
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Installare AP.as.24.0.944.ap375100
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning di nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per utenti Cisco BroadWorks.
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti di Webex di Cisco Broadworks di chiamare altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella directory Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo di estensione di tutte le aree del metodo di inizio chiamata e del profilo utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e diversi gruppi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due aziende che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks tramite i seguenti metodi:
-
Utenti Cisco BroadWorks
-
Provisioning API pubblica come estensione
-
Il parametro dell'interno deve essere passato esplicitamente come parte della chiamata API. Per aziende/gruppi che dispongono di un codice di chiamata posizione (LDC) configurato, il parametro interno deve essere la combinazione di LDC e 'numero di interno.
-
-
Provisioning a flusso costante o autoattivazione
-
L'interno e il sistema LDC (ove applicabile) verranno recuperati automaticamente da BroadWorks.
-
-
-
Utenti o entità Calling solo BroadWorks
-
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione del codice di chiamata posizione (LDC) e del numero di interno.
-
Record chiamata BroadWorks |
Descrizione |
Metodo di provisioning |
Gestione dell'interno |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
API pubblica |
L'interno deve essere passato come parametro |
A flusso costante |
Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks |
Utenti di chiamata non caricati in Webex |
Sinc rubrica |
Interno sincronizzato dalla sincronizzazione rubrica |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sinc rubrica | Interno sincronizzato dalla sincronizzazione rubrica |
Elenchi telefonici BroadWorks |
Elenchi telefonici aziendali, di gruppo o personali |
Sinc rubrica |
Non applicabile |
Prerequisiti
-
La versione del client richiesta per supportare questa funzione è la versione 42.11 o successiva.
-
Patch in cui i codici di chiamata dell'interno e della posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
-
AP.platform.23.0.1075.ap380045
-
AP.as.23.0.1075.ap380045
-
AP.xsp.23.0.1075.ap380045
-
AP.as.24.0.944.ap380045
-
-
Abilita l'intestazione X-BroadWorks-Remote-Party-Info sul AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP, richiesto per il supporto della funzione di chiamata interno.
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata dell'interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità chiamata di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'interno come seconda opzione sia in Partner Hub che in Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con l'interno tramite uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione di estensione sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Questo non visualizza un interno nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere l'opzione di chiamata a interno visibile per i clienti esistenti:
-
Se un partner desidera che a tutte le organizzazioni dei clienti gestiti sia fornito un interno come opzione di chiamata, è consigliabile che l'amministratore del partner sposti l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
-
Se un partner desidera fornire opzioni di chiamata per un'organizzazione cliente specifica, si consiglia all'amministratore partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto di contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e allinearlo all'aumento dei contatti 30K per l'elenco telefonico aziendale, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per organizzazione, applicabile alla somma degli elenchi telefonici aziendali e di gruppo in un'unica azienda BroadWorks. Ad esempio, sarà supportata un'azienda BroadWorks con elenco telefonico Enterprise con 30K e anche 5 elenchi di telefoni di gruppo, ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K in totale).
Questa funzione è disponibile su richiesta. Contatta il team del tuo account per abilitarlo.
-
Prima di abilitare la funzione, è necessario eseguire una migrazione dei prerequisiti per il provisioning e associare i gruppi per tutti gli utenti predisposti esistenti.
-
Il team Cisco eseguirà un'API interna per eseguire la migrazione di eventuali utenti predisposti esistenti e associarli al gruppo corretto. NOTA: Questa operazione può richiedere fino a una settimana.
-
Una volta completata la migrazione per il partner e abilitata la funzione, tutti gli utenti predisposti di recente verranno "raggruppati" in modo appropriato.
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks in storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare il gruppo a cui appartiene questo utente. L'associazione dell'utente a un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca di contatti nello storage di gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning di Webex per gli abbonati BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
L'ID gruppo aziendale BroadWorks può essere fornito per gli utenti Cisco BroadWorks tramite i seguenti metodi:
-
Webex per utenti Cisco BroadWorks
-
Provisioning API pubblica come 'spEnterpriseGroupId'
-
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
-
-
Provisioning a flusso costante o autoattivazione
-
L'ID gruppo aziendale BroadWorks verrà recuperato automaticamente da BroadWorks.
-
-
Utenti o entità Calling solo BroadWorks
-
Non applicabile. Non è necessario sincronizzare l'ID gruppo BroadWorks Enterprise per questi utenti.
-
-
Record chiamata BroadWorks |
Descrizione |
Metodo di provisioning |
Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
API pubblica |
ID gruppo BroadWorks Enterprise Group deve essere passato come parametro spEnterpriseGroupId |
A flusso costante |
ID gruppo aziendale BroadWorks recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks |
Utenti di chiamata non caricati in Webex |
Sinc rubrica |
Non applicabile |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sinc rubrica |
Non applicabile |
Elenchi telefonici BroadWorks |
Contatti negli elenchi telefonici di gruppo BroadWorks |
Sinc rubrica |
I contatti di gruppo vengono memorizzati nel Servizio Webex Contact associato al gruppo specifico |
Elenchi telefonici BroadWorks Enterprise o Persional |
Contatti negli elenchi telefonici aziendali o personali |
Sinc rubrica |
Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. La migrazione non può essere completata finché QUESTA API non viene completata. L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march
Una volta abilitata la funzione e come risultato della successiva sincronizzazione delle rubriche, verranno visualizzati anche i gruppi utenti aziendali in Control Hub. In questa fase, la visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativo. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza ai gruppi in Control Hub poiché tali modifiche non verranno riflesse nuovamente in BroadWorks. La gestione dei gruppi in Control Hub è destinata ai partner che adotteranno le API di gestione dei contatti future.
Migrazione e prova futura
Cisco il client BroadSoft unified Communications deve passare da UC-One a Webex. Esiste una corrispondente lingua dei servizi di supporto lontani dalla rete provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che si utilizzi UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita è distribuire nuovi ADP XSP| dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti a Webex e, infine, recuperare l'infrastruttura utilizzata per la soluzione precedente.
Abbonamenti ai documenti consigliati
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Esegui sottoscrizione che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di iscriversi a ciascuno dei seguenti articoli per essere certi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per eseguire l'abbonamento, andare a ciascuno dei collegamenti seguenti e nell'articolo che viene avviato, fare clic sul pulsante Abbonati .
Si consiglia di iscriversi come minimo all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati sotto Documenti aggiuntivi dispone di un'opzione Esegui sottoscrizione . Per la visualizzazione di questa opzione, l'articolo deve essere visualizzato su help.webex.com.
Non è disponibile alcuna opzione di abbonamento per le pagine di destinazione della documentazione.
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Webex per documenti Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
-
Soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono propri (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
-
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive la modalità di onboarding e l'onboarding dei dispositivi Room OS e MPP.
-
Guida alla risoluzione dei problemi Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi per Webex per Cisco BroadWorks.
Articoli Webex per Cisco BroadWorks
Per ulteriori informazioni su Webex per Cisco BroadWorks, gli amministratori dei partner possono utilizzare i seguenti siti opzionali:
-
Documentazione di Webex per Cisco BroadWorks: la pagina di destinazione elenca i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
-
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme alle prossime novità.
-
Problemi noti e limitazioni: leggere i problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
-
Ruoli amministratore partner per Webex per BroadWorks e Wholesale RTM: questo articolo descrive come assegnare ruoli amministratore partner per organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte Cisco BroadWorks della soluzione:
Articoli della Guida Webex
È possibile utilizzare i seguenti siti della Guida Webex per trovare articoli Webex che aiutano gli amministratori dei clienti e gli utenti finali a utilizzare le funzioni Webex.
-
Webex dai provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati più di frequente per gli utenti dell'app Webex che hanno acquistato servizi Webex da un provider di servizi.
-
Centro assistenza Webex: utilizzare la funzione di ricerca all'indirizzo help.webex.com per ricercare altri articoli Webex che descrivono l'app Webex e la funzionalità Webex Meetings. È possibile cercare articoli dell'utente o dell'amministratore.
Documentazione per gli sviluppatori
-
Guida per lo sviluppatore di Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Preparazione dell'ambiente
Punti decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastruttura
|
Quanti ADP XSP|? Come prendono mTLS? |
Pianificatore capacità sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento XSP|ADP CLI Questo documento |
Provisioning clienti e utenti |
Si può asserre che si considera attendibili i messaggi e-mail in BroadWorks? Si desidera che gli utenti forniranno gli indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Doc API pubblici su https://developer.webex.com Questo documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo sul branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso dei clienti? | Questo documento |
Funzioni dell'abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o softphone. |
Questo documento Matrice funzioni/pacchetto |
Autenticazione utente | BroadWorks o Webex | Questo documento |
Adattatore di provisioning (per le opzioni di provisioning flow) |
Utilizzi già IM&P integrato, ad esempio per UC-One SaaS? Utilizzare più modelli? Esiste un caso d'uso più comune previsto? |
Questo documento Riferimento CLI server applicazione |
Architettura e infrastruttura
-
Con quale scala intendete iniziare? È possibile aumentare la scalabilità in futuro, ma la stima d'uso corrente deve guidare la pianificazione dell'infrastruttura.
-
Collaborare con il responsabile account / rappresentante di vendita Cisco per ridimensionare l'infrastruttura ADP XSP|, in base alla Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
-
In che modo Webex esegue connessioni TLS reciproche con gli ADP XSP|? Direttamente all'ADP XSP| in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce (Le connessioni TCP non crittografate al bordo della rete non sono supportate).
Provisioning clienti e utenti
Quale metodo di provisioning utente si adatta meglio alle esigenze?
-
Provisioning a flusso costante con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene automaticamente predisposto in Webex.
Se è anche possibile asserre che gli indirizzi e-mail dell'abbonato nella BroadWorks siano validi e univoci per Webex, è possibile utilizzare la varianti "e-mail attendibile" del provisioning flow provisioning. Gli account Webex del sottoscrittore vengono creati e attivati senza il loro intervento; semplicemente scaricare il client ed eseguire l'accesso.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto l provider di servizi deve specificare un indirizzo e-mail valido per l'utente per potervi fornire i servizi Webex. Deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo nell'attributo ID alternativo.
-
Provisioning a flusso costante senza e-mail attendibili: Se non si riesce a verificare l'attendibilità degli indirizzi e-mail dell'abbonato, è comunque possibile assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
-
Provisioning automatico utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. L'utente (o i clienti) distribuiscono invece un collegamento di provisioning e i collegamenti per scaricare diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex. Quindi scaricano il client e a quel punto Webex recuperano alcune configurazioni aggiuntive su di esse da BroadWorks (inclusi i numeri principali).
-
Provisioning controllato SP tramite API: Webex sono esposti una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti generali di sistema descritti in questa guida.
Metodo di provisioning |
Requisiti |
---|---|
Provisioning Flow (e-mail attendibili o non attendibili) |
L'API di provisioning Webex aggiunge gli utenti BroadWorks esistenti a Webex automaticamente una volta che l'utente soddisfa i requisiti e attiva il servizio IM+P integrato . Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello Onboarding include le seguenti impostazioni:
|
Self-Provisioning utente |
L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato l'e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello Onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) |
Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono disponibili due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, andare a Utenti BroadWorks. |
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Installare AP.as.22.0.1123.ap376508.
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Installare AP.as.23.0.1075.ap376509
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Installare AP.as.24.0.944.ap375100
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning di nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per utenti Cisco BroadWorks.
Impostazioni internazionali della lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente amministrativo predisposto viene assegnata automaticamente come impostazioni internazionali predefinite per tale organizzazione cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti alle riunioni in tale organizzazione del cliente.
Sono supportate impostazioni internazionali per la lingua a cinque caratteri in formato (ISO-639-1)_(ISO-3166). Ad esempio, en_USA corrisponde a English_UnitedStates. Se è richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genererà un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso del paese dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, utilizzare le impostazioni internazionali sensibili predefinite in base al codice della lingua richiesto.
Nella tabella seguente vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice della lingua di due lettere in un'impostazione locale di cinque caratteri per le situazioni in cui una impostazione locale di cinque caratteri non è disponibile.
Impostazioni internazionali della lingua supportate (ISO-639-1)_(ISO-3166) |
Se è disponibile solo un codice lingua di due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** |
Utilizzare invece le impostazioni internazionali sensibili predefinite (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA |
it |
en_USA |
fr_FR fr_CA |
Fr |
fr_FR |
cs_CZ |
cs |
cs_CZ |
da_DK |
da |
da_DK |
de_DE |
DE |
de_DE |
hu_HU |
hu |
hu_HU |
id_ID |
Identificativo |
id_ID |
it_IT |
esso |
it_IT |
ja_JP |
ja |
ja_JP |
ko_KR |
ko |
ko_KR |
es_ES es_CO es_MX |
es |
es_ES |
nl_NL |
NL |
nl_NL |
nb_NO |
nb |
nb_NO |
pl_PL |
pl |
pl_PL |
pt_PT pt_BR |
pt |
pt_PT |
ru_RU |
RU |
ru_RU |
ro_RO |
ro |
ro_RO |
zh_CN zh_TW |
zh |
zh_CN |
sv_SE |
sv |
sv_SE |
ar_SA |
ar |
ar_SA |
tr_TR |
tr |
tr_TR |
Le impostazioni internazionali es_CO, id_ID, nb_NO e pt_PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti di Webex Meetings saranno solo in inglese. Inglese è le impostazioni internazionali predefinite per i siti se per il sito non è richiesta alcuna impostazione locale/non valida/non supportata. Questo campo di lingua è applicabile durante la creazione di un sito di organizzazione e Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, verrà utilizzata come lingua predefinita il modello.
Branding
Gli amministratori dei partner possono utilizzare personalizzazioni di branding avanzate per personalizzare il modo in cui l'app Webex cerca le organizzazioni dei clienti gestite dal partner. Gli amministratori dei partner possono personalizzare le seguenti impostazioni per assicurarsi che l'app Webex rifletta il marchio e l'identità della propria società:
-
Loghi aziendali
-
Schemi di colore univoci per la modalità chiaro o la modalità scura
-
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione di personalizzazioni di branding avanzate.
-
Le personalizzazioni del branding di base sono in fase di obsolescenza. Si consiglia di distribuire il branding avanzato, che offre una gamma più ampia di personalizzazioni.
-
Per informazioni dettagliate su come viene applicato il branding quando si esegue il collegamento a un'organizzazione cliente preesistente, fare riferimento a Condizioni dell'allegato organizzazione nella sezione Allega Webex per BroadWorks all'organizzazione esistente .
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding in base alle proprie esigenze, ma quando si esegue l'onboarding di un cliente, tale modello è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Di seguito sono elencati alcuni parametri del modello principale.
Pacchetto
-
È necessario selezionare un pacchetto predefinito quando si crea un modello (per informazioni dettagliate, vedere Pacchetti nella sezione Panoramica). Tutti gli utenti predisposti con tale modello, mediante flusso o auto-provisioning, ricevono il pacchetto predefinito.
-
È possibile controllare la selezione del pacchetto per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori per provisioning aziendali, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
-
Puoi modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedi documentazione dell'API di Webex per Cisco BroadWorks o tramite Partner Hub (vedi Modifica del pacchetto utente in Partner Hub).
-
Non è possibile modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è disattivata; se l'abbonato è assegnato a questo servizio in BroadWorks, il modello Hub partner associato all'URL di provisioning di tale azienda definisce il pacchetto.
Rivenditori e aziende o provider di servizi e gruppi?
-
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se si è un rivenditore con Aziende, è necessario abilitare la modalità Enterprise quando si crea un modello.
-
Se il sistema BroadWorks è configurato in provider di servizi modalità aziendale, è possibile lasciare disattivata la modalità Enterprise nei modelli.
-
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch broadworks richieste per il provisioning flow-through. Per informazioni dettagliate, vedere Patch richieste con provisioning flow-through.
Accertarsi di aver applicato le patch broadworks richieste per il provisioning flow-through. Per informazioni dettagliate, vedere Patch richieste con provisioning flow-through.
Modalità di autenticazione
Decidi come desideri che gli abbonati autenticino quando accedono a Webex. Puoi assegnare la modalità utilizzando l'impostazione Modalità autenticazione nel modello Onboarding. Nella tabella seguente vengono descritte alcune delle opzioni.
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | File BroadWorks ID utente | Indirizzo e-mail |
provider di identità |
BroadWorks.
| Cisco Common Identity |
Autenticazione multi-fattori? | No | Richiede un IdP cliente che supporti l'autenticazione a più fattori. |
Percorso di convalida credenziali
|
|
|
Per una descrizione dettagliata del flusso SSO accesso con autenticazione diretta a BroadWorks, vedere SSO login flow.
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che può verificarsi con le password che utilizzano caratteri speciali in base al quale il browser Web non codifica correttamente i caratteri. Utilizzando una codifica UTF-8, l'intestazione base 64 codificata risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
-
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> imposta authenticationEncoding UTF-8
-
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> imposta authenticationEncoding UTF-8
Paese
È necessario selezionare un paese quando si crea un modello. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie |
Posizione |
Prefisso internazionale |
Nome paese |
---|---|---|---|
1 |
AMER |
+1 |
us, ca |
2 |
APAC |
+65 |
Singapore |
3 |
Anz |
+61 |
Australia |
4 |
EMEA |
+44 |
Regno Unito |
5 |
euro |
+49 |
Germania |
Accordi con più partner
Si desidera utilizzare la licenza secondaria di Webex per Cisco BroadWorks con un altro provider di servizi? In tal caso, ciascun fornitore di servizi avrà bisogno di un'organizzazione partner distinta Webex Control Hub permettere loro di fornire la soluzione per la propria base clienti.
Adattatore e modelli di provisioning
Quando si utilizza il provisioning flowre, l'URL di provisioning inserito in BroadWorks è derivato dal modello in Control Hub. È possibile disporre di più modelli e, quindi, di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati quando hanno ottenuto la concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e il modello che si desidera utilizzare. In questo modo, è necessario solo impostare in modo esplicito l'URL di provisioning per le aziende che necessitano di un modello diverso.
Tenere presente, inoltre, che potrebbe essere stato già utilizzato un URL di provisioning a livello di sistema, ad esempio UC-One SaaS. In tal caso, è possibile scegliere di conservare l'URL a livello di sistema per gli utenti di provisioning su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile passare al percorso alternativo e impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono descritte in dettaglio in Configurazione del server applicazioni con URL del servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning a flusso costante tra il AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server applicazioni e Webex, negando in tal modo la necessità per il server applicazioni di connettersi direttamente a Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati disponibili per Webex devono esistere nel sistema BroadWorks integrato con Webex. Se necessario, è possibile integrare più sistemi BroadWorks.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero principale o interno.
Webex utilizza gli indirizzi e-mail come identificativi principali per tutti gli utenti. Se si utilizza il provisioning flow con messaggi e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail dell'abbonato nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le relative password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo degli utenti BroadWorks Calling che dispongono di un numero principale e/o un interno. Se si utilizza il provisioning a flusso costante, agli utenti deve essere assegnato anche il servizio IM&P integrato.
Server nella rete e requisiti software
-
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere la sezione Criteri per il ciclo di vita dei prodotti BroadSoft in Criteri per il ciclo di vita di BroadSoft e matrice di compatibilità software BroadWorks.
-
Le istanze BroadWorks devono includere almeno i seguenti server:
-
Server applicazioni (AS) con versione BroadWorks come indicato sopra
-
Server di rete (NS)
-
Server di profilo (PS)
-
-
Server ADP XSP|rivolti al pubblico o Piattaforma di consegna delle applicazioni (ADP) che soddisfano i seguenti requisiti:
-
Servizio di autenticazione (BWAuth)
-
Interfacce azioni ed eventi XSI
-
DMS (applicazione Web di gestione dispositivi)
-
Interfaccia CTI (integrazione di telefonia su computer)
-
TLS 1.2 con un certificato valido (non autofirmato) ed eventuali intermedie richiesti. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
-
Autenticazione TLS reciproca (mTLS) per il servizio di autenticazione (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
Autenticazione TLS reciproca (mTLS) per interfaccia CTI (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
-
Un server XSP/ADP separato funge da "server push notifiche di chiamata" (un server NPS nel proprio ambiente utilizzato per eseguire il push delle notifiche di chiamata ad Apple/Google. Questo tipo di chiamata "CNPS" viene chiamata qui per distinguerlo dal servizio in Webex che offre notifiche push per messaggistica e presenza).
Questo server deve essere su R22 o versioni successive.
-
È obbligatorio creare un server XSP/ADP separato per CNPS poiché l'impossibilità di caricare da Webex per connessioni cloud BWKS potrebbe avere un impatto negativo sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSP|ADP, vedere la Guida tecnica di sistema Cisco BroadWorks .
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, vai a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
-
PC/laptop Windows
-
PC Apple / laptop con MacOS
-
iOS (Apple store)
-
Android (Play store)
-
Browser Web (andare a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
-
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
-
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
-
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
-
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (cinese tradizionale)
-
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
-
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
-
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
-
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
-
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (Italiano)
Telefoni e accessori fisici
-
Telefoni IP Cisco:
-
Cisco IP Phone serie 6800 con firmware Multitform
-
Cisco IP Phone serie 7800 con firmware Multitform
-
Cisco IP Phone serie 8800 con firmware Multitform
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html modelli e ulteriori informazioni, vedere .
-
-
I telefoni di terze parti sono supportati allo stesso modo delle altre integrazioni BroadWorks. Tuttavia, non dispongono ancora di contatti e integrazione di presenza con Webex per Cisco BroadWorks.
-
Adattatori:
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 191
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 192 Multiplatform
Per https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html modelli e ulteriori informazioni, vedere .
-
-
Cuffie
-
Cisco Headset serie 500
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html modelli e ulteriori informazioni, vedere .
-
-
Dispositivi Room OS:
-
Webex Room e serie Room Kit
-
Serie Webex Desk
-
Serie Webex Board
-
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e i dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivi
Di seguito sono riportati i file DTAF che devi caricare sui server applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia, è disponibile un nuovo file config-wxt.xml.template
utilizzato per l'app Webex.
Per scaricare gli ultimi profili del dispositivo, andare al sito Download software della piattaforma di consegna dell'applicazione per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che XSP.
Nome client |
Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Business Communicator - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un Profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili di dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Emetti una richiesta di servizio con l'agente di onboarding o il centro TAC di Cisco per il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il seguente titolo di richiesta per le rispettive funzioni:
-
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
-
'Configurazione NPS per Auth Proxy Setup' per configurare NPS per l'uso del proxy di autenticazione.
-
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori dettagli su questa funzione, vedi: Supporto Cisco BroadWorks per CI UUID.
-
Configura BroadWorks per abilitare la fatturazione Cisco per gli abbonamenti BroadWorks e Webex Per BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento validi per 60 giorni. Se il token scade prima di utilizzarlo, puoi inviare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali.
Ordina certificati
Requisiti di certificato per l'autenticazione TLS
Sono necessari certificati di sicurezza, firmati da un'autorità di certificazione affidabile e distribuiti su ADP XSP|rivolti al pubblico, per tutte le applicazioni richieste. Questi verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in ingresso ai server ADP XSP|.
Questi certificati devono includere il nome di dominio completo pubblico XSP|ADP come nome comune oggetto o nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati server dipendono dal modo in cui vengono distribuiti gli ADP XSP|:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente all'ADP XSP|
Il diagramma seguente riepiloga dove deve essere caricato il certificato del server pubblico firmato da CA in questi tre casi:
Le CA pubblicamente supportate che l'app Webex supporta per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per il proxy con bridge TLS
-
Il certificato del server firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta questo certificato server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
È possibile caricare un certificato CA firmato interno sull'ADP XSP|.
-
L'ADP XSP| presenta questo certificato del server firmato internamente al proxy.
-
Il proxy considera attendibile la CA interna che ha firmato il certificato del server ADP XSP|.
Requisiti del certificato TLS per il proxy passthrough TLS o ADP XSP|in DMZ
-
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
-
Gli ADP XSP| presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP|ADPs.
Ulteriori requisiti di certificato per l'autenticazione TLS reciproca su interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione TLS reciproca. Il certificato CA/catena di certificati del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedere a Partner Hub, andare a Impostazioni >
collegamento di download del certificato.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono dalla distribuzione degli ADP XSP| pubblici:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente all'ADP XSP|
Il diagramma seguente riepiloga i requisiti dei certificati in questi tre casi:
(Opzione) Requisiti di certificato per proxy tls-bridge
-
Webex presenta un certificato client firmato pubblicamente al proxy.
-
Il proxy considera attendibile la CA interna Cisco che ha firmato il certificato client. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta il certificato del server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Il proxy presenta un certificato client firmato internamente agli ADP XSP|.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3: Uso chiave estesa X509v3: 1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Il CN del certificato interno deve essere
bwcticlient.webex.com
.-
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati del server interno per XSP|ADP possono essere SAN.
-
Le autorità di certificazione pubbliche potrebbero non voler firmare i certificati con il OID broadworks proprietario richiesto. Nel caso di un proxy bridging, potrebbe essere necessario utilizzare un'autorità di certificazione interna per firmare il certificato client che il proxy presenta all'ADP XSP|.
-
-
Gli ADP XSP| si affidano alla CA interna.
-
Gli ADP XSP| presentano un certificato server firmato internamente.
-
Il proxy considera attendibile la CA interna.
-
La ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XSP| dal proxy.
(Opzione) Requisiti del certificato per il proxy passthrough TLS o ADP XSP|in DMZ
-
Webex presenta un certificato client firmato da un'autorità di certificazione interna Cisco agli ADP XSP|.
-
Gli ADP XSP| affidabili la CA interna Cisco che ha firmato il certificato client. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XSP|.
-
Gli ADP XSP| presentano i certificati del server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP|ADPs.
-
Il server applicazioni ClientIdentity contiene il CN del certificato client firmato da Cisco presentato all'ADP XSP| da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene un elenco di indirizzi IP, porte e protocolli necessari per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle del firewall in entrata ed uscita precedenti documenta solo le connessioni specifiche per Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico a Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e come ciascuna sezione è relativa a Webex per Cisco BroadWorks.
Sezione dell'articolo requisiti di rete |
Gestione delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex |
Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud |
Informativo |
È necessario leggere | |
È necessario leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex |
È necessario leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione |
Opzionale |
Servizi Webex per clienti FedRAMP |
N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedere Whitepaper (PDF) del firewall appWebex.
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza ADP XSP|Broadworks fornita dal partner. Quando un ADP XSP|o un sito non è disponibile per manutenzione pianificata o per motivi non pianificati, i servizi e le app Webex possono passare a un altro ADP XSP| o sito fornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP XSP|BroadWorks possono essere distribuiti direttamente su Internet o possono risiedere in una DMZ preceduta da un elemento di bilanciamento del carico, come F5 BIG-IP. Per fornire la geo-ridondanza, gli ADP XSP| possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un servizio di bilanciamento del carico, ciascuno con un indirizzo IP pubblico. Se gli ADP XSP|sono dietro un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e BroadWorks sembra disporre di un solo ADP XSP|ADP, anche se sono presenti più ADP XSP|.
Nell'esempio seguente, gli ADP XSP| vengono distribuiti in due siti, sito A e sito B. Esistono due ADP XSP|frontali da un servizio di bilanciamento del carico in ciascun sito. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali da LB1 mentre il sito B ha XSP|ADP3 e XSP|ADP4 frontali da LB2. Solo i servizi di bilanciamento del carico sono esposti sulla rete pubblica e le ADP XSP| si trovano nelle reti private DMZ.
Servizi Cloud Webex
Configurazione DNS
I microservizi Webex Cloud devono essere in grado di trovare i server ADP XSP|BroadWorks per la connessione alle interfacce Xsi, al servizio di autenticazione e a CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host ADP XSP|configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento del bordo di bilanciamento del carico o potrebbe essere lo stesso server XSP|ADP. Se vengono restituiti più indirizzi IP, verrà selezionato il primo IP nell'elenco. SRV ricerca non sono attualmente supportate.
Esempio: Record DNS A del partner per la scoperta di server XSP|ADP/Load Balancers bilanciati rivolti a Internet.
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (Sito A) |
R |
|
|
Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP.
Failover
Quando i microservizi Webex inviano una richiesta al servizio di bilanciamento del carico/ADP XSP| e la richiesta non riesce, possono verificarsi diverse cose:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un avanzamento di route al successivo IP.
-
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
-
Se non si riceve alcuna risposta HTTP entro 2 secondi, si verifica un timeout della richiesta e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento all'IP successivo.
Ogni richiesta viene provata 3 volte prima che un problema venga segnalato al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco di indirizzi da provare quando si invia una richiesta a un ADP XSP|. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna all'elenco per riprovare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco dei contatti bloccati. Se tale indirizzo IP viene rimosso dall'elenco dei contatti bloccati.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP XSP| o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster di chiamata BroadWorks, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
-
Azioni XSI
-
Eventi XSI
-
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Lo stato delle connessioni può essere:
-
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
-
Rosso: Quando tutti gli IP nella ricerca dei record A sono irraggiungibili e l'interfaccia non è disponibile.
I seguenti servizi utilizzano i microservizi per la connessione agli ADP XSP| e sono interessati dalla disponibilità dell'interfaccia ADP XSP|:
-
Accesso all'app Webex
-
Aggiornamento token app Webex
-
E-mail/attivazione automatica non attendibile
-
Controllo stato servizio Broadworks
Webex App
Configurazione DNS
L'app Webex accede all'interfaccia Xtended Services Interface (Azioni XSI e Eventi XSI) e ai servizi Device Management Service (DMS) su ADP XSP|.
Per trovare il servizio XSI, l'app Webex esegue una ricerca SRV DNS per _xsi-client._tcp.
. L'SRV punta all'URL configurato per gli host XSP|ADP o i servizi di bilanciamento del carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex esegue il fallback alla ricerca A/AAAA.
L'SRV può risolvere più obiettivi A/AAAA. Tuttavia, ciascun record A/AAAA deve eseguire il mapping a un solo indirizzo IP. Se sono presenti più ADP XSP| in una DMZ dietro il servizio di bilanciamento del carico/dispositivo periferico, è necessario che il servizio di bilanciamento del carico sia configurato per mantenere la persistenza della sessione per indirizzare tutte le richieste della stessa sessione allo stesso ADP XSP|. È richiesta questa configurazione poiché gli heartbeat dell'evento XSI del client devono passare allo stesso ADP XSP| utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non è necessario. Se il DNS richiede che sia definito un record A/AAAA, deve essere restituito solo 1 indirizzo IP. In ogni caso, l'SRV deve essere ancora definito per l'app Webex.
Se Webex App utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client invia heartbeat a un ADP XSP| dove non ha stabilito un canale evento. In questo modo il canale viene eliminato e anche il traffico interno risulta notevolmente più limitato, che compromette le prestazioni del cluster XSP|ADP.
Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca dei record A/AAAA, devi utilizzare un FQDN separato per Webex Cloud e Webex App per accedere alle tue ADP XSP|. Come mostrato negli esempi, Webex Cloud utilizza Un record webex-cloud-xsp.example.com
, e l'app Webex utilizza SRV _xsi-client._tcp.webex-app-xsp.example.com
.
Esempio 1: più ADP XSP|, ciascuno dietro bilanciatori di carico separati
In questo esempio, l'SRV punta a silenziare record A con ciascun record A che punta a un diverso bilanciamento del carico in un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito è riportato un esempio di SRV record.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Esempio 2: più ADP XSP|dietro un singolo servizio di bilanciamento del carico (con bridge TLS)
Per la richiesta iniziale, il servizio di bilanciamento del carico seleziona un XSP|ADP casuale. Indica che XSP ADP|restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il servizio di bilanciamento del carico utilizza il cookie per indirizzare la connessione all'ADP XSP| corretto, assicurando che il canale dell'evento non si rompi.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Bilanciamento del carico |
A |
LB.example.com |
|
Indirizzo IP del servizio di bilanciamento del carico (gli ADP XSP| sono dietro al servizio di bilanciamento del carico) |
URL dms
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il relativo file di configurazione. L'host nell'URL verrà analizzato e l'app Webex eseguirà la ricerca DNS A/AAAA dell'host per connettersi all'ADP XSP| che ospita il servizio DMS.
Esempio: Record DNS A per il rilevamento di server ADP XSP bilanciato verso Internet|/bilanciamento del carico dell'app Webex per scaricare i file di configurazione attraverso DMS:
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. Qualsiasi riferimento a XSP include XSP o ADP.
Come l'app Webex trova indirizzi ADP XSP|
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
-
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (inserito durante la creazione del cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue SRV ricerca nel modo seguente:
-
Il client esegue una ricerca SRV per _xsi-client._tcp.
-
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
-
Il client esegue una ricerca A/AAAA di tali destinazioni e memorizza nella cache gli indirizzi IP restituiti.
-
Il client si connette a uno dei destinazioni (e pertanto, il relativo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi avere lo stesso peso (o a caso se tutti sono uguali).
-
-
Se la ricerca SRV ricerca non restituisce eventuali obiettivi:
Il client esegue una ricerca A/AAAA del parametro radice Xsi, quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento del bordo di bilanciamento del carico o potrebbe essere lo stesso server XSP|ADP.
Come specificato, il record A/AAAA deve risolversi in un indirizzo IP per gli stessi motivi.
-
-
(Opzionale) In un secondo tempo, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocolli> <xsi> <percorsi> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
-
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
-
Se esistono, il client verrà confrontato con l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
-
Se vengono rilevate eventuali differenze, il client inizializza nuovamente la connettività XSI Actions/ XSI Events. Il primo passo consiste nell'eseguire lo stesso processo di ricerca DNS elencato al punto 1, questa volta richiedendo una ricerca per il valore nel %XSI_ROOT_WXT% parametro dal relativo file di configurazione.
Creare i record delle SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
-
Failover
Durante l'accesso, l'app Webex esegue una ricerca SRV DNS per _xsi-client._tcp, crea un elenco di host e si connette a uno degli host in base alla priorità SRV, quindi peso. Questo ospite connesso diventa il selezionato per tutte le richieste future. Un canale di evento viene quindi aperto all'organizzatore selezionato e un heartbeat viene inviato regolarmente per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP; pertanto, è importante che il servizio di bilanciamento del carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server ADP XSP|di backend.
In caso di errore di una richiesta o di una richiesta heartbeat a un host, si possono verificare diverse operazioni:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), l'instradazione dell'app Webex avanza immediatamente al successivo organizzatore nell'elenco.
-
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e indirizza i progressi all'host successivo nell'elenco.
-
Se non si riceve una risposta entro un determinato periodo di tempo, la richiesta viene considerata non riuscita a causa di un timeout e le successive richieste vengono inviate all'organizzatore successivo. Tuttavia, la richiesta di timeout viene considerata come non riuscita. Si è verificato un tentativo in seguito ad alcune richieste in seguito a un errore (con un aumento del tempo di tentativo). Non si sono effettuate nuovamente richieste che presupponete non vitali.
Quando si prova correttamente un nuovo organizzatore, diventa il nuovo organizzatore selezionato, se è presente nell'elenco. Una volta tentato l'ultimo organizzatore nell'elenco, l'app Webex viene rollover a quella del primo.
In caso di heartbeat, se ci sono due errori di richiesta consecutivi, l'app Webex inizializza nuovamente il canale dell'evento.
Tenere presente che l'app Webex non esegue il fail-back e il rilevamento del servizio DNS viene eseguito una sola volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione tramite l'interfaccia ADP/DMS XSP|. Esegue una ricerca dei record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Si tenterà prima di inviare la richiesta di download del file di configurazione utilizzando un token SSO configurazione. Se questo non riesce, verrà riprovare ma con il nome utente e la password del dispositivo.
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione si rivolge agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei propri clienti o forniscono questa soluzione direttamente ai propri abbonati.
Scopo della soluzione
-
Fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che già dispongono del servizio di chiamata fornito dai provider di servizi BroadWorks.
-
Fornire il servizio di chiamata basato su BroadWorks a clienti Webex piccoli e medi.
Contesto
Stiamo evolvendo tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo sforzo consiste nello spostare le funzionalità di chiamata BroadWorks nell'app Webex e infine ridurre gli investimenti nei client UC-One.
Vantaggi
-
Prova futura: contro interruzione del servizio di UC-One Collaborate, spostamento di tutti i client verso Unified Client Framework (UCF)
-
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex mantenendo la chiamata BroadWorks sulla rete di telefonia
Ambito della soluzione
-
Clienti da piccoli a medi esistenti/nuovi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre di chiamate BroadWorks.
-
Clienti Webex esistenti di piccole e medie dimensioni che desiderano aggiungere BroadWorks Calling.
-
Non aziende più grandi (rivedere il nostro portfolio Enterprise per Webex).
-
Non utenti singoli (valutare le offerte Webex Online).
Le funzioni impostate in Webex per Cisco BroadWorks riguardano casi d'uso di piccole e medie imprese. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità per le PMI e ne valutiamo costantemente l'idoneità per questo segmento. Possiamo scegliere di nascondere o rimuovere funzioni che sarebbero altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# |
Requisito |
Note | ||
---|---|---|---|---|
1 |
Patch BroadWorks R22 corrente o superiore | |||
2 |
XSP|ADP per XSI, CTI, DMS e authService |
XSP|ADP dedicato per Webex per Cisco BroadWorks | ||
3 |
Separa XSP|ADP per NPS, può essere condiviso con altre soluzioni che utilizzano NPS. |
Se si dispone di una distribuzione di collaborazione esistente, esaminare le raccomandazioni sulle configurazioni XSP|ADP e NPS. | ||
4 |
Convalida token CI (con TLS) configurata per le connessioni Webex al servizio di autenticazione. | |||
5 |
mTLS configurato per le connessioni Webex all'interfaccia CTI. |
Altre applicazioni non richiedono mTLS. | ||
6 |
Gli utenti devono essere presenti in BroadWorks e necessitano dei seguenti attributi, a seconda della decisione di provisioning:
|
Per i messaggi e-mail attendibili: Si consiglia di inserire lo stesso indirizzo e-mail anche nell'attributo ID alternativo, per consentire agli utenti di accedere con indirizzo e-mail rispetto a BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'uso di e-mail non attendibili può causare l'invio dell'e-mail alla cartella Posta indesiderata o SPAM dell'utente. L'amministratore potrebbe dover modificare le impostazioni e-mail dell'utente per consentire i domini | ||
7 |
Webex per il file DTAF Cisco BroadWorks per l'app Webex | |||
8 |
Utente BW Business Lic o Std Enterprise o Prem Enterprise Lic + Webex per abbonamento Cisco BroadWorks |
Se si dispone di una distribuzione di collaborazione esistente, non è più necessario il pacchetto aggiuntivo UC-One, le porte per conferenze Collab Lic e Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non occorre apportare altre modifiche se non accettare i termini del pacchetto Premium. | ||
9 |
IP/porte devono essere accessibili attraverso i servizi backend Webex e le app Webex su Internet pubblico. |
Vedere la sezione "Preparazione della rete". | ||
10 |
Configurazione TLS v1.2 su XSP|ADPs | |||
11 |
Per il provisioning Flowthrough, il server applicazioni deve connettersi all'adattatore di provisioning BroadWorks.
|
Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è aiutarti a comprendere, preparare, distribuire e gestire la tua soluzione Webex per Cisco BroadWorks. Le principali sezioni del documento riflettono tale obiettivo.
Questa guida include materiale concettuale e di riferimento. In questo documento intendiamo trattare tutti gli aspetti della soluzione.
La serie minima di attività per distribuire la soluzione è la seguente:
-
Contatta il team dell'account per diventare un partner Cisco. È fondamentale esplorare i punti di contatto Cisco per acquisire familiarità (e ricevere formazione). Quando si diventa partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Onboarding partner in questo documento.
-
Configura i tuoi sistemi BroadWorks per l'integrazione con Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento.
-
Usa Partner Hub per connettere Webex a BroadWorks. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione partner in Partner Hub in questo documento.
-
Utilizzare Partner Hub per preparare i modelli di provisioning degli utenti. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento.
-
Testare e eseguire l'onboarding di un cliente mediante il provisioning di almeno un utente (vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
|
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. (Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto).
Come funziona
Webex per Cisco BroadWorks è un'offerta che integra BroadWorks Calling in Webex. Gli abbonati utilizzano una singola applicazione (l'app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
-
Gli utenti chiamano i numeri PSTN utilizzando l'infrastruttura BroadWorks.
-
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino numerico per introdurre i numeri).
-
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Chiamata Webex" sull'app Webex. (Queste chiamate sono da app Webex a app Webex, non da app Webex a PSTN).
-
Gli utenti possono organizzare e accedere a Webex Meetings.
-
Gli utenti possono scambiarsi messaggi uno a uno o in spazi (chat di gruppo persistente) e beneficiare di funzioni come ricerca e condivisione file (sull'infrastruttura Webex).
-
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
-
Una volta eseguito l'onboarding come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare la relazione tra l'istanza BroadWorks e Webex.
-
È possibile creare organizzazioni dei clienti in Control Hub e eseguire il provisioning degli utenti in tali organizzazioni.
-
Ogni abbonato in BroadWorks riceve un'identità Webex in base al proprio indirizzo e-mail (attributo ID e-mail in BroadWorks).
-
Gli utenti eseguono l'autenticazione su BroadWorks o su Webex.
-
Ai clienti vengono rilasciati token di lunga durata per autorizzarli per i servizi su BroadWorks e Webex.
L'app Webex al centro di questa soluzione, è un'applicazione personalizzabile disponibile su desktop Mac/Windows e dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzionalità di messaggistica, presenza e riunioni.
Il client esegue la registrazione ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i tuoi sistemi BroadWorks per garantire un'esperienza di provisioning utente perfetta.
Funzioni e limitazioni
Offriamo diversi pacchetti con diverse caratteristiche.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata, ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano nella rubrica un utente softphone, i risultati della ricerca non forniscono alcuna opzione per inviare un messaggio.
Gli utenti del softphone possono condividere lo schermo durante una chiamata.
Pacchetto "base"
Il pacchetto di base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti in riunioni a "spazio unificato" e riunioni nella sala riunioni personale. (** vedere la seguente nota a titolo di eccezione). In questo pacchetto le riunioni possono avere una durata massima di 40 minuti.
Pacchetto "Standard"
Questo pacchetto include anche tutto quello che è contenuto nel pacchetto Base, ad esempio fino a 100 partecipanti nelle riunioni "spazio unificato" e nelle riunioni nella sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è un ruolo inizialmente ricoperto solo dall'organizzatore della riunione, ma l'organizzatore può passare il "ruolo di relatore" a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può riprendere il ruolo di relatore senza che l'organizzatore corrente glielo passi.
Pacchetto "Premium"
Questo pacchetto include tutto nel pacchetto Standard più un massimo di 300 partecipanti in una riunione "spazio unificato" e fino a 1000 partecipanti in una sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR è supportata per qualsiasi partecipante alla riunione.
Confronta pacchetti
Pacchetto |
Chiamata |
Messaggistica |
Riunioni nello spazio Unified |
PMR riunioni |
---|---|---|---|---|
Softphone |
Incluso |
Non incluso |
Nessuno |
Nessuno |
Base |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Standard |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Premium |
Incluso |
Incluso |
300 partecipanti |
1000 partecipanti |
Il limite della riunione nello spazio Unified per gli utenti Base è 100 partecipanti per riunione nello spazio Unified a meno che lo spazio non includa anche gli utenti a cui sono assegnati i pacchetti "Standard" o "Premium", nel qual caso il limite aumenta in base al pacchetto utente organizzatore. |
"Riunioni nello spazio Unified" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti "Riunione" o "Pianifica". "Riunioni PMR" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale (PMR) di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID). |
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per le differenze di supporto delle funzioni di riunione PMR per i pacchetti Base, Standard e Premium.
Funzione riunione |
Supportato con il pacchetto base |
Suported con pacchetto standard |
Supportato con il pacchetto Preminum |
Commento |
---|---|---|---|---|
Durata riunione |
40 minuti o meno |
Illimitato |
Illimitato | |
Condivisione del desktop |
Sì |
Sì |
Sì |
Base: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione desktop solo da parte dell'organizzatore della riunione PMR. Premium: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. |
Condivisione di un'applicazione |
Sì |
Sì |
Sì |
Base: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione delle applicazioni solo da parte dell'organizzatore della riunione PMR. Premium: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. |
Chat con più interlocutori |
Sì |
Sì |
Sì | |
Whiteboard |
Sì |
Sì |
Sì | |
Protezione con password |
Sì |
Sì |
Sì | |
App Web - nessun download o plug-in (Esperienza ospite) |
Sì |
Sì |
Sì | |
Supporto dell'accoppiamento con i dispositivi Webex |
Sì |
Sì |
Sì | |
Controllo del pavimento (disattivazione del microfono uno / espulsione tutti) |
Sì |
Sì |
Sì | |
Collegamento Riunioni persistenti |
Sì |
Sì |
Sì | |
Accesso sito riunioni |
Sì |
Sì |
Sì | |
Accesso alla riunione tramite VoIP |
Sì |
Sì |
Sì | |
Bloccaggio |
Sì |
Sì |
Sì | |
Controlli relatore |
No |
No |
Sì | |
Controllo desktop remoto |
No |
No |
Sì | |
Numero di partecipanti |
100 |
100 |
1000 | |
Registrazione salvata in locale nel sistema |
Sì |
Sì |
Sì | |
Registrazione nel cloud |
No |
No |
Sì | |
Registrazione - Cloud Storage |
No |
No |
10 GB per sito | |
Trascrizione delle registrazioni |
No |
No |
Sì | |
Pianificazione riunione |
Sì |
Sì |
Sì | |
Abilita condivisione contenuto con integrazioni esterne |
No |
No |
Sì |
Base: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. Standard: condivisione di contenuto solo da parte dell'organizzatore della riunione PMR. Premium: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. |
Consenti modifica URL PMR |
No |
No |
Sì |
Base: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori dei partner e delle organizzazioni possono modificare l'URL da Control Hub. Standard: l'URL PMR può essere modificato solo da Partner Hub per Partner e amministratori organizzazione. Premium: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori partner e dell'organizzazione possono modificare l'URL da Partner Hub. |
Streaming in diretta riunioni (Ad Esempio, su Facebook, Youtube) |
No |
No |
Sì | |
Consenti ad altri utenti di pianificare riunioni per loro conto |
No |
No |
Sì | |
Aggiungi organizzatore alternativo |
Sì |
No |
Sì | |
Integrazione app (es., Zendesk, Slack) |
Dipende dall'integrazione |
Dipende dall'integrazione |
Sì |
Per ulteriori informazioni sul supporto, vedere la sezione Integrazioni app riportata di seguito. |
Integrazione con il calendario Microsoft Office 365 |
Sì |
Sì |
Sì | |
Integrazione con Google Calendaring per G Suite |
Sì |
Sì |
Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione rivolta agli utenti per Webex su help.webex.com
. Per ulteriori informazioni sulle funzioni, leggere i seguenti articoli:
Funzioni di chiamata
L'esperienza di chiamata è simile alle soluzioni precedenti che utilizzano il motore di controllo delle chiamate BroadWorks. La differenza tra UC-One Collaborate e UC-One SaaS è che l'app Webex è il client software principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
-
Zendesk—Solo Premium
-
Slack: solo Premium
-
Microsoft Teams per Webex Meetings—Standard o Premium
-
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
-
Calendario Office 365—Standard o Premium
-
Google Calendaring per G Suite: standard o premium
Supporto dell'infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta gli ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione per Webex per l'infrastruttura desktop virtuale (VDI).
Supporto per IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Pro Pack per Control Hub
Il servizio aggiuntivo Pro Pack per Control Hub offre agli amministratori, ai professionisti della sicurezza delle informazioni e ai responsabili della conformità funzionalità avanzate di sicurezza, conformità e analisi in grado di integrarsi con il software.
Questi servizi aggiuntivi saranno disponibili solo per i pacchetti Standard e Premium.
Per ulteriori informazioni, vedi la Pagina della Guida di Pro Pack per Control Hub.
Tabella di marcia futura
Per informazioni sulle nostre intenzioni per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Le voci della roadmap non sono vincolanti in alcuna capacità. Cisco si riserva il diritto di sospendere o rivedere uno o tutti questi elementi dalle release future.
Limiti
Limitazioni di provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario del sito Webex Meetings creato per tale pacchetto.
Se nella richiesta di provisioning per il primo utente di ciascun pacchetto non viene specificato alcun fuso orario, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sull'impostazione predefinita regionale dell'organizzazione degli abbonati.
Se il cliente ha bisogno di un fuso orario specifico del sito Webex Meetings, specificare il parametro fuso orario
nella richiesta di provisioning per:
-
il primo abbonato predisposto per il pacchetto Standard nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto base nell'organizzazione.
Limitazioni generali
-
Nessuna chiamata nella versione Web del client Webex (questa è una limitazione del client, non una limitazione della soluzione).
-
Webex potrebbe non disporre ancora di tutti i controlli dell'interfaccia utente per supportare alcune funzioni di controllo delle chiamate disponibili da BroadWorks.
-
Attualmente, il client Webex non può essere "White Labeled" (etichetta bianca).
-
Quando si creano le organizzazioni dei clienti utilizzando il metodo di provisioning scelto, vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. Ci aspettiamo che i partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
-
I report sull'utilizzo di riunioni e messaggi sono disponibili attraverso l'organizzazione del cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti di messaggistica
I seguenti limiti di archiviazione dei dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo storage massimo per messaggistica e file combinati.
-
Di base: 2 GB per utente per 3 anni
-
Standard 5 GB per utente per 3 anni
-
Premio: 10 GB per utente per 5 anni
Per ciascuna organizzazione del cliente, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti premium ha un limite totale di messaggistica e storage file di 50 GB. Un singolo utente può superare il limite per utente (10 GB), a condizione che la società sia ancora al di sotto del massimo aggregato (50 GB).
Per gli spazi team creati, i limiti di messaggistica vengono applicati al totale aggregato per l'organizzazione cliente che possiede lo spazio team. Puoi trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti generali di messaggistica applicabili agli spazi dei team di messaggistica Webex, fare riferimento a https://help.webex.com/en-us/n8vw82eb/Webex-Capacity.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure le connessioni a Webex e BroadWorks. I dati memorizzati nel cloud Webex ed esposti all'utente attraverso l'interfaccia dell'app Webex sono crittografati sia in transito che a riposo.
Maggiori dettagli sullo scambio di dati sono disponibili nella sezione Riferimento del presente documento.
Ulteriori letture
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati che più si avvicina alla propria regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore del provider di servizi (utente): Per le attività di manutenzione quotidiane, si gestiscono le parti della soluzione in sede (chiamata) utilizzando i propri sistemi. Gestisci le parti Webex della soluzione attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale.
Il primo utente predisposto per un nuovo organizzatore partner viene assegnato automaticamente ai ruoli amministratore completo e amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi. |
Team operativo di Cisco cloud: Crea la tua "organizzazione partner" in Partner Hub, se non esiste, durante l'onboarding.
Una volta ottenuto l'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente, create "Onboarding templates" (Modelli di onboarding) per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Quindi si fornisce i vostri clienti o abbonati.
# |
Compito tipico |
SP |
Cisco |
---|---|---|---|
1 |
Onboarding partner - Creazione dell'organizzazione partner se non esiste e abilitazione dei tasti di alternanza funzione necessari |
● | |
2 |
Configurazione BroadWorks nell'organizzazione partner tramite Partner Hub (cluster) |
● | |
3 |
Configurazione delle impostazioni di integrazione in Organizzazione partner tramite Partner Hub (modelli di offerta, branding) |
● | |
4 |
Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|ADP Patching, firewall, configurazione XSP|ADP, XSI, AuthService, CTI, NPS, DMS su XSP|ADP) |
● | |
5 |
Sviluppo dell'integrazione o del processo di provisioning |
● | |
6 |
Preparare i materiali GTM |
● | |
7 |
Migrazione o provisioning di nuovi utenti |
● |
Architettura
Cosa c'è nel diagramma?
Client
-
Il client dell'app Webex serve come applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di messaggistica nativa, presenza e riunioni audio/video multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per le chiamate SIP e PSTN.
-
I telefoni IP Cisco e i relativi accessori utilizzano anche l'infrastruttura BroadWorks per le chiamate SIP e PSTN. Ci aspettiamo di essere in grado di supportare telefoni di terze parti.
-
Portale di attivazione utente per gli utenti che accedono a Webex utilizzando le credenziali BroadWorks.
-
Partner Hub è un'interfaccia Web per l'amministrazione dell'organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. Puoi anche utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
Rete di provider di servizi
Il blocco verde a sinistra dello schema rappresenta la tua rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
-
XSP|ADP lato pubblico, per Webex per Cisco BroadWorks: (La scatola rappresenta una o più fattorie XSP|ADP, eventualmente frontali da bilancieri di carico).
-
Ospita l'interfaccia dei servizi Xtended (XSI-Actions & XSI-Events), il servizio di gestione dei dispositivi (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato del ricevitore dell'altro (presenza di telefonia) e la cronologia chiamate.
-
Pubblica la rubrica ai client Webex.
-
-
XSP|ADP lato pubblico, con NPS in esecuzione:
-
server push notifiche chiamate organizzatore: Un server push di notifica su un XSP|ADP nell'ambiente. Si interfaccia tra il server applicazioni e il proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS & FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
-
-
Server applicazioni:
-
Fornisce il controllo delle chiamate e le interfacce ad altri sistemi BroadWorks (generalmente)
-
Per il provisioning flowthrough, l'AS viene utilizzato dall'amministratore del partner per il provisioning degli utenti in Webex
-
Inserisce il profilo utente in BroadWorks
-
-
OSS/BSS: Sistema di supporto alle operazioni/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nello schema rappresenta il cloud Webex. I microservizi Webex supportano l'intero spettro di funzionalità di collaborazione Webex:
-
Cisco Common Identity (CI) è il servizio identità all'interno di Webex.
-
Webex per Cisco BroadWorks rappresenta la serie di microservizi che supportano l'integrazione tra Webex e BroadWorks ospitato da provider di servizi:
-
API di provisioning utente
-
Configurazione provider di servizi
-
Accesso utente mediante credenziali BroadWorks
-
-
Casella di messaggistica Webex per microservizi correlati alla messaggistica.
-
Casella Webex Meetings che rappresenta server di elaborazione multimediale e SBC per riunioni video con più partecipanti (SIP e SRTP)
Servizi Web di terze parti
Nello schema sono rappresentati i seguenti componenti di terze parti:
-
APNS (Apple Push Notifications Service) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Apple.
-
FCM (messaggistica cloud FireBase) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Il ruolo dei server XSP|ADP rivolti al pubblico in Webex per Cisco BroadWorks
La XSP|ADP rivolta al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e client:
-
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste Webex per BroadWorks JWT (JSON Web Token) per conto dell'utente
-
Interfaccia CTI, protetta da mTLS, a cui Webex sottoscrive gli eventi della cronologia chiamate e lo stato della presenza di telefonia da BroadWorks (stato hook).
-
Interfacce azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate degli abbonati, rubriche di elenchi dei contatti e delle chiamate e configurazione del servizio di telefonia per gli utenti finali
-
Servizio DM (Device Management) per il recupero dei file di configurazione delle chiamate da parte dei client
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedere Configurazione dei cluster BroadWorks in Partner Hub in questo documento. Per ciascun cluster, è possibile fornire un solo URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP
È necessario utilizzare un'istanza XSP|ADP dedicata o un'azienda agricola separata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile ospitare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso XSP|ADP in cui è ospitata l'applicazione NPS.
Si consiglia di utilizzare un'istanza/azienda agricola XSP|ADP dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
-
Ad esempio, se offri UC-One SaaS, ti consigliamo di creare una nuova fattoria XSP|ADP per Webex per Cisco BroadWorks. In questo modo i due servizi possono operare in modo indipendente durante la migrazione degli abbonati.
-
Se si collocano le applicazioni Webex per Cisco BroadWorks in un'azienda agricola XSP|ADP utilizzata per altri scopi, è responsabilità dell'utente monitorare l'utilizzo, gestire la complessità risultante e pianificare l'aumento della scala.
-
Il pianificatore della capacità di sistema Cisco BroadWorks assume una fattoria XSP|ADP dedicata e potrebbe non essere preciso se la si utilizza per il calcolo della posizione.
Se non diversamente specificato, le applicazioni Webex dedicate per Cisco BroadWorks XSP|ADP devono ospitare le seguenti applicazioni:
-
AuthService (TLS con convalida token CI o mTLS)
-
CTI (mTLS)
-
Azioni XSI (TLS)
-
XSI-Events (TLS)
-
DMS (TLS): opzionale. Non è obbligatorio distribuire un'istanza DMS o un'azienda agricola separata specificamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
-
TLS (Call Settings Webview): opzionale. La vista Webview (CSW) delle impostazioni di chiamata è richiesta solo se si desidera che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso a CTI attraverso un'interfaccia protetta dall'autenticazione TLS reciproca. Per supportare questo requisito, raccomandiamo una delle seguenti opzioni:
-
(Diagramma etichettato Opzione 1) Una istanza XSP|ADP o azienda agricola per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
-
(Diagramma etichettato Opzione 2) Due istanze XSP|ADP o aziende agricole, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
XSP|ADP Riuso Se si dispone di un'azienda agricola XSP|ADP esistente conforme a una delle architetture suggerite sopra (opzione 1 o 2) ed è leggermente caricata, è possibile riutilizzare le XSP|ADP esistenti. Dovrai verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti dell'applicazione per Webex. Le due considerazioni principali sono:
Poiché gli XSP|ADP hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero esserci altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di XSP|ADP deve essere verificato in un laboratorio con la configurazione desiderata prima di impegnarsi nel riutilizzo. |
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione temporale per tutti gli XSP|ADP utilizzati con Webex.
Installare il pacchetto ntp
dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Quindi è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, consultare la Guida alla gestione del software BroadWorks.
Durante l'installazione interattiva del software XSP|ADP, è possibile configurare NTP. Procedere come segue:
-
Quando il programma di installazione lo chiede,
Configurare NTP?
, immetterey
. -
Quando il programma di installazione lo chiede,
Questo server sarà un server NTP?
, immetteren
. -
Quando il programma di installazione chiede,
Qual è l'indirizzo NTP, il nome host o il nome di dominio completo?
, immettere l'indirizzo del server NTP o un servizio NTP pubblico, ad esempio,pool.ntp.org
.
Se gli XSP|ADP utilizzano un'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie Key=Value:
NTP
NTP_SERVER=<NTP Indirizzo server, ad esempio pool.ntp.org>
Requisiti di identità e sicurezza XSP|ADP
Sfondo
I protocolli e le crittografie delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli vanno dal più generale (provider SSL) al più specifico (interfaccia singola). Un'impostazione più specifica sostituisce sempre un'impostazione più generale. Se non sono specificate, le impostazioni SSL di livello "inferiore" vengono ereditate da livelli "superiori".
Se non viene modificata alcuna impostazione rispetto alle impostazioni predefinite, tutti i livelli ereditano le impostazioni predefinite del provider SSL (JSSE Java Secure Sockets Extension).
Elenco dei requisiti
-
XSP|ADP deve autenticarsi sui client utilizzando un certificato firmato da CA in cui il nome comune o il nome alternativo oggetto corrispondono alla parte di dominio dell'interfaccia XSI.
-
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
-
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
-
Diffie-Hellman Effemeral (DHE) o curve ellittiche Diffie-Hellman Effemeral (ECDHE) chiave-scambio
-
Crittografia AES (Advanced Encryption Standard) con una dimensione minima di blocco di 128 bit (ad esempio, AES-128 o AES-256)
-
Modalità di codifica GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
-
Se viene utilizzata una crittografia CBC, solo la famiglia SHA2 di funzioni hash è consentita per derivazione chiave (SHA256, SHA384, SHA512).
-
-
Ad esempio, le seguenti crittografie soddisfano i requisiti:
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
La CLI XSP|ADP richiede la convenzione di denominazione IANA per le suite di crittografia, come mostrato sopra, non la convenzione openSSL. |
Crittografie TLS supportate per le interfacce AuthService e XSI
Questo elenco è soggetto a modifiche a mano a mano che evolvono i nostri requisiti di sicurezza del cloud. Seguire l'attuale raccomandazione sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento. |
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
-
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
-
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_128_GCM_SHA256
-
TLS_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_256_CBC_SHA256
-
TLS_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_WITH_AES_256_CBC_SHA
-
TLS_PSK_WITH_AES_256_CBC_SHA384
-
TLS_PSK_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_WITH_AES_128_CBC_SHA
-
TLS_PSK_WITH_AES_128_CBC_SHA256
-
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri della scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il numero di thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi visualizzati come segue (non diminuirli se sono al di sopra di questi valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più XSP|ADP
Elemento bordo bilanciamento carico
Se si dispone di un elemento di bilanciamento del carico sul bordo della rete, è necessario gestire in modo trasparente la distribuzione del traffico tra più server XSP|ADP e il cloud e client Webex per Cisco BroadWorks. In questo caso, è possibile fornire l'URL del bilanciatore di carico alla configurazione Webex per Cisco BroadWorks.
Note su questa architettura:
-
Configurare il DNS in modo che i client possano trovare il bilanciatore di carico quando si connettono all'interfaccia Xsi (vedere configurazione DNS).
-
Si consiglia di configurare l'elemento edge in modalità proxy SSL inversa per garantire la crittografia dei dati punto a punto.
-
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Server XSP|ADP orientati verso Internet
Se si espongono direttamente le interfacce Xsi, utilizzare il DNS per distribuire il traffico ai più server XSP|ADP.
Note su questa architettura:
-
Per connettersi ai server XSP|ADP sono necessari due record:
-
Per i microservizi Webex: Per targetizzare più indirizzi IP XSP|ADP, sono necessari record A/AAAA round-robin. Questo perché i microservizi Webex non possono effettuare ricerche SRV. Per esempi, vedere Servizi cloud Webex.
-
Per l'app Webex: Un record SRV che si risolve in record A in cui ogni record A si risolve in un singolo XSP|ADP. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per targetizzare il servizio XSI per più indirizzi XSP|ADP. Assegnare la priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (e all'indirizzo IP successivo) e passino al record A successivo (e all'indirizzo IP) solo se il primo indirizzo IP è inattivo. NON utilizzare un approccio round-robin per l'app Webex.
-
-
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio your-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune.
-
È possibile utilizzare i certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL XSP|ADP in un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server XSP|ADP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.
Ordinazione e provisioning
L'ordine e il provisioning si applicano a questi livelli:
-
Provisioning di partner/provider di servizi:
Ciascun Webex per provider di servizi Cisco BroadWorks (o rivenditore) caricato deve essere configurato come organizzazione partner in Webex e devono essere concesse le autorizzazioni necessarie. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per gestire Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le operazioni di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/aziendale.
-
Ordinazione e provisioning clienti/aziende:
Ogni BroadWorks Enterprise abilitato per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo si verifica automaticamente come parte del provisioning utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks vengono predisposti nella stessa organizzazione cliente Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
-
Ordinazione e provisioning utente/abbonato:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning degli utenti:
-
Provisioning fluviale con e-mail attendibili
-
Provisioning eseguibile senza e-mail attendibili
-
Self-provisioning utente
-
Provisioning API
-
Provisioning eseguibile con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile affermare che BroadWorks dispone di indirizzi e-mail abbonati validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Provisioning eseguibile senza e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non puoi contare sugli indirizzi e-mail degli abbonati detenuti da BroadWorks, questa opzione di provisioning crea account Webex ma non può attivarli fino a quando gli abbonati non forniscono e convalidano i relativi indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
Puoi modificare il pacchetto abbonato tramite Partner Hub oppure scrivere la tua applicazione per utilizzare l'API di provisioning per modificare i pacchetti abbonato.
Self-provisioning utente
Con questa opzione, non è disponibile il provisioning flowthrough da BroadWorks a Webex. Una volta configurata l'integrazione tra Webex e il sistema BroadWorks, vengono visualizzati uno o più collegamenti specifici per il provisioning degli utenti all'interno dell'organizzazione partner Webex per Cisco BroadWorks.
Successivamente, si progettano le proprie comunicazioni (o si delegano ai clienti) per distribuire il collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account vengono predisposti nell'ambito dell'organizzazione partner, puoi regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare tale operazione.
Gli utenti devono esistere nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento. |
Provisioning provider di servizi per API
Webex presenta un set di API pubbliche che consentono di creare il provisioning utente/abbonato Webex per Cisco BroadWorks nel flusso di lavoro/negli strumenti di gestione utenti esistenti.
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
-
Installare AP.as.22.0.1123.ap376508.
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
-
Installare AP.as.23.0.1075.ap376509
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
-
Installazione di AP.as.24.0.944.ap375100
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti Webex per Cisco Broadworks di comporre altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella rubrica Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo dell'estensione di tutte le aree del metodo di avvio chiamata e del profilo dell'utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e gruppi diversi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due imprese che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
-
Utenti Cisco BroadWorks
-
Provisioning API pubblica come 'interno
-
Il parametro dell'interno deve essere esplicitamente passato come parte della chiamata API. Per le imprese/gruppi con Location Dialing Code (LDC) configurato, il parametro dell'interno dovrebbe essere la combinazione di LDC e 'numero di interno.
-
-
Provisioning flusso o auto-attivazione
-
Estensione e LDC (se applicabile) saranno automaticamente recuperati da BroadWorks.
-
-
-
Utenti o entità di chiamata solo BroadWorks
-
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione di codice di chiamata posizione (LDC) e numero di interno.
-
Record di chiamata BroadWorks |
Descrizione |
Metodo di provisioning |
Gestione dell'interno |
---|---|---|---|
Utenti Webex per Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
API pubblica |
L'estensione deve essere passata come parametro |
Attraverso il flusso |
Interno recuperato automaticamente da BroadWorks | ||
Utenti di chiamata solo BroadWorks |
Utenti di chiamata che non hanno eseguito l'onboarding in Webex |
Sincronizzazione rubrica |
Interno sincronizzato per sincronizzazione rubrica |
Entità chiamanti non utenti |
Es., telefono per sale conferenze, fax, numero gruppo di risposta |
Sincronizzazione rubrica | Interno sincronizzato per sincronizzazione rubrica |
Elenchi telefonici BroadWorks |
Elenchi telefonici aziendali, di gruppo o personali |
Sincronizzazione rubrica |
Non applicabile |
Prerequisiti
-
La versione del client richiesta per supportare questa funzione è 42.11 o successiva.
-
Patch in cui i codici di chiamata di estensione e posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
-
AP.platform.23.0.1075.ap380045
-
AP.as.23.0.1075.ap380045
-
AP.xsp.23.0.1075.ap380045
-
AP.as.24.0.944.ap380045
-
-
Abilitare l'intestazione X-BroadWorks-Remote-Party-Info su AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP richiesto per il supporto della funzione di composizione dell'interno.
AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true
Priorità opzioni di chiamata app
Come parte del supporto della funzione di chiamata a interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità delle chiamate di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'estensione come seconda opzione in Partner Hub e Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con estensione attraverso uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione dell'interno sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Non verrà visualizzata un'estensione nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere visibile l'opzione di chiamata dell'interno per i clienti esistenti:
-
Se un partner desidera che tutte le organizzazioni dei clienti gestite siano dotate di un interno come una delle opzioni di chiamata, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
-
Se un partner desidera fornire un interno in opzioni di chiamata per una specifica organizzazione cliente, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e portarli alla pari con l'aumento di 30K contatti per l'elenco telefonico Enterprise, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per Organizzazione, che si applica alla somma degli elenchi telefonici Enterprise e di gruppo in una singola azienda BroadWorks. Ad esempio, sarà supportato un'azienda BroadWorks che dispone di un elenco di telefoni aziendali con 30K e anche di 5 elenchi di telefoni di gruppo ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K totali).
Questa funzione è disponibile su richiesta. Contatta il team dell'account per abilitare questa opzione.
|
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks nello storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare a quale gruppo appartiene questo utente. L'associazione dell'utente con un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca dei contatti nello storage del gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning degli abbonati Webex per BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
È possibile eseguire il provisioning dell'ID gruppo aziendale BroadWorks per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
-
Utenti Webex per Cisco BroadWorks
-
Provisioning API pubblica come "spEnterpriseGroupId"
-
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
-
-
Provisioning flusso o auto-attivazione
-
L'ID gruppo aziendale BroadWorks verrà automaticamente recuperato da BroadWorks.
-
-
Utenti o entità di chiamata solo BroadWorks
-
Non applicabile. Non è necessario sincronizzare l'ID gruppo aziendale BroadWorks per questi utenti.
-
-
Record di chiamata BroadWorks |
Descrizione |
Metodo di provisioning |
Gestione dell'ID gruppo aziendale |
---|---|---|---|
Utenti Webex per Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
API pubblica |
L'ID gruppo aziendale BroadWorks deve essere superato come parametro spEnterpriseGroupId |
Attraverso il flusso |
L'ID gruppo aziendale BroadWorks viene recuperato automaticamente da BroadWorks | ||
Utenti di chiamata solo BroadWorks |
Utenti di chiamata che non hanno eseguito l'onboarding in Webex |
Sincronizzazione rubrica |
Non applicabile |
Entità chiamanti non utenti |
Es., telefono per sale conferenze, fax, numero gruppo di risposta |
Sincronizzazione rubrica |
Non applicabile |
Elenchi telefonici BroadWorks |
Contatti negli elenchi telefonici del gruppo BroadWorks |
Sincronizzazione rubrica |
I contatti di gruppo vengono memorizzati nel servizio Webex Contact associato al gruppo specifico |
Elenchi di telefoni BroadWorks Enterpsie o Persional |
Contatti negli elenchi telefonici aziendali o personali |
Sincronizzazione rubrica |
Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. La migrazione non può essere completata fino a quando QUESTA API non viene completata. L'Id gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march Una volta abilitata la funzione e a seguito della sincronizzazione della rubrica successiva, i gruppi di utenti aziendali verranno visualizzati anche in Control Hub. La visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativa in questa fase. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza a un gruppo in Control Hub poiché tali modifiche non verranno riportate nuovamente in BroadWorks. La gestione di gruppo in Control Hub è destinata all'uso da parte dei partner che adotteranno le prossime API di gestione contatti. |
Migrazione e prova del futuro
La progressione Cisco del client di comunicazione unificata BroadSoft deve spostarsi da UC-One a Webex. Si verifica una corrispondente progressione dei servizi di supporto dalla rete del provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che tu stia eseguendo UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita consiste nel distribuire nuovi XSP|ADP dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti in Webex e infine recuperare l'infrastruttura utilizzata per la soluzione precedente.
Sottoscrizioni di documenti consigliate
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Abbonati che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di eseguire l'abbonamento a ciascuno dei seguenti articoli per assicurarsi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per iscriversi, accedere a ciascuno dei link seguenti e nell'articolo che viene lanciato fare clic sul pulsante Iscriviti.
Come minimo, si consiglia di iscriversi all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati in Documenti aggiuntivi dispone di un'opzione Sottoscrivi . Affinché questa opzione venga visualizzata, l'articolo deve essere visualizzato su help.webex.com.
Non esiste un'opzione di abbonamento per le landing page di documentazione. |
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Documenti Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
-
Porta la tua soluzione PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono di loro proprietà (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
-
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive come eseguire l'onboarding e il servizio dei dispositivi Room OS e MPP.
-
Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi di Webex per Cisco BroadWorks.
Articoli di Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti siti opzionali per ulteriori informazioni su Webex per Cisco BroadWorks:
-
Documentazione Webex per Cisco BroadWorks: nella pagina di destinazione vengono elencati i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
-
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme a quelle presto disponibili.
-
Problemi noti e limitazioni: informazioni sui problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
-
Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale: questo articolo descrive come assegnare i ruoli amministratore partner per le organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte della soluzione Cisco BroadWorks:
Articoli della Guida Webex
I seguenti siti della Guida Webex possono essere utilizzati per trovare gli articoli Webex che consentono agli amministratori dei clienti e agli utenti finali di utilizzare le funzioni Webex.
-
Webex da provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati comunemente per gli utenti dell'app Webex che hanno acquistato i servizi Webex da un provider di servizi.
-
Centro assistenza Webex: utilizzare la funzione di ricerca su help.webex.com per cercare altri articoli Webex che descrivono la funzionalità dell'app Webex e di Webex Meetings. È possibile ricercare gli articoli utente o amministratore.
Documentazione sviluppatore
-
Guida per sviluppatori Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Punti di decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastrutture
|
Quanti XSP|ADP? Come prendono l'mTLS? |
Pianificatore capacità di sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento CLI XSP|ADP Il presente documento |
Provisioning cliente e utente |
Puoi affermare che ti fidi dei messaggi e-mail in BroadWorks? Vuoi che gli utenti forniscano indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Documenti API pubblica su https://developer.webex.com Il presente documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo di branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso per i clienti? | Il presente documento |
Funzioni abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o Softphone. |
Il presente documento Matrice caratteristiche/pacchetto |
Autenticazione utente | BroadWorks o Webex | Il presente documento |
Adattatore di provisioning (per opzioni di provisioning flowthrough) |
Utilizzate già IM&P integrato, ad esempio per UC-One SaaS? Si desidera utilizzare più modelli? È previsto un caso d'uso più comune? |
Il presente documento Riferimento CLI server applicazioni |
Architettura e infrastrutture
-
Con che tipo di scala intende iniziare? È possibile scalare in futuro, ma la stima di utilizzo attuale dovrebbe guidare la pianificazione dell'infrastruttura.
-
Collaborare con il proprio account manager / rappresentante di vendita Cisco per dimensionare l'infrastruttura XSP|ADP, in base al Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
-
In che modo Webex renderà le connessioni Mutual TLS ai tuoi XSP|ADP? Direttamente a XSP|ADP in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce. (Non supportiamo connessioni TCP non crittografate al perimetro della rete).
Provisioning cliente e utente
Quale metodo di provisioning utente si adatta meglio?
-
Provisioning eseguibile con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene predisposto automaticamente in Webex.
Se puoi anche affermare che gli indirizzi e-mail dell'abbonato in BroadWorks sono validi e univoci per Webex, puoi utilizzare la variante "email attendibili" del provisioning flowthrough. Gli account Webex abbonati vengono creati e attivati senza il loro intervento; scaricano semplicemente il client e accedono.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto, il provider di servizi deve fornire un indirizzo e-mail valido all'utente per eseguire il provisioning dei servizi Webex. Questo deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo anche nell'attributo ID alternativo.
-
Provisioning eseguibile senza e-mail attendibili: Se non riesci a fidarti degli indirizzi e-mail dell'abbonato, puoi comunque assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
-
Self-provisioning utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. Tu (o i tuoi clienti) distribuisci invece un collegamento di provisioning e i collegamenti per scaricare i diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano i relativi indirizzi e-mail per creare e attivare gli account Webex. Quindi, scaricano il client e accedono e Webex recupera una configurazione aggiuntiva su di essi da BroadWorks (inclusi i numeri principali).
-
Provisioning controllato da SP tramite API: Webex espone una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei propri flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti di sistema generali descritti in questa guida.
Metodo di provisioning |
Requisiti |
---|---|
Provisioning Flowthrough (e-mail attendibili o non attendibili) |
L'API di provisioning Webex aggiunge automaticamente gli utenti BroadWorks esistenti a Webex una volta che l'utente soddisfa i requisiti e si attiva il servizio Integrated IM+P. Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Self-provisioning utente |
L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato il messaggio e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) |
Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono previsti due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, vai a Utenti BroadWorks. |
Patch richieste con provisioning flow-through
Se si utilizza il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni che si applicano alla release BroadWorks:
Per R22:
-
Installare AP.as.22.0.1123.ap376508.
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txt.
Per R23:
-
Installare AP.as.23.0.1075.ap376509
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txt.
Per R24:
-
Installazione di AP.as.24.0.944.ap375100
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla patch https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txt.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning dei nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per gli utenti Cisco BroadWorks. |
Impostazioni internazionali lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente di amministrazione predisposto viene assegnata automaticamente come impostazioni internazionali predefinite per tale organizzazione cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti alle riunioni in tale organizzazione cliente.
Sono supportate le impostazioni internazionali di cinque caratteri in formato (ISO-639-1)_(ISO-3166). Ad esempio, en_US corrisponde a English_UnitedStates. Se viene richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genera un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un codice paese dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, viene utilizzata l'impostazione locale ragionevole predefinita in base al codice della lingua richiesto.
Nella tabella riportata di seguito vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice lingua a due lettere in un'impostazione locale a cinque caratteri per le situazioni in cui un'impostazione locale a cinque caratteri non è disponibile.
Impostazioni internazionali lingua supportate (ISO-639-1)_(ISO-3166) |
Se è disponibile solo un codice lingua a due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** |
Usa impostazioni internazionali ragionevoli predefinite (ISO-639-1)_(ISO-3166) | |
en_US en_AU en_GB en_CA |
en en |
en_US |
fr_FR fr_CA |
Fr |
fr_FR |
cs_CZ |
cs |
cs_CZ |
da_DK |
da |
da_DK |
de_DE |
DE |
de_DE |
hu_HU |
hu |
hu_HU |
id_ID |
ID |
id_ID |
it_IT |
IT |
it_IT |
ja_JP |
ja |
ja_JP |
ko_KR |
ko |
ko_KR |
es_ES es_CO es_MX |
ES |
es_ES |
nl_NL |
NL |
nl_NL |
nb_NO |
nb. |
nb_NO |
pl_PL |
pl. |
pl_PL |
pt_PT pt_BR |
pt |
pt_PT |
ru_RU |
RU |
ru_RU |
ro_RO |
ro |
ro_RO |
zh_CN zh_TW |
zh |
zh_CN |
sv_SE |
sv |
sv_SE |
ar_SA |
ar |
ar_SA |
tr_TR |
tr |
tr_TR |
Locales es_CO, id_ID, nb_NO e pt_PT non sono supportati dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti Webex Meetings saranno solo in inglese. Inglese è la impostazioni internazionali predefinite per i siti se per il sito non sono richieste impostazioni internazionali non valide/non supportate. Questo campo lingua è applicabile durante la creazione di un'organizzazione e un sito Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, la lingua del modello verrà utilizzata come lingua predefinita. |
Branding
Gli amministratori dei partner possono utilizzare le personalizzazioni di branding avanzate per personalizzare il modo in cui l'app Webex cerca le organizzazioni dei clienti gestite dal partner. Gli amministratori dei partner possono personalizzare le seguenti impostazioni per assicurarsi che l'app Webex rifletta il marchio e l'identità dell'azienda:
-
Loghi aziendali
-
Schemi di colori univoci per la modalità chiaro o la modalità scura
-
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione delle personalizzazioni di branding avanzate.
|
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding come richiesto, ma quando si esegue l'onboarding di un cliente è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Alcuni parametri del modello principale sono elencati di seguito.
Pacchetto
-
È necessario selezionare un pacchetto predefinito quando si crea un modello (vedere Pacchetti nella sezione Panoramica per dettagli). Tutti gli utenti predisposti con tale modello, tramite flowthrough o self-provisioning, ricevono il pacchetto predefinito.
-
È possibile controllare la selezione dei pacchetti per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno di essi. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori di provisioning per azienda, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
-
Puoi modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedi Webex per la documentazione API Cisco BroadWorks o attraverso Partner Hub (vedi Modifica pacchetto utente in Partner Hub).
-
Non puoi modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è attivata o disattivata; se all'abbonato viene assegnato questo servizio in BroadWorks, il modello Partner Hub associato all'URL di provisioning aziendale di tale abbonato definisce il pacchetto.
Rivenditore e aziende o fornitore di servizi e gruppi?
-
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se sei un rivenditore con Enterprise, devi abilitare la modalità Enterprise quando crei un modello.
-
Se il sistema BroadWorks è configurato in modalità provider di servizi, è possibile lasciare disattivata la modalità Enterprise nei modelli.
-
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch BroadWorks richieste per il provisioning flow-through. Per ulteriori dettagli, vedere Patch richieste con provisioning flow-through. |
Modalità di autenticazione
Decidi come desideri che gli abbonati eseguano l'autenticazione quando accedono a Webex. È possibile assegnare la modalità utilizzando l'impostazione Modalità di autenticazione nel modello di onboarding. Nella tabella seguente sono riportate alcune opzioni.
Questa impostazione non ha effetto sull'accesso al portale di attivazione utente. Gli utenti che accedono al portale devono immettere l'ID utente e la password BroadWorks, come configurati su BroadWorks, indipendentemente da come si configura la modalità di autenticazione nel modello di onboarding. |
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | ID utente BroadWorks | Indirizzo e-mail |
Provider identità |
BroadWorks.
| Identità comune Cisco |
Autenticazione a più fattori? | No | Richiede IdP del cliente che supporta l'autenticazione a più fattori. |
Percorso di convalida delle credenziali
|
|
|
Per una ripartizione più dettagliata del flusso di accesso SSO con autenticazione diretta a BroadWorks, vedere Flusso di accesso SSO. |
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che si può verificare con password che utilizzano caratteri speciali per cui il browser Web non codifica correttamente i caratteri. Utilizzando un'intestazione con codifica UTF-8, con codifica base 64, risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
-
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> imposta autenticazioneCodifica UTF-8
-
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> imposta autenticazioneCodifica UTF-8
Paese
Quando si crea un modello, è necessario selezionare un paese. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie S. |
Posizione |
Prefisso internazionale |
Nome paese |
---|---|---|---|
1 |
AMER |
+1 |
Stati Uniti, California |
2 |
APAC |
+65 |
Singapore |
3 |
ANZ |
+61 |
Australia |
4 |
EMEA |
+44 |
Regno Unito |
5 |
EURO |
+49 |
Germania |
Accordi con più partner
Vuoi concedere in sublicenza Webex per Cisco BroadWorks a un altro provider di servizi? In questo caso, ciascun provider di servizi avrà bisogno di un'organizzazione partner distinta in Webex Control Hub per consentire loro di fornire la soluzione per la propria base clienti.
Adattatore di provisioning e modelli
Quando si utilizza il provisioning flowthrough, l'URL di provisioning inserito in BroadWorks viene derivato dal modello in Control Hub. È possibile disporre di più modelli e quindi di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati al momento della concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e quale modello si desidera utilizzare a tale scopo. In questo modo, è necessario impostare esplicitamente l'URL di provisioning per le aziende che necessitano di un modello diverso.
Inoltre, tenere presente che è possibile che si stia già utilizzando un URL di provisioning a livello di sistema, ad esempio con UC-One SaaS. In tal caso, è possibile scegliere di mantenere l'URL a livello di sistema per il provisioning degli utenti su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono dettagliate in Configura server applicazioni con URL servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning flowthrough tra AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server AS e Webex, annullando in tal modo la necessità di connettersi direttamente al servizio Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati che si sta eseguendo il provisioning per Webex devono esistere nel sistema BroadWorks integrato con Webex. È possibile integrare più sistemi BroadWorks, se necessario.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero o interno principale.
Webex utilizza gli indirizzi e-mail come identificatori principali per tutti gli utenti. Se si utilizza il provisioning flowthrough con e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail degli abbonati nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo di utenti di chiamata BroadWorks con un numero principale e/o interno. Se si utilizza il provisioning flowthrough, agli utenti deve essere assegnato anche il servizio IM&P integrato. |
Server nella rete e requisiti software
-
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere la sezione Politica sul ciclo di vita dei prodotti BroadSoft in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
-
Le istanze BroadWorks devono includere almeno i seguenti server:
-
Server applicazioni (AS) con versione BroadWorks come sopra
-
Server di rete (NS)
-
Server profilo (PS)
-
-
Server XSP|ADP o ADP (Application Delivery Platform) rivolti al pubblico che soddisfano i seguenti requisiti:
-
Servizio di autenticazione (BWAuth)
-
Interfacce azioni ed eventi XSI
-
DMS (applicazione Web di gestione dispositivi)
-
Interfaccia CTI (Intergrazione Di Telefonia Informatica)
-
TLS 1.2 con certificato valido (non autofirmato) e qualsiasi intermediazione richiesta. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
-
Autenticazione Mutual TLS (mTLS) per il servizio di autenticazione (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
-
Autenticazione Mutual TLS (mTLS) per l'interfaccia CTI (richiede la catena di certificati del client Webex pubblico installata come ancoraggi attendibili)
-
-
Un server XSP/ADP separato che agisce come "Call Notifications Push Server" (un server NPS nel tuo ambiente utilizzato per le notifiche di chiamata push per Apple/Google. Lo chiamiamo "CNPS" qui per distinguerlo dal servizio in Webex che fornisce notifiche push per messaggi e presenza).
Questo server deve essere su R22 o versione successiva.
-
Viene richiesto un server XSP/ADP separato per CNPS poiché l'imprevedibilità del carico da Webex per le connessioni cloud BWKS potrebbe influire negativamente sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSP|ADP, vedere la Guida tecnica del sistema Cisco BroadWorks.
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, andare a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
-
PC/laptop Windows
-
PC/laptop Apple con MacOS
-
iOS (Apple Store)
-
Android (Play store)
-
Browser Web (andare a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
-
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
-
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
-
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
-
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (tradizionale cinese)
-
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
-
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
-
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
-
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
-
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (italiano)
Telefoni e accessori fisici
-
Telefoni IP Cisco:
-
Telefono IP Cisco serie 6800 con firmware multipiattaforma
-
Telefono IP Cisco serie 7800 con firmware multipiattaforma
-
Telefono IP Cisco serie 8800 con firmware multipiattaforma
Per i modelli e ulteriori informazioni, vedere https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html.
-
-
Supportiamo i telefoni di terze parti allo stesso modo di altre integrazioni BroadWorks. Tuttavia, non dispongono ancora dell'integrazione di contatti e presenza con Webex per Cisco BroadWorks.
-
Adattatori:
-
Adattatore per telefono analogico multipiattaforma Cisco ATA 191
-
Adattatore per telefono analogico multipiattaforma Cisco ATA 192
Per i modelli e ulteriori informazioni, vedere https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html.
-
-
Cuffie:
-
Cuffia Cisco serie 500
Per i modelli e ulteriori informazioni, vedere https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html.
-
-
Dispositivi Room OS:
-
Serie Webex Room e Room Kit
-
Serie Webex Desk
-
Serie Webex Board
-
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e l'assistenza dei dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivo
Di seguito sono riportati i file DTAF che devi caricare sui server delle applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia esiste un nuovo file config-wxt.xml.template
utilizzato per l'app Webex.
Per scaricare i profili dei dispositivi più recenti, andare al sito di Download software della piattaforma di consegna delle applicazioni per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che per XSP.
Nome del cliente |
Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Comunicatore aziendale - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili del dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Generare una richiesta di servizio con l'agente di onboarding o con Cisco TAC per eseguire il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il titolo della richiesta per le rispettive funzioni:
-
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
-
'NPS Configuration for Auth Proxy Setup' (Configurazione NPS per impostazione proxy automatica) per configurare NPS per l'uso del proxy di autenticazione.
-
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori informazioni su questa funzione, vedere: Supporto di Cisco BroadWorks per CI UUID.
-
Configura BroadWorks per abilitare la fatturazione Cisco per BroadWorks e Webex Per abbonamenti BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento valido per 60 giorni. Se il token scade prima di utilizzarlo, è possibile presentare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali. |
Certificati ordine
Requisiti di certificato per l'autenticazione TLS
Per tutte le applicazioni richieste, è necessario disporre di certificati di sicurezza firmati da un'autorità di certificazione ben nota e distribuiti su XSP|ADP di fronte al pubblico. Verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in entrata ai server XSP|ADP.
Questi certificati devono includere il nome di dominio pubblico completo XSP|ADP come nome comune dell'oggetto o nome alternativo dell'oggetto.
I requisiti esatti per la distribuzione di questi certificati del server dipendono da come vengono distribuiti i certificati XSP|ADP rivolti al pubblico:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy passante TLS
-
Direttamente a XSP|ADP
Il seguente diagramma riassume dove il certificato del server pubblico firmato da CA deve essere caricato in questi tre casi:
Le autorità di certificazione supportate pubblicamente dall'app Webex per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per proxy bridge TLS
-
Il certificato del server firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta questo certificato server firmato pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Un certificato firmato CA interno può essere caricato su XSP|ADP.
-
XSP|ADP presenta questo certificato del server firmato internamente al proxy.
-
Il proxy si basa sulla CA interna che ha firmato il certificato del server XSP|ADP.
Requisiti del certificato TLS per proxy passthrough TLS o XSP|ADP in DMZ
-
Il certificato del server firmato pubblicamente viene caricato negli XSP|ADP.
-
Gli XSP|ADP presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati server XSP|ADP.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca sull'interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione Mutual TLS. Il certificato CA/catena del certificato del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedi a Partner Hub, vai a
e fai clic sul collegamento per il download del certificato.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i certificati XSP|ADP rivolti al pubblico:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy passante TLS
-
Direttamente a XSP|ADP
Il seguente diagramma riassume i requisiti del certificato in questi tre casi:
Requisiti del certificato (opzione) per proxy bridge TLS
-
Webex presenta un certificato client firmato pubblicamente al proxy.
-
Il proxy considera attendibile la CA interna di Cisco che ha firmato il certificato del client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Nel proxy viene caricato anche il certificato del server XSP|ADP firmato pubblicamente.
-
Il proxy presenta il certificato del server firmato pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
Estensioni X509v3: Uso chiave estesa X509v3: 1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Il CN del certificato interno deve essere
bwcticlient.webex.com
.
-
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
-
Le autorità pubbliche di certificazione potrebbero non essere disposte a firmare i certificati con l'OIDE proprietario di BroadWorks richiesto. In caso di proxy di bridging, è possibile che si debba utilizzare una CA interna per firmare il certificato del client che il proxy presenta a XSP|ADP.
-
-
Gli XSP|ADP si fidano dell'autorità di certificazione interna.
-
Gli XSP|ADP presentano un certificato server firmato internamente.
-
Il proxy si fida della CA interna.
-
Il ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato a XSP|ADP dal proxy.
Requisiti del certificato (opzione) per proxy passthrough TLS o XSP|ADP in DMZ
-
Webex presenta un certificato client firmato dall'autorità di certificazione interna Cisco CA agli XSP|ADP.
-
Gli XSP|ADP considerano attendibile l'autorità di certificazione interna Cisco che ha firmato il certificato client. Puoi scaricare questa CA / catena da Control Hub e aggiungerla all'archivio attendibilità del proxy. Il certificato del server XSP|ADP firmato pubblicamente viene caricato anche nei server XSP|ADP.
-
Gli XSP|ADP presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati server XSP|ADP.
-
Il server applicazioni ClientIdentity contiene il CN del certificato del client firmato Cisco presentato a XSP|ADP da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene l'elenco di indirizzi IP, porte e protocolli richiesti per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle dei firewall delle regole di ingresso e uscita precedenti documentano solo le connessioni specifiche di Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico per Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e la rilevanza di ciascuna sezione per Webex per Cisco BroadWorks.
Sezione Requisiti di Rete Art. |
Rilevanza delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex |
Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud |
Informativo |
Da leggere | |
Da leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex |
Da leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione |
Opzionale |
Servizi Webex per clienti FedRAMP |
N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedi il whitepaper del firewall dell'app Webex (PDF).
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza Broadworks XSP|ADP fornita dal partner. Quando un sito o XSP|ADP non è disponibile per manutenzione pianificata o motivo non pianificato, i servizi e le app Webex possono passare a un altro sito o XSP|ADP fornito dal partner per completare una richiesta.
Topologia di rete
I Broadworks XSP|ADPs possono essere distribuiti direttamente su Internet, o possono risiedere in un DMZ frontale da un elemento di bilanciamento del carico come F5 BIG-IP. Per fornire una ridondanza geografica, gli XSP|ADP possono essere distribuiti in due (o più) centri dati, ognuno può essere preceduto da un bilanciatore di carico, ognuno con un indirizzo IP pubblico. Se gli XSP|ADP sono dietro a un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e Broadworks sembra avere solo un XSP|ADP, anche se ci sono più XSP|ADP dietro.
Nell'esempio seguente, gli XSP|ADP vengono distribuiti in due siti, Sito A e Sito B. In ogni sito sono presenti due XSP|ADP frontali di un bilanciatore di carico. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali di LB1, mentre il sito B ha XSP|ADP3 e XSP|ADP4 frontali di LB2. Solo i bilanciatori di carico sono esposti sulla rete pubblica e le XSP|ADP sono nelle reti private DMZ.
Servizi cloud Webex
Configurazione DNS
I microservizi cloud Webex devono essere in grado di trovare i server Broadworks XSP|ADP per la connessione alle interfacce Xsi, al servizio di autenticazione e al CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host XSP|ADP configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso. Se vengono restituiti più indirizzi IP, viene selezionato il primo IP nell'elenco. La ricerca SRV non è attualmente supportata.
Esempio: Il DNS A Record del partner per la scoperta del server XSP|ADP/Load Balancers bilanciato Round-Robin.
Tipo di record |
Nome |
Destinazione |
Finalità |
---|---|---|---|
R |
|
|
Punti a LB1 (Sito A) |
R |
|
|
Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Failover
Quando i microservizi Webex inviano una richiesta al servizio di bilanciamento XSP|ADP/carico e la richiesta non riesce, possono verificarsi diverse cose:
-
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un avanzamento dell'indirizzamento all'IP successivo.
-
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
-
Se non si riceve una risposta HTTP entro 2 secondi, la richiesta va in timeout e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un inoltro all'IP successivo.
Ciascuna richiesta viene provata 3 volte prima di segnalare un errore al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco degli indirizzi da provare quando si invia una richiesta a una XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna nell'elenco per provare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco bloccato. Se l'operazione va a buon fine, tale indirizzo IP viene rimosso dall'elenco bloccato.
Stato
Lo stato della connettività dei servizi Webex Cloud agli XSP|ADP o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster BroadWorks Calling, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
-
Azioni XSI
-
Eventi XSI
-
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Gli stati delle connessioni possono essere:
-
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
-
Rosso: Quando tutti gli IP nella ricerca di record sono irraggiungibili e l'interfaccia non è disponibile.
I seguenti servizi utilizzano i microservizi per connettersi agli XSP|ADP e sono influenzati dalla disponibilità dell'interfaccia XSP|ADP:
-
Accesso all'app Webex
-
Aggiornamento token app Webex
-
E-mail/autoattivazione non attendibile
-
Controllo stato servizio Broadworks
App Webex
Configurazione DNS
L'app Webex accede ai servizi Xtended Services Interface (XSI-Actions & XSI-Events) e Device Management Service (DMS) su XSP|ADP.
Per trovare il servizio XSI, l'app Webex esegue la ricerca DNS SRV per _xsi-client._tcp.<dominio xsi app webex>
. L'SRV punta all'URL configurato per gli host XSP|ADP o per i bilanciatori di carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex torna alla ricerca A/AAAA.
L'SRV può risolversi in più target A/AAAA. Tuttavia, ogni record A/AAAA deve mappare solo a un singolo indirizzo IP. Se sono presenti più XSP|ADP in un DMZ dietro il dispositivo di bilanciamento del carico/bordo, è necessario che il bilanciatore di carico sia configurato per mantenere la persistenza della sessione in modo da indirizzare tutte le richieste della stessa sessione allo stesso XSP|ADP. Questa configurazione è stata avviata perché i heartbeat evento XSI del client devono andare alla stessa XSP|ADP utilizzata per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non deve esistere. Se il DNS richiede che un record A/AAAA deve essere definito, allora deve essere restituito solo 1 indirizzo IP. Indipendentemente da ciò, il valore SRV deve essere ancora definito per l'app Webex. Se l'app Webex utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client alla fine invia heartbeat a una XSP|ADP in cui non ha stabilito un canale evento. Di conseguenza, il canale viene strappato e anche il traffico interno significativamente più elevato che compromette le prestazioni del cluster XSP|ADP. Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca di record A/AAAA, è necessario utilizzare un nome di dominio completo separato per Webex Cloud e l'app Webex per accedere ai propri XSP|ADP. Come mostrato negli esempi, Webex Cloud utilizza Un record |
Esempio 1—Più XSP|ADP, ciascuno dietro diversi bilanciatori di carico
In questo esempio, SRV punta a disattivare l'audio dei record A con ogni record A che punta a un bilanciatore di carico diverso su un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito un esempio di record SRV.
Tipo di record |
Registra |
Destinazione |
Finalità |
---|---|---|---|
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
R |
|
|
Indica LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Esempio 2—Più XSP|ADP dietro un singolo bilanciatore di carico (con bridge TLS)
Per la richiesta iniziale, il bilanciatore di carico seleziona un XSP|ADP casuale. Che XSP|ADP restituisca un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il bilanciatore di carico utilizza il cookie per indirizzare la connessione alla XSP|ADP corretta, assicurandosi che il canale dell'evento non si interrompa.
Tipo di record |
Registra |
Destinazione |
Finalità |
---|---|---|---|
SRV |
|
|
Bilanciatore di carico |
R |
LB.esempio.com |
|
Indirizzo IP del bilanciatore di carico (XSP|ADPs sono dietro il bilanciatore di carico) |
URL DMS
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il file di configurazione. Viene eseguita l'analisi dell'organizzatore nell'URL e l'app Webex eseguirà la ricerca DNS A/AAAA dell'organizzatore per connettersi a XSP|ADP che ospita il servizio DMS.
Esempio: DNS Un record per la scoperta del server XSP|ADP bilanciato rivolto a Internet Round-Robin/Bilanciamento del carico da Webex App per scaricare i file di configurazione tramite DMS:
Tipo di record |
Nome |
Destinazione |
Finalità |
---|---|---|---|
R |
|
|
Indica LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. |
Come l'app Webex trova gli indirizzi XSP|ADP
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
-
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (sono stati inseriti quando si crea il cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue la ricerca SRV nel modo seguente:
-
Il client esegue una ricerca SRV per _xsi-client._tcp.<dominio xsi>
-
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
-
Il cliente cerca gli obiettivi A/AAAA e memorizza nella cache gli indirizzi IP restituiti.
-
Il client si connette a uno dei target (e quindi al suo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi al peso (o a caso se sono tutti uguali).
-
-
Se la ricerca SRV non restituisce alcun obiettivo:
Il client esegue la ricerca A/AAAA del parametro principale Xsi e quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso.
Come indicato, il record A/AAAA deve risolversi in un indirizzo IP per le stesse ragioni.
-
-
(Opzionale) Successivamente, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocolli> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
-
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
-
Se esistono, il client confronterà l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
-
Se viene rilevata una differenza, il client re-inizializzerà la connettività XSI Actions/XSI Events. Il primo passo consiste nell'eseguire lo stesso processo di ricerca DNS elencato al passaggio 1, questa volta richiedendo una ricerca per il valore nel parametro %XSI_ROOT_WXT% dal relativo file di configurazione.
Assicurarsi di creare i record SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
-
Failover
Durante l'accesso, l'app Webex esegue una ricerca DNS SRV per _xsi-client._tcp.<dominio xsi>, crea un elenco di host e si connette a uno degli host in base alla priorità SRV, quindi al peso. Questo organizzatore connesso diventa quello selezionato per tutte le richieste future. Viene quindi aperto un canale evento all'organizzatore selezionato e viene inviato regolarmente un heartbeat per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP, pertanto è importante che il bilanciatore di carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server XSP|ADP di backend.
Se una richiesta o una richiesta heartbeat a un organizzatore non riesce, possono verificarsi diverse cose:
-
Se l'errore è dovuto a un errore di rete (es., TCP, SSL), l'indirizzamento dell'app Webex viene eseguito immediatamente all'organizzatore successivo nell'elenco.
-
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e l'indirizzamento passa all'organizzatore successivo nell'elenco.
-
Se una risposta non viene ricevuta entro un periodo di tempo, la richiesta viene considerata non riuscita a causa del timeout e le richieste successive vengono inviate al successivo organizzatore. Tuttavia, la richiesta scaduta viene considerata come non riuscita. Alcune richieste vengono riprovate dopo l'errore (con un tempo di riprova crescente). Le richieste che il presunto non vitale non sono riprovate.
Quando un nuovo organizzatore viene provato correttamente, diventa il nuovo organizzatore selezionato se l'organizzatore è presente nell'elenco. Una volta provato l'ultimo organizzatore nell'elenco, l'app Webex passa al primo.
In caso di heartbeat, se si verificano due errori di richiesta consecutivi, l'app Webex re-inizializzerà il canale eventi.
Tenere presente che l'app Webex non esegue il failback e che il rilevamento del servizio DNS viene eseguito solo una volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione attraverso l'interfaccia XSP|ADP/Dms. Esegue una ricerca di record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Innanzitutto, tenterà di inviare la richiesta per scaricare il file di configurazione utilizzando un token SSO. Se ciò non riesce per qualsiasi motivo, verrà riprovato ma con il nome utente e la password del dispositivo.
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning dell'utente. Molte delle attività sono comuni a tutte le modalità di provisioning.
Onboarding dei partner per Webex per Cisco BroadWorks
Ciascun provider o rivenditore di servizi Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, è necessario eseguire la documentazione Cisco BroadWorks di Webex e i nuovi partner devono accettare l'ICPA (Indirect Channel Partner Agreement) online. Al termine di queste operazioni, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, il tuo Partner Activation e/o Customer Success Program Manager ti contatterà per iniziare il tuo onboarding.
I partner Webex in una regione possono creare organizzazioni di clienti in qualsiasi regione che offriamo i servizi. Per informazioni, vedere: Residenza dati in Webex. |
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
È necessario eseguire l'applicazione NPS su un'altra XSP|ADP. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni / servizi sui vostri XSP|ADP.
Servizio/Applicazione |
Autenticazione richiesta |
Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
Autenticazione utente |
Integrazione telefonia computer |
mTLS (client e server si autenticano a vicenda) |
Presenza di telefonia |
Applicazione Webview Impostazioni chiamata |
TLS (il server esegue l'autenticazione per i client) |
Mostra le impostazioni di chiamata utente nel portale Assistenza utente all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma occorre fare riferimento alla documentazione esistente per installare le applicazioni su XSP|ADP.
Requisiti di coresidenza
-
Il servizio di autenticazione deve essere coresidente con le applicazioni Xsi, perché tali interfacce devono accettare token di lunga durata per l'autorizzazione del servizio. Il servizio di autenticazione è richiesto per convalidare tali token.
-
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
-
È possibile separare gli altri servizi/applicazioni come richiesto per la propria bilancia (gestione dispositivi dedicata XSP|ADP farm, ad esempio).
-
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
-
Non installare altre applicazioni o servizi su XSP|ADP utilizzati per integrare BroadWorks con Webex.
-
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se è in esecuzione R22 o versione superiore e il sistema lo supporta.
Mutual TLS (mTLS) è supportato anche come metodo di autenticazione alternativo per il servizio Auth. Se più organizzazioni Webex eseguono lo stesso server XSP|ADP, è necessario utilizzare l'autenticazione mTLS poiché la convalida token CI non supporta più connessioni allo stesso servizio autenticazione XSP|ADP. Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida del token CI, fare riferimento all'Appendice per configurare i servizi (con mTLS per il servizio di autenticazione). |
Se attualmente si utilizza mTLS per il servizio autenticazione, non è obbligatorio riconfigurare l'uso della convalida token CI con TLS. |
-
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks.
-
Installare le seguenti patch su ciascun server XSP|ADP. Installare le patch appropriate alla release in uso:
-
Per R22:
-
Per R23:
-
Per R24: non è necessario alcun cerotto
Qualsiasi riferimento a XSP include XSP o ADP. -
-
Installare l'applicazione
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP nel percorso del contesto /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> attivazione dell'applicazione AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire il servizio di autenticazione su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> applicazione di distribuzione /authServiceBroadWorks SW Manager distribuzione /authService...
-
A partire da Broadworks build 2022.10, le autorità di certificazione in arrivo con Java non vengono più automaticamente incluse nel trust store BroadWorks quando si passa a una nuova versione di java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
-
IdenTrust radice commerciale CA 1
-
Go Daddy Root Certificate Authority - G2
Verificare che questi certificati siano presenti sotto la seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get
Se non presente, eseguire il seguente comando per importare i trust Java predefiniti:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come ancoraggi attendibili con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trust/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono automaticamente importate nella nuova release e continueranno a essere importate finché non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere la FD di convalida del certificato Cisco Broadworks X509.
-
-
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get
-
set clientId client-Id-Da-Step1
-
impostazione abilitata true
-
set clientSecret client-Secret-From-Step1
-
set ciResponseBodyMaxSizeInBytes 65536
-
set issuerName <URL>
—Per l'URL
, immettere l'URL IssuerName applicabile al cluster CI. Vedere la tabella seguente. -
set issuerUrl <URL>
: per l'URL
, immettere l'IssuerUrl applicabile al cluster CI. Vedere la tabella seguente. -
set tokenInfoUrl <IdPProxy URL>
—Inserisci l'URL proxy IdP che si applica al cluster Teams. Si veda la seconda tabella che segue.
Tabella 1. Imposta nome emittente e URL emittente Se il cluster CI è... Imposta issuerName e issuerURL su... Stati Uniti
UE
USA-B
Se non conosci il tuo cluster CI, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.Tabella 2. Imposta tokenInfoURL Se il cluster di Teams è... Imposta tokenInfoURL su...(URL proxy IdP) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AFRA
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
-
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.
-
Per il test, è possibile verificare che il tokenInfoURL sia valido sostituendo la parte "
idp/authenticate
" dell'URL con "ping
".
-
-
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> imposta scope broadworks-connector:user
-
Configurare i provider di identità per Cisco Federation utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get
-
impostare flsUrl https://cifls.webex.com/federation
-
impostazione refreshPeriodInMinutes 60
-
impostazione refreshToken refresh-Token-From-Step1
-
-
Eseguire il seguente comando per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get
-
Configurare Gestione token utilizzando i seguenti comandi su ciascun server XSP|ADP:
-
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
-
set tokenIssuer BroadWorks
-
imposta tokenDurationInHours 720
-
-
Genera e condividi chiavi RSA. È necessario generare le chiavi su un XSP|ADP, quindi copiarle su tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP.-
Selezionare un XSP|ADP da utilizzare per generare una coppia di tasti.
-
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
-
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
-
Copiare il file esportato
/var/broadworks/tmp/authService.keys
nella stessa posizione sugli altri XSP|ADP, sovrascrivendo un file meno recente.keys
se necessario. -
Importare le chiavi su ciascuno degli altri XSP|ADP:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
-
-
Fornire l'URL authService al contenitore Web. Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token. Su ciascuno degli XSP|ADP:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
impostare l'url http://127.0.0.1/authService
-
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> aggiungi tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Controllare il parametro con
get
. -
Riavviare XSP|ADP.
-
Rimozione dei requisiti di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con la convalida del token CI su R24, è necessario rimuovere anche il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> impostare <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
-
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Immettere il comando
get
e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
-
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocol>
-
Immettere il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati in questa interfaccia. -
Immettere il comando
Aggiungi <interfaceIp> 443 TLSv1.2
per assicurarsi che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
-
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Immettere il comando
get <interfaceIp> 443
per visualizzare le crittografie già utilizzate in questa interfaccia. Deve essere presente almeno una delle suite consigliate Cisco (vedere XSP|ADP Requisiti di identità e sicurezza nella sezione Panoramica). -
Immettere il comando
Aggiungi <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, utilizzare:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>aggiungere 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per trovare la suite in base al nome.
Configurazione di Gestione dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Interfaccia CTI e configurazione correlata
Di seguito viene elencato l'ordine di configurazione "da più a più". In seguito a questo ordine non è obbligatorio.
-
Configurazione del server di applicazione per gli abbonamenti CTI
-
Configurazione di XSP|ADPs per abbonamenti CTI autenticati mTLS
-
Apertura delle porte in entrata per l'interfaccia CTI protetta
-
Abbonamento dell'organizzazione Webex agli eventi CTI di BroadWorks
Configurazione del server di applicazione per gli abbonamenti CTI
Aggiornare ClientIdentity su Application Server con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ciascun server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> aggiungi bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è |
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità |
Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) |
XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocol> |
Una specifica interfaccia CTI su questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocol> |
Su una nuova installazione, le seguenti crittografie sono installate per impostazione predefinita a livello di sistema. Se non è configurato nulla a livello di interfaccia (ad esempio, nell'interfaccia CTI o HTTP), si applica questo elenco di crittografia. Si noti che questo elenco può cambiare nel tempo:
|
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Immettere il comando
get
e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocol>
-
Immettere il comando
ottenere <interfaceIp>
per vedere quali protocolli sono già utilizzati in questa interfaccia. -
Immettere il comando
Aggiungi <interfaceIp> TLSv1.2
per assicurarsi che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
-
Immettere il comando
get
per visualizzare le crittografie già utilizzate in questa interfaccia. Deve essere presente almeno una delle suite consigliate Cisco (vedere XSP|ADP Requisiti di identità e sicurezza nella sezione Panoramica). -
Immettere il comando
Aggiungi <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, utilizzare:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> aggiungere 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per trovare la suite in base al nome.
Ancoraggi affidabili per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che gli XSP|ADP siano rivolti verso internet o rivolti verso internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy bridge (vedere Requisiti del certificato TLS per proxy bridge TLS).
Per ogni XSP|ADP nell'infrastruttura che pubblica eventi CTI in Webex, effettuare le seguenti operazioni:
-
Accedi a Partner Hub.
-
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli XSP|ADP. Tutti i file sono obbligatori.
-
Dividere la catena del certificato in due certificati -
combinedcertchain2023.txt
-
Aprire
combinedcertchain2023.txt
in un editor di testo. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
, e incollare il blocco di testo in un nuovo file. -
Salvare il nuovo file come
root2023.txt
. -
Salvare il file originale come
emissione2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----START CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
-
Accedere a XSP|ADP e passare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
-
(Opzionale) Eseguire la
guida updateTrust
per visualizzare i parametri e il formato di comando. -
Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot2023
ewebexclientissuing2023
sono esempi di alias per i trust anchors; puoi utilizzare il tuo se tutte le voci sono univoche. -
Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[autofirmato]
-
Consenti ai client di autenticarsi con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> impostazione allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
-
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione BroadWorks in uso. Il comando crea un certificato server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> aggiungi <Interface IP> 8012 true true true
-
-
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. È necessario l'indirizzo IP dell'interfaccia CTI per questo; è possibile leggerlo dal seguente contesto:
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>
-
-
Riavviare XSP|ADP.
Abilitazione dell'accesso a BroadWorks CTI Events su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
-
Specificare l'indirizzo CTI in base al quale Webex può iscriversi a CTI Events di BroadWorks.
-
Gli abbonamenti CTI sono su base per abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato viene predisposto per Webex per Cisco BroadWorks.
Visualizzazione Webview Impostazioni chiamata
Call Settings Webview (CSWV) è un'applicazione ospitata su XSP|ADP per consentire agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview per le impostazioni di chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono native dell'app Webex.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, è necessario distribuire la funzione Webview impostazioni chiamata.
La vista Webview Impostazioni chiamata presenta due componenti:
-
Applicazione Webview Impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
-
App Webex, che esegue il rendering delle impostazioni di chiamata in una vista Webview.
Esperienza utente
-
Utenti Windows: Fai clic su Impostazioni chiamata, quindi su .
-
Utenti Mac: Fare clic sull'immagine del profilo, quindi su
.
Distribuzione di CSWV su BroadWorks
Installazione di Webview impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sulla stessa XSP|ADP che ospita l'interfaccia Xsi-Actions nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
-
Accedere a cisco.com e cercare "BWCallSettingsWeb" nella sezione download software.
-
Trovare e scaricare la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) è stata la più recente al momento della scrittura. -
Installare, attivare e distribuire l'archivio Web in base alla Guida alla configurazione della piattaforma di servizi Cisco BroadWorks Xtended per la versione XSP|ADP. (La versione R24 è https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
-
Copiare il file .war in una posizione temporanea su XSP|ADP, come
/tmp/
. -
Passare al seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> Installa applicazione /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
-
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più necessario). -
Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> attiva applicazione BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario fornire anche un contextPath perché è un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio,
/callsettings
. -
Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> Distribuzione di applicazioni/impostazioni di richiamata
-
-
Ora è possibile prevedere l'URL delle impostazioni di chiamata che si specificherà per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
-
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
-
XSP|ADP-FQDN deve corrispondere al FQDN azioni Xsi, perché CSWV deve utilizzare le azioni Xsi e CORS non è supportato.
-
-
Ripetere questa procedura per gli altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview Impostazioni chiamata è ora attiva su XSP|ADP.
Configura l'app Webex per utilizzare Webview impostazioni chiamata
Per ulteriori dettagli sulla configurazione del client, vedere la Guida alla configurazione di Webex per Cisco BroadWorks.
Nel file di configurazione dell'app Webex è presente un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti attraverso l'interfaccia dell'applicazione.
<config> <services> <web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%"> <url>%WEB_CALL_SETTINGS_URL_WXT%</url> </web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel tag %WEB_CALL_SETTINGS_URL_WXT%.
Se non si specifica esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
-
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
-
Imposta destinazione impostazioni chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
-
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.example.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
-
Il file di configurazione client risultante dovrebbe avere una voce come segue:
<web-call-settings target="csw"> <url>https://yourxsp.esempio.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push delle chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Call Notifications Push Server (CNPS) per descrivere un'applicazione ospitata XSP o ospitata ADP che viene eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti e invia le notifiche a Google Firebase Cloud Messaging (FCM) o Apple Push Notification Service (APN).
Tali servizi notificano ai dispositivi mobili degli abbonati Webex per Cisco BroadWorks la presenza di chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzione Notification Push Server.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi a loro volta notificano agli utenti mobili Webex le modifiche ai messaggi in arrivo o alla presenza.
In questa sezione viene descritto come configurare l'NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se è necessario eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPS https://help.webex.com/nl5rir2/. |
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario aggiornare il CNPS per supportare la funzione proxy NPS, server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server di notifica push per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e i tasti di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend di Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APN Apple e i servizi FCM Google.
La funzione migliora anche la capacità del server push delle notifiche di eseguire notifiche push ai dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
-
Per ulteriori informazioni, vedere Server push per VoIP nella descrizione della funzione UCaaS.
-
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software e le patch NPS, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Cercare e scaricare la patch dalla pagina di download del software.
-
Ulteriori informazioni sul server ADP sono disponibili su https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio Apple Push Notification dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per APN. Questo aggiornamento richiede che XSP|ADP che ospita l'NPS esegua R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 |
Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma di consegna dell'applicazione (ADP). | ||
2 |
Installare le patch proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: | ||
3 |
Attivare l'applicazione Notification Push Server. | ||
4 |
(Per le notifiche Android) Abilitare l'API FCM v1 sull'NPS.
| ||
5 |
(Per le notifiche Apple iOS) Abilitare HTTP/2 su NPS.
| ||
6 |
Collegare un supporto tecnico dell'NPS XSP/ADP. | ||
7 |
Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN UN 10.193.78.149
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configura NPS per utilizzare il proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Migra NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un NPS condiviso con altre app mobili, vedere Aggiornamento di Cisco BroadWorks NPS per utilizzare il proxy NPS ( https://help.webex.com/nl5rir2).
1 |
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 |
Creare l'account cliente su NPS:
Per verificare che i valori inseriti corrispondano a quanto ricevuto, eseguire
| |||||||||||||||||||
3 |
Immettere l'URL proxy NPS e impostare l'intervallo di aggiornamento del token (consigliato 30 minuti):
| |||||||||||||||||||
4 |
(Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 |
(Per le notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, assicurandosi di omettere il tasto Auth – impostarlo su vuoto.
| |||||||||||||||||||
6 |
Configurare i seguenti URL NPS:
| |||||||||||||||||||
7 |
Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 |
Verificare se il server applicazioni sta eseguendo lo screening degli ID applicazione, poiché potrebbe essere necessario aggiungere le app Webex all'elenco utenti autorizzati: | |||||||||||||||||||
9 |
Riavviare XSP|ADP: | |||||||||||||||||||
10 |
Esegui test delle notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migrazione di NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente che è necessario eseguire la migrazione a FCMv1. Sono previste tre procedure:
-
Esegui migrazione dei client UC-One a FCMv1: quando disponi di client UCaaS esistenti e devi migrarli per utilizzare FCMv1.
-
Migrazione dei client SaaS a FCMv1: quando si dispone di client SaaS esistenti e occorre migrarli per utilizzare FCMv1.
-
Aggiorna server ADP: quando si esegue la migrazione di NPS a un server ADP.
Migrazione dei client UC-One a FCMv1
Utilizzare la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella console FCM, vedere . L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per ulteriori informazioni, consultare la Guida al branding mobile di Connect all'indirizzo https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al parametro
|
-
Accedere a SDK amministratore FCM all'indirizzo http://console.firebase.google.com.
-
Selezionare l'applicazione Android appropriata.
-
Nella scheda General (Generale), registrare l’ID del progetto
-
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
-
Fare clic sul pulsante blu per creare un nuovo account di servizio
-
Fai clic sul pulsante blu per generare una nuova chiave privata
-
Chiave di download per una posizione sicura
Per riutilizzare un account servizio esistente:
-
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
-
Identificare l'account servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
-
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
-
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
-
-
Copiare il file json su XSP|ADP.
-
Configurare l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> aggiungi <project id> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> ottieni Project ID Accountkey ======================== my_project ********
-
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> aggiungi <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> ottieni ID applicazione progetto ============================== my_app my_project
-
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Enabled true ...Done
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP.
Migrazione dei clienti SaaS a FCMv1
Se si desidera eseguire la migrazione dei client SaaS a FCMv1, attenersi alla procedura seguente su Google FCM Console.
Assicurarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione". |
-
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Enabled false ...Done
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP. -
Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Enabled true ...Done
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP.
Aggiorna server ADP
Se si esegue la migrazione dell'NPS per utilizzare un server ADP, utilizzare i passaggi seguenti nella console Google FCM.
-
Ottenere il file JSON dalla console cloud di Google:
-
Su Google Cloud Console, andare alla pagina Account servizio.
-
Fare clic su Seleziona un progetto, scegliere il progetto e fare clic su Apri.
-
Trova la riga dell'account servizio per la quale desideri creare una chiave, fai clic sul pulsante Altro verticale, quindi fai clic su Crea chiave.
-
Selezionare un tipo di chiave e fare clic su Crea
Il file viene scaricato.
-
-
Aggiungere FCM al server ADP:
-
Importare il file JSON nel server ADP utilizzando il comando
/bw/install
. -
Accedere all'ADP CLI e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON
: -
Quindi, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> aggiungi com.broadsoft.ucaas.connect projectId connect-ucaas...Done
-
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas
-
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò avviene per i seguenti motivi:
-
Per consentire a Webex cloud di autenticare i tuoi utenti rispetto a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
-
Per consentire alle app Webex di utilizzare l'interfaccia Xsi per il controllo delle chiamate.
-
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se alcune interfacce non vengono convalidate correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide. Ciò viene impedito poiché un cluster configurato in modo errato potrebbe causare problemi che sono difficili da risolvere. |
Cosa è necessario fare:
-
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
-
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Se l'utente amministratore non ha visibilità delle impostazioni di BroadWorks Calling , si consiglia di aprire un caso con Cisco TAC.
-
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
-
Assegna un nome al cluster e fai clic su Avanti.
Il concetto di cluster qui è semplicemente una raccolta di interfacce, solitamente collocate su un server XSP|ADP o in una farm, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il sistema BroadWorks non sono applicabili qui.
-
(Opzionale) Immettere un Nome account utente e una Password BroadWorks noti all'interno del sistema BroadWorks che si connette a Webex, quindi fare clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
-
Aggiungere gli URL XSI Actions e XSI Events.
-
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
-
Opzionale. Selezionare la casella di controllo Abilita autenticazione diretta BroadWorks se si desidera che gli accessi a BroadWorks siano diretti a BroadWorks. In caso contrario, l'autenticazione per BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo influisce su queste situazioni di accesso:
-
Accesso al portale di attivazione utente: gli utenti devono immettere le credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o attraverso il proxy IdP.
-
Accesso client: se l'autenticazione BroadWorks è configurata nel modello di onboarding, l'impostazione precedente determina se l'accesso del client all'app Webex è diretto a BroadWorks o viene proxy attraverso il proxy IdP.
-
-
Fai clic su Avanti.
-
Nella pagina CTI Interface (Interfaccia CTI) procedere come segue:
-
Aggiungere l'URL CTI e la porta per l'interfaccia CTI a cui si desidera connettersi.
-
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
-
Opzionale. Abilita il tasto di alternanza Non disturbare (NoDist) e inserisci l'ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurandosi che la funzione funzioni allo stesso modo su entrambe le piattaforme.
-
Fai clic su Avanti.
-
-
Aggiungere l'URL del servizio di autenticazione.
-
Selezionare Servizio autenticazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex poiché il servizio di autenticazione convalida correttamente il token utente rispetto al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
-
Controllare le voci sulla schermata finale, quindi fare clic su Crea. Dovrebbe essere visualizzato un messaggio di successo.
Partner Hub passa gli URL a vari microservizi Webex che testano le connessioni alle interfacce fornite.
-
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è riuscita.
-
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Abbiamo implementato questa verifica per prevenire errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, caricatore di bilanciamento o firewall) come documentato in questa guida, prima di salvare il modello.
Verifica delle connessioni alle interfacce BroadWorks
-
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
-
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
-
Fare clic su Visualizza cluster.
-
Partner Hub avvia i test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina dell'elenco dei cluster mostra il messaggio di stato accanto a ciascun cluster.
I messaggi verdi relativi al successo dovrebbero essere visualizzati. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
-
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio XSI-Actions, XSI-Events, DAS URL e le impostazioni dell'interfaccia CTI.
Configurazione dei modelli di onboarding
I modelli di onboarding sono il modo in cui verrà applicata la configurazione condivisa a uno o più clienti man mano che vengono caricati tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma solo un modello può essere associato a un cliente.
-
Accedere a Partner Hub e selezionare Clienti.
-
Fare clic sul pulsante Modelli di onboarding per visualizzare i modelli esistenti.
-
Fare clic su Crea modello.
-
Nella finestra Dettagli modello, aggiungere il nome del modello, il paese o la regione e la lingua e-mail predefinita.
-
Fare clic sull'elenco a discesa per l'ID abbonamento CCW, individuare gli abbonamenti elencati per il partner e selezionare l'abbonamento applicabile.
Questo campo viene visualizzato solo per i partner migrati da Webex per BroadWorks a Webex. -
Nella finestra Impostazione servizio, utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
-
Immettere un Nome modello, quindi fare clic su Avanti.
-
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per diverse modalità di provisioning Impostazione del nome
Provisioning fluviale con e-mail attendibili
Provisioning flowthrough senza e-mail
Self-provisioning utente
Abilita flusso BroadWorks attraverso il provisioning (include le credenziali dell'account di provisioning se attivato**)
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Attivato
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Disattivato
Creazione automatica di nuove organizzazioni in Control Hub
Il †
Il †
Il †
Indirizzo e-mail provider di servizi
Selezionare un indirizzo e-mail dall'elenco a discesa (è possibile digitare alcuni caratteri per trovare l'indirizzo, se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello di onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature tra paese e regione in questo foglio di calcolo.
Il paese dell'organizzazione determina i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni consultare la sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questo interruttore spento.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note dalla tabella:
-
† Questo passaggio garantisce che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa opzione deve essere sempre attiva, a meno che non si utilizzi un processo manuale di ordinazione ed esecuzione (tramite Cisco Commerce Workspace) per creare le organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello di "provisioning ibrido" e non rientra nel campo di applicazione di questo documento.
-
** "Account di provisioning" si riferisce all'account amministratore a livello di sistema BroadWorks. Su BroadWorks, è necessario un account amministratore con questi attributi: Tipo amministratore=Provisioning, sola lettura=Disattivato.
-
-
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
-
Opzionale. Selezionare Disabilita chiamata gratuita Cisco Webex se si desidera disabilitare le chiamate Webex.
-
Per la configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
-
Numeri di chiamata in ingresso Cisco (PSTN)
-
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
-
-
Fai clic su Avanti.
-
Esistono due approcci per il provisioning degli abbonati relativamente a come vengono verificate le relative identità, utilizzando e-mail attendibili o e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile, gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. In qualità di partner, sei responsabile del provisioning dell'indirizzo e-mail come parte del metodo flow-through o API.
Si consiglia vivamente di utilizzare il metodo di provisioning attendibile poiché garantisce che tutti gli abbonati siano completamente predisposti dall'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso e-mail non attendibile, gli utenti devono verificare i relativi messaggi e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Impostazione del nome
Provisioning flowthrough senza e-mail
Self-provisioning utente
Esegui prima provisioning amministratore
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
-
Note dalla tabella:
-
* Ciascuna organizzazione cliente in Webex deve disporre di almeno un utente con ruolo di amministratore. Il primo utente a cui assegnare IM&P integrato in BroadWorks assume il ruolo di amministratore del cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di fornitore di servizi è possibile avere il controllo su chi ottiene il ruolo. La verifica di questa impostazione impedisce agli utenti di completare l'attivazione fino a quando non viene attivato il primo utente fornito. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
-
-
Fai clic su Avanti.
-
Selezionare la modalità di autenticazione predefinita (autenticazione BroadWorks o autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.(Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
-
Fai clic su Avanti.
-
Per Preferenze, configurare quanto segue:
-
Scegliere se si desidera Precompilare gli indirizzi e-mail utente nella pagina di accesso.
Utilizzare questa opzione solo dopo aver selezionato Autenticazione BroadWorks e aver anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il nome utente BroadWorks. La pagina di accesso offre l'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
-
Se desideri abilitare la sincronizzazione delle rubriche, imposta Abilita sincronizzazione delle rubriche telefoniche per tutte le nuove organizzazioni cliente e attiva Attiva.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
-
Immettere un amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatico di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
-
Assicurati che l'opzione Consenti invito e-mail amministratore quando ti colleghi a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
-
Fai clic su Avanti.
-
Esaminare le voci nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Dovrebbe essere visualizzato un messaggio di successo.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con altri modelli.
-
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario immettere nuovamente i dettagli dell'account di provisioning. I campi Password vuota/Conferma password sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori forniti alla procedura guidata.
Aggiungi altri modelli se disponi di diverse configurazioni condivise che desideri fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbe essere necessario specificare i dettagli del modello per una delle attività seguenti.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning. |
Patch Application Server (solo R22, R23 e R24)
-
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
-
Per R22:
AP.as.22.0.1123.ap373197
-
Per R23:
AP.as.23.0.1075.ap373197
-
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che formano il requisito per la distribuzione di Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella sezione Riferimento. -
-
Passare al contesto
Maintenance/ContainerOptions
. -
Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> aggiungi provisioning bw.imp.useProvisioningUrl true
Scarica gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interfaccia > Messaggistica e Servizio > IM&P integrato) dei comandi AS.
-
Accedi a Partner Hub e vai a
. -
Fare clic su Visualizza modelli.
-
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro flyout a destra. Se non è stato ancora creato un modello, è necessario farlo prima di poter ottenere l'URL di provisioning.
-
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per altri modelli se si dispone di più modelli.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema su server applicazioni
Se si utilizza UC-One SaaS, potrebbe non essere necessario impostare il provisioning e il dominio del servizio a livello di sistema. Vedere i Punti di decisione nella sezione Preparazione dell’ambiente. |
-
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
-
AS_CLI/Interface/Messaging> impostazione provisioningUrl provisioningURL
-
AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name
-
AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password
-
AS_CLI/Interface/Messaging> imposta enableSynchronization true
-
-
Attivare l'interfaccia IMP integrata:
-
/AS_CLI/Service/IntegratedIMP> set serviceDomain example.com
-
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> imposta userAttrIsActive true
-
È necessario immettere il nome completo per il parametro |
(Opzione) Configurazione dei parametri di provisioning per azienda su server applicazioni
-
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
-
Selezionare Usa dominio di servizio e immettere un valore fittizio (Webex ignora questo parametro). È possibile utilizzare
example.com
). -
Selezionare Usa server di messaggistica.
-
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
È necessario immettere il nome completo per il parametro
provisioningURL
, come fornito in Partner Hub. Se il server applicazioni non può accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel file/etc/host
sul server AS. -
Nel campo Nome utente, immettere un nome per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
-
Immettere una password per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
-
Per Identità utente predefinita per ID IM&P, selezionare Principale.
-
Fare clic su Applica.
-
Ripeti per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning utente, vedi Provisioning utente provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning aiuta amministratori e team di vendita controllando la presenza di errori prima di eseguire il provisioning di un cliente o abbonato per un pacchetto. Gli utenti o le integrazioni autorizzati da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per assicurarsi che non vi siano conflitti o errori con il provisioning dei pacchetti per un determinato cliente o abbonato.
L'API verifica se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto per un cliente o un partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, è possibile correggere gli errori prima del provisioning, aumentando la probabilità di un provisioning riuscito.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore Webex per la vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare di un provisioning abbonato all'ingrosso
Per accedere a Precontrolla un documento di provisioning abbonato Wholesale, devi accedere a https://developer.webex.com/ portal. |
Partner SSO - SAML
Consente agli amministratori dei partner di configurare l'SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La seguente procedura SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere la funzionalità SSO del partner a un'organizzazione cliente esistente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso. |
-
Verificare che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'integrazione Single Sign-On in Control Hub.
-
Carica il file di metadati CI con provider di identità.
-
Configurare un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, immettere l'ID entità dall'XML metadati SAML del provider di identità di terze parti.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
-
Proprio che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori dei partner di configurare l'SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per impostare SSO OIDC partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già caricate utilizzando il modello. |
-
Aprire una richiesta di servizio con il centro TAC di Cisco con i dettagli dell'IDP di connessione OpenID. Sono obbligatori e facoltativi gli attributi IDP. TAC deve impostare l'IDP sull'IC e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC, potrebbe consistere in lettere, numeri, trattini, sottolineature, inclinazioni e punti e la lunghezza massima è 128 caratteri.
Id client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Segreto client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco degli ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio, ad esempio "profilo e-mail openid" Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non fornito
URL dell'endpoint di autorizzazione OAuth 2.0 dell'IdP.
endpoint token
Sì se discoveryEndpoint non fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
endpoint infoutente
No
URL dell'endpoint UserInfo di IdP.
Endpoint set di tasti
No
URL dell'endpoint JSON Web Key Set dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
-
Configurare l'URI di reindirizzamento sull'IDP di connessione OpenID.
-
Configurare un modello di onboarding. Per l'impostazione della modalità di autenticazione, selezionare Autenticazione partner Con OpenID Connect e immettere il nome IDP fornito durante l'impostazione IDP come ID entità IDP OpenID Connect.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
-
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui registrazione chiamata, risposta per assente di gruppo, dirigente e assistente di direzione.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
-
Eseguire i seguenti comandi sulle interfacce AS. Ciò consentirà all'AS di inviare l'intestazione SIP
X-BroadWorks-Correlation-Info
:AS_CLI/Interface/SIP> imposta sendCallCorrelationIDNetwork vero
AS_CLI/Interface/SIP> imposta sendCallCorrelationIDAccess true
-
Il parametro
enableCallCorrelationID
associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione delle informazioni sulla correlazione delle chiamate nei registri Xsi-Actions. Si consiglia di abilitareenableCallCorrelationID
utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>Impostazione enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione dell'identificativo di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubrica
La sincronizzazione della rubrica garantisce che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la directory di chiamata completa dal server BroadWorks viene sincronizzata con la directory Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione rubriche, vai a Sincronizzazione rubriche in Webex per Cisco BroadWorks.
Webex per il provisioning flowthrough di Cisco BroadWorks aggiunge utenti di messaggistica e informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, gli elenchi telefonici, gli utenti non di messaggistica e le entità non utenti non sono inclusi (ad esempio, un telefono della sala conferenze, un fax o un numero di gruppo di risposta). L'attivazione della sincronizzazione delle rubriche garantisce che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex. |
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia chiamate e riunioni unificate Webex visualizzata sull'app Webex. Gli utenti possono visualizzare la cronologia dettagliata delle chiamate e della riunione dall'app Webex.
La cronologia chiamate unificata può essere abilitata dagli amministratori a livello di partner in Partner Hub su base cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
-
Eventi cronologia chiamate: questi eventi vengono utilizzati per creare una cronologia chiamate unificata dettagliata
-
Eventi di stato hook: la cronologia chiamate unificata include ottimizzazioni dello stato hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di Telephony Presence
Requisiti della cronologia chiamate unificata
Prima di configurare la cronologia chiamate unificata, accertarsi di aver eseguito la patch del sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
-
AP.as.22.0.1123.ap378585
: dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> attiva 25433
Per R23:
-
AP.as.23.0.1075.ap378585
: dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> attiva 25433
-
Se si utilizza XSP—
AP.xsp.23.0.1075.ap378585
-
Se si utilizza ADP—
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
-
AP.as.24.0.944.ap378585
: dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> attiva 25433
Per l'elenco completo delle patch BroadWorks che è necessario installare come prerequisito per l'esecuzione di Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella sezione Riferimento. |
Oltre alla patch del sistema, il file di configurazione client (config-wxt.xml
) deve avere il seguente set di tag: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altro reindirizzamento nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
-
AP.as.23.0.1075.ap383346
-
AP.as.23.0.1075.ap383994
Per R24:
-
AP.as.24.0.944.ap383346
-
AP.as.24.0.944.ap383994
Per avere informazioni Dirigente-Assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
-
AP.as.24.0.944.ap380052
-
AP.as.24.0.944.ap384239
-
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare anche la sincronizzazione delle rubriche per la cronologia chiamate unificata dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione NoDist, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti nel cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione di Broadworks durante la stessa finestra di manutenzione. |
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configura organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettuare le seguenti operazioni:
-
Accedere a Partner Hub all'indirizzo
admin.webex.com
. -
Andare a Impostazioni e selezionare un cluster esistente.
-
Verificare che la connessione al cluster sia buona. Nel pannello a destra viene visualizzato un segno di spunta verde con Connection stabilita.
Se questa opzione non viene visualizzata, in Check Connnections (Opzionale), immettere BroadWorks User Id e BroadWorks Password e fare clic su Check per verificare che la connessione sia corretta.
-
Selezionare la casella di controllo Abilita cronologia chiamate.
-
Fai clic su Salva.
Interazioni funzione
Per la cronologia chiamate unificata sono presenti le seguenti interazioni delle funzioni:
-
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando questa situazione esiste, gli eventi Cronologia chiamate e Stato hook non vengono inviati all'app Webex.
-
La cronologia chiamate unificate non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia chiamate unificata dall'app Webex. Per informazioni dettagliate, vedere: Webex | Visualizzazione della cronologia chiamate e riunioni.
Disabilita cronologia chiamate unificata
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visivo
L'app Webex supporta un'indicazione visiva delle chiamate spam nel avviso popup quando la chiamata viene presentata al destinatario e nei record della cronologia delle chiamate unificate quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per utilizzare questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- Le seguenti patch devono essere installate e attive:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o almeno AS-25_Rel_2022.12
- La funzione deve essere attivata tramite AS CLI:
- AS_CLI/System/ActivatableFeature> attiva 104112
- AS_CLI/System/StirShaken> set enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'etichettatura e la verifica STIR-SHAKEN come descritto in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste di invito inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti che vengono inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione di spam visivo nella presentazione della chiamata e nella cronologia chiamate unificata della chiamata.
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenta di identificare il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra di chiamata e una volta completata la chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante abbinando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se trova più istanze di un numero in un'origine, non tenterà di sceglierne una, in questo caso, non visualizzerà alcun ID chiamante. |
-
Webex Common Identity (CI) che contiene gli utenti della tua organizzazione.
-
Contatti personali e aziendali. I contatti personali sono visibili nella scheda Contatti.
-
Rubrica locale. In Windows - applicazione Outlook, in Mac - Contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non viene trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, utilizzerà la parte del nome utente dell'URI SIP dall'intestazione SIP From come ultima risorsa.
Per il controllo delle chiamate remote (ad esempio, modalità di controllo del telefono fisso) vengono utilizzate informazioni XSI, dove viene utilizzato ID BWKS o interno, estratte da informazioni di parte remota nell'evento XSI. Se l'informazione della parte remota non è disponibile, verrà utilizzata P-Asserted Identity (PAI) (se configurata).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica di chiamata e nella cronologia chiamate.
-
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
-
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
-
Coda Call Center: Visualizza il nome della coda che ha inoltrato la chiamata.
-
Dirigente-Assistente: Mostra il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
-
Per le chiamate nella coda chiamate interna, in cui un agente richiama una parte interna, la parte remota non visualizzerà il nome della coda chiamata, ma il nome dell'agente che le chiama.
Chiamata con risposta altrove:
Per gruppi di risposta o code chiamate impostate con indirizzamento simultaneo, gli agenti visualizzeranno una chiamata che ha ricevuto risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di risposta o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate perse nella cronologia chiamate se risposte da un altro agente.
Seleziona ID chiamante
Panoramica
La funzione "Seleziona ID chiamante" consente agli utenti di passare tra diversi ID linea chiamante per le chiamate esterne. Se abilitato dall'amministratore, gli utenti possono scegliere tra le seguenti opzioni per l'identità della linea chiamante:
-
Numero utente ("Usa numero di telefono utente per identità linea chiamante")
-
CLID configurabile ("Usa CLID configurabile per identità linea chiamante")
-
CLID gruppo ("Usa numero di telefono di gruppo/reparto per identità linea chiamante")
Funzionalità
Gli utenti dispongono di due metodi per modificare l'ID chiamante predisposto dall'amministratore:
- Codici di accesso funzione (FAC): Codici specifici per ciascuna delle tre opzioni dell'ID chiamante.
- Interfaccia dell'app Webex: Una vista intuitiva all'interno delle app desktop e mobili Webex che visualizza le opzioni disponibili per l'ID chiamante abilitate dall'amministratore, consentendo agli utenti di selezionare l'ID preferito.
Funzioni aggiuntive
- Le app Webex includeranno anche le opzioni per le code Call Center DNIS.
- Gli utenti dell'app mobile avranno opzioni Persona doppia disponibili per gli utenti di mobilità.
Precondizioni
Le seguenti condizioni devono essere soddisfatte sul server BroadWorks affinché l'utente possa controllare la propria scelta di criteri CLID esterni:
- Il flag di sistema 'EnableUserSelectionOfExternalCLIDPolicy' è abilitato.
- L'ambito ID linea di chiamata a livello di utente è impostato su "Usa criteri ID linea di chiamata utente" per questo utente.
- Il flag Criteri di elaborazione chiamate a livello di utente 'Consenti selezione utente di criteri CLID esterni' è abilitato per l'utente.
- Se non viene definito alcun numero per le opzioni "Usa CLID configurabile per l'identità della linea chiamante" o "Usa numero di telefono di gruppo/reparto per l'identità della linea chiamante", la visualizzazione dei FAC o dell'app non avrà effetto. Questa impostazione deve essere configurata dall'amministratore prima della selezione dell'utente.
Patch BroadWorks
Questa funzione richiede due patch BroadWorks specifiche per funzionare correttamente:
Consultare la Sezione 8 Release Independent e Service Patch Information. |
- BWKS-5230 era la funzione CLID selezionabile dall'utente originale - consente agli utenti (se il sistema è configurato correttamente) di modificare i criteri CLID applicabili. Vedi FD qui: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/UserSelectionOfExternalCallingLineIDOptionFD-R250.pdf
- BWKS-9510 è un miglioramento XSI richiesto dal team del client Webex per facilitare la scoperta delle opzioni disponibili per un utente. Ciò è necessario perché la scelta dei criteri CLID non è una semplice funzione a livello di utente (come CFA) direttamente controllabile. Dipende piuttosto dalle diverse opzioni di configurazione del sistema e dalla gerarchia delle "politiche di elaborazione delle chiamate". I dettagli sono disponibili qui: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/XSIEnh179ToSupportUserSelectableCLIDFD-R250.pdf
Configurazione app Webex
Questi tag devono essere abilitati nelle configurazioni desktop, tablet e mobile:
<config> <servizi> <chiamate> <id chiamante> <chiamate in uscita abilitate="%ENABLE_CLID_OUTGOING_CALLS_WXT%">
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni da tavolo. Questa funzione specifica consente di assegnare gli indicatori di linea condivisa all'app Webex dell'utente finale.
Questa funzione consente agli utenti di gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
-
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
-
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
-
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
-
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente alle linee condivise.
-
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise dal client Webex
R23 senza ADP:
-
AP.as.23.0.1075.ap384179
-
AP.xsp.23.0.1075.ap384179
R23 con ADP:
-
AP.as.23.0.1075.ap384179
-
Xsi-Actions-23_2022.10
R24:
-
AS: AP.as.24.0.944.ap384179
-
Xsi-Actions-24_2022.10
R25:
-
AS: Release RI Rel_2022.10_1.310
-
Xsi-Actions-25_2022.10
Cerotto 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo. Esempio: Per il client desktop: Sistema>Tipo di profilo identità/dispositivo - Modifica> Business Communicator - PC: Profilo, opzioni standard, numero di porte:
- SE l'opzione 'Illimitato' è abilitata, non è richiesta alcuna modifica
- SE 'Limitato a' è <10, modificare il valore = 10 e salvarlo per utilizzare tutte le linee disponibili
-
Release RI Rel_2022.10_1.310
Sincronizzazione Non disturbare (NoDist)
La sincronizzazione Non disturbare (NoDist) allinea le impostazioni NoDist tra Webex e BroadWorks sincronizzando lo stato NoDist tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato si sincronizza con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. Analogamente, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist da una piattaforma non vengono riconosciuti dall'altra piattaforma.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Se sono presenti molti clienti (>50) nel cluster BroadWorks, la sincronizzazione NoDist non è supportata. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza. |
Prerequisiti
Accertarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione BroadWorks.
Per la versione 23:
<snipped>
- App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
<snipped>
- App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 su AS:
AS_CLI/System/ActivatableFeature> attiva 25433
Se sono presenti molti clienti (>50) nel cluster BroadWorks, operazioni come l'aggiornamento di azioni XSI, eventi XSI, URL DAS, URL XSP|ADP o sincronizzazione NoDist non sono supportate. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza.
Configura sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto di eventi "as-feature-event". Per informazioni dettagliate, vedere Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
-
Accedi a Partner Hub
-
Fare clic su Impostazioni.
-
Fare clic su Visualizza cluster e selezionare il cluster BroadWorks appropriato.
-
Abilita il tasto di alternanza Non disturbare (NoDist).
-
Inserire l'ID utente BroadWorks e fare clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione NoDist. Se la convalida non riesce, il pulsante Salva viene disabilitato.
-
Se la convalida ha esito positivo, fare clic su Salva.
|
Abilita sincronizzazione NoDist (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per ulteriori dettagli, vedere "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Disabilita sincronizzazione NoDist
Non puoi disabilitare la sincronizzazione NoDist da solo. Per disabilitare la funzione, crea un caso BEMS di ingegneria con le seguenti informazioni:
-
Famiglia: Servizio Spark
-
Prodotto: Chiamata in Webex (Webex per BroadWorks)
-
Componente: Provisioning WxBW
-
Il caso BEMS deve indicare che la sincronizzazione non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterIdBroadWorks.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione delle chiamate.
Modalità di registrazione |
Descrizione |
Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con pausa/ripresa |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente |
La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
-
Per R22: AP.as.22.0.1123.ap377718
-
Per R23: AP.as.23.0.1075.ap377718
-
Per R24: AP.as.24.0.944.ap377718
L'identificativo di correlazione chiamata deve essere attivato. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione delle chiamate Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, andare all'articolo help.webex.com
Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla piattaforma di registrazione chiamate di terze parti.
Abilitazione della casella vocale per l'integrazione Microsoft Teams
Puoi abilitare la casella vocale per gli utenti Microsoft Teams nella soluzione Webex per BroadWorks. Questa integrazione consente agli utenti di recuperare le proprie caselle vocali direttamente attraverso Microsoft Teams, migliorando l'esperienza utente generale.
Procedura per abilitare la casella vocale
-
Configurazione delle impostazioni della casella vocale: Segui la procedura fornita nella documentazione di Webex Calling per configurare e gestire le impostazioni della casella vocale. Ciò include l'impostazione della casella vocale per gli utenti, l'abilitazione delle notifiche e la configurazione da casella vocale a e-mail.
Per istruzioni dettagliate, vedere: Configura e gestisci le impostazioni della casella vocale per un utente Webex Calling.
-
Integra con Microsoft Teams: Assicurarsi che l'integrazione tra Webex per BroadWorks e Microsoft Teams sia configurata correttamente. Ciò consentirà agli utenti di accedere ai messaggi vocali attraverso l'interfaccia Microsoft Teams.
Per informazioni dettagliate sull'integrazione, vedere: Configura Microsoft Teams per Webex Calling.
Esperienza utente
Una volta impostata l'integrazione, gli utenti possono:
- Recupera le caselle vocali direttamente nell'applicazione Microsoft Teams.
- Ricevi notifiche per nuove caselle vocali.
- Gestisci le impostazioni della casella vocale dall'interfaccia Webex.
Requisiti
Per supportare il recupero della casella vocale nell'integrazione Microsoft Teams con l'offerta Webex per BroadWorks, sono necessarie ulteriori modifiche di rete. I partner BroadWorks devono abilitare la condivisione delle risorse cross-origin (CORS) per i seguenti URL sulla piattaforma BroadWorks:
- https://jabber-integration-a.wbx2.com/
- https://jabber-integration-r.wbx2.com/
- https://jabber-integration-k.wbx2.com/
- https://msteams-calling.webex.com/
Per ulteriori dettagli sulle fasi di configurazione, consultare la sezione 8.5.1.2 della Guida alla configurazione della piattaforma di consegna delle applicazioni BW, che richiede la versione 2024.05 sull'ADP.
Gruppo Parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione di parcheggio e recupero delle chiamate di gruppo. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti al dettaglio in un'impostazione di negozio possono utilizzare la funzione per parcheggiare una chiamata che può essere raccolta da qualcuno in un altro reparto.
Funzionamento funzione
Una volta configurata la funzione
-
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nell'app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
-
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nell'app Webex. L'utente quindi inserisce l'estensione della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per attivare questa funzione, verificare quanto segue:
-
Il file di configurazione client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
-
L'identificativo di correlazione chiamata deve essere abilitato su AS e XSP|ADP. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
-
Il controller SBC deve essere configurato per passare l'attributo SIP '
x-broadworks-correlation-in
' a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiungi gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo del server applicazioni Cisco BroadWorks - Parte 2. È necessario creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedi Webex | Parcheggio e recupero delle chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzato
Il parcheggio chiamate regolare o indirizzato non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso funzione:
-
Immettere *68 per parcheggiare una chiamata
-
Immettere *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato negli ambienti del call center o in altre situazioni in cui può essere necessaria un'assistenza o un intervento immediati.
Quando un servizio di inclusione è abilitato, un utente o supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di tasti o pulsanti dedicati sul proprio telefono o dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o di partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in vari scenari. In un ambiente di call center, supervisori o formatori possono monitorare e assistere i rappresentanti del servizio clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire assistenza o prendere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può partecipare rapidamente a conversazioni in corso per fornire assistenza o prendere decisioni importanti.
Nell'app Webex per l'inclusione, viene inviata una notifica che la chiamata viene trasformata in una conferenza. In NOTIFY (informazioni sulla chiamata o conferenza) non sono disponibili ulteriori informazioni sul tipo di conferenza, pertanto è possibile trattarla in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Vengono introdotti i seguenti termini:
-
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore solitamente ha la possibilità di monitorare e intervenire nelle chiamate in corso dei clienti. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire assistenza agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può comprendere la formazione degli agenti, la gestione dei problemi dei clienti e l'ottimizzazione delle prestazioni del team.
-
Cliente: Per cliente si intende una persona fisica o giuridica che interagisce con un'azienda o un'organizzazione per ottenere prodotti, servizi o assistenza. Nel contesto dell'inclusione delle chiamate, un cliente è qualcuno che sta effettuando o ricevendo una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risolvere le loro richieste o problemi durante la chiamata. La funzione di inclusione chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
-
Agente: Un agente, anche noto come rappresentante del servizio clienti o agente di call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza telefonica o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare operazioni e offrire un'esperienza positiva al cliente. Nel contesto dell'inclusione delle chiamate, un agente è la persona che parla direttamente al cliente durante la telefonata. L'agente può ricevere indicazioni o feedback dal supervisore attraverso l'inclusione della chiamata, se necessario.
Per qualsiasi richiesta avviata dal client, come CallStartRequest, CallPickupRequest, DirectedCallPickupRequest, DirectedCallPickupWithBargeInRequest, ecc., se <Webex Client> (scegliere il nome corretto anziché il client Webex, se non appropriato) viene predisposto come dispositivo di aspetto chiamata condivisa, è necessario abilitare la configurazione 'Avvisa tutti gli aspetti delle chiamate con clic' nell'impostazione di aspetto chiamata condivisa per consentire al client di ricevere una chiamata, a meno che la posizione non sia esplicitamente fornita dal client che avvia la richiesta.
La chiamata nativa mobile viene inoltrata alla riunione
La funzione di escalation della chiamata nativa mobile alla riunione è dotata di due funzioni uniche:
-
Nuova notifica push
Gli utenti mobili su una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando si avvia una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si accede direttamente alla schermata in chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata utilizzando il controllo chiamate Cisco per le chiamate su cellulare, viene visualizzata la notifica Webex durante una chiamata su cellulare.
-
Trasferisci chiamata mobile a riunione
Quando sei nel mezzo di una chiamata con qualcuno, potresti voler trasferire tale chiamata in una riunione per utilizzare alcune funzioni di riunione avanzate come video, condivisione o lavagna. In alternativa, invitare altre persone alla discussione e passare a una riunione.
Requisiti BroadWorks
-
Funzione attivabile 25239
-
R23 con XSP|ADP:
-
AS Patch AP.as.23.0.1075.ap383064
-
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
-
Patch AP.platform.23.0.1075.ap383064
-
-
R23 con ADP:
-
AS Patch AP.as.23.0.1075.ap383064
-
ADP con Xsi-Actions-23, versione CommPilot-23 > 2022.05_1.303 e versione NPS > 2022.08_1.350
-
-
R24:
-
Cerotto AS: AP.as.24.0.944.ap383064
-
ADP con Xsi-Actions-24, versione CommPilot-24 > 2022.05_1.303 e versione NPS > 2022.08_1.350
-
-
R25:
-
AS RI rilascio Rel_2022.08_1.354
-
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e NPS versione > 2022.08_1.350
-
Configurazione chiamata URI per supportare lo spostamento della chiamata alla riunione
Criteri di chiamata Url NS
Definisci la regola per (.*)webex.com da indirizzare attraverso I-SBC
NS_CLI/Policy/UrlDialing> ottieni criteri WebexMeetings: Istanza di chiamata Url: Webex unknownSipURIHandling = rifiuta disableSubscriberLookups = true Abilita = true CallTypes: Selezione = {ALL} Da = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP} lineportOnly = false enableSipURIMatchingRules = true NS_CLI/Policy/UrlDialing/Rules> ottieni WebexMeetings Policy: Istanza di chiamata Url: Tabella WebexCalling: Routing schema id regoleNE peso costi dtg =================================================================== 1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE di indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> get ne WebexMeetings Network Element WebexMeetings Location = 1281465 Data Center = Static Cost = 1 Static Weight = 99 Poll = false OpState = enabled State = OnLine Profile = NIL_PROFILE Remote Lookup Enabled = false Signaling Attributes = NS_CLI/System/Device/RoutingNE/Address> get ne WebexMeetings Routing NE Address Cost Weight Port Transport Route ===================================================================== WebexMeetings sbc-address 1 99 - unspecified
Profilo di indirizzamento NS
Aggiunta dell'istanza della policy UrlDialing ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> ottenere il profilo MyInst Profile: Istanza criteri Webex========================================== ... UrlDialing WebexMeetings
AS Usa indirizzamento NS per chiamata NetworkURL
Consente all'AS di rispettare il percorso NS in modalità ibrida AS
AS_CLI/Interface/IMS> imposta queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un PSAP (Public Safety Answering Point), che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, è necessario integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Usa i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
-
Chiamata di emergenza E911 in Webex per BroadWorks: utilizzare questo articolo per configurare la chiamata di emergenza E911 in Webex per Cisco BroadWorks utilizzando uno dei seguenti provider E911 supportati:
-
Banda
-
Intrado
-
RedSky
-
-
Esclusione di responsabilità per chiamate di emergenza: se disponi di un servizio di posizione, puoi configurare la finestra Esclusione di responsabilità per i servizi di emergenza sull'app Webex in modo da includere un'opzione per gli utenti per aggiornare la propria posizione quando eseguono l'accesso.
Personalizzazione e provisioning dei clienti
Gli utenti scaricano e installano le relative app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedere Piattaforme app Webex). Una volta autenticato l'utente, il client si registra a fronte di Webex Cloud per messaggistica e riunioni, recupera le informazioni di branding, scopre le informazioni del servizio BroadWorks e scarica la configurazione di chiamata dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
Configurare i parametri di chiamata per le app Webex in BroadWorks (come di consueto). Configurare i parametri di branding, messaggistica e riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
-
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Prepara il tuo ambiente).
-
Verificare di disporre dei set di tag corretti in BroadWorks System > Resources > Device Management Tag Sets.
-
Per ciascun client che si sta eseguendo il provisioning:
-
Scaricare ed estrarre il file zip DTAF per il client specifico.
-
Importare i file DTAF in BroadWorks all'indirizzo System > Resources > Identity/Device Profile Types
-
Apri il profilo dispositivo appena aggiunto per la modifica e:
-
Inserire il nome di dominio completo dell'azienda agricola XSP|ADP e il protocollo di accesso del dispositivo.
-
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per il funzionamento della condivisione desktop.
È inoltre possibile abilitare il supporto Parte remota eseguendo il seguente comando CLI sul server applicazioni:AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
-
-
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
-
Salvare il profilo.
-
-
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome |
Descrizione |
Priorità codec |
Configurazione dell'ordine di priorità per i codec audio e video per le chiamate VoIP |
TCP, UDP e TLS |
Configurare i protocolli utilizzati per la segnalazione e il contenuto multimediale SIP |
Porte audio e video RTP |
Configurazione degli intervalli di porte per audio e video RTP |
Opzioni SIP |
Configurare diverse opzioni relative a SIP (SIP INFO, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
-
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti gestiti dal partner. Vedere Configurazione di personalizzazioni di branding avanzate.
-
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client. |
Personalizzazione dei report dei problemi e degli URL della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito Feedback e Guida", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con Flowthrough Provisioning
Devi configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub, prima di poter eseguire questa attività.
1 |
Assegna servizio in BroadWorks: |
2 |
Verifica dell'organizzazione cliente e degli utenti in Control Hub: |
Test utente
1 |
Scaricare l'app Webex su due diverse macchine. |
2 |
Eseguire l'accesso come utenti di test sulle due macchine. |
3 |
Effettuare chiamate di prova. |
Provisioning delle organizzazioni dei clienti
Nel modello corrente, eseguiamo automaticamente il provisioning dell'organizzazione del cliente quando si esegue l'onboarding del primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguito una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
-
Usa API per creare account Webex
-
Assegna il provisioning integrato IM&P (flowthrough provisioning) con e-mail attendibili per creare account Webex
-
Assegna provisioning integrato IM&P (flowthrough) senza e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per creare account Webex
-
Consenti agli utenti di autoattivarsi (invia loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex espone le API pubbliche per consentire ai provider di servizi di integrare il provisioning degli abbonati Webex per Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. Le specifiche per queste API sono disponibili su developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti wholesale verranno rifiutati da queste API. |
Provisioning Flowthrough
Su BroadWorks, è possibile eseguire il provisioning degli utenti con l'opzione Abilita IM&P integrato. Questa azione provoca l'adattatore di provisioning BroadWorks per effettuare una chiamata API per il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica del codice, ma solo una modifica della configurazione dell'endpoint API per l'adattatore di provisioning.
Il provisioning degli abbonati su Webex può richiedere molti minuti (diversi minuti per l'utente iniziale all'interno di un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il successo del provisioning flowthrough indica che il provisioning è stato avviato. Non indica il completamento. Per confermare che il provisioning di utenti e organizzazione cliente sia completo su Webex, devi accedere a Partner Hub e guardare nell'elenco dei clienti. Gli utenti di trunking BroadWorks possono disporre di Webex per BroadWorks tramite un identificativo di chiamata condiviso (SCA). L'utente che esegue il trunking dovrà disporre del servizio di autenticazione assegnato. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto Webex SCA dall'autenticazione del trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con le funzioni di elenco di indirizzamento o indirizzamento diretto assegnate. |
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata Modello di onboarding. |
Autoattivazione utente
Per eseguire il provisioning degli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
-
Accedere a Partner Hub e trovare la pagina Elenco clienti.
-
Fare clic su Visualizza modelli.
-
Seleziona il modello di onboarding di provisioning che desideri applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non si trova nel sistema BroadWorks associato a questo modello, non può attivarsi automaticamente con il collegamento.
-
Copiare il collegamento di provisioning e inviarlo all'utente.
È anche possibile includere il collegamento per il download del software e ricordare all'utente di cui ha bisogno di fornire e convalidare il proprio indirizzo e-mail per attivare l'account Webex.
-
È possibile monitorare lo stato di attivazione dell'utente nel modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi di attivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli all'interno della vista Stato utente che consente agli amministratori di provider di servizi Webex per Cisco BroadWorks di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Sposta gli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a… |
Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) |
|
Organizzazione cliente |
Collega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge Webex per BroadWorks anche agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a… |
Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) |
Se l'organizzazione Webex per BroadWorks non esiste (nessun utente predisposto):
Se esiste un'organizzazione Webex per BroadWorks (viene predisposto almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di autoiscrizione (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (con il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
-
Sposta utente (con e-mail attendibili): utilizza il provisioning con e-mail attendibili
-
Sposta utente (con e-mail non attendibili): utilizza il provisioning con e-mail non attendibili
-
Autoattivazione
Se l'organizzazione Webex per Cisco BroadWorks non è ancora stata creata (nessun utente predisposto), seguire i normali processi di provisioning (Provisioning utenti) per creare l'organizzazione e aggiungere il primo utente come utente di amministrazione. Una volta eseguito il provisioning del primo utente nell'organizzazione, seguire i metodi basati sul consenso in questa procedura per spostare gli utenti successivi. |
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza messaggi e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
-
L'amministratore aggiunge l'utente.
-
L'utente viene spinto sul bridge di provisioning BroadWorks.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
All'utente viene inviato un messaggio e-mail automatico.
-
-
L’utente apre l’e-mail e fa clic su Attiva account. L'utente viene reindirizzato al portale consumer Webex.
-
L'utente accede a Webex.
-
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
-
Il vecchio account Webex viene eliminato.
-
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina Download.
-
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza messaggi e-mail non attendibili, è necessario prima convalidare l’indirizzo e-mail dell’utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
-
L'amministratore aggiunge l'utente.
-
L'utente viene inviato automaticamente al bridge di provisioning BroadWorks.
-
All'utente viene inviato un testo con un collegamento di attivazione.
-
-
L'utente fa clic sul collegamento Attivazione e inserisce l'indirizzo e-mail.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
All'utente viene inviato un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Accedi ora.
-
L'indirizzo e-mail viene convalidato.
-
L'utente viene reindirizzato all'accesso al portale consumer Webex.
-
-
L'utente accede a Webex.
-
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
-
Il vecchio account Webex viene eliminato.
-
Utente predisposto su Webex per Cisco BroadWorks utilizzando lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina Download.
-
Flusso di autoattivazione
Se l'utente dispone di un account BroadWorks esistente, può utilizzare il processo di autoattivazione per spostare l'account.
-
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
-
L'utente inserisce il proprio indirizzo e-mail.
-
L'utente viene inviato al bridge di provisioning BroadWorks.
-
Viene inviata un'e-mail automatica all'indirizzo e-mail dell'utente.
-
-
L'utente apre il messaggio e-mail e fa clic sul collegamento Accedi ora, che convalida l'indirizzo e-mail.
-
CI rileva che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di poter continuare.
-
L'utente viene reindirizzato all'accesso a Webex.
-
-
L'utente accede al portale consumer.
-
L'utente fa clic su Elimina account.
-
L'account Webex precedente viene eliminato.
-
All'utente è stato predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
Collegamento di Webex per BroadWorks all'organizzazione esistente
Se sei un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, che non è ancora associata a un'azienda BroadWorks gestita da un partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso amministratore per la richiesta di provisioning riuscita.
È necessaria l'approvazione dell'amministratore dell'organizzazione se una delle seguenti affermazioni è vera:
-
L'organizzazione cliente esistente dispone di 100 utenti o più
-
L'organizzazione dispone di un dominio e-mail verificato
-
Dominio organizzazione richiesto
Se nessuno dei criteri di cui sopra è vero, può verificarsi un Attacco automatico.
In uno scenario di allegato automatico, un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner verranno concessi diritti di amministrazione provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà eseguito un amministratore completo. Con l'accesso amministratore di provisioning, la visibilità in Control Hub sarà limitata agli utenti nell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione. |
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che i messaggi e-mail di invito amministratore vengano collegati a organizzazioni esistenti (il tasto di alternanza è attivo per impostazione predefinita). |
1 |
L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedere Provisioning delle organizzazioni dei clienti. Si verifica quanto segue:
| ||
2 |
Con l'accesso amministratore completo, l'amministratore del partner può completare il processo di provisioning del cliente. Dovrai provare a eseguire nuovamente il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora come amministratore completo esterno, non si dovrebbe osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione cliente esistente sarà visibile come cliente sotto Webex per l'organizzazione partner BroadWorks.
|
Condizioni dell'allegato organizzazione
-
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione cliente di destinazione. In caso contrario, verrà creata una nuova organizzazione cliente.
-
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
-
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato sul modello di provisioning Webex per BroadWorks. Di conseguenza, non vi sono modifiche alla modalità di accesso degli utenti esistenti.
-
Tuttavia, se l'organizzazione cliente esistente dispone di branding di base abilitato, una volta eseguito il collegamento, le impostazioni di branding avanzate del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
-
-
Il nome dell'organizzazione esistente non cambierà.
-
Non è stata apportata alcuna modifica all'impostazione del flag di soppressione e-mail nelle impostazioni dell'organizzazione esistente. Ciò può avere effetto sui nuovi utenti predisposti. A seconda di come è impostato il flag, i nuovi utenti possono o meno ricevere un'e-mail con un codice che deve essere immesso per completare l'attivazione.
-
La modalità di amministrazione con restrizioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
-
Accertarsi di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
-
Un'azienda BroadWorks può essere associata solo a una organziazione Webex. Non è possibile eseguire il provisioning degli abbonati da una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com
.
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo. |
L'indirizzo e-mail aggiunto dall'amministratore dell'organizzazione cliente come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore partner come configurato nel modello di onboarding su Partner Hub. Dopo aver aggiunto l'e-mail dal modello di onboarding in Partner Hub come amministratore completo, qualsiasi amministratore aggiuntivo del partner dovrà essere aggiunto anche come amministratore esterno con diritti di amministratore completo. |
Scollegare Webex per BroadWorks dall'organizzazione esistente
Attenersi alla procedura riportata di seguito per scollegare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato accidentalmente Webex per BroadWorks a un'organizzazione esistente e si desidera rimuovere l'allegato.
In Flusso standard, il distacco di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati. |
-
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso all'amministratore esterno seguendo Approva richiesta amministratore esterno.
-
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Remove a BroadWorks Workspace.
-
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API di rimozione di un abbonato BroadWorks.
-
Rimuovi gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se gli utenti sono stati predisposti tramite il flusso e-mail non attendibile e non sono stati ancora inseriti messaggi e-mail validi, gli utenti rimangono in stato di attesa. Segui Verifica provisioning utente con e-mail non attendibili per eliminare gli utenti.
-
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Hybrid, nella sezione BroadWorks Calling elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera collegare Webex per BroadWorks al cliente, seguire i processi di provisioning per collegarlo a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API abbonato Remove a BroadWorks è quella di andare in BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati. |
Gestione di utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente sono in BroadWorks. Un'identità e-mail distinta per l'utente e le relative licenze per le funzioni Webex vengono conservate in Webex.
Verifica del provisioning utenti con indirizzi e-mail non attendibili
Se si sta eseguendo il provisioning di utenti Webex per BroadWorks utilizzando il provisioning flow-through con e-mail non attendibili, gli utenti devono eseguire il provisioning automaticamente inserendo il relativo indirizzo e-mail nel portale di attivazione utente. Se l'utente riscontra un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riscontra nuovamente l'errore, l'amministratore può utilizzare i passaggi seguenti in Partner Hub per esaminare lo stato e caricare l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 |
Accedere a Partner Hub e trovare la pagina Elenco clienti. |
2 |
Fare clic su Visualizza modelli. Selezionare il modello di onboarding appropriato che si desidera applicare a questo utente. |
3 |
In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con e-mail non attendibili sia configurato correttamente:
|
4 |
In seguito al provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per verificare lo stato del provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo stato corrente, che mostra se l'utente è predisposto o se è presente un requisito in sospeso.
|
5 |
Per gli utenti con errori o requisiti in sospeso, fare clic sui tre punti a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili quando si visualizza l'elenco degli utenti:
-
Esporta: fare clic su questo pulsante se si desidera esportare l'elenco utenti in un file CSV.
-
Escludi utenti predisposti: abilita questo tasto di alternanza se desideri visualizzare solo gli utenti con requisiti o errori in sospeso.
Modifica ID utente o indirizzo e-mail
Modifiche a ID utente e indirizzo e-mail
L'ID e-mail e l'ID alternativo sono gli attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. La tabella seguente descrive gli scopi di questi diversi attributi e cosa fare se occorre cambiarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Finalità | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non puoi modificare questo identificativo e comunque collegare l'utente allo stesso account in Webex. È possibile eliminare l'utente e ricreare se non è corretto. |
ID e-mail | ID utente |
Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si afferma che l'e-mail è attendibile Non richiesto in BroadWorks se non si asserisce di poter considerare attendibili i messaggi e-mail Non richiesto in BroadWorks se consenti agli abbonati di autoattivarsi |
È presente un processo manuale per modificare questa opzione in entrambe le posizioni se all'utente è stato eseguito il provisioning con l'indirizzo e-mail errato:
Non modificare l'ID utente BroadWorks. Questa operazione non è supportata. |
ID alternativo | Nessuno | Consente di abilitare l'autenticazione dell'utente per e-mail e password rispetto all'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se Non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti dovranno inserire il proprio ID utente BroadWorks durante l'autenticazione. |
Modifica pacchetto utenti in Partner Hub
1 |
Accedere a Partner Hub e fare clic su Clienti. |
2 |
Individuare e selezionare l'organizzazione del cliente a cui è assegnato l'utente. Viene visualizzata la pagina di panoramica dell'organizzazione in un pannello a destra dello schermo. |
3 |
Fare clic su Visualizza cliente. L'organizzazione del cliente si apre in Control Hub, mostrando la pagina Panoramica.
|
4 |
Fare clic su Utenti, quindi individuare e fare clic sull'utente interessato. |
5 |
Nei Servizi dell'utente, fare clic su Webex per i pacchetti BroadWorks (Abbonamenti). Si apre il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 |
Nella scheda Profilo, cercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 |
Selezionare il pacchetto desiderato per questo utente (Base, Standard, Premium o Softphone) e fare clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 |
Puoi chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium hanno siti di riunione distinti associati a ciascun pacchetto. Quando un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato viene visualizzato con due siti di riunione in Control Hub. Le funzionalità di riunione organizzatore e il sito della riunione dell'abbonato vengono allineati al pacchetto corrente. Il sito della riunione del pacchetto precedente e qualsiasi contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili all'amministratore del sito della riunione. |
Potrebbero essere necessarie da due a tre ore per le nuove impostazioni PMR derivanti da una modifica del pacchetto da aggiornare. |
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si desidera eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto alcun trasferimento automatico del ruolo di amministratore nel caso in cui venga eliminato l'ultimo amministratore. |
API Cisco BroadWorks per Webex
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
-
Eseguire la richiesta Rimuovi un abbonato BroadWorks API all'indirizzo https://developer.webex.com/docs/api/v1/broadworks-subscriber/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento Webex per Cisco BroadWorks. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
-
Eseguire la richiesta Elimina una persona API all'indirizzo https://developer.webex.com/docs/api/v1/people/delete-a-person per eliminare completamente l'utente.
Provisioning flow-through
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
-
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – IM&P integrato in BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks - Parte 2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento Webex per Cisco BroadWorks dall'utente. L'utente non è più fatturato come utente Webex per Cisco BroadWorks ed è trattato come utente Webex gratuito.
-
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla propria organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub all'indirizzo https://help.webex.com/0qse04/.
Elimina organizzazione
1 |
Usa le API Persone per eliminare tutti gli utenti dall'organizzazione:
| ||
2 |
Se la sincronizzazione rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione rubriche tramite Partner Hub: Per disabilitare la sincronizzazione rubriche tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API aziendale BroadWorks e disabilita l'impostazione enableDirSync. Tutti gli utenti correlati alla sincronizzazione rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione degli utenti (utilizzando entrambi i metodi) può richiedere del tempo a seconda della quantità di utenti. | ||
3 |
Una volta rimossi tutti gli utenti, utilizza l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Annullamento di un abbonamento da Control Hub
Poiché l'API è privata, i clienti non avranno accesso ad essa. Al contrario, le seguenti operazioni mostrano come i clienti possono annullare il proprio abbonamento da Control Hub:
-
L'amministratore del partner può passare alla pagina dei servizi "Hybrid" sul Control Hub del cliente.
-
Individua la scheda "BroadWorks Calling".
-
Una volta eseguito il provisioning di tutti gli utenti da Webex per BroadWorks per tale cliente, il partner deve visualizzare un pulsante "Cancella configurazione" (ad esempio, eliminare la voce customer_config in BPB).
Gestione delle release
I controlli di gestione delle release in Partner Hub consentono a Webex per i provider di servizi Cisco BroadWorks di gestire facilmente le release consentendo loro di controllare la cadenza di rilascio in base alla quale le app Webex degli utenti vengono aggiornate all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza gli aggiornamenti automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
-
Configurazione di pianificazioni di rilascio personalizzate con rinvii dalla pianificazione di rilascio predefinita Cisco
-
Configurare una singola pianificazione della release e trasferirla a cascata a tutte le organizzazioni dei clienti che gestiscono
-
Assegna diverse pianificazioni di rilascio a diverse organizzazioni di clienti
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di rilascio personalizzate, vedere l'articolo Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
-
Aggiunta di un cluster BroadWorks in Partner Hub
-
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
-
Aggiunta di un modello di onboarding in Partner Hub
-
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 |
Accedere a Partner Hub con le credenziali di amministratore del partner all'indirizzo | ||
2 |
Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | ||
3 |
Fare clic su Visualizza cluster. | ||
4 |
Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro flyout a destra.
| ||
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 |
Accedere a Partner Hub con le credenziali di amministratore del partner all'indirizzo | |||||||||
2 |
Vai a Impostazioni e trova la sezione Chiamata BroadWorks . | |||||||||
3 |
Fare clic su Visualizza modelli. | |||||||||
4 |
Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere a Webex Assistant di seguire le azioni, prendere nota di decisioni importanti ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant per Meetings è disponibile gratuitamente per i siti per riunioni con pacchetto Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilitazione di Webex Assistant per Meetings
Webex Assistant è abilitato per impostazione predefinita per i clienti Broadworks con pacchetto standard e premium.
Gli amministratori dei partner e gli amministratori delle organizzazioni dei clienti possono disabilitare la funzione per le organizzazioni dei clienti tramite Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
-
Il supporto è limitato ai siti per riunioni con pacchetto Premium e Standard e solo alle sale riunioni personali.
-
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
-
La condivisione di contenuto tramite e-mail è accessibile solo dagli utenti all'interno della tua organizzazione
-
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Il contenuto della riunione non è accessibile anche se condiviso tra utenti di pacchetti diversi dall'interno della stessa organizzazione.
-
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
-
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile, pertanto le trascrizioni post-riunione non sono disponibili se Webex Assistant è abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni utente su come utilizzare la funzione, vedere Uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
Webex Calling gratuito è abilitato per impostazione predefinita consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, che disabilita tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzioni
Se Webex Calling è disabilitato, le seguenti condizioni si applicano a Webex per gli utenti Cisco BroadWorks:
-
Gli utenti non visualizzano più Chiamata con Webex come opzione di chiamata selezionabile sull'app Webex.
-
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, la cronologia chiamate, i contatti, inserendo l'URI dell'altro utente o l'indirizzo e-mail nella barra di ricerca.
-
Condivisione schermo all'interno di una chiamata BroadWorks.
-
Le riunioni Webex e la presenza in telefonia funzionano ancora, anche se le chiamate Webex sono disabilitate.
Disabilita chiamate Webex (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno di Aggiungi un nuovo modello guidata. Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti assegnate al modello.
Per informazioni dettagliate sulla configurazione di un nuovo modello di onboarding, vedere Configurazione dell'organizzazione partner in Partner Hub.
Disabilita chiamate Webex (modello di onboarding esistente)
Seguire questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
-
Accedere a Partner Hub all'indirizzo admin.webex.com.
-
Scegliere Impostazioni.
-
Fare clic su Visualizza modello e scegliere il modello di inserimento appropriato.
-
Fai clic su Disabilita chiamata gratuita Cisco Webex.
-
Fai clic su Salva.
Disabilita chiamate Webex (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare Webex Calls per un utente esistente, è possibile seguire una delle procedure seguenti per aggiornare l'utente.
Accertarsi di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigura l'utente con le chiamate Webex abilitate. |
Se si utilizza il provisioning flow-through, è possibile effettuare le seguenti operazioni:
-
Aprire CommPilot e passare alla configurazione utente.
-
Rimuovere il servizio Integrated IM+P dall'utente e fare clic su OK.
-
Aggiungere il servizio Integrated IM+P all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
-
Utilizzare Remove a BroadWorks Subscriber API per eliminare l'utente.
-
Utilizzare la Provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione della condivisione video o dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per informazioni dettagliate sulla configurazione e le opzioni complete, vedere Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è anche possibile configurare se il contenuto multimediale delle chiamate in ingresso utilizza per impostazione predefinita solo il video o l'audio. |
Indicatore di stato della linea / Notifica risposta per assente
L'indicatore di stato/notifica di risposta per assente utilizza le funzioni di risposta per assente indirizzata. Un utente con indicatore di stato riceve una notifica audio e visiva sull'app Webex quando un utente dell'elenco di indicatori di stato monitorato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può Ignorare o Rispondere alla chiamata dell'utente monitorato.
La notifica dell'indicatore di stato/risposta per assente consente di rispondere alle chiamate di altri membri del team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra chiamata multipla - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza dei membri del team Webex e non Webex. Per informazioni sull'abilitazione della chiamata multipla, vedere: Finestra multi-chiamata
I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati nella rubrica in Webex e avranno solo stati "sconosciuti" e "in chiamata" (lo stato suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
-
La presenza non è supportata per gli utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
-
Gli utenti CI senza autorizzazione cloud Webex o tipo di account macchina (spazi di lavoro) visualizzano solo la presenza "in chiamata" e "sconosciuta". Nessun stato attivo, suoneria, ecc.
-
Gli utenti non Webex dall'elenco di indicatori di stato, che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza "sconosciuta".
-
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
-
Se un utente non Webex dell'indicatore di stato detiene una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate su BroadWorks. Installare solo le patch valide per la versione in uso:
Per R22:
-
Piattaforma AP.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382362
-
AP.xsp.22.0.1123.ap382053
-
AP.xsp.22.0.1123.ap382362
-
AP.as.22.0.1123.ap383459
-
AP.as.22.0.1123.ap383520
Per R23:
-
Piattaforma AP.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382362
-
AP.as.23.0.1075.ap383459
-
AP.as.23.0.1075.ap383520
-
Se si utilizza XSP|ADP:
-
AP.xsp.23.0.1075.ap382053
-
AP.xsp.23.0.1075.ap382362
-
-
Se si utilizza ADP:
-
Xsi-Actions-23_2022.01_1.200.bwar
-
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
-
Per R24:
-
AP.as.24.0.944.ap382053
-
AP.as.24.0.944.ap382362
-
AP.as.24.0.944.ap383459
-
AP.as.24.0.944. ap383520
-
Xsi-Actions-24_2022.01_1.200.bwar
-
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
-
<busy-lamp-field enabled="%ENABLE_BUSY_LAMP_FIELD_WXT%">
-
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
-
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare la funzione 101642 Enhanced Xsi Mechanism Per la telefonia del team su AS:
AS_CLI/System/ActivatableFeature> attiva 101642
Abilitare X-BroadWorks-Remote-Party-Info
su AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamata SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
Accertarsi che i seguenti servizi siano assegnati agli utenti:
-
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
-
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP. |
Configurazione dell'indicatore di stato della linea su BroadWorks
Gli amministratori dei partner possono utilizzare la seguente procedura per impostare l'indicatore di stato della linea per un utente.
-
Accedere a BroadWorks CommPilot.
-
Per un utente selezionato, accedere ad Applicazioni client e configurare l'indicatore di stato della linea.
-
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
-
Utilizzare i parametri di ricerca per individuare e aggiungere utenti all'elenco Utenti monitorati.
-
Fai clic su OK.
Supporto integrazione Slido
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento di coinvolgimento del pubblico facile da usare. Consente alle persone di ottenere il massimo dalle riunioni colmando la distanza tra oratori e pubblico. Quando Slido è integrato nella tua organizzazione Control Hub, i tuoi utenti possono aggiungere l'app Slido alle riunioni nell'app Webex. Questa integrazione offre ulteriori funzionalità di Q&A e sondaggio alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione di Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando è stata accettata una riunione nel client Outlook che corrisponde a un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che hai assunto un impegno diverso e che la risposta potrebbe essere ritardata.
Per abilitare questa funzione:
-
andare alla scheda Generale della scheda Impostazioni su Windows o Preferenze su Mac.
-
Selezionare la casella per Mostra in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, "In una riunione di calendario" in Webex è associato a "Occupato" in Outlook. |
Avvertenza
Per utilizzare questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come funziona altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la sua presenza non verrà aggiornata fino al termine della riunione. A tale scopo, sarà necessario riavviare il client per rispondere.
Risposta automatica con tono
Con la risposta automatica con tono, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul desktop. Quando l'app Webex squilla sull'altra parte, l'utente sente un determinato segnale acustico che indica che la chiamata è in connessione.
Per utilizzare questa funzione per un utente Webex per Cisco BroadWorks:
-
La funzione è supportata solo sull'aspetto della linea principale
-
L'app Webex deve essere l'identificativo di linea principale
-
Il tag %ENABLE_AUTO_ANSWER_WXT% deve essere abilitato
Se l'utente dispone anche di indicatori di chiamata condivisa (ad esempio, un telefono da tavolo è configurato come uno degli indicatori di linea secondaria), la funzione è ancora supportata sull'aspetto principale, a condizione che gli indicatori di chiamata condivisa siano configurati per non ricevere chiamate in arrivo. Per effettuare questa operazione, è possibile configurare una delle tre condizioni seguenti su BroadWorks per tutte le chiamate condivise:
-
Avvisa tutti gli aspetti delle chiamate con clic è disabilitato nella configurazione dell'aspetto chiamata condivisa: questo è l'approccio consigliato
o
-
Consenti terminazione a questa posizione deve essere disabilitato per tutte le chiamate condivise o
o
-
Posizioni disabilitate per tutti gli indicatori di chiamata condivisi
Aumentare la capacità
XSP|ADP Aziende agricole
Si consiglia di utilizzare il pianificatore di capacità per determinare quante risorse XSP|ADP aggiuntive sono necessarie per l'aumento proposto dei numeri di abbonato. Per le aziende NPS dedicate o Webex dedicato per le aziende Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
-
Fattoria dedicata in scala: Aggiungere uno o più server XSP|ADP all'azienda che ha bisogno di capacità extra. Installare e attivare lo stesso set di applicazioni e configurazioni dei nodi esistenti dell'azienda agricola.
-
Aggiungi azienda agricola dedicata: Aggiungi una nuova fattoria XSP|ADP dedicata. Dovrai creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti nella nuova fattoria, per ridurre la pressione sulla fattoria esistente.
-
Aggiungere azienda agricola specializzata: Se si verificano colli di bottiglia per un particolare servizio, è possibile creare una fattoria XSP|ADP separata a tale scopo, prendendo in considerazione i requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster di Control Hub e le voci DNS se si modifica l'URL del servizio con una nuova azienda agricola.
In tutti i casi, è tua responsabilità monitorare e assegnare risorse all’ambiente BroadWorks. Se si desidera contattare l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare i servizi professionali.
Gestione dei certificati del server HTTP
È necessario gestire questi certificati per le applicazioni Web autenticate mTLS su XSP|ADP:
-
La nostra catena di certificati di attendibilità dal cloud Webex
-
Certificati dell'interfaccia del server HTTP XSP|ADP
Catena di fiducia
Scaricare la catena del certificato di attendibilità da Control Hub e installarlo sui propri XSP|ADP durante la configurazione iniziale. Prevediamo di aggiornare il certificato prima della scadenza e di informarvi su come e quando modificarlo.
Interfacce del server HTTP
XSP|ADP deve presentare un certificato server firmato pubblicamente a Webex, come descritto in Certificati ordine. Quando si protegge l'interfaccia, viene generato un certificato autofirmato per l'interfaccia. Questo certificato è valido per un anno da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Limitato dalla modalità partner
Con limitazioni della modalità partner è un'impostazione Partner Hub che gli amministratori dei partner possono assegnare a organizzazioni di clienti specifiche per limitare le impostazioni dell'organizzazione che gli amministratori dei clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione cliente, tutti gli amministratori dei clienti di tale organizzazione, indipendentemente dai diritti di ruolo, non possono accedere a una serie di controlli limitati in Control Hub. Solo l'amministratore del partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner si intende un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita i diritti di ruolo specifici per gli amministratori dei clienti nell'organizzazione a cui viene applicata l'impostazione. |
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità con limitazioni per partner. Dopo l'accesso, verrà visualizzato un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner notifica all'amministratore del cliente che la modalità con limitazioni è abilitata e che potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore del cliente in un'organizzazione in cui è abilitata la modalità Con limitazioni per partner, il livello di accesso a Control Hub viene determinato con la seguente formula:
(accesso a Control Hub) = (diritti ruolo organizzazione) - (limitazioni della modalità partner)
Gli amministratori dei clienti dovranno affrontare diverse limitazioni, indipendentemente dalla modalità con limitazioni per partner. Tali restrizioni comprendono:
- Impostazioni chiamata: Le impostazioni 'Opzioni app Priorità chiamata' nel menu Chiamata sono di sola lettura.
- Impostazione posizione: L'impostazione della chiamata dopo la creazione della posizione verrà nascosta.
- Gestione PSTN e registrazione chiamate: Queste opzioni verranno disattivate per la posizione.
- Gestione dei numeri di telefono: Nel menu Chiamata, la gestione del numero di telefono è disabilitata e le impostazioni 'Opzioni app priorità chiamata', così come le registrazioni delle chiamate, sono di sola lettura.
Restrizioni
Quando la modalità Con limitazioni per partner è abilitata per un'organizzazione cliente, agli amministratori dei clienti di tale organizzazione viene impedito di accedere alle seguenti impostazioni di Control Hub:
-
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
-
Pulsante Gestisci utenti: disattivato.
-
Aggiungi o modifica manualmente utenti: nessuna opzione per aggiungere o modificare gli utenti, né manualmente né tramite CSV.
-
Richiedi utenti: non disponibile
-
Assegna automaticamente licenze: non disponibile
-
Sincronizzazione rubriche: impossibile modificare le impostazioni di sincronizzazione rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
-
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato ed e-mail principale* sono modificabili.
-
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
-
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, messaggi, riunioni, chiamate)
-
Visualizza stato servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
-
Numero di lavoro principale: questo campo è di sola lettura.
-
-
Nella vista Account, non sono disponibili le seguenti impostazioni:
-
Nome società: campo di sola lettura.
-
-
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
-
Dominio: accesso di sola lettura.
-
E-mail: le impostazioni Elimina inviti e-mail di amministrazione e Selezione impostazioni internazionali e-mail sono di sola lettura.
-
Autenticazione: nessuna opzione per la modifica delle impostazioni di autenticazione e SSO.
-
-
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
-
Impostazioni chiamata: le impostazioni di priorità della chiamata delle opzioni dell'app sono di sola lettura.
-
Funzionamento chiamata: le impostazioni sono di sola lettura.
-
Posizione > PSTN: le opzioni Gateway locale e Cisco PSTN sono nascoste.
-
-
Sotto SERVIZI, le opzioni di servizio Migrazioni e Connected UC vengono eliminate.
Abilitazione limitata dalla modalità partner
Gli amministratori dei partner possono utilizzare la procedura seguente per abilitare Con limitazioni della modalità partner per una determinata organizzazione cliente (l'impostazione predefinita è abilitata).
-
Accedere a Partner Hub ( https://admin.webex.com) e selezionare Clienti.
-
Seleziona l'organizzazione cliente applicabile.
-
Nella vista delle impostazioni a destra, abilitare il tasto di alternanza Con limitazioni in modalità partner per attivare l'impostazione.
Se si desidera disattivare la modalità con limitazioni partner, disabilitare il tasto di alternanza.
Se il partner rimuove la modalità amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà eseguire quanto segue:
|
Per ulteriori informazioni sull'elenco dei fusi orari supportati per il provisioning all'ingrosso, vedere l' elenco dei fusi orari supportati per il provisioning all'ingrosso.
Analisi dei partner
I miglioramenti apportati a Control Hub consentono agli amministratori dei partner di visualizzare e aggiornare facilmente le informazioni sul pacchetto per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata tra tutti i clienti e include i seguenti dettagli:
-
Totale utenti per pacchetto (softphone, base, standard, premium)
-
Tendenza utente per pacchetto (giornaliera/settimanale/mensile)
-
Clienti con n. di pacchetti assegnati
Per informazioni dettagliate su come utilizzare l'analisi dei partner, vedi l'articolo Webex Analisi per Webex per la vendita all'ingrosso e Webex per i pacchetti BroadWorks in Partner Hub.
API di report fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare report di fatturazione. Nella tabella seguente vengono elencate le API, il tipo di accesso richiesto e i requisiti di ruolo.
API di fatturazione |
Finalità |
Tipo di accesso |
Requisiti di ruolo per API (L'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Creazione di un report di fatturazione BroadWorks |
Utilizzato per generare un report di fatturazione. |
Accesso in scrittura |
|
Elenca report di fatturazione BroadWorks |
Consente di elencare i report disponibili per la visualizzazione. |
Accesso in lettura |
|
Ottenere un report di fatturazione BroadWorks |
Utilizzato per ottenere una copia di un report generato. |
Accesso in lettura |
|
Eliminazione di un report di fatturazione BroadWorks |
Utilizzato per eliminare un report generato. |
Accesso scrittura |
|
Campi di fatturazione
Nella tabella seguente sono elencati i campi contenuti nel report generato.
Campo |
Descrizione |
---|---|
nome rivenditore |
Nome partner o ID organizzazione partner |
ID fatturazione |
Identificativo di fatturazione univoco del partner o numero C |
IdImpresaSp |
L'identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno |
Stato versione di prova interna del cliente (Sì/No) |
ID utente |
IDutente dell'abbonato su BroadWorks |
id abbonato |
Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato |
Sì/No |
Data iniziale |
Data di provisioning dell'abbonato. |
dataInizioFatturazione |
Data di inizio fatturazione in questo mese |
DataFineFatturazione |
Data di fine fatturazione in questo mese |
pacchetto |
Il tipo di confezione che viene caricata |
quantità |
Quantità ripartita per fatturazione.
|
|
Risoluzione dei problemi di Webex per Cisco BroadWorks
Abbonamento alla pagina di stato Webex
Innanzitutto, controllare https://status.webex.com quando si verifica un'interruzione imprevista del servizio. Se non hai modificato la tua configurazione in Control Hub o BroadWorks prima dell'interruzione, controlla la pagina di stato. Ulteriori informazioni sull'iscrizione per le notifiche di stato e incidenti al Centro assistenza Webex.
Usa analisi Control Hub
Webex monitora l'utilizzo e i dati di qualità per la tua organizzazione e le organizzazioni dei tuoi clienti. Ulteriori informazioni sulle analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
Clienti o utenti non vengono creati in Control Hub con provisioning flowthrough:
-
Il server applicazioni può raggiungere l'URL di provisioning?
-
L'account di provisioning e la password sono corretti? Tale account esiste in BroadWorks?
I cluster non riescono in modo coerente a eseguire i test di connettività:
La connessione mTLS al servizio di autenticazione non riesce quando si crea il primo cluster in Partner Hub, poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. In caso contrario, non è possibile creare un'ancora attendibile sul servizio di autenticazione XSP|ADPs, pertanto la connessione mTLS di prova da Partner Hub non viene eseguita correttamente. |
-
Le interfacce XSP|ADP sono accessibili pubblicamente?
-
Stai utilizzando le porte corrette? È possibile immettere una porta nella definizione dell'interfaccia sul cluster.
Convalida non riuscita interfacce
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso
/v2.0/
alla fine degli URL. -
Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
-
Esaminare i consigli per la configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso
/v2.0/
alla fine degli URL. -
Controlla che il firewall consenta la comunicazione tra Webex e queste interfacce.
-
Rivedere i consigli sulla configurazione dell'interfaccia in questo documento, con particolare attenzione a:
- Accertarsi di aver condiviso le chiavi RSA in tutti gli XSP|ADP.
- Accertarsi di aver fornito l'URL AuthService al contenitore Web su tutti gli XSP|ADP.
- Se è stata modificata la configurazione della crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. XSP|ADP richiede di immettere il formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento elencava erroneamente le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
-
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati sul proprio archivio attendibilità XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere i certificati del client?
-
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere i certificati del client?
Problemi del cliente
Verificare che il client sia connesso a BroadWorks
-
Accedere all'app Webex.
-
Verificare che l'icona Opzioni di chiamata (un ricevitore con una marcia sopra) sia presente sulla barra laterale.
Se l'icona non è presente, l'utente potrebbe non essere ancora abilitato per il servizio di chiamata in Control Hub.
-
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici . Viene visualizzato lo stato Sessione SSO A cui è stato eseguito l'accesso.
Se viene visualizzato un servizio telefonico diverso, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Tale verifica comporta:
-
Il client ha eseguito correttamente il transveresed dei microservizi Webex richiesti.
-
Autenticazione dell'utente eseguita correttamente.
-
Il client ha ricevuto un token Web JSON di lunga durata dal sistema BroadWorks.
-
Il client ha recuperato il proprio profilo dispositivo e si è registrato su BroadWorks.
Registri client
Tutti i client dell'app Webex possono Inviare I Registri a Webex. Questa è l'opzione migliore per i client mobili. È inoltre necessario registrare l'indirizzo e-mail dell'utente e l'ora approssimativa in cui si è verificato il problema se si sta cercando assistenza da TAC. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se è necessario raccogliere manualmente i registri da un PC Windows, si trovano come segue:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac: /Utenti/{username}/Libreria/Registri/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS configurata male
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
-
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
-
Verificare che la catena di certificati Webex sia installata come ancora affidabile.
-
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e firmato da una CA ben nota.
Messaggio di eccedenza licenza
Questo messaggio può apparire per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'utilizzo delle licenze supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Politica di supporto allo stato stazionario
Il provider di servizi è il primo punto di contatto per il supporto del cliente finale (aziendale). Inoltrare i problemi che il SP non è in grado di risolvere al centro TAC. Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Per ulteriori informazioni, consultare la sezione Politica sul ciclo di vita dei prodotti BroadSoft nella sezione Politica sul ciclo di vita BroadSoft e Matrice di compatibilità software BroadWorks.
Politica di escalation
-
Tu (provider di servizi/partner) sei il primo punto di contatto per il supporto clienti finali (aziendale).
-
I problemi che non possono essere risolti dal SP vengono inoltrati al centro TAC.
Versioni di BroadWorks
-
Il supporto della versione del server BroadWorks segue la policy BroadSoft della versione corrente e di due versioni principali precedenti (N-2). Per ulteriori informazioni, consultare la sezione Politica sul ciclo di vita dei prodotti BroadSoft nella sezione Politica sul ciclo di vita BroadSoft e Matrice di compatibilità software BroadWorks.
Risorse di autosupporto
-
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, dove è presente una pagina specifica di Webex per Cisco BroadWorks che elenca argomenti di Guida e supporto comuni dell'app Webex.
-
L'app Webex può essere personalizzata con questo URL della Guida e un URL di segnalazione problemi.
-
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I registri vengono inviati al cloud Webex, dove possono essere analizzati da Webex DevOps.
-
È disponibile anche una pagina Centro assistenza dedicata alla Guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccogliere informazioni per l'invio di una richiesta di assistenza
Quando vengono visualizzati errori in Control Hub, potrebbero essere allegate informazioni che possono aiutare TAC a indagare sul problema. Ad esempio, se viene visualizzato un ID di verifica per un particolare errore o un codice di errore, salvare il testo da condividere con noi.
Prova a includere almeno le seguenti informazioni quando invii una query o apri un caso:
-
ID organizzazione cliente e ID organizzazione partner (ciascun ID è una stringa di 32 cifre esadecimali, separate da trattini)
-
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce uno
-
Indirizzo e-mail utente (se un particolare utente riscontra problemi)
-
Versioni del cliente (se il problema presenta sintomi notati attraverso il cliente)
Confronto UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > |
SaaS UC-One |
Webex per Cisco BroadWorks |
---|---|---|
Cloud |
Cisco UC-One Cloud (GCP) |
Webex Cloud (AWS) |
Client |
UC-One: Mobile, desktop Receptionist, Supervisore |
Webex: Mobile, desktop, Web |
Principale differenza tecnologica |
Riunioni condotte sulla tecnologia BroadSoft Meet |
Riunioni fornite sulla tecnologia Webex Meetings |
Prove sul campo iniziali |
Contesto di stadiazione, clienti beta |
Ambiente di produzione, clienti GA |
Identità utente |
ID BroadWorks servito come ID principale, a meno che il provider di servizi non disponga già dell'integrazione SSO.
ID utente e segreto in BroadWorks |
ID e-mail in Cisco CI serve come ID principale Integrazione SSO in BroadWorks provider di servizi in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks al momento.
L'utente fornisce le credenziali tramite SSO con BroadWorks e Secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e segreti in IdP |
Autenticazione client |
Gli utenti forniscono le credenziali attraverso il client Token di lunga durata BroadWorks richiesti se si utilizza la messaggistica Webex |
Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso a Webex e aggiornamento dei token |
Gestione / configurazione |
I vostri sistemi OSS/BSS e Portale rivenditore |
I tuoi sistemi OSS/BSS e Control Hub |
Attivazione partner/provider di servizi |
Impostazione una tantum da Cisco Operations |
Impostazione una tantum da Cisco Operations |
Attivazione cliente/azienda |
Portale rivenditore |
Control Hub Creato automaticamente alla prima iscrizione utente |
Opzioni di attivazione utente |
Autoiscrizione Imposta IM&P esterno in BroadWorks
|
Impostazione di IM&P integrato in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP |
Azioni XSI
XSI-Eventi CTI (mTLS) AuthService (mTLS opzionale) DMS |
Azioni XSI Azioni XSI (mTLS) XSI-Eventi CTI (mTLS) Servizio di autenticazione (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 |
Scarica e installa Webex. Per informazioni dettagliate, vedi Webex | Download dell'app. |
2 |
Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 |
Inserisci l'indirizzo e-mail e fai clic su Avanti. |
4 |
Una delle seguenti operazioni si verifica, a seconda del modo in cui l'organizzazione è configurata in Webex: Webex si carica dopo aver eseguito correttamente l'autenticazione su IdP o BroadWorks.
|
Scambio e archiviazione dati
Queste sezioni forniscono dettagli sullo scambio e la memorizzazione dei dati con Webex. Tutti i dati vengono crittografati sia in transito che a riposo. Per ulteriori informazioni, vedi Webex App Security.
Onboarding provider servizi
Quando si configurano cluster e modelli utente in Webex Control Hub durante l'onboarding di provider di servizi, è possibile scambiare i seguenti dati BroadWorks memorizzati in Webex:
-
URL Xsi-Actions
-
URL Xsi-Events
-
URL interfaccia CTI
-
URL servizio di autenticazione
-
Credenziali adattatore di provisioning BroadWorks
Provisioning utente provider di servizi
Questa tabella elenca i dati utente e aziendale che vengono scambiati come parte del provisioning utente attraverso le API Webex.
Trasferimento dei dati in Webex |
Da |
Attraverso |
Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito da SP) |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito dall’utente) |
Utente |
Portale di attivazione utente |
Sì |
Nome |
BroadWorks, per API |
API Webex |
Sì |
Cognome |
BroadWorks, per API |
API Webex |
Sì |
Numero di telefono principale |
BroadWorks, per API |
API Webex |
Sì |
Numero di telefono cellulare |
BroadWorks, per API |
API Webex |
Sì |
Interno principale |
BroadWorks, per API |
API Webex |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
BroadWorks, per API |
API Webex |
Sì |
Lingua |
BroadWorks, per API |
API Webex |
Sì |
Fuso orario |
BroadWorks, per API |
API Webex |
Sì |
Rimozione utente
Le API Webex per Cisco BroadWorks supportano la rimozione parziale e completa dell'utente. Questa tabella elenca tutti i dati utente memorizzati durante il provisioning e ciò che viene eliminato in ogni scenario.
Dati utente |
Eliminazione parziale |
Eliminazione completa |
---|---|---|
ID utente BroadWorks |
Sì |
Sì |
|
No |
Sì |
Nome |
No |
Sì |
Cognome |
No |
Sì |
Numero di telefono principale |
Sì |
Sì |
Numero di telefono cellulare |
Sì |
Sì |
Estensione |
Sì |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
Sì |
Sì |
Lingua |
No |
Sì |
Accesso utente e recupero configurazione
Autenticazione Webex
L'autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da uno qualsiasi dei meccanismi di autenticazione del supporto Webex. (L'autenticazione BroadWorks è trattata separatamente.) Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati |
Da |
Per |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (indipendente) |
Webex |
Browser utente |
Credenziali utente |
Browser utente |
Provider identità (che dispone già di identità utente) |
asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Token di accesso e aggiornamento |
Webex |
Browser utente |
Token di accesso e aggiornamento |
Browser utente |
App Webex |
Autenticazione BroadWorks
L'autenticazione BroadWorks si riferisce all'accesso dell'utente a un'app Webex utilizzando le credenziali BroadWorks. Questa tabella illustra il tipo di dati scambiati tra le diverse componenti sul flusso di autenticazione.
Trasferimento dei dati |
Da |
Per |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (proxy Webex Bwks IdP) |
Webex |
Browser utente |
Informazioni sul branding e URL BroadWorks |
Webex |
Browser utente |
Credenziali utente BroadWorks |
Utente tramite browser (pagina di accesso con marchio servita da Webex) |
Webex |
Credenziali utente BroadWorks |
Webex |
BroadWorks |
Profilo utente BroadWorks |
BroadWorks |
Webex |
asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Token di accesso e aggiornamento |
Webex |
Browser utente |
Token di accesso e aggiornamento |
Browser utente |
App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento dell'avviso di accesso e del messaggio di errore:
- Attualmente gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso poiché la password è già scaduta. Con questa funzione, se la password sta per scadere tra 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere, con l'indicazione di quanti giorni rimangono, e all'utente viene consigliato di contattare il partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su true, è stato emesso l'errore "nome utente e password errati", ma ora con questa funzione viene migliorato il messaggio di errore: Tentativo di accesso non riuscito. La combinazione di ID utente e password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprovare o contattare l'amministratore per aggiornare la password. Codice errore 100006
Controllo flusso di accesso:
- Il partner può limitare l'accesso abilitando un'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, quindi viene visualizzato un errore che indica che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso può essere configurato dal partner come parte della funzione di personalizzazione avanzata. I partner solitamente configurano il collegamento per passare dall'utente a un portale partner per la gestione della password e la reimpostazione della password.
Questa funzione migliora l'esperienza di accesso utente solo durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se una password scade mentre l'utente è connesso all'app Webex. L'utente riceve la notifica di scadenza della password al successivo tentativo di accesso. |
Recupero configurazione cliente
Questa tabella illustra la tipologia di dati scambiati tra le diverse componenti in fase di recupero delle configurazioni del cliente.
Trasferimento dei dati |
Da |
Per |
---|---|---|
Iscrizione |
Cliente |
Webex |
Impostazioni organizzazione, inclusi URL BroadWorks |
Webex |
Cliente |
Token JWT BroadWorks |
BroadWorks attraverso Webex |
Cliente |
Token JWT BroadWorks |
Cliente |
BroadWorks |
Token dispositivo |
BroadWorks |
Cliente |
Token dispositivo |
Cliente |
BroadWorks |
File di configurazione |
BroadWorks |
Cliente |
Utilizzo allo stato stazionario
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione dopo la scadenza del token, tramite BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Trasferimento dei dati |
Da |
Per |
---|---|---|
Segnalazione SIP |
Cliente |
BroadWorks |
Supporto SRTP |
Cliente |
BroadWorks |
Segnalazione SIP |
BroadWorks |
Cliente |
Supporto SRTP |
BroadWorks |
Cliente |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Trasferimento dei dati |
Da |
Per |
---|---|---|
Messaggistica e presenza REST HTTPS |
Cliente |
Webex |
Messaggistica e presenza REST HTTPS |
Webex |
Cliente |
Segnalazione SIP |
Cliente |
Webex |
Supporto SRTP |
Cliente |
Webex |
Segnalazione SIP |
Webex |
Cliente |
Supporto SRTP |
Webex |
Cliente |
Uso dell'API di provisioning
Accesso sviluppatore
La specifica API è disponibile su https://developer.webex.com e una guida all'uso è disponibile su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l'accesso per leggere le specifiche API all'indirizzo https://developer.webex.com/docs/api/v1/broadworks-subscriber.
Autenticazione e autorizzazione applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (ad esempio provisioning abbonato) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere l'aggiornamento e l'accesso ai token per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
Devi prima registrare la tua integrazione con Webex. Una volta eseguita la registrazione, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di accesso e aggiornamento necessari.
Per ulteriori dettagli sulle integrazioni e su come creare questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli obbligatori per l'implementazione delle integrazioni: sviluppatore e utente autorizzatore, che possono essere svolti da persone/team separati nel proprio ambiente.
|
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning utilizzata:
-
Modalità Enterprise: il nome dell'organizzazione corrisponde esattamente a spEnterpriseId.
-
Modalità provider di servizi: il nome dell'organizzazione è la parte groupID di spEnterpriseId.
Il nome dell'organizzazione conterrà qualsiasi spazio vuoto, maiuscolo e caratteri speciali specificati in spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione del ciclo di vita - server BroadSoft.
Ci aspettiamo che il provider di servizi sia "attuale" con le ultime patch BroadWorks e le app Release Independent (RI). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Assicurarsi di rivedere le note di patch per queste patch software. Alcune patch potrebbero avere requisiti CLI aggiuntivi. |
Versione R22
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazioni | ||
Richiesto per sincronizzazione rubrica | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per il server applicazioni | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per la funzione di registrazione chiamata | ||
Patch richiesta per il provisioning flow-through | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Server profilo | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
XSP|ADP |
Richiesto per proxy autenticazione NPS | |
Richiesto per il servizio di autenticazione con convalida token CI | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Obbligatorio per la cronologia chiamate unificata | ||
Altro |
AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazioni |
Richiesto per sincronizzazione rubrica | |
Configurazione server app | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Server profilo | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
XSP|ADP | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Altro |
Se si utilizza ADP... |
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate |
Versione R24
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazioni |
Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per il provisioning flowthrough | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Altro |
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che è necessario configurare per Webex, fare riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utente e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. L'attivazione include la convalida e-mail e l'assegnazione del servizio in Webex. |
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se disponi di indirizzi e-mail affidabili per gli utenti, puoi scegliere di attivarli automaticamente quando esegui il provisioning automatico degli utenti. Questo processo è "provisioning automatico e attivazione automatica".
Provisioning utente automatizzato e attivazione automatica (flusso e-mail affidabile)
Prerequisiti
-
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
-
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
-
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase |
Descrizione |
---|---|
1 |
Citare e prendere ordini per il servizio con i clienti. |
2 |
Si elabora l'ordine del cliente e si esegue il provisioning del cliente nei sistemi. |
3 |
Il sistema di provisioning dei servizi attiva il provisioning di BroadWorks. Questo passaggio, in sintesi, crea l'azienda e gli utenti. Quindi assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM&P esterno. |
4 |
Questo passaggio di provisioning attiva il provisioning automatico dell'organizzazione cliente e degli utenti in Webex. (L'assegnazione del servizio IM&P determina che l'adattatore di provisioning chiami l'API di provisioning Webex). |
5 |
I sistemi devono utilizzare l'API di provisioning Webex se successivamente è necessario regolare il pacchetto per l'utente (per passare dall'impostazione predefinita). |
Flusso di accesso SSO
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, che consente l'autenticazione diretta a BroadWorks. L'immagine mostra gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresenta ciò che il client prevede per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizio BroadWorks che segue immediatamente il flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione BroadWorks diretta abilitata (condivisione risorse cross-origin). Di seguito sono riportati alcuni flussi di accesso SSO SAML alternativi:
-
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
-
L'unica differenza è nei punti 5 e 6 del flusso di accesso Webex. Nel passaggio 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
-
Il flusso procede attraverso i restanti passaggi dei due diagrammi.
-
Il token SSO non viene utilizzato in questo flusso.
-
-
Autenticazione SSO SAML Webex:
-
Nel passaggio 3 del flusso di accesso Webex, il servizio Common Identity restituisce il provider di identità utilizzato dall'autenticazione Webex.
-
A questo punto, viene invocato un flusso di accesso SSO SAML alternativo per Webex.
-
Interazioni utente
Accedi
-
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
-
CI rileva che l'organizzazione cliente associata dispone del proxy IDP BroadWorks (IDP) configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso (il provider di servizi può contrassegnare questa pagina di accesso).
-
L'utente inserisce le credenziali BroadWorks.
-
Broadworks esegue l'autenticazione dell'utente attraverso l'IDP. In caso di successo, l'IDP reindirizza il browser a CI con un SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
-
Una volta completata l'autenticazione, l'app Webex ottiene i token di accesso da CI (non mostrati nel diagramma). Il client li utilizza per richiedere un token Web Jason (JWT) di lunga durata BroadWorks.
-
L'app Webex rileva la configurazione di chiamata da BroadWorks e altri servizi da Webex.
-
L'app Webex si registra in BroadWorks.
Accesso dalla prospettiva dell'utente
Questo diagramma è il tipico flusso di accesso, visualizzato dall'utente finale o dall'abbonato:
-
Scarica e installa l'app Webex.
-
È possibile che tu abbia ricevuto il collegamento dal provider di servizi o che tu possa trovare il download nella pagina di download di Webex.
-
Inserire l'indirizzo e-mail nella schermata di accesso Webex. Fai clic su Avanti.
-
Solitamente, si viene reindirizzati a una pagina con il marchio del fornitore di servizi.
-
Questa pagina potrebbe accogliervi tramite il vostro indirizzo e-mail.
Se non è presente alcun indirizzo e-mail o se l'indirizzo e-mail è errato, inserisci il nome utente BroadWorks.
-
Inserisci la password BroadWorks.
-
Se è stato eseguito correttamente l'accesso, Webex si apre.
Flusso chiamate - Rubrica aziendale
Flusso chiamata: numero PSTN
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni con i clienti
Recupero del profilo dal registro DMS e SIP con AS
-
Il client chiama XSI per ottenere un token di gestione dispositivo e l'URL del DMS.
-
Il client richiede il proprio profilo dispositivo dal DMS presentando il token dal punto 1.
-
Il client legge il profilo del dispositivo e recupera le credenziali, gli indirizzi e le porte SIP.
-
Il Client invia un REGISTRO SIP a SBC utilizzando le informazioni dal punto 3.
-
SBC invia il REGISTRO SIP al SA (l'SBC può eseguire una ricerca nell'NS per individuare un SA se il SBC non conosce già l'utente SIP).
Linee guida per test e laboratorio
Le seguenti linee guida si applicano alle organizzazioni di test e laboratorio:
-
I partner provider di servizi sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
-
Tutti gli utenti oltre i primi 50 utenti di test verranno fatturati.
-
Per garantire un'elaborazione accurata sulla fattura, tutte le organizzazioni di test devono includere il "test" nel nome dell'organizzazione BroadWorks.
-
Le organizzazioni di test interni devono essere designate all'interno di Webex Control Hub. Ciò al fine di impedire agli utenti di test di essere fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di prova:
-
Accedi a Partner Hub e seleziona Clienti.
-
Selezionare il cliente appropriato.
-
Nella barra di controllo destra, abilitare il tasto di alternanza Organizzazione test interni.
Riproduzione casella vocale
Per la casella vocale, accertarsi di configurare il server multimediale per utilizzare uno dei seguenti codici:
-
mp3
-
wav: i file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android
Se si utilizzano i file wav, eseguire i seguenti comandi CLI per configurare il server applicazioni e il server multimediale:
-
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
-
MS_CLI/Applications/MediaStreaming/Services/IVR> impostare sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACL
- Elenco di controllo accessi
- ALG
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APNS
- Servizio di notifica push Apple
- AS
- Server applicazioni
- ATA
- Adattatore per telefono analogico, adattatore che converte la telefonia analogica in VoIP
- BAM
- Gestione applicazioni BroadSoft
- Autenticazione di base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- BMS
- Server di messaggistica BroadSoft
- BOSH
- Flussi bidirezionali Su HTTP sincrono
- BRI
- Basic Rate Interface BRI è un metodo di accesso ISDN
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- CA
- Autorità di certificazione
- Vettore
- Un'organizzazione che gestisce il traffico telefonico (cfr. partner, provider di servizi, rivenditore a valore aggiunto)
- CAPTCHA
- Test di Turing pubblico completamente automatizzato per distinguere Computer ed Esseri Umani
- CCXML
- Linguaggio di markup eXtensible controllo chiamate
- CIF
- Formato intermedio comune
- CLI
- Interfaccia riga di comando
- CN
- Nome comune
- CNPS
- Server push notifiche chiamate. Un server push di notifica che viene eseguito su un XSP|ADP nel proprio ambiente per eseguire notifiche di chiamata push su FCM e APNS. Vedere il proxy NPS.
- DPC
- Attrezzatura della sede del cliente
- CPR
- Regola presenza personalizzata
- CSS
- Foglio stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione telefonia computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- Non disturbare
- Non disturbare
- DNS
- Sistema dei nomi di dominio
- DPG
- Chiama gruppo di pari
- DSCP
- Punto codice servizi differenziati
- DTAF
- File di archivio tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza a doppia tonalità
- Utente finale
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. Sottoscrittore)
- Aziendale
- Una raccolta di utenti finali (cfr. Organizzazione)
- FCM
- Messaggistica cloud Firebase
- FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creare utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks.
- FQDN
- Nome di dominio completo
- Provisioning completo flow-through
- Creare e verificare gli utenti nell'archivio delle identità Webex assegnando il servizio "IM&P integrato" in BroadWorks e asserendo che ciascun utente BroadWorks dispone di un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. È la spina sul telefono o fax o i connettori sul sistema telefonico analogico. Fornisce un'indicazione di aggancio/aggancio sganciato (chiusura con loop). Poiché la porta FXO è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo FXO".
- FXS
- Foreign Exchange Subscriber è la porta che effettivamente fornisce la linea analogica all'abbonato. In altre parole, è la "spina nella parete" che fornisce un segnale di linea, corrente della batteria e tensione della suoneria.
- GCM
- Messaggio cloud Google
- GCM
- Modalità Galois/Counter (tecnologia di crittografia)
- HID
- Dispositivo interfaccia uomo
- HTTPS
- Prese protette da protocollo di trasferimento ipertestuale
- IAD
- Dispositivo di accesso integrato
- IM&P
- Messaggistica istantanea e presenza
- PSTN IP
- Un provider di servizi che fornisce VoIP ai servizi PSTN, intercambiabile con ITSP, o un termine generale per la telefonia "pubblica" connessa a Internet, fornito collettivamente dai principali provider di telecomunicazioni (piuttosto che dai paesi, come è PSTN)
- ITSP
- Provider servizi di telefonia Internet
- IVR
- Risposta vocale interattiva / Rispondente
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificatore Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notazione oggetto script Java
- JSSE
- Java Secure Socket Extension; la tecnologia sottostante che fornisce funzioni di connettività sicure ai server BroadWorks
- KEM
- Modulo interno chiave (telefoni Cisco hardware)
- LLT
- Token di lunga durata (o Long Life): token di connessione autodescrittivo e sicuro che consente agli utenti di rimanere autenticati più a lungo e non è legato ad applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIB
- Base di informazioni di gestione
- Sclerosi multipla
- Server multimediale
- mTLS
- Autenticazione reciproca tra due parti, tramite scambio di certificati, quando si stabilisce una connessione TLS
- MUC
- Chat con più utenti
- NAT
- Traduzioni dell'indirizzo di rete
- NPS
- Server push notifica; vedere CNPS
- Proxy NPS
-
Un servizio in Webex che fornisce token di autorizzazione di breve durata al CNPS, consentendo di eseguire notifiche di chiamata push a FCM e APN e, in ultima analisi, a dispositivi Android e iOS con Webex.
- OCI
- Apri interfaccia client
- Organizzazione
- Società o organizzazione che rappresentano un insieme di utenti finali (cfr. Impresa)
- OTG
- Gruppo di trunk in uscita
- Pacchetto
- Una raccolta di servizi come forniti a un utente finale o abbonato (cfr. Pacchetto)
- Partner
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. rivenditore a valore aggiunto, fornitore di servizi, gestore telefonico)
- PBX
- Borsa filiale privata
- PEM
- E-mail avanzata per la privacy
- PLMN
- Rete mobile terrestre pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia per le telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- PS (Rendimento lordo)
- Server profilo
- PSTN
- Rete telefonica commutata pubblica
- Qualità di vita
- Qualità del servizio
- Portale rivenditore
- Sito web che consente all’amministratore del rivenditore di configurare la soluzione UC-One SaaS. Talvolta viene indicato come portale BAM, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Revisore di frontiera sessione
- SCA
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; un'organizzazione che fornisce servizi di telefonia o correlati ad altre organizzazioni (cfr. vettore, partner, rivenditore a valore aggiunto)
- SIP
- Protocollo di avvio sessione
- SLT
- Token di breve durata (o Short Life) (chiamato anche BroadWorks SSO Token); token autenticato monouso utilizzato per accedere in sicurezza ad applicazioni Web.
- PMI
- Piccole e medie imprese
- SNMP
- Protocollo di gestione di rete semplice
- sRTCP
- protocollo di controllo trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- sRTP
- protocollo di trasferimento in tempo reale sicuro (supporto chiamata VoIP)
- SSL
- Strato di prese sicure
- Sottoscrittore
- La persona che utilizza i servizi, ovvero effettua chiamate, partecipa a riunioni o invia messaggi (cfr. utente finale)
- TCP
- Protocollo di controllo del cambio
- TDM
- Divisione Tempo Multiplexing
- TLS
- Sicurezza livello trasporto
- ToS
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Comunicazioni unificate
- UI
- Interfaccia utente
- UID
- Identificativo univoco
- UMS
- Server di messaggistica
- URI
- Identificativo risorsa uniforme
- URL
- Ricerca risorse uniformi
- USS
- Condivisione server
- UTC
- Tempo universale coordinato
- UVS
- Server video
- Rivenditore a valore aggiunto (VAR)
- Un'organizzazione di agenti che collabora con Cisco per distribuire prodotti e servizi ad altre organizzazioni (cfr. vettore, partner, fornitore di servizi)
- VGA
- Array di grafica video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Linguaggio di markup estensibile vocale
- WebDAV
- Creazione e versioni distribuite su Web
- WebRTC
- Comunicazioni Web in tempo reale
- WRS
- Server WebRTC
- XMPP
- Protocollo di presenza e messaggistica estendibile
Configurazione dei servizi (con mTLS per il servizio autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida token CI. Queste procedure sono obbligatorie se si stanno eseguendo più organizzazioni Webex dallo stesso server XSP|ADP. In caso contrario, sono facoltativi.
Se non si eseguono più organizzazioni Webex dallo stesso server XSP|ADP, si consiglia la convalida del token CI (con TLS) per il servizio di autenticazione. Fare riferimento a Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs per informazioni dettagliate su come configurare il servizio di autenticazione e altri servizi. |
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome applicazione di controllo chiamata definito in Applicazioni/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> get
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o la mancanza dello stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia. |
Configurazione del servizio di autenticazione (con mTLS)
I token BroadWorks di lunga durata vengono generati e convalidati dal servizio di autenticazione ospitato sui tuoi XSP|ADP.
Requisiti
-
I server XSP|ADP che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
-
XSP|ADPs deve condividere le stesse chiavi per crittografare/decrittografare i token longevi di BroadWorks. Copiare queste chiavi in ogni XSP|ADP è un processo manuale.
-
XSP|ADPs deve essere sincronizzato con NTP.
Panoramica sulla configurazione
La configurazione essenziale su XSP|ADP include:
-
Distribuire il servizio di autenticazione.
-
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
-
Generare e condividere le chiavi RSA in XSP|ADP.
-
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ciascun XSP|ADP utilizzato con Webex:
-
Attivare l'applicazione del servizio di autenticazione sul percorso
/authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> attivazione autenticazione applicazioneService <versione> /authService
(dove
<versione>
è la versione di BroadWorks). -
Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
Distribuire l'applicazione/authService
Configurazione della durata del token
-
Verificare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
-
Impostare la durata su 60 giorni (max 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
impostazione tokenDurationInHours 1440
Genera e condividi chiavi RSA
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori è necessario generare chiavi su un XSP|ADP quindi copiarle su tutti gli altri XSP|ADP.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP. |
-
Selezionare un XSP|ADP da utilizzare per generare una coppia di tasti.
-
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
-
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
-
Copiare il file esportato
/var/broadworks/tmp/authService.keys
nella stessa posizione sugli altri XSP|ADP, sovrascrivendo un file meno recente.keys
se necessario. -
Importare le chiavi su ciascuno degli altri XSP|ADP:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al contenitore Web
Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token.
Su ciascuno degli XSP|ADP:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
impostare l'url http://127.0.0.1/authService
-
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> aggiungi tomcat bw.authservice.authServiceUrl http://127.0.0.1/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Controllare il parametro con
get
. -
Riavviare XSP|ADP.
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
-
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Immettere il comando
get
e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
-
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocol>
-
Immettere il comando
get <interfaceIp> 443
per vedere quali protocolli sono già utilizzati in questa interfaccia. -
Immettere il comando
Aggiungi <interfaceIp> 443 TLSv1.2
per assicurarsi che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
-
Accedere a XSP|ADP e andare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Immettere il comando
get <interfaceIp> 443
per visualizzare le crittografie già utilizzate in questa interfaccia. Deve essere presente almeno una delle suite consigliate Cisco (vedere XSP|ADP Requisiti di identità e sicurezza nella sezione Panoramica). -
Immettere il comando
Aggiungi <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia server HTTP.
La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, utilizzare:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>aggiungere 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per trovare la suite in base al nome.
Configurazione dell'attendibilità per il servizio di autenticazione (con mTLS)
-
Accedi a Control Hub con l'account amministratore del partner.
-
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain2023.txt
sul computer locale.
Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli XSP|ADP. Tutti i file sono obbligatori. -
Suddividere la catena del certificato in due certificati -
combinedcertchain2023.txt
.-
Aprire
combinedcertchain2023.txt
in un editor di testo. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
, e incollare il blocco di testo in un nuovo file. -
Salvare il nuovo file come
root2023.txt
. -
Salvare il file originale come
emissione2023.txt
. Il file originale dovrebbe ora avere un solo blocco di testo, circondato dalle righe-----START CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
. -
Accedere a XSP|ADP e passare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Eseguire la guidaUpdateTrust
per visualizzare i parametri e il formato di comando. -
Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot2023
,webexclientissuing
ewebexclientissuing2023
sono esempi di alias per i trust anchors; puoi utilizzare il tuo se tutte e quattro le voci sono univoche. -
Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[autofirmato]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, è richiesto mTLS per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
-
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
ed eseguire il comandoget
per visualizzare le interfacce. -
Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che significa come mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> aggiungi nome porta IPAddress vero vero
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. Essenzialmente, il primo
true
protegge l'interfaccia con TLS (il certificato del server viene creato se richiesto) e il secondotrue
forza l'interfaccia per richiedere l'autenticazione del certificato del client (insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Nome porta interfaccia Secure Client Auth Req Cluster Fqdn ======================================================= 192.0.2.7 443 XSP|ADP01.collab.example.net true false 192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (autenticazione client Req = true) è abilitato sulla porta 192.0.2.7
444
. TLS è abilitato sulla porta 192.0.2.7
443
.
(Opzione) Configurazione di mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o a livello di applicazione per web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si ospitano più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere solo una delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, è necessario mTLS per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
-
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
ed eseguire il comandoget
per visualizzare le applicazioni in esecuzione. -
Per aggiungere un'applicazione e richiederne l'autenticazione client (ovvero mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiungere IPAddress Port ApplicationName vero
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. I nomi delle applicazioni sono elencati qui. Il
true
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiungere 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService a 192.0.2.7:443 e richiede di richiedere e autenticare i certificati dal client.
Verificare con get
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> scarica
Nome applicazione porta IP interfaccia Auth client Req =================================================== 192.0.2.7 443 AuthenticationService true
Configurazione di Gestione dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Dove andare Avanti
Per la configurazione, è possibile accedere nuovamente al flusso dei documenti principale su Interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca rispetto a AuthService
Webex interagisce con il servizio di autenticazione su una connessione TLS autenticata reciproca. Ciò significa che Webex presenta un certificato client e XSP|ADP deve convalidarlo. Per rendere attendibile questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora attendibile su XSP|ADP (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
-
Vai a Impostazioni > BroadWorks Calling.
-
Fare clic sul collegamento del certificato di download.
È inoltre possibile scaricare la catena di certificati da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt. |
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i certificati XSP|ADP rivolti al pubblico:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy passante TLS
-
Direttamente a XSP|ADP
Il diagramma seguente riassume dove deve essere distribuita la catena di certificati CA Webex in questi tre casi.
Requisiti del certificato TLS reciproco per proxy bridge TLS
-
Webex presenta un certificato client firmato da CA Webex al proxy.
-
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità proxy, pertanto il proxy considera attendibile il certificato del client.
-
Nel proxy viene caricato anche il certificato del server XSP|ADP firmato pubblicamente.
-
Il proxy presenta un certificato server firmato pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Il certificato deve avere il campo di estensione x509.v3 Utilizzo chiave esteso popolato con l'OID BroadWorks 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo del clientAuth TLS. Ad esempio:
Estensioni X509v3:
Uso chiave estesa X509v3:
1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Durante la generazione dei certificati client interni per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
-
Gli XSP|ADP si fidano dell'autorità di certificazione interna.
-
Gli XSP|ADP presentano un certificato server firmato internamente.
-
Il proxy si fida della CA interna.
Requisiti di certificato TLS reciproco per proxy passthrough TLS o XSP in DMZ
-
Webex presenta un certificato client firmato da CA Webex agli XSP.
-
La catena di certificati CA Webex viene distribuita nell'archivio attendibilità degli XSP, pertanto gli XSP affidano il certificato client.
-
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
-
Gli XSP presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati server degli XSP.
Cronologia revisioni documenti
La tabella seguente mostra lo storico delle modifiche apportate a questo documento negli ultimi 12 mesi.
Data |
Versione | Descrizione della modifica | |
---|---|---|---|
09 agosto 2024 |
2-122 |
| |
01 agosto 2024 |
2-121 |
| |
25 giugno 2024 |
2-120 |
| |
14 giugno 2024 |
2-119 |
| |
13 maggio 2024 |
2-118 |
| |
10 maggio 2024 |
2-117 |
| |
6 maggio 2024 |
2-116 |
| |
2 maggio 2024 |
2-115 |
| |
10 aprile 2024 |
2-114 |
| |
27 marzo 2024 |
2-113 |
| |
22 marzo 2024 |
2-112 |
| |
7 marzo 2024 |
2-111 |
| |
24 febbraio 2024 |
2-110 |
| |
20 febbraio 2024 |
2-109 |
| |
7 febbraio 2024 |
2-108 |
| |
25 gennaio 2024 |
2-107 |
| |
23 gennaio 2024 |
2-106 |
| |
10 gennaio 2024 |
2-105 |
| |
20 dicembre 2023 |
2-104 |
| |
13 dicembre 2023 |
2-103 |
| |
12 dicembre 2023 |
2-102 |
| |
8 dicembre 2023 |
2-101 |
| |
08 novembre 2023 |
2-100 |
| |
25 ottobre 2023 |
2-99 |
| |
13 settembre 2023 |
2-98 |
| |
04 settembre 2023 |
2-97 |
| |
08 agosto 2023 |
2-96 |
| |
23 giugno 2023 |
2-95 |
| |
30 maggio 2023 |
2-94 |
| |
26 maggio 2023 |
2-93 |
| |
24 maggio 2023 |
2-92 |
| |
10 maggio 2023 |
2-91 |
| |
09 maggio 2023 |
2-90 |
| |
4 maggio 2023 |
2-89 |
| |
27 aprile 2023 |
2-88 |
| |
14 aprile 2023 |
2-87 |
| |
17 marzo 2023 |
2-86 |
| |
11 marzo 2023 |
2-85 |
| |
10 marzo 2023 |
2-84 |
| |
7 marzo 2023 |
2-83 |
| |
28 febbraio 2023 |
2-82 |
| |
15 febbraio 2023 |
2-81 |
| |
10 febbraio 2023 |
2-80 |
| |
Distribuisci Webex per BroadWorks
Panoramica della distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning utente. Molte delle attività sono comuni a tutte le modalità di provisioning.
Onboarding dei partner per Webex per Cisco BroadWorks
Ogni provider di servizi o rivenditore Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, devi eseguire la documentazione Webex Cisco BroadWorks e i nuovi partner devono accettare il Contratto ICPA (Indirect Channel Partner Agreement) online. Al termine di questi passaggi, Cisco Compliance crea una nuova organizzazione partner in Partner Hub (se necessario) e invia un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, l'attivazione del partner e/o il Customer Success Program Manager ti contatteranno per iniziare l'onboarding.
I partner Webex in una regione possono creare organizzazioni di clienti in qualsiasi regione che offriamo i servizi. Per informazioni, vedere: Residenza dati in Webex.
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
L'applicazione NPS deve essere eseguita su un XSP|ADP diverso. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi su XSP|ADP.
Servizio/Applicazione |
Autenticazione richiesta |
Scopo servizio/applicazione |
---|---|---|
Eventi XSI |
TLS (il server si autentica ai client) |
Controllo chiamate, notifiche servizi |
Azioni XSI |
TLS (il server si autentica ai client) |
Controllo chiamata, azioni |
Gestione dispositivi |
TLS (il server si autentica ai client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server si autentica ai client) |
Autenticazione utente |
Integrazione di telefonia tramite computer |
mTLS (client e server si autenticano a vicenda) |
Presenza telefonia |
Applicazione Webview impostazioni chiamata |
TLS (il server si autentica ai client) |
Espone le impostazioni di chiamata utente nel portale auto all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma è necessario fare riferimento alla documentazione esistente per ottenere le applicazioni installate su XSP|ADP.
Requisiti di coresidenza
-
Il servizio di autenticazione deve essere co-residente con le applicazioni Xsi poiché tali interfacce devono accettare token di lunga durata per l'autorizzazione al servizio. Il servizio di autenticazione è necessario per convalidare tali token.
-
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
-
È possibile separare gli altri servizi/applicazioni come richiesto per la propria scala (ad esempio, azienda agricola XSP|ADP di gestione dei dispositivi dedicata).
-
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
-
Non installare altre applicazioni o servizi su XSP|ADP utilizzati per l'integrazione di BroadWorks con Webex.
-
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce XSI
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia Cisco BroadWorks Xtended Services Interface.
È necessario distribuire solo un'istanza delle applicazioni Xsi-Events su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso callControlApplicationName definito in Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> Scarica
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente è inserito in Webex, Webex crea un abbonamento per l'utente sul AS per ricevere gli eventi di telefonia per la cronologia della presenza e delle chiamate. L'abbonamento è associato a callControlApplicationName e il AS lo utilizza per sapere a quali Xsi-Events inviare gli eventi di telefonia.
La modifica del callControlApplicationName o il mancato nome di tutte le app Web Xsi-Events avranno impatto sugli abbonamenti e sulla funzionalità degli eventi di telefonia.
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se si utilizza una versione R22 o successiva e il sistema lo supporta.
La funzionalità TLS reciproca (mTLS) è supportata anche come metodo di autenticazione alternativo per il servizio di autenticazione. Se si dispone di più organizzazioni Webex in esecuzione sullo stesso server XSP|ADP, è necessario utilizzare l'autenticazione mTLS poiché la convalida del token CI non supporta più connessioni allo stesso servizio di autorizzazione XSP|ADP.
Per configurare l'autenticazione mTLS per il servizio di autorizzazione anziché la convalida del token CI, fare riferimento all'Appendice per Configurazione dei servizi (con mTLS per il servizio di autorizzazione).
Se attualmente si utilizza mTLS per il servizio di autorizzazione, non è obbligatorio riconfigurare per utilizzare la convalida del token CI con TLS.
-
Recupero delle credenziali OAuth per Webex per Cisco BroadWorks.
-
Installare le seguenti patch su ciascun server XSP|ADP. Installare le patch appropriate alla versione in uso:
-
Per R22:
-
Per R23:
-
Per R24: nessuna patch richiesta
Qualsiasi riferimento a XSP include XSP o ADP.
-
-
Installare l'applicazione
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP nel percorso context /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> attiva applicazione AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire AuthenticationService su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> distribuisci applicazione /authServiceBroadWorks Distribuzione SW Manager distribuzione /authService...
-
A partire da BroadWorks build 2022.10, le autorità di certificazione che arrivano con Java non vengono più incluse automaticamente nell'archivio attendibilità di BroadWorks quando si passa a una nuova versione di Java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
-
IdenTrust Commercial Root CA 1
-
Autorità di certificazione radice Go Daddy - G2
Verificare che questi certificati siano presenti nella seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> ottieni
Se non è presente, eseguire il seguente comando per importare le entità affidabili Java predefinite:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come trust anchor con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono importate automaticamente nella nuova release e continueranno a essere importate fino a quando non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere FD di convalida del certificato Cisco BroadWorks X509.
-
-
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> ottieni
-
imposta clientId client-Id-From-Step1
-
impostazione abilitata true
-
imposta clientSecret client-Secret-From-Step1
-
imposta ciResponseBodyMaxSizeInBytes 65536
-
imposta issuerName <URL>
: per l'URL
, inserire l'URL IssuerName applicabile al cluster CI. Vedere la tabella seguente. -
set issuerUrl <URL>
: per l'URL
, inserire l'IssuerUrl applicabile al cluster CI. Vedere la tabella seguente. -
set tokenInfoUrl <IdPProxy URL>
: inserire l'URL del proxy IdP applicabile al cluster Teams. Vedere la seconda tabella riportata di seguito.
Tabella 1. Impostare issuerName e issuerURL Se il cluster CI è... Impostare issuerName e issuerURL su... USA
UE
US-B
Se non conosci il tuo Cluster CI, puoi ottenere le informazioni dai dettagli cliente nella vista Help desk di Control Hub.
Tabella 2. Imposta URL info token Se il cluster Teams è... Imposta URL info token su...(URL proxy IdP) acm
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
diaframma
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
aore
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
-
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista Help desk di Control Hub.
-
Per il test, è possibile verificare la validità dell'URL tokenInfo sostituendo la parte "idp/authenticate" dell'URL con "ping".
-
-
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> imposta ambito broadworks-connector:utente
-
Configura i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> ottieni
-
imposta flsUrl https://cifls.webex.com/federation
-
imposta periodo di aggiornamento in minuti 60
-
imposta refreshToken refresh-Token-From-Step1
-
-
Per verificare che la configurazione FLS funzioni, eseguire il comando seguente. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Ottieni
-
Configurare la gestione token utilizzando i seguenti comandi su ciascun server XSP|ADP:
-
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
-
imposta tokenIssuer BroadWorks
-
imposta tokenDurationInOre 720
-
-
Genera e condividi chiavi RSA. È necessario generare le chiavi su un XSP|ADP, quindi copiarle in tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
-
Devi utilizzare le stesse coppie di chiavi pubblica/privata per la crittografia/decrittografia del token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene prima richiesto di emettere un token.
Se si spostano i tasti in sequenza o si modifica la lunghezza della chiave, è necessario ripetere la seguente configurazione e riavviare tutti gli XSP|ADP.
-
Selezionare un XSP|ADP da utilizzare per la generazione di una coppia di chiavi.
-
Utilizzare un client per richiedere un token crittografato a tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(viene generata una coppia di chiavi privata/pubblica su XSP|ADP, se non ne era già presente una)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
esportaKeys
-
Copiare il file esportato
/var/broadworks/tmp/authService.keys
nella stessa posizione sugli altri XSP|ADP, sovrascrivendo un file.keys
precedente, se necessario. -
Importa le chiavi su ciascuno degli altri XSP|ADP:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
-
-
Fornire l'URL di authService al container Web. Il contenitore Web di XSP|ADP necessita dell'URL authService in modo da poter convalidare i token. Su ciascuno degli XSP|ADP:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
imposta URL http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> aggiungi tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Verificare il parametro con
get
. -
Riavviare XSP|ADP.
-
Rimuovi il requisito di autenticazione client per il servizio di autorizzazione (solo R24)
Se il servizio di autenticazione è configurato con la convalida del token CI su R24, è necessario anche rimuovere il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> imposta <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Authentication Service, Xsi-Actions e Xsi-Events utilizzano le interfacce del server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > Interfaccia server HTTP = Più specifica
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il comando
get
e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ogni interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> ottieni
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Inserire il comando
get <interfaceIp> 443
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserisci il comando
aggiungi <interfaceIp> 443 TLSv1.2
per assicurarti che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione di crittografia TLS sull'interfaccia del server HTTP
Per configurare le crittografie richieste:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Inserire il comando
get <interfaceIp> 443
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview). -
Inserire il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.L'XSP|ADP CLI richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizza:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>aggiungi 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base al nome.
Configura gestione dispositivi su XSP|ADP, server applicazioni e server di profilo
Il server di profilo e XSP|ADP sono obbligatori per la gestione dei dispositivi. Devono essere configurati in base alle istruzioni nella Guida alla configurazione di gestione dispositivi BroadWorks.
Interfaccia CTI e configurazione correlata
L'ordine di configurazione "da inmost a outmost" è elencato di seguito. Seguire questo ordine non è obbligatorio.
-
Configurazione del server applicazioni per abbonamenti CTI
-
Configurazione di XSP|ADP per abbonamenti CTI con autenticazione mTLS
-
Porte aperte in ingresso per interfaccia CTI sicura
-
Abbonamento alla tua organizzazione Webex a eventi CTI BroadWorks
Configurazione del server applicazioni per abbonamenti CTI
Aggiornare ClientIdentity sul server applicazioni con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ogni server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> aggiungi bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è bwcticlient.webex.com.
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifica
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità |
Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) |
XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocols> |
Un'interfaccia CTI specifica su questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocols> |
In una nuova installazione, le seguenti crittografie vengono installate per impostazione predefinita a livello di sistema. Se non viene configurato alcun elemento a livello di interfaccia (ad esempio, l'interfaccia CTI o l'interfaccia HTTP), viene applicato questo elenco di crittografie. Tenere presente che questo elenco può cambiare nel tempo:
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
tls_ecdhe_ecdsa_with_aes_128_gcm_sha256
-
tls_ecdhe_rsa_with_aes_128_cbc_sha256
-
tls_ecdhe_ecdsa_with_aes_128_cbc_sha256
-
tls_dhe_dss_with_aes_128_gcm_sha256
-
tls_dhe_rsa_with_aes_128_gcm_sha256
-
tls_dhe_rsa_with_aes_128_cbc_sha256
-
tls_dhe_dss_with_aes_128_cbc_sha256
-
tls_ecdh_rsa_with_aes_128_gcm_sha256
-
tls_ecdh_ecdsa_with_aes_128_gcm_sha256
-
tls_ecdh_rsa_with_aes_128_cbc_sha256
-
tls_ecdh_ecdsa_with_aes_128_cbc_sha256
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserire il comando
get
e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> Ottieni interfaccia porta IP Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
-
Inserire il comando
get <interfaceIp>
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserire il comando
aggiungi <interfaceIp> TLSv1.2
per assicurarsi che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione di crittografia TLS sull'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
-
Immettere il comando
get
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview). -
Inserire il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.L'XSP|ADP CLI richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, è necessario utilizzare:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> aggiungi 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base al nome.
Trust Anchor per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che gli XSP|ADP siano rivolti verso Internet o rivolti verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy di bridge (vedere Requisiti del certificato TLS per il proxy bridge TLS).
Per ogni XSP|ADP nell'infrastruttura che sta pubblicando eventi CTI in Webex, effettuare le seguenti operazioni:
-
Accedi a Partner Hub.
-
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain .txt
sul computer locale.Questi file contengono due set di due certificati. Devi suddividere i file prima di caricarli negli XSP|ADP. Tutti i file sono obbligatori.
-
Suddividere la catena di certificati in due certificati: combinedcertchain .txt
-
Aprire combinedcertchain .txt in un editor di testo.
-
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file. -
Salvare il nuovo file come root .txt.
-
Salvare il file originale come emissione di .txt. Il file originale ora deve disporre di un solo blocco di testo, circondato dalle righe
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copia entrambi i file di testo in una posizione temporanea su XSP|ADP che stai proteggendo, ad esempio,
/var/broadworks/tmp/root .txt
e/var/broadworks/tmp/issuing .txt
-
Accedere a XSP|ADP e passare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
-
(Opzionale) Eseguire
help updateTrust
per visualizzare i parametri e il formato del comando. -
Carica i file dei certificati sui nuovi trust anchor - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot /var/broadworks/tmp/root .txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing /var/broadworks/tmp/issuing .txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
ewebexclientissuing
sono alias di esempio per i trust anchor; puoi utilizzare i tuoi alias purché tutte le voci siano univoche. -
Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> ottieni
Alias Proprietario emittente ============================================================================= webexclientissuing Internal Private TLS SubCA Internal Private Root webexclientroot Internal Private Root[self-signed]
-
Consenti ai client di eseguire l'autenticazione con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> imposta allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
-
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione di BroadWorks. Il comando crea un certificato del server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> aggiungi <Interface IP> 8012 true true true
-
-
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. A tale scopo, è necessario l'indirizzo IP dell'interfaccia CTI; è possibile leggerlo nel seguente contesto:
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> ottieni
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la propria chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interfaccia IP> file chiave</path/to/file chiave certificato> certificatoFile </path/to/certificato server> chainFile</path/to/chain file>
-
-
Riavviare XSP|ADP.
Abilitazione dell'accesso a eventi CTI BroadWorks su Webex
Devi aggiungere e convalidare l'interfaccia CTI quando configuri i cluster in Partner Hub. Vedi Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
Devi aggiungere e convalidare l'interfaccia CTI quando configuri i cluster in Partner Hub. Vedi Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
-
Specifica l'indirizzo CTI in base al quale Webex può abbonarsi agli eventi CTI BroadWorks.
-
Gli abbonamenti CTI si basano su abbonamento singolo e vengono stabiliti e mantenuti solo mentre tale abbonato viene predisposto per Webex per Cisco BroadWorks.
Impostazioni chiamata vista Web
CSWV (Call Settings Webview) è un'applicazione ospitata su XSP|ADP che consente agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview impostazioni chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono nativi dell'app Webex.
Se desideri che gli abbonati a Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre ai valori predefiniti disponibili nell'app Webex, devi distribuire la funzione Impostazioni chiamata Webview.
La vista Web Impostazioni chiamata dispone di due componenti:
-
Applicazione Webview impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
-
L'app Webex, che esegue il rendering delle impostazioni di chiamata in una vista Web.
Esperienza utente
-
Utenti Windows: Fai clic su Impostazioni chiamata, quindi fai clic su .
-
Utenti Mac: Fare clic sull'immagine del profilo, quindi su
.
Distribuzione di CSWV su BroadWorks
Installazione della vista Web impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso XSP|ADP che ospita l'interfaccia Azioni Xsi nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
-
Accedere a cisco.com e ricercare "BWCallSettingsWeb" nella sezione di download del software.
-
Trova e scarica la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) era il più recente al momento della scrittura. -
Installare, attivare e distribuire l'archivio Web in base alla guida alla configurazione della piattaforma di servizio Cisco BroadWorks Xtended per la versione XSP|ADP. (Versione R24 è https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
-
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
. -
Selezionare il seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> installa applicazione /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
-
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più richiesto). -
Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> attiva applicazione BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario anche fornire un ContextPath poiché si tratta di un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio,
/callsettings
. -
Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> distribuisci applicazione /callsettings
-
-
Ora è possibile prevedere l'URL delle impostazioni di chiamata che verrà specificato per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
-
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
-
XSP|ADP-FQDN deve corrispondere all'FQDN azioni Xsi, poiché CSWV deve utilizzare azioni Xsi e CORS non è supportato.
-
-
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview impostazioni chiamata ora è attiva su XSP|ADP.
Configura l'app Webex per utilizzare la vista Webview impostazioni chiamata
Per ulteriori informazioni sulla configurazione del client, vedere Guida alla configurazione di Webex per Cisco BroadWorks.
È presente un tag personalizzato nel file di configurazione dell'app Webex che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti tramite l'interfaccia dell'applicazione.
<config> <servizi> <web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%"> <url>%WEB_CALL_SETTINGS_URL_WXT%</url> </web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel tag %WEB_CALL_SETTINGS_URL_WXT%.
Se non specifichi esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
-
Assicurati di disporre degli ultimi modelli di configurazione per l'app Webex (vedi Profili dispositivo).
-
Impostare la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
-
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente in uso, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.esempio.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
-
Il file di configurazione del client risultante deve contenere una voce nel seguente modo:
<web-call-settings target="csw"> <url>https://yourxsp.esempio.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Server push notifiche chiamate (CNPS) per descrivere un'applicazione ospitata XSP o ADP eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in ingresso ai tuoi utenti e invia le notifiche ai servizi di notifica di Google Firebase Cloud Messaging (FCM) o Apple Push Notification service (APN).
Tali servizi notificano ai dispositivi mobili di Webex per gli abbonati Cisco BroadWorks che hanno chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere Descrizione della funzione del server push delle notifiche.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per inviare le notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi notificano a loro volta agli utenti mobili Webex i messaggi in arrivo o le modifiche alla presenza.
In questa sezione viene descritto come configurare NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se devi eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedi Aggiornamento dell'NPS Cisco BroadWorks per l'uso del proxy NPS https://help.webex.com/nl5rir2/.
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario applicare le patch al CNPS per supportare la funzione proxy NPS, Server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server push di notifica per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private del certificato di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e le chiavi di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend Cisco BroadWorks e utilizza questo token per l'autenticazione con i servizi Apple APN e Google FCM.
La funzione migliora anche la funzionalità del server push notifiche di push delle notifiche ai dispositivi Android tramite la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
-
Per ulteriori informazioni, vedere Descrizione della funzione Server push per VoIP in UCaaS.
-
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software NPS e le patch, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Ricercare e scaricare la patch dalla pagina di download del software.
-
Ulteriori informazioni sul server ADP sono disponibili all'indirizzo https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni su APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio di notifica push di Apple dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per gli APN. Questo aggiornamento richiede che XSP|ADP che ospita NPS sia in esecuzione R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 |
Installare e configurare un XSP dedicato (versione minima R22) o Application Delivery Platform (ADP). |
2 |
Installare le patch del proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: |
3 |
Attivare l'applicazione del server push di notifica. |
4 |
(Per le notifiche Android) Abilitare l'API FCM v1 su NPS.
|
5 |
(Per le notifiche Apple iOS) Abilita HTTP/2 su NPS.
Questa opzione è esclusiva della release 22 e delle versioni precedenti; non è disponibile nella release 23 e nelle versioni precedenti che supportano solo HTTP/2. |
6 |
Collegare un supporto tecnico da XSP/ADP NPS. |
7 |
Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa 149.vle.broadsoft.com qa 149.vle.broadsoft.com IN UN 10.193.78.149 Una volta impostato, è necessario uno dei seguenti elementi per rispondere alle modifiche:
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configurazione di NPS per l'uso del proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Esegui migrazione da NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un NPS condiviso con altre app mobili, vedere Aggiornamento dell'NPS Cisco BroadWorks per l'uso del proxy NPS ( https://help.webex.com/nl5rir2).
1 |
Recupero delle credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 |
Creare l'account client su NPS:
Per verificare che i valori immessi corrispondano a quanto specificato, eseguire L'Url emittente CiscoCI deve essere SEMPRE il cluster CI USA, indipendentemente dalla posizione e il valore predefinito deve essere:
| |||||||||||||||||||
3 |
Immettere l'URL del proxy NPS e impostare l'intervallo di aggiornamento del token (si consiglia 30 minuti):
| |||||||||||||||||||
4 |
(Per notifiche Android) Aggiungere l'ID dell'applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 |
(Per le notifiche Apple iOS) Aggiungere l'ID dell'applicazione al contesto delle applicazioni APNS assicurandosi di omettere la chiave di autorizzazione, impostarla su vuota.
| |||||||||||||||||||
6 |
Configura i seguenti URL NPS:
| |||||||||||||||||||
7 |
Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 |
Verificare che il server applicazioni stia eseguendo lo screening degli ID delle applicazioni poiché potrebbe essere necessario aggiungere le app Webex all'elenco degli utenti autorizzati: | |||||||||||||||||||
9 |
Riavviare XSP|ADP: | |||||||||||||||||||
10 |
Prova le notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migra NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente per la migrazione a FCMv1. Le procedure sono tre:
Esegui migrazione dei client UC-One a FCMv1
Utilizza la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella Console FCM, vedi
. L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile di connessione all'indirizzo https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al parametro gcm_defaultSenderId
, che si trova nel kit di branding, nella cartella Risorse e nel file branding.xml con la sintassi seguente:
<string name="gcm_defaultSenderId">xxxxxxxxxxxxx</string>
-
Accedere a FCM Admin SDK all'indirizzo http://console.firebase.google.com.
-
Selezionare l'applicazione Android appropriata.
-
Nella scheda Generale, registrare l'ID del progetto
-
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurare un account esistente.
Per creare un nuovo account servizio:
-
Fare clic sul pulsante blu per creare un nuovo account servizio
-
Fai clic sul pulsante blu per generare una nuova chiave privata
-
Scarica chiave in una posizione sicura
Per riutilizzare un account servizio esistente:
-
Fare clic sul testo blu per visualizzare gli account servizio esistenti.
-
Identificare l'account servizio da utilizzare. L'account servizio richiede l'autorizzazione firebaseadmin-sdk.
-
A destra, fare clic sul menu dell'hamburger e creare una nuova chiave privata.
-
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
-
-
Copia il file json su XSP|ADP.
-
Configura l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> aggiungi <id progetto> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> ottieni Project ID Accountkey ======================== mio_progetto ********
-
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> aggiungi <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> ottieni ID applicazione Progetto ID ============================== my_app my_project
-
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Abilitato true ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP.
Esegui migrazione dei client SaaS a FCMv1
Utilizzare la procedura seguente su Google FCM Console se si desidera eseguire la migrazione dei client SaaS a FCMv1.
Accertarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione".
-
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Enabled false ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP. -
Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Abilitato true ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP.
Aggiorna server ADP
Utilizzare la procedura seguente in Google FCM Console se si sta eseguendo la migrazione di NPS per utilizzare un server ADP.
-
Ottenere il file JSON dalla console cloud di Google:
-
Nella console Google Cloud, andare alla pagina Account servizio.
-
Fai clic su Seleziona un progetto, scegli il progetto e fai clic su Apri.
-
Individuare la riga dell'account servizio per il quale si desidera creare una chiave, fare clic sul pulsante verticale Altro, quindi fare clic su Crea chiave.
-
Seleziona un tipo di chiave e fai clic su Crea
Il file viene scaricato.
-
-
Aggiungere FCM al server ADP:
-
Importare il file JSON nel server ADP utilizzando il comando
/bw/install
. -
Accedi a ADP CLI e aggiungi il progetto e la chiave API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> aggiungi connect /bw/install/google JSON
: -
Quindi, aggiungere l'Applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Chiudi
-
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ================================== com.broadsoft.ucaas.connect connect-ucaas
-
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò viene effettuato per i seguenti motivi:
-
Per consentire al cloud Webex di autenticare gli utenti in base a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
-
Di consentire alle app Webex di utilizzare l'Interfaccia XSI per il controllo delle chiamate.
-
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se una delle interfacce non viene convalidata correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide.
Questo problema viene impedito poiché un cluster configurato in modo errato può provocare problemi che sono difficili da risolvere.
Operazioni da eseguire:
-
Accedere a Partner Hub (admin.webex.com) con le credenziali di amministratore partner.
-
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni BroadWorks Calling.
Se l'utente amministratore non dispone della visibilità delle impostazioni BroadWorks Calling, si consiglia di aprire un caso con Cisco TAC.
-
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
-
Assegnare un nome a questo cluster e fare clic su Avanti.
Il concetto di cluster in questo caso è semplicemente un insieme di interfacce, solitamente raggruppate su un server o un farm XSP|ADP, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il tuo sistema BroadWorks non rientrano nell'ambito qui.
-
(Opzionale) Inserisci un Nome account e una Password utente BroadWorks all'interno del sistema BroadWorks che stai connettendo a Webex, quindi fai clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
-
Aggiungi gli URL Azioni XSI e Eventi XSI.
-
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
-
Opzionale. Seleziona la casella di controllo Abilita autenticazione diretta BroadWorks se desideri che gli accessi a BroadWorks siano diretti a BroadWorks. Altrimenti, l'autenticazione a BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo incide sulle seguenti situazioni di accesso:
-
Accesso al portale di attivazione utente: gli utenti devono inserire le proprie credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o tramite il proxy IdP.
-
Accesso client: se Autenticazione BroadWorks è configurata nel modello Onboarding, l'impostazione precedente determina se l'accesso client all'app Webex è diretto a BroadWorks o è proxy tramite il proxy IdP.
-
-
Fai clic su Avanti.
-
Nella pagina Interfaccia CTI, effettuare le seguenti operazioni:
-
Aggiungere l'URL CTI e la Porta per l'interfaccia CTI a cui si desidera connettersi.
-
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia delle chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
-
Opzionale. Abilita il tasto di alternanza di sincronizzazione Non disturbare (DND) e inserisci il tuo ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurando che la funzione funzioni allo stesso modo su entrambe le piattaforme.
-
Opzionale. Abilita il tasto di alternanza Sincronizzazione stato assistente personale e inserisci il tuo ID utente BroadWorks. Questa opzione sincronizza lo stato di presenza dell'assistente personale tra i dispositivi BroadWorks Calling e l'app Webex.
-
Fai clic su Avanti.
-
-
Aggiungere l'URL del servizio di autenticazione.
-
Selezionare Servizio di autorizzazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex, poiché il servizio di autenticazione convalida correttamente il token utente in base al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
-
Esamina le voci nella schermata finale, quindi fai clic su Crea. Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Partner Hub passa gli URL a vari microservizi Webex che verificano le connessioni alle interfacce fornite.
-
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e specificare se la convalida è stata completata correttamente.
-
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Questo controllo è stato implementato per evitare errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, servizio di bilanciamento del carico o firewall) come documentato in questa guida, prima di salvare il modello.
Controllo delle connessioni alle interfacce BroadWorks
-
Accedere a Partner Hub (admin.webex.com) con le credenziali di amministratore partner.
-
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni BroadWorks Calling.
-
Fai clic su Visualizza cluster.
-
Partner Hub avvia test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, nella pagina di elenco dei cluster viene visualizzato il messaggio di stato accanto a ciascun cluster.
Dovrebbero essere visualizzati messaggi verdi di operazione riuscita. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
-
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio azioni XSI, eventi XSI, URL DAS e impostazioni dell'interfaccia CTI.
Configura i tuoi modelli di onboarding
I modelli di onboarding sono il modo in cui applicherai la configurazione condivisa a uno o più clienti durante l'onboarding tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma è possibile associare un solo modello a un cliente.
-
Accedi a Partner Hub e seleziona Clienti.
-
Fai clic sul pulsante Modelli di onboarding per visualizzare i modelli esistenti.
-
Fare clic su Crea modello.
-
Nella finestra Dettagli modello, aggiungere il nome del modello, il paese o la regione e la lingua e-mail predefinita.
-
Fare clic sull'elenco a discesa per l'ID abbonamento CCW, individuare gli abbonamenti elencati per il partner e selezionare l'abbonamento applicabile.
Questo campo è visualizzato solo per i partner migrati da Webex per BroadWorks a Webex.
-
Nella finestra Impostazione servizio, utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
-
Inserisci un Nome modello, quindi fai clic su Avanti.
-
Configurare la modalità di provisioning utilizzando queste impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per le diverse modalità di provisioning Nome impostazione
Provisioning a flusso costante con e-mail attendibili
Provisioning a flusso costante senza e-mail
Provisioning automatico utente
Abilita il flusso BroadWorks attraverso il provisioning (includi le credenziali dell'account di provisioning se Attivato**)
Attivato
Fornire Nome account e Password di provisioning in base alla configurazione BroadWorks.
Attivato
Fornire Nome account e Password di provisioning in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il
Il
Il
Indirizzo e-mail provider servizi
Seleziona un indirizzo e-mail dall'elenco a discesa (puoi digitare alcuni caratteri, per trovare l'indirizzo se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso di amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello di onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto associa le organizzazioni dei clienti create con questo modello a una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedi le mappature paese-regione in questo foglio di calcolo.
Il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni, fai riferimento alla sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questa opzione disattivata.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note della tabella:
-
† Questo switch assicura che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa operazione deve essere sempre attiva, a meno che non si stia utilizzando un processo di ordinazione ed esecuzione manuale (tramite Cisco Commerce Workspace) per creare organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello "Provisioning ibrido" ed è fuori dall'ambito di questo documento.
-
** "Account di provisioning" si riferisce all'account amministratore a livello di sistema BroadWorks. In BroadWorks, hai bisogno di un account amministratore con questi attributi: Tipo di amministratore = Provisioning, Sola lettura = Disattivato.
-
-
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
-
Opzionale. Seleziona Disabilita chiamata gratuita Cisco Webex se desideri disabilitare le chiamate Webex.
-
Per Configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
-
Numeri di chiamata in ingresso Cisco (PSTN)
-
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
-
-
Fai clic su Avanti.
-
Esistono due approcci per il provisioning degli abbonati per quanto riguarda il modo in cui vengono verificate le loro identità: utilizzando messaggi e-mail attendibili o messaggi e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. L'utente in qualità di partner è responsabile del provisioning dell'indirizzo e-mail come parte del metodo di flusso attraverso o API.
Si consiglia vivamente di utilizzare il metodo di provisioning affidabile perché assicura che tutti gli abbonati siano forniti completamente da parte dell'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso di e-mail non attendibile gli utenti devono verificare l'e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome impostazione
Provisioning a flusso costante senza e-mail
Provisioning automatico utente
Esegui prima provisioning amministratori
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
-
Note della tabella:
-
* A ciascuna organizzazione cliente in Webex deve essere assegnato almeno un utente con ruolo di amministratore. Il primo utente a cui viene assegnato l'IM&P integrato in BroadWorks assume il ruolo di amministratore cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di provider di servizi, è possibile avere il controllo su chi ottiene il ruolo. Selezionando questa impostazione, gli utenti non possono completare l'attivazione fino a quando non viene attivato il primo utente predisposto. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
-
-
Fai clic su Avanti.
-
Seleziona la modalità di autenticazione predefinita (Autenticazione BroadWorks o Autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla modalità di configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con il centro TAC di Cisco.
Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente.
-
Fai clic su Avanti.
-
Per Preferenze, configurare quanto segue:
-
Scegliere se si desidera precompilare gli indirizzi e-mail utente nella pagina di accesso.
Devi utilizzare questa opzione solo se hai selezionato Autenticazione BroadWorks e hai anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. Altrimenti, dovranno utilizzare il proprio nome utente BroadWorks. La pagina di accesso offre un'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
-
Se desideri abilitare la sincronizzazione delle rubriche, imposta l'opzione Abilita sincronizzazione rubriche telefoniche per tutte le nuove organizzazioni cliente su On.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente, in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
-
Inserire un Amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatizzato di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
-
Assicurati che l'opzione Consenti inviti e-mail amministratore al momento del collegamento a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
-
Fai clic su Avanti.
-
Rivedere le voci nella schermata finale. Puoi fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare eventuali dettagli. Fare clic su Crea.
Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con qualsiasi altro modello.
-
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario inserire nuovamente i dettagli dell'account di provisioning. I campi password/password di conferma vuoti sono disponibili per modificare le credenziali, ma lasciarle vuote per mantenere i valori forniti alla procedura guidata.
Aggiungere altri modelli se si dispone di configurazioni condivise diverse che si desidera fornire ai clienti.
Mantenere aperta la pagina Visualizza modelli poiché potrebbero essere necessari i dettagli del modello per una seguente attività.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning.
Patch Application Server (solo R22, R23 e R24)
-
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
-
Per R22:
AP.as.22.0.1123.ap373197
-
Per R23:
AP.as.23.0.1075.ap373197
-
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che costituiscono i requisiti per la distribuzione di Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.
-
-
Passare al contesto
Opzioni di manutenzione/contenitore
. -
Abilitare il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> aggiungi provisioning bw.imp.useProvisioningUrl true
Ottieni URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per dettagli (Interfaccia > Messaggistica e servizio > IM&P integrato) dei comandi AS.
-
Accedi a Partner Hub e vai a
. -
Fare clic su Visualizza modelli.
-
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro a scomparsa a destra. Se non è stato ancora creato un modello, è necessario effettuare questa operazione per ottenere l'URL di provisioning.
-
Copiare l'URL adattatore di provisioning.
Ripetere questa operazione per altri modelli se sono presenti più modelli.
(Opzione) Configurazione di parametri di provisioning a livello di sistema sul server applicazioni
Se si utilizza UC-One SaaS, è possibile non impostare il provisioning a livello di sistema e il dominio di servizio. Vedere Punti decisionali nella sezione Preparazione dell'ambiente.
-
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
-
AS_CLI/Interface/Messaging> imposta URL provisioning URL provisioning
-
AS_CLI/Interface/Messaging> imposta provisioningUserId provisioning_account_name
-
AS_CLI/Interface/Messaging> imposta password provisioning provisioning_account_password
-
AS_CLI/Interface/Messaging> imposta abilitaSincronizzazione true
-
-
Attivare l'interfaccia IMP integrata:
-
/AS_CLI/Service/IntegratedIMP> imposta serviceDomain esempio.com
-
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> imposta userAttrIsActive true
-
Devi inserire il nome completo per il parametro URL provisioning
, come è stato assegnato in Control Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel file /etc/hosts
sul server applicazioni.
(Opzione) Configurazione dei parametri di provisioning per azienda sul server applicazioni
-
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
-
Selezionare Usa dominio servizio e immettere un valore fittizio (Webex ignora questo parametro). Puoi utilizzare
example.com
). -
Selezionare Usa server di messaggistica.
-
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
Devi inserire il nome completo per il parametro
URL provisioning
, come è stato assegnato in Partner Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel file/etc/hosts
sul server applicazioni. -
Nel campo Nome utente, inserire un nome per l'amministratore di provisioning. Questa operazione deve corrispondere al valore riportato nel modello in Partner Hub.
-
Immettere una password per l'amministratore di provisioning. Questa operazione deve corrispondere al valore riportato nel modello in Partner Hub.
-
Per Identità utente predefinita per ID IM&P, selezionare Principale.
-
Fare clic su Applica.
-
Ripetere questa operazione per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning degli utenti, vedere Provisioning degli utenti del provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning consente agli amministratori e ai team di vendita di verificare gli errori prima di eseguire il provisioning di un pacchetto a un cliente o un abbonato. Gli utenti o le integrazioni autorizzate da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per garantire che non vi siano conflitti o errori con il provisioning del pacchetto per un determinato cliente o abbonato.
L'API controlla se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto per un cliente o un partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, puoi correggere tali errori prima del provisioning, aumentando la probabilità di un provisioning corretto.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore di Webex per la Vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare il provisioning di un abbonato Wholesale
Per accedere a Verifica preliminare di un documento di provisioning Wholesale Subscriber, è necessario accedere a https://developer.webex.com/ portal.
SSO partner - SAML
Consente agli amministratori partner di configurare la funzionalità SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura SSO del partner seguente si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere il Single Sign-On (SSO) partner a un'organizzazione esistente del cliente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso.
-
Verifica che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'Integrazione Single Sign-On in Control Hub.
-
Carica il file di metadati CI con provider identità.
-
Configura un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, inserire l'EntityID dall'XML dei metadati SAML del provider di identità di terze parti.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizzi il modello.
-
Molto che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori partner di configurare la funzionalità SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per l'impostazione dell'OIDC SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già presenti utilizzando il modello.
-
Aprire una richiesta di assistenza con il centro TAC di Cisco con i dettagli dell'IDP OpenID Connect. Di seguito sono riportati attributi IDP obbligatori e opzionali. Il centro TAC deve impostare l'IDP sul CI e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC potrebbe essere costituito da lettere, numeri, trattini, sottolineature, inclinazioni e punti; la lunghezza massima è 128 caratteri.
ID client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Chiave privata client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco di ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio; ad esempio, 'profilo e-mail openid' Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non è fornito
URL dell'endpoint di autorizzazione OAuth 2.0 di IdP.
Endpoint token
Sì se discoveryEndpoint non è fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
Endpoint infoUtente
No
URL dell'endpoint Info utente dell'IdP.
Endpoint set di tasti
No
URL dell'endpoint di set di chiavi Web JSON dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
-
Configurare l'URI di reindirizzamento sull'IDP connect OpenID.
-
Configura un modello di onboarding. Per l'impostazione della modalità di autenticazione, seleziona Autenticazione partner Con OpenID Connect e inserisci il nome IDP fornito durante l'impostazione dell'IDP come ID entità IDP OpenID Connect.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizzi il modello.
-
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo di correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'Identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui Registrazione chiamata, Risposta per assente di gruppo, Dirigente e Dirigente-Assistente.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
-
Eseguire i seguenti comandi sulle interfacce AS. In questo modo, il AS potrà inviare l'intestazione SIP X-BroadWorks-Correlation-Info:
AS_CLI/Interface/SIP> imposta sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> imposta sendCallCorrelationIDAccess true
-
Il/la enableID correlazione chiamataparametro associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione di informazioni di correlazione delle chiamate nei registri Xsi-Actions. Si consiglia di abilitare
enableCallCorrelationID
utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>imposta enableCallCorrelationID true
Per ulteriori informazioni sull'identificatore di correlazione chiamata, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione delle rubriche assicura che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la rubrica di chiamata completa dal server BroadWorks viene sincronizzata con la rubrica Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione delle rubriche, vai a Sincronizzazione rubrica in Webex per Cisco BroadWorks.
Il provisioning a flusso costante di Webex per Cisco BroadWorks aggiunge gli utenti di messaggistica e le informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, elenchi di telefoni, utenti non di messaggistica e entità non utente non sono inclusi (ad esempio, un telefono per sala conferenze, un fax o un numero di gruppo di ricerca). L'attivazione della sincronizzazione delle rubriche assicura che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex.
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia delle chiamate e delle riunioni Webex Unified visualizzata nell'app Webex. Gli utenti possono visualizzare la propria cronologia dettagliata delle chiamate e della cronologia delle riunioni dall'app Webex.
La cronologia delle chiamate unificate può essere abilitata dagli amministratori a livello di partner in Partner Hub cluster per cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata nel cloud Webex:
-
Eventi della cronologia delle chiamate: questi eventi vengono utilizzati per creare una cronologia delle chiamate unificata dettagliata
-
Eventi di stato ricevitore: la cronologia delle chiamate unificate include le ottimizzazioni dello stato dell'aggancio che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di presenza di telefonia
Requisiti cronologia chiamate Unified
Prima di configurare la cronologia chiamate unificata, verificare di aver applicato le patch al sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
Per R23:
-
Se si utilizza XSP—AP.xsp.23.0.1075.ap378585
-
In caso di uso di ADP—
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
Per l'elenco completo delle patch BroadWorks che occorre installare come prerequisito per eseguire Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.
Oltre alle patch del sistema, il file di configurazione del client (config-wxt.xml
) deve avere il seguente tag impostato: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altre informazioni di reindirizzamento nella cronologia chiamate Unified, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
-
AP.as.23.0.1075.ap383346
-
AP.as.23.0.1075.ap383994
Per R24:
-
AP.as.24.0.944.ap383346
-
AP.as.24.0.944.ap383994
Per disporre delle informazioni su dirigente-assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
-
AP.as.24.0.944.ap380052
-
AP.as.24.0.944.ap384239
-
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare la sincronizzazione delle rubriche anche per la cronologia delle chiamate unificata per dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione DND, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti sotto il cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione BroadWorks durante la stessa finestra di manutenzione.
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedi la procedura per l'aggiunta di un cluster in Configurazione dell'organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettua le seguenti operazioni:
-
Accedi a Partner Hub all'indirizzo admin.webex.com.
-
Vai a Impostazioni e seleziona un cluster esistente.
-
Verificare che la connessione del cluster sia buona. Nel pannello destro dovrebbe essere visualizzato un segno di spunta verde con Connessione stabilita.
Se non viene visualizzato, in Controlla connessioni (opzionale), inserisci ID utente BroadWorks e Password BroadWorks e fai clic su Verifica per verificare che la connessione sia buona.
-
Selezionare la casella di controllo Abilita cronologia chiamate.
-
Fai clic su Salva.
Interazioni funzioni
Le seguenti interazioni con le funzioni esistono per la cronologia chiamate unificata:
-
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando esiste questa situazione, gli eventi Cronologia chiamate e Stato ricevitore non vengono inviati all'app Webex.
-
La cronologia chiamate unificata non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata a interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia delle chiamate unificate dall'app Webex. Per informazioni dettagliate, vedere: Webex | Visualizzazione della cronologia chiamate e riunioni.
Disabilita cronologia chiamate Unified
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione per proprio conto. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visiva
L'app Webex supporta un'indicazione visiva delle chiamate di spam nell'avviso popup di chiamata quando la chiamata viene presentata alla persona chiamata e nei record della cronologia chiamate unificata quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per disporre di questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- È necessario installare e attivare le seguenti patch:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o almeno AS-25_Rel_2022.12
- La funzione deve essere attivata tramite la CLI AS:
- AS_CLI/System/ActivatableFeature> attiva 104112
- AS_CLI/System/StirShaken> imposta enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'assegnazione di tag e la verifica STIR-SHAKEN come descritto in Tag e verifica di firma STIR-SHAKEN di Cisco BroadWorks
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste INVITE inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione visiva di spam nella presentazione della chiamata e nella cronologia chiamate unificata della persona chiamata.
Sincronizzazione stato assistente personale
La funzione di sincronizzazione stato dell'assistente personale (PA) sincronizza lo stato di presenza dell'assistente personale tra i dispositivi BroadWorks Calling e Webex App.
Il servizio PA fornisce all'utente un'opzione per informare i chiamanti del motivo per cui la parte chiamata non è disponibile, fornendo opzionalmente informazioni su quando la parte chiamata ritorna e se è presente un operatore per gestire la chiamata. La funzione PA consente agli utenti nelle app Webex di visualizzare la presenza dell'utente insieme allo stato PA e alla durata configurati.
Prerequisiti
Accertarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione di BroadWorks.
Patch per RI e versione 24:
-
AP.as.24.0.944.ap385558
La funzione di sincronizzazione dello stato dell'assistente personale introduce un nuovo pacchetto di eventi PersonalAssistantSync per consentire ai client XSI di sincronizzare con le modifiche alla presenza dell'assistente personale Cisco BroadWorks. Per ulteriori informazioni, vedere Pacchetto eventi XSI per la funzione di sincronizzazione dello stato dell'assistente personale.
Oltre a applicare le patch al sistema, il file di configurazione del client (config-wxt.xml) deve avere il seguente tag impostato: <personal-assistant abilitato="%PERSONAL_ASSISTANT_ENABLED_WXT%"/>
Abilita sincronizzazione stato assistente personale (nuovo cluster)
Per abilitare la sincronizzazione dello stato dell'assistente personale su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configurazione dell'organizzazione partner in Partner Hub.
Abilita sincronizzazione stato assistente personale (cluster esistente)
-
Accedere a Partner Hub con le credenziali di amministratore partner all'indirizzo https://admin.webex.com.
-
Fai clic su Impostazioni organizzazione.
-
Fai clic su Visualizza cluster e seleziona il cluster BroadWorks appropriato.
- Nella sezione Interfaccia CTI, abilitare il tasto di alternanza Sincronizzazione stato assistente personale.
-
Inserisci il tuo ID utente BroadWorks e fai clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione PA. Se la convalida non riesce, il pulsante Salva viene disabilitato.
-
Se la convalida ha esito positivo, fai clic su Salva.
L'abilitazione della sincronizzazione dello stato PA è un interruttore a una via. Una volta abilitata la funzione, non puoi disabilitarla da solo.
Disabilita sincronizzazione stato assistente personale
Una volta abilitato lo stato di sincronizzazione PA su uno dei cluster BroadWorks, non puoi disabilitare la funzione da solo. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenterà di identificare chi è il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra in chiamata e al termine della chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante associando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se vengono trovate più istanze di un numero in un'origine, non tenterà di sceglierne una; in questo caso, non verrà visualizzato alcun ID chiamante.
-
Webex Common Identity (CI) contenente gli utenti dell'organizzazione.
-
Contatti personali e organizzazione. I contatti personali sono visibili sotto la scheda Contatti.
-
rubrica locale. In Windows - applicazione Outlook, in Mac - contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non è stata trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, verrà utilizzata come ultima istanza la parte del nome utente dell'URI SIP dell'intestazione SIP From.
Per il controllo remoto delle chiamate (ad esempio, modalità di controllo telefono fisso) vengono utilizzate le informazioni XSI, dove viene utilizzato l'ID BWKS o l'interno, estratte dalle informazioni della parte remota nell'evento XSI. Se remote-party-info non è disponibile, viene utilizzato PAI (P-Asserted Identity) (se configurato).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica e nella cronologia chiamate.
-
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
-
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
-
Coda call center: Visualizza il nome della coda che ha inoltrato la chiamata.
-
Dirigente-Assistente: Visualizza il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
-
Per le chiamate in coda chiamata interne, in cui un agente richiama una parte interna, la parte remota non visualizza il nome della coda chiamata, ma visualizza il nome dell'agente che la chiama.
Chiamata con risposta altrove:
Per i gruppi di risposta o le code di chiamata impostate con l'indirizzamento simultaneo, gli agenti visualizzeranno una chiamata risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di ricerca o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate non risposte nella cronologia chiamate se si riceve una risposta da un altro agente.
Seleziona ID chiamante
Panoramica
La funzione "Seleziona ID chiamante" consente agli utenti di passare tra diversi ID di linea chiamante per le chiamate esterne. Se abilitata dall'amministratore, gli utenti possono scegliere tra le seguenti opzioni per la propria identità di linea chiamante:
-
Numero utente ("Usa numero di telefono utente per identità linea chiamante")
-
CLID configurabile ("Usa CLID configurabile per identità linea di chiamata")
-
CLID gruppo ("Usa numero di telefono di gruppo/reparto per identità linea chiamante")
Funzionalità
Gli utenti dispongono di due metodi per modificare l'ID chiamante come predisposto dall'amministratore:
- Codici di accesso funzione (FAC): Codici specifici per ciascuna delle tre opzioni dell'ID chiamante.
- Interfaccia app Webex: Una vista intuitiva per l'utente all'interno delle app desktop e mobile Webex che visualizzano le opzioni dell'ID chiamante disponibili abilitate dall'amministratore, consentendo agli utenti di selezionare il proprio ID preferito.
Ulteriori funzioni
- Le app Webex includeranno anche opzioni per le code DNIS del call center.
- Gli utenti dell'app mobile avranno le opzioni Dual Persona disponibili per gli utenti di mobilità.
Precondizioni
Le seguenti condizioni devono essere soddisfatte sul server BroadWorks affinché l'utente possa controllare la sua scelta di criteri CLID esterni:
- Il flag di sistema "EnableUserSelectionOfExternalCLIDPolicy" è abilitato.
- L'ambito ID linea chiamata livello utente è impostato su "Usa criteri ID linea chiamata utente" per questo utente.
- Il flag "Consenti selezione utente di criteri di elaborazione chiamate a livello utente" è abilitato per l'utente.
- Se non viene definito alcun numero per le opzioni "Usa CLID configurabile per identità linea chiamante" o "Usa numero di telefono di gruppo/reparto per identità linea chiamante", i FAC o la visualizzazione dell'app non avranno effetto. Questa impostazione deve essere configurata dall'amministratore prima della selezione dell'utente.
Patch BroadWorks
Per il corretto funzionamento di questa funzione sono necessarie due patch BroadWorks specifiche:
Fare riferimento alla Sezione 8 Release Independent e Service Patch Information.
- BWKS-5230 era la funzione CLID selezionabile dall'utente originale: consente agli utenti (se il sistema è configurato correttamente) di modificare i criteri CLID applicabili. Vedere FD qui: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/UserSelectionOfExternalCallingLineIDOptionFD-R250.pdf
- BWKS-9510 è un miglioramento XSI richiesto dal team del client Webex per facilitare la individuazione delle opzioni disponibili per un utente. Questo è necessario perché la scelta dei criteri CLID non è una semplice funzione a livello utente (come CFA) direttamente controllabile. Piuttosto, dipende da varie opzioni di configurazione del sistema e dalla gerarchia dei "criteri di elaborazione delle chiamate". È possibile visualizzare i dettagli qui: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/XSIEnhancementToSupportUserSelectableCLIDFD-R250.pdf
Configurazione app Webex
Questi tag devono essere abilitati nelle configurazioni desktop, tablet e mobile:
<config> <servizi> <chiamate> <caller-id> <outgoing-calls enabled="%ENABLE_CLID_OUTGOING_CALLS_WXT%">
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni fissi. Questa specifica funzione consente di assegnare identificativi di linea condivisa all'app Webex dell'utente finale.
Questa funzione è utile agli utenti per gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
-
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
-
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
-
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
-
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente a linee condivise.
-
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise del client Webex
R23 senza ADP:
-
AP.as.23.0.1075.ap384179
-
AP.xsp.23.0.1075.ap384179
R23 con ADP:
-
AP.as.23.0.1075.ap384179
-
XSI-Azioni-23_2022.10
r24:
-
come: AP.as.24.0.944.ap384179
-
XSI-Azioni-24_2022.10
r25:
-
come: Versione RI Rel_2022.10_1.310
-
XSI-Azioni-25_2022.10
Patch 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo. Esempio: Per il client desktop: System>Modifica tipo di profilo di identità/dispositivo> Business Communicator - PC: Profilo, Opzioni standard, Numero di porte:
- SE è abilitata l'opzione 'Illimitato', non è richiesta alcuna modifica
- SE 'Limitato a' è <10, modificare il valore = 10 e salvarlo per utilizzare tutte le linee disponibili
-
Versione RI Rel_2022.10_1.310
Per dettagli sulla configurazione del client, vedere sezione 6.1.44 'Profilo principale' della Guida alla configurazione di Webex per Cisco BroadWorks.
Sincronizzazione Non disturbare (DND)
La sincronizzazione Non disturbare (DND) allinea le impostazioni DND tra Webex e BroadWorks sincronizzando lo stato Non disturbare tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato viene sincronizzato con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. In modo analogo, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist di una piattaforma non vengono riconosciuti dall'altra.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Se sono presenti molti clienti (>50) nel cluster BroadWorks, la sincronizzazione NoDist non è supportata. In tali casi, si consiglia di contattare un tecnico del supporto Cisco TAC per assistenza.
Prerequisiti
Accertarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione di BroadWorks.
Per la versione 23:
<frammento>
- App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
<frammento>
- App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 sul SA:
AS_CLI/System/ActivatableFeature> attiva 25433
Se sono presenti molti clienti (>50) nel cluster BroadWorks, operazioni come l'aggiornamento di azioni XSI, eventi XSI, URL DAS, URL XSP|ADP o sincronizzazione DND non sono supportate. In tali casi, si consiglia di contattare un tecnico del supporto Cisco TAC per assistenza.
Configurare la sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto eventi "come evento funzione". Per dettagli, vedi Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
-
Accedi a Partner Hub
-
Fare clic su Impostazioni.
-
Fai clic su Visualizza cluster e seleziona il cluster BroadWorks appropriato.
-
Abilita il tasto di alternanza di sincronizzazione Non disturbare (DND).
-
Inserisci il tuo ID utente BroadWorks e fai clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione DND. Se la convalida non riesce, il pulsante Salva viene disabilitato.
-
Se la convalida ha esito positivo, fai clic su Salva.
-
Una volta abilitata la sincronizzazione DND, Webex aggiorna tutti gli abbonamenti utente per includere il pacchetto per eventi Non disturbare. A seconda del numero di utenti, questo processo può richiedere alcune ore per il completamento.
-
L'abilitazione della sincronizzazione DND è un interruttore a una via. Una volta abilitata la funzione, non puoi disabilitarla da solo.
Abilita sincronizzazione DND (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per dettagli, vedi "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Orario di pausa
Nelle distribuzioni Webex per BroadWorks, la funzione "Orario di pausa" si basa sulla funzionalità "Sincronizzazione Non disturbare (DND)" per garantire che le impostazioni dell'orario di pausa siano sincronizzate su tutti i dispositivi. Per sincronizzare correttamente l'orario di pausa tra desktop e dispositivi mobili, assicurarsi che l'opzione 'Sincronizzazione NoDist' sia abilitata nell'account dell'utente.
Disabilita sincronizzazione DND
Non puoi disabilitare la sincronizzazione DND da solo. Per disabilitare la funzione, crea un caso BEMS tecnico con le seguenti informazioni:
-
Famiglia: Servizio Spark
-
Prodotto: Chiamata in Webex (Webex per BroadWorks)
-
Componente: WxBW - Provisioning
-
Il caso BEMS deve indicare che la sincronizzazione Non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterId BroadWorks.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione chiamata.
Modalità di registrazione |
Descrizione |
Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente |
La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
-
Per R22: AP.as.22.0.1123.ap377718
-
Per R23: AP.as.23.0.1075.ap377718
-
Per R24: AP.as.24.0.944.ap377718
L'Identificativo di correlazione chiamata deve essere attivato. Per dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione della chiamata su BroadWorks, vai alla Guida all'interfaccia di registrazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, vai all'articolo help.webex.com
Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla relativa piattaforma di registrazione chiamate di terze parti.
Abilitazione della casella vocale per l'integrazione di Microsoft Teams
È possibile abilitare la casella vocale per gli utenti Microsoft teams nella soluzione Webex per BroadWorks. Questa integrazione consente agli utenti di recuperare le caselle vocali direttamente attraverso Microsoft Teams, migliorando l'esperienza utente generale.
Procedura per abilitare la casella vocale
Per abilitare la casella vocale per BroadWorks, devi abilitare il tasto di alternanza broadworks-voicemail-enabled-spark-541886: true a livello di organizzazione.
Per abilitare questa funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Esperienza utente
Una volta impostata l'integrazione, gli utenti possono:
- Recupera le caselle vocali direttamente all'interno dell'applicazione Microsoft Teams.
- Ricevi notifiche per i nuovi messaggi vocali.
- Gestisci le impostazioni della casella vocale dall'interfaccia Webex.
Requisiti
Per supportare il recupero della casella vocale nell'integrazione Microsoft Teams con l'offerta Webex per BroadWorks, sono necessarie ulteriori modifiche di rete. I partner BroadWorks devono abilitare la condivisione risorse cross-origin (CORS) per i seguenti URL sulla relativa piattaforma BroadWorks:
- https://jabber-integration-a.wbx2.com/
- https://jabber-integration-r.wbx2.com/
- https://jabber-integration-k.wbx2.com/
- https://msteams-calling.webex.com
Per ulteriori dettagli sulle fasi di configurazione, fare riferimento alla sezione 8.5.1.2 della Guida alla configurazione della piattaforma di consegna delle applicazioni BW, che richiede la versione 2024.05 sull'ADP.
Gruppo Parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione Parcheggio chiamata di gruppo e Retrieve. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono quindi essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti del retail in un'impostazione di store possono utilizzare la funzione per parcheggiare una chiamata che può essere selezionata da qualcuno in un altro reparto.
Operazione funzione
Una volta configurata la funzione
-
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nella relativa app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'interno all'utente per un periodo di 10 secondi.
-
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nella relativa app Webex. L'utente quindi inserisce l'interno della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per il funzionamento di questa funzione, verificare quanto segue:
-
Il file di configurazione del client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
-
L'identificativo di correlazione delle chiamate deve essere abilitato su AS e XSP|ADP. Per dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
-
L'SBC deve essere configurato per passare l'attributo SIP '
x-broadworks-correlation-in
' a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiunta di gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte 2. Devi creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Webex | Parcheggio e recupero delle chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzata
Il parcheggio chiamate regolari o dirette non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso alle funzioni:
-
Inserisci *68 per parcheggiare una chiamata
-
Inserisci *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato in ambienti di call center o in altre situazioni in cui può essere richiesta assistenza o intervento immediato.
Quando un servizio di inclusione è abilitato, un utente o un supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di pulsanti o tasti dedicata sul telefono o sul dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in diversi scenari. In un'impostazione di call center, i supervisori o i formatori possono monitorare e assistere i rappresentanti dell'assistenza clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire indicazioni o assumere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può accedere rapidamente alle conversazioni in corso per fornire assistenza o prendere decisioni importanti.
Nell'app Webex per Inclusione, viene inviata una notifica che indica che la chiamata viene trasformata in una conferenza. Non sono disponibili ulteriori informazioni in NOTIFY (info-chiamata o info-conferenza) qual è il tipo di conferenza, quindi possiamo trattarlo in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Sono introdotti i seguenti termini:
-
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore in genere ha la possibilità di monitorare e intervenire nelle chiamate dei clienti in corso. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire indicazioni agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può coinvolgere la formazione degli agenti, rispondere alle preoccupazioni dei clienti e ottimizzare le prestazioni del team.
-
Cliente: Un cliente si riferisce a una persona o entità che interagisce con una società o un'organizzazione per ottenere prodotti, servizi o supporto. Nel contesto dell'inclusione della chiamata, un cliente è qualcuno che effettua o riceve una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risoluzione di domande o problemi durante la chiamata. La funzione di inclusione della chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
-
Agente: Un agente, noto anche come rappresentante dell'assistenza clienti o agente di call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza tramite telefono o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare transazioni e offrire un'esperienza clienti positiva. Nel contesto dell'inclusione della chiamata, un agente è la persona che parla direttamente al cliente durante la telefonata. Se necessario, l'agente può ricevere istruzioni o feedback dal supervisore tramite l'inclusione delle chiamate.
Per qualsiasi richiesta avviata dal client come CallStartRequest, CallPickupRequest, DirectedCallPickupRequest, DirectedCallPickupWithBargeInRequest, ecc., se <Webex Client> (scegliere il nome corretto anziché il client Webex, se non è appropriato) viene fornito come dispositivo di visualizzazione della chiamata condivisa, la configurazione 'Avvisa tutti gli aspetti per le chiamate Click-to-Dial' deve essere abilitata nell'impostazione Identificativo chiamata condivisa affinché il client riceva una chiamata, a meno che la posizione non sia esplicitamente fornita dal client che avvia la richiesta.
Inoltro chiamata nativa mobile a riunione
L'escalation della chiamata nativa mobile a riunione è dotata di due funzioni univoche:
-
Nuova notifica push
Gli utenti mobili in una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando avvii una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si passa direttamente alla schermata durante la chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata tramite il controllo chiamate Cisco per le chiamate da cellulare, viene visualizzata la notifica Webex durante una chiamata da cellulare.
-
Trasferisci chiamata mobile nella riunione
Quando ci si trova nel mezzo di una chiamata con qualcuno, si consiglia di trasferire la chiamata in una riunione per utilizzare alcune funzioni avanzate per le riunioni come video, condivisione o lavagna. In alternativa, invita altre persone alla discussione e passa a una riunione.
Requisiti BroadWorks
-
Funzione attivabile 25239
-
R23 con XSP|ADP:
-
Patch AS AP.as.23.0.1075.ap383064
-
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
-
Patch AP.platform.23.0.1075.ap383064
-
-
R23 con ADP:
-
Patch AS AP.as.23.0.1075.ap383064
-
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e versione NPS > 2022.08_1.350
-
-
r24:
-
Patch AS: AP.as.24.0.944.ap383064
-
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e versione NPS > 2022.08_1.350
-
-
r25:
-
Versione RI Rel_2022.08_1.354
-
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e versione NPS > 2022.08_1.350
-
Configurazione chiamata URI per supportare il trasferimento di una chiamata nella riunione
Criteri di composizione Url NS
Definisci regola per l'indirizzamento di (.*)webex.com attraverso I-SBC
NS_CLI/Policy/UrlDialing> ottieni criteri WebexMeetings: Istanza chiamata URL: Webex unknownSipURIHandling = reject disableSubscriberLookup = true Abilita = true CallTypes: Selezione = {ALL} Da = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP} lineportOnly = false enableSipURIMatchingRules = true NS_CLI/Policy/UrlDialing/Rules> ottieni criteri WebexMeetings: Istanza chiamata URL: Tabella WebexCalling: Instradamento schema ID regolePeso costo dtg =================================================================== 1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> ottieni elemento di rete WebexMeetings Posizione = 1281465 Centro dati = Costo statico = 1 Peso statico = 99 Sondaggio = falso OpState = stato abilitato = Profilo onLine = NIL_PROFILE Ricerca remota abilitata = falso Attributi di segnalazione = NS_CLI/System/Device/RoutingNE/Address> ottieni WebexMeetings indirizzamento NE indirizzo Peso costo Percorso trasporto porta ===================================================================== WebexMeetings sbc-address 1 99 - non specificato
Profilo di indirizzamento NS
Istanza criteri di UrlDialing aggiunta ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> ottieni il profilo MyInst: Istanza criteri Webex ========================================== … ComposizioneUrl WebexMeetings
Utilizzo NS Route per chiamata NetworkURL
Consentire al AS di rispettare l'indirizzamento NS in modalità AS ibrido
AS_CLI/Interface/IMS> imposta queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un punto di risposta per la sicurezza pubblica (PSAP, Public Safety Answering Point) che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, devi integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Utilizza i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
-
-
Banda
-
Intrado
-
RedSky
-
Personalizzazione e provisioning dei client
Gli utenti scaricano e installano le proprie app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedi Piattaforme di app Webex). Una volta eseguita l'autenticazione, il client si registra su Webex Cloud per messaggi e riunioni, recupera le relative informazioni di branding, rileva le relative informazioni sul servizio BroadWorks e scarica la configurazione di chiamata dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
I parametri di chiamata per le app Webex vengono configurati in BroadWorks (come di consueto). È possibile configurare branding, messaggistica e parametri di riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta di modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
-
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Preparazione dell'ambiente).
-
Verificare di disporre dei set di tag corretti in Sistema BroadWorks > Risorse > Set di tag di gestione dispositivi.
-
Per ciascun client che stai predisponendo:
-
Scaricare ed estrarre il file zip DTAF per il client specifico.
-
Importa file DTAF in BroadWorks su Sistema > Risorse > Tipi di profilo identità/dispositivo
-
Apri il profilo dispositivo appena aggiunto per la modifica e:
-
Inserire il nome di dominio completo (FQDN) dell'azienda agricola XSP|ADP e il protocollo di accesso dispositivo.
-
Selezionare la casella di controllo Supporta info parte remota. Questo supporto è richiesto per il funzionamento della condivisione del desktop.
È inoltre possibile abilitare il supporto della parte remota eseguendo il seguente comando CLI sul server applicazioni:
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
-
-
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
-
Salvare il profilo.
-
-
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome |
Descrizione |
Priorità codec |
Configura ordine di priorità per codec audio e video per chiamate VoIP |
TCP, UDP e TLS |
Configurare i protocolli utilizzati per la segnalazione SIP e il contenuto multimediale |
Porte audio e video RTP |
Configura intervalli di porte per audio e video RTP |
Opzioni SIP |
Configurare diverse opzioni correlate a SIP (INFO SIP, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
-
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti che il partner gestisce. Vedi Configurazione delle personalizzazioni di branding avanzate.
-
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi il branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client.
Personalizzazione degli URL di segnalazione problemi e della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito di feedback e assistenza", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con provisioning a flusso costante
Prima di eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 |
Assegna servizio in BroadWorks: |
2 |
Verifica organizzazione cliente e utenti in Control Hub: |
Test utente
1 |
Scarica l'app Webex su due macchine diverse. |
2 |
Eseguire l'accesso come test degli utenti sulle due macchine. |
3 |
Effettuare chiamate di prova. |
Gestione di Webex per BroadWorks
Pre provisioning organizzazioni clienti
Nel modello corrente, viene eseguito automaticamente il provisioning dell'organizzazione del cliente quando si onboard il primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguita una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
-
Usa API per creare account Webex
-
Assegnare i messaggi e-mail integrati IM&P (provisioning flow) con e-mail affidabili per la creazione di account Webex
-
Assegna IM&P integrato (provisioning FLOW) senza messaggi e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per la creazione di account Webex
-
Consenti agli utenti l'attivazione autonoma (inviando loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex sono esposti API pubbliche per consentire ai provider di servizi di integrare Webex per il provisioning del sottoscrittore Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. La specifica per queste API è disponibile developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti Wholesale verranno rifiutati da queste API.
Provisioning Flow
Su BroadWorks, è possibile fornire agli utenti l'opzione Abilita IM integrato&P. Questa azione causa il provisioning dell'adattatore BroadWorks per rendere chiamata API di eseguire il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile retrocompatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica di codice, ma solo una modifica di configurazione all'endpoint API per l'adattatore di provisioning.
La fornitura del sottoscrittore su Webex può richiedere una notevole quantità di tempo (diversi minuti per l'utente iniziale in un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il completamento del provisioning di flusso indica che il provisioning è stato avviato. Non indica il completamento.
Per verificare che gli utenti e l'organizzazione del cliente siano completamente predisposti su Webex, è necessario accedere a Partner Hub e ricercare l'elenco dei clienti.
Gli utenti trunking BroadWorks possono disporre di Webex per BroadWorks tramite un aspetto di chiamata condivisa (SCA). All'utente del trunking deve essere assegnato il servizio di autenticazione. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto SCA Webex dall'autenticazione trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con funzioni di elenco di indirizzamento o di indirizzamento diretto assegnate.
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata modello di onboarding.
Attivazione automatica utente
Per fornire gli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
-
Accedi a Partner Hub e trova la pagina Elenco clienti .
-
Fare clic su View Templates (Visualizzamodelli).
-
Seleziona il modello di Onboarding di provisioning da applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non è nel sistema BroadWorks associato a questo modello, l'utente non può attivare automaticamente con il collegamento.
-
Copiare il collegamento per il provisioning e inviarlo all'utente.
È possibile anche includere il collegamento di download del software e ricordare all'utente che deve fornire e convalidare il relativo indirizzo e-mail per attivare l'account Webex.
-
È possibile monitorare lo stato di attivazione dell'utente sul modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi diattivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli nella vista Stato utente che consentono agli amministratori di Cisco BroadWorks provider di servizi di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Spostamento degli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a ... |
Segui questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (ad esempio, account gratuito, account di prova) |
|
Organizzazione cliente |
Allega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge anche Webex per BroadWorks agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a ... |
Segui questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (ad esempio, account gratuito, account di prova) |
Se l'organizzazione Webex per BroadWorks non esiste (non viene eseguito il provisioning di alcun utente):
Se esiste un'organizzazione Webex per BroadWorks (viene eseguito il provisioning di almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di iscrizione autonoma (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
-
Trasferisci utente (con e-mail attendibile): utilizza il provisioning con e-mail attendibili
-
Trasferisci utente (con e-mail non attendibile): utilizza il provisioning con e-mail non attendibili
-
Attivazione automatica
Se l'organizzazione Webex per Cisco BroadWorks non è ancora stata creata (non è stato eseguito il provisioning di alcun utente), seguire i normali processi di provisioning ( Provisioning utenti) per creare l'organizzazione e aggiungere il primo utente come utente di amministrazione. Una volta eseguito il provisioning del primo utente nell'organizzazione, seguire i metodi basati sul consenso in questa procedura per spostare gli utenti successivi.
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Activate Account (Attivaaccount). L'utente viene reindirizzato al portale consumer Webex.
-
L'utente accede a Webex.
-
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza e-mail non attendibili, è necessario convalidare prima l'indirizzo e-mail dell'utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito automaticamente sul bridge di provisioning BroadWorks.
-
All'utente viene inviato un testo con un collegamento di attivazione.
-
-
L'utente fa clic sul collegamento Attivazione e inserisce il relativo indirizzo e-mail.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Partecipaora.
-
Indirizzo e-mail convalidato.
-
L'utente viene reindirizzato per accedere al portale Webex Consumer.
-
-
L'utente accede a Webex.
-
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Flusso di attivazione automatica
Se l'utente dispone di un account BroadWorks esistente, potrà utilizzare il processo di attivazione automatica per spostare l'account.
-
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
-
L'utente inserisce il relativo indirizzo e-mail.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
Viene inviato un messaggio e-mail automatico all'indirizzo e-mail dell'utente.
-
-
L'utente apre il messaggio e-mail e fa clic sul collegamento Partecipa ora, che convalida l'indirizzo e-mail.
-
CI ha rilevato che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di continuare.
-
L'utente viene reindirizzato per accedere a Webex.
-
-
L'utente accede al portale consumer.
-
L'utente fa clic su Delete Account (Eliminaaccount).
-
L'account Webex precedente viene eliminato.
-
L'utente ha predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
Allega Webex per BroadWorks all'organizzazione esistente
Se si è un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, non ancora associata a un'azienda BroadWorks gestita da partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso dell'amministratore affinché la richiesta di provisioning venga eseguita correttamente.
L'approvazione dell'amministratore dell'organizzazione è necessaria se è vera una delle seguenti condizioni:
-
L'organizzazione del cliente esistente dispone di 100 utenti o più
-
L'organizzazione dispone di un dominio e-mail verificato
-
Dominio organizzazione richiesto
Se nessuno dei criteri precedenti è vero, si può verificare un collegamento automatico.
In uno scenario di Allegato automatico , un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner vengono riconosciuti diritti di amministratore di provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà impostato un amministratore completo.
Con l'accesso amministratore di provisioning, si avrà visibilità limitata in Control Hub agli utenti dell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione.
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che l'opzione Consenti inviti e-mail amministratore al momento del collegamento a organizzazioni esistenti (il tasto di alternanza è attivato per impostazione predefinita).
1 |
L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedi Provisioning organizzazioni clienti. Si verifica quanto segue:
Supponi che l'amministratore del cliente non riceva un messaggio e-mail. In tal caso, l'amministratore del cliente può aggiungere manualmente l'amministratore del partner (specificato nel modello) come amministratore esterno dell'organizzazione cliente da Control Hub. Quindi, riprovare a eseguire il provisioning dell'utente per attivare il provisioning del cliente Webex per Cisco BroadWorks. |
2 |
Con l'accesso di amministratore completo , l'amministratore partner può completare il processo di provisioning del cliente. Dovrai tentare di nuovo il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora in qualità di amministratore completo esterno, non è necessario osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione del cliente esistente sarà visibile come cliente sotto l'organizzazione partner Webex per BroadWorks. Il nome dell'organizzazione allegata non cambierà in nome aziendale BroadWorks. Il nome dell'organizzazione allegata rimarrà uguale a quello precedente al processo di allegazione. |
Condizioni dell'allegato organizzazione
-
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione cliente di destinazione. Altrimenti, verrà creata una nuova organizzazione cliente.
-
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
-
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato nel modello di provisioning Webex per BroadWorks. Di conseguenza, non sono state apportate modifiche alla modalità di accesso degli utenti esistenti.
-
Tuttavia, se l'organizzazione del cliente esistente ha abilitato il branding base, una volta eseguito l'allegato, le impostazioni di branding avanzato del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
-
-
Il nome dell'organizzazione esistente non cambierà.
-
Nessuna modifica all'impostazione del flag di eliminazione e-mail nelle impostazioni dell'organizzazione esistente. Ciò potrebbe incidere sugli utenti predisposti di recente. A seconda di come è impostato il flag, i nuovi utenti possono ricevere o meno un messaggio e-mail con un codice che deve essere inserito per completare l'attivazione.
-
La modalità di amministrazione con limitazioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
-
Assicurati di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
-
È possibile associare un'azienda BroadWorks a una sola organizzazione Webex. Non è possibile eseguire il provisioning degli abbonati di una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com .
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo.
L'indirizzo e-mail che l'amministratore dell'organizzazione cliente aggiunge come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore del partner come configurato nel modello di onboarding su Partner Hub.
Dopo aver aggiunto l'e-mail dal modello di onboarding su Partner Hub come amministratore completo, qualsiasi altro amministratore partner dovrà essere aggiunto come amministratore esterno con diritti di amministratore completo.
Scollegare Webex per BroadWorks dall'organizzazione esistente
Segui questa procedura per deviare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato Webex per BroadWorks a un'organizzazione esistente per errore e si desidera rimuovere l'allegato.
Nel flusso standard, la disconnessione di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati.
-
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso amministratore esterno seguendo l'opzione Approva richiesta amministratore esterno.
-
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi un'area di lavoro BroadWorks .
-
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi un abbonato BroadWorks .
-
Rimuovere gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se è stato eseguito il provisioning degli utenti tramite il flusso e-mail non attendibili e non sono stati ancora inseriti messaggi e-mail validi, gli utenti vengono lasciati in sospeso. Segui Verifica provisioning utente con messaggi e-mail non attendibili per eliminare gli utenti.
-
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Ibrido, nella sezione BroadWorks Calling , elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera allegare Webex per BroadWorks al cliente, seguire i processi di provisioning per il collegamento a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API Rimuovi un abbonato BroadWorks consiste nell'accedere a BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati.
Gestisci utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente vengono tenuti in BroadWorks. Un'identità e-mail distinta per l'utente e relative licenze per le funzioni Webex sono tenute in Webex.
Verifica del provisioning utenti con indirizzi e-mail non attendibili
Se si sta predis facendo il provisioning di Webex per utenti BroadWorks utilizzando il provisioning flow-through con messaggi e-mail non attendibili, gli utenti devono autoproducersi inserendo il proprio indirizzo e-mail nel portale di attivazione utenti. Se l'utente rileva un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riconorà l'errore, l'amministratore può utilizzare la procedura seguente in Partner Hub per esaminare lo stato e onboardre l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 |
Accedi a Partner Hub e trova la pagina Elenco clienti . |
2 |
Fare clic su View Templates (Visualizzamodelli). Seleziona il modello di onboarding appropriato da applicare a questo utente. |
3 |
In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con messaggi e-mail non attendibili sia configurato correttamente:
|
4 |
Dopo il provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato di provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo Stato corrente, che mostra se l'utente è stato predisposto o se è presente un requisito in sospeso.
|
5 |
Per gli utenti con errori o requisiti in sospeso, fare clic sui tre puntini a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili durante la visualizzazione dell'elenco di utenti:
-
Esporta: fai clic su questo pulsante se desideri esportare l'elenco utenti in un file CSV.
-
Escludi utenti di cui è stato eseguito il provisioning: abilitare questo tasto di alternanza se si desidera visualizzare solo gli utenti con requisiti in sospeso o errori.
Modifica ID utente o indirizzo e-mail
Modifiche dell'ID utente e dell'indirizzo e-mail
ID e-mail e ID alternativo sono attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. Nella tabella seguente vengono descritti gli scopi di questi diversi attributi e le operazioni da eseguire per modificarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non è possibile modificare questo identificativo e collegare comunque l'utente allo stesso account in Webex. È possibile eliminare l'utente e crearla nuovamente se è errata. |
ID e-mail | ID utente |
Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si asserzione di attendibilità dell'e-mail Non richiesto in BroadWorks se non si asserzione di affidabilità dei messaggi e-mail Non richiesto in BroadWorks se si consente agli abbonati di attivare automaticamente |
Se l'utente è predisposto con l'indirizzo e-mail errato, è necessario effettuare un processo manuale per modificare questa impostazione in entrambi i punti:
Non modificare l'ID utente BroadWorks. Operazione non supportata. |
ID alternativo | Nessuno | Abilita autorizzazione utente, tramite e-mail e password, a fronte dell'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti devono immettere il relativo ID utente BroadWorks durante l'autenticazione. |
Modifica del pacchetto utente nell'hub partner
1 |
Accedere all'hub partner e fare clic su Clienti. |
2 |
Individuare e selezionare l'organizzazione del cliente in cui si trova l'utente. La pagina di panoramica dell'organizzazione viene visualizzata in un pannello a destra dello schermo. |
3 |
Fare clic su View Customer (Visualizzacliente). L'organizzazione del cliente viene aperta in Control Hub, che mostra la pagina Panoramica.
|
4 |
Fare clic suUtenti, quindi individuare e fare clic sull'utente interessato. |
5 |
In Servizi dell'utente, fare clicsu Webex per pacchetti BroadWorks (Sottoscrizioni). Viene visualizzato il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 |
Nella scheda Profilo , ricercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 |
Selezionare il pacchetto che si desidera per questo utente (Base, Standard, Premium o Softphone) e fare clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 |
È possibile chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium dispongono di siti per riunioni distinti associati a ciascun pacchetto. Se un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato visualizza due siti per riunioni in Control Hub. Le funzionalità di riunione e il sito della riunione dell'abbonato si allineano al pacchetto corrente. Il sito per riunioni del pacchetto precedente e tutto il contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili ad Amministrazione sito riunione.
Potrebbero essere necessario da due a tre ore per le PMR di aggiornamento che sono risultate da una modifica del pacchetto all'aggiornamento.
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si intende eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto il trasferimento automatico del ruolo di amministratore nel caso in cui l'ultimo amministratore venga eliminato.
Webex per API Cisco BroadWorks
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
-
Eseguire la richiesta di rimozione dell'API di un abbonato BroadWorks su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento a Webex per Cisco BroadWorks. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
Eseguire la richiesta DI ELIMINAZIONE DI una persona su per eliminare completamente https://developer.webex.com/docs/api/v1/people/delete-a-person l'utente.
Flow-through Provisioning
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
-
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – PAGINA IM&P integrata su BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento a Webex per Cisco BroadWorks dall'utente. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori dei clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla relativa organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 |
Usa le API Persone per eliminare tutti gli utenti dall'organizzazione: Rimozione di un'API abbonato BroadWorks rimuove i diritti Webex per Cisco BroadWorks da un utente, ma non elimina l'utente. |
2 |
Se la sincronizzazione delle rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione delle rubriche tramite Partner Hub: Per disabilitare la sincronizzazione delle directory tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API BroadWorks Enterprise e disabilita l'impostazione enableDirSync . Tutti gli utenti correlati alla sincronizzazione delle rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione di utenti (utilizzando uno dei metodi) può richiedere del tempo in base alla quantità di utenti. |
3 |
Una volta rimossi tutti gli utenti, utilizzare l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Annullamento di un abbonamento da Control Hub
Poiché l'API è privata, i clienti non potranno accedervi. Al contrario, la seguente procedura mostra come i clienti possono annullare il proprio abbonamento da Control Hub:
-
L'amministratore del partner può passare alla pagina dei servizi "Ibridi" in Control Hub del cliente.
-
Individuare la scheda "BroadWorks Calling".
-
Una volta eseguito il provisioning di tutti gli utenti da Webex per BroadWorks per tale cliente, il partner visualizza un pulsante per "Cancella configurazione" (ad esempio, elimina la relativa customer_config voce in BPB).
Gestione release
I controlli di gestione delle release in Partner Hub consentono ai provider di servizi Cisco BroadWorks di gestire le release fornendo loro la possibilità di controllare la data di rilascio in base alla quale le app Webex degli utenti ese upgrade all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza aggiornamenti Automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
-
Configura pianificazioni di rilascio personalizzate con differimenti dalla pianificazione di rilascio predefinita di Cisco
-
Configurare una pianificazione a singola release e una propagazione a catena tale pianificazione per tutte le organizzazioni dei clienti che gestiscono
-
Assegna diverse pianificazioni di release a diverse organizzazioni cliente
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di release personalizzate, vedi l'articolo di Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
-
Aggiunta di un cluster BroadWorks in Hub partner
-
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
-
Aggiungi un modello di onboarding in Partner Hub
-
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su |
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. |
3 |
Fare clic su View Clusters (Visualizzacluster). |
4 |
Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro a destra.
|
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su | |||||||||
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. | |||||||||
3 |
Fare clic su View Templates (Visualizzamodelli). | |||||||||
4 |
Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere Assistente Webex follow-up su attività, prendere nota di importanti decisioni ed evidenziare momenti chiave durante una riunione o un evento.
Assistente Webex per Meetings è disponibile gratuitamente per i siti di riunione Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilita Webex Assistant per le riunioni
Assistente Webex è abilitato per impostazione predefinita per i clienti BroadWorks dei pacchetti standard e premium.
Gli amministratori partner e gli amministratori dell'organizzazione cliente possono disabilitare la funzione per le organizzazioni cliente attraverso Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
-
Il supporto è limitato a pacchetti Premium e Standard e solo a sale riunioni personali.
-
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
-
La condivisione del contenuto tramite e-mail è accessibile solo agli utenti all'interno della tua organizzazione
-
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Anche il contenuto della riunione non è accessibile quando è condiviso tra utenti di pacchetti diversi all'interno della stessa organizzazione.
-
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
-
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile e pertanto le trascrizioni post-riunione non sono disponibili indipendentemente dal fatto che Webex Assistant sia abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni sull'uso della funzione, vedere uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
La chiamata Webex gratuita è abilitata per impostazione predefinita, consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, disabilitando tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzioni
Se Webex Calling è disabilitato, si applicano le seguenti condizioni a Webex per gli utenti Cisco BroadWorks:
-
Gli utenti non visualizzano più Chiama con Webex come opzione di chiamata selezionabile sull'app Webex.
-
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per utenti Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, Cronologia chiamate, Contatti, inserendo l'URI o l'indirizzo e-mail dell'altro utente nella barra di ricerca.
-
La condivisione dello schermo funziona all'interno di una chiamata BroadWorks.
-
Le riunioni Webex e la presenza di telefonia continuano a funzionare anche se le chiamate Webex sono disabilitate.
Disabilita Webex Calls (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno della procedura guidata Aggiungi nuovo modello . Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti che assegni al modello.
Per dettagli sulla configurazione di un nuovo modello di onboarding, vedi Configurazione dell'organizzazione partner in Partner Hub.
Disabilita Webex Calls (modello di onboarding esistente)
Segui questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
-
Accedi a Partner Hub all'indirizzo admin.webex.com.
-
Scegliere Impostazioni.
-
Fare clic su Visualizza modello e scegliere il modello di onboarding appropriato.
-
Fai clic su Disabilita chiamata gratuita Cisco Webex.
-
Fare clic su Salva.
Disabilita Webex Calls (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare le chiamate Webex per un utente esistente, puoi seguire una delle procedure seguenti per aggiornare l'utente.
Accertati di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigurerà l'utente con le chiamate Webex abilitate.
Se si sta utilizzando il provisioning flow-through, è possibile effettuare le seguenti operazioni:
-
Aprire CommPilot e andare alla configurazione utente.
-
Rimuovere il servizio IM+P integrato dall'utente e fare clic su OK.
-
Aggiungere il servizio IM+P integrato all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
-
Utilizzare Rimuovi un'API abbonato BroadWorks per eliminare l'utente.
-
Utilizzare Esegui provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione del video o della condivisione dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per i dettagli e le opzioni di configurazione completi, vedi Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è inoltre possibile configurare se il contenuto multimediale per le chiamate in ingresso utilizza per impostazione predefinita solo video o audio.
Indicatore di stato della linea/Notifica risposta per assente
La funzione Indicatore di stato/Notifica risposta per assente utilizza le funzioni Indicatore di stato e Risposta per assente indirizzata. Un utente di indicatori di stato riceve una notifica audio e visiva sull'app Webex quando un utente dall'elenco monitorato di indicatori di stato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può ignorare o rispondere alla chiamata dell'utente monitorato.
La notifica di risposta per assente (BLF) è utile in situazioni in cui un utente deve rispondere alle chiamate per altri membri di team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra multi-chiamata - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza di membri del team Webex e non Webex. Per informazioni sull'abilitazione della chiamata multipla, vedere: Finestra multi-chiamata
I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati con la rubrica in Webex e disporranno solo degli stati "sconosciuti" e "in chiamata" (lo stato di suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
-
La presenza non è supportata per utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
-
Gli utenti CI senza autorizzazione cloud Webex o il tipo di account macchina (spazi di lavoro) mostrano solo la presenza 'in chiamata' e 'sconosciuta'. Nessuno stato attivo, suoneria, eccetera.
-
Gli utenti non Webex presenti nell'elenco di monitoraggio degli indicatori di stato che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza 'sconosciuta'.
-
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
-
Se un utente non Webex dell'indicatore di stato mette in attesa una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate a BroadWorks. Installare solo le patch che si applicano alla versione in uso:
Per R22:
-
AP.platform.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382362
-
AP.xsp.22.0.1123.ap382053
-
AP.xsp.22.0.1123.ap382362
-
AP.as.22.0.1123.ap383459
-
AP.as.22.0.1123.ap383520
Per R23:
-
AP.platform.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382362
-
AP.as.23.0.1075.ap383459
-
AP.as.23.0.1075.ap383520
-
Se si utilizza XSP|ADP:
-
AP.xsp.23.0.1075.ap382053
-
AP.xsp.23.0.1075.ap382362
-
-
Se stai utilizzando ADP:
-
XSI-Actions-23_2022.01_1.200.bwar
-
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
-
Per R24:
-
AP.as.24.0.944.ap382053
-
AP.as.24.0.944.ap382362
-
AP.as.24.0.944.ap383459
-
AP.as.24.0.944. ap383520
-
XSI-Actions-24_2022.01_1.200.bwar
-
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
-
<indicatore di stato abilitato="%ENABLE_BUSY_LAMP_FIELD_WXT%">
-
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
-
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare il Meccanismo Xsi Avanzato 101642 Per Telefonia team sul AS:
AS_CLI/System/ActivatableFeature> attivare 101642
Abilitare X-BroadWorks-Remote-Party-Info
sul server AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamate SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
Verifica che i seguenti servizi siano assegnati agli utenti:
-
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
-
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione dell'indicatore di stato della linea su BroadWorks
Per impostare l'indicatore di stato della linea per un utente, gli amministratori dei partner possono utilizzare la procedura seguente.
-
Accedi a BroadWorks CommPilot.
-
Per un utente selezionato, andare ad Applicazioni client e configurare l'indicatore di stato della linea.
-
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
-
Utilizzare i parametri di ricerca per individuare e aggiungere gli utenti all'elenco Utenti monitorati .
-
Fare clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento facile da utilizzare per il coinvolgimento del pubblico. Consente alle persone di ottenere il massimo dalle riunioni colmando la differenza tra gli oratori e i partecipanti. Se Slido questa funzione è integrata nell'organizzazione Control Hub, gli utenti possono aggiungere l'app Slido alle relative riunioni nell'app Webex. Questa integrazione aggiunge funzionalità Q&A di sondaggi e di sondaggi aggiuntivi alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando si accetta una riunione nel client Outlook che sia un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che si è altrimenti coinvolti e che una risposta potrebbe essere ritardata.
Per abilitare questa funzione:
-
passare alla scheda Generale della scheda Impostazioni su Windows o Preferenze su Mac.
-
Selezionare la casella Mostra se presente in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, l'opzione "In una riunione di calendario" in Webex viene associata a "Occupato" in Outlook.
Avvertenza
Per il funzionamento di questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come lavorando altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra quando presente in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la presenza di tale utente non verrà aggiornata finché non termina la riunione. Questa operazione richiederà un riavvio del client per rispondere.
Risposta automatica con segnale acustico
Con la risposta automatica con segnale acustico, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul proprio desktop. Quando l'app Webex squilla sull'interlocutore, l'utente sente un determinato tono per avvisarlo che la chiamata è connessa.
Affinché un utente Webex per Cisco BroadWorks utilizzi questa funzione:
-
La funzione è supportata solo sull'identificativo di linea principale
-
L'app Webex deve essere l'identificativo di linea principale
-
Il %ENABLE_AUTO_ANSWER_WXT% tag deve essere abilitato
Se l'utente ha anche indicatori di chiamata condivisa (ad esempio, un telefono della scrivania è configurato come uno degli indicatori di linea secondari), la funzione è ancora supportata sull'identificativo principale a condizione che gli indicatori di chiamata condivisa non siano configurati per ricevere le chiamate in arrivo. Questa operazione può essere eseguita configurando una delle tre condizioni seguenti su BroadWorks per tutti gli aspetti di chiamata condivisa:
-
L'opzione Avvisa tutte le apparenze per le chiamate Click-to-Dial è disabilitata nella configurazione dell'Aspetto chiamata condivisa: questo è l'approccio consigliato
o
-
L'opzione Consenti terminazione a questa posizione deve essere disabilitata per tutti gli indicatori di chiamata condivisa o
o
-
Posizioni disabilitate per tutti gli indicatori di chiamata condivisa
Aumento della capacità
Aziende XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare il numero di risorse ADP XSP|aggiuntive necessarie per l'aumento proposto del numero di abbonati. Per uno dei server NPS dedicati o dedicati a Webex per Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
-
Ridimensiona azienda agricola dedicata: Aggiungere uno o più server ADP XSP| all'azienda agricola che richiede capacità aggiuntiva. Installare e attivare la stessa serie di applicazioni e configurazioni dei nodi esistenti del sistema.
-
Aggiungi azienda agricola dedicata: Aggiungi un nuovo farm ADP XSP|dedicato. Sarà necessario creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti sul nuovo registro, per esitare gli utenti a essere presenti nell'hub esistente.
-
Aggiungi azienda agricola specializzata: Se si verificano strozzature per un determinato servizio, si consiglia di creare un'azienda XSP|ADP separata a tale scopo, tenendo in considerazione i requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster Control Hub e le voci DNS se si modifica l'URL del servizio con un nuovo registro.
In tutti i casi, il monitoraggio e la risorsa dell'ambiente BroadWorks è di responsabilità. Se si desidera coinvolgere l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare servizi professionali.
Gestione dei certificati del server HTTP
Devi gestire questi certificati per le applicazioni Web autenticate mTLS sulle tue ADP XSP|:
-
Certificato di catena di fiducia del cloud Webex
-
Certificati delle interfacce server HTTP di|ADP XSP
Catena di fiducia
È possibile scaricare il certificato di catena di attendibilità da Control Hub e installarlo sugli ADP XSP| durante la configurazione iniziale. Si prevede di aggiornare il certificato prima della scadenza e di notificare come e quando modificarlo.
Interfacce server HTTP
L'ADP XSP| deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Ordina certificati. Quando si protegge per la prima volta l'interfaccia, viene generato un certificato autofirmato. Questo certificato è valido per un anno a partire da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione Partner Hub che gli amministratori partner possono assegnare a specifiche organizzazioni clienti per limitare le impostazioni dell'organizzazione che gli amministratori clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione cliente, tutti gli amministratori dei clienti di tale organizzazione, indipendentemente dai diritti di ruolo, non possono accedere a una serie di controlli limitati in Control Hub. Solo un amministratore partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner non è un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita i diritti di ruolo specifici per gli amministratori dei clienti nell'organizzazione a cui viene applicata l'impostazione.
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità Con limitazioni del partner. Dopo l'accesso, verrà visualizzato un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner informa l'amministratore del cliente che la modalità con limitazioni è abilitata e che potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore di clienti in un'organizzazione in cui è abilitata l'opzione Con limitazioni della modalità partner, il livello di accesso a Control Hub è determinato con la formula seguente:
(Accesso Control Hub) = (Diritti ruolo organizzazione) - (Limitati dalle limitazioni della modalità partner)
Gli amministratori dei clienti subiranno diverse limitazioni, indipendentemente dalla modalità con limitazioni da parte del partner. Tali limitazioni includono:
- Impostazioni chiamata: Le impostazioni 'Priorità chiamata Opzioni app' nel menu Chiamata sono di sola lettura.
- Impostazione posizione: L'impostazione della chiamata in seguito alla creazione della posizione verrà nascosta.
- Gestione PSTN e registrazione chiamate: Queste opzioni saranno in grigio per la posizione.
- Gestione numeri di telefono: Nel menu Chiamata, la gestione dei numeri di telefono è disabilitata e le impostazioni 'Priorità chiamata opzioni app' nonché le registrazioni delle chiamate sono di sola lettura.
Limitazioni
Quando la modalità con limitazioni del partner è abilitata per un'organizzazione del cliente, gli amministratori dei clienti in tale organizzazione non possono accedere alle seguenti impostazioni di Control Hub:
-
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
-
Il pulsante Gestisci utenti è disattivato.
-
Aggiunta o modifica manuale utenti: nessuna opzione per aggiungere o modificare gli utenti, manualmente o tramite CSV.
-
Richiedi utenti—non disponibile
-
Assegna automaticamente licenze: non disponibili
-
Sincronizzazione rubriche: impossibile modificare le impostazioni di sincronizzazione rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
-
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato e indirizzo e-mail principale* sono modificabili.
-
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
-
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, Messaggi, Riunioni, Chiamata)
-
Visualizzazione dello stato dei servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
-
Numero ufficio principale: questo campo è di sola lettura.
-
-
Nella vista Account, non sono disponibili le seguenti impostazioni:
-
Nome società di sola lettura.
-
-
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
-
Dominio: l'accesso è di sola lettura.
-
E-mail: le impostazioni Elimina invito e-mail amministratore e Selezione locale e-mail sono di sola lettura.
-
Autenticazione: nessuna opzione per modificare le impostazioni di autenticazione e SSO.
-
-
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
-
Impostazioni chiamata: le impostazioni di Priorità chiamata opzioni app sono di sola lettura.
-
Funzionamento chiamata: le impostazioni sono di sola lettura.
-
Posizione > PSTN: le opzioni gateway locale e Cisco PSTN sono nascoste.
-
-
In SERVIZI, le opzioni di servizio Migrazioni e Connected UC sono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori dei partner possono utilizzare la procedura seguente per abilitare l'opzione Con limitazioni della modalità partner per una determinata organizzazione cliente (l'impostazione predefinita è abilitata).
-
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
-
Selezionare l'organizzazione del cliente applicabile.
-
Nella vista delle impostazioni a destra, abilitare l'interruttore Limitato dalla modalità partner per attivare l'impostazione.
Se si desidera disattivare Limitazione della modalità partner, disabilitare l'interruttore.
Se il partner rimuove la modalità di amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà effettuare le seguenti operazioni:
-
Aggiungi utenti Webex per Wholesale (con il pulsante)
-
Modifica pacchetti per un utente
Per ulteriori informazioni sull'elenco dei fusi orari supportati per il provisioning Wholesale, vedere Elenco dei fusi orari supportati per il provisioning Wholesale.
Analisi partner
I miglioramenti apportati a Control Hub rendono semplice agli amministratori dei partner visualizzare e aggiornare le informazioni del pacchetto per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata tra tutti i clienti e include i seguenti dettagli:
-
Totale utenti per pacchetto (Softphone, Basic, Standard, Premium)
-
Tendenza utenti per pacchetto (giornaliera/settimanale/mensile)
-
Clienti con n. di pacchetti assegnati
Per dettagli completi sull'uso della funzionalità di analisi dei partner, vedere l'articolo Webex Analytics per Webex per i pacchetti Eseeme e Webex per pacchetti Broadworks in Partner Hub.
API report di fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per i report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare i report di fatturazione. Nella tabella riportata di seguito vengono elencate le API, il tipo di accesso richiesto e i requisiti del ruolo.
API di fatturazione |
Scopo |
Tipo di accesso |
Requisito del ruolo per API (l'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Crea un report di fatturazione BroadWorks |
Utilizzato per generare un report di fatturazione. |
Accesso di scrittura |
|
Elenca report di fatturazione BroadWorks |
Utilizzato per elencare i report disponibili per la visualizzazione. |
Accesso di lettura |
|
Come ottenere un report di fatturazione BroadWorks |
Utilizzato per ottenere una copia di un report generato. |
Accesso di lettura |
|
Eliminazione di un report di fatturazione BroadWorks |
Utilizzato per eliminare un report generato. |
Accesso di scrittura |
|
Campi di fatturazione
Nella tabella seguente vengono elencati i campi contenuti nel report generato.
Campo |
Descrizione |
---|---|
Nome rivenditore |
Nome partner o ID organizzazione partner |
ID fatturazione |
Identificativo di fatturazione univoco partner o numero C |
ID spEnterprise |
Identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno |
Stato della versione di prova interna del cliente (Sì/No) |
ID utente |
L'ID utente dell'abbonato su BroadWorks |
ID abbonato |
Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato |
Sì/No |
primaDataInizio |
Data di provisioning dell'abbonato. |
Data di inizio fatturazione |
Data di inizio della fatturazione in questo mese |
Data di fine fatturazione |
Data di fine della fatturazione in questo mese |
pacchetto |
Tipo di pacchetto che viene addebitato |
quantità |
Quantità proporzionale per la fatturazione.
|
-
Una volta generato un report di fatturazione per un determinato periodo di tempo, non è possibile rigenerare tale report a meno che non si elimini prima il report esistente.
-
Se si modifica il tipo di pacchetto o l'ID utente BroadWorks per un determinato utente, il report del mese in cui si è verificata la modifica mostra più voci per tale utente con voci proporzionali separate prima e dopo la modifica.
Risoluzione dei problemi di Webex per Cisco BroadWorks
Iscrizione alla pagina di stato Webex
Innanzitutto, https://status.webex.com verificare se si verifica un'interruzione imprevista del servizio. Se non è stata modificata la configurazione in Control Hub o BroadWorks prima dell'interruzione, controllare la pagina di stato. Per ulteriori informazioni sulla sottoscrizione per lo stato e le notifiche di incidenti, vedere il Centro di assistenza Webex.
Uso della funzionalità di analisi di Control Hub
Webex tiene traccia dei dati di utilizzo e qualità per la propria organizzazione e per le organizzazioni dei clienti. Ulteriori informazioni sulla funzionalità di analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
I clienti o gli utenti non vengono creati in Control Hub con provisioning flow provisioning:
-
Il server dell'applicazione può raggiungere l'URL di provisioning?
-
L'account di provisioning e la password sono corretti, se esistono in BroadWorks?
I cluster non riescono regolarmente con i test di connettività:
La connessione mTLS al servizio di autenticazione dovrebbe non riuscire quando si crea il primo cluster in Partner Hub poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. Senza questo, non è possibile creare un trust anchor sugli ADP XSP| del servizio di autenticazione, quindi la connessione mTLS di test da Partner Hub non viene eseguita correttamente.
-
Le interfacce XSP|ADP sono accessibili pubblicamente?
-
Si stanno utilizzando le porte corrette? È possibile inserire una porta nella definizione dell'interfaccia sul cluster.
Convalida interfacce non riuscita
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano stati inseriti correttamente sul cluster in Partner Hub, incluso
/v2.0
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Esaminare l'avviso di configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano stati inseriti correttamente sul cluster in Partner Hub, incluso
/v2.0
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Rivedere i consigli di configurazione dell'interfaccia in questo documento, con particolare attenzione su:
- Accertarsi di aver condiviso le chiavi RSA tra tutte le ADP XSP|.
- Accertarsi di aver fornito l'URL AuthService al container Web su tutti gli ADP XSP|.
- Se è stata modificata la configurazione di crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'ADP XSP| richiede l'inserimento del formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento indicava in modo errato le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
-
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati nell'archivio attendibilità XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere certificati client?
-
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere certificati client?
Problemi del client
Verificare che il client sia connesso a BroadWorks
-
Accedere all'app Webex.
-
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.
-
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici. Viene visualizzato lo stato della SSO è stato eseguito l'accesso.
Se viene visualizzato un altro servizio telefonico, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Ciò significa:
-
Il client ha transverso correttamente i microservizi Webex richiesti.
-
L'utente è stato autenticato correttamente.
-
Il client è stato emesso un token Web JSON a lungo termine dal sistema BroadWorks.
-
Il client ha recuperato il profilo del dispositivo ed è registrato per BroadWorks.
Registri client
Tutti i client app Webex possono inviare log a Webex. Questa è l'opzione migliore per client mobili. È necessario registrare anche l'indirizzo e-mail dell'utente e l'ora approssimativa del problema, se si desidera assistenza dal Tac. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se occorre raccogliere manualmente i registri da un PC Windows, si trovano nel seguente modo:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac: /Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS non configurata correttamente
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
-
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
-
Verificare che la catena di certificati Webex sia installata come trust anchor.
-
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e che sia firmato da un'autorità di certificazione attendibile.
Messaggio interruzione licenza
Questo messaggio può essere visualizzato per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'uso della licenza supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Criteri di supporto stato originale
Il provider di servizi è il primo punto di contatto per il supporto clienti finale (enterprise). Inoltrare i problemi che il SP non può risolvere al TAC. Il supporto della versione server BroadWorks segue i criteri della Versione corrente e delle due precedenti versioni principali (N-2). Ulteriori informazioni sono disponibili nella sezione Criteri per il ciclo di vita dei prodotti BroadSoft in Criteri per il ciclo di vita di BroadSoft e Matrice di compatibilità software BroadWorks.
Criteri di escalation
-
L'utente (provider di servizi/partner) è il primo punto di contatto per il supporto dei clienti finali (enterprise).
-
I problemi che non possono essere risolti dal SP vengono inoltrati al TAC.
Versioni BroadWorks
-
Il supporto della versione server BroadWorks segue i criteri di BroadSoft, della versione corrente e delle due versioni principali precedenti (N-2). Ulteriori informazioni sono disponibili nella sezione Criteri per il ciclo di vita dei prodotti BroadSoft in Criteri per il ciclo di vita di BroadSoft e Matrice di compatibilità software BroadWorks.
Risorse di self-support
-
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, in cui è disponibile una pagina specifica di Webex per Cisco BroadWorks che elenca la Guida per l'app Webex comune e gli argomenti di supporto.
-
È possibile personalizzare l'app Webex con questo URL della Guida e un URL per la segnalazione di problemi.
-
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I log vengono nel cloud Webex, dove possono essere analizzati da Webex DevOps.
-
È disponibile anche una pagina del Centro assistenza dedicata alla guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccolta delle informazioni per l'invio di una richiesta di assistenza
Quando si visualizzano errori in Control Hub, è possibile che siano state allegati informazioni che consentono al Tac di ricercare la causa del problema. Ad esempio, se viene visualizzato un ID di verifica per un determinato errore o un codice di errore, salvare il testo da condividere con noi.
Provare a includere almeno le seguenti informazioni quando si invia una query o si apre un caso:
-
ID organizzazione cliente e ID organizzazione partner (ciascun ID è una stringa di 32 cifre esadecimali, separate da trattini)
-
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce una
-
Indirizzo e-mail utente (se si verificano problemi con un determinato utente)
-
Versioni del client (se il problema presenta sintomi notati attraverso il client)
Webex per riferimento a BroadWorks
Confronto DI UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > |
UC-One SaaS |
Webex per Cisco BroadWorks |
---|---|---|
Cloud |
Cisco UC-One Cloud (GCP) |
Cloud Webex (APPLICAZIONI WEBEX) |
Client |
UC-One: Mobile, Desktop Receptionist, Supervisore |
Webex: Mobile, Desktop, Web |
Principale differenza tecnologia |
Riunioni consegnate su Broadsoft Meet Technology |
Riunioni consegnate su Webex Meetings Technology |
Versioni di prova sul campo iniziali |
Ambiente di gestione temporanea, client Beta |
Ambiente di produzione, client GA |
Identità utente |
BroadWorks ID utilizzato come ID principale, a meno che provider di servizi sito non SSO già.
ID utente e segreto in BroadWorks |
ID e-mail in Cisco CI serve come ID principale SSO integrazioni in provider di servizi BroadWorks in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks in quel momento.
L'utente fornisce le credenziali tramite SSO broadworks e secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e autenticazione nel provider di identità |
Autenticazione client |
Gli utenti forniscono le credenziali tramite il client Token a lungo accesso BroadWorks richiesti se si utilizza la messaggistica Webex |
Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso e aggiornamento dei token Webex |
Gestione/configurazione |
I sistemi ANDR E BSS e Portale rivenditore |
SISTEMI CUI/BSS e Control Hub |
Attivazione partner/provider di servizi partner |
Una sola impostazione per Cisco Operations |
Una sola impostazione per Cisco Operations |
Attivazione cliente/aziendale |
Portale rivenditore |
Control Hub Creazione automatica alla prima iscrizione utente |
Opzioni di attivazione utente |
Auto iscrizione Impostazione di IM&P esterno in BroadWorks
|
Impostazione di Integrated IM&P in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP |
Azioni XSI
Eventi XSI CTI (mTLS) AuthService (mTLS opzionale) DMS |
Azioni XSI Azioni XSI (mTLS) Eventi XSI CTI (mTLS) AuthService (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 |
Scaricare e installare Webex. Per dettagli, vedere Webex | Download dell'app. |
2 |
Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 |
Inserire il proprio indirizzo e-mail e fare clic su Next(Avanti). |
4 |
In base alla configurazione dell'organizzazione in Webex, si verificano le seguenti operazioni: Webex viene caricato dopo aver eseguito correttamente l'autenticazione per IdP o BroadWorks.
|
Scambio dati e storage
Queste sezioni forniscono dettagli sullo scambio di dati e sullo storage con Webex. Tutti i dati sono crittografati sia in viaggio che a riposo. Per ulteriori dettagli, vedere Sicurezza app Webex.
provider di servizi ilboarding
Quando si configurano cluster e modelli utente in Webex Control Hub durante provider di servizi onboarding, si scambiano i seguenti dati BroadWorks memorizzati da Webex:
-
URL azioni Xsi
-
Xsi-Events URL
-
URL interfaccia CTI
-
URL servizio di autenticazione
-
Credenziali dell'adattatore provisioning BroadWorks
provider di servizi provisioning utente
Questa tabella elenca i dati utente ed aziendale s scambiati come parte del provisioning degli utenti attraverso le API Webex.
Trasferimento dati a Webex |
Da |
Attraverso |
Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito da SP) |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito dall'utente) |
Utente |
Portale di attivazione utente |
Sì |
Nome |
BroadWorks, per API |
API Webex |
Sì |
Cognome |
BroadWorks, per API |
API Webex |
Sì |
Numero di telefono principale |
BroadWorks, per API |
API Webex |
Sì |
Numero telefono cellulare |
BroadWorks, per API |
API Webex |
Sì |
Estensione principale |
BroadWorks, per API |
API Webex |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
BroadWorks, per API |
API Webex |
Sì |
Lingua |
BroadWorks, per API |
API Webex |
Sì |
Fuso orario |
BroadWorks, per API |
API Webex |
Sì |
Rimozione utente
Webex per api Cisco BroadWorks supporta la rimozione parziale e completa degli utenti. Questa tabella elenca tutti i dati utente archiviati durante il provisioning e ciò che viene eliminato in ciascuno scenario.
Dati utente |
Eliminazione parziale |
Eliminazione completa |
---|---|---|
ID utente BroadWorks |
Sì |
Sì |
|
No |
Sì |
Nome |
No |
Sì |
Cognome |
No |
Sì |
Numero di telefono principale |
Sì |
Sì |
Numero telefono cellulare |
Sì |
Sì |
Estensione |
Sì |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
Sì |
Sì |
LANGUAGE |
No |
Sì |
Recupero accesso utente e configurazione
Autenticazione Webex
L' autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da parte di uno qualsiasi dei meccanismi di autenticazione di supporto Webex. (L' autenticazione BroadWorks è trattata separatamente.) Questa tabella mostra il tipo di dati scambiati tra i diversi componenti sul flusso di autenticazione.
Spostamento dei dati |
Da |
A |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (indipendente) |
Webex |
Browser utente |
Credenziali utente |
Browser utente |
Provider di identità (che dispone già di identità utente) |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Autenticazione BroadWorks
Per autenticazione BroadWorks si intende l'accesso dell'utente a un'app Webex utilizzando le relative credenziali BroadWorks. Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti del flusso di autenticazione.
Spostamento dei dati |
Da |
A |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (proxy IdP Webex Bwks) |
Webex |
Browser utente |
Informazioni sul branding e URL BroadWorks |
Webex |
Browser utente |
Credenziali utente BroadWorks |
Utente attraverso il browser (pagina di accesso con branded servita da Webex) |
Webex |
Credenziali utente BroadWorks |
Webex |
BroadWorks |
File BroadWorks profilo utente |
BroadWorks |
Webex |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento del messaggio di avviso ed errore di accesso:
- Attualmente, gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e eseguono l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso perché la password è già scaduta. Con questa funzione, se la password sta per scadere entro 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere con l'indicazione del numero di giorni rimanenti e viene consigliato di contattare il Partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione 'enforcePasswordChangeOnExpiry' in BroadWorks è impostata su true, l'errore "nome utente e password errati" è stato lanciato, ma ora con questa funzione il messaggio di errore è stato migliorato: Tentativo di accesso non riuscito. La combinazione dell'ID utente e della password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice di errore 100006
Controlla flusso di accesso:
- Il partner può limitare l'accesso abilitando l'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione di BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, viene visualizzato un errore dicendo che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso è configurabile dal partner come parte del branding personalizzato: Personalizzazione avanzata. I partner devono configurare il collegamento per reindirizzare gli utenti al portale del partner per la gestione e la reimpostazione delle password.
Questa funzione migliora solo l'esperienza di accesso utente durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se la password scade mentre l'utente è connesso all'app Webex. L'utente riceverà una notifica relativa alla scadenza della password al successivo tentativo di accesso.
Recupero configurazione client
Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti nel recupero delle configurazioni del client.
Spostamento dei dati |
Da |
A |
---|---|---|
Iscrizione |
Client |
Webex |
Impostazioni dell'organizzazione, inclusi gli URL BroadWorks |
Webex |
Client |
Token BroadWorks JWORKS |
BroadWorks attraverso Webex |
Client |
Token BroadWorks JWORKS |
Client |
BroadWorks |
Token dispositivo |
BroadWorks |
Client |
Token dispositivo |
Client |
BroadWorks |
File di configurazione |
BroadWorks |
Client |
Utilizzo stato originale
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione in seguito alla scadenza del token attraverso BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Spostamento dei dati |
Da |
A |
---|---|---|
Segnalazione SIP |
Client |
BroadWorks |
Contenuto multimediale SRTP |
Client |
BroadWorks |
Segnalazione SIP |
BroadWorks |
Client |
Contenuto multimediale SRTP |
BroadWorks |
Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Spostamento dei dati |
Da |
A |
---|---|---|
Messaggistica e presenza HTTPS REST |
Client |
Webex |
Messaggistica e presenza HTTPS REST |
Webex |
Client |
Segnalazione SIP |
Client |
Webex |
Contenuto multimediale SRTP |
Client |
Webex |
Segnalazione SIP |
Webex |
Client |
Contenuto multimediale SRTP |
Webex |
Client |
Uso dell'API di provisioning
Accesso sviluppatore
La specifica API è disponibile su https://developer.webex.com e una guida all'uso è su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l'accesso per leggere la specifica API su https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Autenticazione e autorizzazione dell'applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (come il provisioning del sottoscrittore) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere i token di aggiornamento e di accesso per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
È necessario prima registrare l'integrazione con Webex. Una volta registrata, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di aggiornamento e accesso necessari.
Per ulteriori informazioni sulle integrazioni e su come creare questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli richiesti per l'implementazione delle integrazioni, lo sviluppatore e l'utente che ha autorizzato, e possono essere tenute da persone/team separati nel proprio ambiente.
-
Lo sviluppatore crea l'app e la registra su per generare il ClientID/Secret OAuth richiesto con gli ambito previsti per https://developer.webex.com l'applicazione. Se l'applicazione è stata creata da terze parti, potrebbe registrare l'applicazione (se è stato richiesto l'accesso) o è possibile farlo con il proprio accesso.
-
L'utente autorizzato è l'account che l'applicazione utilizza per autorizzare le chiamate API, per modificare l'organizzazione partner, le organizzazioni dei clienti o i relativi abbonati. Questo account deve avere il ruolo di amministratore completo o amministratore completo di vendite nell'organizzazione partner. Questo account non deve essere mantenuto da terze parti.
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning in uso:
-
Modalità Enterprise: il nome organizzazione è una corrispondenza esatta di spEnterpriseId.
-
Modalità provider di servizi: il nome organizzazione è la parte ID gruppo di spEnterpriseId.
Il nome dell'organizzazione contiene spazi vuoti, caratteri maiuscoli e speciali specificati nel spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "patch current" con le ultime patch BroadWorks e le app RI (Release Independent). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Accertarsi di esaminare le note di patch per queste patch software. Alcune patch potrebbero richiedere ulteriori requisiti CLI.
Versione R22
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione | ||
Obbligatorio per sincronizzazione rubriche | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Patch richiesta per il server applicazioni | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Patch richiesta per funzione di registrazione chiamata | ||
Patch richiesta per provisioning flow-through | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Server dei profili | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Piattaforma | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il servizio di autorizzazione con convalida del token CI | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
XSP|ADP |
Richiesto per il proxy di autenticazione NPS | |
Richiesto per il servizio di autorizzazione con convalida del token CI | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il servizio di autorizzazione con convalida del token CI | ||
Obbligatorio per Cronologia chiamate Unified | ||
Altro |
AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione |
Obbligatorio per sincronizzazione rubriche | |
Server app di configurazione | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Obbligatorio per la registrazione della chiamata | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Server dei profili | ||
Piattaforma | ||
Richiesto per il proxy di autenticazione NPS | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
XSP|ADP | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il proxy di autenticazione NPS | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Altro |
Se si utilizza ADP... |
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata |
Versione R24
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione |
Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per provisioning a flusso costante | ||
Obbligatorio per la registrazione della chiamata | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Altro |
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che devi configurare per Webex, fai riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utenti e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. Attivazione include la convalida e-mail e l'assegnazione del servizio in Webex.
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se si dispone di indirizzi e-mail attendibili per gli utenti, è possibile scegliere di attivarli automaticamente quando vengono predisposti automaticamente. Questo processo è di "provisioning automatico e attivazione automatica".
Provisioning utenti automatizzato e attivazione automatica (flusso e-mail attendibile)
Prerequisiti
-
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
-
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
-
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase |
Descrizione |
---|---|
1 |
Si preventiva ed si eserviranno gli ordini per il servizio con i clienti. |
2 |
L'ordine del cliente viene processato ed è stato predisposto il cliente nel sistema. |
3 |
Il sistema di provisioning del servizio attiva il provisioning di BroadWorks. Questa operazione, in riepilogo, crea l'azienda e gli utenti. Quindi, assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM esterno. |
4 |
Questa operazione di provisioning attiva il provisioning automatico dell'organizzazione e degli utenti del cliente in Webex. (L'assegnazione del servizio IM&P causa la chiamata dell'adattatore di provisioning all'API di provisioning Webex). |
5 |
I sistemi devono utilizzare l'API di provisioning Webex se in seguito occorre regolare il pacchetto per l'utente (per effettuare una modifica rispetto al valore predefinito). |
SSO di accesso
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, consentendo l'autenticazione diretta a BroadWorks. L'immagine visualizza gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresentano ciò che il client fornisce per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizi BroadWorks che segue immediatamente dal flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione diretta BroadWorks abilitata (condivisione risorse multi-origine). Di seguito sono riportati alcuni flussi di SSO SAML alternativi:
-
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
-
L'unica differenza è nel punto 5 e 6 del flusso di accesso Webex. Nel punto 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
-
Il flusso procede attraverso le operazioni restanti nei due diagrammi.
-
Il SSO di registrazione non è utilizzato in questo flusso.
-
-
Autenticazione Webex SSO SAML:
-
Al punto 3 del flusso di accesso Webex, il servizio Common Identity servizi restituisce il provider di identità utilizzato dall'autenticazione Webex.
-
A questo punto, viene richiamato un flusso di SSO SAML alternativo per Webex.
-
Interazioni utente
Accedi
-
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
-
CI rileva che l'organizzazione cliente associata ha il proxy IDP BroadWorks configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso. Il provider di servizi può personalizzare questa pagina di accesso.
-
L'utente inserisce le proprie credenziali BroadWorks.
-
Broadworks autentica l'utente attraverso l'IDP. In caso positivo, IDP reindirizza il browser a CI con un SISTEMA SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
-
In caso di autenticazione eseguita correttamente, l'app Webex ottiene i token di accesso da CI (non mostrato nel diagramma). Il client le utilizza per richiedere un token JNTASSI (Jason Web Token) BroadWorks.
-
L'app Webex rileva la configurazione di chiamata da BroadWorks e da altri servizi di Webex.
-
L'app Webex si registra con BroadWorks.
Accesso dal punto di vista dell'utente
Questo diagramma è il flusso di accesso tipico, visualizzato dall'utente finale o dall'abbonato:
-
L'app Webex viene scaricata e installata.
-
È possibile che sia stato ricevuto il collegamento dal proprio provider di servizi oppure il download potrebbe essere trovato sulla pagina di download di Webex.
-
L'indirizzo e-mail viene inserito nella schermata di accesso di Webex. Fare clic su Avanti.
-
Solitamente, si viene reindirizzati a una provider di servizi a cui viene visualizzata una pagina con marchio.
-
Questa pagina potrebbe dare il benvenuto mediante il proprio indirizzo e-mail.
Se non si dispone di un indirizzo e-mail o se l'indirizzo e-mail è errato, inserire l'indirizzo nome utente BroadWorks.
-
Inserire la password BroadWorks.
-
Se è stato eseguito correttamente l'accesso, Webex si apre.
flusso chiamata: rubrica aziendale
flusso chiamata—PSTN cliente
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni client
Recupera profilo da REGISTRAZIONE DMS e SIP con AS
-
Il client chiama XSI per ottenere un token di gestione dispositivi e l'URL sul DMS.
-
Il client richiede il profilo del dispositivo dal DMS presentando il token dal punto 1.
-
Il client legge il profilo del dispositivo e recupera le credenziali SIP, gli indirizzi e le porte.
-
Il client invia un SIP REGISTER al controller SBC utilizzando le informazioni del punto 3.
-
SBC invia il SIP REGISTER ad AS (il controller SBC può eseguire una ricerca in NS per individuare un AS se SBC non conosce già l'utente SIP).
Linee guida di test e laboratorio
Le seguenti linee guida si applicano a organizzazioni di test e laboratorio:
-
provider di servizi partner sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
-
La fatturazione verrà addebitata a qualsiasi utente oltre i primi 50 utenti di prova.
-
Per assicurare un'elaborazione precisa della fattura, tutte le organizzazioni di test devono includere 'test' nel nome dell'organizzazione BroadWorks.
-
Le organizzazioni di test interne devono essere designate all'interno Webex Control Hub. Al fine di evitare che gli utenti di prova vengano fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di test:
-
Accedere all'hub partner e selezionare Clienti.
-
Selezionare il cliente appropriato.
-
Nella barra di controllo a destra, abilitare l'interruttore Organizzazione test interna.
Riproduzione segreteria telefonica
Per la segreteria telefonica, accertarsi di configurare il server multimediale per l'uso di uno dei seguenti codici:
-
mp3
-
wav— I file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android)
Se si utilizzano file wav, eseguire i seguenti comandi CLI per verificare il server dell'applicazione e server multimediale:
-
AS_CLI/Service/VoiceMsg>imposta vmRecordingAudioFileFormat WAV
-
MS_CLI/Applications/MediaStreaming/Services/IVR> imposta sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACL
- Elenco di controllo accessi
- ALG
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APNS
- Utenti Apple servizio di notifica push
- AS
- Server applicazione
- ATA
- Adattatore telefono analogico, adattatore per la conversione della telefonia analogica VoIP
- BAM
- Gestione applicazioni BroadSoft
- Autenticazione di base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- BMS
- Server di messaggistica BroadSoft
- BOSH
- Flussi bidirezionale su HTTP sincrono
- BRI
- L'interfaccia BRI (Basic Rate Interface) è un metodo di accesso ISDN
- Bundle
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico di telefonia (cf. partner, provider di servizi, rivenditore aggiunto valore)
- CAPTCHA
- Test del turing pubblico completamente automatizzato per incisire sui computer e sull'humans apart
- CODICE CCXML
- Controllo chiamata EXtensible Markup Language
- CIF
- Formato intermedio comune
- CLI
- Interfaccia della riga di comando
- CN
- Nome comune
- CSP
- Server push notifiche chiamate. Un server push notifiche eseguito su un ADP XSP| nell'ambiente, per eseguire il push delle notifiche di chiamata a FCM e APNS. Vedere Proxy NPS.
- CPE
- Apparecchiatura locale del cliente
- CPR
- Regola di presenza personalizzata
- CSS
- Foglio di stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione di telefonia su computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- Non disturbare
- Non disturbare
- DNS
- Sistema di nomi di dominio
- DPG
- Chiama gruppo peer
- DSCP
- Punto codici servizi differenziati
- DTAF
- File di archivio del tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza dual-tone
- Utente finale
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. per l'abbonato)
- Aziendale
- Un gruppo di utenti finali (cf. organizzazione)
- FCM
- Messaggistica cloud Firebase
- FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creazione di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning flow-through completo
- Creazione e verifica di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks e l'asserzione che ciascun utente BroadWorks ha un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. Il plug-on del telefono o del fax o i plug-in sul sistema telefonico analogico. Fornisce un'indicazione di hook/off-hook (chiusura loop). Poiché la porta BLUETOOTH è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo BLUETOOTH".
- FXS
- Foreign Exchange Subscriber è la porta che consegna effettivamente la linea analogica al sottoscrittore. In altre parole, è il plug-in alla parete che offre un segnale di chiamata, una corrente a batteria e una suoneria.
- GCM
- Messaggio Google Cloud
- GCM
- Modalità Galois/Counter Mode (tecnologia di crittografia)
- NASCOSTO
- Dispositivo interfaccia utente
- HTTPS
- Protocollo di trasferimento ipertestuale socket sicuri
- IAD
- Dispositivo di accesso integrato
- IM&P
- Messaggistica immediata e presenza
- IP PSTN
- Un provider di servizi che fornisce VoIP servizi PSTN, intercambiabili con ITSP, o un termine generale per la telefonia 'pubblica' collegata da Internet, collettivamente fornito dai principali fornitori di telecomunicazioni (anziché tramite paesi, come PSTN è)
- ITSP
- Servizi di telefonia Internet provider di servizi
- IVR
- Risposta vocale interattiva/Risponditore
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificativo Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notifica oggetto Java Script
- JSSE
- Estensione socket sicura Java; la tecnologia sottostante che fornisce funzioni di connettività sicura ai server BroadWorks
- KEM
- Modulo di estensione chiave (telefoni Cisco hardware)
- LLT
- Token lungo(o long life); una forma di auto-descrizione, sicura di token di connessione che consente agli utenti di rimanere autenticati per più tempo e non è legata a applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIB
- Base informazioni di gestione
- MS
- Server multimediale
- Mtls
- Autenticazione reciproca tra due parti, mediante lo scambio di certificati, quando si stabilisce una connessione TLS
- MUC
- Chat multi-utente
- NAZ
- Traduzioni indirizzi di rete
- NPS
- Server push di notifica; vedere CNPS
- NPS Proxy
-
Servizio in Webex che fornisce token di autorizzazione breve al CNPS, abilitando il push delle notifiche di chiamata su FCM e APNs e, infine, sui dispositivi Android e iOS che eseguono Webex.
- OCI
- Apri interfaccia client
- Organizzazione
- Una società o un'organizzazione che rappresenta un gruppo di utenti finali (cf. Enterprise)
- OTG
- Gruppo trunk in uscita
- Pacchetto
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. Bundle)
- Partner
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. Valore aggiunto rivenditore, provider di servizi, vettore)
- PBX
- Exchange su succursale privato
- PEM
- Messaggio e-mail avanzato sulla privacy
- PLMN
- Rete mobile su rete pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia di telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- PS
- Server dei profili
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Un sito Web che consente all'amministratore del rivenditore di configurare la propria soluzione UC-One SaaS. Talvolta è noto come portale BANG, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Controllo bordo sessione
- SCA
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; Un'organizzazione che fornisce servizi telefonici o correlati ad altre organizzazioni (cf. Gestore telefonico, partner, rivenditore aggiunto valore)
- SIP
- SIP (Session Initiation Protocol)
- SLT
- Token breve (o breve durata) (denominato anche token SSO BroadWorks); un token autenticato a uso singolo utilizzato per ottenere l'accesso protetto alle applicazioni Web.
- SMB
- Piccola e media azienda
- SNMP
- Semplice protocollo di gestione della rete
- sRTCP
- protocollo Secure Realtime Transfer Control Protocol (VoIP multimediale per chiamate in tempo reale)
- sRTP
- protocollo Secure Realtime Transfer Protocol (VoIP multimediale di chiamata)
- SSL
- Livello socket sicuri
- Abbonato
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. Utente finale)
- TCP
- Protocollo di controllo trasmissione
- TDM
- Multiplexing divisione temporale
- TLS
- Sicurezza livello di trasporto
- Tos
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Unified Communications
- UI
- Interfaccia utente
- UID
- Identificativo univoco
- UMS
- Server di messaggistica
- URI
- Uniform Resource Identifier
- URL
- Localizzatore risorse uniforme
- USS
- Server di condivisione
- UTC
- Coordinated Universal Time
- UV
- Video Server
- Rivenditore aggiunto valore (VAR)
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. vettore, partner, provider di servizi)
- VGA
- Array di elementi grafici video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Voice Extensible Markup Language
- Webdav
- Creazione e versione per Web distributed authoring
- WebRTC
- Comunicazioni in tempo reale Web
- WRS
- WebRTC Server
- XMPP
- Protocollo di messaggistica e presenza Estendi
Appendice
Configurazione dei servizi (con mTLS per il servizio di autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida di token CI. Queste procedure sono obbligatorie se si utilizzano più organizzazioni Webex sullo stesso server ADP XSP|. Altrimenti, sono opzionali.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi connettori Cisco BroadWorks.
È necessario distribuire solo un'istanza delle applicazioni Xsi-Events sull'ADP XSP| utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso callControlApplicationName definito in Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> ottenere
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente è inserito in Webex, Webex crea un abbonamento per l'utente sul AS per ricevere gli eventi di telefonia per la cronologia della presenza e delle chiamate. L'abbonamento è associato a callControlApplicationName e il AS lo utilizza per sapere a quali Xsi-Events inviare gli eventi di telefonia.
La modifica del callControlApplicationName o il mancato nome di tutte le app Web Xsi-Events avranno impatto sugli abbonamenti e sulla funzionalità degli eventi di telefonia.
Configurazione del servizio di autenticazione (con mTLS)
I token di lunga durata BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sulle ADP XSP|.
Requisiti
-
I server ADP XSP| che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
-
Gli ADP XSP| devono condividere le stesse chiavi per la crittografia/decrittografia dei token BroadWorks di lunga durata. Copiare queste chiavi a ciascun ADP XSP| è un processo manuale.
-
Gli ADP XSP| devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli ADP XSP| include:
-
Distribuire il servizio di autenticazione.
-
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
-
Genera e condividi chiavi RSA tra ADP XSP|.
-
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ciascun ADP XSP| utilizzato con Webex:
-
Attivare l'applicazione del servizio di autenticazione sul
percorso /authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> attiva servizio di autenticazione applicazione /authService
(dove
è la versione di BroadWorks).
-
Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
distribuisci applicazione /authService
Configurazione della durata del token
-
Controllare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
-
Impostare la durata su 60 giorni (il massimo è 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
imposta tokenDurationInHours 1440
Genera e condividi chiavi RSA
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittografia di token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori, è necessario generare chiavi su un ADP XSP|e copiarle in tutti gli altri ADP XSP|.
Se si alterano i tasti o si modifica la lunghezza della chiave, è necessario ripetere la configurazione seguente e riavviare tutte le ADP XSP|.
-
Selezionare un ADP XSP| da utilizzare per la generazione di una coppia di chiavi.
-
Utilizzare un client per richiedere un token crittografato all'ADP XSP|, richiedendo il seguente URL dal browser del client:
|https:///authService/token?key=BASE64URL(clientPublicKey)
(viene generata una coppia di chiavi privata/pubblica su ADP XSP|, se non ne era già presente una)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
-
Copiare il file esportato
/var/broadworks/tmp/authService.keys
nella stessa posizione sugli altri ADP XSP|, sovrascrivendo un file.keys
precedente, se necessario. -
Importa le chiavi su ciascuno degli altri ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al container Web
Il container Web di ADP XSP| richiede l'URL authService in modo da poter convalidare i token.
Su ciascuno degli ADP XSP|:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per lo strumento di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
imposta URL http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> aggiungi tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Controllare il parametro con
get
. -
Riavviare ADP XSP|.
Configurazione di TLS e della crittografia sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurazione TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > trasporto > http > interfaccia Server HTTP = Più specifico
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il
comando get e leggere i
risultati. Dovrebbero essere presenti le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Tomcat obbligatorio un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> ottenere
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
È necessario configurare l'interfaccia HTTP che interagisce con Webex Cloud per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Inserire il comando
get 443
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserisci il comando
aggiungi 443 TLSv1.2
per assicurarti che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia del server HTTP
Per configurare i crittografia richiesti:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Inserire il comando
get 443
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements (Requisiti di sicurezza e identità XSP) nella sezione Overview). -
Inserire il comando
add 443
per aggiungere una crittografia all'interfaccia del server HTTP.IL CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
del server HTTP, utilizzare:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>aggiungi 192.0.2.7 443 TLS_ECDHE_ECDSA_CON_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità del servizio di autenticazione (con mTLS)
-
Accedere a Control Hub con l'account dell'amministratore del partner.
-
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain .txt
sul computer locale.Questi file contengono due set di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori. -
Suddividere la catena di certificati in due certificati:
combinedcertchain .txt
.-
Aprire
combinedcertchain .txt
in un editor di testo. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e -----END CERTIFICATE----- , e incollare il blocco di testo in un nuovo
file. -
Salvare il nuovo file come
root .txt
. -
Salvare il file originale come
emissione di .txt
. Il file originale ora deve contenere solo un blocco di testo, racchiuso tra lerighe -----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copiare entrambi i file di testo in una posizione temporanea sull'ADP XSP| che si sta proteggendo, ad esempio,
/var/broadworks/tmp/root .txt
e/var/broadworks/tmp/issuing .txt
. -
Accedere a XSP|ADP e passare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Eseguire la guidaUpdateTrust
per visualizzare i parametri e il formato del comando. -
Carica i file dei certificati sui nuovi trust anchor - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot /var/broadworks/tmp/root .txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing /var/broadworks/tmp/issuing .txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot
,webexclientissuing
ewebexclientissuing
sono alias di esempio per i trust anchor; puoi utilizzare i tuoi alias purché tutte e quattro le voci siano univoche. -
Confermare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> ottenere
Alias Proprietario emittente ============================================================================= webexclientissuing Internal Private TLS SubCA Internal Private Root webexclientroot Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate sull'ADP XSP|. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, mTLS è richiesto per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
-
Accedere all'ADP XSP| di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
ed eseguire il comandoget
per visualizzare le interfacce. -
Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che corrisponde a mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> aggiungi nome porta IPAddress true true
Per informazioni dettagliate, vedere la documentazione CLI XSP ADP|CLI. Essenzialmente, la prima true protegge l'interfaccia con TLS (il certificato server viene creato se richiesto) e la seconda forza true l'interfaccia a richiedere l'autenticazione del certificato
client
(insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> ottenere
Nome porta interfaccia Secure Client Auth Req Cluster Fqdn ======================================================= 192.0.2.7 443 XSP|ADP01.collab.example.net true false 192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (Client Auth Req = true) è abilitato sulla porta 192.0.2.7
444.
TLS è abilitato sulla porta 192.0.2.7
443.
(Opzione) Configurare mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate sull'ADP XSP|. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, mTLS è richiesto per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
-
Accedere all'ADP XSP| di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
ed eseguire il comandoget
per visualizzare le applicazioni in esecuzione. -
Per aggiungere un'applicazione e richiedere l'autenticazione del client (che significa lo stesso di mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiungi nome applicazione porta IPAddress true
Per informazioni dettagliate, vedere la documentazione CLI XSP ADP|CLI. I nomi delle applicazioni sono elencati in questo elenco. Vero
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiunge 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService alla versione 192.0.2.7:443 e richiede che a tale applicazione sia richiesta e autenticata dal client.
Controlla con ottieni
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> ottieni
Interfaccia Porta IP Nome applicazione Client Autenticazione ======================================================
192.0.2.7 443 AuthenticationService true
Configura gestione dispositivi su XSP|ADP, server applicazioni e server di profilo
Il server di profilo e l'ADP XSP| sono obbligatori per la gestione dei dispositivi. Tali impostazioni devono essere configurate in base alle istruzioni nella Guida alla configurazione di Gestione dispositivi BroadWorks.
Dove andare avanti
Per la configurazione, è possibile accedere nuovamente al flusso del documento principale all'indirizzo Interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca con AuthService
Webex interagisce con il servizio di autenticazione su (autenticazione) TLS reciproca connessione autenticata. Ciò significa che Webex presenta un certificato client e l'ADP XSP|deve convalidarlo. Per certificare l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora di attendibilità su ADP XSP| (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
-
Andare a Impostazioni > Chiamata BroadWorks.
-
Fare clic sul collegamento per il download del certificato.
È possibile ottenere la catena di certificati anche da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt.
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono dalla distribuzione degli ADP XSP| pubblici:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente all'ADP XSP|
Il diagramma seguente riepiloga i punti in cui la catena di certificati CA Webex deve essere distribuita in questi tre casi.
Requisiti del certificato TLS reciproca per il proxy con bridge TLS
-
Webex presenta un certificato client firmato dall'autorità di certificazione Webex nel proxy.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità del proxy, pertanto il proxy considera attendibile il certificato client.
-
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta un certificato server firmato pubblicamente con Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Il proxy presenta un certificato client firmato internamente agli ADP XSP|.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3:
Uso chiave estesa X509v3:
1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati del server interno per XSP|ADP possono essere SAN.
-
Gli ADP XSP| si affidano alla CA interna.
-
Gli ADP XSP| presentano un certificato server firmato internamente.
-
Il proxy considera attendibile la CA interna.
Requisiti del certificato TLS reciproca per proxy tls passizzato o XSP in DMZ
-
Webex presenta un certificato client firmato ca Webex agli XSP.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità degli XSP, pertanto gli XSP considerano attendibile il certificato client.
-
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
-
Gli XSP presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP.
Cronologia revisioni documenti
La tabella seguente mostra una cronologia delle modifiche di questo documento negli ultimi 12 mesi.
Data |
Versione | Descrizione della modifica | |
---|---|---|---|
3 dicembre 2024 |
2-124 |
| |
4 ottobre 2024 |
2-123 |
| |
10 settembre 2024 |
2-123 |
| |
9 agosto 2024 |
2-122 |
| |
1 agosto 2024 |
2-121 |
| |
25 giugno 2024 |
2-120 |
| |
14 giugno 2024 |
2-119 |
| |
13 maggio 2024 |
2-118 |
| |
10 maggio 2024 |
2-117 |
| |
6 maggio 2024 |
2-116 |
| |
2 maggio 2024 |
2-115 |
| |
10 aprile 2024 |
2-114 |
| |
27 marzo 2024 |
2-113 |
| |
22 marzo 2024 |
2-112 |
| |
7 marzo 2024 |
2-111 |
| |
24 febbraio 2024 |
2-110 |
| |
20 febbraio 2024 |
2-109 |
| |
07 febbraio 2024 |
2-108 |
| |
25 gennaio 2024 |
2-107 |
| |
23 gennaio 2024 |
2-106 |
| |
10 gennaio 2024 |
2-105 |
| |
Panoramica di Webex per Cisco BroadWorks
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione fornisce agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei clienti o forniscono questa soluzione direttamente ai relativi abbonati.
Scopo soluzione
-
Per fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che dispongono già del servizio di chiamata fornito dai provider di servizi BroadWorks.
-
Per fornire il servizio di chiamata basato a BroadWorks a clienti Webex piccoli e medi.
Contesto
In continua continua evoluzione di tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo impegno è spostare le funzionalità di chiamata BroadWorks nell'app Webex e ridurre l'investimento nei client UC-One.
Benefici
-
Prova futura: di fronte all'end-of-life di UC-One Collaborate, movimento di tutti i clienti verso il Unified Client Framework (UCF)
-
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex e conservazione delle chiamate BroadWorks sulla rete di telefonia
Ambito soluzione
-
I clienti esistenti/nuovi e medi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre della chiamata BroadWorks.
-
I clienti Webex esistenti, da piccoli a medi, desiderano aggiungere la chiamata BroadWorks.
-
Non aziende più grandi (ti prego di esaminare il nostro portfolio Enterprise per Webex).
-
Non i singoli utenti (valutare le offerte Webex online).
Le serie di funzioni in Webex per Cisco BroadWorks hanno come obiettivo casi d'uso di piccola e media attività. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità dei sistemi SME e ne valutiamo costantemente l'idoneità per questo segmento. È possibile scegliere di nascondere o rimuovere funzioni altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# |
Requisito |
Note |
---|---|---|
1 |
Patch BroadWorks corrente R22 o superiore | |
2 |
ADP XSP| per XSI, CTI, DMS e authService |
ADP XSP|dedicato per Webex per Cisco BroadWorks |
3 |
ADP XSP|separato per NPS può essere condiviso con altre soluzioni che utilizzano NPS. |
Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni ADP e NPS XSP|. |
4 |
Convalida token CI (con TLS) configurato per connessioni Webex al servizio di autenticazione. | |
5 |
mTLS configurato per le connessioni Webex all'interfaccia CTI. |
Altre applicazioni non richiedono mTLS. |
6 |
Gli utenti devono esistere in BroadWorks e necessitano dei seguenti attributi, in base alla propria decisione di provisioning:
|
Per e-mail affidabili: Si consiglia di inserire lo stesso indirizzo e-mail nell'attributo ID alternativo anche per consentire agli utenti di accedere con indirizzo e-mail per BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'utilizzo di messaggi e-mail non attendibili può inviare il messaggio e-mail alla cartella della posta indesiderata o dello SPAM dell'utente. L'amministratore potrebbe aver modificato le impostazioni e-mail dell'utente per consentire i domini |
7 |
File DTAF Webex per Cisco BroadWorks per l'app Webex | |
8 |
BW Business Lic o Std Enterprise o Prem Enterprise User Lic + Webex per l'abbonamento Cisco BroadWorks |
Se è già presente una distribuzione di collaborazione esistente, non è più necessario il bundle aggiuntivo UC-One, la collaborazione Lic e le porte della conferenza Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non è necessario apportare ulteriori modifiche se non si accettano i termini del pacchetto Premium. |
9 |
L'indirizzo IP/porte deve essere accessibile attraverso i servizi back-end Webex e le app Webex su Internet pubblico. |
Vedere la sezione "Preparazione della rete". |
10 |
Configurazione TLS v1.2 su ADP XSP| | |
11 |
Per il provisioning Flowworks, il server dell'applicazione deve connettersi all'adattatore di provisioning BroadWorks. La configurazione del proxy in uscita non viene testata o supportato. Se si utilizza un proxy in uscita, si accetta la responsabilità di supportarlo con Webex per Cisco BroadWorks. |
Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è comprendere, preparare, distribuire e gestire la soluzione Webex per Cisco BroadWorks. Le sezioni principali del documento riflettono questo scopo.
Questa guida include informazioni concettuali e materiale di riferimento. Intendiamo coprire tutti gli aspetti della soluzione in questo documento.
La serie minima di attività per la distribuzione della soluzione è la seguente:
-
Raggiungere il team dell'account per diventare un partner Cisco. È obbligatorio esplorare i punti di contatto Cisco per acquisire familiarità (ed essere addestrati). Quando si diventa un partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuire Webex per Cisco BroadWorks > onboarding dei partner in questo documento).
-
Configurare i sistemi BroadWorks per l'integrazione con Webex. (Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento).
-
Utilizzare Partner Hub per collegare Webex a BroadWorks. Vedere Distribuire Webex per Cisco BroadWorks > l'organizzazione partner in Partner Hub in questo documento.
-
Utilizzare Partner Hub per preparare i modelli di provisioning utente. (Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento).
-
Esegui test ed esegui l'onboarding di un cliente eseguendo il provisioning di almeno un utente. (Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
-
Operazioni di alto livello, nell'ordine tipico. Esistono diverse attività determinanti che non è possibile ignorare.
-
Se si desidera creare le proprie applicazioni per gestire Webex per abbonati Cisco BroadWorks, leggere Uso dell'API di provisioning nella sezione Di riferimento di questa guida.
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto.
Funzionamento
Webex per Cisco BroadWorks è un'offerta che integra la chiamata BroadWorks in Webex. Gli abbonati utilizzano una singola applicazione (app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
-
Gli utenti chiamano PSTN numeri di telefono utilizzando l'infrastruttura BroadWorks.
-
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino per introdurre i numeri).
-
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Webex Call" nell'app Webex ( queste chiamate sono app Webex all'app Webex, non all'app Webex PSTN).
-
Gli utenti possono ospitare e partecipare Webex Meetings.
-
Gli utenti possono inviare messaggi l'uno all'altro o negli spazi (chat di gruppo persistente) e usufruire delle funzioni di ricerca e condivisione di file (su infrastruttura Webex).
-
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
-
Dopo averci asserto come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare il rapporto tra l'istanza BroadWorks e Webex.
-
È possibile creare organizzazioni dei clienti in Control Hub e pres effettuare il provisioning degli utenti in tali organizzazioni.
-
Ciascun abbonato in BroadWorks ottiene un'identità Webex in base al relativo indirizzo e-mail (attributo ID e-mail in BroadWorks).
-
Gli utenti eseguono l'autenticazione per BroadWorks o per Webex.
-
I client vengono emessi con token a lungo termine per autorizzarli per i servizi presso BroadWorks e Webex.
L'app Webex al centro di questa soluzione; è un'applicazione che può essere brandable disponibile su desktop Mac/Windows e su dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include le funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzioni di messaggistica, presenza e riunione.
Il client si registra ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i sistemi BroadWorks per garantire un'esperienza di provisioning utente ottimale.
Funzioni e limitazioni
Sono disponibili diversi pacchetti con diverse funzioni.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano un utente tramite softphone, i risultati della ricerca non forniscono alcuna opzione per l'invio di un messaggio.
Gli utenti softphone possono condividere lo schermo durante una chiamata.
Pacchetto "Base"
Il pacchetto base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti in riunioni "spazio unificato" e riunioni nella sala riunioni personale. (** vedere la Nota seguente per eccezione). In questo pacchetto, la durata massima delle riunioni è di 40 minuti.
Pacchetto "standard"
Questo pacchetto include anche tutto quello che è previsto dal pacchetto Base, ad esempio fino a 100 partecipanti in riunioni "spazio unificato" e riunioni nella sala riunioni personale.
La condivisione dello schermo all'interno di una riunione PMR ha inizialmente un ruolo svolto solo dall'organizzatore della riunione, ma l'organizzatore può passare il 'ruolo di relatore' a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può assumere nuovamente il ruolo di relatore senza che venga passato dall'ospite corrente.
Pacchetto "Premium"
Questo pacchetto include tutto quello che è previsto dal pacchetto Standard più fino a 300 partecipanti in una riunione "spazio unificato" e fino a 1000 partecipanti in una sala riunioni personale.
La condivisione dello schermo all'PMR di un evento è supportata per qualsiasi partecipante.
Confronta pacchetti
Pacchetto |
Chiamata in corso |
Messaggistica |
Riunioni spazio unificato |
PMR riunioni |
---|---|---|---|---|
Softphone |
Incluso |
Non incluso |
Nessuno |
Nessuno |
Base |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Standard |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Premium |
Incluso |
Incluso |
300 partecipanti |
1000 partecipanti |
Il limite di riunioni nello spazio Unified per gli utenti Base è di 100 partecipanti per riunione nello spazio Unified, a meno che lo spazio non includa anche gli utenti a cui sono stati assegnati i pacchetti "Standard" o "Premium", nel qual caso il limite aumenta in base al pacchetto utente organizzatore.
Per "Riunioni spazio unificate" si intende una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti "Riunione" o "Pianifica".
Per "riunioni PMR" si intende una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID).
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per conoscere le differenze di supporto delle funzioni per le riunioni nella sala riunioni personale per i pacchetti Base, Standard e Premium.
Funzione riunione |
Supportato con pacchetto base |
Soportato con il pacchetto standard |
Supportato con pacchetto Preminum |
Commento |
---|---|---|---|---|
Durata riunione |
40 Minuti o meno |
Illimitato |
Illimitato | |
Condivisione desktop |
Sì |
Sì |
Sì |
Base: condivisione del desktop da parte di qualsiasi partecipante alla riunione della sala riunioni personale. Standard: condivisione del desktop solo da parte dell'organizzatore della riunione nella sala riunioni personale. Premium: condivisione del desktop da parte di qualsiasi partecipante alla riunione della sala riunioni personale. |
Condivisione di un'applicazione |
Sì |
Sì |
Sì |
Base: condivisione delle applicazioni da parte di qualsiasi partecipante alla riunione della sala riunioni personale. Standard: condivisione dell'applicazione solo da parte dell'organizzatore della riunione nella sala riunioni personale. Premium: condivisione delle applicazioni da parte di qualsiasi partecipante alla riunione della sala riunioni personale. |
Chat tra più parti |
Sì |
Sì |
Sì | |
Lavagna |
Sì |
Sì |
Sì | |
Protezione password |
Sì |
Sì |
Sì | |
App Web - nessun download o plug-in (esperienza ospite) |
Sì |
Sì |
Sì | |
Supporta accoppiamento con dispositivi Webex |
Sì |
Sì |
Sì | |
Controllo piano (disattiva audio di uno / Espelle tutti) |
Sì |
Sì |
Sì | |
Collegamento Riunioni permanenti |
Sì |
Sì |
Sì | |
Acces. sito per riunioni |
Sì |
Sì |
Sì | |
Accesso alla riunione tramite VoIP |
Sì |
Sì |
Sì | |
Blocco |
Sì |
Sì |
Sì | |
Controlli relatore |
No |
No |
Sì | |
Controllo desktop remoto |
No |
No |
Sì | |
Numero di partecipanti |
100 |
100 |
1000 | |
Registrazione salvata in locale nel sistema |
Sì |
Sì |
Sì | |
Registrazione nel cloud |
No |
No |
Sì | |
Registrazione - Storage su cloud |
No |
No |
10 GB per sito | |
Trascrizione delle registrazioni |
No |
No |
Sì | |
Pianificazione riunione |
Sì |
Sì |
Sì | |
Abilita condivisione del contenuto con integrazioni esterne |
No |
No |
Sì |
Base: condivisione di contenuto da parte di qualsiasi partecipante alla riunione della sala riunioni personale. Standard: condivisione del contenuto solo da parte dell'organizzatore della riunione nella sala riunioni personale. Premium: condivisione di contenuto da parte di qualsiasi partecipante alla riunione della sala riunioni personale. |
Consenti PMR modifica dell'URL |
No |
No |
Sì |
Base: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori dei partner e delle organizzazioni possono modificare l'URL da Control Hub. Standard: l'URL PMR può essere modificato solo da Partner Hub dagli amministratori dei partner e dell'organizzazione. Premium: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori di partner e organizzazioni possono modificare l'URL da Partner Hub. |
Riunioni in streaming in diretta (ad esempio, su Facebook, Youtube) |
No |
No |
Sì | |
Consentire ad altri utenti di pianificare le riunioni per proprio conto |
No |
No |
Sì | |
Aggiungi organizzatore alternativo |
Sì |
No |
Sì | |
Integrazione delle app (es. Zendesk, Slack) |
Dipende dall'integrazione |
Dipende dall'integrazione |
Sì |
Vedere la sezione Integrazioni delle app di seguito per ulteriori informazioni sul supporto. |
Integrazione con il calendario Microsoft Office 365 |
Sì |
Sì |
Sì | |
Integrazione con Google Calendaring per G Suite |
Sì |
Sì |
Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione per l'utente per Webex all'help.webex.com
. Leggere i seguenti articoli per ulteriori informazioni sulle funzioni:
Funzioni di chiamata
L'esperienza di chiamata è simile a quelle precedenti che utilizzano il motore di controllo chiamate BroadWorks. La differenza rispetto a UC-One Collaborate e UC-One SaaS è che l'app Webex è il soft client principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
-
Zendesk: solo Premium
-
Slack: solo Premium
-
Microsoft Teams per Webex Meetings: standard o premium
-
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
-
Calendario Office 365: standard o premium
-
Google Calendaring per G Suite: standard o premium
Supporto infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione di Webex per l'infrastruttura desktop virtuale (VDI).
Supporto IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Pro Pack per Control Hub
Il servizio aggiuntivo Pro Pack per Control Hub fornisce agli amministratori, alle informazioni di sicurezza e ai funzionari di conformità funzionalità avanzate in sicurezza, conformità e analisi in grado di integrare il software.
Questi servizi aggiuntivi saranno disponibili solo per i pacchetti Standard e Premium.
Per ulteriori informazioni, vedi la Pagina della Guida di Pro Pack per Control Hub.
Roadmap futuro
Per informazioni sulle nostre intenzione per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Gli elementi della roadmap non sono associabili ad alcuna capacità. Cisco si riserva il diritto di disattivare o revisionare uno o tutti di questi elementi nelle release future.
Limiti
Limitazioni provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario per il Webex Meetings sito creato per tale pacchetto.
Se non viene specificato alcun fuso orario nella richiesta di provisioning per il primo utente di ciascun pacchetto, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sul valore predefinito regionale dell'organizzazione degli abbonati.
Se il cliente richiede un fuso orario Webex Meetings sito specifico, specificare il parametro di fuso orario nella richiesta di provisioning
per:
-
il primo abbonato predisposto per il pacchetto standard nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto Base nell'organizzazione.
Limitazioni generali
-
Nessuna chiamata nella versione Web del client Webex (si tratta di una limitazione del client, non di una limitazione di soluzione).
-
Webex potrebbe non disporre ancora di tutti i controlli UI per supportare alcune funzioni di controllo chiamate disponibili da BroadWorks.
-
Il client Webex non può essere attualmente con etichetta "White labeled".
-
Quando si creano organizzazioni cliente utilizzando il metodo di provisioning scelto, tali organizzazioni vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. È previsto che partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
-
La generazione di report sulle riunioni e sull'utilizzo dei messaggi è disponibile attraverso l'organizzazione cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti messaggistica
I seguenti limiti di storage dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo spazio di storage massimo per la messaggistica e i file combinati.
-
Base: 2 GB per utente per 3 anni
-
5 GB standard per utente per 3 anni
-
Premium: 10 GB per utente per 5 anni
Per ciascuna organizzazione di clienti, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti Premium può utilizzare un limite di messaggistica e storage file totale di 50 GB. Un singolo utente può superare il limite per utente (10 GB) a condizione che la società sia ancora sotto il valore massimo aggregato (50 GB).
Per gli spazi del team creati, i limiti di messaggistica si applicano al totale aggregato per l'organizzazione del cliente che possiede lo spazio del team. È possibile trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti di messaggistica generali che si applicano agli spazi del team di messaggistica Webex, vedere https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure connessioni a Webex e BroadWorks. I dati archiviati nel cloud Webex e esposti all'utente attraverso l'interfaccia dell'app Webex vengono crittografati sia in viaggio che a riposo.
Ulteriori dettagli sullo scambio dei dati sono disponibili nella sezione Riferimento di questo documento.
Lettura aggiuntiva
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati più vicino alla regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore provider di servizi (utente): Per le attività di manutenzione giornaliere, è possibile gestire le parti in locale (di chiamata) della soluzione utilizzando i propri sistemi. Le parti Webex della soluzione vengono gestite attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e Wholesale RTM.
Il primo utente predisposto a un nuovo organizzazione partner viene assegnato automaticamente ai ruoli Amministratore completo e Amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi.
Team operativo Cisco Cloud: Crea l'organizzazione partner in Partner Hub, se non esiste, durante il processo di onboarding.
Una volta che si dispone dell'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente si creano "Modelli di onboarding" per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Si eservi quindi il provisioning dei propri clienti o abbonati.
# |
Attività tipica |
SP |
Cisco |
---|---|---|---|
1 |
Onboarding del partner: creazione dell'organizzazione partner, se presente, e abilitazione delle attivazioni/disattivazioni delle funzioni necessarie |
● | |
2 |
Configurazione BroadWorks nell'organizzazione partner tramite Hub partner (cluster) |
● | |
3 |
Configurazione delle impostazioni di integrazione nell'organizzazione partner tramite Partner Hub (modelli di offerta, branding) |
● | |
4 |
Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|Patch ADP, firewall, configurazione ADP XSP|, XSI, AuthService, CTI, NPS, applicazioni DMS su XSP|ADP) |
● | |
5 |
Sviluppo di un'integrazione o di un processo di provisioning |
● | |
6 |
Prepara materiali GTM |
● | |
7 |
Esegui migrazione o provisioning di nuovi utenti |
● |
Architettura
Che cos'è nel diagramma?
Client
-
Il client Webex App svolge la funzione di applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di riunioni audio/video native di messaggistica, presenza e multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per chiamate SIP PSTN chiamate.
-
I telefoni Cisco IP e relativi accessori utilizzano anche l'infrastruttura BroadWorks per SIP e chiamate PSTN telefoniche. Ci vediamo in grado di supportare telefoni di terze parti.
-
Portale di attivazione utente per consentire agli utenti di accedere a Webex utilizzando le credenziali BroadWorks.
-
Partner Hub è un'interfaccia Web per l'amministrazione della propria organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. È anche possibile utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
provider di servizi di rete
Il blocco verde a sinistra del diagramma rappresenta la rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
-
ADP XSP|rivolto al pubblico, per Webex per Cisco BroadWorks: (La casella rappresenta uno o più farm XSP|ADP, possibilmente frontali da bilanciatori del carico).
-
Ospita l'interfaccia XSI-Actions &XSI-Events, Device Servizio di gestione (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato di hook degli altri (presenza di telefonia) e cronologia chiamate.
-
Pubblica la directory sui client Webex.
-
-
ADP XSP|rivolto al pubblico, con NPS:
-
Server push notifiche chiamate host: Un server push di notifica su un ADP XSP| nel tuo ambiente. Interfaccia tra il server applicazioni e il nostro proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS &FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
-
-
Server applicazione:
-
Fornisce il controllo e le interfacce delle chiamate ad altri sistemi BroadWorks (in genere)
-
Per il provisioning flowre, l'AS viene utilizzato dall'amministratore del partner per eseguire il provisioning degli utenti in Webex
-
Inserisce profilo utente in BroadWorks
-
-
SISTEMA SISTEMA AVAIO/BSS: Sistema di supporto operativo/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nel diagramma rappresenta il cloud Webex. I microservizi Webex supportano tutte le funzionalità di collaborazione Webex:
-
Cisco Common Identity (CI) è il servizio di identità all'interno di Webex.
-
Webex per Cisco BroadWorks rappresenta l'insieme di microservizi che supportano l'integrazione tra Webex e provider di servizi BroadWorks ospitate:
-
API di provisioning utenti
-
provider di servizi configurazione
-
Accesso utente tramite credenziali BroadWorks
-
-
casella Messaggistica Webex per microservizi correlati alla messaggistica.
-
Webex Meetings che rappresenta i server di elaborazione multimediale e i controller SBC per le riunioni video con più partecipanti (SIP & SRTP)
Servizi Web di terze parti
I seguenti componenti di terze parti vengono rappresentati nel diagramma:
-
APNS (Apple Push Notifications Service) inserisce le notifiche di chiamate e messaggi nelle applicazioni Webex sui dispositivi Apple.
-
FCM (FireBase Cloud Messaging) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Ruolo dei server ADP XSP|rivolti al pubblico in Webex per Cisco BroadWorks
L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
-
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste di BroadWorks J JSON (Token Web JSON) per conto dell'utente
-
Interfaccia CTI protetta da mTLS, a cui Webex esegue l'abbonamento per eventi cronologia chiamate e stato della presenza di telefonia da BroadWorks (stato hook).
-
Interfacce di azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate, le directory di contatto e di elenco delle chiamate e la configurazione del servizio di telefonia dell'utente finale
-
Servizio DM (Device Management) per i client per recuperare i file di configurazione delle chiamate
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedi Configurazione dei cluster BroadWorks in Partner Hub in questo documento) Per ciascun cluster, puoi fornire solo un URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP
Si richiede di utilizzare un'istanza ADP XSP|separata e dedicata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile ospitare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso ADP XSP| che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/farm XSP|ADP dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
-
Ad esempio, se stai offrendo UC-One SaaS, ti consigliamo di creare un nuovo farm ADP XSP|per Webex per Cisco BroadWorks. In questo modo i due servizi possono funzionare in modo indipendente durante la migrazione degli abbonati.
-
Se si posizionano le applicazioni Webex per Cisco BroadWorks su un farm XSP|ADP utilizzato per altri scopi, è responsabilità del cliente monitorare l'uso, gestire la complessità risultante e pianificare l'aumento di scala.
-
Il Strumento di pianificazione della capacità del sistema Cisco BroadWorks utilizza un farm ADP XSP| dedicato e potrebbe non essere accurato se lo si utilizza per calcoli di collocazione.
Se non diversamente specificato, il Webex dedicato per Cisco BroadWorks XSP ADP| deve ospitare le seguenti applicazioni:
-
AuthService (TLS con convalida token CI o mTLS)
-
CTI (mTLS)
-
Azioni XSI (TLS)
-
XSI-Events (TLS)
-
DMS (TLS): facoltativo. Non è obbligatorio distribuire un'istanza DMS o un farm separati specificatamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
-
Impostazioni chiamata Webview (TLS): opzionale. La vista Web impostazioni chiamata (CSW) è richiesta solo se desideri che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso al CTI attraverso un'interfaccia protetta (autenticazione) TLS reciproca autenticazione. Per supportare questo requisito, si consiglia una di queste opzioni:
-
(Diagramma etichettato Opzione 1) Un'istanza o un farm XSP|ADP per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
-
(Diagramma etichettato Opzione 2) Due istanze o farm XSP| ADP, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSP|ADP
Se si dispone di un farm ADP XSP|esistente conforme a una delle architetture suggerite sopra (opzione 1 o 2) e carico leggero, è possibile riutilizzare gli ADP XSP|esistenti. Sarà necessario verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti delle applicazioni per Webex. Le due considerazioni principali sono:
-
Se è necessario supportare più organizzazioni partner Webex su XSP|ADP, ciò significa che è necessario utilizzare mTLS sul servizio di autorizzazione (la convalida del token CI è supportata solo per una singola organizzazione partner su un XSP|ADP). Se si utilizza mTLS sul servizio di autenticazione, ciò significa che non è possibile avere client che stanno utilizzando l'autenticazione di base sul servizio di autenticazione allo stesso tempo. Questa situazione impedirebbe il riutilizzo dell'ADP XSP|.
-
Se il servizio CTI esistente è configurato per essere utilizzato dai client con la porta protetta (in genere 8012) ma senza mTLS (ossia, autenticazione client), tale servizio è in conflitto con il requisito webex di disporre di mTLS.
Poiché gli ADP XSP| hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero verificarsi altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di ADP XSP| deve essere verificato in un laboratorio con la configurazione prevista prima di impegnarsi per il riutilizzo.
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione dell'orario per tutti gli ADP XSP| utilizzati con Webex.
Installare il pacchetto ntp
dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Successivamente, è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, vedere la Guida alla gestione software BroadWorks.
Durante l'installazione interattiva del software ADP XSP|, è possibile configurare NTP. Procedere come segue:
-
Quando viene visualizzato il programma di installazione,
configurare NTP?
, inserire y.
-
Quando il programma di installazione richiede,
questo server deve essere un server NTP? , inserire n
.
-
Quando il programma di installazione richiede, Qual è l'indirizzo NTP, il nome host o nome di dominio completo? , inserire l'indirizzo del server NTP o un servizio
NTP pubblico, ad esempio,
pool.ntp.org
.
Se le ADP XSP| utilizzano l'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie chiave=valore:
NTP
NTP_SERVER=
Requisiti di sicurezza e identità ADP XSP|
Sfondo
I protocolli e i tipi di crittografia delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli variano dal più generale (provider SSL) alla più specifica (singola interfaccia). Un'impostazione più specifica sovrascrive sempre un'impostazione più generale. Se non vengono specificate, le impostazioni SSL di livello 'inferiore' vengono ereditano dai livelli superiori.
Se non viene modificata alcuna impostazione dai valori predefiniti, tutti i livelli ereditano le impostazioni predefinite del provider SSL (estensione JSSE Java Secure Sockets).
Elenco requisiti
-
L'ADP XSP| deve autenticarsi ai client utilizzando un certificato firmato da un'autorità di certificazione in cui il nome comune o il nome alternativo oggetto corrisponde alla parte di dominio dell'interfaccia XSI.
-
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
-
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
-
Diffie-Hellman Ephemeral (DHE) o Curve ellittiche Diffie-Hellman Ephemeral (ECDHE) key-exchange
-
Crittografia AES (Advanced Encryption Standard) con una dimensione di blocco minima di 128 bit (ad esempio, AES-128 o AES-256)
-
Modalità di crittografia GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
-
Se viene utilizzata la crittografia CBC, solo la famiglia di funzioni hash SHA2 è consentita per la derivazione chiave (SHA256, SHA384, SHA512).
-
-
Ad esempio, i seguenti tipi di crittografia soddisfano i requisiti:
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come mostrato sopra, non la convenzione openSSL.
Tipi di crittografia TLS supportati per le interfacce AuthService e XSI
Questo elenco è soggetto a modifica quando i requisiti di sicurezza del cloud cambiano. Seguire i suggerimenti sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento.
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
-
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
-
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_128_GCM_SHA256
-
TLS_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_256_CBC_SHA256
-
TLS_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_WITH_AES_256_CBC_SHA
-
TLS_PSK_WITH_AES_256_CBC_SHA384
-
TLS_PSK_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_WITH_AES_128_CBC_SHA
-
TLS_PSK_WITH_AES_128_CBC_SHA256
-
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il conteggio dei thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi mostrati, come segue (non diminuire, se sono superiori ai valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più ADP XSP|
Elemento Edge di bilanciamento del carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, tale elemento deve gestire in modo trasparente la distribuzione del traffico tra più server ADP XSP|e il cloud e i client Webex per Cisco BroadWorks. In questo caso, si fornisce l'URL del servizio di bilanciamento del carico a Webex per la configurazione Cisco BroadWorks.
Note su questa architettura:
-
Configurare DNS in modo che i client possano trovare il servizio di bilanciamento del carico quando si connettono all'interfaccia Xsi (vedere Configurazione DNS).
-
Si consiglia di configurare l'elemento Edge in modalità proxy SSL inverso per accertarsi che la crittografia dati point-to-point.
-
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio tuo-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri nomi di domini completi, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Server ADP XSP|rivolti a Internet
Se si espongono direttamente le interfacce XSI, utilizzare il DNS per distribuire il traffico a più server ADP XSP|.
Note su questa architettura:
-
Sono necessari due record per la connessione ai server ADP XSP|:
-
Per i microservizi Webex: I record a turni A/AAAA sono richiesti per indirizzare più indirizzi IP ADP XSP|. Questo perché i microservizi Webex non possono eseguire ricerche SRV. Per esempi, vedere Servizi cloud Webex.
-
Per l'app Webex: Un record SRV che si risolve in record A e ciascun record A si risolve in un singolo ADP XSP|. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per indirizzare il servizio XSI per più indirizzi ADP XSP|. Assegnare una priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (E l'indirizzo IP successivo) e passino al record A successivo (e indirizzo IP) solo se il primo indirizzo IP non è attivo. NON utilizzare un approccio a tutto tondo per Webex App.
-
-
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio tuo-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri nomi di domini completi, ad esempio XSP|ADP01.example.com, nel nome comune.
-
È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL ADP XSP|in un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server ADP XSP|XSP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.
Ordinazione e provisioning
Ordinazione e provisioning si applicano a questi livelli:
-
Provisioning partner/provider di servizi:
Ciascun Webex per Cisco BroadWorks provider di servizi (o rivenditore) presente deve essere configurato come organizzazione partner in Webex e disporre dei diritti necessari. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per la gestione di Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le attività di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/Enterprise.
-
Ordini e provisioning cliente/Enterprise:
Ciascuna azienda BroadWorks abilitata per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo viene eseguito automaticamente come parte del provisioning dell'utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks sono predisposti nella stessa organizzazione clienti Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
-
Ordinazione e provisioning di utenti/abbonati:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning utente:
-
Provisioning Flow con e-mail attendibili
-
Provisioning flow senza messaggi e-mail attendibili
-
Self-provisioning utente
-
Provisioning API
-
Provisioning a flusso costante con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile asserre che BroadWorks abbia indirizzi e-mail dell'abbonato validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Provisioning flow senza messaggi e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non si può contare sugli indirizzi e-mail dell'abbonato tenuti da BroadWorks, questa opzione di provisioning crea account Webex, ma non può attivarli fino a quando gli abbonati non forniscono e convalidano gli indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Self-Provisioning utente
Con questa opzione, non esiste provisioning flowworks da BroadWorks a Webex. Dopo aver configurato l'integrazione tra Webex e il sistema BroadWorks, si ottengono uno o più collegamenti specifici per il provisioning degli utenti all'interno di Webex per l'organizzazione partner Cisco BroadWorks.
Si progettare quindi le proprie comunicazioni (o delegare ai clienti) la distribuzione del collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account sono predisposti nell'ambito dell'organizzazione partner, è possibile regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare questa operazione.
Gli utenti devono essere presenti nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento.
provider di servizi provisioning da PARTE delle API
Webex sono esposti una serie di API pubbliche che consentono di creare Webex per il provisioning di utenti/abbonati Cisco BroadWorks nel flusso di lavoro/strumenti di gestione degli utenti esistenti.
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Installare AP.as.22.0.1123.ap376508.
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Installare AP.as.23.0.1075.ap376509
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Installare AP.as.24.0.944.ap375100
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning di nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per utenti Cisco BroadWorks.
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti di Webex di Cisco Broadworks di chiamare altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella directory Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo di estensione di tutte le aree del metodo di inizio chiamata e del profilo utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e diversi gruppi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due aziende che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks tramite i seguenti metodi:
-
Utenti Cisco BroadWorks
-
Provisioning API pubblica come estensione
-
Il parametro dell'interno deve essere passato esplicitamente come parte della chiamata API. Per aziende/gruppi che dispongono di un codice di chiamata posizione (LDC) configurato, il parametro interno deve essere la combinazione di LDC e 'numero di interno.
-
-
Provisioning a flusso costante o autoattivazione
-
L'interno e il sistema LDC (ove applicabile) verranno recuperati automaticamente da BroadWorks.
-
-
-
Utenti o entità Calling solo BroadWorks
-
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione del codice di chiamata posizione (LDC) e del numero di interno.
-
Record chiamata BroadWorks |
Descrizione |
Metodo di provisioning |
Gestione dell'interno |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
API pubblica |
L'interno deve essere passato come parametro |
A flusso costante |
Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks |
Utenti di chiamata non caricati in Webex |
Sinc rubrica |
Interno sincronizzato dalla sincronizzazione rubrica |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sinc rubrica | Interno sincronizzato dalla sincronizzazione rubrica |
Elenchi telefonici BroadWorks |
Elenchi telefonici aziendali, di gruppo o personali |
Sinc rubrica |
Non applicabile |
Prerequisiti
-
La versione del client richiesta per supportare questa funzione è la versione 42.11 o successiva.
-
Patch in cui i codici di chiamata dell'interno e della posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
-
AP.platform.23.0.1075.ap380045
-
AP.as.23.0.1075.ap380045
-
AP.xsp.23.0.1075.ap380045
-
AP.as.24.0.944.ap380045
-
-
Abilita l'intestazione X-BroadWorks-Remote-Party-Info sul AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP, richiesto per il supporto della funzione di chiamata interno.
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata dell'interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità chiamata di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'interno come seconda opzione sia in Partner Hub che in Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con l'interno tramite uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione di estensione sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Questo non visualizza un interno nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere l'opzione di chiamata a interno visibile per i clienti esistenti:
-
Se un partner desidera che a tutte le organizzazioni dei clienti gestiti sia fornito un interno come opzione di chiamata, è consigliabile che l'amministratore del partner sposti l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
-
Se un partner desidera fornire opzioni di chiamata per un'organizzazione cliente specifica, si consiglia all'amministratore partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto di contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e allinearlo all'aumento dei contatti 30K per l'elenco telefonico aziendale, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per organizzazione, applicabile alla somma degli elenchi telefonici aziendali e di gruppo in un'unica azienda BroadWorks. Ad esempio, sarà supportata un'azienda BroadWorks con elenco telefonico Enterprise con 30K e anche 5 elenchi di telefoni di gruppo, ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K in totale).
Questa funzione è disponibile su richiesta. Contatta il team del tuo account per abilitarlo.
-
Prima di abilitare la funzione, è necessario eseguire una migrazione dei prerequisiti per il provisioning e associare i gruppi per tutti gli utenti predisposti esistenti.
-
Il team Cisco eseguirà un'API interna per eseguire la migrazione di eventuali utenti predisposti esistenti e associarli al gruppo corretto. NOTA: Questa operazione può richiedere fino a una settimana.
-
Una volta completata la migrazione per il partner e abilitata la funzione, tutti gli utenti predisposti di recente verranno "raggruppati" in modo appropriato.
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks in storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare il gruppo a cui appartiene questo utente. L'associazione dell'utente a un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca di contatti nello storage di gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning di Webex per gli abbonati BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
L'ID gruppo aziendale BroadWorks può essere fornito per gli utenti Cisco BroadWorks tramite i seguenti metodi:
-
Webex per utenti Cisco BroadWorks
-
Provisioning API pubblica come 'spEnterpriseGroupId'
-
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
-
-
Provisioning a flusso costante o autoattivazione
-
L'ID gruppo aziendale BroadWorks verrà recuperato automaticamente da BroadWorks.
-
-
Utenti o entità Calling solo BroadWorks
-
Non applicabile. Non è necessario sincronizzare l'ID gruppo BroadWorks Enterprise per questi utenti.
-
-
Record chiamata BroadWorks |
Descrizione |
Metodo di provisioning |
Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
API pubblica |
ID gruppo BroadWorks Enterprise Group deve essere passato come parametro spEnterpriseGroupId |
A flusso costante |
ID gruppo aziendale BroadWorks recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks |
Utenti di chiamata non caricati in Webex |
Sinc rubrica |
Non applicabile |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sinc rubrica |
Non applicabile |
Elenchi telefonici BroadWorks |
Contatti negli elenchi telefonici di gruppo BroadWorks |
Sinc rubrica |
I contatti di gruppo vengono memorizzati nel Servizio Webex Contact associato al gruppo specifico |
Elenchi telefonici BroadWorks Enterprise o Persional |
Contatti negli elenchi telefonici aziendali o personali |
Sinc rubrica |
Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. La migrazione non può essere completata finché QUESTA API non viene completata. L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march
Una volta abilitata la funzione e come risultato della successiva sincronizzazione delle rubriche, verranno visualizzati anche i gruppi utenti aziendali in Control Hub. In questa fase, la visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativo. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza ai gruppi in Control Hub poiché tali modifiche non verranno riflesse nuovamente in BroadWorks. La gestione dei gruppi in Control Hub è destinata ai partner che adotteranno le API di gestione dei contatti future.
Migrazione e prova futura
Cisco il client BroadSoft unified Communications deve passare da UC-One a Webex. Esiste una corrispondente lingua dei servizi di supporto lontani dalla rete provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che si utilizzi UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita è distribuire nuovi ADP XSP| dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti a Webex e, infine, recuperare l'infrastruttura utilizzata per la soluzione precedente.
Abbonamenti ai documenti consigliati
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Esegui sottoscrizione che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di iscriversi a ciascuno dei seguenti articoli per essere certi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per eseguire l'abbonamento, andare a ciascuno dei collegamenti seguenti e nell'articolo che viene avviato, fare clic sul pulsante Abbonati .
Si consiglia di iscriversi come minimo all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati sotto Documenti aggiuntivi dispone di un'opzione Esegui sottoscrizione . Per la visualizzazione di questa opzione, l'articolo deve essere visualizzato su help.webex.com.
Non è disponibile alcuna opzione di abbonamento per le pagine di destinazione della documentazione.
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Webex per documenti Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
-
Soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono propri (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
-
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive la modalità di onboarding e l'onboarding dei dispositivi Room OS e MPP.
-
Guida alla risoluzione dei problemi Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi per Webex per Cisco BroadWorks.
Articoli Webex per Cisco BroadWorks
Per ulteriori informazioni su Webex per Cisco BroadWorks, gli amministratori dei partner possono utilizzare i seguenti siti opzionali:
-
Documentazione di Webex per Cisco BroadWorks: la pagina di destinazione elenca i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
-
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme alle prossime novità.
-
Problemi noti e limitazioni: leggere i problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
-
Ruoli amministratore partner per Webex per BroadWorks e Wholesale RTM: questo articolo descrive come assegnare ruoli amministratore partner per organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte Cisco BroadWorks della soluzione:
Articoli della Guida Webex
È possibile utilizzare i seguenti siti della Guida Webex per trovare articoli Webex che aiutano gli amministratori dei clienti e gli utenti finali a utilizzare le funzioni Webex.
-
Webex dai provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati più di frequente per gli utenti dell'app Webex che hanno acquistato servizi Webex da un provider di servizi.
-
Centro assistenza Webex: utilizzare la funzione di ricerca all'indirizzo help.webex.com per ricercare altri articoli Webex che descrivono l'app Webex e la funzionalità Webex Meetings. È possibile cercare articoli dell'utente o dell'amministratore.
Documentazione per gli sviluppatori
-
Guida per lo sviluppatore di Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Preparazione dell'ambiente
Punti decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastruttura
|
Quanti ADP XSP|? Come prendono mTLS? |
Pianificatore capacità sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento XSP|ADP CLI Questo documento |
Provisioning clienti e utenti |
Si può asserre che si considera attendibili i messaggi e-mail in BroadWorks? Si desidera che gli utenti forniranno gli indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Doc API pubblici su https://developer.webex.com Questo documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo sul branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso dei clienti? | Questo documento |
Funzioni dell'abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o softphone. |
Questo documento Matrice funzioni/pacchetto |
Autenticazione utente | BroadWorks o Webex | Questo documento |
Adattatore di provisioning (per le opzioni di provisioning flow) |
Utilizzi già IM&P integrato, ad esempio per UC-One SaaS? Utilizzare più modelli? Esiste un caso d'uso più comune previsto? |
Questo documento Riferimento CLI server applicazione |
Architettura e infrastruttura
-
Con quale scala intendete iniziare? È possibile aumentare la scalabilità in futuro, ma la stima d'uso corrente deve guidare la pianificazione dell'infrastruttura.
-
Collaborare con il responsabile account / rappresentante di vendita Cisco per ridimensionare l'infrastruttura ADP XSP|, in base alla Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
-
In che modo Webex esegue connessioni TLS reciproche con gli ADP XSP|? Direttamente all'ADP XSP| in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce (Le connessioni TCP non crittografate al bordo della rete non sono supportate).
Provisioning clienti e utenti
Quale metodo di provisioning utente si adatta meglio alle esigenze?
-
Provisioning a flusso costante con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene automaticamente predisposto in Webex.
Se è anche possibile asserre che gli indirizzi e-mail dell'abbonato nella BroadWorks siano validi e univoci per Webex, è possibile utilizzare la varianti "e-mail attendibile" del provisioning flow provisioning. Gli account Webex del sottoscrittore vengono creati e attivati senza il loro intervento; semplicemente scaricare il client ed eseguire l'accesso.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto l provider di servizi deve specificare un indirizzo e-mail valido per l'utente per potervi fornire i servizi Webex. Deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo nell'attributo ID alternativo.
-
Provisioning a flusso costante senza e-mail attendibili: Se non si riesce a verificare l'attendibilità degli indirizzi e-mail dell'abbonato, è comunque possibile assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
-
Provisioning automatico utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. L'utente (o i clienti) distribuiscono invece un collegamento di provisioning e i collegamenti per scaricare diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex. Quindi scaricano il client e a quel punto Webex recuperano alcune configurazioni aggiuntive su di esse da BroadWorks (inclusi i numeri principali).
-
Provisioning controllato SP tramite API: Webex sono esposti una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti generali di sistema descritti in questa guida.
Metodo di provisioning |
Requisiti |
---|---|
Provisioning Flow (e-mail attendibili o non attendibili) |
L'API di provisioning Webex aggiunge gli utenti BroadWorks esistenti a Webex automaticamente una volta che l'utente soddisfa i requisiti e attiva il servizio IM+P integrato . Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello Onboarding include le seguenti impostazioni:
|
Self-Provisioning utente |
L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato l'e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello Onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) |
Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono disponibili due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, andare a Utenti BroadWorks. |
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Installare AP.as.22.0.1123.ap376508.
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Installare AP.as.23.0.1075.ap376509
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Installare AP.as.24.0.944.ap375100
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning di nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per utenti Cisco BroadWorks.
Impostazioni internazionali della lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente amministrativo predisposto viene assegnata automaticamente come impostazioni internazionali predefinite per tale organizzazione cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti alle riunioni in tale organizzazione del cliente.
Sono supportate impostazioni internazionali per la lingua a cinque caratteri in formato (ISO-639-1)_(ISO-3166). Ad esempio, en_USA corrisponde a English_UnitedStates. Se è richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genererà un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso del paese dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, utilizzare le impostazioni internazionali sensibili predefinite in base al codice della lingua richiesto.
Nella tabella seguente vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice della lingua di due lettere in un'impostazione locale di cinque caratteri per le situazioni in cui una impostazione locale di cinque caratteri non è disponibile.
Impostazioni internazionali della lingua supportate (ISO-639-1)_(ISO-3166) |
Se è disponibile solo un codice lingua di due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** |
Utilizzare invece le impostazioni internazionali sensibili predefinite (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA |
it |
en_USA |
fr_FR fr_CA |
Fr |
fr_FR |
cs_CZ |
cs |
cs_CZ |
da_DK |
da |
da_DK |
de_DE |
DE |
de_DE |
hu_HU |
hu |
hu_HU |
id_ID |
Identificativo |
id_ID |
it_IT |
esso |
it_IT |
ja_JP |
ja |
ja_JP |
ko_KR |
ko |
ko_KR |
es_ES es_CO es_MX |
es |
es_ES |
nl_NL |
NL |
nl_NL |
nb_NO |
nb |
nb_NO |
pl_PL |
pl |
pl_PL |
pt_PT pt_BR |
pt |
pt_PT |
ru_RU |
RU |
ru_RU |
ro_RO |
ro |
ro_RO |
zh_CN zh_TW |
zh |
zh_CN |
sv_SE |
sv |
sv_SE |
ar_SA |
ar |
ar_SA |
tr_TR |
tr |
tr_TR |
Le impostazioni internazionali es_CO, id_ID, nb_NO e pt_PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti di Webex Meetings saranno solo in inglese. Inglese è le impostazioni internazionali predefinite per i siti se per il sito non è richiesta alcuna impostazione locale/non valida/non supportata. Questo campo di lingua è applicabile durante la creazione di un sito di organizzazione e Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, verrà utilizzata come lingua predefinita il modello.
Branding
Gli amministratori dei partner possono utilizzare personalizzazioni di branding avanzate per personalizzare il modo in cui l'app Webex cerca le organizzazioni dei clienti gestite dal partner. Gli amministratori dei partner possono personalizzare le seguenti impostazioni per assicurarsi che l'app Webex rifletta il marchio e l'identità della propria società:
-
Loghi aziendali
-
Schemi di colore univoci per la modalità chiaro o la modalità scura
-
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione di personalizzazioni di branding avanzate.
-
Le personalizzazioni del branding di base sono in fase di obsolescenza. Si consiglia di distribuire il branding avanzato, che offre una gamma più ampia di personalizzazioni.
-
Per informazioni dettagliate su come viene applicato il branding quando si esegue il collegamento a un'organizzazione cliente preesistente, fare riferimento a Condizioni dell'allegato organizzazione nella sezione Allega Webex per BroadWorks all'organizzazione esistente .
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding in base alle proprie esigenze, ma quando si esegue l'onboarding di un cliente, tale modello è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Di seguito sono elencati alcuni parametri del modello principale.
Pacchetto
-
È necessario selezionare un pacchetto predefinito quando si crea un modello (per informazioni dettagliate, vedere Pacchetti nella sezione Panoramica). Tutti gli utenti predisposti con tale modello, mediante flusso o auto-provisioning, ricevono il pacchetto predefinito.
-
È possibile controllare la selezione del pacchetto per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori per provisioning aziendali, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
-
Puoi modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedi documentazione dell'API di Webex per Cisco BroadWorks o tramite Partner Hub (vedi Modifica del pacchetto utente in Partner Hub).
-
Non è possibile modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è disattivata; se l'abbonato è assegnato a questo servizio in BroadWorks, il modello Hub partner associato all'URL di provisioning di tale azienda definisce il pacchetto.
Rivenditori e aziende o provider di servizi e gruppi?
-
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se si è un rivenditore con Aziende, è necessario abilitare la modalità Enterprise quando si crea un modello.
-
Se il sistema BroadWorks è configurato in provider di servizi modalità aziendale, è possibile lasciare disattivata la modalità Enterprise nei modelli.
-
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch broadworks richieste per il provisioning flow-through. Per informazioni dettagliate, vedere Patch richieste con provisioning flow-through.
Accertarsi di aver applicato le patch broadworks richieste per il provisioning flow-through. Per informazioni dettagliate, vedere Patch richieste con provisioning flow-through.
Modalità di autenticazione
Decidi come desideri che gli abbonati autenticino quando accedono a Webex. Puoi assegnare la modalità utilizzando l'impostazione Modalità autenticazione nel modello Onboarding. Nella tabella seguente vengono descritte alcune delle opzioni.
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | File BroadWorks ID utente | Indirizzo e-mail |
provider di identità |
BroadWorks.
| Cisco Common Identity |
Autenticazione multi-fattori? | No | Richiede un IdP cliente che supporti l'autenticazione a più fattori. |
Percorso di convalida credenziali
|
|
|
Per una descrizione dettagliata del flusso SSO accesso con autenticazione diretta a BroadWorks, vedere SSO login flow.
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che può verificarsi con le password che utilizzano caratteri speciali in base al quale il browser Web non codifica correttamente i caratteri. Utilizzando una codifica UTF-8, l'intestazione base 64 codificata risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
-
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> imposta authenticationEncoding UTF-8
-
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> imposta authenticationEncoding UTF-8
Paese
È necessario selezionare un paese quando si crea un modello. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie |
Posizione |
Prefisso internazionale |
Nome paese |
---|---|---|---|
1 |
AMER |
+1 |
us, ca |
2 |
APAC |
+65 |
Singapore |
3 |
Anz |
+61 |
Australia |
4 |
EMEA |
+44 |
Regno Unito |
5 |
euro |
+49 |
Germania |
Accordi con più partner
Si desidera utilizzare la licenza secondaria di Webex per Cisco BroadWorks con un altro provider di servizi? In tal caso, ciascun fornitore di servizi avrà bisogno di un'organizzazione partner distinta Webex Control Hub permettere loro di fornire la soluzione per la propria base clienti.
Adattatore e modelli di provisioning
Quando si utilizza il provisioning flowre, l'URL di provisioning inserito in BroadWorks è derivato dal modello in Control Hub. È possibile disporre di più modelli e, quindi, di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati quando hanno ottenuto la concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e il modello che si desidera utilizzare. In questo modo, è necessario solo impostare in modo esplicito l'URL di provisioning per le aziende che necessitano di un modello diverso.
Tenere presente, inoltre, che potrebbe essere stato già utilizzato un URL di provisioning a livello di sistema, ad esempio UC-One SaaS. In tal caso, è possibile scegliere di conservare l'URL a livello di sistema per gli utenti di provisioning su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile passare al percorso alternativo e impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono descritte in dettaglio in Configurazione del server applicazioni con URL del servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning a flusso costante tra il AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server applicazioni e Webex, negando in tal modo la necessità per il server applicazioni di connettersi direttamente a Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati disponibili per Webex devono esistere nel sistema BroadWorks integrato con Webex. Se necessario, è possibile integrare più sistemi BroadWorks.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero principale o interno.
Webex utilizza gli indirizzi e-mail come identificativi principali per tutti gli utenti. Se si utilizza il provisioning flow con messaggi e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail dell'abbonato nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le relative password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo degli utenti BroadWorks Calling che dispongono di un numero principale e/o un interno. Se si utilizza il provisioning a flusso costante, agli utenti deve essere assegnato anche il servizio IM&P integrato.
Server nella rete e requisiti software
-
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere la sezione Criteri per il ciclo di vita dei prodotti BroadSoft in Criteri per il ciclo di vita di BroadSoft e matrice di compatibilità software BroadWorks.
-
Le istanze BroadWorks devono includere almeno i seguenti server:
-
Server applicazioni (AS) con versione BroadWorks come indicato sopra
-
Server di rete (NS)
-
Server di profilo (PS)
-
-
Server ADP XSP|rivolti al pubblico o Piattaforma di consegna delle applicazioni (ADP) che soddisfano i seguenti requisiti:
-
Servizio di autenticazione (BWAuth)
-
Interfacce azioni ed eventi XSI
-
DMS (applicazione Web di gestione dispositivi)
-
Interfaccia CTI (integrazione di telefonia su computer)
-
TLS 1.2 con un certificato valido (non autofirmato) ed eventuali intermedie richiesti. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
-
Autenticazione TLS reciproca (mTLS) per il servizio di autenticazione (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
Autenticazione TLS reciproca (mTLS) per interfaccia CTI (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
-
Un server XSP/ADP separato funge da "server push notifiche di chiamata" (un server NPS nel proprio ambiente utilizzato per eseguire il push delle notifiche di chiamata ad Apple/Google. Questo tipo di chiamata "CNPS" viene chiamata qui per distinguerlo dal servizio in Webex che offre notifiche push per messaggistica e presenza).
Questo server deve essere su R22 o versioni successive.
-
È obbligatorio creare un server XSP/ADP separato per CNPS poiché l'impossibilità di caricare da Webex per connessioni cloud BWKS potrebbe avere un impatto negativo sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSP|ADP, vedere la Guida tecnica di sistema Cisco BroadWorks .
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, vai a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
-
PC/laptop Windows
-
PC Apple / laptop con MacOS
-
iOS (Apple store)
-
Android (Play store)
-
Browser Web (andare a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
-
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
-
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
-
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
-
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (cinese tradizionale)
-
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
-
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
-
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
-
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
-
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (Italiano)
Telefoni e accessori fisici
-
Telefoni IP Cisco:
-
Cisco IP Phone serie 6800 con firmware Multitform
-
Cisco IP Phone serie 7800 con firmware Multitform
-
Cisco IP Phone serie 8800 con firmware Multitform
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html modelli e ulteriori informazioni, vedere .
-
-
I telefoni di terze parti sono supportati allo stesso modo delle altre integrazioni BroadWorks. Tuttavia, non dispongono ancora di contatti e integrazione di presenza con Webex per Cisco BroadWorks.
-
Adattatori:
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 191
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 192 Multiplatform
Per https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html modelli e ulteriori informazioni, vedere .
-
-
Cuffie
-
Cisco Headset serie 500
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html modelli e ulteriori informazioni, vedere .
-
-
Dispositivi Room OS:
-
Webex Room e serie Room Kit
-
Serie Webex Desk
-
Serie Webex Board
-
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e i dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivi
Di seguito sono riportati i file DTAF che devi caricare sui server applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia, è disponibile un nuovo file config-wxt.xml.template
utilizzato per l'app Webex.
Per scaricare gli ultimi profili del dispositivo, andare al sito Download software della piattaforma di consegna dell'applicazione per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che XSP.
Nome client |
Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Business Communicator - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un Profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili di dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Emetti una richiesta di servizio con l'agente di onboarding o il centro TAC di Cisco per il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il seguente titolo di richiesta per le rispettive funzioni:
-
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
-
'Configurazione NPS per Auth Proxy Setup' per configurare NPS per l'uso del proxy di autenticazione.
-
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori dettagli su questa funzione, vedi: Supporto Cisco BroadWorks per CI UUID.
-
Configura BroadWorks per abilitare la fatturazione Cisco per gli abbonamenti BroadWorks e Webex Per BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento validi per 60 giorni. Se il token scade prima di utilizzarlo, puoi inviare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali.
Ordina certificati
Requisiti di certificato per l'autenticazione TLS
Sono necessari certificati di sicurezza, firmati da un'autorità di certificazione affidabile e distribuiti su ADP XSP|rivolti al pubblico, per tutte le applicazioni richieste. Questi verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in ingresso ai server ADP XSP|.
Questi certificati devono includere il nome di dominio completo pubblico XSP|ADP come nome comune oggetto o nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati server dipendono dal modo in cui vengono distribuiti gli ADP XSP|:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente all'ADP XSP|
Il diagramma seguente riepiloga dove deve essere caricato il certificato del server pubblico firmato da CA in questi tre casi:
Le CA pubblicamente supportate che l'app Webex supporta per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per il proxy con bridge TLS
-
Il certificato del server firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta questo certificato server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
È possibile caricare un certificato CA firmato interno sull'ADP XSP|.
-
L'ADP XSP| presenta questo certificato del server firmato internamente al proxy.
-
Il proxy considera attendibile la CA interna che ha firmato il certificato del server ADP XSP|.
Requisiti del certificato TLS per il proxy passthrough TLS o ADP XSP|in DMZ
-
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
-
Gli ADP XSP| presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP|ADPs.
Ulteriori requisiti di certificato per l'autenticazione TLS reciproca su interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione TLS reciproca. Il certificato CA/catena di certificati del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedere a Partner Hub, andare a Impostazioni >
collegamento di download del certificato.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono dalla distribuzione degli ADP XSP| pubblici:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente all'ADP XSP|
Il diagramma seguente riepiloga i requisiti dei certificati in questi tre casi:
(Opzione) Requisiti di certificato per proxy tls-bridge
-
Webex presenta un certificato client firmato pubblicamente al proxy.
-
Il proxy considera attendibile la CA interna Cisco che ha firmato il certificato client. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta il certificato del server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Il proxy presenta un certificato client firmato internamente agli ADP XSP|.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3: Uso chiave estesa X509v3: 1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Il CN del certificato interno deve essere
bwcticlient.webex.com
.-
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati del server interno per XSP|ADP possono essere SAN.
-
Le autorità di certificazione pubbliche potrebbero non voler firmare i certificati con il OID broadworks proprietario richiesto. Nel caso di un proxy bridging, potrebbe essere necessario utilizzare un'autorità di certificazione interna per firmare il certificato client che il proxy presenta all'ADP XSP|.
-
-
Gli ADP XSP| si affidano alla CA interna.
-
Gli ADP XSP| presentano un certificato server firmato internamente.
-
Il proxy considera attendibile la CA interna.
-
La ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XSP| dal proxy.
(Opzione) Requisiti del certificato per il proxy passthrough TLS o ADP XSP|in DMZ
-
Webex presenta un certificato client firmato da un'autorità di certificazione interna Cisco agli ADP XSP|.
-
Gli ADP XSP| affidabili la CA interna Cisco che ha firmato il certificato client. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XSP|.
-
Gli ADP XSP| presentano i certificati del server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP|ADPs.
-
Il server applicazioni ClientIdentity contiene il CN del certificato client firmato da Cisco presentato all'ADP XSP| da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene un elenco di indirizzi IP, porte e protocolli necessari per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle del firewall in entrata ed uscita precedenti documenta solo le connessioni specifiche per Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico a Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e come ciascuna sezione è relativa a Webex per Cisco BroadWorks.
Sezione dell'articolo requisiti di rete |
Gestione delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex |
Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud |
Informativo |
È necessario leggere | |
È necessario leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex |
È necessario leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione |
Opzionale |
Servizi Webex per clienti FedRAMP |
N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedere Whitepaper (PDF) del firewall appWebex.
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza ADP XSP|Broadworks fornita dal partner. Quando un ADP XSP|o un sito non è disponibile per manutenzione pianificata o per motivi non pianificati, i servizi e le app Webex possono passare a un altro ADP XSP| o sito fornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP XSP|BroadWorks possono essere distribuiti direttamente su Internet o possono risiedere in una DMZ preceduta da un elemento di bilanciamento del carico, come F5 BIG-IP. Per fornire la geo-ridondanza, gli ADP XSP| possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un servizio di bilanciamento del carico, ciascuno con un indirizzo IP pubblico. Se gli ADP XSP|sono dietro un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e BroadWorks sembra disporre di un solo ADP XSP|ADP, anche se sono presenti più ADP XSP|.
Nell'esempio seguente, gli ADP XSP| vengono distribuiti in due siti, sito A e sito B. Esistono due ADP XSP|frontali da un servizio di bilanciamento del carico in ciascun sito. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali da LB1 mentre il sito B ha XSP|ADP3 e XSP|ADP4 frontali da LB2. Solo i servizi di bilanciamento del carico sono esposti sulla rete pubblica e le ADP XSP| si trovano nelle reti private DMZ.
Servizi Cloud Webex
Configurazione DNS
I microservizi Webex Cloud devono essere in grado di trovare i server ADP XSP|BroadWorks per la connessione alle interfacce Xsi, al servizio di autenticazione e a CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host ADP XSP|configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento del bordo di bilanciamento del carico o potrebbe essere lo stesso server XSP|ADP. Se vengono restituiti più indirizzi IP, verrà selezionato il primo IP nell'elenco. SRV ricerca non sono attualmente supportate.
Esempio: Record DNS A del partner per la scoperta di server XSP|ADP/Load Balancers bilanciati rivolti a Internet.
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (Sito A) |
R |
|
|
Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP.
Failover
Quando i microservizi Webex inviano una richiesta al servizio di bilanciamento del carico/ADP XSP| e la richiesta non riesce, possono verificarsi diverse cose:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un avanzamento di route al successivo IP.
-
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
-
Se non si riceve alcuna risposta HTTP entro 2 secondi, si verifica un timeout della richiesta e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento all'IP successivo.
Ogni richiesta viene provata 3 volte prima che un problema venga segnalato al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco di indirizzi da provare quando si invia una richiesta a un ADP XSP|. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna all'elenco per riprovare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco dei contatti bloccati. Se tale indirizzo IP viene rimosso dall'elenco dei contatti bloccati.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP XSP| o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster di chiamata BroadWorks, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
-
Azioni XSI
-
Eventi XSI
-
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Lo stato delle connessioni può essere:
-
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
-
Rosso: Quando tutti gli IP nella ricerca dei record A sono irraggiungibili e l'interfaccia non è disponibile.
I seguenti servizi utilizzano i microservizi per la connessione agli ADP XSP| e sono interessati dalla disponibilità dell'interfaccia ADP XSP|:
-
Accesso all'app Webex
-
Aggiornamento token app Webex
-
E-mail/attivazione automatica non attendibile
-
Controllo stato servizio Broadworks
Webex App
Configurazione DNS
L'app Webex accede all'interfaccia Xtended Services Interface (Azioni XSI e Eventi XSI) e ai servizi Device Management Service (DMS) su ADP XSP|.
Per trovare il servizio XSI, l'app Webex esegue una ricerca SRV DNS per _xsi-client._tcp.
. L'SRV punta all'URL configurato per gli host XSP|ADP o i servizi di bilanciamento del carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex esegue il fallback alla ricerca A/AAAA.
L'SRV può risolvere più obiettivi A/AAAA. Tuttavia, ciascun record A/AAAA deve eseguire il mapping a un solo indirizzo IP. Se sono presenti più ADP XSP| in una DMZ dietro il servizio di bilanciamento del carico/dispositivo periferico, è necessario che il servizio di bilanciamento del carico sia configurato per mantenere la persistenza della sessione per indirizzare tutte le richieste della stessa sessione allo stesso ADP XSP|. È richiesta questa configurazione poiché gli heartbeat dell'evento XSI del client devono passare allo stesso ADP XSP| utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non è necessario. Se il DNS richiede che sia definito un record A/AAAA, deve essere restituito solo 1 indirizzo IP. In ogni caso, l'SRV deve essere ancora definito per l'app Webex.
Se Webex App utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client invia heartbeat a un ADP XSP| dove non ha stabilito un canale evento. In questo modo il canale viene eliminato e anche il traffico interno risulta notevolmente più limitato, che compromette le prestazioni del cluster XSP|ADP.
Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca dei record A/AAAA, devi utilizzare un FQDN separato per Webex Cloud e Webex App per accedere alle tue ADP XSP|. Come mostrato negli esempi, Webex Cloud utilizza Un record webex-cloud-xsp.example.com
, e l'app Webex utilizza SRV _xsi-client._tcp.webex-app-xsp.example.com
.
Esempio 1: più ADP XSP|, ciascuno dietro bilanciatori di carico separati
In questo esempio, l'SRV punta a silenziare record A con ciascun record A che punta a un diverso bilanciamento del carico in un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito è riportato un esempio di SRV record.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Esempio 2: più ADP XSP|dietro un singolo servizio di bilanciamento del carico (con bridge TLS)
Per la richiesta iniziale, il servizio di bilanciamento del carico seleziona un XSP|ADP casuale. Indica che XSP ADP|restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il servizio di bilanciamento del carico utilizza il cookie per indirizzare la connessione all'ADP XSP| corretto, assicurando che il canale dell'evento non si rompi.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Bilanciamento del carico |
A |
LB.example.com |
|
Indirizzo IP del servizio di bilanciamento del carico (gli ADP XSP| sono dietro al servizio di bilanciamento del carico) |
URL dms
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il relativo file di configurazione. L'host nell'URL verrà analizzato e l'app Webex eseguirà la ricerca DNS A/AAAA dell'host per connettersi all'ADP XSP| che ospita il servizio DMS.
Esempio: Record DNS A per il rilevamento di server ADP XSP bilanciato verso Internet|/bilanciamento del carico dell'app Webex per scaricare i file di configurazione attraverso DMS:
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. Qualsiasi riferimento a XSP include XSP o ADP.
Come l'app Webex trova indirizzi ADP XSP|
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
-
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (inserito durante la creazione del cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue SRV ricerca nel modo seguente:
-
Il client esegue una ricerca SRV per _xsi-client._tcp.
-
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
-
Il client esegue una ricerca A/AAAA di tali destinazioni e memorizza nella cache gli indirizzi IP restituiti.
-
Il client si connette a uno dei destinazioni (e pertanto, il relativo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi avere lo stesso peso (o a caso se tutti sono uguali).
-
-
Se la ricerca SRV ricerca non restituisce eventuali obiettivi:
Il client esegue una ricerca A/AAAA del parametro radice Xsi, quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento del bordo di bilanciamento del carico o potrebbe essere lo stesso server XSP|ADP.
Come specificato, il record A/AAAA deve risolversi in un indirizzo IP per gli stessi motivi.
-
-
(Opzionale) In un secondo tempo, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocolli> <xsi> <percorsi> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
-
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
-
Se esistono, il client verrà confrontato con l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
-
Se vengono rilevate eventuali differenze, il client inizializza nuovamente la connettività XSI Actions/ XSI Events. Il primo passo consiste nell'eseguire lo stesso processo di ricerca DNS elencato al punto 1, questa volta richiedendo una ricerca per il valore nel %XSI_ROOT_WXT% parametro dal relativo file di configurazione.
Creare i record delle SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
-
Failover
Durante l'accesso, l'app Webex esegue una ricerca SRV DNS per _xsi-client._tcp, crea un elenco di host e si connette a uno degli host in base alla priorità SRV, quindi peso. Questo ospite connesso diventa il selezionato per tutte le richieste future. Un canale di evento viene quindi aperto all'organizzatore selezionato e un heartbeat viene inviato regolarmente per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP; pertanto, è importante che il servizio di bilanciamento del carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server ADP XSP|di backend.
In caso di errore di una richiesta o di una richiesta heartbeat a un host, si possono verificare diverse operazioni:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), l'instradazione dell'app Webex avanza immediatamente al successivo organizzatore nell'elenco.
-
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e indirizza i progressi all'host successivo nell'elenco.
-
Se non si riceve una risposta entro un determinato periodo di tempo, la richiesta viene considerata non riuscita a causa di un timeout e le successive richieste vengono inviate all'organizzatore successivo. Tuttavia, la richiesta di timeout viene considerata come non riuscita. Si è verificato un tentativo in seguito ad alcune richieste in seguito a un errore (con un aumento del tempo di tentativo). Non si sono effettuate nuovamente richieste che presupponete non vitali.
Quando si prova correttamente un nuovo organizzatore, diventa il nuovo organizzatore selezionato, se è presente nell'elenco. Una volta tentato l'ultimo organizzatore nell'elenco, l'app Webex viene rollover a quella del primo.
In caso di heartbeat, se ci sono due errori di richiesta consecutivi, l'app Webex inizializza nuovamente il canale dell'evento.
Tenere presente che l'app Webex non esegue il fail-back e il rilevamento del servizio DNS viene eseguito una sola volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione tramite l'interfaccia ADP/DMS XSP|. Esegue una ricerca dei record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Si tenterà prima di inviare la richiesta di download del file di configurazione utilizzando un token SSO configurazione. Se questo non riesce, verrà riprovare ma con il nome utente e la password del dispositivo.
Distribuisci Webex per BroadWorks
Panoramica della distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning utente. Molte delle attività sono comuni a tutte le modalità di provisioning.
Onboarding dei partner per Webex per Cisco BroadWorks
Ogni provider di servizi o rivenditore Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, devi eseguire la documentazione Webex Cisco BroadWorks e i nuovi partner devono accettare il Contratto ICPA (Indirect Channel Partner Agreement) online. Al termine di questi passaggi, Cisco Compliance crea una nuova organizzazione partner in Partner Hub (se necessario) e invia un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, l'attivazione del partner e/o il Customer Success Program Manager ti contatteranno per iniziare l'onboarding.
I partner Webex in una regione possono creare organizzazioni di clienti in qualsiasi regione che offriamo i servizi. Per informazioni, vedere: Residenza dati in Webex.
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
L'applicazione NPS deve essere eseguita su un XSP|ADP diverso. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi su XSP|ADP.
Servizio/Applicazione |
Autenticazione richiesta |
Scopo servizio/applicazione |
---|---|---|
Eventi XSI |
TLS (il server si autentica ai client) |
Controllo chiamate, notifiche servizi |
Azioni XSI |
TLS (il server si autentica ai client) |
Controllo chiamata, azioni |
Gestione dispositivi |
TLS (il server si autentica ai client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server si autentica ai client) |
Autenticazione utente |
Integrazione di telefonia tramite computer |
mTLS (client e server si autenticano a vicenda) |
Presenza telefonia |
Applicazione Webview impostazioni chiamata |
TLS (il server si autentica ai client) |
Espone le impostazioni di chiamata utente nel portale auto all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma è necessario fare riferimento alla documentazione esistente per ottenere le applicazioni installate su XSP|ADP.
Requisiti di coresidenza
-
Il servizio di autenticazione deve essere co-residente con le applicazioni Xsi poiché tali interfacce devono accettare token di lunga durata per l'autorizzazione al servizio. Il servizio di autenticazione è necessario per convalidare tali token.
-
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
-
È possibile separare gli altri servizi/applicazioni come richiesto per la propria scala (ad esempio, azienda agricola XSP|ADP di gestione dei dispositivi dedicata).
-
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
-
Non installare altre applicazioni o servizi su XSP|ADP utilizzati per l'integrazione di BroadWorks con Webex.
-
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce XSI
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia Cisco BroadWorks Xtended Services Interface.
È necessario distribuire solo un'istanza delle applicazioni Xsi-Events su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso callControlApplicationName definito in Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> Scarica
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente è inserito in Webex, Webex crea un abbonamento per l'utente sul AS per ricevere gli eventi di telefonia per la cronologia della presenza e delle chiamate. L'abbonamento è associato a callControlApplicationName e il AS lo utilizza per sapere a quali Xsi-Events inviare gli eventi di telefonia.
La modifica del callControlApplicationName o il mancato nome di tutte le app Web Xsi-Events avranno impatto sugli abbonamenti e sulla funzionalità degli eventi di telefonia.
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se si utilizza una versione R22 o successiva e il sistema lo supporta.
La funzionalità TLS reciproca (mTLS) è supportata anche come metodo di autenticazione alternativo per il servizio di autenticazione. Se si dispone di più organizzazioni Webex in esecuzione sullo stesso server XSP|ADP, è necessario utilizzare l'autenticazione mTLS poiché la convalida del token CI non supporta più connessioni allo stesso servizio di autorizzazione XSP|ADP.
Per configurare l'autenticazione mTLS per il servizio di autorizzazione anziché la convalida del token CI, fare riferimento all'Appendice per Configurazione dei servizi (con mTLS per il servizio di autorizzazione).
Se attualmente si utilizza mTLS per il servizio di autorizzazione, non è obbligatorio riconfigurare per utilizzare la convalida del token CI con TLS.
-
Recupero delle credenziali OAuth per Webex per Cisco BroadWorks.
-
Installare le seguenti patch su ciascun server XSP|ADP. Installare le patch appropriate alla versione in uso:
-
Per R22:
-
Per R23:
-
Per R24: nessuna patch richiesta
Qualsiasi riferimento a XSP include XSP o ADP.
-
-
Installare l'applicazione
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP nel percorso context /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> attiva applicazione AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire AuthenticationService su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> distribuisci applicazione /authServiceBroadWorks Distribuzione SW Manager distribuzione /authService...
-
A partire da BroadWorks build 2022.10, le autorità di certificazione che arrivano con Java non vengono più incluse automaticamente nell'archivio attendibilità di BroadWorks quando si passa a una nuova versione di Java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
-
IdenTrust Commercial Root CA 1
-
Autorità di certificazione radice Go Daddy - G2
Verificare che questi certificati siano presenti nella seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> ottieni
Se non è presente, eseguire il seguente comando per importare le entità affidabili Java predefinite:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come trust anchor con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono importate automaticamente nella nuova release e continueranno a essere importate fino a quando non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere FD di convalida del certificato Cisco BroadWorks X509.
-
-
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> ottieni
-
imposta clientId client-Id-From-Step1
-
impostazione abilitata true
-
imposta clientSecret client-Secret-From-Step1
-
imposta ciResponseBodyMaxSizeInBytes 65536
-
imposta issuerName <URL>
: per l'URL
, inserire l'URL IssuerName applicabile al cluster CI. Vedere la tabella seguente. -
set issuerUrl <URL>
: per l'URL
, inserire l'IssuerUrl applicabile al cluster CI. Vedere la tabella seguente. -
set tokenInfoUrl <IdPProxy URL>
: inserire l'URL del proxy IdP applicabile al cluster Teams. Vedere la seconda tabella riportata di seguito.
Tabella 1. Impostare issuerName e issuerURL Se il cluster CI è... Impostare issuerName e issuerURL su... USA
UE
US-B
Se non conosci il tuo Cluster CI, puoi ottenere le informazioni dai dettagli cliente nella vista Help desk di Control Hub.
Tabella 2. Imposta URL info token Se il cluster Teams è... Imposta URL info token su...(URL proxy IdP) acm
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
diaframma
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
aore
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
-
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista Help desk di Control Hub.
-
Per il test, è possibile verificare la validità dell'URL tokenInfo sostituendo la parte "idp/authenticate" dell'URL con "ping".
-
-
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> imposta ambito broadworks-connector:utente
-
Configura i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> ottieni
-
imposta flsUrl https://cifls.webex.com/federation
-
imposta periodo di aggiornamento in minuti 60
-
imposta refreshToken refresh-Token-From-Step1
-
-
Per verificare che la configurazione FLS funzioni, eseguire il comando seguente. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Ottieni
-
Configurare la gestione token utilizzando i seguenti comandi su ciascun server XSP|ADP:
-
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
-
imposta tokenIssuer BroadWorks
-
imposta tokenDurationInOre 720
-
-
Genera e condividi chiavi RSA. È necessario generare le chiavi su un XSP|ADP, quindi copiarle in tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
-
Devi utilizzare le stesse coppie di chiavi pubblica/privata per la crittografia/decrittografia del token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene prima richiesto di emettere un token.
Se si spostano i tasti in sequenza o si modifica la lunghezza della chiave, è necessario ripetere la seguente configurazione e riavviare tutti gli XSP|ADP.
-
Selezionare un XSP|ADP da utilizzare per la generazione di una coppia di chiavi.
-
Utilizzare un client per richiedere un token crittografato a tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(viene generata una coppia di chiavi privata/pubblica su XSP|ADP, se non ne era già presente una)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
esportaKeys
-
Copiare il file esportato
/var/broadworks/tmp/authService.keys
nella stessa posizione sugli altri XSP|ADP, sovrascrivendo un file.keys
precedente, se necessario. -
Importa le chiavi su ciascuno degli altri XSP|ADP:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
-
-
Fornire l'URL di authService al container Web. Il contenitore Web di XSP|ADP necessita dell'URL authService in modo da poter convalidare i token. Su ciascuno degli XSP|ADP:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
imposta URL http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> aggiungi tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Verificare il parametro con
get
. -
Riavviare XSP|ADP.
-
Rimuovi il requisito di autenticazione client per il servizio di autorizzazione (solo R24)
Se il servizio di autenticazione è configurato con la convalida del token CI su R24, è necessario anche rimuovere il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> imposta <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Authentication Service, Xsi-Actions e Xsi-Events utilizzano le interfacce del server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > Interfaccia server HTTP = Più specifica
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il comando
get
e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ogni interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> ottieni
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Inserire il comando
get <interfaceIp> 443
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserisci il comando
aggiungi <interfaceIp> 443 TLSv1.2
per assicurarti che l'interfaccia possa utilizzare TLS 1.2 nella comunicazione con il cloud.
Modifica della configurazione di crittografia TLS sull'interfaccia del server HTTP
Per configurare le crittografie richieste:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Inserire il comando
get <interfaceIp> 443
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview). -
Inserire il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.L'XSP|ADP CLI richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizza:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>aggiungi 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base al nome.
Configura gestione dispositivi su XSP|ADP, server applicazioni e server di profilo
Il server di profilo e XSP|ADP sono obbligatori per la gestione dei dispositivi. Devono essere configurati in base alle istruzioni nella Guida alla configurazione di gestione dispositivi BroadWorks.
Interfaccia CTI e configurazione correlata
L'ordine di configurazione "da inmost a outmost" è elencato di seguito. Seguire questo ordine non è obbligatorio.
-
Configurazione del server applicazioni per abbonamenti CTI
-
Configurazione di XSP|ADP per abbonamenti CTI con autenticazione mTLS
-
Porte aperte in ingresso per interfaccia CTI sicura
-
Abbonamento alla tua organizzazione Webex a eventi CTI BroadWorks
Configurazione del server applicazioni per abbonamenti CTI
Aggiornare ClientIdentity sul server applicazioni con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ogni server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> aggiungi bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è bwcticlient.webex.com.
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifica
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità |
Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) |
XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocols> |
Un'interfaccia CTI specifica su questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocols> |
In una nuova installazione, le seguenti crittografie vengono installate per impostazione predefinita a livello di sistema. Se non viene configurato alcun elemento a livello di interfaccia (ad esempio, l'interfaccia CTI o l'interfaccia HTTP), viene applicato questo elenco di crittografie. Tenere presente che questo elenco può cambiare nel tempo:
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
tls_ecdhe_ecdsa_with_aes_128_gcm_sha256
-
tls_ecdhe_rsa_with_aes_128_cbc_sha256
-
tls_ecdhe_ecdsa_with_aes_128_cbc_sha256
-
tls_dhe_dss_with_aes_128_gcm_sha256
-
tls_dhe_rsa_with_aes_128_gcm_sha256
-
tls_dhe_rsa_with_aes_128_cbc_sha256
-
tls_dhe_dss_with_aes_128_cbc_sha256
-
tls_ecdh_rsa_with_aes_128_gcm_sha256
-
tls_ecdh_ecdsa_with_aes_128_gcm_sha256
-
tls_ecdh_rsa_with_aes_128_cbc_sha256
-
tls_ecdh_ecdsa_with_aes_128_cbc_sha256
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserire il comando
get
e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> Ottieni interfaccia porta IP Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
-
Inserire il comando
get <interfaceIp>
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserire il comando
aggiungi <interfaceIp> TLSv1.2
per assicurarsi che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione di crittografia TLS sull'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
-
Immettere il comando
get
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview). -
Inserire il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.L'XSP|ADP CLI richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, è necessario utilizzare:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> aggiungi 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base al nome.
Trust Anchor per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che gli XSP|ADP siano rivolti verso Internet o rivolti verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy di bridge (vedere Requisiti del certificato TLS per il proxy bridge TLS).
Per ogni XSP|ADP nell'infrastruttura che sta pubblicando eventi CTI in Webex, effettuare le seguenti operazioni:
-
Accedi a Partner Hub.
-
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain .txt
sul computer locale.Questi file contengono due set di due certificati. Devi suddividere i file prima di caricarli negli XSP|ADP. Tutti i file sono obbligatori.
-
Suddividere la catena di certificati in due certificati: combinedcertchain .txt
-
Aprire combinedcertchain .txt in un editor di testo.
-
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file. -
Salvare il nuovo file come root .txt.
-
Salvare il file originale come emissione di .txt. Il file originale ora deve disporre di un solo blocco di testo, circondato dalle righe
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copia entrambi i file di testo in una posizione temporanea su XSP|ADP che stai proteggendo, ad esempio,
/var/broadworks/tmp/root .txt
e/var/broadworks/tmp/issuing .txt
-
Accedere a XSP|ADP e passare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
-
(Opzionale) Eseguire
help updateTrust
per visualizzare i parametri e il formato del comando. -
Carica i file dei certificati sui nuovi trust anchor - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot /var/broadworks/tmp/root .txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing /var/broadworks/tmp/issuing .txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
ewebexclientissuing
sono alias di esempio per i trust anchor; puoi utilizzare i tuoi alias purché tutte le voci siano univoche. -
Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> ottieni
Alias Proprietario emittente ============================================================================= webexclientissuing Internal Private TLS SubCA Internal Private Root webexclientroot Internal Private Root[self-signed]
-
Consenti ai client di eseguire l'autenticazione con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> imposta allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
-
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione di BroadWorks. Il comando crea un certificato del server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> aggiungi <Interface IP> 8012 true true true
-
-
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. A tale scopo, è necessario l'indirizzo IP dell'interfaccia CTI; è possibile leggerlo nel seguente contesto:
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> ottieni
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la propria chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interfaccia IP> file chiave</path/to/file chiave certificato> certificatoFile </path/to/certificato server> chainFile</path/to/chain file>
-
-
Riavviare XSP|ADP.
Abilitazione dell'accesso a eventi CTI BroadWorks su Webex
Devi aggiungere e convalidare l'interfaccia CTI quando configuri i cluster in Partner Hub. Vedi Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
Devi aggiungere e convalidare l'interfaccia CTI quando configuri i cluster in Partner Hub. Vedi Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
-
Specifica l'indirizzo CTI in base al quale Webex può abbonarsi agli eventi CTI BroadWorks.
-
Gli abbonamenti CTI si basano su abbonamento singolo e vengono stabiliti e mantenuti solo mentre tale abbonato viene predisposto per Webex per Cisco BroadWorks.
Impostazioni chiamata vista Web
CSWV (Call Settings Webview) è un'applicazione ospitata su XSP|ADP che consente agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview impostazioni chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono nativi dell'app Webex.
Se desideri che gli abbonati a Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre ai valori predefiniti disponibili nell'app Webex, devi distribuire la funzione Webview impostazioni chiamata.
La vista Web Impostazioni chiamata dispone di due componenti:
-
Applicazione Webview impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
-
L'app Webex, che esegue il rendering delle impostazioni di chiamata in una vista Web.
Esperienza utente
-
Utenti Windows: Fai clic su Impostazioni chiamata, quindi fai clic su .
-
Utenti Mac: Fare clic sull'immagine del profilo, quindi su
.
Distribuzione di CSWV su BroadWorks
Installazione della vista Web impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso XSP|ADP che ospita l'interfaccia Azioni Xsi nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
-
Accedere a cisco.com e ricercare "BWCallSettingsWeb" nella sezione di download del software.
-
Trova e scarica la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) era il più recente al momento della scrittura. -
Installare, attivare e distribuire l'archivio Web in base alla guida alla configurazione della piattaforma di servizio Cisco BroadWorks Xtended per la versione XSP|ADP. (Versione R24 è https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
-
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
. -
Selezionare il seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> installa applicazione /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
-
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più richiesto). -
Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> attiva applicazione BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario anche fornire un ContextPath poiché si tratta di un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio,
/callsettings
. -
Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> distribuisci applicazione /callsettings
-
-
Ora è possibile prevedere l'URL delle impostazioni di chiamata che verrà specificato per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
-
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
-
XSP|ADP-FQDN deve corrispondere all'FQDN azioni Xsi, poiché CSWV deve utilizzare azioni Xsi e CORS non è supportato.
-
-
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview impostazioni chiamata ora è attiva su XSP|ADP.
Configura l'app Webex per utilizzare la vista Webview impostazioni chiamata
Per ulteriori informazioni sulla configurazione del client, vedere Guida alla configurazione di Webex per Cisco BroadWorks.
È presente un tag personalizzato nel file di configurazione dell'app Webex che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti tramite l'interfaccia dell'applicazione.
<config> <servizi> <web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%"> <url>%WEB_CALL_SETTINGS_URL_WXT%</url> </web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel tag %WEB_CALL_SETTINGS_URL_WXT%.
Se non specifichi esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
-
Assicurati di disporre degli ultimi modelli di configurazione per l'app Webex (vedi Profili dispositivo).
-
Impostare la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
-
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente in uso, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.esempio.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
-
Il file di configurazione del client risultante deve contenere una voce nel seguente modo:
<web-call-settings target="csw"> <url>https://yourxsp.esempio.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Server push notifiche chiamate (CNPS) per descrivere un'applicazione ospitata XSP o ADP eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in ingresso ai tuoi utenti e invia le notifiche ai servizi di notifica di Google Firebase Cloud Messaging (FCM) o Apple Push Notification service (APN).
Tali servizi notificano ai dispositivi mobili di Webex per gli abbonati Cisco BroadWorks che hanno chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere Descrizione della funzione del server push delle notifiche.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per inviare le notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi notificano a loro volta agli utenti mobili Webex i messaggi in arrivo o le modifiche alla presenza.
In questa sezione viene descritto come configurare NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se devi eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedi Aggiornamento dell'NPS Cisco BroadWorks per l'uso del proxy NPS https://help.webex.com/nl5rir2/.
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario applicare le patch al CNPS per supportare la funzione proxy NPS, Server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server push di notifica per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private del certificato di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e le chiavi di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend Cisco BroadWorks e utilizza questo token per l'autenticazione con i servizi Apple APN e Google FCM.
La funzione migliora anche la funzionalità del server push notifiche di push delle notifiche ai dispositivi Android tramite la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
-
Per ulteriori informazioni, vedere Descrizione della funzione Server push per VoIP in UCaaS.
-
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software NPS e le patch, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Ricercare e scaricare la patch dalla pagina di download del software.
-
Ulteriori informazioni sul server ADP sono disponibili all'indirizzo https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni su APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio di notifica push di Apple dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per gli APN. Questo aggiornamento richiede che XSP|ADP che ospita NPS sia in esecuzione R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 |
Installare e configurare un XSP dedicato (versione minima R22) o Application Delivery Platform (ADP). |
2 |
Installare le patch del proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: |
3 |
Attivare l'applicazione del server push di notifica. |
4 |
(Per le notifiche Android) Abilitare l'API FCM v1 su NPS.
|
5 |
(Per le notifiche Apple iOS) Abilita HTTP/2 su NPS.
Questa opzione è esclusiva della release 22 e delle versioni precedenti; non è disponibile nella release 23 e nelle versioni precedenti che supportano solo HTTP/2. |
6 |
Collegare un supporto tecnico da XSP/ADP NPS. |
7 |
Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa 149.vle.broadsoft.com qa 149.vle.broadsoft.com IN UN 10.193.78.149 Una volta impostato, è necessario uno dei seguenti elementi per rispondere alle modifiche:
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configurazione di NPS per l'uso del proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Esegui migrazione da NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un NPS condiviso con altre app mobili, vedere Aggiornamento dell'NPS Cisco BroadWorks per l'uso del proxy NPS ( https://help.webex.com/nl5rir2).
1 |
Recupero delle credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 |
Creare l'account client su NPS:
Per verificare che i valori immessi corrispondano a quanto specificato, eseguire L'Url emittente CiscoCI deve essere SEMPRE il cluster CI USA, indipendentemente dalla posizione e il valore predefinito deve essere:
| |||||||||||||||||||
3 |
Immettere l'URL del proxy NPS e impostare l'intervallo di aggiornamento del token (si consiglia 30 minuti):
| |||||||||||||||||||
4 |
(Per notifiche Android) Aggiungere l'ID dell'applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 |
(Per le notifiche Apple iOS) Aggiungere l'ID dell'applicazione al contesto delle applicazioni APNS assicurandosi di omettere la chiave di autorizzazione, impostarla su vuota.
| |||||||||||||||||||
6 |
Configura i seguenti URL NPS:
| |||||||||||||||||||
7 |
Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 |
Verificare che il server applicazioni stia eseguendo lo screening degli ID delle applicazioni poiché potrebbe essere necessario aggiungere le app Webex all'elenco degli utenti autorizzati: | |||||||||||||||||||
9 |
Riavviare XSP|ADP: | |||||||||||||||||||
10 |
Prova le notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migra NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente per la migrazione a FCMv1. Le procedure sono tre:
Esegui migrazione dei client UC-One a FCMv1
Utilizza la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella Console FCM, vedi
. L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile di connessione all'indirizzo https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al parametro gcm_defaultSenderId
, che si trova nel kit di branding, nella cartella Risorse e nel file branding.xml con la sintassi seguente:
<string name="gcm_defaultSenderId">xxxxxxxxxxxxx</string>
-
Accedere a FCM Admin SDK all'indirizzo http://console.firebase.google.com.
-
Selezionare l'applicazione Android appropriata.
-
Nella scheda Generale, registrare l'ID del progetto
-
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurare un account esistente.
Per creare un nuovo account servizio:
-
Fare clic sul pulsante blu per creare un nuovo account servizio
-
Fai clic sul pulsante blu per generare una nuova chiave privata
-
Scarica chiave in una posizione sicura
Per riutilizzare un account servizio esistente:
-
Fare clic sul testo blu per visualizzare gli account servizio esistenti.
-
Identificare l'account servizio da utilizzare. L'account servizio richiede l'autorizzazione firebaseadmin-sdk.
-
A destra, fare clic sul menu dell'hamburger e creare una nuova chiave privata.
-
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
-
-
Copia il file json su XSP|ADP.
-
Configura l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> aggiungi <id progetto> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> ottieni Project ID Accountkey ======================== mio_progetto ********
-
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> aggiungi <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> ottieni ID applicazione Progetto ID ============================== my_app my_project
-
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Abilitato true ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP.
Esegui migrazione dei client SaaS a FCMv1
Utilizzare la procedura seguente su Google FCM Console se si desidera eseguire la migrazione dei client SaaS a FCMv1.
Accertarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione".
-
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Enabled false ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP. -
Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Abilitato true ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP.
Aggiorna server ADP
Utilizzare la procedura seguente in Google FCM Console se si sta eseguendo la migrazione di NPS per utilizzare un server ADP.
-
Ottenere il file JSON dalla console cloud di Google:
-
Nella console Google Cloud, andare alla pagina Account servizio.
-
Fai clic su Seleziona un progetto, scegli il progetto e fai clic su Apri.
-
Individuare la riga dell'account servizio per il quale si desidera creare una chiave, fare clic sul pulsante verticale Altro, quindi fare clic su Crea chiave.
-
Seleziona un tipo di chiave e fai clic su Crea
Il file viene scaricato.
-
-
Aggiungere FCM al server ADP:
-
Importare il file JSON nel server ADP utilizzando il comando
/bw/install
. -
Accedi a ADP CLI e aggiungi il progetto e la chiave API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> aggiungi connect /bw/install/google JSON
: -
Quindi, aggiungere l'Applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Chiudi
-
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ================================== com.broadsoft.ucaas.connect connect-ucaas
-
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò viene effettuato per i seguenti motivi:
-
Per consentire al cloud Webex di autenticare gli utenti in base a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
-
Di consentire alle app Webex di utilizzare l'Interfaccia XSI per il controllo delle chiamate.
-
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se una delle interfacce non viene convalidata correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide.
Questo problema viene impedito poiché un cluster configurato in modo errato può provocare problemi che sono difficili da risolvere.
Cosa è necessario fare:
-
Accedere a Partner Hub (admin.webex.com) con le credenziali di amministratore partner.
-
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni BroadWorks Calling.
Se l'utente amministratore non dispone della visibilità delle impostazioni BroadWorks Calling, si consiglia di aprire un caso con Cisco TAC.
-
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
-
Assegnare un nome a questo cluster e fare clic su Avanti.
Il concetto di cluster in questo caso è semplicemente un insieme di interfacce, solitamente raggruppate su server o farm XSP|ADP, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il tuo sistema BroadWorks non rientrano nell'ambito qui.
-
(Opzionale) Inserisci un Nome account e una Password utente BroadWorks all'interno del sistema BroadWorks che stai connettendo a Webex, quindi fai clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
-
Aggiungi gli URL Azioni XSI e Eventi XSI.
-
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
-
Opzionale. Seleziona la casella di controllo Abilita autenticazione diretta BroadWorks se desideri che gli accessi a BroadWorks siano diretti a BroadWorks. Altrimenti, l'autenticazione a BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo incide sulle seguenti situazioni di accesso:
-
Accesso al portale di attivazione utente: gli utenti devono inserire le proprie credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o tramite il proxy IdP.
-
Accesso client: se Autenticazione BroadWorks è configurata nel modello Onboarding, l'impostazione precedente determina se l'accesso client all'app Webex è diretto a BroadWorks o è proxy tramite il proxy IdP.
-
-
Fai clic su Avanti.
-
Nella pagina Interfaccia CTI, effettuare le seguenti operazioni:
-
Aggiungere l'URL CTI e la Porta per l'interfaccia CTI a cui si desidera connettersi.
-
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia delle chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
-
Opzionale. Abilita il tasto di alternanza di sincronizzazione Non disturbare (DND) e inserisci il tuo ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurando che la funzione funzioni allo stesso modo su entrambe le piattaforme.
-
Fai clic su Avanti.
-
-
Aggiungere l'URL del servizio di autenticazione.
-
Selezionare Servizio di autorizzazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex, poiché il servizio di autenticazione convalida correttamente il token utente in base al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
-
Esamina le voci nella schermata finale, quindi fai clic su Crea. Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Partner Hub passa gli URL a vari microservizi Webex che verificano le connessioni alle interfacce fornite.
-
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e specificare se la convalida è stata completata correttamente.
-
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Questo controllo è stato implementato per evitare errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, servizio di bilanciamento del carico o firewall) come documentato in questa guida, prima di salvare il modello.
Controllo delle connessioni alle interfacce BroadWorks
-
Accedere a Partner Hub (admin.webex.com) con le credenziali di amministratore partner.
-
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni BroadWorks Calling.
-
Fai clic su Visualizza cluster.
-
Partner Hub avvia test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, nella pagina di elenco dei cluster viene visualizzato il messaggio di stato accanto a ciascun cluster.
Dovrebbero essere visualizzati messaggi verdi di operazione riuscita. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
-
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio azioni XSI, eventi XSI, URL DAS e impostazioni dell'interfaccia CTI.
Configura i tuoi modelli di onboarding
I modelli di onboarding sono il modo in cui applicherai la configurazione condivisa a uno o più clienti durante l'onboarding tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma è possibile associare un solo modello a un cliente.
-
Accedi a Partner Hub e seleziona Clienti.
-
Fai clic sul pulsante Modelli di onboarding per visualizzare i modelli esistenti.
-
Fare clic su Crea modello.
-
Nella finestra Dettagli modello, aggiungere il nome del modello, il paese o la regione e la lingua e-mail predefinita.
-
Fare clic sull'elenco a discesa per l'ID abbonamento CCW, individuare gli abbonamenti elencati per il partner e selezionare l'abbonamento applicabile.
Questo campo è visualizzato solo per i partner migrati da Webex per BroadWorks a Webex.
-
Nella finestra Impostazione servizio, utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
-
Inserisci un Nome modello, quindi fai clic su Avanti.
-
Configurare la modalità di provisioning utilizzando queste impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per le diverse modalità di provisioning Nome impostazione
Provisioning a flusso costante con e-mail attendibili
Provisioning a flusso costante senza e-mail
Provisioning automatico utente
Abilita il flusso BroadWorks attraverso il provisioning (includi le credenziali dell'account di provisioning se Attivato**)
Attivato
Fornire Nome account e Password di provisioning in base alla configurazione BroadWorks.
Attivato
Fornire Nome account e Password di provisioning in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il
Il
Il
Indirizzo e-mail provider servizi
Seleziona un indirizzo e-mail dall'elenco a discesa (puoi digitare alcuni caratteri, per trovare l'indirizzo se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso di amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello Onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto associa le organizzazioni dei clienti create con questo modello a una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedi le mappature paese-regione in questo foglio di calcolo.
Il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni, fai riferimento alla sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questa opzione disattivata.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note della tabella:
-
† Questo switch assicura che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa operazione deve essere sempre attiva, a meno che non si stia utilizzando un processo di ordinazione ed esecuzione manuale (tramite Cisco Commerce Workspace) per creare organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello "Provisioning ibrido" ed è fuori dall'ambito di questo documento.
-
** "Account di provisioning" si riferisce all'account amministratore a livello di sistema BroadWorks. In BroadWorks, hai bisogno di un account amministratore con questi attributi: Tipo di amministratore = Provisioning, Sola lettura = Disattivato.
-
-
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
-
Opzionale. Seleziona Disabilita chiamata gratuita Cisco Webex se desideri disabilitare le chiamate Webex.
-
Per Configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
-
Numeri di chiamata in ingresso Cisco (PSTN)
-
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
-
-
Fai clic su Avanti.
-
Esistono due approcci per il provisioning degli abbonati per quanto riguarda il modo in cui vengono verificate le loro identità: utilizzando messaggi e-mail attendibili o messaggi e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. L'utente in qualità di partner è responsabile del provisioning dell'indirizzo e-mail come parte del metodo di flusso attraverso o API.
Si consiglia vivamente di utilizzare il metodo di provisioning affidabile perché assicura che tutti gli abbonati siano forniti completamente da parte dell'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso di e-mail non attendibile gli utenti devono verificare l'e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome impostazione
Provisioning a flusso costante senza e-mail
Provisioning automatico utente
Esegui prima provisioning amministratori
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
-
Note della tabella:
-
* A ciascuna organizzazione cliente in Webex deve essere assegnato almeno un utente con ruolo di amministratore. Il primo utente a cui viene assegnato l'IM&P integrato in BroadWorks assume il ruolo di amministratore cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di provider di servizi, è possibile avere il controllo su chi ottiene il ruolo. Selezionando questa impostazione, gli utenti non possono completare l'attivazione fino a quando non viene attivato il primo utente predisposto. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
-
-
Fai clic su Avanti.
-
Seleziona la modalità di autenticazione predefinita (Autenticazione BroadWorks o Autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla modalità di configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con il centro TAC di Cisco.
Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente.
-
Fai clic su Avanti.
-
Per Preferenze, configurare quanto segue:
-
Scegliere se si desidera precompilare gli indirizzi e-mail utente nella pagina di accesso.
Devi utilizzare questa opzione solo se hai selezionato Autenticazione BroadWorks e hai anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. Altrimenti, dovranno utilizzare il proprio nome utente BroadWorks. La pagina di accesso offre un'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
-
Se desideri abilitare la sincronizzazione delle rubriche, imposta l'opzione Abilita sincronizzazione rubriche telefoniche per tutte le nuove organizzazioni cliente su On.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente, in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
-
Inserire un Amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatizzato di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
-
Assicurati che l'opzione Consenti inviti e-mail amministratore al momento del collegamento a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
-
Fai clic su Avanti.
-
Rivedere le voci nella schermata finale. Puoi fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare eventuali dettagli. Fare clic su Crea.
Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con qualsiasi altro modello.
-
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario inserire nuovamente i dettagli dell'account di provisioning. I campi password/password di conferma vuoti sono disponibili per modificare le credenziali, ma lasciarle vuote per mantenere i valori forniti alla procedura guidata.
Aggiungere altri modelli se si dispone di configurazioni condivise diverse che si desidera fornire ai clienti.
Mantenere aperta la pagina Visualizza modelli poiché potrebbero essere necessari i dettagli del modello per una seguente attività.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning.
Patch Application Server (solo R22, R23 e R24)
-
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
-
Per R22:
AP.as.22.0.1123.ap373197
-
Per R23:
AP.as.23.0.1075.ap373197
-
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che costituiscono i requisiti per la distribuzione di Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.
-
-
Passare al contesto
Opzioni di manutenzione/contenitore
. -
Abilitare il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> aggiungi provisioning bw.imp.useProvisioningUrl true
Ottieni URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per dettagli (Interfaccia > Messaggistica e servizio > IM&P integrato) dei comandi AS.
-
Accedi a Partner Hub e vai a
. -
Fare clic su Visualizza modelli.
-
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro a scomparsa a destra. Se non è stato ancora creato un modello, è necessario effettuare questa operazione per ottenere l'URL di provisioning.
-
Copiare l'URL adattatore di provisioning.
Ripetere questa operazione per altri modelli se sono presenti più modelli.
(Opzione) Configurazione di parametri di provisioning a livello di sistema sul server applicazioni
Se si utilizza UC-One SaaS, è possibile non impostare il provisioning a livello di sistema e il dominio di servizio. Vedere Punti decisionali nella sezione Preparazione dell'ambiente.
-
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
-
AS_CLI/Interface/Messaging> imposta URL provisioning URL provisioning
-
AS_CLI/Interface/Messaging> imposta provisioningUserId provisioning_account_name
-
AS_CLI/Interface/Messaging> imposta password provisioning provisioning_account_password
-
AS_CLI/Interface/Messaging> imposta abilitaSincronizzazione true
-
-
Attivare l'interfaccia IMP integrata:
-
/AS_CLI/Service/IntegratedIMP> imposta serviceDomain esempio.com
-
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> imposta userAttrIsActive true
-
Devi inserire il nome completo per il parametro URL provisioning
, come è stato assegnato in Control Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel file /etc/hosts
sul server applicazioni.
(Opzione) Configurazione dei parametri di provisioning per azienda sul server applicazioni
-
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
-
Selezionare Usa dominio servizio e immettere un valore fittizio (Webex ignora questo parametro). Puoi utilizzare
example.com
). -
Selezionare Usa server di messaggistica.
-
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
Devi inserire il nome completo per il parametro
URL provisioning
, come è stato assegnato in Partner Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel file/etc/hosts
sul server applicazioni. -
Nel campo Nome utente, inserire un nome per l'amministratore di provisioning. Questa operazione deve corrispondere al valore riportato nel modello in Partner Hub.
-
Immettere una password per l'amministratore di provisioning. Questa operazione deve corrispondere al valore riportato nel modello in Partner Hub.
-
Per Identità utente predefinita per ID IM&P, selezionare Principale.
-
Fare clic su Applica.
-
Ripetere questa operazione per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning degli utenti, vedere Provisioning degli utenti del provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning consente agli amministratori e ai team di vendita di verificare gli errori prima di eseguire il provisioning di un pacchetto a un cliente o un abbonato. Gli utenti o le integrazioni autorizzate da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per garantire che non vi siano conflitti o errori con il provisioning del pacchetto per un determinato cliente o abbonato.
L'API controlla se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto per un cliente o un partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, puoi correggere tali errori prima del provisioning, aumentando la probabilità di un provisioning corretto.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore di Webex per la Vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare il provisioning di un abbonato Wholesale
Per accedere a Verifica preliminare di un documento di provisioning Wholesale Subscriber, è necessario accedere a https://developer.webex.com/ portal.
SSO partner - SAML
Consente agli amministratori partner di configurare la funzionalità SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura SSO del partner seguente si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere il Single Sign-On (SSO) partner a un'organizzazione esistente del cliente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso.
-
Verifica che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'Integrazione Single Sign-On in Control Hub.
-
Carica il file di metadati CI con provider identità.
-
Configura un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, inserire l'EntityID dall'XML dei metadati SAML del provider di identità di terze parti.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizzi il modello.
-
Molto che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori partner di configurare la funzionalità SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per l'impostazione dell'OIDC SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già presenti utilizzando il modello.
-
Aprire una richiesta di assistenza con il centro TAC di Cisco con i dettagli dell'IDP OpenID Connect. Di seguito sono riportati attributi IDP obbligatori e opzionali. Il centro TAC deve impostare l'IDP sul CI e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC potrebbe essere costituito da lettere, numeri, trattini, sottolineature, inclinazioni e punti; la lunghezza massima è 128 caratteri.
ID client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Chiave privata client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco di ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio; ad esempio, 'profilo e-mail openid' Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non è fornito
URL dell'endpoint di autorizzazione OAuth 2.0 di IdP.
Endpoint token
Sì se discoveryEndpoint non è fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
Endpoint infoUtente
No
URL dell'endpoint Info utente dell'IdP.
Endpoint set di tasti
No
URL dell'endpoint di set di chiavi Web JSON dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
-
Configurare l'URI di reindirizzamento sull'IDP connect OpenID.
-
Configura un modello di onboarding. Per l'impostazione della modalità di autenticazione, seleziona Autenticazione partner Con OpenID Connect e inserisci il nome IDP fornito durante l'impostazione dell'IDP come ID entità IDP OpenID Connect.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizzi il modello.
-
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo di correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'Identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui Registrazione chiamata, Risposta per assente di gruppo, Dirigente e Dirigente-Assistente.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
-
Eseguire i seguenti comandi sulle interfacce AS. In questo modo, il AS potrà inviare l'intestazione SIP X-BroadWorks-Correlation-Info:
AS_CLI/Interface/SIP> imposta sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> imposta sendCallCorrelationIDAccess true
-
Il/la enableID correlazione chiamataparametro associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione di informazioni di correlazione delle chiamate nei registri Xsi-Actions. Si consiglia di abilitare
enableCallCorrelationID
utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>imposta enableCallCorrelationID true
Per ulteriori informazioni sull'identificatore di correlazione chiamata, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione delle rubriche assicura che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la rubrica di chiamata completa dal server BroadWorks viene sincronizzata con la rubrica Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione delle rubriche, vai a Sincronizzazione rubrica in Webex per Cisco BroadWorks.
Il provisioning a flusso costante di Webex per Cisco BroadWorks aggiunge gli utenti di messaggistica e le informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, elenchi di telefoni, utenti non di messaggistica e entità non utente non sono inclusi (ad esempio, un telefono per sala conferenze, un fax o un numero di gruppo di ricerca). L'attivazione della sincronizzazione delle rubriche assicura che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex.
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia delle chiamate e delle riunioni Webex Unified visualizzata nell'app Webex. Gli utenti possono visualizzare la propria cronologia dettagliata delle chiamate e della cronologia delle riunioni dall'app Webex.
La cronologia delle chiamate unificate può essere abilitata dagli amministratori a livello di partner in Partner Hub cluster per cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata nel cloud Webex:
-
Eventi della cronologia delle chiamate: questi eventi vengono utilizzati per creare una cronologia delle chiamate unificata dettagliata
-
Eventi di stato ricevitore: la cronologia delle chiamate unificate include le ottimizzazioni dello stato dell'aggancio che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di presenza di telefonia
Requisiti cronologia chiamate Unified
Prima di configurare la cronologia chiamate unificata, verificare di aver applicato le patch al sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
Per R23:
-
Se si utilizza XSP—AP.xsp.23.0.1075.ap378585
-
In caso di uso di ADP—
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
Per l'elenco completo delle patch BroadWorks che occorre installare come prerequisito per eseguire Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.
Oltre alle patch del sistema, il file di configurazione del client (config-wxt.xml
) deve avere il seguente tag impostato: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altre informazioni di reindirizzamento nella cronologia chiamate Unified, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
-
AP.as.23.0.1075.ap383346
-
AP.as.23.0.1075.ap383994
Per R24:
-
AP.as.24.0.944.ap383346
-
AP.as.24.0.944.ap383994
Per disporre delle informazioni su dirigente-assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
-
AP.as.24.0.944.ap380052
-
AP.as.24.0.944.ap384239
-
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare la sincronizzazione delle rubriche anche per la cronologia delle chiamate unificata per dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione DND, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti sotto il cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione BroadWorks durante la stessa finestra di manutenzione.
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedi la procedura per l'aggiunta di un cluster in Configurazione dell'organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettua le seguenti operazioni:
-
Accedi a Partner Hub all'indirizzo admin.webex.com.
-
Vai a Impostazioni e seleziona un cluster esistente.
-
Verificare che la connessione del cluster sia buona. Nel pannello destro dovrebbe essere visualizzato un segno di spunta verde con Connessione stabilita.
Se non viene visualizzato, in Controlla connessioni (opzionale), inserisci ID utente BroadWorks e Password BroadWorks e fai clic su Verifica per verificare che la connessione sia buona.
-
Selezionare la casella di controllo Abilita cronologia chiamate.
-
Fai clic su Salva.
Interazioni funzioni
Le seguenti interazioni con le funzioni esistono per la cronologia chiamate unificata:
-
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando esiste questa situazione, gli eventi Cronologia chiamate e Stato ricevitore non vengono inviati all'app Webex.
-
La cronologia chiamate unificata non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata a interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia delle chiamate unificate dall'app Webex. Per informazioni dettagliate, vedere: Webex | Visualizzazione della cronologia chiamate e riunioni.
Disabilita cronologia chiamate Unified
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione per proprio conto. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visiva
L'app Webex supporta un'indicazione visiva delle chiamate di spam nell'avviso popup di chiamata quando la chiamata viene presentata alla persona chiamata e nei record della cronologia chiamate unificata quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per disporre di questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- È necessario installare e attivare le seguenti patch:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o almeno AS-25_Rel_2022.12
- La funzione deve essere attivata tramite la CLI AS:
- AS_CLI/System/ActivatableFeature> attiva 104112
- AS_CLI/System/StirShaken> imposta enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'assegnazione di tag e la verifica STIR-SHAKEN come descritto in Tag e verifica di firma STIR-SHAKEN di Cisco BroadWorks
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste INVITE inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione visiva di spam nella presentazione della chiamata e nella cronologia chiamate unificata della persona chiamata.
Sincronizzazione stato assistente personale
La funzione di sincronizzazione stato dell'assistente personale (PA) sincronizza lo stato di presenza dell'assistente personale tra i dispositivi BroadWorks Calling e Webex App.
Il servizio PA fornisce all'utente un'opzione per informare i chiamanti del motivo per cui la parte chiamata non è disponibile, fornendo opzionalmente informazioni su quando la parte chiamata ritorna e se è presente un operatore per gestire la chiamata. La funzione PA consente agli utenti nelle app Webex di visualizzare la presenza dell'utente insieme allo stato PA e alla durata configurati.
Prerequisiti
Accertarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione di BroadWorks.
Patch per RI e versione 24:
-
AP.as.24.0.944.ap385558
La funzione di sincronizzazione dello stato dell'assistente personale introduce un nuovo pacchetto di eventi PersonalAssistantSync per consentire ai client XSI di sincronizzare con le modifiche alla presenza dell'assistente personale Cisco BroadWorks. Per ulteriori informazioni, vedere Pacchetto eventi XSI per la funzione di sincronizzazione dello stato dell'assistente personale.
Oltre alle patch del sistema, il file di configurazione del client ({0}config-wxt.xml{1}) deve avere il seguente tag impostato: <personal-assistant abilitato="%PERSONAL_ASSISTANT_ENABLED_WXT%"/>
Abilita sincronizzazione stato assistente personale (nuovo cluster)
Per abilitare la sincronizzazione dello stato dell'assistente personale su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configurazione dell'organizzazione partner in Partner Hub.
Abilita sincronizzazione stato assistente personale (cluster esistente)
-
Accedere a Partner Hub con le credenziali di amministratore partner all'indirizzo https://admin.webex.com.
-
Fai clic su Impostazioni organizzazione.
-
Fai clic su Visualizza cluster e seleziona il cluster BroadWorks appropriato.
- Nella sezione Interfaccia CTI, abilitare il tasto di alternanza Sincronizzazione stato assistente personale.
-
Inserisci il tuo ID utente BroadWorks e fai clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione PA. Se la convalida non riesce, il pulsante Salva viene disabilitato.
-
Se la convalida ha esito positivo, fai clic su Salva.
L'abilitazione della sincronizzazione dello stato PA è un interruttore a una via. Una volta abilitata la funzione, non puoi disabilitarla da solo.
Disabilita sincronizzazione stato assistente personale
Una volta abilitato lo stato di sincronizzazione PA su uno dei cluster BroadWorks, non puoi disabilitare la funzione da solo. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenterà di identificare chi è il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra in chiamata e al termine della chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante associando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se vengono trovate più istanze di un numero in un'origine, non tenterà di sceglierne una; in questo caso, non verrà visualizzato alcun ID chiamante.
-
Webex Common Identity (CI) contenente gli utenti dell'organizzazione.
-
Contatti personali e organizzazione. I contatti personali sono visibili sotto la scheda Contatti.
-
rubrica locale. In Windows - applicazione Outlook, in Mac - contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non è stata trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, verrà utilizzata come ultima istanza la parte del nome utente dell'URI SIP dell'intestazione SIP From.
Per il controllo remoto delle chiamate (ad esempio, modalità di controllo telefono fisso) vengono utilizzate le informazioni XSI, dove viene utilizzato l'ID BWKS o l'interno, estratte dalle informazioni della parte remota nell'evento XSI. Se remote-party-info non è disponibile, viene utilizzato PAI (P-Asserted Identity) (se configurato).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica e nella cronologia chiamate.
-
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
-
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
-
Coda call center: Visualizza il nome della coda che ha inoltrato la chiamata.
-
Dirigente-Assistente: Visualizza il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
-
Per le chiamate in coda chiamata interne, in cui un agente richiama una parte interna, la parte remota non visualizza il nome della coda chiamata, ma visualizza il nome dell'agente che la chiama.
Chiamata con risposta altrove:
Per i gruppi di risposta o le code di chiamata impostate con l'indirizzamento simultaneo, gli agenti visualizzeranno una chiamata risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di ricerca o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate non risposte nella cronologia chiamate se si riceve una risposta da un altro agente.
Seleziona ID chiamante
Panoramica
La funzione "Seleziona ID chiamante" consente agli utenti di passare tra diversi ID di linea chiamante per le chiamate esterne. Se abilitata dall'amministratore, gli utenti possono scegliere tra le seguenti opzioni per la propria identità di linea chiamante:
-
Numero utente ("Usa numero di telefono utente per identità linea chiamante")
-
CLID configurabile ("Usa CLID configurabile per identità linea di chiamata")
-
CLID gruppo ("Usa numero di telefono di gruppo/reparto per identità linea chiamante")
Funzionalità
Gli utenti dispongono di due metodi per modificare l'ID chiamante come predisposto dall'amministratore:
- Codici di accesso funzione (FAC): Codici specifici per ciascuna delle tre opzioni dell'ID chiamante.
- Interfaccia app Webex: Una vista intuitiva per l'utente all'interno delle app desktop e mobile Webex che visualizzano le opzioni dell'ID chiamante disponibili abilitate dall'amministratore, consentendo agli utenti di selezionare il proprio ID preferito.
Ulteriori funzioni
- Le app Webex includeranno anche opzioni per le code DNIS del call center.
- Gli utenti dell'app mobile avranno le opzioni Dual Persona disponibili per gli utenti di mobilità.
Precondizioni
Le seguenti condizioni devono essere soddisfatte sul server BroadWorks affinché l'utente possa controllare la sua scelta di criteri CLID esterni:
- Il flag di sistema "EnableUserSelectionOfExternalCLIDPolicy" è abilitato.
- L'ambito ID linea chiamata livello utente è impostato su "Usa criteri ID linea chiamata utente" per questo utente.
- Il flag "Consenti selezione utente di criteri di elaborazione delle chiamate a livello utente" è abilitato per l'utente.
- Se non viene definito alcun numero per le opzioni "Usa CLID configurabile per identità linea chiamante" o "Usa numero di telefono di gruppo/reparto per identità linea chiamante", i FAC o la visualizzazione dell'app non avranno effetto. Questa impostazione deve essere configurata dall'amministratore prima della selezione dell'utente.
Patch BroadWorks
Per il corretto funzionamento di questa funzione sono necessarie due patch BroadWorks specifiche:
Fare riferimento alla Sezione 8 Release Independent e Service Patch Information.
- BWKS-5230 era la funzione CLID selezionabile dall'utente originale: consente agli utenti (se il sistema è configurato correttamente) di modificare i criteri CLID applicabili. Vedere FD qui: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/UserSelectionOfExternalCallingLineIDOptionFD-R250.pdf
- BWKS-9510 è un miglioramento XSI richiesto dal team del client Webex per facilitare la individuazione delle opzioni disponibili per un utente. Questo è necessario perché la scelta dei criteri CLID non è una semplice funzione a livello utente (come CFA) che è direttamente controllabile. Piuttosto, dipende da varie opzioni di configurazione del sistema e dalla gerarchia dei "criteri di elaborazione delle chiamate". È possibile visualizzare i dettagli qui: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/XSIEnhancementToSupportUserSelectableCLIDFD-R250.pdf
Configurazione app Webex
Questi tag devono essere abilitati nelle configurazioni desktop, tablet e mobile:
<config> <servizi> <chiamate> <caller-id> <outgoing-calls enabled="%ENABLE_CLID_OUTGOING_CALLS_WXT%">
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni fissi. Questa specifica funzione consente di assegnare identificativi di linea condivisa all'app Webex dell'utente finale.
Questa funzione è utile agli utenti per gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
-
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
-
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
-
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
-
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente a linee condivise.
-
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise del client Webex
R23 senza ADP:
-
AP.as.23.0.1075.ap384179
-
AP.xsp.23.0.1075.ap384179
R23 con ADP:
-
AP.as.23.0.1075.ap384179
-
XSI-Azioni-23_2022.10
r24:
-
come: AP.as.24.0.944.ap384179
-
XSI-Azioni-24_2022.10
r25:
-
come: Versione RI Rel_2022.10_1.310
-
XSI-Azioni-25_2022.10
Patch 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo. Esempio: Per il client desktop: System>Modifica tipo di profilo di identità/dispositivo> Business Communicator - PC: Profilo, Opzioni standard, Numero di porte:
- SE è abilitata l'opzione 'Illimitato', non è richiesta alcuna modifica
- SE 'Limitato a' è <10, modificare il valore = 10 e salvarlo per utilizzare tutte le linee disponibili
-
Versione RI Rel_2022.10_1.310
Per dettagli sulla configurazione del client, vedere sezione 6.1.44 'Profilo principale' della Guida alla configurazione di Webex per Cisco BroadWorks.
Sincronizzazione Non disturbare (DND)
La sincronizzazione Non disturbare (DND) allinea le impostazioni DND tra Webex e BroadWorks sincronizzando lo stato Non disturbare tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato viene sincronizzato con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. In modo analogo, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist di una piattaforma non vengono riconosciuti dall'altra.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Se sono presenti molti clienti (>50) nel cluster BroadWorks, la sincronizzazione NoDist non è supportata. In tali casi, si consiglia di contattare un tecnico del supporto Cisco TAC per assistenza.
Prerequisiti
Accertarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione di BroadWorks.
Per la versione 23:
<frammento>
- App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
<frammento>
- App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 sul SA:
AS_CLI/System/ActivatableFeature> attiva 25433
Se sono presenti molti clienti (>50) nel cluster BroadWorks, operazioni come l'aggiornamento di azioni XSI, eventi XSI, URL DAS, URL XSP|ADP o sincronizzazione DND non sono supportate. In tali casi, si consiglia di contattare un tecnico del supporto Cisco TAC per assistenza.
Configurare la sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto eventi "come evento funzione". Per dettagli, vedi Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
-
Accedi a Partner Hub
-
Fare clic su Impostazioni.
-
Fai clic su Visualizza cluster e seleziona il cluster BroadWorks appropriato.
-
Abilita il tasto di alternanza di sincronizzazione Non disturbare (DND).
-
Inserisci il tuo ID utente BroadWorks e fai clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione DND. Se la convalida non riesce, il pulsante Salva viene disabilitato.
-
Se la convalida ha esito positivo, fai clic su Salva.
-
Una volta abilitata la sincronizzazione DND, Webex aggiorna tutti gli abbonamenti utente per includere il pacchetto per eventi Non disturbare. A seconda del numero di utenti, questo processo può richiedere alcune ore per il completamento.
-
L'abilitazione della sincronizzazione DND è un interruttore a una via. Una volta abilitata la funzione, non puoi disabilitarla da solo.
Abilita sincronizzazione DND (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per dettagli, vedi "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Orario di pausa
Nelle distribuzioni Webex per BroadWorks, la funzione "Orario di pausa" si basa sulla funzionalità "Sincronizzazione Non disturbare (DND)" per garantire che le impostazioni dell'orario di pausa siano sincronizzate su tutti i dispositivi. Per sincronizzare correttamente l'orario di pausa tra desktop e dispositivi mobili, assicurarsi che l'opzione 'Sincronizzazione NoDist' sia abilitata nell'account dell'utente.
Disabilita sincronizzazione DND
Non puoi disabilitare la sincronizzazione DND da solo. Per disabilitare la funzione, crea un caso BEMS tecnico con le seguenti informazioni:
-
Famiglia: Servizio Spark
-
Prodotto: Chiamata in Webex (Webex per BroadWorks)
-
Componente: WxBW - Provisioning
-
Il caso BEMS deve indicare che la sincronizzazione Non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterId BroadWorks.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione chiamata.
Modalità di registrazione |
Descrizione |
Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente |
La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
-
Per R22: AP.as.22.0.1123.ap377718
-
Per R23: AP.as.23.0.1075.ap377718
-
Per R24: AP.as.24.0.944.ap377718
L'Identificativo di correlazione chiamata deve essere attivato. Per dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione della chiamata su BroadWorks, vai alla Guida all'interfaccia di registrazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, vai all'articolo help.webex.com
Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla relativa piattaforma di registrazione chiamate di terze parti.
Abilitazione della casella vocale per l'integrazione di Microsoft Teams
È possibile abilitare la casella vocale per gli utenti Microsoft teams nella soluzione Webex per BroadWorks. Questa integrazione consente agli utenti di recuperare le caselle vocali direttamente attraverso Microsoft Teams, migliorando l'esperienza utente generale.
Procedura per abilitare la casella vocale
Per abilitare la casella vocale per BroadWorks, devi abilitare il tasto di alternanza broadworks-voicemail-enabled-spark-541886: true a livello di organizzazione.
Per abilitare questa funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Esperienza utente
Una volta impostata l'integrazione, gli utenti possono:
- Recupera le caselle vocali direttamente all'interno dell'applicazione Microsoft Teams.
- Ricevi notifiche per i nuovi messaggi vocali.
- Gestisci le impostazioni della casella vocale dall'interfaccia Webex.
Requisiti
Per supportare il recupero della casella vocale nell'integrazione Microsoft Teams con l'offerta Webex per BroadWorks, sono necessarie ulteriori modifiche di rete. I partner BroadWorks devono abilitare la condivisione risorse cross-origin (CORS) per i seguenti URL sulla relativa piattaforma BroadWorks:
- https://jabber-integration-a.wbx2.com/
- https://jabber-integration-r.wbx2.com/
- https://jabber-integration-k.wbx2.com/
- https://msteams-calling.webex.com/
Per ulteriori dettagli sulle fasi di configurazione, fare riferimento alla sezione 8.5.1.2 della Guida alla configurazione della piattaforma di consegna delle applicazioni BW, che richiede la versione 2024.05 sull'ADP.
Gruppo Parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione Parcheggio chiamata di gruppo e Retrieve. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono quindi essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti del retail in un'impostazione di store possono utilizzare la funzione per parcheggiare una chiamata che può essere selezionata da qualcuno in un altro reparto.
Operazione funzione
Una volta configurata la funzione
-
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nella relativa app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'interno all'utente per un periodo di 10 secondi.
-
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nella relativa app Webex. L'utente quindi inserisce l'interno della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per il funzionamento di questa funzione, verificare quanto segue:
-
Il file di configurazione del client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
-
L'identificativo di correlazione delle chiamate deve essere abilitato su AS e XSP|ADP. Per dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
-
L'SBC deve essere configurato per passare l'attributo SIP '
x-broadworks-correlation-in
' a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiunta di gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte 2. Devi creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Webex | Parcheggio e recupero delle chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzata
Il parcheggio chiamate regolari o dirette non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso alle funzioni:
-
Inserisci *68 per parcheggiare una chiamata
-
Inserisci *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato in ambienti di call center o in altre situazioni in cui può essere richiesta assistenza o intervento immediato.
Quando un servizio di inclusione è abilitato, un utente o un supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di pulsanti o tasti dedicata sul telefono o sul dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in diversi scenari. In un'impostazione di call center, i supervisori o i formatori possono monitorare e assistere i rappresentanti dell'assistenza clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire indicazioni o assumere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può accedere rapidamente alle conversazioni in corso per fornire assistenza o prendere decisioni importanti.
Nell'app Webex per Inclusione, viene inviata una notifica che indica che la chiamata viene trasformata in una conferenza. Non sono disponibili ulteriori informazioni in NOTIFY (info-chiamata o info-conferenza) qual è il tipo di conferenza, quindi possiamo trattarlo in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Sono introdotti i seguenti termini:
-
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore in genere ha la possibilità di monitorare e intervenire nelle chiamate dei clienti in corso. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire indicazioni agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può coinvolgere la formazione degli agenti, rispondere alle preoccupazioni dei clienti e ottimizzare le prestazioni del team.
-
Cliente: Un cliente si riferisce a una persona o entità che interagisce con una società o un'organizzazione per ottenere prodotti, servizi o supporto. Nel contesto dell'inclusione della chiamata, un cliente è qualcuno che effettua o riceve una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risoluzione di domande o problemi durante la chiamata. La funzione di inclusione della chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
-
Agente: Un agente, noto anche come rappresentante dell'assistenza clienti o agente di call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza tramite telefono o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare transazioni e offrire un'esperienza clienti positiva. Nel contesto dell'inclusione della chiamata, un agente è la persona che parla direttamente al cliente durante la telefonata. Se necessario, l'agente può ricevere istruzioni o feedback dal supervisore tramite l'inclusione delle chiamate.
Per qualsiasi richiesta avviata dal client come CallStartRequest, CallPickupRequest, DirectedCallPickupRequest, DirectedCallPickupWithBargeInRequest, ecc., se <Webex Client> (scegliere il nome corretto anziché il client Webex, se non è appropriato) viene fornito come dispositivo di visualizzazione della chiamata condivisa, la configurazione 'Avvisa tutti gli aspetti per le chiamate Click-to-Dial' deve essere abilitata nell'impostazione Identificativo chiamata condivisa affinché il client riceva una chiamata, a meno che la posizione non sia esplicitamente fornita dal client che avvia la richiesta.
Inoltro chiamata nativa mobile a riunione
L'escalation della chiamata nativa mobile a riunione è dotata di due funzioni univoche:
-
Nuova notifica push
Gli utenti mobili in una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando avvii una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si passa direttamente alla schermata durante la chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata tramite il controllo chiamate Cisco per le chiamate da cellulare, viene visualizzata la notifica Webex durante una chiamata da cellulare.
-
Trasferisci chiamata mobile nella riunione
Quando ci si trova nel mezzo di una chiamata con qualcuno, si consiglia di trasferire la chiamata in una riunione per utilizzare alcune funzioni avanzate per le riunioni come video, condivisione o lavagna. In alternativa, invita altre persone alla discussione e passa a una riunione.
Requisiti BroadWorks
-
Funzione attivabile 25239
-
R23 con XSP|ADP:
-
Patch AS AP.as.23.0.1075.ap383064
-
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
-
Patch AP.platform.23.0.1075.ap383064
-
-
R23 con ADP:
-
Patch AS AP.as.23.0.1075.ap383064
-
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e versione NPS > 2022.08_1.350
-
-
r24:
-
Patch AS: AP.as.24.0.944.ap383064
-
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e versione NPS > 2022.08_1.350
-
-
r25:
-
Versione RI Rel_2022.08_1.354
-
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e versione NPS > 2022.08_1.350
-
Configurazione chiamata URI per supportare il trasferimento di una chiamata nella riunione
Criteri di composizione Url NS
Definisci regola per l'indirizzamento di (.*)webex.com attraverso I-SBC
NS_CLI/Policy/UrlDialing> ottieni criteri WebexMeetings: Istanza chiamata URL: Webex unknownSipURIHandling = reject disableSubscriberLookup = true Abilita = true CallTypes: Selezione = {ALL} Da = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP} lineportOnly = false enableSipURIMatchingRules = true NS_CLI/Policy/UrlDialing/Rules> ottieni criteri WebexMeetings: Istanza chiamata URL: Tabella WebexCalling: Instradamento schema ID regolePeso costo dtg =================================================================== 1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> ottieni elemento di rete WebexMeetings Posizione = 1281465 Centro dati = Costo statico = 1 Peso statico = 99 Sondaggio = falso OpState = stato abilitato = Profilo onLine = NIL_PROFILE Ricerca remota abilitata = falso Attributi di segnalazione = NS_CLI/System/Device/RoutingNE/Address> ottieni WebexMeetings indirizzamento NE indirizzo Peso costo Percorso trasporto porta ===================================================================== WebexMeetings sbc-address 1 99 - non specificato
Profilo di indirizzamento NS
Istanza criteri di UrlDialing aggiunta ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> ottieni il profilo MyInst: Istanza criteri Webex ========================================== … ComposizioneUrl WebexMeetings
Utilizzo NS Route per chiamata NetworkURL
Consentire al AS di rispettare l'indirizzamento NS in modalità AS ibrido
AS_CLI/Interface/IMS> imposta queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un punto di risposta per la sicurezza pubblica (PSAP, Public Safety Answering Point) che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, devi integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Utilizza i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
-
-
Banda
-
Intrado
-
RedSky
-
Personalizzazione e provisioning dei client
Gli utenti scaricano e installano le proprie app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedi Piattaforme di app Webex). Una volta eseguita l'autenticazione, il client si registra su Webex Cloud per messaggi e riunioni, recupera le relative informazioni di branding, rileva le relative informazioni sul servizio BroadWorks e scarica la configurazione di chiamata dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
I parametri di chiamata per le app Webex vengono configurati in BroadWorks (come di consueto). È possibile configurare branding, messaggistica e parametri di riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta di modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
-
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Preparazione dell'ambiente).
-
Verificare di disporre dei set di tag corretti in Sistema BroadWorks > Risorse > Set di tag di gestione dispositivi.
-
Per ciascun client che stai predisponendo:
-
Scaricare ed estrarre il file zip DTAF per il client specifico.
-
Importa file DTAF in BroadWorks su Sistema > Risorse > Tipi di profilo identità/dispositivo
-
Apri il profilo dispositivo appena aggiunto per la modifica e:
-
Inserire il nome di dominio completo (FQDN) dell'azienda agricola XSP|ADP e il protocollo di accesso dispositivo.
-
Selezionare la casella di controllo Supporta info parte remota. Questo supporto è richiesto per il funzionamento della condivisione del desktop.
È inoltre possibile abilitare il supporto della parte remota eseguendo il seguente comando CLI sul server applicazioni:
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
-
-
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
-
Salvare il profilo.
-
-
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome |
Descrizione |
Priorità codec |
Configura ordine di priorità per codec audio e video per chiamate VoIP |
TCP, UDP e TLS |
Configurare i protocolli utilizzati per la segnalazione SIP e il contenuto multimediale |
Porte audio e video RTP |
Configura intervalli di porte per audio e video RTP |
Opzioni SIP |
Configurare diverse opzioni correlate a SIP (INFO SIP, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
-
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti che il partner gestisce. Vedi Configurazione delle personalizzazioni di branding avanzate.
-
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi il branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client.
Personalizzazione degli URL di segnalazione problemi e della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito di feedback e assistenza", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con provisioning a flusso costante
Prima di eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 |
Assegna servizio in BroadWorks: |
2 |
Verifica organizzazione cliente e utenti in Control Hub: |
Test utente
1 |
Scarica l'app Webex su due macchine diverse. |
2 |
Eseguire l'accesso come test degli utenti sulle due macchine. |
3 |
Effettuare chiamate di prova. |
Gestione di Webex per BroadWorks
Pre provisioning organizzazioni clienti
Nel modello corrente, viene eseguito automaticamente il provisioning dell'organizzazione del cliente quando si onboard il primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguita una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
-
Usa API per creare account Webex
-
Assegnare i messaggi e-mail integrati IM&P (provisioning flow) con e-mail affidabili per la creazione di account Webex
-
Assegna IM&P integrato (provisioning FLOW) senza messaggi e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per la creazione di account Webex
-
Consenti agli utenti l'attivazione autonoma (inviando loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex sono esposti API pubbliche per consentire ai provider di servizi di integrare Webex per il provisioning del sottoscrittore Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. La specifica per queste API è disponibile developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti Wholesale verranno rifiutati da queste API.
Provisioning Flow
Su BroadWorks, è possibile fornire agli utenti l'opzione Abilita IM integrato&P. Questa azione causa il provisioning dell'adattatore BroadWorks per rendere chiamata API di eseguire il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile retrocompatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica di codice, ma solo una modifica di configurazione all'endpoint API per l'adattatore di provisioning.
La fornitura del sottoscrittore su Webex può richiedere una notevole quantità di tempo (diversi minuti per l'utente iniziale in un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il completamento del provisioning di flusso indica che il provisioning è stato avviato. Non indica il completamento.
Per verificare che gli utenti e l'organizzazione del cliente siano completamente predisposti su Webex, è necessario accedere a Partner Hub e ricercare l'elenco dei clienti.
Gli utenti trunking BroadWorks possono disporre di Webex per BroadWorks tramite un aspetto di chiamata condivisa (SCA). All'utente del trunking deve essere assegnato il servizio di autenticazione. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto SCA Webex dall'autenticazione trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con funzioni di elenco di indirizzamento o di indirizzamento diretto assegnate.
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata modello di onboarding.
Attivazione automatica utente
Per fornire gli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
-
Accedi a Partner Hub e trova la pagina Elenco clienti .
-
Fare clic su View Templates (Visualizzamodelli).
-
Seleziona il modello di Onboarding di provisioning da applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non è nel sistema BroadWorks associato a questo modello, l'utente non può attivare automaticamente con il collegamento.
-
Copiare il collegamento per il provisioning e inviarlo all'utente.
È possibile anche includere il collegamento di download del software e ricordare all'utente che deve fornire e convalidare il relativo indirizzo e-mail per attivare l'account Webex.
-
È possibile monitorare lo stato di attivazione dell'utente sul modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi diattivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli nella vista Stato utente che consentono agli amministratori di Cisco BroadWorks provider di servizi di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Spostamento degli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a ... |
Segui questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (ad esempio, account gratuito, account di prova) |
|
Organizzazione cliente |
Allega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge anche Webex per BroadWorks agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a ... |
Segui questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (ad esempio, account gratuito, account di prova) |
Se l'organizzazione Webex per BroadWorks non esiste (non viene eseguito il provisioning di alcun utente):
Se esiste un'organizzazione Webex per BroadWorks (viene eseguito il provisioning di almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di iscrizione autonoma (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
-
Trasferisci utente (con e-mail attendibile): utilizza il provisioning con e-mail attendibili
-
Trasferisci utente (con e-mail non attendibile): utilizza il provisioning con e-mail non attendibili
-
Attivazione automatica
Se l'organizzazione Webex per Cisco BroadWorks non è ancora stata creata (non è stato eseguito il provisioning di alcun utente), seguire i normali processi di provisioning ( Provisioning utenti) per creare l'organizzazione e aggiungere il primo utente come utente di amministrazione. Una volta eseguito il provisioning del primo utente nell'organizzazione, seguire i metodi basati sul consenso in questa procedura per spostare gli utenti successivi.
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Activate Account (Attivaaccount). L'utente viene reindirizzato al portale consumer Webex.
-
L'utente accede a Webex.
-
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza e-mail non attendibili, è necessario convalidare prima l'indirizzo e-mail dell'utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito automaticamente sul bridge di provisioning BroadWorks.
-
All'utente viene inviato un testo con un collegamento di attivazione.
-
-
L'utente fa clic sul collegamento Attivazione e inserisce il relativo indirizzo e-mail.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Partecipaora.
-
Indirizzo e-mail convalidato.
-
L'utente viene reindirizzato per accedere al portale Webex Consumer.
-
-
L'utente accede a Webex.
-
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Flusso di attivazione automatica
Se l'utente dispone di un account BroadWorks esistente, potrà utilizzare il processo di attivazione automatica per spostare l'account.
-
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
-
L'utente inserisce il relativo indirizzo e-mail.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
Viene inviato un messaggio e-mail automatico all'indirizzo e-mail dell'utente.
-
-
L'utente apre il messaggio e-mail e fa clic sul collegamento Partecipa ora, che convalida l'indirizzo e-mail.
-
CI ha rilevato che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di continuare.
-
L'utente viene reindirizzato per accedere a Webex.
-
-
L'utente accede al portale consumer.
-
L'utente fa clic su Delete Account (Eliminaaccount).
-
L'account Webex precedente viene eliminato.
-
L'utente ha predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
Allega Webex per BroadWorks all'organizzazione esistente
Se si è un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, non ancora associata a un'azienda BroadWorks gestita da partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso dell'amministratore affinché la richiesta di provisioning venga eseguita correttamente.
L'approvazione dell'amministratore dell'organizzazione è necessaria se è vera una delle seguenti condizioni:
-
L'organizzazione del cliente esistente dispone di 100 utenti o più
-
L'organizzazione dispone di un dominio e-mail verificato
-
Dominio organizzazione richiesto
Se nessuno dei criteri precedenti è vero, si può verificare un collegamento automatico.
In uno scenario di Allegato automatico , un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner vengono riconosciuti diritti di amministratore di provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà impostato un amministratore completo.
Con l'accesso amministratore di provisioning, si avrà visibilità limitata in Control Hub agli utenti dell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione.
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che l'opzione Consenti inviti e-mail amministratore al momento del collegamento a organizzazioni esistenti (il tasto di alternanza è attivato per impostazione predefinita).
1 |
L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedi Provisioning organizzazioni clienti. Si verifica quanto segue:
Supponi che l'amministratore del cliente non riceva un messaggio e-mail. In tal caso, l'amministratore del cliente può aggiungere manualmente l'amministratore del partner (specificato nel modello) come amministratore esterno dell'organizzazione cliente da Control Hub. Quindi, riprovare a eseguire il provisioning dell'utente per attivare il provisioning del cliente Webex per Cisco BroadWorks. |
2 |
Con l'accesso di amministratore completo , l'amministratore partner può completare il processo di provisioning del cliente. Dovrai tentare di nuovo il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora in qualità di amministratore completo esterno, non è necessario osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione del cliente esistente sarà visibile come cliente sotto l'organizzazione partner Webex per BroadWorks. Il nome dell'organizzazione allegata non cambierà in nome aziendale BroadWorks. Il nome dell'organizzazione allegata rimarrà uguale a quello precedente al processo di allegazione. |
Condizioni dell'allegato organizzazione
-
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione cliente di destinazione. Altrimenti, verrà creata una nuova organizzazione cliente.
-
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
-
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato nel modello di provisioning Webex per BroadWorks. Di conseguenza, non sono state apportate modifiche alla modalità di accesso degli utenti esistenti.
-
Tuttavia, se l'organizzazione del cliente esistente ha abilitato il branding base, una volta eseguito l'allegato, le impostazioni di branding avanzato del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
-
-
Il nome dell'organizzazione esistente non cambierà.
-
Nessuna modifica all'impostazione del flag di eliminazione e-mail nelle impostazioni dell'organizzazione esistente. Ciò potrebbe incidere sugli utenti predisposti di recente. A seconda di come è impostato il flag, i nuovi utenti possono ricevere o meno un messaggio e-mail con un codice che deve essere inserito per completare l'attivazione.
-
La modalità di amministrazione con limitazioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
-
Assicurati di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
-
È possibile associare un'azienda BroadWorks a una sola organizzazione Webex. Non è possibile eseguire il provisioning degli abbonati di una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com .
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo.
L'indirizzo e-mail che l'amministratore dell'organizzazione cliente aggiunge come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore del partner come configurato nel modello di onboarding su Partner Hub.
Dopo aver aggiunto l'e-mail dal modello di onboarding su Partner Hub come amministratore completo, qualsiasi altro amministratore partner dovrà essere aggiunto come amministratore esterno con diritti di amministratore completo.
Scollegare Webex per BroadWorks dall'organizzazione esistente
Segui questa procedura per deviare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato Webex per BroadWorks a un'organizzazione esistente per errore e si desidera rimuovere l'allegato.
Nel flusso standard, la disconnessione di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati.
-
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso amministratore esterno seguendo l'opzione Approva richiesta amministratore esterno.
-
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi un'area di lavoro BroadWorks .
-
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi un abbonato BroadWorks .
-
Rimuovere gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se è stato eseguito il provisioning degli utenti tramite il flusso e-mail non attendibili e non sono stati ancora inseriti messaggi e-mail validi, gli utenti vengono lasciati in sospeso. Segui Verifica provisioning utente con messaggi e-mail non attendibili per eliminare gli utenti.
-
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Ibrido, nella sezione BroadWorks Calling , elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera allegare Webex per BroadWorks al cliente, seguire i processi di provisioning per il collegamento a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API Rimuovi un abbonato BroadWorks consiste nell'accedere a BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati.
Gestisci utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente vengono tenuti in BroadWorks. Un'identità e-mail distinta per l'utente e relative licenze per le funzioni Webex sono tenute in Webex.
Verifica del provisioning utenti con indirizzi e-mail non attendibili
Se si sta predis facendo il provisioning di Webex per utenti BroadWorks utilizzando il provisioning flow-through con messaggi e-mail non attendibili, gli utenti devono autoproducersi inserendo il proprio indirizzo e-mail nel portale di attivazione utenti. Se l'utente rileva un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riconorà l'errore, l'amministratore può utilizzare la procedura seguente in Partner Hub per esaminare lo stato e onboardre l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 |
Accedi a Partner Hub e trova la pagina Elenco clienti . |
2 |
Fare clic su View Templates (Visualizzamodelli). Seleziona il modello di onboarding appropriato da applicare a questo utente. |
3 |
In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con messaggi e-mail non attendibili sia configurato correttamente:
|
4 |
Dopo il provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato di provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo Stato corrente, che mostra se l'utente è stato predisposto o se è presente un requisito in sospeso.
|
5 |
Per gli utenti con errori o requisiti in sospeso, fare clic sui tre puntini a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili durante la visualizzazione dell'elenco di utenti:
-
Esporta: fai clic su questo pulsante se desideri esportare l'elenco utenti in un file CSV.
-
Escludi utenti di cui è stato eseguito il provisioning: abilitare questo tasto di alternanza se si desidera visualizzare solo gli utenti con requisiti in sospeso o errori.
Modifica ID utente o indirizzo e-mail
Modifiche dell'ID utente e dell'indirizzo e-mail
ID e-mail e ID alternativo sono attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. Nella tabella seguente vengono descritti gli scopi di questi diversi attributi e le operazioni da eseguire per modificarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non è possibile modificare questo identificativo e collegare comunque l'utente allo stesso account in Webex. È possibile eliminare l'utente e crearla nuovamente se è errata. |
ID e-mail | ID utente |
Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si asserzione di attendibilità dell'e-mail Non richiesto in BroadWorks se non si asserzione di affidabilità dei messaggi e-mail Non richiesto in BroadWorks se si consente agli abbonati di attivare automaticamente |
Se l'utente è predisposto con l'indirizzo e-mail errato, è necessario effettuare un processo manuale per modificare questa impostazione in entrambi i punti:
Non modificare l'ID utente BroadWorks. Operazione non supportata. |
ID alternativo | Nessuno | Abilita autorizzazione utente, tramite e-mail e password, a fronte dell'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti devono immettere il relativo ID utente BroadWorks durante l'autenticazione. |
Modifica del pacchetto utente nell'hub partner
1 |
Accedere all'hub partner e fare clic su Clienti. |
2 |
Individuare e selezionare l'organizzazione del cliente in cui si trova l'utente. La pagina di panoramica dell'organizzazione viene visualizzata in un pannello a destra dello schermo. |
3 |
Fare clic su View Customer (Visualizzacliente). L'organizzazione del cliente viene aperta in Control Hub, che mostra la pagina Panoramica.
|
4 |
Fare clic suUtenti, quindi individuare e fare clic sull'utente interessato. |
5 |
In Servizi dell'utente, fare clicsu Webex per pacchetti BroadWorks (Sottoscrizioni). Viene visualizzato il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 |
Nella scheda Profilo , ricercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 |
Selezionare il pacchetto che si desidera per questo utente (Base, Standard, Premium o Softphone) e fare clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 |
È possibile chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium dispongono di siti per riunioni distinti associati a ciascun pacchetto. Se un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato visualizza due siti per riunioni in Control Hub. Le funzionalità di riunione e il sito della riunione dell'abbonato si allineano al pacchetto corrente. Il sito per riunioni del pacchetto precedente e tutto il contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili ad Amministrazione sito riunione.
Potrebbero essere necessario da due a tre ore per le PMR di aggiornamento che sono risultate da una modifica del pacchetto all'aggiornamento.
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si intende eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto il trasferimento automatico del ruolo di amministratore nel caso in cui l'ultimo amministratore venga eliminato.
Webex per API Cisco BroadWorks
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
-
Eseguire la richiesta di rimozione dell'API di un abbonato BroadWorks su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento a Webex per Cisco BroadWorks. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
Eseguire la richiesta DI ELIMINAZIONE DI una persona su per eliminare completamente https://developer.webex.com/docs/api/v1/people/delete-a-person l'utente.
Flow-through Provisioning
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
-
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – PAGINA IM&P integrata su BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento a Webex per Cisco BroadWorks dall'utente. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori dei clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla relativa organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 |
Usa le API Persone per eliminare tutti gli utenti dall'organizzazione: Rimozione di un'API abbonato BroadWorks rimuove i diritti Webex per Cisco BroadWorks da un utente, ma non elimina l'utente. |
2 |
Se la sincronizzazione delle rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione delle rubriche tramite Partner Hub: Per disabilitare la sincronizzazione delle directory tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API BroadWorks Enterprise e disabilita l'impostazione enableDirSync . Tutti gli utenti correlati alla sincronizzazione delle rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione di utenti (utilizzando uno dei metodi) può richiedere del tempo in base alla quantità di utenti. |
3 |
Una volta rimossi tutti gli utenti, utilizzare l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Annullamento di un abbonamento da Control Hub
Poiché l'API è privata, i clienti non potranno accedervi. Al contrario, la seguente procedura mostra come i clienti possono annullare il proprio abbonamento da Control Hub:
-
L'amministratore del partner può passare alla pagina dei servizi "Ibridi" in Control Hub del cliente.
-
Individuare la scheda "BroadWorks Calling".
-
Una volta eseguito il provisioning di tutti gli utenti da Webex per BroadWorks per tale cliente, il partner visualizza un pulsante per "Cancella configurazione" (ad esempio, elimina la relativa customer_config voce in BPB).
Gestione release
I controlli di gestione delle release in Partner Hub consentono ai provider di servizi Cisco BroadWorks di gestire le release fornendo loro la possibilità di controllare la data di rilascio in base alla quale le app Webex degli utenti ese upgrade all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza aggiornamenti Automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
-
Configura pianificazioni di rilascio personalizzate con differimenti dalla pianificazione di rilascio predefinita di Cisco
-
Configurare una pianificazione a singola release e una propagazione a catena tale pianificazione per tutte le organizzazioni dei clienti che gestiscono
-
Assegna diverse pianificazioni di release a diverse organizzazioni cliente
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di release personalizzate, vedi l'articolo di Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
-
Aggiunta di un cluster BroadWorks in Hub partner
-
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
-
Aggiungi un modello di onboarding in Partner Hub
-
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su |
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. |
3 |
Fare clic su View Clusters (Visualizzacluster). |
4 |
Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro a destra.
|
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su | |||||||||
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. | |||||||||
3 |
Fare clic su View Templates (Visualizzamodelli). | |||||||||
4 |
Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere Assistente Webex follow-up su attività, prendere nota di importanti decisioni ed evidenziare momenti chiave durante una riunione o un evento.
Assistente Webex per Meetings è disponibile gratuitamente per i siti di riunione Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilita Webex Assistant per le riunioni
Assistente Webex è abilitato per impostazione predefinita per i clienti BroadWorks dei pacchetti standard e premium.
Gli amministratori partner e gli amministratori dell'organizzazione cliente possono disabilitare la funzione per le organizzazioni cliente attraverso Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
-
Il supporto è limitato a pacchetti Premium e Standard e solo a sale riunioni personali.
-
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
-
La condivisione del contenuto tramite e-mail è accessibile solo agli utenti all'interno della tua organizzazione
-
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Anche il contenuto della riunione non è accessibile quando è condiviso tra utenti di pacchetti diversi all'interno della stessa organizzazione.
-
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
-
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile e pertanto le trascrizioni post-riunione non sono disponibili indipendentemente dal fatto che Webex Assistant sia abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni sull'uso della funzione, vedere uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
La chiamata Webex gratuita è abilitata per impostazione predefinita, consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, disabilitando tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzioni
Se Webex Calling è disabilitato, si applicano le seguenti condizioni a Webex per gli utenti Cisco BroadWorks:
-
Gli utenti non visualizzano più Chiama con Webex come opzione di chiamata selezionabile sull'app Webex.
-
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per utenti Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, Cronologia chiamate, Contatti, inserendo l'URI o l'indirizzo e-mail dell'altro utente nella barra di ricerca.
-
La condivisione dello schermo funziona all'interno di una chiamata BroadWorks.
-
Le riunioni Webex e la presenza di telefonia continuano a funzionare anche se le chiamate Webex sono disabilitate.
Disabilita Webex Calls (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno della procedura guidata Aggiungi nuovo modello . Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti che assegni al modello.
Per dettagli sulla configurazione di un nuovo modello di onboarding, vedi Configurazione dell'organizzazione partner in Partner Hub.
Disabilita Webex Calls (modello di onboarding esistente)
Segui questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
-
Accedi a Partner Hub all'indirizzo admin.webex.com.
-
Scegliere Impostazioni.
-
Fare clic su Visualizza modello e scegliere il modello di onboarding appropriato.
-
Fai clic su Disabilita chiamata gratuita Cisco Webex.
-
Fare clic su Salva.
Disabilita Webex Calls (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare le chiamate Webex per un utente esistente, puoi seguire una delle procedure seguenti per aggiornare l'utente.
Accertati di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigurerà l'utente con le chiamate Webex abilitate.
Se si sta utilizzando il provisioning flow-through, è possibile effettuare le seguenti operazioni:
-
Aprire CommPilot e andare alla configurazione utente.
-
Rimuovere il servizio IM+P integrato dall'utente e fare clic su OK.
-
Aggiungere il servizio IM+P integrato all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
-
Utilizzare Rimuovi un'API abbonato BroadWorks per eliminare l'utente.
-
Utilizzare Esegui provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione del video o della condivisione dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per i dettagli e le opzioni di configurazione completi, vedi Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è inoltre possibile configurare se il contenuto multimediale per le chiamate in ingresso utilizza per impostazione predefinita solo video o audio.
Indicatore di stato della linea/Notifica risposta per assente
La funzione Indicatore di stato/Notifica risposta per assente utilizza le funzioni Indicatore di stato e Risposta per assente indirizzata. Un utente di indicatori di stato riceve una notifica audio e visiva sull'app Webex quando un utente dall'elenco monitorato di indicatori di stato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può ignorare o rispondere alla chiamata dell'utente monitorato.
La notifica di risposta per assente (BLF) è utile in situazioni in cui un utente deve rispondere alle chiamate per altri membri di team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra multi-chiamata - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza di membri del team Webex e non Webex. Per informazioni sull'abilitazione della chiamata multipla, vedere: Finestra multi-chiamata
I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati con la rubrica in Webex e disporranno solo degli stati "sconosciuti" e "in chiamata" (lo stato di suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
-
La presenza non è supportata per utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
-
Gli utenti CI senza autorizzazione cloud Webex o il tipo di account macchina (spazi di lavoro) mostrano solo la presenza 'in chiamata' e 'sconosciuta'. Nessuno stato attivo, suoneria, eccetera.
-
Gli utenti non Webex presenti nell'elenco di monitoraggio degli indicatori di stato che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza 'sconosciuta'.
-
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
-
Se un utente non Webex dell'indicatore di stato mette in attesa una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate a BroadWorks. Installare solo le patch che si applicano alla versione in uso:
Per R22:
-
AP.platform.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382362
-
AP.xsp.22.0.1123.ap382053
-
AP.xsp.22.0.1123.ap382362
-
AP.as.22.0.1123.ap383459
-
AP.as.22.0.1123.ap383520
Per R23:
-
AP.platform.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382362
-
AP.as.23.0.1075.ap383459
-
AP.as.23.0.1075.ap383520
-
Se si utilizza XSP|ADP:
-
AP.xsp.23.0.1075.ap382053
-
AP.xsp.23.0.1075.ap382362
-
-
Se stai utilizzando ADP:
-
XSI-Actions-23_2022.01_1.200.bwar
-
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
-
Per R24:
-
AP.as.24.0.944.ap382053
-
AP.as.24.0.944.ap382362
-
AP.as.24.0.944.ap383459
-
AP.as.24.0.944. ap383520
-
XSI-Actions-24_2022.01_1.200.bwar
-
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
-
<indicatore di stato abilitato="%ENABLE_BUSY_LAMP_FIELD_WXT%">
-
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
-
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare il Meccanismo Xsi Avanzato 101642 Per Telefonia team sul AS:
AS_CLI/System/ActivatableFeature> attivare 101642
Abilitare X-BroadWorks-Remote-Party-Info
sul server AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamate SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
Verifica che i seguenti servizi siano assegnati agli utenti:
-
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
-
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione dell'indicatore di stato della linea su BroadWorks
Per impostare l'indicatore di stato della linea per un utente, gli amministratori dei partner possono utilizzare la procedura seguente.
-
Accedi a BroadWorks CommPilot.
-
Per un utente selezionato, andare ad Applicazioni client e configurare l'indicatore di stato della linea.
-
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
-
Utilizzare i parametri di ricerca per individuare e aggiungere gli utenti all'elenco Utenti monitorati .
-
Fare clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento facile da utilizzare per il coinvolgimento del pubblico. Consente alle persone di ottenere il massimo dalle riunioni colmando la differenza tra gli oratori e i partecipanti. Se Slido questa funzione è integrata nell'organizzazione Control Hub, gli utenti possono aggiungere l'app Slido alle relative riunioni nell'app Webex. Questa integrazione aggiunge funzionalità Q&A di sondaggi e di sondaggi aggiuntivi alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando si accetta una riunione nel client Outlook che sia un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che si è altrimenti coinvolti e che una risposta potrebbe essere ritardata.
Per abilitare questa funzione:
-
passare alla scheda Generale della scheda Impostazioni su Windows o Preferenze su Mac.
-
Selezionare la casella Mostra se presente in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, l'opzione "In una riunione di calendario" in Webex viene associata a "Occupato" in Outlook.
Avvertenza
Per il funzionamento di questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come lavorando altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra quando presente in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la presenza di tale utente non verrà aggiornata finché non termina la riunione. Questa operazione richiederà un riavvio del client per rispondere.
Risposta automatica con segnale acustico
Con la risposta automatica con segnale acustico, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul proprio desktop. Quando l'app Webex squilla sull'interlocutore, l'utente sente un determinato tono per avvisarlo che la chiamata è connessa.
Affinché un utente Webex per Cisco BroadWorks utilizzi questa funzione:
-
La funzione è supportata solo sull'identificativo di linea principale
-
L'app Webex deve essere l'identificativo di linea principale
-
Il %ENABLE_AUTO_ANSWER_WXT% tag deve essere abilitato
Se l'utente ha anche indicatori di chiamata condivisa (ad esempio, un telefono della scrivania è configurato come uno degli indicatori di linea secondari), la funzione è ancora supportata sull'identificativo principale a condizione che gli indicatori di chiamata condivisa non siano configurati per ricevere le chiamate in arrivo. Questa operazione può essere eseguita configurando una delle tre condizioni seguenti su BroadWorks per tutti gli aspetti di chiamata condivisa:
-
L'opzione Avvisa tutte le apparenze per le chiamate Click-to-Dial è disabilitata nella configurazione dell'Aspetto chiamata condivisa: questo è l'approccio consigliato
o
-
L'opzione Consenti terminazione a questa posizione deve essere disabilitata per tutti gli indicatori di chiamata condivisa o
o
-
Posizioni disabilitate per tutti gli indicatori di chiamata condivisa
Aumento della capacità
Aziende XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare il numero di risorse ADP XSP|aggiuntive necessarie per l'aumento proposto del numero di abbonati. Per uno dei server NPS dedicati o dedicati a Webex per Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
-
Ridimensiona azienda agricola dedicata: Aggiungere uno o più server ADP XSP| all'azienda agricola che richiede capacità aggiuntiva. Installare e attivare la stessa serie di applicazioni e configurazioni dei nodi esistenti del sistema.
-
Aggiungi azienda agricola dedicata: Aggiungi un nuovo farm ADP XSP|dedicato. Sarà necessario creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti sul nuovo registro, per esitare gli utenti a essere presenti nell'hub esistente.
-
Aggiungi azienda agricola specializzata: Se si verificano strozzature per un determinato servizio, si consiglia di creare un'azienda XSP|ADP separata a tale scopo, tenendo in considerazione i requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster Control Hub e le voci DNS se si modifica l'URL del servizio con un nuovo registro.
In tutti i casi, il monitoraggio e la risorsa dell'ambiente BroadWorks è di responsabilità. Se si desidera coinvolgere l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare servizi professionali.
Gestione dei certificati del server HTTP
Devi gestire questi certificati per le applicazioni Web autenticate mTLS sulle tue ADP XSP|:
-
Certificato di catena di fiducia del cloud Webex
-
Certificati delle interfacce server HTTP di|ADP XSP
Catena di fiducia
È possibile scaricare il certificato di catena di attendibilità da Control Hub e installarlo sugli ADP XSP| durante la configurazione iniziale. Si prevede di aggiornare il certificato prima della scadenza e di notificare come e quando modificarlo.
Interfacce server HTTP
L'ADP XSP| deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Ordina certificati. Quando si protegge per la prima volta l'interfaccia, viene generato un certificato autofirmato. Questo certificato è valido per un anno a partire da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione Partner Hub che gli amministratori partner possono assegnare a specifiche organizzazioni clienti per limitare le impostazioni dell'organizzazione che gli amministratori clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione cliente, tutti gli amministratori dei clienti di tale organizzazione, indipendentemente dai diritti di ruolo, non possono accedere a una serie di controlli limitati in Control Hub. Solo un amministratore partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner non è un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita i diritti di ruolo specifici per gli amministratori dei clienti nell'organizzazione a cui viene applicata l'impostazione.
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità Con limitazioni del partner. Dopo l'accesso, verrà visualizzato un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner informa l'amministratore del cliente che la modalità con limitazioni è abilitata e che potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore di clienti in un'organizzazione in cui è abilitata l'opzione Con limitazioni della modalità partner, il livello di accesso a Control Hub è determinato con la formula seguente:
(Accesso Control Hub) = (Diritti ruolo organizzazione) - (Limitati dalle limitazioni della modalità partner)
Gli amministratori dei clienti subiranno diverse limitazioni, indipendentemente dalla modalità con limitazioni da parte del partner. Tali limitazioni includono:
- Impostazioni chiamata: Le impostazioni 'Priorità chiamata Opzioni app' nel menu Chiamata sono di sola lettura.
- Impostazione posizione: L'impostazione della chiamata in seguito alla creazione della posizione verrà nascosta.
- Gestione PSTN e registrazione chiamate: Queste opzioni saranno in grigio per la posizione.
- Gestione numeri di telefono: Nel menu Chiamata, la gestione dei numeri di telefono è disabilitata e le impostazioni 'Priorità chiamata opzioni app' nonché le registrazioni delle chiamate sono di sola lettura.
Limitazioni
Quando la modalità con limitazioni del partner è abilitata per un'organizzazione del cliente, gli amministratori dei clienti in tale organizzazione non possono accedere alle seguenti impostazioni di Control Hub:
-
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
-
Il pulsante Gestisci utenti è disattivato.
-
Aggiunta o modifica manuale utenti: nessuna opzione per aggiungere o modificare gli utenti, manualmente o tramite CSV.
-
Richiedi utenti—non disponibile
-
Assegna automaticamente licenze: non disponibili
-
Sincronizzazione rubriche: impossibile modificare le impostazioni di sincronizzazione rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
-
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato e indirizzo e-mail principale* sono modificabili.
-
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
-
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, Messaggi, Riunioni, Chiamata)
-
Visualizzazione dello stato dei servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
-
Numero ufficio principale: questo campo è di sola lettura.
-
-
Nella vista Account, non sono disponibili le seguenti impostazioni:
-
Nome società di sola lettura.
-
-
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
-
Dominio: l'accesso è di sola lettura.
-
E-mail: le impostazioni Elimina invito e-mail amministratore e Selezione locale e-mail sono di sola lettura.
-
Autenticazione: nessuna opzione per modificare le impostazioni di autenticazione e SSO.
-
-
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
-
Impostazioni chiamata: le impostazioni di Priorità chiamata opzioni app sono di sola lettura.
-
Funzionamento chiamata: le impostazioni sono di sola lettura.
-
Posizione > PSTN: le opzioni gateway locale e Cisco PSTN sono nascoste.
-
-
In SERVIZI, le opzioni di servizio Migrazioni e Connected UC sono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori dei partner possono utilizzare la procedura seguente per abilitare l'opzione Con limitazioni della modalità partner per una determinata organizzazione cliente (l'impostazione predefinita è abilitata).
-
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
-
Selezionare l'organizzazione del cliente applicabile.
-
Nella vista delle impostazioni a destra, abilitare l'interruttore Limitato dalla modalità partner per attivare l'impostazione.
Se si desidera disattivare Limitazione della modalità partner, disabilitare l'interruttore.
Se il partner rimuove la modalità di amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà effettuare le seguenti operazioni:
-
Aggiungi utenti Webex per Wholesale (con il pulsante)
-
Modifica pacchetti per un utente
Per ulteriori informazioni sull'elenco dei fusi orari supportati per il provisioning Wholesale, vedere Elenco dei fusi orari supportati per il provisioning Wholesale.
Analisi partner
I miglioramenti apportati a Control Hub rendono semplice agli amministratori dei partner visualizzare e aggiornare le informazioni del pacchetto per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata tra tutti i clienti e include i seguenti dettagli:
-
Totale utenti per pacchetto (Softphone, Basic, Standard, Premium)
-
Tendenza utenti per pacchetto (giornaliera/settimanale/mensile)
-
Clienti con n. di pacchetti assegnati
Per dettagli completi sull'uso della funzionalità di analisi dei partner, vedere l'articolo Webex Analytics per Webex per i pacchetti Eseeme e Webex per pacchetti Broadworks in Partner Hub.
API report di fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per i report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare i report di fatturazione. Nella tabella riportata di seguito vengono elencate le API, il tipo di accesso richiesto e i requisiti del ruolo.
API di fatturazione |
Scopo |
Tipo di accesso |
Requisito del ruolo per API (l'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Crea un report di fatturazione BroadWorks |
Utilizzato per generare un report di fatturazione. |
Accesso di scrittura |
|
Elenca report di fatturazione BroadWorks |
Utilizzato per elencare i report disponibili per la visualizzazione. |
Accesso di lettura |
|
Come ottenere un report di fatturazione BroadWorks |
Utilizzato per ottenere una copia di un report generato. |
Accesso di lettura |
|
Eliminazione di un report di fatturazione BroadWorks |
Utilizzato per eliminare un report generato. |
Accesso di scrittura |
|
Campi di fatturazione
Nella tabella seguente vengono elencati i campi contenuti nel report generato.
Campo |
Descrizione |
---|---|
Nome rivenditore |
Nome partner o ID organizzazione partner |
ID fatturazione |
Identificativo di fatturazione univoco partner o numero C |
ID spEnterprise |
Identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno |
Stato della versione di prova interna del cliente (Sì/No) |
ID utente |
L'ID utente dell'abbonato su BroadWorks |
ID abbonato |
Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato |
Sì/No |
primaDataInizio |
Data di provisioning dell'abbonato. |
Data di inizio fatturazione |
Data di inizio della fatturazione in questo mese |
Data di fine fatturazione |
Data di fine della fatturazione in questo mese |
pacchetto |
Tipo di pacchetto che viene addebitato |
quantità |
Quantità proporzionale per la fatturazione.
|
-
Una volta generato un report di fatturazione per un determinato periodo di tempo, non è possibile rigenerare tale report a meno che non si elimini prima il report esistente.
-
Se si modifica il tipo di pacchetto o l'ID utente BroadWorks per un determinato utente, il report del mese in cui si è verificata la modifica mostra più voci per tale utente con voci proporzionali separate prima e dopo la modifica.
Risoluzione dei problemi di Webex per Cisco BroadWorks
Iscrizione alla pagina di stato Webex
Innanzitutto, https://status.webex.com verificare se si verifica un'interruzione imprevista del servizio. Se non è stata modificata la configurazione in Control Hub o BroadWorks prima dell'interruzione, controllare la pagina di stato. Per ulteriori informazioni sulla sottoscrizione per lo stato e le notifiche di incidenti, vedere il Centro di assistenza Webex.
Uso della funzionalità di analisi di Control Hub
Webex tiene traccia dei dati di utilizzo e qualità per la propria organizzazione e per le organizzazioni dei clienti. Ulteriori informazioni sulla funzionalità di analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
I clienti o gli utenti non vengono creati in Control Hub con provisioning flow provisioning:
-
Il server dell'applicazione può raggiungere l'URL di provisioning?
-
L'account di provisioning e la password sono corretti, se esistono in BroadWorks?
I cluster non riescono regolarmente con i test di connettività:
La connessione mTLS al servizio di autenticazione dovrebbe non riuscire quando si crea il primo cluster in Partner Hub poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. Senza questo, non è possibile creare un trust anchor sugli ADP XSP| del servizio di autenticazione, quindi la connessione mTLS di test da Partner Hub non viene eseguita correttamente.
-
Le interfacce XSP|ADP sono accessibili pubblicamente?
-
Si stanno utilizzando le porte corrette? È possibile inserire una porta nella definizione dell'interfaccia sul cluster.
Convalida interfacce non riuscita
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano stati inseriti correttamente sul cluster in Partner Hub, incluso
/v2.0
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Esaminare l'avviso di configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano stati inseriti correttamente sul cluster in Partner Hub, incluso
/v2.0
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Rivedere i consigli di configurazione dell'interfaccia in questo documento, con particolare attenzione su:
- Accertarsi di aver condiviso le chiavi RSA tra tutte le ADP XSP|.
- Accertarsi di aver fornito l'URL AuthService al container Web su tutti gli ADP XSP|.
- Se è stata modificata la configurazione di crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'ADP XSP| richiede l'inserimento del formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento indicava in modo errato le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
-
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati nell'archivio attendibilità XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere certificati client?
-
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere certificati client?
Problemi del client
Verificare che il client sia connesso a BroadWorks
-
Accedere all'app Webex.
-
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.
-
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici. Viene visualizzato lo stato della SSO è stato eseguito l'accesso.
Se viene visualizzato un altro servizio telefonico, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Ciò significa:
-
Il client ha transverso correttamente i microservizi Webex richiesti.
-
L'utente è stato autenticato correttamente.
-
Il client è stato emesso un token Web JSON a lungo termine dal sistema BroadWorks.
-
Il client ha recuperato il profilo del dispositivo ed è registrato per BroadWorks.
Registri client
Tutti i client app Webex possono inviare log a Webex. Questa è l'opzione migliore per client mobili. È necessario registrare anche l'indirizzo e-mail dell'utente e l'ora approssimativa del problema, se si desidera assistenza dal Tac. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se occorre raccogliere manualmente i registri da un PC Windows, si trovano nel seguente modo:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac: /Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS non configurata correttamente
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
-
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
-
Verificare che la catena di certificati Webex sia installata come trust anchor.
-
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e che sia firmato da un'autorità di certificazione attendibile.
Messaggio interruzione licenza
Questo messaggio può essere visualizzato per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'uso della licenza supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Criteri di supporto stato originale
Il provider di servizi è il primo punto di contatto per il supporto clienti finale (enterprise). Inoltrare i problemi che il SP non può risolvere al TAC. Il supporto della versione server BroadWorks segue i criteri della Versione corrente e delle due precedenti versioni principali (N-2). Ulteriori informazioni sono disponibili nella sezione Criteri per il ciclo di vita dei prodotti BroadSoft in Criteri per il ciclo di vita di BroadSoft e Matrice di compatibilità software BroadWorks.
Criteri di escalation
-
L'utente (provider di servizi/partner) è il primo punto di contatto per il supporto dei clienti finali (enterprise).
-
I problemi che non possono essere risolti dal SP vengono inoltrati al TAC.
Versioni BroadWorks
-
Il supporto della versione server BroadWorks segue i criteri di BroadSoft, della versione corrente e delle due versioni principali precedenti (N-2). Ulteriori informazioni sono disponibili nella sezione Criteri per il ciclo di vita dei prodotti BroadSoft in Criteri per il ciclo di vita di BroadSoft e Matrice di compatibilità software BroadWorks.
Risorse di self-support
-
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, in cui è disponibile una pagina specifica di Webex per Cisco BroadWorks che elenca la Guida per l'app Webex comune e gli argomenti di supporto.
-
È possibile personalizzare l'app Webex con questo URL della Guida e un URL per la segnalazione di problemi.
-
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I log vengono nel cloud Webex, dove possono essere analizzati da Webex DevOps.
-
È disponibile anche una pagina del Centro assistenza dedicata alla guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccolta delle informazioni per l'invio di una richiesta di assistenza
Quando si visualizzano errori in Control Hub, è possibile che siano state allegati informazioni che consentono al Tac di ricercare la causa del problema. Ad esempio, se viene visualizzato un ID di verifica per un determinato errore o un codice di errore, salvare il testo da condividere con noi.
Provare a includere almeno le seguenti informazioni quando si invia una query o si apre un caso:
-
ID organizzazione cliente e ID organizzazione partner (ciascun ID è una stringa di 32 cifre esadecimali, separate da trattini)
-
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce una
-
Indirizzo e-mail utente (se si verificano problemi con un determinato utente)
-
Versioni del client (se il problema presenta sintomi notati attraverso il client)
Webex per riferimento a BroadWorks
Confronto DI UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > |
UC-One SaaS |
Webex per Cisco BroadWorks |
---|---|---|
Cloud |
Cisco UC-One Cloud (GCP) |
Cloud Webex (APPLICAZIONI WEBEX) |
Client |
UC-One: Mobile, Desktop Receptionist, Supervisore |
Webex: Mobile, Desktop, Web |
Principale differenza tecnologia |
Riunioni consegnate su Broadsoft Meet Technology |
Riunioni consegnate su Webex Meetings Technology |
Versioni di prova sul campo iniziali |
Ambiente di gestione temporanea, client Beta |
Ambiente di produzione, client GA |
Identità utente |
BroadWorks ID utilizzato come ID principale, a meno che provider di servizi sito non SSO già.
ID utente e segreto in BroadWorks |
ID e-mail in Cisco CI serve come ID principale SSO integrazioni in provider di servizi BroadWorks in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks in quel momento.
L'utente fornisce le credenziali tramite SSO broadworks e secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e autenticazione nel provider di identità |
Autenticazione client |
Gli utenti forniscono le credenziali tramite il client Token a lungo accesso BroadWorks richiesti se si utilizza la messaggistica Webex |
Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso e aggiornamento dei token Webex |
Gestione/configurazione |
I sistemi ANDR E BSS e Portale rivenditore |
SISTEMI CUI/BSS e Control Hub |
Attivazione partner/provider di servizi partner |
Una sola impostazione per Cisco Operations |
Una sola impostazione per Cisco Operations |
Attivazione cliente/aziendale |
Portale rivenditore |
Control Hub Creazione automatica alla prima iscrizione utente |
Opzioni di attivazione utente |
Auto iscrizione Impostazione di IM&P esterno in BroadWorks
|
Impostazione di Integrated IM&P in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP |
Azioni XSI
Eventi XSI CTI (mTLS) AuthService (mTLS opzionale) DMS |
Azioni XSI Azioni XSI (mTLS) Eventi XSI CTI (mTLS) AuthService (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 |
Scaricare e installare Webex. Per dettagli, vedere Webex | Download dell'app. |
2 |
Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 |
Inserire il proprio indirizzo e-mail e fare clic su Next(Avanti). |
4 |
In base alla configurazione dell'organizzazione in Webex, si verificano le seguenti operazioni: Webex viene caricato dopo aver eseguito correttamente l'autenticazione per IdP o BroadWorks.
|
Scambio dati e storage
Queste sezioni forniscono dettagli sullo scambio di dati e sullo storage con Webex. Tutti i dati sono crittografati sia in viaggio che a riposo. Per ulteriori dettagli, vedere Sicurezza app Webex.
provider di servizi ilboarding
Quando si configurano cluster e modelli utente in Webex Control Hub durante provider di servizi onboarding, si scambiano i seguenti dati BroadWorks memorizzati da Webex:
-
URL azioni Xsi
-
Xsi-Events URL
-
URL interfaccia CTI
-
URL servizio di autenticazione
-
Credenziali dell'adattatore provisioning BroadWorks
provider di servizi provisioning utente
Questa tabella elenca i dati utente ed aziendale s scambiati come parte del provisioning degli utenti attraverso le API Webex.
Trasferimento dati a Webex |
Da |
Attraverso |
Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito da SP) |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito dall'utente) |
Utente |
Portale di attivazione utente |
Sì |
Nome |
BroadWorks, per API |
API Webex |
Sì |
Cognome |
BroadWorks, per API |
API Webex |
Sì |
Numero di telefono principale |
BroadWorks, per API |
API Webex |
Sì |
Numero telefono cellulare |
BroadWorks, per API |
API Webex |
Sì |
Estensione principale |
BroadWorks, per API |
API Webex |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
BroadWorks, per API |
API Webex |
Sì |
Lingua |
BroadWorks, per API |
API Webex |
Sì |
Fuso orario |
BroadWorks, per API |
API Webex |
Sì |
Rimozione utente
Webex per api Cisco BroadWorks supporta la rimozione parziale e completa degli utenti. Questa tabella elenca tutti i dati utente archiviati durante il provisioning e ciò che viene eliminato in ciascuno scenario.
Dati utente |
Eliminazione parziale |
Eliminazione completa |
---|---|---|
ID utente BroadWorks |
Sì |
Sì |
|
No |
Sì |
Nome |
No |
Sì |
Cognome |
No |
Sì |
Numero di telefono principale |
Sì |
Sì |
Numero telefono cellulare |
Sì |
Sì |
Estensione |
Sì |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
Sì |
Sì |
LANGUAGE |
No |
Sì |
Recupero accesso utente e configurazione
Autenticazione Webex
L' autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da parte di uno qualsiasi dei meccanismi di autenticazione di supporto Webex. (L' autenticazione BroadWorks è trattata separatamente.) Questa tabella mostra il tipo di dati scambiati tra i diversi componenti sul flusso di autenticazione.
Spostamento dei dati |
Da |
A |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (indipendente) |
Webex |
Browser utente |
Credenziali utente |
Browser utente |
Provider di identità (che dispone già di identità utente) |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Autenticazione BroadWorks
Per autenticazione BroadWorks si intende l'accesso dell'utente a un'app Webex utilizzando le relative credenziali BroadWorks. Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti del flusso di autenticazione.
Spostamento dei dati |
Da |
A |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (proxy IdP Webex Bwks) |
Webex |
Browser utente |
Informazioni sul branding e URL BroadWorks |
Webex |
Browser utente |
Credenziali utente BroadWorks |
Utente attraverso il browser (pagina di accesso con branded servita da Webex) |
Webex |
Credenziali utente BroadWorks |
Webex |
BroadWorks |
File BroadWorks profilo utente |
BroadWorks |
Webex |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento del messaggio di avviso ed errore di accesso:
- Attualmente, gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e eseguono l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso perché la password è già scaduta. Con questa funzione, se la password sta per scadere entro 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere con l'indicazione del numero di giorni rimanenti e viene consigliato di contattare il Partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione 'enforcePasswordChangeOnExpiry' in BroadWorks è impostata su true, l'errore "nome utente e password errati" è stato lanciato, ma ora con questa funzione il messaggio di errore è stato migliorato: Tentativo di accesso non riuscito. La combinazione dell'ID utente e della password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice di errore 100006
Controlla flusso di accesso:
- Il partner può limitare l'accesso abilitando l'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione di BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, viene visualizzato un errore dicendo che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso è configurabile dal partner come parte del branding personalizzato: Personalizzazione avanzata. I partner devono configurare il collegamento per reindirizzare gli utenti al portale del partner per la gestione e la reimpostazione delle password.
Questa funzione migliora solo l'esperienza di accesso utente durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se la password scade mentre l'utente è connesso all'app Webex. L'utente riceverà una notifica relativa alla scadenza della password al successivo tentativo di accesso.
Recupero configurazione client
Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti nel recupero delle configurazioni del client.
Spostamento dei dati |
Da |
A |
---|---|---|
Iscrizione |
Client |
Webex |
Impostazioni dell'organizzazione, inclusi gli URL BroadWorks |
Webex |
Client |
Token BroadWorks JWORKS |
BroadWorks attraverso Webex |
Client |
Token BroadWorks JWORKS |
Client |
BroadWorks |
Token dispositivo |
BroadWorks |
Client |
Token dispositivo |
Client |
BroadWorks |
File di configurazione |
BroadWorks |
Client |
Utilizzo stato originale
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione in seguito alla scadenza del token attraverso BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Spostamento dei dati |
Da |
A |
---|---|---|
Segnalazione SIP |
Client |
BroadWorks |
Contenuto multimediale SRTP |
Client |
BroadWorks |
Segnalazione SIP |
BroadWorks |
Client |
Contenuto multimediale SRTP |
BroadWorks |
Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Spostamento dei dati |
Da |
A |
---|---|---|
Messaggistica e presenza HTTPS REST |
Client |
Webex |
Messaggistica e presenza HTTPS REST |
Webex |
Client |
Segnalazione SIP |
Client |
Webex |
Contenuto multimediale SRTP |
Client |
Webex |
Segnalazione SIP |
Webex |
Client |
Contenuto multimediale SRTP |
Webex |
Client |
Uso dell'API di provisioning
Accesso sviluppatore
La specifica API è disponibile su https://developer.webex.com e una guida all'uso è su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l'accesso per leggere la specifica API su https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Autenticazione e autorizzazione dell'applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (come il provisioning del sottoscrittore) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere i token di aggiornamento e di accesso per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
È necessario prima registrare l'integrazione con Webex. Una volta registrata, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di aggiornamento e accesso necessari.
Per ulteriori informazioni sulle integrazioni e su come creare questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli richiesti per l'implementazione delle integrazioni, lo sviluppatore e l'utente che ha autorizzato, e possono essere tenute da persone/team separati nel proprio ambiente.
-
Lo sviluppatore crea l'app e la registra su per generare il ClientID/Secret OAuth richiesto con gli ambito previsti per https://developer.webex.com l'applicazione. Se l'applicazione è stata creata da terze parti, potrebbe registrare l'applicazione (se è stato richiesto l'accesso) o è possibile farlo con il proprio accesso.
-
L'utente autorizzato è l'account che l'applicazione utilizza per autorizzare le chiamate API, per modificare l'organizzazione partner, le organizzazioni dei clienti o i relativi abbonati. Questo account deve avere il ruolo di amministratore completo o amministratore completo di vendite nell'organizzazione partner. Questo account non deve essere mantenuto da terze parti.
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning in uso:
-
Modalità Enterprise: il nome organizzazione è una corrispondenza esatta di spEnterpriseId.
-
Modalità provider di servizi: il nome organizzazione è la parte ID gruppo di spEnterpriseId.
Il nome dell'organizzazione contiene spazi vuoti, caratteri maiuscoli e speciali specificati nel spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "patch current" con le ultime patch BroadWorks e le app RI (Release Independent). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Accertarsi di esaminare le note di patch per queste patch software. Alcune patch potrebbero richiedere ulteriori requisiti CLI.
Versione R22
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione | ||
Obbligatorio per sincronizzazione rubriche | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Patch richiesta per il server applicazioni | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Patch richiesta per funzione di registrazione chiamata | ||
Patch richiesta per provisioning flow-through | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Server dei profili | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Piattaforma | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il servizio di autorizzazione con convalida del token CI | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
XSP|ADP |
Richiesto per il proxy di autenticazione NPS | |
Richiesto per il servizio di autorizzazione con convalida del token CI | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il servizio di autorizzazione con convalida del token CI | ||
Obbligatorio per Cronologia chiamate Unified | ||
Altro |
AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione |
Obbligatorio per sincronizzazione rubriche | |
Server app di configurazione | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Obbligatorio per la registrazione della chiamata | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Server dei profili | ||
Piattaforma | ||
Richiesto per il proxy di autenticazione NPS | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
XSP|ADP | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il proxy di autenticazione NPS | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Altro |
Se si utilizza ADP... |
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata |
Versione R24
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione |
Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per provisioning a flusso costante | ||
Obbligatorio per la registrazione della chiamata | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Altro |
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che devi configurare per Webex, fai riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utenti e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. Attivazione include la convalida e-mail e l'assegnazione del servizio in Webex.
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se si dispone di indirizzi e-mail attendibili per gli utenti, è possibile scegliere di attivarli automaticamente quando vengono predisposti automaticamente. Questo processo è di "provisioning automatico e attivazione automatica".
Provisioning utenti automatizzato e attivazione automatica (flusso e-mail attendibile)
Prerequisiti
-
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
-
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
-
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase |
Descrizione |
---|---|
1 |
Si preventiva ed si eserviranno gli ordini per il servizio con i clienti. |
2 |
L'ordine del cliente viene processato ed è stato predisposto il cliente nel sistema. |
3 |
Il sistema di provisioning del servizio attiva il provisioning di BroadWorks. Questa operazione, in riepilogo, crea l'azienda e gli utenti. Quindi, assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM esterno. |
4 |
Questa operazione di provisioning attiva il provisioning automatico dell'organizzazione e degli utenti del cliente in Webex. (L'assegnazione del servizio IM&P causa la chiamata dell'adattatore di provisioning all'API di provisioning Webex). |
5 |
I sistemi devono utilizzare l'API di provisioning Webex se in seguito occorre regolare il pacchetto per l'utente (per effettuare una modifica rispetto al valore predefinito). |
SSO di accesso
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, consentendo l'autenticazione diretta a BroadWorks. L'immagine visualizza gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresentano ciò che il client fornisce per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizi BroadWorks che segue immediatamente dal flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione diretta BroadWorks abilitata (condivisione risorse multi-origine). Di seguito sono riportati alcuni flussi di SSO SAML alternativi:
-
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
-
L'unica differenza è nel punto 5 e 6 del flusso di accesso Webex. Nel punto 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
-
Il flusso procede attraverso le operazioni restanti nei due diagrammi.
-
Il SSO di registrazione non è utilizzato in questo flusso.
-
-
Autenticazione Webex SSO SAML:
-
Al punto 3 del flusso di accesso Webex, il servizio Common Identity servizi restituisce il provider di identità utilizzato dall'autenticazione Webex.
-
A questo punto, viene richiamato un flusso di SSO SAML alternativo per Webex.
-
Interazioni utente
Accedi
-
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
-
CI rileva che l'organizzazione cliente associata ha il proxy IDP BroadWorks configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso. Il provider di servizi può personalizzare questa pagina di accesso.
-
L'utente inserisce le proprie credenziali BroadWorks.
-
Broadworks autentica l'utente attraverso l'IDP. In caso positivo, IDP reindirizza il browser a CI con un SISTEMA SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
-
In caso di autenticazione eseguita correttamente, l'app Webex ottiene i token di accesso da CI (non mostrato nel diagramma). Il client le utilizza per richiedere un token JNTASSI (Jason Web Token) BroadWorks.
-
L'app Webex rileva la configurazione di chiamata da BroadWorks e da altri servizi di Webex.
-
L'app Webex si registra con BroadWorks.
Accesso dal punto di vista dell'utente
Questo diagramma è il flusso di accesso tipico, visualizzato dall'utente finale o dall'abbonato:
-
L'app Webex viene scaricata e installata.
-
È possibile che sia stato ricevuto il collegamento dal proprio provider di servizi oppure il download potrebbe essere trovato sulla pagina di download di Webex.
-
L'indirizzo e-mail viene inserito nella schermata di accesso di Webex. Fare clic su Avanti.
-
Solitamente, si viene reindirizzati a una provider di servizi a cui viene visualizzata una pagina con marchio.
-
Questa pagina potrebbe dare il benvenuto mediante il proprio indirizzo e-mail.
Se non si dispone di un indirizzo e-mail o se l'indirizzo e-mail è errato, inserire l'indirizzo nome utente BroadWorks.
-
Inserire la password BroadWorks.
-
Se è stato eseguito correttamente l'accesso, Webex si apre.
flusso chiamata: rubrica aziendale
flusso chiamata—PSTN cliente
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni client
Recupera profilo da REGISTRAZIONE DMS e SIP con AS
-
Il client chiama XSI per ottenere un token di gestione dispositivi e l'URL sul DMS.
-
Il client richiede il profilo del dispositivo dal DMS presentando il token dal punto 1.
-
Il client legge il profilo del dispositivo e recupera le credenziali SIP, gli indirizzi e le porte.
-
Il client invia un SIP REGISTER al controller SBC utilizzando le informazioni del punto 3.
-
SBC invia il SIP REGISTER ad AS (il controller SBC può eseguire una ricerca in NS per individuare un AS se SBC non conosce già l'utente SIP).
Linee guida di test e laboratorio
Le seguenti linee guida si applicano a organizzazioni di test e laboratorio:
-
provider di servizi partner sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
-
La fatturazione verrà addebitata a qualsiasi utente oltre i primi 50 utenti di prova.
-
Per assicurare un'elaborazione precisa della fattura, tutte le organizzazioni di test devono includere 'test' nel nome dell'organizzazione BroadWorks.
-
Le organizzazioni di test interne devono essere designate all'interno Webex Control Hub. Al fine di evitare che gli utenti di prova vengano fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di test:
-
Accedere all'hub partner e selezionare Clienti.
-
Selezionare il cliente appropriato.
-
Nella barra di controllo a destra, abilitare l'interruttore Organizzazione test interna.
Riproduzione segreteria telefonica
Per la segreteria telefonica, accertarsi di configurare il server multimediale per l'uso di uno dei seguenti codici:
-
mp3
-
wav— I file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android)
Se si utilizzano file wav, eseguire i seguenti comandi CLI per verificare il server dell'applicazione e server multimediale:
-
AS_CLI/Service/VoiceMsg>imposta vmRecordingAudioFileFormat WAV
-
MS_CLI/Applications/MediaStreaming/Services/IVR> imposta sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACL
- Elenco di controllo accessi
- ALG
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APNS
- Utenti Apple servizio di notifica push
- AS
- Server applicazione
- ATA
- Adattatore telefono analogico, adattatore per la conversione della telefonia analogica VoIP
- BAM
- Gestione applicazioni BroadSoft
- Autenticazione di base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- BMS
- Server di messaggistica BroadSoft
- BOSH
- Flussi bidirezionale su HTTP sincrono
- BRI
- L'interfaccia BRI (Basic Rate Interface) è un metodo di accesso ISDN
- Bundle
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico di telefonia (cf. partner, provider di servizi, rivenditore aggiunto valore)
- CAPTCHA
- Test del turing pubblico completamente automatizzato per incisire sui computer e sull'humans apart
- CODICE CCXML
- Controllo chiamata EXtensible Markup Language
- CIF
- Formato intermedio comune
- CLI
- Interfaccia della riga di comando
- CN
- Nome comune
- CSP
- Server push notifiche chiamate. Un server push notifiche eseguito su un ADP XSP| nell'ambiente, per eseguire il push delle notifiche di chiamata a FCM e APNS. Vedere Proxy NPS.
- CPE
- Apparecchiatura locale del cliente
- CPR
- Regola di presenza personalizzata
- CSS
- Foglio di stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione di telefonia su computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- Non disturbare
- Non disturbare
- DNS
- Sistema di nomi di dominio
- DPG
- Chiama gruppo peer
- DSCP
- Punto codici servizi differenziati
- DTAF
- File di archivio del tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza dual-tone
- Utente finale
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. per l'abbonato)
- Aziendale
- Un gruppo di utenti finali (cf. organizzazione)
- FCM
- Messaggistica cloud Firebase
- FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creazione di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning flow-through completo
- Creazione e verifica di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks e l'asserzione che ciascun utente BroadWorks ha un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. Il plug-on del telefono o del fax o i plug-in sul sistema telefonico analogico. Fornisce un'indicazione di hook/off-hook (chiusura loop). Poiché la porta BLUETOOTH è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo BLUETOOTH".
- FXS
- Foreign Exchange Subscriber è la porta che consegna effettivamente la linea analogica al sottoscrittore. In altre parole, è il plug-in alla parete che offre un segnale di chiamata, una corrente a batteria e una suoneria.
- GCM
- Messaggio Google Cloud
- GCM
- Modalità Galois/Counter Mode (tecnologia di crittografia)
- NASCOSTO
- Dispositivo interfaccia utente
- HTTPS
- Protocollo di trasferimento ipertestuale socket sicuri
- IAD
- Dispositivo di accesso integrato
- IM&P
- Messaggistica immediata e presenza
- IP PSTN
- Un provider di servizi che fornisce VoIP servizi PSTN, intercambiabili con ITSP, o un termine generale per la telefonia 'pubblica' collegata da Internet, collettivamente fornito dai principali fornitori di telecomunicazioni (anziché tramite paesi, come PSTN è)
- ITSP
- Servizi di telefonia Internet provider di servizi
- IVR
- Risposta vocale interattiva/Risponditore
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificativo Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notifica oggetto Java Script
- JSSE
- Estensione socket sicura Java; la tecnologia sottostante che fornisce funzioni di connettività sicura ai server BroadWorks
- KEM
- Modulo di estensione chiave (telefoni Cisco hardware)
- LLT
- Token lungo(o long life); una forma di auto-descrizione, sicura di token di connessione che consente agli utenti di rimanere autenticati per più tempo e non è legata a applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIB
- Base informazioni di gestione
- MS
- Server multimediale
- Mtls
- Autenticazione reciproca tra due parti, mediante lo scambio di certificati, quando si stabilisce una connessione TLS
- MUC
- Chat multi-utente
- NAZ
- Traduzioni indirizzi di rete
- NPS
- Server push di notifica; vedere CNPS
- NPS Proxy
-
Servizio in Webex che fornisce token di autorizzazione breve al CNPS, abilitando il push delle notifiche di chiamata su FCM e APNs e, infine, sui dispositivi Android e iOS che eseguono Webex.
- OCI
- Apri interfaccia client
- Organizzazione
- Una società o un'organizzazione che rappresenta un gruppo di utenti finali (cf. Enterprise)
- OTG
- Gruppo trunk in uscita
- Pacchetto
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. Bundle)
- Partner
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. Valore aggiunto rivenditore, provider di servizi, vettore)
- PBX
- Exchange su succursale privato
- PEM
- Messaggio e-mail avanzato sulla privacy
- PLMN
- Rete mobile su rete pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia di telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- PS
- Server dei profili
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Un sito Web che consente all'amministratore del rivenditore di configurare la propria soluzione UC-One SaaS. Talvolta è noto come portale BANG, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Controllo bordo sessione
- SCA
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; Un'organizzazione che fornisce servizi telefonici o correlati ad altre organizzazioni (cf. Gestore telefonico, partner, rivenditore aggiunto valore)
- SIP
- SIP (Session Initiation Protocol)
- SLT
- Token breve (o breve durata) (denominato anche token SSO BroadWorks); un token autenticato a uso singolo utilizzato per ottenere l'accesso protetto alle applicazioni Web.
- SMB
- Piccola e media azienda
- SNMP
- Semplice protocollo di gestione della rete
- sRTCP
- protocollo Secure Realtime Transfer Control Protocol (VoIP multimediale per chiamate in tempo reale)
- sRTP
- protocollo Secure Realtime Transfer Protocol (VoIP multimediale di chiamata)
- SSL
- Livello socket sicuri
- Abbonato
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. Utente finale)
- TCP
- Protocollo di controllo trasmissione
- TDM
- Multiplexing divisione temporale
- TLS
- Sicurezza livello di trasporto
- Tos
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Unified Communications
- UI
- Interfaccia utente
- UID
- Identificativo univoco
- UMS
- Server di messaggistica
- URI
- Uniform Resource Identifier
- URL
- Localizzatore risorse uniforme
- USS
- Server di condivisione
- UTC
- Coordinated Universal Time
- UV
- Video Server
- Rivenditore aggiunto valore (VAR)
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. vettore, partner, provider di servizi)
- VGA
- Array di elementi grafici video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Voice Extensible Markup Language
- Webdav
- Creazione e versione per Web distributed authoring
- WebRTC
- Comunicazioni in tempo reale Web
- WRS
- WebRTC Server
- XMPP
- Protocollo di messaggistica e presenza Estendi
Appendice
Configurazione dei servizi (con mTLS per il servizio di autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida di token CI. Queste procedure sono obbligatorie se si utilizzano più organizzazioni Webex sullo stesso server ADP XSP|. Altrimenti, sono opzionali.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi connettori Cisco BroadWorks.
È necessario distribuire solo un'istanza delle applicazioni Xsi-Events sull'ADP XSP| utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso callControlApplicationName definito in Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> ottenere
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente è inserito in Webex, Webex crea un abbonamento per l'utente sul AS per ricevere gli eventi di telefonia per la cronologia della presenza e delle chiamate. L'abbonamento è associato a callControlApplicationName e il AS lo utilizza per sapere a quali Xsi-Events inviare gli eventi di telefonia.
La modifica del callControlApplicationName o il mancato nome di tutte le app Web Xsi-Events avranno impatto sugli abbonamenti e sulla funzionalità degli eventi di telefonia.
Configurazione del servizio di autenticazione (con mTLS)
I token di lunga durata BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sulle ADP XSP|.
Requisiti
-
I server ADP XSP| che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
-
Gli ADP XSP| devono condividere le stesse chiavi per la crittografia/decrittografia dei token BroadWorks di lunga durata. Copiare queste chiavi a ciascun ADP XSP| è un processo manuale.
-
Gli ADP XSP| devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli ADP XSP| include:
-
Distribuire il servizio di autenticazione.
-
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
-
Genera e condividi chiavi RSA tra ADP XSP|.
-
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ciascun ADP XSP| utilizzato con Webex:
-
Attivare l'applicazione del servizio di autenticazione sul
percorso /authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> attiva servizio di autenticazione applicazione /authService
(dove
è la versione di BroadWorks).
-
Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
distribuisci applicazione /authService
Configurazione della durata del token
-
Controllare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
-
Impostare la durata su 60 giorni (il massimo è 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
imposta tokenDurationInHours 1440
Genera e condividi chiavi RSA
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittografia di token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori, è necessario generare chiavi su un ADP XSP|e copiarle in tutti gli altri ADP XSP|.
Se si alterano i tasti o si modifica la lunghezza della chiave, è necessario ripetere la configurazione seguente e riavviare tutte le ADP XSP|.
-
Selezionare un ADP XSP| da utilizzare per la generazione di una coppia di chiavi.
-
Utilizzare un client per richiedere un token crittografato all'ADP XSP|, richiedendo il seguente URL dal browser del client:
|https:///authService/token?key=BASE64URL(clientPublicKey)
(viene generata una coppia di chiavi privata/pubblica su ADP XSP|, se non ne era già presente una)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
-
Copiare il file esportato
/var/broadworks/tmp/authService.keys
nella stessa posizione sugli altri ADP XSP|, sovrascrivendo un file.keys
precedente, se necessario. -
Importa le chiavi su ciascuno degli altri ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al container Web
Il container Web di ADP XSP| richiede l'URL authService in modo da poter convalidare i token.
Su ciascuno degli ADP XSP|:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per lo strumento di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
imposta URL http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> aggiungi tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Controllare il parametro con
get
. -
Riavviare ADP XSP|.
Configurazione di TLS e della crittografia sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurazione TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > trasporto > http > interfaccia Server HTTP = Più specifico
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il
comando get e leggere i
risultati. Dovrebbero essere presenti le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Tomcat obbligatorio un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> ottenere
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
È necessario configurare l'interfaccia HTTP che interagisce con Webex Cloud per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Inserire il comando
get 443
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserisci il comando
aggiungi 443 TLSv1.2
per assicurarti che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia del server HTTP
Per configurare i crittografia richiesti:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Inserire il comando
get 443
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements (Requisiti di sicurezza e identità XSP) nella sezione Overview). -
Inserire il comando
add 443
per aggiungere una crittografia all'interfaccia del server HTTP.IL CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
del server HTTP, utilizzare:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>aggiungi 192.0.2.7 443 TLS_ECDHE_ECDSA_CON_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità del servizio di autenticazione (con mTLS)
-
Accedere a Control Hub con l'account dell'amministratore del partner.
-
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain .txt
sul computer locale.Questi file contengono due set di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori. -
Suddividere la catena di certificati in due certificati:
combinedcertchain .txt
.-
Aprire
combinedcertchain .txt
in un editor di testo. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e -----END CERTIFICATE----- , e incollare il blocco di testo in un nuovo
file. -
Salvare il nuovo file come
root .txt
. -
Salvare il file originale come
emissione di .txt
. Il file originale ora deve contenere solo un blocco di testo, racchiuso tra lerighe -----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copiare entrambi i file di testo in una posizione temporanea sull'ADP XSP| che si sta proteggendo, ad esempio,
/var/broadworks/tmp/root .txt
e/var/broadworks/tmp/issuing .txt
. -
Accedere a XSP|ADP e passare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Eseguire la guidaUpdateTrust
per visualizzare i parametri e il formato del comando. -
Carica i file dei certificati sui nuovi trust anchor - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot /var/broadworks/tmp/root .txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing /var/broadworks/tmp/issuing .txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot
,webexclientissuing
ewebexclientissuing
sono alias di esempio per i trust anchor; puoi utilizzare i tuoi alias purché tutte e quattro le voci siano univoche. -
Confermare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> ottenere
Alias Proprietario emittente ============================================================================= webexclientissuing Internal Private TLS SubCA Internal Private Root webexclientroot Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate sull'ADP XSP|. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, mTLS è richiesto per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
-
Accedere all'ADP XSP| di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
ed eseguire il comandoget
per visualizzare le interfacce. -
Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che corrisponde a mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> aggiungi nome porta IPAddress true true
Per informazioni dettagliate, vedere la documentazione CLI XSP ADP|CLI. Essenzialmente, la prima true protegge l'interfaccia con TLS (il certificato server viene creato se richiesto) e la seconda forza true l'interfaccia a richiedere l'autenticazione del certificato
client
(insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> ottenere
Nome porta interfaccia Secure Client Auth Req Cluster Fqdn ======================================================= 192.0.2.7 443 XSP|ADP01.collab.example.net true false 192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (Client Auth Req = true) è abilitato sulla porta 192.0.2.7
444.
TLS è abilitato sulla porta 192.0.2.7
443.
(Opzione) Configurare mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate sull'ADP XSP|. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, mTLS è richiesto per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
-
Accedere all'ADP XSP| di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
ed eseguire il comandoget
per visualizzare le applicazioni in esecuzione. -
Per aggiungere un'applicazione e richiedere l'autenticazione del client (che significa lo stesso di mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiungi nome applicazione porta IPAddress true
Per informazioni dettagliate, vedere la documentazione CLI XSP ADP|CLI. I nomi delle applicazioni sono elencati in questo elenco. Vero
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiunge 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService alla versione 192.0.2.7:443 e richiede che a tale applicazione sia richiesta e autenticata dal client.
Controlla con ottieni
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> ottieni
Interfaccia Porta IP Nome applicazione Client Autenticazione ======================================================
192.0.2.7 443 AuthenticationService true
Configura gestione dispositivi su XSP|ADP, server applicazioni e server di profilo
Il server di profilo e l'ADP XSP| sono obbligatori per la gestione dei dispositivi. Tali impostazioni devono essere configurate in base alle istruzioni nella Guida alla configurazione di Gestione dispositivi BroadWorks.
Dove andare avanti
Per la configurazione, è possibile accedere nuovamente al flusso del documento principale all'indirizzo Interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca con AuthService
Webex interagisce con il servizio di autenticazione su (autenticazione) TLS reciproca connessione autenticata. Ciò significa che Webex presenta un certificato client e l'ADP XSP|deve convalidarlo. Per certificare l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora di attendibilità su ADP XSP| (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
-
Andare a Impostazioni > Chiamata BroadWorks.
-
Fare clic sul collegamento per il download del certificato.
È possibile ottenere la catena di certificati anche da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt.
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono dalla distribuzione degli ADP XSP| pubblici:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente all'ADP XSP|
Il diagramma seguente riepiloga i punti in cui la catena di certificati CA Webex deve essere distribuita in questi tre casi.
Requisiti del certificato TLS reciproca per il proxy con bridge TLS
-
Webex presenta un certificato client firmato dall'autorità di certificazione Webex nel proxy.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità del proxy, pertanto il proxy considera attendibile il certificato client.
-
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta un certificato server firmato pubblicamente con Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Il proxy presenta un certificato client firmato internamente agli ADP XSP|.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3:
Uso chiave estesa X509v3:
1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati del server interno per XSP|ADP possono essere SAN.
-
Gli ADP XSP| si affidano alla CA interna.
-
Gli ADP XSP| presentano un certificato server firmato internamente.
-
Il proxy considera attendibile la CA interna.
Requisiti del certificato TLS reciproca per proxy tls passizzato o XSP in DMZ
-
Webex presenta un certificato client firmato ca Webex agli XSP.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità degli XSP, pertanto gli XSP considerano attendibile il certificato client.
-
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
-
Gli XSP presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP.
Cronologia revisioni documenti
La tabella seguente mostra una cronologia delle modifiche di questo documento negli ultimi 12 mesi.
Data |
Versione | Descrizione della modifica | |
---|---|---|---|
3 dicembre 2024 |
2-124 |
| |
4 ottobre 2024 |
2-123 |
| |
10 settembre 2024 |
2-123 |
| |
9 agosto 2024 |
2-122 |
| |
1 agosto 2024 |
2-121 |
| |
25 giugno 2024 |
2-120 |
| |
14 giugno 2024 |
2-119 |
| |
13 maggio 2024 |
2-118 |
| |
10 maggio 2024 |
2-117 |
| |
6 maggio 2024 |
2-116 |
| |
2 maggio 2024 |
2-115 |
| |
10 aprile 2024 |
2-114 |
| |
27 marzo 2024 |
2-113 |
| |
22 marzo 2024 |
2-112 |
| |
7 marzo 2024 |
2-111 |
| |
24 febbraio 2024 |
2-110 |
| |
20 febbraio 2024 |
2-109 |
| |
07 febbraio 2024 |
2-108 |
| |
25 gennaio 2024 |
2-107 |
| |
23 gennaio 2024 |
2-106 |
| |
10 gennaio 2024 |
2-105 |
| |
Appendice
Configurazione dei servizi (con mTLS per il servizio di autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XS|PADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida di token CI. Queste procedure sono obbligatorie se si stanno eseguendo più organizzazioni Webex dallo stesso server ADP XSP|. Altrimenti, sono opzionali.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi connettori Cisco BroadWorks.
Solo un'istanza delle applicazioni Xsi-Events deve essere distribuita su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome di chiamataControlApplication definito in Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> ottenere
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o il fatto di non avere lo stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia.
Configurazione del servizio di autenticazione (con mTLS)
I token longevi di BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sui tuoi XSP|ADP.
Requisiti
-
I server XSP|ADP che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
-
XSP|ADP devono condividere le stesse chiavi per crittografare/decrittografare token di lunga durata BroadWorks. Copiare queste chiavi in ogni XSP|ADP è un processo manuale.
-
Gli ADP XSP|devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli XSP|ADP include:
-
Distribuire il servizio di autenticazione.
-
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
-
Generare e condividere le chiavi RSA su XSP|ADP.
-
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSPADP|
Su ogni XSP|ADP utilizzato con Webex:
-
Attivare l'applicazione del servizio di autenticazione sul
percorso /authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> attivare application authenticationService /authService
(dove
è la versione di BroadWorks).
-
Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
Distribuzione applicazione/authService
Configurazione della durata del token
-
Controllare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
-
Impostare la durata su 60 giorni (il massimo è 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
impostazione tokenDurationInHours 1440
Genera e condividi chiavi RSA
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittografia di token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori è necessario generare chiavi su un XSP|ADP quindi copiarle su tutti gli altri XS|PADP.
Se si scambiano i tasti o si modifica la lunghezza dei tasti, è necessario ripetere la configurazione seguente e riavviare tutti gli XSP|ADP.
-
Selezionare un XSP|ADP da utilizzare per generare una coppia di chiavi.
-
Utilizzare un client per richiedere un token crittografato da tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(In questo modo viene generata una coppia di chiavi private/pubbliche su XSP|ADP, se non ne esiste già una)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
ExportKeys
-
Copiare il file esportato
/var/broadworks/tmp/authService.keys
nella stessa posizione sugli altri ADP XSP|, sovrascrivendo un file old.keys
se necessario. -
Importare le chiavi su ciascuna delle altre ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al container Web
Il contenitore Web di XSP|ADP richiede l'URL authService in modo che possa convalidare i token.
Su ciascuna delle ADP XSP|:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per lo strumento di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
impostare url http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> aggiungi tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Controllare il parametro con
get
. -
Riavviare XSP|ADP.
Configurazione di TLS e della crittografia sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurazione TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > trasporto > http > interfaccia Server HTTP = Più specifico
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSPADP|
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il
comando get e leggere i
risultati. Dovrebbero essere presenti le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Tomcat obbligatorio un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> get
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
È necessario configurare l'interfaccia HTTP che interagisce con Webex Cloud per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocol>
-
Immettere il comando
get 443
per vedere quali protocolli sono già utilizzati in questa interfaccia. -
Immettere il comando
Aggiungi 443 TLSv1.2
per assicurarsi che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia del server HTTP
Per configurare i crittografia richiesti:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Immettere il comando
get 443
per visualizzare le crittografie già utilizzate in questa interfaccia. Devono essere presenti almeno una delle suite consigliate Cisco (vedere XS|PADP Identity and Security Requirement s nella sezione Overview). -
Immettere il comando
Aggiungi 443
per aggiungere una crittografia all'interfaccia server HTTP.La CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
del server HTTP, utilizzare:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>aggiungere 192.0.2.7 443 TLS_ECDHE_ECDSA_CON_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità del servizio di autenticazione (con mTLS)
-
Accedere a Control Hub con l'account dell'amministratore del partner.
-
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain2023.txt
sul computer locale.Questi file contengono due serie di due certificati. È necessario suddividere i file prima di caricarli negli ADP|XSP. Tutti i file sono obbligatori. -
Suddividere la catena del certificato in due certificati -
combinedcertchain2023.txt
.-
Aprire
combinedcertchain2023.txt
in un editor di testo. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e -----END CERTIFICATE----- , e incollare il blocco di testo in un nuovo
file. -
Salvare il nuovo file come
root2023.txt
. -
Salvare il file originale come
emissione2023.txt
. Il file originale ora deve contenere solo un blocco di testo, racchiuso tra lerighe -----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copiare entrambi i file di testo in una posizione temporanea su XSP|ADP che si sta proteggendo, ad esempio
/var/broadworks/tmp/root2023.txt
e/var/broadworks/tmp/issuing2023.txt
. -
Accedere a XSP|ADP e passare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Eseguire la GuidaUpdateTrust
per visualizzare i parametri e il formato di comando. -
Carica i file del certificato in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot2023
,webexclientissuing
ewebexclientissuing2023
sono esempi di alias per i trust anchors; è possibile utilizzare il proprio purché tutte e quattro le voci siano univoche. -
Confermare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> get
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[autofirmato]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, mTLS è richiesto per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
-
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
ed eseguire il comandoget
per visualizzare le interfacce. -
Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che corrisponde a mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> aggiungi nome porta IPAddress vero vero
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. Essenzialmente, la prima true protegge l'interfaccia con TLS (il certificato server viene creato se richiesto) e la seconda forza true l'interfaccia a richiedere l'autenticazione del certificato
client
(insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> get
Nome porta interfaccia Secure Client Auth Req Cluster Fqdn ======================================================= 192.0.2.7 443 XSP|ADP01.collab.example.net true false 192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (Client Auth Req = true) è abilitato sulla porta 192.0.2.7
444.
TLS è abilitato sulla porta 192.0.2.7
443.
(Opzione) Configurare mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate su XSP|ADP. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, mTLS è richiesto per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
-
Accedere a XSP|ADP di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
ed eseguire il comandoget
per visualizzare le applicazioni in esecuzione. -
Per aggiungere un'applicazione e richiedere l'autenticazione del client (che significa lo stesso di mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiungere IPAddress Port ApplicationName true
Vedere la documentazione XSP|ADP CLI per maggiori dettagli. I nomi delle applicazioni sono elencati in questo elenco. Vero
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiungi 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService alla versione 192.0.2.7:443 e richiede che a tale applicazione sia richiesta e autenticata dal client.
Controlla con ottieni
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> richiedere
Interfaccia Porta IP Nome applicazione Client Autenticazione ======================================================
192.0.2.7 443 AuthenticationService true
Configurazione della gestione dei dispositivi su XSP|ADP, server applicazioni e server profili
Il server profilo e XSP|ADP sono obbligatori per Gestione dispositivi. Tali impostazioni devono essere configurate in base alle istruzioni nella Guida alla configurazione di Gestione dispositivi BroadWorks.
Dove andare avanti
Per la configurazione, è possibile accedere nuovamente al flusso dei documenti principale su Interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca con AuthService
Webex interagisce con il servizio di autenticazione su (autenticazione) TLS reciproca connessione autenticata. Ciò significa che Webex presenta un certificato client e che XSP|ADP deve convalidarlo. Per garantire l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora attendibile su XSP|ADP (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
-
Andare a Impostazioni > Chiamata BroadWorks.
-
Fare clic sul collegamento per il download del certificato.
È possibile ottenere la catena di certificati anche da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt.
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente a XSP|ADP
Il diagramma seguente riepiloga i punti in cui la catena di certificati CA Webex deve essere distribuita in questi tre casi.
Requisiti del certificato TLS reciproca per il proxy con bridge TLS
-
Webex presenta un certificato client firmato dall'autorità di certificazione Webex nel proxy.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità del proxy, pertanto il proxy considera attendibile il certificato client.
-
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta un certificato server firmato pubblicamente con Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3:
Uso chiave estesa X509v3:
1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
-
Le ADP XSP|si fidano delle autorità di certificazione interne.
-
Gli ADP XSP|presentano un certificato del server firmato internamente.
-
Il proxy considera attendibile la CA interna.
Requisiti del certificato TLS reciproca per proxy tls passizzato o XSP in DMZ
-
Webex presenta un certificato client firmato ca Webex agli XSP.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità degli XSP, pertanto gli XSP considerano attendibile il certificato client.
-
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
-
Gli XSP presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP.
Cronologia revisioni documenti
La tabella seguente mostra lo storico delle modifiche apportate a questo documento negli ultimi 12 mesi.
Data |
Versione | Descrizione della modifica | |
---|---|---|---|
04 ottobre 2024 |
2-123 |
| |
10 settembre 2024 |
2-123 |
| |
09 agosto 2024 |
2-122 |
| |
01 agosto 2024 |
2-121 |
| |
25 giugno 2024 |
2-120 |
| |
14 giugno 2024 |
2-119 |
| |
13 maggio 2024 |
2-118 |
| |
10 maggio 2024 |
2-117 |
| |
6 maggio 2024 |
2-116 |
| |
2 maggio 2024 |
2-115 |
| |
10 aprile 2024 |
2-114 |
| |
27 marzo 2024 |
2-113 |
| |
22 marzo 2024 |
2-112 |
| |
7 marzo 2024 |
2-111 |
| |
24 febbraio 2024 |
2-110 |
| |
20 febbraio 2024 |
2-109 |
| |
7 febbraio 2024 |
2-108 |
| |
25 gennaio 2024 |
2-107 |
| |
23 gennaio 2024 |
2-106 |
| |
10 gennaio 2024 |
2-105 |
| |
Panoramica di Webex per Cisco BroadWorks
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione fornisce agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei clienti o forniscono questa soluzione direttamente ai relativi abbonati.
Scopo soluzione
-
Per fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che dispongono già del servizio di chiamata fornito dai provider di servizi BroadWorks.
-
Per fornire il servizio di chiamata basato a BroadWorks a clienti Webex piccoli e medi.
Contesto
In continua continua evoluzione di tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo impegno è spostare le funzionalità di chiamata BroadWorks nell'app Webex e ridurre l'investimento nei client UC-One.
Benefici
-
Prova futura: di fronte all'end-of-life di UC-One Collaborate, movimento di tutti i clienti verso il Unified Client Framework (UCF)
-
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex e conservazione delle chiamate BroadWorks sulla rete di telefonia
Ambito soluzione
-
I clienti esistenti/nuovi e medi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre della chiamata BroadWorks.
-
I clienti Webex esistenti, da piccoli a medi, desiderano aggiungere la chiamata BroadWorks.
-
Non aziende più grandi (ti prego di esaminare il nostro portfolio Enterprise per Webex).
-
Non i singoli utenti (valutare le offerte Webex online).
Le serie di funzioni in Webex per Cisco BroadWorks hanno come obiettivo casi d'uso di piccola e media attività. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità dei sistemi SME e ne valutiamo costantemente l'idoneità per questo segmento. È possibile scegliere di nascondere o rimuovere funzioni altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# |
Requisito |
Note |
---|---|---|
1 |
Patch BroadWorks R22 corrente o superiore | |
2 |
XSP|ADP per XSI, CTI, DMS e authService |
XSP|ADP dedicato per Webex per Cisco BroadWorks |
3 |
XSP|ADP separato per NPS, può essere condiviso con altre soluzioni che utilizzano NPS. |
Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni XSP|ADP e NPS. |
4 |
Convalida token CI (con TLS) configurato per connessioni Webex al servizio di autenticazione. | |
5 |
mTLS configurato per le connessioni Webex all'interfaccia CTI. |
Altre applicazioni non richiedono mTLS. |
6 |
Gli utenti devono esistere in BroadWorks e necessitano dei seguenti attributi, in base alla propria decisione di provisioning:
|
Per e-mail affidabili: Si consiglia di inserire lo stesso indirizzo e-mail nell'attributo ID alternativo anche per consentire agli utenti di accedere con indirizzo e-mail per BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'utilizzo di messaggi e-mail non attendibili può inviare il messaggio e-mail alla cartella della posta indesiderata o dello SPAM dell'utente. L'amministratore potrebbe aver modificato le impostazioni e-mail dell'utente per consentire i domini |
7 |
File DTAF Webex per Cisco BroadWorks per l'app Webex | |
8 |
BW Business Lic o Std Enterprise o Prem Enterprise User Lic + Webex per l'abbonamento Cisco BroadWorks |
Se è già presente una distribuzione di collaborazione esistente, non è più necessario il bundle aggiuntivo UC-One, la collaborazione Lic e le porte della conferenza Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non è necessario apportare ulteriori modifiche se non si accettano i termini del pacchetto Premium. |
9 |
L'indirizzo IP/porte deve essere accessibile attraverso i servizi back-end Webex e le app Webex su Internet pubblico. |
Vedere la sezione "Preparazione della rete". |
10 |
Configurazione TLS v1.2 su XSP|ADP | |
11 |
Per il provisioning Flowworks, il server dell'applicazione deve connettersi all'adattatore di provisioning BroadWorks. La configurazione del proxy in uscita non viene testata o supportato. Se si utilizza un proxy in uscita, si accetta la responsabilità di supportarlo con Webex per Cisco BroadWorks. |
Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è comprendere, preparare, distribuire e gestire la soluzione Webex per Cisco BroadWorks. Le sezioni principali del documento riflettono questo scopo.
Questa guida include informazioni concettuali e materiale di riferimento. Intendiamo coprire tutti gli aspetti della soluzione in questo documento.
La serie minima di attività per la distribuzione della soluzione è la seguente:
-
Raggiungere il team dell'account per diventare un partner Cisco. È obbligatorio esplorare i punti di contatto Cisco per acquisire familiarità (ed essere addestrati). Quando si diventa un partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuire Webex per Cisco BroadWorks > onboarding dei partner in questo documento).
-
Configurare i sistemi BroadWorks per l'integrazione con Webex. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento.
-
Utilizzare Partner Hub per collegare Webex a BroadWorks. Vedere Distribuire Webex per Cisco BroadWorks > l'organizzazione partner in Partner Hub in questo documento.
-
Utilizzare Partner Hub per preparare i modelli di provisioning utente. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento.
-
Testare e eseguire l'onboarding di un cliente mediante il provisioning di almeno un utente. Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test.)
-
Operazioni di alto livello, nell'ordine tipico. Esistono diverse attività determinanti che non è possibile ignorare.
-
Se si desidera creare le proprie applicazioni per gestire Webex per abbonati Cisco BroadWorks, leggere Uso dell'API di provisioning nella sezione Di riferimento di questa guida.
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto.
Funzionamento
Webex per Cisco BroadWorks è un'offerta che integra la chiamata BroadWorks in Webex. Gli abbonati utilizzano una singola applicazione (app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
-
Gli utenti chiamano PSTN numeri di telefono utilizzando l'infrastruttura BroadWorks.
-
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino per introdurre i numeri).
-
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Webex Call" nell'app Webex ( queste chiamate sono app Webex all'app Webex, non all'app Webex PSTN).
-
Gli utenti possono ospitare e partecipare Webex Meetings.
-
Gli utenti possono inviare messaggi l'uno all'altro o negli spazi (chat di gruppo persistente) e usufruire delle funzioni di ricerca e condivisione di file (su infrastruttura Webex).
-
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
-
Dopo averci asserto come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare il rapporto tra l'istanza BroadWorks e Webex.
-
È possibile creare organizzazioni dei clienti in Control Hub e pres effettuare il provisioning degli utenti in tali organizzazioni.
-
Ciascun abbonato in BroadWorks ottiene un'identità Webex in base al relativo indirizzo e-mail (attributo ID e-mail in BroadWorks).
-
Gli utenti eseguono l'autenticazione per BroadWorks o per Webex.
-
I client vengono emessi con token a lungo termine per autorizzarli per i servizi presso BroadWorks e Webex.
L'app Webex al centro di questa soluzione; è un'applicazione che può essere brandable disponibile su desktop Mac/Windows e su dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include le funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzioni di messaggistica, presenza e riunione.
Il client si registra ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i sistemi BroadWorks per garantire un'esperienza di provisioning utente ottimale.
Funzioni e limitazioni
Sono disponibili diversi pacchetti con diverse funzioni.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano un utente tramite softphone, i risultati della ricerca non forniscono alcuna opzione per l'invio di un messaggio.
Gli utenti softphone possono condividere lo schermo durante una chiamata.
Pacchetto "Base"
Il pacchetto di base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti in riunioni "unified space" e riunioni nella sala riunioni personale (PMR). (** vedi la seguente nota per l'eccezione). In questo pacchetto le riunioni possono avere una durata massima di 40 minuti.
Pacchetto "standard"
Questo pacchetto include anche tutto quello che è contenuto nel pacchetto Base, ad esempio fino a 100 partecipanti nelle riunioni "spazio unificato" e nelle riunioni nella sala riunioni personale (PMR).
La condivisione dello schermo all'interno di una riunione PMR ha inizialmente un ruolo svolto solo dall'organizzatore della riunione, ma l'organizzatore può passare il 'ruolo di relatore' a qualsiasi partecipante alla riunione scelto e solo l'organizzatore può assumere nuovamente il ruolo di relatore senza che venga passato dall'ospite corrente.
Pacchetto "Premium"
Questo pacchetto include tutto nel pacchetto Standard più un massimo di 300 partecipanti in una riunione "spazio unificato" e fino a 1000 partecipanti in una sala riunioni personale (PMR).
La condivisione dello schermo all'PMR di un evento è supportata per qualsiasi partecipante.
Confronta pacchetti
Pacchetto |
Chiamata in corso |
Messaggistica |
Riunioni nello spazio Unified |
PMR riunioni |
---|---|---|---|---|
Softphone |
Incluso |
Non incluso |
Nessuno |
Nessuno |
Base |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Standard |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Premium |
Incluso |
Incluso |
300 partecipanti |
1000 partecipanti |
Il limite della riunione nello spazio Unified per gli utenti Base è 100 partecipanti per riunione nello spazio Unified a meno che lo spazio non includa anche gli utenti a cui sono assegnati i pacchetti "Standard" o "Premium", nel qual caso il limite aumenta in base al pacchetto utente organizzatore.
"Riunioni nello spazio Unified" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti "Riunione" o "Pianifica".
"Riunioni PMR" si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale (PMR) di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID).
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per le differenze di supporto delle funzioni di riunione PMR per i pacchetti Base, Standard e Premium.
Funzione riunione |
Supportato con il pacchetto base |
Soportato con il pacchetto standard |
Supportato con pacchetto Preminum |
Commento |
---|---|---|---|---|
Durata riunione |
40 minuti o meno |
Illimitato |
Illimitato | |
Condivisione desktop |
Sì |
Sì |
Sì |
Base: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione desktop solo da parte dell'organizzatore della riunione PMR. Premium: condivisione del desktop da parte di qualsiasi partecipante alla riunione PMR. |
Condivisione di un'applicazione |
Sì |
Sì |
Sì |
Base: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. Standard : condivisione delle applicazioni solo da parte dell'organizzatore della riunione PMR. Premium: condivisione dell'applicazione da parte di qualsiasi partecipante alla riunione PMR. |
Chat tra più parti |
Sì |
Sì |
Sì | |
Lavagna |
Sì |
Sì |
Sì | |
Protezione password |
Sì |
Sì |
Sì | |
App Web - nessun download o plug-in (esperienza ospite) |
Sì |
Sì |
Sì | |
Supporta accoppiamento con dispositivi Webex |
Sì |
Sì |
Sì | |
Controllo piano (disattiva audio di uno / Espelle tutti) |
Sì |
Sì |
Sì | |
Collegamento Riunioni permanenti |
Sì |
Sì |
Sì | |
Acces. sito per riunioni |
Sì |
Sì |
Sì | |
Accesso alla riunione tramite VoIP |
Sì |
Sì |
Sì | |
Blocco |
Sì |
Sì |
Sì | |
Controlli relatore |
No |
No |
Sì | |
Controllo desktop remoto |
No |
No |
Sì | |
Numero di partecipanti |
100 |
100 |
1000 | |
Registrazione salvata in locale nel sistema |
Sì |
Sì |
Sì | |
Registrazione nel cloud |
No |
No |
Sì | |
Registrazione - Storage su cloud |
No |
No |
10 GB per sito | |
Trascrizione delle registrazioni |
No |
No |
Sì | |
Pianificazione riunione |
Sì |
Sì |
Sì | |
Abilita condivisione del contenuto con integrazioni esterne |
No |
No |
Sì |
Base: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. Standard: condivisione di contenuto solo da parte dell'organizzatore della riunione PMR. Premium: condivisione di contenuto da parte di qualsiasi partecipante alla riunione PMR. |
Consenti PMR modifica dell'URL |
No |
No |
Sì |
Base: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori dei partner e delle organizzazioni possono modificare l'URL da Control Hub. Standard: l'URL PMR può essere modificato solo da Partner Hub per Partner e amministratori organizzazione. Premium: gli utenti possono modificare l'URL PMR dal sito Webex. Gli amministratori di partner e organizzazioni possono modificare l'URL da Partner Hub. |
Riunioni in streaming in diretta (ad esempio, su Facebook, Youtube) |
No |
No |
Sì | |
Consentire ad altri utenti di pianificare le riunioni per proprio conto |
No |
No |
Sì | |
Aggiungi organizzatore alternativo |
Sì |
No |
Sì | |
Integrazione delle app (es. Zendesk, Slack) |
Dipende dall'integrazione |
Dipende dall'integrazione |
Sì |
Vedere la sezione Integrazioni delle app di seguito per ulteriori informazioni sul supporto. |
Integrazione con il calendario Microsoft Office 365 |
Sì |
Sì |
Sì | |
Integrazione con Google Calendaring per G Suite |
Sì |
Sì |
Sì | |
Il Centro assistenza Webex pubblica le funzioni e la documentazione per l'utente per Webex all'help.webex.com
. Leggere i seguenti articoli per ulteriori informazioni sulle funzioni:
Funzioni di chiamata
L'esperienza di chiamata è simile a quelle precedenti che utilizzano il motore di controllo chiamate BroadWorks. La differenza rispetto a UC-One Collaborate e UC-One SaaS è che l'app Webex è il soft client principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
-
Zendesk—Solo Premium
-
Slack: solo Premium
-
Microsoft Teams per Webex Meetings—Standard o Premium
-
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
-
Calendario Office 365—Standard o Premium
-
Google Calendaring per G Suite: standard o premium
Supporto infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione per Webex per l'infrastruttura desktop virtuale (VDI).
Supporto per IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Pro Pack per Control Hub
Il servizio aggiuntivo Pro Pack per Control Hub fornisce agli amministratori, alle informazioni di sicurezza e ai funzionari di conformità funzionalità avanzate in sicurezza, conformità e analisi in grado di integrare il software.
Questi servizi aggiuntivi saranno disponibili solo per i pacchetti Standard e Premium.
Per ulteriori informazioni, vedi la Pagina della Guida di Pro Pack per Control Hub.
Roadmap futuro
Per informazioni sulle nostre intenzione per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Gli elementi della roadmap non sono associabili ad alcuna capacità. Cisco si riserva il diritto di disattivare o revisionare uno o tutti di questi elementi nelle release future.
Limiti
Limitazioni provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario per il Webex Meetings sito creato per tale pacchetto.
Se non viene specificato alcun fuso orario nella richiesta di provisioning per il primo utente di ciascun pacchetto, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sul valore predefinito regionale dell'organizzazione degli abbonati.
Se il cliente richiede un fuso orario Webex Meetings sito specifico, specificare il parametro di fuso orario nella richiesta di provisioning
per:
-
il primo abbonato predisposto per il pacchetto standard nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto base nell'organizzazione.
Limitazioni generali
-
Nessuna chiamata nella versione Web del client Webex (si tratta di una limitazione del client, non di una limitazione di soluzione).
-
Webex potrebbe non disporre ancora di tutti i controlli UI per supportare alcune funzioni di controllo chiamate disponibili da BroadWorks.
-
Il client Webex non può essere attualmente con etichetta "White labeled".
-
Quando si creano organizzazioni cliente utilizzando il metodo di provisioning scelto, tali organizzazioni vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. È previsto che partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
-
La generazione di report sulle riunioni e sull'utilizzo dei messaggi è disponibile attraverso l'organizzazione cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti messaggistica
I seguenti limiti di storage dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo spazio di storage massimo per la messaggistica e i file combinati.
-
Base: 2 GB per utente per 3 anni
-
5 GB standard per utente per 3 anni
-
Premium: 10 GB per utente per 5 anni
Per ciascuna organizzazione di clienti, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti Premium può utilizzare un limite di messaggistica e storage file totale di 50 GB. Un singolo utente può superare il limite per utente (10 GB) a condizione che la società sia ancora sotto il valore massimo aggregato (50 GB).
Per gli spazi del team creati, i limiti di messaggistica si applicano al totale aggregato per l'organizzazione del cliente che possiede lo spazio del team. È possibile trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti di messaggistica generali che si applicano agli spazi del team di messaggistica Webex, vedere https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure connessioni a Webex e BroadWorks. I dati archiviati nel cloud Webex e esposti all'utente attraverso l'interfaccia dell'app Webex vengono crittografati sia in viaggio che a riposo.
Ulteriori dettagli sullo scambio dei dati sono disponibili nella sezione Riferimento di questo documento.
Lettura aggiuntiva
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati più vicino alla regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore provider di servizi (utente): Per le attività di manutenzione giornaliere, è possibile gestire le parti in locale (di chiamata) della soluzione utilizzando i propri sistemi. Le parti Webex della soluzione vengono gestite attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale.
Il primo utente predisposto per un nuovo organizzatore partner viene assegnato automaticamente ai ruoli amministratore completo e amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi.
Team operativo Cisco Cloud: Crea l'organizzazione partner in Partner Hub, se non esiste, durante il processo di onboarding.
Una volta che si dispone dell'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente, create "Onboarding templates" (Modelli di onboarding) per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Si eservi quindi il provisioning dei propri clienti o abbonati.
# |
Attività tipica |
SP |
Cisco |
---|---|---|---|
1 |
Onboarding del partner: creazione dell'organizzazione partner, se presente, e abilitazione delle attivazioni/disattivazioni delle funzioni necessarie |
● | |
2 |
Configurazione BroadWorks nell'organizzazione partner tramite Hub partner (cluster) |
● | |
3 |
Configurazione delle impostazioni di integrazione nell'organizzazione partner tramite Partner Hub (modelli di offerta, branding) |
● | |
4 |
Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|ADP Patching, firewall, configurazione XS|PADP, XSI, AuthService, CTI, NPS, applicazioni DMS su XS|PADP) |
● | |
5 |
Sviluppo di un'integrazione o di un processo di provisioning |
● | |
6 |
Prepara materiali GTM |
● | |
7 |
Esegui migrazione o provisioning di nuovi utenti |
● |
Architettura
Che cos'è nel diagramma?
Client
-
Il client Webex App svolge la funzione di applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di riunioni audio/video native di messaggistica, presenza e multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per chiamate SIP PSTN chiamate.
-
I telefoni Cisco IP e relativi accessori utilizzano anche l'infrastruttura BroadWorks per SIP e chiamate PSTN telefoniche. Ci vediamo in grado di supportare telefoni di terze parti.
-
Portale di attivazione utente per consentire agli utenti di accedere a Webex utilizzando le credenziali BroadWorks.
-
Partner Hub è un'interfaccia Web per l'amministrazione della propria organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. È anche possibile utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
provider di servizi di rete
Il blocco verde a sinistra del diagramma rappresenta la rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
-
XSP|ADP rivolto al pubblico, per Webex per Cisco BroadWorks: (La scatola rappresenta una o più fattorie XSP|ADP, eventualmente frontali da bilanciatori di carico).
-
Ospita l'interfaccia XSI-Actions &XSI-Events, Device Servizio di gestione (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato di hook degli altri (presenza di telefonia) e cronologia chiamate.
-
Pubblica la directory sui client Webex.
-
-
XSP|ADP rivolto al pubblico, con NPS in esecuzione:
-
Server push notifiche chiamate host: Un server push di notifica su un ADP XSP| nel proprio ambiente. Interfaccia tra il server applicazioni e il nostro proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS &FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
-
-
Server applicazione:
-
Fornisce il controllo e le interfacce delle chiamate ad altri sistemi BroadWorks (in genere)
-
Per il provisioning flowre, l'AS viene utilizzato dall'amministratore del partner per eseguire il provisioning degli utenti in Webex
-
Inserisce profilo utente in BroadWorks
-
-
SISTEMA SISTEMA AVAIO/BSS: Sistema di supporto operativo/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nel diagramma rappresenta il cloud Webex. I microservizi Webex supportano tutte le funzionalità di collaborazione Webex:
-
Cisco Common Identity (CI) è il servizio di identità all'interno di Webex.
-
Webex per Cisco BroadWorks rappresenta l'insieme di microservizi che supportano l'integrazione tra Webex e provider di servizi BroadWorks ospitate:
-
API di provisioning utenti
-
provider di servizi configurazione
-
Accesso utente tramite credenziali BroadWorks
-
-
casella Messaggistica Webex per microservizi correlati alla messaggistica.
-
Webex Meetings che rappresenta i server di elaborazione multimediale e i controller SBC per le riunioni video con più partecipanti (SIP & SRTP)
Servizi Web di terze parti
I seguenti componenti di terze parti vengono rappresentati nel diagramma:
-
APNS (Apple Push Notifications Service) inserisce le notifiche di chiamate e messaggi nelle applicazioni Webex sui dispositivi Apple.
-
FCM (FireBase Cloud Messaging) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Il ruolo dei server XSPADP rivolti al pubblico in Webex per Cisco BroadWorks|
L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
-
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste di BroadWorks J JSON (Token Web JSON) per conto dell'utente
-
Interfaccia CTI protetta da mTLS, a cui Webex esegue l'abbonamento per eventi cronologia chiamate e stato della presenza di telefonia da BroadWorks (stato hook).
-
Interfacce di azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate, le directory di contatto e di elenco delle chiamate e la configurazione del servizio di telefonia dell'utente finale
-
Servizio DM (Device Management) per i client per recuperare i file di configurazione delle chiamate
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedere Configurazione dei cluster BroadWorks in Partner Hub in questo documento. Per ciascun cluster, è possibile fornire un solo URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP
È necessario utilizzare un'istanza ADP XSP|dedicata o un'azienda agricola separata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile organizzare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso XSP|ADP che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/azienda agricola ADP XSP| dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
-
Ad esempio, se offri UC-One SaaS, ti consigliamo di creare una nuova fattoria XSP|ADP per Webex per Cisco BroadWorks. In questo modo i due servizi possono funzionare in modo indipendente durante la migrazione degli abbonati.
-
Se si collocano le applicazioni Webex per Cisco BroadWorks in una fattoria ADP|XSP utilizzata per altri scopi, è responsabilità dell'utente monitorare l'utilizzo, gestire la complessità risultante e pianificare l'aumento della scala.
-
Il pianificatore della capacità di sistema Cisco BroadWork s assume una fattoria ADP XS|P dedicata e potrebbe non essere preciso se la si utilizza per i calcoli della posizione.
Se non diversamente specificato, gli Webex dedicati per Cisco BroadWorks XSP|ADP devono ospitare le seguenti applicazioni:
-
AuthService (TLS con convalida token CI o mTLS)
-
CTI (mTLS)
-
Azioni XSI (TLS)
-
XSI-Events (TLS)
-
DMS (TLS): opzionale. Non è obbligatorio distribuire un'istanza DMS o un'azienda agricola separata specificamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
-
TLS (Call Settings Webview): opzionale. La vista Webview (CSW) delle impostazioni di chiamata è richiesta solo se si desidera che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso al CTI attraverso un'interfaccia protetta (autenticazione) TLS reciproca autenticazione. Per supportare questo requisito, si consiglia una di queste opzioni:
-
(Diagramma etichettato Opzione 1) Una istanza XS|PADP o un'azienda agricola per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
-
(Diagramma etichettato Opzione 2) Due istanze ADP XS|P o aziende agricole, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSPADP|
Se si dispone di una fattoria ADP XSP|esistente conforme a una delle architetture suggerite sopra (Opzione 1 o 2) ed è leggermente caricata, è possibile riutilizzare le ADP XS|Pesistenti. Dovrai verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti dell'applicazione per Webex. Le due considerazioni principali sono:
-
Se è necessario supportare più organizzazioni partner Webex sull'ADP XSP|, ciò significa che è necessario utilizzare mTLS sul servizio di autenticazione (la convalida del token CI è supportata solo per una singola organizzazione partner su un'ADP XS|P). Se si utilizza mTLS sul servizio di autenticazione, ciò significa che non è possibile avere client che stanno utilizzando l'autenticazione di base sul servizio di autenticazione allo stesso tempo. Questa situazione impedirebbe il riutilizzo di XSP|ADP.
-
Se il servizio CTI esistente configurato per essere utilizzato dai client con la porta protetta (solitamente 8012) ma senz a mTLS (ossia autenticazione client), ciò entrerà in conflitto con il requisito Webex di disporre di mTLS.
Poiché gli XSP|ADP hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero esserci altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di XSP|ADP deve essere verificato in un laboratorio con la configurazione desiderata prima di impegnarsi per il riutilizzo.
Configurazione della sincronizzazione NTP su XSPADP|
La distribuzione richiede la sincronizzazione temporale per tutti gli XSP|ADP utilizzati con Webex.
Installare il pacchetto ntp
dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Quindi è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, vedere la Guida alla gestione software BroadWorks.
Durante l'installazione interattiva del software XSP|ADP, è possibile configurare NTP. Procedere come segue:
-
Quando viene visualizzato il programma di installazione,
configurare NTP?
, inserire y.
-
Quando il programma di installazione richiede,
questo server deve essere un server NTP? , inserire n
.
-
Quando il programma di installazione richiede, Qual è l'indirizzo NTP, il nome host o nome di dominio completo? , inserire l'indirizzo del server NTP o un servizio
NTP pubblico, ad esempio,
pool.ntp.org
.
Se gli ADP XSP|utilizzano un'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie Key=Value:
NTP
NTP_SERVER=
Requisiti di identità e sicurezza XSP|ADP
Sfondo
I protocolli e i tipi di crittografia delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli variano dal più generale (provider SSL) alla più specifica (singola interfaccia). Un'impostazione più specifica sovrascrive sempre un'impostazione più generale. Se non vengono specificate, le impostazioni SSL di livello 'inferiore' vengono ereditano dai livelli superiori.
Se non viene modificata alcuna impostazione dai valori predefiniti, tutti i livelli ereditano le impostazioni predefinite del provider SSL (estensione JSSE Java Secure Sockets).
Elenco requisiti
-
L'|ADP XSP deve autenticarsi sui client utilizzando un certificato firmato da CA in cui il nome comune o il nome alternativo oggetto corrispondono alla parte di dominio dell'interfaccia XSI.
-
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
-
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
-
Diffie-Hellman Ephemeral (DHE) o Curve ellittiche Diffie-Hellman Ephemeral (ECDHE) key-exchange
-
Crittografia AES (Advanced Encryption Standard) con una dimensione di blocco minima di 128 bit (ad esempio, AES-128 o AES-256)
-
Modalità di crittografia GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
-
Se viene utilizzata la crittografia CBC, solo la famiglia di funzioni hash SHA2 è consentita per la derivazione chiave (SHA256, SHA384, SHA512).
-
-
Ad esempio, i seguenti tipi di crittografia soddisfano i requisiti:
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come illustrato sopra, non la convenzione openSSL.
Tipi di crittografia TLS supportati per le interfacce AuthService e XSI
Questo elenco è soggetto a modifica quando i requisiti di sicurezza del cloud cambiano. Seguire i suggerimenti sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento.
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
-
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
-
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_128_GCM_SHA256
-
TLS_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_256_CBC_SHA256
-
TLS_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_WITH_AES_256_CBC_SHA
-
TLS_PSK_WITH_AES_256_CBC_SHA384
-
TLS_PSK_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_WITH_AES_128_CBC_SHA
-
TLS_PSK_WITH_AES_128_CBC_SHA256
-
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il conteggio dei thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi mostrati, come segue (non diminuire, se sono superiori ai valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventoHandlerThreadCount = 50
Più |ADP XSP
Elemento Edge di bilanciamento del carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, deve gestire in modo trasparente la distribuzione del traffico tra più server XSP|ADP e il cloud e i client Webex per Cisco BroadWorks. In questo caso, si fornisce l'URL del servizio di bilanciamento del carico a Webex per la configurazione Cisco BroadWorks.
Note su questa architettura:
-
Configurare DNS in modo che i client possano trovare il servizio di bilanciamento del carico quando si connettono all'interfaccia Xsi (vedere Configurazione DNS).
-
Si consiglia di configurare l'elemento Edge in modalità proxy SSL inverso per accertarsi che la crittografia dati point-to-point.
-
I certificati di XSP|ADP01 e XS|PADP02 devono entrambi avere il dominio XS|PADP, ad esempio your-XS|PADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Server XSPADP orientati verso Internet|
Se si espongono direttamente le interfacce Xsi, utilizzare il DNS per distribuire il traffico ai più server XSP|ADP.
Note su questa architettura:
-
Per connettersi ai server XSP|ADP sono necessari due record:
-
Per i microservizi Webex: Per targetizzare più indirizzi IP XSP|ADP sono necessari record A/AAAA round-robin. Questo perché i microservizi Webex non possono effettuare ricerche SRV. Per esempi, vedere Servizi cloud Webex.
-
Per l'app Webex: Un record SRV che si risolve in record A in cui ogni record A si risolve in un singolo XSP|ADP. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per targetizzare il servizio XSI per più indirizzi XSP|ADP. Assegnare la priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (e all'indirizzo IP successivo) e passino al record A successivo (e all'indirizzo IP) solo se il primo indirizzo IP è inattivo. NON utilizzare un approccio round-robin per l'app Webex.
-
-
I certificati di XSP|ADP01 e XS|PADP02 devono entrambi avere il dominio XS|PADP, ad esempio your-XS|PADP.example.com, nel nome alternativo oggetto. Devono avere i propri FQDN, ad esempio XSP|ADP01.example.com, nel nome comune.
-
È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL XSP|ADP di un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server XS|PADP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.
Ordinazione e provisioning
Ordinazione e provisioning si applicano a questi livelli:
-
Provisioning di partner/provider di servizi:
Ciascun Webex per Cisco BroadWorks provider di servizi (o rivenditore) presente deve essere configurato come organizzazione partner in Webex e disporre dei diritti necessari. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per la gestione di Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le attività di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/Enterprise.
-
Ordinazione e provisioning clienti/aziende:
Ciascuna azienda BroadWorks abilitata per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo viene eseguito automaticamente come parte del provisioning dell'utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks sono predisposti nella stessa organizzazione clienti Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
-
Ordinazione e provisioning utente/abbonato:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning utente:
-
Provisioning Flow con e-mail attendibili
-
Provisioning flow senza messaggi e-mail attendibili
-
Self-provisioning utente
-
Provisioning API
-
Provisioning eseguibile con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile asserre che BroadWorks abbia indirizzi e-mail dell'abbonato validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Provisioning flow senza messaggi e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non si può contare sugli indirizzi e-mail dell'abbonato tenuti da BroadWorks, questa opzione di provisioning crea account Webex, ma non può attivarli fino a quando gli abbonati non forniscono e convalidano gli indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Self-Provisioning utente
Con questa opzione, non esiste provisioning flowworks da BroadWorks a Webex. Dopo aver configurato l'integrazione tra Webex e il sistema BroadWorks, si ottengono uno o più collegamenti specifici per il provisioning degli utenti all'interno di Webex per l'organizzazione partner Cisco BroadWorks.
Si progettare quindi le proprie comunicazioni (o delegare ai clienti) la distribuzione del collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account sono predisposti nell'ambito dell'organizzazione partner, è possibile regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare questa operazione.
Gli utenti devono essere presenti nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento.
provider di servizi provisioning da PARTE delle API
Webex sono esposti una serie di API pubbliche che consentono di creare Webex per il provisioning di utenti/abbonati Cisco BroadWorks nel flusso di lavoro/strumenti di gestione degli utenti esistenti.
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Installare AP.as.22.0.1123.ap376508.
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Installare AP.as.23.0.1075.ap376509
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Installazione di AP.as.24.0.944.ap375100
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning di nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per utenti Cisco BroadWorks.
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti Webex per Cisco Broadworks di comporre altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella rubrica Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo dell'estensione di tutte le aree del metodo di avvio chiamata e del profilo dell'utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e gruppi diversi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due imprese che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
-
Utenti Cisco BroadWorks
-
Provisioning API pubblica come 'interno
-
Il parametro dell'interno deve essere esplicitamente passato come parte della chiamata API. Per le imprese/gruppi con Location Dialing Code (LDC) configurato, il parametro dell'interno dovrebbe essere la combinazione di LDC e 'numero di interno.
-
-
Provisioning flusso o auto-attivazione
-
Estensione e LDC (se applicabile) saranno automaticamente recuperati da BroadWorks.
-
-
-
Utenti o entità di chiamata solo BroadWorks
-
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione di codice di chiamata posizione (LDC) e numero di interno.
-
Record chiamata BroadWorks |
Descrizione |
Metodo di provisioning |
Gestione dell'interno |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
API pubblica |
L'estensione deve essere passata come parametro |
Attraverso il flusso |
Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks |
Utenti di chiamata che non hanno eseguito l'onboarding in Webex |
Sinc rubrica |
Interno sincronizzato per sincronizzazione rubrica |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sinc rubrica | Interno sincronizzato per sincronizzazione rubrica |
Elenchi telefonici BroadWorks |
Elenchi telefonici aziendali, di gruppo o personali |
Sinc rubrica |
Non applicabile |
Prerequisiti
-
La versione del client richiesta per supportare questa funzione è 42.11 o successiva.
-
Patch in cui i codici di chiamata di estensione e posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
-
AP.platform.23.0.1075.ap380045
-
AP.as.23.0.1075.ap380045
-
AP.xsp.23.0.1075.ap380045
-
AP.as.24.0.944.ap380045
-
-
Abilitare l'intestazione X-BroadWorks-Remote-Party-Info su AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP richiesto per il supporto della funzione di composizione dell'interno.
AS_CLI/System/DeviceType/SIP> impostazione <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata a interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità delle chiamate di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'estensione come seconda opzione in Partner Hub e Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con estensione attraverso uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione dell'interno sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Non verrà visualizzata un'estensione nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere visibile l'opzione di chiamata dell'interno per i clienti esistenti:
-
Se un partner desidera che tutte le organizzazioni dei clienti gestite siano dotate di un interno come una delle opzioni di chiamata, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
-
Se un partner desidera fornire un interno in opzioni di chiamata per una specifica organizzazione cliente, si consiglia all'amministratore del partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e portarli alla pari con l'aumento di 30K contatti per l'elenco telefonico Enterprise, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per Organizzazione, che si applica alla somma degli elenchi telefonici Enterprise e di gruppo in una singola azienda BroadWorks. Ad esempio, sarà supportato un'azienda BroadWorks che dispone di un elenco di telefoni aziendali con 30K e anche di 5 elenchi di telefoni di gruppo ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K totali).
Questa funzione è disponibile su richiesta. Contatta il team dell'account per abilitare questa opzione.
-
Prima di abilitare la funzione, è necessario eseguire una migrazione di prerequisito per eseguire il provisioning e associare i gruppi per tutti gli utenti predisposti esistenti.
-
Il team Cisco eseguirà un'API interna per eseguire la migrazione di eventuali utenti predisposti esistenti per associarli al gruppo corretto. NOTA: L'elaborazione può richiedere fino a una settimana.
-
Una volta completata la migrazione per il partner e abilitata la funzione, tutti gli utenti di recente provisioning verranno 'raggruppati' in modo appropriato.
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks nello storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare a quale gruppo appartiene questo utente. L'associazione dell'utente con un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca dei contatti nello storage del gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning degli abbonati Webex per BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
È possibile eseguire il provisioning dell'ID gruppo aziendale BroadWorks per gli utenti Cisco BroadWorks utilizzando i seguenti metodi:
-
Webex per utenti Cisco BroadWorks
-
Provisioning API pubblica come "spEnterpriseGroupId"
-
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
-
-
Provisioning flusso o auto-attivazione
-
L'ID gruppo aziendale BroadWorks verrà automaticamente recuperato da BroadWorks.
-
-
Utenti o entità di chiamata solo BroadWorks
-
Non applicabile. Non è necessario sincronizzare l'ID gruppo aziendale BroadWorks per questi utenti.
-
-
Record chiamata BroadWorks |
Descrizione |
Metodo di provisioning |
Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
API pubblica |
L'ID gruppo aziendale BroadWorks deve essere superato come parametro spEnterpriseGroupId |
Attraverso il flusso |
L'ID gruppo aziendale BroadWorks viene recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks |
Utenti di chiamata che non hanno eseguito l'onboarding in Webex |
Sinc rubrica |
Non applicabile |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sinc rubrica |
Non applicabile |
Elenchi telefonici BroadWorks |
Contatti negli elenchi telefonici del gruppo BroadWorks |
Sinc rubrica |
I contatti di gruppo vengono memorizzati nel servizio Webex Contact associato al gruppo specifico |
Elenchi di telefoni BroadWorks Enterpsie o Persional |
Contatti negli elenchi telefonici aziendali o personali |
Sinc rubrica |
Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. Impossibile completare la migrazione fino a quando QUESTA API non viene completata. L'Id gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march
Una volta abilitata la funzione e a seguito della sincronizzazione della rubrica successiva, i gruppi di utenti aziendali verranno visualizzati anche in Control Hub. La visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativa in questa fase. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza a un gruppo in Control Hub poiché tali modifiche non verranno riportate nuovamente in BroadWorks. La gestione di gruppo in Control Hub è destinata all'uso da parte dei partner che adotteranno le prossime API di gestione contatti.
Migrazione e prova futura
Cisco il client BroadSoft unified Communications deve passare da UC-One a Webex. Esiste una corrispondente lingua dei servizi di supporto lontani dalla rete provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che tu stia eseguendo UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita consiste nel distribuire nuovi ADP|XSP dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti a Webex e, infine, recuperare l'infrastruttura utilizzata per la soluzione precedente.
Sottoscrizioni di documenti consigliate
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Abbonat i che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di eseguire l'abbonamento a ciascuno dei seguenti articoli per assicurarsi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per iscriversi, accedere a ciascuno dei link seguenti e nell'articolo che viene lanciato fare clic sul pulsante Iscrivit i.
Come minimo, si consiglia di iscriversi all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati in Documenti aggiuntiv i dispone di un'opzione Sottoscriv i . Affinché questa opzione venga visualizzata, l'articolo deve essere visualizzato su help.webex.com.
Non esiste un'opzione di abbonamento per le landing page di documentazione.
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Documenti Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
-
Porta la tua soluzione PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono di loro proprietà (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
-
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive come eseguire l'onboarding e il servizio dei dispositivi Room OS e MPP.
-
Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi di Webex per Cisco BroadWorks.
Articoli di Webex per Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti siti opzionali per ulteriori informazioni su Webex per Cisco BroadWorks:
-
Documentazione Webex per Cisco BroadWorks: nella pagina di destinazione vengono elencati i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
-
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme a quelle presto disponibili.
-
Problemi noti e limitazioni: informazioni sui problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
-
Ruoli amministratore partner per Webex per BroadWorks e RTM Wholesale: questo articolo descrive come assegnare i ruoli amministratore partner per le organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte della soluzione Cisco BroadWorks:
Articoli della Guida Webex
I seguenti siti della Guida Webex possono essere utilizzati per trovare gli articoli Webex che consentono agli amministratori dei clienti e agli utenti finali di utilizzare le funzioni Webex.
-
Webex da provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati comunemente per gli utenti dell'app Webex che hanno acquistato i servizi Webex da un provider di servizi.
-
Centro assistenza Webex: utilizzare la funzione di ricerca su help.webex.com per cercare altri articoli Webex che descrivono la funzionalità dell'app Webex e di Webex Meetings. È possibile ricercare gli articoli utente o amministratore.
Documentazione sviluppatore
-
Guida per sviluppatori Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Preparazione dell'ambiente
Punti decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastruttura
|
Quanti ADP XSP|? Come prendono mTLS? |
Pianificatore capacità sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento CLI XSPADP| Questo documento |
Provisioning clienti e utenti |
Si può asserre che si considera attendibili i messaggi e-mail in BroadWorks? Si desidera che gli utenti forniranno gli indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Doc API pubblici su https://developer.webex.com Questo documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo sul branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso dei clienti? | Questo documento |
Funzioni dell'abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o softphone. |
Questo documento Matrice funzioni/pacchetto |
Autenticazione utente | BroadWorks o Webex | Questo documento |
Adattatore di provisioning (per le opzioni di provisioning flow) |
Utilizzi già IM&P integrato, ad esempio per UC-One SaaS? Utilizzare più modelli? Esiste un caso d'uso più comune previsto? |
Questo documento Riferimento CLI server applicazione |
Architettura e infrastruttura
-
Con quale scala intendete iniziare? È possibile aumentare la scalabilità in futuro, ma la stima d'uso corrente deve guidare la pianificazione dell'infrastruttura.
-
Collaborare con il proprio account manager/rappresentante di vendita Cisco per dimensionare l'infrastruttura ADP XSP|, in base al Cisco BroadWorks System Capacity Planne r e alla Cisco BroadWorks System Engineering Guide.
-
In che modo Webex renderà le connessioni TLS reciproche alle tue ADP XSP|? Direttamente a XSP|ADP in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce. (Non supportiamo connessioni TCP non crittografate al perimetro della rete).
Provisioning clienti e utenti
Quale metodo di provisioning utente si adatta meglio alle esigenze?
-
Provisioning eseguibile con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene automaticamente predisposto in Webex.
Se è anche possibile asserre che gli indirizzi e-mail dell'abbonato nella BroadWorks siano validi e univoci per Webex, è possibile utilizzare la varianti "e-mail attendibile" del provisioning flow provisioning. Gli account Webex del sottoscrittore vengono creati e attivati senza il loro intervento; semplicemente scaricare il client ed eseguire l'accesso.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto l provider di servizi deve specificare un indirizzo e-mail valido per l'utente per potervi fornire i servizi Webex. Deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo nell'attributo ID alternativo.
-
Provisioning eseguibile senza e-mail attendibili: Se non si riesce a verificare l'attendibilità degli indirizzi e-mail dell'abbonato, è comunque possibile assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
-
Self-provisioning utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. L'utente (o i clienti) distribuiscono invece un collegamento di provisioning e i collegamenti per scaricare diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex. Quindi scaricano il client e a quel punto Webex recuperano alcune configurazioni aggiuntive su di esse da BroadWorks (inclusi i numeri principali).
-
Provisioning controllato da SP tramite API: Webex sono esposti una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti di sistema generali descritti in questa guida.
Metodo di provisioning |
Requisiti |
---|---|
Provisioning Flow (e-mail attendibili o non attendibili) |
L'API di provisioning Webex aggiunge automaticamente gli utenti BroadWorks esistenti a Webex una volta che l'utente soddisfa i requisiti e si attiva il servizio Integrated IM+ P. Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Self-Provisioning utente |
L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato il messaggio e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello di onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) |
Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono previsti due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, vai a Utenti BroadWorks. |
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Installare AP.as.22.0.1123.ap376508.
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Installare AP.as.23.0.1075.ap376509
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Installazione di AP.as.24.0.944.ap375100
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning di nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per utenti Cisco BroadWorks.
Impostazioni internazionali lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente amministrativo predisposto viene assegnata automaticamente come impostazioni internazionali predefinite per tale organizzazione cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti alle riunioni in tale organizzazione del cliente.
Sono supportate le impostazioni internazionali in lingua a cinque caratteri (ISO-639-1)_(ISO-3166). Ad esempio, en_US corrisponde a nglish_EUnitedStates. Se viene richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genera un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso internazionale dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, viene utilizzata l'impostazione locale ragionevole predefinita in base al codice della lingua richiesto.
Nella tabella riportata di seguito vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice lingua a due lettere in un'impostazione locale a cinque caratteri per le situazioni in cui un'impostazione locale a cinque caratteri non è disponibile.
Impostazioni internazionali lingua supportate (ISO-639-1)_(ISO-3166) |
Se è disponibile solo un codice lingua a due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** |
Usa impostazioni internazionali sensibili di default (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA |
it |
en_USA |
fr_FR fr_CA |
Fr |
fr_FR |
cs_CZ |
cs |
cs_CZ |
da_DK |
da |
da_DK |
de_DE |
DE |
de_DE |
hu_HU |
hu |
hu_HU |
id_ID |
Identificativo |
id_ID |
it_IT |
esso |
it_IT |
ja_JP |
ja |
ja_JP |
ko_KR |
ko |
ko_KR |
es_ES es_CO es_MX |
es |
es_ES |
nl_NL |
NL |
nl_NL |
nb_NO |
nb. |
nb_NO |
pl_PL |
pl. |
pl_PL |
pt_PT pt_BR |
pt |
pt_PT |
ru_RU |
RU |
ru_RU |
ro_RO |
ro |
ro_RO |
zh_CN zh_TW |
zh |
zh_CN |
sv_SE |
sv |
sv_SE |
ar_SA |
ar |
ar_SA |
tr_TR |
tr |
tr_TR |
Le impostazioni internazionali es_CO,id_ ID,nb_ NO ept_ PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti Webex Meetings saranno solo in inglese. Inglese è la impostazioni internazionali predefinite per i siti se per il sito non sono richieste impostazioni internazionali non valide/non supportate. Questo campo lingua è applicabile durante la creazione di un'organizzazione e un sito Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, la lingua del modello verrà utilizzata come lingua predefinita.
Branding
Gli amministratori dei partner possono utilizzare personalizzazioni di branding avanzate per personalizzare il modo in cui l'app Webex cerca le organizzazioni dei clienti gestite dal partner. Gli amministratori dei partner possono personalizzare le seguenti impostazioni per assicurarsi che l'app Webex rifletta il marchio e l'identità della propria società:
-
Loghi aziendali
-
Schemi di colore univoci per la modalità chiaro o la modalità scura
-
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione delle personalizzazioni di branding avanzate.
-
Le personalizzazioni di branding di base sono in via di estinzione. Si consiglia di distribuire il branding avanzato, che offre una gamma più ampia di personalizzazioni.
-
Per informazioni dettagliate su come viene applicato il branding quando si collega a un'organizzazione cliente preesistente, fare riferimento all'Allegato Condizioni dell'organizzazion e nella sezione Allega Webex per BroadWorks all'organizzazione esistent e .
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding come richiesto, ma quando si esegue l'onboarding di un cliente è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Di seguito sono elencati alcuni parametri del modello principale.
Pacchetto
-
È necessario selezionare un pacchetto predefinito quando si crea un modello (per informazioni dettagliate, vedere Pacchetti nella sezione Panoramica). Tutti gli utenti predisposti con tale modello, mediante flusso o auto-provisioning, ricevono il pacchetto predefinito.
-
È possibile controllare la selezione del pacchetto per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori per provisioning aziendali, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
-
Puoi modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedi Webex per la documentazione API Cisco BroadWork s o attraverso Partner Hub (vedi Modifica pacchetto utente in Partner Hub).
-
Non è possibile modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è disattivata; se l'abbonato è assegnato a questo servizio in BroadWorks, il modello Hub partner associato all'URL di provisioning di tale azienda definisce il pacchetto.
Rivenditori e aziende o provider di servizi e gruppi?
-
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se si è un rivenditore con Aziende, è necessario abilitare la modalità Enterprise quando si crea un modello.
-
Se il sistema BroadWorks è configurato in provider di servizi modalità aziendale, è possibile lasciare disattivata la modalità Enterprise nei modelli.
-
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch broadworks richieste per il provisioning flow-through. Per informazioni dettagliate, vedere Patch richieste con provisioning flow-through.
Accertarsi di aver applicato le patch broadworks richieste per il provisioning flow-through. Per informazioni dettagliate, vedere Patch richieste con provisioning flow-through.
Modalità di autenticazione
Decidi come desideri che gli abbonati eseguano l'autenticazione quando accedono a Webex. È possibile assegnare la modalità utilizzando l'impostazione Modalità di autenticazion e nel modello di onboarding. Nella tabella seguente sono riportate alcune opzioni.
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | File BroadWorks ID utente | Indirizzo e-mail |
provider di identità |
BroadWorks.
| Cisco Common Identity |
Autenticazione multi-fattori? | No | Richiede un IdP cliente che supporti l'autenticazione a più fattori. |
Percorso di convalida credenziali
|
|
|
Per una descrizione dettagliata del flusso SSO accesso con autenticazione diretta a BroadWorks, vedere SSO login flow.
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che si può verificare con password che utilizzano caratteri speciali per cui il browser Web non codifica correttamente i caratteri. Utilizzando un'intestazione con codifica UTF-8, con codifica base 64, risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
-
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
-
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> set authenticationEncoding UTF-8
Paese
Quando si crea un modello, è necessario selezionare un paese. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie S. |
Posizione |
Prefisso internazionale |
Nome paese |
---|---|---|---|
1 |
AMER |
+1 |
Stati Uniti, California |
2 |
APAC |
+65 |
Singapore |
3 |
Anz |
+61 |
Australia |
4 |
EMEA |
+44 |
Regno Unito |
5 |
EURO |
+49 |
Germania |
Accordi con più partner
Si desidera utilizzare la licenza secondaria di Webex per Cisco BroadWorks con un altro provider di servizi? In tal caso, ciascun fornitore di servizi avrà bisogno di un'organizzazione partner distinta Webex Control Hub permettere loro di fornire la soluzione per la propria base clienti.
Adattatore e modelli di provisioning
Quando si utilizza il provisioning flowre, l'URL di provisioning inserito in BroadWorks è derivato dal modello in Control Hub. È possibile disporre di più modelli e, quindi, di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati quando hanno ottenuto la concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e il modello che si desidera utilizzare. In questo modo, è necessario solo impostare in modo esplicito l'URL di provisioning per le aziende che necessitano di un modello diverso.
Tenere presente, inoltre, che potrebbe essere stato già utilizzato un URL di provisioning a livello di sistema, ad esempio UC-One SaaS. In tal caso, è possibile scegliere di mantenere l'URL a livello di sistema per il provisioning degli utenti su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile passare al percorso alternativo e impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono dettagliate in Configura server applicazioni con URL servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning flowthrough tra AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server AS e Webex, annullando in tal modo la necessità di connettersi direttamente al servizio Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati disponibili per Webex devono esistere nel sistema BroadWorks integrato con Webex. Se necessario, è possibile integrare più sistemi BroadWorks.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero o interno principale.
Webex utilizza gli indirizzi e-mail come identificativi principali per tutti gli utenti. Se si utilizza il provisioning flow con messaggi e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail dell'abbonato nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le relative password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo di utenti di chiamata BroadWorks con un numero principale e/o interno. Se si utilizza il provisioning flowthrough, agli utenti deve essere assegnato anche il servizio IM&P integrato.
Server nella rete e requisiti software
-
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere la sezione Politica sul ciclo di vita dei prodotti BroadSoft in BroadSoft Lifecycle Policy e BroadWorks Software Compatibility Matrix.
-
Le istanze BroadWorks devono includere almeno i seguenti server:
-
Server applicazioni (AS) con versione BroadWorks come indicato sopra
-
Server di rete (NS)
-
Server di profilo (PS)
-
-
Server XSP|ADP o piattaforma di distribuzione delle applicazioni (ADP) di fronte al pubblico che soddisfano i seguenti requisiti:
-
Servizio di autenticazione (BWAuth)
-
Interfacce azioni ed eventi XSI
-
DMS (applicazione Web di gestione dispositivi)
-
Interfaccia CTI (integrazione di telefonia su computer)
-
TLS 1.2 con un certificato valido (non autofirmato) ed eventuali intermedie richiesti. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
-
Autenticazione TLS reciproca (mTLS) per il servizio di autenticazione (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
Autenticazione TLS reciproca (mTLS) per interfaccia CTI (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
-
Un server XSP/ADP separato funge da "server push notifiche di chiamata" (un server NPS nel proprio ambiente utilizzato per eseguire il push delle notifiche di chiamata ad Apple/Google. Questo tipo di chiamata "CNPS" viene chiamata qui per distinguerlo dal servizio in Webex che offre notifiche push per messaggistica e presenza).
Questo server deve essere su R22 o versioni successive.
-
È obbligatorio creare un server XSP/ADP separato per CNPS poiché l'impossibilità di caricare da Webex per connessioni cloud BWKS potrebbe avere un impatto negativo sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSP|ADP, consultare la Guida tecnica di sistema Cisco BroadWork s.
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, andare a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
-
PC/laptop Windows
-
PC Apple / laptop con MacOS
-
iOS (Apple store)
-
Android (Play store)
-
Browser Web (vai a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
-
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
-
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
-
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
-
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (tradizionale cinese)
-
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
-
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
-
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
-
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
-
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (italiano)
Telefoni e accessori fisici
-
Telefoni IP Cisco:
-
Cisco IP Phone serie 6800 con firmware Multitform
-
Cisco IP Phone serie 7800 con firmware Multitform
-
Cisco IP Phone serie 8800 con firmware Multitform
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html modelli e ulteriori informazioni, vedere .
-
-
I telefoni di terze parti sono supportati allo stesso modo delle altre integrazioni BroadWorks. Tuttavia, non dispongono ancora di contatti e integrazione di presenza con Webex per Cisco BroadWorks.
-
Adattatori:
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 191
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 192 Multiplatform
Per https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html modelli e ulteriori informazioni, vedere .
-
-
Cuffie
-
Cisco Headset serie 500
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html modelli e ulteriori informazioni, vedere .
-
-
Dispositivi Room OS:
-
Serie Webex Room e Room Kit
-
Serie Webex Desk
-
Serie Webex Board
-
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e l'assistenza dei dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivi
Di seguito sono riportati i file DTAF che devi caricare sui server delle applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia esiste un nuovo file config-wxt.xml.template
utilizzato per l'app Webex.
Per scaricare i profili dei dispositivi più recenti, andare al sito di Download softwar e della piattaforma di consegna delle applicazioni per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che per XSP.
Nome client |
Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Business Communicator - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un profilo identità/dispositiv o assegnato in BroadWorks che utilizzi uno dei profili del dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Genera una richiesta di servizio con l'agente di onboarding o con Cisco TAC per eseguire il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il titolo della richiesta per le rispettive funzioni:
-
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
-
'NPS Configuration for Auth Proxy Setup' (Configurazione NPS per impostazione proxy automatica) per configurare NPS per l'uso del proxy di autenticazione.
-
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori informazioni su questa funzione, vedere: Supporto di Cisco BroadWorks per CI UUID.
-
Configura BroadWorks per abilitare la fatturazione Cisco per BroadWorks e Webex Per abbonamenti BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento validi per 60 giorni. Se il token scade prima di utilizzarlo, è possibile presentare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali.
Ordina certificati
Requisiti di certificato per l'autenticazione TLS
Per tutte le applicazioni richieste, saranno necessari i certificati di sicurezza, firmati da un'autorità di certificazione ben nota e distribuiti su ADP XSP|pubblico. Verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in entrata ai server XSP|ADP.
Questi certificati devono includere il nome di dominio pubblico XSP|ADP completo come Nome comune oggetto o Nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati del server dipendono da come vengono distribuiti gli ADP XSP|rivolti al pubblico:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente a XSP|ADP
Il diagramma seguente riepiloga dove deve essere caricato il certificato del server pubblico firmato da CA in questi tre casi:
Le CA pubblicamente supportate che l'app Webex supporta per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per il proxy con bridge TLS
-
Il certificato del server firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta questo certificato server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Un certificato firmato CA interno può essere caricato su XSP|ADP.
-
L'|ADP XSP presenta questo certificato del server firmato internamente al proxy.
-
Il proxy si basa sulla CA interna che ha firmato il certificato del server XSP|ADP.
ADP in DMZ|
-
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
-
Gli ADP XSP|presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
Ulteriori requisiti di certificato per l'autenticazione TLS reciproca su interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione TLS reciproca. Il certificato CA/catena di certificati del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedere a Partner Hub, andare a Impostazioni >
collegamento di download del certificato.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono da come vengono distribuiti i tuoi ADP XSP|rivolti al pubblico:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente a XSP|ADP
Il diagramma seguente riepiloga i requisiti dei certificati in questi tre casi:
(Opzione) Requisiti di certificato per proxy tls-bridge
-
Webex presenta un certificato client firmato pubblicamente al proxy.
-
Il proxy considera attendibile la CA interna Cisco che ha firmato il certificato client. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta il certificato del server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Il proxy presenta un certificato client firmato internamente agli XSP|ADP.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3: Uso chiave estesa X509v3: 1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Il CN del certificato interno deve essere
bwcticlient.webex.com
.-
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati server interni per XSP|ADP possono essere SAN.
-
Le autorità di certificazione pubbliche potrebbero non voler firmare i certificati con il OID broadworks proprietario richiesto. In caso di proxy di bridging, è possibile che sia necessario utilizzare una CA interna per firmare il certificato del client che il proxy presenta all'ADP XSP|.
-
-
Le ADP XSP|si fidano delle autorità di certificazione interne.
-
Gli ADP XSP|presentano un certificato del server firmato internamente.
-
Il proxy considera attendibile la CA interna.
-
Il ClientIdentit y del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XS|P dal proxy.
ADP in DMZ|
-
Webex presenta un certificato client firmato da CA Cisco interno alle ADP XSP|.
-
Gli ADP XSP|si fidano delle autorità di certificazione interne di Cisco che hanno firmato il certificato client. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XS|P.
-
Gli ADP XSP|presentano i certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i |certificati server ADP XSP.
-
Il server applicazioni ClientIdentit y contiene il CN del certificato del client firmato Cisco presentato a XS|PADP da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene l'elenco di indirizzi IP, porte e protocolli richiesti per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle del firewall in entrata ed uscita precedenti documenta solo le connessioni specifiche per Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico a Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e come ciascuna sezione è relativa a Webex per Cisco BroadWorks.
Sezione dell'articolo requisiti di rete |
Gestione delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex |
Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud |
Informativo |
È necessario leggere | |
È necessario leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex |
È necessario leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione |
Opzionale |
Servizi Webex per clienti FedRAMP |
N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedere Whitepaper (PDF) del firewall appWebex.
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza XSP|ADP di Broadworks fornita dal partner. Quando un ADP o un sito XSP|non è disponibile per manutenzione pianificata o motivo non pianificato, i servizi e le app Webex possono passare a un altro ADP o sito XS|Pfornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP Broadworks XSP|possono essere distribuiti direttamente su Internet o possono risiedere in un DMZ frontale da un elemento di bilanciamento del carico come F5 BIG-IP. Per fornire ridondanza geografica, gli ADP XSP|possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un bilanciatore di carico, ognuno con un indirizzo IP pubblico. Se gli ADP XSP| sono dietro a un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e Broadworks sembra avere solo un XS|PADP, anche se vi sono più ADP XS|P dietro.
Nell'esempio seguente, le ADP|XSP vengono distribuite in due siti, il Sito A e il Sito B. Esistono due AD|PXSP frontali di un bilanciatore di carico in ogni sito. Il sito A ha XSP|ADP1 e XS|PADP2 frontali di LB1 e il sito B ha XS|PADP3 e XS|PADP4 frontali di LB2. Solo i bilanciatori di carico sono esposti sulla rete pubblica e le ADP|XSP sono nelle reti private DMZ.
Servizi Cloud Webex
Configurazione DNS
I microservizi cloud Webex devono essere in grado di trovare il server|ADP Broadworks XSP per la connessione alle interfacce Xsi, al servizio di autenticazione e al CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host XSP|ADP configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso. Se vengono restituiti più indirizzi IP, verrà selezionato il primo IP nell'elenco. SRV ricerca non sono attualmente supportate.
Esempio: Il DNS A Record del partner per la scoperta del server XSP|ADP/Load Balancers bilanciato Round-Robin.
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (Sito A) |
R |
|
|
Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP.
Failover
Quando i microservizi Webex inviano una richiesta al servizio |di bilanciamento del carico/ADP XSP e la richiesta non riesce, possono verificarsi diverse cose:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un avanzamento di route al successivo IP.
-
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
-
Se non si riceve alcuna risposta HTTP entro 2 secondi, si verifica un timeout della richiesta e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento all'IP successivo.
Ogni richiesta viene provata 3 volte prima che un problema venga segnalato al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco degli indirizzi da provare quando si invia una richiesta a un XSP|ADP. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna all'elenco per riprovare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco dei contatti bloccati. Se tale indirizzo IP viene rimosso dall'elenco dei contatti bloccati.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP|XSP o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster di chiamata BroadWorks, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
-
Azioni XSI
-
Eventi XSI
-
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Lo stato delle connessioni può essere:
-
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
-
Rosso: Quando tutti gli IP nella ricerca dei record A sono irraggiungibili e l'interfaccia non è disponibile.
I seguenti servizi utilizzano i microservizi per connettersi agli XSP|ADP e sono interessati dalla disponibilità dell'interfaccia XS|PADP:
-
Accesso all'app Webex
-
Aggiornamento token app Webex
-
E-mail/attivazione automatica non attendibile
-
Controllo stato servizio Broadworks
Webex App
Configurazione DNS
L'app Webex accede ai servizi Xtended Services Interface (XSI-Actions & XSI-Events) e Device Management Service (DMS) su XSP|ADP.
Per trovare il servizio XSI, l'app Webex esegue la ricerca DNS SRV per _xsi-client._tcp.
. L'SRV punta all'URL configurato per gli host XSP|ADP o i bilanciatori di carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex torna alla ricerca A/AAAA.
L'SRV può risolversi in più target A/AAAA. Tuttavia, ogni record A/AAAA deve mappare solo a un singolo indirizzo IP. Se sono presenti più ADP|XSP in un DMZ dietro il dispositivo di bilanciamento del carico/bordo, è necessario che il bilanciatore di carico sia configurato per mantenere la persistenza della sessione in modo da indirizzare tutte le richieste della stessa sessione allo stesso XS|PADP. Questa configurazione viene avviata perché i heartbeat dell'evento XSI del client devono andare allo stesso XSP|ADP utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non deve esistere. Se il DNS richiede che un record A/AAAA deve essere definito, allora deve essere restituito solo 1 indirizzo IP. Indipendentemente da ciò, il valore SRV deve essere ancora definito per l'app Webex.
Se l'app Webex utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client alla fine invia heartbeat a un XSP|ADP dove non ha stabilito un canale per eventi. Di conseguenza, il canale viene strappato e il traffico interno è notevolmente più intenso, il che pregiudica le prestazioni del cluster ADP|XSP.
Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca di record A/AAAA, è necessario utilizzare un nome di dominio completo separato per Webex Cloud e l'app Webex per accedere agli ADP|XSP. Come mostrato negli esempi, Webex Cloud utilizza Un record webex-cloud-xsp.example.com
e l'app Webex utilizza SRV _xsi-client._tcp.webex-app-xsp.example.com
.
Esempio 1: ADPXSP multipli, ciascuno dietro bilanciatori di carico separati|
In questo esempio, SRV punta a disattivare l'audio dei record A con ogni record A che punta a un bilanciatore di carico diverso su un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito è riportato un esempio di SRV record.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Esempio 2: più amministratori XSP dietro un singolo bilanciatore di carico (con bridge TLS)|
Per la richiesta iniziale, il bilanciatore di carico seleziona un XSP|ADP casuale. XSP|ADP restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il bilanciatore di carico utilizza il cookie per indirizzare la connessione all'ADP XSP|corretto, assicurandosi che il canale dell'evento non si interrompa.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Bilanciatore di carico |
A |
LB.example.com |
|
Indirizzo IP del bilanciatore di carico (XSP|ADP sono dietro al bilanciatore di carico) |
URL DMS
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il relativo file di configurazione. Viene eseguita l'analisi dell'organizzatore nell'URL e l'app Webex esegue la ricerca DNS A/AAAA dell'organizzatore per connettersi all'ADP XSP|che ospita il servizio DMS.
Esempio: DNS Un record per la scoperta di Round-Robin bilanciato server XSP|ADP/Bilanciamento del carico di Webex App per scaricare i file di configurazione tramite DMS:
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. Qualsiasi riferimento a XSP include XSP o ADP.
ADP|
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
-
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (inserito durante la creazione del cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue SRV ricerca nel modo seguente:
-
Il client esegue una ricerca SRV per _xsi-client._tcp.
-
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
-
Il client esegue una ricerca A/AAAA di tali destinazioni e memorizza nella cache gli indirizzi IP restituiti.
-
Il client si connette a uno dei destinazioni (e pertanto, il relativo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi avere lo stesso peso (o a caso se tutti sono uguali).
-
-
Se la ricerca SRV ricerca non restituisce eventuali obiettivi:
Il client esegue una ricerca A/AAAA del parametro radice Xsi, quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento bordo di bilanciamento del carico oppure potrebbe essere il server XSP|ADP stesso.
Come specificato, il record A/AAAA deve risolversi in un indirizzo IP per gli stessi motivi.
-
-
(Opzionale) In un secondo tempo, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocolli> <xsi> <paths> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
-
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
-
Se esistono, il client verrà confrontato con l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
-
Se vengono rilevate eventuali differenze, il client inizializza nuovamente la connettività XSI Actions/ XSI Events. La prima fase consiste nell'eseguire lo stesso processo di ricerca DNS elencato nella fase 1, richiedendo questa volta una ricerca del valore nel %XSI_ROOT_WXT% parametro dal file di configurazione.
Creare i record delle SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
-
Failover
Durante l'accesso, l'app Webex esegue una ricerca DNS SRV per _xsi-client._tcp., crea un elenco di host e si connette a uno degli host in base alla priorità SRV, quindi al peso. Questo ospite connesso diventa il selezionato per tutte le richieste future. Un canale di evento viene quindi aperto all'organizzatore selezionato e un heartbeat viene inviato regolarmente per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP, pertanto è importante che il bilanciatore di carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server XSP|ADP di backend.
In caso di errore di una richiesta o di una richiesta heartbeat a un host, si possono verificare diverse operazioni:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), l'instradazione dell'app Webex avanza immediatamente al successivo organizzatore nell'elenco.
-
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e l'indirizzamento passa all'organizzatore successivo nell'elenco.
-
Se non si riceve una risposta entro un determinato periodo di tempo, la richiesta viene considerata non riuscita a causa di un timeout e le successive richieste vengono inviate all'organizzatore successivo. Tuttavia, la richiesta di timeout viene considerata come non riuscita. Si è verificato un tentativo in seguito ad alcune richieste in seguito a un errore (con un aumento del tempo di tentativo). Non si sono effettuate nuovamente richieste che presupponete non vitali.
Quando si prova correttamente un nuovo organizzatore, diventa il nuovo organizzatore selezionato, se è presente nell'elenco. Una volta tentato l'ultimo organizzatore nell'elenco, l'app Webex viene rollover a quella del primo.
In caso di heartbeat, se ci sono due errori di richiesta consecutivi, l'app Webex inizializza nuovamente il canale dell'evento.
Tenere presente che l'app Webex non esegue il fail-back e il rilevamento del servizio DNS viene eseguito una sola volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione attraverso l'interfaccia XSP|ADP/Dms. Esegue una ricerca dei record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Si tenterà prima di inviare la richiesta di download del file di configurazione utilizzando un token SSO configurazione. Se questo non riesce, verrà riprovare ma con il nome utente e la password del dispositivo.
Distribuisci Webex per BroadWorks
Panoramica sulla distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning dell'utente. Molte delle attività sono comuni a tutte le modalità di provisioning.
Onboarding dei partner per Webex per Cisco BroadWorks
Ciascun provider o rivenditore di servizi Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, è necessario eseguire la documentazione Cisco BroadWorks di Webex e i nuovi partner devono accettare l'ICPA (Indirect Channel Partner Agreement) online. Al termine di queste operazioni, Cisco Compliance creerà una nuova organizzazione partner in Partner Hub (se necessario) e invierà un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, il tuo Partner Activation e/o Customer Success Program Manager ti contatterà per iniziare il tuo onboarding.
I partner Webex in una regione possono creare organizzazioni di clienti in qualsiasi regione che offriamo i servizi. Per informazioni, vedere: Residenza dati nell'app Webex
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
L'applicazione NPS deve essere eseguita su un XSP|ADP diverso. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi su XSP|ADP.
Servizio/Applicazione |
Autenticazione richiesta |
Scopo servizio/applicazione |
---|---|---|
Xsi-Events |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, notifiche servizio |
Azioni Xsi |
TLS (il server esegue l'autenticazione per i client) |
Controllo chiamate, azioni |
Gestione dispositivi |
TLS (il server esegue l'autenticazione per i client) |
Download configurazione chiamata |
servizio di autenticazione |
TLS (il server esegue l'autenticazione per i client) |
autenticazione protetta |
Computer Telephony Integration (CTI) |
mTLS (client e server si autenticano a vicenda) |
Presenza telefonia |
Applicazione Webview Impostazioni chiamata |
TLS (il server esegue l'autenticazione per i client) |
Mostra le impostazioni di chiamata utente nel portale Assistenza utente all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma è necessario fare riferimento alla documentazione esistente per ottenere le applicazioni installate su XSP|ADP.
Requisiti di coresidenza
-
Il servizio di autenticazione deve essere coresidente con le applicazioni Xsi, perché tali interfacce devono accettare token di lunga durata per l'autorizzazione del servizio. Il servizio di autenticazione è richiesto per convalidare tali token.
-
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
-
È possibile separare gli altri servizi/applicazioni come richiesto per la propria scala (ad esempio, azienda agricola XSP|ADP di gestione dei dispositivi dedicata).
-
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
-
Non installare altre applicazioni o servizi su XSP|ADP utilizzati per l'integrazione di BroadWorks con Webex.
-
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi Xtended di Cisco BroadWorks.
È necessario distribuire solo un'istanza delle applicazioni Xsi-Events su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso nome di chiamataControlApplication definito in Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> Scarica
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente ha eseguito l'onboarding in Webex, Webex crea un abbonamento per l'utente su AS per ricevere eventi di telefonia per la cronologia delle chiamate e della presenza. L'abbonamento è associato a callControlApplicationName e l'AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica di callControlApplicationName o il fatto di non avere lo stesso nome su tutte le webapp Xsi-Events avrà un impatto sulle funzionalità di abbonamento ed eventi di telefonia.
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se è in esecuzione R22 o versione superiore e il sistema lo supporta.
Mutual TLS (mTLS) è supportato anche come metodo di autenticazione alternativo per il servizio Auth. Se si dispone di più organizzazioni Webex in esecuzione sullo stesso server XSP|ADP, è necessario utilizzare l'autenticazione mTLS poiché la convalida del token CI non supporta più connessioni allo stesso servizio di autorizzazione XSP|ADP.
Per configurare l'autenticazione mTLS per il servizio di autenticazione anziché la convalida del token CI, fare riferimento all'Appendice per configurare i servizi (con mTLS per il servizio di autenticazione).
Se attualmente si utilizza mTLS per il servizio autenticazione, non è obbligatorio riconfigurare l'uso della convalida token CI con TLS.
-
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks.
-
Installare le seguenti patch su ciascun server XSP|ADP. Installare le patch appropriate alla release in uso:
-
Per R22:
-
Per R23:
-
Per R24: non è necessario alcun cerotto
Qualsiasi riferimento a XSP include XSP o ADP.
-
-
Installare l'applicazione
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP nel percorso context /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> attiva applicazione AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire AuthenticationService su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> distribuisci applicazione /authServiceBroadWorks Distribuzione SW Manager distribuzione /authService...
-
A partire da Broadworks build 2022.10, le autorità di certificazione in arrivo con Java non vengono più automaticamente incluse nel trust store BroadWorks quando si passa a una nuova versione di java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
-
IdenTrust radice commerciale CA 1
-
Go Daddy Root Certificate Authority - G2
Verificare che questi certificati siano presenti sotto la seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> ottieni
Se non presente, eseguire il seguente comando per importare i trust Java predefiniti:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come ancoraggi attendibili con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono automaticamente importate nella nuova release e continueranno a essere importate finché non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere la FD di convalida del certificato Cisco Broadworks X509.
-
-
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> ottieni
-
impostazione clientId client-Id-Da-Step1
-
impostazione abilitata true
-
imposta clientSecret client-Secret-From-Step1
-
imposta ciResponseBodyMaxSizeInBytes 65536
-
imposta issuerName <URL>
: per l'URL
, inserire l'URL IssuerName applicabile al cluster CI. Vedere la tabella seguente. -
set issuerUrl <URL>
: per l'URL
, inserire l'IssuerUrl applicabile al cluster CI. Vedere la tabella seguente. -
set tokenInfoUrl <IdPProxy URL>
: inserire l'URL del proxy IdP applicabile al cluster Teams. Si veda la seconda tabella che segue.
Tabella 1. Imposta nome emittente e URL emittente Se il cluster CI è... Imposta issuerName e issuerURL su... Stati Uniti
UE
USA-B
Se non conosci il tuo cluster CI, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.
Tabella 2. Imposta tokenInfoURL Se il cluster di Teams è... Imposta tokenInfoURL su...(URL proxy IdP) ACHM
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AFRA
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AORE
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
-
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista help desk di Control Hub.
-
Per il test, è possibile verificare che il tokenInfoURL sia valido sostituendo la parte "idp/authenticate" dell'URL con "ping".
-
-
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> imposta ambito broadworks-connector:utente
-
Configura i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> ottieni
-
imposta flsUrl https://cifls.webex.com/federation
-
imposta periodo di aggiornamento in minuti 60
-
impostazione refreshToken refresh-Token-From-Step1
-
-
Eseguire il seguente comando per verificare che la configurazione FLS funzioni. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Ottieni
-
Configurare la gestione token utilizzando i seguenti comandi su ciascun server XSP|ADP:
-
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
-
imposta tokenIssuer BroadWorks
-
imposta tokenDurationInOre 720
-
-
Genera e condividi chiavi RSA. È necessario generare le chiavi su un XSP|ADP, quindi copiarle in tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittazione dei token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
Se si spostano i tasti in sequenza o si modifica la lunghezza della chiave, è necessario ripetere la seguente configurazione e riavviare tutti gli XSP|ADP.
-
Selezionare un XSP|ADP da utilizzare per la generazione di una coppia di chiavi.
-
Utilizzare un client per richiedere un token crittografato a tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(viene generata una coppia di chiavi privata/pubblica su XSP|ADP, se non ne era già presente una)
-
La posizione dell'archivio chiave non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
esportaKeys
-
Copiare il file esportato
/var/broadworks/tmp/authService.keys
nella stessa posizione sugli altri XSP|ADP, sovrascrivendo un file.keys
precedente, se necessario. -
Importa le chiavi su ciascuno degli altri XSP|ADP:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
-
-
Fornire l'URL authService al contenitore Web. Il contenitore Web di XSP|ADP necessita dell'URL authService in modo da poter convalidare i token. Su ciascuno degli XSP|ADP:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
imposta URL http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al contenitore:
XSP|ADP_CLI/Maintenance/ContainerOptions> aggiungi tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Verificare il parametro con
get
. -
Riavviare XSP|ADP.
-
Rimozione dei requisiti di autenticazione del client per il servizio di autenticazione (solo R24)
Se si dispone del servizio di autenticazione configurato con la convalida del token CI su R24, è necessario rimuovere anche il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> imposta <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > HTTP Interfaccia server = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità | contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il comando
get
e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> ottieni
Aggiunta del protocollo TLS 1.2 all'interfaccia server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia server HTTP:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Inserire il comando
get <interfaceIp> 443
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserisci il comando
aggiungi <interfaceIp> 443 TLSv1.2
per assicurarti che l'interfaccia possa utilizzare TLS 1.2 nella comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia del server HTTP
Per configurare le crittografie richieste:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Inserire il comando
get <interfaceIp> 443
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview). -
Inserire il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.L'XSP|ADP CLI richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizza:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>aggiungi 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base al nome.
Configura gestione dispositivi su XSP|ADP, server applicazioni e server di profilo
Il server di profilo e XSP|ADP sono obbligatori per la gestione dei dispositivi. Devono essere configurati in base alle istruzioni della Guida alla configurazione di BroadWorks Device Management.
Interfaccia CTI e configurazione correlata
Di seguito viene elencato l'ordine di configurazione "da più a più". In seguito a questo ordine non è obbligatorio.
-
Configurazione del server di applicazione per gli abbonamenti CTI
-
Configurazione di XSP|ADP per abbonamenti CTI con autenticazione mTLS
-
Apertura delle porte in entrata per l'interfaccia CTI protetta
-
Abbonamento dell'organizzazione Webex agli eventi CTI di BroadWorks
Configurazione del server di applicazione per gli abbonamenti CTI
Aggiornare ClientIdentity su Application Server con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ciascun server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> aggiungi bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è bwcticlient.webex.com.
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifico
I contesti CLI utilizzati per visualizzare o modificare le diverse impostazioni SSL sono:
Specificità |
Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) |
XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocols> |
Una specifica interfaccia CTI su questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocols> |
Su una nuova installazione, le seguenti crittografie sono installate per impostazione predefinita a livello di sistema. Se non è configurato nulla a livello di interfaccia (ad esempio, nell'interfaccia CTI o HTTP), si applica questo elenco di crittografia. Si noti che questo elenco può cambiare nel tempo:
-
TLSECDHERSAWITHAES128GCMSHA256
-
TLSECDHEECDSAWITHAES128GCMSHA256
-
TLSECDHERSAWITHAES128CBCSHA256
-
TLSECDHEECDSAWITHAES128CBCSHA256
-
TLSDHEDSSWITHAES128GCMSHA256
-
TLSDHERSAWITHAES128GCMSHA256
-
TLSDHERSAWITHAES128CBCSHA256
-
TLSDHEDSSWITHAES128CBCSHA256
-
TLSECDHRSAWITHAES128GCMSHA256
-
TLSECDHECDSAWITHAES128GCMSHA256
-
TLSECDHRSAWITHAES128CBCSHA256
-
TLSECDHECDSAWITHAES128CBCSHA256
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserire il comando
get
e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna di esse, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> Ottieni interfaccia porta IP Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
-
Inserire il comando
get <interfaceIp>
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserire il comando
aggiungi <interfaceIp> TLSv1.2
per assicurarsi che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione delle crittografie TLS nell'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
-
Immettere il comando
get
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview). -
Inserire il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.L'XSP|ADP CLI richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, è necessario utilizzare:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> aggiungi 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base al nome.
Ancoraggi affidabili per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che gli XSP|ADP siano rivolti verso Internet o rivolti verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy bridge (vedere Requisiti del certificato TLS per proxy bridge TLS).
Per ogni XSP|ADP nell'infrastruttura che sta pubblicando eventi CTI in Webex, effettuare le seguenti operazioni:
-
Accedi a Partner Hub all'indirizzo .
-
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain .txt
sul computer locale.Questi file contengono due serie di due certificati. Devi suddividere i file prima di caricarli negli XSP|ADP. Tutti i file sono obbligatori.
-
Dividere la catena del certificato in due certificati - combinedcertchain2023.txt
-
Aprire combinedcertchain2023.txt in un editor di testo.
-
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file. -
Salvare il nuovo file come root2023.txt.
-
Salvare il file originale come emissione2023.txt. Il file originale ora deve disporre di un solo blocco di testo, circondato dalle righe
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copia entrambi i file di testo in una posizione temporanea su XSP|ADP che stai proteggendo, ad esempio,
/var/broadworks/tmp/root .txt
e/var/broadworks/tmp/issuing .txt
-
Accedere a XSP|ADP e passare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
-
(Opzionale) Eseguire
help updateTrust
per visualizzare i parametri e il formato del comando. -
Carica i file dei certificati in nuovi trust anchors - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot /var/broadworks/tmp/root .txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing /var/broadworks/tmp/issuing .txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
ewebexclientissuing
sono alias di esempio per i trust anchor; puoi utilizzare i tuoi alias purché tutte le voci siano univoche. -
Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> ottieni
Alias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[autofirmato]
-
Consenti ai client di autenticarsi con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> imposta allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
-
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione BroadWorks in uso. Il comando crea un certificato server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> aggiungi <Interface IP> 8012 true true true
-
-
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. È necessario l'indirizzo IP dell'interfaccia CTI per questo; è possibile leggerlo dal seguente contesto:
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> ottieni
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interfaccia IP> file chiave</path/to/file chiave certificato> certificatoFile </path/to/certificato server> chainFile</path/to/chain file>
-
-
Riavviare XSP|ADP.
Abilitazione dell'accesso a BroadWorks CTI Events su Webex
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
È necessario aggiungere e convalidare l'interfaccia CTI quando si configurano i cluster in Partner Hub. Per istruzioni dettagliate, vedere Configurazione dell'organizzazione partner in Partner Hub.
-
Specificare l'indirizzo CTI in base al quale Webex può iscriversi a CTI Events di BroadWorks.
-
Gli abbonamenti CTI sono su base per abbonato e vengono stabiliti e mantenuti solo mentre l'abbonato viene predisposto per Webex per Cisco BroadWorks.
Visualizzazione Webview Impostazioni chiamata
CSWV (Call Settings Webview) è un'applicazione ospitata su XSP|ADP che consente agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview per le impostazioni di chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono native dell'app Webex.
Se si desidera che gli abbonati Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre i valori predefiniti disponibili nell'app Webex, è necessario distribuire la funzione Webview impostazioni chiamata.
La vista Webview Impostazioni chiamata presenta due componenti:
-
Applicazione Webview impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
-
App Webex, che esegue il rendering delle impostazioni di chiamata in una vista Webview.
Esperienza utente
-
Utenti Windows: Fai clic su Impostazioni chiamata, quindi fai clic su .
-
Utenti Mac Fare clic sull'immagine del profilo, quindi su
.
Distribuzione di CSWV su BroadWorks
Installazione della vista Web impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso XSP|ADP che ospita l'interfaccia Azioni Xsi nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
-
Accedere a cisco.com e cercare "BWCallSettingsWeb" nella sezione download software.
-
Trovare e scaricare la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) era il più recente al momento della scrittura. -
Installare, attivare e distribuire l'archivio Web in base alla guida alla configurazione della piattaforma di servizio Cisco BroadWorks Xtended per la versione XSP|ADP. (Versione R24 è https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
-
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
. -
Passare al seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> installa applicazione /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
-
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più richiesto). -
Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> attiva applicazione BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario fornire anche un contextPath perché è un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio,
/callsettings
. -
Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> distribuisci applicazione /callsettings
-
-
Ora è possibile prevedere l'URL delle impostazioni di chiamata che si specificherà per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
-
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
-
XSP|ADP-FQDN deve corrispondere all'FQDN azioni Xsi, poiché CSWV deve utilizzare azioni Xsi e CORS non è supportato.
-
-
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview impostazioni chiamata ora è attiva su XSP|ADP.
Configura l'app Webex per utilizzare Webview impostazioni chiamata
Per ulteriori dettagli sulla configurazione del client, vedere la Guida alla configurazione di Webex per Cisco BroadWorks.
Nel file di configurazione dell'app Webex è presente un tag personalizzato che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti attraverso l'interfaccia dell'applicazione.
<config> <servizi> <web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%"> <url>%WEB_CALL_SETTINGS_URL_WXT%</url> </web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel tag %WEB_CALL_SETTINGS_URL_WXT%.
Se non si specifica esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
-
Accertarsi di disporre degli ultimi modelli di configurazione per l'app Webex (vedere Profili dispositivo).
-
Impostare la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
-
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.esempio.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
-
Il file di configurazione client risultante dovrebbe avere una voce come segue:
<web-call-settings target="csw"> <url>https://yourxsp.esempio.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push delle chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Call Notifications Push Server (CNPS) per descrivere un'applicazione ospitata XSP o ospitata ADP che viene eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in arrivo agli utenti e invia le notifiche a Google Firebase Cloud Messaging (FCM) o Apple Push Notification Service (APN).
Tali servizi notificano ai dispositivi mobili degli abbonati Webex per Cisco BroadWorks la presenza di chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere la descrizione della funzione Notification Push Server.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per eseguire il push delle notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi a loro volta notificano agli utenti mobili Webex le modifiche ai messaggi in arrivo o alla presenza.
In questa sezione viene descritto come configurare l'NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se devi eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedi Aggiornamento dell'NPS Cisco BroadWorks per l'uso del proxy NPS https://help.webex.com/nl5rir2/.
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario aggiornare il CNPS per supportare la funzione proxy NPS, server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server di notifica push per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e i tasti di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend di Cisco BroadWorks e utilizza questo token per l'autenticazione con gli APN Apple e i servizi FCM Google.
La funzione migliora anche la capacità del server push delle notifiche di eseguire notifiche push ai dispositivi Android attraverso la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
-
Per ulteriori informazioni, vedere Server push per VoIP nella descrizione della funzione UCaaS.
-
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software e le patch NPS, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Cercare e scaricare la patch dalla pagina di download del software.
-
Ulteriori informazioni sul server ADP sono disponibili all'indirizzo https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio Apple Push Notification dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per gli APN. Questo aggiornamento richiede che XSP|ADP che ospita NPS sia in esecuzione R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 |
Installare e configurare un XSP dedicato (versione minima R22) o una piattaforma di consegna dell'applicazione (ADP). |
2 |
Installare le patch proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: |
3 |
Attivare l'applicazione Notification Push Server. |
4 |
(Per le notifiche Android) Abilitare l'API FCM v1 sull'NPS.
|
5 |
(Per le notifiche Apple iOS) Abilitare HTTP/2 su NPS.
Questa opzione è esclusiva per la versione 22 e versioni precedenti; non è disponibile nella versione 23 e nelle versioni precedenti, che supportano solo HTTP/2. |
6 |
Collegare un supporto tecnico dell'NPS XSP/ADP. |
7 |
Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa 149.vle.broadsoft.com qa 149.vle.broadsoft.com IN UN 10.193.78.149 Una volta impostata, per rispondere alle modifiche è necessario disporre di una delle seguenti opzioni:
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configura NPS per utilizzare il proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Migra NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un NPS condiviso con altre app mobili, vedere Aggiornamento dell'NPS Cisco BroadWorks per l'uso del proxy NPS ( https://help.webex.com/nl5rir2).
1 |
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 |
Creare l'account cliente su NPS:
Per verificare che i valori immessi corrispondano a quanto specificato, eseguire L'issuerUrl di CiscoCI deve essere SEMPRE cluster US CI indipendentemente dalla posizione e l'impostazione predefinita deve essere:
| |||||||||||||||||||
3 |
Immettere l'URL proxy NPS e impostare l'intervallo di aggiornamento del token (consigliato 30 minuti):
| |||||||||||||||||||
4 |
(Per le notifiche Android) Aggiungere l'ID applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 |
(Per le notifiche Apple iOS) Aggiungere l'ID applicazione al contesto delle applicazioni APNS, assicurandosi di omettere il tasto Auth – impostarlo su vuoto.
| |||||||||||||||||||
6 |
Configura il seguente DPG:
| |||||||||||||||||||
7 |
Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 |
Verificare se il server applicazioni sta eseguendo lo screening degli ID applicazione, poiché potrebbe essere necessario aggiungere le app Webex all'elenco utenti autorizzati: | |||||||||||||||||||
9 |
Riavviare XSP|ADP: | |||||||||||||||||||
10 |
Esegui test delle notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migrazione di NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente che è necessario eseguire la migrazione a FCMv1. Sono previste tre procedure:
-
Esegui migrazione dei client UC-One a FCMv1: quando disponi di client UCaaS esistenti e devi migrarli per utilizzare FCMv1.
-
Migrazione dei client SaaS a FCMv1: quando si dispone di client SaaS esistenti e occorre migrarli per utilizzare FCMv1.
-
Aggiorna server ADP: quando si esegue la migrazione di NPS a un server ADP.
Migrazione dei client UC-One a FCMv1
Utilizzare la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella Console FCM, vedi
. L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile di connessione all'indirizzo https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al parametro gcm_defaultSenderId
, che si trova nel kit di branding, nella cartella Risorse e nel file branding.xml con la sintassi seguente:
<string name="gcm_defaultSenderId">xxxxxxxxxxxxx</string>
-
Accedere a FCM Admin SDK all'indirizzo http://console.firebase.google.com.
-
Selezionare l'applicazione Android appropriata.
-
Nella scheda General (Generale), registrare l’ID del progetto
-
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurarne uno esistente.
Per creare un nuovo account di servizio:
-
Fare clic sul pulsante blu per creare un nuovo account di servizio
-
Fai clic sul pulsante blu per generare una nuova chiave privata
-
Chiave di download per una posizione sicura
Per riutilizzare un account servizio esistente:
-
Fare clic sul testo blu per visualizzare gli account di servizio esistenti.
-
Identificare l'account servizio da utilizzare. L'account di servizio richiede l'autorizzazione firebaseadmin-sdk.
-
A destra, fare clic sul menu hamburger e creare una nuova chiave privata.
-
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
-
-
Copia il file json su XSP|ADP.
-
Configurare l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> aggiungi <id progetto> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> ottieni Project ID Accountkey ======================== mio_progetto ********
-
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> aggiungi <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> ottieni ID applicazione Progetto ID ============================== my_app my_project
-
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Abilitato true ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP.
Migrazione dei clienti SaaS a FCMv1
Se si desidera eseguire la migrazione dei client SaaS a FCMv1, attenersi alla procedura seguente su Google FCM Console.
Assicurarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione".
-
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Enabled false ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP. -
Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Abilitato true ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP.
Aggiorna server ADP
Se si esegue la migrazione dell'NPS per utilizzare un server ADP, utilizzare i passaggi seguenti nella console Google FCM.
-
Ottenere il file JSON dalla console cloud di Google:
-
Su Google Cloud Console, andare alla pagina Account servizio.
-
Fare clic su Seleziona un progetto, scegliere il progetto e fare clic su Apri.
-
Trova la riga dell'account servizio per la quale desideri creare una chiave, fai clic sul pulsante Altro verticale, quindi fai clic su Crea chiave.
-
Selezionare un tipo di chiave e fare clic su Crea
Il file viene scaricato.
-
-
Aggiungere FCM al server ADP:
-
Importare il file JSON nel server ADP utilizzando il comando
/bw/install
. -
Accedere all'ADP CLI e aggiungere la chiave Project e API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> aggiungi connect /bw/install/google JSON
: -
Quindi, aggiungere l'applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Chiudi
-
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ================================== com.broadsoft.ucaas.connect connect-ucaas
-
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Questo si può verificare per i seguenti motivi:
-
Per consentire al cloud Webex di autenticare gli utenti in base a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
-
Per consentire alle app Webex di utilizzare l'interfaccia Xsi per il controllo delle chiamate.
-
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se alcune interfacce non vengono convalidate correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide.
Ciò viene impedito poiché un cluster configurato in modo errato potrebbe causare problemi che sono difficili da risolvere.
Cosa è necessario fare?
-
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
-
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
Se l'utente amministratore non ha visibilità delle impostazioni di BroadWorks Calling , si consiglia di aprire un caso con Cisco TAC.
-
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
-
Assegna un nome al cluster e fai clic su Avanti.
Il concetto di cluster in questo caso è semplicemente un insieme di interfacce, solitamente raggruppate su server o farm XSP|ADP, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il sistema BroadWorks non sono applicabili qui.
-
(Opzionale) Immettere un Nome account utente e una Password BroadWorks noti all'interno del sistema BroadWorks che si connette a Webex, quindi fare clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
-
Aggiungere gli URL XSI Actions e XSI Events.
-
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
-
Opzionale. Selezionare la casella di controllo Abilita autenticazione diretta BroadWorks se si desidera che gli accessi a BroadWorks siano diretti a BroadWorks. In caso contrario, l'autenticazione per BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo influisce su queste situazioni di accesso:
-
Accesso al portale di attivazione utente: gli utenti devono immettere le credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o attraverso il proxy IdP.
-
Accesso client: se l'autenticazione BroadWorks è configurata nel modello di onboarding, l'impostazione precedente determina se l'accesso del client all'app Webex è diretto a BroadWorks o viene proxy attraverso il proxy IdP.
-
-
Fai clic su Avanti.
-
Nella pagina CTI Interface (Interfaccia CTI) procedere come segue:
-
Aggiungere l'URL CTI e la porta per l'interfaccia CTI a cui si desidera connettersi.
-
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
-
Opzionale. Abilita il tasto di alternanza Non disturbare (NoDist) e inserisci l'ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurandosi che la funzione funzioni allo stesso modo su entrambe le piattaforme.
-
Fai clic su Avanti.
-
-
Aggiungere l'URL del servizio di autenticazione.
-
Selezionare Servizio autenticazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex poiché il servizio di autenticazione convalida correttamente il token utente rispetto al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
-
Controllare le voci sulla schermata finale, quindi fare clic su Crea. Dovrebbe essere visualizzato un messaggio di successo.
Partner Hub passa gli URL a vari microservizi Webex che testano le connessioni alle interfacce fornite.
-
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e se la convalida è riuscita.
-
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Abbiamo implementato questa verifica per prevenire errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, servizio di bilanciamento del carico o firewall) come documentato in questa guida, prima di salvare il modello.
Verifica delle connessioni alle interfacce BroadWorks
-
Accedi a Partner Hub (admin.webex.com) con le credenziali dell'amministratore del partner.
-
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni di BroadWorks Calling.
-
Fare clic su Visualizza cluster.
-
Partner Hub avvia i test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, la pagina dell'elenco dei cluster mostra il messaggio di stato accanto a ciascun cluster.
I messaggi verdi relativi al successo dovrebbero essere visualizzati. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
-
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio XSI-Actions, XSI-Events, DAS URL e le impostazioni dell'interfaccia CTI.
Configurazione dei modelli di onboarding
I modelli di onboarding sono il modo in cui verrà applicata la configurazione condivisa a uno o più clienti man mano che vengono caricati tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma solo un modello può essere associato a un cliente.
-
Fare clic sul pulsante Modelli di onboarding per visualizzare i modelli esistenti.
-
Fare clic su Modello di chat.
-
Nella finestra Dettagli modello, aggiungere il nome del modello, il paese o la regione e la lingua e-mail predefinita.
-
Fare clic sull'elenco a discesa per l'ID abbonamento CCW, individuare gli abbonamenti elencati per il partner e selezionare l'abbonamento applicabile.
Questo campo viene visualizzato solo per i partner migrati da Webex per BroadWorks a Webex.
-
Nella finestra Impostazione servizio, utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
-
Immettere un Nome modello, quindi fare clic su Avanti.
-
Configurare la modalità di provisioning utilizzando le seguenti impostazioni consigliate:
Tabella 2. Impostazioni di provisioning consigliate per diverse modalità di provisioning Nome riunione
Provisioning fluviale con e-mail attendibili
Provisioning flowthrough senza e-mail
Self-provisioning utente
Abilita flusso BroadWorks attraverso il provisioning (include le credenziali dell'account di provisioning se attivato**)
Il
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Il
Fornire il Nome account di provisioning e la Password in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il †
Il †
Il †
Indirizzo e-mail provider servizi
Selezionare un indirizzo e-mail dall'elenco a discesa (è possibile digitare alcuni caratteri per trovare l'indirizzo, se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello di onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto corrisponde alle organizzazioni dei clienti create con questo modello in una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedere le mappature tra paese e regione in questo foglio di calcolo.
Il paese dell'organizzazione determina i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni consultare la sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questo interruttore spento.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note dalla tabella:
-
† Questo passaggio garantisce che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa opzione deve essere sempre attiva, a meno che non si utilizzi un processo manuale di ordinazione ed esecuzione (tramite Cisco Commerce Workspace) per creare le organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello di "provisioning ibrido" e non rientra nel campo di applicazione di questo documento.
-
** "Account di provisioning" si riferisce all'account amministratore a livello di sistema BroadWorks. Su BroadWorks, è necessario un account amministratore con questi attributi: Tipo amministratore=Provisioning, sola lettura=Disattivato.
-
-
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
-
Opzionale. Selezionare Disabilita chiamata gratuita Cisco Webex se si desidera disabilitare le chiamate Webex.
-
Per la configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
-
Numeri di chiamata in ingresso Cisco (PSTN)
-
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
-
-
Fai clic su Avanti.
-
Esistono due approcci per il provisioning degli abbonati relativamente a come vengono verificate le relative identità, utilizzando e-mail attendibili o e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile, gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. In qualità di partner, sei responsabile del provisioning dell'indirizzo e-mail come parte del metodo flow-through o API.
Si consiglia vivamente di utilizzare il metodo di provisioning attendibile poiché garantisce che tutti gli abbonati siano completamente predisposti dall'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso e-mail non attendibile, gli utenti devono verificare i relativi messaggi e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 2. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome riunione
Provisioning flowthrough senza e-mail
Self-provisioning utente
Esegui prima provisioning amministratore
Consigliato
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Obbligatorio
-
Note dalla tabella:
-
* Ciascuna organizzazione cliente in Webex deve disporre di almeno un utente con ruolo di amministratore. Il primo utente a cui assegnare IM&P integrato in BroadWorks assume il ruolo di amministratore del cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di fornitore di servizi è possibile avere il controllo su chi ottiene il ruolo. La verifica di questa impostazione impedisce agli utenti di completare l'attivazione fino a quando non viene attivato il primo utente fornito. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
-
-
Fai clic su Avanti.
-
Selezionare la modalità di autenticazione predefinita (autenticazione BroadWorks o autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con Cisco TAC.
(Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente).
-
Fai clic su Avanti.
-
Per Preferenze, configurare quanto segue:
-
Scegliere se si desidera Precompilare gli indirizzi e-mail utente nella pagina di accesso.
Utilizzare questa opzione solo dopo aver selezionato Autenticazione BroadWorks e aver anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. In caso contrario, dovranno utilizzare il nome utente BroadWorks. La pagina di accesso offre l'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
-
Se desideri abilitare la sincronizzazione delle rubriche, imposta Abilita sincronizzazione delle rubriche telefoniche per tutte le nuove organizzazioni cliente e attiva Attiva.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
-
Immettere un amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatico di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
-
Assicurati che l'opzione Consenti invito e-mail amministratore quando ti colleghi a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
-
Fai clic su Avanti.
-
Esaminare le voci nella schermata finale. È possibile fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare qualsiasi dettaglio. Fare clic su Crea.
Dovrebbe essere visualizzato un messaggio di successo.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con altri modelli.
-
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario immettere nuovamente i dettagli dell'account di provisioning. I campi Password vuota/Conferma password sono disponibili per modificare le credenziali, se necessario, ma lasciarli vuoti per mantenere i valori forniti alla procedura guidata.
Aggiungi altri modelli se disponi di diverse configurazioni condivise che desideri fornire ai clienti.
Tenere aperta la pagina Visualizza modelli poiché potrebbe essere necessario specificare i dettagli del modello per una delle attività seguenti.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning.
Patch Application Server (solo R22, R23 e R24)
-
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
-
Per R22:
AP.as.22.0.1123.ap373197
-
Per R23:
AP.as.23.0.1075.ap373197
-
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che formano il requisito per la distribuzione di Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella sezione Riferimento.
-
-
Passare al contesto
Opzioni di manutenzione/contenitore
. -
Abilita il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> aggiungi provisioning bw.imp.useProvisioningUrl true
Scarica gli URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per informazioni dettagliate (Interfaccia > Messaggistica e Servizio > IM&P integrato) dei comandi AS.
-
Accedi a Partner Hub e vai a
. -
Fare clic su Modello di chat.
-
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro flyout a destra. Se non è stato ancora creato un modello, è necessario farlo prima di poter ottenere l'URL di provisioning.
-
Copiare l'URL dell'adattatore di provisioning.
Ripetere questa operazione per altri modelli se si dispone di più modelli.
(Opzione) Configurazione dei parametri di provisioning a livello di sistema su server applicazioni
Se si utilizza UC-One SaaS, potrebbe non essere necessario impostare il provisioning e il dominio del servizio a livello di sistema. Vedere i Punti di decisione nella sezione Preparazione dell’ambiente.
-
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
-
AS_CLI/Interface/Messaging> imposta URL provisioning URL provisioning
-
AS_CLI/Interface/Messaging> imposta provisioningUserId provisioning_account_name
-
AS_CLI/Interface/Messaging> imposta password provisioning provisioning_account_password
-
AS_CLI/Interface/Messaging> imposta abilitaSincronizzazione true
-
-
Attivare l'interfaccia IMP integrata:
-
/AS_CLI/Service/IntegratedIMP> imposta serviceDomain esempio.com
-
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> imposta userAttrIsActive true
-
Devi inserire il nome completo per il parametro URL provisioning
, come è stato assegnato in Control Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel file /etc/hosts
sul server applicazioni.
(Opzione) Configurazione dei parametri di provisioning per azienda su server applicazioni
-
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
-
Selezionare Usa dominio di servizio e immettere un valore fittizio (Webex ignora questo parametro). Puoi utilizzare
example.com
). -
Selezionare Usa server di messaggistica.
-
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
Devi inserire il nome completo per il parametro
URL provisioning
, come è stato assegnato in Partner Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel file/etc/hosts
sul server applicazioni. -
Nel campo Nome utente, immettere un nome per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
-
Immettere una password per l'amministratore del provisioning. Questo deve corrispondere al valore sul modello in Partner Hub.
-
Per Identità utente predefinita per ID IM&P, selezionare Principale.
-
Fare clic su Applica.
-
Ripeti per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning utente, vedi Provisioning utente provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning aiuta amministratori e team di vendita controllando la presenza di errori prima di eseguire il provisioning di un cliente o abbonato per un pacchetto. Gli utenti o le integrazioni autorizzati da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per assicurarsi che non vi siano conflitti o errori con il provisioning dei pacchetti per un determinato cliente o abbonato.
L'API verifica se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto per un cliente o un partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, è possibile correggere gli errori prima del provisioning, aumentando la probabilità di un provisioning riuscito.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore Webex per la vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare di un provisioning abbonato all'ingrosso
Per accedere a Verifica preliminare di un documento di provisioning Wholesale Subscriber, è necessario accedere a https://developer.webex.com/ portal.
Partner SSO - SAML
Consente agli amministratori dei partner di configurare l'SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La seguente procedura SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere la funzionalità SSO del partner a un'organizzazione cliente esistente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso.
-
Verificare che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'integrazione Single Sign-On in Control Hub.
-
Carica il file di metadati CI con provider di identità.
-
Configurare un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, immettere l'ID entità dall'XML metadati SAML del provider di identità di terze parti.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
-
Proprio che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori dei partner di configurare l'SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per impostare SSO OIDC partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già caricate utilizzando il modello.
-
Aprire una richiesta di servizio con il centro TAC di Cisco con i dettagli dell'IDP di connessione OpenID. Sono obbligatori e facoltativi gli attributi IDP. TAC deve impostare l'IDP sull'IC e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Obbligatorio
Descrizione
Nome DS
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC, potrebbe consistere in lettere, numeri, trattini, sottolineature, inclinazioni e punti e la lunghezza massima è 128 caratteri.
Id client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Segreto client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco degli ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio, ad esempio "profilo e-mail openid" Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non fornito
URL dell'endpoint di autorizzazione OAuth 2.0 dell'IdP.
endpoint token
Sì se discoveryEndpoint non fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
endpoint infoutente
No
URL dell'endpoint UserInfo di IdP.
Endpoint set di tasti
No
URL dell'endpoint JSON Web Key Set dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
-
Configurare l'URI di reindirizzamento sull'IDP di connessione OpenID.
-
Configurare un modello di onboarding. Per l'impostazione della modalità di autenticazione, selezionare Autenticazione partner Con OpenID Connect e immettere il nome IDP fornito durante l'impostazione IDP come ID entità IDP OpenID Connect.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizza il modello.
-
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui registrazione chiamata, risposta per assente di gruppo, dirigente e assistente di direzione.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
-
Eseguire i seguenti comandi sulle interfacce AS. Ciò consentirà all'AS di inviare l'intestazione SIP X-BroadWorks-Correlation-Info:
AS_CLI/Interface/SIP> imposta sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> imposta sendCallCorrelationIDAccess true
-
Il parametro enableCallCorrelationID associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione delle informazioni sulla correlazione delle chiamate nei registri Xsi-Actions. Si consiglia di abilitare
enableCallCorrelationID
utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>imposta enableCallCorrelationID true
Per ulteriori informazioni sull'identificativo di correlazione chiamata, vedere Descrizione della funzione dell'identificativo di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione delle directory consente agli utenti Webex di BroadWorks di utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante sul server BroadWorks. Quando questa funzione è abilitata, la directory di chiamata completa dal server BroadWorks viene sincronizzata con la directory Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per ulteriori informazioni, andare a Sincronizzazione rubrica in Webex per Cisco BroadWorks.
Webex per il provisioning flowthrough di Cisco BroadWorks aggiunge utenti di messaggistica e informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, gli elenchi telefonici, gli utenti non di messaggistica e le entità non utenti non sono inclusi (ad esempio, un telefono della sala conferenze, un fax o un numero di gruppo di risposta). L'attivazione della sincronizzazione delle rubriche garantisce che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex.
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia chiamate e riunioni unificate Webex visualizzata sull'app Webex. Gli utenti possono visualizzare la cronologia dettagliata delle chiamate e della riunione dall'app Webex.
La cronologia chiamate unificata può essere abilitata dagli amministratori a livello di partner in Partner Hub su base cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata con il cloud Webex:
-
Eventi cronologia chiamate: questi eventi vengono utilizzati per creare una cronologia chiamate unificata dettagliata
-
Eventi di stato hook: la cronologia chiamate unificata include ottimizzazioni dello stato hook che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di Telephony Presence
Requisiti della cronologia chiamate unificata
Prima di configurare la cronologia chiamate unificata, accertarsi di aver eseguito la patch del sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
Per R23:
-
Se si utilizza XSP—AP.xsp.23.0.1075.ap378585
-
In caso di uso di ADP—
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
Per l'elenco completo delle patch BroadWorks che è necessario installare come prerequisito per l'esecuzione di Webex per Cisco BroadWorks, vedere Requisiti software BroadWorks nella sezione Riferimento.
Oltre alle patch del sistema, il file di configurazione del client (config-wxt.xml
) deve avere il seguente tag impostato: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altro reindirizzamento nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
-
AP.as.23.0.1075.ap383346
-
AP.as.23.0.1075.ap383994
Per R24:
-
AP.as.24.0.944.ap383346
-
AP.as.24.0.944.ap383994
Per avere informazioni Dirigente-Assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
-
AP.as.24.0.944.ap380052
-
AP.as.24.0.944.ap384239
-
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare anche la sincronizzazione delle rubriche per la cronologia chiamate unificata dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione NoDist, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti nel cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione di Broadworks durante la stessa finestra di manutenzione.
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configura organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettuare le seguenti operazioni:
-
Accedere a Partner Hub all'indirizzo
admin.webex.com
. -
Andare a Impostazioni e selezionare un cluster esistente.
-
Verificare che la connessione al cluster sia buona. Nel pannello a destra viene visualizzato un segno di spunta verde con Connection stabilita.
Se questa opzione non viene visualizzata, in Check Connnections (Opzionale), immettere BroadWorks User Id e BroadWorks Password e fare clic su Check per verificare che la connessione sia corretta.
-
Seleziona la casella di controllo Abilita privacy.
-
Fai clic su Salva.
Interazioni funzione
Per la cronologia chiamate unificata sono presenti le seguenti interazioni delle funzioni:
-
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando questa situazione esiste, gli eventi Cronologia chiamate e Stato hook non vengono inviati all'app Webex.
-
La cronologia chiamate unificate non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata dell'interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia chiamate unificata dall'app Webex. Per informazioni dettagliate, vedere: App Webex | Visualizzazione della cronologia di chiamate e riunioni
Disabilita cronologia chiamate unificata
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visivo
L'app Webex supporta un'indicazione visiva delle chiamate spam nel avviso popup quando la chiamata viene presentata al destinatario e nei record della cronologia delle chiamate unificate quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per abilitare questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- Le seguenti patch devono essere installate e attive:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o almeno AS-25_Rel_2022.12
- La funzione deve essere attivata tramite AS CLI:
- AS_CLI/System/ActivatableFeature> attiva 104112
- AS_CLI/System/StirShaken> imposta enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'etichettatura e la verifica STIR-SHAKEN come descritto in Cisco BroadWorks STIR-SHAKEN Signing Tagging and Verification
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste di invito inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti che vengono inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione di spam visivo nella presentazione della chiamata e nella cronologia chiamate unificata della chiamata.
Sincronizzazione stato assistente personale
La funzione di sincronizzazione stato dell'assistente personale (PA) sincronizza lo stato di presenza dell'assistente personale tra i dispositivi BroadWorks Calling e Webex App.
Il servizio PA fornisce all'utente un'opzione per informare i chiamanti del motivo per cui la parte chiamata non è disponibile, fornendo opzionalmente informazioni su quando la parte chiamata ritorna e se è presente un operatore per gestire la chiamata. La funzione PA consente agli utenti nelle app Webex di visualizzare la presenza dell'utente insieme allo stato PA e alla durata configurati.
Prerequisiti
Accertarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione BroadWorks.
Patch per RI e versione 24:
-
AP.as.24.0.944.ap385558
La funzione di sincronizzazione dello stato dell'assistente personale introduce un nuovo pacchetto di eventi PersonalAssistantSync per consentire ai client XSI di sincronizzare con le modifiche alla presenza dell'assistente personale Cisco BroadWorks. Per ulteriori informazioni, vedere Pacchetto eventi XSI per la funzione di sincronizzazione dello stato dell'assistente personale.
Oltre a applicare le patch al sistema, il file di configurazione del client (config-wxt.xml) deve avere il seguente tag impostato: <personal-assistant abilitato="%PERSONAL_ASSISTANT_ENABLED_WXT%"/>
Abilita sincronizzazione stato assistente personale (nuovo cluster)
Per abilitare la sincronizzazione dello stato dell'assistente personale su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configurazione dell'organizzazione partner in Partner Hub.
Abilita sincronizzazione stato assistente personale (cluster esistente)
-
Accedere a Partner Hub con le credenziali di amministratore partner all'indirizzo https://admin.webex.com.
-
Fai clic su Impostazioni organizzazione.
-
Fare clic su Visualizza cluster e selezionare il cluster BroadWorks appropriato.
- Nella sezione Interfaccia CTI, abilitare il tasto di alternanza Sincronizzazione stato assistente personale.
-
Inserire l'ID utente BroadWorks e fare clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione PA. Se la convalida non riesce, il pulsante Salva viene disabilitato.
-
Se la convalida ha esito positivo, fare clic su Salva.
L'abilitazione della sincronizzazione dello stato PA è un interruttore a una via. Una volta abilitata la funzione, non puoi disabilitarla da solo.
Impossibile disabilitare la sincronizzazione dello stato dell'assistente personale.
Una volta abilitato lo stato di sincronizzazione PA su uno dei cluster BroadWorks, non puoi disabilitare la funzione da solo. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Identificazione chiamante e reindirizzamento chiamata
identificazione chiamante
Quando l'app Webex riceve una chiamata, tenta di identificare il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra di chiamata e una volta completata la chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante abbinando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se trova più istanze di un numero in un'origine, non tenterà di sceglierne una, in questo caso, non visualizzerà alcun ID chiamante.
-
Webex Common Identity (CI) che contiene gli utenti della tua organizzazione.
-
Contatti personali e aziendali. I contatti personali sono visibili nella scheda Contatti.
-
Rubrica locale. In Windows - applicazione Outlook, in Mac - Contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non viene trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, utilizzerà la parte del nome utente dell'URI SIP dall'intestazione SIP From come ultima risorsa.
Per il controllo delle chiamate remote (ad esempio, modalità di controllo del telefono fisso) vengono utilizzate informazioni XSI, dove viene utilizzato ID BWKS o interno, estratte da informazioni di parte remota nell'evento XSI. Se l'informazione della parte remota non è disponibile, verrà utilizzata P-Asserted Identity (PAI) (se configurata).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica di chiamata e nella cronologia chiamate.
-
Inoltro chiamata Visualizza il numero che ha inoltrato la chiamata.
-
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
-
Coda Call Center: Visualizza il nome della coda che ha inoltrato la chiamata.
-
Assistente di direzione Mostra il nome del dirigente per il quale è in arrivo la chiamata.
Eccezione:
-
Per le chiamate nella coda chiamate interna, in cui un agente richiama una parte interna, la parte remota non visualizzerà il nome della coda chiamata, ma il nome dell'agente che le chiama.
Chiamata con risposta altrove:
Per gruppi di risposta o code chiamate impostate con indirizzamento simultaneo, gli agenti visualizzeranno una chiamata che ha ricevuto risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di risposta o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate perse nella cronologia chiamate se risposte da un altro agente.
Blocca ID chiamante
Panoramica
La funzione "Seleziona ID chiamante" consente agli utenti di passare tra diversi ID linea chiamante per le chiamate esterne. Se abilitato dall'amministratore, gli utenti possono scegliere tra le seguenti opzioni per l'identità della linea chiamante:
-
Numero utente ("Usa numero di telefono utente per identità linea chiamante")
-
CLID configurabile ("Usa CLID configurabile per identità linea chiamante")
-
CLID gruppo ("Usa numero di telefono di gruppo/reparto per identità linea chiamante")
Funzionalità
Gli utenti dispongono di due metodi per modificare l'ID chiamante predisposto dall'amministratore:
- Codici di accesso funzione (FAC): Codici specifici per ciascuna delle tre opzioni dell'ID chiamante.
- Interfaccia dell'app Webex: Una vista intuitiva all'interno delle app desktop e mobili Webex che visualizza le opzioni disponibili per l'ID chiamante abilitate dall'amministratore, consentendo agli utenti di selezionare l'ID preferito.
Risorse aggiuntive
- Le app Webex includeranno anche le opzioni per le code Call Center DNIS.
- Gli utenti dell'app mobile avranno opzioni Persona doppia disponibili per gli utenti di mobilità.
Precondizioni
Le seguenti condizioni devono essere soddisfatte sul server BroadWorks affinché l'utente possa controllare la propria scelta di criteri CLID esterni:
- Il flag di sistema 'EnableUserSelectionOfExternalCLIDPolicy' è abilitato.
- L'ambito ID linea di chiamata a livello di utente è impostato su "Usa criteri ID linea di chiamata utente" per questo utente.
- Il flag Criteri di elaborazione chiamate a livello di utente 'Consenti selezione utente di criteri CLID esterni' è abilitato per l'utente.
- Se non viene definito alcun numero per le opzioni "Usa CLID configurabile per l'identità della linea chiamante" o "Usa numero di telefono di gruppo/reparto per l'identità della linea chiamante", la visualizzazione dei FAC o dell'app non avrà effetto. Questa impostazione deve essere configurata dall'amministratore prima della selezione dell'utente.
Patch BroadWorks
Questa funzione richiede due patch BroadWorks specifiche per funzionare correttamente:
Consultare la Sezione 8 Release Independent e Service Patch Information.
- BWKS-5230 era la funzione CLID selezionabile dall'utente originale - consente agli utenti (se il sistema è configurato correttamente) di modificare i criteri CLID applicabili. Vedi FD qui: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/UserSelectionOfExternalCallingLineIDOptionFD-R250.pdf
- BWKS-9510 è un miglioramento XSI richiesto dal team del client Webex per facilitare la scoperta delle opzioni disponibili per un utente. Ciò è necessario perché la scelta dei criteri CLID non è una semplice funzione a livello di utente (come CFA) direttamente controllabile. Dipende piuttosto dalle diverse opzioni di configurazione del sistema e dalla gerarchia delle "politiche di elaborazione delle chiamate". I dettagli sono disponibili qui: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/XSIEnhancementToSupportUserSelectableCLIDFD-R250.pdf
Configurazione app Webex
Questi tag devono essere abilitati nelle configurazioni desktop, tablet e mobile:
<config> <servizi> <chiamate> <caller-id> <outgoing-calls enabled="%ENABLE_CLID_OUTGOING_CALLS_WXT%">
Aspetto chiamata condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni da tavolo. Questa funzione specifica consente di assegnare gli indicatori di linea condivisa all'app Webex dell'utente finale.
Questa funzione consente agli utenti di gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
-
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
-
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
-
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
-
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente alle linee condivise.
-
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise dal client Webex
R23 senza ADP:
-
AP.as.23.0.1075.ap384179
-
AP.xsp.23.0.1075.ap384179
R23 con ADP:
-
AP.as.23.0.1075.ap384179
-
XSI-Azioni-23_2022.10
R24:
-
AS: AP.as.24.0.944.ap384179
-
XSI-Azioni-24_2022.10
R25:
-
AS: Versione RI Rel_2022.10_1.310
-
XSI-Azioni-25_2022.10
Cerotto 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo. Esempio: Per il client desktop: Sistema>Tipo di profilo identità/dispositivo - Modifica> Business Communicator - PC: Profilo, opzioni standard, numero di porte:
- SE l'opzione 'Illimitato' è abilitata, non è richiesta alcuna modifica
- SE 'Limitato a' è <10, modificare il valore = 10 e salvarlo per utilizzare tutte le linee disponibili
-
Versione RI Rel_2022.10_1.310
Per dettagli sulla configurazione del client, vedere sezione 6.1.44 'Profilo principale' della Guida alla configurazione di Webex per Cisco BroadWorks.
Sincronizzazione Non disturbare (DND)
La sincronizzazione Non disturbare (NoDist) allinea le impostazioni NoDist tra Webex e BroadWorks sincronizzando lo stato NoDist tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato si sincronizza con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. Analogamente, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist da una piattaforma non vengono riconosciuti dall'altra piattaforma.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Se sono presenti molti clienti (>50) nel cluster BroadWorks, la sincronizzazione NoDist non è supportata. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza.
Prerequisiti
Accertarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione BroadWorks.
Per la versione 23:
<frammento>
- App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
<frammento>
- App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 su AS:
AS_CLI/System/ActivatableFeature> attiva 25433
Se sono presenti molti clienti (>50) nel cluster BroadWorks, operazioni come l'aggiornamento di azioni XSI, eventi XSI, URL DAS, URL XSP|ADP o sincronizzazione DND non sono supportate. In tali casi, si consiglia di contattare un tecnico del supporto TAC Cisco per assistenza.
Configura sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto di eventi "as-feature-event". Per informazioni dettagliate, vedere Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
-
Accedi a Partner Hub
-
Fare clic su Impostazioni.
-
Fare clic su Visualizza cluster e selezionare il cluster BroadWorks appropriato.
-
Abilita il tasto di alternanza Non disturbare (NoDist).
-
Inserire l'ID utente BroadWorks e fare clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione NoDist. Se la convalida non riesce, il pulsante Salva viene disabilitato.
-
Se la convalida ha esito positivo, fare clic su Salva.
-
Una volta abilitata la sincronizzazione NoDist, Webex aggiorna tutte le sottoscrizioni degli utenti per includere il pacchetto Evento Non disturbare. A seconda del numero di utenti, il completamento di questo processo potrebbe richiedere alcune ore.
-
L'abilitazione della sincronizzazione NoDist è un interruttore a una via. Una volta abilitata la funzione, non puoi disabilitarla da solo.
Abilita sincronizzazione NoDist (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per ulteriori dettagli, vedere "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Orario di pausa
Nelle distribuzioni Webex per BroadWorks, la funzione "Orario di pausa" si basa sulla funzionalità "Sincronizzazione Non disturbare (DND)" per garantire che le impostazioni dell'orario di pausa siano sincronizzate su tutti i dispositivi. Per sincronizzare correttamente l'orario di pausa tra desktop e dispositivi mobili, assicurarsi che l'opzione 'Sincronizzazione NoDist' sia abilitata nell'account dell'utente.
Disabilita sincronizzazione NoDist
Non puoi disabilitare la sincronizzazione NoDist da solo. Per disabilitare la funzione, crea un caso BEMS di ingegneria con le seguenti informazioni:
-
Famiglia: Servizio Spark
-
Prodotto: Chiamata in Webex (Webex per BroadWorks)
-
Componente Provisioning WxBW
-
Il caso BEMS deve indicare che la sincronizzazione non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterIdBroadWorks.
Caso d'uso
Registrazione chiamata
Webex per BroadWorks supporta quattro modalità di registrazione chiamata:
Registrazione del video |
Descrizione |
Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre |
Sempre:la registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi |
Sempre:la registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta |
OnDemand: la registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma la registrazione viene eliminata a meno che l'utente non premaAvvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione. |
|
OnDemand con avvio avviato dall'utente |
OnDemand con avvio avviato dall'utente: la registrazione non viene avviata a meno che l'utente non seleziona l'opzioneAvvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
-
Per R22: AP.as.22.0.1123.ap377718
-
Per R23: AP.as.23.0.1075.ap377718
-
Per R24: AP.as.24.0.944.ap377718
L'identificativo di correlazione chiamata deve essere attivato. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione delle chiamate su BroadWorks, andare alla Guida all'interfaccia di registrazione delle chiamate Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, vai all'articolo help.webex.com
Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla piattaforma di registrazione chiamate di terze parti.
Abilitazione della casella vocale per l'integrazione Microsoft Teams
Puoi abilitare la casella vocale per gli utenti Microsoft Teams nella soluzione Webex per BroadWorks. Questa integrazione consente agli utenti di recuperare le proprie caselle vocali direttamente attraverso Microsoft Teams, migliorando l'esperienza utente generale.
Procedura per abilitare la casella vocale
Per abilitare la casella vocale per BroadWorks, devi abilitare il tasto di alternanza broadworks-voicemail-enabled-spark-541886: true a livello di organizzazione.
Per abilitare questa funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Esperienza utente
Una volta impostata l'integrazione, gli utenti possono:
- Recupera le caselle vocali direttamente nell'applicazione Microsoft Teams.
- Ricevi notifiche per nuove caselle vocali.
- Gestisci le impostazioni della casella vocale dall'interfaccia Webex.
Requisiti
Per supportare il recupero della casella vocale nell'integrazione Microsoft Teams con l'offerta Webex per BroadWorks, sono necessarie ulteriori modifiche di rete. I partner BroadWorks devono abilitare la condivisione delle risorse cross-origin (CORS) per i seguenti URL sulla piattaforma BroadWorks:
- https://jabber-integration-a.wbx2.com/
- https://jabber-integration-r.wbx2.com/
- https://jabber-integration-k.wbx2.com/
- https://msteams-calling.webex.com/
Per ulteriori dettagli sulle fasi di configurazione, consultare la sezione 8.5.1.2 della Guida alla configurazione della piattaforma di consegna delle applicazioni BW, che richiede la versione 2024.05 sull'ADP.
Gruppo Parcheggio chiamata e recupera
Webex per BroadWorks supporta la funzionalità Dise Parcheggio chiamata e Retrieve. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti del retail in un'impostazione di store possono utilizzare la funzione per parcheggiare una chiamata che può essere selezionata e continuata da qualcuno in un altro reparto.
Funzionamento funzione
Una volta configurata la funzione
-
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nell'app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'estensione all'utente per un periodo di 10 secondi.
-
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nell'app Webex. L'utente quindi inserisce l'estensione della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per attivare questa funzione, verificare quanto segue:
-
Il file di configurazione client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
-
L'identificativo di correlazione delle chiamate deve essere abilitato su AS e XSP|ADP. Per i dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
-
L'SBC deve essere configurato per passare l'attributo SIP '
x-broadworks-correlation-in
' a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiungi gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo del server applicazioni Cisco BroadWorks - Parte 2. È necessario creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Webex | Parcheggio e recupero delle chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzato
Il parcheggio chiamate regolare o indirizzato non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso alle funzioni:
-
Immettere *68 per parcheggiare una chiamata
-
Immettere *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato negli ambienti del call center o in altre situazioni in cui può essere necessaria un'assistenza o un intervento immediati.
Quando un servizio di inclusione è abilitato, un utente o supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di tasti o pulsanti dedicati sul proprio telefono o dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o di partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in vari scenari. In un ambiente di call center, supervisori o formatori possono monitorare e assistere i rappresentanti del servizio clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire assistenza o prendere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può partecipare rapidamente a conversazioni in corso per fornire assistenza o prendere decisioni importanti.
Nell'app Webex per l'inclusione, viene inviata una notifica che la chiamata viene trasformata in una conferenza. In NOTIFY (informazioni sulla chiamata o conferenza) non sono disponibili ulteriori informazioni sul tipo di conferenza, pertanto è possibile trattarla in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Vengono introdotti i seguenti termini:
-
Supervisore Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore solitamente ha la possibilità di monitorare e intervenire nelle chiamate in corso dei clienti. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire assistenza agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può comprendere la formazione degli agenti, la gestione dei problemi dei clienti e l'ottimizzazione delle prestazioni del team.
-
Cliente Per cliente si intende una persona fisica o giuridica che interagisce con un'azienda o un'organizzazione per ottenere prodotti, servizi o assistenza. Nel contesto dell'inclusione delle chiamate, un cliente è qualcuno che sta effettuando o ricevendo una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risolvere le loro richieste o problemi durante la chiamata. La funzione di inclusione chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
-
Agenti Un agente, anche noto come rappresentante del servizio clienti o agente di call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza telefonica o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare operazioni e offrire un'esperienza positiva al cliente. Nel contesto dell'inclusione delle chiamate, un agente è la persona che parla direttamente al cliente durante la telefonata. L'agente può ricevere indicazioni o feedback dal supervisore attraverso l'inclusione della chiamata, se necessario.
Per qualsiasi richiesta avviata dal client come CallStartRequest, CallPickupRequest, DirectedCallPickupRequest, DirectedCallPickupWithBargeInRequest, ecc., se <Webex Client> (scegliere il nome corretto anziché il client Webex, se non è appropriato) viene fornito come dispositivo di visualizzazione della chiamata condivisa, la configurazione 'Avvisa tutti gli aspetti per le chiamate Click-to-Dial' deve essere abilitata nell'impostazione Identificativo chiamata condivisa affinché il client riceva una chiamata, a meno che la posizione non sia esplicitamente fornita dal client che avvia la richiesta.
La chiamata nativa mobile viene inoltrata alla riunione
La funzione di escalation della chiamata nativa mobile alla riunione è dotata di due funzioni uniche:
-
Notifica push locale
Gli utenti mobili su una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando si avvia una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si accede direttamente alla schermata in chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata utilizzando il controllo chiamate Cisco per le chiamate su cellulare, viene visualizzata la notifica Webex durante una chiamata su cellulare.
-
Trasferisci chiamata mobile a riunione
Quando sei nel mezzo di una chiamata con qualcuno, potresti voler trasferire la chiamata in una riunione per utilizzare alcune funzioni di riunione avanzate come video, condivisione o lavagna. In alternativa, invitare altre persone alla discussione e passare a una riunione.
Requisiti BroadWorks
-
Funzione attivabile 25239
-
R23 con XSP|ADP:
-
AS Patch AP.as.23.0.1075.ap383064
-
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
-
Patch AP.platform.23.0.1075.ap383064
-
-
R23 con ADP:
-
AS Patch AP.as.23.0.1075.ap383064
-
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e versione NPS > 2022.08_1.350
-
-
R24:
-
Cerotto AS: AP.as.24.0.944.ap383064
-
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e versione NPS > 2022.08_1.350
-
-
R25:
-
Versione RI Rel_2022.08_1.354
-
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e versione NPS > 2022.08_1.350
-
Configurazione chiamata URI per supportare lo spostamento della chiamata alla riunione
Criteri di chiamata Url NS
Definisci la regola per (.*)webex.com da indirizzare attraverso I-SBC
NS_CLI/Policy/UrlDialing> ottieni criteri WebexMeetings: Istanza di chiamata Url: Webex unknownSipURIHandling = rifiuta disableSubscriberLookups = true Abilita = true CallTypes: Selezione = {ALL} Da = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP} lineportOnly = false enableSipURIMatchingRules = true NS_CLI/Policy/UrlDialing/Rules> ottieni criteri WebexMeetings: Istanza di chiamata Url: Tabella WebexCalling: Instradamento schema ID regolePeso costo dtg =================================================================== 1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE di indirizzamento NS per I-SBC
Configurazione base
NS_CLI/System/Device/RoutingNE> ottieni elemento di rete WebexMeetings Posizione = 1281465 Centro dati = Costo statico = 1 Peso statico = 99 Sondaggio = falso OpState = stato abilitato = Profilo onLine = NIL_PROFILE Ricerca remota abilitata = falso Attributi di segnalazione = NS_CLI/System/Device/RoutingNE/Address> ottieni WebexMeetings indirizzamento NE indirizzo Peso costo Percorso trasporto porta ===================================================================== WebexMeetings sbc-address 1 99 - non specificato
Profilo di indirizzamento NS
Aggiunta dell'istanza della policy UrlDialing ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> ottieni il profilo MyInst: Istanza criteri Webex========================================== ... UrlDialing WebexMeetings
AS Usa indirizzamento NS per chiamata NetworkURL
Consente all'AS di rispettare il percorso NS in modalità ibrida AS
AS_CLI/Interface/IMS> imposta queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un PSAP (Public Safety Answering Point), che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, è necessario integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Usa i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
-
Chiamata di emergenza E911 in Webex per BroadWorks: utilizzare questo articolo per configurare la chiamata di emergenza E911 in Webex per Cisco BroadWorks utilizzando uno dei seguenti provider E911 supportati:
-
Banda
-
Intrado
-
RedSky
-
-
Esclusione di responsabilità per chiamate di emergenza: se disponi di un servizio di posizione, puoi configurare la finestra Esclusione di responsabilità per i servizi di emergenza sull'app Webex in modo da includere un'opzione per gli utenti per aggiornare la propria posizione quando eseguono l'accesso.
Personalizzazione e provisioning dei clienti
Gli utenti scaricano e installano le relative app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedere Piattaforme app Webex). Una volta eseguita l'autenticazione, il client si registra su Webex Cloud per messaggi e riunioni, recupera le relative informazioni di branding, rileva le relative informazioni sul servizio BroadWorks e scarica la configurazione di chiamata dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
Configurare i parametri di chiamata per le app Webex in BroadWorks (come di consueto). Configurare i parametri di branding, messaggistica e riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta dei modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
-
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Prepara il tuo ambiente).
-
Verificare di disporre dei set di tag corretti in BroadWorks System > Resources > Device Management Tag Sets.
-
Per ciascun client che si sta eseguendo il provisioning:
-
Scaricare ed estrarre il file zip DTAF per il client specifico.
-
Importare i file DTAF in BroadWorks all'indirizzo System > Resources > Identity/Device Profile Types
-
Apri il profilo dispositivo appena aggiunto per la modifica e:
-
Inserire il nome di dominio completo (FQDN) dell'azienda agricola XSP|ADP e il protocollo di accesso dispositivo.
-
Selezionare la casella di controllo Support Remote Party Info. Questo supporto è richiesto per il funzionamento della condivisione desktop.
È inoltre possibile abilitare il supporto Parte remota eseguendo il seguente comando CLI sul server applicazioni:
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
-
-
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
-
Salvare il profilo.
-
-
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome |
Descrizione |
Priorità codec |
Configurazione dell'ordine di priorità per i codec audio e video per le chiamate VoIP |
TCP, UDP e TLS |
Configurare i protocolli utilizzati per la segnalazione e il contenuto multimediale SIP |
Porte audio e video RTP |
Configurazione degli intervalli di porte per audio e video RTP |
Opzioni SIP |
Configurare diverse opzioni relative a SIP (SIP INFO, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
-
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti gestiti dal partner. Configurazione delle personalizzazioni del branding avanzato
-
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client.
Personalizzazione dei report dei problemi e degli URL della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito Feedback e Guida", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
provisioning flowfunzionale
Prima di eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 |
Assegna servizio in BroadWorks: |
2 |
Verifica dell'organizzazione cliente e degli utenti in Control Hub: |
Impostazioni utente
1 |
Scaricare l'app Webex su due diverse macchine. |
2 |
Eseguire l'accesso come utenti di test sulle due macchine. |
3 |
Effettuare chiamate di prova. |
Gestione di Webex per BroadWorks
Pre provisioning organizzazioni clienti
Nel modello corrente, viene eseguito automaticamente il provisioning dell'organizzazione del cliente quando si onboard il primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguita una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
-
Usa API per creare account Webex
-
Assegnare i messaggi e-mail integrati IM&P (provisioning flow) con e-mail affidabili per la creazione di account Webex
-
Assegna IM&P integrato (provisioning FLOW) senza messaggi e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per la creazione di account Webex
-
Consenti agli utenti l'attivazione autonoma (inviando loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex sono esposti API pubbliche per consentire ai provider di servizi di integrare Webex per il provisioning del sottoscrittore Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. La specifica per queste API è disponibile developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti wholesale verranno rifiutati da queste API.
Provisioning Flow
Su BroadWorks, è possibile fornire agli utenti l'opzione Abilita IM integrato&P. Questa azione causa il provisioning dell'adattatore BroadWorks per rendere chiamata API di eseguire il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile retrocompatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica di codice, ma solo una modifica di configurazione all'endpoint API per l'adattatore di provisioning.
La fornitura del sottoscrittore su Webex può richiedere una notevole quantità di tempo (diversi minuti per l'utente iniziale in un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il completamento del provisioning di flusso indica che il provisioning è stato avviato. Non indica il completamento.
Per verificare che gli utenti e l'organizzazione del cliente siano completamente predisposti su Webex, è necessario accedere a Partner Hub e ricercare l'elenco dei clienti.
Gli utenti di trunking BroadWorks possono disporre di Webex per BroadWorks tramite un identificativo di chiamata condiviso (SCA). L'utente che esegue il trunking dovrà disporre del servizio di autenticazione assegnato. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto Webex SCA dall'autenticazione del trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con le funzioni di elenco di indirizzamento o indirizzamento diretto assegnate.
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata Modello di onboarding.
Attivazione automatica utente
Per fornire gli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
-
Accedere a Partner Hub e trovare la pagina Elenco client i.
-
Fare clic su View Templates (Visualizzamodelli).
-
Seleziona il modello di onboarding di provisioning che desideri applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non è nel sistema BroadWorks associato a questo modello, l'utente non può attivare automaticamente con il collegamento.
-
Copiare il collegamento per il provisioning e inviarlo all'utente.
È possibile anche includere il collegamento di download del software e ricordare all'utente che deve fornire e convalidare il relativo indirizzo e-mail per attivare l'account Webex.
-
È possibile monitorare lo stato di attivazione dell'utente sul modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi diattivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli nella vista Stato utente che consentono agli amministratori di Cisco BroadWorks provider di servizi di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Spostamento degli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a… |
Seguire questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (es., account gratuito, account di prova) |
Se l'organizzazione Webex per BroadWorks non esiste (nessun utente predisposto):
Se esiste un'organizzazione Webex per BroadWorks (viene predisposto almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di autoiscrizione (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (con il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
-
Sposta utente (con e-mail attendibili): utilizza il provisioning con e-mail attendibili
-
Sposta utente (con e-mail non attendibili): utilizza il provisioning con e-mail non attendibili
-
Attivazione automatica
Se l'organizzazione Webex per Cisco BroadWorks non è ancora stata creata (nessun utente predisposto), seguire i normali processi di provisioning (Provisioning utenti) per creare l'organizzazione e aggiungere il primo utente come utente di amministrazione. Una volta eseguito il provisioning del primo utente nell'organizzazione, seguire i metodi basati sul consenso in questa procedura per spostare gli utenti successivi.
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza messaggi e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Activate Account (Attivaaccount). L'utente viene reindirizzato al portale consumer Webex.
-
L'utente accede a Webex.
-
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza messaggi e-mail non attendibili, è necessario prima convalidare l’indirizzo e-mail dell’utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito automaticamente sul bridge di provisioning BroadWorks.
-
All'utente viene inviato un testo con un collegamento di attivazione.
-
-
L'utente fa clic sul collegamento Attivazione e inserisce il relativo indirizzo e-mail.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Partecipaora.
-
Indirizzo e-mail convalidato.
-
L'utente viene reindirizzato per accedere al portale Webex Consumer.
-
-
L'utente accede a Webex.
-
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Flusso di attivazione automatica
Se l'utente dispone di un account BroadWorks esistente, potrà utilizzare il processo di attivazione automatica per spostare l'account.
-
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
-
L'utente inserisce il relativo indirizzo e-mail.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
Viene inviato un messaggio e-mail automatico all'indirizzo e-mail dell'utente.
-
-
L'utente apre il messaggio e-mail e fa clic sul collegamento Partecipa ora, che convalida l'indirizzo e-mail.
-
CI ha rilevato che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di continuare.
-
L'utente viene reindirizzato per accedere a Webex.
-
-
L'utente accede al portale consumer.
-
L'utente fa clic su Delete Account (Eliminaaccount).
-
L'account Webex precedente viene eliminato.
-
L'utente ha predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
Collegamento di Webex per BroadWorks all'organizzazione esistente
Se sei un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, che non è ancora associata a un'azienda BroadWorks gestita da un partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso amministratore per la richiesta di provisioning riuscita.
È necessaria l'approvazione dell'amministratore dell'organizzazione se una delle seguenti affermazioni è vera:
-
L'organizzazione cliente esistente dispone di 100 utenti o più
-
L'organizzazione dispone di un dominio e-mail verificato
-
Dominio organizzazione richiesto
Se nessuno dei criteri di cui sopra è vero, può verificarsi un Attacco automatico.
In uno scenario di allegato automatic o, un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner verranno concessi diritti di amministrazione provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà eseguito un amministratore completo.
Con l'accesso amministratore di provisioning, la visibilità in Control Hub sarà limitata agli utenti nell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione.
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che i messaggi e-mail di invito amministratore vengano collegati a organizzazioni esistent i (il tasto di alternanza è attivo per impostazione predefinita).
1 |
L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedere Provisioning delle organizzazioni dei clienti. Si verifica quanto segue:
Supponiamo che l'amministratore del cliente non riceva un messaggio e-mail. In tal caso, l'amministratore del cliente può aggiungere manualmente l'amministratore del partner (specificato nel modello) come amministratore esterno dell'organizzazione del cliente da Control Hub. Quindi, riprovare a eseguire il provisioning dell'utente, che attiverà il provisioning dei clienti Webex per Cisco BroadWorks. |
2 |
Con l'accesso amministratore complet o, l'amministratore del partner può completare il processo di provisioning del cliente. Dovrai provare a eseguire nuovamente il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora come amministratore completo esterno, non si dovrebbe osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione cliente esistente sarà visibile come cliente sotto Webex per l'organizzazione partner BroadWorks. Il nome dell'organizzazione allegata non cambia nel nome aziendale BroadWorks. Il nome dell'organizzazione allegata rimarrà invariato prima del processo di allegato. |
Condizioni dell'allegato organizzazione
-
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione cliente di destinazione. In caso contrario, verrà creata una nuova organizzazione cliente.
-
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
-
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato sul modello di provisioning Webex per BroadWorks. Di conseguenza, non vi sono modifiche alla modalità di accesso degli utenti esistenti.
-
Tuttavia, se l'organizzazione cliente esistente dispone di branding di base abilitato, una volta eseguito il collegamento, le impostazioni di branding avanzate del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
-
-
Il nome dell'organizzazione esistente non cambierà.
-
Non è stata apportata alcuna modifica all'impostazione del flag di soppressione e-mail nelle impostazioni dell'organizzazione esistente. Ciò può avere effetto sui nuovi utenti predisposti. A seconda di come è impostato il flag, i nuovi utenti possono o meno ricevere un'e-mail con un codice che deve essere immesso per completare l'attivazione.
-
La modalità di amministrazione con restrizioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
-
Accertarsi di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
-
Un'azienda BroadWorks può essere associata solo a una organziazione Webex. Non è possibile eseguire il provisioning degli abbonati da una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com .
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo.
L'indirizzo e-mail aggiunto dall'amministratore dell'organizzazione cliente come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore partner come configurato nel modello di onboarding su Partner Hub.
Dopo aver aggiunto l'e-mail dal modello di onboarding in Partner Hub come amministratore completo, qualsiasi amministratore aggiuntivo del partner dovrà essere aggiunto anche come amministratore esterno con diritti di amministratore completo.
Scollegare Webex per BroadWorks dall'organizzazione esistente
Attenersi alla procedura riportata di seguito per scollegare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato accidentalmente Webex per BroadWorks a un'organizzazione esistente e si desidera rimuovere l'allegato.
In Flusso standard, il distacco di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati.
-
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso all'amministratore esterno seguendo Approva richiesta amministratore esterno.
-
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Remove a BroadWorks Workspac e.
-
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API di rimozione di un abbonato BroadWork s.
-
Rimuovi gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se gli utenti sono stati predisposti tramite il flusso e-mail non attendibile e non sono stati ancora inseriti messaggi e-mail validi, gli utenti rimangono in stato di attesa. Segui Verifica provisioning utente con e-mail non attendibil i per eliminare gli utenti.
-
Elimina la configurazione BroadWorks Callin g per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Hybrid, nella sezione BroadWorks Calling elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera collegare Webex per BroadWorks al cliente, seguire i processi di provisioning per collegarlo a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API abbonato Remove a BroadWorks è quella di andare in BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati.
Gestione di utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente vengono tenuti in BroadWorks. Un'identità e-mail distinta per l'utente e relative licenze per le funzioni Webex sono tenute in Webex.
Verifica del provisioning utenti con indirizzi e-mail non attendibili
Se si sta predis facendo il provisioning di Webex per utenti BroadWorks utilizzando il provisioning flow-through con messaggi e-mail non attendibili, gli utenti devono autoproducersi inserendo il proprio indirizzo e-mail nel portale di attivazione utenti. Se l'utente rileva un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riconorà l'errore, l'amministratore può utilizzare la procedura seguente in Partner Hub per esaminare lo stato e onboardre l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 |
Accedere a Partner Hub e trovare la pagina Elenco client i. |
2 |
Fare clic su View Templates (Visualizzamodelli). Selezionare il modello di onboarding appropriato che si desidera applicare a questo utente. |
3 |
In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con messaggi e-mail non attendibili sia configurato correttamente:
|
4 |
Dopo il provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato di provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo Stato corrente, che mostra se l'utente è stato predisposto o se è presente un requisito in sospeso.
|
5 |
Per gli utenti con errori o requisiti in sospeso, fare clic sui tre puntini a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili durante la visualizzazione dell'elenco di utenti:
-
Esporta: fare clic su questo pulsante se si desidera esportare l'elenco utenti in un file CSV.
-
Escludi utenti predisposti: abilita questo tasto di alternanza se desideri visualizzare solo gli utenti con requisiti o errori in sospeso.
Modifica ID utente o indirizzo e-mail
Modifiche dell'ID utente e dell'indirizzo e-mail
ID e-mail e ID alternativo sono attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. Nella tabella seguente vengono descritti gli scopi di questi diversi attributi e le operazioni da eseguire per modificarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non è possibile modificare questo identificativo e collegare comunque l'utente allo stesso account in Webex. È possibile eliminare l'utente e crearla nuovamente se è errata. |
ID e-mail | ID utente |
Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si asserzione di attendibilità dell'e-mail Non richiesto in BroadWorks se non si asserzione di affidabilità dei messaggi e-mail Non richiesto in BroadWorks se si consente agli abbonati di attivare automaticamente |
Se l'utente è predisposto con l'indirizzo e-mail errato, è necessario effettuare un processo manuale per modificare questa impostazione in entrambi i punti:
Non modificare l'ID utente BroadWorks. Operazione non supportata. |
ID alternativo | Nessuno | Abilita autorizzazione utente, tramite e-mail e password, a fronte dell'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti devono immettere il relativo ID utente BroadWorks durante l'autenticazione. |
Modifica del pacchetto utente nell'hub partner
1 |
Accedere all'hub partner e fare clic su Clienti. |
2 |
Individuare e selezionare l'organizzazione del cliente in cui si trova l'utente. La pagina di panoramica dell'organizzazione viene visualizzata in un pannello a destra dello schermo. |
3 |
Fare clic su View Customer (Visualizzacliente). L'organizzazione del cliente viene aperta in Control Hub, che mostra la pagina Panoramica.
|
4 |
Fare clic suUtenti, quindi individuare e fare clic sull'utente interessato. |
5 |
In Servizi dell'utente, fare clicsu Webex per pacchetti BroadWorks (Sottoscrizioni). Viene visualizzato il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 |
Nella scheda Profilo , cercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 |
Selezionare il pacchetto desiderato per questo utente (Base, Standard, Premiu m o Softphone) e fare clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 |
È possibile chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium dispongono di siti per riunioni distinti associati a ciascun pacchetto. Se un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato visualizza due siti per riunioni in Control Hub. Le funzionalità di riunione e il sito della riunione dell'abbonato si allineano al pacchetto corrente. Il sito per riunioni del pacchetto precedente e tutto il contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili ad Amministrazione sito riunione.
Potrebbero essere necessario da due a tre ore per le PMR di aggiornamento che sono risultate da una modifica del pacchetto all'aggiornamento.
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si desidera eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto alcun trasferimento automatico del ruolo di amministratore nel caso in cui venga eliminato l'ultimo amministratore.
Webex per API Cisco BroadWorks
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
-
Eseguire la richiesta di rimozione dell'API di un abbonato BroadWorks su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento a Webex per Cisco BroadWorks. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
Eseguire la richiesta DI ELIMINAZIONE DI una persona su per eliminare completamente https://developer.webex.com/docs/api/v1/people/delete-a-person l'utente.
Flow-through Provisioning
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
-
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – PAGINA IM&P integrata su BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento Webex per Cisco BroadWorks dall'utente. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori dei clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla relativa organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 |
Usa le API Persone per eliminare tutti gli utenti dall'organizzazione: L'API di rimozione di un abbonato BroadWorks rimuove i diritti Webex per Cisco BroadWorks da un utente, ma non lo elimina. |
2 |
Se la sincronizzazione rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione rubriche tramite Partner Hub: Per disabilitare la sincronizzazione rubriche tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API aziendale BroadWork s e disabilita l'impostazione enableDirSyn c. Tutti gli utenti correlati alla sincronizzazione rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione degli utenti (utilizzando entrambi i metodi) può richiedere del tempo a seconda della quantità di utenti. |
3 |
Una volta rimossi tutti gli utenti, utilizza l'API Elimina un'organizzazion e per eliminare l'organizzazione. |
Annullamento di un abbonamento da Control Hub
Poiché l'API è privata, i clienti non avranno accesso ad essa. Al contrario, le seguenti operazioni mostrano come i clienti possono annullare il proprio abbonamento da Control Hub:
-
L'amministratore del partner può passare alla pagina dei servizi "Hybrid" sul Control Hub del cliente.
-
Individua la scheda "BroadWorks Calling".
-
Una volta eseguito il provisioning di tutti gli utenti da Webex per BroadWorks per tale cliente, il partner deve visualizzare un pulsante "Cancella configurazione" (ad esempio, eliminare la customer_config voce in BPB).
Gestione delle release
I controlli di gestione delle release in Partner Hub consentono ai provider di servizi Cisco BroadWorks di gestire le release fornendo loro la possibilità di controllare la data di rilascio in base alla quale le app Webex degli utenti ese upgrade all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza gli aggiornamenti automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
-
Configurazione di pianificazioni di rilascio personalizzate con rinvii dalla pianificazione di rilascio predefinita Cisco
-
Configurare una singola pianificazione della release e trasferirla a cascata a tutte le organizzazioni dei clienti che gestiscono
-
Assegna diverse pianificazioni di rilascio a diverse organizzazioni di clienti
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di rilascio personalizzate, vedere l'articolo Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
-
Aggiunta di un cluster BroadWorks in Hub partner
-
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
-
Aggiunta di un modello di onboarding in Partner Hub
-
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su |
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. |
3 |
Fare clic su View Clusters (Visualizzacluster). |
4 |
Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro a destra.
|
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su | |||||||||
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. | |||||||||
3 |
Fare clic su View Templates (Visualizzamodelli). | |||||||||
4 |
Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere Assistente Webex follow-up su attività, prendere nota di importanti decisioni ed evidenziare momenti chiave durante una riunione o un evento.
Webex Assistant per Meetings è disponibile gratuitamente per i siti per riunioni con pacchetto Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilitazione di Webex Assistant per Meetings
Webex Assistant è abilitato per impostazione predefinita per i clienti Broadworks con pacchetto standard e premium.
Gli amministratori dei partner e gli amministratori delle organizzazioni dei clienti possono disabilitare la funzione per le organizzazioni dei clienti tramite Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
-
Il supporto è limitato ai siti per riunioni con pacchetto Premium e Standard e solo alle sale riunioni personali.
-
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
-
La condivisione di contenuto tramite e-mail è accessibile solo dagli utenti all'interno della tua organizzazione
-
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Il contenuto della riunione non è accessibile anche se condiviso tra utenti di pacchetti diversi dall'interno della stessa organizzazione.
-
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
-
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile, pertanto le trascrizioni post-riunione non sono disponibili se Webex Assistant è abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni utente su come utilizzare la funzione, vedere Uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
Webex Calling gratuito è abilitato per impostazione predefinita consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, che disabilita tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzioni
Se Webex Calling è disabilitato, le seguenti condizioni si applicano a Webex per gli utenti Cisco BroadWorks:
-
Gli utenti non visualizzano più Chiamata con Webe x come opzione di chiamata selezionabile sull'app Webex.
-
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, la cronologia chiamate, i contatti, inserendo l'URI dell'altro utente o l'indirizzo e-mail nella barra di ricerca.
-
Condivisione schermo all'interno di una chiamata BroadWorks.
-
Le riunioni Webex e la presenza in telefonia funzionano ancora, anche se le chiamate Webex sono disabilitate.
Disabilita chiamate Webex (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuit a Cisco Webex all'interno di Aggiungi un nuovo modell o guidata. Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti assegnate al modello.
Per informazioni dettagliate sulla configurazione di un nuovo modello di onboarding, vedere Configurazione dell'organizzazione partner in Partner Hub.
Disabilita chiamate Webex (modello di onboarding esistente)
Seguire questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
-
Accedere a Partner Hub all'indirizzo admin.webex.com.
-
Scegliere Impostazioni.
-
Fare clic su Visualizza modell o e scegliere il modello di inserimento appropriato.
-
Fai clic su Disabilita chiamata gratuita Cisco Webex.
-
Fare clic su Salva.
Disabilita chiamate Webex (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare Webex Calls per un utente esistente, è possibile seguire una delle procedure seguenti per aggiornare l'utente.
Accertarsi di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigura l'utente con le chiamate Webex abilitate.
Se si utilizza il provisioning flow-through, è possibile effettuare le seguenti operazioni:
-
Aprire CommPilot e passare alla configurazione utente.
-
Rimuovere il servizio Integrated IM+ P dall'utente e fare clic su OK.
-
Aggiungere il servizio Integrated IM+ P all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
-
Utilizzare Remove a BroadWorks Subscriber AP I per eliminare l'utente.
-
Utilizzare la Provisioning di un'API abbonato BroadWork s per aggiungere l'utente.
Disabilitazione della condivisione video o dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per informazioni dettagliate sulla configurazione e le opzioni complete, vedere Disabilitazione delle videochiamat e e Disabilitazione della condivisione dello scherm o nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è anche possibile configurare se il contenuto multimediale delle chiamate in ingresso utilizza per impostazione predefinita solo il video o l'audio.
Indicatore di stato della linea / Notifica risposta per assente
L'indicatore di stato/notifica di risposta per assente utilizza le funzioni di risposta per assente indirizzata. Un utente con indicatore di stato riceve una notifica audio e visiva sull'app Webex quando un utente dell'elenco di indicatori di stato monitorato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può Ignorar e o Risponder e alla chiamata dell'utente monitorato.
La notifica dell'indicatore di stato/risposta per assente consente di rispondere alle chiamate di altri membri del team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra chiamata multipla - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza dei membri del team Webex e non Webex. Per informazioni sull'abilitazione della chiamata multipla, vedere: Finestra multi-chiamata
I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati nella rubrica in Webex e avranno solo stati "sconosciuti" e "in chiamata" (lo stato suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
-
La presenza non è supportata per gli utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
-
Gli utenti CI senza autorizzazione cloud Webex o tipo di account macchina (spazi di lavoro) visualizzano solo la presenza "in chiamata" e "sconosciuta". Nessun stato attivo, suoneria, ecc.
-
Gli utenti non Webex dall'elenco di indicatori di stato, che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza "sconosciuta".
-
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
-
Se un utente non Webex dell'indicatore di stato detiene una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate su BroadWorks. Installare solo le patch valide per la versione in uso:
Per R22:
-
Piattaforma AP.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382362
-
AP.xsp.22.0.1123.ap382053
-
AP.xsp.22.0.1123.ap382362
-
AP.as.22.0.1123.ap383459
-
AP.as.22.0.1123.ap383520
Per R23:
-
Piattaforma AP.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382362
-
AP.as.23.0.1075.ap383459
-
AP.as.23.0.1075.ap383520
-
Se si utilizza XSP|ADP:
-
AP.xsp.23.0.1075.ap382053
-
AP.xsp.23.0.1075.ap382362
-
-
Se si utilizza ADP:
-
Xsi-Actions-23_2022.0_11.200.bwar
-
Xsi-Events-23_2022.0_11.201.bwar (o versione successiva)
-
Per R24:
-
AP.as.24.0.944.ap382053
-
AP.as.24.0.944.ap382362
-
AP.as.24.0.944.ap383459
-
AP.as.24.0.944. ap383520
-
Xsi-Actions-24_2022.0_11.200.bwar
-
Xsi-Events-24_2022.0_11.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
-
<indicatore di stato abilitato="%ENABLE_BUSY_LAMP_FIELD_WXT%">
-
<display caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
-
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(tag facoltativo)
È necessario attivare la funzione 101642 Enhanced Xsi Mechanism Per la telefonia del team su AS:
AS_CLI/System/ActivatableFeature> attiva 101642
Abilitare X-BroadWorks-Remote-Party-Info
su AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamata SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> impostazione <device_profile_type> supportRemotePartyInfo true
Accertarsi che i seguenti servizi siano assegnati agli utenti:
-
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
-
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione dell'indicatore di stato della linea su BroadWorks
Gli amministratori dei partner possono utilizzare la seguente procedura per impostare l'indicatore di stato della linea per un utente.
-
Accedere a BroadWorks CommPilot.
-
Per un utente selezionato, accedere ad Applicazioni clien t e configurare l'indicatore di stato della linea.
-
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
-
Utilizzare i parametri di ricerca per individuare e aggiungere utenti all'elenco Utenti monitorat i.
-
Fare clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento facile da utilizzare per il coinvolgimento del pubblico. Consente alle persone di ottenere il massimo dalle riunioni colmando la differenza tra gli oratori e i partecipanti. Se Slido questa funzione è integrata nell'organizzazione Control Hub, gli utenti possono aggiungere l'app Slido alle relative riunioni nell'app Webex. Questa integrazione aggiunge funzionalità Q&A di sondaggi e di sondaggi aggiuntivi alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando è stata accettata una riunione nel client Outlook che corrisponde a un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che hai assunto un impegno diverso e che la risposta potrebbe essere ritardata.
Per abilitare questa funzione:
-
andare alla scheda General e della scheda Impostazion i su Windows o Preferenz e su Mac.
-
Selezionare la casella per Mostra in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, "In una riunione di calendario" in Webex è associato a "Occupato" in Outlook.
Avvertenza
Per utilizzare questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come funziona altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la sua presenza non verrà aggiornata fino al termine della riunione. A tale scopo, sarà necessario riavviare il client per rispondere.
Risposta automatica con tono
Con la risposta automatica con tono, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul desktop. Quando l'app Webex squilla sull'altra parte, l'utente sente un determinato segnale acustico che indica che la chiamata è in connessione.
Per utilizzare questa funzione per un utente Webex per Cisco BroadWorks:
-
La funzione è supportata solo sull'aspetto della linea principale
-
L'app Webex deve essere l'identificativo di linea principale
-
Il %ENABLE_AUTO_ANSWER_WXT% tag deve essere abilitato
Se l'utente dispone anche di indicatori di chiamata condivisa (ad esempio, un telefono da tavolo è configurato come uno degli indicatori di linea secondaria), la funzione è ancora supportata sull'aspetto principale, a condizione che gli indicatori di chiamata condivisa siano configurati per no n ricevere chiamate in arrivo. Per effettuare questa operazione, è possibile configurare una delle tre condizioni seguenti su BroadWorks per tutte le chiamate condivise:
-
Avvisa tutti gli aspetti delle chiamate con clic è disabilitato nella configurazione dell'aspetto chiamata condivisa: questo è l'approccio consigliato
o
-
Consenti terminazione a questa posizione deve essere disabilitato per tutte le chiamate condivise o
o
-
Posizioni disabilitate per tutti gli indicatori di chiamata condivisi
Aumento della capacità
Aziende agricole XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare quante risorse XSP|ADP aggiuntive sono necessarie per l'aumento proposto dei numeri di abbonati. Per uno dei server NPS dedicati o dedicati a Webex per Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
-
Fattoria dedicata in scala: Aggiungere uno o più server XSP|ADP all'azienda che ha bisogno di capacità extra. Installare e attivare la stessa serie di applicazioni e configurazioni dei nodi esistenti del sistema.
-
Aggiungi azienda agricola dedicata: Aggiungi una nuova fattoria XSP|ADP dedicata. Sarà necessario creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti sul nuovo registro, per esitare gli utenti a essere presenti nell'hub esistente.
-
Aggiungere azienda agricola specializzata: Se si verificano strozzature per un particolare servizio, è possibile creare un'azienda agricola ADP|XSP separata a tale scopo, tenendo conto dei requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster Control Hub e le voci DNS se si modifica l'URL del servizio con un nuovo registro.
In tutti i casi, il monitoraggio e la risorsa dell'ambiente BroadWorks è di responsabilità. Se si desidera coinvolgere l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare servizi professionali.
Gestione dei certificati del server HTTP
È necessario gestire questi certificati per le applicazioni Web autenticate mTLS su XSP|ADP:
-
Certificato di catena di fiducia del cloud Webex
-
Certificati delle interfacce del server HTTP di XSP|ADP
Catena di fiducia
È possibile scaricare la catena del certificato di attendibilità da Control Hub e installarlo sugli ADP|XSP durante la configurazione iniziale. Si prevede di aggiornare il certificato prima della scadenza e di notificare come e quando modificarlo.
Interfacce server HTTP
L'|ADP XSP deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Certificati ordine. Quando si protegge per la prima volta l'interfaccia, viene generato un certificato autofirmato. Questo certificato è valido per un anno a partire da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione Partner Hub che gli amministratori dei partner possono assegnare a organizzazioni di clienti specifiche per limitare le impostazioni dell'organizzazione che gli amministratori dei clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione cliente, tutti gli amministratori dei clienti di tale organizzazione, indipendentemente dai diritti di ruolo, non possono accedere a una serie di controlli limitati in Control Hub. Solo l'amministratore del partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner si intende un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita i diritti di ruolo specifici per gli amministratori dei clienti nell'organizzazione a cui viene applicata l'impostazione.
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità con limitazioni per partner. Dopo l'accesso, verrà visualizzato un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner notifica all'amministratore del cliente che la modalità con limitazioni è abilitata e che potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore del cliente in un'organizzazione in cui è abilitata la modalità Con limitazioni per partner, il livello di accesso a Control Hub viene determinato con la seguente formula:
(accesso a Control Hub) = (diritti ruolo organizzazione) - (limitazioni della modalità partner)
Gli amministratori dei clienti dovranno affrontare diverse limitazioni, indipendentemente dalla modalità con limitazioni per partner. Tali restrizioni comprendono:
- Impostazioni chiamata: Le impostazioni 'Opzioni app Priorità chiamata' nel menu Chiamata sono di sola lettura.
- Impostazione posizione: L'impostazione della chiamata dopo la creazione della posizione verrà nascosta.
- Gestione PSTN e registrazione chiamate: Queste opzioni verranno disattivate per la posizione.
- Gestione dei numeri di telefono: Nel menu Chiamata, la gestione del numero di telefono è disabilitata e le impostazioni 'Opzioni app priorità chiamata', così come le registrazioni delle chiamate, sono di sola lettura.
Limitazioni
Quando la modalità Con limitazioni per partner è abilitata per un'organizzazione cliente, agli amministratori dei clienti di tale organizzazione viene impedito di accedere alle seguenti impostazioni di Control Hub:
-
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
-
Il pulsante Gestisci utenti è disattivato.
-
Aggiungi o modifica manualmente utenti: nessuna opzione per aggiungere o modificare utenti, manualmente o tramite CSV.
-
Richiedi utenti—non disponibile
-
Assegnazione automatica licenze—non disponibile
-
Sincronizzazione rubriche: impossibile modificare le impostazioni di sincronizzazione rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
-
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato ed e-mail principale* sono modificabili.
-
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
-
Modifica servizi: nessuna opzione di modifica dei servizi abilitati per un utente (ad esempio, Messaggi, Riunioni, Chiamata)
-
Visualizza stato servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
-
Numero di lavoro principale: questo campo è di sola lettura.
-
-
Nella vista Account, non sono disponibili le seguenti impostazioni:
-
Ragione sociale è di sola lettura.
-
-
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
-
Dominio: l'accesso è di sola lettura.
-
E-mail: le impostazioni di Elimina invito amministratore e Selezione impostazioni internazionali e-mail sono di sola lettura.
-
Autenticazione: nessuna opzione per modificare le impostazioni di autenticazione e SSO.
-
-
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
-
Impostazioni chiamata: le impostazioni di priorità di chiamata delle opzioni dell'app sono di sola lettura.
-
Funzionamento chiamata: le impostazioni sono di sola lettura.
-
Posizione > PSTN: le opzioni gateway locale e PSTN Cisco sono nascoste.
-
-
In SERVICES, le opzioni del servizio Migrations e Connected UC vengono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori dei partner possono utilizzare la procedura seguente per abilitare Con limitazioni della modalità partne r per una determinata organizzazione cliente (l'impostazione predefinita è abilitata).
-
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
-
Selezionare l'organizzazione del cliente applicabile.
-
Nella vista delle impostazioni a destra, abilitare l'interruttore Limitato dalla modalità partner per attivare l'impostazione.
Se si desidera disattivare Limitazione della modalità partner, disabilitare l'interruttore.
Se il partner rimuove la modalità amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà eseguire quanto segue:
-
Aggiungi Webex per utenti all'ingrosso (con il pulsante)
-
Modifica pacchetti per un utente
Per ulteriori informazioni sull'elenco dei fusi orari supportati per il provisioning all'ingrosso, vedere l' elenco dei fusi orari supportati per il provisioning all'ingrosso.
Analisi dei partner
I miglioramenti apportati a Control Hub rendono semplice agli amministratori dei partner visualizzare e aggiornare le informazioni del pacchetto per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata tra tutti i clienti e include i seguenti dettagli:
-
Totale utenti per pacchetto (Softphone, Basic, Standard, Premium)
-
Tendenza utenti per pacchetto (giornaliera/settimanale/mensile)
-
Clienti con n. di pacchetti assegnati
Per dettagli completi sull'uso della funzionalità di analisi dei partner, vedere l'articolo Webex Analytics per Webex per i pacchetti Eseeme e Webex per pacchetti Broadworks in Partner Hub.
API di report fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare report di fatturazione. Nella tabella seguente vengono elencate le API, il tipo di accesso richiesto e i requisiti di ruolo.
API di fatturazione |
Scopo |
Tipo di accesso |
Requisiti di ruolo per API (L'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Creazione di un report di fatturazione BroadWorks |
Utilizzato per generare un report di fatturazione. |
Accesso in scrittura |
|
Elenca report di fatturazione BroadWorks |
Consente di elencare i report disponibili per la visualizzazione. |
Accesso in lettura |
|
Ottenere un report di fatturazione BroadWorks |
Utilizzato per ottenere una copia di un report generato. |
Accesso in lettura |
|
Eliminazione di un report di fatturazione BroadWorks |
Utilizzato per eliminare un report generato. |
Accesso scrittura |
|
Campi di fatturazione
Nella tabella seguente sono elencati i campi contenuti nel report generato.
Campo |
Descrizione |
---|---|
nome rivenditore |
Nome partner o ID organizzazione partner |
ID fatturazione |
Identificativo di fatturazione univoco del partner o numero C |
IdImpresaSp |
L'identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno |
Stato versione di prova interna del cliente (Sì/No) |
ID utente |
IDutente dell'abbonato su BroadWorks |
id abbonato |
Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato |
Sì/No |
Data iniziale |
Data di provisioning dell'abbonato. |
dataInizioFatturazione |
Data di inizio fatturazione in questo mese |
DataFineFatturazione |
Data di fine fatturazione in questo mese |
pacchetto |
Il tipo di confezione che viene caricata |
quantità |
Quantità ripartita per fatturazione.
|
-
Una volta generato un report di fatturazione per un periodo specifico, non è possibile rigenerare tale report a meno che non si elimini prima il report esistente.
-
Se si modifica il tipo di pacchetto o l'ID utente BroadWorks per un determinato utente, il report del mese in cui si è verificata la modifica mostra più voci per tale utente con voci ripartite proporzionalmente separate prima e dopo la modifica.
Risoluzione dei problemi di Webex per Cisco BroadWorks
Iscrizione alla pagina di stato Webex
Innanzitutto, https://status.webex.com verificare se si verifica un'interruzione imprevista del servizio. Se non è stata modificata la configurazione in Control Hub o BroadWorks prima dell'interruzione, controllare la pagina di stato. Per ulteriori informazioni sulla sottoscrizione per lo stato e le notifiche di incidenti, vedere il Centro di assistenza Webex.
Uso della funzionalità di analisi di Control Hub
Webex tiene traccia dei dati di utilizzo e qualità per la propria organizzazione e per le organizzazioni dei clienti. Ulteriori informazioni sulla funzionalità di analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
I clienti o gli utenti non vengono creati in Control Hub con provisioning flow provisioning:
-
Il server dell'applicazione può raggiungere l'URL di provisioning?
-
L'account di provisioning e la password sono corretti, se esistono in BroadWorks?
I cluster non riescono regolarmente con i test di connettività:
La connessione mTLS al servizio di autenticazione dovrebbe non riuscire quando si crea il primo cluster in Partner Hub poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. In caso contrario, non è possibile creare un'ancora attendibile sul servizio di autenticazione XSP|ADPs, pertanto la connessione mTLS di prova da Partner Hub non viene eseguita correttamente.
-
Le interfacce XSP|ADP sono accessibili pubblicamente?
-
Si stanno utilizzando le porte corrette? È possibile inserire una porta nella definizione dell'interfaccia sul cluster.
Convalida interfacce non riuscita
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso
/v2.0
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Esaminare l'avviso di configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano immessi correttamente nel cluster in Partner Hub, incluso
/v2.0
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Rivedere i consigli di configurazione dell'interfaccia in questo documento, con particolare attenzione su:
- Accertarsi di aver condiviso le chiavi RSA tra tutti gli XSP|ADP.
- Accertarsi di aver fornito l'URL AuthService al contenitore Web su tutti gli XSP|ADP.
- Se è stata modificata la configurazione di crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'|ADP XSP richiede di immettere il formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento indicava in modo errato le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
-
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati sul proprio archivio attendibile XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere certificati client?
-
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere certificati client?
Problemi del client
Verificare che il client sia connesso a BroadWorks
-
Accedere all'app Webex.
-
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.
-
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici. Viene visualizzato lo stato della SSO è stato eseguito l'accesso.
Se viene visualizzato un altro servizio telefonico, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Ciò significa:
-
Il client ha transverso correttamente i microservizi Webex richiesti.
-
L'utente è stato autenticato correttamente.
-
Il client è stato emesso un token Web JSON a lungo termine dal sistema BroadWorks.
-
Il client ha recuperato il profilo del dispositivo ed è registrato per BroadWorks.
Registri client
Tutti i client app Webex possono inviare log a Webex. Questa è l'opzione migliore per client mobili. È necessario registrare anche l'indirizzo e-mail dell'utente e l'ora approssimativa del problema, se si desidera assistenza dal Tac. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se occorre raccogliere manualmente i registri da un PC Windows, si trovano nel seguente modo:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac: /Utenti/{username}/Libreria/Registri/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS non configurata correttamente
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
-
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
-
Verificare che la catena di certificati Webex sia installata come trust anchor.
-
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e che sia firmato da un'autorità di certificazione attendibile.
Messaggio interruzione licenza
Questo messaggio può essere visualizzato per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'uso della licenza supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Criteri di supporto stato originale
Il provider di servizi è il primo punto di contatto per il supporto clienti finale (enterprise). Inoltrare i problemi che il SP non può risolvere al TAC. Il supporto della versione server BroadWorks segue i criteri della Versione corrente e delle due precedenti versioni principali (N-2). Per ulteriori informazioni, consultare la sezione Politica sul ciclo di vita dei prodotti BroadSoft nella sezione Politica sul ciclo di vita BroadSoft e Matrice di compatibilità software BroadWorks.
Criteri di escalation
-
L'utente (provider di servizi/partner) è il primo punto di contatto per il supporto dei clienti finali (enterprise).
-
I problemi che non possono essere risolti dal SP vengono inoltrati al TAC.
Versioni BroadWorks
-
Il supporto della versione server BroadWorks segue i criteri di BroadSoft, della versione corrente e delle due versioni principali precedenti (N-2). Per ulteriori informazioni, consultare la sezione Politica sul ciclo di vita dei prodotti BroadSoft nella sezione Politica sul ciclo di vita BroadSoft e Matrice di compatibilità software BroadWorks.
Risorse di self-support
-
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, in cui è disponibile una pagina specifica di Webex per Cisco BroadWorks che elenca la Guida per l'app Webex comune e gli argomenti di supporto.
-
È possibile personalizzare l'app Webex con questo URL della Guida e un URL per la segnalazione di problemi.
-
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I log vengono nel cloud Webex, dove possono essere analizzati da Webex DevOps.
-
È disponibile anche una pagina del Centro assistenza dedicata alla guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccolta delle informazioni per l'invio di una richiesta di assistenza
Quando si visualizzano errori in Control Hub, è possibile che siano state allegati informazioni che consentono al Tac di ricercare la causa del problema. Ad esempio, se viene visualizzato un ID di verifica per un determinato errore o un codice di errore, salvare il testo da condividere con noi.
Provare a includere almeno le seguenti informazioni quando si invia una query o si apre un caso:
-
ID organizzazione cliente e ID organizzazione partner (ciascun ID è una stringa di 32 cifre esadecimali, separate da trattini)
-
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce una
-
Indirizzo e-mail utente (se si verificano problemi con un determinato utente)
-
Versioni del client (se il problema presenta sintomi notati attraverso il client)
Webex per riferimento a BroadWorks
Confronto DI UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > |
UC-One SaaS |
Webex per Cisco BroadWorks |
---|---|---|
Cloud |
Cisco UC-One Cloud (GCP) |
Cloud Webex (APPLICAZIONI WEBEX) |
Client |
UC-One: Mobile, Desktop Receptionist, Supervisore |
Webex: Mobile, Desktop, Web |
Principale differenza tecnologia |
Riunioni consegnate su Broadsoft Meet Technology |
Riunioni consegnate su Webex Meetings Technology |
Versioni di prova sul campo iniziali |
Ambiente di gestione temporanea, client Beta |
Ambiente di produzione, client GA |
Identità utente |
BroadWorks ID utilizzato come ID principale, a meno che provider di servizi sito non SSO già.
ID utente e segreto in BroadWorks |
ID e-mail in Cisco CI serve come ID principale SSO integrazioni in provider di servizi BroadWorks in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks in quel momento.
L'utente fornisce le credenziali tramite SSO broadworks e secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e autenticazione nel provider di identità |
Autenticazione client |
Gli utenti forniscono le credenziali tramite il client Token a lungo accesso BroadWorks richiesti se si utilizza la messaggistica Webex |
Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso e aggiornamento dei token Webex |
Gestione/configurazione |
I sistemi ANDR E BSS e Portale rivenditore |
SISTEMI CUI/BSS e Control Hub |
Attivazione partner/provider di servizi partner |
Una sola impostazione per Cisco Operations |
Una sola impostazione per Cisco Operations |
Attivazione cliente/aziendale |
Portale rivenditore |
Control Hub Creazione automatica alla prima iscrizione utente |
Opzioni di attivazione utente |
Auto iscrizione Impostazione di IM&P esterno in BroadWorks
|
Impostazione di Integrated IM&P in BroadWorks (solitamente aziende) |
Interfacce servizio XSPADP| |
Azioni XSI
Eventi XSI CTI (mTLS) AuthService (mTLS opzionale) DMS |
Azioni XSI Azioni XSI (mTLS) Eventi XSI CTI (mTLS) AuthService (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 |
Scaricare e installare Webex. Per dettagli, vedere Webex | Download dell'app. |
2 |
Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 |
Inserire il proprio indirizzo e-mail e fare clic su Next(Avanti). |
4 |
In base alla configurazione dell'organizzazione in Webex, si verificano le seguenti operazioni: Webex viene caricato dopo aver eseguito correttamente l'autenticazione per IdP o BroadWorks.
|
Scambio dati e storage
Queste sezioni forniscono dettagli sullo scambio di dati e sullo storage con Webex. Tutti i dati sono crittografati sia in viaggio che a riposo. Per ulteriori dettagli, vedere Sicurezza app Webex.
provider di servizi ilboarding
Quando si configurano cluster e modelli utente in Webex Control Hub durante provider di servizi onboarding, si scambiano i seguenti dati BroadWorks memorizzati da Webex:
-
URL azioni Xsi
-
Xsi-Events URL
-
URL interfaccia CTI
-
URL servizio di autenticazione
-
Credenziali dell'adattatore provisioning BroadWorks
provider di servizi provisioning utente
Questa tabella elenca i dati utente ed aziendale s scambiati come parte del provisioning degli utenti attraverso le API Webex.
Trasferimento dati a Webex |
Da |
Attraverso |
Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito da SP) |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito dall'utente) |
Utente |
Portale di attivazione utente |
Sì |
Nome |
BroadWorks, per API |
API Webex |
Sì |
Cognome |
BroadWorks, per API |
API Webex |
Sì |
Numero di telefono principale |
BroadWorks, per API |
API Webex |
Sì |
Numero telefono cellulare |
BroadWorks, per API |
API Webex |
Sì |
Estensione principale |
BroadWorks, per API |
API Webex |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
BroadWorks, per API |
API Webex |
Sì |
Lingua |
BroadWorks, per API |
API Webex |
Sì |
Fuso orario |
BroadWorks, per API |
API Webex |
Sì |
Rimozione utente
Webex per api Cisco BroadWorks supporta la rimozione parziale e completa degli utenti. Questa tabella elenca tutti i dati utente archiviati durante il provisioning e ciò che viene eliminato in ciascuno scenario.
Dati utente |
Eliminazione parziale |
Eliminazione completa |
---|---|---|
ID utente BroadWorks |
Sì |
Sì |
|
No |
Sì |
Nome |
No |
Sì |
Cognome |
No |
Sì |
Numero di telefono principale |
Sì |
Sì |
Numero telefono cellulare |
Sì |
Sì |
Estensione |
Sì |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
Sì |
Sì |
LANGUAGE |
No |
Sì |
Recupero accesso utente e configurazione
Autenticazione Webex
L'autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da uno qualsiasi dei meccanismi di autenticazione del supporto Webex. ( l'autenticazione BroadWorks è trattata separatamente) Questa tabella illustra il tipo di dati scambiati tra i diversi componenti sul flusso di autenticazione.
Spostamento dei dati |
Da |
A |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (indipendente) |
Webex |
Browser utente |
Credenziali utente |
Browser utente |
Provider di identità (che dispone già di identità utente) |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Autenticazione BroadWorks
L'autenticazione BroadWorks si riferisce all'accesso dell'utente a un'app Webex utilizzando le credenziali BroadWorks. Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti del flusso di autenticazione.
Spostamento dei dati |
Da |
A |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (proxy IdP Webex Bwks) |
Webex |
Browser utente |
Informazioni sul branding e URL BroadWorks |
Webex |
Browser utente |
Credenziali utente BroadWorks |
Utente attraverso il browser (pagina di accesso con branded servita da Webex) |
Webex |
Credenziali utente BroadWorks |
Webex |
BroadWorks |
File BroadWorks profilo utente |
BroadWorks |
Webex |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento dell'avviso di accesso e del messaggio di errore:
- Attualmente gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso poiché la password è già scaduta. Con questa funzione, se la password sta per scadere tra 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere, con l'indicazione di quanti giorni rimangono, e all'utente viene consigliato di contattare il partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su true, è stato emesso l'errore "nome utente e password errati", ma ora con questa funzione viene migliorato il messaggio di errore: Tentativo di accesso non riuscito. La combinazione di ID utente e password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice errore 100006
Controllo flusso di accesso:
- Il partner può limitare l'accesso abilitando un'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione in BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, quindi viene visualizzato un errore che indica che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso può essere configurato dal partner come parte della funzione di personalizzazione avanzata. I partner solitamente configurano il collegamento per passare dall'utente a un portale partner per la gestione della password e la reimpostazione della password.
Questa funzione migliora l'esperienza di accesso utente solo durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se una password scade mentre l'utente è connesso all'app Webex. L'utente riceve la notifica di scadenza della password al successivo tentativo di accesso.
Recupero configurazione client
Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti nel recupero delle configurazioni del client.
Spostamento dei dati |
Da |
A |
---|---|---|
Iscrizione |
Client |
Webex |
Impostazioni dell'organizzazione, inclusi gli URL BroadWorks |
Webex |
Client |
Token BroadWorks JWORKS |
BroadWorks attraverso Webex |
Client |
Token BroadWorks JWORKS |
Client |
BroadWorks |
Token dispositivo |
BroadWorks |
Client |
Token dispositivo |
Client |
BroadWorks |
File di configurazione |
BroadWorks |
Client |
Utilizzo stato originale
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione in seguito alla scadenza del token attraverso BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Spostamento dei dati |
Da |
A |
---|---|---|
Segnalazione SIP |
Client |
BroadWorks |
Contenuto multimediale SRTP |
Client |
BroadWorks |
Segnalazione SIP |
BroadWorks |
Client |
Contenuto multimediale SRTP |
BroadWorks |
Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Spostamento dei dati |
Da |
A |
---|---|---|
Messaggistica e presenza HTTPS REST |
Client |
Webex |
Messaggistica e presenza HTTPS REST |
Webex |
Client |
Segnalazione SIP |
Client |
Webex |
Contenuto multimediale SRTP |
Client |
Webex |
Segnalazione SIP |
Webex |
Client |
Contenuto multimediale SRTP |
Webex |
Client |
Uso dell'API di provisioning
Accesso sviluppatore
La specifica API è disponibile su https://developer.webex.com e una guida all'uso è su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l'accesso per leggere la specifica API su https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Autenticazione e autorizzazione dell'applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (come il provisioning del sottoscrittore) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere i token di aggiornamento e di accesso per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
È necessario prima registrare l'integrazione con Webex. Una volta registrata, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di aggiornamento e accesso necessari.
Per ulteriori informazioni sulle integrazioni e su come creare questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli richiesti per l'implementazione delle integrazioni, lo sviluppatore e l'utente che ha autorizzato, e possono essere tenute da persone/team separati nel proprio ambiente.
-
Lo sviluppatore crea l'app e la registra su per generare il ClientID/Secret OAuth richiesto con gli ambito previsti per https://developer.webex.com l'applicazione. Se l'applicazione è stata creata da terze parti, potrebbe registrare l'applicazione (se è stato richiesto l'accesso) o è possibile farlo con il proprio accesso.
-
L'utente autorizzato è l'account che l'applicazione utilizza per autorizzare le chiamate API, per modificare l'organizzazione partner, le organizzazioni dei clienti o i relativi abbonati. Questo account deve avere il ruolo di amministratore completo o amministratore completo di vendite nell'organizzazione partner. Questo account non deve essere mantenuto da terze parti.
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning utilizzata:
-
Modalità Enterprise: il nome dell'organizzazione corrisponde esattamente a spEnterpriseId.
-
Modalità provider di servizi: il nome dell'organizzazione è la parte groupID di spEnterpriseId.
Il nome dell'organizzazione conterrà qualsiasi spazio vuoto, maiuscolo e caratteri speciali specificati in spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "attuale" con le ultime patch BroadWorks e le app Release Independent (RI). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Accertarsi di esaminare le note di patch per queste patch software. Alcune patch potrebbero richiedere ulteriori requisiti CLI.
Versione R22
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione | ||
Richiesto per sincronizzazione rubrica | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per il server applicazioni | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Patch richiesta per la funzione di registrazione chiamata | ||
Patch richiesta per il provisioning flow-through | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Server dei profili | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
XSP|ADP |
Richiesto per proxy autenticazione NPS | |
Richiesto per il servizio di autenticazione con convalida token CI | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per il servizio di autenticazione con convalida token CI | ||
Obbligatorio per la cronologia chiamate unificata | ||
Altro |
AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione |
Richiesto per sincronizzazione rubrica | |
Configurazione server app | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Server dei profili | ||
Piattaforma | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
XSP|ADP | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per aggiornare da V1 a V2 Notifiche push | ||
Richiesto per proxy autenticazione NPS | ||
Richiesto per proxy autenticazione NPS | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Altro |
Se si utilizza ADP... Xsi-Events-232021.0_51.251.bwar_ |
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate |
Versione R24
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione |
Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per il provisioning flowthrough | ||
Richiesto per la registrazione chiamata | ||
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate | ||
Altro |
Xsi-Events-242021.0_51.251.bwar_ |
Patch richiesta per stato gancio (presenza) e cronologia chiamate unificate |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che è necessario configurare per Webex, fare riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utenti e flussi di attivazione
Provisioning descrive l'aggiunta dell'utente a Webex. L'attivazione include la convalida e-mail e l'assegnazione del servizio in Webex.
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se si dispone di indirizzi e-mail attendibili per gli utenti, è possibile scegliere di attivarli automaticamente quando vengono predisposti automaticamente. Questo processo è di "provisioning automatico e attivazione automatica".
Provisioning utenti automatizzato e attivazione automatica (flusso e-mail attendibile)
Prerequisiti
-
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
-
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
-
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase |
Descrizione |
---|---|
1 |
Si preventiva ed si eserviranno gli ordini per il servizio con i clienti. |
2 |
L'ordine del cliente viene processato ed è stato predisposto il cliente nel sistema. |
3 |
Il sistema di provisioning del servizio attiva il provisioning di BroadWorks. Questa operazione, in riepilogo, crea l'azienda e gli utenti. Quindi, assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM esterno. |
4 |
Questa operazione di provisioning attiva il provisioning automatico dell'organizzazione e degli utenti del cliente in Webex. (L'assegnazione del servizio IM&P causa la chiamata dell'adattatore di provisioning all'API di provisioning Webex). |
5 |
I sistemi devono utilizzare l'API di provisioning Webex se in seguito occorre regolare il pacchetto per l'utente (per effettuare una modifica rispetto al valore predefinito). |
SSO di accesso
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, consentendo l'autenticazione diretta a BroadWorks. L'immagine visualizza gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresentano ciò che il client fornisce per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizi BroadWorks che segue immediatamente dal flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione diretta BroadWorks abilitata (condivisione risorse multi-origine). Di seguito sono riportati alcuni flussi di SSO SAML alternativi:
-
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
-
L'unica differenza è nel punto 5 e 6 del flusso di accesso Webex. Nel punto 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
-
Il flusso procede attraverso le operazioni restanti nei due diagrammi.
-
Il SSO di registrazione non è utilizzato in questo flusso.
-
-
Autenticazione Webex SSO SAML:
-
Al punto 3 del flusso di accesso Webex, il servizio Common Identity servizi restituisce il provider di identità utilizzato dall'autenticazione Webex.
-
A questo punto, viene richiamato un flusso di SSO SAML alternativo per Webex.
-
Interazioni utente
Accedi
-
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
-
CI rileva che l'organizzazione cliente associata ha il proxy IDP BroadWorks configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso. (Il provider di servizi può contrassegnare questa pagina di accesso).
-
L'utente inserisce le proprie credenziali BroadWorks.
-
Broadworks autentica l'utente attraverso l'IDP. In caso positivo, IDP reindirizza il browser a CI con un SISTEMA SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
-
In caso di autenticazione eseguita correttamente, l'app Webex ottiene i token di accesso da CI (non mostrato nel diagramma). Il client le utilizza per richiedere un token JNTASSI (Jason Web Token) BroadWorks.
-
L'app Webex rileva la configurazione di chiamata da BroadWorks e da altri servizi di Webex.
-
L'app Webex si registra con BroadWorks.
Accesso dal punto di vista dell'utente
Questo diagramma è il flusso di accesso tipico, visualizzato dall'utente finale o dall'abbonato:
-
L'app Webex viene scaricata e installata.
-
È possibile che sia stato ricevuto il collegamento dal proprio provider di servizi oppure il download potrebbe essere trovato sulla pagina di download di Webex.
-
L'indirizzo e-mail viene inserito nella schermata di accesso di Webex. Fare clic su Avanti.
-
Solitamente, si viene reindirizzati a una provider di servizi a cui viene visualizzata una pagina con marchio.
-
Questa pagina potrebbe dare il benvenuto mediante il proprio indirizzo e-mail.
Se non si dispone di un indirizzo e-mail o se l'indirizzo e-mail è errato, inserire l'indirizzo nome utente BroadWorks.
-
Inserire la password BroadWorks.
-
Se è stato eseguito correttamente l'accesso, Webex si apre.
flusso chiamata: rubrica aziendale
flusso chiamata—PSTN cliente
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni client
Recupera profilo da REGISTRAZIONE DMS e SIP con AS
-
Il client chiama XSI per ottenere un token di gestione dispositivi e l'URL sul DMS.
-
Il client richiede il profilo del dispositivo dal DMS presentando il token dal punto 1.
-
Il client legge il profilo del dispositivo e recupera le credenziali SIP, gli indirizzi e le porte.
-
Il client invia un SIP REGISTER al controller SBC utilizzando le informazioni del punto 3.
-
SBC invia il SIP REGISTER ad AS (il controller SBC può eseguire una ricerca in NS per individuare un AS se SBC non conosce già l'utente SIP).
Linee guida di test e laboratorio
Le seguenti linee guida si applicano a organizzazioni di test e laboratorio:
-
provider di servizi partner sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
-
La fatturazione verrà addebitata a qualsiasi utente oltre i primi 50 utenti di prova.
-
Per assicurare un'elaborazione precisa della fattura, tutte le organizzazioni di test devono includere 'test' nel nome dell'organizzazione BroadWorks.
-
Le organizzazioni di test interne devono essere designate all'interno Webex Control Hub. Al fine di evitare che gli utenti di prova vengano fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di test:
-
Accedere all'hub partner e selezionare Clienti.
-
Selezionare il cliente appropriato.
-
Nella barra di controllo a destra, abilitare l'interruttore Organizzazione test interna.
Riproduzione segreteria telefonica
Per la segreteria telefonica, accertarsi di configurare il server multimediale per l'uso di uno dei seguenti codici:
-
mp3
-
wav— I file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android)
Se si utilizzano file wav, eseguire i seguenti comandi CLI per verificare il server dell'applicazione e server multimediale:
-
AS_CLI/Service/VoiceMsg>set vmRecordingAudioFileFormat WAV
-
MS_CLI/Applications/MediaStreaming/Services/IVR> impostare sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACL
- Elenco di controllo accessi
- ALG
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APNS
- Utenti Apple servizio di notifica push
- AS
- Server applicazione
- ATA
- Adattatore telefono analogico, adattatore per la conversione della telefonia analogica VoIP
- BAM
- Gestione applicazioni BroadSoft
- Autenticazione di base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- BMS
- Server di messaggistica BroadSoft
- BOSH
- Flussi bidirezionale su HTTP sincrono
- BRI
- L'interfaccia BRI (Basic Rate Interface) è un metodo di accesso ISDN
- Bundle
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico di telefonia (cf. partner, provider di servizi, rivenditore aggiunto valore)
- CAPTCHA
- Test del turing pubblico completamente automatizzato per incisire sui computer e sull'humans apart
- CODICE CCXML
- Controllo chiamata EXtensible Markup Language
- CIF
- Formato intermedio comune
- CLI
- Interfaccia della riga di comando
- CN
- Nome comune
- CSP
- Server push notifiche chiamate. Un server push notifiche che viene eseguito su un ADP XSP| nel proprio ambiente per eseguire notifiche di chiamata push su FCM e APNS. Vedere Proxy NPS.
- CPE
- Apparecchiatura locale del cliente
- CPR
- Regola di presenza personalizzata
- CSS
- Foglio di stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione di telefonia su computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- Non disturbare
- Non disturbare
- DNS
- Sistema di nomi di dominio
- DPG
- Chiama gruppo peer
- DSCP
- Punto codici servizi differenziati
- DTAF
- File di archivio del tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza dual-tone
- Utente finale
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. per l'abbonato)
- Aziendale
- Un gruppo di utenti finali (cf. organizzazione)
- FCM
- Messaggistica cloud Firebase
- FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creazione di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning flow-through completo
- Creazione e verifica di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks e l'asserzione che ciascun utente BroadWorks ha un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. Il plug-on del telefono o del fax o i plug-in sul sistema telefonico analogico. Fornisce un'indicazione di hook/off-hook (chiusura loop). Poiché la porta BLUETOOTH è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo BLUETOOTH".
- FXS
- Foreign Exchange Subscriber è la porta che consegna effettivamente la linea analogica al sottoscrittore. In altre parole, è il plug-in alla parete che offre un segnale di chiamata, una corrente a batteria e una suoneria.
- GCM
- Messaggio Google Cloud
- GCM
- Modalità Galois/Counter Mode (tecnologia di crittografia)
- NASCOSTO
- Dispositivo interfaccia utente
- HTTPS
- Protocollo di trasferimento ipertestuale socket sicuri
- IAD
- Dispositivo di accesso integrato
- IM&P
- Messaggistica immediata e presenza
- IP PSTN
- Un provider di servizi che fornisce VoIP servizi PSTN, intercambiabili con ITSP, o un termine generale per la telefonia 'pubblica' collegata da Internet, collettivamente fornito dai principali fornitori di telecomunicazioni (anziché tramite paesi, come PSTN è)
- ITSP
- Servizi di telefonia Internet provider di servizi
- IVR
- Risposta vocale interattiva/Risponditore
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificatore Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notifica oggetto Java Script
- JSSE
- Estensione socket sicura Java; la tecnologia sottostante che fornisce funzioni di connettività sicura ai server BroadWorks
- KEM
- Modulo di estensione chiave (telefoni Cisco hardware)
- LLT
- Token lungo(o long life); una forma di auto-descrizione, sicura di token di connessione che consente agli utenti di rimanere autenticati per più tempo e non è legata a applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIB
- Base informazioni di gestione
- MS
- Server multimediale
- Mtls
- Autenticazione reciproca tra due parti, mediante lo scambio di certificati, quando si stabilisce una connessione TLS
- MUC
- Chat multi-utente
- NAZ
- Traduzioni indirizzi di rete
- NPS
- Server push di notifica; vedere CNPS
- NPS Proxy
-
Servizio in Webex che fornisce token di autorizzazione breve al CNPS, abilitando il push delle notifiche di chiamata su FCM e APNs e, infine, sui dispositivi Android e iOS che eseguono Webex.
- OCI
- Apri interfaccia client
- Organizzazione
- Una società o un'organizzazione che rappresenta un gruppo di utenti finali (cf. Enterprise)
- OTG
- Gruppo trunk in uscita
- Pacchetto
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. Bundle)
- Partner
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. Valore aggiunto rivenditore, provider di servizi, vettore)
- PBX
- Exchange su succursale privato
- PEM
- Messaggio e-mail avanzato sulla privacy
- PLMN
- Rete mobile su rete pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia di telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- PS
- Server dei profili
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Un sito Web che consente all'amministratore del rivenditore di configurare la propria soluzione UC-One SaaS. Talvolta è noto come portale BANG, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Controllo bordo sessione
- SCA
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; Un'organizzazione che fornisce servizi telefonici o correlati ad altre organizzazioni (cf. Gestore telefonico, partner, rivenditore aggiunto valore)
- SIP
- SIP (Session Initiation Protocol)
- SLT
- Token breve (o breve durata) (denominato anche token SSO BroadWorks); un token autenticato a uso singolo utilizzato per ottenere l'accesso protetto alle applicazioni Web.
- SMB
- Piccola e media azienda
- SNMP
- Semplice protocollo di gestione della rete
- sRTCP
- protocollo Secure Realtime Transfer Control Protocol (VoIP multimediale per chiamate in tempo reale)
- sRTP
- protocollo Secure Realtime Transfer Protocol (VoIP multimediale di chiamata)
- SSL
- Livello socket sicuri
- Abbonato
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. Utente finale)
- TCP
- Protocollo di controllo trasmissione
- TDM
- Multiplexing divisione temporale
- TLS
- Sicurezza livello di trasporto
- Tos
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Unified Communications
- UI
- Interfaccia utente
- UID
- Identificativo univoco
- UMS
- Server di messaggistica
- URI
- Uniform Resource Identifier
- URL
- Localizzatore risorse uniforme
- USS
- Server di condivisione
- UTC
- Coordinated Universal Time
- UV
- Video Server
- Rivenditore aggiunto valore (VAR)
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. vettore, partner, provider di servizi)
- VGA
- Array di elementi grafici video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Voice Extensible Markup Language
- Webdav
- Creazione e versione per Web distributed authoring
- WebRTC
- Comunicazioni in tempo reale Web
- WRS
- WebRTC Server
- XMPP
- Protocollo di messaggistica e presenza Estendi
Panoramica di Webex per Cisco BroadWorks
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione fornisce agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei clienti o forniscono questa soluzione direttamente ai relativi abbonati.
Scopo soluzione
-
Per fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che dispongono già del servizio di chiamata fornito dai provider di servizi BroadWorks.
-
Per fornire il servizio di chiamata basato a BroadWorks a clienti Webex piccoli e medi.
Contesto
In continua continua evoluzione di tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo impegno è spostare le funzionalità di chiamata BroadWorks nell'app Webex e ridurre l'investimento nei client UC-One.
Benefici
-
Prova futura: di fronte all'end-of-life di UC-One Collaborate, movimento di tutti i clienti verso il Unified Client Framework (UCF)
-
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex e conservazione delle chiamate BroadWorks sulla rete di telefonia
Ambito soluzione
-
I clienti esistenti/nuovi e medi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre della chiamata BroadWorks.
-
I clienti Webex esistenti, da piccoli a medi, desiderano aggiungere la chiamata BroadWorks.
-
Non aziende più grandi (ti prego di esaminare il nostro portfolio Enterprise per Webex).
-
Non i singoli utenti (valutare le offerte Webex online).
Le serie di funzioni in Webex per Cisco BroadWorks hanno come obiettivo casi d'uso di piccola e media attività. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità dei sistemi SME e ne valutiamo costantemente l'idoneità per questo segmento. È possibile scegliere di nascondere o rimuovere funzioni altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# |
Requisito |
Note |
---|---|---|
1 |
Patch BroadWorks corrente R22 o superiore | |
2 |
ADP XSP| per XSI, CTI, DMS e authService |
ADP XSP|dedicato per Webex per Cisco BroadWorks |
3 |
ADP XSP|separato per NPS può essere condiviso con altre soluzioni che utilizzano NPS. |
Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni ADP e NPS XSP|. |
4 |
Convalida token CI (con TLS) configurato per connessioni Webex al servizio di autenticazione. | |
5 |
mTLS configurato per le connessioni Webex all'interfaccia CTI. |
Altre applicazioni non richiedono mTLS. |
6 |
Gli utenti devono esistere in BroadWorks e necessitano dei seguenti attributi, in base alla propria decisione di provisioning:
|
Per e-mail affidabili: Si consiglia di inserire lo stesso indirizzo e-mail nell'attributo ID alternativo anche per consentire agli utenti di accedere con indirizzo e-mail per BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'utilizzo di messaggi e-mail non attendibili può inviare il messaggio e-mail alla cartella della posta indesiderata o dello SPAM dell'utente. L'amministratore potrebbe aver modificato le impostazioni e-mail dell'utente per consentire i domini |
7 |
File DTAF Webex per Cisco BroadWorks per l'app Webex | |
8 |
BW Business Lic o Std Enterprise o Prem Enterprise User Lic + Webex per l'abbonamento Cisco BroadWorks |
Se è già presente una distribuzione di collaborazione esistente, non è più necessario il bundle aggiuntivo UC-One, la collaborazione Lic e le porte della conferenza Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non è necessario apportare ulteriori modifiche se non si accettano i termini del pacchetto Premium. |
9 |
L'indirizzo IP/porte deve essere accessibile attraverso i servizi back-end Webex e le app Webex su Internet pubblico. |
Vedere la sezione "Preparazione della rete". |
10 |
Configurazione TLS v1.2 su ADP XSP| | |
11 |
Per il provisioning Flowworks, il server dell'applicazione deve connettersi all'adattatore di provisioning BroadWorks. La configurazione del proxy in uscita non viene testata o supportato. Se si utilizza un proxy in uscita, si accetta la responsabilità di supportarlo con Webex per Cisco BroadWorks. |
Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è comprendere, preparare, distribuire e gestire la soluzione Webex per Cisco BroadWorks. Le sezioni principali del documento riflettono questo scopo.
Questa guida include informazioni concettuali e materiale di riferimento. Intendiamo coprire tutti gli aspetti della soluzione in questo documento.
La serie minima di attività per la distribuzione della soluzione è la seguente:
-
Raggiungere il team dell'account per diventare un partner Cisco. È obbligatorio esplorare i punti di contatto Cisco per acquisire familiarità (ed essere addestrati). Quando si diventa un partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuire Webex per Cisco BroadWorks > onboarding dei partner in questo documento).
-
Configurare i sistemi BroadWorks per l'integrazione con Webex. (Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento).
-
Utilizzare Partner Hub per collegare Webex a BroadWorks. Vedere Distribuire Webex per Cisco BroadWorks > l'organizzazione partner in Partner Hub in questo documento.
-
Utilizzare Partner Hub per preparare i modelli di provisioning utente. (Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento).
-
Esegui test ed esegui l'onboarding di un cliente eseguendo il provisioning di almeno un utente. (Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
-
Operazioni di alto livello, nell'ordine tipico. Esistono diverse attività determinanti che non è possibile ignorare.
-
Se si desidera creare le proprie applicazioni per gestire Webex per abbonati Cisco BroadWorks, leggere Uso dell'API di provisioning nella sezione Di riferimento di questa guida.
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto.
Funzionamento
Webex per Cisco BroadWorks è un'offerta che integra la chiamata BroadWorks in Webex. Gli abbonati utilizzano una singola applicazione (app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
-
Gli utenti chiamano PSTN numeri di telefono utilizzando l'infrastruttura BroadWorks.
-
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino per introdurre i numeri).
-
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Webex Call" nell'app Webex ( queste chiamate sono app Webex all'app Webex, non all'app Webex PSTN).
-
Gli utenti possono ospitare e partecipare Webex Meetings.
-
Gli utenti possono inviare messaggi l'uno all'altro o negli spazi (chat di gruppo persistente) e usufruire delle funzioni di ricerca e condivisione di file (su infrastruttura Webex).
-
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
-
Dopo averci asserto come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare il rapporto tra l'istanza BroadWorks e Webex.
-
È possibile creare organizzazioni dei clienti in Control Hub e pres effettuare il provisioning degli utenti in tali organizzazioni.
-
Ciascun abbonato in BroadWorks ottiene un'identità Webex in base al relativo indirizzo e-mail (attributo ID e-mail in BroadWorks).
-
Gli utenti eseguono l'autenticazione per BroadWorks o per Webex.
-
I client vengono emessi con token a lungo termine per autorizzarli per i servizi presso BroadWorks e Webex.
L'app Webex al centro di questa soluzione; è un'applicazione che può essere brandable disponibile su desktop Mac/Windows e su dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include le funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzioni di messaggistica, presenza e riunione.
Il client si registra ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i sistemi BroadWorks per garantire un'esperienza di provisioning utente ottimale.
Funzioni e limitazioni
Sono disponibili diversi pacchetti con diverse funzioni.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano un utente tramite softphone, i risultati della ricerca non forniscono alcuna opzione per l'invio di un messaggio.
Gli utenti softphone possono condividere lo schermo durante una chiamata.
Pacchetto "Base"
Il pacchetto base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti alle riunioni. (** vedere la Nota seguente per eccezione). In questo pacchetto, la durata massima delle riunioni è di 40 minuti.
Pacchetto "standard"
Questo pacchetto include anche tutto quello che è previsto dal pacchetto Base oltre a funzioni di riunione aggiuntive, inclusi sottotitoli codificati, trascrizione in tempo reale di 5 lingue principali, Assistente AI Cisco e sondaggi e Q&A di Slido.
Pacchetto "Premium"
Questo pacchetto include tutto quello che è previsto dal pacchetto Standard più un massimo di 300 partecipanti nella riunione "Unified Space" e fino a 1000 partecipanti in una sala riunioni personale, registrazione su cloud delle riunioni e funzioni di messaggistica avanzate che includono l'Assistente AI Cisco.
'Riunioni spazio unificate' si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti 'Riunione' o 'Pianifica'.
Confronta pacchetti
Pacchetto |
Chiamata in corso |
Messaggistica |
Riunioni spazio unificato |
PMR riunioni |
---|---|---|---|---|
Softphone |
Incluso |
Non incluso |
Nessuno |
Nessuno |
Base |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Standard |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Premium |
Incluso |
Incluso |
300 partecipanti |
1000 partecipanti |
'Riunioni PMR' si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID).
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per conoscere le differenze di supporto delle funzioni per le riunioni nella sala riunioni personale per i pacchetti Base, Standard e Premium.
Funzione riunione |
Supportato con pacchetto base |
Soportato con il pacchetto standard |
Supportato con pacchetto Preminum |
Commento |
---|---|---|---|---|
Durata riunione |
40 Minuti o meno |
24 ore |
24 ore | |
Condivisione desktop |
Sì |
Sì |
Sì | |
Condivisione di un'applicazione |
Sì |
Sì |
Sì | |
Chat tra più parti |
Sì |
Sì |
Sì | |
Lavagna |
Sì |
Sì |
Sì | |
Protezione password |
Sì |
Sì |
Sì | |
App Web - nessun download o plug-in (esperienza ospite) |
Sì |
Sì |
Sì | |
Supporta accoppiamento con dispositivi Webex |
Sì |
Sì |
Sì | |
Controllo piano (disattiva audio di uno / Espelle tutti) |
Sì |
Sì |
Sì | |
Collegamento Riunioni permanenti |
Sì |
Sì |
Sì | |
Acces. sito per riunioni |
Sì |
Sì |
Sì | |
Accesso alla riunione tramite VoIP |
Sì |
Sì |
Sì | |
Blocco |
Sì |
Sì |
Sì | |
Controlli relatore |
No |
No |
Sì | |
Controllo desktop remoto |
Sì |
Sì |
Sì | |
Numero di partecipanti |
100 |
100 |
1000 | |
Registrazione salvata in locale nel sistema |
Sì |
Sì |
Sì | |
Registrazione nel cloud |
No |
No |
Sì | |
Registrazione - Storage su cloud |
No |
No |
10 GB per sito | |
Trascrizione delle registrazioni |
No |
No |
Sì | |
Pianificazione riunione |
Sì |
Sì |
Sì | |
Abilita condivisione del contenuto con integrazioni esterne |
No |
No |
Sì | |
Consenti PMR modifica dell'URL |
Sì |
Sì |
Sì | |
Riunioni in streaming in diretta (ad esempio, su Facebook, Youtube) |
No |
No |
Sì | |
Consentire ad altri utenti di pianificare le riunioni per proprio conto |
No |
No |
Sì | |
Aggiungi organizzatore alternativo |
Sì |
Sì |
Sì | |
Integrazione delle app (es. Zendesk, Slack) |
Dipende dall'integrazione |
Dipende dall'integrazione |
Sì |
Vedere la sezione Integrazioni delle app di seguito per ulteriori informazioni sul supporto. |
Integrazione con il calendario Microsoft Office 365 |
Sì |
Sì |
Sì | |
Integrazione con Google Calendaring per G Suite |
Sì |
Sì |
Sì |
Il Centro assistenza Webex pubblica le funzioni e la documentazione per l'utente per Webex all'help.webex.com
. Leggere i seguenti articoli per ulteriori informazioni sulle funzioni:
Funzioni di chiamata
L'esperienza di chiamata è simile a quelle precedenti che utilizzano il motore di controllo chiamate BroadWorks. La differenza rispetto a UC-One Collaborate e UC-One SaaS è che l'app Webex è il soft client principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
-
Zendesk: solo Premium
-
Slack: solo Premium
-
Microsoft Teams per Webex Meetings: standard o premium
-
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
-
Calendario Office 365: standard o premium
-
Google Calendaring per G Suite: standard o premium
Supporto infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione di Webex per l'infrastruttura desktop virtuale (VDI).
Supporto IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Pro Pack per Control Hub
Il servizio aggiuntivo Pro Pack per Control Hub fornisce agli amministratori, alle informazioni di sicurezza e ai funzionari di conformità funzionalità avanzate in sicurezza, conformità e analisi in grado di integrare il software.
Questi servizi aggiuntivi saranno disponibili solo per i pacchetti Standard e Premium.
Per ulteriori informazioni, vedi la Pagina della Guida di Pro Pack per Control Hub.
Roadmap futuro
Per informazioni sulle nostre intenzione per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Gli elementi della roadmap non sono associabili ad alcuna capacità. Cisco si riserva il diritto di disattivare o revisionare uno o tutti di questi elementi nelle release future.
Limiti
Limitazioni provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario per il Webex Meetings sito creato per tale pacchetto.
Se non viene specificato alcun fuso orario nella richiesta di provisioning per il primo utente di ciascun pacchetto, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sul valore predefinito regionale dell'organizzazione degli abbonati.
Se il cliente richiede un fuso orario Webex Meetings sito specifico, specificare il parametro di fuso orario nella richiesta di provisioning
per:
-
il primo abbonato predisposto per il pacchetto standard nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto Base nell'organizzazione.
Limitazioni generali
-
Nessuna chiamata nella versione Web del client Webex (si tratta di una limitazione del client, non di una limitazione di soluzione).
-
Webex potrebbe non disporre ancora di tutti i controlli UI per supportare alcune funzioni di controllo chiamate disponibili da BroadWorks.
-
Il client Webex non può essere attualmente con etichetta "White labeled".
-
Quando si creano organizzazioni cliente utilizzando il metodo di provisioning scelto, tali organizzazioni vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. È previsto che partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
-
La generazione di report sulle riunioni e sull'utilizzo dei messaggi è disponibile attraverso l'organizzazione cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti messaggistica
I seguenti limiti di storage dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo spazio di storage massimo per la messaggistica e i file combinati.
-
Base: 2 GB per utente per 3 anni
-
5 GB standard per utente per 3 anni
-
Premium: 10 GB per utente per 5 anni
Per ciascuna organizzazione di clienti, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti Premium può utilizzare un limite di messaggistica e storage file totale di 50 GB. Un singolo utente può superare il limite per utente (10 GB) a condizione che la società sia ancora sotto il valore massimo aggregato (50 GB).
Per gli spazi del team creati, i limiti di messaggistica si applicano al totale aggregato per l'organizzazione del cliente che possiede lo spazio del team. È possibile trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti di messaggistica generali che si applicano agli spazi del team di messaggistica Webex, vedere https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure connessioni a Webex e BroadWorks. I dati archiviati nel cloud Webex e esposti all'utente attraverso l'interfaccia dell'app Webex vengono crittografati sia in viaggio che a riposo.
Ulteriori dettagli sullo scambio dei dati sono disponibili nella sezione Riferimento di questo documento.
Lettura aggiuntiva
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati più vicino alla regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore provider di servizi (utente): Per le attività di manutenzione giornaliere, è possibile gestire le parti in locale (di chiamata) della soluzione utilizzando i propri sistemi. Le parti Webex della soluzione vengono gestite attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e Wholesale RTM.
Il primo utente predisposto a un nuovo organizzazione partner viene assegnato automaticamente ai ruoli Amministratore completo e Amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi.
Team operativo Cisco Cloud: Crea l'organizzazione partner in Partner Hub, se non esiste, durante il processo di onboarding.
Una volta che si dispone dell'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente si creano "Modelli di onboarding" per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Si eservi quindi il provisioning dei propri clienti o abbonati.
# |
Attività tipica |
SP |
Cisco |
---|---|---|---|
1 |
Onboarding del partner: creazione dell'organizzazione partner, se presente, e abilitazione delle attivazioni/disattivazioni delle funzioni necessarie |
● | |
2 |
Configurazione BroadWorks nell'organizzazione partner tramite Hub partner (cluster) |
● | |
3 |
Configurazione delle impostazioni di integrazione nell'organizzazione partner tramite Partner Hub (modelli di offerta, branding) |
● | |
4 |
Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|Patch ADP, firewall, configurazione ADP XSP|, XSI, AuthService, CTI, NPS, applicazioni DMS su XSP|ADP) |
● | |
5 |
Sviluppo di un'integrazione o di un processo di provisioning |
● | |
6 |
Prepara materiali GTM |
● | |
7 |
Esegui migrazione o provisioning di nuovi utenti |
● |
Architettura
Che cos'è nel diagramma?
Client
-
Il client Webex App svolge la funzione di applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di riunioni audio/video native di messaggistica, presenza e multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per chiamate SIP PSTN chiamate.
-
I telefoni Cisco IP e relativi accessori utilizzano anche l'infrastruttura BroadWorks per SIP e chiamate PSTN telefoniche. Ci vediamo in grado di supportare telefoni di terze parti.
-
Portale di attivazione utente per consentire agli utenti di accedere a Webex utilizzando le credenziali BroadWorks.
-
Partner Hub è un'interfaccia Web per l'amministrazione della propria organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. È anche possibile utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
provider di servizi di rete
Il blocco verde a sinistra del diagramma rappresenta la rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
-
ADP XSP|rivolto al pubblico, per Webex per Cisco BroadWorks: (La casella rappresenta uno o più farm XSP|ADP, possibilmente frontali da bilanciatori del carico).
-
Ospita l'interfaccia XSI-Actions &XSI-Events, Device Servizio di gestione (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato di hook degli altri (presenza di telefonia) e cronologia chiamate.
-
Pubblica la directory sui client Webex.
-
-
ADP XSP|rivolto al pubblico, con NPS:
-
Server push notifiche chiamate host: Un server push di notifica su un ADP XSP| nel tuo ambiente. Interfaccia tra il server applicazioni e il nostro proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS &FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
-
-
Server applicazione:
-
Fornisce il controllo e le interfacce delle chiamate ad altri sistemi BroadWorks (in genere)
-
Per il provisioning flowre, l'AS viene utilizzato dall'amministratore del partner per eseguire il provisioning degli utenti in Webex
-
Inserisce profilo utente in BroadWorks
-
-
SISTEMA SISTEMA AVAIO/BSS: Sistema di supporto operativo/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nel diagramma rappresenta il cloud Webex. I microservizi Webex supportano tutte le funzionalità di collaborazione Webex:
-
Cisco Common Identity (CI) è il servizio di identità all'interno di Webex.
-
Webex per Cisco BroadWorks rappresenta l'insieme di microservizi che supportano l'integrazione tra Webex e provider di servizi BroadWorks ospitate:
-
API di provisioning utenti
-
provider di servizi configurazione
-
Accesso utente tramite credenziali BroadWorks
-
-
casella Messaggistica Webex per microservizi correlati alla messaggistica.
-
Webex Meetings che rappresenta i server di elaborazione multimediale e i controller SBC per le riunioni video con più partecipanti (SIP & SRTP)
Servizi Web di terze parti
I seguenti componenti di terze parti vengono rappresentati nel diagramma:
-
APNS (Apple Push Notifications Service) inserisce le notifiche di chiamate e messaggi nelle applicazioni Webex sui dispositivi Apple.
-
FCM (FireBase Cloud Messaging) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Ruolo dei server ADP XSP|rivolti al pubblico in Webex per Cisco BroadWorks
L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
-
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste di BroadWorks J JSON (Token Web JSON) per conto dell'utente
-
Interfaccia CTI protetta da mTLS, a cui Webex esegue l'abbonamento per eventi cronologia chiamate e stato della presenza di telefonia da BroadWorks (stato hook).
-
Interfacce di azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate, le directory di contatto e di elenco delle chiamate e la configurazione del servizio di telefonia dell'utente finale
-
Servizio DM (Device Management) per i client per recuperare i file di configurazione delle chiamate
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedi Configurazione dei cluster BroadWorks in Partner Hub in questo documento) Per ciascun cluster, puoi fornire solo un URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP
Si richiede di utilizzare un'istanza ADP XSP|separata e dedicata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile ospitare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso ADP XSP| che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/farm XSP|ADP dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
-
Ad esempio, se stai offrendo UC-One SaaS, ti consigliamo di creare un nuovo farm ADP XSP|per Webex per Cisco BroadWorks. In questo modo i due servizi possono funzionare in modo indipendente durante la migrazione degli abbonati.
-
Se si posizionano le applicazioni Webex per Cisco BroadWorks su un farm XSP|ADP utilizzato per altri scopi, è responsabilità del cliente monitorare l'uso, gestire la complessità risultante e pianificare l'aumento di scala.
-
Il Strumento di pianificazione della capacità del sistema Cisco BroadWorks utilizza un farm ADP XSP| dedicato e potrebbe non essere accurato se lo si utilizza per calcoli di collocazione.
Se non diversamente specificato, il Webex dedicato per Cisco BroadWorks XSP ADP| deve ospitare le seguenti applicazioni:
-
AuthService (TLS con convalida token CI o mTLS)
-
CTI (mTLS)
-
Azioni XSI (TLS)
-
XSI-Events (TLS)
-
DMS (TLS): facoltativo. Non è obbligatorio distribuire un'istanza DMS o un farm separati specificatamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
-
Impostazioni chiamata Webview (TLS): opzionale. La vista Web impostazioni chiamata (CSW) è richiesta solo se desideri che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso al CTI attraverso un'interfaccia protetta (autenticazione) TLS reciproca autenticazione. Per supportare questo requisito, si consiglia una di queste opzioni:
-
(Diagramma etichettato Opzione 1) Un'istanza o un farm XSP|ADP per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
-
(Diagramma etichettato Opzione 2) Due istanze o farm XSP| ADP, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSP|ADP
Se si dispone di un farm ADP XSP|esistente conforme a una delle architetture suggerite sopra (opzione 1 o 2) e carico leggero, è possibile riutilizzare gli ADP XSP|esistenti. Sarà necessario verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti delle applicazioni per Webex. Le due considerazioni principali sono:
-
Se è necessario supportare più organizzazioni partner Webex su XSP|ADP, ciò significa che è necessario utilizzare mTLS sul servizio di autorizzazione (la convalida del token CI è supportata solo per una singola organizzazione partner su un XSP|ADP). Se si utilizza mTLS sul servizio di autenticazione, ciò significa che non è possibile avere client che stanno utilizzando l'autenticazione di base sul servizio di autenticazione allo stesso tempo. Questa situazione impedirebbe il riutilizzo dell'ADP XSP|.
-
Se il servizio CTI esistente è configurato per essere utilizzato dai client con la porta protetta (in genere 8012) ma senza mTLS (ossia, autenticazione client), tale servizio è in conflitto con il requisito webex di disporre di mTLS.
Poiché gli ADP XSP| hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero verificarsi altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di ADP XSP| deve essere verificato in un laboratorio con la configurazione prevista prima di impegnarsi per il riutilizzo.
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione dell'orario per tutti gli ADP XSP| utilizzati con Webex.
Installare il pacchetto ntp
dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Successivamente, è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, vedere la Guida alla gestione software BroadWorks.
Durante l'installazione interattiva del software ADP XSP|, è possibile configurare NTP. Procedere come segue:
-
Quando viene visualizzato il programma di installazione,
configurare NTP?
, inserire y.
-
Quando il programma di installazione richiede,
questo server deve essere un server NTP? , inserire n
.
-
Quando il programma di installazione richiede, Qual è l'indirizzo NTP, il nome host o nome di dominio completo? , inserire l'indirizzo del server NTP o un servizio
NTP pubblico, ad esempio,
pool.ntp.org
.
Se le ADP XSP| utilizzano l'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie chiave=valore:
NTP
NTP_SERVER=
Requisiti di sicurezza e identità ADP XSP|
Sfondo
I protocolli e i tipi di crittografia delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli variano dal più generale (provider SSL) alla più specifica (singola interfaccia). Un'impostazione più specifica sovrascrive sempre un'impostazione più generale. Se non vengono specificate, le impostazioni SSL di livello 'inferiore' vengono ereditano dai livelli superiori.
Se non viene modificata alcuna impostazione dai valori predefiniti, tutti i livelli ereditano le impostazioni predefinite del provider SSL (estensione JSSE Java Secure Sockets).
Elenco requisiti
-
L'ADP XSP| deve autenticarsi ai client utilizzando un certificato firmato da un'autorità di certificazione in cui il nome comune o il nome alternativo oggetto corrisponde alla parte di dominio dell'interfaccia XSI.
-
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
-
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
-
Diffie-Hellman Ephemeral (DHE) o Curve ellittiche Diffie-Hellman Ephemeral (ECDHE) key-exchange
-
Crittografia AES (Advanced Encryption Standard) con una dimensione di blocco minima di 128 bit (ad esempio, AES-128 o AES-256)
-
Modalità di crittografia GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
-
Se viene utilizzata la crittografia CBC, solo la famiglia di funzioni hash SHA2 è consentita per la derivazione chiave (SHA256, SHA384, SHA512).
-
-
Ad esempio, i seguenti tipi di crittografia soddisfano i requisiti:
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come mostrato sopra, non la convenzione openSSL.
Tipi di crittografia TLS supportati per le interfacce AuthService e XSI
Questo elenco è soggetto a modifica quando i requisiti di sicurezza del cloud cambiano. Seguire i suggerimenti sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento.
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
-
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
-
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_128_GCM_SHA256
-
TLS_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_256_CBC_SHA256
-
TLS_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_WITH_AES_256_CBC_SHA
-
TLS_PSK_WITH_AES_256_CBC_SHA384
-
TLS_PSK_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_WITH_AES_128_CBC_SHA
-
TLS_PSK_WITH_AES_128_CBC_SHA256
-
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il conteggio dei thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi mostrati, come segue (non diminuire, se sono superiori ai valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più ADP XSP|
Elemento Edge di bilanciamento del carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, tale elemento deve gestire in modo trasparente la distribuzione del traffico tra più server ADP XSP|e il cloud e i client Webex per Cisco BroadWorks. In questo caso, si fornisce l'URL del servizio di bilanciamento del carico a Webex per la configurazione Cisco BroadWorks.
Note su questa architettura:
-
Configurare DNS in modo che i client possano trovare il servizio di bilanciamento del carico quando si connettono all'interfaccia Xsi (vedere Configurazione DNS).
-
Si consiglia di configurare l'elemento Edge in modalità proxy SSL inverso per accertarsi che la crittografia dati point-to-point.
-
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio tuo-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri nomi di domini completi, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Server ADP XSP|rivolti a Internet
Se si espongono direttamente le interfacce XSI, utilizzare il DNS per distribuire il traffico a più server ADP XSP|.
Note su questa architettura:
-
Sono necessari due record per la connessione ai server ADP XSP|:
-
Per i microservizi Webex: I record a turni A/AAAA sono richiesti per indirizzare più indirizzi IP ADP XSP|. Questo perché i microservizi Webex non possono eseguire ricerche SRV. Per esempi, vedere Servizi cloud Webex.
-
Per l'app Webex: Un record SRV che si risolve in record A e ciascun record A si risolve in un singolo ADP XSP|. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per indirizzare il servizio XSI per più indirizzi ADP XSP|. Assegnare una priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (E l'indirizzo IP successivo) e passino al record A successivo (e indirizzo IP) solo se il primo indirizzo IP non è attivo. NON utilizzare un approccio a tutto tondo per Webex App.
-
-
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio tuo-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri nomi di domini completi, ad esempio XSP|ADP01.example.com, nel nome comune.
-
È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL ADP XSP|in un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server ADP XSP|XSP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.
Ordinazione e provisioning
Ordinazione e provisioning si applicano a questi livelli:
-
Provisioning partner/provider di servizi:
Ciascun Webex per Cisco BroadWorks provider di servizi (o rivenditore) presente deve essere configurato come organizzazione partner in Webex e disporre dei diritti necessari. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per la gestione di Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le attività di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/Enterprise.
-
Ordini e provisioning cliente/Enterprise:
Ciascuna azienda BroadWorks abilitata per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo viene eseguito automaticamente come parte del provisioning dell'utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks sono predisposti nella stessa organizzazione clienti Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
-
Ordinazione e provisioning di utenti/abbonati:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning utente:
-
Provisioning Flow con e-mail attendibili
-
Provisioning flow senza messaggi e-mail attendibili
-
Self-provisioning utente
-
Provisioning API
-
Provisioning a flusso costante con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile asserre che BroadWorks abbia indirizzi e-mail dell'abbonato validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Provisioning flow senza messaggi e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non si può contare sugli indirizzi e-mail dell'abbonato tenuti da BroadWorks, questa opzione di provisioning crea account Webex, ma non può attivarli fino a quando gli abbonati non forniscono e convalidano gli indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Self-Provisioning utente
Con questa opzione, non esiste provisioning flowworks da BroadWorks a Webex. Dopo aver configurato l'integrazione tra Webex e il sistema BroadWorks, si ottengono uno o più collegamenti specifici per il provisioning degli utenti all'interno di Webex per l'organizzazione partner Cisco BroadWorks.
Si progettare quindi le proprie comunicazioni (o delegare ai clienti) la distribuzione del collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account sono predisposti nell'ambito dell'organizzazione partner, è possibile regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare questa operazione.
Gli utenti devono essere presenti nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento.
provider di servizi provisioning da PARTE delle API
Webex sono esposti una serie di API pubbliche che consentono di creare Webex per il provisioning di utenti/abbonati Cisco BroadWorks nel flusso di lavoro/strumenti di gestione degli utenti esistenti.
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Installare AP.as.22.0.1123.ap376508.
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Installare AP.as.23.0.1075.ap376509
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Installare AP.as.24.0.944.ap375100
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning di nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per utenti Cisco BroadWorks.
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti di Webex di Cisco Broadworks di chiamare altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella directory Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo di estensione di tutte le aree del metodo di inizio chiamata e del profilo utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e diversi gruppi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due aziende che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks tramite i seguenti metodi:
-
Utenti Cisco BroadWorks
-
Provisioning API pubblica come estensione
-
Il parametro dell'interno deve essere passato esplicitamente come parte della chiamata API. Per aziende/gruppi che dispongono di un codice di chiamata posizione (LDC) configurato, il parametro interno deve essere la combinazione di LDC e 'numero di interno.
-
-
Provisioning a flusso costante o autoattivazione
-
L'interno e il sistema LDC (ove applicabile) verranno recuperati automaticamente da BroadWorks.
-
-
-
Utenti o entità Calling solo BroadWorks
-
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione del codice di chiamata posizione (LDC) e del numero di interno.
-
Record chiamata BroadWorks |
Descrizione |
Metodo di provisioning |
Gestione dell'interno |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
API pubblica |
L'interno deve essere passato come parametro |
A flusso costante |
Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks |
Utenti di chiamata non caricati in Webex |
Sinc rubrica |
Interno sincronizzato dalla sincronizzazione rubrica |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sinc rubrica | Interno sincronizzato dalla sincronizzazione rubrica |
Elenchi telefonici BroadWorks |
Elenchi telefonici aziendali, di gruppo o personali |
Sinc rubrica |
Non applicabile |
Prerequisiti
-
La versione del client richiesta per supportare questa funzione è la versione 42.11 o successiva.
-
Patch in cui i codici di chiamata dell'interno e della posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
-
AP.platform.23.0.1075.ap380045
-
AP.as.23.0.1075.ap380045
-
AP.xsp.23.0.1075.ap380045
-
AP.as.24.0.944.ap380045
-
-
Abilita l'intestazione X-BroadWorks-Remote-Party-Info sul AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP, richiesto per il supporto della funzione di chiamata interno.
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata dell'interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità chiamata di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'interno come seconda opzione sia in Partner Hub che in Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con l'interno tramite uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione di estensione sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Questo non visualizza un interno nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere l'opzione di chiamata a interno visibile per i clienti esistenti:
-
Se un partner desidera che a tutte le organizzazioni dei clienti gestiti sia fornito un interno come opzione di chiamata, è consigliabile che l'amministratore del partner sposti l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
-
Se un partner desidera fornire opzioni di chiamata per un'organizzazione cliente specifica, si consiglia all'amministratore partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto di contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e allinearlo all'aumento dei contatti 30K per l'elenco telefonico aziendale, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per organizzazione, applicabile alla somma degli elenchi telefonici aziendali e di gruppo in un'unica azienda BroadWorks. Ad esempio, sarà supportata un'azienda BroadWorks con elenco telefonico Enterprise con 30K e anche 5 elenchi di telefoni di gruppo, ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K in totale).
Questa funzione è disponibile su richiesta. Contatta il team del tuo account per abilitarlo.
-
Prima di abilitare la funzione, è necessario eseguire una migrazione dei prerequisiti per il provisioning e associare i gruppi per tutti gli utenti predisposti esistenti.
-
Il team Cisco eseguirà un'API interna per eseguire la migrazione di eventuali utenti predisposti esistenti e associarli al gruppo corretto. NOTA: Questa operazione può richiedere fino a una settimana.
-
Una volta completata la migrazione per il partner e abilitata la funzione, tutti gli utenti predisposti di recente verranno "raggruppati" in modo appropriato.
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks in storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare il gruppo a cui appartiene questo utente. L'associazione dell'utente a un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca di contatti nello storage di gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning di Webex per gli abbonati BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
L'ID gruppo aziendale BroadWorks può essere fornito per gli utenti Cisco BroadWorks tramite i seguenti metodi:
-
Webex per utenti Cisco BroadWorks
-
Provisioning API pubblica come 'spEnterpriseGroupId'
-
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
-
-
Provisioning a flusso costante o autoattivazione
-
L'ID gruppo aziendale BroadWorks verrà recuperato automaticamente da BroadWorks.
-
-
Utenti o entità Calling solo BroadWorks
-
Non applicabile. Non è necessario sincronizzare l'ID gruppo BroadWorks Enterprise per questi utenti.
-
-
Record chiamata BroadWorks |
Descrizione |
Metodo di provisioning |
Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
API pubblica |
ID gruppo BroadWorks Enterprise Group deve essere passato come parametro spEnterpriseGroupId |
A flusso costante |
ID gruppo aziendale BroadWorks recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks |
Utenti di chiamata non caricati in Webex |
Sinc rubrica |
Non applicabile |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sinc rubrica |
Non applicabile |
Elenchi telefonici BroadWorks |
Contatti negli elenchi telefonici di gruppo BroadWorks |
Sinc rubrica |
I contatti di gruppo vengono memorizzati nel Servizio Webex Contact associato al gruppo specifico |
Elenchi telefonici BroadWorks Enterprise o Persional |
Contatti negli elenchi telefonici aziendali o personali |
Sinc rubrica |
Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. La migrazione non può essere completata finché QUESTA API non viene completata. L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march
Una volta abilitata la funzione e come risultato della successiva sincronizzazione delle rubriche, verranno visualizzati anche i gruppi utenti aziendali in Control Hub. In questa fase, la visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativo. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza ai gruppi in Control Hub poiché tali modifiche non verranno riflesse nuovamente in BroadWorks. La gestione dei gruppi in Control Hub è destinata ai partner che adotteranno le API di gestione dei contatti future.
Migrazione e prova futura
Cisco il client BroadSoft unified Communications deve passare da UC-One a Webex. Esiste una corrispondente lingua dei servizi di supporto lontani dalla rete provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che si utilizzi UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita è distribuire nuovi ADP XSP| dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti a Webex e, infine, recuperare l'infrastruttura utilizzata per la soluzione precedente.
Abbonamenti ai documenti consigliati
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Esegui sottoscrizione che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di iscriversi a ciascuno dei seguenti articoli per essere certi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per eseguire l'abbonamento, andare a ciascuno dei collegamenti seguenti e nell'articolo che viene avviato, fare clic sul pulsante Abbonati .
Si consiglia di iscriversi come minimo all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati sotto Documenti aggiuntivi dispone di un'opzione Esegui sottoscrizione . Per la visualizzazione di questa opzione, l'articolo deve essere visualizzato su help.webex.com.
Non è disponibile alcuna opzione di abbonamento per le pagine di destinazione della documentazione.
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Webex per documenti Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
-
Soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono propri (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
-
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive la modalità di onboarding e l'onboarding dei dispositivi Room OS e MPP.
-
Guida alla risoluzione dei problemi Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi per Webex per Cisco BroadWorks.
Articoli Webex per Cisco BroadWorks
Per ulteriori informazioni su Webex per Cisco BroadWorks, gli amministratori dei partner possono utilizzare i seguenti siti opzionali:
-
Documentazione di Webex per Cisco BroadWorks: la pagina di destinazione elenca i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
-
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme alle prossime novità.
-
Problemi noti e limitazioni: leggere i problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
-
Ruoli amministratore partner per Webex per BroadWorks e Wholesale RTM: questo articolo descrive come assegnare ruoli amministratore partner per organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte Cisco BroadWorks della soluzione:
Articoli della Guida Webex
È possibile utilizzare i seguenti siti della Guida Webex per trovare articoli Webex che aiutano gli amministratori dei clienti e gli utenti finali a utilizzare le funzioni Webex.
-
Webex dai provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati più di frequente per gli utenti dell'app Webex che hanno acquistato servizi Webex da un provider di servizi.
-
Centro assistenza Webex: utilizzare la funzione di ricerca all'indirizzo help.webex.com per ricercare altri articoli Webex che descrivono l'app Webex e la funzionalità Webex Meetings. È possibile cercare articoli dell'utente o dell'amministratore.
Documentazione per gli sviluppatori
-
Guida per lo sviluppatore di Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Preparazione dell'ambiente
Punti decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastruttura
|
Quanti ADP XSP|? Come prendono mTLS? |
Pianificatore capacità sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento XSP|ADP CLI Questo documento |
Provisioning clienti e utenti |
Si può asserre che si considera attendibili i messaggi e-mail in BroadWorks? Si desidera che gli utenti forniranno gli indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Doc API pubblici su https://developer.webex.com Questo documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo sul branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso dei clienti? | Questo documento |
Funzioni dell'abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o softphone. |
Questo documento Matrice funzioni/pacchetto |
Autenticazione utente | BroadWorks o Webex | Questo documento |
Adattatore di provisioning (per le opzioni di provisioning flow) |
Utilizzi già IM&P integrato, ad esempio per UC-One SaaS? Utilizzare più modelli? Esiste un caso d'uso più comune previsto? |
Questo documento Riferimento CLI server applicazione |
Architettura e infrastruttura
-
Con quale scala intendete iniziare? È possibile aumentare la scalabilità in futuro, ma la stima d'uso corrente deve guidare la pianificazione dell'infrastruttura.
-
Collaborare con il responsabile account / rappresentante di vendita Cisco per ridimensionare l'infrastruttura ADP XSP|, in base alla Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
-
In che modo Webex esegue connessioni TLS reciproche con gli ADP XSP|? Direttamente all'ADP XSP| in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce (Le connessioni TCP non crittografate al bordo della rete non sono supportate).
Provisioning clienti e utenti
Quale metodo di provisioning utente si adatta meglio alle esigenze?
-
Provisioning a flusso costante con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene automaticamente predisposto in Webex.
Se è anche possibile asserre che gli indirizzi e-mail dell'abbonato nella BroadWorks siano validi e univoci per Webex, è possibile utilizzare la varianti "e-mail attendibile" del provisioning flow provisioning. Gli account Webex del sottoscrittore vengono creati e attivati senza il loro intervento; semplicemente scaricare il client ed eseguire l'accesso.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto l provider di servizi deve specificare un indirizzo e-mail valido per l'utente per potervi fornire i servizi Webex. Deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo nell'attributo ID alternativo.
-
Provisioning a flusso costante senza e-mail attendibili: Se non si riesce a verificare l'attendibilità degli indirizzi e-mail dell'abbonato, è comunque possibile assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
-
Provisioning automatico utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. L'utente (o i clienti) distribuiscono invece un collegamento di provisioning e i collegamenti per scaricare diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex. Quindi scaricano il client e a quel punto Webex recuperano alcune configurazioni aggiuntive su di esse da BroadWorks (inclusi i numeri principali).
-
Provisioning controllato SP tramite API: Webex sono esposti una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti generali di sistema descritti in questa guida.
Metodo di provisioning |
Requisiti |
---|---|
Provisioning Flow (e-mail attendibili o non attendibili) |
L'API di provisioning Webex aggiunge gli utenti BroadWorks esistenti a Webex automaticamente una volta che l'utente soddisfa i requisiti e attiva il servizio IM+P integrato . Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello Onboarding include le seguenti impostazioni:
|
Self-Provisioning utente |
L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato l'e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello Onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) |
Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono disponibili due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, andare a Utenti BroadWorks. |
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Installare AP.as.22.0.1123.ap376508.
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Installare AP.as.23.0.1075.ap376509
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Installare AP.as.24.0.944.ap375100
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning di nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per utenti Cisco BroadWorks.
Impostazioni internazionali della lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente amministrativo predisposto viene assegnata automaticamente come impostazioni internazionali predefinite per tale organizzazione cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti alle riunioni in tale organizzazione del cliente.
Sono supportate impostazioni internazionali per la lingua a cinque caratteri in formato (ISO-639-1)_(ISO-3166). Ad esempio, en_USA corrisponde a English_UnitedStates. Se è richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genererà un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso del paese dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, utilizzare le impostazioni internazionali sensibili predefinite in base al codice della lingua richiesto.
Nella tabella seguente vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice della lingua di due lettere in un'impostazione locale di cinque caratteri per le situazioni in cui una impostazione locale di cinque caratteri non è disponibile.
Impostazioni internazionali della lingua supportate (ISO-639-1)_(ISO-3166) |
Se è disponibile solo un codice lingua di due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** |
Utilizzare invece le impostazioni internazionali sensibili predefinite (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA |
it |
en_USA |
fr_FR fr_CA |
Fr |
fr_FR |
cs_CZ |
cs |
cs_CZ |
da_DK |
da |
da_DK |
de_DE |
DE |
de_DE |
hu_HU |
hu |
hu_HU |
id_ID |
Identificativo |
id_ID |
it_IT |
esso |
it_IT |
ja_JP |
ja |
ja_JP |
ko_KR |
ko |
ko_KR |
es_ES es_CO es_MX |
es |
es_ES |
nl_NL |
NL |
nl_NL |
nb_NO |
nb |
nb_NO |
pl_PL |
pl |
pl_PL |
pt_PT pt_BR |
pt |
pt_PT |
ru_RU |
RU |
ru_RU |
ro_RO |
ro |
ro_RO |
zh_CN zh_TW |
zh |
zh_CN |
sv_SE |
sv |
sv_SE |
ar_SA |
ar |
ar_SA |
tr_TR |
tr |
tr_TR |
Le impostazioni internazionali es_CO, id_ID, nb_NO e pt_PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti di Webex Meetings saranno solo in inglese. Inglese è le impostazioni internazionali predefinite per i siti se per il sito non è richiesta alcuna impostazione locale/non valida/non supportata. Questo campo di lingua è applicabile durante la creazione di un sito di organizzazione e Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, verrà utilizzata come lingua predefinita il modello.
Branding
Gli amministratori dei partner possono utilizzare personalizzazioni di branding avanzate per personalizzare il modo in cui l'app Webex cerca le organizzazioni dei clienti gestite dal partner. Gli amministratori dei partner possono personalizzare le seguenti impostazioni per assicurarsi che l'app Webex rifletta il marchio e l'identità della propria società:
-
Loghi aziendali
-
Schemi di colore univoci per la modalità chiaro o la modalità scura
-
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione di personalizzazioni di branding avanzate.
-
Le personalizzazioni del branding di base sono in fase di obsolescenza. Si consiglia di distribuire il branding avanzato, che offre una gamma più ampia di personalizzazioni.
-
Per informazioni dettagliate su come viene applicato il branding quando si esegue il collegamento a un'organizzazione cliente preesistente, fare riferimento a Condizioni dell'allegato organizzazione nella sezione Allega Webex per BroadWorks all'organizzazione esistente .
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding in base alle proprie esigenze, ma quando si esegue l'onboarding di un cliente, tale modello è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Di seguito sono elencati alcuni parametri del modello principale.
Pacchetto
-
È necessario selezionare un pacchetto predefinito quando si crea un modello (per informazioni dettagliate, vedere Pacchetti nella sezione Panoramica). Tutti gli utenti predisposti con tale modello, mediante flusso o auto-provisioning, ricevono il pacchetto predefinito.
-
È possibile controllare la selezione del pacchetto per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori per provisioning aziendali, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
-
Puoi modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedi documentazione dell'API di Webex per Cisco BroadWorks o tramite Partner Hub (vedi Modifica del pacchetto utente in Partner Hub).
-
Non è possibile modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è disattivata; se l'abbonato è assegnato a questo servizio in BroadWorks, il modello Hub partner associato all'URL di provisioning di tale azienda definisce il pacchetto.
Rivenditori e aziende o provider di servizi e gruppi?
-
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se si è un rivenditore con Aziende, è necessario abilitare la modalità Enterprise quando si crea un modello.
-
Se il sistema BroadWorks è configurato in provider di servizi modalità aziendale, è possibile lasciare disattivata la modalità Enterprise nei modelli.
-
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch broadworks richieste per il provisioning flow-through. Per informazioni dettagliate, vedere Patch richieste con provisioning flow-through.
Accertarsi di aver applicato le patch broadworks richieste per il provisioning flow-through. Per informazioni dettagliate, vedere Patch richieste con provisioning flow-through.
Modalità di autenticazione
Decidi come desideri che gli abbonati autenticino quando accedono a Webex. Puoi assegnare la modalità utilizzando l'impostazione Modalità autenticazione nel modello Onboarding. Nella tabella seguente vengono descritte alcune delle opzioni.
Modalità di autenticazione | BroadWorks | Webex |
Identità utente principale | File BroadWorks ID utente | Indirizzo e-mail |
provider di identità |
BroadWorks.
| Cisco Common Identity |
Autenticazione multi-fattori? | No | Richiede un IdP cliente che supporti l'autenticazione a più fattori. |
Percorso di convalida credenziali
|
|
|
Per una descrizione dettagliata del flusso SSO accesso con autenticazione diretta a BroadWorks, vedere SSO login flow.
Codifica UTF-8 con autenticazione BroadWorks
Con l'autenticazione BroadWorks, si consiglia di configurare la codifica UTF-8 per l'intestazione di autenticazione. UTF-8 risolve un problema che può verificarsi con le password che utilizzano caratteri speciali in base al quale il browser Web non codifica correttamente i caratteri. Utilizzando una codifica UTF-8, l'intestazione base 64 codificata risolve questo problema.
È possibile configurare la codifica UTF-8 eseguendo uno dei seguenti comandi CLI su XSP o ADP:
-
XSP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> imposta authenticationEncoding UTF-8
-
ADP_CLI/Applications/WebContainer/Tomcat/GeneralSettings> imposta authenticationEncoding UTF-8
Paese
È necessario selezionare un paese quando si crea un modello. Questo paese verrà assegnato automaticamente come paese dell'organizzazione per tutti i clienti predisposti con il modello in Common Identity. Inoltre, il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex.
I numeri di chiamata in ingresso globali predefiniti del sito verranno impostati sul primo numero di chiamata in ingresso disponibile definito nel dominio di telefonia in base al paese dell'organizzazione. Se il paese dell'organizzazione non viene trovato nel numero di accesso definito nel dominio di telefonia, verrà utilizzato il numero predefinito di tale posizione.
N. di serie |
Posizione |
Prefisso internazionale |
Nome paese |
---|---|---|---|
1 |
AMER |
+1 |
us, ca |
2 |
APAC |
+65 |
Singapore |
3 |
Anz |
+61 |
Australia |
4 |
EMEA |
+44 |
Regno Unito |
5 |
euro |
+49 |
Germania |
Accordi con più partner
Si desidera utilizzare la licenza secondaria di Webex per Cisco BroadWorks con un altro provider di servizi? In tal caso, ciascun fornitore di servizi avrà bisogno di un'organizzazione partner distinta Webex Control Hub permettere loro di fornire la soluzione per la propria base clienti.
Adattatore e modelli di provisioning
Quando si utilizza il provisioning flowre, l'URL di provisioning inserito in BroadWorks è derivato dal modello in Control Hub. È possibile disporre di più modelli e, quindi, di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati quando hanno ottenuto la concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e il modello che si desidera utilizzare. In questo modo, è necessario solo impostare in modo esplicito l'URL di provisioning per le aziende che necessitano di un modello diverso.
Tenere presente, inoltre, che potrebbe essere stato già utilizzato un URL di provisioning a livello di sistema, ad esempio UC-One SaaS. In tal caso, è possibile scegliere di conservare l'URL a livello di sistema per gli utenti di provisioning su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile passare al percorso alternativo e impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono descritte in dettaglio in Configurazione del server applicazioni con URL del servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning a flusso costante tra il AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server applicazioni e Webex, negando in tal modo la necessità per il server applicazioni di connettersi direttamente a Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati disponibili per Webex devono esistere nel sistema BroadWorks integrato con Webex. Se necessario, è possibile integrare più sistemi BroadWorks.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero principale o interno.
Webex utilizza gli indirizzi e-mail come identificativi principali per tutti gli utenti. Se si utilizza il provisioning flow con messaggi e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail dell'abbonato nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le relative password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo degli utenti BroadWorks Calling che dispongono di un numero principale e/o un interno. Se si utilizza il provisioning a flusso costante, agli utenti deve essere assegnato anche il servizio IM&P integrato.
Server nella rete e requisiti software
-
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere la sezione Criteri per il ciclo di vita dei prodotti BroadSoft in Criteri per il ciclo di vita di BroadSoft e matrice di compatibilità software BroadWorks.
-
Le istanze BroadWorks devono includere almeno i seguenti server:
-
Server applicazioni (AS) con versione BroadWorks come indicato sopra
-
Server di rete (NS)
-
Server di profilo (PS)
-
-
Server ADP XSP|rivolti al pubblico o Piattaforma di consegna delle applicazioni (ADP) che soddisfano i seguenti requisiti:
-
Servizio di autenticazione (BWAuth)
-
Interfacce azioni ed eventi XSI
-
DMS (applicazione Web di gestione dispositivi)
-
Interfaccia CTI (integrazione di telefonia su computer)
-
TLS 1.2 con un certificato valido (non autofirmato) ed eventuali intermedie richiesti. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
-
Autenticazione TLS reciproca (mTLS) per il servizio di autenticazione (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
Autenticazione TLS reciproca (mTLS) per interfaccia CTI (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
-
Un server XSP/ADP separato funge da "server push notifiche di chiamata" (un server NPS nel proprio ambiente utilizzato per eseguire il push delle notifiche di chiamata ad Apple/Google. Questo tipo di chiamata "CNPS" viene chiamata qui per distinguerlo dal servizio in Webex che offre notifiche push per messaggistica e presenza).
Questo server deve essere su R22 o versioni successive.
-
È obbligatorio creare un server XSP/ADP separato per CNPS poiché l'impossibilità di caricare da Webex per connessioni cloud BWKS potrebbe avere un impatto negativo sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSP|ADP, vedere la Guida tecnica di sistema Cisco BroadWorks .
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, vai a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
-
PC/laptop Windows
-
PC Apple / laptop con MacOS
-
iOS (Apple store)
-
Android (Play store)
-
Browser Web (andare a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
-
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
-
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
-
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
-
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (cinese tradizionale)
-
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
-
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
-
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
-
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
-
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (Italiano)
Telefoni e accessori fisici
-
Telefoni IP Cisco:
-
Cisco IP Phone serie 6800 con firmware Multitform
-
Cisco IP Phone serie 7800 con firmware Multitform
-
Cisco IP Phone serie 8800 con firmware Multitform
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html modelli e ulteriori informazioni, vedere .
-
-
I telefoni di terze parti sono supportati allo stesso modo delle altre integrazioni BroadWorks. Tuttavia, non dispongono ancora di contatti e integrazione di presenza con Webex per Cisco BroadWorks.
-
Adattatori:
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 191
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 192 Multiplatform
Per https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html modelli e ulteriori informazioni, vedere .
-
-
Cuffie
-
Cisco Headset serie 500
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html modelli e ulteriori informazioni, vedere .
-
-
Dispositivi Room OS:
-
Webex Room e serie Room Kit
-
Serie Webex Desk
-
Serie Webex Board
-
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e i dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivi
Di seguito sono riportati i file DTAF che devi caricare sui server applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia, è disponibile un nuovo file config-wxt.xml.template
utilizzato per l'app Webex.
Per scaricare gli ultimi profili del dispositivo, andare al sito Download software della piattaforma di consegna dell'applicazione per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che XSP.
Nome client |
Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Business Communicator - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un Profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili di dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Emetti una richiesta di servizio con l'agente di onboarding o il centro TAC di Cisco per il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il seguente titolo di richiesta per le rispettive funzioni:
-
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
-
'Configurazione NPS per Auth Proxy Setup' per configurare NPS per l'uso del proxy di autenticazione.
-
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori dettagli su questa funzione, vedi: Supporto Cisco BroadWorks per CI UUID.
-
Configura BroadWorks per abilitare la fatturazione Cisco per gli abbonamenti BroadWorks e Webex Per BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento validi per 60 giorni. Se il token scade prima di utilizzarlo, puoi inviare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali.
Ordina certificati
Requisiti di certificato per l'autenticazione TLS
Sono necessari certificati di sicurezza, firmati da un'autorità di certificazione affidabile e distribuiti su ADP XSP|rivolti al pubblico, per tutte le applicazioni richieste. Questi verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in ingresso ai server ADP XSP|.
Questi certificati devono includere il nome di dominio completo pubblico XSP|ADP come nome comune oggetto o nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati server dipendono dal modo in cui vengono distribuiti gli ADP XSP|:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente all'ADP XSP|
Il diagramma seguente riepiloga dove deve essere caricato il certificato del server pubblico firmato da CA in questi tre casi:
Le CA pubblicamente supportate che l'app Webex supporta per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per il proxy con bridge TLS
-
Il certificato del server firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta questo certificato server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
È possibile caricare un certificato CA firmato interno sull'ADP XSP|.
-
L'ADP XSP| presenta questo certificato del server firmato internamente al proxy.
-
Il proxy considera attendibile la CA interna che ha firmato il certificato del server ADP XSP|.
Requisiti del certificato TLS per il proxy passthrough TLS o ADP XSP|in DMZ
-
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
-
Gli ADP XSP| presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP|ADPs.
Ulteriori requisiti di certificato per l'autenticazione TLS reciproca su interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione TLS reciproca. Il certificato CA/catena di certificati del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedere a Partner Hub, andare a Impostazioni >
collegamento di download del certificato.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono dalla distribuzione degli ADP XSP| pubblici:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente all'ADP XSP|
Il diagramma seguente riepiloga i requisiti dei certificati in questi tre casi:
(Opzione) Requisiti di certificato per proxy tls-bridge
-
Webex presenta un certificato client firmato pubblicamente al proxy.
-
Il proxy considera attendibile la CA interna Cisco che ha firmato il certificato client. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta il certificato del server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Il proxy presenta un certificato client firmato internamente agli ADP XSP|.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3: Uso chiave estesa X509v3: 1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Il CN del certificato interno deve essere
bwcticlient.webex.com
.-
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati del server interno per XSP|ADP possono essere SAN.
-
Le autorità di certificazione pubbliche potrebbero non voler firmare i certificati con il OID broadworks proprietario richiesto. Nel caso di un proxy bridging, potrebbe essere necessario utilizzare un'autorità di certificazione interna per firmare il certificato client che il proxy presenta all'ADP XSP|.
-
-
Gli ADP XSP| si affidano alla CA interna.
-
Gli ADP XSP| presentano un certificato server firmato internamente.
-
Il proxy considera attendibile la CA interna.
-
La ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XSP| dal proxy.
(Opzione) Requisiti del certificato per il proxy passthrough TLS o ADP XSP|in DMZ
-
Webex presenta un certificato client firmato da un'autorità di certificazione interna Cisco agli ADP XSP|.
-
Gli ADP XSP| affidabili la CA interna Cisco che ha firmato il certificato client. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XSP|.
-
Gli ADP XSP| presentano i certificati del server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP|ADPs.
-
Il server applicazioni ClientIdentity contiene il CN del certificato client firmato da Cisco presentato all'ADP XSP| da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene un elenco di indirizzi IP, porte e protocolli necessari per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle del firewall in entrata ed uscita precedenti documenta solo le connessioni specifiche per Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico a Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e come ciascuna sezione è relativa a Webex per Cisco BroadWorks.
Sezione dell'articolo requisiti di rete |
Gestione delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex |
Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud |
Informativo |
È necessario leggere | |
È necessario leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex |
È necessario leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione |
Opzionale |
Servizi Webex per clienti FedRAMP |
N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedere Whitepaper (PDF) del firewall appWebex.
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza ADP XSP|Broadworks fornita dal partner. Quando un ADP XSP|o un sito non è disponibile per manutenzione pianificata o per motivi non pianificati, i servizi e le app Webex possono passare a un altro ADP XSP| o sito fornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP XSP|BroadWorks possono essere distribuiti direttamente su Internet o possono risiedere in una DMZ preceduta da un elemento di bilanciamento del carico, come F5 BIG-IP. Per fornire la geo-ridondanza, gli ADP XSP| possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un servizio di bilanciamento del carico, ciascuno con un indirizzo IP pubblico. Se gli ADP XSP|sono dietro un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e BroadWorks sembra disporre di un solo ADP XSP|ADP, anche se sono presenti più ADP XSP|.
Nell'esempio seguente, gli ADP XSP| vengono distribuiti in due siti, sito A e sito B. Esistono due ADP XSP|frontali da un servizio di bilanciamento del carico in ciascun sito. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali da LB1 mentre il sito B ha XSP|ADP3 e XSP|ADP4 frontali da LB2. Solo i servizi di bilanciamento del carico sono esposti sulla rete pubblica e le ADP XSP| si trovano nelle reti private DMZ.
Servizi Cloud Webex
Configurazione DNS
I microservizi Webex Cloud devono essere in grado di trovare i server ADP XSP|BroadWorks per la connessione alle interfacce Xsi, al servizio di autenticazione e a CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host ADP XSP|configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento del bordo di bilanciamento del carico o potrebbe essere lo stesso server XSP|ADP. Se vengono restituiti più indirizzi IP, verrà selezionato il primo IP nell'elenco. SRV ricerca non sono attualmente supportate.
Esempio: Record DNS A del partner per la scoperta di server XSP|ADP/Load Balancers bilanciati rivolti a Internet.
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (Sito A) |
R |
|
|
Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP.
Failover
Quando i microservizi Webex inviano una richiesta al servizio di bilanciamento del carico/ADP XSP| e la richiesta non riesce, possono verificarsi diverse cose:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un avanzamento di route al successivo IP.
-
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
-
Se non si riceve alcuna risposta HTTP entro 2 secondi, si verifica un timeout della richiesta e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento all'IP successivo.
Ogni richiesta viene provata 3 volte prima che un problema venga segnalato al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco di indirizzi da provare quando si invia una richiesta a un ADP XSP|. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna all'elenco per riprovare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco dei contatti bloccati. Se tale indirizzo IP viene rimosso dall'elenco dei contatti bloccati.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP XSP| o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster di chiamata BroadWorks, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
-
Azioni XSI
-
Eventi XSI
-
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Lo stato delle connessioni può essere:
-
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
-
Rosso: Quando tutti gli IP nella ricerca dei record A sono irraggiungibili e l'interfaccia non è disponibile.
I seguenti servizi utilizzano i microservizi per la connessione agli ADP XSP| e sono interessati dalla disponibilità dell'interfaccia ADP XSP|:
-
Accesso all'app Webex
-
Aggiornamento token app Webex
-
E-mail/attivazione automatica non attendibile
-
Controllo stato servizio Broadworks
Webex App
Configurazione DNS
L'app Webex accede all'interfaccia Xtended Services Interface (Azioni XSI e Eventi XSI) e ai servizi Device Management Service (DMS) su ADP XSP|.
Per trovare il servizio XSI, l'app Webex esegue una ricerca SRV DNS per _xsi-client._tcp.
. L'SRV punta all'URL configurato per gli host XSP|ADP o i servizi di bilanciamento del carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex esegue il fallback alla ricerca A/AAAA.
L'SRV può risolvere più obiettivi A/AAAA. Tuttavia, ciascun record A/AAAA deve eseguire il mapping a un solo indirizzo IP. Se sono presenti più ADP XSP| in una DMZ dietro il servizio di bilanciamento del carico/dispositivo periferico, è necessario che il servizio di bilanciamento del carico sia configurato per mantenere la persistenza della sessione per indirizzare tutte le richieste della stessa sessione allo stesso ADP XSP|. È richiesta questa configurazione poiché gli heartbeat dell'evento XSI del client devono passare allo stesso ADP XSP| utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non è necessario. Se il DNS richiede che sia definito un record A/AAAA, deve essere restituito solo 1 indirizzo IP. In ogni caso, l'SRV deve essere ancora definito per l'app Webex.
Se Webex App utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client invia heartbeat a un ADP XSP| dove non ha stabilito un canale evento. In questo modo il canale viene eliminato e anche il traffico interno risulta notevolmente più limitato, che compromette le prestazioni del cluster XSP|ADP.
Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca dei record A/AAAA, devi utilizzare un FQDN separato per Webex Cloud e Webex App per accedere alle tue ADP XSP|. Come mostrato negli esempi, Webex Cloud utilizza Un record webex-cloud-xsp.example.com
, e l'app Webex utilizza SRV _xsi-client._tcp.webex-app-xsp.example.com
.
Esempio 1: più ADP XSP|, ciascuno dietro bilanciatori di carico separati
In questo esempio, l'SRV punta a silenziare record A con ciascun record A che punta a un diverso bilanciamento del carico in un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito è riportato un esempio di SRV record.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Esempio 2: più ADP XSP|dietro un singolo servizio di bilanciamento del carico (con bridge TLS)
Per la richiesta iniziale, il servizio di bilanciamento del carico seleziona un XSP|ADP casuale. Indica che XSP ADP|restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il servizio di bilanciamento del carico utilizza il cookie per indirizzare la connessione all'ADP XSP| corretto, assicurando che il canale dell'evento non si rompi.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Bilanciamento del carico |
A |
LB.example.com |
|
Indirizzo IP del servizio di bilanciamento del carico (gli ADP XSP| sono dietro al servizio di bilanciamento del carico) |
URL dms
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il relativo file di configurazione. L'host nell'URL verrà analizzato e l'app Webex eseguirà la ricerca DNS A/AAAA dell'host per connettersi all'ADP XSP| che ospita il servizio DMS.
Esempio: Record DNS A per il rilevamento di server ADP XSP bilanciato verso Internet|/bilanciamento del carico dell'app Webex per scaricare i file di configurazione attraverso DMS:
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. Qualsiasi riferimento a XSP include XSP o ADP.
Come l'app Webex trova indirizzi ADP XSP|
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
-
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (inserito durante la creazione del cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue SRV ricerca nel modo seguente:
-
Il client esegue una ricerca SRV per _xsi-client._tcp.
-
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
-
Il client esegue una ricerca A/AAAA di tali destinazioni e memorizza nella cache gli indirizzi IP restituiti.
-
Il client si connette a uno dei destinazioni (e pertanto, il relativo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi avere lo stesso peso (o a caso se tutti sono uguali).
-
-
Se la ricerca SRV ricerca non restituisce eventuali obiettivi:
Il client esegue una ricerca A/AAAA del parametro radice Xsi, quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento del bordo di bilanciamento del carico o potrebbe essere lo stesso server XSP|ADP.
Come specificato, il record A/AAAA deve risolversi in un indirizzo IP per gli stessi motivi.
-
-
(Opzionale) In un secondo tempo, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocolli> <xsi> <percorsi> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
-
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
-
Se esistono, il client verrà confrontato con l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
-
Se vengono rilevate eventuali differenze, il client inizializza nuovamente la connettività XSI Actions/ XSI Events. Il primo passo consiste nell'eseguire lo stesso processo di ricerca DNS elencato al punto 1, questa volta richiedendo una ricerca per il valore nel %XSI_ROOT_WXT% parametro dal relativo file di configurazione.
Creare i record delle SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
-
Failover
Durante l'accesso, l'app Webex esegue una ricerca SRV DNS per _xsi-client._tcp, crea un elenco di host e si connette a uno degli host in base alla priorità SRV, quindi peso. Questo ospite connesso diventa il selezionato per tutte le richieste future. Un canale di evento viene quindi aperto all'organizzatore selezionato e un heartbeat viene inviato regolarmente per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP; pertanto, è importante che il servizio di bilanciamento del carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server ADP XSP|di backend.
In caso di errore di una richiesta o di una richiesta heartbeat a un host, si possono verificare diverse operazioni:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), l'instradazione dell'app Webex avanza immediatamente al successivo organizzatore nell'elenco.
-
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e indirizza i progressi all'host successivo nell'elenco.
-
Se non si riceve una risposta entro un determinato periodo di tempo, la richiesta viene considerata non riuscita a causa di un timeout e le successive richieste vengono inviate all'organizzatore successivo. Tuttavia, la richiesta di timeout viene considerata come non riuscita. Si è verificato un tentativo in seguito ad alcune richieste in seguito a un errore (con un aumento del tempo di tentativo). Non si sono effettuate nuovamente richieste che presupponete non vitali.
Quando si prova correttamente un nuovo organizzatore, diventa il nuovo organizzatore selezionato, se è presente nell'elenco. Una volta tentato l'ultimo organizzatore nell'elenco, l'app Webex viene rollover a quella del primo.
In caso di heartbeat, se ci sono due errori di richiesta consecutivi, l'app Webex inizializza nuovamente il canale dell'evento.
Tenere presente che l'app Webex non esegue il fail-back e il rilevamento del servizio DNS viene eseguito una sola volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione tramite l'interfaccia ADP/DMS XSP|. Esegue una ricerca dei record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Si tenterà prima di inviare la richiesta di download del file di configurazione utilizzando un token SSO configurazione. Se questo non riesce, verrà riprovare ma con il nome utente e la password del dispositivo.
Distribuisci Webex per BroadWorks
Panoramica della distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning utente. Molte delle attività sono comuni a tutte le modalità di provisioning.
Onboarding dei partner per Webex per Cisco BroadWorks
Ogni provider di servizi o rivenditore Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, devi eseguire la documentazione Webex Cisco BroadWorks e i nuovi partner devono accettare il Contratto ICPA (Indirect Channel Partner Agreement) online. Al termine di questi passaggi, Cisco Compliance crea una nuova organizzazione partner in Partner Hub (se necessario) e invia un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, l'attivazione del partner e/o il Customer Success Program Manager ti contatteranno per iniziare l'onboarding.
I partner Webex in una regione possono creare organizzazioni di clienti in qualsiasi regione che offriamo i servizi. Per informazioni, vedere: Residenza dati in Webex.
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
L'applicazione NPS deve essere eseguita su un XSP|ADP diverso. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi su XSP|ADP.
Servizio/Applicazione |
Autenticazione richiesta |
Scopo servizio/applicazione |
---|---|---|
Eventi XSI |
TLS (il server si autentica ai client) |
Controllo chiamate, notifiche servizi |
Azioni XSI |
TLS (il server si autentica ai client) |
Controllo chiamata, azioni |
Gestione dispositivi |
TLS (il server si autentica ai client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server si autentica ai client) |
Autenticazione utente |
Integrazione di telefonia tramite computer |
mTLS (client e server si autenticano a vicenda) |
Presenza telefonia |
Applicazione Webview impostazioni chiamata |
TLS (il server si autentica ai client) |
Espone le impostazioni di chiamata utente nel portale auto all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma è necessario fare riferimento alla documentazione esistente per ottenere le applicazioni installate su XSP|ADP.
Requisiti di coresidenza
-
Il servizio di autenticazione deve essere co-residente con le applicazioni Xsi poiché tali interfacce devono accettare token di lunga durata per l'autorizzazione al servizio. Il servizio di autenticazione è necessario per convalidare tali token.
-
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
-
È possibile separare gli altri servizi/applicazioni come richiesto per la propria scala (ad esempio, azienda agricola XSP|ADP di gestione dei dispositivi dedicata).
-
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
-
Non installare altre applicazioni o servizi su XSP|ADP utilizzati per l'integrazione di BroadWorks con Webex.
-
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce XSI
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia Cisco BroadWorks Xtended Services Interface.
È necessario distribuire solo un'istanza delle applicazioni Xsi-Events su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso callControlApplicationName definito in Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> Scarica
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente è inserito in Webex, Webex crea un abbonamento per l'utente sul AS per ricevere gli eventi di telefonia per la cronologia della presenza e delle chiamate. L'abbonamento è associato a callControlApplicationName e il AS lo utilizza per sapere a quali Xsi-Events inviare gli eventi di telefonia.
La modifica del callControlApplicationName o il mancato nome di tutte le app Web Xsi-Events avranno impatto sugli abbonamenti e sulla funzionalità degli eventi di telefonia.
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se si utilizza una versione R22 o successiva e il sistema lo supporta.
La funzionalità TLS reciproca (mTLS) è supportata anche come metodo di autenticazione alternativo per il servizio di autenticazione. Se si dispone di più organizzazioni Webex in esecuzione sullo stesso server XSP|ADP, è necessario utilizzare l'autenticazione mTLS poiché la convalida del token CI non supporta più connessioni allo stesso servizio di autorizzazione XSP|ADP.
Per configurare l'autenticazione mTLS per il servizio di autorizzazione anziché la convalida del token CI, fare riferimento all'Appendice per Configurazione dei servizi (con mTLS per il servizio di autorizzazione).
Se attualmente si utilizza mTLS per il servizio di autorizzazione, non è obbligatorio riconfigurare per utilizzare la convalida del token CI con TLS.
-
Recupero delle credenziali OAuth per Webex per Cisco BroadWorks.
-
Installare le seguenti patch su ciascun server XSP|ADP. Installare le patch appropriate alla versione in uso:
-
Per R22:
-
Per R23:
-
Per R24: nessuna patch richiesta
Qualsiasi riferimento a XSP include XSP o ADP.
-
-
Installare l'applicazione
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP nel percorso context /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> attiva applicazione AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire AuthenticationService su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> distribuisci applicazione /authServiceBroadWorks Distribuzione SW Manager distribuzione /authService...
-
A partire da BroadWorks build 2022.10, le autorità di certificazione che arrivano con Java non vengono più incluse automaticamente nell'archivio attendibilità di BroadWorks quando si passa a una nuova versione di Java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
-
IdenTrust Commercial Root CA 1
-
Autorità di certificazione radice Go Daddy - G2
Verificare che questi certificati siano presenti nella seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> ottieni
Se non è presente, eseguire il seguente comando per importare le entità affidabili Java predefinite:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come trust anchor con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono importate automaticamente nella nuova release e continueranno a essere importate fino a quando non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere FD di convalida del certificato Cisco BroadWorks X509.
-
-
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> ottieni
-
imposta clientId client-Id-From-Step1
-
impostazione abilitata true
-
imposta clientSecret client-Secret-From-Step1
-
imposta ciResponseBodyMaxSizeInBytes 65536
-
imposta issuerName <URL>
: per l'URL
, inserire l'URL IssuerName applicabile al cluster CI. Vedere la tabella seguente. -
set issuerUrl <URL>
: per l'URL
, inserire l'IssuerUrl applicabile al cluster CI. Vedere la tabella seguente. -
set tokenInfoUrl <IdPProxy URL>
: inserire l'URL del proxy IdP applicabile al cluster Teams. Vedere la seconda tabella riportata di seguito.
Tabella 1. Impostare issuerName e issuerURL Se il cluster CI è... Impostare issuerName e issuerURL su... USA
UE
US-B
Se non conosci il tuo Cluster CI, puoi ottenere le informazioni dai dettagli cliente nella vista Help desk di Control Hub.
Tabella 2. Imposta URL info token Se il cluster Teams è... Imposta URL info token su...(URL proxy IdP) acm
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
diaframma
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
aore
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
-
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista Help desk di Control Hub.
-
Per il test, è possibile verificare la validità dell'URL tokenInfo sostituendo la parte "idp/authenticate" dell'URL con "ping".
-
-
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> imposta ambito broadworks-connector:utente
-
Configura i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> ottieni
-
imposta flsUrl https://cifls.webex.com/federation
-
imposta periodo di aggiornamento in minuti 60
-
imposta refreshToken refresh-Token-From-Step1
-
-
Per verificare che la configurazione FLS funzioni, eseguire il comando seguente. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Ottieni
-
Configurare la gestione token utilizzando i seguenti comandi su ciascun server XSP|ADP:
-
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
-
imposta tokenIssuer BroadWorks
-
imposta tokenDurationInOre 720
-
-
Genera e condividi chiavi RSA. È necessario generare le chiavi su un XSP|ADP, quindi copiarle in tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
-
Devi utilizzare le stesse coppie di chiavi pubblica/privata per la crittografia/decrittografia del token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene prima richiesto di emettere un token.
Se si spostano i tasti in sequenza o si modifica la lunghezza della chiave, è necessario ripetere la seguente configurazione e riavviare tutti gli XSP|ADP.
-
Selezionare un XSP|ADP da utilizzare per la generazione di una coppia di chiavi.
-
Utilizzare un client per richiedere un token crittografato a tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(viene generata una coppia di chiavi privata/pubblica su XSP|ADP, se non ne era già presente una)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
esportaKeys
-
Copiare il file esportato
/var/broadworks/tmp/authService.keys
nella stessa posizione sugli altri XSP|ADP, sovrascrivendo un file.keys
precedente, se necessario. -
Importa le chiavi su ciascuno degli altri XSP|ADP:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
-
-
Fornire l'URL di authService al container Web. Il contenitore Web di XSP|ADP necessita dell'URL authService in modo da poter convalidare i token. Su ciascuno degli XSP|ADP:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
imposta URL http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> aggiungi tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Verificare il parametro con
get
. -
Riavviare XSP|ADP.
-
Rimuovi il requisito di autenticazione client per il servizio di autorizzazione (solo R24)
Se il servizio di autenticazione è configurato con la convalida del token CI su R24, è necessario anche rimuovere il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> imposta <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Authentication Service, Xsi-Actions e Xsi-Events utilizzano le interfacce del server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > Interfaccia server HTTP = Più specifica
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il comando
get
e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ogni interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> ottieni
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Inserire il comando
get <interfaceIp> 443
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserisci il comando
aggiungi <interfaceIp> 443 TLSv1.2
per assicurarti che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione di crittografia TLS sull'interfaccia del server HTTP
Per configurare le crittografie richieste:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Inserire il comando
get <interfaceIp> 443
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview). -
Inserire il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.L'XSP|ADP CLI richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizza:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>aggiungi 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base al nome.
Configura gestione dispositivi su XSP|ADP, server applicazioni e server di profilo
Il server di profilo e XSP|ADP sono obbligatori per la gestione dei dispositivi. Devono essere configurati in base alle istruzioni nella Guida alla configurazione di gestione dispositivi BroadWorks.
Interfaccia CTI e configurazione correlata
L'ordine di configurazione "da inmost a outmost" è elencato di seguito. Seguire questo ordine non è obbligatorio.
-
Configurazione del server applicazioni per abbonamenti CTI
-
Configurazione di XSP|ADP per abbonamenti CTI con autenticazione mTLS
-
Porte aperte in ingresso per interfaccia CTI sicura
-
Abbonamento alla tua organizzazione Webex a eventi CTI BroadWorks
Configurazione del server applicazioni per abbonamenti CTI
Aggiornare ClientIdentity sul server applicazioni con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ogni server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> aggiungi bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è bwcticlient.webex.com.
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifica
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità |
Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) |
XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocols> |
Un'interfaccia CTI specifica su questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocols> |
In una nuova installazione, le seguenti crittografie vengono installate per impostazione predefinita a livello di sistema. Se non viene configurato alcun elemento a livello di interfaccia (ad esempio, l'interfaccia CTI o l'interfaccia HTTP), viene applicato questo elenco di crittografie. Tenere presente che questo elenco può cambiare nel tempo:
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
tls_ecdhe_ecdsa_with_aes_128_gcm_sha256
-
tls_ecdhe_rsa_with_aes_128_cbc_sha256
-
tls_ecdhe_ecdsa_with_aes_128_cbc_sha256
-
tls_dhe_dss_with_aes_128_gcm_sha256
-
tls_dhe_rsa_with_aes_128_gcm_sha256
-
tls_dhe_rsa_with_aes_128_cbc_sha256
-
tls_dhe_dss_with_aes_128_cbc_sha256
-
tls_ecdh_rsa_with_aes_128_gcm_sha256
-
tls_ecdh_ecdsa_with_aes_128_gcm_sha256
-
tls_ecdh_rsa_with_aes_128_cbc_sha256
-
tls_ecdh_ecdsa_with_aes_128_cbc_sha256
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserire il comando
get
e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> Ottieni interfaccia porta IP Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
-
Inserire il comando
get <interfaceIp>
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserire il comando
aggiungi <interfaceIp> TLSv1.2
per assicurarsi che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione di crittografia TLS sull'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
-
Immettere il comando
get
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview). -
Inserire il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.L'XSP|ADP CLI richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, è necessario utilizzare:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> aggiungi 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base al nome.
Trust Anchor per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che gli XSP|ADP siano rivolti verso Internet o rivolti verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy di bridge (vedere Requisiti del certificato TLS per il proxy bridge TLS).
Per ogni XSP|ADP nell'infrastruttura che sta pubblicando eventi CTI in Webex, effettuare le seguenti operazioni:
-
Accedi a Partner Hub.
-
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain .txt
sul computer locale.Questi file contengono due set di due certificati. Devi suddividere i file prima di caricarli negli XSP|ADP. Tutti i file sono obbligatori.
-
Suddividere la catena di certificati in due certificati: combinedcertchain .txt
-
Aprire combinedcertchain .txt in un editor di testo.
-
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file. -
Salvare il nuovo file come root .txt.
-
Salvare il file originale come emissione di .txt. Il file originale ora deve disporre di un solo blocco di testo, circondato dalle righe
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copia entrambi i file di testo in una posizione temporanea su XSP|ADP che stai proteggendo, ad esempio,
/var/broadworks/tmp/root .txt
e/var/broadworks/tmp/issuing .txt
-
Accedere a XSP|ADP e passare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
-
(Opzionale) Eseguire
help updateTrust
per visualizzare i parametri e il formato del comando. -
Carica i file dei certificati sui nuovi trust anchor - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot /var/broadworks/tmp/root .txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing /var/broadworks/tmp/issuing .txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
ewebexclientissuing
sono alias di esempio per i trust anchor; puoi utilizzare i tuoi alias purché tutte le voci siano univoche. -
Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> ottieni
Alias Proprietario emittente ============================================================================= webexclientissuing Internal Private TLS SubCA Internal Private Root webexclientroot Internal Private Root[self-signed]
-
Consenti ai client di eseguire l'autenticazione con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> imposta allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
-
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione di BroadWorks. Il comando crea un certificato del server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> aggiungi <Interface IP> 8012 true true true
-
-
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. A tale scopo, è necessario l'indirizzo IP dell'interfaccia CTI; è possibile leggerlo nel seguente contesto:
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> ottieni
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la propria chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interfaccia IP> file chiave</path/to/file chiave certificato> certificatoFile </path/to/certificato server> chainFile</path/to/chain file>
-
-
Riavviare XSP|ADP.
Abilitazione dell'accesso a eventi CTI BroadWorks su Webex
Devi aggiungere e convalidare l'interfaccia CTI quando configuri i cluster in Partner Hub. Vedi Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
Devi aggiungere e convalidare l'interfaccia CTI quando configuri i cluster in Partner Hub. Vedi Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
-
Specifica l'indirizzo CTI in base al quale Webex può abbonarsi agli eventi CTI BroadWorks.
-
Gli abbonamenti CTI si basano su abbonamento singolo e vengono stabiliti e mantenuti solo mentre tale abbonato viene predisposto per Webex per Cisco BroadWorks.
Impostazioni chiamata vista Web
CSWV (Call Settings Webview) è un'applicazione ospitata su XSP|ADP che consente agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview impostazioni chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono nativi dell'app Webex.
Se desideri che gli abbonati a Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre ai valori predefiniti disponibili nell'app Webex, devi distribuire la funzione Impostazioni chiamata Webview.
La vista Web Impostazioni chiamata dispone di due componenti:
-
Applicazione Webview impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
-
L'app Webex, che esegue il rendering delle impostazioni di chiamata in una vista Web.
Esperienza utente
-
Utenti Windows: Fai clic su Impostazioni chiamata, quindi fai clic su .
-
Utenti Mac: Fare clic sull'immagine del profilo, quindi su
.
Distribuzione di CSWV su BroadWorks
Installazione della vista Web impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso XSP|ADP che ospita l'interfaccia Azioni Xsi nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
-
Accedere a cisco.com e ricercare "BWCallSettingsWeb" nella sezione di download del software.
-
Trova e scarica la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) era il più recente al momento della scrittura. -
Installare, attivare e distribuire l'archivio Web in base alla guida alla configurazione della piattaforma di servizio Cisco BroadWorks Xtended per la versione XSP|ADP. (Versione R24 è https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
-
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
. -
Selezionare il seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> installa applicazione /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
-
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più richiesto). -
Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> attiva applicazione BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario anche fornire un ContextPath poiché si tratta di un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio,
/callsettings
. -
Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> distribuisci applicazione /callsettings
-
-
Ora è possibile prevedere l'URL delle impostazioni di chiamata che verrà specificato per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
-
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
-
XSP|ADP-FQDN deve corrispondere all'FQDN azioni Xsi, poiché CSWV deve utilizzare azioni Xsi e CORS non è supportato.
-
-
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview impostazioni chiamata ora è attiva su XSP|ADP.
Configura l'app Webex per utilizzare la vista Webview impostazioni chiamata
Per ulteriori informazioni sulla configurazione del client, vedere Guida alla configurazione di Webex per Cisco BroadWorks.
È presente un tag personalizzato nel file di configurazione dell'app Webex che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti tramite l'interfaccia dell'applicazione.
<config> <servizi> <web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%"> <url>%WEB_CALL_SETTINGS_URL_WXT%</url> </web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel tag %WEB_CALL_SETTINGS_URL_WXT%.
Se non specifichi esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
-
Assicurati di disporre degli ultimi modelli di configurazione per l'app Webex (vedi Profili dispositivo).
-
Impostare la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
-
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente in uso, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.esempio.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
-
Il file di configurazione del client risultante deve contenere una voce nel seguente modo:
<web-call-settings target="csw"> <url>https://yourxsp.esempio.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Server push notifiche chiamate (CNPS) per descrivere un'applicazione ospitata XSP o ADP eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in ingresso ai tuoi utenti e invia le notifiche ai servizi di notifica di Google Firebase Cloud Messaging (FCM) o Apple Push Notification service (APN).
Tali servizi notificano ai dispositivi mobili di Webex per gli abbonati Cisco BroadWorks che hanno chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere Descrizione della funzione del server push delle notifiche.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per inviare le notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi notificano a loro volta agli utenti mobili Webex i messaggi in arrivo o le modifiche alla presenza.
In questa sezione viene descritto come configurare NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se devi eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedi Aggiornamento dell'NPS Cisco BroadWorks per l'uso del proxy NPS https://help.webex.com/nl5rir2/.
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario applicare le patch al CNPS per supportare la funzione proxy NPS, Server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server push di notifica per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private del certificato di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e le chiavi di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend Cisco BroadWorks e utilizza questo token per l'autenticazione con i servizi Apple APN e Google FCM.
La funzione migliora anche la funzionalità del server push notifiche di push delle notifiche ai dispositivi Android tramite la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
-
Per ulteriori informazioni, vedere Descrizione della funzione Server push per VoIP in UCaaS.
-
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software NPS e le patch, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Ricercare e scaricare la patch dalla pagina di download del software.
-
Ulteriori informazioni sul server ADP sono disponibili all'indirizzo https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni su APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio di notifica push di Apple dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per gli APN. Questo aggiornamento richiede che XSP|ADP che ospita NPS sia in esecuzione R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 |
Installare e configurare un XSP dedicato (versione minima R22) o Application Delivery Platform (ADP). |
2 |
Installare le patch del proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: |
3 |
Attivare l'applicazione del server push di notifica. |
4 |
(Per le notifiche Android) Abilitare l'API FCM v1 su NPS.
|
5 |
(Per le notifiche Apple iOS) Abilita HTTP/2 su NPS.
Questa opzione è esclusiva della release 22 e delle versioni precedenti; non è disponibile nella release 23 e nelle versioni precedenti che supportano solo HTTP/2. |
6 |
Collegare un supporto tecnico da XSP/ADP NPS. |
7 |
Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa 149.vle.broadsoft.com qa 149.vle.broadsoft.com IN UN 10.193.78.149 Una volta impostato, è necessario uno dei seguenti elementi per rispondere alle modifiche:
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configurazione di NPS per l'uso del proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Esegui migrazione da NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un NPS condiviso con altre app mobili, vedere Aggiornamento dell'NPS Cisco BroadWorks per l'uso del proxy NPS ( https://help.webex.com/nl5rir2).
1 |
Recupero delle credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 |
Creare l'account client su NPS:
Per verificare che i valori immessi corrispondano a quanto specificato, eseguire L'Url emittente CiscoCI deve essere SEMPRE il cluster CI USA, indipendentemente dalla posizione e il valore predefinito deve essere:
| |||||||||||||||||||
3 |
Immettere l'URL del proxy NPS e impostare l'intervallo di aggiornamento del token (si consiglia 30 minuti):
| |||||||||||||||||||
4 |
(Per notifiche Android) Aggiungere l'ID dell'applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 |
(Per le notifiche Apple iOS) Aggiungere l'ID dell'applicazione al contesto delle applicazioni APNS assicurandosi di omettere la chiave di autorizzazione, impostarla su vuota.
| |||||||||||||||||||
6 |
Configura i seguenti URL NPS:
| |||||||||||||||||||
7 |
Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 |
Verificare che il server applicazioni stia eseguendo lo screening degli ID delle applicazioni poiché potrebbe essere necessario aggiungere le app Webex all'elenco degli utenti autorizzati: | |||||||||||||||||||
9 |
Riavviare XSP|ADP: | |||||||||||||||||||
10 |
Prova le notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migra NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente per la migrazione a FCMv1. Le procedure sono tre:
Esegui migrazione dei client UC-One a FCMv1
Utilizza la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella Console FCM, vedi
. L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile di connessione all'indirizzo https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al parametro gcm_defaultSenderId
, che si trova nel kit di branding, nella cartella Risorse e nel file branding.xml con la sintassi seguente:
<string name="gcm_defaultSenderId">xxxxxxxxxxxxx</string>
-
Accedere a FCM Admin SDK all'indirizzo http://console.firebase.google.com.
-
Selezionare l'applicazione Android appropriata.
-
Nella scheda Generale, registrare l'ID del progetto
-
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurare un account esistente.
Per creare un nuovo account servizio:
-
Fare clic sul pulsante blu per creare un nuovo account servizio
-
Fai clic sul pulsante blu per generare una nuova chiave privata
-
Scarica chiave in una posizione sicura
Per riutilizzare un account servizio esistente:
-
Fare clic sul testo blu per visualizzare gli account servizio esistenti.
-
Identificare l'account servizio da utilizzare. L'account servizio richiede l'autorizzazione firebaseadmin-sdk.
-
A destra, fare clic sul menu dell'hamburger e creare una nuova chiave privata.
-
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
-
-
Copia il file json su XSP|ADP.
-
Configura l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> aggiungi <id progetto> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> ottieni Project ID Accountkey ======================== mio_progetto ********
-
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> aggiungi <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> ottieni ID applicazione Progetto ID ============================== my_app my_project
-
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Abilitato true ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP.
Esegui migrazione dei client SaaS a FCMv1
Utilizzare la procedura seguente su Google FCM Console se si desidera eseguire la migrazione dei client SaaS a FCMv1.
Accertarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione".
-
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Enabled false ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP. -
Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Abilitato true ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP.
Aggiorna server ADP
Utilizzare la procedura seguente in Google FCM Console se si sta eseguendo la migrazione di NPS per utilizzare un server ADP.
-
Ottenere il file JSON dalla console cloud di Google:
-
Nella console Google Cloud, andare alla pagina Account servizio.
-
Fai clic su Seleziona un progetto, scegli il progetto e fai clic su Apri.
-
Individuare la riga dell'account servizio per il quale si desidera creare una chiave, fare clic sul pulsante verticale Altro, quindi fare clic su Crea chiave.
-
Seleziona un tipo di chiave e fai clic su Crea
Il file viene scaricato.
-
-
Aggiungere FCM al server ADP:
-
Importare il file JSON nel server ADP utilizzando il comando
/bw/install
. -
Accedi a ADP CLI e aggiungi il progetto e la chiave API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> aggiungi connect /bw/install/google JSON
: -
Quindi, aggiungere l'Applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Chiudi
-
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ================================== com.broadsoft.ucaas.connect connect-ucaas
-
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò viene effettuato per i seguenti motivi:
-
Per consentire al cloud Webex di autenticare gli utenti in base a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
-
Di consentire alle app Webex di utilizzare l'Interfaccia XSI per il controllo delle chiamate.
-
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se una delle interfacce non viene convalidata correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide.
Questo problema viene impedito poiché un cluster configurato in modo errato può provocare problemi che sono difficili da risolvere.
Cosa è necessario fare:
-
Accedere a Partner Hub (admin.webex.com) con le credenziali di amministratore partner.
-
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni BroadWorks Calling.
Se l'utente amministratore non dispone della visibilità delle impostazioni BroadWorks Calling, si consiglia di aprire un caso con Cisco TAC.
-
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
-
Assegnare un nome a questo cluster e fare clic su Avanti.
Il concetto di cluster in questo caso è semplicemente un insieme di interfacce, solitamente raggruppate su un server o un farm XSP|ADP, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il tuo sistema BroadWorks non rientrano nell'ambito qui.
-
(Opzionale) Inserisci un Nome account e una Password utente BroadWorks all'interno del sistema BroadWorks che stai connettendo a Webex, quindi fai clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
-
Aggiungi gli URL Azioni XSI e Eventi XSI.
-
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
-
Opzionale. Seleziona la casella di controllo Abilita autenticazione diretta BroadWorks se desideri che gli accessi a BroadWorks siano diretti a BroadWorks. Altrimenti, l'autenticazione a BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo incide sulle seguenti situazioni di accesso:
-
Accesso al portale di attivazione utente: gli utenti devono inserire le proprie credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o tramite il proxy IdP.
-
Accesso client: se Autenticazione BroadWorks è configurata nel modello Onboarding, l'impostazione precedente determina se l'accesso client all'app Webex è diretto a BroadWorks o è proxy tramite il proxy IdP.
-
-
Fai clic su Avanti.
-
Nella pagina Interfaccia CTI, effettuare le seguenti operazioni:
-
Aggiungere l'URL CTI e la Porta per l'interfaccia CTI a cui si desidera connettersi.
-
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia delle chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
-
Opzionale. Abilita il tasto di alternanza di sincronizzazione Non disturbare (DND) e inserisci il tuo ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurando che la funzione funzioni allo stesso modo su entrambe le piattaforme.
-
Opzionale. Abilita il tasto di alternanza Sincronizzazione stato assistente personale e inserisci il tuo ID utente BroadWorks. Questa opzione sincronizza lo stato di presenza dell'assistente personale tra i dispositivi BroadWorks Calling e l'app Webex.
-
Fai clic su Avanti.
-
-
Aggiungere l'URL del servizio di autenticazione.
-
Selezionare Servizio di autorizzazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex, poiché il servizio di autenticazione convalida correttamente il token utente in base al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
-
Esamina le voci nella schermata finale, quindi fai clic su Crea. Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Partner Hub passa gli URL a vari microservizi Webex che verificano le connessioni alle interfacce fornite.
-
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e specificare se la convalida è stata completata correttamente.
-
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Questo controllo è stato implementato per evitare errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, servizio di bilanciamento del carico o firewall) come documentato in questa guida, prima di salvare il modello.
Controllo delle connessioni alle interfacce BroadWorks
-
Accedere a Partner Hub (admin.webex.com) con le credenziali di amministratore partner.
-
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni BroadWorks Calling.
-
Fai clic su Visualizza cluster.
-
Partner Hub avvia test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, nella pagina di elenco dei cluster viene visualizzato il messaggio di stato accanto a ciascun cluster.
Dovrebbero essere visualizzati messaggi verdi di operazione riuscita. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
-
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio azioni XSI, eventi XSI, URL DAS e impostazioni dell'interfaccia CTI.
Configura i tuoi modelli di onboarding
I modelli di onboarding sono il modo in cui applicherai la configurazione condivisa a uno o più clienti durante l'onboarding tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma è possibile associare un solo modello a un cliente.
-
Accedi a Partner Hub e seleziona Clienti.
-
Fai clic sul pulsante Modelli di onboarding per visualizzare i modelli esistenti.
-
Fare clic su Crea modello.
-
Nella finestra Dettagli modello, aggiungere il nome del modello, il paese o la regione e la lingua e-mail predefinita.
-
Fare clic sull'elenco a discesa per l'ID abbonamento CCW, individuare gli abbonamenti elencati per il partner e selezionare l'abbonamento applicabile.
Questo campo è visualizzato solo per i partner migrati da Webex per BroadWorks a Webex.
-
Nella finestra Impostazione servizio, utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
-
Inserisci un Nome modello, quindi fai clic su Avanti.
-
Configurare la modalità di provisioning utilizzando queste impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per le diverse modalità di provisioning Nome impostazione
Provisioning a flusso costante con e-mail attendibili
Provisioning a flusso costante senza e-mail
Provisioning automatico utente
Abilita il flusso BroadWorks attraverso il provisioning (includi le credenziali dell'account di provisioning se Attivato**)
Attivato
Fornire Nome account e Password di provisioning in base alla configurazione BroadWorks.
Attivato
Fornire Nome account e Password di provisioning in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il
Il
Il
Indirizzo e-mail provider servizi
Seleziona un indirizzo e-mail dall'elenco a discesa (puoi digitare alcuni caratteri, per trovare l'indirizzo se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso di amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello di onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto associa le organizzazioni dei clienti create con questo modello a una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedi le mappature paese-regione in questo foglio di calcolo.
Il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni, fai riferimento alla sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questa opzione disattivata.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note della tabella:
-
† Questo switch assicura che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa operazione deve essere sempre attiva, a meno che non si stia utilizzando un processo di ordinazione ed esecuzione manuale (tramite Cisco Commerce Workspace) per creare organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello "Provisioning ibrido" ed è fuori dall'ambito di questo documento.
-
** "Account di provisioning" si riferisce all'account amministratore a livello di sistema BroadWorks. In BroadWorks, hai bisogno di un account amministratore con questi attributi: Tipo di amministratore = Provisioning, Sola lettura = Disattivato.
-
-
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
-
Opzionale. Seleziona Disabilita chiamata gratuita Cisco Webex se desideri disabilitare le chiamate Webex.
-
Per Configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
-
Numeri di chiamata in ingresso Cisco (PSTN)
-
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
-
-
Fai clic su Avanti.
-
Esistono due approcci per il provisioning degli abbonati per quanto riguarda il modo in cui vengono verificate le loro identità: utilizzando messaggi e-mail attendibili o messaggi e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. L'utente in qualità di partner è responsabile del provisioning dell'indirizzo e-mail come parte del metodo di flusso attraverso o API.
Si consiglia vivamente di utilizzare il metodo di provisioning affidabile perché assicura che tutti gli abbonati siano forniti completamente da parte dell'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso di e-mail non attendibile gli utenti devono verificare l'e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome impostazione
Provisioning a flusso costante senza e-mail
Provisioning automatico utente
Esegui prima provisioning amministratori
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
-
Note della tabella:
-
* A ciascuna organizzazione cliente in Webex deve essere assegnato almeno un utente con ruolo di amministratore. Il primo utente a cui viene assegnato l'IM&P integrato in BroadWorks assume il ruolo di amministratore cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di provider di servizi, è possibile avere il controllo su chi ottiene il ruolo. Selezionando questa impostazione, gli utenti non possono completare l'attivazione fino a quando non viene attivato il primo utente predisposto. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
-
-
Fai clic su Avanti.
-
Seleziona la modalità di autenticazione predefinita (Autenticazione BroadWorks o Autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla modalità di configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con il centro TAC di Cisco.
Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente.
-
Fai clic su Avanti.
-
Per Preferenze, configurare quanto segue:
-
Scegliere se si desidera precompilare gli indirizzi e-mail utente nella pagina di accesso.
Devi utilizzare questa opzione solo se hai selezionato Autenticazione BroadWorks e hai anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. Altrimenti, dovranno utilizzare il proprio nome utente BroadWorks. La pagina di accesso offre un'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
-
Se desideri abilitare la sincronizzazione delle rubriche, imposta l'opzione Abilita sincronizzazione rubriche telefoniche per tutte le nuove organizzazioni cliente su On.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente, in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
-
Inserire un Amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatizzato di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
-
Assicurati che l'opzione Consenti inviti e-mail amministratore al momento del collegamento a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
-
Fai clic su Avanti.
-
Rivedere le voci nella schermata finale. Puoi fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare eventuali dettagli. Fare clic su Crea.
Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con qualsiasi altro modello.
-
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario inserire nuovamente i dettagli dell'account di provisioning. I campi password/password di conferma vuoti sono disponibili per modificare le credenziali, ma lasciarle vuote per mantenere i valori forniti alla procedura guidata.
Aggiungere altri modelli se si dispone di configurazioni condivise diverse che si desidera fornire ai clienti.
Mantenere aperta la pagina Visualizza modelli poiché potrebbero essere necessari i dettagli del modello per una seguente attività.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning.
Patch Application Server (solo R22, R23 e R24)
-
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
-
Per R22:
AP.as.22.0.1123.ap373197
-
Per R23:
AP.as.23.0.1075.ap373197
-
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che costituiscono i requisiti per la distribuzione di Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.
-
-
Passare al contesto
Opzioni di manutenzione/contenitore
. -
Abilitare il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> aggiungi provisioning bw.imp.useProvisioningUrl true
Ottieni URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per dettagli (Interfaccia > Messaggistica e servizio > IM&P integrato) dei comandi AS.
-
Accedi a Partner Hub e vai a
. -
Fare clic su Visualizza modelli.
-
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro a scomparsa a destra. Se non è stato ancora creato un modello, è necessario effettuare questa operazione per ottenere l'URL di provisioning.
-
Copiare l'URL adattatore di provisioning.
Ripetere questa operazione per altri modelli se sono presenti più modelli.
(Opzione) Configurazione di parametri di provisioning a livello di sistema sul server applicazioni
Se si utilizza UC-One SaaS, è possibile non impostare il provisioning a livello di sistema e il dominio di servizio. Vedere Punti decisionali nella sezione Preparazione dell'ambiente.
-
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
-
AS_CLI/Interface/Messaging> imposta URL provisioning URL provisioning
-
AS_CLI/Interface/Messaging> imposta provisioningUserId provisioning_account_name
-
AS_CLI/Interface/Messaging> imposta password provisioning provisioning_account_password
-
AS_CLI/Interface/Messaging> imposta abilitaSincronizzazione true
-
-
Attivare l'interfaccia IMP integrata:
-
/AS_CLI/Service/IntegratedIMP> imposta serviceDomain esempio.com
-
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> imposta userAttrIsActive true
-
Devi inserire il nome completo per il parametro URL provisioning
, come è stato assegnato in Control Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel file /etc/hosts
sul server applicazioni.
(Opzione) Configurazione dei parametri di provisioning per azienda sul server applicazioni
-
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
-
Selezionare Usa dominio servizio e immettere un valore fittizio (Webex ignora questo parametro). Puoi utilizzare
example.com
). -
Selezionare Usa server di messaggistica.
-
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
Devi inserire il nome completo per il parametro
URL provisioning
, come è stato assegnato in Partner Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel file/etc/hosts
sul server applicazioni. -
Nel campo Nome utente, inserire un nome per l'amministratore di provisioning. Questa operazione deve corrispondere al valore riportato nel modello in Partner Hub.
-
Immettere una password per l'amministratore di provisioning. Questa operazione deve corrispondere al valore riportato nel modello in Partner Hub.
-
Per Identità utente predefinita per ID IM&P, selezionare Principale.
-
Fare clic su Applica.
-
Ripetere questa operazione per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning degli utenti, vedere Provisioning degli utenti del provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning consente agli amministratori e ai team di vendita di verificare gli errori prima di eseguire il provisioning di un pacchetto a un cliente o un abbonato. Gli utenti o le integrazioni autorizzate da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per garantire che non vi siano conflitti o errori con il provisioning del pacchetto per un determinato cliente o abbonato.
L'API controlla se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto per un cliente o un partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, puoi correggere tali errori prima del provisioning, aumentando la probabilità di un provisioning corretto.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore di Webex per la Vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare il provisioning di un abbonato Wholesale
Per accedere a Verifica preliminare di un documento di provisioning Wholesale Subscriber, è necessario accedere a https://developer.webex.com/ portal.
SSO partner - SAML
Consente agli amministratori partner di configurare la funzionalità SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura SSO del partner seguente si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere il Single Sign-On (SSO) partner a un'organizzazione esistente del cliente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso.
-
Verifica che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'Integrazione Single Sign-On in Control Hub.
-
Carica il file di metadati CI con provider identità.
-
Configura un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, inserire l'EntityID dall'XML dei metadati SAML del provider di identità di terze parti.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizzi il modello.
-
Molto che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori partner di configurare la funzionalità SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per l'impostazione dell'OIDC SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già presenti utilizzando il modello.
-
Aprire una richiesta di assistenza con il centro TAC di Cisco con i dettagli dell'IDP OpenID Connect. Di seguito sono riportati attributi IDP obbligatori e opzionali. Il centro TAC deve impostare l'IDP sul CI e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC potrebbe essere costituito da lettere, numeri, trattini, sottolineature, inclinazioni e punti; la lunghezza massima è 128 caratteri.
ID client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Chiave privata client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco di ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio; ad esempio, 'profilo e-mail openid' Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non è fornito
URL dell'endpoint di autorizzazione OAuth 2.0 di IdP.
Endpoint token
Sì se discoveryEndpoint non è fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
Endpoint infoUtente
No
URL dell'endpoint Info utente dell'IdP.
Endpoint set di tasti
No
URL dell'endpoint di set di chiavi Web JSON dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
-
Configurare l'URI di reindirizzamento sull'IDP connect OpenID.
-
Configura un modello di onboarding. Per l'impostazione della modalità di autenticazione, seleziona Autenticazione partner Con OpenID Connect e inserisci il nome IDP fornito durante l'impostazione dell'IDP come ID entità IDP OpenID Connect.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizzi il modello.
-
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo di correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'Identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui Registrazione chiamata, Risposta per assente di gruppo, Dirigente e Dirigente-Assistente.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
-
Eseguire i seguenti comandi sulle interfacce AS. In questo modo, il AS potrà inviare l'intestazione SIP X-BroadWorks-Correlation-Info:
AS_CLI/Interface/SIP> imposta sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> imposta sendCallCorrelationIDAccess true
-
Il/la enableID correlazione chiamataparametro associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione di informazioni di correlazione delle chiamate nei registri Xsi-Actions. Si consiglia di abilitare
enableCallCorrelationID
utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>imposta enableCallCorrelationID true
Per ulteriori informazioni sull'identificatore di correlazione chiamata, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione delle rubriche assicura che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la rubrica di chiamata completa dal server BroadWorks viene sincronizzata con la rubrica Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione delle rubriche, vai a Sincronizzazione rubrica in Webex per Cisco BroadWorks.
Il provisioning a flusso costante di Webex per Cisco BroadWorks aggiunge gli utenti di messaggistica e le informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, elenchi di telefoni, utenti non di messaggistica e entità non utente non sono inclusi (ad esempio, un telefono per sala conferenze, un fax o un numero di gruppo di ricerca). L'attivazione della sincronizzazione delle rubriche assicura che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex.
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia delle chiamate e delle riunioni Webex Unified visualizzata nell'app Webex. Gli utenti possono visualizzare la propria cronologia dettagliata delle chiamate e della cronologia delle riunioni dall'app Webex.
La cronologia delle chiamate unificate può essere abilitata dagli amministratori a livello di partner in Partner Hub cluster per cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata nel cloud Webex:
-
Eventi della cronologia delle chiamate: questi eventi vengono utilizzati per creare una cronologia delle chiamate unificata dettagliata
-
Eventi di stato ricevitore: la cronologia delle chiamate unificate include le ottimizzazioni dello stato dell'aggancio che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di presenza di telefonia
Requisiti cronologia chiamate Unified
Prima di configurare la cronologia chiamate unificata, verificare di aver applicato le patch al sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
Per R23:
-
Se si utilizza XSP—AP.xsp.23.0.1075.ap378585
-
In caso di uso di ADP—
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
Per l'elenco completo delle patch BroadWorks che occorre installare come prerequisito per eseguire Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.
Oltre alle patch del sistema, il file di configurazione del client (config-wxt.xml
) deve avere il seguente tag impostato: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altre informazioni di reindirizzamento nella cronologia chiamate Unified, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
-
AP.as.23.0.1075.ap383346
-
AP.as.23.0.1075.ap383994
Per R24:
-
AP.as.24.0.944.ap383346
-
AP.as.24.0.944.ap383994
Per disporre delle informazioni su dirigente-assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
-
AP.as.24.0.944.ap380052
-
AP.as.24.0.944.ap384239
-
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare la sincronizzazione delle rubriche anche per la cronologia delle chiamate unificata per dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione DND, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti sotto il cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione BroadWorks durante la stessa finestra di manutenzione.
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedi la procedura per l'aggiunta di un cluster in Configurazione dell'organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettua le seguenti operazioni:
-
Accedi a Partner Hub all'indirizzo admin.webex.com.
-
Vai a Impostazioni e seleziona un cluster esistente.
-
Verificare che la connessione del cluster sia buona. Nel pannello destro dovrebbe essere visualizzato un segno di spunta verde con Connessione stabilita.
Se non viene visualizzato, in Controlla connessioni (opzionale), inserisci ID utente BroadWorks e Password BroadWorks e fai clic su Verifica per verificare che la connessione sia buona.
-
Selezionare la casella di controllo Abilita cronologia chiamate.
-
Fai clic su Salva.
Interazioni funzioni
Le seguenti interazioni con le funzioni esistono per la cronologia chiamate unificata:
-
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando esiste questa situazione, gli eventi Cronologia chiamate e Stato ricevitore non vengono inviati all'app Webex.
-
La cronologia chiamate unificata non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata a interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia delle chiamate unificate dall'app Webex. Per informazioni dettagliate, vedere: Webex | Visualizzazione della cronologia chiamate e riunioni.
Disabilita cronologia chiamate Unified
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione per proprio conto. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visiva
L'app Webex supporta un'indicazione visiva delle chiamate di spam nell'avviso popup di chiamata quando la chiamata viene presentata alla persona chiamata e nei record della cronologia chiamate unificata quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per disporre di questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- È necessario installare e attivare le seguenti patch:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o almeno AS-25_Rel_2022.12
- La funzione deve essere attivata tramite la CLI AS:
- AS_CLI/System/ActivatableFeature> attiva 104112
- AS_CLI/System/StirShaken> imposta enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'assegnazione di tag e la verifica STIR-SHAKEN come descritto in Tag e verifica di firma STIR-SHAKEN di Cisco BroadWorks
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste INVITE inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione visiva di spam nella presentazione della chiamata e nella cronologia chiamate unificata della persona chiamata.
Sincronizzazione stato assistente personale
La funzione di sincronizzazione stato dell'assistente personale (PA) sincronizza lo stato di presenza dell'assistente personale tra i dispositivi BroadWorks Calling e Webex App.
Il servizio PA fornisce all'utente un'opzione per informare i chiamanti del motivo per cui la parte chiamata non è disponibile, fornendo opzionalmente informazioni su quando la parte chiamata ritorna e se è presente un operatore per gestire la chiamata. La funzione PA consente agli utenti nelle app Webex di visualizzare la presenza dell'utente insieme allo stato PA e alla durata configurati.
Prerequisiti
Accertarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione di BroadWorks.
Patch per RI e versione 24:
-
AP.as.24.0.944.ap385558
La funzione di sincronizzazione dello stato dell'assistente personale introduce un nuovo pacchetto di eventi PersonalAssistantSync per consentire ai client XSI di sincronizzare con le modifiche alla presenza dell'assistente personale Cisco BroadWorks. Per ulteriori informazioni, vedere Pacchetto eventi XSI per la funzione di sincronizzazione dello stato dell'assistente personale.
Oltre alle patch del sistema, il file di configurazione del client ({0}config-wxt.xml{1}) deve avere il seguente tag impostato: <personal-assistant abilitato="%PERSONAL_ASSISTANT_ENABLED_WXT%"/>
Abilita sincronizzazione stato assistente personale (nuovo cluster)
Per abilitare la sincronizzazione dello stato dell'assistente personale su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configurazione dell'organizzazione partner in Partner Hub.
Abilita sincronizzazione stato assistente personale (cluster esistente)
-
Accedere a Partner Hub con le credenziali di amministratore partner all'indirizzo https://admin.webex.com.
-
Fai clic su Impostazioni organizzazione.
-
Fai clic su Visualizza cluster e seleziona il cluster BroadWorks appropriato.
- Nella sezione Interfaccia CTI, abilitare il tasto di alternanza Sincronizzazione stato assistente personale.
-
Inserisci il tuo ID utente BroadWorks e fai clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione PA. Se la convalida non riesce, il pulsante Salva viene disabilitato.
-
Se la convalida ha esito positivo, fai clic su Salva.
L'abilitazione della sincronizzazione dello stato PA è un interruttore a una via. Una volta abilitata la funzione, non puoi disabilitarla da solo.
Disabilita sincronizzazione stato assistente personale
Una volta abilitato lo stato di sincronizzazione PA su uno dei cluster BroadWorks, non puoi disabilitare la funzione da solo. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenterà di identificare chi è il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra in chiamata e al termine della chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante associando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se vengono trovate più istanze di un numero in un'origine, non tenterà di sceglierne una; in questo caso, non verrà visualizzato alcun ID chiamante.
-
Webex Common Identity (CI) contenente gli utenti dell'organizzazione.
-
Contatti personali e organizzazione. I contatti personali sono visibili sotto la scheda Contatti.
-
rubrica locale. In Windows - applicazione Outlook, in Mac - contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non è stata trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, verrà utilizzata come ultima istanza la parte del nome utente dell'URI SIP dell'intestazione SIP From.
Per il controllo remoto delle chiamate (ad esempio, modalità di controllo telefono fisso) vengono utilizzate le informazioni XSI, dove viene utilizzato l'ID BWKS o l'interno, estratte dalle informazioni della parte remota nell'evento XSI. Se remote-party-info non è disponibile, viene utilizzato PAI (P-Asserted Identity) (se configurato).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica e nella cronologia chiamate.
-
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
-
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
-
Coda call center: Visualizza il nome della coda che ha inoltrato la chiamata.
-
Dirigente-Assistente: Visualizza il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
-
Per le chiamate in coda chiamata interne, in cui un agente richiama una parte interna, la parte remota non visualizza il nome della coda chiamata, ma visualizza il nome dell'agente che la chiama.
Chiamata con risposta altrove:
Per i gruppi di risposta o le code di chiamata impostate con l'indirizzamento simultaneo, gli agenti visualizzeranno una chiamata risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di ricerca o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate non risposte nella cronologia chiamate se si riceve una risposta da un altro agente.
Seleziona ID chiamante
Panoramica
La funzione "Seleziona ID chiamante" consente agli utenti di passare tra diversi ID di linea chiamante per le chiamate esterne. Se abilitata dall'amministratore, gli utenti possono scegliere tra le seguenti opzioni per la propria identità di linea chiamante:
-
Numero utente ("Usa numero di telefono utente per identità linea chiamante")
-
CLID configurabile ("Usa CLID configurabile per identità linea di chiamata")
-
CLID gruppo ("Usa numero di telefono di gruppo/reparto per identità linea chiamante")
Funzionalità
Gli utenti dispongono di due metodi per modificare l'ID chiamante come predisposto dall'amministratore:
- Codici di accesso funzione (FAC): Codici specifici per ciascuna delle tre opzioni dell'ID chiamante.
- Interfaccia app Webex: Una vista intuitiva per l'utente all'interno delle app desktop e mobile Webex che visualizzano le opzioni dell'ID chiamante disponibili abilitate dall'amministratore, consentendo agli utenti di selezionare il proprio ID preferito.
Ulteriori funzioni
- Le app Webex includeranno anche opzioni per le code DNIS del call center.
- Gli utenti dell'app mobile avranno le opzioni Dual Persona disponibili per gli utenti di mobilità.
Precondizioni
Le seguenti condizioni devono essere soddisfatte sul server BroadWorks affinché l'utente possa controllare la sua scelta di criteri CLID esterni:
- Il flag di sistema "EnableUserSelectionOfExternalCLIDPolicy" è abilitato.
- L'ambito ID linea chiamata livello utente è impostato su "Usa criteri ID linea chiamata utente" per questo utente.
- Il flag "Consenti selezione utente di criteri di elaborazione chiamate a livello utente" è abilitato per l'utente.
- Se non viene definito alcun numero per le opzioni "Usa CLID configurabile per identità linea chiamante" o "Usa numero di telefono di gruppo/reparto per identità linea chiamante", i FAC o la visualizzazione dell'app non avranno effetto. Questa impostazione deve essere configurata dall'amministratore prima della selezione dell'utente.
Patch BroadWorks
Per il corretto funzionamento di questa funzione sono necessarie due patch BroadWorks specifiche:
Fare riferimento alla Sezione 8 Release Independent e Service Patch Information.
- BWKS-5230 era la funzione CLID selezionabile dall'utente originale: consente agli utenti (se il sistema è configurato correttamente) di modificare i criteri CLID applicabili. Vedere FD qui: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/UserSelectionOfExternalCallingLineIDOptionFD-R250.pdf
- BWKS-9510 è un miglioramento XSI richiesto dal team del client Webex per facilitare la individuazione delle opzioni disponibili per un utente. Questo è necessario perché la scelta dei criteri CLID non è una semplice funzione a livello utente (come CFA) direttamente controllabile. Piuttosto, dipende da varie opzioni di configurazione del sistema e dalla gerarchia dei "criteri di elaborazione delle chiamate". È possibile visualizzare i dettagli qui: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/XSIEnhancementToSupportUserSelectableCLIDFD-R250.pdf
Configurazione app Webex
Questi tag devono essere abilitati nelle configurazioni desktop, tablet e mobile:
<config> <servizi> <chiamate> <caller-id> <outgoing-calls enabled="%ENABLE_CLID_OUTGOING_CALLS_WXT%">
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni fissi. Questa specifica funzione consente di assegnare identificativi di linea condivisa all'app Webex dell'utente finale.
Questa funzione è utile agli utenti per gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
-
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
-
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
-
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
-
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente a linee condivise.
-
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise del client Webex
R23 senza ADP:
-
AP.as.23.0.1075.ap384179
-
AP.xsp.23.0.1075.ap384179
R23 con ADP:
-
AP.as.23.0.1075.ap384179
-
XSI-Azioni-23_2022.10
r24:
-
come: AP.as.24.0.944.ap384179
-
XSI-Azioni-24_2022.10
r25:
-
come: Versione RI Rel_2022.10_1.310
-
XSI-Azioni-25_2022.10
Patch 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo. Esempio: Per il client desktop: System>Modifica tipo di profilo di identità/dispositivo> Business Communicator - PC: Profilo, Opzioni standard, Numero di porte:
- SE è abilitata l'opzione 'Illimitato', non è richiesta alcuna modifica
- SE 'Limitato a' è <10, modificare il valore = 10 e salvarlo per utilizzare tutte le linee disponibili
-
Versione RI Rel_2022.10_1.310
Per dettagli sulla configurazione del client, vedere sezione 6.1.44 'Profilo principale' della Guida alla configurazione di Webex per Cisco BroadWorks.
Sincronizzazione Non disturbare (DND)
La sincronizzazione Non disturbare (DND) allinea le impostazioni DND tra Webex e BroadWorks sincronizzando lo stato Non disturbare tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato viene sincronizzato con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. In modo analogo, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist di una piattaforma non vengono riconosciuti dall'altra.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Se sono presenti molti clienti (>50) nel cluster BroadWorks, la sincronizzazione NoDist non è supportata. In tali casi, si consiglia di contattare un tecnico del supporto Cisco TAC per assistenza.
Prerequisiti
Accertarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione di BroadWorks.
Per la versione 23:
<frammento>
- App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
<frammento>
- App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 sul SA:
AS_CLI/System/ActivatableFeature> attiva 25433
Se sono presenti molti clienti (>50) nel cluster BroadWorks, operazioni come l'aggiornamento di azioni XSI, eventi XSI, URL DAS, URL XSP|ADP o sincronizzazione DND non sono supportate. In tali casi, si consiglia di contattare un tecnico del supporto Cisco TAC per assistenza.
Configurare la sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto eventi "come evento funzione". Per dettagli, vedi Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
-
Accedi a Partner Hub
-
Fare clic su Impostazioni.
-
Fai clic su Visualizza cluster e seleziona il cluster BroadWorks appropriato.
-
Abilita il tasto di alternanza di sincronizzazione Non disturbare (DND).
-
Inserisci il tuo ID utente BroadWorks e fai clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione DND. Se la convalida non riesce, il pulsante Salva viene disabilitato.
-
Se la convalida ha esito positivo, fai clic su Salva.
-
Una volta abilitata la sincronizzazione DND, Webex aggiorna tutti gli abbonamenti utente per includere il pacchetto per eventi Non disturbare. A seconda del numero di utenti, questo processo può richiedere alcune ore per il completamento.
-
L'abilitazione della sincronizzazione DND è un interruttore a una via. Una volta abilitata la funzione, non puoi disabilitarla da solo.
Abilita sincronizzazione DND (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per dettagli, vedi "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Orario di pausa
Nelle distribuzioni Webex per BroadWorks, la funzione "Orario di pausa" si basa sulla funzionalità "Sincronizzazione Non disturbare (DND)" per garantire che le impostazioni dell'orario di pausa siano sincronizzate su tutti i dispositivi. Per sincronizzare correttamente l'orario di pausa tra desktop e dispositivi mobili, assicurarsi che l'opzione 'Sincronizzazione NoDist' sia abilitata nell'account dell'utente.
Disabilita sincronizzazione DND
Non puoi disabilitare la sincronizzazione DND da solo. Per disabilitare la funzione, crea un caso BEMS tecnico con le seguenti informazioni:
-
Famiglia: Servizio Spark
-
Prodotto: Chiamata in Webex (Webex per BroadWorks)
-
Componente: WxBW - Provisioning
-
Il caso BEMS deve indicare che la sincronizzazione Non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterId BroadWorks.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione chiamata.
Modalità di registrazione |
Descrizione |
Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente |
La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
-
Per R22: AP.as.22.0.1123.ap377718
-
Per R23: AP.as.23.0.1075.ap377718
-
Per R24: AP.as.24.0.944.ap377718
L'Identificativo di correlazione chiamata deve essere attivato. Per dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione della chiamata su BroadWorks, vai alla Guida all'interfaccia di registrazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, vai all'articolo help.webex.com
Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla relativa piattaforma di registrazione chiamate di terze parti.
Abilitazione della casella vocale per l'integrazione di Microsoft Teams
È possibile abilitare la casella vocale per gli utenti Microsoft teams nella soluzione Webex per BroadWorks. Questa integrazione consente agli utenti di recuperare le caselle vocali direttamente attraverso Microsoft Teams, migliorando l'esperienza utente generale.
Procedura per abilitare la casella vocale
Per abilitare la casella vocale per BroadWorks, devi abilitare il tasto di alternanza broadworks-voicemail-enabled-spark-541886: true a livello di organizzazione.
Per abilitare questa funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Esperienza utente
Una volta impostata l'integrazione, gli utenti possono:
- Recupera le caselle vocali direttamente all'interno dell'applicazione Microsoft Teams.
- Ricevi notifiche per i nuovi messaggi vocali.
- Gestisci le impostazioni della casella vocale dall'interfaccia Webex.
Requisiti
Per supportare il recupero della casella vocale nell'integrazione Microsoft Teams con l'offerta Webex per BroadWorks, sono necessarie ulteriori modifiche di rete. I partner BroadWorks devono abilitare la condivisione risorse cross-origin (CORS) per i seguenti URL sulla relativa piattaforma BroadWorks:
- https://jabber-integration-a.wbx2.com/
- https://jabber-integration-r.wbx2.com/
- https://jabber-integration-k.wbx2.com/
- https://msteams-calling.webex.com
Per ulteriori dettagli sulle fasi di configurazione, fare riferimento alla sezione 8.5.1.2 della Guida alla configurazione della piattaforma di consegna delle applicazioni BW, che richiede la versione 2024.05 sull'ADP.
Gruppo Parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione Parcheggio chiamata di gruppo e Retrieve. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono quindi essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti del retail in un'impostazione di store possono utilizzare la funzione per parcheggiare una chiamata che può essere selezionata da qualcuno in un altro reparto.
Operazione funzione
Una volta configurata la funzione
-
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nella relativa app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'interno all'utente per un periodo di 10 secondi.
-
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nella relativa app Webex. L'utente quindi inserisce l'interno della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per il funzionamento di questa funzione, verificare quanto segue:
-
Il file di configurazione del client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
-
L'identificativo di correlazione delle chiamate deve essere abilitato su AS e XSP|ADP. Per dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
-
L'SBC deve essere configurato per passare l'attributo SIP '
x-broadworks-correlation-in
' a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiunta di gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte 2. Devi creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Webex | Parcheggio e recupero delle chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzata
Il parcheggio chiamate regolari o dirette non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso alle funzioni:
-
Inserisci *68 per parcheggiare una chiamata
-
Inserisci *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato in ambienti di call center o in altre situazioni in cui può essere richiesta assistenza o intervento immediato.
Quando un servizio di inclusione è abilitato, un utente o un supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di pulsanti o tasti dedicata sul telefono o sul dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in diversi scenari. In un'impostazione di call center, i supervisori o i formatori possono monitorare e assistere i rappresentanti dell'assistenza clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire indicazioni o assumere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può accedere rapidamente alle conversazioni in corso per fornire assistenza o prendere decisioni importanti.
Nell'app Webex per Inclusione, viene inviata una notifica che indica che la chiamata viene trasformata in una conferenza. Non sono disponibili ulteriori informazioni in NOTIFY (info-chiamata o info-conferenza) qual è il tipo di conferenza, quindi possiamo trattarlo in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Sono introdotti i seguenti termini:
-
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore in genere ha la possibilità di monitorare e intervenire nelle chiamate dei clienti in corso. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire indicazioni agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può coinvolgere la formazione degli agenti, rispondere alle preoccupazioni dei clienti e ottimizzare le prestazioni del team.
-
Cliente: Un cliente si riferisce a una persona o entità che interagisce con una società o un'organizzazione per ottenere prodotti, servizi o supporto. Nel contesto dell'inclusione della chiamata, un cliente è qualcuno che effettua o riceve una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risoluzione di domande o problemi durante la chiamata. La funzione di inclusione della chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
-
Agente: Un agente, noto anche come rappresentante dell'assistenza clienti o agente di call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza tramite telefono o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare transazioni e offrire un'esperienza clienti positiva. Nel contesto dell'inclusione della chiamata, un agente è la persona che parla direttamente al cliente durante la telefonata. Se necessario, l'agente può ricevere istruzioni o feedback dal supervisore tramite l'inclusione delle chiamate.
Per qualsiasi richiesta avviata dal client come CallStartRequest, CallPickupRequest, DirectedCallPickupRequest, DirectedCallPickupWithBargeInRequest, ecc., se <Webex Client> (scegliere il nome corretto anziché il client Webex, se non è appropriato) viene fornito come dispositivo di visualizzazione della chiamata condivisa, la configurazione 'Avvisa tutti gli aspetti per le chiamate Click-to-Dial' deve essere abilitata nell'impostazione Identificativo chiamata condivisa affinché il client riceva una chiamata, a meno che la posizione non sia esplicitamente fornita dal client che avvia la richiesta.
Inoltro chiamata nativa mobile a riunione
L'escalation della chiamata nativa mobile a riunione è dotata di due funzioni univoche:
-
Nuova notifica push
Gli utenti mobili in una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando avvii una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si passa direttamente alla schermata durante la chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata tramite il controllo chiamate Cisco per le chiamate da cellulare, viene visualizzata la notifica Webex durante una chiamata da cellulare.
-
Trasferisci chiamata mobile nella riunione
Quando ci si trova nel mezzo di una chiamata con qualcuno, si consiglia di trasferire la chiamata in una riunione per utilizzare alcune funzioni avanzate per le riunioni come video, condivisione o lavagna. In alternativa, invita altre persone alla discussione e passa a una riunione.
Requisiti BroadWorks
-
Funzione attivabile 25239
-
R23 con XSP|ADP:
-
Patch AS AP.as.23.0.1075.ap383064
-
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
-
Patch AP.platform.23.0.1075.ap383064
-
-
R23 con ADP:
-
Patch AS AP.as.23.0.1075.ap383064
-
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e versione NPS > 2022.08_1.350
-
-
r24:
-
Patch AS: AP.as.24.0.944.ap383064
-
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e versione NPS > 2022.08_1.350
-
-
r25:
-
Versione RI Rel_2022.08_1.354
-
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e versione NPS > 2022.08_1.350
-
Configurazione chiamata URI per supportare il trasferimento di una chiamata nella riunione
Criteri di composizione Url NS
Definisci regola per l'indirizzamento di (.*)webex.com attraverso I-SBC
NS_CLI/Policy/UrlDialing> ottieni criteri WebexMeetings: Istanza chiamata URL: Webex unknownSipURIHandling = reject disableSubscriberLookup = true Abilita = true CallTypes: Selezione = {ALL} Da = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP} lineportOnly = false enableSipURIMatchingRules = true NS_CLI/Policy/UrlDialing/Rules> ottieni criteri WebexMeetings: Istanza chiamata URL: Tabella WebexCalling: Instradamento schema ID regolePeso costo dtg =================================================================== 1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> ottieni elemento di rete WebexMeetings Posizione = 1281465 Centro dati = Costo statico = 1 Peso statico = 99 Sondaggio = falso OpState = stato abilitato = Profilo onLine = NIL_PROFILE Ricerca remota abilitata = falso Attributi di segnalazione = NS_CLI/System/Device/RoutingNE/Address> ottieni WebexMeetings indirizzamento NE indirizzo Peso costo Percorso trasporto porta ===================================================================== WebexMeetings sbc-address 1 99 - non specificato
Profilo di indirizzamento NS
Istanza criteri di UrlDialing aggiunta ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> ottieni il profilo MyInst: Istanza criteri Webex ========================================== … ComposizioneUrl WebexMeetings
Utilizzo NS Route per chiamata NetworkURL
Consentire al AS di rispettare l'indirizzamento NS in modalità AS ibrido
AS_CLI/Interface/IMS> imposta queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un punto di risposta per la sicurezza pubblica (PSAP, Public Safety Answering Point) che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, devi integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Utilizza i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
-
-
Banda
-
Intrado
-
RedSky
-
Personalizzazione e provisioning dei client
Gli utenti scaricano e installano le proprie app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedi Piattaforme di app Webex). Una volta eseguita l'autenticazione, il client si registra su Webex Cloud per messaggi e riunioni, recupera le relative informazioni di branding, rileva le relative informazioni sul servizio BroadWorks e scarica la configurazione di chiamata dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
I parametri di chiamata per le app Webex vengono configurati in BroadWorks (come di consueto). È possibile configurare branding, messaggistica e parametri di riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta di modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
-
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Preparazione dell'ambiente).
-
Verificare di disporre dei set di tag corretti in Sistema BroadWorks > Risorse > Set di tag di gestione dispositivi.
-
Per ciascun client che stai predisponendo:
-
Scaricare ed estrarre il file zip DTAF per il client specifico.
-
Importa file DTAF in BroadWorks su Sistema > Risorse > Tipi di profilo identità/dispositivo
-
Apri il profilo dispositivo appena aggiunto per la modifica e:
-
Inserire il nome di dominio completo (FQDN) dell'azienda agricola XSP|ADP e il protocollo di accesso dispositivo.
-
Selezionare la casella di controllo Supporta info parte remota. Questo supporto è richiesto per il funzionamento della condivisione del desktop.
È inoltre possibile abilitare il supporto della parte remota eseguendo il seguente comando CLI sul server applicazioni:
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
-
-
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
-
Salvare il profilo.
-
-
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome |
Descrizione |
Priorità codec |
Configura ordine di priorità per codec audio e video per chiamate VoIP |
TCP, UDP e TLS |
Configurare i protocolli utilizzati per la segnalazione SIP e il contenuto multimediale |
Porte audio e video RTP |
Configura intervalli di porte per audio e video RTP |
Opzioni SIP |
Configurare diverse opzioni correlate a SIP (INFO SIP, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
-
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti che il partner gestisce. Vedi Configurazione delle personalizzazioni di branding avanzate.
-
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi il branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client.
Personalizzazione degli URL di segnalazione problemi e della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito di feedback e assistenza", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con provisioning a flusso costante
Prima di eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 |
Assegna servizio in BroadWorks: |
2 |
Verifica organizzazione cliente e utenti in Control Hub: |
Test utente
1 |
Scarica l'app Webex su due macchine diverse. |
2 |
Eseguire l'accesso come test degli utenti sulle due macchine. |
3 |
Effettuare chiamate di prova. |
Gestione di Webex per BroadWorks
Pre provisioning organizzazioni clienti
Nel modello corrente, viene eseguito automaticamente il provisioning dell'organizzazione del cliente quando si onboard il primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguita una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
-
Usa API per creare account Webex
-
Assegnare i messaggi e-mail integrati IM&P (provisioning flow) con e-mail affidabili per la creazione di account Webex
-
Assegna IM&P integrato (provisioning FLOW) senza messaggi e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per la creazione di account Webex
-
Consenti agli utenti l'attivazione autonoma (inviando loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex sono esposti API pubbliche per consentire ai provider di servizi di integrare Webex per il provisioning del sottoscrittore Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. La specifica per queste API è disponibile developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti Wholesale verranno rifiutati da queste API.
Provisioning Flow
Su BroadWorks, è possibile fornire agli utenti l'opzione Abilita IM integrato&P. Questa azione causa il provisioning dell'adattatore BroadWorks per rendere chiamata API di eseguire il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile retrocompatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica di codice, ma solo una modifica di configurazione all'endpoint API per l'adattatore di provisioning.
La fornitura del sottoscrittore su Webex può richiedere una notevole quantità di tempo (diversi minuti per l'utente iniziale in un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il completamento del provisioning di flusso indica che il provisioning è stato avviato. Non indica il completamento.
Per verificare che gli utenti e l'organizzazione del cliente siano completamente predisposti su Webex, è necessario accedere a Partner Hub e ricercare l'elenco dei clienti.
Gli utenti trunking BroadWorks possono disporre di Webex per BroadWorks tramite un aspetto di chiamata condivisa (SCA). All'utente del trunking deve essere assegnato il servizio di autenticazione. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto SCA Webex dall'autenticazione trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con funzioni di elenco di indirizzamento o di indirizzamento diretto assegnate.
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata modello di onboarding.
Attivazione automatica utente
Per fornire gli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
-
Accedi a Partner Hub e trova la pagina Elenco clienti .
-
Fare clic su View Templates (Visualizzamodelli).
-
Seleziona il modello di Onboarding di provisioning da applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non è nel sistema BroadWorks associato a questo modello, l'utente non può attivare automaticamente con il collegamento.
-
Copiare il collegamento per il provisioning e inviarlo all'utente.
È possibile anche includere il collegamento di download del software e ricordare all'utente che deve fornire e convalidare il relativo indirizzo e-mail per attivare l'account Webex.
-
È possibile monitorare lo stato di attivazione dell'utente sul modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi diattivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli nella vista Stato utente che consentono agli amministratori di Cisco BroadWorks provider di servizi di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Spostamento degli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a ... |
Segui questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (ad esempio, account gratuito, account di prova) |
|
Organizzazione cliente |
Allega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge anche Webex per BroadWorks agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a ... |
Segui questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (ad esempio, account gratuito, account di prova) |
Se l'organizzazione Webex per BroadWorks non esiste (non viene eseguito il provisioning di alcun utente):
Se esiste un'organizzazione Webex per BroadWorks (viene eseguito il provisioning di almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di iscrizione autonoma (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
-
Trasferisci utente (con e-mail attendibile): utilizza il provisioning con e-mail attendibili
-
Trasferisci utente (con e-mail non attendibile): utilizza il provisioning con e-mail non attendibili
-
Attivazione automatica
Se l'organizzazione Webex per Cisco BroadWorks non è ancora stata creata (non è stato eseguito il provisioning di alcun utente), seguire i normali processi di provisioning ( Provisioning utenti) per creare l'organizzazione e aggiungere il primo utente come utente di amministrazione. Una volta eseguito il provisioning del primo utente nell'organizzazione, seguire i metodi basati sul consenso in questa procedura per spostare gli utenti successivi.
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Activate Account (Attivaaccount). L'utente viene reindirizzato al portale consumer Webex.
-
L'utente accede a Webex.
-
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza e-mail non attendibili, è necessario convalidare prima l'indirizzo e-mail dell'utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito automaticamente sul bridge di provisioning BroadWorks.
-
All'utente viene inviato un testo con un collegamento di attivazione.
-
-
L'utente fa clic sul collegamento Attivazione e inserisce il relativo indirizzo e-mail.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Partecipaora.
-
Indirizzo e-mail convalidato.
-
L'utente viene reindirizzato per accedere al portale Webex Consumer.
-
-
L'utente accede a Webex.
-
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Flusso di attivazione automatica
Se l'utente dispone di un account BroadWorks esistente, potrà utilizzare il processo di attivazione automatica per spostare l'account.
-
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
-
L'utente inserisce il relativo indirizzo e-mail.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
Viene inviato un messaggio e-mail automatico all'indirizzo e-mail dell'utente.
-
-
L'utente apre il messaggio e-mail e fa clic sul collegamento Partecipa ora, che convalida l'indirizzo e-mail.
-
CI ha rilevato che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di continuare.
-
L'utente viene reindirizzato per accedere a Webex.
-
-
L'utente accede al portale consumer.
-
L'utente fa clic su Delete Account (Eliminaaccount).
-
L'account Webex precedente viene eliminato.
-
L'utente ha predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
Allega Webex per BroadWorks all'organizzazione esistente
Se si è un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, non ancora associata a un'azienda BroadWorks gestita da partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso dell'amministratore affinché la richiesta di provisioning venga eseguita correttamente.
L'approvazione dell'amministratore dell'organizzazione è necessaria se è vera una delle seguenti condizioni:
-
L'organizzazione del cliente esistente dispone di 100 utenti o più
-
L'organizzazione dispone di un dominio e-mail verificato
-
Dominio organizzazione richiesto
Se nessuno dei criteri precedenti è vero, si può verificare un collegamento automatico.
In uno scenario di Allegato automatico , un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner vengono riconosciuti diritti di amministratore di provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà impostato un amministratore completo.
Con l'accesso amministratore di provisioning, si avrà visibilità limitata in Control Hub agli utenti dell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione.
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che l'opzione Consenti inviti e-mail amministratore al momento del collegamento a organizzazioni esistenti (il tasto di alternanza è attivato per impostazione predefinita).
1 |
L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedi Provisioning organizzazioni clienti. Si verifica quanto segue:
Supponi che l'amministratore del cliente non riceva un messaggio e-mail. In tal caso, l'amministratore del cliente può aggiungere manualmente l'amministratore del partner (specificato nel modello) come amministratore esterno dell'organizzazione cliente da Control Hub. Quindi, riprovare a eseguire il provisioning dell'utente per attivare il provisioning del cliente Webex per Cisco BroadWorks. |
2 |
Con l'accesso di amministratore completo , l'amministratore partner può completare il processo di provisioning del cliente. Dovrai tentare di nuovo il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora in qualità di amministratore completo esterno, non è necessario osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione del cliente esistente sarà visibile come cliente sotto l'organizzazione partner Webex per BroadWorks. Il nome dell'organizzazione allegata non cambierà in nome aziendale BroadWorks. Il nome dell'organizzazione allegata rimarrà uguale a quello precedente al processo di allegazione. |
Condizioni dell'allegato organizzazione
-
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione cliente di destinazione. Altrimenti, verrà creata una nuova organizzazione cliente.
-
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
-
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato nel modello di provisioning Webex per BroadWorks. Di conseguenza, non sono state apportate modifiche alla modalità di accesso degli utenti esistenti.
-
Tuttavia, se l'organizzazione del cliente esistente ha abilitato il branding base, una volta eseguito l'allegato, le impostazioni di branding avanzato del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
-
-
Il nome dell'organizzazione esistente non cambierà.
-
Nessuna modifica all'impostazione del flag di eliminazione e-mail nelle impostazioni dell'organizzazione esistente. Ciò potrebbe incidere sugli utenti predisposti di recente. A seconda di come è impostato il flag, i nuovi utenti possono ricevere o meno un messaggio e-mail con un codice che deve essere inserito per completare l'attivazione.
-
La modalità di amministrazione con limitazioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
-
Assicurati di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
-
È possibile associare un'azienda BroadWorks a una sola organizzazione Webex. Non è possibile eseguire il provisioning degli abbonati di una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com .
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo.
L'indirizzo e-mail che l'amministratore dell'organizzazione cliente aggiunge come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore del partner come configurato nel modello di onboarding su Partner Hub.
Dopo aver aggiunto l'e-mail dal modello di onboarding su Partner Hub come amministratore completo, qualsiasi altro amministratore partner dovrà essere aggiunto come amministratore esterno con diritti di amministratore completo.
Scollegare Webex per BroadWorks dall'organizzazione esistente
Segui questa procedura per deviare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato Webex per BroadWorks a un'organizzazione esistente per errore e si desidera rimuovere l'allegato.
Nel flusso standard, la disconnessione di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati.
-
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso amministratore esterno seguendo l'opzione Approva richiesta amministratore esterno.
-
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi un'area di lavoro BroadWorks .
-
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi un abbonato BroadWorks .
-
Rimuovere gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se è stato eseguito il provisioning degli utenti tramite il flusso e-mail non attendibili e non sono stati ancora inseriti messaggi e-mail validi, gli utenti vengono lasciati in sospeso. Segui Verifica provisioning utente con messaggi e-mail non attendibili per eliminare gli utenti.
-
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Ibrido, nella sezione BroadWorks Calling , elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera allegare Webex per BroadWorks al cliente, seguire i processi di provisioning per il collegamento a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API Rimuovi un abbonato BroadWorks consiste nell'accedere a BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati.
Gestisci utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente vengono tenuti in BroadWorks. Un'identità e-mail distinta per l'utente e relative licenze per le funzioni Webex sono tenute in Webex.
Verifica del provisioning utenti con indirizzi e-mail non attendibili
Se si sta predis facendo il provisioning di Webex per utenti BroadWorks utilizzando il provisioning flow-through con messaggi e-mail non attendibili, gli utenti devono autoproducersi inserendo il proprio indirizzo e-mail nel portale di attivazione utenti. Se l'utente rileva un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riconorà l'errore, l'amministratore può utilizzare la procedura seguente in Partner Hub per esaminare lo stato e onboardre l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 |
Accedi a Partner Hub e trova la pagina Elenco clienti . |
2 |
Fare clic su View Templates (Visualizzamodelli). Seleziona il modello di onboarding appropriato da applicare a questo utente. |
3 |
In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con messaggi e-mail non attendibili sia configurato correttamente:
|
4 |
Dopo il provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato di provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo Stato corrente, che mostra se l'utente è stato predisposto o se è presente un requisito in sospeso.
|
5 |
Per gli utenti con errori o requisiti in sospeso, fare clic sui tre puntini a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili durante la visualizzazione dell'elenco di utenti:
-
Esporta: fai clic su questo pulsante se desideri esportare l'elenco utenti in un file CSV.
-
Escludi utenti di cui è stato eseguito il provisioning: abilitare questo tasto di alternanza se si desidera visualizzare solo gli utenti con requisiti in sospeso o errori.
Modifica ID utente o indirizzo e-mail
Modifiche dell'ID utente e dell'indirizzo e-mail
ID e-mail e ID alternativo sono attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. Nella tabella seguente vengono descritti gli scopi di questi diversi attributi e le operazioni da eseguire per modificarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non è possibile modificare questo identificativo e collegare comunque l'utente allo stesso account in Webex. È possibile eliminare l'utente e crearla nuovamente se è errata. |
ID e-mail | ID utente |
Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si asserzione di attendibilità dell'e-mail Non richiesto in BroadWorks se non si asserzione di affidabilità dei messaggi e-mail Non richiesto in BroadWorks se si consente agli abbonati di attivare automaticamente |
Se l'utente è predisposto con l'indirizzo e-mail errato, è necessario effettuare un processo manuale per modificare questa impostazione in entrambi i punti:
Non modificare l'ID utente BroadWorks. Operazione non supportata. |
ID alternativo | Nessuno | Abilita autorizzazione utente, tramite e-mail e password, a fronte dell'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti devono immettere il relativo ID utente BroadWorks durante l'autenticazione. |
Modifica del pacchetto utente nell'hub partner
1 |
Accedere all'hub partner e fare clic su Clienti. |
2 |
Individuare e selezionare l'organizzazione del cliente in cui si trova l'utente. La pagina di panoramica dell'organizzazione viene visualizzata in un pannello a destra dello schermo. |
3 |
Fare clic su View Customer (Visualizzacliente). L'organizzazione del cliente viene aperta in Control Hub, che mostra la pagina Panoramica.
|
4 |
Fare clic suUtenti, quindi individuare e fare clic sull'utente interessato. |
5 |
In Servizi dell'utente, fare clicsu Webex per pacchetti BroadWorks (Sottoscrizioni). Viene visualizzato il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 |
Nella scheda Profilo , ricercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 |
Selezionare il pacchetto che si desidera per questo utente (Base, Standard, Premium o Softphone) e fare clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 |
È possibile chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium dispongono di siti per riunioni distinti associati a ciascun pacchetto. Se un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato visualizza due siti per riunioni in Control Hub. Le funzionalità di riunione e il sito della riunione dell'abbonato si allineano al pacchetto corrente. Il sito per riunioni del pacchetto precedente e tutto il contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili ad Amministrazione sito riunione.
Potrebbero essere necessario da due a tre ore per le PMR di aggiornamento che sono risultate da una modifica del pacchetto all'aggiornamento.
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si intende eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto il trasferimento automatico del ruolo di amministratore nel caso in cui l'ultimo amministratore venga eliminato.
Webex per API Cisco BroadWorks
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
-
Eseguire la richiesta di rimozione dell'API di un abbonato BroadWorks su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento a Webex per Cisco BroadWorks. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
Eseguire la richiesta DI ELIMINAZIONE DI una persona su per eliminare completamente https://developer.webex.com/docs/api/v1/people/delete-a-person l'utente.
Flow-through Provisioning
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
-
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – PAGINA IM&P integrata su BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento a Webex per Cisco BroadWorks dall'utente. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori dei clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla relativa organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 |
Usa le API Persone per eliminare tutti gli utenti dall'organizzazione: Rimozione di un'API abbonato BroadWorks rimuove i diritti Webex per Cisco BroadWorks da un utente, ma non elimina l'utente. |
2 |
Se la sincronizzazione delle rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione delle rubriche tramite Partner Hub: Per disabilitare la sincronizzazione delle directory tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API BroadWorks Enterprise e disabilita l'impostazione enableDirSync . Tutti gli utenti correlati alla sincronizzazione delle rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione di utenti (utilizzando uno dei metodi) può richiedere del tempo in base alla quantità di utenti. |
3 |
Una volta rimossi tutti gli utenti, utilizzare l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Annullamento di un abbonamento da Control Hub
Poiché l'API è privata, i clienti non potranno accedervi. Al contrario, la seguente procedura mostra come i clienti possono annullare il proprio abbonamento da Control Hub:
-
L'amministratore del partner può passare alla pagina dei servizi "Ibridi" in Control Hub del cliente.
-
Individuare la scheda "BroadWorks Calling".
-
Una volta eseguito il provisioning di tutti gli utenti da Webex per BroadWorks per tale cliente, il partner visualizza un pulsante per "Cancella configurazione" (ad esempio, elimina la relativa customer_config voce in BPB).
Gestione release
I controlli di gestione delle release in Partner Hub consentono ai provider di servizi Cisco BroadWorks di gestire le release fornendo loro la possibilità di controllare la data di rilascio in base alla quale le app Webex degli utenti ese upgrade all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza aggiornamenti Automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
-
Configura pianificazioni di rilascio personalizzate con differimenti dalla pianificazione di rilascio predefinita di Cisco
-
Configurare una pianificazione a singola release e una propagazione a catena tale pianificazione per tutte le organizzazioni dei clienti che gestiscono
-
Assegna diverse pianificazioni di release a diverse organizzazioni cliente
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di release personalizzate, vedi l'articolo di Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
-
Aggiunta di un cluster BroadWorks in Hub partner
-
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
-
Aggiungi un modello di onboarding in Partner Hub
-
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su |
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. |
3 |
Fare clic su View Clusters (Visualizzacluster). |
4 |
Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro a destra.
|
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su | |||||||||
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. | |||||||||
3 |
Fare clic su View Templates (Visualizzamodelli). | |||||||||
4 |
Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere Assistente Webex follow-up su attività, prendere nota di importanti decisioni ed evidenziare momenti chiave durante una riunione o un evento.
Assistente Webex per Meetings è disponibile gratuitamente per i siti di riunione Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilita Webex Assistant per le riunioni
Assistente Webex è abilitato per impostazione predefinita per i clienti BroadWorks dei pacchetti standard e premium.
Gli amministratori partner e gli amministratori dell'organizzazione cliente possono disabilitare la funzione per le organizzazioni cliente attraverso Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
-
Il supporto è limitato a pacchetti Premium e Standard e solo a sale riunioni personali.
-
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
-
La condivisione del contenuto tramite e-mail è accessibile solo agli utenti all'interno della tua organizzazione
-
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Anche il contenuto della riunione non è accessibile quando è condiviso tra utenti di pacchetti diversi all'interno della stessa organizzazione.
-
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
-
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile e pertanto le trascrizioni post-riunione non sono disponibili indipendentemente dal fatto che Webex Assistant sia abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni sull'uso della funzione, vedere uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
La chiamata Webex gratuita è abilitata per impostazione predefinita, consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, disabilitando tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzioni
Se Webex Calling è disabilitato, si applicano le seguenti condizioni a Webex per gli utenti Cisco BroadWorks:
-
Gli utenti non visualizzano più Chiama con Webex come opzione di chiamata selezionabile sull'app Webex.
-
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per utenti Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, Cronologia chiamate, Contatti, inserendo l'URI o l'indirizzo e-mail dell'altro utente nella barra di ricerca.
-
La condivisione dello schermo funziona all'interno di una chiamata BroadWorks.
-
Le riunioni Webex e la presenza di telefonia continuano a funzionare anche se le chiamate Webex sono disabilitate.
Disabilita Webex Calls (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno della procedura guidata Aggiungi nuovo modello . Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti che assegni al modello.
Per dettagli sulla configurazione di un nuovo modello di onboarding, vedi Configurazione dell'organizzazione partner in Partner Hub.
Disabilita Webex Calls (modello di onboarding esistente)
Segui questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
-
Accedi a Partner Hub all'indirizzo admin.webex.com.
-
Scegliere Impostazioni.
-
Fare clic su Visualizza modello e scegliere il modello di onboarding appropriato.
-
Fai clic su Disabilita chiamata gratuita Cisco Webex.
-
Fare clic su Salva.
Disabilita Webex Calls (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare le chiamate Webex per un utente esistente, puoi seguire una delle procedure seguenti per aggiornare l'utente.
Accertati di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigurerà l'utente con le chiamate Webex abilitate.
Se si sta utilizzando il provisioning flow-through, è possibile effettuare le seguenti operazioni:
-
Aprire CommPilot e andare alla configurazione utente.
-
Rimuovere il servizio IM+P integrato dall'utente e fare clic su OK.
-
Aggiungere il servizio IM+P integrato all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
-
Utilizzare Rimuovi un'API abbonato BroadWorks per eliminare l'utente.
-
Utilizzare Esegui provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione del video o della condivisione dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per i dettagli e le opzioni di configurazione completi, vedi Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è inoltre possibile configurare se il contenuto multimediale per le chiamate in ingresso utilizza per impostazione predefinita solo video o audio.
Indicatore di stato della linea/Notifica risposta per assente
La funzione Indicatore di stato/Notifica risposta per assente utilizza le funzioni Indicatore di stato e Risposta per assente indirizzata. Un utente di indicatori di stato riceve una notifica audio e visiva sull'app Webex quando un utente dall'elenco monitorato di indicatori di stato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può ignorare o rispondere alla chiamata dell'utente monitorato.
La notifica di risposta per assente (BLF) è utile in situazioni in cui un utente deve rispondere alle chiamate per altri membri di team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra multi-chiamata - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza di membri del team Webex e non Webex. Per informazioni sull'abilitazione della chiamata multipla, vedere: Finestra multi-chiamata
I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati con la rubrica in Webex e disporranno solo degli stati "sconosciuti" e "in chiamata" (lo stato di suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
-
La presenza non è supportata per utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
-
Gli utenti CI senza autorizzazione cloud Webex o il tipo di account macchina (spazi di lavoro) mostrano solo la presenza 'in chiamata' e 'sconosciuta'. Nessuno stato attivo, suoneria, eccetera.
-
Gli utenti non Webex presenti nell'elenco di monitoraggio degli indicatori di stato che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza 'sconosciuta'.
-
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
-
Se un utente non Webex dell'indicatore di stato mette in attesa una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate a BroadWorks. Installare solo le patch che si applicano alla versione in uso:
Per R22:
-
AP.platform.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382362
-
AP.xsp.22.0.1123.ap382053
-
AP.xsp.22.0.1123.ap382362
-
AP.as.22.0.1123.ap383459
-
AP.as.22.0.1123.ap383520
Per R23:
-
AP.platform.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382362
-
AP.as.23.0.1075.ap383459
-
AP.as.23.0.1075.ap383520
-
Se si utilizza XSP|ADP:
-
AP.xsp.23.0.1075.ap382053
-
AP.xsp.23.0.1075.ap382362
-
-
Se stai utilizzando ADP:
-
XSI-Actions-23_2022.01_1.200.bwar
-
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
-
Per R24:
-
AP.as.24.0.944.ap382053
-
AP.as.24.0.944.ap382362
-
AP.as.24.0.944.ap383459
-
AP.as.24.0.944. ap383520
-
XSI-Actions-24_2022.01_1.200.bwar
-
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
-
<indicatore di stato abilitato="%ENABLE_BUSY_LAMP_FIELD_WXT%">
-
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
-
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare il Meccanismo Xsi Avanzato 101642 Per Telefonia team sul AS:
AS_CLI/System/ActivatableFeature> attivare 101642
Abilitare X-BroadWorks-Remote-Party-Info
sul server AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamate SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
Verifica che i seguenti servizi siano assegnati agli utenti:
-
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
-
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione dell'indicatore di stato della linea su BroadWorks
Per impostare l'indicatore di stato della linea per un utente, gli amministratori dei partner possono utilizzare la procedura seguente.
-
Accedi a BroadWorks CommPilot.
-
Per un utente selezionato, andare ad Applicazioni client e configurare l'indicatore di stato della linea.
-
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
-
Utilizzare i parametri di ricerca per individuare e aggiungere gli utenti all'elenco Utenti monitorati .
-
Fare clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento facile da utilizzare per il coinvolgimento del pubblico. Consente alle persone di ottenere il massimo dalle riunioni colmando la differenza tra gli oratori e i partecipanti. Se Slido questa funzione è integrata nell'organizzazione Control Hub, gli utenti possono aggiungere l'app Slido alle relative riunioni nell'app Webex. Questa integrazione aggiunge funzionalità Q&A di sondaggi e di sondaggi aggiuntivi alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Disponibilità Webex: In una riunione di calendario
Quando si accetta una riunione nel client Outlook che sia un appuntamento, una riunione ad hoc o una riunione non Webex, la disponibilità di Webex viene visualizzata come "In una riunione di calendario". Questa disponibilità consente ai colleghi di sapere che si è altrimenti coinvolti e che una risposta potrebbe essere ritardata.
Per abilitare questa funzione:
-
passare alla scheda Generale della scheda Impostazioni su Windows o Preferenze su Mac.
-
Selezionare la casella Mostra se presente in una riunione di calendario.
Per gli utenti con l'integrazione di presenza Outlook abilitata, l'opzione "In una riunione di calendario" in Webex viene associata a "Occupato" in Outlook.
Avvertenza
Per il funzionamento di questa funzione, è necessario che l'app Webex e il client Outlook siano in esecuzione contemporaneamente.
Attualmente stiamo lavorando per supportare l'opzione 'Mostra come lavorando altrove' in Outlook per non visualizzare un utente come "In una riunione di calendario" in Webex.
Se un utente sceglie di disabilitare l'opzione "Mostra quando presente in una riunione di calendario" mentre si trova attualmente in una riunione di calendario, la presenza di tale utente non verrà aggiornata finché non termina la riunione. Questa operazione richiederà un riavvio del client per rispondere.
Risposta automatica con segnale acustico
Con la risposta automatica con segnale acustico, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul proprio desktop. Quando l'app Webex squilla sull'interlocutore, l'utente sente un determinato tono per avvisarlo che la chiamata è connessa.
Affinché un utente Webex per Cisco BroadWorks utilizzi questa funzione:
-
La funzione è supportata solo sull'identificativo di linea principale
-
L'app Webex deve essere l'identificativo di linea principale
-
Il %ENABLE_AUTO_ANSWER_WXT% tag deve essere abilitato
Se l'utente ha anche indicatori di chiamata condivisa (ad esempio, un telefono della scrivania è configurato come uno degli indicatori di linea secondari), la funzione è ancora supportata sull'identificativo principale a condizione che gli indicatori di chiamata condivisa non siano configurati per ricevere le chiamate in arrivo. Questa operazione può essere eseguita configurando una delle tre condizioni seguenti su BroadWorks per tutti gli aspetti di chiamata condivisa:
-
L'opzione Avvisa tutte le apparenze per le chiamate Click-to-Dial è disabilitata nella configurazione dell'Aspetto chiamata condivisa: questo è l'approccio consigliato
o
-
L'opzione Consenti terminazione a questa posizione deve essere disabilitata per tutti gli indicatori di chiamata condivisa o
o
-
Posizioni disabilitate per tutti gli indicatori di chiamata condivisa
Aumento della capacità
Aziende XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare il numero di risorse ADP XSP|aggiuntive necessarie per l'aumento proposto del numero di abbonati. Per uno dei server NPS dedicati o dedicati a Webex per Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
-
Ridimensiona azienda agricola dedicata: Aggiungere uno o più server ADP XSP| all'azienda agricola che richiede capacità aggiuntiva. Installare e attivare la stessa serie di applicazioni e configurazioni dei nodi esistenti del sistema.
-
Aggiungi azienda agricola dedicata: Aggiungi un nuovo farm ADP XSP|dedicato. Sarà necessario creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti sul nuovo registro, per esitare gli utenti a essere presenti nell'hub esistente.
-
Aggiungi azienda agricola specializzata: Se si verificano strozzature per un determinato servizio, si consiglia di creare un'azienda XSP|ADP separata a tale scopo, tenendo in considerazione i requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster Control Hub e le voci DNS se si modifica l'URL del servizio con un nuovo registro.
In tutti i casi, il monitoraggio e la risorsa dell'ambiente BroadWorks è di responsabilità. Se si desidera coinvolgere l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare servizi professionali.
Gestione dei certificati del server HTTP
Devi gestire questi certificati per le applicazioni Web autenticate mTLS sulle tue ADP XSP|:
-
Certificato di catena di fiducia del cloud Webex
-
Certificati delle interfacce server HTTP di|ADP XSP
Catena di fiducia
È possibile scaricare il certificato di catena di attendibilità da Control Hub e installarlo sugli ADP XSP| durante la configurazione iniziale. Si prevede di aggiornare il certificato prima della scadenza e di notificare come e quando modificarlo.
Interfacce server HTTP
L'ADP XSP| deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Ordina certificati. Quando si protegge per la prima volta l'interfaccia, viene generato un certificato autofirmato. Questo certificato è valido per un anno a partire da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione Partner Hub che gli amministratori partner possono assegnare a specifiche organizzazioni clienti per limitare le impostazioni dell'organizzazione che gli amministratori clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione cliente, tutti gli amministratori dei clienti di tale organizzazione, indipendentemente dai diritti di ruolo, non possono accedere a una serie di controlli limitati in Control Hub. Solo un amministratore partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner non è un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita i diritti di ruolo specifici per gli amministratori dei clienti nell'organizzazione a cui viene applicata l'impostazione.
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità Con limitazioni del partner. Dopo l'accesso, verrà visualizzato un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner informa l'amministratore del cliente che la modalità con limitazioni è abilitata e che potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore di clienti in un'organizzazione in cui è abilitata l'opzione Con limitazioni della modalità partner, il livello di accesso a Control Hub è determinato con la formula seguente:
(Accesso Control Hub) = (Diritti ruolo organizzazione) - (Limitati dalle limitazioni della modalità partner)
Gli amministratori dei clienti subiranno diverse limitazioni, indipendentemente dalla modalità con limitazioni da parte del partner. Tali limitazioni includono:
- Impostazioni chiamata: Le impostazioni 'Priorità chiamata Opzioni app' nel menu Chiamata sono di sola lettura.
- Impostazione posizione: L'impostazione della chiamata in seguito alla creazione della posizione verrà nascosta.
- Gestione PSTN e registrazione chiamate: Queste opzioni saranno in grigio per la posizione.
- Gestione numeri di telefono: Nel menu Chiamata, la gestione dei numeri di telefono è disabilitata e le impostazioni 'Priorità chiamata opzioni app' nonché le registrazioni delle chiamate sono di sola lettura.
Limitazioni
Quando la modalità con limitazioni del partner è abilitata per un'organizzazione del cliente, gli amministratori dei clienti in tale organizzazione non possono accedere alle seguenti impostazioni di Control Hub:
-
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
-
Il pulsante Gestisci utenti è disattivato.
-
Aggiunta o modifica manuale utenti: nessuna opzione per aggiungere o modificare gli utenti, manualmente o tramite CSV.
-
Richiedi utenti—non disponibile
-
Assegna automaticamente licenze: non disponibili
-
Sincronizzazione rubriche: impossibile modificare le impostazioni di sincronizzazione rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
-
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato e indirizzo e-mail principale* sono modificabili.
-
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
-
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, Messaggi, Riunioni, Chiamata)
-
Visualizzazione dello stato dei servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
-
Numero ufficio principale: questo campo è di sola lettura.
-
-
Nella vista Account, non sono disponibili le seguenti impostazioni:
-
Nome società di sola lettura.
-
-
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
-
Dominio: l'accesso è di sola lettura.
-
E-mail: le impostazioni Elimina invito e-mail amministratore e Selezione locale e-mail sono di sola lettura.
-
Autenticazione: nessuna opzione per modificare le impostazioni di autenticazione e SSO.
-
-
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
-
Impostazioni chiamata: le impostazioni di Priorità chiamata opzioni app sono di sola lettura.
-
Funzionamento chiamata: le impostazioni sono di sola lettura.
-
Posizione > PSTN: le opzioni gateway locale e Cisco PSTN sono nascoste.
-
-
In SERVIZI, le opzioni di servizio Migrazioni e Connected UC sono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori dei partner possono utilizzare la procedura seguente per abilitare l'opzione Con limitazioni della modalità partner per una determinata organizzazione cliente (l'impostazione predefinita è abilitata).
-
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
-
Selezionare l'organizzazione del cliente applicabile.
-
Nella vista delle impostazioni a destra, abilitare l'interruttore Limitato dalla modalità partner per attivare l'impostazione.
Se si desidera disattivare Limitazione della modalità partner, disabilitare l'interruttore.
Se il partner rimuove la modalità di amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà effettuare le seguenti operazioni:
-
Aggiungi utenti Webex per Wholesale (con il pulsante)
-
Modifica pacchetti per un utente
Per ulteriori informazioni sull'elenco dei fusi orari supportati per il provisioning Wholesale, vedere Elenco dei fusi orari supportati per il provisioning Wholesale.
Analisi partner
I miglioramenti apportati a Control Hub rendono semplice agli amministratori dei partner visualizzare e aggiornare le informazioni del pacchetto per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata tra tutti i clienti e include i seguenti dettagli:
-
Totale utenti per pacchetto (Softphone, Basic, Standard, Premium)
-
Tendenza utenti per pacchetto (giornaliera/settimanale/mensile)
-
Clienti con n. di pacchetti assegnati
Per dettagli completi sull'uso della funzionalità di analisi dei partner, vedere l'articolo Webex Analytics per Webex per i pacchetti Eseeme e Webex per pacchetti Broadworks in Partner Hub.
API report di fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per i report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare i report di fatturazione. Nella tabella riportata di seguito vengono elencate le API, il tipo di accesso richiesto e i requisiti del ruolo.
API di fatturazione |
Scopo |
Tipo di accesso |
Requisito del ruolo per API (l'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Crea un report di fatturazione BroadWorks |
Utilizzato per generare un report di fatturazione. |
Accesso di scrittura |
|
Elenca report di fatturazione BroadWorks |
Utilizzato per elencare i report disponibili per la visualizzazione. |
Accesso di lettura |
|
Come ottenere un report di fatturazione BroadWorks |
Utilizzato per ottenere una copia di un report generato. |
Accesso di lettura |
|
Eliminazione di un report di fatturazione BroadWorks |
Utilizzato per eliminare un report generato. |
Accesso di scrittura |
|
Campi di fatturazione
Nella tabella seguente vengono elencati i campi contenuti nel report generato.
Campo |
Descrizione |
---|---|
Nome rivenditore |
Nome partner o ID organizzazione partner |
ID fatturazione |
Identificativo di fatturazione univoco partner o numero C |
ID spEnterprise |
Identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno |
Stato della versione di prova interna del cliente (Sì/No) |
ID utente |
L'ID utente dell'abbonato su BroadWorks |
ID abbonato |
Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato |
Sì/No |
primaDataInizio |
Data di provisioning dell'abbonato. |
Data di inizio fatturazione |
Data di inizio della fatturazione in questo mese |
Data di fine fatturazione |
Data di fine della fatturazione in questo mese |
pacchetto |
Tipo di pacchetto che viene addebitato |
quantità |
Quantità proporzionale per la fatturazione.
|
-
Una volta generato un report di fatturazione per un determinato periodo di tempo, non è possibile rigenerare tale report a meno che non si elimini prima il report esistente.
-
Se si modifica il tipo di pacchetto o l'ID utente BroadWorks per un determinato utente, il report del mese in cui si è verificata la modifica mostra più voci per tale utente con voci proporzionali separate prima e dopo la modifica.
Risoluzione dei problemi di Webex per Cisco BroadWorks
Iscrizione alla pagina di stato Webex
Innanzitutto, https://status.webex.com verificare se si verifica un'interruzione imprevista del servizio. Se non è stata modificata la configurazione in Control Hub o BroadWorks prima dell'interruzione, controllare la pagina di stato. Per ulteriori informazioni sulla sottoscrizione per lo stato e le notifiche di incidenti, vedere il Centro di assistenza Webex.
Uso della funzionalità di analisi di Control Hub
Webex tiene traccia dei dati di utilizzo e qualità per la propria organizzazione e per le organizzazioni dei clienti. Ulteriori informazioni sulla funzionalità di analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
I clienti o gli utenti non vengono creati in Control Hub con provisioning flow provisioning:
-
Il server dell'applicazione può raggiungere l'URL di provisioning?
-
L'account di provisioning e la password sono corretti, se esistono in BroadWorks?
I cluster non riescono regolarmente con i test di connettività:
La connessione mTLS al servizio di autenticazione dovrebbe non riuscire quando si crea il primo cluster in Partner Hub poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. Senza questo, non è possibile creare un trust anchor sugli ADP XSP| del servizio di autenticazione, quindi la connessione mTLS di test da Partner Hub non viene eseguita correttamente.
-
Le interfacce XSP|ADP sono accessibili pubblicamente?
-
Si stanno utilizzando le porte corrette? È possibile inserire una porta nella definizione dell'interfaccia sul cluster.
Convalida interfacce non riuscita
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano stati inseriti correttamente sul cluster in Partner Hub, incluso
/v2.0
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Esaminare l'avviso di configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano stati inseriti correttamente sul cluster in Partner Hub, incluso
/v2.0
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Rivedere i consigli di configurazione dell'interfaccia in questo documento, con particolare attenzione su:
- Accertarsi di aver condiviso le chiavi RSA tra tutte le ADP XSP|.
- Accertarsi di aver fornito l'URL AuthService al container Web su tutti gli ADP XSP|.
- Se è stata modificata la configurazione di crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'ADP XSP| richiede l'inserimento del formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento indicava in modo errato le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
-
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati nell'archivio attendibilità XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere certificati client?
-
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere certificati client?
Problemi del client
Verificare che il client sia connesso a BroadWorks
-
Accedere all'app Webex.
-
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.
-
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici. Viene visualizzato lo stato della SSO è stato eseguito l'accesso.
Se viene visualizzato un altro servizio telefonico, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Ciò significa:
-
Il client ha transverso correttamente i microservizi Webex richiesti.
-
L'utente è stato autenticato correttamente.
-
Il client è stato emesso un token Web JSON a lungo termine dal sistema BroadWorks.
-
Il client ha recuperato il profilo del dispositivo ed è registrato per BroadWorks.
Registri client
Tutti i client app Webex possono inviare log a Webex. Questa è l'opzione migliore per client mobili. È necessario registrare anche l'indirizzo e-mail dell'utente e l'ora approssimativa del problema, se si desidera assistenza dal Tac. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se occorre raccogliere manualmente i registri da un PC Windows, si trovano nel seguente modo:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac: /Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS non configurata correttamente
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
-
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
-
Verificare che la catena di certificati Webex sia installata come trust anchor.
-
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e che sia firmato da un'autorità di certificazione attendibile.
Messaggio interruzione licenza
Questo messaggio può essere visualizzato per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'uso della licenza supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Criteri di supporto stato originale
Il provider di servizi è il primo punto di contatto per il supporto clienti finale (enterprise). Inoltrare i problemi che il SP non può risolvere al TAC. Il supporto della versione server BroadWorks segue i criteri della Versione corrente e delle due precedenti versioni principali (N-2). Ulteriori informazioni sono disponibili nella sezione Criteri per il ciclo di vita dei prodotti BroadSoft in Criteri per il ciclo di vita di BroadSoft e Matrice di compatibilità software BroadWorks.
Criteri di escalation
-
L'utente (provider di servizi/partner) è il primo punto di contatto per il supporto dei clienti finali (enterprise).
-
I problemi che non possono essere risolti dal SP vengono inoltrati al TAC.
Versioni BroadWorks
-
Il supporto della versione server BroadWorks segue i criteri di BroadSoft, della versione corrente e delle due versioni principali precedenti (N-2). Ulteriori informazioni sono disponibili nella sezione Criteri per il ciclo di vita dei prodotti BroadSoft in Criteri per il ciclo di vita di BroadSoft e Matrice di compatibilità software BroadWorks.
Risorse di self-support
-
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, in cui è disponibile una pagina specifica di Webex per Cisco BroadWorks che elenca la Guida per l'app Webex comune e gli argomenti di supporto.
-
È possibile personalizzare l'app Webex con questo URL della Guida e un URL per la segnalazione di problemi.
-
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I log vengono nel cloud Webex, dove possono essere analizzati da Webex DevOps.
-
È disponibile anche una pagina del Centro assistenza dedicata alla guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccolta delle informazioni per l'invio di una richiesta di assistenza
Quando si visualizzano errori in Control Hub, è possibile che siano state allegati informazioni che consentono al Tac di ricercare la causa del problema. Ad esempio, se viene visualizzato un ID di verifica per un determinato errore o un codice di errore, salvare il testo da condividere con noi.
Provare a includere almeno le seguenti informazioni quando si invia una query o si apre un caso:
-
ID organizzazione cliente e ID organizzazione partner (ciascun ID è una stringa di 32 cifre esadecimali, separate da trattini)
-
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce una
-
Indirizzo e-mail utente (se si verificano problemi con un determinato utente)
-
Versioni del client (se il problema presenta sintomi notati attraverso il client)
Webex per riferimento a BroadWorks
Confronto DI UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > |
UC-One SaaS |
Webex per Cisco BroadWorks |
---|---|---|
Cloud |
Cisco UC-One Cloud (GCP) |
Cloud Webex (APPLICAZIONI WEBEX) |
Client |
UC-One: Mobile, Desktop Receptionist, Supervisore |
Webex: Mobile, Desktop, Web |
Principale differenza tecnologia |
Riunioni consegnate su Broadsoft Meet Technology |
Riunioni consegnate su Webex Meetings Technology |
Versioni di prova sul campo iniziali |
Ambiente di gestione temporanea, client Beta |
Ambiente di produzione, client GA |
Identità utente |
BroadWorks ID utilizzato come ID principale, a meno che provider di servizi sito non SSO già.
ID utente e segreto in BroadWorks |
ID e-mail in Cisco CI serve come ID principale SSO integrazioni in provider di servizi BroadWorks in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks in quel momento.
L'utente fornisce le credenziali tramite SSO broadworks e secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e autenticazione nel provider di identità |
Autenticazione client |
Gli utenti forniscono le credenziali tramite il client Token a lungo accesso BroadWorks richiesti se si utilizza la messaggistica Webex |
Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso e aggiornamento dei token Webex |
Gestione/configurazione |
I sistemi ANDR E BSS e Portale rivenditore |
SISTEMI CUI/BSS e Control Hub |
Attivazione partner/provider di servizi partner |
Una sola impostazione per Cisco Operations |
Una sola impostazione per Cisco Operations |
Attivazione cliente/aziendale |
Portale rivenditore |
Control Hub Creazione automatica alla prima iscrizione utente |
Opzioni di attivazione utente |
Auto iscrizione Impostazione di IM&P esterno in BroadWorks
|
Impostazione di Integrated IM&P in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP |
Azioni XSI
Eventi XSI CTI (mTLS) AuthService (mTLS opzionale) DMS |
Azioni XSI Azioni XSI (mTLS) Eventi XSI CTI (mTLS) AuthService (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 |
Scaricare e installare Webex. Per dettagli, vedere Webex | Download dell'app. |
2 |
Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 |
Inserire il proprio indirizzo e-mail e fare clic su Next(Avanti). |
4 |
In base alla configurazione dell'organizzazione in Webex, si verificano le seguenti operazioni: Webex viene caricato dopo aver eseguito correttamente l'autenticazione per IdP o BroadWorks.
|
Scambio dati e storage
Queste sezioni forniscono dettagli sullo scambio di dati e sullo storage con Webex. Tutti i dati sono crittografati sia in viaggio che a riposo. Per ulteriori dettagli, vedere Sicurezza app Webex.
provider di servizi ilboarding
Quando si configurano cluster e modelli utente in Webex Control Hub durante provider di servizi onboarding, si scambiano i seguenti dati BroadWorks memorizzati da Webex:
-
URL azioni Xsi
-
Xsi-Events URL
-
URL interfaccia CTI
-
URL servizio di autenticazione
-
Credenziali dell'adattatore provisioning BroadWorks
provider di servizi provisioning utente
Questa tabella elenca i dati utente ed aziendale s scambiati come parte del provisioning degli utenti attraverso le API Webex.
Trasferimento dati a Webex |
Da |
Attraverso |
Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito da SP) |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito dall'utente) |
Utente |
Portale di attivazione utente |
Sì |
Nome |
BroadWorks, per API |
API Webex |
Sì |
Cognome |
BroadWorks, per API |
API Webex |
Sì |
Numero di telefono principale |
BroadWorks, per API |
API Webex |
Sì |
Numero telefono cellulare |
BroadWorks, per API |
API Webex |
Sì |
Estensione principale |
BroadWorks, per API |
API Webex |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
BroadWorks, per API |
API Webex |
Sì |
Lingua |
BroadWorks, per API |
API Webex |
Sì |
Fuso orario |
BroadWorks, per API |
API Webex |
Sì |
Rimozione utente
Webex per api Cisco BroadWorks supporta la rimozione parziale e completa degli utenti. Questa tabella elenca tutti i dati utente archiviati durante il provisioning e ciò che viene eliminato in ciascuno scenario.
Dati utente |
Eliminazione parziale |
Eliminazione completa |
---|---|---|
ID utente BroadWorks |
Sì |
Sì |
|
No |
Sì |
Nome |
No |
Sì |
Cognome |
No |
Sì |
Numero di telefono principale |
Sì |
Sì |
Numero telefono cellulare |
Sì |
Sì |
Interno |
Sì |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
Sì |
Sì |
LANGUAGE |
No |
Sì |
Recupero accesso utente e configurazione
Autenticazione Webex
L' autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da parte di uno qualsiasi dei meccanismi di autenticazione di supporto Webex. (L' autenticazione BroadWorks è trattata separatamente.) Questa tabella mostra il tipo di dati scambiati tra i diversi componenti sul flusso di autenticazione.
Spostamento dei dati |
Da |
A |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (indipendente) |
Webex |
Browser utente |
Credenziali utente |
Browser utente |
Provider di identità (che dispone già di identità utente) |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Autenticazione BroadWorks
Per autenticazione BroadWorks si intende l'accesso dell'utente a un'app Webex utilizzando le relative credenziali BroadWorks. Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti del flusso di autenticazione.
Spostamento dei dati |
Da |
A |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (proxy IdP Webex Bwks) |
Webex |
Browser utente |
Informazioni sul branding e URL BroadWorks |
Webex |
Browser utente |
Credenziali utente BroadWorks |
Utente attraverso il browser (pagina di accesso con branded servita da Webex) |
Webex |
Credenziali utente BroadWorks |
Webex |
BroadWorks |
File BroadWorks profilo utente |
BroadWorks |
Webex |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento del messaggio di avviso ed errore di accesso:
- Attualmente, gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e eseguono l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso perché la password è già scaduta. Con questa funzione, se la password sta per scadere entro 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere con l'indicazione del numero di giorni rimanenti e viene consigliato di contattare il Partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione 'enforcePasswordChangeOnExpiry' in BroadWorks è impostata su true, l'errore "nome utente e password errati" è stato lanciato, ma ora con questa funzione il messaggio di errore è stato migliorato: Tentativo di accesso non riuscito. La combinazione dell'ID utente e della password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice di errore 100006
Controlla flusso di accesso:
- Il partner può limitare l'accesso abilitando l'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione di BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, viene visualizzato un errore dicendo che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso è configurabile dal partner come parte del branding personalizzato: Personalizzazione avanzata. I partner devono configurare il collegamento per reindirizzare gli utenti al portale del partner per la gestione e la reimpostazione delle password.
Questa funzione migliora solo l'esperienza di accesso utente durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se la password scade mentre l'utente è connesso all'app Webex. L'utente riceverà una notifica relativa alla scadenza della password al successivo tentativo di accesso.
Recupero configurazione client
Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti nel recupero delle configurazioni del client.
Spostamento dei dati |
Da |
A |
---|---|---|
Iscrizione |
Client |
Webex |
Impostazioni dell'organizzazione, inclusi gli URL BroadWorks |
Webex |
Client |
Token BroadWorks JWORKS |
BroadWorks attraverso Webex |
Client |
Token BroadWorks JWORKS |
Client |
BroadWorks |
Token dispositivo |
BroadWorks |
Client |
Token dispositivo |
Client |
BroadWorks |
File di configurazione |
BroadWorks |
Client |
Utilizzo stato originale
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione in seguito alla scadenza del token attraverso BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Spostamento dei dati |
Da |
A |
---|---|---|
Segnalazione SIP |
Client |
BroadWorks |
Contenuto multimediale SRTP |
Client |
BroadWorks |
Segnalazione SIP |
BroadWorks |
Client |
Contenuto multimediale SRTP |
BroadWorks |
Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Spostamento dei dati |
Da |
A |
---|---|---|
Messaggistica e presenza HTTPS REST |
Client |
Webex |
Messaggistica e presenza HTTPS REST |
Webex |
Client |
Segnalazione SIP |
Client |
Webex |
Contenuto multimediale SRTP |
Client |
Webex |
Segnalazione SIP |
Webex |
Client |
Contenuto multimediale SRTP |
Webex |
Client |
Uso dell'API di provisioning
Accesso sviluppatore
La specifica API è disponibile su https://developer.webex.com e una guida all'uso è su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l'accesso per leggere la specifica API su https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Autenticazione e autorizzazione dell'applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (come il provisioning del sottoscrittore) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere i token di aggiornamento e di accesso per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
È necessario prima registrare l'integrazione con Webex. Una volta registrata, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di aggiornamento e accesso necessari.
Per ulteriori informazioni sulle integrazioni e su come creare questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli richiesti per l'implementazione delle integrazioni, lo sviluppatore e l'utente che ha autorizzato, e possono essere tenute da persone/team separati nel proprio ambiente.
-
Lo sviluppatore crea l'app e la registra su per generare il ClientID/Secret OAuth richiesto con gli ambito previsti per https://developer.webex.com l'applicazione. Se l'applicazione è stata creata da terze parti, potrebbe registrare l'applicazione (se è stato richiesto l'accesso) o è possibile farlo con il proprio accesso.
-
L'utente autorizzato è l'account che l'applicazione utilizza per autorizzare le chiamate API, per modificare l'organizzazione partner, le organizzazioni dei clienti o i relativi abbonati. Questo account deve avere il ruolo di amministratore completo o amministratore completo di vendite nell'organizzazione partner. Questo account non deve essere mantenuto da terze parti.
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning in uso:
-
Modalità Enterprise: il nome organizzazione è una corrispondenza esatta di spEnterpriseId.
-
Modalità provider di servizi: il nome organizzazione è la parte ID gruppo di spEnterpriseId.
Il nome dell'organizzazione contiene spazi vuoti, caratteri maiuscoli e speciali specificati nel spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "patch current" con le ultime patch BroadWorks e le app RI (Release Independent). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Accertarsi di esaminare le note di patch per queste patch software. Alcune patch potrebbero richiedere ulteriori requisiti CLI.
Versione R22
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione | ||
Obbligatorio per sincronizzazione rubriche | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Patch richiesta per il server applicazioni | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Patch richiesta per funzione di registrazione chiamata | ||
Patch richiesta per provisioning flow-through | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Server dei profili | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Piattaforma | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il servizio di autorizzazione con convalida del token CI | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
XSP|ADP |
Richiesto per il proxy di autenticazione NPS | |
Richiesto per il servizio di autorizzazione con convalida del token CI | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il servizio di autorizzazione con convalida del token CI | ||
Obbligatorio per Cronologia chiamate Unified | ||
Altro |
AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione |
Obbligatorio per sincronizzazione rubriche | |
Server app di configurazione | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Obbligatorio per la registrazione della chiamata | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Server dei profili | ||
Piattaforma | ||
Richiesto per il proxy di autenticazione NPS | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
XSP|ADP | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il proxy di autenticazione NPS | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Altro |
Se si utilizza ADP... |
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata |
Versione R24
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione |
Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per provisioning a flusso costante | ||
Obbligatorio per la registrazione della chiamata | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Altro |
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che devi configurare per Webex, fai riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utenti e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. Attivazione include la convalida e-mail e l'assegnazione del servizio in Webex.
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se si dispone di indirizzi e-mail attendibili per gli utenti, è possibile scegliere di attivarli automaticamente quando vengono predisposti automaticamente. Questo processo è di "provisioning automatico e attivazione automatica".
Provisioning utenti automatizzato e attivazione automatica (flusso e-mail attendibile)
Prerequisiti
-
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
-
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
-
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase |
Descrizione |
---|---|
1 |
Si preventiva ed si eserviranno gli ordini per il servizio con i clienti. |
2 |
L'ordine del cliente viene processato ed è stato predisposto il cliente nel sistema. |
3 |
Il sistema di provisioning del servizio attiva il provisioning di BroadWorks. Questa operazione, in riepilogo, crea l'azienda e gli utenti. Quindi, assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM esterno. |
4 |
Questa operazione di provisioning attiva il provisioning automatico dell'organizzazione e degli utenti del cliente in Webex. (L'assegnazione del servizio IM&P causa la chiamata dell'adattatore di provisioning all'API di provisioning Webex). |
5 |
I sistemi devono utilizzare l'API di provisioning Webex se in seguito occorre regolare il pacchetto per l'utente (per effettuare una modifica rispetto al valore predefinito). |
SSO di accesso
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, consentendo l'autenticazione diretta a BroadWorks. L'immagine visualizza gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresentano ciò che il client fornisce per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizi BroadWorks che segue immediatamente dal flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione diretta BroadWorks abilitata (condivisione risorse multi-origine). Di seguito sono riportati alcuni flussi di SSO SAML alternativi:
-
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
-
L'unica differenza è nel punto 5 e 6 del flusso di accesso Webex. Nel punto 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
-
Il flusso procede attraverso le operazioni restanti nei due diagrammi.
-
Il SSO di registrazione non è utilizzato in questo flusso.
-
-
Autenticazione Webex SSO SAML:
-
Al punto 3 del flusso di accesso Webex, il servizio Common Identity servizi restituisce il provider di identità utilizzato dall'autenticazione Webex.
-
A questo punto, viene richiamato un flusso di SSO SAML alternativo per Webex.
-
Interazioni utente
Accedi
-
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
-
CI rileva che l'organizzazione cliente associata ha il proxy IDP BroadWorks configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso. Il provider di servizi può personalizzare questa pagina di accesso.
-
L'utente inserisce le proprie credenziali BroadWorks.
-
Broadworks autentica l'utente attraverso l'IDP. In caso positivo, IDP reindirizza il browser a CI con un SISTEMA SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
-
In caso di autenticazione eseguita correttamente, l'app Webex ottiene i token di accesso da CI (non mostrato nel diagramma). Il client le utilizza per richiedere un token JNTASSI (Jason Web Token) BroadWorks.
-
L'app Webex rileva la configurazione di chiamata da BroadWorks e da altri servizi di Webex.
-
L'app Webex si registra con BroadWorks.
Accesso dal punto di vista dell'utente
Questo diagramma è il flusso di accesso tipico, visualizzato dall'utente finale o dall'abbonato:
-
L'app Webex viene scaricata e installata.
-
È possibile che sia stato ricevuto il collegamento dal proprio provider di servizi oppure il download potrebbe essere trovato sulla pagina di download di Webex.
-
L'indirizzo e-mail viene inserito nella schermata di accesso di Webex. Fare clic su Avanti.
-
Solitamente, si viene reindirizzati a una provider di servizi a cui viene visualizzata una pagina con marchio.
-
Questa pagina potrebbe dare il benvenuto mediante il proprio indirizzo e-mail.
Se non si dispone di un indirizzo e-mail o se l'indirizzo e-mail è errato, inserire l'indirizzo nome utente BroadWorks.
-
Inserire la password BroadWorks.
-
Se è stato eseguito correttamente l'accesso, Webex si apre.
flusso chiamata: rubrica aziendale
flusso chiamata—PSTN cliente
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni client
Recupera profilo da REGISTRAZIONE DMS e SIP con AS
-
Il client chiama XSI per ottenere un token di gestione dispositivi e l'URL sul DMS.
-
Il client richiede il profilo del dispositivo dal DMS presentando il token dal punto 1.
-
Il client legge il profilo del dispositivo e recupera le credenziali SIP, gli indirizzi e le porte.
-
Il client invia un SIP REGISTER al controller SBC utilizzando le informazioni del punto 3.
-
SBC invia il SIP REGISTER ad AS (il controller SBC può eseguire una ricerca in NS per individuare un AS se SBC non conosce già l'utente SIP).
Linee guida di test e laboratorio
Le seguenti linee guida si applicano a organizzazioni di test e laboratorio:
-
provider di servizi partner sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
-
La fatturazione verrà addebitata a qualsiasi utente oltre i primi 50 utenti di prova.
-
Per assicurare un'elaborazione precisa della fattura, tutte le organizzazioni di test devono includere 'test' nel nome dell'organizzazione BroadWorks.
-
Le organizzazioni di test interne devono essere designate all'interno Webex Control Hub. Al fine di evitare che gli utenti di prova vengano fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di test:
-
Accedere all'hub partner e selezionare Clienti.
-
Selezionare il cliente appropriato.
-
Nella barra di controllo a destra, abilitare l'interruttore Organizzazione test interna.
Riproduzione segreteria telefonica
Per la segreteria telefonica, accertarsi di configurare il server multimediale per l'uso di uno dei seguenti codici:
-
mp3
-
wav— I file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android)
Se si utilizzano file wav, eseguire i seguenti comandi CLI per verificare il server dell'applicazione e server multimediale:
-
AS_CLI/Service/VoiceMsg>imposta vmRecordingAudioFileFormat WAV
-
MS_CLI/Applications/MediaStreaming/Services/IVR> imposta sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACL
- Elenco di controllo accessi
- ALG
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APNS
- Utenti Apple servizio di notifica push
- AS
- Server applicazione
- ATA
- Adattatore telefono analogico, adattatore per la conversione della telefonia analogica VoIP
- BAM
- Gestione applicazioni BroadSoft
- Autenticazione di base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- BMS
- Server di messaggistica BroadSoft
- BOSH
- Flussi bidirezionale su HTTP sincrono
- BRI
- L'interfaccia BRI (Basic Rate Interface) è un metodo di accesso ISDN
- Bundle
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico di telefonia (cf. partner, provider di servizi, rivenditore aggiunto valore)
- CAPTCHA
- Test del turing pubblico completamente automatizzato per incisire sui computer e sull'humans apart
- CODICE CCXML
- Controllo chiamata EXtensible Markup Language
- CIF
- Formato intermedio comune
- CLI
- Interfaccia della riga di comando
- CN
- Nome comune
- CSP
- Server push notifiche chiamate. Un server push notifiche eseguito su un ADP XSP| nell'ambiente, per eseguire il push delle notifiche di chiamata a FCM e APNS. Vedere Proxy NPS.
- CPE
- Apparecchiatura locale del cliente
- CPR
- Regola di presenza personalizzata
- CSS
- Foglio di stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione di telefonia su computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- Non disturbare
- Non disturbare
- DNS
- Sistema di nomi di dominio
- DPG
- Chiama gruppo peer
- DSCP
- Punto codici servizi differenziati
- DTAF
- File di archivio del tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza dual-tone
- Utente finale
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. per l'abbonato)
- Aziendale
- Un gruppo di utenti finali (cf. organizzazione)
- FCM
- Messaggistica cloud Firebase
- FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creazione di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning flow-through completo
- Creazione e verifica di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks e l'asserzione che ciascun utente BroadWorks ha un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. Il plug-on del telefono o del fax o i plug-in sul sistema telefonico analogico. Fornisce un'indicazione di hook/off-hook (chiusura loop). Poiché la porta BLUETOOTH è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo BLUETOOTH".
- FXS
- Foreign Exchange Subscriber è la porta che consegna effettivamente la linea analogica al sottoscrittore. In altre parole, è il plug-in alla parete che offre un segnale di chiamata, una corrente a batteria e una suoneria.
- GCM
- Messaggio Google Cloud
- GCM
- Modalità Galois/Counter Mode (tecnologia di crittografia)
- NASCOSTO
- Dispositivo interfaccia utente
- HTTPS
- Protocollo di trasferimento ipertestuale socket sicuri
- IAD
- Dispositivo di accesso integrato
- IM&P
- Messaggistica immediata e presenza
- IP PSTN
- Un provider di servizi che fornisce VoIP servizi PSTN, intercambiabili con ITSP, o un termine generale per la telefonia 'pubblica' collegata da Internet, collettivamente fornito dai principali fornitori di telecomunicazioni (anziché tramite paesi, come PSTN è)
- ITSP
- Servizi di telefonia Internet provider di servizi
- IVR
- Risposta vocale interattiva/Risponditore
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificativo Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notifica oggetto Java Script
- JSSE
- Estensione socket sicura Java; la tecnologia sottostante che fornisce funzioni di connettività sicura ai server BroadWorks
- KEM
- Modulo di estensione chiave (telefoni Cisco hardware)
- LLT
- Token lungo(o long life); una forma di auto-descrizione, sicura di token di connessione che consente agli utenti di rimanere autenticati per più tempo e non è legata a applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIB
- Base informazioni di gestione
- MS
- Server multimediale
- Mtls
- Autenticazione reciproca tra due parti, mediante lo scambio di certificati, quando si stabilisce una connessione TLS
- MUC
- Chat multi-utente
- NAZ
- Traduzioni indirizzi di rete
- NPS
- Server push di notifica; vedere CNPS
- NPS Proxy
-
Servizio in Webex che fornisce token di autorizzazione breve al CNPS, abilitando il push delle notifiche di chiamata su FCM e APNs e, infine, sui dispositivi Android e iOS che eseguono Webex.
- OCI
- Apri interfaccia client
- Organizzazione
- Una società o un'organizzazione che rappresenta un gruppo di utenti finali (cf. Enterprise)
- OTG
- Gruppo trunk in uscita
- Pacchetto
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. Bundle)
- Partner
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. Valore aggiunto rivenditore, provider di servizi, vettore)
- PBX
- Exchange su succursale privato
- PEM
- Messaggio e-mail avanzato sulla privacy
- PLMN
- Rete mobile su rete pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia di telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- PS
- Server dei profili
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Un sito Web che consente all'amministratore del rivenditore di configurare la propria soluzione UC-One SaaS. Talvolta è noto come portale BANG, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Controllo bordo sessione
- SCA
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; Un'organizzazione che fornisce servizi telefonici o correlati ad altre organizzazioni (cf. Gestore telefonico, partner, rivenditore aggiunto valore)
- SIP
- SIP (Session Initiation Protocol)
- SLT
- Token breve (o breve durata) (denominato anche token SSO BroadWorks); un token autenticato a uso singolo utilizzato per ottenere l'accesso protetto alle applicazioni Web.
- SMB
- Piccola e media azienda
- SNMP
- Semplice protocollo di gestione della rete
- sRTCP
- protocollo Secure Realtime Transfer Control Protocol (VoIP multimediale per chiamate in tempo reale)
- sRTP
- protocollo Secure Realtime Transfer Protocol (VoIP multimediale di chiamata)
- SSL
- Livello socket sicuri
- Abbonato
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. Utente finale)
- TCP
- Protocollo di controllo trasmissione
- TDM
- Multiplexing divisione temporale
- TLS
- Sicurezza livello di trasporto
- Tos
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Unified Communications
- UI
- Interfaccia utente
- UID
- Identificativo univoco
- UMS
- Server di messaggistica
- URI
- Uniform Resource Identifier
- URL
- Localizzatore risorse uniforme
- USS
- Server di condivisione
- UTC
- Coordinated Universal Time
- UV
- Video Server
- Rivenditore aggiunto valore (VAR)
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. vettore, partner, provider di servizi)
- VGA
- Array di elementi grafici video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Voice Extensible Markup Language
- Webdav
- Creazione e versione per Web distributed authoring
- WebRTC
- Comunicazioni in tempo reale Web
- WRS
- WebRTC Server
- XMPP
- Protocollo di messaggistica e presenza Estendi
Appendice
Configurazione dei servizi (con mTLS per il servizio di autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida di token CI. Queste procedure sono obbligatorie se si utilizzano più organizzazioni Webex sullo stesso server ADP XSP|. Altrimenti, sono opzionali.
|Se non si utilizzano più organizzazioni Webex sullo stesso server ADP XSP, si consiglia la convalida del token CI (con TLS) per il servizio di autorizzazione. Riferimento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs per informazioni dettagliate sulla configurazione del servizio di autenticazione e di altri servizi.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi connettori Cisco BroadWorks.
È necessario distribuire solo un'istanza delle applicazioni Xsi-Events sull'ADP XSP| utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso callControlApplicationName definito in Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> ottenere
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente è inserito in Webex, Webex crea un abbonamento per l'utente sul AS per ricevere gli eventi di telefonia per la cronologia della presenza e delle chiamate. L'abbonamento è associato a callControlApplicationName e il AS lo utilizza per sapere a quali Xsi-Events inviare gli eventi di telefonia.
La modifica del callControlApplicationName o il mancato nome di tutte le app Web Xsi-Events avranno impatto sugli abbonamenti e sulla funzionalità degli eventi di telefonia.
Configurazione del servizio di autenticazione (con mTLS)
I token di lunga durata BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sulle ADP XSP|.
Requisiti
-
I server ADP XSP| che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
-
Gli ADP XSP| devono condividere le stesse chiavi per la crittografia/decrittografia dei token BroadWorks di lunga durata. Copiare queste chiavi a ciascun ADP XSP| è un processo manuale.
-
Gli ADP XSP| devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli ADP XSP| include:
-
Distribuire il servizio di autenticazione.
-
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
-
Genera e condividi chiavi RSA tra ADP XSP|.
-
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ciascun ADP XSP| utilizzato con Webex:
-
Attivare l'applicazione del servizio di autenticazione sul
percorso /authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> attiva servizio di autenticazione applicazione /authService
(dove
è la versione di BroadWorks).
-
Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
distribuisci applicazione /authService
Configurazione della durata del token
-
Controllare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
-
Impostare la durata su 60 giorni (il massimo è 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
imposta tokenDurationInHours 1440
Genera e condividi chiavi RSA
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittografia di token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori, è necessario generare chiavi su un ADP XSP|e copiarle in tutti gli altri ADP XSP|.
Se si alterano i tasti o si modifica la lunghezza della chiave, è necessario ripetere la configurazione seguente e riavviare tutte le ADP XSP|.
-
Selezionare un ADP XSP| da utilizzare per la generazione di una coppia di chiavi.
-
Utilizzare un client per richiedere un token crittografato all'ADP XSP|, richiedendo il seguente URL dal browser del client:
|https:///authService/token?key=BASE64URL(clientPublicKey)
(viene generata una coppia di chiavi privata/pubblica su ADP XSP|, se non ne era già presente una)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
-
Copiare il file esportato
/var/broadworks/tmp/authService.keys
nella stessa posizione sugli altri ADP XSP|, sovrascrivendo un file.keys
precedente, se necessario. -
Importa le chiavi su ciascuno degli altri ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al container Web
Il container Web di ADP XSP| richiede l'URL authService in modo da poter convalidare i token.
Su ciascuno degli ADP XSP|:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per lo strumento di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
imposta URL http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> aggiungi tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Controllare il parametro con
get
. -
Riavviare ADP XSP|.
Configurazione di TLS e della crittografia sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurazione TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > trasporto > http > interfaccia Server HTTP = Più specifico
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il
comando get e leggere i
risultati. Dovrebbero essere presenti le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Tomcat obbligatorio un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> ottenere
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
È necessario configurare l'interfaccia HTTP che interagisce con Webex Cloud per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Inserire il comando
get 443
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserisci il comando
aggiungi 443 TLSv1.2
per assicurarti che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia del server HTTP
Per configurare i crittografia richiesti:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Inserire il comando
get 443
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements (Requisiti di sicurezza e identità XSP) nella sezione Overview). -
Inserire il comando
add 443
per aggiungere una crittografia all'interfaccia del server HTTP.IL CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
del server HTTP, utilizzare:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>aggiungi 192.0.2.7 443 TLS_ECDHE_ECDSA_CON_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità del servizio di autenticazione (con mTLS)
-
Accedere a Control Hub con l'account dell'amministratore del partner.
-
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain .txt
sul computer locale.Questi file contengono due set di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori. -
Suddividere la catena di certificati in due certificati:
combinedcertchain .txt
.-
Aprire
combinedcertchain .txt
in un editor di testo. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e -----END CERTIFICATE----- , e incollare il blocco di testo in un nuovo
file. -
Salvare il nuovo file come
root .txt
. -
Salvare il file originale come
emissione di .txt
. Il file originale ora deve contenere solo un blocco di testo, racchiuso tra lerighe -----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copiare entrambi i file di testo in una posizione temporanea sull'ADP XSP| che si sta proteggendo, ad esempio,
/var/broadworks/tmp/root .txt
e/var/broadworks/tmp/issuing .txt
. -
Accedere a XSP|ADP e passare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Eseguire la guidaUpdateTrust
per visualizzare i parametri e il formato del comando. -
Carica i file dei certificati sui nuovi trust anchor - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot /var/broadworks/tmp/root .txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing /var/broadworks/tmp/issuing .txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot
,webexclientissuing
ewebexclientissuing
sono alias di esempio per i trust anchor; puoi utilizzare i tuoi alias purché tutte e quattro le voci siano univoche. -
Confermare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> ottenere
Alias Proprietario emittente ============================================================================= webexclientissuing Internal Private TLS SubCA Internal Private Root webexclientroot Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate sull'ADP XSP|. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, mTLS è richiesto per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
-
Accedere all'ADP XSP| di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
ed eseguire il comandoget
per visualizzare le interfacce. -
Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che corrisponde a mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> aggiungi nome porta IPAddress true true
Per informazioni dettagliate, vedere la documentazione CLI XSP ADP|CLI. Essenzialmente, la prima true protegge l'interfaccia con TLS (il certificato server viene creato se richiesto) e la seconda forza true l'interfaccia a richiedere l'autenticazione del certificato
client
(insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> ottenere
Nome porta interfaccia Secure Client Auth Req Cluster Fqdn ======================================================= 192.0.2.7 443 XSP|ADP01.collab.example.net true false 192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (Client Auth Req = true) è abilitato sulla porta 192.0.2.7
444.
TLS è abilitato sulla porta 192.0.2.7
443.
(Opzione) Configurare mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate sull'ADP XSP|. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, mTLS è richiesto per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
-
Accedere all'ADP XSP| di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
ed eseguire il comandoget
per visualizzare le applicazioni in esecuzione. -
Per aggiungere un'applicazione e richiedere l'autenticazione del client (che significa lo stesso di mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiungi nome applicazione porta IPAddress true
Per informazioni dettagliate, vedere la documentazione CLI XSP ADP|CLI. I nomi delle applicazioni sono elencati in questo elenco. Vero
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiunge 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService alla versione 192.0.2.7:443 e richiede che a tale applicazione sia richiesta e autenticata dal client.
Controlla con ottieni
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> ottieni
Interfaccia Porta IP Nome applicazione Client Autenticazione ======================================================
192.0.2.7 443 AuthenticationService true
Configura gestione dispositivi su XSP|ADP, server applicazioni e server di profilo
Il server di profilo e l'ADP XSP| sono obbligatori per la gestione dei dispositivi. Tali impostazioni devono essere configurate in base alle istruzioni nella Guida alla configurazione di Gestione dispositivi BroadWorks.
Dove andare avanti
Per la configurazione, è possibile accedere nuovamente al flusso del documento principale all'indirizzo Interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca con AuthService
Webex interagisce con il servizio di autenticazione su (autenticazione) TLS reciproca connessione autenticata. Ciò significa che Webex presenta un certificato client e l'ADP XSP|deve convalidarlo. Per certificare l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora di attendibilità su ADP XSP| (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
-
Andare a Impostazioni > Chiamata BroadWorks.
-
Fare clic sul collegamento per il download del certificato.
È possibile ottenere la catena di certificati anche da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt.
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono dalla distribuzione degli ADP XSP| pubblici:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente all'ADP XSP|
Il diagramma seguente riepiloga i punti in cui la catena di certificati CA Webex deve essere distribuita in questi tre casi.
Requisiti del certificato TLS reciproca per il proxy con bridge TLS
-
Webex presenta un certificato client firmato dall'autorità di certificazione Webex nel proxy.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità del proxy, pertanto il proxy considera attendibile il certificato client.
-
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta un certificato server firmato pubblicamente con Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Il proxy presenta un certificato client firmato internamente agli ADP XSP|.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3:
Uso chiave estesa X509v3:
1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati del server interno per XSP|ADP possono essere SAN.
-
Gli ADP XSP| si affidano alla CA interna.
-
Gli ADP XSP| presentano un certificato server firmato internamente.
-
Il proxy considera attendibile la CA interna.
Requisiti del certificato TLS reciproca per proxy tls passizzato o XSP in DMZ
-
Webex presenta un certificato client firmato ca Webex agli XSP.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità degli XSP, pertanto gli XSP considerano attendibile il certificato client.
-
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
-
Gli XSP presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP.
Cronologia revisioni documenti
La tabella seguente mostra una cronologia delle modifiche di questo documento negli ultimi 12 mesi.
Data |
Versione | Descrizione della modifica | |
---|---|---|---|
13 gennaio 2025 |
3-1 |
| |
3 dicembre 2024 |
2-124 |
| |
4 ottobre 2024 |
2-123 |
| |
10 settembre 2024 |
2-123 |
| |
9 agosto 2024 |
2-122 |
| |
1 agosto 2024 |
2-121 |
| |
25 giugno 2024 |
2-120 |
| |
14 giugno 2024 |
2-119 |
| |
13 maggio 2024 |
2-118 |
| |
10 maggio 2024 |
2-117 |
| |
6 maggio 2024 |
2-116 |
| |
2 maggio 2024 |
2-115 |
| |
10 aprile 2024 |
2-114 |
| |
27 marzo 2024 |
2-113 |
| |
22 marzo 2024 |
2-112 |
| |
7 marzo 2024 |
2-111 |
| |
24 febbraio 2024 |
2-110 |
| |
20 febbraio 2024 |
2-109 |
| |
07 febbraio 2024 |
2-108 |
| |
25 gennaio 2024 |
2-107 |
| |
23 gennaio 2024 |
2-106 |
| |
10 gennaio 2024 |
2-105 |
| |
Panoramica di Webex per Cisco BroadWorks
Introduzione a Webex per Cisco BroadWorks
Cronologia revisioni documenti
Questa sezione fornisce agli amministratori di sistema delle organizzazioni partner Cisco (provider di servizi) che implementano Webex per le organizzazioni dei clienti o forniscono questa soluzione direttamente ai relativi abbonati.
Scopo soluzione
-
Per fornire funzioni di collaborazione cloud Webex a clienti piccoli e medi che dispongono già del servizio di chiamata fornito dai provider di servizi BroadWorks.
-
Per fornire il servizio di chiamata basato a BroadWorks a clienti Webex piccoli e medi.
Contesto
In continua continua evoluzione di tutti i nostri clienti di collaborazione verso un'applicazione unificata. Questo percorso riduce le difficoltà di adozione, migliora l'interoperabilità e la migrazione e offre esperienze utente prevedibili in tutto il nostro portfolio di collaborazione. Parte di questo impegno è spostare le funzionalità di chiamata BroadWorks nell'app Webex e ridurre l'investimento nei client UC-One.
Benefici
-
Prova futura: di fronte all'end-of-life di UC-One Collaborate, movimento di tutti i clienti verso il Unified Client Framework (UCF)
-
Il meglio di entrambi: Abilitazione delle funzioni di messaggistica e riunione Webex e conservazione delle chiamate BroadWorks sulla rete di telefonia
Ambito soluzione
-
I clienti esistenti/nuovi e medi (meno di 250 abbonati) che desiderano una suite di funzioni di collaborazione, potrebbero già disporre della chiamata BroadWorks.
-
I clienti Webex esistenti, da piccoli a medi, desiderano aggiungere la chiamata BroadWorks.
-
Non aziende più grandi (ti prego di esaminare il nostro portfolio Enterprise per Webex).
-
Non i singoli utenti (valutare le offerte Webex online).
Le serie di funzioni in Webex per Cisco BroadWorks hanno come obiettivo casi d'uso di piccola e media attività. I pacchetti Webex per Cisco BroadWorks sono progettati per ridurre la complessità dei sistemi SME e ne valutiamo costantemente l'idoneità per questo segmento. È possibile scegliere di nascondere o rimuovere funzioni altrimenti disponibili nei pacchetti Enterprise.
Prerequisiti per il successo con Webex per Cisco BroadWorks
# |
Requisito |
Note |
---|---|---|
1 |
Patch BroadWorks corrente R22 o superiore | |
2 |
ADP XSP| per XSI, CTI, DMS e authService |
ADP XSP|dedicato per Webex per Cisco BroadWorks |
3 |
ADP XSP|separato per NPS può essere condiviso con altre soluzioni che utilizzano NPS. |
Se si dispone di una distribuzione di collaborazione esistente, rivedere le raccomandazioni sulle configurazioni ADP e NPS XSP|. |
4 |
Convalida token CI (con TLS) configurato per connessioni Webex al servizio di autenticazione. | |
5 |
mTLS configurato per le connessioni Webex all'interfaccia CTI. |
Altre applicazioni non richiedono mTLS. |
6 |
Gli utenti devono esistere in BroadWorks e necessitano dei seguenti attributi, in base alla propria decisione di provisioning:
|
Per e-mail affidabili: Si consiglia di inserire lo stesso indirizzo e-mail nell'attributo ID alternativo anche per consentire agli utenti di accedere con indirizzo e-mail per BroadWorks. Per e-mail non attendibili: A seconda delle impostazioni e-mail dell'utente, l'utilizzo di messaggi e-mail non attendibili può inviare il messaggio e-mail alla cartella della posta indesiderata o dello SPAM dell'utente. L'amministratore potrebbe aver modificato le impostazioni e-mail dell'utente per consentire i domini |
7 |
File DTAF Webex per Cisco BroadWorks per l'app Webex | |
8 |
BW Business Lic o Std Enterprise o Prem Enterprise User Lic + Webex per l'abbonamento Cisco BroadWorks |
Se è già presente una distribuzione di collaborazione esistente, non è più necessario il bundle aggiuntivo UC-One, la collaborazione Lic e le porte della conferenza Meet-me. Se si dispone di una distribuzione UC-One SaaS esistente, non è necessario apportare ulteriori modifiche se non si accettano i termini del pacchetto Premium. |
9 |
L'indirizzo IP/porte deve essere accessibile attraverso i servizi back-end Webex e le app Webex su Internet pubblico. |
Vedere la sezione "Preparazione della rete". |
10 |
Configurazione TLS v1.2 su ADP XSP| | |
11 |
Per il provisioning Flowworks, il server dell'applicazione deve connettersi all'adattatore di provisioning BroadWorks. La configurazione del proxy in uscita non viene testata o supportato. Se si utilizza un proxy in uscita, si accetta la responsabilità di supportarlo con Webex per Cisco BroadWorks. |
Vedere l'argomento "Preparazione della rete". |
Informazioni su questo documento
Lo scopo di questo documento è comprendere, preparare, distribuire e gestire la soluzione Webex per Cisco BroadWorks. Le sezioni principali del documento riflettono questo scopo.
Questa guida include informazioni concettuali e materiale di riferimento. Intendiamo coprire tutti gli aspetti della soluzione in questo documento.
La serie minima di attività per la distribuzione della soluzione è la seguente:
-
Raggiungere il team dell'account per diventare un partner Cisco. È obbligatorio esplorare i punti di contatto Cisco per acquisire familiarità (ed essere addestrati). Quando si diventa un partner Cisco, viene applicato il tasto di alternanza Webex per Cisco BroadWorks all'organizzazione partner Webex. Vedere Distribuire Webex per Cisco BroadWorks > onboarding dei partner in questo documento).
-
Configurare i sistemi BroadWorks per l'integrazione con Webex. (Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs in questo documento).
-
Utilizzare Partner Hub per collegare Webex a BroadWorks. Vedere Distribuire Webex per Cisco BroadWorks > l'organizzazione partner in Partner Hub in questo documento.
-
Utilizzare Partner Hub per preparare i modelli di provisioning utente. (Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dei modelli di onboarding in questo documento).
-
Esegui test ed esegui l'onboarding di un cliente eseguendo il provisioning di almeno un utente. (Vedere Distribuzione di Webex per Cisco BroadWorks > Configurazione dell'organizzazione di test).
-
Operazioni di alto livello, nell'ordine tipico. Esistono diverse attività determinanti che non è possibile ignorare.
-
Se si desidera creare le proprie applicazioni per gestire Webex per abbonati Cisco BroadWorks, leggere Uso dell'API di provisioning nella sezione Di riferimento di questa guida.
Terminologia
Cerchiamo di limitare il gergo e gli acronimi utilizzati in questo documento e di spiegare ogni termine quando viene utilizzato per la prima volta. Vedere Riferimento Webex per Cisco BroadWorks > Terminologia se un termine non viene spiegato nel contesto.
Funzionamento
Webex per Cisco BroadWorks è un'offerta che integra la chiamata BroadWorks in Webex. Gli abbonati utilizzano una singola applicazione (app Webex) per sfruttare le funzioni fornite da entrambe le piattaforme:
-
Gli utenti chiamano PSTN numeri di telefono utilizzando l'infrastruttura BroadWorks.
-
Gli utenti chiamano altri numeri BroadWorks utilizzando l'infrastruttura BroadWorks (chiamate audio/video selezionando i numeri associati agli utenti o il tastierino per introdurre i numeri).
-
Gli utenti possono, in alternativa, effettuare una chiamata VOIP Webex sull'infrastruttura Webex selezionando l'opzione "Webex Call" nell'app Webex ( queste chiamate sono app Webex all'app Webex, non all'app Webex PSTN).
-
Gli utenti possono ospitare e partecipare Webex Meetings.
-
Gli utenti possono inviare messaggi l'uno all'altro o negli spazi (chat di gruppo persistente) e usufruire delle funzioni di ricerca e condivisione di file (su infrastruttura Webex).
-
Gli utenti possono condividere la presenza (stato). Possono scegliere la presenza personalizzata o la presenza calcolata dal client.
-
Dopo averci asserto come organizzazione partner in Control Hub, con i diritti corretti, è possibile configurare il rapporto tra l'istanza BroadWorks e Webex.
-
È possibile creare organizzazioni dei clienti in Control Hub e pres effettuare il provisioning degli utenti in tali organizzazioni.
-
Ciascun abbonato in BroadWorks ottiene un'identità Webex in base al relativo indirizzo e-mail (attributo ID e-mail in BroadWorks).
-
Gli utenti eseguono l'autenticazione per BroadWorks o per Webex.
-
I client vengono emessi con token a lungo termine per autorizzarli per i servizi presso BroadWorks e Webex.
L'app Webex al centro di questa soluzione; è un'applicazione che può essere brandable disponibile su desktop Mac/Windows e su dispositivi mobili e tablet Android/iOS.
Esiste anche una versione Web dell'app Webex che attualmente non include le funzioni di chiamata.
Il client si connette al cloud Webex per offrire funzioni di messaggistica, presenza e riunione.
Il client si registra ai sistemi BroadWorks per le funzioni di chiamata.
Il cloud Webex funziona con i sistemi BroadWorks per garantire un'esperienza di provisioning utente ottimale.
Funzioni e limitazioni
Sono disponibili diversi pacchetti con diverse funzioni.
Pacchetto "Softphone"
Questo tipo di pacchetto utilizza l'app Webex come client solo softphone con funzionalità di chiamata ma nessuna funzionalità di messaggistica. Gli utenti con questo tipo di pacchetto possono accedere alle riunioni Webex, ma non possono avviare riunioni per proprio conto. Quando altri utenti (softphone o non softphone) ricercano un utente tramite softphone, i risultati della ricerca non forniscono alcuna opzione per l'invio di un messaggio.
Gli utenti softphone possono condividere lo schermo durante una chiamata.
Pacchetto "Base"
Il pacchetto base include le funzioni di chiamata, messaggistica e riunione. Include 100 partecipanti alle riunioni. (** vedere la Nota seguente per eccezione). In questo pacchetto, la durata massima delle riunioni è di 40 minuti.
Pacchetto "standard"
Questo pacchetto include anche tutto quello che è previsto dal pacchetto Base oltre a funzioni di riunione aggiuntive, inclusi sottotitoli codificati, trascrizione in tempo reale di 5 lingue principali, Assistente AI Cisco e sondaggi e Q&A di Slido.
Pacchetto "Premium"
Questo pacchetto include tutto quello che è previsto dal pacchetto Standard più un massimo di 300 partecipanti nella riunione "Unified Space" e fino a 1000 partecipanti in una sala riunioni personale, registrazione su cloud delle riunioni e funzioni di messaggistica avanzate che includono l'Assistente AI Cisco.
'Riunioni spazio unificate' si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge in uno spazio Webex. Ad esempio, un utente avvia una riunione dallo spazio tramite i pulsanti 'Riunione' o 'Pianifica'.
Confronta pacchetti
Pacchetto |
Chiamata in corso |
Messaggistica |
Riunioni spazio unificato |
PMR riunioni |
---|---|---|---|---|
Softphone |
Incluso |
Non incluso |
Nessuno |
Nessuno |
Base |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Standard |
Incluso |
Incluso |
100 partecipanti |
100 partecipanti |
Premium |
Incluso |
Incluso |
300 partecipanti |
1000 partecipanti |
'Riunioni PMR' si riferisce a una riunione Webex (pianificata o non pianificata) che si svolge nella sala riunioni personale di un utente. Queste riunioni utilizzano un URL dedicato (ad esempio: cisco.webex.com/meet/roomOwnerUserID).
Funzioni di messaggistica e riunione
Fare riferimento alla tabella seguente per conoscere le differenze di supporto delle funzioni per le riunioni nella sala riunioni personale per i pacchetti Base, Standard e Premium.
Funzione riunione |
Supportato con pacchetto base |
Soportato con il pacchetto standard |
Supportato con pacchetto Preminum |
Commento |
---|---|---|---|---|
Durata riunione |
40 Minuti o meno |
24 ore |
24 ore | |
Condivisione desktop |
Sì |
Sì |
Sì | |
Condivisione di un'applicazione |
Sì |
Sì |
Sì | |
Chat tra più parti |
Sì |
Sì |
Sì | |
Lavagna |
Sì |
Sì |
Sì | |
Protezione password |
Sì |
Sì |
Sì | |
App Web - nessun download o plug-in (esperienza ospite) |
Sì |
Sì |
Sì | |
Supporta accoppiamento con dispositivi Webex |
Sì |
Sì |
Sì | |
Controllo piano (disattiva audio di uno / Espelle tutti) |
Sì |
Sì |
Sì | |
Collegamento Riunioni permanenti |
Sì |
Sì |
Sì | |
Acces. sito per riunioni |
Sì |
Sì |
Sì | |
Accesso alla riunione tramite VoIP |
Sì |
Sì |
Sì | |
Blocco |
Sì |
Sì |
Sì | |
Controlli relatore |
No |
No |
Sì | |
Controllo desktop remoto |
Sì |
Sì |
Sì | |
Numero di partecipanti |
100 |
100 |
1000 | |
Registrazione salvata in locale nel sistema |
Sì |
Sì |
Sì | |
Registrazione nel cloud |
No |
No |
Sì | |
Registrazione - Storage su cloud |
No |
No |
10 GB per sito | |
Trascrizione delle registrazioni |
No |
No |
Sì | |
Pianificazione riunione |
Sì |
Sì |
Sì | |
Abilita condivisione del contenuto con integrazioni esterne |
No |
No |
Sì | |
Consenti PMR modifica dell'URL |
Sì |
Sì |
Sì | |
Riunioni in streaming in diretta (ad esempio, su Facebook, Youtube) |
No |
No |
Sì | |
Consentire ad altri utenti di pianificare le riunioni per proprio conto |
No |
No |
Sì | |
Aggiungi organizzatore alternativo |
Sì |
Sì |
Sì | |
Integrazione delle app (es. Zendesk, Slack) |
Dipende dall'integrazione |
Dipende dall'integrazione |
Sì |
Vedere la sezione Integrazioni delle app di seguito per ulteriori informazioni sul supporto. |
Integrazione con il calendario Microsoft Office 365 |
Sì |
Sì |
Sì | |
Integrazione con Google Calendaring per G Suite |
Sì |
Sì |
Sì |
Il Centro assistenza Webex pubblica le funzioni e la documentazione per l'utente per Webex all'help.webex.com
. Leggere i seguenti articoli per ulteriori informazioni sulle funzioni:
Funzioni di chiamata
L'esperienza di chiamata è simile a quelle precedenti che utilizzano il motore di controllo chiamate BroadWorks. La differenza rispetto a UC-One Collaborate e UC-One SaaS è che l'app Webex è il soft client principale.
Integrazioni app
È possibile integrare Webex per Cisco BroadWorks con le seguenti applicazioni:
-
Zendesk: solo Premium
-
Slack: solo Premium
-
Microsoft Teams per Webex Meetings: standard o premium
-
Microsoft Teams per la chiamata: supportato con tutti i pacchetti
-
Calendario Office 365: standard o premium
-
Google Calendaring per G Suite: standard o premium
Supporto infrastruttura desktop virtuale (VDI)
Webex per Cisco BroadWorks ora supporta ambienti con infrastruttura desktop virtuale (VDI). Per informazioni dettagliate su come distribuire l'infrastruttura VDI, fare riferimento alla Guida alla distribuzione di Webex per l'infrastruttura desktop virtuale (VDI).
Supporto IPv6
Webex per Cisco BroadWorks supporta l'indirizzamento IPv6 per l'app Webex.
Pro Pack per Control Hub
Il servizio aggiuntivo Pro Pack per Control Hub fornisce agli amministratori, alle informazioni di sicurezza e ai funzionari di conformità funzionalità avanzate in sicurezza, conformità e analisi in grado di integrare il software.
Questi servizi aggiuntivi saranno disponibili solo per i pacchetti Standard e Premium.
Per ulteriori informazioni, vedi la Pagina della Guida di Pro Pack per Control Hub.
Roadmap futuro
Per informazioni sulle nostre intenzione per le versioni future di Webex per Cisco BroadWorks, visitare https://salesconnect.cisco.com/#/program/PAGE-16649. Gli elementi della roadmap non sono associabili ad alcuna capacità. Cisco si riserva il diritto di disattivare o revisionare uno o tutti di questi elementi nelle release future.
Limiti
Limitazioni provisioning
Fuso orario sito riunioni
Il fuso orario del primo abbonato per ciascun pacchetto diventa il fuso orario per il Webex Meetings sito creato per tale pacchetto.
Se non viene specificato alcun fuso orario nella richiesta di provisioning per il primo utente di ciascun pacchetto, il fuso orario del sito Webex Meetings per tale pacchetto viene impostato sul valore predefinito regionale dell'organizzazione degli abbonati.
Se il cliente richiede un fuso orario Webex Meetings sito specifico, specificare il parametro di fuso orario nella richiesta di provisioning
per:
-
il primo abbonato predisposto per il pacchetto standard nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto Premium nell'organizzazione.
-
il primo abbonato predisposto per il pacchetto Base nell'organizzazione.
Limitazioni generali
-
Nessuna chiamata nella versione Web del client Webex (si tratta di una limitazione del client, non di una limitazione di soluzione).
-
Webex potrebbe non disporre ancora di tutti i controlli UI per supportare alcune funzioni di controllo chiamate disponibili da BroadWorks.
-
Il client Webex non può essere attualmente con etichetta "White labeled".
-
Quando si creano organizzazioni cliente utilizzando il metodo di provisioning scelto, tali organizzazioni vengono create automaticamente nella stessa regione dell'organizzazione partner. Questo funzionamento è per impostazione predefinita. È previsto che partner multinazionali creino un'organizzazione partner in ogni regione in cui gestiscono le organizzazioni dei clienti.
-
La generazione di report sulle riunioni e sull'utilizzo dei messaggi è disponibile attraverso l'organizzazione cliente in Control Hub.
Problemi noti e limitazioni
Per un elenco aggiornato dei problemi noti e delle limitazioni con l'offerta Webex per Cisco BroadWorks, vedere Problemi noti e limitazioni.
Limiti messaggistica
I seguenti limiti di storage dati (messaggistica e file combinati) si applicano alle organizzazioni che hanno acquistato Webex per i servizi Cisco BroadWorks attraverso un provider di servizi. Questi limiti rappresentano lo spazio di storage massimo per la messaggistica e i file combinati.
-
Base: 2 GB per utente per 3 anni
-
5 GB standard per utente per 3 anni
-
Premium: 10 GB per utente per 5 anni
Per ciascuna organizzazione di clienti, questi totali per utente vengono aggregati per fornire un totale aggregato per tale cliente, in base al numero di utenti. Ad esempio, una società con cinque utenti Premium può utilizzare un limite di messaggistica e storage file totale di 50 GB. Un singolo utente può superare il limite per utente (10 GB) a condizione che la società sia ancora sotto il valore massimo aggregato (50 GB).
Per gli spazi del team creati, i limiti di messaggistica si applicano al totale aggregato per l'organizzazione del cliente che possiede lo spazio del team. È possibile trovare informazioni sul proprietario dei singoli spazi del team dai Criteri spazio. Per informazioni su come visualizzare i criteri dello spazio per un singolo spazio del team, vedere https://help.webex.com/en-us/baztm6/Webex-Space-Policy.
Ulteriori informazioni
Per ulteriori informazioni sui limiti di messaggistica generali che si applicano agli spazi del team di messaggistica Webex, vedere https://help.webex.com/en-us/n8vw82eb/Webex-Capacities.
Sicurezza, dati e ruoli
Sicurezza Webex
Il client Webex è un'applicazione sicura che rende sicure connessioni a Webex e BroadWorks. I dati archiviati nel cloud Webex e esposti all'utente attraverso l'interfaccia dell'app Webex vengono crittografati sia in viaggio che a riposo.
Ulteriori dettagli sullo scambio dei dati sono disponibili nella sezione Riferimento di questo documento.
Lettura aggiuntiva
Residenza dati organizzazione
I dati Webex vengono memorizzati nel centro dati più vicino alla regione. Vedere Residenza dei dati in Webex nel Centro assistenza.
Ruoli
Amministratore provider di servizi (utente): Per le attività di manutenzione giornaliere, è possibile gestire le parti in locale (di chiamata) della soluzione utilizzando i propri sistemi. Le parti Webex della soluzione vengono gestite attraverso Partner Hub.
Per informazioni sui ruoli disponibili ai partner, sui privilegi di accesso che accompagnano tali ruoli e su come assegnare i ruoli, vedere Ruoli amministratore partner per Webex per BroadWorks e Wholesale RTM.
Il primo utente predisposto a un nuovo organizzazione partner viene assegnato automaticamente ai ruoli Amministratore completo e Amministratore partner completo. L'amministratore può utilizzare l'articolo precedente per assegnare ruoli aggiuntivi.
Team operativo Cisco Cloud: Crea l'organizzazione partner in Partner Hub, se non esiste, durante il processo di onboarding.
Una volta che si dispone dell'account Partner Hub, è possibile configurare le interfacce Webex per i propri sistemi. Successivamente si creano "Modelli di onboarding" per rappresentare le suite o i pacchetti serviti attraverso tali sistemi. Si eservi quindi il provisioning dei propri clienti o abbonati.
# |
Attività tipica |
SP |
Cisco |
---|---|---|---|
1 |
Onboarding del partner: creazione dell'organizzazione partner, se presente, e abilitazione delle attivazioni/disattivazioni delle funzioni necessarie |
● | |
2 |
Configurazione BroadWorks nell'organizzazione partner tramite Hub partner (cluster) |
● | |
3 |
Configurazione delle impostazioni di integrazione nell'organizzazione partner tramite Partner Hub (modelli di offerta, branding) |
● | |
4 |
Preparazione dell'ambiente BroadWorks per l'integrazione (AS, XSP|Patch ADP, firewall, configurazione ADP XSP|, XSI, AuthService, CTI, NPS, applicazioni DMS su XSP|ADP) |
● | |
5 |
Sviluppo di un'integrazione o di un processo di provisioning |
● | |
6 |
Prepara materiali GTM |
● | |
7 |
Esegui migrazione o provisioning di nuovi utenti |
● |
Architettura
Che cos'è nel diagramma?
Client
-
Il client Webex App svolge la funzione di applicazione principale in Webex per le offerte Cisco BroadWorks. Il client è disponibile su piattaforme desktop, mobili e Web.
Il client dispone di riunioni audio/video native di messaggistica, presenza e multiparty fornite dal cloud Webex. Il client Webex utilizza l'infrastruttura BroadWorks per chiamate SIP PSTN chiamate.
-
I telefoni Cisco IP e relativi accessori utilizzano anche l'infrastruttura BroadWorks per SIP e chiamate PSTN telefoniche. Ci vediamo in grado di supportare telefoni di terze parti.
-
Portale di attivazione utente per consentire agli utenti di accedere a Webex utilizzando le credenziali BroadWorks.
-
Partner Hub è un'interfaccia Web per l'amministrazione della propria organizzazione Webex e delle organizzazioni dei clienti. Partner Hub consente di configurare l'integrazione tra l'infrastruttura BroadWorks e Webex. È anche possibile utilizzare Partner Hub per gestire la configurazione del client e la fatturazione.
provider di servizi di rete
Il blocco verde a sinistra del diagramma rappresenta la rete. I componenti ospitati nella rete forniscono i seguenti servizi e interfacce ad altre parti della soluzione:
-
ADP XSP|rivolto al pubblico, per Webex per Cisco BroadWorks: (La casella rappresenta uno o più farm XSP|ADP, possibilmente frontali da bilanciatori del carico).
-
Ospita l'interfaccia XSI-Actions &XSI-Events, Device Servizio di gestione (DMS), l'interfaccia CTI e il servizio di autenticazione. Insieme, queste applicazioni consentono ai telefoni e ai client Webex di autenticarsi, scaricare i file di configurazione delle chiamate, effettuare e ricevere chiamate e visualizzare lo stato di hook degli altri (presenza di telefonia) e cronologia chiamate.
-
Pubblica la directory sui client Webex.
-
-
ADP XSP|rivolto al pubblico, con NPS:
-
Server push notifiche chiamate host: Un server push di notifica su un ADP XSP| nel tuo ambiente. Interfaccia tra il server applicazioni e il nostro proxy NPS. Il proxy fornisce token di breve durata all'NPS per autorizzare le notifiche ai servizi cloud. Questi servizi (APNS &FCM) inviano notifiche di chiamata ai client Webex su dispositivi Apple iOS e Google Android.
-
-
Server applicazione:
-
Fornisce il controllo e le interfacce delle chiamate ad altri sistemi BroadWorks (in genere)
-
Per il provisioning flowre, l'AS viene utilizzato dall'amministratore del partner per eseguire il provisioning degli utenti in Webex
-
Inserisce profilo utente in BroadWorks
-
-
SISTEMA SISTEMA AVAIO/BSS: Sistema di supporto operativo/servizi SIP aziendali per l'amministrazione delle aziende BroadWorks.
Webex Cloud
Il blocco blu nel diagramma rappresenta il cloud Webex. I microservizi Webex supportano tutte le funzionalità di collaborazione Webex:
-
Cisco Common Identity (CI) è il servizio di identità all'interno di Webex.
-
Webex per Cisco BroadWorks rappresenta l'insieme di microservizi che supportano l'integrazione tra Webex e provider di servizi BroadWorks ospitate:
-
API di provisioning utenti
-
provider di servizi configurazione
-
Accesso utente tramite credenziali BroadWorks
-
-
casella Messaggistica Webex per microservizi correlati alla messaggistica.
-
Webex Meetings che rappresenta i server di elaborazione multimediale e i controller SBC per le riunioni video con più partecipanti (SIP & SRTP)
Servizi Web di terze parti
I seguenti componenti di terze parti vengono rappresentati nel diagramma:
-
APNS (Apple Push Notifications Service) inserisce le notifiche di chiamate e messaggi nelle applicazioni Webex sui dispositivi Apple.
-
FCM (FireBase Cloud Messaging) invia notifiche di chiamate e messaggi alle applicazioni Webex sui dispositivi Android.
Considerazioni sull'architettura XSP|ADP
Ruolo dei server ADP XSP|rivolti al pubblico in Webex per Cisco BroadWorks
L'ADP XSP|rivolto al pubblico nel tuo ambiente fornisce le seguenti interfacce/servizi a Webex e ai client:
-
Servizio di autenticazione (AuthService), protetto da TLS, che risponde alle richieste di BroadWorks J JSON (Token Web JSON) per conto dell'utente
-
Interfaccia CTI protetta da mTLS, a cui Webex esegue l'abbonamento per eventi cronologia chiamate e stato della presenza di telefonia da BroadWorks (stato hook).
-
Interfacce di azioni ed eventi Xsi (eXtended Services Interface) per il controllo delle chiamate, le directory di contatto e di elenco delle chiamate e la configurazione del servizio di telefonia dell'utente finale
-
Servizio DM (Device Management) per i client per recuperare i file di configurazione delle chiamate
Fornire gli URL per queste interfacce quando si configura Webex per Cisco BroadWorks. Vedi Configurazione dei cluster BroadWorks in Partner Hub in questo documento) Per ciascun cluster, puoi fornire solo un URL per ciascuna interfaccia. Se si dispone di più interfacce nell'infrastruttura BroadWorks, è possibile creare più cluster.
Architettura XSP|ADP
Si richiede di utilizzare un'istanza ADP XSP|separata e dedicata per ospitare l'applicazione NPS (Notification Push Server). È possibile utilizzare lo stesso NPS con UC-One SaaS o UC-One Collaborate. Tuttavia, non è possibile ospitare le altre applicazioni richieste per Webex per Cisco BroadWorks sullo stesso ADP XSP| che ospita l'applicazione NPS.
Si consiglia di utilizzare un'istanza/farm XSP|ADP dedicata per ospitare le applicazioni richieste per l'integrazione Webex per i seguenti motivi
-
Ad esempio, se stai offrendo UC-One SaaS, ti consigliamo di creare un nuovo farm ADP XSP|per Webex per Cisco BroadWorks. In questo modo i due servizi possono funzionare in modo indipendente durante la migrazione degli abbonati.
-
Se si posizionano le applicazioni Webex per Cisco BroadWorks su un farm XSP|ADP utilizzato per altri scopi, è responsabilità del cliente monitorare l'uso, gestire la complessità risultante e pianificare l'aumento di scala.
-
Il Strumento di pianificazione della capacità del sistema Cisco BroadWorks utilizza un farm ADP XSP| dedicato e potrebbe non essere accurato se lo si utilizza per calcoli di collocazione.
Se non diversamente specificato, il Webex dedicato per Cisco BroadWorks XSP ADP| deve ospitare le seguenti applicazioni:
-
AuthService (TLS con convalida token CI o mTLS)
-
CTI (mTLS)
-
Azioni XSI (TLS)
-
XSI-Events (TLS)
-
DMS (TLS): facoltativo. Non è obbligatorio distribuire un'istanza DMS o un farm separati specificatamente per Webex per Cisco BroadWorks. È possibile utilizzare la stessa istanza DMS utilizzata per UC-One SaaS o UC-One Collaborate.
-
Impostazioni chiamata Webview (TLS): opzionale. La vista Web impostazioni chiamata (CSW) è richiesta solo se desideri che gli utenti Webex per Cisco BroadWorks possano configurare le funzioni di chiamata sull'app Webex.
Webex richiede l'accesso al CTI attraverso un'interfaccia protetta (autenticazione) TLS reciproca autenticazione. Per supportare questo requisito, si consiglia una di queste opzioni:
-
(Diagramma etichettato Opzione 1) Un'istanza o un farm XSP|ADP per tutte le applicazioni, con due interfacce configurate su ciascun server: un'interfaccia mTLS per CTI e un'interfaccia TLS per altre app come AuthService.
-
(Diagramma etichettato Opzione 2) Due istanze o farm XSP| ADP, una con un'interfaccia mTLS per CTI e l'altra con un'interfaccia TLS per altre app, come AuthService.
Riutilizzo XSP|ADP
Se si dispone di un farm ADP XSP|esistente conforme a una delle architetture suggerite sopra (opzione 1 o 2) e carico leggero, è possibile riutilizzare gli ADP XSP|esistenti. Sarà necessario verificare che non vi siano requisiti di configurazione in conflitto tra le applicazioni esistenti e i nuovi requisiti delle applicazioni per Webex. Le due considerazioni principali sono:
-
Se è necessario supportare più organizzazioni partner Webex su XSP|ADP, ciò significa che è necessario utilizzare mTLS sul servizio di autorizzazione (la convalida del token CI è supportata solo per una singola organizzazione partner su un XSP|ADP). Se si utilizza mTLS sul servizio di autenticazione, ciò significa che non è possibile avere client che stanno utilizzando l'autenticazione di base sul servizio di autenticazione allo stesso tempo. Questa situazione impedirebbe il riutilizzo dell'ADP XSP|.
-
Se il servizio CTI esistente è configurato per essere utilizzato dai client con la porta protetta (in genere 8012) ma senza mTLS (ossia, autenticazione client), tale servizio è in conflitto con il requisito webex di disporre di mTLS.
Poiché gli ADP XSP| hanno molte applicazioni e il numero di permutazioni di queste applicazioni è elevato, potrebbero verificarsi altri conflitti non identificati. Per questo motivo, qualsiasi potenziale riutilizzo di ADP XSP| deve essere verificato in un laboratorio con la configurazione prevista prima di impegnarsi per il riutilizzo.
Configurazione della sincronizzazione NTP su XSP|ADP
La distribuzione richiede la sincronizzazione dell'orario per tutti gli ADP XSP| utilizzati con Webex.
Installare il pacchetto ntp
dopo aver installato il sistema operativo e prima di installare il software BroadWorks. Successivamente, è possibile configurare NTP durante l'installazione del software XSP|ADP. Per ulteriori informazioni, vedere la Guida alla gestione software BroadWorks.
Durante l'installazione interattiva del software ADP XSP|, è possibile configurare NTP. Procedere come segue:
-
Quando viene visualizzato il programma di installazione,
configurare NTP?
, inserire y.
-
Quando il programma di installazione richiede,
questo server deve essere un server NTP? , inserire n
.
-
Quando il programma di installazione richiede, Qual è l'indirizzo NTP, il nome host o nome di dominio completo? , inserire l'indirizzo del server NTP o un servizio
NTP pubblico, ad esempio,
pool.ntp.org
.
Se le ADP XSP| utilizzano l'installazione invisibile all'utente (non interattiva), il file di configurazione del programma di installazione deve includere le seguenti coppie chiave=valore:
NTP
NTP_SERVER=
Requisiti di sicurezza e identità ADP XSP|
Sfondo
I protocolli e i tipi di crittografia delle connessioni TLS Cisco BroadWorks sono configurabili a diversi livelli di specificità. Questi livelli variano dal più generale (provider SSL) alla più specifica (singola interfaccia). Un'impostazione più specifica sovrascrive sempre un'impostazione più generale. Se non vengono specificate, le impostazioni SSL di livello 'inferiore' vengono ereditano dai livelli superiori.
Se non viene modificata alcuna impostazione dai valori predefiniti, tutti i livelli ereditano le impostazioni predefinite del provider SSL (estensione JSSE Java Secure Sockets).
Elenco requisiti
-
L'ADP XSP| deve autenticarsi ai client utilizzando un certificato firmato da un'autorità di certificazione in cui il nome comune o il nome alternativo oggetto corrisponde alla parte di dominio dell'interfaccia XSI.
-
L'interfaccia Xsi deve supportare il protocollo TLSv1.2.
-
L'interfaccia Xsi deve utilizzare una suite di crittografia che soddisfi i seguenti requisiti.
-
Diffie-Hellman Ephemeral (DHE) o Curve ellittiche Diffie-Hellman Ephemeral (ECDHE) key-exchange
-
Crittografia AES (Advanced Encryption Standard) con una dimensione di blocco minima di 128 bit (ad esempio, AES-128 o AES-256)
-
Modalità di crittografia GCM (Galois/Counter Mode) o CBC (Cipher Block Chaining)
-
Se viene utilizzata la crittografia CBC, solo la famiglia di funzioni hash SHA2 è consentita per la derivazione chiave (SHA256, SHA384, SHA512).
-
-
Ad esempio, i seguenti tipi di crittografia soddisfano i requisiti:
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
L'XSP|ADP CLI richiede la convenzione di denominazione IANA per le suite di crittografia, come mostrato sopra, non la convenzione openSSL.
Tipi di crittografia TLS supportati per le interfacce AuthService e XSI
Questo elenco è soggetto a modifica quando i requisiti di sicurezza del cloud cambiano. Seguire i suggerimenti sulla sicurezza del cloud Cisco per la selezione della crittografia, come descritto nell'elenco dei requisiti in questo documento.
-
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
-
TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA
-
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_DHE_RSA_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_GCM_SHA384
-
TLS_DHE_PSK_WITH_AES_256_GCM_SHA384
-
TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_AES_256_GCM_SHA384
-
TLS_PSK_WITH_CHACHA20_POLY1305_SHA256
-
TLS_RSA_PSK_WITH_AES_128_GCM_SHA256
-
TLS_DHE_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_128_GCM_SHA256
-
TLS_PSK_WITH_AES_128_GCM_SHA256
-
TLS_RSA_WITH_AES_256_CBC_SHA256
-
TLS_RSA_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA384
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA384
-
TLS_RSA_PSK_WITH_AES_256_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_256_CBC_SHA
-
TLS_RSA_WITH_AES_256_CBC_SHA
-
TLS_PSK_WITH_AES_256_CBC_SHA384
-
TLS_PSK_WITH_AES_256_CBC_SHA
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA256
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA256
-
TLS_RSA_PSK_WITH_AES_128_CBC_SHA
-
TLS_DHE_PSK_WITH_AES_128_CBC_SHA
-
TLS_RSA_WITH_AES_128_CBC_SHA
-
TLS_PSK_WITH_AES_128_CBC_SHA256
-
TLS_PSK_WITH_AES_128_CBC_SHA
Parametri scala Xsi Events
Potrebbe essere necessario aumentare la dimensione della coda Xsi-Events e il conteggio dei thread per gestire il volume di eventi richiesto dalla soluzione Webex per Cisco BroadWorks. È possibile aumentare i parametri ai valori minimi mostrati, come segue (non diminuire, se sono superiori ai valori minimi):
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventQueueSize = 2000
XSP|ADP_CLI/Applications/Xsi-Events/BWIntegration>
eventHandlerThreadCount = 50
Più ADP XSP|
Elemento Edge di bilanciamento del carico
Se si dispone di un elemento di bilanciamento del carico sul perimetro di rete, tale elemento deve gestire in modo trasparente la distribuzione del traffico tra più server ADP XSP|e il cloud e i client Webex per Cisco BroadWorks. In questo caso, si fornisce l'URL del servizio di bilanciamento del carico a Webex per la configurazione Cisco BroadWorks.
Note su questa architettura:
-
Configurare DNS in modo che i client possano trovare il servizio di bilanciamento del carico quando si connettono all'interfaccia Xsi (vedere Configurazione DNS).
-
Si consiglia di configurare l'elemento Edge in modalità proxy SSL inverso per accertarsi che la crittografia dati point-to-point.
-
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio tuo-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri nomi di domini completi, ad esempio XSP|ADP01.example.com, nel nome comune. È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Server ADP XSP|rivolti a Internet
Se si espongono direttamente le interfacce XSI, utilizzare il DNS per distribuire il traffico a più server ADP XSP|.
Note su questa architettura:
-
Sono necessari due record per la connessione ai server ADP XSP|:
-
Per i microservizi Webex: I record a turni A/AAAA sono richiesti per indirizzare più indirizzi IP ADP XSP|. Questo perché i microservizi Webex non possono eseguire ricerche SRV. Per esempi, vedere Servizi cloud Webex.
-
Per l'app Webex: Un record SRV che si risolve in record A e ciascun record A si risolve in un singolo ADP XSP|. Per esempi, vedi App Webex.
Utilizzare i record SRV con priorità per indirizzare il servizio XSI per più indirizzi ADP XSP|. Assegnare una priorità ai record SRV in modo che i microservizi passino sempre allo stesso record A (E l'indirizzo IP successivo) e passino al record A successivo (e indirizzo IP) solo se il primo indirizzo IP non è attivo. NON utilizzare un approccio a tutto tondo per Webex App.
-
-
I certificati di XSP|ADP01 e XSP|ADP02 devono entrambi avere il dominio XSP|ADP, ad esempio tuo-XSP|ADP.example.com, nel nome alternativo oggetto. Devono avere i propri nomi di domini completi, ad esempio XSP|ADP01.example.com, nel nome comune.
-
È possibile utilizzare certificati con caratteri jolly, ma non sono consigliati.
Evita reindirizzamenti HTTP
Talvolta, il DNS è configurato per risolvere l'URL ADP XSP|in un servizio di bilanciamento del carico HTTP e il servizio di bilanciamento del carico è configurato per reindirizzare attraverso un proxy inverso ai server ADP XSP|XSP.
Webex non segue un reindirizzamento quando ci si connette agli URL forniti, pertanto questa configurazione non funziona.
Ordinazione e provisioning
Ordinazione e provisioning si applicano a questi livelli:
-
Provisioning partner/provider di servizi:
Ciascun Webex per Cisco BroadWorks provider di servizi (o rivenditore) presente deve essere configurato come organizzazione partner in Webex e disporre dei diritti necessari. Cisco Operations fornisce all'amministratore dell'organizzazione partner l'accesso per la gestione di Webex per Cisco BroadWorks su Webex Partner Hub. L'amministratore del partner deve eseguire tutte le attività di provisioning richieste prima di poter eseguire il provisioning di un'organizzazione cliente/Enterprise.
-
Ordini e provisioning cliente/Enterprise:
Ciascuna azienda BroadWorks abilitata per Webex per Cisco BroadWorks attiva la creazione di un'organizzazione cliente Webex associata. Questo processo viene eseguito automaticamente come parte del provisioning dell'utente/abbonato. Tutti gli utenti/abbonati all'interno di un'azienda BroadWorks sono predisposti nella stessa organizzazione clienti Webex.
Lo stesso funzionamento si applica se il sistema BroadWorks è configurato come provider di servizi con gruppi. Quando si esegue il provisioning di un abbonato in un gruppo BroadWorks, un'organizzazione cliente corrispondente al gruppo viene creata automaticamente in Webex.
-
Ordinazione e provisioning di utenti/abbonati:
Webex per Cisco BroadWorks attualmente supporta i seguenti modelli di provisioning utente:
-
Provisioning Flow con e-mail attendibili
-
Provisioning flow senza messaggi e-mail attendibili
-
Self-provisioning utente
-
Provisioning API
-
Provisioning a flusso costante con e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se è possibile asserre che BroadWorks abbia indirizzi e-mail dell'abbonato validi e univoci per Webex, questa opzione di provisioning crea e attiva automaticamente gli account Webex con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Provisioning flow senza messaggi e-mail attendibili
Configurare il servizio IM&P integrato per utilizzare un URL di provisioning Webex, quindi assegnare il servizio agli utenti. Il server applicazioni utilizza l'API di provisioning Webex per richiedere gli account utente Webex corrispondenti.
Se non si può contare sugli indirizzi e-mail dell'abbonato tenuti da BroadWorks, questa opzione di provisioning crea account Webex, ma non può attivarli fino a quando gli abbonati non forniscono e convalidano gli indirizzi e-mail. A quel punto, Webex può attivare gli account con tali indirizzi e-mail come ID utente.
È possibile modificare il pacchetto dell'abbonato attraverso Partner Hub oppure scrivere la propria applicazione per utilizzare l'API di provisioning per modificare i pacchetti del sottoscrittore.
Self-Provisioning utente
Con questa opzione, non esiste provisioning flowworks da BroadWorks a Webex. Dopo aver configurato l'integrazione tra Webex e il sistema BroadWorks, si ottengono uno o più collegamenti specifici per il provisioning degli utenti all'interno di Webex per l'organizzazione partner Cisco BroadWorks.
Si progettare quindi le proprie comunicazioni (o delegare ai clienti) la distribuzione del collegamento agli abbonati. Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex.
Poiché gli account sono predisposti nell'ambito dell'organizzazione partner, è possibile regolare manualmente i pacchetti utente attraverso Partner Hub o utilizzare l'API per effettuare questa operazione.
Gli utenti devono essere presenti nel sistema BroadWorks integrato con Webex oppure è vietato creare account con tale collegamento.
provider di servizi provisioning da PARTE delle API
Webex sono esposti una serie di API pubbliche che consentono di creare Webex per il provisioning di utenti/abbonati Cisco BroadWorks nel flusso di lavoro/strumenti di gestione degli utenti esistenti.
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Installare AP.as.22.0.1123.ap376508.
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Installare AP.as.23.0.1075.ap376509
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Installare AP.as.24.0.944.ap375100
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning di nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per utenti Cisco BroadWorks.
Chiamata interno
Il supporto della funzione di chiamata dell'interno consente agli utenti di Webex di Cisco Broadworks di chiamare altri utenti con un interno simile al numero di telefono principale all'interno della stessa azienda. Ciò è particolarmente utile per gli utenti che non dispongono di numeri DID.
Durante il provisioning, l'interno degli utenti viene memorizzato nella directory Webex come interno dell'utente. Per la chiamata BroadWorks, l'interno viene visualizzato nell'app Webex nel campo di estensione di tutte le aree del metodo di inizio chiamata e del profilo utente. Webex per Cisco BroadWorks supporta le chiamate solo interno tra utenti all'interno dello stesso gruppo e diversi gruppi della stessa azienda con la combinazione di codice di chiamata posizione e interno. Tuttavia, la chiamata tra due aziende che utilizzano solo interni non è supportata.
È possibile eseguire il provisioning di un interno per gli utenti Cisco BroadWorks tramite i seguenti metodi:
-
Utenti Cisco BroadWorks
-
Provisioning API pubblica come estensione
-
Il parametro dell'interno deve essere passato esplicitamente come parte della chiamata API. Per aziende/gruppi che dispongono di un codice di chiamata posizione (LDC) configurato, il parametro interno deve essere la combinazione di LDC e 'numero di interno.
-
-
Provisioning a flusso costante o autoattivazione
-
L'interno e il sistema LDC (ove applicabile) verranno recuperati automaticamente da BroadWorks.
-
-
-
Utenti o entità Calling solo BroadWorks
-
Sincronizzato automaticamente da BroadWorks per sincronizzazione rubrica utilizzando la combinazione del codice di chiamata posizione (LDC) e del numero di interno.
-
Record chiamata BroadWorks |
Descrizione |
Metodo di provisioning |
Gestione dell'interno |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
API pubblica |
L'interno deve essere passato come parametro |
A flusso costante |
Interno recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks |
Utenti di chiamata non caricati in Webex |
Sinc rubrica |
Interno sincronizzato dalla sincronizzazione rubrica |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sinc rubrica | Interno sincronizzato dalla sincronizzazione rubrica |
Elenchi telefonici BroadWorks |
Elenchi telefonici aziendali, di gruppo o personali |
Sinc rubrica |
Non applicabile |
Prerequisiti
-
La versione del client richiesta per supportare questa funzione è la versione 42.11 o successiva.
-
Patch in cui i codici di chiamata dell'interno e della posizione vengono aggiunti a XSI e all'adattatore di provisioning febbraio 2022 per la versione 23 o superiore come parte di:
-
AP.platform.23.0.1075.ap380045
-
AP.as.23.0.1075.ap380045
-
AP.xsp.23.0.1075.ap380045
-
AP.as.24.0.944.ap380045
-
-
Abilita l'intestazione X-BroadWorks-Remote-Party-Info sul AS utilizzando il comando CLI seguente per questo flusso di chiamata SIP, richiesto per il supporto della funzione di chiamata interno.
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
Priorità opzioni chiamata app
Come parte del supporto della funzione di chiamata dell'interno, L'impostazione di priorità delle opzioni di chiamata dell'app viene fornita anche a livello di partner per tutti i partner Webex per Cisco Broadworks. Utilizzando questa impostazione, il partner può controllare le impostazioni di priorità chiamata di tutti i suoi clienti gestiti da Partner Hub. L'impostazione di priorità delle opzioni di chiamata dell'app per un cliente può essere modificata anche a livello di cliente da Control Hub.
L'impostazione di priorità delle opzioni di chiamata dell'app contiene l'interno come seconda opzione sia in Partner Hub che in Control Hub quando viene eseguito il provisioning di un utente Webex per Cisco Broadworks con l'interno tramite uno dei metodi di provisioning sopra menzionati.
Per tutte le organizzazioni predisposte esistenti, l'opzione di estensione sarà nello stato nascosto (per impostazione predefinita) nell'impostazione di priorità delle opzioni di chiamata dell'app. Questo non visualizza un interno nell'opzione di chiamata audio/video dell'utente nell'app Webex.
Di seguito sono riportate le opzioni per rendere l'opzione di chiamata a interno visibile per i clienti esistenti:
-
Se un partner desidera che a tutte le organizzazioni dei clienti gestiti sia fornito un interno come opzione di chiamata, è consigliabile che l'amministratore del partner sposti l'interno da nascosto a disponibile in Partner Hub. Ciò consentirà alle organizzazioni dei clienti gestite di ereditare l'impostazione dal proprio partner.
-
Se un partner desidera fornire opzioni di chiamata per un'organizzazione cliente specifica, si consiglia all'amministratore partner di spostare l'interno da nascosto a disponibile in Control Hub.
Supporto di contatti di gruppo
Questa funzione migliora il servizio Webex per BroadWorks DirSync rimuovendo la limitazione per la sincronizzazione di fino a 1500 contatti dagli elenchi telefonici di gruppo su BroadWorks e consentendo ai partner di sincronizzare fino a 30K contatti da un singolo elenco telefonico di gruppo e allinearlo all'aumento dei contatti 30K per l'elenco telefonico aziendale, rilasciato separatamente.
Esiste un limite complessivo di 200K per tutti i contatti esterni per organizzazione, applicabile alla somma degli elenchi telefonici aziendali e di gruppo in un'unica azienda BroadWorks. Ad esempio, sarà supportata un'azienda BroadWorks con elenco telefonico Enterprise con 30K e anche 5 elenchi di telefoni di gruppo, ciascuno con 30K (180K totale per organizzazione). Tuttavia, se sono presenti 6 elenchi di telefoni di gruppo ciascuno con 30K, questo non sarà supportato (210K in totale).
Questa funzione è disponibile su richiesta. Contatta il team del tuo account per abilitarlo.
-
Prima di abilitare la funzione, è necessario eseguire una migrazione dei prerequisiti per il provisioning e associare i gruppi per tutti gli utenti predisposti esistenti.
-
Il team Cisco eseguirà un'API interna per eseguire la migrazione di eventuali utenti predisposti esistenti e associarli al gruppo corretto. NOTA: Questa operazione può richiedere fino a una settimana.
-
Una volta completata la migrazione per il partner e abilitata la funzione, tutti gli utenti predisposti di recente verranno "raggruppati" in modo appropriato.
Una volta abilitata la funzione, il servizio DirSync avvia la sincronizzazione dei contatti dell'elenco telefonico di gruppo BroadWorks in storage dedicato per contatto di gruppo nel servizio Webex Contact.
Durante il provisioning, il gruppo aziendale dell'utente deve essere memorizzato nella rubrica Webex per indicare il gruppo a cui appartiene questo utente. L'associazione dell'utente a un gruppo BroadWorks nella rubrica Webex consente all'app Webex di eseguire la ricerca di contatti nello storage di gruppo Contact Service per il gruppo specifico dell'utente.
La funzione richiede il provisioning di Webex per gli abbonati BroadWorks in Webex con l'ID gruppo aziendale BroadWorks.
L'ID gruppo aziendale BroadWorks può essere fornito per gli utenti Cisco BroadWorks tramite i seguenti metodi:
-
Webex per utenti Cisco BroadWorks
-
Provisioning API pubblica come 'spEnterpriseGroupId'
-
L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API.
-
-
Provisioning a flusso costante o autoattivazione
-
L'ID gruppo aziendale BroadWorks verrà recuperato automaticamente da BroadWorks.
-
-
Utenti o entità Calling solo BroadWorks
-
Non applicabile. Non è necessario sincronizzare l'ID gruppo BroadWorks Enterprise per questi utenti.
-
-
Record chiamata BroadWorks |
Descrizione |
Metodo di provisioning |
Gestione dell'ID gruppo aziendale |
---|---|---|---|
Webex per utenti Cisco BroadWorks |
Gli utenti sono abilitati per Webex per Cisco BroadWorks |
API pubblica |
ID gruppo BroadWorks Enterprise Group deve essere passato come parametro spEnterpriseGroupId |
A flusso costante |
ID gruppo aziendale BroadWorks recuperato automaticamente da BroadWorks | ||
Utenti che chiamano solo BroadWorks |
Utenti di chiamata non caricati in Webex |
Sinc rubrica |
Non applicabile |
Entità di chiamata non utente |
Ad esempio, un telefono sala conferenze, un fax, un numero di gruppo di risposta |
Sinc rubrica |
Non applicabile |
Elenchi telefonici BroadWorks |
Contatti negli elenchi telefonici di gruppo BroadWorks |
Sinc rubrica |
I contatti di gruppo vengono memorizzati nel Servizio Webex Contact associato al gruppo specifico |
Elenchi telefonici BroadWorks Enterprise o Persional |
Contatti negli elenchi telefonici aziendali o personali |
Sinc rubrica |
Non applicabile |
L'API pubblica deve essere aggiornata PRIMA della MIGRAZIONE. La migrazione non può essere completata finché QUESTA API non viene completata. L'ID gruppo aziendale BroadWorks deve essere passato esplicitamente nel parametro spEnterpriseGroupId della chiamata API https://developer.webex.com/docs/api/changelog#2023-march
Una volta abilitata la funzione e come risultato della successiva sincronizzazione delle rubriche, verranno visualizzati anche i gruppi utenti aziendali in Control Hub. In questa fase, la visualizzazione dei gruppi in Control Hub per Webex per BroadWorks è puramente informativo. Gli amministratori di partner e clienti non devono apportare modifiche ai gruppi o all'appartenenza ai gruppi in Control Hub poiché tali modifiche non verranno riflesse nuovamente in BroadWorks. La gestione dei gruppi in Control Hub è destinata ai partner che adotteranno le API di gestione dei contatti future.
Migrazione e prova futura
Cisco il client BroadSoft unified Communications deve passare da UC-One a Webex. Esiste una corrispondente lingua dei servizi di supporto lontani dalla rete provider di servizi, ad eccezione della chiamata, verso la piattaforma cloud Webex.
Sia che si utilizzi UC-One SaaS o BroadWorks Collaborate, la strategia di migrazione preferita è distribuire nuovi ADP XSP| dedicati per l'integrazione con Webex per Cisco BroadWorks. È possibile eseguire i due servizi in parallelo durante la migrazione dei clienti a Webex e, infine, recuperare l'infrastruttura utilizzata per la soluzione precedente.
Abbonamenti ai documenti consigliati
Gli articoli del Centro assistenza Webex (su help.webex.com) dispongono di un'opzione Esegui sottoscrizione che consente di ricevere una notifica e-mail ogni volta che l'articolo viene aggiornato.
Si consiglia di iscriversi a ciascuno dei seguenti articoli per essere certi di non perdere aggiornamenti critici che incidono sulla connettività di rete. Per eseguire l'abbonamento, andare a ciascuno dei collegamenti seguenti e nell'articolo che viene avviato, fare clic sul pulsante Abbonati .
Si consiglia di iscriversi come minimo all'elenco precedente. Tuttavia, la maggior parte degli articoli e dei documenti Webex elencati sotto Documenti aggiuntivi dispone di un'opzione Esegui sottoscrizione . Per la visualizzazione di questa opzione, l'articolo deve essere visualizzato su help.webex.com.
Non è disponibile alcuna opzione di abbonamento per le pagine di destinazione della documentazione.
Documenti aggiuntivi
Fare riferimento alla seguente documentazione correlata per ulteriori informazioni su Webex per Cisco BroadWorks:
Webex per documenti Cisco BroadWorks
Gli amministratori dei partner possono utilizzare i seguenti documenti e siti per ottenere informazioni su Webex per Cisco BroadWorks.
-
Soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks: questa soluzione consente ai provider di servizi di fornire i numeri di telefono propri (anziché i numeri forniti da Cisco) che gli utenti possono utilizzare quando accedono a Webex Meetings.
-
Guida alla configurazione di Webex per Cisco BroadWorks: descrive come configurare l'app Webex per Webex per Cisco BroadWorks.
- Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks: descrive la modalità di onboarding e l'onboarding dei dispositivi Room OS e MPP.
-
Guida alla risoluzione dei problemi Webex per Cisco BroadWorks: contiene informazioni sulla risoluzione dei problemi per Webex per Cisco BroadWorks.
Articoli Webex per Cisco BroadWorks
Per ulteriori informazioni su Webex per Cisco BroadWorks, gli amministratori dei partner possono utilizzare i seguenti siti opzionali:
-
Documentazione di Webex per Cisco BroadWorks: la pagina di destinazione elenca i documenti tecnici e gli articoli Webex opzionali destinati agli amministratori partner di Webex per Cisco BroadWorks.
-
Novità di Webex per Cisco BroadWorks: leggi le ultime funzioni rilasciate insieme alle prossime novità.
-
Problemi noti e limitazioni: leggere i problemi noti identificati nella soluzione Webex per Cisco BroadWorks.
-
Ruoli amministratore partner per Webex per BroadWorks e Wholesale RTM: questo articolo descrive come assegnare ruoli amministratore partner per organizzazioni partner che offrono Webex per Cisco BroadWorks. I ruoli vengono utilizzati per assegnare l'accesso di amministrazione alle impostazioni in Partner Hub e Control Hub.
Documenti Cisco BroadWorks
Gli amministratori dei partner possono fare riferimento al sito Cisco BroadWorks su cisco.com per documenti tecnici che descrivono come distribuire la parte Cisco BroadWorks della soluzione:
Articoli della Guida Webex
È possibile utilizzare i seguenti siti della Guida Webex per trovare articoli Webex che aiutano gli amministratori dei clienti e gli utenti finali a utilizzare le funzioni Webex.
-
Webex dai provider di servizi: questa pagina di destinazione contiene collegamenti con informazioni introduttive e articoli utilizzati più di frequente per gli utenti dell'app Webex che hanno acquistato servizi Webex da un provider di servizi.
-
Centro assistenza Webex: utilizzare la funzione di ricerca all'indirizzo help.webex.com per ricercare altri articoli Webex che descrivono l'app Webex e la funzionalità Webex Meetings. È possibile cercare articoli dell'utente o dell'amministratore.
Documentazione per gli sviluppatori
-
Guida per lo sviluppatore di Webex per BroadWorks: fornisce informazioni agli sviluppatori che creano applicazioni che utilizzano le API Webex per BroadWorks.
Preparazione dell'ambiente
Punti decisione
Considerazione | Domande a cui rispondere | Risorse |
Architettura e infrastruttura
|
Quanti ADP XSP|? Come prendono mTLS? |
Pianificatore capacità sistema Cisco BroadWorks Guida tecnica del sistema Cisco BroadWorks Riferimento XSP|ADP CLI Questo documento |
Provisioning clienti e utenti |
Si può asserre che si considera attendibili i messaggi e-mail in BroadWorks? Si desidera che gli utenti forniranno gli indirizzi e-mail per attivare i propri account? È possibile creare strumenti per utilizzare la nostra API? |
Doc API pubblici su https://developer.webex.com Questo documento |
Branding | Quale colore e logo si desidera utilizzare? | Articolo sul branding dell'app Webex |
Modelli | Quali sono i diversi casi d'uso dei clienti? | Questo documento |
Funzioni dell'abbonato per cliente/azienda/gruppo | Scegliere il pacchetto per definire il livello di servizio per modello. Base, Standard, Premium o softphone. |
Questo documento Matrice funzioni/pacchetto |
Autenticazione utente | BroadWorks o Webex | Questo documento |
Adattatore di provisioning (per le opzioni di provisioning flow) |
Utilizzi già IM&P integrato, ad esempio per UC-One SaaS? Utilizzare più modelli? Esiste un caso d'uso più comune previsto? |
Questo documento Riferimento CLI server applicazione |
Architettura e infrastruttura
-
Con quale scala intendete iniziare? È possibile aumentare la scalabilità in futuro, ma la stima d'uso corrente deve guidare la pianificazione dell'infrastruttura.
-
Collaborare con il responsabile account / rappresentante di vendita Cisco per ridimensionare l'infrastruttura ADP XSP|, in base alla Cisco BroadWorks System Capacity Planner e alla Cisco BroadWorks System Engineering Guide.
-
In che modo Webex esegue connessioni TLS reciproche con gli ADP XSP|? Direttamente all'ADP XSP| in un DMZ o tramite proxy TLS? Ciò incide sulla gestione dei certificati e sugli URL utilizzati per le interfacce (Le connessioni TCP non crittografate al bordo della rete non sono supportate).
Provisioning clienti e utenti
Quale metodo di provisioning utente si adatta meglio alle esigenze?
-
Provisioning a flusso costante con e-mail attendibili: Assegnando il servizio "IM&P integrato" su BroadWorks, l'abbonato viene automaticamente predisposto in Webex.
Se è anche possibile asserre che gli indirizzi e-mail dell'abbonato nella BroadWorks siano validi e univoci per Webex, è possibile utilizzare la varianti "e-mail attendibile" del provisioning flow provisioning. Gli account Webex del sottoscrittore vengono creati e attivati senza il loro intervento; semplicemente scaricare il client ed eseguire l'accesso.
Indirizzo e-mail è un attributo utente chiave su Webex. Pertanto l provider di servizi deve specificare un indirizzo e-mail valido per l'utente per potervi fornire i servizi Webex. Deve essere nell'attributo ID e-mail dell'utente in BroadWorks. Si consiglia di copiarlo nell'attributo ID alternativo.
-
Provisioning a flusso costante senza e-mail attendibili: Se non si riesce a verificare l'attendibilità degli indirizzi e-mail dell'abbonato, è comunque possibile assegnare il servizio IM&P integrato in BroadWorks per il provisioning degli utenti in Webex.
Con questa opzione, gli account vengono creati quando si assegna il servizio, ma gli abbonati devono fornire e convalidare i relativi indirizzi e-mail per attivare gli account Webex.
-
Provisioning automatico utente: Questa opzione non richiede l'assegnazione del servizio IM&P in BroadWorks. L'utente (o i clienti) distribuiscono invece un collegamento di provisioning e i collegamenti per scaricare diversi client, con il branding e le istruzioni.
Gli abbonati seguono il collegamento, quindi forniscono e convalidano gli indirizzi e-mail per creare e attivare i propri account Webex. Quindi scaricano il client e a quel punto Webex recuperano alcune configurazioni aggiuntive su di esse da BroadWorks (inclusi i numeri principali).
-
Provisioning controllato SP tramite API: Webex sono esposti una serie di API pubbliche che consentono ai provider di servizi di creare provisioning utente/abbonato nei flussi di lavoro esistenti.
Requisiti di provisioning
Nella tabella seguente vengono riepilogati i requisiti per ciascun metodo di provisioning. Oltre a questi requisiti, la distribuzione deve soddisfare i requisiti generali di sistema descritti in questa guida.
Metodo di provisioning |
Requisiti |
---|---|
Provisioning Flow (e-mail attendibili o non attendibili) |
L'API di provisioning Webex aggiunge gli utenti BroadWorks esistenti a Webex automaticamente una volta che l'utente soddisfa i requisiti e attiva il servizio IM+P integrato . Esistono due flussi (e-mail attendibili o e-mail non attendibili) che vengono assegnati tramite il modello di onboarding su Webex. Requisiti BroadWorks:
Requisiti Webex: Il modello Onboarding include le seguenti impostazioni:
|
Self-Provisioning utente |
L'amministratore fornisce a un utente BroadWorks esistente un collegamento al portale di attivazione utente. L'utente deve accedere al portale utilizzando le credenziali BroadWorks e fornire un indirizzo e-mail valido. Una volta convalidato l'e-mail, Webex recupera ulteriori informazioni utente per completare il provisioning. Requisiti BroadWorks:
Requisiti Webex: Il modello Onboarding include le seguenti impostazioni:
|
Provisioning controllato da SP tramite API (e-mail attendibili o non attendibili) |
Webex espone una serie di API pubbliche che consentono di creare il provisioning degli utenti nei flussi di lavoro e negli strumenti esistenti. Sono disponibili due flussi:
Requisiti BroadWorks:
Requisiti Webex:
Per utilizzare le API, andare a Utenti BroadWorks. |
Patch richieste con provisioning Flow-through
Se si sta utilizzando il provisioning flow-through, è necessario installare una patch di sistema e applicare una proprietà CLI. Fare riferimento all'elenco seguente per istruzioni applicabili alla release BroadWorks:
Per R22:
-
Installare AP.as.22.0.1123.ap376508.
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154309/AP.as.22.0.1123.ap376508.txtpatch.
Per R23:
-
Installare AP.as.23.0.1075.ap376509
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154325/AP.as.23.0.1075.ap376509.txtpatch.
Per R24:
-
Installare AP.as.24.0.944.ap375100
-
Dopo l'installazione, impostare la proprietà
bw.msg.includeIsEnterpriseInOSSschema
sutrue
dalla CLI inMaintenance/ContainerOptions
.Per ulteriori informazioni, vedere le note sulla https://www.cisco.com/web/software/286326332/154326/AP.as.24.0.944.ap375100.txtpatch.
Una volta completate queste operazioni, non sarà possibile eseguire il provisioning di nuovi utenti con i servizi di collaborazione UC-One. Gli utenti predisposti di recente devono essere Webex per utenti Cisco BroadWorks.
Impostazioni internazionali della lingua supportate
Durante il provisioning, la lingua assegnata in BroadWorks al primo utente amministrativo predisposto viene assegnata automaticamente come impostazioni internazionali predefinite per tale organizzazione cliente. Questa impostazione determina la lingua predefinita utilizzata per e-mail di attivazione, riunioni e inviti alle riunioni in tale organizzazione del cliente.
Sono supportate impostazioni internazionali per la lingua a cinque caratteri in formato (ISO-639-1)_(ISO-3166). Ad esempio, en_USA corrisponde a English_UnitedStates. Se è richiesta solo una lingua di due lettere (utilizzando il formato ISO-639-1), il servizio genererà un'impostazione locale della lingua di cinque caratteri combinando la lingua richiesta con un prefisso del paese dal modello, ad esempio "requestedLanguage_CountryCode", se non è possibile ottenere un'impostazione locale valida, utilizzare le impostazioni internazionali sensibili predefinite in base al codice della lingua richiesto.
Nella tabella seguente vengono elencate le impostazioni internazionali supportate e la mappatura che converte un codice della lingua di due lettere in un'impostazione locale di cinque caratteri per le situazioni in cui una impostazione locale di cinque caratteri non è disponibile.
Impostazioni internazionali della lingua supportate (ISO-639-1)_(ISO-3166) |
Se è disponibile solo un codice lingua di due lettere... | |
---|---|---|
Codice lingua (ISO-639-1) ** |
Utilizzare invece le impostazioni internazionali sensibili predefinite (ISO-639-1)_(ISO-3166) | |
en_USA en_AU en_GB en_CA |
it |
en_USA |
fr_FR fr_CA |
Fr |
fr_FR |
cs_CZ |
cs |
cs_CZ |
da_DK |
da |
da_DK |
de_DE |
DE |
de_DE |
hu_HU |
hu |
hu_HU |
id_ID |
Identificativo |
id_ID |
it_IT |
esso |
it_IT |
ja_JP |
ja |
ja_JP |
ko_KR |
ko |
ko_KR |
es_ES es_CO es_MX |
es |
es_ES |
nl_NL |
NL |
nl_NL |
nb_NO |
nb |
nb_NO |
pl_PL |
pl |
pl_PL |
pt_PT pt_BR |
pt |
pt_PT |
ru_RU |
RU |
ru_RU |
ro_RO |
ro |
ro_RO |
zh_CN zh_TW |
zh |
zh_CN |
sv_SE |
sv |
sv_SE |
ar_SA |
ar |
ar_SA |
tr_TR |
tr |
tr_TR |
Le impostazioni internazionali es_CO, id_ID, nb_NO e pt_PT non sono supportate dai siti per riunioni Webex. Per queste impostazioni internazionali, I siti di Webex Meetings saranno solo in inglese. Inglese è le impostazioni internazionali predefinite per i siti se per il sito non è richiesta alcuna impostazione locale/non valida/non supportata. Questo campo di lingua è applicabile durante la creazione di un sito di organizzazione e Webex Meetings. Se in un post o nell'API dell'abbonato non viene menzionata alcuna lingua, verrà utilizzata come lingua predefinita il modello.
Branding
Gli amministratori dei partner possono utilizzare personalizzazioni di branding avanzate per personalizzare il modo in cui l'app Webex cerca le organizzazioni dei clienti gestite dal partner. Gli amministratori dei partner possono personalizzare le seguenti impostazioni per assicurarsi che l'app Webex rifletta il marchio e l'identità della propria società:
-
Loghi aziendali
-
Schemi di colore univoci per la modalità chiaro o la modalità scura
-
URL di supporto personalizzati
Per informazioni dettagliate su come personalizzare il branding, fare riferimento a Configurazione di personalizzazioni di branding avanzate.
-
Le personalizzazioni del branding di base sono in fase di obsolescenza. Si consiglia di distribuire il branding avanzato, che offre una gamma più ampia di personalizzazioni.
Modelli di onboarding
I modelli di onboarding consentono di definire i parametri in base ai quali i clienti e gli abbonati associati vengono predisposti automaticamente su Webex per Cisco BroadWorks. È possibile configurare più modelli di onboarding in base alle proprie esigenze, ma quando si esegue l'onboarding di un cliente, tale modello è associato a un solo modello (non è possibile applicare più modelli a un cliente).
Di seguito sono elencati alcuni parametri del modello principale.
Pacchetto
-
È necessario selezionare un pacchetto predefinito quando si crea un modello (per informazioni dettagliate, vedere Pacchetti nella sezione Panoramica). Tutti gli utenti predisposti con tale modello, mediante flusso o auto-provisioning, ricevono il pacchetto predefinito.
-
È possibile controllare la selezione del pacchetto per diversi clienti creando più modelli e selezionando diversi pacchetti predefiniti in ciascuno. È possibile quindi distribuire diversi collegamenti di provisioning o diversi adattatori per provisioning aziendali, a seconda del metodo di provisioning dell'utente scelto per tali modelli.
-
Puoi modificare il pacchetto di abbonati specifici da questa impostazione predefinita utilizzando l'API di provisioning (vedi documentazione dell'API di Webex per Cisco BroadWorks o tramite Partner Hub (vedi Modifica del pacchetto utente in Partner Hub).
-
Non è possibile modificare il pacchetto di un abbonato da BroadWorks. L'assegnazione del servizio IM&P integrato è disattivata; se l'abbonato è assegnato a questo servizio in BroadWorks, il modello Hub partner associato all'URL di provisioning di tale azienda definisce il pacchetto.
Rivenditori e aziende o provider di servizi e gruppi?
-
La configurazione del sistema BroadWorks ha un impatto sul flusso attraverso il provisioning. Se si è un rivenditore con Aziende, è necessario abilitare la modalità Enterprise quando si crea un modello.
-
Se il sistema BroadWorks è configurato in provider di servizi modalità aziendale, è possibile lasciare disattivata la modalità Enterprise nei modelli.
-
Se si intende eseguire il provisioning delle organizzazioni dei clienti utilizzando entrambe le modalità BroadWorks, è necessario utilizzare modelli diversi per gruppi e aziende.
Accertarsi di aver applicato le patch broadworks richieste per il provisioning flow-through. Per informazioni dettagliate, vedere Patch richieste con provisioning flow-through.
Accertarsi di aver applicato le patch broadworks richieste per il provisioning flow-through. Per informazioni dettagliate, vedere Patch richieste con provisioning flow-through.
Accordi con più partner
Si desidera utilizzare la licenza secondaria di Webex per Cisco BroadWorks con un altro provider di servizi? In tal caso, ciascun fornitore di servizi avrà bisogno di un'organizzazione partner distinta Webex Control Hub permettere loro di fornire la soluzione per la propria base clienti.
Adattatore e modelli di provisioning
Quando si utilizza il provisioning flowre, l'URL di provisioning inserito in BroadWorks è derivato dal modello in Control Hub. È possibile disporre di più modelli e, quindi, di più URL di provisioning. Ciò consente di selezionare, su base aziendale, il pacchetto da applicare agli abbonati quando hanno ottenuto la concessione del servizio IM&P integrato.
È necessario considerare se si desidera impostare un URL di provisioning a livello di sistema come percorso di provisioning predefinito e il modello che si desidera utilizzare. In questo modo, è necessario solo impostare in modo esplicito l'URL di provisioning per le aziende che necessitano di un modello diverso.
Tenere presente, inoltre, che potrebbe essere stato già utilizzato un URL di provisioning a livello di sistema, ad esempio UC-One SaaS. In tal caso, è possibile scegliere di conservare l'URL a livello di sistema per gli utenti di provisioning su UC-One SaaS e sostituire le aziende che passano a Webex per Cisco BroadWorks. In alternativa, è possibile passare al percorso alternativo e impostare l'URL a livello di sistema per Webex per BroadWorks e riconfigurare le aziende che si desidera mantenere su UC-One SaaS.
Le scelte di configurazione relative a questa decisione sono descritte in dettaglio in Configurazione del server applicazioni con URL del servizio di provisioning.
Proxy adattatore di provisioning
Per maggiore sicurezza, il proxy dell'adattatore di provisioning consente di utilizzare un proxy HTTP(S) sulla piattaforma di consegna dell'applicazione per il provisioning a flusso costante tra il AS e Webex. La connessione proxy crea un tunnel TCP end-to-end che inoltra il traffico tra il server applicazioni e Webex, negando in tal modo la necessità per il server applicazioni di connettersi direttamente a Internet pubblico. Per connessioni sicure, è possibile utilizzare TLS.
Questa funzione richiede l'impostazione del proxy su BroadWorks. Per informazioni dettagliate, vedere Descrizione della funzione proxy dell'adattatore di provisioning Cisco BroadWorks.
Requisiti minimi
Account
Tutti gli abbonati disponibili per Webex devono esistere nel sistema BroadWorks integrato con Webex. Se necessario, è possibile integrare più sistemi BroadWorks.
Tutti gli abbonati devono disporre di licenze BroadWorks e di un numero principale o interno.
Webex utilizza gli indirizzi e-mail come identificativi principali per tutti gli utenti. Se si utilizza il provisioning flow con messaggi e-mail attendibili, gli utenti devono disporre di indirizzi validi nell'attributo e-mail in BroadWorks.
Se il modello utilizza l'autenticazione BroadWorks, è possibile copiare gli indirizzi e-mail dell'abbonato nell'attributo ID alternativo in BroadWorks. Ciò consente agli utenti di accedere a Webex utilizzando gli indirizzi e-mail e le relative password BroadWorks.
Gli amministratori devono utilizzare i relativi account Webex per accedere a Partner Hub.
Non è supportato l'onboarding di un amministratore BroadWorks in Webex per Cisco BroadWorks. Puoi eseguire l'onboarding solo degli utenti BroadWorks Calling che dispongono di un numero principale e/o un interno. Se si utilizza il provisioning a flusso costante, agli utenti deve essere assegnato anche il servizio IM&P integrato.
Server nella rete e requisiti software
-
Istanze BroadWorks con versione minima R22. Vedere Requisiti software BroadWorks (in questo documento) per le versioni e le patch supportate. Per ulteriori informazioni, vedere la sezione Criteri per il ciclo di vita dei prodotti BroadSoft in Criteri per il ciclo di vita di BroadSoft e matrice di compatibilità software BroadWorks.
-
Le istanze BroadWorks devono includere almeno i seguenti server:
-
Server applicazioni (AS) con versione BroadWorks come indicato sopra
-
Server di rete (NS)
-
Server di profilo (PS)
-
-
Server ADP XSP|rivolti al pubblico o Piattaforma di consegna delle applicazioni (ADP) che soddisfano i seguenti requisiti:
-
Servizio di autenticazione (BWAuth)
-
Interfacce azioni ed eventi XSI
-
DMS (applicazione Web di gestione dispositivi)
-
Interfaccia CTI (integrazione di telefonia su computer)
-
TLS 1.2 con un certificato valido (non autofirmato) ed eventuali intermedie richiesti. Richiede l'amministrazione a livello di sistema per facilitare la ricerca aziendale.
-
Autenticazione TLS reciproca (mTLS) per il servizio di autenticazione (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
Autenticazione TLS reciproca (mTLS) per interfaccia CTI (richiede l'installazione della catena di certificati del client Webex pubblico come trust anchor)
-
-
Un server XSP/ADP separato funge da "server push notifiche di chiamata" (un server NPS nel proprio ambiente utilizzato per eseguire il push delle notifiche di chiamata ad Apple/Google. Questo tipo di chiamata "CNPS" viene chiamata qui per distinguerlo dal servizio in Webex che offre notifiche push per messaggistica e presenza).
Questo server deve essere su R22 o versioni successive.
-
È obbligatorio creare un server XSP/ADP separato per CNPS poiché l'impossibilità di caricare da Webex per connessioni cloud BWKS potrebbe avere un impatto negativo sulle prestazioni del server NPS, con il risultato di un aumento della latenza di notifica. Per ulteriori informazioni sulla scala XSP|ADP, vedere la Guida tecnica di sistema Cisco BroadWorks .
Piattaforme app Webex
Per scaricare la versione in inglese dell'app Webex, vai a https://www.webex.com/webexfromserviceproviders-downloads.html. L'app Webex è disponibile su:
-
PC/laptop Windows
-
PC Apple / laptop con MacOS
-
iOS (Apple store)
-
Android (Play store)
-
Browser Web (andare a https://teams.webex.com/)
Versioni localizzate
Per scaricare una versione localizzata dell'app Webex, usa uno dei seguenti collegamenti:
-
https://origin-webex-uat.cisco.com/ko/webexfromserviceproviders-downloads.html (coreano)
-
https://origin-webex-uat.cisco.com/fr/webexfromserviceproviders-downloads.html (francese)
-
https://origin-webex-uat.cisco.com/pt/webexfromserviceproviders-downloads.html (portoghese)
-
https://origin-webex-uat.cisco.com/zh-tw/webexfromserviceproviders-downloads.html (cinese tradizionale)
-
https://origin-webex-uat.cisco.com/zh-cn/webexfromserviceproviders-downloads.html (cinese semplificato)
-
https://origin-webex-uat.cisco.com/ja/webexfromserviceproviders-downloads.html (Giappone)
-
https://origin-webex-uat.cisco.com/es/webexfromserviceproviders-downloads.html (Spagna)
-
https://origin-webex-uat.cisco.com/de/webexfromserviceproviders-downloads.html (tedesco)
-
https://origin-webex-uat.cisco.com/it/webexfromserviceproviders-downloads.html (Italiano)
Telefoni e accessori fisici
-
Telefoni IP Cisco:
-
Cisco IP Phone serie 6800 con firmware Multitform
-
Cisco IP Phone serie 7800 con firmware Multitform
-
Cisco IP Phone serie 8800 con firmware Multitform
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/ip-phones/multiplatform-firmware.html modelli e ulteriori informazioni, vedere .
-
-
I telefoni di terze parti sono supportati allo stesso modo delle altre integrazioni BroadWorks. Tuttavia, non dispongono ancora di contatti e integrazione di presenza con Webex per Cisco BroadWorks.
-
Adattatori:
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 191
-
Adattatore telefono analogico a multipiattaforma Cisco ATA 192 Multiplatform
Per https://www.cisco.com/c/en/us/products/unified-communications/ata-190-series-analog-telephone-adapters/index.html modelli e ulteriori informazioni, vedere .
-
-
Cuffie
-
Cisco Headset serie 500
Per https://www.cisco.com/c/en/us/products/collaboration-endpoints/headset-500-series/index.html modelli e ulteriori informazioni, vedere .
-
-
Dispositivi Room OS:
-
Webex Room e serie Room Kit
-
Serie Webex Desk
-
Serie Webex Board
-
Integrazione dispositivo
Per informazioni dettagliate su come eseguire l'onboarding e i dispositivi Room OS e MPP per Webex per Cisco BroadWorks, vedere la Guida all'integrazione dei dispositivi per Webex per Cisco BroadWorks.
Profili dispositivi
Di seguito sono riportati i file DTAF che devi caricare sui server applicazioni per supportare l'app Webex come client di chiamata. Sono gli stessi file DTAF utilizzati per UC-One SaaS, tuttavia, è disponibile un nuovo file config-wxt.xml.template
utilizzato per l'app Webex.
Per scaricare gli ultimi profili del dispositivo, andare al sito Download software della piattaforma di consegna dell'applicazione per ottenere gli ultimi file DTAF. Questi download funzionano sia per ADP che XSP.
Nome client |
Tipo di profilo dispositivo e nome pacchetto |
---|---|
Modello mobile Webex |
Tipo di profilo identità/dispositivo: Connetti - Mobile DTAF: File di configurazione: |
Modello tablet Webex |
Tipo di profilo identità/dispositivo: Connetti - Tablet DTAF: File di configurazione: |
Modello desktop Webex |
Tipo di profilo identità/dispositivo: Business Communicator - PC DTAF: File di configurazione: |
Identifica/Profilo dispositivo
Tutti gli utenti Webex per Cisco BroadWorks devono disporre di un Profilo identità/dispositivo assegnato in BroadWorks che utilizzi uno dei profili di dispositivo precedenti per effettuare chiamate utilizzando l'app Webex. Il profilo fornisce la configurazione che consente all'utente di effettuare chiamate.
Come ottenere le credenziali OAuth per Webex per Cisco BroadWorks
Emetti una richiesta di servizio con l'agente di onboarding o il centro TAC di Cisco per il provisioning di Cisco OAuth per l'account Cisco Identity Provider Federation.
Utilizzare il seguente titolo di richiesta per le rispettive funzioni:
-
XSP|ADP AuthService Configuration' per configurare il servizio su XSP|ADP.
-
'Configurazione NPS per Auth Proxy Setup' per configurare NPS per l'uso del proxy di autenticazione.
-
Sincronizzazione UUID utente CI' per sincronizzazione UUID utente CI. Per ulteriori dettagli su questa funzione, vedi: Supporto Cisco BroadWorks per CI UUID.
-
Configura BroadWorks per abilitare la fatturazione Cisco per gli abbonamenti BroadWorks e Webex Per BroadWorks.
Cisco fornisce un ID client OAuth, un segreto client e un token di aggiornamento validi per 60 giorni. Se il token scade prima di utilizzarlo, puoi inviare un'altra richiesta.
Se sono già state ottenute le credenziali del provider di identità Cisco OAuth, completare una nuova richiesta di servizio per aggiornare le credenziali.
Ordina certificati
Requisiti di certificato per l'autenticazione TLS
Sono necessari certificati di sicurezza, firmati da un'autorità di certificazione affidabile e distribuiti su ADP XSP|rivolti al pubblico, per tutte le applicazioni richieste. Questi verranno utilizzati per supportare la verifica del certificato TLS per tutta la connettività in ingresso ai server ADP XSP|.
Questi certificati devono includere il nome di dominio completo pubblico XSP|ADP come nome comune oggetto o nome alternativo oggetto.
I requisiti esatti per la distribuzione di questi certificati server dipendono dal modo in cui vengono distribuiti gli ADP XSP|:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente all'ADP XSP|
Il diagramma seguente riepiloga dove deve essere caricato il certificato del server pubblico firmato da CA in questi tre casi:
Le CA pubblicamente supportate che l'app Webex supporta per l'autenticazione sono elencate in Autorità di certificazione supportate per i servizi ibridi Webex.
Requisiti del certificato TLS per il proxy con bridge TLS
-
Il certificato del server firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta questo certificato server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
È possibile caricare un certificato CA firmato interno sull'ADP XSP|.
-
L'ADP XSP| presenta questo certificato del server firmato internamente al proxy.
-
Il proxy considera attendibile la CA interna che ha firmato il certificato del server ADP XSP|.
Requisiti del certificato TLS per il proxy passthrough TLS o ADP XSP|in DMZ
-
Il certificato del server firmato pubblicamente viene caricato negli ADP XSP|.
-
Gli ADP XSP| presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP|ADPs.
Ulteriori requisiti di certificato per l'autenticazione TLS reciproca su interfaccia CTI
Quando ci si connette all'interfaccia CTI, Webex presenta un certificato client come parte dell'autenticazione TLS reciproca. Il certificato CA/catena di certificati del client Webex è disponibile per il download tramite Control Hub.
Per scaricare il certificato:
Accedere a Partner Hub, andare a Impostazioni >
collegamento di download del certificato.I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono dalla distribuzione degli ADP XSP| pubblici:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente all'ADP XSP|
Il diagramma seguente riepiloga i requisiti dei certificati in questi tre casi:
(Opzione) Requisiti di certificato per proxy tls-bridge
-
Webex presenta un certificato client firmato pubblicamente al proxy.
-
Il proxy considera attendibile la CA interna Cisco che ha firmato il certificato client. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta il certificato del server firmato pubblicamente in Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Il proxy presenta un certificato client firmato internamente agli ADP XSP|.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3: Uso chiave estesa X509v3: 1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Il CN del certificato interno deve essere
bwcticlient.webex.com
.-
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati del server interno per XSP|ADP possono essere SAN.
-
Le autorità di certificazione pubbliche potrebbero non voler firmare i certificati con il OID broadworks proprietario richiesto. Nel caso di un proxy bridging, potrebbe essere necessario utilizzare un'autorità di certificazione interna per firmare il certificato client che il proxy presenta all'ADP XSP|.
-
-
Gli ADP XSP| si affidano alla CA interna.
-
Gli ADP XSP| presentano un certificato server firmato internamente.
-
Il proxy considera attendibile la CA interna.
-
La ClientIdentity del server applicazioni contiene il CN del certificato client firmato internamente presentato all'ADP XSP| dal proxy.
(Opzione) Requisiti del certificato per il proxy passthrough TLS o ADP XSP|in DMZ
-
Webex presenta un certificato client firmato da un'autorità di certificazione interna Cisco agli ADP XSP|.
-
Gli ADP XSP| affidabili la CA interna Cisco che ha firmato il certificato client. È possibile scaricare questa CA/ catena da Control Hub e aggiungerla all'archivio di attendibilità del proxy. Il certificato del server ADP XSP|firmato pubblicamente viene caricato anche negli ADP XSP|.
-
Gli ADP XSP| presentano i certificati del server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP|ADPs.
-
Il server applicazioni ClientIdentity contiene il CN del certificato client firmato da Cisco presentato all'ADP XSP| da Webex.
Preparazione della rete
Per ulteriori informazioni sulle connessioni utilizzate da Webex per Cisco BroadWorks, vedere: Requisiti di rete per Webex per Cisco BroadWorks. Questo articolo contiene un elenco di indirizzi IP, porte e protocolli necessari per configurare le regole di ingresso e uscita del firewall.
Requisiti di rete per i servizi Webex
Le tabelle del firewall in entrata ed uscita precedenti documenta solo le connessioni specifiche per Webex per Cisco BroadWorks. Per informazioni generali sulle connessioni tra l'app Webex e il cloud Webex, vedere Requisiti di rete per i servizi Webex. Questo articolo è generico a Webex, ma la tabella seguente identifica le diverse sezioni dell'articolo e come ciascuna sezione è relativa a Webex per Cisco BroadWorks.
Sezione dell'articolo requisiti di rete |
Gestione delle informazioni |
---|---|
Riepilogo dei tipi di dispositivi e dei protocolli supportati da Webex |
Informativo |
Protocolli di trasporto e crittografia per app e dispositivi Webex registrati su cloud |
Informativo |
È necessario leggere | |
È necessario leggere | |
Domini e URL a cui è necessario accedere per i servizi Webex |
È necessario leggere |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Opzionale | |
Un riepilogo degli altri servizi ibridi Webex e della documentazione |
Opzionale |
Servizi Webex per clienti FedRAMP |
N/A |
Ulteriori informazioni
Per ulteriori informazioni, vedere Whitepaper (PDF) del firewall appWebex.
Supporto ridondanza BroadWorks
I servizi cloud Webex e le app client Webex che devono accedere alla rete del partner supportano completamente la ridondanza ADP XSP|Broadworks fornita dal partner. Quando un ADP XSP|o un sito non è disponibile per manutenzione pianificata o per motivi non pianificati, i servizi e le app Webex possono passare a un altro ADP XSP| o sito fornito dal partner per completare una richiesta.
Topologia di rete
Gli ADP XSP|BroadWorks possono essere distribuiti direttamente su Internet o possono risiedere in una DMZ preceduta da un elemento di bilanciamento del carico, come F5 BIG-IP. Per fornire la geo-ridondanza, gli ADP XSP| possono essere distribuiti in due (o più) centri dati, ciascuno può essere preceduto da un servizio di bilanciamento del carico, ciascuno con un indirizzo IP pubblico. Se gli ADP XSP|sono dietro un servizio di bilanciamento del carico, i microservizi e l'app Webex visualizzano solo l'indirizzo IP del servizio di bilanciamento del carico e BroadWorks sembra disporre di un solo ADP XSP|ADP, anche se sono presenti più ADP XSP|.
Nell'esempio seguente, gli ADP XSP| vengono distribuiti in due siti, sito A e sito B. Esistono due ADP XSP|frontali da un servizio di bilanciamento del carico in ciascun sito. Il sito A ha XSP|ADP1 e XSP|ADP2 frontali da LB1 mentre il sito B ha XSP|ADP3 e XSP|ADP4 frontali da LB2. Solo i servizi di bilanciamento del carico sono esposti sulla rete pubblica e le ADP XSP| si trovano nelle reti private DMZ.
Servizi Cloud Webex
Configurazione DNS
I microservizi Webex Cloud devono essere in grado di trovare i server ADP XSP|BroadWorks per la connessione alle interfacce Xsi, al servizio di autenticazione e a CTI.
I microservizi cloud Webex eseguiranno la ricerca DNS A/AAAA del nome host ADP XSP|configurato e si connetteranno all'indirizzo IP restituito. Potrebbe essere un elemento del bordo di bilanciamento del carico o potrebbe essere lo stesso server XSP|ADP. Se vengono restituiti più indirizzi IP, verrà selezionato il primo IP nell'elenco. SRV ricerca non sono attualmente supportate.
Esempio: Record DNS A del partner per la scoperta di server XSP|ADP/Load Balancers bilanciati rivolti a Internet.
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (Sito A) |
R |
|
|
Punti a LB2 (Sito B) |
Qualsiasi riferimento a XSP include XSP o ADP.
Failover
Quando i microservizi Webex inviano una richiesta al servizio di bilanciamento del carico/ADP XSP| e la richiesta non riesce, possono verificarsi diverse cose:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un avanzamento di route al successivo IP.
-
Se viene restituito un codice di errore (HTTP 5xx), i microservizi Webex contrassegnano l'IP come bloccato ed eseguono immediatamente un inoltro all'IP successivo.
-
Se non si riceve alcuna risposta HTTP entro 2 secondi, si verifica un timeout della richiesta e i microservizi Webex contrassegnano l'IP come bloccato ed eseguono un avanzamento all'IP successivo.
Ogni richiesta viene provata 3 volte prima che un problema venga segnalato al microservizio.
Quando un IP è nell'elenco bloccato, non verrà incluso nell'elenco di indirizzi da provare quando si invia una richiesta a un ADP XSP|. Dopo un periodo di tempo predeterminato, un IP bloccato scade e torna all'elenco per riprovare quando viene effettuata un'altra richiesta.
Se tutti gli indirizzi IP sono bloccati, il microservizio tenterà comunque di inviare la richiesta selezionando casualmente un indirizzo IP dall'elenco dei contatti bloccati. Se tale indirizzo IP viene rimosso dall'elenco dei contatti bloccati.
Stato
Lo stato della connettività dei servizi Webex Cloud agli ADP XSP| o ai servizi di bilanciamento del carico è visibile in Control Hub. In un cluster di chiamata BroadWorks, viene visualizzato uno stato di connessione per ciascuna di queste interfacce:
-
Azioni XSI
-
Eventi XSI
-
Servizio di autenticazione
Lo stato della connessione viene aggiornato quando viene caricata la pagina o durante gli aggiornamenti di input. Lo stato delle connessioni può essere:
-
Verde: Quando è possibile raggiungere l'interfaccia su uno degli IP nella ricerca di record A.
-
Rosso: Quando tutti gli IP nella ricerca dei record A sono irraggiungibili e l'interfaccia non è disponibile.
I seguenti servizi utilizzano i microservizi per la connessione agli ADP XSP| e sono interessati dalla disponibilità dell'interfaccia ADP XSP|:
-
Accesso all'app Webex
-
Aggiornamento token app Webex
-
E-mail/attivazione automatica non attendibile
-
Controllo stato servizio Broadworks
Webex App
Configurazione DNS
L'app Webex accede all'interfaccia Xtended Services Interface (Azioni XSI e Eventi XSI) e ai servizi Device Management Service (DMS) su ADP XSP|.
Per trovare il servizio XSI, l'app Webex esegue una ricerca SRV DNS per _xsi-client._tcp.
. L'SRV punta all'URL configurato per gli host XSP|ADP o i servizi di bilanciamento del carico per il servizio XSI. Se la ricerca SRV non è disponibile, l'app Webex esegue il fallback alla ricerca A/AAAA.
L'SRV può risolvere più obiettivi A/AAAA. Tuttavia, ciascun record A/AAAA deve eseguire il mapping a un solo indirizzo IP. Se sono presenti più ADP XSP| in una DMZ dietro il servizio di bilanciamento del carico/dispositivo periferico, è necessario che il servizio di bilanciamento del carico sia configurato per mantenere la persistenza della sessione per indirizzare tutte le richieste della stessa sessione allo stesso ADP XSP|. È richiesta questa configurazione poiché gli heartbeat dell'evento XSI del client devono passare allo stesso ADP XSP| utilizzato per stabilire il canale dell'evento.
Nell'esempio 1, il record A/AAAA per webex-app-XSP|ADP.example.com non esiste e non è necessario. Se il DNS richiede che sia definito un record A/AAAA, deve essere restituito solo 1 indirizzo IP. In ogni caso, l'SRV deve essere ancora definito per l'app Webex.
Se Webex App utilizza il nome A/AAAA che si risolve in più di un indirizzo IP o se l'elemento di bilanciamento del carico/bordo non mantiene la persistenza della sessione, il client invia heartbeat a un ADP XSP| dove non ha stabilito un canale evento. In questo modo il canale viene eliminato e anche il traffico interno risulta notevolmente più limitato, che compromette le prestazioni del cluster XSP|ADP.
Poiché Webex Cloud e l'app Webex presentano requisiti diversi nella ricerca dei record A/AAAA, devi utilizzare un FQDN separato per Webex Cloud e Webex App per accedere alle tue ADP XSP|. Come mostrato negli esempi, Webex Cloud utilizza Un record webex-cloud-xsp.example.com
, e l'app Webex utilizza SRV _xsi-client._tcp.webex-app-xsp.example.com
.
Esempio 1: più ADP XSP|, ciascuno dietro bilanciatori di carico separati
In questo esempio, l'SRV punta a silenziare record A con ciascun record A che punta a un diverso bilanciamento del carico in un sito diverso. L'app Webex utilizzerà sempre il primo indirizzo IP nell'elenco e passerà al record successivo solo se il primo è inattivo.
Di seguito è riportato un esempio di SRV record.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
SRV |
|
|
Rilevamento client dell'interfaccia Xsi |
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Esempio 2: più ADP XSP|dietro un singolo servizio di bilanciamento del carico (con bridge TLS)
Per la richiesta iniziale, il servizio di bilanciamento del carico seleziona un XSP|ADP casuale. Indica che XSP ADP|restituisce un cookie incluso nell'app Webex nelle richieste future. Per richieste future, il servizio di bilanciamento del carico utilizza il cookie per indirizzare la connessione all'ADP XSP| corretto, assicurando che il canale dell'evento non si rompi.
Tipo di record |
Registra |
Destinazione |
Scopo |
---|---|---|---|
SRV |
|
|
Bilanciamento del carico |
A |
LB.example.com |
|
Indirizzo IP del servizio di bilanciamento del carico (gli ADP XSP| sono dietro al servizio di bilanciamento del carico) |
URL dms
Durante il processo di accesso, l'app Webex recupera anche l'URL DMS per scaricare il relativo file di configurazione. L'host nell'URL verrà analizzato e l'app Webex eseguirà la ricerca DNS A/AAAA dell'host per connettersi all'ADP XSP| che ospita il servizio DMS.
Esempio: Record DNS A per il rilevamento di server ADP XSP bilanciato verso Internet|/bilanciamento del carico dell'app Webex per scaricare i file di configurazione attraverso DMS:
Tipo di record |
Nome |
Destinazione |
Scopo |
---|---|---|---|
R |
|
|
Punti a LB1 (sito A) |
R |
|
|
Punti a LB2 (sito B) |
Qualsiasi riferimento a XSP include XSP o ADP. Qualsiasi riferimento a XSP include XSP o ADP.
Come l'app Webex trova indirizzi ADP XSP|
Il client tenta di individuare i nodi XSP|ADP utilizzando il seguente flusso DNS:
-
Il client recupera inizialmente gli URL Xsi-Actions/Xsi-Events dal cloud Webex (inserito durante la creazione del cluster di chiamata BroadWorks associato). Il nome host/dominio Xsi viene analizzato dall'URL e il client esegue SRV ricerca nel modo seguente:
-
Il client esegue una ricerca SRV per _xsi-client._tcp.
-
Se la ricerca SRV restituisce uno o più obiettivi A/AAAA:
-
Il client esegue una ricerca A/AAAA di tali destinazioni e memorizza nella cache gli indirizzi IP restituiti.
-
Il client si connette a uno dei destinazioni (e pertanto, il relativo record A/AAAA con un singolo indirizzo IP) in base alla priorità SRV, quindi avere lo stesso peso (o a caso se tutti sono uguali).
-
-
Se la ricerca SRV ricerca non restituisce eventuali obiettivi:
Il client esegue una ricerca A/AAAA del parametro radice Xsi, quindi tenta di connettersi all'indirizzo IP restituito. Potrebbe essere un elemento del bordo di bilanciamento del carico o potrebbe essere lo stesso server XSP|ADP.
Come specificato, il record A/AAAA deve risolversi in un indirizzo IP per gli stessi motivi.
-
-
(Opzionale) In un secondo tempo, è possibile fornire dettagli XSI-Actions/XSI-Events personalizzati nella configurazione del dispositivo per l'app Webex, utilizzando i seguenti tag:
<protocolli> <xsi> <percorsi> <root>%XSI_ROOT_WXT%</root> <actions>%XSI_ACTIONS_PATH_WXT%</actions> <events>%XSI_EVENTS_PATH_WXT%</events> </paths> </xsi> </protocols>
-
Questi parametri di configurazione hanno la precedenza su qualsiasi configurazione nel cluster BroadWorks in Control Hub.
-
Se esistono, il client verrà confrontato con l'indirizzo XSI originale ricevuto tramite la configurazione del cluster BroadWorks.
-
Se vengono rilevate eventuali differenze, il client inizializza nuovamente la connettività XSI Actions/ XSI Events. Il primo passo consiste nell'eseguire lo stesso processo di ricerca DNS elencato al punto 1, questa volta richiedendo una ricerca per il valore nel %XSI_ROOT_WXT% parametro dal relativo file di configurazione.
Creare i record delle SRV corrispondenti se si utilizza questo tag per modificare le interfacce Xsi.
-
Failover
Durante l'accesso, l'app Webex esegue una ricerca SRV DNS per _xsi-client._tcp, crea un elenco di host e si connette a uno degli host in base alla priorità SRV, quindi peso. Questo ospite connesso diventa il selezionato per tutte le richieste future. Un canale di evento viene quindi aperto all'organizzatore selezionato e un heartbeat viene inviato regolarmente per verificare il canale. Tutte le richieste inviate dopo la prima includono un cookie che viene restituito nella risposta HTTP; pertanto, è importante che il servizio di bilanciamento del carico mantenga la persistenza della sessione (affinità) e invii sempre le richieste allo stesso server ADP XSP|di backend.
In caso di errore di una richiesta o di una richiesta heartbeat a un host, si possono verificare diverse operazioni:
-
Se l'errore è dovuto a un errore di rete (ad esempio, TCP, SSL), l'instradazione dell'app Webex avanza immediatamente al successivo organizzatore nell'elenco.
-
Se viene restituito un codice di errore (HTTP 5xx), l'app Webex contrassegna l'indirizzo IP come bloccato e indirizza i progressi all'host successivo nell'elenco.
-
Se non si riceve una risposta entro un determinato periodo di tempo, la richiesta viene considerata non riuscita a causa di un timeout e le successive richieste vengono inviate all'organizzatore successivo. Tuttavia, la richiesta di timeout viene considerata come non riuscita. Si è verificato un tentativo in seguito ad alcune richieste in seguito a un errore (con un aumento del tempo di tentativo). Non si sono effettuate nuovamente richieste che presupponete non vitali.
Quando si prova correttamente un nuovo organizzatore, diventa il nuovo organizzatore selezionato, se è presente nell'elenco. Una volta tentato l'ultimo organizzatore nell'elenco, l'app Webex viene rollover a quella del primo.
In caso di heartbeat, se ci sono due errori di richiesta consecutivi, l'app Webex inizializza nuovamente il canale dell'evento.
Tenere presente che l'app Webex non esegue il fail-back e il rilevamento del servizio DNS viene eseguito una sola volta all'accesso.
Durante l'accesso, l'app Webex tenta di scaricare il file di configurazione tramite l'interfaccia ADP/DMS XSP|. Esegue una ricerca dei record A/AAAA dell'host nell'URL DMS recuperato e si connette al primo IP. Si tenterà prima di inviare la richiesta di download del file di configurazione utilizzando un token SSO configurazione. Se questo non riesce, verrà riprovare ma con il nome utente e la password del dispositivo.
Distribuisci Webex per BroadWorks
Panoramica della distribuzione
I diagrammi seguenti rappresentano l'ordine tipico delle attività di distribuzione per le diverse modalità di provisioning utente. Molte delle attività sono comuni a tutte le modalità di provisioning.
Onboarding dei partner per Webex per Cisco BroadWorks
Ogni provider di servizi o rivenditore Webex per Cisco BroadWorks deve essere impostato come organizzazione partner per Webex per Cisco BroadWorks. Se si dispone di un'organizzazione partner Webex esistente, è possibile utilizzarla.
Per completare l'onboarding necessario, devi eseguire la documentazione Webex Cisco BroadWorks e i nuovi partner devono accettare il Contratto ICPA (Indirect Channel Partner Agreement) online. Al termine di questi passaggi, Cisco Compliance crea una nuova organizzazione partner in Partner Hub (se necessario) e invia un messaggio e-mail con i dettagli di autenticazione all'amministratore di registrazione nella documentazione. Allo stesso tempo, l'attivazione del partner e/o il Customer Success Program Manager ti contatteranno per iniziare l'onboarding.
I partner Webex in una regione possono creare organizzazioni di clienti in qualsiasi regione che offriamo i servizi. Per informazioni, vedere: Residenza dati in Webex.
Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs
L'applicazione NPS deve essere eseguita su un XSP|ADP diverso. I requisiti per tale XSP|ADP sono descritti in Configurazione delle notifiche di chiamata dalla rete.
Sono necessarie le seguenti applicazioni/servizi su XSP|ADP.
Servizio/Applicazione |
Autenticazione richiesta |
Scopo servizio/applicazione |
---|---|---|
Eventi XSI |
TLS (il server si autentica ai client) |
Controllo chiamate, notifiche servizi |
Azioni XSI |
TLS (il server si autentica ai client) |
Controllo chiamata, azioni |
Gestione dispositivi |
TLS (il server si autentica ai client) |
Download configurazione chiamata |
Servizio di autenticazione |
TLS (il server si autentica ai client) |
Autenticazione utente |
Integrazione di telefonia tramite computer |
mTLS (client e server si autenticano a vicenda) |
Presenza telefonia |
Applicazione Webview impostazioni chiamata |
TLS (il server si autentica ai client) |
Espone le impostazioni di chiamata utente nel portale auto all'interno dell'app Webex |
In questa sezione viene descritto come applicare le configurazioni richieste per TLS e mTLS su queste interfacce, ma è necessario fare riferimento alla documentazione esistente per ottenere le applicazioni installate su XSP|ADP.
Requisiti di coresidenza
-
Il servizio di autenticazione deve essere co-residente con le applicazioni Xsi poiché tali interfacce devono accettare token di lunga durata per l'autorizzazione al servizio. Il servizio di autenticazione è necessario per convalidare tali token.
-
Il servizio di autenticazione e Xsi possono eseguire sulla stessa porta, se necessario.
-
È possibile separare gli altri servizi/applicazioni come richiesto per la propria scala (ad esempio, azienda agricola XSP|ADP di gestione dei dispositivi dedicata).
-
È possibile co-individuare le applicazioni Xsi, CTI, Authentication Service e DMS.
-
Non installare altre applicazioni o servizi su XSP|ADP utilizzati per l'integrazione di BroadWorks con Webex.
-
Non co-individuare l'applicazione NPS con altre applicazioni.
Interfacce XSI
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia Cisco BroadWorks Xtended Services Interface.
È necessario distribuire solo un'istanza delle applicazioni Xsi-Events su XSP|ADP utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso callControlApplicationName definito in Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> Scarica
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente è inserito in Webex, Webex crea un abbonamento per l'utente sul AS per ricevere gli eventi di telefonia per la cronologia della presenza e delle chiamate. L'abbonamento è associato a callControlApplicationName e il AS lo utilizza per sapere a quale Xsi-Events inviare gli eventi di telefonia.
La modifica del callControlApplicationName o il mancato nome di tutte le app Web Xsi-Events avranno impatto sugli abbonamenti e sulla funzionalità degli eventi di telefonia.
Configurazione del servizio di autenticazione (con convalida del token CI)
Utilizzare questa procedura per configurare il servizio di autenticazione per utilizzare la convalida del token CI con TLS. Questo metodo di autenticazione è consigliato se si utilizza una versione R22 o successiva e il sistema lo supporta.
La funzionalità TLS reciproca (mTLS) è supportata anche come metodo di autenticazione alternativo per il servizio di autenticazione. Se si dispone di più organizzazioni Webex in esecuzione sullo stesso server XSP|ADP, è necessario utilizzare l'autenticazione mTLS poiché la convalida del token CI non supporta più connessioni allo stesso servizio di autorizzazione XSP|ADP.
Per configurare l'autenticazione mTLS per il servizio di autorizzazione anziché la convalida del token CI, fare riferimento all'Appendice per Configurazione dei servizi (con mTLS per il servizio di autorizzazione).
Se attualmente si utilizza mTLS per il servizio di autorizzazione, non è obbligatorio riconfigurare per utilizzare la convalida del token CI con TLS.
-
Ottenere le credenziali OAuth per Webex per Cisco BroadWorks.
-
Installare le seguenti patch su ciascun server XSP|ADP. Installare le patch appropriate alla versione in uso:
-
Per R22:
-
Per R23:
-
Per R24: nessuna patch richiesta
Qualsiasi riferimento a XSP include XSP o ADP.
-
-
Installare l'applicazione
AuthenticationService
su ciascun servizio XSP|ADP.Eseguire il seguente comando per attivare l'applicazione AuthenticationService su XSP|ADP nel percorso context /authService.
XSP|ADP_CLI/Maintenance/ManagedObjects> attiva applicazione AuthenticationService 22.0_1.1123/authService
Eseguire questo comando per distribuire AuthenticationService su XSP|ADP:
XSP|ADP_CLI/Maintenance/ManagedObjects> distribuisci applicazione /authServiceBroadWorks Distribuzione SW Manager distribuzione /authService...
-
A partire da BroadWorks build 2022.10, le autorità di certificazione che arrivano con Java non vengono più incluse automaticamente nell'archivio attendibilità di BroadWorks quando si passa a una nuova versione di Java. Il servizio di autenticazione apre una connessione TLS a Webex per recuperare il token di accesso e deve disporre di quanto segue nel relativo truststore per convalidare l'URL IDBroker e Webex:
-
IdenTrust Commercial Root CA 1
-
Autorità di certificazione radice Go Daddy - G2
Verificare che questi certificati siano presenti nella seguente CLI
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> ottieni
Se non è presente, eseguire il seguente comando per importare le entità affidabili Java predefinite:
ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust
In alternativa, è possibile aggiungere manualmente questi certificati come trust anchor con il seguente comando:
ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust <alias> <trustAnchorFile>
Se l'ADP viene aggiornato da una release precedente, le autorità di certificazione della release precedente vengono importate automaticamente nella nuova release e continueranno a essere importate fino a quando non vengono rimosse manualmente.
L'applicazione AuthenticationService è esente dall'impostazione validatePeerIdentity in ADP_CLI/System/SSLCommonSettings/GeneralSettings e convalida sempre l'identità peer. Per ulteriori informazioni su questa impostazione, vedere FD di convalida del certificato Cisco BroadWorks X509.
-
-
Configurare i provider di identità eseguendo i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> ottieni
-
imposta clientId client-Id-From-Step1
-
impostazione abilitata true
-
imposta clientSecret client-Secret-From-Step1
-
imposta ciResponseBodyMaxSizeInBytes 65536
-
imposta issuerName <URL>
: per l'URL
, inserire l'URL IssuerName applicabile al cluster CI. Vedere la tabella seguente. -
set issuerUrl <URL>
: per l'URL
, inserire l'IssuerUrl applicabile al cluster CI. Vedere la tabella seguente. -
set tokenInfoUrl <IdPProxy URL>
: inserire l'URL del proxy IdP applicabile al cluster Teams. Vedere la seconda tabella riportata di seguito.
Tabella 1. Impostare issuerName e issuerURL Se il cluster CI è... Impostare issuerName e issuerURL su... USA
ue
US-B
Se non conosci il tuo Cluster CI, puoi ottenere le informazioni dai dettagli cliente nella vista Help desk di Control Hub.
Tabella 2. Imposta URL info token Se il cluster Teams è... Imposta URL info token su...(URL proxy IdP) acm
https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
diaframma
https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
aore
https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
-
Se non conosci il tuo cluster Teams, puoi ottenere le informazioni dai dettagli del cliente nella vista Help desk di Control Hub.
-
Per il test, è possibile verificare la validità dell'URL tokenInfo sostituendo la parte "
idp/authenticate
" dell'URL con "ping
".
-
-
Specificare l'autorizzazione Webex che deve essere presente nel profilo utente in Webex eseguendo il seguente comando:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> imposta ambito broadworks-connector:utente
-
Configura i provider di identità per la federazione Cisco utilizzando i seguenti comandi su ciascun server XSP|ADP:
XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> ottieni
-
imposta flsUrl https://cifls.webex.com/federation
-
imposta periodo di aggiornamento in minuti 60
-
imposta refreshToken refresh-Token-From-Step1
-
-
Per verificare che la configurazione FLS funzioni, eseguire il comando seguente. Questo comando restituirà l'elenco dei provider di identità:
XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Ottieni
-
Configurare la gestione token utilizzando i seguenti comandi su ciascun server XSP|ADP:
-
XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>
-
imposta tokenIssuer BroadWorks
-
imposta tokenDurationInOre 720
-
-
Genera e condividi chiavi RSA. È necessario generare le chiavi su un XSP|ADP, quindi copiarle in tutti gli altri XSP|ADP. Ciò è dovuto ai seguenti fattori:
-
Devi utilizzare le stesse coppie di chiavi pubblica/privata per la crittografia/decrittografia del token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene prima richiesto di emettere un token.
Se si spostano i tasti in sequenza o si modifica la lunghezza della chiave, è necessario ripetere la seguente configurazione e riavviare tutti gli XSP|ADP.
-
Selezionare un XSP|ADP da utilizzare per la generazione di una coppia di chiavi.
-
Utilizzare un client per richiedere un token crittografato a tale XSP|ADP, richiedendo il seguente URL dal browser del client:
https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)
(viene generata una coppia di chiavi privata/pubblica su XSP|ADP, se non ne era già presente una)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
esportaKeys
-
Copiare il file esportato
/var/broadworks/tmp/authService.keys
nella stessa posizione sugli altri XSP|ADP, sovrascrivendo un file.keys
precedente, se necessario. -
Importa le chiavi su ciascuno degli altri XSP|ADP:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
-
-
Fornire l'URL di authService al container Web. Il contenitore Web di XSP|ADP necessita dell'URL authService in modo da poter convalidare i token. Su ciascuno degli XSP|ADP:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per l'utilità di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
imposta URL http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> aggiungi tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Verificare il parametro con
get
. -
Riavviare XSP|ADP.
-
Rimuovi il requisito di autenticazione client per il servizio di autorizzazione (solo R24)
Se il servizio di autenticazione è configurato con la convalida del token CI su R24, è necessario anche rimuovere il requisito di autenticazione client per il servizio di autenticazione. Eseguire il seguente comando CLI:
ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> imposta <interfaceIp> <port> AuthenticationService clientAuthReq false
Configurazione di TLS e crittografie sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Authentication Service, Xsi-Actions e Xsi-Events utilizzano le interfacce del server HTTP. I livelli di configurabilità TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > Trasporto > HTTP > Interfaccia server HTTP = Più specifica
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il comando
get
e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Apache tomcat richiede un certificato per ogni interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> ottieni
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
L'interfaccia HTTP che interagisce con il cloud Webex deve essere configurata per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Inserire il comando
get <interfaceIp> 443
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserisci il comando
aggiungi <interfaceIp> 443 TLSv1.2
per assicurarti che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione di crittografia TLS sull'interfaccia del server HTTP
Per configurare le crittografie richieste:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Inserire il comando
get <interfaceIp> 443
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview). -
Inserire il comando
add <interfaceIp> 443 <cipherName>
per aggiungere una crittografia all'interfaccia del server HTTP.L'XSP|ADP CLI richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia del server HTTP, si utilizza:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>aggiungi 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base al nome.
Configura gestione dispositivi su XSP|ADP, server applicazioni e server di profilo
Il server di profilo e XSP|ADP sono obbligatori per la gestione dei dispositivi. Devono essere configurati in base alle istruzioni nella Guida alla configurazione di gestione dispositivi BroadWorks.
Interfaccia CTI e configurazione correlata
L'ordine di configurazione "da inmost a outmost" è elencato di seguito. Seguire questo ordine non è obbligatorio.
-
Configurazione del server applicazioni per abbonamenti CTI
-
Configurazione di XSP|ADP per abbonamenti CTI con autenticazione mTLS
-
Porte aperte in ingresso per interfaccia CTI sicura
-
Abbonamento alla tua organizzazione Webex a eventi CTI BroadWorks
Configurazione del server applicazioni per abbonamenti CTI
Aggiornare ClientIdentity sul server applicazioni con il nome comune (CN) del certificato client CTI Webex per Cisco BroadWorks.
Per ogni server applicazioni in uso con Webex, aggiungere l'identità del certificato a ClientIdentity come segue:
AS_CLI/System/ClientIdentity> aggiungi bwcticlient.webex.com
Il nome comune del certificato client Webex per Cisco BroadWorks è bwcticlient.webex.com
.
Configurazione di TLS e crittografie sull'interfaccia CTI
I livelli di configurabilità per l'interfaccia CTI XSP|ADP sono i seguenti:
Più generale = Sistema > Trasporto > Interfacce CTI > Interfaccia CTI = Più specifica
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità |
Contesto CLI |
---|---|
Sistema (globale) (R22 e versioni successive) |
XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Protocolli di trasporto per questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Tutte le interfacce CTI su questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocols> |
Un'interfaccia CTI specifica su questo sistema (R22 e versioni successive) |
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocols> |
In una nuova installazione, le seguenti crittografie vengono installate per impostazione predefinita a livello di sistema. Se non viene configurato alcun elemento a livello di interfaccia (ad esempio, l'interfaccia CTI o l'interfaccia HTTP), viene applicato questo elenco di crittografie. Tenere presente che questo elenco può cambiare nel tempo:
-
tls_ecdhe_rsa_with_aes_128_gcm_sha256
-
tls_ecdhe_ecdsa_with_aes_128_gcm_sha256
-
tls_ecdhe_rsa_with_aes_128_cbc_sha256
-
tls_ecdhe_ecdsa_with_aes_128_cbc_sha256
-
tls_dhe_dss_with_aes_128_gcm_sha256
-
tls_dhe_rsa_with_aes_128_gcm_sha256
-
tls_dhe_rsa_with_aes_128_cbc_sha256
-
tls_dhe_dss_with_aes_128_cbc_sha256
-
tls_ecdh_rsa_with_aes_128_gcm_sha256
-
tls_ecdh_ecdsa_with_aes_128_gcm_sha256
-
tls_ecdh_rsa_with_aes_128_cbc_sha256
-
tls_ecdh_ecdsa_with_aes_128_cbc_sha256
Lettura della configurazione dell'interfaccia CTI TLS su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer>
Inserire il comando
get
e leggere i risultati. È necessario visualizzare le interfacce (indirizzi IP) e, per ciascuna, se richiedono un certificato del server e se richiedono l'autenticazione del client.XSP|ADP_CLI/Interface/CTI/CTIServer> Ottieni interfaccia porta IP Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Aggiunta del protocollo TLS 1.2 all'interfaccia CTI
L'interfaccia CTI XSP|ADP che interagisce con il cloud Webex deve essere configurata per TLS v1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia CTI:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
-
Inserire il comando
get <interfaceIp>
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserire il comando
aggiungi <interfaceIp> TLSv1.2
per assicurarsi che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione di crittografia TLS sull'interfaccia CTI
Per configurare le crittografie richieste sull'interfaccia CTI:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
-
Immettere il comando
get
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements nella sezione Overview). -
Inserire il comando
add <interfaceIp> <cipherName>
per aggiungere una crittografia all'interfaccia CTI.L'XSP|ADP CLI richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
all'interfaccia CTI, è necessario utilizzare:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> aggiungi 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base al nome.
Trust Anchor per l'interfaccia CTI (R22 e versioni successive)
Questa procedura presuppone che gli XSP|ADP siano rivolti verso Internet o rivolti verso Internet tramite proxy pass-through. La configurazione del certificato è diversa per un proxy di bridge (vedere Requisiti del certificato TLS per il proxy bridge TLS).
Per ogni XSP|ADP nell'infrastruttura che sta pubblicando eventi CTI in Webex, effettuare le seguenti operazioni:
-
Accedi a Partner Hub.
-
Vai a Impostazioni > BroadWorks Calling e fai clic su Scarica certificato CA Webex per ottenere
CombinedCertChain .txt
sul computer locale.Questi file contengono due set di due certificati. Devi suddividere i file prima di caricarli negli XSP|ADP. Tutti i file sono obbligatori.
-
Suddividere la catena di certificati in due certificati:
combinedcertchain .txt
-
Aprire
combinedcertchain .txt
in un editor di testo. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
e incollare il blocco di testo in un nuovo file. -
Salvare il nuovo file come
root .txt
. -
Salvare il file originale come
emissione di .txt
. Il file originale ora deve disporre di un solo blocco di testo, circondato dalle righe-----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copia entrambi i file di testo in una posizione temporanea su XSP|ADP che stai proteggendo, ad esempio,
/var/broadworks/tmp/root .txt
e/var/broadworks/tmp/issuing .txt
-
Accedere a XSP|ADP e passare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
-
(Opzionale) Eseguire
help updateTrust
per visualizzare i parametri e il formato del comando. -
Carica i file dei certificati sui nuovi trust anchor - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot /var/broadworks/tmp/root .txt
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing /var/broadworks/tmp/issuing .txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
ewebexclientissuing
sono alias di esempio per i trust anchor; puoi utilizzare i tuoi alias purché tutte le voci siano univoche. -
Verificare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> ottieni
Alias Proprietario emittente ============================================================================= webexclientissuing Internal Private TLS SubCA Internal Private Root webexclientroot Internal Private Root[autofirmato]
-
Consenti ai client di eseguire l'autenticazione con i certificati:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> imposta allowClientApp true
Aggiunta dell'interfaccia CTI e abilitazione di mTLS
-
Aggiungere l'interfaccia SSL CTI.
Il contesto CLI dipende dalla versione di BroadWorks. Il comando crea un certificato del server autofirmato sull'interfaccia e forza l'interfaccia a richiedere un certificato client.
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> aggiungi <Interface IP> 8012 true true true
-
-
Sostituire il certificato del server e la chiave sulle interfacce CTI di XSP|ADP. A tale scopo, è necessario l'indirizzo IP dell'interfaccia CTI; è possibile leggerlo nel seguente contesto:
-
Su BroadWorks R22 e R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> ottieni
Quindi eseguire i seguenti comandi per sostituire il certificato autofirmato dell'interfaccia con il proprio certificato e la propria chiave privata:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interfaccia IP> file chiave</path/to/file chiave certificato> certificatoFile </path/to/certificato server> chainFile</path/to/chain file>
-
-
Riavviare XSP|ADP.
Abilitazione dell'accesso a eventi CTI BroadWorks su Webex
Devi aggiungere e convalidare l'interfaccia CTI quando configuri i cluster in Partner Hub. Vedi Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
Devi aggiungere e convalidare l'interfaccia CTI quando configuri i cluster in Partner Hub. Vedi Configurazione dell'organizzazione partner in Partner Hub per istruzioni dettagliate.
-
Specifica l'indirizzo CTI in base al quale Webex può abbonarsi agli eventi CTI BroadWorks.
-
Gli abbonamenti CTI si basano su abbonamento singolo e vengono stabiliti e mantenuti solo mentre tale abbonato viene predisposto per Webex per Cisco BroadWorks.
Impostazioni chiamata vista Web
CSWV (Call Settings Webview) è un'applicazione ospitata su XSP|ADP che consente agli utenti di modificare le impostazioni di chiamata BroadWorks attraverso una webview visualizzata nel soft client. Vedere la Guida alla soluzione Webview impostazioni chiamata Cisco BroadWorks.
Webex utilizza questa funzione per fornire agli utenti l'accesso alle impostazioni di chiamata BroadWorks comuni che non sono nativi dell'app Webex.
Se desideri che gli abbonati a Webex per Cisco BroadWorks accedano alle impostazioni di chiamata oltre ai valori predefiniti disponibili nell'app Webex, devi distribuire la funzione Impostazioni chiamata Webview.
La vista Web Impostazioni chiamata dispone di due componenti:
-
Applicazione Webview impostazioni chiamata, ospitata su Cisco BroadWorks XSP|ADP.
-
L'app Webex, che esegue il rendering delle impostazioni di chiamata in una vista Web.
Esperienza utente
-
Utenti Windows: Fai clic su Impostazioni chiamata, quindi fai clic su .
-
Utenti Mac: Fare clic sull'immagine del profilo, quindi su
.
Distribuzione di CSWV su BroadWorks
Installazione della vista Web impostazioni chiamata su XSP|ADPs
L'applicazione CSWV deve essere sullo stesso XSP|ADP che ospita l'interfaccia Azioni Xsi nel proprio ambiente. Si tratta di un'applicazione non gestita su XSP|ADP, pertanto è necessario installare e distribuire un file di archivio Web.
-
Accedere a cisco.com e ricercare "BWCallSettingsWeb" nella sezione di download del software.
-
Trova e scarica la versione più recente del file.
Ad esempio,
BWCallSettingsWeb_1.8.2_1.war
( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) era il più recente al momento della scrittura. -
Installare, attivare e distribuire l'archivio Web in base alla guida alla configurazione della piattaforma di servizio Cisco BroadWorks Xtended per la versione XSP|ADP. (Versione R24 è https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf).
-
Copiare il file .war in una posizione temporanea su XSP|ADP, ad esempio
/tmp/
. -
Selezionare il seguente contesto CLI ed eseguire il comando di installazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> installa applicazione /tmp/BWCallSettingsWeb_1.7.5_1.war
Il gestore software BroadWorks convalida e installa il file.
-
[Opzionale] Elimina
/tmp/BWCallSettingsWeb_1.7.5_1.war
(questo file non è più richiesto). -
Attivare l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects> attiva applicazione BWCallSettingsWeb 1.7.5 /callsettings
Il nome e la versione sono obbligatori per qualsiasi applicazione, ma per CSWV è necessario anche fornire un ContextPath poiché si tratta di un'applicazione non gestita. È possibile utilizzare qualsiasi valore non utilizzato da un'altra applicazione, ad esempio,
/callsettings
. -
Distribuire l'applicazione Impostazioni chiamata nel percorso contestuale selezionato:
XSP|ADP_CLI/Maintenance/ManagedObjects> distribuisci applicazione /callsettings
-
-
Ora è possibile prevedere l'URL delle impostazioni di chiamata che verrà specificato per i client, come segue:
https://<XSP|ADP-FQDN>/callsettings/
Note:
-
È necessario fornire la barra finale su questo URL quando si immette nel file di configurazione del client.
-
XSP|ADP-FQDN deve corrispondere all'FQDN azioni Xsi, poiché CSWV deve utilizzare azioni Xsi e CORS non è supportato.
-
-
Ripetere questa procedura per altri XSP|ADP nell'ambiente Webex per Cisco BroadWorks (se necessario).
L'applicazione Webview impostazioni chiamata ora è attiva su XSP|ADP.
Configura l'app Webex per utilizzare la vista Webview impostazioni chiamata
Per ulteriori informazioni sulla configurazione del client, vedere Guida alla configurazione di Webex per Cisco BroadWorks.
È presente un tag personalizzato nel file di configurazione dell'app Webex che è possibile utilizzare per impostare l'URL CSWV. Questo URL mostra le impostazioni di chiamata agli utenti tramite l'interfaccia dell'applicazione.
<config> <servizi> <web-call-settings target="%WEB_CALL_SETTINGS_TARGET_WXT%"> <url>%WEB_CALL_SETTINGS_URL_WXT%</url> </web-call-settings>
Nel modello di configurazione dell'app Webex su BroadWorks, configurare l'URL CSWV nel tag %WEB_CALL_SETTINGS_URL_WXT%.
Se non specifichi esplicitamente l'URL, l'impostazione predefinita è vuota e la pagina delle impostazioni di chiamata non è visibile agli utenti.
-
Assicurati di disporre degli ultimi modelli di configurazione per l'app Webex (vedi Profili dispositivo).
-
Impostare la destinazione delle impostazioni di chiamata Web su
csw
:%WEB_CALL_SETTINGS_TARGET_WXT% csw
-
Impostare l'URL delle impostazioni di chiamata Web per l'ambiente in uso, ad esempio:
%WEB_CALL_SETTINGS_URL_WXT% https://yourxsp.esempio.com/callsettings/
Questo valore è stato derivato durante la distribuzione dell'applicazione CSWV.
-
Il file di configurazione del client risultante deve contenere una voce nel seguente modo:
<web-call-settings target="csw"> <url>https://yourxsp.esempio.com/callsettings/</url> </web-call-settings>
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione delle notifiche push chiamate in Webex per Cisco BroadWorks
In questo documento viene utilizzato il termine Server push notifiche chiamate (CNPS) per descrivere un'applicazione ospitata XSP o ADP eseguita nel proprio ambiente. Il CNPS funziona con il sistema BroadWorks per essere a conoscenza delle chiamate in ingresso ai tuoi utenti e invia le notifiche ai servizi di notifica di Google Firebase Cloud Messaging (FCM) o Apple Push Notification service (APN).
Tali servizi notificano ai dispositivi mobili di Webex per gli abbonati Cisco BroadWorks che hanno chiamate in ingresso su Webex.
Per ulteriori informazioni su NPS, vedere Descrizione della funzione del server push delle notifiche.
Un meccanismo simile in Webex funziona con i servizi di messaggistica e presenza Webex per inviare le notifiche ai servizi di notifica Google (FCM) o Apple (APNS). Tali servizi notificano a loro volta agli utenti mobili Webex i messaggi in arrivo o le modifiche alla presenza.
In questa sezione viene descritto come configurare NPS per il proxy di autenticazione quando l'NPS non supporta già altre app. Se devi eseguire la migrazione di un NPS condiviso per utilizzare il proxy NPS, vedi Aggiornamento dell'NPS Cisco BroadWorks per l'uso del proxy NPS https://help.webex.com/nl5rir2/.
Panoramica sul proxy NPS
Per la compatibilità con Webex per Cisco BroadWorks, è necessario applicare le patch al CNPS per supportare la funzione proxy NPS, Server push per VoIP in UCaaS.
La funzione implementa un nuovo design nel server push di notifica per risolvere la vulnerabilità di sicurezza della condivisione delle chiavi private del certificato di notifica push con i provider di servizi per client mobili. Anziché condividere i certificati e le chiavi di notifica push con il provider di servizi, l'NPS utilizza una nuova API per ottenere un token di notifica push di breve durata da Webex per il backend Cisco BroadWorks e utilizza questo token per l'autenticazione con i servizi Apple APN e Google FCM.
La funzione migliora anche la funzionalità del server push notifiche di push delle notifiche ai dispositivi Android tramite la nuova API HTTPv1 di Google Firebase Cloud Messaging (FCM).
-
Per ulteriori informazioni, vedere Descrizione della funzione Server push per VoIP in UCaaS.
-
Le patch BroadWorks per la funzione sono disponibili su: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Per il software NPS e le patch, vedere la sezione Preparazione dell'NPS per Webex per Cisco BroadWorks.
Ricercare e scaricare la patch dalla pagina di download del software.
-
Ulteriori informazioni sul server ADP sono disponibili all'indirizzo https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html.
Considerazioni su APNS
Apple non supporterà più il protocollo binario basato su HTTP/1 sul servizio di notifica push di Apple dopo il 31 marzo 2021. Si consiglia di configurare XSP|ADP per utilizzare l'interfaccia basata su HTTP/2 per gli APN. Questo aggiornamento richiede che XSP|ADP che ospita NPS sia in esecuzione R22 o versioni successive.
Preparazione dell'NPS per Webex per Cisco BroadWorks
1 |
Installare e configurare un XSP dedicato (versione minima R22) o Application Delivery Platform (ADP). |
2 |
Installare le patch del proxy di autenticazione NPS: Patch XSP R22: Patch XSP R23: |
3 |
Attivare l'applicazione del server push di notifica. |
4 |
(Per le notifiche Android) Abilitare l'API FCM v1 su NPS.
|
5 |
(Per le notifiche Apple iOS) Abilita HTTP/2 su NPS.
Questa opzione è esclusiva della release 22 e delle versioni precedenti; non è disponibile nella release 23 e nelle versioni precedenti che supportano solo HTTP/2. |
6 |
Collegare un supporto tecnico da XSP/ADP NPS. |
7 |
Su ciascun server AS, il file namedefs in Esempio: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa 149.vle.broadsoft.com qa 149.vle.broadsoft.com IN UN 10.193.78.149 Una volta impostato, è necessario uno dei seguenti elementi per rispondere alle modifiche:
|
Operazioni successive
Per nuove installazioni di un NPS, andare a Configura NPS per l'uso del proxy di autenticazione
Per eseguire la migrazione di una distribuzione Android esistente a FCMv1, andare a Esegui migrazione da NPS a FCMv1
Configurazione di NPS per l'uso del proxy di autenticazione
Questa attività si applica a una nuova installazione di NPS, dedicata a Webex per Cisco BroadWorks.
Se si desidera configurare il proxy di autenticazione su un NPS condiviso con altre app mobili, vedere Aggiornamento dell'NPS Cisco BroadWorks per l'uso del proxy NPS ( https://help.webex.com/nl5rir2).
1 |
Ottenere le credenziali OAuth per Webex per Cisco BroadWorks. | |||||||||||||||||||
2 |
Creare l'account client su NPS:
Per verificare che i valori immessi corrispondano a quanto specificato, eseguire L'Url emittente CiscoCI deve essere SEMPRE il cluster CI USA, indipendentemente dalla posizione e il valore predefinito deve essere:
| |||||||||||||||||||
3 |
Immettere l'URL del proxy NPS e impostare l'intervallo di aggiornamento del token (si consiglia 30 minuti):
| |||||||||||||||||||
4 |
(Per notifiche Android) Aggiungere l'ID dell'applicazione Android al contesto delle applicazioni FCM su NPS.
| |||||||||||||||||||
5 |
(Per le notifiche Apple iOS) Aggiungere l'ID dell'applicazione al contesto delle applicazioni APNS assicurandosi di omettere la chiave di autorizzazione, impostarla su vuota.
| |||||||||||||||||||
6 |
Configura i seguenti URL NPS:
| |||||||||||||||||||
7 |
Configurare i seguenti parametri di connessione NPS in base ai valori consigliati mostrati:
| |||||||||||||||||||
8 |
Verificare che il server applicazioni stia eseguendo lo screening degli ID delle applicazioni poiché potrebbe essere necessario aggiungere le app Webex all'elenco degli utenti autorizzati: | |||||||||||||||||||
9 |
Riavviare XSP|ADP: | |||||||||||||||||||
10 |
Prova le notifiche di chiamata effettuando chiamate da un abbonato BroadWorks a due utenti mobili Webex. Verificare che la notifica di chiamata venga visualizzata sui dispositivi iOS e Android. |
Migra NPS a FCMv1
Questo argomento contiene procedure opzionali che è possibile utilizzare in Google FCM Console quando si dispone di una distribuzione NPS esistente per la migrazione a FCMv1. Le procedure sono tre:
-
Esegui migrazione dei client UC-One a FCMv1Quando si dispone di client UCaaS esistenti e occorre eseguire la migrazione per utilizzare FCMv1.
-
Esegui migrazione dei client SaaS a FCMv1: quando si dispone di client SaaS esistenti e occorre eseguire la migrazione per utilizzare FCMv1.
-
Aggiorna server ADP: quando si esegue la migrazione del server NPS a un server ADP.
Esegui migrazione dei client UC-One a FCMv1
Utilizza la procedura seguente in Google FCM Console per eseguire la migrazione dei client UC-One a Google FCM HTTPv1.
Se il branding viene applicato al client, il client deve disporre dell'ID mittente. Nella Console FCM, vedi
. L'impostazione viene visualizzata nella tabella delle credenziali del progetto.Per informazioni dettagliate, vedere la Guida al branding mobile di connessione all'indirizzo https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Fare riferimento al parametro gcm_defaultSenderId
, che si trova nel kit di branding, nella cartella Risorse e nel file branding.xml con la sintassi seguente:
<string name="gcm_defaultSenderId">xxxxxxxxxxxxx</string>
-
Accedere a FCM Admin SDK all'indirizzo http://console.firebase.google.com.
-
Selezionare l'applicazione Android appropriata.
-
Nella scheda Generale, registrare l'ID del progetto
-
Passare alla scheda Account servizio per configurare un account servizio. È possibile creare un nuovo account servizio o configurare un account esistente.
Per creare un nuovo account servizio:
-
Fare clic sul pulsante blu per creare un nuovo account servizio
-
Fai clic sul pulsante blu per generare una nuova chiave privata
-
Scarica chiave in una posizione sicura
Per riutilizzare un account servizio esistente:
-
Fare clic sul testo blu per visualizzare gli account servizio esistenti.
-
Identificare l'account servizio da utilizzare. L'account servizio richiede l'autorizzazione firebaseadmin-sdk.
-
A destra, fare clic sul menu dell'hamburger e creare una nuova chiave privata.
-
Scaricare il file json contenente la chiave e salvarlo in una posizione sicura.
-
-
Copia il file json su XSP|ADP.
-
Configura l'ID del progetto e:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> aggiungi <id progetto> <path/to/json-key-file> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> ottieni Project ID Accountkey ======================== mio_progetto ********
-
Configurare l'applicazione:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> aggiungi <app id> projectId <project id> ...Done XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> ottieni ID applicazione Progetto ID ============================== my_app my_project
-
Abilita FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Abilitato true ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP.
Esegui migrazione dei client SaaS a FCMv1
Utilizzare la procedura seguente su Google FCM Console se si desidera eseguire la migrazione dei client SaaS a FCMv1.
Accertarsi di aver già completato la procedura "Configurazione di NPS per utilizzare il proxy di autenticazione".
-
Disabilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Enabled false ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP. -
Abilita FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> impostato V1Abilitato true ...Fatto
-
Eseguire il comando
bwrestart
per riavviare XSP|ADP.
Aggiorna server ADP
Utilizzare la procedura seguente in Google FCM Console se si sta eseguendo la migrazione di NPS per utilizzare un server ADP.
-
Ottenere il file JSON dalla console cloud di Google:
-
Nella console Google Cloud, andare alla pagina Account servizio.
-
Fai clic su Seleziona un progetto, scegli il progetto e fai clic su Apri.
-
Individuare la riga dell'account servizio per il quale si desidera creare una chiave, fare clic sul pulsante verticale Altro, quindi fare clic su Crea chiave.
-
Selezionare un tipo di chiave e fare clic su Crea
Il file viene scaricato.
-
-
Aggiungere FCM al server ADP:
-
Importare il file JSON nel server ADP utilizzando il comando
/bw/install
. -
Accedi a ADP CLI e aggiungi il progetto e la chiave API:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> aggiungi connect /bw/install/google JSON
: -
Quindi, aggiungere l'Applicazione e la chiave:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Chiudi
-
Verificare la configurazione:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g Project ID Accountkey ======================== connect-ucaas ******** ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g Application ID Project ================================== com.broadsoft.ucaas.connect connect-ucaas
-
Configurazione dell'organizzazione partner in Partner Hub
Configurazione dei cluster BroadWorks
[una volta per cluster]
Ciò viene effettuato per i seguenti motivi:
-
Per consentire al cloud Webex di autenticare gli utenti in base a BroadWorks (tramite il servizio di autenticazione ospitato da XSP|ADP).
-
Di consentire alle app Webex di utilizzare l'Interfaccia XSI per il controllo delle chiamate.
-
Per consentire a Webex di ascoltare gli eventi CTI pubblicati da BroadWorks (presenza di telefonia e cronologia chiamate).
La procedura guidata del cluster convalida automaticamente le interfacce quando vengono aggiunte. È possibile continuare a modificare il cluster se una delle interfacce non viene convalidata correttamente, ma non è possibile salvare un cluster se sono presenti voci non valide.
Questo problema viene impedito poiché un cluster configurato in modo errato può provocare problemi che sono difficili da risolvere.
Operazioni da eseguire:
-
Accedere a Partner Hub (admin.webex.com) con le credenziali di amministratore partner.
-
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni BroadWorks Calling.
Se l'utente amministratore non dispone della visibilità delle impostazioni BroadWorks Calling, si consiglia di aprire un caso con Cisco TAC.
-
Fare clic su Aggiungi cluster.
In questo modo viene avviata una procedura guidata in cui vengono fornite le interfacce XSP|ADP (URL). È possibile aggiungere una porta all'URL dell'interfaccia se si utilizza una porta non standard.
-
Assegnare un nome a questo cluster e fare clic su Avanti.
Il concetto di cluster in questo caso è semplicemente un insieme di interfacce, solitamente raggruppate su un server o un farm XSP|ADP, che consentono a Webex di leggere le informazioni dal server applicazioni (AS). È possibile avere un XSP|ADP per cluster AS o più XSP|ADP per cluster o più cluster AS per XSP|ADP. I requisiti di scala per il tuo sistema BroadWorks non rientrano nell'ambito qui.
-
(Opzionale) Inserisci un Nome account e una Password utente BroadWorks all'interno del sistema BroadWorks che stai connettendo a Webex, quindi fai clic su Avanti.
I test di convalida possono utilizzare questo account per convalidare le connessioni alle interfacce nel cluster.
-
Aggiungi gli URL Azioni XSI e Eventi XSI.
-
Opzionale. Aggiornare l'URL DAS con l'URL del servizio di attivazione del dispositivo.
-
Opzionale. Seleziona la casella di controllo Abilita autenticazione diretta BroadWorks se desideri che gli accessi a BroadWorks siano diretti a BroadWorks. Altrimenti, l'autenticazione a BroadWorks viene proxy attraverso il servizio proxy IdP ospitato da Webex.
Questa casella di controllo incide sulle seguenti situazioni di accesso:
-
Accesso al portale di attivazione utente: gli utenti devono inserire le proprie credenziali BroadWorks quando accedono al portale. L'impostazione precedente determina se l'accesso è diretto a BroadWorks o tramite il proxy IdP.
-
Accesso client: se Autenticazione BroadWorks è configurata nel modello Onboarding, l'impostazione precedente determina se l'accesso client all'app Webex è diretto a BroadWorks o è proxy tramite il proxy IdP.
-
-
Fare clic su Avanti.
-
Nella pagina Interfaccia CTI, effettuare le seguenti operazioni:
-
Aggiungere l'URL CTI e la Porta per l'interfaccia CTI a cui si desidera connettersi.
-
Opzionale. Abilita il tasto di alternanza Cronologia chiamate, quindi inserisci il tuo ID utente BroadWorks. Quando questa opzione è selezionata, gli eventi della cronologia delle chiamate BroadWorks vengono sincronizzati con il cloud Webex. Gli utenti possono visualizzare la cronologia chiamate nell'app Webex.
-
Opzionale. Abilita il tasto di alternanza di sincronizzazione Non disturbare (DND) e inserisci il tuo ID utente BroadWorks. Questa opzione sincronizza gli eventi NoDist tra Webex e BroadWorks, assicurando che la funzione funzioni allo stesso modo su entrambe le piattaforme.
-
Opzionale. Abilita il tasto di alternanza Sincronizzazione stato assistente personale e inserisci il tuo ID utente BroadWorks. Questa opzione sincronizza lo stato di presenza dell'assistente personale tra i dispositivi BroadWorks Calling e l'app Webex.
-
Fare clic su Avanti.
-
-
Aggiungere l'URL del servizio di autenticazione.
-
Selezionare Servizio di autorizzazione con convalida del token CI.
Questa opzione non richiede mTLS per proteggere la connessione da Webex, poiché il servizio di autenticazione convalida correttamente il token utente in base al servizio di identità Webex prima di emettere il token di lunga durata per l'utente.
-
Esamina le voci nella schermata finale, quindi fai clic su Crea. Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Partner Hub passa gli URL a vari microservizi Webex che verificano le connessioni alle interfacce fornite.
-
Fare clic su Visualizza cluster per visualizzare il nuovo cluster e specificare se la convalida è stata completata correttamente.
-
Il pulsante Crea può essere disabilitato nella schermata finale (anteprima) della procedura guidata. Se non è possibile salvare il modello, indica un problema con una delle integrazioni appena configurate.
Questo controllo è stato implementato per evitare errori nelle attività successive. È possibile tornare indietro attraverso la procedura guidata durante la configurazione della distribuzione, che potrebbe richiedere modifiche all'infrastruttura (ad esempio, XSP|ADP, servizio di bilanciamento del carico o firewall) come documentato in questa guida, prima di salvare il modello.
Controllo delle connessioni alle interfacce BroadWorks
-
Accedere a Partner Hub (admin.webex.com) con le credenziali di amministratore partner.
-
Apri la pagina Impostazioni dal menu laterale e trova le impostazioni BroadWorks Calling.
-
Fai clic su Visualizza cluster.
-
Partner Hub avvia test di connettività dai vari microservizi verso le interfacce nei cluster.
Al termine dei test, nella pagina di elenco dei cluster viene visualizzato il messaggio di stato accanto a ciascun cluster.
Dovrebbero essere visualizzati messaggi verdi di operazione riuscita. Se viene visualizzato un messaggio di Errore rosso, fare clic sul nome del cluster interessato per visualizzare l'impostazione che causa il problema.
-
Opzionale. Selezionare un cluster se si desidera visualizzare le impostazioni esistenti per tale cluster, ad esempio azioni XSI, eventi XSI, URL DAS e impostazioni dell'interfaccia CTI.
Configura i tuoi modelli di onboarding
I modelli di onboarding sono il modo in cui applicherai la configurazione condivisa a uno o più clienti durante l'onboarding tramite i metodi di provisioning. È necessario associare ciascun modello a un cluster (creato nella sezione precedente).
È possibile creare il numero di modelli necessario, ma è possibile associare un solo modello a un cliente.
-
Accedi a Partner Hub e seleziona Clienti.
-
Fai clic sul pulsante Modelli di onboarding per visualizzare i modelli esistenti.
-
Fare clic su Crea modello.
-
Nella finestra Dettagli modello, aggiungere il nome del modello, il paese o la regione e la lingua e-mail predefinita.
-
Fare clic sull'elenco a discesa per l'ID abbonamento CCW, individuare gli abbonamenti elencati per il partner e selezionare l'abbonamento applicabile.
Questo campo è visualizzato solo per i partner migrati da Webex per BroadWorks a Webex.
-
Nella finestra Impostazione servizio, utilizzare il menu a discesa Cluster per scegliere il cluster che si desidera utilizzare con questo modello.
-
Inserisci un Nome modello, quindi fai clic su Avanti.
-
Configurare la modalità di provisioning utilizzando queste impostazioni consigliate:
Tabella 3. Impostazioni di provisioning consigliate per le diverse modalità di provisioning Nome impostazione
Provisioning a flusso costante con e-mail attendibili
Provisioning a flusso costante senza e-mail
Provisioning automatico utente
Abilita flusso BroadWorks attraverso il provisioning (includi le credenziali dell'account di provisioning se Attivato**)
Attivato
Fornire Nome account e Password di provisioning in base alla configurazione BroadWorks.
Attivato
Fornire Nome account e Password di provisioning in base alla configurazione BroadWorks.
Disattivato
Crea automaticamente nuove organizzazioni in Control Hub
Il†
Il†
Il†
Indirizzo e-mail provider servizi
Seleziona un indirizzo e-mail dall'elenco a discesa (puoi digitare alcuni caratteri, per trovare l'indirizzo se è un elenco lungo).
Questo indirizzo e-mail identifica l'amministratore all'interno dell'organizzazione partner a cui sarà concesso l'accesso di amministratore delegato a qualsiasi nuova organizzazione cliente creata con il modello Onboarding.
Paese
Scegli il paese che utilizzi per questo modello.
Il paese scelto associa le organizzazioni dei clienti create con questo modello a una determinata regione. Attualmente, la regione potrebbe essere (EMEAR) o (Nord America e resto del mondo). Vedi le mappature paese-regione in questo foglio di calcolo.
Il paese dell'organizzazione determinerà i numeri di chiamata in ingresso globali predefiniti per Cisco PSTN nei siti per riunioni Webex. Per ulteriori informazioni, fai riferimento alla sezione Paese della pagina della Guida.
Modalità BroadWorks Enterprise attiva
Abilitare questa opzione se i clienti forniti con questo modello sono aziende in BroadWorks.
Se si tratta di gruppi, lasciare questa opzione disattivata.
Se si dispone di un mix di aziende e gruppi in BroadWorks, è necessario creare modelli diversi per tali casi diversi.
Note della tabella:
-
† Questo switch assicura che venga creata una nuova organizzazione cliente se il dominio e-mail di un abbonato non corrisponde a un'organizzazione Webex esistente.
Questa operazione deve essere sempre attiva, a meno che non si stia utilizzando un processo di ordinazione ed esecuzione manuale (tramite Cisco Commerce Workspace) per creare organizzazioni dei clienti in Webex (prima di avviare il provisioning degli utenti in tali organizzazioni). Tale opzione è spesso nota come modello "Provisioning ibrido" ed è fuori dall'ambito di questo documento.
-
** "Account di provisioning" si riferisce all'account amministratore a livello di sistema BroadWorks. In BroadWorks, hai bisogno di un account amministratore con questi attributi: Tipo di amministratore = Provisioning, Sola lettura = Disattivato.
-
-
Selezionare il pacchetto di servizi predefinito per i clienti che utilizzano questo modello (vedere Pacchetti nella sezione Panoramica); Base, Standard, Premium o Softphone.
Puoi ignorare questa impostazione per i singoli utenti tramite Partner Hub.
-
Opzionale. Seleziona Disabilita chiamata gratuita Cisco Webex se desideri disabilitare le chiamate Webex.
-
Per Configurazione dell'accesso alla riunione, selezionare una delle seguenti opzioni:
-
Numeri di chiamata in ingresso Cisco (PSTN)
-
Numeri di chiamata in ingresso forniti dai partner (BYoPSTN): se si seleziona questa opzione, fare riferimento alla Guida alla soluzione Bring Your Own PSTN per Webex per Cisco BroadWorks per informazioni dettagliate su come configurare questa opzione.
-
-
Fare clic su Avanti.
-
Esistono due approcci per il provisioning degli abbonati per quanto riguarda il modo in cui vengono verificate le loro identità: utilizzando messaggi e-mail attendibili o messaggi e-mail non attendibili.
Nel flusso di lavoro e-mail attendibile gli utenti forniscono indirizzi e-mail al partner che li aggiunge in BroadWorks. L'utente in qualità di partner è responsabile del provisioning dell'indirizzo e-mail come parte del metodo di flusso attraverso o API.
Si consiglia vivamente di utilizzare il metodo di provisioning affidabile perché assicura che tutti gli abbonati siano forniti completamente da parte dell'utente come partner e che non sia richiesta alcuna azione da parte degli utenti finali.
Nel caso di e-mail non attendibile gli utenti devono verificare l'e-mail prima del provisioning oppure gli utenti possono autoattivarsi.
Nel caso Non attendibile, sono disponibili diverse modalità di provisioning in base alle impostazioni di verifica nella tabella seguente:
Tabella 4. Impostazioni di verifica utente consigliate per le modalità di provisioning non attendibili Nome impostazione
Provisioning a flusso costante senza e-mail
Provisioning automatico utente
Esegui prima provisioning amministratori
Consigliato*
Non applicabile
Consenti agli utenti di autoattivarsi
Non applicabile
Richiesto
-
Note della tabella:
-
* A ciascuna organizzazione cliente in Webex deve essere assegnato almeno un utente con ruolo di amministratore. Il primo utente a cui viene assegnato l'IM&P integrato in BroadWorks assume il ruolo di amministratore cliente se viene creata una nuova organizzazione cliente in Webex. In qualità di provider di servizi, è possibile avere il controllo su chi ottiene il ruolo. Selezionando questa impostazione, gli utenti non possono completare l'attivazione fino a quando non viene attivato il primo utente predisposto. Se si deseleziona questa impostazione, il primo utente che diventa attivo nella nuova organizzazione diventa l'amministratore del cliente.
-
-
Fare clic su Avanti.
-
Seleziona la modalità di autenticazione predefinita (Autenticazione BroadWorks o Autenticazione Webex) per l'accesso utente a Webex.
Questa impostazione non ha effetto sull'accesso dell'utente al portale di attivazione utente. Gli utenti devono utilizzare l'ID utente e la password BroadWorks quando accedono al portale, indipendentemente dalla modalità di configurazione del modello di onboarding.
Questa impostazione verrà applicata solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di applicare una nuova impostazione di autenticazione alle organizzazioni dei clienti esistenti, le impostazioni esistenti vengono applicate in modo che gli utenti esistenti non perdano l'accesso. Per modificare la modalità di autenticazione per le organizzazioni dei clienti esistenti, è necessario aprire un ticket con il centro TAC di Cisco.
Vedere Modalità di autenticazione nella sezione Preparazione dell'ambiente.
-
Fare clic su Avanti.
-
Per Preferenze, configurare quanto segue:
-
Scegliere se si desidera precompilare gli indirizzi e-mail utente nella pagina di accesso.
Devi utilizzare questa opzione solo se hai selezionato Autenticazione BroadWorks e hai anche inserito gli indirizzi e-mail degli utenti nell'attributo ID alternativo in BroadWorks. Altrimenti, dovranno utilizzare il proprio nome utente BroadWorks. La pagina di accesso offre un'opzione per modificare l'utente, se necessario, ma ciò potrebbe causare problemi di accesso.
-
Se desideri abilitare la sincronizzazione delle rubriche, imposta l'opzione Abilita sincronizzazione rubriche telefoniche per tutte le nuove organizzazioni cliente su On.
Questa opzione consente a Webex di leggere i contatti BroadWorks nell'organizzazione del cliente, in modo che gli utenti possano trovarli e chiamarli dall'app Webex.
-
Inserire un Amministratore partner.
Questo nome viene utilizzato nel messaggio e-mail automatizzato di Webex, che invita gli utenti a convalidare i relativi indirizzi e-mail.
-
Assicurati che l'opzione Consenti inviti e-mail amministratore al momento del collegamento a organizzazioni esistenti sia Attiva (l'impostazione predefinita è Attiva).
-
Fare clic su Avanti.
-
Rivedere le voci nella schermata finale. Puoi fare clic sui controlli di navigazione nella parte superiore della procedura guidata per tornare indietro e modificare eventuali dettagli. Fare clic su Crea.
Viene visualizzato un messaggio che indica che l'operazione è stata completata.
Fare clic su Visualizza modelli per visualizzare il nuovo modello elencato con qualsiasi altro modello.
-
Fare clic sul nome del modello per modificare o eliminare il modello, se necessario.
Non è necessario inserire nuovamente i dettagli dell'account di provisioning. I campi password/password di conferma vuoti sono disponibili per modificare le credenziali, ma lasciarle vuote per mantenere i valori forniti alla procedura guidata.
Aggiungere altri modelli se si dispone di configurazioni condivise diverse che si desidera fornire ai clienti.
Mantenere aperta la pagina Visualizza modelli poiché potrebbero essere necessari i dettagli del modello per una seguente attività.
Configurazione del server applicazioni con l'URL del servizio di provisioning
Questa attività è richiesta solo per il flusso attraverso il provisioning.
Patch Application Server (solo R22, R23 e R24)
-
Se ancora non è stato fatto, applicare la seguente patch applicabile alla versione in uso:
-
Per R22:
AP.as.22.0.1123.ap373197
-
Per R23:
AP.as.23.0.1075.ap373197
-
Per R24:
AP.as.24.0.944.ap384177
Per un elenco completo delle patch BroadWorks che costituiscono i requisiti per la distribuzione di Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.
-
-
Passare al contesto
Opzioni di manutenzione/contenitore
. -
Abilitare il parametro URL di provisioning:
/AS_CLI/Maintenance/ContainerOptions> aggiungi provisioning bw.imp.useProvisioningUrl true
Ottieni URL di provisioning da Partner Hub
Fare riferimento alla Guida all'amministrazione dell'interfaccia della riga di comando del server applicazioni Cisco BroadWorks per dettagli (Interfaccia > Messaggistica e servizio > IM&P integrato) dei comandi AS.
-
Accedi a Partner Hub e vai a
. -
Fare clic su Visualizza modelli.
-
Seleziona il modello che stai utilizzando per eseguire il provisioning degli abbonati di questa azienda/gruppo in Webex.
I dettagli del modello vengono visualizzati in un riquadro a scomparsa a destra. Se non è stato ancora creato un modello, è necessario effettuare questa operazione per ottenere l'URL di provisioning.
-
Copiare l'URL adattatore di provisioning.
Ripetere questa operazione per altri modelli se sono presenti più modelli.
(Opzione) Configurazione di parametri di provisioning a livello di sistema sul server applicazioni
Se si utilizza UC-One SaaS, è possibile non impostare il provisioning a livello di sistema e il dominio di servizio. Vedere Punti decisionali nella sezione Preparazione dell'ambiente.
-
Accedere al server applicazioni e configurare l'interfaccia di messaggistica.
-
AS_CLI/Interface/Messaging> imposta URL provisioning URL provisioning
-
AS_CLI/Interface/Messaging> imposta provisioningUserId provisioning_account_name
-
AS_CLI/Interface/Messaging> imposta password provisioning provisioning_account_password
-
AS_CLI/Interface/Messaging> imposta abilitaSincronizzazione true
-
-
Attivare l'interfaccia IMP integrata:
-
/AS_CLI/Service/IntegratedIMP> imposta serviceDomain esempio.com
-
/AS_CLI/Service/IntegratedIMP/DefaultAttribute> imposta userAttrIsActive true
-
Devi inserire il nome completo per il parametro URL provisioning
, come è stato assegnato in Control Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel file /etc/hosts
sul server applicazioni.
(Opzione) Configurazione dei parametri di provisioning per azienda sul server applicazioni
-
Nell'interfaccia utente BroadWorks, aprire l'azienda che si desidera configurare e andare a Servizi > IM&P integrato.
-
Selezionare Usa dominio servizio e immettere un valore fittizio (Webex ignora questo parametro). Puoi utilizzare
example.com
). -
Selezionare Usa server di messaggistica.
-
Nel campo URL, incollare l'URL di provisioning copiato dal modello in Partner Hub.
Devi inserire il nome completo per il parametro
URL provisioning
, come è stato assegnato in Partner Hub. Se il server applicazioni non riesce ad accedere al DNS per risolvere il nome host, è necessario creare la mappatura nel file/etc/hosts
sul server applicazioni. -
Nel campo Nome utente, inserire un nome per l'amministratore di provisioning. Questa operazione deve corrispondere al valore riportato nel modello in Partner Hub.
-
Immettere una password per l'amministratore di provisioning. Questa operazione deve corrispondere al valore riportato nel modello in Partner Hub.
-
Per Identità utente predefinita per ID IM&P, selezionare Principale.
-
Fare clic su Applica.
-
Ripetere questa operazione per altre aziende che desideri configurare per il flusso attraverso il provisioning.
Dati provisioning utente
Per informazioni sui dati utente che vengono scambiati tra BroadWorks e Webex durante il provisioning degli utenti, vedere Provisioning degli utenti del provider di servizi.
API di controllo pre-provisioning partner
L'API di controllo pre-provisioning consente agli amministratori e ai team di vendita di verificare gli errori prima di eseguire il provisioning di un pacchetto a un cliente o un abbonato. Gli utenti o le integrazioni autorizzate da un utente con il ruolo di amministratore completo del partner possono utilizzare questa API per garantire che non vi siano conflitti o errori con il provisioning del pacchetto per un determinato cliente o abbonato.
L'API controlla se sono presenti conflitti tra questo cliente/abbonato e i clienti/abbonati esistenti su Webex. Ad esempio, l'API può generare errori se l'abbonato è già predisposto per un cliente o un partner diverso, se l'indirizzo e-mail esiste già per un altro abbonato o se sono presenti conflitti tra i parametri di provisioning e ciò che esiste già su Webex. In questo modo, puoi correggere tali errori prima del provisioning, aumentando la probabilità di un provisioning corretto.
Per ulteriori informazioni sull'API, vedere: Guida per lo sviluppatore di Webex per la Vendita all'ingrosso
Per utilizzare l'API, vai a: Verifica preliminare il provisioning di un abbonato Wholesale
Per accedere a Verifica preliminare di un documento di provisioning Wholesale Subscriber, è necessario accedere a https://developer.webex.com/ portal.
SSO partner - SAML
Consente agli amministratori partner di configurare la funzionalità SSO SAML per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura SSO del partner seguente si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di aggiungere il Single Sign-On (SSO) partner a un'organizzazione esistente del cliente, il metodo di autenticazione esistente viene mantenuto per evitare che gli utenti esistenti perdano l'accesso.
-
Verifica che il provider di identità di terze parti soddisfi i requisiti elencati nella sezione Requisiti per provider di identità dell'Integrazione Single Sign-On in Control Hub.
-
Carica il file di metadati CI con provider identità.
-
Configura un modello di onboarding. Per l'impostazione Modalità di autenticazione, selezionare Autenticazione partner. Per l'ID entità IDP, inserire l'EntityID dall'XML dei metadati SAML del provider di identità di terze parti.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizzi il modello.
-
Molto che l'utente può accedere.
SSO partner - OpenID Connect (OIDC)
Consente agli amministratori partner di configurare la funzionalità SSO OIDC per le organizzazioni dei clienti appena create. I partner possono configurare una singola relazione SSO predefinita e applicare tale configurazione alle organizzazioni dei clienti che gestiscono nonché ai propri dipendenti.
La procedura seguente per l'impostazione dell'OIDC SSO del partner si applica solo alle organizzazioni dei clienti appena create. Se gli amministratori dei partner tentano di modificare il tipo di autenticazione predefinito in OIDC SSO partner in un tempio esistente, le modifiche non verranno applicate alle organizzazioni dei clienti già presenti utilizzando il modello.
-
Aprire una richiesta di assistenza con il centro TAC di Cisco con i dettagli dell'IDP OpenID Connect. Di seguito sono riportati attributi IDP obbligatori e opzionali. Il centro TAC deve impostare l'IDP sul CI e fornire l'URI di reindirizzamento da configurare sull'IDP.
Attributo
Richiesto
Descrizione
Nome IDP
Sì
Nome univoco ma senza distinzione tra maiuscole e minuscole per la configurazione IdP OIDC potrebbe essere costituito da lettere, numeri, trattini, sottolineature, inclinazioni e punti; la lunghezza massima è 128 caratteri.
ID client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Chiave privata client OAuth
Sì
Utilizzato per richiedere l'autenticazione IdP OIDC.
Elenco di ambiti
Sì
Elenco di ambiti che verranno utilizzati per richiedere l'autenticazione IdP OIDC, suddivisi per spazio; ad esempio, 'profilo e-mail openid' Deve includere openid ed e-mail.
Endpoint autorizzazione
Sì se discoveryEndpoint non è fornito
URL dell'endpoint di autorizzazione OAuth 2.0 di IdP.
Endpoint token
Sì se discoveryEndpoint non è fornito
URL dell'endpoint token OAuth 2.0 dell'IdP.
Endpoint di rilevamento
No
URL dell'endpoint di rilevamento IdP per il rilevamento degli endpoint OpenID.
Endpoint infoUtente
No
URL dell'endpoint Info utente dell'IdP.
Endpoint set di tasti
No
URL dell'endpoint di set di chiavi Web JSON dell'IdP.
Oltre agli attributi IDP precedenti, è necessario specificare l'ID organizzazione partner nella richiesta TAC.
-
Configurare l'URI di reindirizzamento sull'IDP connect OpenID.
-
Configura un modello di onboarding. Per l'impostazione della modalità di autenticazione, seleziona Autenticazione partner Con OpenID Connect e inserisci il nome IDP fornito durante l'impostazione dell'IDP come ID entità IDP OpenID Connect.
-
Creare un nuovo utente in una nuova organizzazione cliente che utilizzi il modello.
-
L'utente può eseguire l'accesso utilizzando il flusso di autenticazione SSO.
Abilita identificativo di correlazione chiamata
Per eseguire Webex per Cisco BroadWorks, è necessario abilitare l'Identificativo di correlazione chiamata. Questa impostazione è richiesta per molte funzioni di chiamata, tra cui Registrazione chiamata, Risposta per assente di gruppo, Dirigente e Dirigente-Assistente.
Utilizzare la CLI per abilitare la funzione su tutte le interfacce AS e XSP|ADP.
-
Eseguire i seguenti comandi sulle interfacce AS. In questo modo, il AS potrà inviare l'intestazione SIP
X-BroadWorks-Correlation-Info
:AS_CLI/Interface/SIP> imposta sendCallCorrelationIDNetwork true
AS_CLI/Interface/SIP> imposta sendCallCorrelationIDAccess true
-
Il/la
enableID correlazione chiamata
parametro associato all'applicazione Xsi-Actions viene utilizzato per controllare l'inclusione di informazioni di correlazione delle chiamate nei registri Xsi-Actions. Si consiglia di abilitareenableCallCorrelationID
utilizzando il seguente comando sulle interfacce XSP|ADP:XSP|ADP_CLI/Applications/Xsi-Actions/GeneralSettings>imposta enableCallCorrelationID true
Per ulteriori informazioni sull'identificatore di correlazione chiamata, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Sincronizzazione rubriche
La sincronizzazione delle rubriche assicura che gli utenti Webex per Cisco BroadWorks possano utilizzare la rubrica Webex per chiamare qualsiasi entità chiamante dal server BroadWorks. Quando questa funzione è abilitata, la rubrica di chiamata completa dal server BroadWorks viene sincronizzata con la rubrica Webex. Gli utenti possono accedere alla rubrica dall'app Webex e effettuare una chiamata a qualsiasi entità chiamante dal server BroadWorks.
Per attivare la sincronizzazione delle rubriche, vai a Sincronizzazione rubrica in Webex per Cisco BroadWorks.
Il provisioning a flusso costante di Webex per Cisco BroadWorks aggiunge gli utenti di messaggistica e le informazioni di chiamata associate dal server BroadWorks alla piattaforma Webex. Tuttavia, elenchi di telefoni, utenti non di messaggistica e entità non utente non sono inclusi (ad esempio, un telefono per sala conferenze, un fax o un numero di gruppo di ricerca). L'attivazione della sincronizzazione delle rubriche assicura che tutte le entità chiamanti vengano aggiunte alla piattaforma Webex.
Cronologia chiamate Unified
Quando la cronologia chiamate unificata è abilitata, gli eventi di chiamata BroadWorks vengono sincronizzati con il cloud Webex e diventano parte della cronologia delle chiamate e delle riunioni Webex Unified visualizzata nell'app Webex. Gli utenti possono visualizzare la propria cronologia dettagliata delle chiamate e della cronologia delle riunioni dall'app Webex.
La cronologia delle chiamate unificate può essere abilitata dagli amministratori a livello di partner in Partner Hub cluster per cluster. Quando questa funzione è attivata, la distribuzione BroadWorks sincronizza i seguenti eventi di chiamata nel cloud Webex:
-
Eventi della cronologia delle chiamate: questi eventi vengono utilizzati per creare una cronologia delle chiamate unificata dettagliata
-
Eventi di stato ricevitore: la cronologia delle chiamate unificate include le ottimizzazioni dello stato dell'aggancio che riducono la quantità di larghezza di banda di rete per gli aggiornamenti di presenza di telefonia
Requisiti cronologia chiamate Unified
Prima di configurare la cronologia chiamate unificata, verificare di aver applicato le patch al sistema. Questa funzione dipende dall'installazione delle seguenti patch BroadWorks:
Per R22:
-
AP.as.22.0.1123.ap378585
: dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> attiva 25433
Per R23:
-
AP.as.23.0.1075.ap378585
: dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> attiva 25433
-
Se si utilizza XSP—
AP.xsp.23.0.1075.ap378585
-
In caso di uso di ADP—
Xsi-Events-23_2021.05_1.251.bwar
Per R24:
-
AP.as.24.0.944.ap378585
: dopo l'installazione della patch, è necessario attivare la funzione 25433. Ad esempio:AS_CLI/System/ActivatableFeature> attiva 25433
Per l'elenco completo delle patch BroadWorks che occorre installare come prerequisito per eseguire Webex per Cisco BroadWorks, Vedere Requisiti software BroadWorks nella sezione Riferimento.
Oltre alle patch del sistema, il file di configurazione del client (config-wxt.xml
) deve avere il seguente tag impostato: <call-history enable-unified-history=”%ENABLE_UNIFIED_CALL_HISTORY_WXT%”/>
Per disporre di informazioni su gruppo di risposta, call center e altre informazioni di reindirizzamento nella cronologia chiamate Unified, è necessario installare e attivare le seguenti patch BroadWorks:
Per R23:
-
AP.as.23.0.1075.ap383346
-
AP.as.23.0.1075.ap383994
Per R24:
-
AP.as.24.0.944.ap383346
-
AP.as.24.0.944.ap383994
Per disporre delle informazioni su dirigente-assistente nella cronologia chiamate unificata, è necessario installare e attivare le seguenti patch BroadWorks:
Per R24:
-
AP.as.24.0.944.ap380052
-
AP.as.24.0.944.ap384239
-
ADP con Xsi-Events-24_2022.06 o versione successiva
Oltre alle patch BroadWorks, è necessario abilitare la sincronizzazione delle rubriche anche per la cronologia delle chiamate unificata per dirigente-assistente.
Quando si abilita la cronologia chiamate o la sincronizzazione DND, Webex invia richieste di aggiornamento dell'abbonamento CTI per tutti gli utenti sotto il cluster. A seconda del numero di utenti, questa operazione può durare fino a qualche ora. Si consiglia di non eseguire alcuna attività di manutenzione BroadWorks durante la stessa finestra di manutenzione.
Abilita cronologia chiamate (nuovo cluster)
Per abilitare la cronologia chiamate su un nuovo cluster, vedi la procedura per l'aggiunta di un cluster in Configurazione dell'organizzazione partner in Partner Hub.
Abilita cronologia chiamate (cluster esistente)
Per abilitare la cronologia chiamate su un cluster esistente, effettua le seguenti operazioni:
-
Accedi a Partner Hub all'indirizzo
admin.webex.com
. -
Vai a Impostazioni e seleziona un cluster esistente.
-
Verificare che la connessione del cluster sia buona. Nel pannello destro dovrebbe essere visualizzato un segno di spunta verde con Connessione stabilita.
Se non viene visualizzato, in Controlla connessioni (opzionale), inserisci ID utente BroadWorks e Password BroadWorks e fai clic su Verifica per verificare che la connessione sia buona.
-
Selezionare la casella di controllo Abilita cronologia chiamate.
-
Fai clic su Salva.
Interazioni funzioni
Le seguenti interazioni con le funzioni esistono per la cronologia chiamate unificata:
-
La cronologia chiamate unificata non è supportata per gli utenti configurati in BroadWorks con elenchi di indirizzamento o indirizzamenti diretti. Quando esiste questa situazione, gli eventi Cronologia chiamate e Stato ricevitore non vengono inviati all'app Webex.
-
La cronologia chiamate unificata non è supportata con la chiamata dell'interno. Le chiamate effettuate utilizzando la chiamata a interno potrebbero non essere riflesse correttamente nella cronologia chiamate.
Visualizzazione della cronologia chiamate sull'app Webex
Gli utenti finali possono accedere e visualizzare la cronologia delle chiamate unificate dall'app Webex. Per informazioni dettagliate, vedere: Webex | Visualizzazione della cronologia chiamate e riunioni.
Disabilita cronologia chiamate Unified
Una volta abilitata la cronologia chiamate unificata su un cluster, non è possibile disabilitare la funzione per proprio conto. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Indicazione di spam visiva
L'app Webex supporta un'indicazione visiva delle chiamate di spam nell'avviso popup di chiamata quando la chiamata viene presentata alla persona chiamata e nei record della cronologia chiamate unificata quando BroadWorks viene aggiornato per eseguire la convalida dell'ID chiamante tramite il framework STIR/SHAKEN. Per disporre di questa funzione:
- Abilitare la cronologia chiamate unificata come descritto nella sezione precedente.
- È necessario installare e attivare le seguenti patch:
- AP.as.23.0.1075.ap384591 / AP.as.24.0.944.ap384591
- o almeno AS-25_Rel_2022.12
- La funzione deve essere attivata tramite la CLI AS:
- AS_CLI/System/ActivatableFeature> attiva 104112
- AS_CLI/System/StirShaken> imposta enableVerification true
- Broadworks deve essere configurato per eseguire la firma, l'assegnazione di tag e la verifica STIR-SHAKEN come descritto in Tag e verifica di firma STIR-SHAKEN di Cisco BroadWorks
Se BroadWorks è configurato correttamente, una nuova intestazione X-Cisco-CallerId-Disposition verrà aggiunta nelle richieste INVITE inviate ai client Cisco e un nuovo campo callerIdDisposition verrà aggiunto agli eventi della cronologia chiamate esistenti inviati a Webex Cloud tramite l'interfaccia CTI. I dispositivi Webex utilizzeranno queste informazioni per fornire un'indicazione visiva di spam nella presentazione della chiamata e nella cronologia chiamate unificata della persona chiamata.
Sincronizzazione stato assistente personale
La funzione di sincronizzazione stato dell'assistente personale (PA) sincronizza lo stato di presenza dell'assistente personale tra i dispositivi BroadWorks Calling e Webex App.
Il servizio PA fornisce all'utente un'opzione per informare i chiamanti del motivo per cui la parte chiamata non è disponibile, fornendo opzionalmente informazioni su quando la parte chiamata ritorna e se è presente un operatore per gestire la chiamata. La funzione PA consente agli utenti nelle app Webex di visualizzare la presenza dell'utente insieme allo stato PA e alla durata configurati.
Prerequisiti
Accertarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione di BroadWorks.
Patch per RI e versione 24:
-
AP.as.24.0.944.ap385558
La funzione di sincronizzazione dello stato dell'assistente personale introduce un nuovo pacchetto di eventi PersonalAssistantSync per consentire ai client XSI di sincronizzare con le modifiche alla presenza dell'assistente personale Cisco BroadWorks. Per ulteriori informazioni, vedere Pacchetto eventi XSI per la funzione di sincronizzazione dello stato dell'assistente personale.
Oltre alle patch del sistema, il file di configurazione del client ({0}config-wxt.xml{1}) deve avere il seguente tag impostato: <personal-assistant abilitato="%PERSONAL_ASSISTANT_ENABLED_WXT%"/>
Abilita sincronizzazione stato assistente personale (nuovo cluster)
Per abilitare la sincronizzazione dello stato dell'assistente personale su un nuovo cluster, vedere la procedura per l'aggiunta di un cluster in Configurazione dell'organizzazione partner in Partner Hub.
Abilita sincronizzazione stato assistente personale (cluster esistente)
-
Accedere a Partner Hub con le credenziali di amministratore partner all'indirizzo https://admin.webex.com.
-
Fai clic su Impostazioni organizzazione.
-
Fai clic su Visualizza cluster e seleziona il cluster BroadWorks appropriato.
- Nella sezione Interfaccia CTI, abilitare il tasto di alternanza Sincronizzazione stato assistente personale.
-
Inserisci il tuo ID utente BroadWorks e fai clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione PA. Se la convalida non riesce, il pulsante Salva viene disabilitato.
-
Se la convalida ha esito positivo, fai clic su Salva.
L'abilitazione della sincronizzazione dello stato PA è un interruttore a una via. Una volta abilitata la funzione, non puoi disabilitarla da solo.
Disabilita sincronizzazione stato assistente personale
Una volta abilitato lo stato di sincronizzazione PA su uno dei cluster BroadWorks, non puoi disabilitare la funzione da solo. Se è necessario disabilitare la funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Identificazione chiamante e reindirizzamento chiamata
Identificazione chiamante
Quando l'app Webex riceve una chiamata, tenterà di identificare chi è il chiamante e visualizzare queste informazioni nella notifica di chiamata in arrivo, nella finestra in chiamata e al termine della chiamata, nella cronologia chiamate e nella casella vocale.
L'app Webex tenterà di trovare l'ID chiamante associando il numero di telefono in arrivo ai numeri di telefono dei contatti trovati in varie origini. L'app Webex utilizzerà le seguenti origini in questo ordine. Una volta trovato in un'origine, non tenterà di cercare altrove.
Se vengono trovate più istanze di un numero in un'origine, non tenterà di sceglierne una; in questo caso, non verrà visualizzato alcun ID chiamante.
-
Webex Common Identity (CI) contenente gli utenti dell'organizzazione.
-
Contatti personali e organizzazione. I contatti personali sono visibili sotto la scheda Contatti.
-
rubrica locale. In Windows - applicazione Outlook, in Mac - contatti Mac, in iOS - contatti iPhone, in Android - contatti Android.
Se non è stata trovata alcuna corrispondenza con il numero di telefono in arrivo, l'app utilizzerà il nome visualizzato nell'intestazione SIP FROM, se disponibile. In caso contrario, verrà utilizzata come ultima istanza la parte del nome utente dell'URI SIP dell'intestazione SIP From.
Per il controllo remoto delle chiamate (ad esempio, modalità di controllo telefono fisso) vengono utilizzate le informazioni XSI, dove viene utilizzato l'ID BWKS o l'interno, estratte dalle informazioni della parte remota nell'evento XSI. Se remote-party-info non è disponibile, viene utilizzato PAI (P-Asserted Identity) (se configurato).
Reindirizzamento chiamata
Nel caso in cui una chiamata sia stata reindirizzata o inoltrata, l'app tenterà di mostrare chi è il chiamante e come è stato inoltrato nella notifica e nella cronologia chiamate.
-
Chiamata inoltrata: Visualizza il numero che ha inoltrato la chiamata.
-
Gruppo di risposta: Visualizza il nome del gruppo di risposta che ha inoltrato la chiamata.
-
Coda call center: Visualizza il nome della coda che ha inoltrato la chiamata.
-
Dirigente-Assistente: Visualizza il nome del dirigente per il quale è in arrivo la chiamata.
Eccezioni:
-
Per le chiamate in coda chiamata interne, in cui un agente richiama una parte interna, la parte remota non visualizza il nome della coda chiamata, ma visualizza il nome dell'agente che la chiama.
Chiamata con risposta altrove:
Per i gruppi di risposta o le code di chiamata impostate con l'indirizzamento simultaneo, gli agenti visualizzeranno una chiamata risposta in un altro punto della cronologia chiamate se un altro agente risponde alla chiamata. Per gruppi di ricerca o code chiamate con indirizzamento sequenziale o in un overflow, le chiamate verranno visualizzate come chiamate non risposte nella cronologia chiamate se si riceve una risposta da un altro agente.
Seleziona ID chiamante
Panoramica
La funzione "Seleziona ID chiamante" consente agli utenti di passare tra diversi ID di linea chiamante per le chiamate esterne. Se abilitata dall'amministratore, gli utenti possono scegliere tra le seguenti opzioni per la propria identità di linea chiamante:
-
Numero utente ("Usa numero di telefono utente per identità linea chiamante")
-
CLID configurabile ("Usa CLID configurabile per identità linea di chiamata")
-
CLID gruppo ("Usa numero di telefono di gruppo/reparto per identità linea chiamante")
Funzionalità
Gli utenti dispongono di due metodi per modificare l'ID chiamante come predisposto dall'amministratore:
- Codici di accesso funzione (FAC): Codici specifici per ciascuna delle tre opzioni dell'ID chiamante.
- Interfaccia app Webex: Una vista intuitiva per l'utente all'interno delle app desktop e mobile Webex che visualizzano le opzioni dell'ID chiamante disponibili abilitate dall'amministratore, consentendo agli utenti di selezionare il proprio ID preferito.
Ulteriori funzioni
- Le app Webex includeranno anche opzioni per le code DNIS del call center.
- Gli utenti dell'app mobile avranno le opzioni Dual Persona disponibili per gli utenti di mobilità.
Precondizioni
Le seguenti condizioni devono essere soddisfatte sul server BroadWorks affinché l'utente possa controllare la sua scelta di criteri CLID esterni:
- Il flag di sistema "EnableUserSelectionOfExternalCLIDPolicy" è abilitato.
- L'ambito ID linea chiamata livello utente è impostato su "Usa criteri ID linea chiamata utente" per questo utente.
- Il flag "Consenti selezione utente di criteri di elaborazione chiamate a livello utente" è abilitato per l'utente.
- Se non viene definito alcun numero per le opzioni "Usa CLID configurabile per identità linea chiamante" o "Usa numero di telefono di gruppo/reparto per identità linea chiamante", i FAC o la visualizzazione dell'app non avranno effetto. Questa impostazione deve essere configurata dall'amministratore prima della selezione dell'utente.
Patch BroadWorks
Per il corretto funzionamento di questa funzione sono necessarie due patch BroadWorks specifiche:
Fare riferimento alla Sezione 8 Release Independent e Service Patch Information.
- BWKS-5230 era la funzione CLID selezionabile dall'utente originale: consente agli utenti (se il sistema è configurato correttamente) di modificare i criteri CLID applicabili. Vedere FD qui: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/UserSelectionOfExternalCallingLineIDOptionFD-R250.pdf
- BWKS-9510 è un miglioramento XSI richiesto dal team del client Webex per facilitare la individuazione delle opzioni disponibili per un utente. Questo è necessario perché la scelta dei criteri CLID non è una semplice funzione a livello utente (come CFA) direttamente controllabile. Piuttosto, dipende da varie opzioni di configurazione del sistema e dalla gerarchia dei "criteri di elaborazione delle chiamate". È possibile visualizzare i dettagli qui: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/FD/AS/XSIEnhancementToSupportUserSelectableCLIDFD-R250.pdf
Configurazione app Webex
Questi tag devono essere abilitati nelle configurazioni desktop, tablet e mobile:
<config> <servizi> <chiamate> <caller-id> <outgoing-calls enabled="%ENABLE_CLID_OUTGOING_CALLS_WXT%">
Identificativo di linea condivisa
L'identificativo di linea condivisa consente di predisporre linee di altri utenti come linee condivise sul dispositivo dell'utente finale. La configurazione della linea condivisa per l'app Webex è simile alla configurazione della linea condivisa per i telefoni fissi. Questa specifica funzione consente di assegnare identificativi di linea condivisa all'app Webex dell'utente finale.
Questa funzione è utile agli utenti per gestire le chiamate sull'interno di un altro utente direttamente dall'app Webex.
-
Puoi configurare l'identificativo di linea condivisa solo per la versione desktop di un'app Webex.
-
Puoi aggiungere un massimo di 10 linee inclusa la linea principale all'app Webex.
-
Non puoi assegnare la linea dello spazio di lavoro come linea condivisa.
-
Non è possibile eseguire il provisioning di un utente con il servizio Dirigente-Assistente contemporaneamente a linee condivise.
-
La porta della linea principale di un utente non deve essere modificata in una linea condivisa.
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
Patch 1: Flag del proprietario nell'elenco dei dispositivi per supportare le linee condivise del client Webex
R23 senza ADP:
-
AP.as.23.0.1075.ap384179
-
AP.xsp.23.0.1075.ap384179
R23 con ADP:
-
AP.as.23.0.1075.ap384179
-
XSI-Azioni-23_2022.10
r24:
-
come: AP.as.24.0.944.ap384179
-
XSI-Azioni-24_2022.10
r25:
-
come: Versione RI Rel_2022.10_1.310
-
XSI-Azioni-25_2022.10
Patch 2: Patch per aumentare il numero di porte sui tipi di profilo del dispositivo. Esempio: Per il client desktop: System>Modifica tipo di profilo di identità/dispositivo> Business Communicator - PC: Profilo, Opzioni standard, Numero di porte:
- SE è abilitata l'opzione 'Illimitato', non è richiesta alcuna modifica
- SE 'Limitato a' è <10, modificare il valore = 10 e salvarlo per utilizzare tutte le linee disponibili
-
Versione RI Rel_2022.10_1.310
Per dettagli sulla configurazione del client, vedere sezione 6.1.44 'Profilo principale' della Guida alla configurazione di Webex per Cisco BroadWorks.
Sincronizzazione Non disturbare (DND)
La sincronizzazione Non disturbare (DND) allinea le impostazioni DND tra Webex e BroadWorks sincronizzando lo stato Non disturbare tra le due piattaforme. Ad esempio, se un utente attiva la funzione Non disturbare dall'app Webex, tale stato viene sincronizzato con i dispositivi di chiamata BroadWorks. Di conseguenza, il telefono fisso registrato su BroadWorks dell'utente non squilla quando qualcuno tenta di chiamarlo. In modo analogo, se un utente imposta la funzione Non disturbare da un telefono fisso, lo stato viene sincronizzato con l'app Webex. Senza questa funzione, gli aggiornamenti NoDist di una piattaforma non vengono riconosciuti dall'altra.
La sincronizzazione DND viene applicata a livello di cluster BroadWorks e può essere abilitata in Partner Hub da un amministratore del partner.
Se sono presenti molti clienti (>50) nel cluster BroadWorks, la sincronizzazione NoDist non è supportata. In tali casi, si consiglia di contattare un tecnico del supporto Cisco TAC per assistenza.
Prerequisiti
Accertarsi che le seguenti patch siano applicate a AS e XSP|ADP. Applicare solo le patch per la versione di BroadWorks.
Per la versione 23:
<frammento>
- App ADP: Xsi-Actions-23_2022.03_1.220.bwar, Xsi-Events-23_2022.03_1.220.bwar
Per la versione 24:
<frammento>
- App ADP: Xsi-Actions-24_2022.03_1.220.bwar, Xsi-Events-24_2022.03_1.220.bwar
Dopo aver applicato le patch, attivare la funzione 25433 sul SA:
AS_CLI/System/ActivatableFeature> attiva 25433
Se sono presenti molti clienti (>50) nel cluster BroadWorks, operazioni come l'aggiornamento di azioni XSI, eventi XSI, URL DAS, URL XSP|ADP o sincronizzazione DND non sono supportate. In tali casi, si consiglia di contattare un tecnico del supporto Cisco TAC per assistenza.
Configurare la sincronizzazione chiave funzione dispositivo su BroadWorks. Assicurarsi che il telefono supporti SIP SUBSCRIBE/NOTIFY per il pacchetto eventi "come evento funzione". Per dettagli, vedi Sincronizzazione chiave funzione dispositivo Cisco BroadWorks.
Abilita sincronizzazione DND (cluster esistente)
-
Accedi a Partner Hub
-
Fare clic su Impostazioni.
-
Fai clic su Visualizza cluster e seleziona il cluster BroadWorks appropriato.
-
Abilita il tasto di alternanza di sincronizzazione Non disturbare (DND).
-
Inserisci il tuo ID utente BroadWorks e fai clic su Abilita.
Il sistema convalida che il cluster BroadWorks dispone delle patch appropriate per supportare la sincronizzazione DND. Se la convalida non riesce, il pulsante Salva viene disabilitato.
-
Se la convalida ha esito positivo, fai clic su Salva.
-
Una volta abilitata la sincronizzazione DND, Webex aggiorna tutti gli abbonamenti utente per includere il pacchetto per eventi Non disturbare. A seconda del numero di utenti, questo processo può richiedere alcune ore per il completamento.
-
L'abilitazione della sincronizzazione DND è un interruttore a una via. Una volta abilitata la funzione, non puoi disabilitarla da solo.
Abilita sincronizzazione DND (nuovo cluster)
È inoltre possibile abilitare la funzione durante la creazione del cluster. Per dettagli, vedi "Configurazione dei cluster BroadWorks" in Configurazione dell'organizzazione partner in Partner Hub.
Orario di pausa
Nelle distribuzioni Webex per BroadWorks, la funzione "Orario di pausa" si basa sulla funzionalità "Sincronizzazione Non disturbare (DND)" per garantire che le impostazioni dell'orario di pausa siano sincronizzate su tutti i dispositivi. Per sincronizzare correttamente l'orario di pausa tra desktop e dispositivi mobili, assicurarsi che l'opzione 'Sincronizzazione NoDist' sia abilitata nell'account dell'utente.
Disabilita sincronizzazione DND
Non puoi disabilitare la sincronizzazione DND da solo. Per disabilitare la funzione, crea un caso BEMS tecnico con le seguenti informazioni:
-
Famiglia: Servizio Spark
-
Prodotto: Chiamata in Webex (Webex per BroadWorks)
-
Componente: WxBW - Provisioning
-
Il caso BEMS deve indicare che la sincronizzazione Non disturbare deve essere disabilitata per un partner. Il caso deve contenere partnerId e clusterId BroadWorks.
Casi d'uso
Registrazione chiamata
Webex per Cisco BroadWorks supporta quattro modalità di registrazione chiamata.
Modalità di registrazione |
Descrizione |
Controlli/indicatori visualizzati sull'app Webex |
---|---|---|
Sempre |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente non può avviare o interrompere la registrazione. |
|
Sempre con Sospendi/Riprendi |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata. L'utente può sospendere e riprendere la registrazione. |
|
Su richiesta |
La registrazione viene avviata automaticamente quando viene stabilita la chiamata, ma viene eliminata a meno che l'utente non prema Avvia registrazione. Se l'utente avvia la registrazione, viene conservata la registrazione completa della configurazione della chiamata. Dopo aver avviato la registrazione, l'utente può anche sospendere e riprendere la registrazione |
|
OnDemand con avvio avviato dall'utente |
La registrazione non viene avviata a meno che l'utente non selezioni l'opzione Avvia registrazione nell'app Webex. L'utente ha la possibilità di avviare e interrompere la registrazione più volte durante una chiamata. |
|
Requisiti
Per distribuire questa funzione su Webex per Cisco BroadWorks, è necessario distribuire le seguenti patch BroadWorks:
-
Per R22: AP.as.22.0.1123.ap377718
-
Per R23: AP.as.23.0.1075.ap377718
-
Per R24: AP.as.24.0.944.ap377718
L'Identificativo di correlazione chiamata deve essere attivato. Per dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
Per utilizzare questa funzione, è necessario abilitare il seguente tag di configurazione: %ENABLE_CALL_RECORDING_WXT%
.
Questa funzione richiede un'integrazione con una piattaforma di registrazione chiamate di terze parti.
Per configurare la registrazione della chiamata su BroadWorks, vai alla Guida all'interfaccia di registrazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare la funzione di registrazione, vai all'articolo help.webex.com
Webex | Registrazione delle chiamate.
Per riprodurre una registrazione, gli utenti o gli amministratori devono passare alla relativa piattaforma di registrazione chiamate di terze parti.
Abilitazione della casella vocale per l'integrazione di Microsoft Teams
È possibile abilitare la casella vocale per gli utenti Microsoft teams nella soluzione Webex per BroadWorks. Questa integrazione consente agli utenti di recuperare le caselle vocali direttamente attraverso Microsoft Teams, migliorando l'esperienza utente generale.
Procedura per abilitare la casella vocale
Per abilitare la casella vocale per BroadWorks, devi abilitare il tasto di alternanza broadworks-voicemail-enabled-spark-541886: true a livello di organizzazione.
Per abilitare questa funzione, contattare il Centro assistenza tecnica Cisco (TAC).
Esperienza utente
Una volta impostata l'integrazione, gli utenti possono:
- Recupera le caselle vocali direttamente all'interno dell'applicazione Microsoft Teams.
- Ricevi notifiche per i nuovi messaggi vocali.
- Gestisci le impostazioni della casella vocale dall'interfaccia Webex.
Requisiti
Per supportare il recupero della casella vocale nell'integrazione Microsoft Teams con l'offerta Webex per BroadWorks, sono necessarie ulteriori modifiche di rete. I partner BroadWorks devono abilitare la condivisione risorse cross-origin (CORS) per i seguenti URL sulla relativa piattaforma BroadWorks:
- https://jabber-integration-a.wbx2.com/
- https://jabber-integration-r.wbx2.com/
- https://jabber-integration-k.wbx2.com/
- https://msteams-calling.webex.com
Per ulteriori dettagli sulle fasi di configurazione, fare riferimento alla sezione 8.5.1.2 della Guida alla configurazione della piattaforma di consegna delle applicazioni BW, che richiede la versione 2024.05 sull'ADP.
Gruppo parcheggio chiamata e recupera
Webex per Cisco BroadWorks supporta la funzione Parcheggio chiamata di gruppo e Retrieve. Questa funzione consente agli utenti all'interno di un gruppo di parcheggiare le chiamate, che possono quindi essere recuperate da altri utenti nel gruppo. Ad esempio, i dipendenti del retail in un'impostazione di store possono utilizzare la funzione per parcheggiare una chiamata che può essere selezionata da qualcuno in un altro reparto.
Operazione funzione
Una volta configurata la funzione
-
Durante una chiamata, un utente fa clic sull'opzione Parcheggia nella relativa app Webex per parcheggiare la chiamata su un interno selezionato automaticamente dal sistema. Il sistema visualizza l'interno all'utente per un periodo di 10 secondi.
-
Un altro utente nel gruppo fa clic sull'opzione Recupera chiamata nella relativa app Webex. L'utente quindi inserisce l'interno della chiamata parcheggiata per continuare la chiamata.
Requisiti
Per il funzionamento di questa funzione, verificare quanto segue:
-
Il file di configurazione del client deve avere i seguenti tag impostati:
<call-park enabled="%ENABLE_CALL_PARK_WXT%" timer="%CALL_PARK_AUTO_CLOSE_DIALOG_TIMER_WXT%"/>
-
L'identificativo di correlazione delle chiamate deve essere abilitato su AS e XSP|ADP. Per dettagli, vedere Abilitazione dell'identificatore di correlazione chiamata.
-
L'SBC deve essere configurato per passare l'attributo SIP '
x-broadworks-correlation-in
' a e dal server applicazioni.
Configurazione
Per informazioni su come configurare il parcheggio chiamata di gruppo su BroadWorks, vedere "Aggiunta di gruppo parcheggio chiamata" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte 2. Devi creare un gruppo e aggiungere utenti al gruppo.
Per informazioni su come configurare l'identificatore di correlazione chiamata su BroadWorks, vedere Descrizione della funzione dell'identificatore di correlazione chiamata Cisco BroadWorks.
Ulteriori informazioni
Per informazioni utente su come utilizzare il parcheggio chiamata di gruppo, vedere Webex | Parcheggio e recupero delle chiamate.
Parcheggio chiamata/Parcheggio chiamata indirizzata
Il parcheggio chiamate regolari o dirette non è supportato nell'interfaccia utente dell'app Webex, ma gli utenti predisposti possono distribuire la funzione utilizzando i codici di accesso alle funzioni:
-
Inserisci *68 per parcheggiare una chiamata
-
Inserisci *88 per recuperare una chiamata
Inclusione
Il servizio di inclusione viene comunemente utilizzato in ambienti di call center o in altre situazioni in cui può essere richiesta assistenza o intervento immediato.
Quando un servizio di inclusione è abilitato, un utente o un supervisore designato può accedere a una chiamata attiva avviando un comando specifico o utilizzando una combinazione di pulsanti o tasti dedicata sul telefono o sul dispositivo di comunicazione. Una volta effettuata la richiesta di inclusione, il sistema stabilisce una connessione con la chiamata in corso, consentendo alla persona autorizzata di ascoltare la conversazione o partecipare alla chiamata come partecipante attivo.
Il servizio di inclusione può essere utile in diversi scenari. In un'impostazione di call center, i supervisori o i formatori possono monitorare e assistere i rappresentanti dell'assistenza clienti ascoltando le loro chiamate in tempo reale. Se necessario, possono intervenire per fornire indicazioni o assumere il controllo della chiamata se il rappresentante è in difficoltà. In situazioni di emergenza o discussioni critiche, il personale autorizzato può accedere rapidamente alle conversazioni in corso per fornire assistenza o prendere decisioni importanti.
Nell'app Webex per Inclusione, viene inviata una notifica che indica che la chiamata viene trasformata in una conferenza. Non sono disponibili ulteriori informazioni in NOTIFY (info-chiamata o info-conferenza) qual è il tipo di conferenza, quindi possiamo trattarlo in modo diverso.
Quando si verifica un'inclusione, viene stabilita una chiamata a tre vie tra le parti. Sono introdotti i seguenti termini:
-
Supervisore: Un supervisore è una persona che supervisiona e gestisce un team di agenti del servizio clienti o rappresentanti di call center. Nel contesto dell'inclusione delle chiamate, un supervisore in genere ha la possibilità di monitorare e intervenire nelle chiamate dei clienti in corso. Possono utilizzare strumenti o software di monitoraggio delle chiamate per ascoltare le chiamate, fornire indicazioni agli agenti e garantire il controllo di qualità. Il ruolo del supervisore può coinvolgere la formazione degli agenti, rispondere alle preoccupazioni dei clienti e ottimizzare le prestazioni del team.
-
Cliente: Un cliente si riferisce a una persona o entità che interagisce con una società o un'organizzazione per ottenere prodotti, servizi o supporto. Nel contesto dell'inclusione della chiamata, un cliente è qualcuno che effettua o riceve una telefonata con un agente del servizio clienti. I clienti possono richiedere assistenza, informazioni o risoluzione di domande o problemi durante la chiamata. La funzione di inclusione della chiamata consente ai supervisori o al personale autorizzato di partecipare alla chiamata in corso tra il cliente e l'agente.
-
Agente: Un agente, noto anche come rappresentante dell'assistenza clienti o agente di call center, è una persona responsabile della gestione delle interazioni con i clienti e della fornitura di supporto o assistenza tramite telefono o altri canali di comunicazione. Gli agenti sono addestrati per rispondere alle richieste dei clienti, risolvere problemi, elaborare transazioni e offrire un'esperienza clienti positiva. Nel contesto dell'inclusione della chiamata, un agente è la persona che parla direttamente al cliente durante la telefonata. Se necessario, l'agente può ricevere istruzioni o feedback dal supervisore tramite l'inclusione delle chiamate.
Per qualsiasi richiesta avviata dal client come CallStartRequest, CallPickupRequest, DirectedCallPickupRequest, DirectedCallPickupWithBargeInRequest, ecc., se <Webex Client> (scegliere il nome corretto anziché il client Webex, se non è appropriato) viene fornito come dispositivo di visualizzazione della chiamata condivisa, la configurazione 'Avvisa tutti gli aspetti per le chiamate Click-to-Dial' deve essere abilitata nell'impostazione Identificativo chiamata condivisa affinché il client riceva una chiamata, a meno che la posizione non sia esplicitamente fornita dal client che avvia la richiesta.
Inoltro chiamata nativa mobile a riunione
L'escalation della chiamata nativa mobile a riunione è dotata di due funzioni univoche:
-
Nuova notifica push
Gli utenti mobili in una chiamata nativa ora possono passare all'app Webex toccando la Nuova notifica push. Quando avvii una schermata di chiamata nativa, viene visualizzata una Nuova notifica push sullo schermo e toccando la notifica si passa direttamente alla schermata durante la chiamata dell'app Webex.
Se si utilizza Webex Go o l'operatore di rete mobile (MNO) dispone di segnali di chiamata tramite il controllo chiamate Cisco per le chiamate da cellulare, viene visualizzata la notifica Webex durante una chiamata da cellulare.
-
Trasferisci chiamata mobile nella riunione
Quando ci si trova nel mezzo di una chiamata con qualcuno, si consiglia di trasferire la chiamata in una riunione per utilizzare alcune funzioni avanzate per le riunioni come video, condivisione o lavagna. In alternativa, invita altre persone alla discussione e passa a una riunione.
Requisiti BroadWorks
-
Funzione attivabile 25239
-
R23 con XSP|ADP:
-
Patch AS AP.as.23.0.1075.ap383064
-
XSP|ADP Patch AP.xsp.23.0.1075.ap383064
-
Patch AP.platform.23.0.1075.ap383064
-
-
R23 con ADP:
-
Patch AS AP.as.23.0.1075.ap383064
-
ADP con Xsi-Actions-23, CommPilot-23 versione > 2022.05_1.303 e versione NPS > 2022.08_1.350
-
-
r24:
-
Patch AS: AP.as.24.0.944.ap383064
-
ADP con Xsi-Actions-24, CommPilot-24 versione > 2022.05_1.303 e versione NPS > 2022.08_1.350
-
-
r25:
-
Versione RI Rel_2022.08_1.354
-
ADP con Xsi-Actions-25, CommPilot-25 > 2022.08_1.350 e versione NPS > 2022.08_1.350
-
Configurazione chiamata URI per supportare il trasferimento di una chiamata nella riunione
Criteri di composizione Url NS
Definisci regola per l'indirizzamento di (.*)webex.com attraverso I-SBC
NS_CLI/Policy/UrlDialing> ottieni criteri WebexMeetings: Istanza chiamata URL: Webex unknownSipURIHandling = reject disableSubscriberLookup = true Abilita = true CallTypes: Selezione = {ALL} Da = {PCS, ALL, TRMT, LO, TPSX, OAX, GNT, DP, LPS, OA, TPS, IOA, MOBX, EA, FGB, MOB, SNEN, POA, SV, SVCD, CAC, IN, TO1X, MS, CSV, VSC, EM, SVCO, SMC, TPSE, ZD, NIL, CS, CT, TF, GAN, VFAC, TO, DA, OAP} lineportOnly = false enableSipURIMatchingRules = true NS_CLI/Policy/UrlDialing/Rules> ottieni criteri WebexMeetings: Istanza chiamata URL: Tabella WebexCalling: Instradamento schema ID regolePeso costo dtg =================================================================== 1 *@*.webex.com WebexMeetings 1 50 WebexMeetings
NE indirizzamento NS per I-SBC
Configurazione di esempio
NS_CLI/System/Device/RoutingNE> ottieni elemento di rete WebexMeetings Posizione = 1281465 Centro dati = Costo statico = 1 Peso statico = 99 Sondaggio = falso OpState = stato abilitato = Profilo onLine = NIL_PROFILE Ricerca remota abilitata = falso Attributi di segnalazione = NS_CLI/System/Device/RoutingNE/Address> ottieni WebexMeetings indirizzamento NE indirizzo Peso costo Percorso trasporto porta ===================================================================== WebexMeetings sbc-address 1 99 - non specificato
Profilo di indirizzamento NS
Istanza criteri di UrlDialing aggiunta ai profili di indirizzamento appropriati
NS_CLI/Policy/Profile> ottieni il profilo MyInst: Istanza criteri Webex ========================================== … ComposizioneUrl WebexMeetings
Utilizzo NS Route per chiamata NetworkURL
Consentire al AS di rispettare l'indirizzamento NS in modalità AS ibrido
AS_CLI/Interface/IMS> imposta queryNSForNetworkURL true
Chiamata di emergenza E911
Webex per Cisco BroadWorks supporta la chiamata dei servizi di emergenza E911. Con questa funzione, le chiamate di emergenza vengono indirizzate a un punto di risposta per la sicurezza pubblica (PSAP, Public Safety Answering Point) che può quindi indirizzare i servizi di emergenza alla posizione del chiamante. Per utilizzare questa funzione, devi integrare Webex per Cisco BroadWorks con un provider di chiamate di emergenza E911.
Utilizza i seguenti articoli Webex per configurare il supporto per i servizi di chiamata di emergenza E911:
-
Chiamata di emergenza E911 in Webex per BroadWorks: utilizza questo articolo per configurare la chiamata di emergenza E911 in Webex per Cisco BroadWorks utilizzando uno dei seguenti provider E911 supportati:
-
Larghezza di banda
-
Intrado
-
Categoria: RedSky
-
-
Esclusione di responsabilità per chiamata di emergenza: se disponi di un servizio di posizione, puoi configurare la finestra Esclusione di responsabilità per i servizi di emergenza nell'app Webex in modo da includere un'opzione che consente agli utenti di aggiornare la propria posizione al momento dell'accesso.
Personalizzazione e provisioning dei client
Gli utenti scaricano e installano le proprie app Webex generiche, per desktop o dispositivi mobili (per i collegamenti di download, vedi Piattaforme di app Webex). Una volta eseguita l'autenticazione, il client si registra su Webex Cloud per messaggi e riunioni, recupera le relative informazioni di branding, rileva le relative informazioni sul servizio BroadWorks e scarica la configurazione di chiamata dal server applicazioni BroadWorks (tramite DMS su XSP|ADP).
I parametri di chiamata per le app Webex vengono configurati in BroadWorks (come di consueto). È possibile configurare branding, messaggistica e parametri di riunione per i client in Control Hub. Non si modifica direttamente un file di configurazione.
Questi due set di configurazioni possono sovrapporsi, nel qual caso la configurazione Webex sostituisce la configurazione BroadWorks.
Aggiunta di modelli di configurazione delle app Webex al server applicazioni BroadWorks
Le app Webex sono configurate con file DTAF. I client scaricano un file XML di configurazione dal server applicazioni tramite il servizio Gestione dispositivi su XSP|ADP.
-
Ottenere i file DTAF richiesti (vedere Profili dispositivo nella sezione Preparazione dell'ambiente).
-
Verificare di disporre dei set di tag corretti in Sistema BroadWorks > Risorse > Set di tag di gestione dispositivi.
-
Per ciascun client che stai predisponendo:
-
Scaricare ed estrarre il file zip DTAF per il client specifico.
-
Importa file DTAF in BroadWorks su Sistema > Risorse > Tipi di profilo identità/dispositivo
-
Apri il profilo dispositivo appena aggiunto per la modifica e:
-
Inserire il nome di dominio completo (FQDN) dell'azienda agricola XSP|ADP e il protocollo di accesso dispositivo.
-
Selezionare la casella di controllo Supporta info parte remota. Questo supporto è richiesto per il funzionamento della condivisione del desktop.
È inoltre possibile abilitare il supporto della parte remota eseguendo il seguente comando CLI sul server applicazioni:
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
-
-
Modificare i modelli in base all'ambiente (vedere la tabella seguente).
-
Salvare il profilo.
-
-
Fare clic su File e autenticazione, quindi selezionare l'opzione per ricostruire tutti i file di sistema.
Nome |
Descrizione |
Priorità codec |
Configura ordine di priorità per codec audio e video per chiamate VoIP |
TCP, UDP e TLS |
Configurare i protocolli utilizzati per la segnalazione SIP e il contenuto multimediale |
Porte audio e video RTP |
Configura intervalli di porte per audio e video RTP |
Opzioni SIP |
Configurare diverse opzioni correlate a SIP (INFO SIP, utilizzare rport, rilevamento proxy SIP, intervalli di aggiornamento per registrazione e abbonamento, ecc.) |
Personalizzazione del branding per l'app Webex
-
Personalizzazioni partner: gli amministratori dei partner possono applicare personalizzazioni di branding avanzate che si applicano all'organizzazione partner e/o ai clienti che il partner gestisce. Vedi Configurazione delle personalizzazioni di branding avanzate.
-
Personalizzazioni clienti: se il partner consente ai clienti di applicare le proprie personalizzazioni di branding, gli amministratori dei clienti possono seguire le procedure in Aggiungi il branding aziendale a Webex.
Il portale di attivazione utente utilizza lo stesso logo aggiunto per il branding del client.
Personalizzazione degli URL di segnalazione problemi e della Guida
Per personalizzare queste opzioni, gli amministratori possono seguire la procedura "Aggiungi URL sito di feedback e assistenza", disponibile in entrambi gli articoli di branding precedenti.
Configurazione dell'organizzazione di test per Webex per Cisco BroadWorks
Operazioni preliminari
Con provisioning a flusso costante
Prima di eseguire questa attività, è necessario configurare tutti i servizi XSP|ADP e l'organizzazione partner in Control Hub.
1 |
Assegna servizio in BroadWorks: |
2 |
Verifica organizzazione cliente e utenti in Control Hub: |
Test utente
1 |
Scarica l'app Webex su due macchine diverse. |
2 |
Eseguire l'accesso come test degli utenti sulle due macchine. |
3 |
Effettuare chiamate di prova. |
Gestione di Webex per BroadWorks
Pre provisioning organizzazioni clienti
Nel modello corrente, viene eseguito automaticamente il provisioning dell'organizzazione del cliente quando si onboard il primo utente attraverso uno dei metodi descritti in questo documento. Il provisioning viene eseguita una sola volta per ciascun cliente.
Provisioning utenti
È possibile eseguire il provisioning degli utenti nei seguenti modi:
-
Usa API per creare account Webex
-
Assegnare i messaggi e-mail integrati IM&P (provisioning flow) con e-mail affidabili per la creazione di account Webex
-
Assegna IM&P integrato (provisioning FLOW) senza messaggi e-mail attendibili. Gli utenti forniscono e convalidano gli indirizzi e-mail per la creazione di account Webex
-
Consenti agli utenti l'attivazione autonoma (inviando loro un collegamento, creano account Webex)
API di provisioning pubblico
Webex sono esposti API pubbliche per consentire ai provider di servizi di integrare Webex per il provisioning del sottoscrittore Cisco BroadWorks nei flussi di lavoro di provisioning esistenti. La specifica per queste API è disponibile developer.webex.com
. Se si desidera sviluppare con queste API, contattare il rappresentante Cisco per ottenere Webex per Cisco BroadWorks.
I clienti Wholesale verranno rifiutati da queste API.
Provisioning Flow
Su BroadWorks, è possibile fornire agli utenti l'opzione Abilita IM integrato&P. Questa azione causa il provisioning dell'adattatore BroadWorks per rendere chiamata API di eseguire il provisioning dell'utente su Webex. La nostra API di provisioning è compatibile retrocompatibile con l'API UC-One SaaS. BroadWorks AS non richiede alcuna modifica di codice, ma solo una modifica di configurazione all'endpoint API per l'adattatore di provisioning.
La fornitura del sottoscrittore su Webex può richiedere una notevole quantità di tempo (diversi minuti per l'utente iniziale in un'azienda). Webex esegue il provisioning come attività in background. Pertanto, il completamento del provisioning di flusso indica che il provisioning è stato avviato. Non indica il completamento.
Per verificare che gli utenti e l'organizzazione del cliente siano completamente predisposti su Webex, è necessario accedere a Partner Hub e ricercare l'elenco dei clienti.
Gli utenti trunking BroadWorks possono disporre di Webex per BroadWorks tramite un aspetto di chiamata condivisa (SCA). All'utente del trunking deve essere assegnato il servizio di autenticazione. Come descritto nella Guida alla soluzione di trunking BroadWorks sezione 8, ciò consente di separare l'autenticazione dell'aspetto SCA Webex dall'autenticazione trunk comune. Non è possibile eseguire il provisioning di Webex per BroadWorks per il trunking degli utenti con funzioni di elenco di indirizzamento o di indirizzamento diretto assegnate.
La posizione dei modelli è stata spostata da BroadWorks Calling in Impostazioni organizzazione alla sezione Elenco clienti ed è ora denominata modello di onboarding.
Attivazione automatica utente
Per fornire gli utenti BroadWorks in Webex, senza assegnare il servizio IM&P integrato:
-
Accedi a Partner Hub e trova la pagina Elenco clienti .
-
Fare clic su View Templates (Visualizzamodelli).
-
Seleziona il modello di Onboarding di provisioning da applicare a questo utente.
Tenere presente che ciascun modello è associato a un cluster e all'organizzazione partner. Se l'utente non è nel sistema BroadWorks associato a questo modello, l'utente non può attivare automaticamente con il collegamento.
-
Copiare il collegamento per il provisioning e inviarlo all'utente.
È possibile anche includere il collegamento di download del software e ricordare all'utente che deve fornire e convalidare il relativo indirizzo e-mail per attivare l'account Webex.
-
È possibile monitorare lo stato di attivazione dell'utente sul modello selezionato.
Per ulteriori informazioni, vedere Provisioning utente e flussi diattivazione.
Provisioning con e-mail non attendibili
Partner Hub fornisce una serie di controlli nella vista Stato utente che consentono agli amministratori di Cisco BroadWorks provider di servizi di esaminare lo stato utente e risolvere gli errori durante il provisioning con e-mail non attendibili. Per informazioni dettagliate, vedere Verifica provisioning utente con messaggi e-mail nonattendibili.
Spostamento degli utenti Webex in Webex per Cisco BroadWorks
Per spostare gli utenti Webex esistenti in Webex per Cisco BroadWorks, fare riferimento alla tabella seguente per determinare la procedura da seguire.
L'utente Webex esistente appartiene a ... |
Segui questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (ad esempio, account gratuito, account di prova) |
|
Organizzazione cliente |
Allega Webex per BroadWorks all'organizzazione esistente: l'allegato dell'organizzazione (per il primo utente) aggiunge anche Webex per BroadWorks agli utenti successivi, a condizione che siano assegnati all'organizzazione corretta. |
L'utente Webex esistente appartiene a ... |
Segui questi processi per spostare l'utente |
---|---|
Organizzazione consumer o autoiscrizione (ad esempio, account gratuito, account di prova) |
Se l'organizzazione Webex per BroadWorks non esiste (non viene eseguito il provisioning di alcun utente):
Se esiste un'organizzazione Webex per BroadWorks (viene eseguito il provisioning di almeno un utente):
|
Organizzazione cliente |
|
Spostamento dell'utente (con consenso) in Webex per Cisco BroadWorks
Utilizzare questa procedura per spostare un utente Webex esistente che si trova in un'organizzazione consumer o dispone di un account di iscrizione autonoma (account gratuito o account di prova) in Webex per Cisco BroadWorks. Tenere presente che l'organizzazione Webex per Cisco BroadWorks deve esistere (il primo utente predisposto). In questo caso, è possibile utilizzare una di queste opzioni per spostare gli utenti:
-
Trasferisci utente (con e-mail attendibile): utilizza il provisioning con e-mail attendibili
-
Trasferisci utente (con e-mail non attendibile): utilizza il provisioning con e-mail non attendibili
-
Attivazione automatica
Se l'organizzazione Webex per Cisco BroadWorks non è ancora stata creata (non è stato eseguito il provisioning di alcun utente), seguire i normali processi di provisioning ( Provisioning utenti) per creare l'organizzazione e aggiungere il primo utente come utente di amministrazione. Una volta eseguito il provisioning del primo utente nell'organizzazione, seguire i metodi basati sul consenso in questa procedura per spostare gli utenti successivi.
Sposta utente (con e-mail attendibile)
Se il modello di onboarding utilizza e-mail attendibili, l'amministratore del partner può spostare gli utenti successivi con questo processo:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Activate Account (Attivaaccount). L'utente viene reindirizzato al portale consumer Webex.
-
L'utente accede a Webex.
-
L'utente fa clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Sposta utente (con e-mail non attendibile)
Se il modello di onboarding utilizza e-mail non attendibili, è necessario convalidare prima l'indirizzo e-mail dell'utente. L'amministratore può seguire questo processo per spostare gli utenti successivi:
-
Amministratore aggiunge l'utente.
-
L'utente viene inserito automaticamente sul bridge di provisioning BroadWorks.
-
All'utente viene inviato un testo con un collegamento di attivazione.
-
-
L'utente fa clic sul collegamento Attivazione e inserisce il relativo indirizzo e-mail.
-
La ricerca CI determina che questo utente dispone di un altro account Webex con questo indirizzo e-mail.
-
Viene inviato all'utente un messaggio e-mail automatico.
-
-
L'utente apre il messaggio e-mail e fa clic su Partecipaora.
-
Indirizzo e-mail convalidato.
-
L'utente viene reindirizzato per accedere al portale Webex Consumer.
-
-
L'utente accede a Webex.
-
L'utente deve fare clic su Elimina per eliminare l'account Webex precedente.
-
Account Webex precedente eliminato.
-
L'utente è predisposto per Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
L'utente viene indirizzato alla pagina di download.
-
Flusso di attivazione automatica
Se l'utente dispone di un account BroadWorks esistente, potrà utilizzare il processo di attivazione automatica per spostare l'account.
-
L'utente accede all'URL del portale di accesso utente utilizzando le credenziali BroadWorks.
-
L'utente inserisce il relativo indirizzo e-mail.
-
L'utente viene inserito sul bridge di provisioning BroadWorks.
-
Viene inviato un messaggio e-mail automatico all'indirizzo e-mail dell'utente.
-
-
L'utente apre il messaggio e-mail e fa clic sul collegamento Partecipa ora, che convalida l'indirizzo e-mail.
-
CI ha rilevato che l'utente dispone di un account Webex esistente. L'utente deve eliminare l'account precedente prima di continuare.
-
L'utente viene reindirizzato per accedere a Webex.
-
-
L'utente accede al portale consumer.
-
L'utente fa clic su Delete Account (Eliminaaccount).
-
L'account Webex precedente viene eliminato.
-
L'utente ha predisposto un nuovo account Webex per Cisco BroadWorks con lo stesso indirizzo e-mail.
-
Allega Webex per BroadWorks all'organizzazione esistente
Se si è un amministratore partner che aggiunge i servizi Webex per BroadWorks a un'organizzazione cliente Webex esistente, non ancora associata a un'azienda BroadWorks gestita da partner, l'amministratore dell'organizzazione cliente DEVE approvare l'accesso dell'amministratore affinché la richiesta di provisioning venga eseguita correttamente.
L'approvazione dell'amministratore dell'organizzazione è necessaria se è vera una delle seguenti condizioni:
-
L'organizzazione del cliente esistente dispone di 100 utenti o più
-
L'organizzazione dispone di un dominio e-mail verificato
-
Dominio organizzazione richiesto
Se nessuno dei criteri precedenti è vero, si può verificare un collegamento automatico.
In uno scenario di Allegato automatico , un abbonamento Webex per BroadWorks viene aggiunto a un'organizzazione cliente esistente senza alcuna notifica all'amministratore dell'organizzazione o all'utente finale esistente. Nella maggior parte dei casi, all'organizzazione partner vengono riconosciuti diritti di amministratore di provisioning. Tuttavia, se l'organizzazione del cliente non dispone di licenze o solo di licenze sospese/annullate, verrà impostato un amministratore completo.
Con l'accesso amministratore di provisioning, si avrà visibilità limitata in Control Hub agli utenti dell'organizzazione esistente. Si consiglia di contattare l'amministratore del cliente e richiedere l'accesso amministratore completo all'organizzazione.
Gli amministratori dei partner possono completare la seguente procedura per aggiungere i servizi di chiamata BroadWorks a un'organizzazione Webex esistente:
Assicurati che l'opzione Consenti inviti e-mail amministratore al momento del collegamento a organizzazioni esistenti (il tasto di alternanza è attivato per impostazione predefinita).
1 |
L'amministratore del partner esegue il provisioning di Webex per Cisco BroadWorks per il cliente. Per informazioni, vedi Provisioning organizzazioni clienti. Si verifica quanto segue:
Supponi che l'amministratore del cliente non riceva un messaggio e-mail. In tal caso, l'amministratore del cliente può aggiungere manualmente l'amministratore del partner (specificato nel modello) come amministratore esterno dell'organizzazione cliente da Control Hub. Quindi, riprovare a eseguire il provisioning dell'utente per attivare il provisioning del cliente Webex per Cisco BroadWorks. |
2 |
Con l'accesso di amministratore completo , l'amministratore partner può completare il processo di provisioning del cliente. Dovrai tentare di nuovo il Provisioning del cliente a partire dal punto 1 precedente. Tuttavia, ora in qualità di amministratore completo esterno, non è necessario osservare l'errore 2017. Una volta completato il provisioning dei servizi di chiamata, l'organizzazione del cliente esistente sarà visibile come cliente sotto l'organizzazione partner Webex per BroadWorks. Il nome dell'organizzazione allegata non cambierà in nome aziendale BroadWorks. Il nome dell'organizzazione allegata rimarrà uguale a quello precedente al processo di allegazione. |
Condizioni dell'allegato organizzazione
-
L'indirizzo e-mail del primo abbonato BroadWorks predisposto deve corrispondere all'indirizzo e-mail di un utente esistente nell'organizzazione cliente di destinazione. Altrimenti, verrà creata una nuova organizzazione cliente.
-
Il primo utente dell'organizzazione esistente predisposto per Webex per BroadWorks non viene predisposto come utente amministratore. Le impostazioni e i diritti dell'organizzazione esistente vengono conservati.
-
Le impostazioni di autenticazione esistenti dell'organizzazione hanno la precedenza su ciò che è configurato nel modello di provisioning Webex per BroadWorks. Di conseguenza, non sono state apportate modifiche alla modalità di accesso degli utenti esistenti.
-
Tuttavia, se l'organizzazione del cliente esistente ha abilitato il branding base, una volta eseguito l'allegato, le impostazioni di branding avanzato del partner avranno la precedenza. Se il cliente desidera che il branding di base rimanga intatto, il partner deve configurare l'organizzazione del cliente per sostituire il branding nelle impostazioni di branding avanzate.
-
-
Il nome dell'organizzazione esistente non cambierà.
-
Nessuna modifica all'impostazione del flag di eliminazione e-mail nelle impostazioni dell'organizzazione esistente. Ciò potrebbe incidere sugli utenti predisposti di recente. A seconda di come è impostato il flag, i nuovi utenti possono ricevere o meno un messaggio e-mail con un codice che deve essere inserito per completare l'attivazione.
-
La modalità di amministrazione con limitazioni (impostata dal tasto di alternanza Con limitazioni della modalità partner) è disattivata per l'organizzazione collegata.
-
Assicurati di completare il processo di allegato dell'organizzazione (spostamento degli utenti esistenti e aggiornamento dell'ID organizzazione), prima di eseguire il provisioning di nuovi utenti nell'organizzazione Webex per Cisco BroadWorks.
-
È possibile associare un'azienda BroadWorks a una sola organizzazione Webex. Non è possibile eseguire il provisioning degli abbonati di una singola azienda BroadWorks in organizzazioni Webex separate.
Aggiungi amministratore esterno
Per le operazioni che gli amministratori dell'organizzazione cliente possono seguire per aggiungere l'amministratore del partner come amministratore esterno, vedere l'articolo Approva richiesta amministratore esterno su help.webex.com .
L'amministratore del cliente deve fornire all'amministratore esterno i diritti e i privilegi di amministratore completo.
L'indirizzo e-mail che l'amministratore dell'organizzazione cliente aggiunge come amministratore esterno deve corrispondere all'indirizzo e-mail dell'amministratore del partner come configurato nel modello di onboarding su Partner Hub.
Dopo aver aggiunto l'e-mail dal modello di onboarding su Partner Hub come amministratore completo, qualsiasi altro amministratore partner dovrà essere aggiunto come amministratore esterno con diritti di amministratore completo.
Scollegare Webex per BroadWorks dall'organizzazione esistente
Segui questa procedura per deviare Webex per BroadWorks da un'organizzazione Webex esistente. Ad esempio, se è stato collegato Webex per BroadWorks a un'organizzazione esistente per errore e si desidera rimuovere l'allegato.
Nel flusso standard, la disconnessione di Webex per BroadWorks da un'organizzazione Webex esistente (solo flusso standard) eliminerà tutti i dati degli abbonati associati e disattiverà l'abbonamento Webex per BroadWorks del cliente. Inoltre, perderai l'accesso all'organizzazione del cliente se questo è l'unico abbonamento associato. Nel flusso ibrido, gli abbonamenti dei clienti non vengono modificati.
-
Se non disponi dell'accesso alle impostazioni del cliente in Control Hub, chiedi all'amministratore del cliente di concedere l'accesso amministratore esterno seguendo l'opzione Approva richiesta amministratore esterno.
-
Rimuovi tutti gli spazi di lavoro Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi un'area di lavoro BroadWorks .
-
Rimuovi tutti gli abbonati Webex per BroadWorks dall'organizzazione. Utilizzare l'API Rimuovi un abbonato BroadWorks .
-
Rimuovere gli utenti Webex per BroadWorks in sospeso dall'organizzazione. Ad esempio, se è stato eseguito il provisioning degli utenti tramite il flusso e-mail non attendibili e non sono stati ancora inseriti messaggi e-mail validi, gli utenti vengono lasciati in sospeso. Segui Verifica provisioning utente con messaggi e-mail non attendibili per eliminare gli utenti.
-
Elimina la configurazione BroadWorks Calling per questo cliente. Apri l'istanza Control Hub del cliente, fai clic su Ibrido, nella sezione BroadWorks Calling , elimina tutte le configurazioni.
Dopo aver completato il distacco, se si desidera allegare Webex per BroadWorks al cliente, seguire i processi di provisioning per il collegamento a un cliente esistente.
Un'opzione alternativa per rimuovere gli abbonati se non si desidera utilizzare l'API Rimuovi un abbonato BroadWorks consiste nell'accedere a BroadWorks CommPilot e rimuovere il servizio IM&P integrato per gli utenti interessati.
Gestisci utenti e organizzazioni
Per gestire gli utenti in Webex per Cisco BroadWorks, tenere presente che l'utente esiste sia in BroadWorks che in Webex. Gli attributi di chiamata e l'identità BroadWorks dell'utente vengono tenuti in BroadWorks. Un'identità e-mail distinta per l'utente e relative licenze per le funzioni Webex sono tenute in Webex.
Verifica del provisioning utenti con indirizzi e-mail non attendibili
Se si sta predis facendo il provisioning di Webex per utenti BroadWorks utilizzando il provisioning flow-through con messaggi e-mail non attendibili, gli utenti devono autoproducersi inserendo il proprio indirizzo e-mail nel portale di attivazione utenti. Se l'utente rileva un errore, può utilizzare l'opzione Riprova visualizzata nel portale per effettuare un altro tentativo. Se l'utente riconorà l'errore, l'amministratore può utilizzare la procedura seguente in Partner Hub per esaminare lo stato e onboardre l'utente, eliminare l'utente o applicare le modifiche di configurazione.
1 |
Accedi a Partner Hub e trova la pagina Elenco clienti . |
2 |
Fare clic su View Templates (Visualizzamodelli). Seleziona il modello di onboarding appropriato da applicare a questo utente. |
3 |
In Verifica utente, verificare che le seguenti impostazioni siano impostate per garantire che il provisioning flow-through con messaggi e-mail non attendibili sia configurato correttamente:
|
4 |
Dopo il provisioning dell'utente, nella sezione Verifica utente, fare clic su Mostra stato utente per controllare lo stato di provisioning. La vista Stato utente visualizza l'elenco di utenti insieme a dettagli come l'ID BroadWorks, il tipo di pacchetto selezionato e lo Stato corrente, che mostra se l'utente è stato predisposto o se è presente un requisito in sospeso.
|
5 |
Per gli utenti con errori o requisiti in sospeso, fare clic sui tre puntini a destra e scegliere una delle seguenti opzioni amministrative:
|
Opzioni di visualizzazione aggiuntive
Le seguenti opzioni aggiuntive sono disponibili durante la visualizzazione dell'elenco di utenti:
-
Esporta: fai clic su questo pulsante se desideri esportare l'elenco utenti in un file CSV.
-
Escludi utenti di cui è stato eseguito il provisioning: abilitare questo tasto di alternanza se si desidera visualizzare solo gli utenti con requisiti in sospeso o errori.
Modifica ID utente o indirizzo e-mail
Modifiche dell'ID utente e dell'indirizzo e-mail
ID e-mail e ID alternativo sono attributi utente BroadWorks utilizzati con Webex per Cisco BroadWorks. L'ID utente BroadWorks è ancora l'identificativo principale dell'utente in BroadWorks. Nella tabella seguente vengono descritti gli scopi di questi diversi attributi e le operazioni da eseguire per modificarli:
Attributo in BroadWorks | Attributo corrispondente in Webex | Scopo | Note |
ID utente BroadWorks | Nessuno | Identificativo principale | Non è possibile modificare questo identificativo e collegare comunque l'utente allo stesso account in Webex. È possibile eliminare l'utente e crearla nuovamente se è errata. |
ID e-mail | ID utente |
Obbligatorio per il provisioning flow-through (creazione di ID utente Webex) quando si asserzione di attendibilità dell'e-mail Non richiesto in BroadWorks se non si asserzione di affidabilità dei messaggi e-mail Non richiesto in BroadWorks se si consente agli abbonati di attivare automaticamente |
Se l'utente è predisposto con l'indirizzo e-mail errato, è necessario effettuare un processo manuale per modificare questa impostazione in entrambi i punti:
Non modificare l'ID utente BroadWorks. Operazione non supportata. |
ID alternativo | Nessuno | Abilita autorizzazione utente, tramite e-mail e password, a fronte dell'ID utente BroadWorks | Deve essere uguale all'ID e-mail. Se non è possibile inserire il messaggio e-mail nell'attributo ID alternativo, gli utenti devono immettere il relativo ID utente BroadWorks durante l'autenticazione. |
Modifica del pacchetto utente nell'hub partner
1 |
Accedere all'hub partner e fare clic su Clienti. |
2 |
Individuare e selezionare l'organizzazione del cliente in cui si trova l'utente. La pagina di panoramica dell'organizzazione viene visualizzata in un pannello a destra dello schermo. |
3 |
Fare clic su View Customer (Visualizzacliente). L'organizzazione del cliente viene aperta in Control Hub, che mostra la pagina Panoramica.
|
4 |
Fare clic suUtenti, quindi individuare e fare clic sull'utente interessato. |
5 |
In Servizi dell'utente, fare clicsu Webex per pacchetti BroadWorks (Sottoscrizioni). Viene visualizzato il pannello dei pacchetti dell'utente ed è possibile visualizzare il pacchetto attualmente assegnato all'utente. |
6 |
Nella scheda Profilo , ricercare nella sezione Pacchetto e fare clic sulla freccia (>) per espandere la vista. |
7 |
Selezionare il pacchetto che si desidera per questo utente (Base, Standard, Premium o Softphone) e fare clic su Salva. Control Hub mostra un messaggio che l'utente sta aggiornando. |
8 |
È possibile chiudere i dettagli utente e la scheda Control Hub. |
I pacchetti Standard e Premium dispongono di siti per riunioni distinti associati a ciascun pacchetto. Se un abbonato con privilegi di amministratore con uno di questi due pacchetti si sposta nell'altro pacchetto, l'abbonato visualizza due siti per riunioni in Control Hub. Le funzionalità di riunione e il sito della riunione dell'abbonato si allineano al pacchetto corrente. Il sito per riunioni del pacchetto precedente e tutto il contenuto creato in precedenza su tale sito, come le registrazioni, rimangono accessibili ad Amministrazione sito riunione.
Potrebbero essere necessario da due a tre ore per le PMR di aggiornamento che sono risultate da una modifica del pacchetto all'aggiornamento.
Elimina utenti
Esistono diversi metodi che gli amministratori possono utilizzare per eliminare un utente da Webex per Cisco BroadWorks:
Se l'utente che si intende eliminare dispone di privilegi di amministratore, assegnare un nuovo amministratore prima di eliminare l'utente. Non è previsto il trasferimento automatico del ruolo di amministratore nel caso in cui l'ultimo amministratore venga eliminato.
Webex per API Cisco BroadWorks
Gli amministratori dei partner possono utilizzare l'API Webex per Cisco BroadWorks per eliminare gli utenti:
-
Eseguire la richiesta di rimozione dell'API di un abbonato BroadWorks su https://developer.webex.com/docs/api/v1/broadworks-subscribers/remove-a-broadworks-subscriber. Questa richiesta rimuove l'abbonamento a Webex per Cisco BroadWorks. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
Eseguire la richiesta DI ELIMINAZIONE DI una persona su per eliminare completamente https://developer.webex.com/docs/api/v1/people/delete-a-person l'utente.
Flow-through Provisioning
Gli amministratori dei partner possono utilizzare il provisioning flow-through per eliminare gli utenti:
-
Sul server BroadWorks, rimuovere il servizio integrato IM+P dall'utente. È possibile disabilitare il servizio per l'utente dalla pagina Utente – PAGINA IM&P integrata su BroadWorks. Per una procedura dettagliata, vedere "Configurazione di IM&P integrato" nella Guida all'amministrazione dell'interfaccia Web del gruppo di server applicazioni Cisco BroadWorks – Parte2.
Una volta disabilitato il servizio, il provisioning flow-through rimuove l'abbonamento a Webex per Cisco BroadWorks dall'utente. L'utente non viene più fatturato come utente Webex per Cisco BroadWorks e viene considerato come utente Webex gratuito.
-
In Control Hub, individuare e selezionare l'utente.
- Andare ad Azioni e selezionare Elimina utente.
Control Hub (amministratori dei clienti)
Gli amministratori dei clienti possono utilizzare Control Hub per eliminare gli utenti dalla relativa organizzazione. Per informazioni dettagliate, vedere Eliminazione di un utente dalla propria organizzazione in Webex Control Hub su https://help.webex.com/0qse04/.
Elimina organizzazione
1 |
Usa le API Persone per eliminare tutti gli utenti dall'organizzazione: Rimozione di un'API abbonato BroadWorks rimuove i diritti Webex per Cisco BroadWorks da un utente, ma non elimina l'utente. |
2 |
Se la sincronizzazione delle rubriche è attivata, disabilitarla. Questa operazione può essere eseguita tramite Partner Hub o tramite l'API pubblica. Per disabilitare la sincronizzazione delle rubriche tramite Partner Hub: Per disabilitare la sincronizzazione delle directory tramite API, utilizza Aggiorna sincronizzazione rubriche per un'API BroadWorks Enterprise e disabilita l'impostazione enableDirSync . Tutti gli utenti correlati alla sincronizzazione delle rubriche BroadWorks per questa organizzazione verranno eliminati. Tenere presente che la rimozione di utenti (utilizzando uno dei metodi) può richiedere del tempo in base alla quantità di utenti. |
3 |
Una volta rimossi tutti gli utenti, utilizzare l'API Elimina un'organizzazione per eliminare l'organizzazione. |
Annullamento di un abbonamento da Control Hub
Poiché l'API è privata, i clienti non potranno accedervi. Al contrario, la seguente procedura mostra come i clienti possono annullare il proprio abbonamento da Control Hub:
-
L'amministratore del partner può passare alla pagina dei servizi "Ibridi" in Control Hub del cliente.
-
Individuare la scheda "BroadWorks Calling".
-
Una volta eseguito il provisioning di tutti gli utenti da Webex per BroadWorks per tale cliente, il partner visualizza un pulsante per "Cancella configurazione" (ad esempio, elimina la relativa customer_config voce in BPB).
Gestione release
I controlli di gestione delle release in Partner Hub consentono ai provider di servizi Cisco BroadWorks di gestire le release fornendo loro la possibilità di controllare la data di rilascio in base alla quale le app Webex degli utenti ese upgrade all'ultimo software.
Per impostazione predefinita, l'app Webex utilizza aggiornamenti Automatici (release mensili controllate da Cisco). Tuttavia, con questa funzione, gli amministratori dei partner possono:
-
Configura pianificazioni di rilascio personalizzate con differimenti dalla pianificazione di rilascio predefinita di Cisco
-
Configurare una pianificazione a singola release e una propagazione a catena tale pianificazione per tutte le organizzazioni dei clienti che gestiscono
-
Assegna diverse pianificazioni di release a diverse organizzazioni cliente
Per ulteriori informazioni sulla gestione delle release, incluse informazioni su come configurare e applicare pianificazioni di release personalizzate, vedi l'articolo di Webex Personalizzazioni della gestione delle release.
Riconfigurare il sistema
È possibile riconfigurare il sistema come segue:
-
Aggiunta di un cluster BroadWorks in Hub partner
-
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
-
Aggiungi un modello di onboarding in Partner Hub
-
Modifica o eliminazione di un modello di onboarding in Partner Hub
Modifica o eliminazione di un cluster BroadWorks in Partner Hub
È possibile modificare o rimuovere un cluster BroadWorks in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su |
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. |
3 |
Fare clic su View Clusters (Visualizzacluster). |
4 |
Fare clic sul cluster che si desidera modificare o eliminare. I dettagli del cluster vengono visualizzati in un riquadro a destra.
|
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Modifica o eliminazione di un modello di onboarding in Partner Hub
Puoi modificare o eliminare i modelli di onboarding in Partner Hub.
1 |
Accedere all'hub del partner con le credenziali di amministrazione del partner su | |||||||||
2 |
Andare a Impostazioni e individuare la sezione Chiamata BroadWorks. | |||||||||
3 |
Fare clic su View Templates (Visualizzamodelli). | |||||||||
4 |
Fare clic sul modello che si desidera modificare o eliminare. | |||||||||
5 |
Sono disponibili le seguenti opzioni:
L'elenco dei cluster viene aggiornato con le modifiche apportate.
|
Webex Assistant
Assistente Webex webis per Meetings è un assistente per riunioni virtuale intelligente e interattivo che rende ricercabili, utilizzabili e più produttive le riunioni. È possibile chiedere Assistente Webex follow-up su attività, prendere nota di importanti decisioni ed evidenziare momenti chiave durante una riunione o un evento.
Assistente Webex per Meetings è disponibile gratuitamente per i siti di riunione Premium e Standard e per le sale riunioni personali. Il supporto include sia i siti nuovi che quelli esistenti.
Abilita Webex Assistant per le riunioni
Assistente Webex è abilitato per impostazione predefinita per i clienti BroadWorks dei pacchetti standard e premium.
Gli amministratori partner e gli amministratori dell'organizzazione cliente possono disabilitare la funzione per le organizzazioni cliente attraverso Control Hub.
Limiti
Esistono le seguenti limitazioni per Webex per Cisco BroadWorks:
-
Il supporto è limitato a pacchetti Premium e Standard e solo a sale riunioni personali.
-
Le trascrizioni dei sottotitoli codificati sono supportate solo in inglese, spagnolo, francese e tedesco.
-
La condivisione del contenuto tramite e-mail è accessibile solo agli utenti all'interno della tua organizzazione
-
Il contenuto della riunione non è accessibile agli utenti al di fuori della tua organizzazione. Anche il contenuto della riunione non è accessibile quando è condiviso tra utenti di pacchetti diversi all'interno della stessa organizzazione.
-
Con il pacchetto Premium, sono disponibili trascrizioni post-riunione sia che Webex Assistant sia abilitato o disabilitato. Tuttavia, se è selezionata la registrazione locale, le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
-
Con il pacchetto Standard, l'opzione Registra riunione su cloud non è disponibile e pertanto le trascrizioni post-riunione non sono disponibili indipendentemente dal fatto che Webex Assistant sia abilitato o disabilitato. Tuttavia, se viene selezionata la registrazione locale, anche le trascrizioni o gli elementi di rilievo post-riunione non vengono acquisiti.
Ulteriori informazioni su Webex Assistant
Per informazioni sull'uso della funzione, vedere uso di Assistente Webex in Webex Meetings ed Events.
Disabilita Webex Calls
La chiamata Webex gratuita è abilitata per impostazione predefinita, consentendo agli utenti di effettuare chiamate gratuite a qualsiasi dispositivo abilitato Webex. Tuttavia, se si desidera che tutte le chiamate utilizzino l'infrastruttura BroadWorks, è possibile disabilitare le chiamate Webex all'interno di un modello di onboarding, disabilitando tale opzione per le organizzazioni dei clienti che utilizzano il modello.
Supporto funzioni
Se Webex Calling è disabilitato, si applicano le seguenti condizioni a Webex per gli utenti Cisco BroadWorks:
-
Gli utenti non visualizzano più Chiama con Webex come opzione di chiamata selezionabile sull'app Webex.
-
Gli utenti non possono effettuare o ricevere chiamate Webex gratuite a utenti non Webex per utenti Cisco BroadWorks. Ciò include le chiamate avviate da uno spazio del team Webex, Cronologia chiamate, Contatti, inserendo l'URI o l'indirizzo e-mail dell'altro utente nella barra di ricerca.
-
La condivisione dello schermo funziona all'interno di una chiamata BroadWorks.
-
Le riunioni Webex e la presenza di telefonia continuano a funzionare anche se le chiamate Webex sono disabilitate.
Disabilita Webex Calls (nuovo modello di onboarding)
Durante la configurazione di un nuovo modello di onboarding, è possibile configurare se le chiamate Webex sono abilitate o disabilitate selezionando o deselezionando la casella di controllo Disabilita chiamata gratuita Cisco Webex all'interno della procedura guidata Aggiungi nuovo modello . Questa impostazione verrà selezionata per gli utenti nelle organizzazioni dei clienti che assegni al modello.
Per dettagli sulla configurazione di un nuovo modello di onboarding, vedi Configurazione dell'organizzazione partner in Partner Hub.
Disabilita Webex Calls (modello di onboarding esistente)
Segui questa procedura per disabilitare le chiamate Webex da un modello di onboarding esistente. In questo modo, la funzione verrà disabilitata per tutti i nuovi utenti nelle organizzazioni dei clienti che utilizzano questo modello.
-
Accedi a Partner Hub all'indirizzo admin.webex.com.
-
Scegliere Impostazioni.
-
Fare clic su Visualizza modello e scegliere il modello di onboarding appropriato.
-
Fai clic su Disabilita chiamata gratuita Cisco Webex.
-
Fare clic su Salva.
Disabilita Webex Calls (utente esistente)
La disabilitazione di questa funzione in un modello di onboarding modifica l'impostazione solo per i nuovi utenti assegnati al modello. Per disabilitare le chiamate Webex per un utente esistente, puoi seguire una delle procedure seguenti per aggiornare l'utente.
Accertati di aver già completato una delle procedure precedenti per disabilitare le chiamate Webex dal modello di onboarding a cui è assegnato l'utente. In caso contrario, una delle procedure seguenti riconfigurerà l'utente con le chiamate Webex abilitate.
Se si sta utilizzando il provisioning flow-through, è possibile effettuare le seguenti operazioni:
-
Aprire CommPilot e andare alla configurazione utente.
-
Rimuovere il servizio IM+P integrato dall'utente e fare clic su OK.
-
Aggiungere il servizio IM+P integrato all'utente e fare clic su OK.
Altrimenti, è possibile utilizzare l'API per aggiornare l'utente.
-
Utilizzare Rimuovi un'API abbonato BroadWorks per eliminare l'utente.
-
Utilizzare Esegui provisioning di un'API abbonato BroadWorks per aggiungere l'utente.
Disabilitazione del video o della condivisione dello schermo nelle chiamate
Gli amministratori dei partner possono utilizzare i tag di configurazione per disabilitare le videochiamate e/o la condivisione dello schermo all'interno di una chiamata dall'app Webex (per impostazione predefinita, entrambi i tipi di supporto sono abilitati per le chiamate).
Per i dettagli e le opzioni di configurazione completi, vedi Disabilitazione delle videochiamate e Disabilitazione della condivisione dello schermo nella Guida alla configurazione di Webex per Cisco BroadWorks.
Per il video, è inoltre possibile configurare se il contenuto multimediale per le chiamate in ingresso utilizza per impostazione predefinita solo video o audio.
Indicatore di stato della linea/Notifica risposta per assente
La funzione Indicatore di stato/Notifica risposta per assente utilizza le funzioni Indicatore di stato e Risposta per assente indirizzata. Un utente di indicatori di stato riceve una notifica audio e visiva sull'app Webex quando un utente dall'elenco monitorato di indicatori di stato riceve una chiamata in arrivo. L'utente dell'indicatore di stato può ignorare o rispondere alla chiamata dell'utente monitorato.
La notifica di risposta per assente (BLF) è utile in situazioni in cui un utente deve rispondere alle chiamate per altri membri di team che potrebbero lavorare in una posizione diversa.
Gli utenti possono anche visualizzare l'elenco di indicatori di stato monitorati nella sezione Finestra multi-chiamata - Elenco di controllo - (solo Windows, Mac non supportato) per visualizzare la presenza di membri del team Webex e non Webex. Per informazioni sull'abilitazione della chiamata multipla, vedere: Finestra multi-chiamata
I membri Webex avranno una presenza Webex completa. I membri non Webex devono essere sincronizzati con la rubrica in Webex e disporranno solo degli stati "sconosciuti" e "in chiamata" (lo stato di suoneria attiverà la finestra di dialogo di risposta per assente).
Limitazioni di presenza per utenti non Webex:
-
La presenza non è supportata per utenti broadworks non CI, anche se sono nell'elenco di indicatori di stato.
-
Gli utenti CI senza autorizzazione cloud Webex o il tipo di account macchina (spazi di lavoro) mostrano solo la presenza 'in chiamata' e 'sconosciuta'. Nessuno stato attivo, suoneria, eccetera.
-
Gli utenti non Webex presenti nell'elenco di monitoraggio degli indicatori di stato che hanno avviato una chiamata prima dell'avvio del client Webex o mentre era offline verranno visualizzati con una presenza 'sconosciuta'.
-
Se si perde la connessione, tutti gli stati in chiamata non Webex verranno ripristinati su "sconosciuto" al momento della riconnessione.
-
Se un utente non Webex dell'indicatore di stato mette in attesa una chiamata, continuerà a essere visualizzato come "in chiamata".
Requisiti
Accertarsi che le seguenti patch siano applicate a BroadWorks. Installare solo le patch che si applicano alla versione in uso:
Per R22:
-
AP.platform.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382053
-
AP.as.22.0.1123.ap382362
-
AP.xsp.22.0.1123.ap382053
-
AP.xsp.22.0.1123.ap382362
-
AP.as.22.0.1123.ap383459
-
AP.as.22.0.1123.ap383520
Per R23:
-
AP.platform.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382053
-
AP.as.23.0.1075.ap382362
-
AP.as.23.0.1075.ap383459
-
AP.as.23.0.1075.ap383520
-
Se si utilizza XSP|ADP:
-
AP.xsp.23.0.1075.ap382053
-
AP.xsp.23.0.1075.ap382362
-
-
Se stai utilizzando ADP:
-
XSI-Actions-23_2022.01_1.200.bwar
-
Xsi-Events-23_2022.01_1.201.bwar (o versione successiva)
-
Per R24:
-
AP.as.24.0.944.ap382053
-
AP.as.24.0.944.ap382362
-
AP.as.24.0.944.ap383459
-
AP.as.24.0.944. ap383520
-
XSI-Actions-24_2022.01_1.200.bwar
-
Xsi-Events-24_2022.01_1.201.bwar (o versione successiva)
Accertarsi che i seguenti tag di configurazione siano abilitati nell'app Webex:
-
<indicatore di stato abilitato="%ENABLE_BUSY_LAMP_FIELD_WXT%">
-
<display-caller enabled="%ENABLE_BLF_DISPLAY_CALLER_WXT%"/>
-
<notification-delay time=”%BLF_NOTIFICATON_DELAY_TIME_WXT%”/>
(questo tag è opzionale)
È necessario attivare il Meccanismo Xsi Avanzato 101642 Per Telefonia team sul AS:
AS_CLI/System/ActivatableFeature> attivare 101642
Abilitare X-BroadWorks-Remote-Party-Info
sul server AS utilizzando il comando CLI seguente poiché alcuni flussi di chiamate SIP richiedono questa funzione:
AS_CLI/System/DeviceType/SIP> imposta <device_profile_type> supportRemotePartyInfo true
Verifica che i seguenti servizi siano assegnati agli utenti:
-
Assegna il servizio di risposta per assente indirizzata per tutti gli utenti
-
Impostazione dell'indicatore di stato della linea per gli utenti
Qualsiasi riferimento a XSP include XSP o ADP.
Configurazione dell'indicatore di stato della linea su BroadWorks
Per impostare l'indicatore di stato della linea per un utente, gli amministratori dei partner possono utilizzare la procedura seguente.
-
Accedi a BroadWorks CommPilot.
-
Per un utente selezionato, andare ad Applicazioni client e configurare l'indicatore di stato della linea.
-
Aggiungere l'URL dell'elenco di indicatori di stato che verrà monitorato.
-
Utilizzare i parametri di ricerca per individuare e aggiungere gli utenti all'elenco Utenti monitorati .
-
Fare clic su OK.
Slido Supporto integrazione
Webex per Cisco BroadWorks supporta l'integrazione dell'app Webex con Slido.
Slido è uno strumento facile da utilizzare per il coinvolgimento del pubblico. Consente alle persone di ottenere il massimo dalle riunioni colmando la differenza tra gli oratori e i partecipanti. Se Slido questa funzione è integrata nell'organizzazione Control Hub, gli utenti possono aggiungere l'app Slido alle relative riunioni nell'app Webex. Questa integrazione aggiunge funzionalità Q&A di sondaggi e di sondaggi aggiuntivi alla riunione.
Per ulteriori informazioni su come distribuire e utilizzare Slido con l'app Webex, vedi Integrazione Slido con l'app Webex.
Risposta automatica con segnale acustico
Con la risposta automatica con segnale acustico, gli utenti possono effettuare una chiamata da un'app di terze parti, come Contact Center, e la chiamata viene indirizzata automaticamente attraverso l'app Webex sul proprio desktop. Quando l'app Webex squilla sull'interlocutore, l'utente sente un determinato tono per avvisarlo che la chiamata è connessa.
Affinché un utente Webex per Cisco BroadWorks utilizzi questa funzione:
-
La funzione è supportata solo sull'identificativo di linea principale
-
L'app Webex deve essere l'identificativo di linea principale
-
Il %ENABLE_AUTO_ANSWER_WXT% tag deve essere abilitato
Se l'utente ha anche indicatori di chiamata condivisa (ad esempio, un telefono della scrivania è configurato come uno degli indicatori di linea secondari), la funzione è ancora supportata sull'identificativo principale a condizione che gli indicatori di chiamata condivisa non siano configurati per ricevere le chiamate in arrivo. Questa operazione può essere eseguita configurando una delle tre condizioni seguenti su BroadWorks per tutti gli aspetti di chiamata condivisa:
-
L'opzione Avvisa tutte le apparenze per le chiamate Click-to-Dial è disabilitata nella configurazione dell'Aspetto chiamata condivisa: questo è l'approccio consigliato
o
-
L'opzione Consenti terminazione a questa posizione deve essere disabilitata per tutti gli indicatori di chiamata condivisa o
o
-
Posizioni disabilitate per tutti gli indicatori di chiamata condivisa
Aumento della capacità
Aziende XSP|ADP
Si consiglia di utilizzare il pianificatore di capacità per determinare il numero di risorse ADP XSP|aggiuntive necessarie per l'aumento proposto del numero di abbonati. Per uno dei server NPS dedicati o dedicati a Webex per Cisco BroadWorks, sono disponibili le seguenti opzioni di scalabilità:
-
Ridimensiona azienda agricola dedicata: Aggiungere uno o più server ADP XSP| all'azienda agricola che richiede capacità aggiuntiva. Installare e attivare la stessa serie di applicazioni e configurazioni dei nodi esistenti del sistema.
-
Aggiungi azienda agricola dedicata: Aggiungi un nuovo farm ADP XSP|dedicato. Sarà necessario creare un nuovo cluster e nuovi modelli in Partner Hub, in modo da poter iniziare ad aggiungere nuovi clienti sul nuovo registro, per esitare gli utenti a essere presenti nell'hub esistente.
-
Aggiungi azienda agricola specializzata: Se si verificano strozzature per un determinato servizio, si consiglia di creare un'azienda XSP|ADP separata a tale scopo, tenendo in considerazione i requisiti di coresidenza elencati in questo documento. Potrebbe essere necessario riconfigurare i cluster Control Hub e le voci DNS se si modifica l'URL del servizio con un nuovo registro.
In tutti i casi, il monitoraggio e la risorsa dell'ambiente BroadWorks è di responsabilità. Se si desidera coinvolgere l'assistenza Cisco, è possibile contattare il rappresentante dell'account, che può organizzare servizi professionali.
Gestione dei certificati del server HTTP
Devi gestire questi certificati per le applicazioni Web autenticate mTLS sulle tue ADP XSP|:
-
Certificato di catena di fiducia del cloud Webex
-
Certificati delle interfacce server HTTP di|ADP XSP
Catena di fiducia
È possibile scaricare il certificato di catena di attendibilità da Control Hub e installarlo sugli ADP XSP| durante la configurazione iniziale. Si prevede di aggiornare il certificato prima della scadenza e di notificare come e quando modificarlo.
Interfacce server HTTP
L'ADP XSP| deve presentare un certificato del server firmato pubblicamente a Webex, come descritto in Ordina certificati. Quando si protegge per la prima volta l'interfaccia, viene generato un certificato autofirmato. Questo certificato è valido per un anno a partire da tale data. È necessario sostituire il certificato autofirmato con un certificato firmato pubblicamente. È responsabilità dell'utente richiedere un nuovo certificato prima della scadenza.
Con limitazioni della modalità partner
Con limitazioni della modalità partner è un'impostazione Partner Hub che gli amministratori partner possono assegnare a specifiche organizzazioni clienti per limitare le impostazioni dell'organizzazione che gli amministratori clienti possono aggiornare in Control Hub. Quando questa impostazione è abilitata per una determinata organizzazione cliente, tutti gli amministratori dei clienti di tale organizzazione, indipendentemente dai diritti di ruolo, non possono accedere a una serie di controlli limitati in Control Hub. Solo un amministratore partner può aggiornare le impostazioni con limitazioni.
Con limitazioni della modalità partner non è un'impostazione a livello di organizzazione anziché un ruolo. Tuttavia, l'impostazione limita i diritti di ruolo specifici per gli amministratori dei clienti nell'organizzazione a cui viene applicata l'impostazione.
Accesso amministratore cliente
Gli amministratori dei clienti ricevono una notifica quando viene applicata la modalità Con limitazioni del partner. Dopo l'accesso, verrà visualizzato un banner di notifica nella parte superiore dello schermo, immediatamente sotto l'intestazione di Control Hub. Il banner informa l'amministratore del cliente che la modalità con limitazioni è abilitata e che potrebbe non essere in grado di aggiornare alcune impostazioni di chiamata.
Per un amministratore di clienti in un'organizzazione in cui è abilitata l'opzione Con limitazioni della modalità partner, il livello di accesso a Control Hub è determinato con la formula seguente:
(Accesso Control Hub) = (Diritti ruolo organizzazione) - (Limitati dalle limitazioni della modalità partner)
Gli amministratori dei clienti subiranno diverse limitazioni, indipendentemente dalla modalità con limitazioni da parte del partner. Tali limitazioni includono:
- Impostazioni chiamata: Le impostazioni 'Priorità chiamata Opzioni app' nel menu Chiamata sono di sola lettura.
- Impostazione posizione: L'impostazione della chiamata in seguito alla creazione della posizione verrà nascosta.
- Gestione PSTN e registrazione chiamate: Queste opzioni saranno in grigio per la posizione.
- Gestione numeri di telefono: Nel menu Chiamata, la gestione dei numeri di telefono è disabilitata e le impostazioni 'Priorità chiamata opzioni app' nonché le registrazioni delle chiamate sono di sola lettura.
Limitazioni
Quando la modalità con limitazioni del partner è abilitata per un'organizzazione del cliente, gli amministratori dei clienti in tale organizzazione non possono accedere alle seguenti impostazioni di Control Hub:
-
Nella vista Utenti, non sono disponibili le seguenti impostazioni:
-
Il pulsante Gestisci utenti è disattivato.
-
Aggiunta o modifica manuale utenti: nessuna opzione per aggiungere o modificare gli utenti, manualmente o tramite CSV.
-
Richiedi utenti—non disponibile
-
Assegna automaticamente licenze: non disponibili
-
Sincronizzazione rubriche: impossibile modificare le impostazioni di sincronizzazione rubriche (questa impostazione è disponibile solo per gli amministratori a livello di partner).
-
Dettagli utente: le impostazioni utente come nome, cognome, nome visualizzato e indirizzo e-mail principale* sono modificabili.
-
Reimposta pacchetto: nessuna opzione per reimpostare il tipo di pacchetto.
-
Modifica servizi: nessuna opzione per modificare i servizi abilitati per un utente (ad esempio, Messaggi, Riunioni, Chiamata)
-
Visualizzazione dello stato dei servizi: impossibile visualizzare lo stato completo dei servizi ibridi o del canale di aggiornamento software
-
Numero ufficio principale: questo campo è di sola lettura.
-
-
Nella vista Account, non sono disponibili le seguenti impostazioni:
-
Nome società di sola lettura.
-
-
Nella vista Impostazioni organizzazione, non sono disponibili le seguenti impostazioni:
-
Dominio: l'accesso è di sola lettura.
-
E-mail: le impostazioni Elimina invito e-mail amministratore e Selezione locale e-mail sono di sola lettura.
-
Autenticazione: nessuna opzione per modificare le impostazioni di autenticazione e SSO.
-
-
Nel menu Chiamata, non sono disponibili le seguenti impostazioni:
-
Impostazioni chiamata: le impostazioni di Priorità chiamata opzioni app sono di sola lettura.
-
Funzionamento chiamata: le impostazioni sono di sola lettura.
-
Posizione > PSTN: le opzioni gateway locale e Cisco PSTN sono nascoste.
-
-
In SERVIZI, le opzioni di servizio Migrazioni e Connected UC sono eliminate.
Abilita Con limitazioni della modalità partner
Gli amministratori dei partner possono utilizzare la procedura seguente per abilitare l'opzione Con limitazioni della modalità partner per una determinata organizzazione cliente (l'impostazione predefinita è abilitata).
-
Accedi a Partner Hub ( https://admin.webex.com) e seleziona Clienti.
-
Selezionare l'organizzazione del cliente applicabile.
-
Nella vista delle impostazioni a destra, abilitare l'interruttore Limitato dalla modalità partner per attivare l'impostazione.
Se si desidera disattivare Limitazione della modalità partner, disabilitare l'interruttore.
Se il partner rimuove la modalità di amministratore con limitazioni per un amministratore del cliente, l'amministratore del cliente potrà effettuare le seguenti operazioni:
-
Aggiungi utenti Webex per Wholesale (con il pulsante)
-
Modifica pacchetti per un utente
Per ulteriori informazioni sull'elenco dei fusi orari supportati per il provisioning Wholesale, vedere Elenco dei fusi orari supportati per il provisioning Wholesale.
Analisi partner
I miglioramenti apportati a Control Hub rendono semplice agli amministratori dei partner visualizzare e aggiornare le informazioni del pacchetto per conto dei propri utenti. Questa funzione consente ai partner di ottenere una vista aggregata tra tutti i clienti e include i seguenti dettagli:
-
Totale utenti per pacchetto (Softphone, Basic, Standard, Premium)
-
Tendenza utenti per pacchetto (giornaliera/settimanale/mensile)
-
Clienti con n. di pacchetti assegnati
Per dettagli completi sull'uso della funzionalità di analisi dei partner, vedere l'articolo Webex Analytics per Webex per i pacchetti Eseeme e Webex per pacchetti Broadworks in Partner Hub.
API report di fatturazione
Webex per sviluppatori fornisce API pubbliche che possono essere utilizzate per i report di fatturazione mensili. Gli amministratori dei partner possono utilizzare queste API per creare, elencare, ottenere ed eliminare i report di fatturazione. Nella tabella riportata di seguito vengono elencate le API, il tipo di accesso richiesto e i requisiti del ruolo.
API di fatturazione |
Scopo |
Tipo di accesso |
Requisito del ruolo per API (l'amministratore richiede almeno uno di questi ruoli) |
---|---|---|---|
Crea un report di fatturazione BroadWorks |
Utilizzato per generare un report di fatturazione. |
Accesso di scrittura |
|
Elenca report di fatturazione BroadWorks |
Utilizzato per elencare i report disponibili per la visualizzazione. |
Accesso di lettura |
|
Come ottenere un report di fatturazione BroadWorks |
Utilizzato per ottenere una copia di un report generato. |
Accesso di lettura |
|
Eliminazione di un report di fatturazione BroadWorks |
Utilizzato per eliminare un report generato. |
Accesso di scrittura |
|
Campi di fatturazione
Nella tabella seguente vengono elencati i campi contenuti nel report generato.
Campo |
Descrizione |
---|---|
Nome rivenditore |
Nome partner o ID organizzazione partner |
ID fatturazione |
Identificativo di fatturazione univoco partner o numero C |
ID spEnterprise |
Identificativo univoco fornito dal provider di servizi per l'azienda dell'abbonato. |
Interno |
Stato della versione di prova interna del cliente (Sì/No) |
ID utente |
L'ID utente dell'abbonato su BroadWorks |
ID abbonato |
Un identificativo univoco per l'abbonato in questione in Webex |
Autoattivato |
Sì/No |
primaDataInizio |
Data di provisioning dell'abbonato. |
Data di inizio fatturazione |
Data di inizio della fatturazione in questo mese |
Data di fine fatturazione |
Data di fine della fatturazione in questo mese |
pacchetto |
Tipo di pacchetto che viene addebitato |
quantità |
Quantità proporzionale per la fatturazione.
|
-
Una volta generato un report di fatturazione per un determinato periodo di tempo, non è possibile rigenerare tale report a meno che non si elimini prima il report esistente.
-
Se si modifica il tipo di pacchetto o l'ID utente BroadWorks per un determinato utente, il report del mese in cui si è verificata la modifica mostra più voci per tale utente con voci proporzionali separate prima e dopo la modifica.
Risoluzione dei problemi di Webex per Cisco BroadWorks
Iscrizione alla pagina di stato Webex
Innanzitutto, https://status.webex.com verificare se si verifica un'interruzione imprevista del servizio. Se non è stata modificata la configurazione in Control Hub o BroadWorks prima dell'interruzione, controllare la pagina di stato. Per ulteriori informazioni sulla sottoscrizione per lo stato e le notifiche di incidenti, vedere il Centro di assistenza Webex.
Uso della funzionalità di analisi di Control Hub
Webex tiene traccia dei dati di utilizzo e qualità per la propria organizzazione e per le organizzazioni dei clienti. Ulteriori informazioni sulla funzionalità di analisi di Control Hub su Centro assistenza Webex.
Problemi di rete
I clienti o gli utenti non vengono creati in Control Hub con provisioning flow provisioning:
-
Il server dell'applicazione può raggiungere l'URL di provisioning?
-
L'account di provisioning e la password sono corretti, se esistono in BroadWorks?
I cluster non riescono regolarmente con i test di connettività:
La connessione mTLS al servizio di autenticazione dovrebbe non riuscire quando si crea il primo cluster in Partner Hub poiché è necessario creare il cluster per ottenere l'accesso alla catena di certificati Webex. Senza questo, non è possibile creare un trust anchor sugli ADP XSP| del servizio di autenticazione, quindi la connessione mTLS di test da Partner Hub non viene eseguita correttamente.
-
Le interfacce XSP|ADP sono accessibili pubblicamente?
-
Si stanno utilizzando le porte corrette? È possibile inserire una porta nella definizione dell'interfaccia sul cluster.
Convalida interfacce non riuscita
Interfacce Xsi-Actions e Xsi-Events:
- Verificare che gli URL dell'interfaccia siano stati inseriti correttamente sul cluster in Partner Hub, incluso
/v2.0
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Esaminare l'avviso di configurazione dell'interfaccia in questo documento.
Interfaccia servizio di autenticazione:
- Verificare che gli URL dell'interfaccia siano stati inseriti correttamente sul cluster in Partner Hub, incluso
/v2.0
alla fine degli URL. -
Controllare il firewall per consentire la comunicazione tra Webex e queste interfacce.
-
Rivedere i consigli di configurazione dell'interfaccia in questo documento, con particolare attenzione su:
- Accertarsi di aver condiviso le chiavi RSA tra tutte le ADP XSP|.
- Accertarsi di aver fornito l'URL AuthService al container Web su tutti gli ADP XSP|.
- Se è stata modificata la configurazione di crittografia TLS, verificare di aver utilizzato la convenzione di denominazione corretta. L'ADP XSP| richiede l'inserimento del formato del nome IANA per le crittografie TLS. Una versione precedente di questo documento indicava in modo errato le suite di crittografia richieste nella convenzione di denominazione OpenSSL.
-
Se si utilizza mTLS con il servizio di autenticazione, i certificati del client Webex vengono caricati nell'archivio attendibilità XSP|ADP/ADP? L'app (o l'interfaccia) è configurata per richiedere certificati client?
-
Se si utilizza la convalida del token CI con il servizio di autenticazione, l'app (o l'interfaccia) è configurata per non richiedere certificati client?
Problemi del client
Verificare che il client sia connesso a BroadWorks
-
Accedere all'app Webex.
-
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.
-
Aprire il menu Impostazioni/Preferenze e andare alla sezione Servizi telefonici. Viene visualizzato lo stato della SSO è stato eseguito l'accesso.
Se viene visualizzato un altro servizio telefonico, come Webex Calling, l'utente non utilizza Webex per Cisco BroadWorks.
Ciò significa:
-
Il client ha transverso correttamente i microservizi Webex richiesti.
-
L'utente è stato autenticato correttamente.
-
Il client è stato emesso un token Web JSON a lungo termine dal sistema BroadWorks.
-
Il client ha recuperato il profilo del dispositivo ed è registrato per BroadWorks.
Registri client
Tutti i client app Webex possono inviare log a Webex. Questa è l'opzione migliore per client mobili. È necessario registrare anche l'indirizzo e-mail dell'utente e l'ora approssimativa del problema, se si desidera assistenza dal Tac. Per ulteriori informazioni, vedere Dove è possibile trovare supporto per Webex?
Se occorre raccogliere manualmente i registri da un PC Windows, si trovano nel seguente modo:
PC Windows: C:\Users\{username}\AppData\Local\CiscoSpark
Mac: /Users/{username}/Library/Logs/SparkMacDesktop
Problemi di accesso utente
Autenticazione mTLS non configurata correttamente
Se tutti gli utenti sono interessati, controllare la connessione mTLS da Webex all'URL del servizio di autenticazione:
-
Verificare che l'applicazione del servizio di autenticazione o l'interfaccia utilizzata siano configurate per mTLS.
-
Verificare che la catena di certificati Webex sia installata come trust anchor.
-
Verificare che il certificato del server sull'interfaccia/applicazione sia valido e che sia firmato da un'autorità di certificazione attendibile.
Messaggio interruzione licenza
Questo messaggio può essere visualizzato per un cliente nella vista Clienti di Partner Hub. Questo messaggio viene visualizzato quando l'uso della licenza supera quanto consentito dalla licenza. Il messaggio può essere ignorato.
Guida alla risoluzione dei problemi
Per informazioni dettagliate sulla risoluzione dei problemi di Webex per Cisco BroadWorks, fare riferimento alla Guida alla risoluzione dei problemi di Webex per Cisco BroadWorks.
Supporto
Criteri di supporto stato originale
Il provider di servizi è il primo punto di contatto per il supporto clienti finale (enterprise). Inoltrare i problemi che il SP non può risolvere al TAC. Il supporto della versione server BroadWorks segue i criteri della Versione corrente e delle due precedenti versioni principali (N-2). Ulteriori informazioni sono disponibili nella sezione Criteri per il ciclo di vita dei prodotti BroadSoft in Criteri per il ciclo di vita di BroadSoft e Matrice di compatibilità software BroadWorks.
Criteri di escalation
-
L'utente (provider di servizi/partner) è il primo punto di contatto per il supporto dei clienti finali (enterprise).
-
I problemi che non possono essere risolti dal SP vengono inoltrati al TAC.
Versioni BroadWorks
-
Il supporto della versione server BroadWorks segue i criteri di BroadSoft, della versione corrente e delle due versioni principali precedenti (N-2). Ulteriori informazioni sono disponibili nella sezione Criteri per il ciclo di vita dei prodotti BroadSoft in Criteri per il ciclo di vita di BroadSoft e Matrice di compatibilità software BroadWorks.
Risorse di self-support
-
Gli utenti possono trovare supporto attraverso il Centro assistenza Webex, in cui è disponibile una pagina specifica di Webex per Cisco BroadWorks che elenca la Guida per l'app Webex comune e gli argomenti di supporto.
-
È possibile personalizzare l'app Webex con questo URL della Guida e un URL per la segnalazione di problemi.
-
Gli utenti dell'app Webex possono inviare feedback o registri direttamente dal client. I log vengono nel cloud Webex, dove possono essere analizzati da Webex DevOps.
-
È disponibile anche una pagina del Centro assistenza dedicata alla guida a livello di amministratore per Webex per Cisco BroadWorks.
Raccolta delle informazioni per l'invio di una richiesta di assistenza
Quando si visualizzano errori in Control Hub, è possibile che siano state allegati informazioni che consentono al Tac di ricercare la causa del problema. Ad esempio, se viene visualizzato un ID di verifica per un determinato errore o un codice di errore, salvare il testo da condividere con noi.
Provare a includere almeno le seguenti informazioni quando si invia una query o si apre un caso:
-
ID organizzazione cliente e ID organizzazione partner (ciascun ID è una stringa di 32 cifre esadecimali, separate da trattini)
-
TrackingID (anche una stringa a 32 cifre esadecimali) se l'interfaccia o il messaggio di errore ne fornisce una
-
Indirizzo e-mail utente (se si verificano problemi con un determinato utente)
-
Versioni del client (se il problema presenta sintomi notati attraverso il client)
Webex per riferimento a BroadWorks
Confronto DI UC-One SaaS con Webex per Cisco BroadWorks
Soluzione > |
UC-One SaaS |
Webex per Cisco BroadWorks |
---|---|---|
Cloud |
Cisco UC-One Cloud (GCP) |
Cloud Webex (APPLICAZIONI WEBEX) |
Client |
UC-One: Mobile, Desktop Receptionist, Supervisore |
Webex: Mobile, Desktop, Web |
Principale differenza tecnologia |
Riunioni consegnate su Broadsoft Meet Technology |
Riunioni consegnate su Webex Meetings Technology |
Versioni di prova sul campo iniziali |
Ambiente di gestione temporanea, client Beta |
Ambiente di produzione, client GA |
Identità utente |
BroadWorks ID utilizzato come ID principale, a meno che provider di servizi sito non SSO già.
ID utente e segreto in BroadWorks |
ID e-mail in Cisco CI serve come ID principale SSO integrazioni in provider di servizi BroadWorks in cui l'utente eseguirà l'autenticazione con ID utente BroadWorks e segreto BroadWorks in quel momento.
L'utente fornisce le credenziali tramite SSO broadworks e secret in BroadWorks OPPURE ID utente e segreto in IdP CI OPPURE ID utente in CI, ID e autenticazione nel provider di identità |
Autenticazione client |
Gli utenti forniscono le credenziali tramite il client Token a lungo accesso BroadWorks richiesti se si utilizza la messaggistica Webex |
Gli utenti forniscono le credenziali tramite browser (pagina di accesso dal proxy BIdP Webex o CI) Accesso e aggiornamento dei token Webex |
Gestione/configurazione |
I sistemi ANDR E BSS e Portale rivenditore |
SISTEMI CUI/BSS e Control Hub |
Attivazione partner/provider di servizi partner |
Una sola impostazione per Cisco Operations |
Una sola impostazione per Cisco Operations |
Attivazione cliente/aziendale |
Portale rivenditore |
Control Hub Creazione automatica alla prima iscrizione utente |
Opzioni di attivazione utente |
Auto iscrizione Impostazione di IM&P esterno in BroadWorks
|
Impostazione di Integrated IM&P in BroadWorks (solitamente aziende) |
Interfacce servizio XSP|ADP |
Azioni XSI
Eventi XSI CTI (mTLS) AuthService (mTLS opzionale) DMS |
Azioni XSI Azioni XSI (mTLS) Eventi XSI CTI (mTLS) AuthService (TLS) DMS |
Installazione di Webex e accesso (prospettiva abbonato)
1 |
Scaricare e installare Webex. Per dettagli, vedere Webex | Download dell'app. |
2 |
Eseguire Webex. Webex richiede l'indirizzo e-mail.
|
3 |
Inserire il proprio indirizzo e-mail e fare clic su Next(Avanti). |
4 |
In base alla configurazione dell'organizzazione in Webex, si verificano le seguenti operazioni: Webex viene caricato dopo aver eseguito correttamente l'autenticazione per IdP o BroadWorks.
|
Scambio dati e storage
Queste sezioni forniscono dettagli sullo scambio di dati e sullo storage con Webex. Tutti i dati sono crittografati sia in viaggio che a riposo. Per ulteriori dettagli, vedere Sicurezza app Webex.
provider di servizi ilboarding
Quando si configurano cluster e modelli utente in Webex Control Hub durante provider di servizi onboarding, si scambiano i seguenti dati BroadWorks memorizzati da Webex:
-
URL azioni Xsi
-
Xsi-Events URL
-
URL interfaccia CTI
-
URL servizio di autenticazione
-
Credenziali dell'adattatore provisioning BroadWorks
provider di servizi provisioning utente
Questa tabella elenca i dati utente ed aziendale s scambiati come parte del provisioning degli utenti attraverso le API Webex.
Trasferimento dati a Webex |
Da |
Attraverso |
Memorizzato da Webex? |
---|---|---|---|
ID utente BroadWorks |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito da SP) |
BroadWorks, per API |
API Webex |
Sì |
E-mail (se fornito dall'utente) |
Utente |
Portale di attivazione utente |
Sì |
Nome |
BroadWorks, per API |
API Webex |
Sì |
Cognome |
BroadWorks, per API |
API Webex |
Sì |
Numero di telefono principale |
BroadWorks, per API |
API Webex |
Sì |
Numero telefono cellulare |
BroadWorks, per API |
API Webex |
Sì |
Estensione principale |
BroadWorks, per API |
API Webex |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
BroadWorks, per API |
API Webex |
Sì |
Lingua |
BroadWorks, per API |
API Webex |
Sì |
Fuso orario |
BroadWorks, per API |
API Webex |
Sì |
Rimozione utente
Webex per api Cisco BroadWorks supporta la rimozione parziale e completa degli utenti. Questa tabella elenca tutti i dati utente archiviati durante il provisioning e ciò che viene eliminato in ciascuno scenario.
Dati utente |
Eliminazione parziale |
Eliminazione completa |
---|---|---|
ID utente BroadWorks |
Sì |
Sì |
|
No |
Sì |
Nome |
No |
Sì |
Cognome |
No |
Sì |
Numero di telefono principale |
Sì |
Sì |
Numero telefono cellulare |
Sì |
Sì |
Interno |
Sì |
Sì |
ID provider di servizi BroadWorks e ID gruppo |
Sì |
Sì |
LANGUAGE |
No |
Sì |
Recupero accesso utente e configurazione
Autenticazione Webex
L' autenticazione Webex si riferisce all'accesso dell'utente a un'app Webex da parte di uno qualsiasi dei meccanismi di autenticazione di supporto Webex. (L' autenticazione BroadWorks è trattata separatamente.) Questa tabella mostra il tipo di dati scambiati tra i diversi componenti sul flusso di autenticazione.
Spostamento dei dati |
Da |
A |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (indipendente) |
Webex |
Browser utente |
Credenziali utente |
Browser utente |
Provider di identità (che dispone già di identità utente) |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Autenticazione BroadWorks
Per autenticazione BroadWorks si intende l'accesso dell'utente a un'app Webex utilizzando le relative credenziali BroadWorks. Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti del flusso di autenticazione.
Spostamento dei dati |
Da |
A |
---|---|---|
Indirizzo e-mail |
Utente attraverso l'app Webex |
Webex |
Token di accesso limitato e URL IdP (proxy IdP Webex Bwks) |
Webex |
Browser utente |
Informazioni sul branding e URL BroadWorks |
Webex |
Browser utente |
Credenziali utente BroadWorks |
Utente attraverso il browser (pagina di accesso con branded servita da Webex) |
Webex |
Credenziali utente BroadWorks |
Webex |
BroadWorks |
File BroadWorks profilo utente |
BroadWorks |
Webex |
Asserzione SAML |
Browser utente |
Webex |
Codice di autenticazione |
Webex |
Browser utente |
Codice di autenticazione |
Browser utente |
Webex |
Accesso e aggiornamento dei token |
Webex |
Browser utente |
Accesso e aggiornamento dei token |
Browser utente |
App Webex |
Notifica di scadenza password BroadWorks durante l'accesso
Questa funzione migliora il processo di accesso e controlla il flusso di accesso in base a:
Miglioramento del messaggio di avviso ed errore di accesso:
- Attualmente, gli utenti Wexbex per BWKS che utilizzano l'autenticazione BroadWorks e eseguono l'accesso attraverso l'UAP non ricevono la notifica che la password sta per scadere o che non sono in grado di eseguire l'accesso perché la password è già scaduta. Con questa funzione, se la password sta per scadere entro 10 giorni o meno, l'utente riceve un avviso che la password sta per scadere con l'indicazione del numero di giorni rimanenti e viene consigliato di contattare il Partner o di seguire il collegamento Password dimenticata nella schermata di accesso per reimpostare la password.
- Se la password è scaduta e la configurazione 'enforcePasswordChangeOnExpiry' in BroadWorks è impostata su true, l'errore "nome utente e password errati" è stato lanciato, ma ora con questa funzione il messaggio di errore è stato migliorato: Tentativo di accesso non riuscito. La combinazione dell'ID utente e della password fornita non corrisponde ai nostri record o la password deve essere aggiornata. Riprova o contatta l'amministratore per aggiornare la password. Codice di errore 100006
Controlla flusso di accesso:
- Il partner può limitare l'accesso abilitando l'impostazione "w4bwks-password-expiry-fail-login". Questa impostazione "può essere abilitata da Cisco su richiesta di un partner. Se la password BroadWorks è scaduta, la configurazione di BroadWorks 'enforcePasswordChangeOnExpiry' è impostata su false e l'impostazione 'w4bwks-password-expiry-fail-login' è abilitata, viene visualizzato un errore dicendo che la password è scaduta x giorni fa, mentre se il servizio di impostazione è disabilitato, l'accesso è consentito. Per impostazione predefinita, l'impostazione è disabilitata.
Il collegamento Password dimenticata nella pagina di accesso è configurabile dal partner come parte del branding personalizzato: Personalizzazione avanzata. I partner devono configurare il collegamento per reindirizzare gli utenti al portale del partner per la gestione e la reimpostazione delle password.
Questa funzione migliora solo l'esperienza di accesso utente durante l'accesso dell'utente attivato quando la password sta per scadere o è già scaduta. La funzione non viene gestita se la password scade mentre l'utente è connesso all'app Webex. L'utente riceverà una notifica relativa alla scadenza della password al successivo tentativo di accesso.
Recupero configurazione client
Questa tabella illustra il tipo di dati s scambiati tra i diversi componenti nel recupero delle configurazioni del client.
Spostamento dei dati |
Da |
A |
---|---|---|
Iscrizione |
Client |
Webex |
Impostazioni dell'organizzazione, inclusi gli URL BroadWorks |
Webex |
Client |
Token BroadWorks JWORKS |
BroadWorks attraverso Webex |
Client |
Token BroadWorks JWORKS |
Client |
BroadWorks |
Token dispositivo |
BroadWorks |
Client |
Token dispositivo |
Client |
BroadWorks |
File di configurazione |
BroadWorks |
Client |
Utilizzo stato originale
In questa sezione vengono descritti i dati che si spostano tra i componenti durante la nuova autenticazione in seguito alla scadenza del token attraverso BroadWorks o Webex.
Questa tabella elenca il movimento dei dati per la chiamata.
Spostamento dei dati |
Da |
A |
---|---|---|
Segnalazione SIP |
Client |
BroadWorks |
Contenuto multimediale SRTP |
Client |
BroadWorks |
Segnalazione SIP |
BroadWorks |
Client |
Contenuto multimediale SRTP |
BroadWorks |
Client |
Questa tabella elenca il movimento dei dati per messaggistica, presenza e riunioni.
Spostamento dei dati |
Da |
A |
---|---|---|
Messaggistica e presenza HTTPS REST |
Client |
Webex |
Messaggistica e presenza HTTPS REST |
Webex |
Client |
Segnalazione SIP |
Client |
Webex |
Contenuto multimediale SRTP |
Client |
Webex |
Segnalazione SIP |
Webex |
Client |
Contenuto multimediale SRTP |
Webex |
Client |
Uso dell'API di provisioning
Accesso sviluppatore
La specifica API è disponibile su https://developer.webex.com e una guida all'uso è su https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
È necessario eseguire l'accesso per leggere la specifica API su https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Autenticazione e autorizzazione dell'applicazione
L'applicazione si integra con Webex come integrazione. Questo meccanismo consente all'applicazione di eseguire attività amministrative (come il provisioning del sottoscrittore) per un amministratore all'interno dell'organizzazione partner.
Le API Webex seguono lo standard OAuth 2 ( http://oauth.net/2/). OAuth 2 consente alle integrazioni di terze parti di ottenere i token di aggiornamento e di accesso per conto dell'amministratore del partner scelto per l'autenticazione delle chiamate API.
È necessario prima registrare l'integrazione con Webex. Una volta registrata, l'applicazione deve supportare questo flusso di concessione autorizzazione OAuth 2.0 per ottenere i token di aggiornamento e accesso necessari.
Per ulteriori informazioni sulle integrazioni e su come creare questo flusso di autorizzazione OAuth 2 nell'applicazione, vedere https://developer.webex.com/docs/integrations.
Esistono due ruoli richiesti per l'implementazione delle integrazioni, lo sviluppatore e l'utente che ha autorizzato, e possono essere tenute da persone/team separati nel proprio ambiente.
-
Lo sviluppatore crea l'app e la registra su per generare il ClientID/Secret OAuth richiesto con gli ambito previsti per https://developer.webex.com l'applicazione. Se l'applicazione è stata creata da terze parti, potrebbe registrare l'applicazione (se è stato richiesto l'accesso) o è possibile farlo con il proprio accesso.
-
L'utente autorizzato è l'account che l'applicazione utilizza per autorizzare le chiamate API, per modificare l'organizzazione partner, le organizzazioni dei clienti o i relativi abbonati. Questo account deve avere il ruolo di amministratore completo o amministratore completo di vendite nell'organizzazione partner. Questo account non deve essere mantenuto da terze parti.
Nome organizzazione
Il nome dell'organizzazione dipende dalla modalità di provisioning in uso:
-
Modalità Enterprise: il nome organizzazione è una corrispondenza esatta di spEnterpriseId.
-
Modalità provider di servizi: il nome organizzazione è la parte ID gruppo di spEnterpriseId.
Il nome dell'organizzazione contiene spazi vuoti, caratteri maiuscoli e speciali specificati nel spEnterpriseId originale.
Requisiti software BroadWorks
Vedere Gestione ciclo di vita - Server BroadSoft.
Ci aspettiamo che il provider di servizi sia "patch current" con le ultime patch BroadWorks e le app RI (Release Independent). L'elenco di patch seguente è il requisito minimo per l'integrazione con Webex.
Accertarsi di esaminare le note di patch per queste patch software. Alcune patch potrebbero richiedere ulteriori requisiti CLI.
Versione R22
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione | ||
Obbligatorio per sincronizzazione rubriche | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Patch richiesta per il server applicazioni | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Patch richiesta per funzione di registrazione chiamata | ||
Patch richiesta per provisioning flow-through | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Server dei profili | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Piattaforma | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il servizio di autorizzazione con convalida del token CI | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
XSP|ADP |
Richiesto per il proxy di autenticazione NPS | |
Richiesto per il servizio di autorizzazione con convalida del token CI | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il servizio di autorizzazione con convalida del token CI | ||
Obbligatorio per Cronologia chiamate Unified | ||
Altro |
AP.xsa.22.0.1123.ap372757 | |
Versione R23
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione |
Obbligatorio per sincronizzazione rubriche | |
Server app di configurazione | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Obbligatorio per la registrazione della chiamata | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Server dei profili | ||
Piattaforma | ||
Richiesto per il proxy di autenticazione NPS | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
XSP|ADP | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per l'aggiornamento delle notifiche push da V1 a V2 | ||
Richiesto per il proxy di autenticazione NPS | ||
Richiesto per il proxy di autenticazione NPS | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Altro |
Se si utilizza ADP... |
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata |
Versione R24
Server |
Cerotto |
Informazioni aggiuntive |
---|---|---|
Server applicazione |
Obbligatorio per Unified Messaging Server (UMS) | |
Richiesto per provisioning a flusso costante | ||
Obbligatorio per la registrazione della chiamata | ||
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata | ||
Altro |
Patch richiesta per stato hook (presenza) e cronologia chiamate unificata |
Tag BroadWorks richiesti per Webex
Per informazioni sui tag di sistema BroadWorks e sui tag personalizzati che devi configurare per Webex, fai riferimento alla Guida alla configurazione di Webex per Cisco BroadWorks.
Provisioning utenti e flussi di attivazione
Il provisioning descrive l'aggiunta dell'utente a Webex. Attivazione include la convalida e-mail e l'assegnazione del servizio in Webex.
Gli indirizzi e-mail degli utenti devono essere univoci poiché Webex utilizza l'indirizzo e-mail per identificare un utente. Se si dispone di indirizzi e-mail attendibili per gli utenti, è possibile scegliere di attivarli automaticamente quando vengono predisposti automaticamente. Questo processo è di "provisioning automatico e attivazione automatica".
Provisioning utenti automatizzato e attivazione automatica (flusso e-mail attendibile)
Prerequisiti
-
L'adattatore di provisioning punta a Webex per Cisco BroadWorks (che richiede una connessione in uscita da AS al bridge di provisioning Webex).
-
È necessario disporre di indirizzi e-mail dell'utente finale raggiungibili validi come ID alternativi in BroadWorks.
-
Control Hub dispone di un account di provisioning nella configurazione dell'organizzazione partner.
Fase |
Descrizione |
---|---|
1 |
Si preventiva ed si eserviranno gli ordini per il servizio con i clienti. |
2 |
L'ordine del cliente viene processato ed è stato predisposto il cliente nel sistema. |
3 |
Il sistema di provisioning del servizio attiva il provisioning di BroadWorks. Questa operazione, in riepilogo, crea l'azienda e gli utenti. Quindi, assegna i servizi e i numeri necessari a ciascun utente. Uno di questi servizi è l'IM esterno. |
4 |
Questa operazione di provisioning attiva il provisioning automatico dell'organizzazione e degli utenti del cliente in Webex. (L'assegnazione del servizio IM&P causa la chiamata dell'adattatore di provisioning all'API di provisioning Webex). |
5 |
I sistemi devono utilizzare l'API di provisioning Webex se in seguito occorre regolare il pacchetto per l'utente (per effettuare una modifica rispetto al valore predefinito). |
SSO di accesso
Di seguito è riportato il flusso di accesso SSO SAML per l'app Webex quando si utilizza l'autenticazione BroadWorks e quando è abilitata la condivisione delle risorse cross-origin, consentendo l'autenticazione diretta a BroadWorks. L'immagine visualizza gli eventi del client e dell'utente a sinistra con il testo sulle frecce che rappresentano ciò che il client fornisce per l'autorizzazione. I passaggi 1 e 5 sono eventi utente. Il lato destro dell'immagine rappresenta gli eventi dei servizi di accesso insieme a ciò che viene restituito al client.
Di seguito è riportato il flusso di rilevamento servizi BroadWorks che segue immediatamente dal flusso di accesso SSO SAML Webex precedente. Il client utilizza il token di accesso ottenuto durante la registrazione a Webex Device Management per richiedere la registrazione dalla distribuzione BroadWorks.
Flussi di accesso alternativi
Le immagini precedenti presuppongono che l'accesso SSO SAML sia configurato utilizzando l'autenticazione BroadWorks con l'autenticazione diretta BroadWorks abilitata (condivisione risorse multi-origine). Di seguito sono riportati alcuni flussi di SSO SAML alternativi:
-
Autenticazione BroadWorks senza autenticazione BroadWorks diretta (condivisione risorse cross-origin):
-
L'unica differenza è nel punto 5 e 6 del flusso di accesso Webex. Nel punto 5, le credenziali di accesso vengono convalidate dal proxy IdP (anziché da XSI) e un'asserzione SAML viene restituita al client.
-
Il flusso procede attraverso le operazioni restanti nei due diagrammi.
-
Il SSO di registrazione non è utilizzato in questo flusso.
-
-
Autenticazione Webex SSO SAML:
-
Al punto 3 del flusso di accesso Webex, il servizio Common Identity servizi restituisce il provider di identità utilizzato dall'autenticazione Webex.
-
A questo punto, viene richiamato un flusso di SSO SAML alternativo per Webex.
-
Interazioni utente
Accedi
-
L'app Webex avvia un browser in Cisco Common Identity (CI) per consentire agli utenti di inserire il proprio indirizzo e-mail.
-
CI rileva che l'organizzazione cliente associata ha il proxy IDP BroadWorks configurato come IDP SAML. CI reindirizza all'IDP che presenta all'utente una pagina di accesso. Il provider di servizi può personalizzare questa pagina di accesso.
-
L'utente inserisce le proprie credenziali BroadWorks.
-
Broadworks autentica l'utente attraverso l'IDP. In caso positivo, IDP reindirizza il browser a CI con un SISTEMA SAML Success per completare il flusso di autenticazione (non mostrato nel diagramma).
-
In caso di autenticazione eseguita correttamente, l'app Webex ottiene i token di accesso da CI (non mostrato nel diagramma). Il client le utilizza per richiedere un token JNTASSI (Jason Web Token) BroadWorks.
-
L'app Webex rileva la configurazione di chiamata da BroadWorks e da altri servizi di Webex.
-
L'app Webex si registra con BroadWorks.
Accesso dal punto di vista dell'utente
Questo diagramma è il flusso di accesso tipico, visualizzato dall'utente finale o dall'abbonato:
-
L'app Webex viene scaricata e installata.
-
È possibile che sia stato ricevuto il collegamento dal proprio provider di servizi oppure il download potrebbe essere trovato sulla pagina di download di Webex.
-
L'indirizzo e-mail viene inserito nella schermata di accesso di Webex. Fare clic su Avanti.
-
Solitamente, si viene reindirizzati a una provider di servizi a cui viene visualizzata una pagina con marchio.
-
Questa pagina potrebbe dare il benvenuto mediante il proprio indirizzo e-mail.
Se non si dispone di un indirizzo e-mail o se l'indirizzo e-mail è errato, inserire l'indirizzo nome utente BroadWorks.
-
Inserire la password BroadWorks.
-
Se è stato eseguito correttamente l'accesso, Webex si apre.
flusso chiamata: rubrica aziendale
flusso chiamata—PSTN cliente
Presentazione e condivisione
Avvio di una riunione nello spazio
Interazioni client
Recupera profilo da REGISTRAZIONE DMS e SIP con AS
-
Il client chiama XSI per ottenere un token di gestione dispositivi e l'URL sul DMS.
-
Il client richiede il profilo del dispositivo dal DMS presentando il token dal punto 1.
-
Il client legge il profilo del dispositivo e recupera le credenziali SIP, gli indirizzi e le porte.
-
Il client invia un SIP REGISTER al controller SBC utilizzando le informazioni del punto 3.
-
SBC invia il SIP REGISTER ad AS (il controller SBC può eseguire una ricerca in NS per individuare un AS se SBC non conosce già l'utente SIP).
Linee guida di test e laboratorio
Le seguenti linee guida si applicano a organizzazioni di test e laboratorio:
-
provider di servizi partner sono limitati a un massimo di 50 utenti di test che possono essere predisposti su più organizzazioni.
-
La fatturazione verrà addebitata a qualsiasi utente oltre i primi 50 utenti di prova.
-
Per assicurare un'elaborazione precisa della fattura, tutte le organizzazioni di test devono includere 'test' nel nome dell'organizzazione BroadWorks.
-
Le organizzazioni di test interne devono essere designate all'interno Webex Control Hub. Al fine di evitare che gli utenti di prova vengano fatturati come utenti effettivi.
Designazione di un'organizzazione come organizzazione di test
Per designare un'organizzazione come organizzazione di test:
-
Accedere all'hub partner e selezionare Clienti.
-
Selezionare il cliente appropriato.
-
Nella barra di controllo a destra, abilitare l'interruttore Organizzazione test interna.
Riproduzione segreteria telefonica
Per la segreteria telefonica, accertarsi di configurare il server multimediale per l'uso di uno dei seguenti codici:
-
mp3
-
wav— I file WAV sono supportati nei seguenti formati: PCM (supportato su tutte le piattaforme) e DVI-ADPCM (non supportato su Android)
Se si utilizzano file wav, eseguire i seguenti comandi CLI per verificare il server dell'applicazione e server multimediale:
-
AS_CLI/Service/VoiceMsg>imposta vmRecordingAudioFileFormat WAV
-
MS_CLI/Applications/MediaStreaming/Services/IVR> imposta sendmail8kHzWavFileDefaultFormat ulaw
Terminologia
- ACL
- Elenco di controllo accessi
- ALG
- Gateway livello applicazione
- API
- Interfaccia di programmazione applicazione
- APNS
- Utenti Apple servizio di notifica push
- AS
- Server applicazione
- ATA
- Adattatore telefono analogico, adattatore per la conversione della telefonia analogica VoIP
- BAM
- Gestione applicazioni BroadSoft
- Autenticazione di base
- Un metodo di autenticazione in cui un account (nome utente) viene convalidato da un segreto condiviso (password)
- BMS
- Server di messaggistica BroadSoft
- BOSH
- Flussi bidirezionale su HTTP sincrono
- BRI
- L'interfaccia BRI (Basic Rate Interface) è un metodo di accesso ISDN
- Bundle
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. pacchetto)
- CA
- Autorità di certificazione
- Gestore telefonico
- Un'organizzazione che gestisce il traffico di telefonia (cf. partner, provider di servizi, rivenditore aggiunto valore)
- CAPTCHA
- Test del turing pubblico completamente automatizzato per incisire sui computer e sull'humans apart
- CODICE CCXML
- Controllo chiamata EXtensible Markup Language
- CIF
- Formato intermedio comune
- CLI
- Interfaccia della riga di comando
- CN
- Nome comune
- CSP
- Server push notifiche chiamate. Un server push notifiche eseguito su un ADP XSP| nell'ambiente, per eseguire il push delle notifiche di chiamata a FCM e APNS. Vedere Proxy NPS.
- CPE
- Apparecchiatura locale del cliente
- CPR
- Regola di presenza personalizzata
- CSS
- Foglio di stile a cascata
- CSV
- Valore separato da virgole
- CTI
- Integrazione di telefonia su computer
- CUBE
- Cisco Unified Border Element
- DMZ
- Zona demilitarizzata
- DN
- Numero di rubrica
- Non disturbare
- Non disturbare
- DNS
- Sistema di nomi di dominio
- DPG
- Chiama gruppo peer
- DSCP
- Punto codici servizi differenziati
- DTAF
- File di archivio del tipo di dispositivo
- DTG
- Gruppo trunk di destinazione
- DTMF
- Multifrequenza dual-tone
- Utente finale
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. per l'abbonato)
- Aziendale
- Un gruppo di utenti finali (cf. organizzazione)
- FCM
- Messaggistica cloud Firebase
- FMC
- Convergenza mobile fissa
- Provisioning flow-through
- Creazione di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks.
- nome di dominio completo
- Nome di dominio completo
- Provisioning flow-through completo
- Creazione e verifica di utenti nell'archivio di identità Webex mediante l'assegnazione del servizio "IM&P integrato" in BroadWorks e l'asserzione che ciascun utente BroadWorks ha un indirizzo e-mail univoco e valido.
- FXO
- Foreign Exchange Office è la porta che riceve la linea analogica. Il plug-on del telefono o del fax o i plug-in sul sistema telefonico analogico. Fornisce un'indicazione di hook/off-hook (chiusura loop). Poiché la porta BLUETOOTH è collegata a un dispositivo, ad esempio un fax o un telefono, il dispositivo viene spesso denominato "dispositivo BLUETOOTH".
- FXS
- Foreign Exchange Subscriber è la porta che consegna effettivamente la linea analogica al sottoscrittore. In altre parole, è il plug-in alla parete che offre un segnale di chiamata, una corrente a batteria e una suoneria.
- GCM
- Messaggio Google Cloud
- GCM
- Modalità Galois/Counter Mode (tecnologia di crittografia)
- NASCOSTO
- Dispositivo interfaccia utente
- HTTPS
- Protocollo di trasferimento ipertestuale socket sicuri
- IAD
- Dispositivo di accesso integrato
- IM&P
- Messaggistica immediata e presenza
- IP PSTN
- Un provider di servizi che fornisce VoIP servizi PSTN, intercambiabili con ITSP, o un termine generale per la telefonia 'pubblica' collegata da Internet, collettivamente fornito dai principali fornitori di telecomunicazioni (anziché tramite paesi, come PSTN è)
- ITSP
- Servizi di telefonia Internet provider di servizi
- IVR
- Risposta vocale interattiva/Risponditore
- JID
- L'indirizzo nativo di un'entità XMPP è denominato Identificativo Jabber o JID localpart@domain.part.example.com/resourcepart (@ . / sono separatori)
- JSON
- Notifica oggetto Java Script
- JSSE
- Estensione socket sicura Java; la tecnologia sottostante che fornisce funzioni di connettività sicura ai server BroadWorks
- KEM
- Modulo di estensione chiave (telefoni Cisco hardware)
- LLT
- Token lungo(o long life); una forma di auto-descrizione, sicura di token di connessione che consente agli utenti di rimanere autenticati per più tempo e non è legata a applicazioni specifiche.
- MA
- Archiviazione messaggi
- MIB
- Base informazioni di gestione
- MS
- Server multimediale
- Mtls
- Autenticazione reciproca tra due parti, mediante lo scambio di certificati, quando si stabilisce una connessione TLS
- MUC
- Chat multi-utente
- NAZ
- Traduzioni indirizzi di rete
- NPS
- Server push di notifica; vedere CNPS
- NPS Proxy
-
Servizio in Webex che fornisce token di autorizzazione breve al CNPS, abilitando il push delle notifiche di chiamata su FCM e APNs e, infine, sui dispositivi Android e iOS che eseguono Webex.
- OCI
- Apri interfaccia client
- Organizzazione
- Una società o un'organizzazione che rappresenta un gruppo di utenti finali (cf. Enterprise)
- OTG
- Gruppo trunk in uscita
- Pacchetto
- Una raccolta dei servizi disponibili a un utente finale o a un abbonato (cf. Bundle)
- Partner
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. Valore aggiunto rivenditore, provider di servizi, vettore)
- PBX
- Exchange su succursale privato
- PEM
- Messaggio e-mail avanzato sulla privacy
- PLMN
- Rete mobile su rete pubblica
- PRI
- Primary Rate Interface (PRI) è uno standard di interfaccia di telecomunicazioni utilizzato su una rete digitale di servizi integrati (ISDN)
- PS
- Server dei profili
- PSTN
- Rete telefonica commutata pubblica
- QoS
- Qualità del servizio
- Portale rivenditore
- Un sito Web che consente all'amministratore del rivenditore di configurare la propria soluzione UC-One SaaS. Talvolta è noto come portale BANG, portale di amministrazione o portale di gestione.
- RTCP
- Protocollo di controllo in tempo reale
- RTP
- Protocollo di trasporto in tempo reale
- SBC
- Controllo bordo sessione
- SCA
- Identificativo di chiamata condivisa
- SD
- Definizione standard
- SDP
- Protocollo descrizione sessione
- SP
- provider di servizi; Un'organizzazione che fornisce servizi telefonici o correlati ad altre organizzazioni (cf. Gestore telefonico, partner, rivenditore aggiunto valore)
- SIP
- SIP (Session Initiation Protocol)
- SLT
- Token breve (o breve durata) (denominato anche token SSO BroadWorks); un token autenticato a uso singolo utilizzato per ottenere l'accesso protetto alle applicazioni Web.
- SMB
- Piccola e media azienda
- SNMP
- Semplice protocollo di gestione della rete
- sRTCP
- protocollo Secure Realtime Transfer Control Protocol (VoIP multimediale per chiamate in tempo reale)
- sRTP
- protocollo Secure Realtime Transfer Protocol (VoIP multimediale di chiamata)
- SSL
- Livello socket sicuri
- Abbonato
- La persona che utilizza i servizi, che effettua chiamate, partecipa alle riunioni o invia messaggi (cf. Utente finale)
- TCP
- Protocollo di controllo trasmissione
- TDM
- Multiplexing divisione temporale
- TLS
- Sicurezza livello di trasporto
- Tos
- Tipo di servizio
- UAP
- Portale di attivazione utente
- UC
- Unified Communications
- UI
- Interfaccia utente
- UID
- Identificativo univoco
- UMS
- Server di messaggistica
- URI
- Uniform Resource Identifier
- URL
- Localizzatore risorse uniforme
- USS
- Server di condivisione
- UTC
- Coordinated Universal Time
- UV
- Video Server
- Rivenditore aggiunto valore (VAR)
- Un'organizzazione agente che collabora con Cisco per la distribuzione di prodotti e servizi ad altre organizzazioni (cf. vettore, partner, provider di servizi)
- VGA
- Array di elementi grafici video
- VoIP
- Voice over Internet Protocol (IP)
- VXML
- Voice Extensible Markup Language
- Webdav
- Creazione e versione per Web distributed authoring
- WebRTC
- Comunicazioni in tempo reale Web
- WRS
- WebRTC Server
- XMPP
- Protocollo di messaggistica e presenza Estendi
Appendice
Configurazione dei servizi (con mTLS per il servizio di autenticazione)
Le procedure seguenti sostituiscono le procedure nell'argomento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs. Completare queste procedure solo se si utilizza mTLS per il servizio di autenticazione anziché la convalida di token CI. Queste procedure sono obbligatorie se si utilizzano più organizzazioni Webex sullo stesso server ADP XSP|. Altrimenti, sono opzionali.
|Se non si utilizzano più organizzazioni Webex sullo stesso server ADP XSP, si consiglia la convalida del token CI (con TLS) per il servizio di autorizzazione. Riferimento Configurazione dei servizi su Webex per Cisco BroadWorks XSP|ADPs per informazioni dettagliate sulla configurazione del servizio di autenticazione e di altri servizi.
Interfacce Xsi
Installare e configurare le applicazioni Xsi-Actions e Xsi-Events come descritto nella Guida alla configurazione dell'interfaccia dei servizi connettori Cisco BroadWorks.
È necessario distribuire solo un'istanza delle applicazioni Xsi-Events sull'ADP XSP| utilizzato per l'interfaccia CTI.
Tutti gli eventi Xsi utilizzati per l'integrazione di BroadWorks con Webex devono avere lo stesso callControlApplicationName definito in Applications/Xsi-Events/GeneralSettings. Ad esempio:
ADP_CLI/Applications/Xsi-Events/GeneralSettings> ottenere
callControlApplicationName = com.broadsoft.xsi-events
Quando un utente è inserito in Webex, Webex crea un abbonamento per l'utente sul AS per ricevere gli eventi di telefonia per la cronologia della presenza e delle chiamate. L'abbonamento è associato a callControlApplicationName e il AS lo utilizza per sapere a quali Xsi-Events inviare gli eventi di telefonia.
La modifica del callControlApplicationName o il mancato nome di tutte le app Web Xsi-Events avranno impatto sugli abbonamenti e sulla funzionalità degli eventi di telefonia.
Configurazione del servizio di autenticazione (con mTLS)
I token di lunga durata BroadWorks vengono generati e convalidati dal servizio di autenticazione ospitato sulle ADP XSP|.
Requisiti
-
I server ADP XSP| che ospitano il servizio di autenticazione devono disporre di un'interfaccia mTLS configurata.
-
Gli ADP XSP| devono condividere le stesse chiavi per la crittografia/decrittografia dei token BroadWorks di lunga durata. Copiare queste chiavi a ciascun ADP XSP| è un processo manuale.
-
Gli ADP XSP| devono essere sincronizzati con NTP.
Panoramica sulla configurazione
La configurazione essenziale sugli ADP XSP| include:
-
Distribuire il servizio di autenticazione.
-
Configurare la durata del token su almeno 60 giorni (lasciare l'emittente come BroadWorks).
-
Genera e condividi chiavi RSA tra ADP XSP|.
-
Fornire l'URL authService al contenitore Web.
Distribuzione del servizio di autenticazione su XSP|ADP
Su ciascun ADP XSP| utilizzato con Webex:
-
Attivare l'applicazione del servizio di autenticazione sul
percorso /authService
(è necessario utilizzare questo percorso):XSP|ADP_CLI/Maintenance/ManagedObjects> attiva servizio di autenticazione applicazione /authService
(dove
è la versione di BroadWorks).
-
Distribuire l'applicazione:
XSP|ADP_CLI/Maintenance/ManagedObjects>
distribuisci applicazione /authService
Configurazione della durata del token
-
Controllare la configurazione token esistente (ore):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
get
-
Impostare la durata su 60 giorni (il massimo è 180 giorni):
XSP|ADP_CLI/Applications/authenticationService/TokenManagement>
imposta tokenDurationInHours 1440
Genera e condividi chiavi RSA
-
È necessario utilizzare le stesse coppie di chiavi pubbliche/private per la crittografia/decrittografia di token in tutte le istanze del servizio di autenticazione.
-
La coppia di chiavi viene generata dal servizio di autenticazione quando viene richiesto per la prima volta di emettere un token.
A causa di questi due fattori, è necessario generare chiavi su un ADP XSP|e copiarle in tutti gli altri ADP XSP|.
Se si alterano i tasti o si modifica la lunghezza della chiave, è necessario ripetere la configurazione seguente e riavviare tutte le ADP XSP|.
-
Selezionare un ADP XSP| da utilizzare per la generazione di una coppia di chiavi.
-
Utilizzare un client per richiedere un token crittografato all'ADP XSP|, richiedendo il seguente URL dal browser del client:
|https:///authService/token?key=BASE64URL(clientPublicKey)
(viene generata una coppia di chiavi privata/pubblica su ADP XSP|, se non ne era già presente una)
-
La posizione dell'archivio chiavi non è configurabile. Esportare le chiavi:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement>
exportKeys
-
Copiare il file esportato
/var/broadworks/tmp/authService.keys
nella stessa posizione sugli altri ADP XSP|, sovrascrivendo un file.keys
precedente, se necessario. -
Importa le chiavi su ciascuno degli altri ADP XSP|:
XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys
Fornire l'URL authService al container Web
Il container Web di ADP XSP| richiede l'URL authService in modo da poter convalidare i token.
Su ciascuno degli ADP XSP|:
-
Aggiungere l'URL del servizio di autenticazione come servizio di autenticazione esterno per lo strumento di comunicazione BroadWorks:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService>
imposta URL http://127.0.0.1:80/authService
-
Aggiungere l'URL del servizio di autenticazione al container:
XSP|ADP_CLI/Maintenance/ContainerOptions> aggiungi tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService
Ciò consente a Webex di utilizzare il servizio di autenticazione per convalidare i token presentati come credenziali.
-
Controllare il parametro con
get
. -
Riavviare ADP XSP|.
Configurazione di TLS e della crittografia sulle interfacce HTTP (per XSI e servizio di autenticazione)
Le applicazioni Servizio di autenticazione, Xsi-Actions e Xsi-Events utilizzano interfacce server HTTP. I livelli di configurazione TLS per queste applicazioni sono i seguenti:
Più generale = Sistema > trasporto > http > interfaccia Server HTTP = Più specifico
I contesti CLI utilizzati per visualizzare o modificare diverse impostazioni SSL sono:
Specificità | Contesto CLI |
Sistema (globale) |
|
Protocolli di trasporto per questo sistema |
|
HTTP su questo sistema |
|
Interfacce server HTTP specifiche su questo sistema |
|
Lettura della configurazione dell'interfaccia TLS del server HTTP su XSP|ADP
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
-
Inserire il
comando get e leggere i
risultati. Dovrebbero essere presenti le interfacce (indirizzi IP) e, per ciascuna, se sono sicure e se richiedono l'autenticazione del client.
Tomcat obbligatorio un certificato per ciascuna interfaccia protetta; il sistema genera un certificato autofirmato, se necessario.
XSP|ADP_CLI/Interface/Http/HttpServer> ottenere
Aggiunta del protocollo TLS 1.2 all'interfaccia del server HTTP
È necessario configurare l'interfaccia HTTP che interagisce con Webex Cloud per TLSv1.2. Il cloud non negozia le versioni precedenti del protocollo TLS.
Per configurare il protocollo TLSv1.2 sull'interfaccia del server HTTP:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>
-
Inserire il comando
get 443
per visualizzare i protocolli già utilizzati su questa interfaccia. -
Inserisci il comando
aggiungi 443 TLSv1.2
per assicurarti che l'interfaccia possa utilizzare TLS 1.2 durante la comunicazione con il cloud.
Modifica della configurazione dei tipi di crittografia TLS sull'interfaccia del server HTTP
Per configurare i crittografia richiesti:
-
Accedere a XSP|ADP e passare a
XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>
-
Inserire il comando
get 443
per visualizzare le crittografie già utilizzate su questa interfaccia. Deve essere presente almeno una delle suite consigliate da Cisco (vedere XSP|ADP Identity and Security Requirements (Requisiti di sicurezza e identità XSP) nella sezione Overview). -
Inserire il comando
add 443
per aggiungere una crittografia all'interfaccia del server HTTP.IL CLI XSP|ADP richiede il nome della suite di crittografia standard IANA, non il nome della suite di crittografia openSSL. Ad esempio, per aggiungere la crittografia openSSL
ECDHE-ECDSA-CHACHA20-POLY1305 all'interfaccia
del server HTTP, utilizzare:XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>aggiungi 192.0.2.7 443 TLS_ECDHE_ECDSA_CON_CHACHA20_POLY1305
Vedere https://ciphersuite.info/ per individuare la suite in base a uno dei due nomi.
Configurazione dell'attendibilità del servizio di autenticazione (con mTLS)
-
Accedere a Control Hub con l'account dell'amministratore del partner.
-
Vai a Scarica certificato CA Webex per ottenere
e fai clic suCombinedCertChain .txt
sul computer locale.Questi file contengono due set di due certificati. È necessario suddividere i file prima di caricarli negli ADP XSP|. Tutti i file sono obbligatori. -
Suddividere la catena di certificati in due certificati:
combinedcertchain .txt
.-
Aprire
combinedcertchain .txt
in un editor di testo. -
Selezionare e tagliare il primo blocco di testo, incluse le righe
-----BEGIN CERTIFICATE-----
e -----END CERTIFICATE----- , e incollare il blocco di testo in un nuovo
file. -
Salvare il nuovo file come
root .txt
. -
Salvare il file originale come
emissione di .txt
. Il file originale ora deve contenere solo un blocco di testo, racchiuso tra lerighe -----BEGIN CERTIFICATE-----
e-----END CERTIFICATE-----
.
-
-
Copiare entrambi i file di testo in una posizione temporanea sull'ADP XSP| che si sta proteggendo, ad esempio,
/var/broadworks/tmp/root .txt
e/var/broadworks/tmp/issuing .txt
. -
Accedere a XSP|ADP e passare a
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
. (Opzionale) Eseguire la guidaUpdateTrust
per visualizzare i parametri e il formato del comando. -
Carica i file dei certificati sui nuovi trust anchor - 2023
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot /var/broadworks/tmp/root .txt XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing /var/broadworks/tmp/issuing .txt
Tutti gli alias devono avere un nome diverso.
webexclientroot
,webexclientroot
,webexclientissuing
ewebexclientissuing
sono alias di esempio per i trust anchor; puoi utilizzare i tuoi alias purché tutte e quattro le voci siano univoche. -
Confermare che gli ancoraggi siano aggiornati:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts> ottenere
Alias Proprietario emittente ============================================================================= webexclientissuing Internal Private TLS SubCA Internal Private Root webexclientroot Internal Private Root[self-signed]
(Opzione) Configurare mTLS a livello di interfaccia/porta HTTP
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate sull'ADP XSP|. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di interfaccia/porta HTTP, mTLS è richiesto per tutte le applicazioni Web ospitate a cui si accede tramite questa interfaccia/porta.
-
Accedere all'ADP XSP| di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/HttpServer>
ed eseguire il comandoget
per visualizzare le interfacce. -
Per aggiungere un'interfaccia e richiedere l'autenticazione del client (che corrisponde a mTLS):
XSP|ADP_CLI/Interface/Http/HttpServer> aggiungi nome porta IPAddress true true
Per informazioni dettagliate, vedere la documentazione CLI XSP ADP|CLI. Essenzialmente, la prima true protegge l'interfaccia con TLS (il certificato server viene creato se richiesto) e la seconda forza true l'interfaccia a richiedere l'autenticazione del certificato
client
(insieme sono mTLS).
Ad esempio:
XSP|ADP_CLI/Interface/Http/HttpServer> ottenere
Nome porta interfaccia Secure Client Auth Req Cluster Fqdn ======================================================= 192.0.2.7 443 XSP|ADP01.collab.example.net true false 192.0.2.7 444 XSP|ADP01.collab.example.net true true
In questo esempio, mTLS (Client Auth Req = true) è abilitato sulla porta 192.0.2.7
444.
TLS è abilitato sulla porta 192.0.2.7
443.
(Opzione) Configurare mTLS per applicazioni Web specifiche
È possibile configurare mTLS a livello di interfaccia/porta HTTP o su base per applicazione Web.
Il modo in cui si abilita mTLS per l'applicazione dipende dalle applicazioni ospitate sull'ADP XSP|. Se si stanno ospitando più applicazioni che richiedono mTLS, è necessario abilitare mTLS sull'interfaccia. Se è necessario proteggere una sola delle diverse applicazioni che utilizzano la stessa interfaccia HTTP, è possibile configurare mTLS a livello di applicazione.
Quando si configura mTLS a livello di applicazione, mTLS è richiesto per tale applicazione indipendentemente dalla configurazione dell'interfaccia del server HTTP.
-
Accedere all'ADP XSP| di cui si sta configurando l'interfaccia.
-
Passare a
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps>
ed eseguire il comandoget
per visualizzare le applicazioni in esecuzione. -
Per aggiungere un'applicazione e richiedere l'autenticazione del client (che significa lo stesso di mTLS):
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiungi nome applicazione porta IPAddress true
Per informazioni dettagliate, vedere la documentazione CLI XSP ADP|CLI. I nomi delle applicazioni sono elencati in questo elenco. Vero
in questo comando abilita mTLS.
Ad esempio:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> aggiunge 192.0.2.7 443 AuthenticationService true
Il comando di esempio aggiunge l'applicazione AuthenticationService alla versione 192.0.2.7:443 e richiede che a tale applicazione sia richiesta e autenticata dal client.
Controlla con ottieni
:
XSP|ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> ottieni
Interfaccia Porta IP Nome applicazione Client Autenticazione ======================================================
192.0.2.7 443 AuthenticationService true
Configura gestione dispositivi su XSP|ADP, server applicazioni e server di profilo
Il server di profilo e l'ADP XSP| sono obbligatori per la gestione dei dispositivi. Tali impostazioni devono essere configurate in base alle istruzioni nella Guida alla configurazione di Gestione dispositivi BroadWorks.
Dove andare avanti
Per la configurazione, è possibile accedere nuovamente al flusso del documento principale all'indirizzo Interfaccia CTI e configurazione correlata.
Requisiti di certificato aggiuntivi per l'autenticazione TLS reciproca con AuthService
Webex interagisce con il servizio di autenticazione su (autenticazione) TLS reciproca connessione autenticata. Ciò significa che Webex presenta un certificato client e l'ADP XSP|deve convalidarlo. Per certificare l'attendibilità di questo certificato, utilizzare la catena di certificati CA Webex per creare un'ancora di attendibilità su ADP XSP| (o proxy). La catena di certificati è disponibile per il download tramite Partner Hub:
-
Andare a Impostazioni > Chiamata BroadWorks.
-
Fare clic sul collegamento per il download del certificato.
È possibile ottenere la catena di certificati anche da https://bwks-uap.webex.com/assets/public/CombinedCertChain2023.txt.
I requisiti esatti per la distribuzione di questa catena di certificati CA Webex dipendono dalla distribuzione degli ADP XSP| pubblici:
-
Tramite un proxy di bridging TLS
-
Tramite un proxy pass-through TLS
-
Direttamente all'ADP XSP|
Il diagramma seguente riepiloga i punti in cui la catena di certificati CA Webex deve essere distribuita in questi tre casi.
Requisiti del certificato TLS reciproca per il proxy con bridge TLS
-
Webex presenta un certificato client firmato dall'autorità di certificazione Webex nel proxy.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità del proxy, pertanto il proxy considera attendibile il certificato client.
-
Anche il certificato del server ADP XSP|firmato pubblicamente viene caricato nel proxy.
-
Il proxy presenta un certificato server firmato pubblicamente con Webex.
-
Webex considera attendibile la CA pubblica che ha firmato il certificato del server del proxy.
-
Il proxy presenta un certificato client firmato internamente agli ADP XSP|.
Questo certificato deve avere l'estensione del campo dell'estensione x509.v3 Utilizzo chiave estesa compilato con BroadWorks OID 1.3.6.1.4.1.6431.1.1.8.2.1.3 e lo scopo dell'autorizzazione del client TLS. Ad esempio.:
Estensioni X509v3:
Uso chiave estesa X509v3:
1.3.6.1.4.1.6431.1.1.8.2.1.3, Autenticazione client Web TLS
Quando si generano certificati del client interno per il proxy, tenere presente che i certificati SAN non sono supportati. I certificati del server interno per XSP|ADP possono essere SAN.
-
Gli ADP XSP| si affidano alla CA interna.
-
Gli ADP XSP| presentano un certificato server firmato internamente.
-
Il proxy considera attendibile la CA interna.
Requisiti del certificato TLS reciproca per proxy tls passizzato o XSP in DMZ
-
Webex presenta un certificato client firmato ca Webex agli XSP.
-
La catena di certificati CA Webex viene distribuita sull'archivio di attendibilità degli XSP, pertanto gli XSP considerano attendibile il certificato client.
-
Anche il certificato del server XSP firmato pubblicamente viene caricato negli XSP.
-
Gli XSP presentano certificati server firmati pubblicamente a Webex.
-
Webex considera attendibile la CA pubblica che ha firmato i certificati del server XSP.
Cronologia revisioni documenti
La tabella seguente mostra una cronologia delle modifiche di questo documento negli ultimi 12 mesi.
Data |
Versione | Descrizione della modifica | |
---|---|---|---|
13 gennaio 2025 |
3-1 |
| |
3 dicembre 2024 |
2-124 |
| |
4 ottobre 2024 |
2-123 |
| |
10 settembre 2024 |
2-123 |
| |
9 agosto 2024 |
2-122 |
| |
1 agosto 2024 |
2-121 |
| |
25 giugno 2024 |
2-120 |
| |
14 giugno 2024 |
2-119 |
| |
13 maggio 2024 |
2-118 |
| |
10 maggio 2024 |
2-117 |
| |
6 maggio 2024 |
2-116 |
| |
2 maggio 2024 |
2-115 |
| |
10 aprile 2024 |
2-114 |
| |
27 marzo 2024 |
2-113 |
| |
22 marzo 2024 |
2-112 |
| |
7 marzo 2024 |
2-111 |
| |
24 febbraio 2024 |
2-110 |
| |
20 febbraio 2024 |
2-109 |
| |
07 febbraio 2024 |
2-108 |
| |
25 gennaio 2024 |
2-107 |
| |
23 gennaio 2024 |
2-106 |
| |
10 gennaio 2024 |
2-105 |
| |