> 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/sso-field-guide.md).
# Guida ai campi SSO
## Introduzione
Integrando Single Sign-On (SSO) con Zoom, gli amministratori hanno a disposizione Gestione degli utenti e opzioni di sicurezza che possono semplificare la gestione dell'account. Una volta configurato, gli utenti possono autenticare il proprio accesso usando le credenziali aziendali presso il provider di identità della propria azienda invece di usare metodi di autenticazione alternativi come Oauth tramite un'app di terze parti o un Nome utente e password diretti con Zoom.
Questo documento fornisce una panoramica completa delle configurazioni SSO e delle Impostazioni in Zoom, oltre a informazioni sulla risoluzione dei problemi e sulla sicurezza.
## Configurazione di SSO
#### SSO richiede un URL personalizzato per iniziare
Un account deve avere un URL personalizzato approvato prima di configurare SSO. Una volta approvato l'URL personalizzato, gli amministratori di Zoom possono accedere alla [configurazione SSO](https://zoom.us/account/sso) pagina tramite il sottomenu delle opzioni avanzate nel portale web. Consultare il nostro articolo di Assistenza su [URL personalizzato](https://support.zoom.us/hc/en-us/articles/215062646-Guidelines-for-Vanity-URL-requests) per ulteriori informazioni.
#### Zoom SSO funziona con qualsiasi provider di identità SAML 2.0 o OIDC
Zoom può integrarsi con qualsiasi provider di identità che supporti SAML 2.0 o OpenID Connect (OIDC) autenticazione.
#### Gli amministratori di Zoom possono gestire le informazioni del profilo utente e le licenze tramite mappatura delle risposte o integrazioni SCIM
Gli amministratori possono gestire le informazioni del profilo utente e le licenze tramite mappatura delle risposte o richieste dell'interfaccia di programmazione dell'applicazione (API) di System for Cross-Domain Identity Management (SCIM), a seconda delle funzionalità disponibili dal provider di identità. Entrambi i metodi di Gestione degli utenti offrono funzionalità quasi equivalenti per la mappatura delle informazioni del profilo e la gestione delle licenze, ma alcune mappature SCIM richiedono configurazione manuale.
Per un elenco completo delle funzionalità SCIM, consulta la nostra [documentazione API SCIM](https://developers.zoom.us/docs/api/?ampDeviceId=157cfe5d-7f7a-45eb-afb0-efde5a7d3feb\&SessionId=1778697171616).
#### Gli amministratori di Zoom possono gestire lo stato dell'account utente tramite SCIM, ma non SAML o OIDC
Poiché SCIM consente ai provider di identità di comunicare direttamente con Zoom in qualsiasi momento, gli account utente possono essere *attivati*, *disattivato*, *creato*, o *eliminato* tramite integrazioni SCIM automaticamente. Ad esempio, se l’account di un utente in Active Directory è disabilitato, oppure se all’utente non è assegnata l’applicazione, SCIM può inviare una richiesta di disattivazione automatica per l’account dell’utente all’interno di Zoom. Questa Funzionalità dipende dalle capacità dell’applicazione SCIM del provider di identità e la funzionalità può variare in base al provider.
#### Pochi provider di identità offrono SCIM per Zoom
Molti provider di identità non hanno Integrazioni SCIM create per Zoom come parte dei loro servizi. Gli account che utilizzano un provider di identità che non supporta SCIM con Zoom devono usare la mappatura delle risposte per la gestione automatizzata dell'utente.
#### SCIM richiede un dominio associato per eseguire automaticamente il provisioning degli utenti
Account che utilizzano SCIM per gestire e effettuare il provisioning degli utenti per l'SSO **deve** associare il dominio e-mail a Zoom. La mancata associazione del dominio comporterà errori di provisioning degli utenti. Consulta il nostro articolo di Assistenza su [Domini associati](https://support.zoom.us/hc/en-us/articles/203395207) per ulteriori informazioni sul processo.
### Guida alla configurazione SAML
I seguenti link includono guide per configurare l'SSO con SAML.
{% hint style="success" %}
**Suggerimento Zoom**
Fai clic sul ✔ nella colonna Provider o Documentazione Zoom per aprire una nuova finestra con le istruzioni.
{% endhint %}
Se il provider di identità utilizzato dalla tua Business non è elencato sopra, ti consigliamo di cercare nella knowledge base del provider una guida di Integrazioni specifica per Zoom. Se non è disponibile, l'SSO può comunque essere configurato abbinando gli identificatori chiave del tuo IdP nello schermo di configurazione SSO di Zoom. Consulta il Centro assistenza di Zoom per ulteriori informazioni su un [guida introduttiva rapida all'SSO](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0060673) e quali informazioni sono richieste per completare questo processo.
### Guida alla configurazione OIDC
Zoom supporta OIDC discovery, che può compilare automaticamente i dettagli comuni del provider di identità, come l'issuer, l'endpoint di autorizzazione, l'endpoint del token e le chiavi di firma. Poiché OIDC si basa su valori di configurazione standardizzati, in genere non è necessaria la documentazione di Zoom specifica del provider; quando discovery non è disponibile, i valori necessari possono essere inseriti manualmente.
Di conseguenza, i provider di identità OIDC conformi agli standard possono generalmente essere configurati con Zoom anche quando non è disponibile una guida di Integrazioni specifica del provider. Fai riferimento al Centro assistenza di Zoom per ulteriori informazioni su [la configurazione dell'SSO OIDC](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0083701).
### Opzioni di configurazione aggiuntive
#### Zoom può supportare più URL personalizzato e/o più applicazioni del provider di identità
Gli account Zoom possono supportare più URL personalizzato, più configurazioni del provider di identità (IdP) o una combinazione di entrambi. Le configurazioni supportate includono:
* Più URL personalizzato che condividono una configurazione IdP comune.
* Più URL personalizzato, ciascuno con una configurazione IdP indipendente.
* Un singolo URL personalizzato associato a più configurazioni IdP.
Queste configurazioni sono abilitate tramite Assistenza Zoom e non sono configurate tramite l'interfaccia di amministrazione SSO Standard. Invia una [richiesta di assistenza](https://support.zoom.com/hc/en/contact?id=contact_us) per Abilita questa Funzionalità, insieme all'URL personalizzato desiderato, alla configurazione dell'IdP e al risultato di autenticazione previsto.
{% hint style="info" %}
**Nota**
L'autenticazione OIDC non supporta attualmente più Vanity URL o IdP. Se non sei sicuro che questa situazione si applichi al tuo caso, parla con il team del tuo account Zoom per ulteriori informazioni.
{% endhint %}
#### On-premises Active Directory può utilizzare l'Applicativo AD Sync invece di SCIM
Account che desiderano automatizzare il provisioning dell'utente tramite SCIM ma che non dispongono di un provider di identità basato su cloud possono utilizzare l'applicazione Active Directory (AD) Sincronizza Tool sviluppata da Zoom per gestire i loro utente. Questa applicazione viene eseguita su Oracle JDK 8 e simula il provisioning SCIM gestendo gli utente tramite comandi API. Vedi il nostro articolo di Assistenza sul [Applicativo AD Sync](https://support.zoom.us/hc/en-us/articles/115005865543-Managing-the-AD-Sync-Tool) per ulteriori informazioni.
{% hint style="success" %}
**Raccomandazione Zoom**
L’Applicativo AD Sync richiede una configurazione precisa per Gestione degli utenti. Prima dell’implementazione completa è necessario eseguire test approfonditi e una revisione della configurazione dell’applicativo per evitare interruzioni del servizio.
{% endhint %}
#### I provider di identità possono persino autenticare i partecipanti alla riunione che non hanno un account Zoom
Gli account che vogliono richiedere agli utenti di autenticare la propria identità ma non desiderano fornire account Zoom possono Configura un profilo di autenticazione esterna con il proprio provider di identità. Quando è abilitato per una riunione, gli utenti che tentano di partecipare devono autenticare le proprie credenziali di accesso presso il provider di identità per ottenere l'accesso. Si tratta di una configurazione comune per le scuole che non forniscono account a tutti gli studenti ma richiedono l'autenticazione per partecipare alle lezioni. Consulta il nostro articolo di Assistenza su [la configurazione dell'autenticazione esterna](https://support.zoom.us/hc/en-us/articles/360053351051-Configuring-external-authentication-for-K-12-schools) per ulteriori informazioni.
#### La modifica del provider di identità richiede di riconfigurare SSO in Zoom
Gli account che stanno modificando i provider di identità devono rifare la configurazione SSO in Zoom. Ciò include l'aggiornamento di tutti i campi nella pagina di configurazione per allinearli al nuovo provider di identità. Si consiglia agli account di confermare che le mappature delle risposte non subiranno Modifica con il nuovo provider di identità.
Non dovrebbero essere necessarie ulteriori configurazioni o Modifica, supponendo che non vi siano ulteriori Modifica.
#### I Clienti con sub-account possono Configura SSO dall'account principale o dal sub-account
I Clienti con sub-account hanno due opzioni per la configurazione di SSO:
1. Tutti gli utenti autenticano utilizzando l'URL personalizzato dell'account principale e vengono automaticamente autenticati nel sub-account tramite mappatura avanzata delle risposte ([si applicano alcune limitazioni di mappatura](#mapping-users-to-a-sub-account-will-only-apply-a-meeting-license-and-add-ons))
2. Ogni sotto-account ha un URL personalizzato univoco e una configurazione SSO indipendente, utilizzati esclusivamente dai membri di quel sotto-account
Ogni configurazione offre vantaggi unici, con la seconda opzione che offre la massima flessibilità. I Clienti che stanno valutando l'implementazione di una delle due configurazioni dovrebbero discutere con il proprio team account quale configurazione sia più adatta alle loro esigenze.
## Metodi di provisioning
#### Le modalità di provisioning e SCIM sono due meccanismi diversi e possono essere utilizzati insieme
Provisioning *Al momento dell'accesso* e *Prima dell'accesso* sono i due valori Disponibile di una singola impostazione SSO. Stabiliscono se Zoom creerà un account per un utente nel momento in cui si autentica, oppure richiederanno che l'account esista già. SCIM non è un terzo valore di tale impostazione — è un meccanismo separato, basato su API, che esegue il provisioning degli utenti indipendentemente dall'autenticazione e opera insieme a qualunque modalità di provisioning sia selezionata.
| Metodo di provisioning | Come funziona | Prerequisiti | Crea account | Disattiva account |
| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ------------------------------ | ------------------------------ |
|
Al momento dell'accesso (Just-in-time)
| Crea l'account quando l'utente si autentica per la prima volta | Nessuno | Sì | No |
|
Prima dell'accesso (Pre-provisioning)
| Verifica che un utente sia autorizzato ad accedere tramite SSO | Un account con il tipo di accesso SSO. Spesso usato con il provisioning SCIM. | No, ma è spesso usato con SCIM | No, ma è spesso usato con SCIM |
| **SCIM** | Sincronizza i dati dell'utente dal provider di identità secondo il proprio Pianificare tramite API | Assistenza SCIM dell'IdP e un dominio associato | Sì | Sì, se supportato dall'IdP |
### Al momento dell'accesso
#### Il provisioning all'accesso crea l'account e il tipo di accesso SSO in un unico passaggio
Con l' *Al momento dell'accesso* impostazione (nota anche come provisioning just-in-time), un utente a cui viene assegnata l'applicazione Zoom all'interno del provider di identità e che riceve qualsiasi licenza Zoom supportata avrà un account creato per lui la prima volta che può autenticare. Non deve esistere nulla in Zoom prima. Questo lo rende l'opzione più semplice da configurare ed è il motivo per cui è consigliato quando si configura SSO per la prima volta su un account.
Il provisioning all'accesso è compatibile anche con SCIM — i due possono funzionare contemporaneamente. In pratica, tuttavia, SCIM di solito ne elimina la necessità, perché gli account esistono già quando un utente si autentica per la prima volta.
### Prima dell'accesso
#### Il provisioning prima dell'accesso dipende dal fatto che qualcos'altro abbia creato prima l'account o il tipo di accesso
Il *Prima dell'accesso* L'impostazione (nota anche come pre-provisioning) non esegue automaticamente il provisioning di nulla. Impone invece una condizione: un utente può autenticarsi solo se il suo account Zoom esiste già e ha il tipo di accesso SSO. Qualcos'altro deve quindi essere responsabile della creazione di tali account, e ci sono due opzioni pratiche.
* **Provisioning SCIM**, che crea automaticamente gli account dal provider di identità quando agli utenti viene assegnata l'applicazione.
* **Caricamento CSV in blocco** con l' *Utente SSO* opzione selezionata, che crea gli account e applica il tipo di accesso SSO in una singola importazione.
Ecco perché il pre-provisioning e SCIM sono così spesso abbinati. Il pre-provisioning stabilisce un requisito; SCIM è il meccanismo che lo soddisfa su larga scala.
Gli amministratori Zoom possono confermare se un account ha un tipo di accesso SSO visualizzando l'account utente sulla [Gestione degli utenti](https://zoom.us/account/user#/) pagina nel portale web e cercando l'icona “SSO” sotto l'e-mail dell'utente.
Posizione dell'icona SSO sotto l'e-mail di un utente.
Se l'icona è presente, l'utente è provisioned per SSO; se l'icona manca, l'utente non potrà accedere tramite SSO mentre il pre-provisioning è abilitato finché non viene aggiunta. Un amministratore Zoom può aggiungere questo tipo di accesso aggiungendo utenti in blocco tramite un file CSV e selezionando l'opzione “Utente SSO” oppure può fare in modo che l'utente si autentichi mentre Provision at Sign-in è abilitato.
Esempio che mostra l'opzione Utente SSO per il caricamento in blocco.
### SCIM
#### SCIM esegue il provisioning degli utenti tramite API e non trasmette mai valori di identità come SAML o OIDC
SCIM differisce dalla mappatura delle risposte in un modo che vale la pena dire chiaramente. La mappatura delle risposte — tramite asserzioni SAML o claim OIDC — trasporta informazioni sull'utente *come parte di un evento di autenticazione*. Nulla viene applicato finché l'utente non accede, e le informazioni viaggiano all'interno dell'asserzione.
SCIM non trasporta affatto asserzioni o claim. Il provider di identità chiama direttamente le API di Zoom secondo la propria pianificazione, inviando informazioni sull'utente indipendentemente dal fatto che l'utente abbia mai effettuato l'accesso. È questo che consente a SCIM di creare, aggiornare, disattivare ed eliminare account senza il coinvolgimento dell'utente, ed è per questo che SCIM può gestire lo stato dell'account mentre la mappatura delle risposte non può farlo.
SCIM è compatibile con entrambi i modi di provisioning ed è più spesso distribuito insieme al pre-provisioning.
{% hint style="success" %}
**Raccomandazione Zoom**
Quando configuri SSO e SCIM insieme su un nuovo account, abilita *Provisioning all'accesso* per primo. Aiuta a garantire che gli utenti possano autenticarsi mentre l'integrazione SCIM è ancora in fase di convalida. Una volta confermato che SCIM sta creando account con il tipo di accesso SSO applicato, passa a *Prima dell'accesso* se si desidera un controllo più rigoroso.
{% endhint %}
## Impostazioni di sicurezza
#### Gli amministratori Zoom possono imporre la disconnessione automatica dopo un intervallo di tempo definito
Gli amministratori Zoom possono configurare Zoom in modo che disconnetta automaticamente gli utenti dalle sessioni attive dopo intervalli di tempo definiti, personalizzabili da 15 minuti a 180 giorni. Questo processo imposterà la scadenza del token di accesso Zoom alla durata predefinita una volta generato il token. Questo token non ha alcuna relazione con un provider di identità ed è univoco per Zoom.
#### Un dominio deve essere associato e gestito per imporre l'autenticazione SSO
Gli amministratori Zoom possono imporre l'autenticazione SSO *solo* se il dominio e-mail è associato e gestito in Zoom. Quando questa opzione è abilitata, tutti gli utenti che si autenticano usando il/i dominio/i della tua azienda verranno automaticamente reindirizzati alla pagina di autenticazione del tuo provider di identità, indipendentemente dalla piattaforma.
Una volta che il dominio è approvato e gestito, un amministratore Zoom può imporre l'autenticazione SSO tramite la [pagina di sicurezza](https://zoom.us/account/setting/security) sotto **Metodi di accesso**. Fai riferimento al nostro articolo di assistenza su [Domini associati](https://support.zoom.us/hc/en-us/articles/203395207) per ulteriori informazioni su come associare e gestire un dominio.
#### Gli utenti specificati possono essere esentati dall'autenticazione SSO obbligatoria
Gli amministratori Zoom possono escludere utenti specifici dall'autenticazione SSO obbligatoria. Escludere utenti specifici (come un account di amministratore) può essere utile se una configurazione SSO si rompe e un amministratore dell'account ha bisogno di accesso non SSO all'account Zoom. Gli admin esentati possono accedere a admin.zoom.us in qualsiasi momento in caso di blocco dell'account o configurazione SSO danneggiata (l'utente deve avere il ruolo standard **admin** ). Se un admin Zoom non riesce ad accedere all'account, deve contattare l'Assistenza Zoom per ricevere assistenza.
Per abilitare un'eccezione per un utente, vai all'account [pagina di sicurezza](https://zoom.us/account/setting/security) nel portale web, nelle opzioni avanzate, individua l'elenco dei domini imposti e aggiungi un'eccezione tramite l'elenco di modifica.
Esempio di elenco di domini per SSO.
#### I client mobili e desktop possono essere configurati per richiedere agli utenti di usare l'autenticazione SSO
I client Zoom possono essere preconfigurati per automatizzare le funzionalità SSO, incluso l'accesso automatico, la disconnessione automatica, l'autenticazione esclusivamente SSO sul Dispositivo e altro ancora tramite Criteri di gruppo, servizi di gestione dei dispositivi mobili (MDM) e client di distribuzione di massa.
Per un elenco completo delle possibilità di configurazione, fai riferimento alle nostre opzioni di configurazione per [Criteri di gruppo](https://support.zoom.us/hc/en-us/articles/360039100051), [iOS](https://support.zoom.us/hc/en-us/articles/360022302612-Using-MDM-to-configure-Zoom-on-iOS), [Android](https://support.zoom.us/hc/en-us/articles/360031913292-Using-MDM-to-configure-Zoom-on-Android), [Mac](https://support.zoom.us/hc/en-us/articles/115001799006-Mass-deploying-preconfigured-settings-for-Mac) e [Windows](https://support.zoom.us/hc/en-us/articles/201362163-Mass-deployment-with-preconfigured-settings-for-Windows).
#### Gli utenti di Office 365 possono accedere automaticamente al componente aggiuntivo Zoom per Outlook utilizzando le credenziali SSO
I Clienti che utilizzano Office 365 possono effettuare automaticamente l'accesso dei propri utenti al componente aggiuntivo Zoom per Outlook utilizzando le credenziali SSO. Questo può essere abbinato a un [manifesto personalizzato del componente aggiuntivo](https://support.zoom.us/hc/en-us/articles/360041403311) che precompila l'URL personalizzato dell'account, creando un'esperienza di autenticazione senza interruzioni per gli utenti. Questa funzionalità utilizza il token di sessione SSO dell'utente se è attivo, oppure richiederà una nuova autenticazione con il provider di identità se non viene trovata alcuna sessione attiva.
Un admin di Zoom può abilitare questa impostazione sull'account [pagina di sicurezza](https://zoom.us/account/setting/security) nel **avanzato** menu.
Esempio di impostazione di admin per SSO con il componente aggiuntivo Outlook.
## Mappatura delle risposte
Nella mappatura delle risposte, **attributi** sono categorie di dati definite da **valori**, e sono utilizzati per trasmettere informazioni dal fornitore di servizi di identità a un fornitore di servizi come Zoom. La mappatura di attributi e valori è essenziale per automatizzare le informazioni del profilo utente e gestire le licenze utente.
La mappatura delle risposte di Zoom è suddivisa in due parti: *di base* e *avanzato*. La mappatura di base viene utilizzata per mappare le informazioni di base del profilo, inclusi nome, numero di telefono, reparto, ecc., mentre la mappatura avanzata viene utilizzata per gestire assegnazioni dinamiche di licenze, assegnare gruppi di utenti, ruoli utente e altro ancora.
Questa sezione copre i fondamenti della mappatura delle risposte di base e avanzata ed evidenzia le condizioni uniche richieste per alcune funzionalità.
#### Zoom supporta la mappatura delle risposte tramite SAML e OIDC
Zoom può configurare la mappatura delle risposte tramite SAML o OIDC. Le informazioni di identità SAML vengono scambiate in asserzioni in formato XML, mentre le informazioni di identità OIDC vengono fornite tramite set di chiavi Web JSON (JWK). In entrambi i casi, Zoom può utilizzare gli attributi o le attestazioni ricevuti dal provider di identità per mappare le informazioni del profilo utente, le licenze, i gruppi e altre impostazioni dell'account supportate.
#### Fondamenti: attributi e valori
La maggior parte dei provider di identità trasmette le informazioni di base del profilo usando semplici nomi di attributo e valori. Ad esempio, il reparto di un dipendente può arrivare con un attributo department e un valore Human Resources. La tabella seguente mostra la relazione tra attributi e valori quando si trasmettono informazioni su un utente.
| Attributo | Valore |
| --------- | ------------------------------ |
| nome | John |
| cognome | Smith |
| e-mail | |
| reparto | Risorse umane |
Assegnando correttamente un attributo a una mappatura delle risposte, le informazioni dell'utente possono essere applicate automaticamente a un profilo utente per semplificare il processo di creazione e gestione dell'account.
### Mappatura di base: informazioni del profilo
La mappatura di base viene utilizzata per applicare informazioni del profilo come nome, cognome, reparto, numero di telefono, centro di costo e Posizione da una directory al profilo di un utente. Molte di queste categorie sono autoesplicative e possono essere configurate facilmente; tuttavia, alcune categorie richiedono spiegazioni per una configurazione corretta, al fine di bloccare conseguenze impreviste o errori dell'applicazione. La sezione seguente evidenzia opzioni di mappatura uniche e Impostazioni di configurazione per la mappatura di base. Consulta il nostro [articolo sulla mappatura di base](https://support.zoom.us/hc/en-us/articles/115005888686-Setting-up-basic-SAML-mapping) per un elenco completo degli attributi supportati.
#### Il tipo di licenza predefinito si applica solo a *utenti appena creati*
L'opzione del tipo di licenza predefinito applicherà la licenza designata a tutti gli *appena creati* utenti che vengono forniti nell'account tramite autenticazione iniziale. Questo non si applica agli utenti che si autenticano per una seconda volta, agli utenti che sono stati consolidati nell'account da un account precedente, agli utenti che vengono forniti tramite SCIM o agli utenti invitati manualmente.
Per informazioni su *l'aggiornamento* Per le licenze utente con autenticazione, fare riferimento alla configurazione della licenza sottostante [Mappatura avanzata](#advanced-mapping-licenses-add-ons-and-access).
#### Un tipo di licenza predefinito di *Nessuno* non consentirà ai nuovi utenti di autenticare, a meno che la mappatura avanzata non sia configurata per Assegna una licenza
Gli utenti Zoom devono avere un tipo di licenza assegnato (Non assegnato senza Zoom Meetings Basic, Zoom Workplace, ecc.) per accedere al servizio Zoom. Se viene selezionato un tipo di licenza predefinito Nessuno, i nuovi utenti non possono accedere o creare un nuovo account a meno che ricevano una licenza tramite [Mappatura avanzata](#advanced-mapping-licenses-add-ons-and-access).
#### La maggior parte delle mappature di base verrà riapplicata all'accesso, salvo diversa indicazione
La maggior parte delle mappature di base verrà aggiornata ogni volta che un utente accede, per impostazione predefinita, *tranne* *per* nome, cognome, nome da mostrare e numero di telefono. Per impostazione predefinita, queste quattro mappature si applicheranno solo la prima volta che un utente si autentica e non si riapplicheranno più, anche se aggiornate da un utente o admin. Gli amministratori Zoom possono Modifica questo comportamento abilitando l'opzione per **Aggiorna a ogni accesso SSO** nella pagina di mapping delle risposte.
Esempio dell'opzione Aggiorna a ogni accesso SSO.
#### Le mappature dei Numeri telefonici dovrebbero includere un prefisso internazionale e il prefisso di area se al di fuori degli Stati Uniti
I Numeri telefonici mappati tramite asserzioni dovrebbero includere il prefisso internazionale e il prefisso di area dell'utente, quando possibile. Zoom assumerà, per predefinito, un prefisso internazionale di +1 se non definito.
Gli account che non conservano i prefissi internazionali nella propria directory possono modificare le proprie asserzioni all'interno del proprio provider di identità per includerli automaticamente, se necessario.
#### Ogni utente può avere fino a tre Numeri telefonici e un numero di fax mappati al proprio profilo
Gli amministratori Zoom possono Configura fino a tre mappature separate di Numeri telefonici e un numero di fax per ciascun utente. Ogni numero di telefono deve essere univoco e non può duplicare il valore di un altro campo.
Esempio delle opzioni per i Numeri telefonici per ogni utente.
#### Le immagini del profilo devono essere mappate da un URL accessibile pubblicamente oppure codificate con Base64
Gli account che desiderano mappare le immagini del profilo dalla propria directory devono mappare le immagini utilizzando un URL accessibile pubblicamente oppure codificare l'immagine in Base64 durante l'asserzione.
### ID univoco del dipendente
**L'ID univoco del dipendente Modifica l'identificativo principale che Zoom usa per identificare gli utenti e aiuta a bloccare gli account utente duplicati dopo una Modifica dell'e-mail**
Il *ID univoco del dipendente* è una Funzionalità che Zoom offre per aiutare con la gestione dell'identità. Per impostazione predefinita, l'identificazione primaria per un utente Zoom è la sua **e-mail** **indirizzo**. Questo significa che se il tipo di accesso e-mail di lavoro è ****, quindi Zoom identificherà sempre questo utente tramite quell'indirizzo di posta elettronica. Questo identificativo consente a integrazioni come gli account OAuth SSO o Facebook e Google di associare l'utente allo stesso account Zoom.
Tuttavia, questo processo di identificazione può essere problematico se il nome o l'e-mail di un utente cambia. Ad esempio, se **** ha una Modifica e-mail a ****, Zoom non può determinare in modo sicuro che si tratti della stessa persona (perché l'identificativo fondamentale è diverso), quindi Zoom creerà un nuovo account la prima volta **** accede.
Per semplificare questo problema, Zoom offre la Funzionalità ID univoco del dipendente, che modifica l'identificativo principale di un utente da indirizzo e-mail a un ID univoco predefinito. *Ciò non modifica il Nome utente Zoom dell'utente*, ma offre invece un attributo identificativo alternativo. Questa Modifica consente a Zoom di aggiornare dinamicamente l'indirizzo e-mail di un utente all'interno di Zoom se:
* un *nuovo* indirizzo e-mail è accompagnato da un ID univoco del dipendente noto; e
* il dominio e-mail dell'utente interessato è associato in Zoom
Ad esempio, se **** si autentica e passa un valore di 12345 (il proprio numero di dipendente) per l’attributo ID univoco del dipendente, Zoom identificherà ora l’utente all’interno dell’account in base al valore dichiarato. Se John si autentica di nuovo usando l’e-mail **** pur continuando a passare l’ID univoco del dipendente di 12345, Zoom identificherà che è ora **** e aggiornerà dinamicamente l’e-mail dell’utente all’interno dell’account se il dominio è associato.
Gli amministratori dell’identità dovrebbero essere *sicuri* che non ci siano due utenti che si sovrappongano con lo stesso valore di ID univoco del dipendente prima di stabilire una mappatura per questa categoria. Se un altro utente si autentica e passa lo stesso valore, l’e-mail si aggiornerà di nuovo per il nuovo utente e può causare notevoli disagi ai servizi e all’esperienza dell’utente.
**La Funzionalità ID univoco del dipendente richiede Domini associati per la Modifica dell’e-mail di un utente**
La Funzionalità ID univoco del dipendente non può aggiornare l’indirizzo e-mail di un utente a meno che il dominio e-mail non sia ufficialmente associato al profilo dell'account. Fare riferimento al nostro articolo di Assistenza su [Domini associati](https://support.zoom.us/hc/en-us/articles/203395207) per ulteriori informazioni.
**Gli amministratori e i proprietari non possono aggiornare la propria e-mail tramite l’ID univoco del dipendente**
Le e-mail di admin e Titolare all'interno di Zoom non possono essere aggiornate tramite la Funzionalità ID univoco del dipendente. Ciò è previsto come misura di sicurezza per bloccare l'accesso non autorizzato. Gli admin e i Titolare devono effettuare la Modifica della loro e-mail tramite la pagina del profilo.
**Le email dell'utente possono essere aggiornate solo una volta al giorno tramite l'ID univoco del dipendente**
Le e-mail dell'utente possono essere aggiornate solo una volta ogni 24 ore tramite la Funzionalità ID univoco dipendente. Un utente deve attendere un intero giorno di calendario dall'aggiornamento precedente prima di aggiornare nuovamente la propria e-mail tramite SSO.
Diagramma di un flusso di esempio per l'aggiornamento delle email degli utenti.
**Impostando l'attributo su \ verrà utilizzato il NameID dichiarato dell'utente**
Mappatura dell'attributo ID univoco del dipendente a **\** utilizzerà automaticamente il valore NameID asserito dell’utente come identificativo univoco. Questo può essere uno strumento utile se il tuo identity provider asserisce un NameID diverso dall’e-mail di un utente, come un User Principal Name (UPN) o un valore simile che non cambia. Non utilizzare questo valore se i NameID degli utenti corrispondono alla loro e-mail.
Esempio dell'impostazione admin <NameID>.
### Mappatura avanzata: licenze e Aggiungi-on
La sezione Advanced Information Mapping può applicare dinamicamente licenze (incluso Zoom Phone), componenti aggiuntivi e gruppi di accesso utente agli utenti man mano che si autenticano (autenticare). A differenza della mappatura Basic, la mappatura avanzata contiene molte sfumature che possono richiedere un'attenzione diligente durante la configurazione, a seconda della complessità del tuo ambiente. Questa sezione evidenzia le sfumature per configurare la mappatura avanzata delle risposte. Fai riferimento al nostro [articolo sulla mappatura avanzata](https://support.zoom.us/hc/en-us/articles/115005081403-Setting-up-advanced-SAML-mapping) per un elenco completo degli attributi supportati.
#### La mappatura avanzata si applica ogni volta che un utente si autentica (autenticare)
A differenza della mappatura Basic, che prevede aggiornamenti facoltativi (Facoltativo) per alcune categorie, le configurazioni di mappatura avanzata si applicheranno ogni volta che un utente si autentica (autenticare), secondo l'ordine di applicazione dall'alto verso il basso.
Ad esempio, se un utente ha una licenza Basic e poi si autentica tramite SSO passando un attributo e un valore mappati all'assegnazione di una licenza completa, all'utente verrà assegnata immediatamente la licenza completa. Se il profilo dell'utente viene poi modificato all'interno del provider di identità per riportarlo a una licenza Basic, gli verrà riassegnata la licenza Basic una volta che si autentica di nuovo (autenticare) in Zoom.
#### La mappatura avanzata consente più attributi e valori per categoria
A differenza della mappatura Basic, che consente un solo attributo per categoria, la mappatura avanzata può supportare più attributi e valori per ciascuna categoria. Ciò consente una notevole flessibilità nella gestione della licenza utente e di Access tramite gruppi di sicurezza all'interno del tuo provider di identità, come mostrato nella seguente configurazione.
Esempio di mappatura avanzata degli attributi.
{% hint style="success" %}
**Suggerimento Zoom**
Gli attributi possono variare in base al provider di identità, in particolare per i gruppi di sicurezza. Conferma con il tuo provider di identità o tramite [i log di risposta](#response-logs-tell-you-which-saml-values-and-attributes-are-being-asserted) come vengono asseriti gli attributi.
{% endhint %}
#### La mappatura avanzata applica le licenze dall'alto verso il basso quando vengono asseriti più attributi
Se un utente passa più attributi o valori configurati per la mappatura avanzata, Zoom mapperà le licenze dall'alto verso il basso. Vedi il seguente esempio:
Esempio di selezione del tipo di licenza nelle Impostazioni admin.
Secondo la configurazione sopra, se un utente dovesse passare un attributo per entrambi **global\_users** e **marketing**, perché **marketing** è il più alto nella configurazione, questo attributo verrà applicato all'utente e gli attributi applicabili rimanenti verranno ignorati.
In alternativa, se la configurazione fosse impostata con **global\_users** come il più alto, come si vede nella schermata seguente, se l'asserzione di un utente conteneva **global\_users**, **marketing**, **umano** **risorse**, e **IT**, perché **global\_users** ha la priorità più alta, verrà assegnata solo una licenza Basic.
Esempio di regolazione dell'ordine di priorità
Gli amministratori di Zoom possono regolare l'ordine di applicazione quando modificano i valori di mappatura usando le frecce ↑↓ all'interno dell'editor.
{% hint style="success" %}
**Raccomandazione Zoom**
Configura le configurazioni avanzate dalla più specifica alla più generale per bloccare l'applicazione errata della licenza.
{% endhint %}
#### Le mappature di webinar e Grande riunione possono condividere un valore comune per applicare entrambi i componenti aggiuntivi
Per semplificare il processo di applicazione, gli amministratori Zoom possono configurare due volte lo stesso attributo e valore per applicare agli utenti sia i componenti aggiuntivi webinar sia quelli per grande riunione, come mostrato nell'immagine seguente con il **global\_users** valore. Se lo si desidera, questi componenti aggiuntivi possono anche essere configurati in modo indipendente, come mostrato con il **solo\_webinar** e **solo\_grande\_riunione** valori.
Esempio di attributi per solo_grande_riunione e solo_webinar.
#### Gli utenti e i gruppi di utenti specificati possono essere esentati da mappature specifiche
Ogni opzione in Mappatura avanzata può essere configurata per esentare utenti e gruppi di utenti specifici dal comportamento di mappatura. Ciò può essere utile per evitare interruzioni del servizio per gli utenti VIP dovute a una potenziale Modifica delle licenze.
Esempio di esenzioni utente.
#### Zoom supporta fino a cinque attributi personalizzati
Gli amministratori Zoom possono configurare fino a *cinque* attributi personalizzati per aggiungere dati utente al proprio profilo Zoom nella [gestione avanzata degli utenti](https://zoom.us/account/user#/advanced) pagina. Dopo aver aggiunto i campi personalizzati, gli amministratori Zoom possono configurare la mappatura nella [Mappatura delle risposte](https://zoom.us/account/sso/mapping) pagina.
Esempio di attributi personalizzati
#### La mappatura degli utenti a un sub-account comporterà *solo* l'applicazione di una licenza riunione e dei componenti aggiuntivi
La mappatura di un utente a un sub-account applicherà al sub-account solo la licenza riunione e i componenti aggiuntivi dell'utente come Webinar e Large Meetings. I Gruppi utenti, i Gruppi IM, i Ruoli utente, ecc. non si applicheranno e devono essere configurati all'interno del sub-account.
I Clienti che richiedono maggiore flessibilità per la mappatura delle risposte con i sub-account avranno bisogno di un URL personalizzato univoco e di una nuova configurazione Single Sign-On all'interno del sub-account.
### Mappatura avanzata: assegnazione di utenti e gruppi contatto
L'assegnazione ai Gruppi utenti e ai Gruppi contatto è l'unica area della mappatura avanzata che opera in due modalità distinte: *mappatura standard* e *mappatura multipla*.
* **Mappatura standard** applica una singola corrispondenza. Un amministratore può configurare molte coppie attributo-valore, ma quando un utente si autentica, ha effetto solo la prima voce corrispondente e il resto viene ignorato. Raggiungere un risultato specifico dipende quindi da una configurazione precisa ed esatta. Questo è il comportamento predefinito per tutti gli account.
* **Mappatura multipla** è una modalità Facoltativo che applica ogni corrispondenza. Una singola autenticazione può corrispondere contemporaneamente a più attributi e valori, assegnando l'utente a più gruppi in un solo passaggio. Questo la rende particolarmente adatta agli account con strutture di gruppi complesse che collocano gli utenti in una vasta gamma di Gruppi utenti e Gruppi contatto. La mappatura multipla deve essere abilitata tramite l'Assistenza Zoom.
#### **La mappatura standard assegna un utente al primo Gruppo utenti o Gruppo contatto corrispondente**
Nella mappatura standard, quando l'asserzione di un utente corrisponde a più valori configurati all'interno della categoria Gruppo utenti o Gruppo contatto, Zoom applica solo la voce corrispondente più in alto nella configurazione. Le voci vengono valutate in ordine dall'alto verso il basso e viene applicata la prima che corrisponde. Tutte le corrispondenze rimanenti all'interno di quella categoria vengono ignorate.
Ad esempio, in una configurazione contenente venti coppie attributo-valore mappate a diversi Gruppi utenti, un utente la cui asserzione corrisponde a diverse di queste coppie viene inserito solo nel gruppo associato alla voce corrispondente più in alto.
#### Un singolo valore può aggiungere un utente a più gruppi e il primo gruppo aggiunto diventa il Gruppo principale
Gli amministratori Zoom possono configurare la mappatura dei Gruppi utenti per aggiungere un utente a più gruppi con un solo valore. Questo comportamento si applica sia alla mappatura standard sia alla mappatura multipla.
Il primo gruppo utente aggiunto verrà impostato come Gruppo principale dell'utente e determinerà le impostazioni predefinite dell'utente *a meno che un gruppo sottostante abbia un'impostazione bloccata*. Per ulteriori informazioni sui Gruppi utenti, consultare il nostro [articolo di assistenza](https://support.zoom.us/hc/en-us/articles/204519819-Managing-user-groups-and-settings).
Nell'immagine seguente, se un utente passasse i valori per **Leadership**, **Risorse umane**, e **Regulated**, verrebbero inseriti solo nei gruppi per **Leadership**, perché è la prima corrispondenza e non si applicano ulteriori corrispondenze.
Esempio di mappatura standard dei Gruppi utenti.
#### La mappatura multipla assegna un utente a ogni Gruppo utenti e Gruppo contatto corrispondente, fino a 50 corrispondenze di regole
Quando la mappatura multipla è abilitata, Zoom applica *ogni* voce corrispondente all'interno delle categorie Gruppo utenti e Gruppo contatto anziché solo la corrispondenza più in alto. Lo stesso attributo può essere configurato fino a cinquanta volte e ogni valore configurato che corrisponde a un'asserzione inserisce l'utente nel relativo gruppo associato.
Ciò significa che un singolo attributo passato con cinquanta valori distinti, ciascuno mappato a un gruppo diverso, può inserire un utente in tutti i cinquanta gruppi in una singola autenticazione. Questo consente una relazione uno a uno tra i gruppi di sicurezza del provider di identità e i gruppi Zoom, in modo che l'aggiunta di un utente a un gruppo di sicurezza all'interno del provider di identità lo assegni al gruppo Zoom corrispondente alla successiva autenticazione.
Nell'immagine seguente, se un utente passasse i valori per **leadership**, **testing**, **IA**, e **risorse\_umane** con la mappatura multipla abilitata, l'utente verrebbe inserito in tutti i gruppi utenti, perché Zoom applicherà le prime 50 corrispondenze di regole quando la mappatura multipla è abilitata.
Esempio di Gruppi utenti con mappatura multipla
La designazione di Gruppo principale non è influenzata dalla modalità di mappatura. Sia nella mappatura standard sia nella mappatura multipla, il primo gruppo corrispondente aggiunto diventa il Gruppo principale dell'utente, a meno che un gruppo sottostante abbia un'impostazione bloccata.
#### La mappatura multipla semplifica l'assegnazione dei gruppi in ambienti aziendali di grandi dimensioni
La mappatura multipla riduce la precisione di configurazione necessaria per assegnare gli utenti a più Gruppi utenti o Gruppi contatto. Nella mappatura standard, inserire un utente in più gruppi dipende da una configurazione esatta dall'alto verso il basso che si risolve correttamente in una sola valutazione. La mappatura multipla rimuove questo vincolo applicando tutte le voci corrispondenti in una volta, il che supporta ambienti in cui gli utenti appartengono a molti gruppi e in cui configurazioni per attributo e valore sarebbero altrimenti difficili da eseguire in un solo passaggio.
#### La mappatura multipla richiede l'attivazione tramite l'Assistenza Zoom
La mappatura multipla non è abilitata tramite l'interfaccia di amministrazione standard di SSO. L'abilitazione della funzione richiede l'invio di un [richiesta di assistenza](https://support.zoom.com/hc/en/contact?id=contact_us) a Zoom per chiedere che la mappatura multipla venga attivata per l'account. Fino all'elaborazione della richiesta, l'assegnazione ai Gruppi utenti e ai Gruppi contatto opera secondo il comportamento standard della prima corrispondenza.
### Mappatura avanzata: Auto Mapping
#### Auto Mapping funge da fallback e assegna gli utenti a un gruppo Utente, Canale o IM denominato in base al valore dichiarato quando nessuna regola esplicita corrisponde
Auto Mapping può essere usato per assegnare automaticamente gli utenti a un Gruppo utenti, Canale e Gruppo IM denominati in base al valore dichiarato. A differenza degli altri componenti di mappatura avanzata, che possono essere configurati per assegnare un utente a qualsiasi gruppo in base al valore, Auto Mapping assegna sempre un utente a un gruppo in base al valore esatto. Se il gruppo non esisteva in precedenza, verrà creato automaticamente.
Auto Mapping funziona come fallback e si applica solo quando l'asserzione di un utente non corrisponde a nessuna delle regole esplicite configurate nelle sezioni di mappatura avanzata sopra. Se a un utente è già assegnato un gruppo tramite una regola esplicita—ad esempio, inserito in un Gruppo utenti in base all'appartenenza a un gruppo di sicurezza del provider di identità—tale assegnazione esplicita ha la precedenza e la corrispondente regola di Auto Mapping viene ignorata. Nello stesso esempio, un Gruppo utenti assegnato automaticamente dal valore del reparto dell'utente non si applicherebbe, perché la regola esplicita del Gruppo utenti ha già trovato corrispondenza.
Esempio di una configurazione di Auto Mapping.
Ad esempio, se Auto Mapping è impostato per mappare un utente nei gruppi in base al reparto, e l'utente non ha trovato corrispondenza con una regola esplicita per quella categoria, allora se il valore del reparto non è già definito per il Gruppo utenti, Canale o Gruppo IM, gli utenti verranno assegnati automaticamente a un gruppo che corrisponde al nome del loro reparto, come mostrato nella tabella seguente:
| Attributo | Valore | Il gruppo Zoom esiste già? | Risultato |
| --------- | ------------- | -------------------------- | -------------------------------------------------------- |
| Reparto | Risorse umane | Sì | Utente aggiunto al gruppo Risorse umane |
| Reparto | Marketing | Sì | Utente aggiunto al gruppo Marketing |
| Reparto | Vendite | No | Gruppo Vendite creato, utente aggiunto al gruppo Vendite |
## Risoluzione dei problemi SSO
#### I registri delle risposte possono essere salvati per la risoluzione dei problemi
Zoom può salvare i registri delle risposte dei tentativi di autenticazione per sette giorni dopo un'autenticazione. Questi registri delle risposte possono essere uno strumento prezioso per la risoluzione dei problemi di configurazione e degli errori utente, oltre alle configurazioni di mappatura delle risposte. Consulta la sezione su [risoluzione dei problemi degli errori con i registri delle risposte](#using-saml-response-logs-to-troubleshoot) per ulteriori informazioni.
{% hint style="success" %}
**Raccomandazione Zoom**
Abilita il salvataggio dei registri delle risposte per semplificare la risoluzione dei problemi.
{% endhint %}
#### Uso dei registri delle risposte per la risoluzione dei problemi
I registri delle risposte salvati possono essere uno strumento prezioso per la risoluzione dei problemi di configurazione e degli errori utente, oltre alle configurazioni di mappatura delle risposte. Se la configurazione SSO di Zoom è impostata per salvare i registri delle risposte, questi possono essere accessibili tramite la [scheda Registro delle risposte](https://zoom.us/account/sso/saml_logs) disponibile nella pagina di configurazione SSO in Impostazioni avanzate. Per visualizzare i registri delle risposte, fare clic su **Visualizza dettagli** accanto a un tentativo di autenticazione.
#### La maggior parte delle autenticazioni verrà visualizzata nei registri delle risposte
La maggior parte dei tentativi di autenticazione falliti o non riusciti verrà visualizzata nella pagina dei registri delle risposte. Se un tentativo di autenticazione non viene visualizzato, è molto probabile che Zoom non abbia ricevuto un'asserzione dal provider di identità oppure che il salvataggio dei registri delle risposte sia disabilitato.
#### I registri delle risposte possono indicare se la configurazione è errata o se il certificato è obsoleto
Quando il salvataggio dei registri delle risposte è abilitato, le informazioni del provider di identità vengono asserite a Zoom per autenticare le identità di ciascuna parte. Se un'impostazione o una stringa di informazioni asserita, come il certificato X509 o l'ID dell'emittente, è diversa dalla configurazione corrente di Zoom, verrà visualizzato un errore che avvisa che le informazioni “non corrispondono alle impostazioni SSO correnti”. Un amministratore Zoom può aggiornare la configurazione SSO per farla corrispondere a questi valori asseriti, se sono corretti, per risolvere l'errore.
Esempio di avvisi di configurazione errata.
#### I registri delle risposte indicano quali valori e attributi vengono asseriti
La revisione dei registri delle risposte può aiutare a risolvere le configurazioni di mappatura delle risposte verificando quali attributi e valori vengono asseriti dagli utenti durante l'autenticazione. Questi possono essere confrontati con la configurazione per garantire che attributi e valori corrispondano.
Esempio di informazioni asserite dal servizio del provider di identità.
Se attributi o valori sono mancanti, le informazioni non vengono asserite dal servizio del provider di identità. Gli utenti che riscontrano questo problema sono invitati a contattare i servizi di assistenza del provider di identità per ulteriore aiuto.
#### I Registri delle risposte includono un codice di errore e una breve spiegazione, se non ha esito positivo
Se un utente non può autenticarsi o riceve un errore, i registri delle risposte contengono un codice di errore e una breve spiegazione dell'errore.
Esempio di codice di errore e spiegazione.
La maggior parte dei problemi può essere identificata e risolta utilizzando questi messaggi di errore. Se non riesci a risolvere l'errore, contatta l'Assistenza Zoom per ulteriore aiuto.
#### Errori dell'ID di tracciamento Web
Se un utente non riesce nell'autenticazione SSO, riceverà un codice di errore WEB Tracking ID. Questi codici non sono un messaggio di errore relativo a un fallimento specifico, ma sono invece un ID di registro univoco che può essere esaminato in Mappatura delle risposte per identificare i problemi di autenticazione.
Esempio di errore visibile all'utente con un codice di errore WEB Tracking ID.
Per identificare l'errore, se la registrazione delle risposte è abilitata, vai alla [scheda Registro delle risposte](https://zoom.us/account/sso/saml_logs) scheda disponibile nella pagina di configurazione SSO in Impostazioni avanzate. Da lì, inserisci il WEB tracking ID nel campo Tracking ID e avvia la ricerca per popolare il registro delle risposte
Esempio di ricerca nel Registro delle risposte con il suddetto codice di errore WEB Tracking ID.
I registri delle risposte dovrebbero mostrare l'asserzione ricevuta e un codice di errore e un messaggio nella parte inferiore della risposta che possono essere utilizzati per ulteriori attività di risoluzione dei problemi.
### Errori SCIM
#### Utente non esiste o non appartiene a questo account
Questo errore si verifica quando l'indirizzo e-mail di un utente di destinazione non riesce a essere provisionato a causa di un account già esistente. Gli amministratori Zoom sono invitati a contattare direttamente l'utente e a invitarlo manualmente all'account.
Esempio di errore di provisioning.
#### Non puoi aggiungere utenti a pagamento
Questo errore si verifica quando SCIM tenta di provisionare un utente quando sull'account non sono presenti licenze sufficienti. 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 la risoluzione dei problemi di provisioning degli utenti
Zoom fornisce gli ultimi 100 registri delle richieste API nella [Zoom Marketplace](https://marketplace.zoom.us/). Un amministratore Zoom può usare questi registri per confermare quali informazioni vengono inviate e ricevute tramite le API di provisioning. Per accedere ai registri, accedi a Zoom Marketplace come amministratore Zoom e fai clic su **Gestisci**. Nella pagina seguente, seleziona **Log delle chiamate** sotto **Gestione app personale**. Da lì, fai clic su una voce per espandere i log API e rivedere il contenuto.
L'immagine seguente mostra un esempio di una richiesta di provisioning utente SCIM, con gli attributi di identità e licenza dell'utente evidenziati per riferimento.
Esempio di una richiesta di provisioning utente SCIM.
Come la mappatura 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 licenza dell'utente vengano inviati dal provider di identità. Se le informazioni previste mancano da queste asserzioni, contatta il provider di identità per assistenza.
## Flussi di dati e autenticazione
#### Autenticazione SAML
Il seguente diagramma descrive il flusso di autenticazione SAML di un utente quando avvia una sessione Single Sign-On con Zoom.
Diagramma di un esempio di flusso di autenticazione SAML.
#### Autenticazione OIDC
Il seguente diagramma descrive il flusso di autenticazione OIDC di un utente quando avvia una sessione Single Sign-On con Zoom.
Diagramma di un esempio di flusso di autenticazione SAML.
#### Token di accesso Web SSO
Dopo che un utente si autentica, la sessione dell'utente viene creata nel suo browser e ha una durata di due ore per impostazione predefinita. Se l'utente continua a usare attivamente la pagina web di Zoom, la sessione si aggiornerà; tuttavia, se l'utente non usa la propria pagina web per due ore, il token scadrà e l'utente dovrà autenticarsi di nuovo. Gli amministratori Zoom possono configurare la durata di questa sessione attiva nella [Sicurezza](https://zoom.us/account/setting/security) pagina sotto Gli utenti devono accedere di nuovo dopo un periodo di inattività e **Imposta periodo di inattività sul web (minuti)**.
#### Token di accesso client
Quando un utente tenta di autenticarsi tramite SSO all'interno di un client, il dispositivo dell'utente aprirà un browser web e lo reindirizzerà alla pagina di accesso del provider di identità. Dopo che un utente si autentica, il browser dell'utente riceverà un token di avvio del client Zoom. Una volta che l'utente fa clic sul pulsante “apri” o “avvia”, il browser usa lo schema URL combinato con il token di avvio per aprire il client Zoom.
Il client Zoom utilizzerà il token di avvio per ottenere il token di accesso e il token di aggiornamento dal server Zoom. Il client utilizzerà il token di accesso per un periodo di due ore alla volta e, alla scadenza, utilizzerà il token di aggiornamento per ottenere un nuovo insieme di token, che vengono archiviati nel database locale del client. Questo processo di aggiornamento è illimitato per impostazione predefinita e può continuare a ciclare tra i token finché un utente non esegue la disconnessione o i token scadono. Gli amministratori Zoom possono personalizzare la durata della sessione nella [Impostazioni SSO](https://zoom.us/account/sso) pagina sotto [*forza la disconnessione automatica*](#zoom-administrators-can-enforce-automatic-logout-after-a-defined-length-of-time).
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://library.zoom.com/technical-library/it/area-admin/account-and-endpoint-management/sso-field-guide.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
