Zum Hauptinhalt springen

Ping Identity SSO/SCIM E-Mail-Nichtübereinstimmung

Claude verwendet E-Mail als primären Identifikator, um SSO-Anmeldungen mit bereitgestellten Plätzen abzugleichen. Ping Identity-Produkte (PingOne und PingFederate) verfügen über flexible, mehrstufige Attributkonfiguration. Wenn SCIM-Bereitstellung und SAML/OIDC-SSO verschiedene Benutzerattribute abrufen, blockiert eine Nichtübereinstimmung den Zugriff.

Gilt für: Enterprise-Pläne und Console-Organisationen mit SCIM-Bereitstellung. Team-Pläne haben keine SCIM-Bereitstellung, daher gilt dieses Nichtübereinstimmungs-Szenario nicht – siehe JIT- oder SCIM-Bereitstellung einrichten für verfügbare Optionen pro Plan.


Symptome

Benutzer können beim Zugriff auf Ihre Organisation über SSO eines oder mehrere der folgenden Probleme erleben:

  • „Kontoerstellung ist blockiert“ – Die Person authentifiziert sich über SSO, aber Claude kann kein übereinstimmendes bereitgestelltes Konto finden.

  • Landung auf einem kostenlosen persönlichen Konto – Wenn die Organisationserstellung nicht eingeschränkt ist, umgeht die Person Ihre Organisation vollständig.

  • „Überprüfen Sie, welches Konto Sie verwenden“ Nichtübereinstimmung – Der SSO-Callback zeigt eine andere E-Mail als die, die die Person bei der Anmeldung eingegeben hat.

  • Claude Code-Authentifizierungsfehler – Die Claude Code CLI zeigt während des Authentifizierungsflusses einen E-Mail-Nichtübereinstimmungsfehler an.


So passiert das

Ping Identity-Produkte ermöglichen granulare Attributzuordnung auf mehreren Ebenen (Verzeichnis, IdP-Adapter, SP-Connector, Anwendung). SCIM und SSO können jeweils verschiedene Pfade durch diese Ebenen durchlaufen, was zu unterschiedlichen E-Mail-Werten führt, die Claude erreichen:

Ping-Attribut

Typischer Wert

Häufig verwendet von

email (PingOne)

Empfohlen für SCIM und SAML/OIDC

username (PingOne)

testuser1 oder [email protected]

Standard-Anmeldekennzeichen; kann sich von E-Mail unterscheiden

IdP-Adapter-Attribut (PingFederate)

Variiert je nach Adapter-Typ (LDAP, HTML-Formular usw.)

PingFederate-Identitätsquellen

LDAP-mail-Attribut

Verzeichnis-basierte E-Mail in PingFederate

LDAP sAMAccountName oder uid

Kann Mitarbeiter-ID oder Kurzname sein

Manchmal versehentlich als E-Mail zugeordnet

Benutzerdefinierte Populationsattribute

Benutzerdefinierte Felder pro Umgebung

Erweiterte PingOne-Konfigurationen

Claude erfordert eine exakte Zeichenfolgenübereinstimmung zwischen der SCIM-bereitgestellten E-Mail und der SSO-bestätigten E-Mail.

PingFederate-Hinweis: Das Attributvertrag-System von PingFederate ist besonders komplex – E-Mail kann mehrere Ebenen durchlaufen (LDAP → IdP-Adapter → Adapter-Vertrag → SP-Connector → Assertion). Eine Nichtübereinstimmung auf einer beliebigen Ebene führt dazu, dass der falsche Wert Claude erreicht. Verfolgen Sie den Wert von Ende zu Ende.


Diagnoseschritte

Schritt 1 – Nichtübereinstimmung bestätigen (PingOne)

  1. SCIM-Attributzuordnung überprüfen: Gehen Sie in PingOne Admin zu Verbindungen → Anwendungen → [Claude-App] → Attributzuordnungen. Suchen Sie das Attribut, das emails[primary].value oder email zugeordnet ist. Notieren Sie das PingOne-Benutzerattribut, das als Quelle verwendet wird.

  2. SSO-Attributzuordnung überprüfen: Gehen Sie in derselben App zur Registerkarte SAML oder OIDC und suchen Sie das Attribut oder den Anspruch, der E-Mail zugeordnet ist. Notieren Sie sein Quellattribut.

  3. Wenn SCIM und SSO auf verschiedene PingOne-Attribute verweisen, haben Sie die Nichtübereinstimmung bestätigt.

