Vai al contenuto principale

Mancata corrispondenza tra email Ping Identity SSO/SCIM

Claude utilizza l'email come identificatore principale per abbinare gli accessi SSO ai posti di lavoro forniti. I prodotti Ping Identity (PingOne e PingFederate) dispongono di una configurazione degli attributi flessibile e stratificata. Quando il provisioning SCIM e SSO SAML/OIDC estraggono da attributi utente diversi, una mancata corrispondenza 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.

  • Accesso a un account personale gratuito — Se la creazione dell'organizzazione non è limitata, la persona ignora completamente la tua organizzazione.

  • «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 — Claude Code CLI mostra un errore di mancata corrispondenza email durante il flusso di autenticazione.


Come accade

I prodotti Ping Identity consentono il mapping granulare degli attributi a più livelli (directory, adattatore IdP, connettore SP, applicazione). SCIM e SSO possono ciascuno attraversare percorsi diversi attraverso questi livelli, risultando in valori email diversi che raggiungono Claude:

Attributo Ping

Valore tipico

Comunemente utilizzato da

email (PingOne)

Consigliato sia per SCIM che per SAML/OIDC

username (PingOne)

testuser1 o [email protected]

Identificatore di accesso predefinito; può differire dall'email

Attributo dell'adattatore IdP (PingFederate)

Varia in base al tipo di adattatore (LDAP, HTML Form, ecc.)

Fonti di identità PingFederate

Attributo LDAP mail

Email proveniente dalla directory in PingFederate

LDAP sAMAccountName o uid

Potrebbe essere un ID dipendente o un nome utente breve

A volte mappato all'email per errore

Attributi di popolazione personalizzati

Campi personalizzati definiti per ambiente

Configurazioni PingOne avanzate

Claude richiede una corrispondenza esatta tra l'email fornita tramite SCIM e l'email asserita da SSO.

Nota su PingFederate: Il sistema di contratto degli attributi di PingFederate è particolarmente complesso—l'email può passare attraverso più livelli (LDAP → adattatore IdP → contratto dell'adattatore → connettore SP → asserzione). Una mancata corrispondenza a qualsiasi livello causerà il raggiungimento del valore errato a Claude. Traccia il valore da capo a fondo.


Passaggi diagnostici

Passaggio 1 — Confermare la mancata corrispondenza (PingOne)

  1. Controllare il mapping degli attributi SCIM: In PingOne Admin, vai a Connections → Applications → [App Claude] → Attribute Mappings. Trova l'attributo mappato a emails[primary].value o email. Annota l'attributo utente PingOne utilizzato come origine.

  2. Controllare il mapping degli attributi SSO: Nella stessa app, vai alla scheda SAML o OIDC e trova l'attributo o il claim mappato all'email. Annota il suo attributo di origine.

  3. Se SCIM e SSO fanno riferimento a attributi PingOne diversi, hai confermato la mancata corrispondenza.

Passaggio 1 (alternativo) — Confermare la mancata corrispondenza (PingFederate)

  1. Nella console di amministrazione di PingFederate, individua la SP Connection per Claude.

  2. In Attribute Contract Fulfillment, trova l'attributo email e traccia la sua origine all'adattatore IdP o all'archivio dati LDAP.

  3. Separatamente, controlla il connettore di provisioning SCIM o il canale di provisioning in uscita per Claude e traccia l'origine dell'attributo email inviato.

  4. Se le due tracce portano a attributi di directory diversi, hai confermato la mancata corrispondenza.

Passaggio 2 — Identificare l'ambito del problema

  • Se la maggior parte o tutte le persone fornite condividono la stessa mancata corrispondenza di formato email, questo è un problema di mapping degli 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 — Controllare i valori degli attributi per una persona specifica

  1. PingOne: Vai a Identities → Users → [User] e confronta i valori dei campi Username e Email.

  2. PingFederate con LDAP: Controlla il record LDAP della persona e confronta mail, userPrincipalName, sAMAccountName e qualsiasi altro attributo utilizzato nel mapping dell'adattatore.


Risoluzione

PingOne — Allineare entrambi i mapping all'attributo email

  1. In Connections → Applications → [App Claude], apri Attribute Mappings.

  2. Per SCIM: Assicurati che emails[primary].value sia mappato all'attributo Email Address di PingOne.

  3. Per SAML/OIDC: Assicurati che l'attributo email o il claim sia anche mappato all'attributo Email Address di PingOne.

  4. Salva le modifiche.

PingFederate — Allineare il contratto degli attributi su tutti i livelli

  1. Nella SP Connection per Claude, vai a Attribute Contract Fulfillment.

  2. Trova l'attributo email. Assicurati che la sua origine sia lo stesso attributo LDAP o archivio dati utilizzato nel canale di provisioning in uscita SCIM.

  3. Se utilizzi un adattatore IdP personalizzato, assicurati che il contratto dell'adattatore includa l'attributo email canonico e che sia correttamente mappato attraverso la connessione SP.

  4. Aggiorna il provisioning SCIM per utilizzare lo stesso attributo di origine.

Attivare una risincronizzazione completa

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

  1. PingOne: Nelle impostazioni di provisioning dell'app, attiva un ciclo di provisioning completo. Potrebbe essere necessario disabilitare e riabilitare il provisioning per forzare una ripetizione completa.

  2. PingFederate: Attiva una sincronizzazione completa nel canale di provisioning in uscita. Controlla i log di provisioning per confermare che i valori email aggiornati vengono inviati.

  3. Verifica che i valori email aggiornati compaiano nei log di provisioning 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 dell'organizzazione non era limitata prima della correzione, alcune persone potrebbero aver creato accidentalmente account Claude personali gratuiti. Contatta il nostro team di supporto per farli rimuovere.

  • Account fantasma (posti con email errata): Contatta il nostro team di supporto per deprovisionarli.

  • Disponibilità dei posti: Se gli account fantasma occupano tutti i posti contrattuali, i nuovi accessi falliranno. Contatta il nostro team di supporto.

  • Aggiunta di persone interessate: Dopo la rimozione degli account fantasma, le persone potrebbero aver bisogno di essere reinvitate o riprovisionate.

  • 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 log di provisioning corrisponde al formato email inviato da SSO.

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


Problemi comuni

Problema

Soluzione

Campo username di PingOne utilizzato invece di email

Cambia il mapping SCIM all'attributo Email Address di PingOne.

Mancata corrispondenza degli attributi PingFederate tra i livelli del contratto

Traccia l'attributo email da capo a fondo: origine LDAP → adattatore IdP → contratto dell'adattatore → connettore SP → asserzione.

LDAP sAMAccountName o uid mappato come origine email

Utilizza l'attributo LDAP mail invece.

La sincronizzazione incrementale del provisioning non aggiorna i record esistenti

Una risincronizzazione completa è richiesta dopo aver modificato i mapping degli attributi.

Contratto degli attributi aggiornato in PingFederate ma connettore SCIM non aggiornato

Sia la connessione SP che il canale di provisioning SCIM in uscita devono essere aggiornati indipendentemente.

Email 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 dei tuoi 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 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.

Hai ricevuto la risposta alla tua domanda?