Supporto per il servizio di directory UC connesso al cloud Webex

È possibile sincronizzare e gestire gli utenti da Active Directory cloud (ad esempio, Azure AD) in un'infrastruttura UC locale o ospitata su cloud, come Cisco Unified Communications Manager (Unified Communications Manager) e Cisco Unity Connection (Unity Connection) con il servizio directory Webex Cloud-Connected UC. Durante la sincronizzazione, il sistema importa un elenco di utenti e dati utente associati da Azure Active Directory (o un servizio di directory cloud simile) sincronizzato nel servizio di Common Identity Webex. È necessario selezionare il cluster Unified CM da Control Hub che richiede la sincronizzazione, selezionare l'associazione del campo ID utente Unified CM appropriata, quindi selezionare il contratto di sincronizzazione richiesto per eseguire la sincronizzazione.

Attiva servizio di directory

Devi attivare il Servizio directory per ciascun cluster in Webex Cloud-Connected UC per consentire la sincronizzazione e la gestione degli utenti dal cloud in Unified Communications Manager.

Per impostazione predefinita, il servizio di directory non è abilitato per tutti i clusterboarded.
1

Dalla vista del cliente in Control Hub, andare a Servizi > Connected UC. Nella scheda UC Management, fare clic su Inventario.

Viene visualizzato l'elenco di gruppi di cluster con la descrizione, lo stato, i cluster e i nodi.

2

Fai clic su Dettagli accanto al gruppo di cluster a cui appartiene il nodo.

Viene visualizzata la pagina Inventario, che mostra l'elenco di cluster appartenenti al gruppo di cluster selezionato.

3

Fai clic su Dettagli accanto al cluster a cui appartiene il nodo di prodotto specifico.

Viene visualizzato il nome del nodo con la versione, il prodotto e lo stato.

4

Fai clic sull'icona dei puntini di sospensione ⋮ accanto a Cronologia eventi e scegli Gestione servizi.

Viene visualizzata la pagina Gestione servizi con l'elenco dei servizi.

5

Utilizzare il pulsante di attivazione/disattivazione per abilitare il servizio di directory.

6

Fare clic su Invia.

Servizio di directory

Servizio di directory

Utilizzare la scheda Servizio rubrica per sincronizzare gli utenti dalle rubriche basate su cloud in Unified Communications Manager.

1

Dalla vista del cliente in Control Hub, andare a Servizi > Connected UC.

2

Nella scheda Servizio di directory, fare clic su Visualizza cluster. Viene visualizzata la pagina Servizio di directory.

È possibile visualizzare l'elenco dei dettagli del cluster in questa pagina.

Visualizza dettagli cluster

Visualizza dettagli cluster

Dalla pagina di selezione del cluster nel servizio di directory, scegliere un cluster con cui sincronizzare i dati utente.

La pagina Selezione cluster fornisce anche i dettagli del cluster, lo stato di provisioning, l'ultimo stato sincronizzato, il prodotto associato e, se presente, il motivo del problema. È possibile selezionare il fuso orario locale; per impostazione predefinita, è selezionato il fuso orario del browser.

Dettagli cluster

Descrizione

Nome cluster

Nome del cluster.

Stato

Stato della sincronizzazione.

Ultima sincronizzazione

Data dell'ultima sincronizzazione.

Prodotto

Dettagli del prodotto.
Provisioning della sincronizzazione del servizio rubrica

La sincronizzazione del Servizio di directory Webex Cloud-Connected UC consente di importare i dati degli utenti finali da Webex Common Identity Service nel database Unified Communications Manager da visualizzare nella finestra Configurazione utente finale.

Assicurarsi di non eseguire operazioni di provisioning durante l'aggiornamento pianificato del modulo Webex Cloud-Connected UC.

Se si esegue il provisioning durante l'aggiornamento del modulo, i passaggi 1, 2 o 3 potrebbero mostrare stati di errore dopo un determinato periodo di tempo e il pulsante Riprova viene visualizzato dopo qualche tempo. È possibile avviare nuovamente il provisioning selezionando il pulsante Riprova . Assicurati di verificare lo stato del cluster per il completamento dell'aggiornamento prima di ritentare il provisioning.

1

