Passer au contenu principal

Décalage d'email Ping Identity SSO/SCIM

Claude utilise l'email comme identifiant principal pour faire correspondre les connexions SSO aux sièges provisionnés. Les produits Ping Identity (PingOne et PingFederate) offrent une configuration d'attributs flexible et en couches. Lorsque la provisioning SCIM et SSO/OIDC extraient des attributs utilisateur différents, un décalage bloque l'accès.

S'applique à : Plans Enterprise et organisations Console utilisant la provisioning SCIM. Les plans Team n'ont pas de provisioning SCIM, donc ce scénario de décalage ne s'applique pas—voir Configurer la provisioning JIT ou SCIM pour ce qui est disponible sur chaque plan.


Symptômes

Les utilisateurs peuvent rencontrer un ou plusieurs des éléments suivants en tentant d'accéder à votre organisation via SSO :

  • « La création de compte est bloquée » — L'utilisateur s'authentifie via SSO mais Claude ne peut pas trouver de compte provisionné correspondant.

  • Accès à un compte personnel gratuit — Si la création d'organisation n'est pas restreinte, l'utilisateur contourne entièrement votre organisation.

  • « Vérifiez le compte auquel vous êtes connecté » décalage — Le rappel SSO affiche un email différent de celui que l'utilisateur a saisi à la connexion.

  • Échec d'authentification Claude Code — Le CLI Claude Code affiche une erreur de décalage d'email lors du flux d'authentification.


Comment cela se produit

Les produits Ping Identity permettent un mappage d'attributs granulaire à plusieurs niveaux (répertoire, adaptateur IdP, connecteur SP, application). SCIM et SSO peuvent chacun traverser différents chemins à travers ces couches, ce qui entraîne des valeurs d'email différentes atteignant Claude :

Attribut Ping

Valeur typique

Couramment utilisé par

email (PingOne)

Recommandé pour SCIM et SAML/OIDC

username (PingOne)

testuser1 ou [email protected]

Identifiant de connexion par défaut ; peut différer de l'email

Attribut d'adaptateur IdP (PingFederate)

Varie selon le type d'adaptateur (LDAP, formulaire HTML, etc.)

Sources d'identité PingFederate

Attribut LDAP mail

Email provenant du répertoire dans PingFederate

LDAP sAMAccountName ou uid

Peut être un ID d'employé ou un nom d'utilisateur court

Parfois mappé à l'email par erreur

Attributs de population personnalisés

Champs personnalisés définis par environnement

Configurations PingOne avancées

Claude nécessite une correspondance exacte entre l'email provisionné par SCIM et l'email affirmé par SSO.

