Vai al contenuto principale

Mancata corrispondenza tra email Okta SSO/SCIM

Claude utilizza l'email come identificatore principale per abbinare gli accessi SSO ai posti di lavoro forniti. In Okta, il provisioning SCIM e SSO sono configurati separatamente e possono estrarre l'email da diversi campi del profilo utente. Questa guida spiega come identificare e risolvere la mancata corrispondenza.

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» — L'autenticazione SSO ha successo ma Claude non riesce a individuare un account fornito corrispondente. Se la tua organizzazione ha la creazione di organizzazioni limitata (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 a quale account sei connesso» 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.


Come accade

I profili utente Okta contengono più campi che rappresentano l'identità. Il provisioning SCIM (in Provisioning → To App) e SSO SAML/OIDC (in Sign On) sono configurati indipendentemente.

Attributo Okta

Valore tipico

Comunemente utilizzato da

user.login

testuser1 o [email protected]

Mapping userName SCIM predefinito; a volte NameID

user.email

Attestazione email SAML/OIDC (consigliato)

appuser.email

Override a livello di app dell'email utente

Mapping attributi personalizzato a livello di app

Una mancata corrispondenza comune: SCIM utilizza user.login mentre SAML invia user.email. Claude richiede una corrispondenza esatta della stringa.

Confusione comune: I mapping degli attributi SCIM di Okta e le dichiarazioni degli attributi SAML si trovano in due schede diverse — Provisioning → To App per SCIM e Sign On per SSO.


Passaggi diagnostici

Passaggio 1 — Confermare la mancata corrispondenza

  1. Verifica email SCIM: Vai a Applications → [Claude App] → Provisioning → To App → Attribute Mappings. Individua la riga email (o userName). La colonna Value mostra l'espressione Okta inviata.

  2. Verifica email SSO (SAML): Vai a Applications → [Claude App] → Sign On → SAML Settings → Edit → Attribute Statements. Trova l'attributo email. La colonna Value indica quale campo Okta viene asserito.

  3. Verifica email SSO (OIDC): Vai a Applications → [Claude App] → Sign On → OpenID Connect ID Token e rivedi la sezione Claims per l'email.

  4. Se i valori SCIM e SSO fanno riferimento a campi Okta diversi, la mancata corrispondenza è confermata.

Passaggio 2 — Identificare l'ambito del problema

  • La maggior parte o tutte le persone fornite sono interessate: Si tratta di un problema di mapping degli attributi sistemico. La soluzione è nel mapping degli attributi SCIM del tuo IdP.

  • Una o due persone interessate: Il problema è specifico di quegli account. Verifica il loro profilo utente direttamente.

Passaggio 3 — Verificare i profili utente Okta direttamente

  1. Vai a Directory → People → [User] → Profile.

  2. Confronta i valori dei campi Login e Email. Le differenze tra questi campi produrranno mancate corrispondenze di mapping.


Risoluzione

Allinea entrambi i mapping allo stesso campo Okta

La soluzione più sicura è utilizzare user.email sia per SCIM che per SSO, poiché questo campo contiene l'indirizzo email canonico in Okta.

  1. Aggiorna mapping SCIM: In Provisioning → To App → Attribute Mappings, cambia l'origine email (o userName) in user.email.

  2. Aggiorna attestazione SSO (SAML): In Sign On → SAML Settings → Attribute Statements, cambia il valore dell'attributo email in user.email.

  3. Aggiorna attestazione SSO (OIDC): In Sign On → OpenID Connect ID Token → Claims, aggiorna l'attestazione email per eseguire il mapping a user.email.

  4. Fai clic su «Salva.»

Forza una risincronizzazione completa

Critico — Sincronizzazione completa richiesta: Una sincronizzazione incrementale non aggiornerà i record esistenti dopo aver modificato un mapping degli attributi.

  1. In Provisioning → To App, fai clic su «Force Sync» per attivare una rivalutazione completa di tutti gli assegnati.

  2. In alternativa, per persone specifiche: Provisioning → Push Users → seleziona le persone interessate → Push Now.

  3. Verifica il registro di sistema Okta (Reports → System Log) per gli errori di provisioning.

  4. Verifica che i valori email aggiornati compaiano nei registri di provisioning prima che le persone ritentino l'accesso.


Pulizia post-correzione

Dopo aver corretto il mapping 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 account Claude personali gratuiti. Contatta il nostro team di supporto per la rimozione.

  • Account fantasma (posti con email errata): Gli account forniti originariamente con l'email errata potrebbero ancora esistere nella tua organizzazione, occupando posti che non possono mai essere utilizzati. Contatta il nostro team di supporto per il deprovisioning.

  • Disponibilità dei posti: Se gli account fantasma occupano tutti i posti contrattuali, i nuovi accessi falliranno con un errore di esaurimento dei posti anche dopo che il mapping è stato corretto.

  • Aggiunta nuovamente delle persone interessate: Dopo la rimozione dell'account fantasma, le persone con l'email corretta potrebbero aver bisogno di essere reinvitate o riprovisionate.

  • Prevenire occorrenze future: Abilita «Limita creazione organizzazione» nelle impostazioni di Identità e accesso della tua organizzazione per impedire alle persone non provisionate di creare account gratuiti.


Verifica

Dopo aver completato la correzione e qualsiasi pulizia:

  1. Verifica un campione di persone provisionate—conferma che la loro email nel registro di provisioning corrisponde al formato email che SSO invia.

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

  3. Conferma che le persone non stanno creando account gratuiti—con la creazione di organizzazioni limitata, le persone bloccate vedono un errore chiaro invece di accedere a un account personale.

  4. Se Claude Code è stato interessato, chiedi alla persona di eseguire nuovamente claude auth login --enterprise e conferma che l'email corrisponde al suo posto di lavoro fornito.


Problemi comuni

Problema

Soluzione

L'amministratore aggiorna le attestazioni SAML ma dimentica i mapping degli attributi SCIM (o viceversa)

Entrambi devono essere aggiornati. Mapping SCIM in Provisioning → To App; attestazioni SAML in Sign On → SAML Settings.

user.login contiene un nome utente (non email) per alcune persone

Passa entrambi a user.email e verifica che i campi email siano compilati per tutti.

La sincronizzazione incrementale viene eseguita ma le email non vengono aggiornate

Force Sync o Push Users è richiesto dopo una modifica del mapping degli attributi.

L'attributo del profilo a livello di app (appuser.email) differisce dal profilo utente (user.email)

Verifica se i mapping degli attributi a livello di app sostituiscono i valori del profilo utente.

Email aggiornate ma la persona non riesce ancora ad accedere

Cerca organizzazioni gratuite non autorizzate o account fantasma. Cancella i cookie del browser e riprova. Contatta il supporto se persiste.

Le app OIDC e SAML sono app Okta separate per Claude

Alcune organizzazioni configurano entrambe. Assicurati l'allineamento degli attributi in entrambe le app.


Quando contattare il supporto

Contatta il nostro team di supporto con il dominio della tua organizzazione, l'email della persona interessata e gli screenshot del mapping degli 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 che Claude ha registrato 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.

Hai ricevuto la risposta alla tua domanda?