Dalla pagina di selezione del cluster nel servizio di directory, scegliere un cluster di cui si desidera eseguire il provisioning per l'abilitazione della sincronizzazione.

2

Fare clic su Avvia provisioning.

3

Nella finestra di configurazione Mappatura campi, assicurarsi che l'associazione scelta per il campo ID utente Unified CM identifichi in modo univoco l'utente all'interno del cluster dopo l'avvio del provisioning.

4

Scegli la mappatura del campo ID utente Unified CM appropriata per la sincronizzazione dell'utente da Webex.

  • Campo ID utente in Unified CM mappato all'ID e-mail dell'utente in Webex.

  • Campo ID posta in Unified CM mappato all'ID e-mail dell'utente in Webex.

  • Campo ID utente in Unified CM mappato all'ID e-mail senza la parte dominio dell'utente in Webex.

    Verrà creato un nuovo account utente se non può essere eseguita correttamente la mappatura per un account utente esistente in Unified CM. L'ID e-mail (o la parte ID dell'ID e-mail) dell'utente verrà utilizzato come identificativo univoco per il nuovo account utente creato.
5

Fare clic su Avanti.

6

Seleziona un contratto dall'elenco a discesa per creare un nuovo contratto di sincronizzazione.

Una volta creato il nuovo contratto di sincronizzazione, tutti i contratti di sincronizzazione esistenti che puntano alla rubrica in sede vengono eliminati. Puoi apportare modifiche al nuovo contratto di sincronizzazione dopo che è stato creato.

7

Nella sezione Anteprima contratto, esaminare i dettagli del contratto (dettagli della rubrica LDAP esterna esistenti disponibili in Unified Communications Manager) prima di avviare la sincronizzazione.

Puoi visualizzare i seguenti dettagli:

  • Informazioni gruppo

  • Modello di gruppo di funzioni applicato con modelli di linee e dispositivi universali

  • Dettagli di linee e mask ai numeri di telefono sincronizzati per gli utenti inseriti

  • Utenti predisposti di recente e relativi interni

  • Sezione Campi utente standard da sincronizzare

  • Nome host o indirizzo IP del server di directory

Fare clic su Avant i per selezionare il filtro del gruppo.

8

Dall'elenco a discesa Seleziona gruppi, seleziona uno o più gruppi specifici da sincronizzare. Fai clic sulla casella di controllo Seleziona tutti i gruppi se desideri selezionare tutti i gruppi di utenti.

Per impostazione predefinita, vengono sincronizzati tutti gli utenti. Se non selezioni alcun gruppo, tutti gli utenti e i dati degli utenti associati verranno sincronizzati automaticamente.

Per i gruppi nidificati in una rubrica, gli utenti devono selezionare specificatamente il gruppo di utenti sottostante durante il provisioning perché non sono inclusi per impostazione predefinita nel gruppo principale. Devi verificare eventuali nidificazioni ripetitive per assicurarti che solo gli utenti richiesti siano inclusi durante il provisioning.

Eventuali modifiche apportate al contratto di sincronizzazione, ad esempio, la rimozione di un utente o un gruppo di destinazione non verranno propagate durante la sincronizzazione periodica. Devi disabilitare il Servizio directory per tale cluster da Control Hub, quindi eseguire nuovamente il provisioning del cluster con il contratto di sincronizzazione nuovo o modificato.

9

Fai clic su Avanti per preparare il processo di sincronizzazione.

10

Nella finestra Abilita sincronizzazione, abilita la sincronizzazione una volta che il sistema copia correttamente i dati utente in uno spazio di storage temporaneo in Unified CM e viene creato un nuovo contratto di sincronizzazione (dopo le operazioni ai punti 1 e 2 come illustrato nella schermata seguente).

11

L'opzione di download del report consente di visualizzare parzialmente i risultati. Per recuperare i report completi per il cluster Unified CM, eseguire il seguente comando CLI: file get activelog /cm/trace/CIService/log4j/DryRunResults.csv. In questo caso, il risultato dell'esecuzione di test di Unified CM mostra quanto segue:

  • Nuovi utenti: utenti presenti in Servizio di identità Webex e non presenti nel Database Unified CM

  • Utenti corrispondenti: utenti presenti in Servizio di identità Webex e nel database Unified CM

  • Utenti non corrispondenti: utenti presenti nel database Unified CM ma non presenti su Webex Identity Service