Remarque PingFederate : Le système de contrat d'attribut de PingFederate est particulièrement complexe—l'email peut passer par plusieurs couches (LDAP → adaptateur IdP → contrat d'adaptateur → connecteur SP → assertion). Un décalage à n'importe quelle couche entraînera une valeur incorrecte atteignant Claude. Tracez la valeur de bout en bout.


Étapes de diagnostic

Étape 1 — Confirmer le décalage (PingOne)

  1. Vérifier le mappage d'attributs SCIM : Dans PingOne Admin, allez à Connexions → Applications → [Application Claude] → Mappages d'attributs. Trouvez l'attribut mappé à emails[primary].value ou email. Notez l'attribut utilisateur PingOne utilisé comme source.

  2. Vérifier le mappage d'attributs SSO : Dans la même application, allez à l'onglet SAML ou OIDC et trouvez l'attribut ou la revendication mappée à l'email. Notez son attribut source.

  3. Si SCIM et SSO font référence à des attributs PingOne différents, vous avez confirmé le décalage.

Étape 1 (alternative) — Confirmer le décalage (PingFederate)

  1. Dans la console d'administration PingFederate, localisez la connexion SP pour Claude.

  2. Dans Accomplissement du contrat d'attribut, trouvez l'attribut email et tracez sa source jusqu'à l'adaptateur IdP ou au magasin de données LDAP.

  3. Séparément, vérifiez le connecteur de provisioning SCIM ou le canal de provisioning sortant pour Claude et tracez la source de l'attribut email envoyé.

  4. Si les deux traces mènent à des attributs de répertoire différents, vous avez confirmé le décalage.

Étape 2 — Identifier l'étendue du problème

  • Si la plupart ou tous les utilisateurs provisionnés partagent le même décalage de format d'email, c'est un problème de mappage d'attributs systémique. La solution se trouve dans le mappage d'attributs SCIM de votre IdP.

  • Si seulement une ou deux personnes sont affectées, le problème est probablement spécifique à ces comptes. Vérifiez leur profil directement.

Étape 3 — Vérifier les valeurs d'attributs pour une personne spécifique

  1. PingOne : Allez à Identités → Utilisateurs → [Utilisateur] et comparez les valeurs des champs Nom d'utilisateur et Email.

  2. PingFederate avec LDAP : Vérifiez l'enregistrement LDAP de la personne et comparez mail, userPrincipalName, sAMAccountName et tout autre attribut utilisé dans votre mappage d'adaptateur.


Résolution

PingOne — Aligner les deux mappages sur l'attribut email

  1. Dans Connexions → Applications → [Application Claude], ouvrez Mappages d'attributs.

  2. Pour SCIM : Assurez-vous que emails[primary].value est mappé à l'attribut Adresse email de PingOne.

  3. Pour SAML/OIDC : Assurez-vous que l'attribut ou la revendication email est également mappé à l'attribut Adresse email de PingOne.

  4. Enregistrez les modifications.

PingFederate — Aligner le contrat d'attribut sur toutes les couches

  1. Dans la connexion SP pour Claude, allez à Accomplissement du contrat d'attribut.

  2. Trouvez l'attribut email. Assurez-vous que sa source est le même attribut LDAP ou magasin de données utilisé dans votre canal de provisioning sortant SCIM.

  3. Si vous utilisez un adaptateur IdP personnalisé, assurez-vous que le contrat de l'adaptateur inclut l'attribut email canonique et qu'il est correctement mappé jusqu'à la connexion SP.

  4. Mettez à jour la provisioning SCIM pour utiliser le même attribut source.

Déclencher une resynchronisation complète

Critique — Synchronisation complète requise : Une synchronisation incrémentale ne mettra pas à jour les enregistrements existants après avoir modifié un mappage d'attributs. Vous devez déclencher un redémarrage complet du cycle de provisioning.

  1. PingOne : Dans les paramètres de provisioning de l'application, déclenchez un cycle de provisioning complet. Vous devrez peut-être désactiver et réactiver la provisioning pour forcer une réinsertion complète.

  2. PingFederate : Déclenchez une synchronisation complète dans votre canal de provisioning sortant. Vérifiez vos journaux de provisioning pour confirmer que les valeurs d'email mises à jour sont envoyées.

  3. Vérifiez que les valeurs d'email mises à jour apparaissent dans les journaux de provisioning avant de demander aux utilisateurs de réessayer la connexion.


Nettoyage après correction

Après correction du mappage d'attributs et fin de la synchronisation complète :

  • Comptes gratuits non autorisés : Si la création d'organisation n'était pas restreinte avant la correction, certaines personnes ont peut-être créé par inadvertance des comptes Claude personnels gratuits. Contactez notre équipe d'assistance pour les faire supprimer.

  • Comptes fantômes (sièges avec mauvais email) : Contactez notre équipe d'assistance pour les déprovisionner.

  • Disponibilité des sièges : Si les comptes fantômes occupent tous les sièges contractés, les nouvelles connexions échoueront. Contactez notre équipe d'assistance.

  • Réajout des personnes affectées : Après suppression des comptes fantômes, les personnes devront peut-être être réinvitées ou reprovisionnées.

  • Prévenir les occurrences futures : Activez « Restreindre la création d'organisation » dans les paramètres Identité et accès de votre organisation.


Vérification

  1. Vérifiez un échantillon de personnes provisionnées—confirmez que leur email dans le journal de provisioning correspond au format d'email que SSO envoie.

  2. Demandez à une personne affectée d'effacer les cookies du navigateur pour claude.ai, puis de se connecter via SSO.

  3. Confirmez que les personnes ne créent pas de comptes gratuits.

  4. Si Claude Code a été affecté, demandez à la personne de réexécuter claude auth login --enterprise et confirmez que l'email correspond à son siège provisionné.


Problèmes courants

Problème

Solution

Champ username de PingOne utilisé au lieu de email

Changez le mappage SCIM à l'attribut Adresse email de PingOne.

Décalage d'attribut PingFederate sur les couches de contrat

Tracez l'attribut email de bout en bout : source LDAP → adaptateur IdP → contrat d'adaptateur → connecteur SP → assertion.

LDAP sAMAccountName ou uid mappé comme source d'email

Utilisez l'attribut LDAP mail à la place.

La synchronisation de provisioning incrémentale ne met pas à jour les enregistrements existants

Une resynchronisation complète est requise après modification des mappages d'attributs.

Contrat d'attribut mis à jour dans PingFederate mais connecteur SCIM non mis à jour

La connexion SP et le canal de provisioning SCIM sortant doivent être mis à jour indépendamment.

Emails mis à jour dans SCIM mais la personne ne peut toujours pas se connecter

Vérifiez les organisations gratuites non autorisées ou les comptes fantômes. Effacez les cookies du navigateur et réessayez.


Quand contacter l'assistance

Contactez notre équipe d'assistance avec le domaine de votre organisation, l'email de la personne affectée et des captures d'écran de vos mappages d'attributs quand :

  • Les attributs SCIM et SSO semblent identiques mais les utilisateurs ne peuvent toujours pas accéder à leurs sièges.

  • Vous avez besoin de confirmation de l'email que Claude a enregistré lors de la provisioning SCIM pour des personnes spécifiques.

  • Vous avez besoin d'aide pour nettoyer les comptes fantômes ou les organisations gratuites non autorisées.

  • Les utilisateurs rencontrent une erreur de dépassement de sièges malgré les sièges contractés disponibles.

Avez-vous trouvé la réponse à votre question ?