Zum Hauptinhalt springen

Okta SSO/SCIM E-Mail-Nichtübereinstimmung

Claude verwendet E-Mail als primären Identifikator, um SSO-Anmeldungen mit bereitgestellten Plätzen abzugleichen. In Okta werden SCIM-Bereitstellung und SSO separat konfiguriert und können E-Mail aus verschiedenen Benutzerprofilfeldern abrufen. Diese Anleitung erklärt, wie Sie die Nichtübereinstimmung identifizieren und beheben.

Gilt für: Enterprise-Pläne und Console-Organisationen mit SCIM-Bereitstellung. Team-Pläne haben keine SCIM-Bereitstellung, daher tritt dieses Nichtübereinstimmungsszenario nicht auf – 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“ – SSO-Authentifizierung ist erfolgreich, aber Claude kann kein übereinstimmendes bereitgestelltes Konto finden. Wenn Ihre Organisation die Kontoerstellung eingeschränkt hat (empfohlen), wird die Person vollständig blockiert.

  • Landung auf einem kostenlosen persönlichen Konto – Wenn die Kontoerstellung nicht eingeschränkt ist, umgeht die Person Ihre Organisation vollständig und erstellt oder landet auf einem kostenlosen persönlichen Konto statt auf ihrem bereitgestellten Platz.

  • „Überprüfen Sie, bei welchem Konto Sie angemeldet sind“-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 einen E-Mail-Nichtübereinstimmungsfehler während des Authentifizierungsflusses.


Wie dies geschieht

Okta-Benutzerprofile enthalten mehrere Felder, die Identität darstellen. SCIM-Bereitstellung (unter Provisioning → To App) und SAML/OIDC SSO (unter Sign On) werden unabhängig konfiguriert.

Okta-Attribut

Typischer Wert

Häufig verwendet von

user.login

testuser1 oder [email protected]

Standard-SCIM-userName-Zuordnung; manchmal NameID

user.email

SAML/OIDC-E-Mail-Anspruch (empfohlen)

appuser.email

Außerkraftsetzung der Benutzer-E-Mail auf App-Ebene

Benutzerdefinierte Attributzuordnung auf App-Ebene

Eine häufige Nichtübereinstimmung: SCIM verwendet user.login, während SAML user.email sendet. Claude erfordert eine exakte Zeichenkettenübereinstimmung.

Häufige Verwechslung: Oktas SCIM-Attributzuordnungen und SAML-Attributanweisungen befinden sich in zwei verschiedenen Registerkarten – Provisioning → To App für SCIM und Sign On für SSO.


Diagnoseschritte

Schritt 1 – Nichtübereinstimmung bestätigen

  1. SCIM-E-Mail überprüfen: Navigieren Sie zu Applications → [Claude App] → Provisioning → To App → Attribute Mappings. Suchen Sie die Zeile email (oder userName). Die Spalte Value zeigt den gesendeten Okta-Ausdruck.

  2. SSO-E-Mail überprüfen (SAML): Gehen Sie zu Applications → [Claude App] → Sign On → SAML Settings → Edit → Attribute Statements. Suchen Sie das Attribut email. Die Spalte Value zeigt an, welches Okta-Feld bestätigt wird.

  3. SSO-E-Mail überprüfen (OIDC): Gehen Sie zu Applications → [Claude App] → Sign On → OpenID Connect ID Token und überprüfen Sie den Abschnitt Claims auf E-Mail.

  4. Wenn SCIM- und SSO-Werte auf verschiedene Okta-Felder verweisen, ist die Nichtübereinstimmung bestätigt.

Schritt 2 – Umfang des Problems identifizieren

  • Die meisten oder alle bereitgestellten Personen betroffen: Dies ist ein systemisches Attributzuordnungsproblem. Die Lösung liegt in der SCIM-Attributzuordnung Ihres IdP.

  • Eine oder zwei Personen betroffen: Das Problem ist spezifisch für diese Konten. Überprüfen Sie deren Benutzerprofil direkt.

Schritt 3 – Okta-Benutzerprofile direkt überprüfen

  1. Gehen Sie zu Directory → People → [User] → Profile.

  2. Vergleichen Sie die Werte der Felder Login und E-Mail. Unterschiede zwischen diesen Feldern führen zu Zuordnungsnichtübereinstimmungen.


Lösung

Beide Zuordnungen auf dasselbe Okta-Feld ausrichten