È possibile controllare il report e decidere se si desidera conservare lo stesso elenco di utenti ed aggiungere o eliminare gli utenti. In base alla decisione, è possibile interrompere il processo e annullare le modifiche di provisioning.
Qualsiasi aggiornamento effettuato ai dati utente nella rubrica cloud in seguito alla sincronizzazione delle rubriche verrà aggiornato nel prossimo periodo di sincronizzazione. Questo perché la rubrica cloud viene sincronizzata periodicamente una volta al giorno.
12

Dopo la verifica del contratto di sincronizzazione, fare clic su Anteprima in Unified CM per accedere all'infrastruttura locale e apportare le modifiche al contratto di sincronizzazione appena creato.

È richiesto l'accesso VPN.

È possibile modificare solo le informazioni del gruppo per Unified CM. Non è possibile rinominare il contratto o modificare alcun dettaglio.

13

Seleziona la casella di controllo per confermare che il contratto di sincronizzazione è stato esaminato e verificato in Unified CM.

14

Fai clic su Abilita sincronizzazione per continuare con la sincronizzazione.

Durante la sincronizzazione, non potrai eseguire alcuna azione fino al completamento. Una volta completata la sincronizzazione per un determinato cluster, la pagina del Servizio rubrica elenca questo cluster con lo stato predisposto. A questo punto, hai autorizzato correttamente Azure AD per il provisioning e la sincronizzazione degli utenti Webex nell'infrastruttura UC e sono state completate le operazioni per l'impostazione della sincronizzazione.

15

Una volta completato il provisioning iniziale, la sincronizzazione periodica viene eseguita ogni 24 ore. Qualsiasi modifica effettuata nella directory cloud verrà propagata ai cluster durante questo periodo.

Devi abilitare la sincronizzazione entro 20 ore dal momento in cui viene creato il nuovo contratto. Gli utenti sincronizzati LDAP diventano inattivi e vengono rimossi dopo 24 ore di inattività. Gli utenti non potranno accedere e utilizzare i servizi Unified CM.

Una volta completato il provisioning Azure AD per un determinato cluster, non è possibile creare nuovi contratti di sincronizzazione o modificare le impostazioni di configurazione per lo stesso cluster tranne per le impostazioni del gruppo. Se si desidera creare un nuovo contratto di sincronizzazione per lo stesso cluster, andare alla pagina Gestione servizio e disabilitare il servizio di directory. È quindi possibile creare un nuovo contratto per il provisioning.

Se la sincronizzazione non riesce per qualsiasi motivo, le ultime modifiche di provisioning verranno applicate il giorno successivo al periodo di sincronizzazione.

  • Se stai utilizzando Azure IdP durante l'autenticazione SSO dopo un provisioning eseguito correttamente, assicurati di configurare le richieste corrette in Azure IdP. Ad esempio, durante il provisioning, se viene selezionata l'opzione 1 per la mappatura dell'ID utente, assicurati che user.userprincipalname sia impostato come UID nella sezione "Richieste aggiuntive".

  • I seguenti attributi sono sincronizzati da Webex Common Identity Service in Unified Communications Manager: userName, e-mail, nome, displayName, titolo, numeri di telefono, reparto, manager.

  • Qualsiasi aggiornamento effettuato ai dati utente nella rubrica cloud in seguito alla sincronizzazione delle rubriche verrà aggiornato nel prossimo periodo di sincronizzazione. Questo perché la rubrica cloud viene sincronizzata periodicamente una volta al giorno.

  • Per gli accessi, è necessaria la funzionalità Single Sign-On (SSO). Questo documento descrive solo l'integrazione della funzionalità Single Sign-On (SSO).

  • Prima di eseguire nuovamente il provisioning di qualsiasi cluster da Control Hub, si consiglia di interrompere manualmente il servizio Dirsync dalla GUI di Cisco Unified Serviceability.

  • Dopo il nuovo provisioning, se gli utenti contrassegnati come utenti non corrispondenti corrispondono a Nuovi utenti (utenti che condividono lo stesso ID posta), si consiglia di attendere un massimo di 48 ore per l'applicazione delle modifiche di sincronizzazione. Se si desidera visualizzare immediatamente le modifiche aggiornate, assicurarsi di effettuare le seguenti operazioni prima di eseguire nuovamente il provisioning:

    1. Disabilita il Servizio directory dalla pagina Gestione servizi in Control Hub.

    2. Elimina il contratto di sincronizzazione Webex Common Identity Service da Unified CM.

    3. Disabilitare la casella di controllo Abilita sincronizzazione dal server LDAP nella pagina Configurazione sistema LDAP nell'interfaccia utente di Cisco Unified CM Administration.

    4. Eliminare gli utenti finali dalla finestra Utente finale.

    5. Abilita il Servizio directory dalla pagina Gestione servizi in Control Hub.

