Vai al contenuto principale

Mancata corrispondenza tra email Microsoft Entra ID SSO/SCIM

Claude utilizza l'email come identificatore principale per abbinare gli accessi SSO ai posti di lavoro forniti. In Microsoft Entra ID, il provisioning SCIM e l'autenticazione SSO sono configurati in posizioni separate e possono estrarre l'email da attributi utente diversi, causando una mancata corrispondenza che blocca l'accesso. Questa guida illustra come identificare il problema, correggere il mapping degli attributi e pulire eventuali effetti collaterali.

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 creazione dell'organizzazione è limitata (consigliato), la persona è completamente bloccata.

  • Accesso a un account personale gratuito — Se la creazione dell'organizzazione non è limitata, la persona aggira la tua organizzazione e crea o accede a un account personale gratuito.

  • «Verifica a quale account sei connesso» mancata corrispondenza — Il callback SSO mostra un'email diversa da quella inserita dalla persona al momento dell'accesso.

  • Errore di autenticazione Claude Code — La CLI Claude Code mostra un errore di mancata corrispondenza email durante il flusso di autenticazione.


Come accade

Gli account utente di Microsoft Entra ID hanno più attributi simili a email che possono contenere valori diversi. Il provisioning SCIM e l'autenticazione SSO sono configurati in aree amministrative separate e ognuno può estrarre da un attributo diverso:

Attributo Entra

Valore tipico

Comunemente utilizzato da

userPrincipalName

[email protected] (potrebbe essere in formato ID dipendente)

Mapping predefinito di userName SCIM

mail

[email protected] (email standard)

Attestazione email OIDC / SAML

proxyAddresses

Indirizzo primario Exchange / M365

otherMails

Potrebbe contenere alias o indirizzi secondari

Email di contatto alternative

La mancata corrispondenza si verifica quando SCIM estrae l'email da un attributo mentre SSO invia l'email da un altro. Anche una differenza minima blocca l'accesso — Claude richiede una corrispondenza esatta della stringa.

Confusione comune: Entra ha due aree amministrative separate. L'app di provisioning SCIM si trova sotto Applicazioni aziendali (termine di Microsoft per le app integrate, non correlato al tuo piano Claude). L'app SSO/OIDC si trova sotto Registrazioni app. Gli amministratori IT spesso navigano nella posizione sbagliata.


Passaggi diagnostici

Passaggio 1 — Confermare la mancata corrispondenza

  1. Controlla l'email SCIM: In Centro amministrativo Entra → Applicazioni aziendali → [App Claude SCIM] → Provisioning → Log di provisioning, trova una persona fornita di recente e ispeziona Attributi modificati. Il valore mappato a emails[type eq «work»].value è quello che SCIM ha inviato a Claude.

  2. Controlla l'email SSO: In Applicazioni aziendali → [App Claude] → Single sign-on → Attributi e attestazioni, trova l'attestazione email. Per le app OIDC, controlla Registrazioni app → [App Claude] → Configurazione token.

  3. Se i due attributi di origine puntano a campi diversi, hai confermato la mancata corrispondenza.

Passaggio 2 — Identificare l'ambito

  • Se la maggior parte o tutte le persone fornite condividono lo stesso formato di mancata corrispondenza, questo è un problema di mapping degli attributi sistemico. La correzione è nella configurazione del mapping degli attributi SCIM.

  • Se solo una o due persone sono interessate, controlla il loro profilo utente direttamente in Entra.

Passaggio 3 — Controlla le attestazioni del token OIDC (solo app OIDC)

  1. Nel Centro amministrativo Entra, vai a Registrazioni app (non Applicazioni aziendali).

  2. Trova l'app Claude OIDC e fai clic su «Configurazione token.»

  3. Controlla l'attestazione email facoltativa.

  4. Fai un riferimento incrociato con il mapping degli attributi SCIM per confermare se corrispondono.


Risoluzione

Correggere il mapping degli attributi SCIM

Accedi all'app di provisioning SCIM — non all'app SSO/OIDC:

  1. Vai a Centro amministrativo Entra → Applicazioni aziendali.

  2. Cerca l'app Claude SCIM. Cerca l'app con una sezione Provisioning.

  3. Fai clic su Provisioning → Modifica provisioning → Mapping degli attributi.

  4. Trova la riga in cui l'attributo SCIM è emails[type eq «work»].value. Fai clic per modificare.

  5. Cambia l'Attributo di origine per corrispondere a quello che SSO invia — in genere mail.

  6. Controlla anche il mapping di userName e aggiorna se necessario.

  7. Fai clic su «Salva.»

Attivare una sincronizzazione completa del provisioning

Sincronizzazione completa richiesta — quella incrementale non funzionerà. Devi attivare un riavvio completo del ciclo di provisioning.

  1. Vai alla pagina di panoramica Provisioning.

  2. Fai clic su Riavvia provisioning.

  3. Attendi il completamento della sincronizzazione.

  4. Verifica nei log di provisioning che le email siano state aggiornate al formato corretto.


Pulizia post-correzione

Dopo aver corretto il mapping degli attributi e completato la sincronizzazione completa:

  • Account gratuiti non autorizzati: Se la creazione dell'organizzazione 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 originariamente forniti con l'email errata potrebbero ancora esistere nella tua organizzazione, occupando posti che non potranno mai essere utilizzati. Contatta il nostro team di supporto per deprovisionare questi.

  • 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 di persone interessate: Dopo la rimozione degli 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 Identità e accesso della tua organizzazione.


Verifica

  1. Controlla un campione di persone fornite — conferma che la loro email nel log di provisioning corrisponda 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.

  3. Conferma che le persone non stiano creando account gratuiti — con la creazione dell'organizzazione 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 corrisponda al suo posto fornito.


Problemi comuni

Problema

Soluzione

Mapping SCIM aggiornato ma attestazione SSO non controllata (o viceversa)

Entrambi devono essere aggiornati. SCIM sotto Applicazioni aziendali → Provisioning; attestazioni SSO sotto Single sign-on → Attributi e attestazioni o Registrazioni app → Configurazione token.

userPrincipalName è in formato ID dipendente, non un'email reale

Passa SCIM a utilizzare l'attributo mail.

La sincronizzazione incrementale viene eseguita ma le email non si aggiornano

Riavvia provisioning è richiesto dopo una modifica del mapping degli attributi.

L'attestazione email dell'app OIDC non è configurata come attestazione facoltativa

Aggiungi email sotto Registrazioni app → Configurazione token.

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.


Quando contattare il supporto

Contatta il nostro team di supporto con il dominio della tua organizzazione, l'email della persona interessata e 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 di 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?