Passer au contenu principal

Okta SSO/SCIM : incohérence d'adresse e-mail

Claude utilise l'adresse e-mail comme identifiant principal pour faire correspondre les connexions SSO aux sièges provisionnés. Dans Okta, le provisionnement SCIM et SSO sont configurés séparément et peuvent extraire l'e-mail de différents champs de profil utilisateur. Ce guide explique comment identifier et résoudre l'incohérence.

S'applique à : Plans Enterprise et organisations Console utilisant le provisionnement SCIM. Les plans Team n'ont pas de provisionnement SCIM, donc ce scénario d'incohérence ne s'applique pas—consultez Configurer le provisionnement JIT ou SCIM pour connaître les options disponibles sur chaque plan.


Symptômes

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

  • « La création de compte est bloquée » — L'authentification SSO réussit mais Claude ne peut pas localiser un compte provisionné correspondant. Si votre organisation a restreint la création d'organisation (recommandé), la personne est complètement bloquée.

  • Accès à un compte personnel gratuit — Si la création d'organisation n'est pas restreinte, la personne contourne votre organisation et crée ou accède à un compte personnel gratuit au lieu de son siège provisionné.

  • « Vérifiez le compte auquel vous êtes connecté » incohérence — Le rappel SSO affiche une adresse e-mail différente de celle que la personne a saisie à la connexion.

  • Échec d'authentification Claude Code — L'interface de ligne de commande Claude Code affiche une erreur d'incohérence d'e-mail lors du flux d'authentification.


Comment cela se produit

Les profils utilisateur Okta contiennent plusieurs champs qui représentent l'identité. Le provisionnement SCIM (sous Provisioning → To App) et SSO SAML/OIDC (sous Sign On) sont configurés indépendamment.

Attribut Okta

Valeur typique

Couramment utilisé par

user.login

testuser1 ou [email protected]

Mappage userName SCIM par défaut ; parfois NameID

user.email

Revendication d'e-mail SAML/OIDC (recommandé)

appuser.email

Remplacement au niveau de l'application de l'e-mail utilisateur

Mappage d'attribut personnalisé au niveau de l'application

Une incohérence courante : SCIM utilise user.login tandis que SAML envoie user.email. Claude nécessite une correspondance exacte de chaîne.

Confusion courante : Les mappages d'attributs SCIM d'Okta et les déclarations d'attributs SAML se trouvent dans deux onglets différents — Provisioning → To App pour SCIM, et Sign On pour SSO.


Étapes de diagnostic

Étape 1 — Confirmer l'incohérence

  1. Vérifier l'e-mail SCIM : Accédez à Applications → [Claude App] → Provisioning → To App → Attribute Mappings. Localisez la ligne email (ou userName). La colonne Value affiche l'expression Okta envoyée.

  2. Vérifier l'e-mail SSO (SAML) : Allez à Applications → [Claude App] → Sign On → SAML Settings → Edit → Attribute Statements. Trouvez l'attribut email. La colonne Value indique quel champ Okta est affirmé.

  3. Vérifier l'e-mail SSO (OIDC) : Allez à Applications → [Claude App] → Sign On → OpenID Connect ID Token et consultez la section Claims pour l'e-mail.

  4. Si les valeurs SCIM et SSO font référence à des champs Okta différents, l'incohérence est confirmée.

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

  • La plupart ou tous les utilisateurs provisionnés sont affectés : C'est un problème systémique de mappage d'attributs. La solution se trouve dans le mappage d'attributs SCIM de votre IdP.

  • Un ou deux utilisateurs affectés : Le problème est spécifique à ces comptes. Vérifiez leur profil utilisateur directement.

Étape 3 — Vérifier les profils utilisateur Okta directement

  1. Allez à Directory → People → [User] → Profile.

  2. Comparez les valeurs des champs Login et Email. Les différences entre ces champs produiront des incohérences de mappage.


Résolution

Aligner les deux mappages sur le même champ Okta

La solution la plus sûre est d'utiliser user.email pour SCIM et SSO, car ce champ contient l'adresse e-mail canonique dans Okta.

  1. Mettre à jour le mappage SCIM : Dans Provisioning → To App → Attribute Mappings, changez la source email (ou userName) en user.email.

  2. Mettre à jour la revendication SSO (SAML) : Dans Sign On → SAML Settings → Attribute Statements, changez la valeur d'attribut d'e-mail en user.email.

  3. Mettre à jour la revendication SSO (OIDC) : Dans Sign On → OpenID Connect ID Token → Claims, mettez à jour la revendication d'e-mail pour mapper à user.email.

  4. Cliquez sur « Enregistrer. »

