Claude utilizza l'email come identificatore principale per abbinare gli accessi SSO ai posti di lavoro forniti. In Google Workspace, il provisioning automatico SCIM e l'SSO SAML possono inviare valori email diversi, soprattutto quando le persone hanno alias email, causando una mancata corrispondenza che blocca l'accesso.
Si applica a: Piani Enterprise e organizzazioni Console che utilizzano il provisioning SCIM. I piani Team non dispongono del provisioning SCIM, quindi questo scenario di mancata corrispondenza non si applica — consulta Configurare il provisioning JIT o SCIM per scoprire cosa è disponibile su ogni piano.
Sintomi
Le persone potrebbero riscontrare uno o più dei seguenti problemi quando tentano di accedere alla tua organizzazione tramite SSO:
«La creazione dell'account è bloccata» — La persona si autentica tramite SSO ma Claude non riesce a trovare un account fornito corrispondente. Se la tua organizzazione ha limitato la creazione di organizzazioni (consigliato), la persona è completamente bloccata.
Accesso a un account personale gratuito — Se la creazione di organizzazioni non è limitata, la persona aggira completamente la tua organizzazione e crea o accede a un account personale gratuito invece del suo posto di lavoro fornito.
«Verifica quale account hai effettuato l'accesso» mancata corrispondenza — Il callback SSO mostra un'email diversa da quella che la persona ha inserito al momento dell'accesso.
Errore di autenticazione Claude Code — Claude Code CLI mostra un errore di mancata corrispondenza email durante il flusso di autenticazione, impedendo alla persona di connettersi alla tua organizzazione.
Come accade
Gli account Google Workspace hanno un'email principale e possono avere più alias. Il provisioning SCIM e l'SSO SAML sono configurati separatamente nella console di amministrazione di Google e possono estrarre da campi di indirizzo diversi:
Attributo Google | Valore tipico | Comunemente utilizzato da |
| Consigliato per SCIM e SAML | |
Alias email | A volte mappato per errore in SCIM | |
Campi schema personalizzati | Attributi personalizzati definiti per organizzazione | Mappature di attributi avanzate |
Email dell'unità organizzativa | Varianti di indirizzo derivate da OU | Raramente, in strutture organizzative complesse |
La mancata corrispondenza più comune: SCIM è configurato per inviare un indirizzo alias mentre SAML invia l'email principale (o viceversa). Poiché gli alias e le email principali sono stringhe diverse, Claude non può abbinarli. Claude richiede una corrispondenza esatta della stringa.
Confusione comune: In Google Admin, le impostazioni di provisioning automatico SCIM e la mappatura degli attributi SAML si trovano su schede separate all'interno della stessa app. Gli amministratori a volte aggiornano una e perdono l'altra. Verifica entrambe le posizioni.
Passaggi diagnostici
Passaggio 1 — Confermare la mancata corrispondenza
Controlla l'email SCIM: Nella console di amministrazione di Google, vai a App → App web e mobili → [App Claude] → Provisioning automatico. Controlla quale attributo è mappato al campo email inviato a Claude.
Controlla l'email SAML: Nella stessa app, vai alla sezione Mappatura attributi SAML. Trova l'attributo mappato all'email e annota la sua origine.
Controlla una persona specifica: In Directory → Utenti → [Utente], confronta l'Email principale con eventuali Email alias elencate.
Passaggio 2 — Identificare l'ambito del problema
Se la maggior parte o tutti gli utenti forniti condividono la stessa mancata corrispondenza di formato email, si tratta di un problema di mappatura degli attributi sistemico. La soluzione è nella mappatura degli attributi SCIM del tuo IdP.
Se solo una o due persone sono interessate, il problema è probabilmente specifico di quegli account. Controlla il loro profilo direttamente.
Passaggio 3 — Controllare Name ID nella configurazione SAML
Nelle impostazioni dell'app, vai a SAML → Dettagli del provider di servizi.
Conferma che Name ID sia impostato su Informazioni di base → Email principale.
Se Name ID è impostato su un campo schema personalizzato o un alias, potrebbe inviare un valore diverso da SCIM.
Risoluzione
Allinea entrambe le mappature a primaryEmail
L'attributo primaryEmail di Google Workspace è la fonte più affidabile sia per SCIM che per SAML.
Aggiorna il provisioning SCIM: In App → App web e mobili → [App Claude] → Provisioning automatico → Mappatura attributi, assicurati che l'attributo email sia mappato a primaryEmail.
Aggiorna SAML Name ID: In SAML → Dettagli del provider di servizi, imposta Name ID su Informazioni di base → Email principale.
Aggiorna la mappatura degli attributi SAML: Nel passaggio Mappatura attributi, assicurati che l'attributo email sia mappato su Informazioni di base → Email principale.
Salva tutte le modifiche.
Attiva una risincronizzazione completa
Critico — Sincronizzazione completa richiesta: Una sincronizzazione incrementale non aggiornerà i record esistenti dopo aver modificato una mappatura di attributi. Devi attivare un riavvio completo del ciclo di provisioning.
Nella console di amministrazione di Google, vai alle impostazioni Provisioning automatico dell'app.
Sospendi temporaneamente il provisioning, quindi riabilitalo. Questo attiva una sincronizzazione completa di tutti gli assegnati.
In alternativa, rimuovi e aggiungi di nuovo le persone interessate dall'assegnazione dell'app per forzare il re-provisioning dei loro singoli record.
Monitora i log di provisioning per gli errori e conferma che le email siano state aggiornate per corrispondere al formato SAML prima di chiedere alle persone di riprovare.
Pulizia post-correzione
Dopo aver corretto la mappatura degli attributi e completato la sincronizzazione completa:
Account gratuiti non autorizzati: Se la creazione di organizzazioni non era limitata prima della correzione, alcune persone potrebbero aver creato involontariamente account Claude personali gratuiti. Contatta il nostro team di supporto per farli rimuovere.
Account fantasma (posti con email errata): Gli account forniti originariamente con l'email errata potrebbero ancora esistere nella tua organizzazione, occupando posti. Contatta il nostro team di supporto per deprovisionarli.
Disponibilità dei posti: Se gli account fantasma occupano tutti i posti contrattuali, i nuovi accessi falliranno con un errore di esaurimento dei posti. Il deprovisioning degli account fantasma libera quei posti.
Re-aggiunta delle persone interessate: Dopo la rimozione degli account fantasma, le persone con l'email corretta potrebbero aver bisogno di essere reinvitate o re-provisionate.
Prevenire occorrenze future: Abilita «Limita creazione organizzazione» nelle impostazioni Identità e accesso della tua organizzazione. Questo impedisce alle persone non ancora provisionate di creare accidentalmente account personali gratuiti.
Verifica
Controlla un campione di persone provisionate — conferma che la loro email nel log di provisioning corrisponda al formato email inviato da SSO.
Chiedi a una persona interessata di cancellare i cookie del browser per claude.ai, quindi accedi tramite SSO. Dovrebbe accedere direttamente all'area di lavoro della tua organizzazione senza errori.
Conferma che le persone non stiano creando account gratuiti — con la creazione di organizzazioni limitata, le persone bloccate vedono un errore chiaro invece di accedere a un account personale.
Se Claude Code è stato interessato, chiedi alla persona di eseguire di nuovo
claude auth login --enterprisee conferma che l'email corrisponda al suo posto di lavoro fornito.
Problemi comuni
Problema | Soluzione |
SCIM invia un alias mentre SAML invia l'email principale | Usa sempre |
Name ID nelle impostazioni SAML non è stato controllato | Il campo Name ID determina l'email inviata al momento dell'accesso. Questo è separato dalla sezione di mappatura degli attributi. Controlla entrambi. |
Il campo schema personalizzato è vuoto per alcune persone | Attieniti agli attributi Google standard come |
Il re-provisioning non si attiva automaticamente dopo il cambio di mappatura | Potrebbe essere necessario sospendere e riabilitare manualmente il provisioning per forzare una sincronizzazione completa. |
L'email principale di qualcuno è cambiata ma l'email vecchia appare ancora in Claude | È necessaria una risincronizzazione completa dopo i cambiamenti dell'email principale. |
Le email sono state aggiornate in SCIM ma la persona non riesce ancora ad accedere | Controlla la presenza di organizzazioni gratuite non autorizzate o account fantasma. Cancella i cookie del browser e riprova. |
Quando contattare il supporto
Contatta il nostro team di supporto con il dominio della tua organizzazione, l'email della persona interessata e screenshot delle tue mappature di attributi quando:
Gli attributi SCIM e SSO sembrano identici ma le persone non riescono ancora ad accedere ai loro posti.
Hai bisogno della conferma dell'email registrata da Claude durante il provisioning SCIM per persone specifiche.
Hai bisogno di aiuto per pulire gli account fantasma o le organizzazioni gratuite non autorizzate.
Le persone stanno ricevendo un errore di esaurimento dei posti nonostante i posti contrattuali disponibili.