Stato provisioning

Stato provisioning

Nel dashboard del servizio di directory, è possibile visualizzare e tenere traccia dello stato del cluster ed esaminare gli errori.

Nella tabella seguente sono elencati lo stato, la descrizione e le azioni corrispondenti.

Tabella 1. Stato provisioning

Stato provisioning

Descrizione

Elaborazione

Provisioning in corso.

Azione richiesta

Se è richiesto l'intervento manuale per un determinato cluster, effettua le operazioni necessarie. Ad esempio,

  • Se desideri continuare o abbandonare la sincronizzazione dopo un'esecuzione di prova.

  • Una volta creato il nuovo contratto, verifica la presenza di notifiche ed esegui le azioni necessarie.

Errore

Se sono richieste eventuali azioni nella procedura guidata 'Abilita sincronizzazione', verificale e, se necessario, esegui le azioni necessarie.

In caso di errori durante qualsiasi fase del provisioning, l'amministratore deve eseguire l'audit della pagina Cronologia eventi in Cisco Webex Control Hub per il servizio: Servizio directory. In questo modo è possibile isolare, eseguire il debug e risolvere i possibili problemi. Per accedere agli eventi, vedere Accesso alla cronologia eventi per i servizi Hybrid.

Per ulteriori informazioni sui vari tipi di eventi e sui relativi dettagli, vedere la tabella 'Eventi e possibili risoluzioni' di seguito.

Predisposto

Il provisioning del cluster è completato.

Non predisposto

Il provisioning del cluster non è ancora iniziato.
Tabella 2. Eventi e risoluzioni

Eventi

Azione richiesta

Sincronizzazione periodica non riuscita

Assicurati di attendere il completamento della sincronizzazione periodica del giorno successivo. Verifica che la sincronizzazione sia stata completata correttamente. Se il problema persiste, contatta il supporto Cisco TAC.

Copia dati non riuscita

Fai clic sul pulsante Riprova per continuare il trasferimento dati. Se il problema persiste, contatta il supporto Cisco TAC.

Errore del contratto di sincronizzazione

Fai clic sul pulsante Riprova per riprovare a creare il contratto di sincronizzazione. Se il problema persiste, contatta il supporto Cisco TAC.

Sincronizzazione periodica ignorata

Nessuna azione richiesta.

Trasferimento dati non riuscito

Fai clic sul pulsante Riprova per continuare il trasferimento dati. Se il problema persiste, contatta il supporto Cisco TAC.

Sincronizzazione utenti non corrispondente

Controlla nei registri di sincronizzazione rubrica in Unified CM gli errori di sincronizzazione utenti o contatta il supporto Cisco TAC per ulteriore assistenza.

Provisioning utenti eseguito correttamente

Nessuna azione richiesta.

Trasferimento dati a sincronizzazione periodica riuscito

Nessuna azione richiesta.

Impossibile recuperare i dettagli utente di alcuni dei gruppi selezionati da Webex Common Identity.

Passa al Dashboard e seleziona il cluster per ottenere i dettagli dei gruppi in errore facendo clic sul collegamento di download fornito. Verifica se gli utenti sono presenti in Webex Common Identity e fai clic su Riprova. Contatta il supporto Cisco TAC per ulteriore assistenza.

Impossibile recuperare i dettagli utente di tutti i gruppi selezionati da Webex Common Identity.

Fai clic sul pulsante Riprova per continuare il trasferimento dati. Se il problema persiste, contatta il supporto Cisco TAC per ulteriore assistenza.
Risoluzione dei problemi di sincronizzazione

