> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/it/area-admin/account-and-endpoint-management/scim-guide.md). # 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**](#understanding-scim-attributes) 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](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), il [SSO e provisioning di Zoom per Entra ID](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121), e il [articolo SSO di Zoom per Okta](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063256). {% hint style="danger" %} **Avviso** Un provisioning configurato in modo errato influisce sugli utenti esistenti, inclusa la rimozione delle licenze già in uso. Verifica ogni Modifica rispetto a un singolo utente di test prima di applicarla a una popolazione reale. {% endhint %} ### **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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061540) * privilegi di titolare dell'account o admin dell'account Zoom * [Single Sign-On](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060673) abilitato sull'account Zoom * Un [dominio associato verificato](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0066259) 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**](#before-attempting-advanced-mapping-zoom-side-objects-must-exist-before-scim-can-reference-them) 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 utente` l'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: ``` urn:ietf:params:scim:schemas:extension:zoom:1.0:utente:zoomPhoneSite ``` 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**.
ProprietàEstratto dall'esempioCosa fa
Spazio dei nomiurn:ietf:params:scim:schemas:extension:zoom:1.0:utenteIndica 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.
NomezoomPhoneSiteIdentifica 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 datostringaIndica 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 consentitoLON-01, un nome della sede Zoom PhoneL'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.
{% hint style="danger" %} **Avviso** Zoom pubblica più di uno spazio dei nomi delle estensioni utente. Gli attributi di configurazione del prodotto e di licenza usano `urn:ietf:params:scim:schemas:extension:zoom:1.0:utente`, che è lo spazio dei nomi che questa guida usa in tutta la documentazione. Campi enterprise Standard come `department`, `responsabile`, e `centro di costo` usa `urn:ietf:params:scim:schemas:extension:enterprise:2.0:utente`. Un terzo, `urn:us:zoom:scim:schemas:extension:1.0:Zoomutente`, contiene informazioni sul tipo di accesso restituite nelle risposte API anziché configurate durante il provisioning. Un attributo costruito sul namespace sbagliato viene accettato dal tuo provider di identità e ignorato silenziosamente da Zoom. {% endhint %} #### Trova l'attributo di cui hai bisogno nel riferimento API SCIM2 La [riferimento API SCIM2](https://developers.zoom.us/docs/api/scim2/#tag/user/post/scim2/Users) è 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:utente` oggetto. 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 — `zoomPhoneExtNumber` impostato su `0` attiva l'assegnazione automatica dell'interno, `zoomPhoneCallingPlan` impostato su `-1` rimuove tutti i piani di chiamata e `zoomPhoneNumber` deve 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: ``` Genitore urn:ietf:params:scim:schemas:extension:zoom:1.0:utente Due punti : Figlio zoomPhoneSite Identificativo urn:ietf:params:scim:schemas:extension:zoom:1.0:Utente:zoomPhoneSite ``` 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: ``` Base (genitore) urn:ietf:params:scim:schemas:extension:zoom:1.0:utente sede Zoom Phone urn:ietf:params:scim:schemas:extension:zoom:1.0:utente:zoomPhoneSite Numero di Zoom Phone urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneNumber Interno Zoom Phone urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneExtNumber Zoom Phone piano di chiamate urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomPhoneCallingPlan ``` Lo stesso elemento genitore è presente in ogni altro prodotto Zoom. Nulla Info la costruzione cambia quando lo fa il prodotto: ``` Pacchetto centro di contatto urn:ietf:params:scim:schemas:extension:zoom:1.0:utente:zoomContactCenterPacchetto Ruolo di accelerazione dei ricavi urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomRevenueAcceleratorRole Pacchetto Workplace urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomWorkplace Zoom Docs urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomDocs ``` 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](https://library.zoom.com/admin-corner/account-and-endpoint-management/sso-field-guide), 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.
Mappatura BasicMappatura avanzata
Qual è il valoreTesto memorizzato nel profilo dell'utenteUn puntatore a un oggetto in Zoom, oppure un diritto su un posto acquistato
Esempidepartment, titolo, centro di costozoomPhoneSite, zoomContactCenterRole, zoomWorkplace
GenitoreDi livello superiore, oppure l'estensione EnterpriseL'estensione Zoom
Prerequisiti in ZoomNessunoL'oggetto deve esistere, oppure il posto deve essere libero
Se il valore è erratoSu un profilo appare testo erratoL'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: ``` Base (genitore) urn:ietf:params:scim:schemas:extension:Enterprise:2.0:utente Dipartimento urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department Centro di costo urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter Numero dipendente urn:ietf:params:scim:schemas:extension:Enterprise:2.0:utente:dipendenteNumber Organizzazione urn:ietf:params:scim:schemas:extension:Enterprise:2.0:utente:Organizzazione Responsabile urn:ietf:params:scim:schemas:extension:enterprise:2.0:utente:manager ``` Popolare Dipartimento e Centro di costo tramite SCIM non richiede più il mapping SAML. {% hint style="info" %} **Raccomandazione** Mappa prima un attributo Basic — `department` è un buon candidato, e viene trattato come **Scenario 0** negli scenari di riferimento — ed eseguilo dall'inizio alla fine per un singolo utente di test prima di configurare qualsiasi cosa sotto l'estensione Zoom. Un `department` un valore che appare correttamente in un profilo Zoom dimostra la dichiarazione dello schema, la mappatura, l'ambito e la tua capacità di leggere i log di provisioning. Ogni attributo avanzato che segue differisce solo in ciò a cui punta, non in come viene configurato. {% endhint %} #### 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.
LivelloScopoMicrosoft Entra IDOkta
1. DichiaraIndica al provider di identità che l'attributo esiste sull'applicazione Zoom così diventa Disponibile come destinazione di mapping.Fase 1Fase 1
2. MappaDefinisci da dove proviene il valore.Fase 2Passaggi 2–3
3. AmbitoDetermina a quali utenti si applica la configurazione e quando viene eseguita.Passaggi 3–5Passaggi 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**](https://zoom.com/account) → [**Sicurezza e fiducia**](https://zoom.com/account/setting/security), e gestisci i Domini associati in [**Centro admin**](https://zoom.com/account) → **Account** → [**profilo dell'account**](https://zoom.com/account); vedi [configurazione SSO/SCIM di Zoom + Microsoft Entra ID](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064121). 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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064911). * **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. | Attributo | Cosa deve già esistere | Come crearlo | | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929). | | `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](https://zoom.com/account) → Configurazione del prodotto → sistema telefonico → [Informazioni sull'azienda](https://zoom.com/pbx/page/telephone/settings#/settings) → **Aggiungi sede**, oppure **Importa** per la creazione in blocco. Vedi [Gestione dei Siti multipli](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069716). | | `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](https://zoom.com/account) → Configurazione del prodotto → Numeri → [Numeri telefonici](https://zoom.com/cpw/page/phoneNumbers#/number-list). 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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0074457) e [Gestione dei Numeri telefonici](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060212). | | `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](https://zoom.com/account) → Configurazione del prodotto → sistema telefonico → [Utenti e stanze](https://zoom.com/pbx/page/telephone/phoneUsers#/users) → Seleziona l'oggetto che contiene il numero interno → **Profilo** → **Numero interno** → **Modifica**. Vedi [Modifica delle Impostazioni dell'utente telefonico](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069338). | | `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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077929) e [Gestione degli utenti telefonici](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0069309). I codici di piano sono elencati nel [riferimento al piano di chiamate di Zoom Phone](https://developers.zoom.us/docs/api/references/phone-calling-plans/), o restituiti come `tipo` dal [Elenca i piani di chiamate](https://developers.zoom.us/docs/api/references/phone-calling-plans/) 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. | Attributo | Cosa deve già esistere | Come crearlo | | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060874). | | `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](https://zoom.com/account) → gestione CX → centro di contatto → [Ruoli](https://zoom.com/cci/index/admin#/admin-next/admin-roles) → **Aggiungi** → Configura autorizzazioni → **Salva**. Vedi [Gestione dei ruoli del centro di contatto Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0061941). | | `zoomContactCenterRegion` | La regione. Se omessa, assegna la regione principale dell'account, che deve essere configurata. | [Centro admin](https://zoom.com/account) → gestione CX → centro di contatto → [Preferenze](https://zoom.com/cci/index/admin#/admin-preferences) → Regioni → **Aggiungi regione** → inserire un nome e Seleziona una zona SIP → **Aggiungi**. Vedi [Gestione delle regioni del centro di contatto Zoom](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0057668). | | `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](https://zoom.com/account) → gestione CX → centro di contatto → Utenti → [Modelli](https://zoom.com/cci/index/admin#/admin-agents#templates) → **Aggiungi modello** → Scegli **Aggiungi** → Configura ruoli, pacchetti, code e competenze → **Aggiungi**. Vedi [Gestione del modello Impostazioni utente di Zoom centro di contatto](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0077757). | {% hint style="danger" %} **Avviso** La funzionalità regioni del centro di contatto deve essere abilitata da Assistenza Zoom prima che le regioni possano essere create e ogni utente appartiene a una sola regione. Poiché si tratta di una richiesta di assistenza e non di un'Attiva/disattiva self-service, segnalarla tempestivamente se è prevista una distribuzione multi-regione. {% endhint %} **Le caselle di posta in arrivo, le code e le competenze non hanno alcun attributo SCIM.** Per eseguirne il provisioning, preconfigurali in [Centro admin](https://zoom.com/account) → 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.
OggettoCome crearlo
CodaCentro admin → gestione CX → centro di contatto → Code → Aggiungi coda → nome, canale, agenti → Salva. Vedi Gestione delle code di Zoom centro di contatto.
CompetenzaCentro 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 arrivoCentro 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 | Attributo | Cosa deve già esistere | Come crearlo | | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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](https://zoom.com/account) → Utenti → [Ruoli](https://zoom.com/role#/) → **Zoom Revenue Accelerator** scheda → **+ Aggiungi Ruolo** → nome e descrizione → **Aggiungi** → Configura autorizzazioni → **Salva le modifiche**. Vedi [Utilizzo della Gestione ruoli di Zoom Revenue Accelerator](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0059285). | | `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. | Attributo | Cosa deve già esistere | Come crearlo | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ruoli[]` (`valore` / `mostrare`) | Il Ruolo dell'account, denominato esattamente. I Ruoli sono referenziati da SCIM, mai creati da esso. | [Centro admin](https://zoom.com/account) → Utenti → [Ruoli](https://zoom.com/role#/) → **Aggiungi Ruolo** → nome e descrizione → Configura autorizzazioni. Vedi [Utilizzando la Gestione ruoli](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0064983). | | `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](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0063375). | | `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](https://zoom.com/account) → Sicurezza e fiducia → [Single Sign-On](https://zoom.com/account/sso/saml). | 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** — `zoomPhoneExtNumber` inviato come `0`, 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](https://zoom.com/account) → Utenti → [Gruppi](https://zoom.com/account/group#/) dopo che il gruppo appare. {% hint style="info" %} **Raccomandazione** Considera la configurazione sul lato Zoom come una fase preliminare con una propria approvazione finale, completata e verificata prima che inizi il lavoro di mappatura degli attributi. Sedi, numeri, piani, Ruoli e modelli sono spesso gestiti da un team diverso da quello della configurazione del provider di identità, e scoprire un oggetto mancante durante il testing del provisioning costa molto di più che confermarne l'esistenza in anticipo. {% endhint %} ### **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. {% hint style="info" %} **Raccomandazione** Decidi la fonte di verità prima di toccare la configurazione del provider di identità. La maggior parte delle implementazioni SCIM fallite sono problemi dei dati della directory presentati come problemi di provisioning. {% endhint %} ### **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. | Attributo | Tipo | Note | | --------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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**](https://zoom.com/account) → **Configurazione del prodotto** → **sistema telefonico** → [**Informazioni sull'azienda**](https://zoom.com/pbx/page/telephone/settings#/settings) → **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. | Attributo | Tipo | Note | | -------------------- | ------- | --------------------------------------------------------------------- | | `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. {% hint style="info" %} **Nota** La sede predefinita in un account Zoom Phone è in genere chiamata esattamente `Sede principale`, visibile sotto [**Centro admin**](https://zoom.com/account) → **Configurazione del prodotto** → **sistema telefonico** → [**Informazioni sull'azienda**](https://zoom.com/pbx/page/telephone/settings#/settings). Conferma il nome sull'account specifico prima di farvi affidamento, poiché può essere rinominato. {% endhint %} #### 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](https://developers.zoom.us/docs/api/references/phone-calling-plans/). **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](https://developers.zoom.us/docs/api/references/phone-calling-plans/) 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](https://developers.zoom.us/docs/api/references/phone-calling-plans/) — 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. | Attributo | Tipo | 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 1. Accedi al Zoom web portal come titolare dell'account. 2. Vai alla [**Zoom App Marketplace**](https://marketplace.zoom.us/) → **Gestisci** → **App sull'account**. 3. Seleziona l'applicazione che rappresenta la connessione del provider di identità. Per Entra, in genere si chiama **Azure Identity** o simile. 4. Apri il **Log di chiamare** scheda. 5. Usa **Cerca per endpoint**, oppure i filtri intervallo di date, metodo e stato, per individuare la chiamare pertinente. 6. Seleziona la riga per espanderla. 7. Rivedi `requestBody` per vedere esattamente cosa è stato inviato, e `risposta` per 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
CodiceMessaggioCausa e soluzione
400L'account non ha abilitato Single Sign-On.SSO è un prerequisito per SCIM. Abilita e Configura prima SSO sull'account Zoom.
400L'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.
403La 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.
404L'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.
409Il 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.
409Impossibile Aggiungi utenti a pagamento.Nessuna licenza del tipo richiesto è disponibile. Capacità libera sull'account, oppure eseguire il provisioning dell'utente come Basic.
409Impossibile 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.
429Troppe 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. {% hint style="info" %} **Nota** Quando Zoom e il provider di identità non sono d'accordo sulla configurazione di un utente, considerare il provider di identità come autorevole e correggere lì il valore. La modifica direttamente nel Zoom web portal produce uno stato che il successivo evento di provisioning sovrascrive, rendendo più difficile diagnosticare il problema di fondo. {% endhint %} ## **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 `Collaborazione` valore di `tipo utente` non è supportato con Entra ID a causa di una limitazione specifica di Microsoft. {% hint style="info" %} **Nota** La configurazione di provisioning Standard può essere eseguita da uno dei seguenti `entra.microsoft.com` o `portal.azure.com`. L'editor dello schema usato nel Passaggio 1, tuttavia, è raggiungibile solo tramite l'URL del Portale Azure con il `forceSchemaEditorEnabled` parametro aggiunto. Questo flag non ha alcun effetto su `entra.microsoft.com`. Usa il collegamento del Portale Azure nel Passaggio 1 per tutti i passaggi di questa parte per evitare di cambiare portale a metà configurazione. {% endhint %} ### 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. 1. Accedi al Portale Azure usando l'URL dell'editor dello schema: `https://portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#home` 2. Sotto **Servizi Azure**, Seleziona **Microsoft Entra ID**. 3. Nel menu di navigazione a sinistra, sotto **Gestisci**, fai clic **Applicazioni Enterprise**. 4. 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. 5. 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. 6. 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**. 7. Nell'angolo in basso a sinistra, Seleziona il **Mostra opzioni avanzate** casella di controllo. 8. Fai clic su **Modifica elenco attributi per Zoom**. 9. 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:zoomPhoneSite` * **Tipo**: Seleziona **Stringa** o **Booleano**, corrispondente al tipo di dati documentato nel riferimento API SCIM2. 10. Ripeti il passaggio 9 per ogni attributo aggiuntivo. 11. Nell'angolo in alto a sinistra, fai clic su **Salva**. {% hint style="warning" %} **Attenzione** I nomi degli attributi fanno distinzione tra maiuscole e minuscole e devono corrispondere esattamente al riferimento API. `zoomPhoneSite` è valido; `zoomphonesite` e `ZoomPhoneSite` non lo sono. Un attributo con maiuscole/minuscole errate viene accettato dall'editor dello schema senza errori e fallisce in silenzio nell'API Zoom. Per gli attributi documentati come `booleano`, **Stringa** è valido anche, a condizione che la sorgente mappata fornisca il testo letterale `true` o `false`. Selezionando **Stringa** è spesso più pratico quando la sorgente è un attributo di estensione Entra, che memorizza testo. {% endhint %} ### 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.
Tipo di mappaturaDa usare quandoComportamento
DirettaUn campo Entra contiene già il valore esatto che Zoom si aspetta.Trasmette il valore di origine invariato.
CostanteOgni utente nell'ambito dovrebbe ricevere lo stesso valore.Invia un valore fisso a ogni utente provisionato.
EspressioneIl 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:** 1. Torna a **Provisioning** → **Mappature** → **Provisioning degli utenti Microsoft Entra ID**. 2. Nell'angolo in basso a sinistra, fai clic su **Aggiungi nuova mappatura**. 3. Configura la mappatura in base al tipo selezionato — vedi le indicazioni di seguito. 4. Fai clic sulla **Attributo di destinazione** menu a discesa e Seleziona l'attributo dichiarato nel Passaggio 1. 5. 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ì**. 6. Fai clic sulla **Applica questa mappatura** menu a discesa e Seleziona **Sempre**, così il valore si applica sia alla creazione sia agli aggiornamenti successivi. 7. Fai clic su **OK**. 8. 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. {% hint style="info" icon="lightbulb" %} **Suggerimento** Popola **Valore predefinito se nullo** ogni volta che un valore di origine mancante causerebbe un errore o un risultato indesiderato. Un valore predefinito di `Sede principale` in una mappatura della sede garantisce che gli utenti senza una posizione dell'ufficio vengano comunque provisionati correttamente anziché finire in uno stato indefinito. {% endhint %} #### 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: ``` IIF([officeLocation]="London","LON-01", IIF([officeLocation]="Manchester","MAN-01", "Sede principale")) ``` {% hint style="danger" %} **Avviso** Le espressioni confrontano il testo esattamente come digitato, inclusa la maiuscola/minuscola. `GB` e `gb` sono valori diversi, così come `Regno Unito` e `regno unito`. Un confronto che fallisce non genera un errore — passa al ramo predefinito, e l'utente viene provisionato con la configurazione sbagliata senza alcun avviso. {% endhint %} Racchiudi i valori di origine in `ToUpper()` e confrontali con letterali in maiuscolo per neutralizzare le incoerenze di maiuscole/minuscole: ``` IIF(ToUpper([country])="GB","202", IIF(ToUpper([country])="UNITED KINGDOM","202", "-1")) ``` #### 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 con `GB` — 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. 1. Vai a **Microsoft Entra ID** → **Applicazioni Enterprise** → la tua applicazione Zoom → **Utenti e gruppi**. 2. Fai clic su **Aggiungi utente/gruppo**. 3. Sotto **Utenti e gruppi**, seleziona l'utente o il gruppo di sicurezza previsto. 4. Sotto **Seleziona un ruolo**, scegli il Ruolo appropriato. 5. 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.
RuoloEffetto
BasicEffettua 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 licenzaAssegna 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: 1. Vai a **Provisioning** → **Mappature** e seleziona **Effettua il provisioning dei gruppi Microsoft Entra ID**. 2. Attiva/disattiva **Abilitato** a **Sì**. 3. Conferma che le mappature predefinite siano presenti: `displayName` → `displayName`, e `membri` → `membri`. 4. Fai clic su **Salva**. 5. 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. {% hint style="warning" %} **Attenzione: cosa SCIM fa e non fa con i gruppi** Se un gruppo Zoom con un nome corrispondente non esiste già, SCIM ne crea uno usando il gruppo di Entra `displayName` esattamente come digitato. Il gruppo viene creato con i membri ma **senza alcuna configurazione del prodotto**. Un amministratore deve comunque aprire [**Centro admin**](https://zoom.com/account) → **Utenti** → [**Gruppi**](https://zoom.com/account/group#/) nel Zoom web portal e applicare le Impostazioni desiderate — criteri di Zoom Phone a livello di gruppo, autorizzazioni di chiamata o altra configurazione del prodotto. SCIM effettua il provisioning dell'esistenza e dell'appartenenza di un gruppo; non definisce cosa faccia quel gruppo all'interno di Zoom. {% endhint %} ### 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. 1. Vai a **Provisioning** → **Panoramica del provisioning**. 2. Fai clic su **Provision on Demand**. 3. Cerca e seleziona un singolo utente di test, quindi fai clic su **Effettua il provisioning**. 4. 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. 5. Conferma che i valori degli attributi visualizzati corrispondano alle tue intenzioni. 6. Accedi al Zoom web portal e conferma che la configurazione sia stata applicata. {% hint style="info" %} **Raccomandazione** Convalida rispetto a un utente che rappresenta il *più difficile* caso nella tua popolazione — un utente all'estero, un utente creato tramite un metodo diverso o un utente il cui campo di origine è vuoto. Un test che copra solo il caso semplice non farà emergere le modalità di errore descritte nel Passaggio 2. {% endhint %} ### 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. 1. Vai a **Microsoft Entra ID** → **Applicazioni Enterprise** → la tua applicazione Zoom → **Provisioning** → **Provisioning**. 2. Attiva/disattiva **Stato del provisioning** a **Attivo**. 3. 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 1. Vai a **Microsoft Entra ID** → **Applicazioni Enterprise** → la tua applicazione Zoom → **Monitora** → **Log di provisioning**. 2. 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**. 3. Esamina la **Riepilogo** per confermare se l'azione è riuscita o è fallita. 4. 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**](#reference-scenarios) 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: ``` IIF(ToUpper([country])="GB","202", IIF(ToUpper([country])="UNITED KINGDOM","202", IIF(ToUpper([country])="US","200", IIF(ToUpper([country])="UNITED STATES","200", "-1")))) ``` 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. {% hint style="warning" %} **Attenzione: due profili, due scopi** Okta mantiene due profili distinti che contano qui, e comprenderne la separazione previene la maggior parte della confusione iniziale. Il **profilo utente di Okta** è dove un valore viene *memorizzato* associato a una persona nella directory. Il **profilo applicazione utente Zoom** è dove un valore viene *inviato* a Zoom e i relativi attributi riportano il nome esterno e lo spazio dei nomi SCIM. Una configurazione per utente richiede entrambi, più una mappatura di Connessione tra loro. Una configurazione a livello di gruppo richiede solo l'attributo del profilo dell'applicazione, con il valore impostato sull'assegnazione del gruppo. {% endhint %} ### 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. 1. Accedi alla console amministratori di Okta. 2. Nel menu di navigazione a sinistra, fai clic su **Applicazioni**, quindi fai clic **Applicazioni**. 3. Sotto **STATO**, fai clic **ATTIVA**. 4. 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. 5. Fai clic sulla **Provisioning** scheda. 6. Sotto **Mappature degli attributi di Zoom**, fai clic **Vai a Profile Editor**. 7. Sotto **Attributi**, fai clic **+ Aggiungi attributo**. 8. 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:zoomPhoneSite` * **Descrizione** (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. 9. Fai clic su **Salva**, oppure **Salva e Aggiungi un altro**. {% hint style="danger" %} **Avviso** Il Nome esterno e lo Spazio dei nomi esterno devono essere entrambi corretti. La guida pubblicata da Zoom specifica lo Spazio dei nomi esterno come l'URN completo *incluso* il nome dell'attributo — ad esempio `urn:ietf:params:scim:schemas:extension:zoom:1.0:User:zoomRevenueAcceleratorRole` — anziché il solo namespace. Questo differisce dalla convenzione SCIM generica. Segui il formato mostrato sopra, poiché riflette la configurazione che Zoom documenta come funzionante. I nomi degli attributi fanno distinzione tra maiuscole e minuscole ovunque. Un attributo con maiuscole/minuscole errate viene accettato dall'Editor del profilo senza errori e fallisce silenziosamente nell'API Zoom. {% endhint %} ### 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. 1. Nel menu di navigazione a sinistra, fai clic su **Rubrica**, quindi fai clic **Editor del profilo**. 2. Fai clic sulla **Utenti** scheda. 3. Nel **Utenti** scatola, sotto **Filtri**, fai clic **Tutti**. 4. A destra di **Okta**, fai clic su **Utente** profilo. 5. Sotto **Attributi**, fai clic **+ Aggiungi attributo**. 6. 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. 7. Fai clic su **Salva**. {% hint style="info" icon="lightbulb" %} **Suggerimento** Usa lo stesso nome per l'attributo del profilo utente di Okta e per l'attributo del profilo dell'applicazione Zoom. Okta non lo richiede, ma i nomi corrispondenti rendono l'elenco di mappatura autoesplicativo e riducono in modo sostanziale i tempi di risoluzione dei problemi man mano che aumenta il numero di attributi. {% endhint %} 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 1. Vai a **Applicazioni** → **Applicazioni** → **ATTIVA** → il **Zoom** applicazione. 2. Fai clic sulla **Provisioning** scheda. 3. 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**. 4. Fai clic sulla **Valore dell'attributo** menu a discesa e Seleziona **Mappa dal profilo Okta**. 5. Fai clic sul menu a discesa della sorgente — che visualizza `login | string` per impostazione predefinita — e Seleziona l'attributo del profilo utente Okta creato nel Passaggio 2. 6. 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. 7. Fai clic su **Salva**. 8. Ripeti per ogni attributo. {% hint style="warning" %} **Attenzione: derivare o tradurre un valore** Quando il valore di Okta e il valore di Zoom non sono la stessa stringa, il **Valore dell'attributo** campo accetta anche Okta Expression Lingua, che supporta logica condizionale e funzioni di stringa. La sintassi delle espressioni e le funzioni Disponibile variano a seconda della versione di Okta; convalida qualsiasi espressione su un singolo utente di test usando **Anteprima** prima di applicarla più ampiamente, e consulta la documentazione attuale di Okta su Expression Lingua per le funzioni supportate. Quando la traduzione è semplice e il set di valori è piccolo, definire il valore Zoom direttamente sull'attributo di Okta come elenco enumerato — oppure usare un attributo a livello di gruppo, come nel Passaggio 5 — è di solito più manutenibile di un'espressione. {% endhint %} ### 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. 1. Vai a **Applicazioni** → **Applicazioni** → **ATTIVA** → il **Zoom** applicazione. 2. Fai clic sulla **Provisioning** scheda. 3. Sotto **Provisioning nell'app**, fai clic **Modifica**. 4. Abilita le Impostazioni descritte di seguito, quindi fai clic su **Salva**. | Impostazione | Effetto | | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **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. | {% hint style="danger" %} **Avviso** **Aggiorna gli attributi utente** è ciò che fa sì che le mappature degli attributi personalizzati abbiano effetto sugli utenti esistenti. Senza di esso, le mappature si applicano solo al momento della creazione dell'utente e qualsiasi successiva Modifica in Okta non raggiungerà Zoom. {% endhint %} ### Passaggio 5: Assegna valori agli utenti o ai gruppi **Per assegnare un valore a un singolo utente:** 1. Vai a **Rubrica** → **Persone** e fai clic sul nome dell'utente. 2. Fai clic sulla **Profilo** scheda, quindi fai clic su **Modifica**. 3. Popola l'attributo creato nel Passaggio 2 con il valore che Zoom si aspetta. 4. 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: 1. 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. 2. Vai a **Rubrica** → **Gruppi** → il **Tutti** scheda, quindi fai clic su **Aggiungi gruppo**. 3. Inserisci un **Nome** e Facoltativo **Descrizione**, quindi fai clic **Salva**. 4. Apri il gruppo e fai clic su **Applicazioni** scheda. 5. Fai clic su **Assegna applicazione**, quindi fai clic **Assegna** a destra di **Zoom** applicazione. 6. Popola gli attributi a livello di gruppo con i valori che dovrebbero applicarsi a tutti i Membri. 7. Fai clic su **Salva e torna indietro**, quindi fai clic **Fatto**. 8. Fai clic sul gruppo **Persone** scheda, quindi fai clic su **Assegna Membri**. 9. Cerca gli utenti per nome, indirizzo e-mail principale o Nome utente, e fai clic sul pulsante Aggiungi accanto a ciascuno. 10. 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. 1. Vai a **Applicazioni** → **Applicazioni** → **ATTIVA** → il **Zoom** applicazione. 2. Fai clic sulla **Assegnazioni** scheda. 3. Sotto **Filtri**, fai clic **Gruppi**. 4. Trascina e rilascia i gruppi nell'ordine desiderato. {% hint style="info" %} **Raccomandazione** Ordina i gruppi dal più specifico al più generale, in modo che un gruppo con ambito ristretto — una sede o un Ruolo particolare — prevalga su un criterio generale. Invertire quest'ordine fa sì che il gruppo generale sovrascriva tutti quelli specifici, il che in genere si presenta come un'intera popolazione che riceve la stessa configurazione indesiderata. {% endhint %} ### Passaggio 6: Verifica usando il Registro di sistema di Okta 1. Vai a **Rapporti** → **Registro di sistema**. 2. Filtra per l'utente di destinazione o per l'applicazione Zoom e restringi l'intervallo di tempo al tentativo di provisioning. 3. 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. {% hint style="warning" %} **Attenzione: il fallimento silenzioso specifico di Okta** Un attributo dichiarato nel profilo Utente Zoom ma mai mappato, oppure mappato senza **Aggiorna gli attributi utente** abilitato nel Passaggio 4, non trasmette nulla pur rimanendo visibile nell'elenco delle mappature. Non viene generato alcun errore. Se un valore non raggiunge Zoom e il System Log non mostra alcun Evento corrispondente, controlla la mappatura e le Impostazioni di provisioning prima di indagare oltre. {% endhint %} #### 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**](#reference-scenarios) 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**. {% hint style="warning" %} **Attenzione: formato dello spazio dei nomi per gli attributi dell'estensione enterprise** L'AVVERTENZA al Passaggio 1 descrive la convenzione di Zoom di aggiungere il nome dell'attributo allo spazio dei nomi External. Tale indicazione è documentata per gli attributi sotto l'estensione Zoom. `department` appartiene all'estensione enterprise SCIM standard, dove il comportamento normale di Okta è mantenere lo spazio dei nomi e il nome esterno in campi separati, come mostrato sopra. Se il valore non arriva a Zoom, prova la forma con suffisso — `urn:ietf:params:scim:schemas:extension:enterprise:2.0:utente:dipartimento` — e conferma quale forma ha avuto successo nel registro chiamate di Marketplace. {% endhint %} **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: | Attributo | Note | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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.

Esempio di un errore di provisioning.

#### 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.

Esempio di un errore di 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](https://marketplace.zoom.us/). 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.

Esempio di una richiesta di provisioning SCIM per un utente.

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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://library.zoom.com/technical-library/it/area-admin/account-and-endpoint-management/scim-guide.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.