Schritt 1 (Alternative) – Nichtübereinstimmung bestätigen (PingFederate)

  1. Suchen Sie in der PingFederate Admin-Konsole die SP-Verbindung für Claude.

  2. Suchen Sie in Attributvertrag-Erfüllung das E-Mail-Attribut und verfolgen Sie seine Quelle zurück zum IdP-Adapter oder LDAP-Datenspeicher.

  3. Überprüfen Sie separat den SCIM-Bereitstellungs-Connector oder den ausgehenden Bereitstellungskanal für Claude und verfolgen Sie die Quelle des gesendeten E-Mail-Attributs.

  4. Wenn die beiden Verfolgungen zu verschiedenen Verzeichnisattributen führen, haben Sie die Nichtübereinstimmung bestätigt.

Schritt 2 – Umfang des Problems identifizieren

  • Wenn die meisten oder alle bereitgestellten Personen das gleiche E-Mail-Format-Nichtübereinstimmungs-Problem haben, ist dies ein systemisches Attributzuordnungsproblem. Die Lösung liegt in der SCIM-Attributzuordnung Ihres IdP.

  • Wenn nur eine oder zwei Personen betroffen sind, ist das Problem wahrscheinlich spezifisch für diese Konten. Überprüfen Sie ihr Profil direkt.

Schritt 3 – Attributwerte für eine bestimmte Person überprüfen

  1. PingOne: Gehen Sie zu Identitäten → Benutzer → [Benutzer] und vergleichen Sie die Werte der Felder Benutzername und E-Mail.

  2. PingFederate mit LDAP: Überprüfen Sie den LDAP-Datensatz der Person und vergleichen Sie mail, userPrincipalName, sAMAccountName und alle anderen Attribute, die in Ihrer Adapter-Zuordnung verwendet werden.


Lösung

PingOne – Beide Zuordnungen zum E-Mail-Attribut ausrichten

  1. Öffnen Sie in Verbindungen → Anwendungen → [Claude-App] die Attributzuordnungen.

  2. Für SCIM: Stellen Sie sicher, dass emails[primary].value dem E-Mail-Adresse-Attribut von PingOne zugeordnet ist.

  3. Für SAML/OIDC: Stellen Sie sicher, dass das E-Mail-Attribut oder der Anspruch auch dem E-Mail-Adresse-Attribut von PingOne zugeordnet ist.

  4. Speichern Sie die Änderungen.

PingFederate – Attributvertrag über alle Ebenen ausrichten

  1. Gehen Sie in der SP-Verbindung für Claude zu Attributvertrag-Erfüllung.

  2. Suchen Sie das E-Mail-Attribut. Stellen Sie sicher, dass seine Quelle das gleiche LDAP- oder Datenspeicher-Attribut ist, das in Ihrem SCIM-Ausgangsbereitstellungskanal verwendet wird.

  3. Wenn Sie einen benutzerdefinierten IdP-Adapter verwenden, stellen Sie sicher, dass der Adapter-Vertrag das kanonische E-Mail-Attribut enthält und dass es korrekt zur SP-Verbindung zugeordnet ist.

  4. Aktualisieren Sie die SCIM-Bereitstellung, um das gleiche Quellattribut zu verwenden.

Vollständige Neusynchronisierung auslösen

Kritisch – Vollständige Synchronisierung erforderlich: Eine inkrementelle Synchronisierung aktualisiert vorhandene Datensätze nach einer Attributzuordnungsänderung nicht. Sie müssen einen vollständigen Neustart des Bereitstellungszyklus auslösen.

  1. PingOne: Lösen Sie in den Bereitstellungseinstellungen der App einen vollständigen Bereitstellungszyklus aus. Möglicherweise müssen Sie die Bereitstellung deaktivieren und erneut aktivieren, um einen vollständigen Neustart zu erzwingen.

  2. PingFederate: Lösen Sie eine vollständige Synchronisierung in Ihrem ausgehenden Bereitstellungskanal aus. Überprüfen Sie Ihre Bereitstellungsprotokolle, um zu bestätigen, dass die aktualisierten E-Mail-Werte gesendet werden.

  3. Überprüfen Sie, dass aktualisierte E-Mail-Werte in Bereitstellungsprotokollen angezeigt werden, bevor Sie Personen auffordern, sich erneut anzumelden.


