Guida pratica SCIM per Entra ID e Okta
Una guida per creare mappature SCIM personalizzate tra Entra ID o Okta e Zoom
Panoramica
L'API SCIM2 di Zoom espone un ampio catalogo di attributi utente che controllano licenze, diritti dei prodotti, ruoli, regioni e configurazione per servizio. Le integrazioni di provisioning predefinite sia per Microsoft Entra ID sia per Okta mappano solo un piccolo sottoinsieme di questi — abbastanza per creare, aggiornare e disattivare gli utenti, ma non abbastanza per eseguire il provisioning di siti Zoom Phone, pacchetti centro di contatto, ruoli di Revenue Accelerator o di uno qualsiasi delle decine di altri attributi supportati da Zoom.
Questa guida insegna il metodo ripetibile per aggiungere qualsiasi attributo SCIM di Zoom alla configurazione di provisioning. Anziché documentare un singolo attributo in isolamento, spiega il modello sottostante in modo che gli amministratori possano cercare un attributo nella documentazione dell'API SCIM2 di Zoom e configurarlo autonomamente, senza attendere la pubblicazione di un articolo specifico per prodotto.
Come usare questa guida
Leggi prima l'Introduzione, a partire da Comprendere gli attributi SCIM insieme alle sezioni che seguono — prerequisiti, dati della directory, scenari di riferimento e verifica lato Zoom. Questi si applicano indipendentemente dall'identity provider (IdP) che usi. Quindi, procedi con la sezione Microsoft Entra ID o Okta a seconda di quale usi. Ciascuna di queste parti è completa dal primo passaggio di configurazione fino alla Verifica e agli esempi svolti; non sarà necessario passare da una all'altra.
Per i concetti fondamentali di SSO e provisioning che stanno alla base di questa guida, fai riferimento all'articolo Guida SSO, il SSO e provisioning di Zoom per Entra ID, e il articolo SSO di Zoom per Okta.
Prerequisiti per l'uso di SCIM
Tutto in questa parte si applica indipendentemente dal provider di identità. Leggi questo prima di passare alle istruzioni specifiche del tuo provider di identità.
Requisiti comuni a entrambi i provider di identità
account Zoom Business, Istruzione o Enterprise con un approvato URL personalizzato
privilegi di titolare dell'account o admin dell'account Zoom
Single Sign-On abilitato sull'account Zoom
Un dominio associato verificato sull'account Zoom, corrispondente al dominio e-mail degli utenti sottoposti a provisioning
Il provisioning SCIM è già stato stabilito tra il provider di identità e Zoom
La licenza Zoom, il piano, l'add-on o l'oggetto di configurazione assegnato deve già esistere ed essere disponibile sull'account Zoom
I requisiti specifici del provider di identità sono elencati all'inizio di ciascuna sezione corrispondente.
Limitazioni comuni a entrambi i provider di identità
SCIM assegna solo i diritti esistenti; non può creare gli oggetti a cui fa riferimento. Vedi la sezione Prima di tentare la mappatura avanzata, gli oggetti lato Zoom devono esistere prima che SCIM possa farvi riferimento di seguito.
Alcuni attributi accettano un solo valore per utente. Un piano di chiamate Zoom Phone è un esempio: i pacchetti add-on come Customer Engagement Pack non possono essere provisionati tramite SCIM.
La
tipo utentel'attributo è documentato da Zoom come previsto per la deprecazione.
Introduzione
Comprendere gli attributi SCIM
Gli amministratori che comprendono come è costruito un attributo SCIM di Zoom possono Configura qualsiasi attributo supportato da Zoom. Gli amministratori che seguono una procedura possono Configura solo l'attributo descritto da quella procedura. Questa sezione tratta la costruzione. L'associazione di un attributo a una fonte di dati arriva più tardi, nelle sezioni del provider di identità.
Ogni attributo ha un namespace, un nome, un tipo di dato e un valore consentito
Iniziamo con un esempio completo e funzionante. Ecco l'identificativo per assegnare un utente a una sede di Zoom Phone:
Sono in gioco quattro proprietà di questo attributo. Due di esse sono visibili nella riga sopra. Le altre due provengono dalla documentazione API e vengono inserite altrove nel tuo provider di identità in un secondo momento. Per i nostri scopi immediati, ci concentriamo su due: i Spazio dei nomi e la Nome.
Spazio dei nomi
urn:ietf:params:scim:schemas:extension:zoom:1.0:utente
Indica a Zoom a quale schema appartiene l'impostazione e funge da base condivisa per quasi tutti gli attributi di prodotto e di licenza di Zoom. Passato a Zoom come prima metà dell'identificativo.
Nome
zoomPhoneSite
Identifica l'impostazione specifica di Zoom che viene scritta — qui, la sede Zoom Phone dell'utente. Passato a Zoom come seconda metà dell'identificativo. Fa distinzione tra maiuscole e minuscole.
Tipo di dato
stringa
Indica al tuo provider di identità che tipo di valore contiene l'attributo, in modo che venga archiviato e formattato correttamente. Non viene passato come parte dell'identificativo; è dichiarato separatamente come Tipo in Entra ID, oppure Tipo di dato in Okta.
Valore consentito
LON-01, un nome della sede Zoom Phone
L'impostazione effettivamente applicata all'utente. Testo libero per alcuni attributi, un insieme fisso per altri — Essenziali, Premium, oppure Elite per Zoom centro di contatto, per esempio. Trasmesso a Zoom al momento del provisioning, fornito dalla mappatura anziché dall'identificativo.
Trova l'attributo di cui hai bisogno nel riferimento API SCIM2
La riferimento API SCIM2 è l'elenco autorevole di tutto ciò che Zoom accetta durante il provisioning. Contano due operazioni: Crea un utente e Aggiorna un utente.
Lavora principalmente da Aggiorna un utente. La creazione avviene una sola volta per persona, ma le Modifica degli attributi avvengono continuamente — un trasferimento di ufficio, una Modifica del piano, una Modifica del Ruolo, una persona che lascia l'azienda — quindi, nel tempo, la maggior parte di ciò che il provisioning fa davvero sono aggiornamenti. Aggiorna un utente documenta anche i valori di rimozione che Crea un utente non ha motivo di includere, ad esempio l'impostazione zoomPhoneCallingPlan a -1 per rimuovere tutti i piani di chiamata da un utente.
Per trovare un attributo:
Apri il riferimento API SCIM2 e vai a Aggiorna un utente.
Nel corpo della richiesta, individua l'
urn:ietf:params:scim:schemas:extension:zoom:1.0:utenteoggetto. Ogni attributo trattato in questa guida è elencato al suo interno.Trova il tuo attributo per nome e registrare il suo tipo di dati e i suoi valori consentiti.
Leggi la descrizione accanto ad esso. Le descrizioni includono comportamenti che non puoi dedurre dal nome dell'attributo —
zoomPhoneExtNumberimpostato su0attiva l'assegnazione automatica dell'interno,zoomPhoneCallingPlanimpostato su-1rimuove tutti i piani di chiamata ezoomPhoneNumberdeve fare riferimento a un numero che è già non assegnato nell'account Zoom.
Assemblaggio dell'identificativo: genitore, due punti, figlio
Tutto ciò elencato all'interno di quello urn:ietf:params:scim:schemas:extension:zoom:1.0:utente l'oggetto è un bambino di esso. L'oggetto stesso è il genitore. Creare un identificativo significa assegnare un nome al genitore, aggiungere due punti, quindi aggiungere il figlio:
Questa è l'intera costruzione. Non c'è alcuna tabella di ricerca da richiedere a Zoom e nulla da generare — l'identificativo è composto da due elementi che hai già, uniti da due punti.
Il genitore resta lo stesso; cambia solo il figlio
Poiché il padre è fisso, configurare un secondo, quinto o quindicesimo attributo è la stessa azione con un figlio diverso aggiunto in coda:
Lo stesso elemento genitore è presente in ogni altro prodotto Zoom. Nulla Info la costruzione cambia quando lo fa il prodotto:
Impari quindi l'elemento padre una sola volta. Da quel momento in poi, configurare un nuovo attributo significa consultare solo tre cose nella documentazione di riferimento dell'API: il nome dell'elemento figlio, il suo tipo di dati e i suoi valori consentiti.
Se riesci ad assemblare un genitore e un figlio, la parte più difficile di questa configurazione è già alle spalle. Ciò che resta è indicare al tuo provider di identità da dove deve provenire ciascun valore — trattato nelle sezioni di Entra ID e Okta che seguono — e decidere quali attributi affrontare per primi, trattati Avanti.
Due tipi di mappatura: Basic e avanzata
Non tutti gli attributi comportano lo stesso rischio, ed è utile ordinarli prima di configurare qualsiasi cosa.
Questa guida utilizza i termini di base e avanzate dal Guida SSO, che traccia la stessa linea per la mappatura della risposta SAML. I termini descrivono cosa fa Zoom con il valore all'arrivo, non quanto sia difficile Configura l'attributo. Meccanicamente i due sono identici: entrambi sono documentati nello stesso Aggiorna un utente corpo della richiesta, entrambi sono costruiti con la stessa costruzione padre-due punti-figlio, ed entrambi sono dichiarati e mappati attraverso gli stessi passaggi in Entra ID e Okta.
Mappatura Basic scrive testo nel profilo di un utente. Zoom memorizza il valore esattamente come inviato e non lo controlla mai rispetto a nulla.
Mappatura avanzata fa una richiesta sull'account. Zoom prende il valore e cerca un oggetto corrispondente, oppure un posto libero in un piano acquistato — e quella ricerca può fallire.
Qual è il valore
Testo memorizzato nel profilo dell'utente
Un puntatore a un oggetto in Zoom, oppure un diritto su un posto acquistato
Esempi
department, titolo, centro di costo
zoomPhoneSite, zoomContactCenterRole, zoomWorkplace
Genitore
Di livello superiore, oppure l'estensione Enterprise
L'estensione Zoom
Prerequisiti in Zoom
Nessuno
L'oggetto deve esistere, oppure il posto deve essere libero
Se il valore è errato
Su un profilo appare testo errato
L'attributo viene rifiutato o ignorato silenziosamente
La distinzione guida due decisioni pratiche. Determina cosa devi creare prima in Zoom — nulla per la mappatura di base, potenzialmente molto per quella avanzata — e determina quanto costa un errore. Un reparto errato è un errore estetico su un profilo. Un nome della sede errato o una postazione di licenza non disponibile lasciano un utente senza un telefono funzionante o senza il prodotto per cui è stato assunto, e in un'implementazione live può revocare un diritto a qualcuno che già lo aveva.
Questa differenza nelle conseguenze è il motivo per cui i due casi sono trattati separatamente di seguito.
Mappatura Basic: informazioni del profilo
La mappatura Basic popola i campi descrittivi nel profilo Zoom di un utente. Zoom memorizza ogni valore esattamente come inviato e non lo convalida mai rispetto a un oggetto esistente, quindi non c'è nulla da creare in Zoom in anticipo e nulla che possa rompersi se un valore è errato.
I campi principali dell'identità sono generalmente già mappati. Nome utente, name.givenName, name.familyName, displayName, e emails si trovano al livello superiore del corpo della richiesta senza alcun elemento padre e sia le integrazioni Entra ID sia quelle Okta li mappano immediatamente. Verificali anziché ricrearli. titolo, phoneNumbers, e locale sono anch'essi al livello superiore, ma potrebbe essere necessario aggiungerli.
I campi Enterprise usano un secondo genitore. La costruzione non subisce alcuna Modifica — solo il genitore lo fa:
Popolare Dipartimento e Centro di costo tramite SCIM non richiede più il mapping SAML.
Mappatura avanzata: configurazione del prodotto e diritti
La mappatura avanzata assegna ciò che un utente può fare: una sede di Zoom Phone e un piano di chiamate, un Ruolo e un Pacchetto del centro di contatto, un bundle di Workplace, un segmento di Revenue Accelerator. Questi attributi risiedono sotto l'elemento padre dell'estensione Zoom usato in tutta questa guida.
La differenza che conta è che questi valori non sono memorizzati — vengono risolti. Zoom prende il valore che invii e cerca un oggetto corrispondente o un posto Disponibile. Dove la mappatura di base scrive testo su un profilo, la mappatura avanzata formula una richiesta sulla configurazione e sull'inventario dell'account, e tale richiesta può fallire.
Ecco perché questa guida dedica un'intera sezione ai prerequisiti. Ogni attributo avanzato dipende dal fatto che qualcosa sia stato creato o acquistato prima nel Zoom web portal, e le modalità di errore sono notevolmente meno indulgenti di un titolo di lavoro scritto male.
I tre livelli comuni a ogni configurazione
Indipendentemente dall'attributo o dal provider di identità, il lavoro è sempre lo stesso: tre livelli. Solo la Posizione di ogni controllo differisce.
1. Dichiara
Indica al provider di identità che l'attributo esiste sull'applicazione Zoom così diventa Disponibile come destinazione di mapping.
Fase 1
Fase 1
2. Mappa
Definisci da dove proviene il valore.
Fase 2
Passaggi 2–3
3. Ambito
Determina a quali utenti si applica la configurazione e quando viene eseguita.
Passaggi 3–5
Passaggi 4–5
Una volta compreso questo schema, aggiungere un quinto o un quindicesimo attributo è una ripetizione degli stessi tre livelli, non un nuovo progetto.
Entra e Okta differiscono nel punto da cui può avere origine un valore
Questa è la differenza architetturale singolarmente più significativa tra i due percorsi, e spiega perché lo stesso requisito di business produce configurazioni diverse tra Entra e Okta.
Entra ID ricava i valori solo dagli attributi dell'oggetto utente. Un valore deve provenire da un campo sull'utente — un campo di directory esistente o un attributo di estensione realizzato appositamente. Quando il valore della directory e il valore di Zoom non sono la stessa stringa, è necessaria un'espressione per tradurli tra loro.
Okta può ricavare i valori sia dal profilo utente sia da un'assegnazione di gruppo. Dichiarare un attributo con Tipo di attributo: gruppo consente di impostare il valore una sola volta su un gruppo e farlo ereditare da tutti i Membri. Quando la configurazione segue la struttura organizzativa, elimina del tutto la necessità di logica di traduzione.
Nessuno dei due approcci è universalmente migliore, ma portano a configurazioni diverse.
Requisiti di preconfigurazione lato Zoom
Prima di tentare la mappatura avanzata, gli oggetti lato Zoom devono esistere prima che SCIM possa farvi riferimento
SCIM è un meccanismo di assegnazione, non di creazione — collega un utente alla configurazione che già esiste sull'account Zoom, e la non può costruisce quella configurazione per conto dell'utente.
Gran parte degli attributi di mappatura avanzata sono riferimenti: il valore che invii dovrebbe risolversi in un oggetto che esiste già in Zoom — una sede, un Ruolo, un modello, un piano acquistato, un numero specifico o un numero interno. Una regola li governa tutti:
Se un attributo nomina una cosa, quella cosa deve già esistere, deve essere scritta esattamente come inviata e — quando attinge a un pool finito — deve avere capacità inutilizzata.
Quando un oggetto referenziato non esiste, SCIM non lo crea né mette la richiesta in coda. L'attributo fallisce del tutto, con l'errore restituito nel registro di provisioning, oppure viene scartato in silenzio — Zoom accetta il payload, non applica nulla e segnala successo.
Le sezioni seguenti suddividono le precondizioni per prodotto, con il percorso di navigazione e l'articolo di Assistenza per crearne ciascuna. Leggi le note a livello account, poi la sezione per ciascun prodotto che intendi provisionare.
Le precondizioni a livello account si applicano prima del provisioning di qualsiasi prodotto
I requisiti dell'account elencati all'inizio di questa guida — URL personalizzato, SSO, autorizzazione SCIM e un dominio associato verificato — sono precondizioni per ogni attributo che segue. Configura sicurezza e SSO in Centro admin → Sicurezza e fiducia, e gestisci i Domini associati in Centro admin → Account → profilo dell'account; vedi configurazione SSO/SCIM di Zoom + Microsoft Entra ID.
Vale la pena affermare esplicitamente altri due punti:
Acquistare un posto non è la stessa cosa che assegnarlo. SCIM esegue l'assegnazione, ma il posto deve esistere prima. Vedi Assegnazione o rimozione delle licenze Zoom dagli utenti.
I posti devono appartenere al piano esatto richiesto. Inviare un attributo di licenza quando quel piano specifico non ha posti liberi fallisce anche se un piano diverso nell'account mostra capacità disponibile.
Zoom Phone
Zoom Phone ha il più ampio insieme di attributi di riferimento perché un utente telefonico è assemblato da diversi elementi di infrastruttura da acquistare in anticipo o già predisposti.
La licenza stessa di Zoom Phone
Un posto Zoom Phone Disponibile — l'abilitazione prerequisito prima che qualsiasi elemento seguente possa collegarsi.
Acquistare in anticipo. Vedi Acquistare e assegnare le licenze Zoom Phone.
zoomPhoneSite
La sede, nominata esattamente come il valore inviato. Omettere l'attributo assegna la sede principale dell'account, che esiste come predefinito una volta che i Siti multipli sono abilitati.
Centro admin → Configurazione del prodotto → sistema telefonico → Informazioni sull'azienda → Aggiungi sede, oppure Importa per la creazione in blocco. Vedi Gestione dei Siti multipli.
zoomPhoneNumber
Il numero, acquistato o portato nell'account e attualmente non assegnato. Un numero già in possesso di un altro utente, di una coda delle chiamate o di un centralinista automatico non può essere riutilizzato.
Centro admin → Configurazione del prodotto → Numeri → Numeri telefonici. Acquista o esegui la Portabilità qui, e lascia il numero di destinazione non assegnato così che SCIM possa reclamarlo. Vedi Uso di Number Management per la gestione dei Numeri telefonici e Gestione dei Numeri telefonici.
zoomPhoneExtNumber (solo valori specifici)
Un numero interno di 3–6 cifre, non già in uso. Non è richiesto quando si invia 0, che delega l'assegnazione a Zoom.
Centro admin → Configurazione del prodotto → sistema telefonico → Utenti e stanze → Seleziona l'oggetto che contiene il numero interno → Profilo → Numero interno → Modifica. Vedi Modifica delle Impostazioni dell'utente telefonico.
zoomPhoneCallingPlan
Il piano di chiamate, acquistato e con capacità Disponibile, richiamato dal suo codice piano esatto.
Acquistare in anticipo. Vedi Acquistare e assegnare le licenze Zoom Phone e Gestione degli utenti telefonici. I codici di piano sono elencati nel riferimento al piano di chiamate di Zoom Phone, o restituiti come tipo dal Elenca i piani di chiamate API insieme ai conteggi dei posti Disponibile.
zoomPhoneCallingPlanSubscription (solo account con più abbonamenti)
L'abbonamento specifico da cui il piano dovrebbe attingere, quando l'account contiene più di un abbonamento per lo stesso piano.
Piani e Fatturazione → gestione degli abbonamenti.
Il pool di interni è condiviso tra i tipi di oggetto, non solo gli utenti. Le code di chiamata, i servizi di centralinista automatico, i gruppi di linea condivisa e i telefoni dell'area comune consumano tutti interni dallo stesso intervallo. Questa è la causa più frequente degli errori "interno già in uso" perché l'interno sembra libero quando un amministratore controlla solo l'elenco degli utenti.
Un numero portato non è assegnabile finché la Portabilità non è completata. Il numero deve essere sia presente nell'account sia non assegnato; avviare una Portabilità non soddisfa nessuna delle due condizioni.
Le sedi sono il blocco più comune perché crearle comporta requisiti propri. Gli indirizzi delle sedi vengono convalidati rispetto a un database di indirizzi reali perché sono alla base dei servizi di chiamata di emergenza — combinazioni inventate di indirizzo e CAP vengono rifiutate con un errore di convalida. Quando si importano sedi in blocco, la colonna del centralinista automatico si aspetta il valore Sì anziché il testo dell'etichetta mostrato nell'interfaccia, e il nome ID chiamante si applica principalmente a Stati Uniti e Canada e può essere lasciato vuoto se causa un errore di convalida.
Zoom centro di contatto
Il provisioning del centro di contatto è basato su Ruolo e template. Gli attributi individuali devono risolversi in oggetti esistenti del centro di contatto e il template contiene le Impostazioni che non hanno un attributo SCIM dedicato proprio.
zoomContactCenterPackage
Il Pacchetto — Essenziali, Premium, oppure Elite — acquistato con posti inutilizzati.
acquistare in anticipo; Premium potrebbe richiedere di contattare prima Assistenza Zoom per acquistare pacchetti aggiuntivi. Vedi Modifica delle Impostazioni utente del centro di contatto Zoom.
Piano componenti aggiuntivi Zoom Contact Center
Il piano add-on, acquistato e con capacità.
acquistare in anticipo; piano account e Informazioni di fatturazione.
zoomContactCenterRole
Il Ruolo, Standard o personalizzato, con il nome esatto. Omettendolo, viene assegnato il Ruolo Agente predefinito, che è predefinito.
Centro admin → gestione CX → centro di contatto → Ruoli → Aggiungi → Configura autorizzazioni → Salva. Vedi Gestione dei ruoli del centro di contatto Zoom.
zoomContactCenterRegion
La regione. Se omessa, assegna la regione principale dell'account, che deve essere configurata.
Centro admin → gestione CX → centro di contatto → Preferenze → Regioni → Aggiungi regione → inserire un nome e Seleziona una zona SIP → Aggiungi. Vedi Gestione delle regioni del centro di contatto Zoom.
zoomContactCenterUserTemplate
Il modello utente, denominato esattamente. I modelli di tipo Aggiungi si applicano alla creazione dell'utente; i modelli di tipo Update si applicano all'aggiornamento.
Centro admin → gestione CX → centro di contatto → Utenti → Modelli → Aggiungi modello → Scegli Aggiungi → Configura ruoli, pacchetti, code e competenze → Aggiungi. Vedi Gestione del modello Impostazioni utente di Zoom centro di contatto.
Le caselle di posta in arrivo, le code e le competenze non hanno alcun attributo SCIM. Per eseguirne il provisioning, preconfigurali in Centro admin → gestione CX → centro di contatto, collegali a un modello utente e Assegna quel modello tramite zoomContactCenterUserTemplate. Diventano quindi prerequisiti del modello piuttosto che del singolo utente — il che rende anche il template l'unico oggetto da mantenere man mano che tali requisiti subiscono una Modifica.
Coda
Centro admin → gestione CX → centro di contatto → Code → Aggiungi coda → nome, canale, agenti → Salva. Vedi Gestione delle code di Zoom centro di contatto.
Competenza
Centro admin → gestione CX → centro di contatto → Competenze → Seleziona una categoria → Aggiungi skill → nome → Aggiungi. Vedi Gestione delle competenze e delle categorie di competenze.
Posta in arrivo
Centro admin → gestione CX → centro di contatto → Posta in arrivo → Aggiungi Inbox. Vedi Gestione delle inbox di Zoom centro di contatto.
Quando vengono forniti sia un modello sia attributi individuali, prevalgono i valori individuali. Inviare un modello insieme a zoomContactCenterRole significa che l'attributo Ruolo sovrascrive l'impostazione del Ruolo del modello, quindi sia il Ruolo di riferimento sia il modello devono esistere.
Zoom Revenue Accelerator
zoomRevenueAcceleratorPlan e zoomRevenueAcceleratorSubscription
Il piano ZRA acquistato o l'abbonamento con un posto Disponibile.
acquistare in anticipo; piano account e Informazioni di fatturazione.
zoomRevenueAcceleratorRole
Il Ruolo, Standard o personalizzato — ad esempio Responsabile Reparto vendite — denominato esattamente.
Centro admin → Utenti → Ruoli → Zoom Revenue Accelerator scheda → + Aggiungi Ruolo → nome e descrizione → Aggiungi → Configura autorizzazioni → Salva le modifiche. Vedi Utilizzo della Gestione ruoli di Zoom Revenue Accelerator.
zoomRevenueAcceleratorSegment
Il segmento a cui appartiene l'utente.
Impostazioni admin di Revenue Accelerator.
zoomRevenueAcceleratorRegion
La regione — ad esempio, Stati Uniti.
Impostazioni admin di Revenue Accelerator.
Licenze di Zoom Workplace e ruoli dell'account
Oltre ai tre prodotti sopra, lo Standard utente registrare contiene riferimenti a Ruolo e licenza che seguono la stessa regola.
ruoli[] (valore / mostrare)
Il Ruolo dell'account, denominato esattamente. I Ruoli sono referenziati da SCIM, mai creati da esso.
Centro admin → Utenti → Ruoli → Aggiungi Ruolo → nome e descrizione → Configura autorizzazioni. Vedi Utilizzando la Gestione ruoli.
zoomWorkplace e altri attributi di licenza o add-on — lavagna, Scheduler, Clips Plus, sottotitoli tradotti, Workforce Management (WFM), Gestione della qualità, Gestione della conformità, CX Insights, Assistenza AI per il Reparto vendite e i loro ...Abbonamento controparti
Il bundle o add-on corrispondente, acquistato con posti inutilizzati.
Piani e Fatturazione → Gestione del piano → modifica il piano → aumenta il numero di licenze. Vedi Aggiornamento del tuo account e Aggiungi-ons.
tipo di accesso (sso / email di lavoro), sotto urn:us:zoom:scim:schemas:extension:1.0:Zoomutente
SSO configurato sull'account, per il tipo di accesso SSO.
Centro admin → Sicurezza e fiducia → Single Sign-On.
Per un attributo di licenza o add-on non c'è alcun oggetto da nominare, ma la precondizione è identica nei suoi effetti: senza un posto Disponibile in quel pool specifico, l'assegnazione non riesce.
Attributi senza precondizione
Ogni attributo di mappatura di base si qualifica, come previsto in Mappatura Basic: informazioni del profilo — Zoom memorizza quei valori alla lettera e non li convalida mai rispetto a un oggetto esistente. Due attributi dell'estensione Zoom si comportano allo stesso modo:
Valori auto-delegati —
zoomPhoneExtNumberinviato come0, dove Zoom assegna l'estensione stessa.Attributi personalizzati dell'account — il
{customAttribute}campo, che contiene qualunque stringa invii.
Riferimenti predefiniti sono un caso intermedio: omettere zoomPhoneSite, zoomContactCenterRole, oppure zoomContactCenterRegion torna alla sede principale, al Ruolo predefinito dell'Agente e alla regione principale, rispettivamente. Questi predefiniti devono esistere anch'essi, e per impostazione predefinita esistono.
I gruppi sono un'eccezione parziale. Quando il provisioning dei gruppi è abilitato, SCIM creerà un gruppo Zoom che non esiste ancora, usando il nome del gruppo di origine esattamente come digitato. Non applica alcuna configurazione del prodotto a quel gruppo — il gruppo arriva con i membri e nient'altro. I criteri di Zoom Phone, le autorizzazioni di chiamata e le altre Impostazioni a livello di gruppo devono comunque essere configurate in Centro admin → Utenti → Gruppi dopo che il gruppo appare.
Preparazione dei dati della tua directory
SCIM trasmette tutto ciò che contiene la sorgente. Non convalida, normalizza né corregge. Prima di mappare qualsiasi attributo, conferma tre cose riguardo alla sorgente prevista:
È popolato per ogni utente nell'ambito. Un campo non popolato non invia nulla, oppure invia il predefinito configurato.
I suoi valori sono coerenti nel formato e nella capitalizzazione. La logica di confronto in entrambi i provider di identità è esatta.
I suoi valori corrispondono esattamente ai valori attesi da Zoom. Zoom non effettua corrispondenze approssimative tra nomi della sede, nomi del Ruolo o valori del piano.
Laddove un campo esistente non possa soddisfare tutte e tre le condizioni, un attributo realizzato appositamente e popolato deliberatamente per questa Integrazioni è più sostenibile che riutilizzare un campo su cui scrivono anche altri sistemi.
Scenari di riferimento
In questa guida vengono utilizzati quattro scenari. I loro requisiti Business e i prerequisiti lato Zoom sono identici indipendentemente dal provider di identità, quindi sono definiti una sola volta qui. Ogni sezione specifica del provider di identità si conclude mostrando come implementare tutti e quattro in quella piattaforma.
Scenario 0: Dipartimento, come una prima mappatura Basic
Il reparto di un utente dovrebbe apparire nel suo profilo Zoom, preso dalla directory. Questa è la mappatura di base raccomandata in precedenza come primo test end-to-end, ed è inclusa qui in modo che la procedura venga seguita in entrambe le sezioni del provider di identità.
Prerequisito lato Zoom. Nessuna. Zoom memorizza il valore esattamente come inviato e non lo convalida mai rispetto a un oggetto esistente.
Attributo. Si noti che il genitore differisce dai tre scenari qui sotto — department si trova sotto l'estensione enterprise, non l'estensione Zoom.
urn:ietf:params:scim:schemas:extension:enterprise:2.0:utente:dipartimento
stringa
Testo libero. Entrambi i provider di identità contengono già un department campo sul profilo utente, quindi non è necessario alcun nuovo attributo di origine.
Perché iniziare da qui. Un valore di reparto visualizzato correttamente su un profilo Zoom dimostra la dichiarazione dello schema, la mappatura, l'ambito e la tua capacità di leggere i registri di provisioning — senza mettere a rischio una licenza o una configurazione telefonica. Ogni scenario avanzato qui sotto differisce solo per ciò a cui punta l'attributo.
Controlla prima se è già mappato. Le mappature predefinito differiscono tra Entra ID e Okta, e si Modifica man mano che entrambi i fornitori aggiornano le loro integrazioni Zoom. Esamina l'elenco esistente sotto Provisioning → Mappature in Entra, oppure Mappature degli attributi di Zoom con Mostra attributi non mappati abilitato in Okta. Se department è già mappato, verificane l’esistenza invece di dichiararne un duplicato — e se invece vuoi un attributo da Configura da zero, centro di costo, Organizzazione, e employeeNumber si trovano sotto lo stesso elemento padre e si comportano in modo identico.
Scenario 1: sede di Zoom Phone e assegnazione automatica del numero interno
Gli utenti devono essere assegnati alla sede corretta di Zoom Phone in base al loro ufficio e ricevere un numero interno senza intervento amministrativo.
Prerequisito lato Zoom Le sedi devono già esistere. Creale sotto Centro admin → Configurazione del prodotto → sistema telefonico → Informazioni sull'azienda → Aggiungi sede, oppure in blocco tramite Importa. Gli indirizzi della sede vengono convalidati rispetto a un database di indirizzi del mondo reale perché supportano i servizi di chiamata di emergenza, quindi combinazioni fittizie di indirizzo e codice postale non supereranno la convalida.
Attributi. Entrambi utilizzano lo spazio dei nomi urn:ietf:params:scim:schemas:extension:zoom:1.0:utente: seguito dal nome.
zoomPhoneSite
stringa
Deve corrispondere al nome della sede di Zoom carattere per carattere
zoomPhoneExtNumber
stringa
0 attiva l'assegnazione automatica
Perché il valore 0 è importante. Zoom è l'unico sistema che sa quali estensioni sono già in uso — incluse le estensioni assegnate alle code di chiamata e ai receptionist automatici anziché agli utenti. Delegare l'assegnazione a Zoom elimina un'intera categoria di errore di provisioning. Sfruttare invece le estensioni dalla directory è appropriato durante una migrazione, in cui preservare i numeri di estensione esistenti conta, ma la mappatura dovrebbe passare a 0 una volta completata la migrazione, così i futuri nuovi arrivati non dipendano da dati della directory mantenuti indefinitamente.
Scenario 2: piano di chiamate Zoom Phone variabile in base al paese
Un'Organizzazione multinazionale ha acquistato piani di chiamate autonomi di Zoom Phone e ha bisogno che ogni utente riceva il piano corrispondente al proprio paese.
Prerequisito lato Zoom. I piani di chiamate devono già essere acquistati e Disponibile sull'account. I valori del piano sono documentati nel riferimento al piano di chiamate di Zoom Phone.
Attributo. zoomPhoneCallingPlan (stringa).
Come ottenere il codice del piano corretto. zoomPhoneCallingPlan utilizza il codice numerico del piano, non il nome di un piano. Il modo più affidabile per ottenerlo è il Elenca i piani di chiamate API, che restituisce il codice di ciascun piano nome, il suo nome da mostrare tipo — il codice che mappi — e il suo sottoscritti e e Disponibile conteggi dei posti. Una chiamata quindi conferma che il piano esiste, ti fornisce il valore da inviare e verifica che ci sia capacità per chiamare e Assegna il piano.
Il Zoom web portal mostra solo nomi da mostrare, mai codici, quindi un amministratore che lavora solo dal portale deve tradurre il nome da mostrare usando il riferimento al piano di chiamate di Zoom Phone — dove, per esempio, UNLIMITED_PLAN_US_CA è 200 e UNLIMITED_PLAN_GB_IE è 202. Le liste di riferimento riportano nomi costanti anziché la formulazione del portale, quindi conferma la corrispondenza in base alle caratteristiche del piano — regione e a consumo rispetto a illimitato — anziché al testo esatto.
Separatamente, il riferimento API SCIM2 di Zoom mostra un nome di piano di fatturazione come phone_calling_usca_monthly_unlimited nel suo payload di esempio. Quel identificativo è usato per acquistare una sottoscrizione, non per Assegna un piano a un utente. Se devi specificare da quale sottoscrizione attinge un piano, questo appartiene in zoomPhoneCallingPlanSubscription.
Perché -1 viene usato come fallback. I documenti di riferimento SCIM2 -1 come valore che rimuove tutti i piani di chiamata. Usarlo per gli utenti non corrispondenti produce un risultato deterministico e visibile — nessun piano assegnato — anziché l'ambiguità di non inviare alcun valore. Offre inoltre un modo pulito per rimuovere i diritti di chiamata senza eliminare l'utente.
Scenario 3: Pacchetto, Ruolo e regione di Zoom centro di contatto
Gli agenti del centro di contatto devono essere provisionati con il Pacchetto ZCC e il Ruolo corretti al momento dell'Onboarding, anziché essere configurati manualmente in un secondo momento. Questo scenario dimostra che il metodo è indipendente dal prodotto — non cambia nulla della procedura, solo i nomi degli attributi e i valori consentiti.
zoomContactCenterPackage
stringa
Essenziali, Premium, Elite
zoomContactCenterRole
stringa
Qualsiasi nome di Ruolo ZCC. Predefinito su Agente se omesso.
zoomContactCenterRegion
stringa
Qualsiasi regione ZCC configurata. Predefinita sulla regione principale se omessa.
Omettendo deliberatamente gli attributi. Esci zoomContactCenterRegion non mappato nelle distribuzioni a singola regione, dove il valore predefinito documentato di Zoom è già corretto. Omettere un attributo il cui valore predefinito è corretto è preferibile alla sua mappatura — ogni mappatura è un obbligo di manutenzione.
Nota operativa. Il riferimento SCIM2 documenta anche zoomContactCenterUserTemplate, che applica un template ZCC predefinito. I template di tipo Aggiungi si applicano alla creazione utente e i template di tipo aggiornamento in fase di aggiornamento; quando in una stessa richiesta vengono forniti sia un template sia valori di attributo individuali, i valori individuali hanno la priorità. Vale la pena prendere in considerazione i template quando la configurazione ZCC è abbastanza complessa da rendere difficoltoso mantenerla attraverso molte mappature di attributi individuali.
Verifica lato Zoom e errori comuni
Ogni provider di identità ha il proprio registro, descritto nel Passaggio 6 di ciascun provider di identità. Il log lato Zoom qui sotto è identico per entrambi ed è il registrare definitivo di ciò che Zoom ha effettivamente ricevuto.
Zoom App Marketplace i registri di chiamare Mostra lo scambio completo di richiesta e risposta
Accedi al Zoom web portal come titolare dell'account.
Vai alla Zoom App Marketplace → Gestisci → App sull'account.
Seleziona l'applicazione che rappresenta la connessione del provider di identità. Per Entra, in genere si chiama Azure Identity o simile.
Apri il Log di chiamare scheda.
Usa Cerca per endpoint, oppure i filtri intervallo di date, metodo e stato, per individuare la chiamare pertinente.
Seleziona la riga per espanderla.
Rivedi
requestBodyper vedere esattamente cosa è stato inviato, erispostaper vedere esattamente cosa ha restituito Zoom, incluso l'ID utente Zoom generato,httpStatus, e il set di attributi risultante.
Zoom conserva gli ultimi 100 registri delle richieste API, quindi indaga su un errore tempestivamente invece che dopo che ulteriori attività di provisioning lo hanno sostituito.
Errori comuni di provisioning e relative cause
400
L'account non ha abilitato Single Sign-On.
SSO è un prerequisito per SCIM. Abilita e Configura prima SSO sull'account Zoom.
400
L'utente è inattivo o bloccato.
L'utente Zoom di destinazione non può essere aggiornato nel suo stato attuale. Risolvi lo stato dell'account nel Zoom web portal.
403
La richiesta è stata negata a causa di autorizzazioni insufficienti: "utente:Edit".
Le credenziali alla base della connessione SCIM non dispongono dell'ambito richiesto. Riautorizza la connessione con un account Titolare o admin.
404
L'utente non esiste.
Il provider di identità non ha correlato l'utente a un utente Zoom esistente. Verifica l'attributo corrispondente e il formato del Nome utente.
409
Il dominio e-mail non corrisponde al dominio associato dell'account.
Il dominio e-mail dell'utente non è associato all'account Zoom. Associa e verifica il dominio prima del provisioning.
409
Impossibile Aggiungi utenti a pagamento.
Nessuna licenza del tipo richiesto è disponibile. Capacità libera sull'account, oppure eseguire il provisioning dell'utente come Basic.
409
Impossibile creare altri utenti con [bundle name].
Il bundle specifico non ha più posti disponibili. Si applica a Workplace Business Plus, Enterprise Premier, Pro Plus e agli equivalenti di Istruzione.
429
Troppe richieste.
Il provisioning ha superato i limiti di frequenza di Zoom. Indagare se persiste tra i cicli.
Una modalità di errore non produce alcun errore
Un valore che Zoom accetta ma che non corrisponde a nulla — un nome della sede con uno spazio finale, o un nome del Ruolo poiché rinominato in Zoom — può essere accettato sintatticamente e non essere applicato a nulla. Nessuna voce di log segnala questo evento. Le varianti specifiche della piattaforma dello stesso problema sono trattate nel Passaggio 6.
Configurazione di SCIM con Entra ID
Requisiti aggiuntivi per Entra ID
Privilegi di amministratore di Entra ID con accesso alle applicazioni Enterprise
Il dominio e-mail utilizzato dai tuoi utenti verificato come dominio personalizzato nel tenant di Entra ID
Limitazioni aggiuntive in Entra ID
Le mappature degli attributi provengono esclusivamente da Entra oggetto utente attributi. I gruppi di sicurezza non possono fornire direttamente un valore a un attributo Zoom; l'appartenenza al gruppo controlla l'ambito, non il valore.
I cicli di provisioning incrementale vengono eseguiti approssimativamente ogni 40 minuti. Le modifiche non sono istantanee una volta abilitato il provisioning.
La
Collaborazionevalore ditipo utentenon è supportato con Entra ID a causa di una limitazione specifica di Microsoft.
Passaggio 1: Dichiarare l'attributo nello schema dell'applicazione Zoom
Dichiarare un attributo è un'azione una tantum per attributo. Dichiara ogni attributo che intendi usare prima di configurare qualsiasi mapping, in modo che tutte le destinazioni siano disponibili al Passaggio 2.
Accedi al Portale Azure usando l'URL dell'editor dello schema:
https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#homeSotto Servizi Azure, Seleziona Microsoft Entra ID.
Nel menu di navigazione a sinistra, sotto Gestisci, fai clic Applicazioni Enterprise.
Nell'elenco delle applicazioni, fai clic sulla tua applicazione Zoom. Nota: Il nome dell'applicazione è definito dall'amministratore Entra quando l'applicazione viene creata. Viene spesso chiamato Zoom o Zoom SSO, ma potrebbe essere diverso nel tuo tenant.
Nel menu di navigazione a sinistra, sotto Gestisci, fai clic Provisioning. Nota: Azure attualmente presenta uno di due layout. Nell'esperienza legacy, Seleziona Modifica mappature attributi in Gestisci provisioning. Nella nuova esperienza, la pagina si apre su un Panoramica scheda; Seleziona Provisioning di nuovo dal menu a sinistra. Entrambe le opzioni arrivano alla stessa destinazione.
Fai clic sulla Mappature menu a tendina, quindi fai clic Provisioning degli utenti Microsoft Entra ID. Nota: Nei tenant che mostrano ancora la denominazione legacy, questa opzione appare come Effettua il provisioning degli utenti di Azure Active Directory.
Nell'angolo in basso a sinistra, Seleziona il Mostra opzioni avanzate casella di controllo.
Fai clic su Modifica elenco attributi per Zoom.
Scorri fino alla prima riga vuota e completa quanto segue:
Nome: Inserire l'intera stringa dell'attributo, ad esempio
urn:ietf:params:scim:schemas:extension:zoom:1.0:utente:zoomPhoneSiteTipo: Seleziona Stringa o Booleano, corrispondente al tipo di dati documentato nel riferimento API SCIM2.
Ripeti il passaggio 9 per ogni attributo aggiuntivo.
Nell'angolo in alto a sinistra, fai clic su Salva.
Passaggio 2: Mappa una sorgente directory all'attributo
Entra ID offre tre tipi di mappatura e la scelta tra questi è la decisione più importante nella configurazione.
Diretta
Un campo Entra contiene già il valore esatto che Zoom si aspetta.
Trasmette il valore di origine invariato.
Costante
Ogni utente nell'ambito dovrebbe ricevere lo stesso valore.
Invia un valore fisso a ogni utente provisionato.
Espressione
Il valore deve essere derivato, tradotto o variato in base all'attributo dell'utente.
Valuta un'espressione sui campi di origine e invia il risultato.
Per creare la mappatura:
Torna a Provisioning → Mappature → Provisioning degli utenti Microsoft Entra ID.
Nell'angolo in basso a sinistra, fai clic su Aggiungi nuova mappatura.
Configura la mappatura in base al tipo selezionato — vedi le indicazioni di seguito.
Fai clic sulla Attributo di destinazione menu a discesa e Seleziona l'attributo dichiarato nel Passaggio 1.
Fai clic sulla Abbina gli oggetti usando questo attributo menu a discesa e Seleziona No. Nota: Gli attributi personalizzati di Zoom sono valori di configurazione, non chiavi di corrispondenza dell'identità. Solo l'attributo che mette in corrispondenza gli utenti Entra con gli utenti Zoom — in genere
Nome utente— dovrebbe essere impostato su Sì.Fai clic sulla Applica questa mappatura menu a discesa e Seleziona Sempre, così il valore si applica sia alla creazione sia agli aggiornamenti successivi.
Fai clic su OK.
Ripeti per ogni attributo, quindi fai clic su Salva in alto nel Mappatura attributi pagina.
La mappatura diretta trasmette un campo esistente senza trasformazioni
Tipo di mappatura: Diretta
Attributo di origine: Un campo di Entra il cui valore corrisponde già esattamente a ciò che Zoom si aspetta, carattere per carattere
Valore predefinito se nullo (Facoltativo): Un fallback applicato quando il campo di origine è vuoto
La mappatura diretta è l'opzione meno fragile e dovrebbe essere preferita ovunque i dati della directory la supportino. Se physicalDeliveryOfficeName — esposto come Posizione ufficio nel profilo utente di Entra — contiene già valori che corrispondono esattamente ai nomi delle sedi di Zoom Phone, mapparlo direttamente non richiede alcuna logica.
La mappatura costante applica un valore all'intera popolazione nell'ambito
Tipo di mappatura: Costante
Valore costante: Il valore fisso da inviare
La mappatura costante si adatta alle distribuzioni a configurazione singola ed è anche il meccanismo alla base di diversi comportamenti specifici di Zoom. Impostare zoomPhoneExtNumber su un valore costante di 0 istruisce Zoom ad assegnare il successivo interno disponibile all'interno della sede dell'utente, eliminando del tutto le collisioni di interni.
La mappatura espressione traduce o ricava un valore al momento del provisioning
Tipo di mappatura: Espressione
Espressione: Una nidificata
IIF()istruzione che valuta uno o più attributi di origine
La mappatura espressione è richiesta ogni volta che il valore della directory e il valore di Zoom non sono la stessa stringa:
Racchiudi i valori di origine in ToUpper() e confrontali con letterali in maiuscolo per neutralizzare le incoerenze di maiuscole/minuscole:
Il formato del campo di origine varia in base a come è stato creato l'utente di Entra
Questa è la causa più comune di mappature espressione che sembrano corrette ma si comportano in modo incoerente su una popolazione.
Posizione di utilizzo è imposto da Microsoft affinché contenga sempre un codice ISO 3166-1 alpha-2 valido, ad esempio
GB, perché regola la disponibilità di licenze e funzionalità. Questo campo è affidabile.Paese o regione non è soggetto a tale imposizione e il suo contenuto dipende dal metodo di creazione. Gli utenti creati tramite l'interfaccia grafica del portale amministratori di Entra selezionano da un menu a discesa di nomi completi dei paesi, quindi il campo in genere memorizza
Regno Unito. Gli utenti creati tramite importazione CSV o PowerShell sono in genere popolati conGB— per convenzione, non per imposizione.
In qualsiasi tenant in cui gli utenti siano stati creati con più di un metodo, paese non manterrà un formato coerente. Standardizza il campo prima di costruire l'espressione, oppure verifica esplicitamente entrambi i formati come mostrato sopra.
Passaggio 3: porta utenti e gruppi nell'ambito del provisioning
L'assegnazione determina quali utenti vengono toccati dalla configurazione. Gli utenti al di fuori dell'ambito di assegnazione dell'applicazione non sono mai interessati da alcuna mappatura, il che rende l'assegnazione il principale controllo di sicurezza durante il rollout.
Vai a Microsoft Entra ID → Applicazioni Enterprise → la tua applicazione Zoom → Utenti e gruppi.
Fai clic su Aggiungi utente/gruppo.
Sotto Utenti e gruppi, seleziona l'utente o il gruppo di sicurezza previsto.
Sotto Seleziona un ruolo, scegli il Ruolo appropriato.
Fai clic su Assegna.
In pratica contano solo due valori di Ruolo. Altre opzioni come Corp e Pro sono nomi legacy in fase di eliminazione oppure destinati a scenari poco comuni.
Basic
Effettua il provisioning dell'utente senza una licenza per riunione a pagamento. Seleziona questo quando un attributo personalizzato — come un piano di chiamate Zoom Phone — è responsabile dell'assegnazione del diritto a pagamento.
Concesso in licenza
Assegna il piano di licenza dell'account Zoom predefinito piano di licenza, ad esempio Zoom Workplace Enterprise Plus. Questa schermata non consente di scegliere un bundle specifico; il valore predefinito è configurato sul lato Zoom.
Questa selezione del Ruolo si applica una sola volta per utente o gruppo aggiunto all'applicazione, indipendentemente dal numero di attributi personalizzati che vengono sottoposti a provisioning.
Per effettuare il provisioning dei gruppi Entra come gruppi Zoom, che è disattivato per impostazione predefinita:
Vai a Provisioning → Mappature e seleziona Effettua il provisioning dei gruppi Microsoft Entra ID.
Attiva/disattiva Abilitato a Sì.
Conferma che le mappature predefinite siano presenti:
displayName→displayName, emembri→membri.Fai clic su Salva.
Torna a Utenti e gruppi e conferma che il gruppo stesso sia assegnato all'applicazione, non solo i singoli membri. Il provisioning dei gruppi elabora solo i gruppi assegnati direttamente.
Passaggio 4: convalida con Provision on Demand
Provision on Demand viene eseguito indipendentemente dal Stato del provisioning Attiva/disattiva, ed è proprio per questo che è lo strumento corretto per la convalida. Ogni passaggio fino a questo punto — incluso questo — può essere completato mentre il provisioning rimane disattivato.
Vai a Provisioning → Panoramica del provisioning.
Fai clic su Provision on Demand.
Cerca e seleziona un singolo utente di test, quindi fai clic su Effettua il provisioning.
Rivedi il risultato. Entra segnala le quattro fasi che esegue per ogni evento di provisioning — Importa, Determina se è nell'ambito, Corrispondenza, e Effettua il provisioning — ognuna espandibile singolarmente.
Conferma che i valori degli attributi visualizzati corrispondano alle tue intenzioni.
Accedi al Zoom web portal e conferma che la configurazione sia stata applicata.
Passaggio 5: Abilita il provisioning continuo
Abilita il provisioning, rendendo la configurazione effettiva per ogni utente nell'ambito. Completa e verifica prima i Passaggi 1 a 4.
Vai a Microsoft Entra ID → Applicazioni Enterprise → la tua applicazione Zoom → Provisioning → Provisioning.
Attiva/disattiva Stato del provisioning a Attivo.
Fai clic su Salva.
Il primo ciclo può richiedere fino a circa 40 minuti. I cicli incrementali successivi vengono eseguiti a intervalli di circa 40 minuti. I nuovi utenti, le modifiche degli attributi e le disattivazioni si sincronizzano in base a quella Pianificare anziché immediatamente.
Passaggio 6: Verifica usando i log di provisioning di Entra
Vai a Microsoft Entra ID → Applicazioni Enterprise → la tua applicazione Zoom → Monitora → Log di provisioning.
Cerca o filtra per l'utente di test, quindi Seleziona l'Evento pertinente. La vista dei dettagli si apre con quattro schede: Passaggi, Risoluzione dei problemi e raccomandazioni, Proprietà modificate, e Riepilogo.
Esamina la Riepilogo per confermare se l'azione è riuscita o è fallita.
Se è fallita, apri Risoluzione dei problemi e raccomandazioni, che mostra l'azione tentata, il nome principale dell'utente interessato e — sotto Dettagli — il codice di errore e il messaggio di errore completo restituito dalle API di Zoom.
Questo è più affidabile dell'ispezione dello schermo di mapping perché Mostra i valori letterali trasmessi anziché ciò che la mappatura doveva produrre. Se il log di Entra non è conclusivo, passa ai log delle chiamate di Zoom App Marketplace descritti sotto Verifica lato Zoom e errori comuni, che mostrano lo scambio grezzo di richiesta e risposta.
Comportamento di Onboarding e offboarding in Entra ID
L'ambito è il principale controllo di sicurezza. Gli utenti al di fuori dell'ambito di assegnazione dell'applicazione non vengono mai modificati da alcuna mappatura in questa configurazione.
La disattivazione di un utente in Entra, o la sua rimozione dall'ambito, inverte automaticamente il provisioning e chiude il ciclo di offboarding.
Ogni errore produce una voce di log corrispondente — con la riserva sul fallimento silenzioso citata sopra.
Passaggio 7: Applica gli scenari di riferimento in Entra ID
Gli scenari, i prerequisiti e le definizioni degli attributi si trovano nella Scenari di riferimento sezione. Qui sono riportate solo le mappature di Entra.
Scenario 0 — Dipartimento. Al Passaggio 1, dichiara urn:ietf:params:scim:schemas:extension:enterprise:2.0:utente:dipartimento come Stringa, avendo cura di usare lo spazio dei nomi enterprise anziché quello di Zoom. Mappalo come Diretta dal campo Entra department campo. Nessun Valore predefinito se nullo è necessario — un campo di origine vuoto semplicemente non invia nulla, e non deve esistere alcun oggetto lato Zoom.
Scenario 1 — sede di Zoom Phone e interno automatico. Mappa zoomPhoneSite come Diretta da physicalDeliveryOfficeName, con Valore predefinito se nullo impostato su Sede principale. Mappa zoomPhoneExtNumber come Costante con un valore di 0 a meno che tu non stia migrando una configurazione di interni già esistente. Quando i valori della Posizione dell'ufficio non corrispondono esattamente ai nomi delle sedi Zoom, sostituisci una Espressione mappatura nel formato mostrato nel Passaggio 2.
Scenario 2 — piano di chiamate variabile in base al paese. Poiché Entra non può ricavare un valore da un gruppo, è necessaria un'espressione. Estendila con ulteriori IIF() livelli per paese, e considera sia il formato alpha-2 sia quello in testo completo come descritto nel Passaggio 2:
Laddove l'attributo del piano di chiamate assegna l'idoneità a pagamento, Seleziona Basic anziché Concesso in licenza nel Passaggio 3. Seleziona Concesso in licenza applica inoltre la licenza predefinita dell'account, il che potrebbe non essere il risultato commerciale previsto.
Scenario 3 — Pacchetto centro di contatto, Ruolo e regione. Mappa zoomContactCenterPackage con un Espressione guidato da un campo della directory che distingue i livelli degli agenti, e zoomContactCenterRole come Diretta da un campo che contiene il nome del Ruolo. Lascia zoomContactCenterRegion non mappato nelle distribuzioni a singola regione.
Configurazione di SCIM con Okta
Requisiti aggiuntivi per Okta
Privilegi di amministratore di Okta con accesso al Profile Editor
Limitazioni aggiuntive in Okta
Dove un utente appartiene a più gruppi che forniscono valori in conflitto per lo stesso attributo, viene trasmesso solo il valore del gruppo con la priorità più alta. Vedi il Passaggio 5.
Passaggio 1: Dichiarare l'attributo nel profilo utente dell'applicazione Zoom
Questo è l'attributo che trasmette effettivamente un valore a Zoom. La sua dichiarazione è un'azione una tantum per attributo.
Accedi alla console amministratori di Okta.
Nel menu di navigazione a sinistra, fai clic su Applicazioni, quindi fai clic Applicazioni.
Sotto STATO, fai clic ATTIVA.
Fai clic sulla Zoom applicazione. Nota: Il nome dell'applicazione è definito dall'amministratore di Okta quando l'applicazione viene creata. Viene spesso chiamata Zoom, ma potrebbe essere diverso nel tuo tenant.
Fai clic sulla Provisioning scheda.
Sotto Mappature degli attributi di Zoom, fai clic Vai a Profile Editor.
Sotto Attributi, fai clic + Aggiungi attributo.
Completa quanto segue:
Tipo di dato: Seleziona stringa o booleano, in linea con il riferimento dell'API SCIM2.
Nome da mostrare: Inserisci il nome dell'attributo, ad esempio
zoomPhoneSite.Nome variabile: Inserisci lo stesso nome.
Nome esterno: Inserisci il nome dell'attributo esattamente come documentato da Zoom, ad esempio
zoomPhoneSite.Spazio dei nomi esterno: Inserisci
urn:ietf:params:scim:schemas:extension:zoom:1.0:utente:zoomPhoneSiteDescrizione (Facoltativo): Registra perché l'attributo esiste e da dove provengono i suoi valori.
Tipo di attributo: Seleziona Personale per un valore per utente, oppure gruppo per un valore ereditato tramite l'appartenenza al gruppo.
Fai clic su Salva, oppure Salva e Aggiungi un altro.
Passaggio 2: crea un attributo di origine nel profilo utente di Okta
Completa questo passaggio in cui il valore è mantenuto per utente. Saltalo se il valore è identico per ogni utente, oppure se verrà fornito invece a livello di gruppo.
Nel menu di navigazione a sinistra, fai clic su Rubrica, quindi fai clic Editor del profilo.
Fai clic sulla Utenti scheda.
Nel Utenti scatola, sotto Filtri, fai clic Tutti.
A destra di Okta, fai clic su Utente profilo.
Sotto Attributi, fai clic + Aggiungi attributo.
Completa quanto segue:
Tipo di dato: Abbina l'attributo Zoom dichiarato nel Passo 1.
Nome da mostrare e Nome variabile: inserire un nome, ad esempio
zoomPhoneSite.Enum (Facoltativo): Seleziona Definisci un elenco enumerato di valori in cui l'attributo Zoom accetta solo un insieme fisso di valori.
Attributo obbligatorio (Facoltativo): Seleziona Sì in cui ogni utente nell'ambito deve avere un valore.
Fai clic su Salva.
Usa l' Enum opzione ogni volta che Zoom documenta un insieme fisso di valori — pacchetti centro di contatto, codici del bundle Workplace, valori del piano Revenue Accelerator. Limitare il campo al momento dell'inserimento impedisce che un refuso diventi un errore silenzioso di provisioning che emerge settimane dopo come un'autorizzazione mancante.
Passaggio 3: Mappa l'attributo di origine all'attributo Zoom
Vai a Applicazioni → Applicazioni → ATTIVA → il Zoom applicazione.
Fai clic sulla Provisioning scheda.
Sotto Mappature degli attributi di Zoom, individua l'attributo dichiarato nel Passaggio 1 e fai clic sull'icona di modifica alla sua destra. Nota: Se l'attributo non è visibile, fai clic Mostra attributi non mappati.
Fai clic sulla Valore dell'attributo menu a discesa e Seleziona Mappa dal profilo Okta.
Fai clic sul menu a discesa della sorgente — che visualizza
login | stringper impostazione predefinita — e Seleziona l'attributo del profilo utente Okta creato nel Passaggio 2.Seleziona Crea e aggiorna. Nota: Crea solo applica il valore quando l'utente Zoom viene sottoposto a provisioning per la prima volta e mai più. Seleziona deliberatamente questa opzione per i valori che non devono essere sovrascritti dopo l'assegnazione iniziale; Seleziona Crea e aggiorna in tutti gli altri casi, in modo che le modifiche alla directory si propaghino.
Fai clic su Salva.
Ripeti per ogni attributo.
Passaggio 4: Abilita il provisioning per l'applicazione
Le mappature degli attributi non hanno effetto finché le operazioni di provisioning corrispondenti non sono attive. Abilita queste operazioni prima di assegnare i valori nel Passaggio 5.
Vai a Applicazioni → Applicazioni → ATTIVA → il Zoom applicazione.
Fai clic sulla Provisioning scheda.
Sotto Provisioning nell'app, fai clic Modifica.
Abilita le Impostazioni descritte di seguito, quindi fai clic su Salva.
Crea utenti
Crea o collega un utente in Zoom quando l'applicazione viene assegnata a un utente in Okta.
Aggiorna gli attributi utente
Aggiorna gli attributi di un utente in Zoom quando l'applicazione viene assegnata. Le modifiche successive al profilo utente di Okta sovrascrivono automaticamente il valore corrispondente in Zoom.
Disattiva utenti
Disattiva l'account Zoom quando l'applicazione non è più assegnata in Okta, oppure quando l'account Okta viene disattivato. Gli account possono essere riattivati riassegnando l'applicazione.
Passaggio 5: Assegna valori agli utenti o ai gruppi
Per assegnare un valore a un singolo utente:
Vai a Rubrica → Persone e fai clic sul nome dell'utente.
Fai clic sulla Profilo scheda, quindi fai clic su Modifica.
Popola l'attributo creato nel Passaggio 2 con il valore che Zoom si aspetta.
Fai clic su Salva.
Il valore viene trasmesso tempestivamente. Conferma il risultato nel Zoom web portal prima di applicare la stessa Modifica su scala più ampia.
Per assegnare un valore a un gruppo — il modello più scalabile in cui la configurazione segue la struttura organizzativa:
Conferma che l'attributo sia stato dichiarato nel Passaggio 1 con Tipo di attributo: gruppo. Se è stato dichiarato come Personale, dichiara un equivalente a livello di gruppo ripetendo il Passaggio 1 contro il Utente Zoom profilo sotto Rubrica → Editor del profilo → Utenti → Tutti, selezionando gruppo come tipo di attributo.
Vai a Rubrica → Gruppi → il Tutti scheda, quindi fai clic su Aggiungi gruppo.
Inserisci un Nome e Facoltativo Descrizione, quindi fai clic Salva.
Apri il gruppo e fai clic su Applicazioni scheda.
Fai clic su Assegna applicazione, quindi fai clic Assegna a destra di Zoom applicazione.
Popola gli attributi a livello di gruppo con i valori che dovrebbero applicarsi a tutti i Membri.
Fai clic su Salva e torna indietro, quindi fai clic Fatto.
Fai clic sul gruppo Persone scheda, quindi fai clic su Assegna Membri.
Cerca gli utenti per nome, indirizzo e-mail principale o Nome utente, e fai clic sul pulsante Aggiungi accanto a ciascuno.
Fai clic su Fatto.
I Membri ereditano automaticamente i valori degli attributi del gruppo. Gli utenti aggiunti in seguito li ereditano al momento dell'adesione, il che rende questo modello duraturo per l'Onboarding continuo anziché per un esercizio di migrazione una tantum.
La priorità del gruppo risolve i valori in conflitto quando un utente appartiene a diversi gruppi
Quando un utente è membro di più di un gruppo che fornisce un valore per lo stesso attributo, Okta trasmette il valore dal gruppo con la priorità più alta.
Vai a Applicazioni → Applicazioni → ATTIVA → il Zoom applicazione.
Fai clic sulla Assegnazioni scheda.
Sotto Filtri, fai clic Gruppi.
Trascina e rilascia i gruppi nell'ordine desiderato.
Passaggio 6: Verifica usando il Registro di sistema di Okta
Vai a Rapporti → Registro di sistema.
Filtra per l'utente di destinazione o per l'applicazione Zoom e restringi l'intervallo di tempo al tentativo di provisioning.
Apri il relativo Evento e rivedi il dettaglio, che include l'esito e qualsiasi errore restituito dall'applicazione a valle.
Gli errori di provisioning non risolti compaiono anche nella scheda dell'applicazione Zoom Provisioning scheda. Se il log di Okta non è conclusivo, passa ai registri delle chiamate di Zoom App Marketplace descritti sotto Verifica lato Zoom e errori comuni, che mostrano lo scambio grezzo di richiesta e risposta.
Comportamento di Onboarding e offboarding in Okta
L'ambito è il principale controllo di sicurezza. Gli utenti a cui non è assegnata l'applicazione Zoom in Okta non vengono mai modificati da alcuna mappatura in questa configurazione.
Con Disattiva utenti abilitato, la rimozione dell'assegnazione dell'applicazione o la disattivazione dell'account Okta disattiva automaticamente l'account Zoom.
La riassegnazione dell'applicazione riattiva un account Zoom precedentemente disattivato, il che rende l'appartenenza al gruppo un meccanismo valido per gestire chi lascia e chi rientra.
Passaggio 7: Applica gli scenari di riferimento in Okta
Gli scenari, i prerequisiti e le definizioni degli attributi si trovano nella Scenari di riferimento sezione. Qui viene fornita solo la configurazione di Okta.
Scenario 0 — Dipartimento. Nel Passaggio 1, dichiara l'attributo con Nome da mostrare e Nome variabile department, Nome esterno department, e Spazio dei nomi esterno urn:ietf:params:scim:schemas:extension:enterprise:2.0:utente. Usa Tipo di attributo: Personale. Il profilo utente di base di Okta contiene già un department attributo, quindi il Passaggio 2 può essere saltato — mappalo direttamente da lì al Passaggio 3, selezionando Crea e aggiorna.
Alternative se department è già mappato. Ognuno dei seguenti si comporta in modo identico, si colloca sotto lo stesso elemento padre e non comporta precondizioni — sostituisci il nome dell'attributo sia nel Nome esterno e nello spazio dei nomi, e Aggiungi un attributo sorgente corrispondente al Passaggio 2 se il profilo di Okta non ne contiene già uno:
centro di costo
Campo Business, varia tra gli utenti quindi un valore errato è visibile
Organizzazione
Spesso identico per tutti gli utenti, il che rende più difficile individuare un errore
employeeNumber
Spesso già mappato come campo di identità — controlla prima di dichiararlo
pronomi
Si trova sotto il Zoom estensione anziché quella Enterprise, quindi usa lo stesso spazio dei nomi di ogni altro scenario in questa guida ed evita completamente la questione del formato sopra
Scenario 1 — sede di Zoom Phone e interno automatico. Dichiara zoomPhoneSite con Tipo di attributo: gruppo e imposta il suo valore nel gruppo Okta di ogni sede, così l'appartenenza al gruppo determina direttamente la sede e non è necessaria alcuna logica di traduzione. Dichiara zoomPhoneExtNumber come attributo personale con un valore predefinito di 0 a meno che tu non stia migrando una configurazione preesistente di estensioni.
Scenario 2 — piano di chiamate variabile in base al paese. Dichiara zoomPhoneCallingPlan con Tipo di attributo: gruppo e crea un gruppo per ogni regione del piano di chiamate, impostando il valore del piano sull'assegnazione dell'applicazione Zoom di ciascun gruppo. Gli utenti ereditano il piano corretto tramite l'appartenenza al gruppo, e il valore archiviato in Okta è il valore esatto che Zoom si aspetta. Questo rende anche la configurazione visibile e verificabile dalla Assegnazioni scheda, e resiste alle incoerenze nel modo in cui sono stati popolati i dati della directory sottostante. Un gruppo che contiene -1 fornisce un modo pulito per revocare i diritti del piano di chiamate senza eliminare l'utente.
Scenario 3 — Pacchetto centro di contatto, Ruolo e regione. Dichiara zoomContactCenterPackage come attributo enumerato limitato ai tre valori consentiti, così un Pacchetto non valido non può mai essere inserito. Dichiara zoomContactCenterRole come attributo a livello di gruppo, poiché il Ruolo generalmente segue la struttura del team. Esci zoomContactCenterRegion non mappato nelle distribuzioni a singola regione.
Risoluzione dei problemi
Errori
L'utente non esiste o non appartiene a questo account
Questo errore si verifica quando l'indirizzo e-mail di un utente target non riesce a essere provisionato a causa di un account già esistente. Gli amministratori Zoom sono incoraggiati a contattare direttamente l'utente e a invitarlo manualmente nell'account.
Non puoi aggiungere utenti a pagamento
Questo errore si verifica quando SCIM tenta di provisionare un utente quando nell'account ci sono licenze insufficienti. Per risolvere l'errore, l'utente deve essere provisionato come utente Basic, oppure deve essere resa disponibile una licenza per il provisioning.
Uso dei log SCIM per risolvere i problemi di provisioning degli utenti
Zoom fornisce i 100 log più recenti delle richieste API nel Zoom Marketplace. Un amministratore Zoom può usare questi log per confermare quali informazioni vengono inviate e ricevute tramite le API di provisioning. Per accedere ai log, accedi a Zoom Marketplace come amministratore Zoom e fai clic su Gestisci. Nella pagina seguente, seleziona Registri delle chiamate in Gestione app personali. Da lì, fai clic su una voce per espandere i log API e rivederne i contenuti.
L'immagine seguente mostra un esempio di una richiesta di provisioning SCIM per un utente, con gli attributi di identità e di licenza dell'utente evidenziati come riferimento.
Come per il mapping delle risposte, Zoom può applicare solo le informazioni inviate dal provider di identità nella richiesta di provisioning. Usa questi log per confermare che gli attributi di identità e di licenza dell'utente vengano inviati dal provider di identità. Se le informazioni previste mancano da queste asserzioni, contatta il tuo provider di identità per ricevere assistenza.
Ultimo aggiornamento
È stato utile?