In questa sezione vengono fornite le informazioni e le soluzioni necessarie per risolvere alcuni problemi comuni che possono verificarsi durante le diverse fasi della sincronizzazione degli utenti da Control Hub al database Unified Communications Manager.

Utenti non corrispondenti

Se vengono visualizzati utenti non corrispondenti, abilitare la sincronizzazione entro 20 ore dalla creazione del nuovo contratto. Gli utenti esistenti vengono contrassegnati come inattivi e vengono eliminati da Unified CM dopo 24 ore di inattività.

Errore: copia dei dati non riuscita. Riprovare

  • La comunicazione tra Cloud-Connected UC e Webex Cloud è stata interrotta o non è in grado di recuperare i dati utente dal cloud Webex.

    Soluzione: Per verificare se la connettività ha esito positivo su Cisco Cloud, controllare lo stato per questi servizi all'indirizzo: https://status.webex.com/. Fai clic su Riprova.

  • La comunicazione tra Cloud-Connected UC e Unified CM è in interruzione o non è in grado di eseguire il push dei dati utente sul database Unified CM.

    Soluzione: Controllare la connettività di rete tra Cloud-Connected UC e Unified CM e fare clic su Riprova. Se il problema persiste, contatta il supporto Cisco TAC.

Errore: impossibile creare il contratto di sincronizzazione. Riprovare

  • La comunicazione tra Cloud-Connected UC e Unified CM è in interruzione o non è in grado di eseguire il push dei dati del contratto di sincronizzazione nel database Unified CM.

    Soluzione: Controllare la connettività di rete tra Cloud-Connected UC e Unified CM e fare clic su Riprova. Se il problema persiste, contatta il supporto Cisco TAC.

  • Contratto di sincronizzazione non creato correttamente.

Errore–Impossibile abilitare la sincronizzazione delle rubriche. Riprova

  • La comunicazione tra Cloud-Connected UC e Unified CM è stata interrotta e il servizio Cisco DirSync non viene attivato.

    Soluzione: Controllare la connettività di rete tra Cloud-Connected UC e Unified CM e fare clic su Riprova. Se il problema persiste, contatta il supporto Cisco TAC.

Impossibile ottenere i dettagli del contratto di sincronizzazione. Riprova tra qualche tempo.

Comunicazione tra Cloud-Connected UC e Unified CM interrotta.

Soluzione: Controllare la connettività di rete tra Cloud-Connected UC e Unified CM e fare clic su Riprova. Se il problema persiste, contatta il supporto Cisco TAC.

Impossibile recuperare i dati utente per i gruppi selezionati

Durante il primo provisioning, potrebbero verificarsi problemi nel download dei dati utente da uno o più gruppi specifici selezionati per la sincronizzazione. Nel messaggio di errore, fare clic sul collegamento di download per visualizzare i dettagli delle informazioni del gruppo in errore.

È anche possibile scaricare informazioni di gruppo non riuscite per i cluster già predisposti dalla pagina Cronologia eventi in Cisco Webex Control Hub. Passa al Dashboard e seleziona il cluster per ottenere i dettagli dei gruppi in errore facendo clic sul collegamento di download fornito. Verifica se gli utenti sono presenti in Webex Common Identity e fai clic su Riprova. Contatta il supporto Cisco TAC per ulteriore assistenza.

Problemi noti e limitazioni per la sincronizzazione del servizio di directory Webex Cloud-Connected UC

Problemi noti e limitazioni per la sincronizzazione del servizio di directory Webex Cloud-Connected UC

Se si verifica un problema con questa funzione, controlla se si tratta di un problema già noto e se esiste una soluzione consigliata.

  • Puoi disabilitare il Servizio directory per un cluster da Control Hub, quindi riabilitare nuovamente il cluster. Si consiglia di attendere almeno 60 secondi prima di attivare il servizio di directory per la sincronizzazione.

  • In seguito all'eliminazione, nel caso in cui desideri eseguire l'onboarding dello stesso cluster Unified CM nell'organizzazione, devi prima disabilitare il servizio rubrica, quindi eseguire nuovamente il provisioning dello stesso cluster.

  • Durante il provisioning, l'elenco dei dettagli del gruppo non viene visualizzato a causa di problemi di sincronizzazione con Webex Common Identity Service. Si consiglia agli utenti di abbandonare il provisioning e riprovare dopo qualche tempo.