Bereinigung nach der Behebung

Nach Korrektur der Attributzuordnung und Abschluss der vollständigen Synchronisierung:

  • Rogue-Konten: Wenn die Organisationserstellung vor der Behebung nicht eingeschränkt war, haben einige Personen möglicherweise versehentlich kostenlose persönliche Claude-Konten erstellt. Kontaktieren Sie unser Support-Team, um diese zu entfernen.

  • Ghost-Konten (Plätze mit falscher E-Mail): Kontaktieren Sie unser Support-Team, um diese bereitzustellen.

  • Platzverfügbarkeit: Wenn Ghost-Konten alle vertraglich vereinbarten Plätze belegen, schlagen neue Anmeldungen fehl. Kontaktieren Sie unser Support-Team.

  • Betroffene Personen erneut hinzufügen: Nach dem Entfernen von Ghost-Konten müssen Personen möglicherweise erneut eingeladen oder bereitgestellt werden.

  • Zukünftige Vorkommen verhindern: Aktivieren Sie „Organisationserstellung einschränken“ in den Identitäts- und Zugriffseinstellungen Ihrer Organisation.


Überprüfung

  1. Überprüfen Sie eine Stichprobe bereitgestellter Personen – bestätigen Sie, dass ihre E-Mail im Bereitstellungsprotokoll dem E-Mail-Format entspricht, das SSO sendet.

  2. Bitten Sie eine betroffene Person, Browser-Cookies für claude.ai zu löschen und sich dann über SSO anzumelden.

  3. Bestätigen Sie, dass Personen keine kostenlosen Konten erstellen.

  4. Wenn Claude Code betroffen war, lassen Sie die Person claude auth login --enterprise erneut ausführen und bestätigen Sie, dass die E-Mail ihrem bereitgestellten Platz entspricht.


Häufige Probleme

Problem

Lösung

PingOne-username-Feld statt email verwendet

Ändern Sie die SCIM-Zuordnung zum E-Mail-Adresse-Attribut von PingOne.

PingFederate-Attributnichtübereinstimmung über Vertragsebenen

Verfolgen Sie das E-Mail-Attribut von Ende zu Ende: LDAP-Quelle → IdP-Adapter → Adapter-Vertrag → SP-Connector → Assertion.

LDAP sAMAccountName oder uid als E-Mail-Quelle zugeordnet

Verwenden Sie stattdessen das LDAP-mail-Attribut.

Inkrementelle Bereitstellungssynchronisierung aktualisiert vorhandene Datensätze nicht

Nach Änderung von Attributzuordnungen ist eine vollständige Neusynchronisierung erforderlich.

Attributvertrag in PingFederate aktualisiert, aber SCIM-Connector nicht aktualisiert

Sowohl SP-Verbindung als auch ausgehender SCIM-Bereitstellungskanal müssen unabhängig aktualisiert werden.

E-Mails in SCIM aktualisiert, aber Person kann sich immer noch nicht anmelden

Überprüfen Sie auf Rogue-Organisationen oder Ghost-Konten. Löschen Sie Browser-Cookies und versuchen Sie es erneut.


Wann Sie den Support kontaktieren sollten

Kontaktieren Sie unser Support-Team mit der Domäne Ihrer Organisation, der E-Mail der betroffenen Person und Screenshots Ihrer Attributzuordnungen, wenn:

  • SCIM- und SSO-Attribute scheinen identisch zu sein, aber Personen können auf ihre Plätze nicht zugreifen.

  • Sie benötigen eine Bestätigung der E-Mail, die Claude während der SCIM-Bereitstellung für bestimmte Personen aufgezeichnet hat.

  • Sie benötigen Hilfe beim Bereinigen von Ghost-Konten oder Rogue-Organisationen.

  • Personen erhalten einen Fehler „Plätze voll“, obwohl vertraglich vereinbarte Plätze verfügbar sind.

Hat dies deine Frage beantwortet?