Vai al contenuto principale

Mancata corrispondenza tra email OneLogin SSO/SCIM

Claude utilizza l'email come identificatore principale per abbinare gli accessi SSO ai posti di lavoro forniti. In OneLogin, il provisioning SCIM e l'SSO SAML sono configurati in schede separate dell'app e possono fare riferimento a campi del profilo utente diversi, 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 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 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.


Come accade

I profili utente OneLogin contengono campi distinti per nome utente ed email, che possono contenere valori diversi. I parametri di provisioning SCIM e le dichiarazioni di attributi SAML sono configurati indipendentemente e possono ciascuno estrarre da un campo diverso:

Campo OneLogin

Valore tipico

Comunemente utilizzato da

Nome utente

testuser1 o [email protected]

A volte utilizzato nel mapping userName SCIM

Email

Consigliato sia per SCIM che per SAML

Nome di accesso

Potrebbe differire dall'email se SSO viene utilizzato per accessi non basati su email

Configurazioni legacy o personalizzate

Campi utente personalizzati

Attributi personalizzati definiti per organizzazione

Mapping di attributi avanzati

Una mancata corrispondenza comune: la scheda dei parametri SCIM mappa l'attributo email al Nome utente (che potrebbe essere un ID dipendente o un nome breve) mentre la dichiarazione di attributi SAML invia il campo Email. Claude richiede una corrispondenza esatta della stringa.

Confusione comune: I parametri SCIM e le dichiarazioni di attributi SAML di OneLogin si trovano in schede diverse della stessa app — Parametri per SCIM e SSO (o Parametri con campi specifici di SAML) per SSO. Entrambi devono essere controllati e allineati.


Passaggi diagnostici

Passaggio 1 — Confermare la mancata corrispondenza

  1. Controlla l'email SCIM: Nel portale di amministrazione OneLogin, vai a Applicazioni → [App Claude] → Parametri. Trova il campo mappato all'email che Claude riceve. Nota la colonna Valore OneLogin — mostra quale campo utente viene inviato.

  2. Controlla l'email SAML: Nella stessa app, vai alla scheda SSO. Fai clic su Altre azioni → Modifica risposta SAML o controlla la sezione Dichiarazioni di attributi SAML. Trova l'attributo per l'email e nota il campo di origine.

  3. Controlla una persona specifica: In Utenti → [Utente], confronta i campi Nome utente e Email. Se differiscono, qualsiasi mapping che utilizza uno rispetto all'altro causerà una mancata corrispondenza.

Passaggio 2 — Identificare l'ambito del problema

  • Se la maggior parte o tutti gli utenti forniti condividono la stessa mancata corrispondenza di formato email, questo è un problema di mapping di attributi sistemico. La soluzione è nel mapping 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 — Esaminare i valori dei campi utente

  1. Vai a Utenti → [Utente interessato] → Informazioni utente.

  2. Controlla sia il campo Nome utente che il campo Email.

  3. Se il Nome utente è in un formato che non corrisponde a un'email valida, SCIM potrebbe inviare un valore non valido o non corrispondente.


Risoluzione

Allinea entrambi i mapping al campo Email

Il campo Email di OneLogin è la fonte più affidabile sia per SCIM che per SAML, poiché è progettato per contenere un indirizzo email valido.

  1. Aggiorna parametro SCIM: In Applicazioni → [App Claude] → Parametri, trova la riga per l'attributo email che Claude riceve. Cambia il Valore a Email (il campo Email di OneLogin).

  2. Aggiorna dichiarazione di attributi SAML: Nella scheda SSO (o Parametri per gli attributi SAML), aggiorna il valore dell'attributo email per utilizzare lo stesso campo Email.

  3. Fai clic su «Salva.»

Attiva una risincronizzazione completa

Critico — Sincronizzazione completa richiesta: Una sincronizzazione incrementale non aggiornerà i record esistenti dopo aver modificato un mapping di attributi. Devi attivare un riavvio completo del ciclo di provisioning.

  1. Nella scheda Provisioning dell'app, cerca un'opzione Risincronizza o Sincronizza tutto ed eseguila.

  2. Per fornire di nuovo singole persone: Vai a Utenti → [Utente] → Applicazioni, trova l'app Claude e utilizza Fornisci di nuovo.

  3. Controlla il registro dell'attività di provisioning di OneLogin per gli errori.

  4. Verifica che i valori email aggiornati appaiano nel registro prima di chiedere alle persone di riprovare 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 inavvertitamente account personali Claude 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 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 di persone interessate: Dopo la rimozione degli account fantasma, le persone con l'email corretta potrebbero aver bisogno di essere reinvitate o fornite di nuovo.

  • Prevenire occorrenze future: Abilita «Limita creazione organizzazione» nelle impostazioni di Identità e accesso della tua organizzazione.


Verifica

  1. Controlla un campione di persone fornite—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.

  3. Conferma che le persone non stanno creando account gratuiti.

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


Problemi comuni

Problema

Soluzione

Il campo Nome utente contiene un nome breve o un ID dipendente, non un'email

Passa SCIM per utilizzare il campo Email.

Gli attributi SAML sono stati aggiornati ma i parametri SCIM non sono stati modificati

Sia la scheda Parametri (per SCIM) che gli attributi SSO/SAML devono essere aggiornati indipendentemente.

La risincronizzazione non sembra attivarsi

Prova a rimuovere e riassegnare le persone interessate dall'app.

I campi utente personalizzati sono mappati ma vuoti per alcune persone

Passa al campo Email standard.

Le email sono state aggiornate in SCIM ma la persona non riesce ancora ad accedere

Controlla gli account org gratuiti non autorizzati o gli account fantasma. Cancella i cookie del browser e riprova.

«Dominio di invito non consentito» quando si tenta di aggiungere di nuovo persone

Il dominio della tua organizzazione potrebbe non essere verificato in Claude. Contatta il supporto.


Quando contattare il supporto

Contatta il nostro team di supporto con il dominio della tua organizzazione, l'email della persona interessata e gli screenshot dei tuoi mapping di 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 gli account org gratuiti non autorizzati.

  • Le persone stanno ricevendo un errore di esaurimento dei posti nonostante i posti contrattuali disponibili.

Hai ricevuto la risposta alla tua domanda?