Forcer une resynchronisation complète

Critique — Synchronisation complète requise : Une synchronisation incrémentielle ne mettra pas à jour les enregistrements existants après que vous ayez modifié un mappage d'attributs.

  1. Dans Provisioning → To App, cliquez sur « Force Sync » pour déclencher une réévaluation complète de tous les utilisateurs assignés.

  2. Sinon, pour des utilisateurs spécifiques : Provisioning → Push Users → sélectionner les utilisateurs affectés → Push Now.

  3. Vérifiez le journal système Okta (Reports → System Log) pour les erreurs de provisionnement.

  4. Vérifiez que les valeurs d'e-mail mises à jour apparaissent dans les journaux de provisionnement avant que les utilisateurs ne réessaient de se connecter.


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, certains utilisateurs ont peut-être créé des comptes Claude personnels gratuits. Contactez notre équipe d'assistance pour suppression.

  • Comptes fantômes (sièges avec mauvais e-mail) : Les comptes provisionnés d'origine avec l'e-mail incorrect peuvent toujours exister dans votre organisation, occupant des sièges qui ne peuvent jamais être utilisés. Contactez notre équipe d'assistance pour déprovisionner.

  • Disponibilité des sièges : Si les comptes fantômes occupent tous les sièges contractés, les nouvelles connexions échoueront avec une erreur de manque de sièges même après correction du mappage.

  • Réajout des utilisateurs affectés : Après suppression des comptes fantômes, les utilisateurs avec l'e-mail corrigé devront peut-être être réinvités ou reprovisionnés.

  • Prévenir les occurrences futures : Activez « Restrict organization creation » dans les paramètres Identity and access de votre organisation pour empêcher les utilisateurs non provisionnés de créer des comptes gratuits.


Vérification

Après avoir complété la correction et tout nettoyage :

  1. Vérifiez un échantillon d'utilisateurs provisionnés—confirmez que leur e-mail dans le journal de provisionnement correspond au format d'e-mail que SSO envoie.

  2. Demandez à un utilisateur affecté d'effacer les cookies du navigateur pour claude.ai, puis de se connecter via SSO. Il devrait accéder directement à l'espace de travail de votre organisation sans erreur.

  3. Confirmez que les utilisateurs ne créent pas de comptes gratuits—avec la création d'organisation restreinte, les utilisateurs bloqués voient une erreur claire au lieu d'accéder à un compte personnel.

  4. Si Claude Code était affecté, demandez à l'utilisateur de réexécuter claude auth login --enterprise et confirmez que l'e-mail correspond à son siège provisionné.


Problèmes courants

Problème

Solution

L'administrateur met à jour les revendications SAML mais oublie les mappages d'attributs SCIM (ou vice versa)

Les deux doivent être mis à jour. Mappages SCIM sous Provisioning → To App ; revendications SAML sous Sign On → SAML Settings.

user.login contient un nom d'utilisateur (pas un e-mail) pour certains utilisateurs

Basculez les deux sur user.email et vérifiez que les champs d'e-mail sont remplis pour tout le monde.

La synchronisation incrémentielle s'exécute mais les e-mails ne se mettent pas à jour

Force Sync ou Push Users est requis après une modification du mappage d'attributs.

L'attribut de profil au niveau de l'application (appuser.email) diffère du profil utilisateur (user.email)

Vérifiez si les mappages d'attributs au niveau de l'application remplacent les valeurs du profil utilisateur.

Les e-mails sont mis à jour mais l'utilisateur ne peut toujours pas se connecter

Recherchez les organisations gratuites non autorisées ou les comptes fantômes. Effacez les cookies du navigateur et réessayez. Contactez l'assistance si le problème persiste.

Les applications OIDC et SAML sont des applications Okta séparées pour Claude

Certaines organisations configurent les deux. Assurez-vous l'alignement des attributs dans les deux applications.


Quand contacter l'assistance

Contactez notre équipe d'assistance avec le domaine de votre organisation, l'e-mail de l'utilisateur affecté et des captures d'écran du mappage 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'e-mail que Claude a enregistré lors du provisionnement SCIM pour des utilisateurs 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 manque de sièges malgré les sièges contractés disponibles.

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