Die sicherste Lösung ist die Verwendung von user.email für SCIM und SSO, da dieses Feld die kanonische E-Mail-Adresse in Okta enthält.

  1. SCIM-Zuordnung aktualisieren: Ändern Sie in Provisioning → To App → Attribute Mappings die Quelle von email (oder userName) zu user.email.

  2. SSO-Anspruch aktualisieren (SAML): Ändern Sie in Sign On → SAML Settings → Attribute Statements den E-Mail-Attributwert zu user.email.

  3. SSO-Anspruch aktualisieren (OIDC): Aktualisieren Sie in Sign On → OpenID Connect ID Token → Claims den E-Mail-Anspruch, um auf user.email zu verweisen.

  4. Klicken Sie auf „Speichern“.

Vollständige Neusynchronisierung erzwingen

Kritisch – Vollständige Synchronisierung erforderlich: Eine inkrementelle Synchronisierung aktualisiert vorhandene Datensätze nicht, nachdem Sie eine Attributzuordnung geändert haben.

  1. Klicken Sie in Provisioning → To App auf „Force Sync“, um eine vollständige Neubewertung aller zugewiesenen Personen auszulösen.

  2. Alternativ für bestimmte Personen: Provisioning → Push Users → betroffene Personen auswählen → Push Now.

  3. Überprüfen Sie das Okta-Systemprotokoll (Reports → System Log) auf Bereitstellungsfehler.

  4. Überprüfen Sie, ob aktualisierte E-Mail-Werte in Bereitstellungsprotokollen angezeigt werden, bevor Personen sich erneut anmelden.


Bereinigung nach der Behebung

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

  • Rogue-Konten: Wenn die Kontoerstellung vor der Behebung nicht eingeschränkt war, haben einige Personen möglicherweise kostenlose persönliche Claude-Konten erstellt. Kontaktieren Sie unser Support-Team zur Entfernung.

  • Ghost-Konten (Plätze mit falscher E-Mail): Die ursprünglich bereitgestellten Konten mit der falschen E-Mail können noch in Ihrer Organisation vorhanden sein und belegen Plätze, die nie verwendet werden können. Kontaktieren Sie unser Support-Team zur Aufhebung der Bereitstellung.

  • Platzverfügbarkeit: Wenn Ghost-Konten alle vertraglich vereinbarten Plätze belegen, schlagen neue Anmeldungen mit einem Fehler „Keine Plätze verfügbar“ fehl, auch nachdem die Zuordnung korrigiert wurde.

  • Betroffene Personen erneut hinzufügen: Nach Entfernung von Ghost-Konten müssen Personen mit der korrigierten E-Mail möglicherweise erneut eingeladen oder bereitgestellt werden.

  • Zukünftige Vorkommen verhindern: Aktivieren Sie „Organisationserstellung einschränken“ in den Identitäts- und Zugriffseinstellungen Ihrer Organisation, um zu verhindern, dass nicht bereitgestellte Personen kostenlose Konten erstellen.


Überprüfung

Nach Abschluss der Behebung und aller Bereinigungen:

  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. Sie sollten direkt in den Arbeitsbereich Ihrer Organisation landen, ohne Fehler.

  3. Bestätigen Sie, dass Personen keine kostenlosen Konten erstellen – mit eingeschränkter Organisationserstellung sehen blockierte Personen eine klare Fehlermeldung statt auf einem persönlichen Konto zu landen.

  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

Admin aktualisiert SAML-Ansprüche, vergisst aber SCIM-Attributzuordnungen (oder umgekehrt)

Beide müssen aktualisiert werden. SCIM-Zuordnungen unter Provisioning → To App; SAML-Ansprüche unter Sign On → SAML Settings.

user.login enthält für einige Personen einen Benutzernamen (keine E-Mail)

Wechseln Sie beide zu user.email und überprüfen Sie, dass E-Mail-Felder für alle ausgefüllt sind.

Inkrementelle Synchronisierung wird ausgeführt, aber E-Mails werden nicht aktualisiert

Force Sync oder Push Users ist nach einer Attributzuordnungsänderung erforderlich.

App-Ebenen-Profilattribut (appuser.email) unterscheidet sich vom Benutzerprofil (user.email)

Überprüfen Sie, ob Attributzuordnungen auf App-Ebene Benutzerprofilwerte außer Kraft setzen.

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

Suchen Sie nach Rogue-Organisationen oder Ghost-Konten. Löschen Sie Browser-Cookies und versuchen Sie es erneut. Kontaktieren Sie Support, wenn das Problem weiterhin besteht.

OIDC- und SAML-Apps sind separate Okta-Apps für Claude

Einige Organisationen konfigurieren beide. Stellen Sie sicher, dass die Attributzuordnung in beiden Apps übereinstimmt.


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 der Attributzuordnung, wenn:

  • SCIM- und SSO-Attribute scheinen identisch zu sein, aber Personen können immer noch nicht auf ihre Plätze 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 „Keine Plätze verfügbar“, obwohl vertraglich vereinbarte Plätze verfügbar sind.

Hat dies deine Frage beantwortet?