Wenn Sie Authentifizierungs- und Bereitstellungsfehler in der Workforce Identity-Föderation diagnostizieren und beheben möchten, prüfen Sie die Antworten Ihres Identitätsanbieters (IdP) und die Cloud-Audit-Logs. Mit diesen Prüfungen können Sie Konfigurationsabweichungen erkennen und den Nutzerzugriff wiederherstellen.
IdP-Antwort prüfen
In diesem Abschnitt erfahren Sie, wie Sie die Antwort Ihres Identitätsanbieters (IdP) prüfen, um die in diesem Dokument aufgeführten Probleme zu beheben.
Browserbasierte Anmeldung
Wenn Sie die von Ihrem IdP zurückgegebene Antwort prüfen möchten, generieren Sie mit einem Tool Ihrer Wahl eine HAR-Datei. Sie können beispielsweise das HAR-Analysetool der Google Admin Toolbox verwenden. Dort finden Sie eine Anleitung zum Erstellen einer HAR-Datei sowie die Tools zum Hochladen und Analysieren der Datei.
SAML
So prüfen Sie die SAML-IdP-Antwort:
- Suchen Sie in der HAR-Datei nach dem Wert des Anfrageparameters
SAMLResponse, der für die URL mit dem Pfad/signin-callbackprotokolliert wird. - Decodieren Sie das Tool mit einem Tool Ihrer Wahl, z. B. Google Admin Toolbox Encode/Decode.
OIDC
So prüfen Sie die OIDC-IdP-Antwort: Dieser Ansatz funktioniert nicht mit dem Codefluss.
- Suchen Sie in der HAR-Datei nach dem Anfrageparameter
id_token, der für eine URL mit dem Pfad/signin-callbackprotokolliert ist. - Decodieren Sie es mit einem JWT-Debugging-Tool Ihrer Wahl.
gcloud-CLI
Wenn Sie die Antwort Ihres IdP bei Verwendung der gcloud CLI prüfen möchten, kopieren Sie den Inhalt der Datei, die Sie beim Ausführen des Befehls gcloud iam workforce-pools create-cred-config im Flag --credential-source-file übergeben haben, und führen Sie dann die folgenden Schritte aus:
SAML
Decodieren Sie die Antwort des SAML-IdP mit einem Tool Ihrer Wahl. Sie können beispielsweise Google Admin Toolbox Encode/Decode verwenden.
OIDC
Decodieren Sie die Antwort des OIDC-IdP mit einem JWT-Debugging-Tool Ihrer Wahl.
Logs prüfen
Um festzustellen, ob Google Cloud mit Ihrem IdP kommuniziert, und um Transaktionsinformationen zu prüfen, können Sie die Cloud-Audit-Logs einsehen.
Beispiele für Logs finden Sie unter Beispiele für Audit-Logs.
Fehler bei der Personalpool- und Anbieterverwaltung
Dieser Abschnitt enthält Vorschläge zur Behebung häufiger Fehler bei der Verwaltung von Pools und Anbietern.
Allgemeine Fehler bei der Attributzuordnung
So beheben Sie Probleme mit der Attributzuordnung von Workforce Identity-Poolanbietern:
Prüfen Sie die Attribute, auch als Anforderungen bezeichnet, in Ihrer IdP-Konfiguration. Prüfen Sie in der Google Cloud Console, wie Ihre Attributzuordnungen IdP-Attribute in Google Cloud-Attribute umwandeln und wie Ihre Bedingungen diese Attribute auswerten, um den Zugriff zuzulassen oder zu verweigern.
- Prüfen Sie, ob Sie die Rolle IAM Workforce Pool Editor (
roles/iam.workforcePoolEditor) haben. - Wenn Sie die browserbasierte Anmeldung für die Workforce Identity-Föderation aktivieren möchten, fügen Sie
https://auth.cloud.google/signin-callback/locations/global/workforcePools/POOL_ID/providers/PROVIDER_IDder Liste der zulässigen Weiterleitungs-URIs Ihres IdP hinzu. -
Rufen Sie in der Google Cloud Console die Seite Workforce Identity-Pools auf.
Zu Workforce Identity-Pools - Klicken Sie in der Liste der Pools auf den Namen des Pools, den Sie prüfen möchten.
- Klicken Sie auf der Seite Details zum Workforce-Pool auf den Namen des IdP, den Sie prüfen möchten.
- Klicken Sie auf der Seite Anbieterdetails auf IdP-Token debuggen.
- Melden Sie sich im Dialogfeld Anmelden als Testnutzer bei Ihrem IdP an.
Auf der Seite Anbieterattribute validieren werden die zugeordneten Attribute und das Ergebnis Ihrer Attributbedingung angezeigt.
Im Abschnitt Zugeordnete Attribute aus Ihrem IdP-Token sehen Sie, wie Google-Attribute wie
google.subjectbasierend auf Ihrer Zuordnungskonfiguration aus dem Token Ihres IdP ausgefüllt werden. Wenn eine Zuordnung falsch ist, wird ein Fehlersymbol angezeigt.Im Abschnitt Attributbedingung wird das boolesche Ergebnis Ihrer Bedingung angezeigt. Wenn die Bedingung
falseergibt, wird die Anmeldung blockiert.Wenn Sie das vollständige Assertion-Token ansehen möchten, klicken Sie auf Vollständiges Token ansehen. Hier wird das JSON-Rohobjekt von Ihrem IdP angezeigt. Verweisen Sie in Ihren Zuordnungen im Format
assertion.PROPERTY_NAMEauf ein Attribut auf oberster Ebene.Sie können die Konfiguration bearbeiten, um Fehler zu beheben:
- Klicken Sie auf der Seite Anbieterattribute validieren auf Bearbeiten.
- Nehmen Sie die gewünschten Änderungen vor.
- Wenn Sie einen neuen Test starten und die aktualisierten Ergebnisse sehen möchten, klicken Sie auf Speichern und Token noch einmal abrufen.
- Prüfen Sie, ob Sie die Rolle IAM Workforce Pool Editor (
Prüfen Sie Tokens, die von Ihrem IdP generiert werden. Informationen zum Generieren eines Tokens von Ihrem IdP finden Sie in der Dokumentation Ihres IdP.
Detailliertes Audit-Logging der Mitarbeiteridentitätsföderation in Cloud-Audit-Logs prüfen.
Im detaillierten Audit-Logging werden Authentifizierungs- und Autorisierungsfehler sowie Anforderungen protokolliert, die von der Workforce Identity-Föderation empfangen wurden.
Sie können das detaillierte Audit-Logging aktivieren, wenn Sie den Workforce Identity-Poolanbieter erstellen. Wenn Sie das detaillierte Audit-Logging aktivieren möchten, fügen Sie das Flag --detailed-audit-logging hinzu, wenn Sie den Workforce Identity-Poolanbieter erstellen.
Berechtigung verweigert
Dieser Fehler tritt auf, wenn der Nutzer, der versucht, eine Workforce Identity-Föderation zu konfigurieren, nicht die Rolle „IAM Workforce Pool Admin“ (roles/iam.workforcePoolAdmin) hat.
INVALID_ARGUMENT: Fehlende OIDC-Webkonfiguration für Einmalanmeldung (SSO)
Der folgende Fehler tritt auf, wenn die Felder web-sso-response-type und web-sso-assertion-claims-behavior beim Erstellen eines OIDC-Workforce Identity-Poolanbieters nicht festgelegt werden:
ERROR: (gcloud.iam.workforce-pools.providers.create-oidc) INVALID_ARGUMENT: Missing OIDC web single sign-on config.
Um diesen Fehler zu beheben, folgen Sie der Anleitung im Abschnitt Anbieter erstellen und legen Sie dabei die Felder beim Erstellen des OIDC-Workforce Identity-Poolanbieters korrekt fest.
Ratenbegrenzung überschritten (HTTP 429)
Dieser Fehler tritt auf, wenn Ihre Organisation das Kontingent für den Tokenaustausch im Personalpool (sts.googleapis.com/workforce_requests) ausgeschöpft hat.
Dieses Kontingent wird für jede Organisation erzwungen und beträgt standardmäßig 1.000 Anfragen pro Minute. Da dieses Kontingent von allen Personalpools, Anbietern, Nutzern und automatisierten Arbeitslasten in Ihrer Organisation gemeinsam genutzt wird, kann ein einzelner Client mit hoher Frequenz HTTP-429-Fehler in der gesamten Organisation verursachen, auch für Administratoren. Weitere Informationen finden Sie unter Kontingente und Limits.
Hinweis
Wenn Sie über die Workforce Identity-Föderation angemeldet sind, werden Google Cloud CLI-Befehle und neue Anmeldesitzungen in der Google Cloud Console möglicherweise gedrosselt. Wenn Sie diese Schritte ausführen möchten, wenn Ihr Kontingent überschritten ist, verwenden Sie ein Administratorkonto, das sich nicht über die Workforce Identity-Föderation authentifiziert, z. B. ein Cloud Identity-Super-Admin-Konto für den Notfallzugriff.
Schritt 1: Prüfen, ob das Kontingent ausgeschöpft ist
Rufen Sie in der Google Cloud Console IAM und Verwaltung > Kontingente auf, legen Sie die Ressourcenauswahl auf Ihre Organisation (nicht auf ein Projekt) fest und wählen Sie Anfragen zum Tokenaustausch für Workforce-Pools aus.
Zu „IAM und Verwaltung“ > „Kontingente“
Schritt 2: Traffic-Quelle ermitteln
Gedrosselte Token-Austausche werden abgelehnt, bevor die Anmeldedaten validiert werden. Sie werden daher nicht in Cloud-Audit-Logs angezeigt. Verwenden Sie eine der folgenden Methoden, um die Quelle des Traffics zu ermitteln:
- IdP-Anmeldeprotokolle prüfen: Suchen Sie in Ihrem Identitätsanbieter, z. B. im Okta-Systemprotokoll oder in den Microsoft Entra ID-Anmeldeprotokollen, nach einer bestimmten Anwendung, einem Diensthauptkonto oder einem Nutzerkonto, das Tokens in ungewöhnlich hoher Rate ausgibt.
- Arbeitslastkonfigurationen prüfen: Prüfen Sie Ihre automatisierten Jobs, CI/CD-Pipelines, Daemon-Agents und GKE-Arbeitslasten, die mit einer Konfigurationsdatei für Workforce-Anmeldedaten konfiguriert sind.
Schritt 3: Traffic eindämmen
Wählen Sie die Option aus, mit der der Traffic mit den geringsten Unterbrechungen für Ihre Belegschaft aufgelöst wird:
| Aktion | Auswirkungen auf Nutzer |
|---|---|
| Arbeitslast beenden (Bereitstellung auf null skalieren, Job löschen oder Client im IdP widerrufen) | Keine. Empfohlen, wenn Sie die spezifische Arbeitslast identifizieren können. |
| Deaktivieren Sie die programmatische Anmeldung im Workforce-Pool. | Blockiert den gesamten programmatischen Tokenaustausch für den Pool, einschließlich gcloud und kubectl für Ihre menschlichen Nutzer.
Google Cloud Die Anmeldung in der Console funktioniert weiterhin.Empfohlen, wenn Sie die Arbeitslast nicht sofort finden können. |
| Pool oder Anbieter deaktivieren | Blockiert die Authentifizierung für den gesamten Workforce-Pool oder ‑Anbieter. |
So deaktivieren Sie die programmatische Anmeldung:
gcloud iam workforce-pools update WORKFORCE_POOL_ID \
--location=global \
--disable-programmatic-signin
Nachdem Sie die problematische Arbeitslast beendet haben, aktivieren Sie die programmatische Anmeldung wieder, indem Sie den Befehl mit dem Flag --no-disable-programmatic-signin ausführen.
Schritt 4: Wiederauftreten verhindern
- Migrieren Sie automatisierte Arbeitslasten zur Identitätsföderation von Arbeitslasten.
- Wiederholen Sie gedrosselte Anfragen mit exponentiellem Backoff und Jitter. Enge Wiederholungsschleifen vertiefen die Sättigung und verlängern den Ausfall.
- Benachrichtigung bei 80 % Ihres Kontingents, damit Sie vor der Sättigung gewarnt werden.
- Wenn Ihr Bedarf im stabilen Zustand das Limit regelmäßig überschreitet, empfehlen wir, eine Kontingenterhöhung über Cloud Customer Care anzufordern, bevor Sie sie benötigen.
Anmeldefehler
Dieser Abschnitt enthält Vorschläge zur Behebung häufiger Fehler, die bei der Anmeldung durch einen Nutzer einer Workforce Identity-Föderation auftreten können.
Häufige Anmeldefehler
Die angegebenen Anmeldedaten werden von der Attributbedingung abgelehnt
Dieser Fehler tritt auf, wenn die Attributbedingung, die für den Anbieter des Mitarbeiteridentitäts-Pools festgelegt ist, nicht erfüllt wurde.
Betrachten Sie beispielsweise die folgende Attributbedingung:
SAML
'gcp-users' in assertion.attributes.groups
OIDC
'gcp-users' in assertion.groups
In diesem Fall wird der Fehler angezeigt, wenn die Liste der Gruppen, die von Ihrem IdP im Attribut groups gesendet wurden, nicht gcp-users enthält.
Führen Sie folgende Schritte aus, um diesen Fehler zu beheben:
Beschreiben Sie den Anbieter, mit dem Sie sich angemeldet haben, und prüfen Sie, ob der
attributeConditionkorrekt ist. Informationen zu Vorgängen, die in Bedingungen unterstützt werden, finden Sie in der Sprachdefinition.Führen Sie die Schritte unter IdP-Antwort prüfen aus, um die vom IdP zurückgegebenen Attribute zu sehen und zu bestätigen, ob die Attributbedingung korrekt formatiert und genau ist.
Melden Sie sich in der Admin-Konsole Ihres IdP an und prüfen Sie, ob die in der Attributbedingung referenzierten IdP-Attribute korrekt eingerichtet sind. Weitere Informationen finden Sie in der Dokumentation Ihres IdP.
Das zugeordnete Attribut muss vom Typ STRING sein
Dieser Fehler tritt bei einem Anbieter von SAML-Workforce Identity-Pools auf, wenn das in der Fehlermeldung angegebene Attribut ein einwertiger STRING ist, aber einer Liste in der Attributzuordnung zugeordnet ist:
Betrachten Sie beispielsweise einen Anbieter von SAML-Workforce Identity-Pools, der die Attributzuordnung attribute.role=assertion.attributes.userRole hat. In einer SAML-Assertion kann ein Attribute mehrere AttributeValue-Tags haben, wie im folgenden Beispiel gezeigt. Daher werden alle SAML-Attribute als Listen betrachtet, sodass assertion.attributes.userRole eine Liste ist.
<saml:Attribute Name="userRole">
<saml:AttributeValue>
security-admin
</saml:AttributeValue>
<saml:AttributeValue>
user
</saml:AttributeValue>
</saml:Attribute>
In diesem Beispiel wird möglicherweise der folgende Fehler angezeigt:
The mapped attribute 'attribute.role' must be of type STRING
So beheben Sie das Problem:
Beschreiben Sie den Anbieter, mit dem Sie sich angemeldet haben, und identifizieren Sie das IdP-Attribut, das in
attributeMappingfestgelegt ist. Vergleichen Sie das Attribut mit dem Attribut in der Fehlermeldung. Im vorherigen Beispiel wird ein IdP-Attribut mit dem NamenuserRoledem Attributrolezugeordnet und das Attributrolewird im Fehlerbeispiel angezeigt.Beachten Sie beim Aktualisieren der Attributzuordnung Folgendes:
Wenn das Attribut, das den Fehler verursacht, ein Listenwert ist, ermitteln Sie ein alternatives, stabiles Attribut mit einem Stringwert. Aktualisieren Sie dann die Attributzuordnung, um sie zu verwenden, indem Sie auf das erste Element verweisen. Wenn im vorherigen Beispiel
myRoleals alternatives einwertiges IdP-Attribut identifiziert wurde, sieht die Attributzuordnung so aus:attribute.role=assertion.attributes.myRole[0]
Wenn das Attribut einwertig ist, können Sie die Attributzuordnung auch so aktualisieren, dass das erste Element aus der Liste verwendet wird. Wenn
userRoleim vorherigen Beispiel nur eine Rolle enthält, können Sie die folgende Zuordnung verwenden:attribute.role=assertion.attributes.userRole[0]
Informationen zum Ableiten eines einwertigen stabilen Bezeichners aus der Liste finden Sie unter Sprachdefinition. Aktualisieren Sie die Attributzuordnung entsprechend.
Im Abschnitt IdP-Antwort prüfen finden Sie die vom IdP zurückgegebene Antwort.
Aus den angegebenen Anmeldedaten konnte kein Wert für google.subject abgerufen werden.
Dieser Fehler tritt auf, wenn die erforderliche Anforderung google.subject nicht mithilfe der Attributzuordnung zugeordnet werden konnte, die Sie in der Konfiguration des Anbieters des Workforce Identity-Pools festgelegt haben.
Führen Sie folgende Schritte aus, um diesen Fehler zu beheben:
Beschreiben Sie den Anbieter und prüfen Sie
attributeMapping. Ermitteln Sie die Zuordnung, die fürgoogle.subjectkonfiguriert ist. Wenn die Zuordnung nicht korrekt ist, aktualisieren Sie den Anbieter des Workforce Identity-Pools.Im Abschnitt IdP-Antwort prüfen finden Sie die vom IdP zurückgegebene Antwort. Prüfen Sie den Wert des Attributs aus der IdP-Antwort, der in Ihren Attributzuordnungen
google.subjectzugeordnet ist.Wenn der Wert leer oder falsch ist, melden Sie sich in der Admin-Konsole Ihres IdP an und prüfen Sie die konfigurierten Attribute. Prüfen Sie bei den Attributen, ob für den betroffenen Nutzer entsprechende Daten in Ihrem IdP vorhanden sind. Aktualisieren Sie die IdP-Konfiguration, um die Attribute oder Nutzerinformationen entsprechend zu korrigieren.
Versuchen Sie noch einmal, sich anzumelden.
Größe der zugeordneten Attribute überschreitet das Limit
Der folgende Fehler tritt auf, wenn ein föderierter Nutzer versucht, sich anzumelden:
The size of the entire mapped attributes exceeds the 16 KB limit.
Bitten Sie Ihren IdP-Administrator, die Anzahl der von Ihrem IdP ausgegebenen Attribute zu reduzieren, um dieses Problem zu beheben. Ihr IdP muss nur Attribute ausgeben, die für die Föderation von Nutzern mit Google Clouderforderlich sind. Weitere Informationen zu den Limits für die Attributzuordnung finden Sie unter Attributzuordnungen.
Wenn Ihr IdP beispielsweise eine große Anzahl von google.groups ausgibt, die zugeordnete Attribute in Ihrem Workforce Identity-Pool-Anbieter sind, kann ein Anmeldeversuch fehlschlagen.
Bitten Sie Ihren Administrator, die Anzahl der Gruppen zu beschränken, die Ihr IdP ausgibt.
Anzahl der Gruppen überschreitet das Limit
Der folgende Fehler tritt auf, wenn ein föderierter Nutzer versucht, sich anzumelden:
The current count of GROUPS_COUNT mapped attribute google.groups exceeds the GROUPS_COUNT_LIMIT count limit. Either modify your attribute mapping or the incoming assertion to produce a mapped attribute that has fewer than GROUPS_COUNT_LIMIT groups.
Dieser Fehler enthält die folgenden Werte:
GROUPS_COUNT: die Anzahl der Gruppen, die der IdP ausgibtGROUPS_COUNT_LIMIT: Google Cloud-Anzahlslimit für Gruppen
Dieser Fehler tritt auf, wenn die Anzahl der vom IdP ausgegebenen Gruppen das Limit vonGoogle Cloudüberschreitet. Gruppen werden mit dem Attribut google.groups Google Cloud zugeordnet.
Bitten Sie Ihren Administrator, die Anzahl der von Ihrem IdP ausgegebenen Gruppen zu reduzieren, um dieses Problem zu beheben. Ihr IdP muss nur Gruppen ausgeben, die für die Zusammenführung von Nutzern mit Google Cloudverwendet werden. Weitere Informationen zu gruppenbezogenen Limits finden Sie unter Attributzuordnungen.
400. Dies ist ein Fehler
Dieser Fehler tritt auf, wenn die Anfrage nicht wie erwartet empfangen wurde oder fehlerhaft war.
Führen Sie folgende Schritte aus, um diesen Fehler zu beheben:
Folgen Sie der Anleitung im Abschnitt Ihre Nutzer über die Vorgehensweise bei der Anmeldung informieren, um zu prüfen, ob Sie die richtigen Schritte zur Anmeldung ausführen.
Vergleichen Sie die Konfiguration Ihres Anbieters für Workforce Identity-Pools mit Ihrer IdP-Konfiguration.
Anmeldefehler bei zusätzlichen Attributen
In diesem Abschnitt finden Sie Vorschläge zur Behebung von Fehlern bei der Verwendung von zusätzlichen Attributen.
Anmeldung schlägt fehl, wenn zusätzliche Attribute konfiguriert sind
Wenn Sie zusätzliche Attribute konfiguriert haben, führt jedes Konfigurationsproblem, z. B. eine falsche Client-ID, ein falscher Clientschlüssel oder ein falscher Aussteller-URI, dazu, dass der Anmeldeversuch fehlschlägt.
Führen Sie folgende Schritte aus, um diesen Fehler zu beheben:
- Beschreiben Sie den Anbieter und prüfen Sie, ob die Client-ID und der Aussteller-URI korrekt sind.
- Prüfen Sie, ob der Clientschlüssel gültig und nicht abgelaufen ist.
- Prüfen Sie in Ihrem IdP, ob die Anwendung die erforderlichen Berechtigungen hat.
Gruppen aus SAML- oder OIDC-Assertion werden ignoriert
Wenn zusätzliche Attribute konfiguriert sind, ignoriert die Workforce Identity-Föderation alle Gruppeninformationen, die direkt in den SAML- oder OIDC-Anforderungen angegeben sind. Stattdessen werden nur die Gruppen verwendet, die über den Backchannel abgerufen wurden (z. B. über die Microsoft Graph API).
Wenn Ihre Nutzer nicht die erwarteten Gruppen sehen, prüfen Sie, ob die Gruppen korrekt über den Backchannel abgerufen werden und ob alle Attributfilter richtig konfiguriert sind.
OIDC-Anmeldefehler
Dieser Abschnitt enthält Vorschläge zur Behebung OIDC-spezifischer Fehler, die bei der Anmeldung durch einen Nutzer einer Mitarbeiteridentitätsföderation auftreten können.
Fehler beim Herstellen einer Verbindung zum Aussteller des angegebenen Ausweises
Dieser Fehler tritt auf, wenn ein OIDC-Anbieter von Workforce Identity-Pools das OIDC-Discovery-Dokument oder den JWKS-URI nicht erreichen kann.
Führen Sie folgende Schritte aus, um diesen Fehler zu beheben:
Beschreiben Sie den Anbieter und prüfen Sie den konfigurierten
issuerUri. Erstellen Sie die Discovery-Dokument-URL, indem Sie/.well-known/openid-configurationan den Aussteller-URI anhängen. Wenn IhrissuerUribeispielsweisehttps://example.comist, lautet die URL des Discovery-Dokumentshttps://example.com/.well-known/openid-configuration.Öffnen Sie die URL des Discovery-Dokuments in einem Inkognitofenster.
Wenn die URL nicht geöffnet wird oder der Browser den Fehler
404anzeigt, finden Sie in der Dokumentation Ihres IdP den richtigen Aussteller-URI. Aktualisieren Sie bei Bedarf denissuerUriin Ihrem Anbieter des Workforce Identity-Pools.Wenn Ihr IdP lokal ausgeführt wird, finden Sie in der Dokumentation Ihres IdP Informationen dazu, wie Sie ihn für den Zugriff über das Internet bereitstellen.
Wenn die URL geöffnet wird, prüfen Sie Folgendes:
- Prüfen Sie, ob die URL nicht zu oft weitergeleitet wird, bevor das Discovery-Dokument bereitgestellt wird. Wenn dies der Fall ist, wenden Sie sich an den Administrator Ihres IdP, um das Problem zu beheben.
- Prüfen Sie die Antwortzeit des IdP. Wenden Sie sich an Ihren IdP-Administrator, um die Antwortlatenz zu reduzieren.
- Das geöffnete Discovery-Dokument sollte im JSON-Format vorliegen.
Suchen Sie im JSON-Code nach dem Feld
jwks_uri.- Prüfen Sie, ob der zugehörige URL-Wert ebenfalls geöffnet wird.
- Prüfen Sie, ob die URL die weiter oben in diesem Leitfaden beschriebenen Bedingungen erfüllt.
Versuchen Sie noch einmal, sich anzumelden.
SAML-Anmeldefehler
Dieser Abschnitt enthält Vorschläge zur Behebung SAML-spezifischer Fehler, die bei der Anmeldung durch einen Nutzer einer Mitarbeiteridentitätsföderation auftreten können.
Die Signatur in SAMLResponse konnte nicht verifiziert werden
Dieser Fehler tritt bei einem Anbieter von SAML-Workforce Identity-Pools auf, wenn die Signatur in der Antwort des IdP nicht mit einem der X.509-Zertifikate verifiziert werden kann, die Sie in der XML-Datei der IdP-Metadaten angeben, welche Sie bei Ihrem Anbieter von Workforce Identity-Pools konfiguriert haben. Eine häufige Ursache für diesen Fehler ist, dass das Verifizierungszertifikat bei Ihrem IdP rotiert wurde, Sie aber die Konfiguration des Anbieters von Workforce Identity-Pools nicht mit der neuesten XML-Datei der IdP-Metadaten aktualisiert haben.
Führen Sie folgende Schritte aus, um diesen Fehler zu beheben:
Optional: Führen Sie die Schritte unter IdP-Antwort prüfen aus, um die vom IdP zurückgegebene Antwort zu sehen und das Feld
X509Certificatedarin zu finden. Beschreiben Sie den Anbieter, mit dem Sie sich angemeldet haben, und prüfen Sie das FeldX509Certificateim WertidpMetadataXml, der für den Anbieter von Workforce Identity-Pools festgelegt ist. Vergleichen Sie das Zertifikat mit dem Zertifikat in der Antwort Ihres IdP. Die Zertifikate müssen übereinstimmen.Melden Sie sich in der Admin-Konsole Ihres IdP an und laden Sie die aktuelle Metadaten-XML-Datei herunter.
Aktualisieren Sie den Anbieter von Workforce Identity-Pools für Workloads mit der heruntergeladenen IdP-Metadaten-XML.
Versuchen Sie noch einmal, sich anzumelden.
Der Empfänger in der SAML-Assertion ist nicht auf die richtige ACS-URL festgelegt.
Dieser Fehler tritt bei einem Anbieter von SAML-Workforce Identity-Pools auf, wenn die IdP-Antwort einen falschen Wert für das Feld Recipient im Tag SubjectConfirmationData enthält.
Um diesen Fehler zu beheben, aktualisieren Sie das Recipient URL / Redirect URL oder das entsprechende Feld in der Konfiguration Ihres IdP, um die Weiterleitungs-URL zu verwenden, die unter Weiterleitungs-URLs in Ihrem IdP einrichten beschrieben wird, und versuchen Sie es noch einmal.
Führen Sie die Schritte unter IdP-Antwort prüfen aus, um die vom IdP zurückgegebene Antwort zu sehen und zu bestätigen, ob das Feld Recipient korrekt ist.
Für den Anbieter von SAML-Workforce Identity-Pools locations/global/workforcePools/example-pool/providers/example-provider wird beispielsweise der Recipient, der die Weiterleitungs-URL enthält, in der SAML-Antwort des IdP so angezeigt:
<SubjectConfirmationData Recipient="https://auth.cloud.google/signin-callback/locations/global/workforcePools/example-pool/providers/example-provider"
SAMLResponse-Ziel stimmt nicht mit der RP-Callback-URL überein
Dieser Fehler tritt bei einem Anbieter von SAML-Workforce Identity-Pools auf, wenn die IdP-Antwort einen falschen Wert für das Feld Destination im Tag Response enthält.
Aktualisieren Sie zur Behebung dieses Problems Destination URL / Redirect URL oder das äquivalent Feld in der Konfiguration Ihres IdP zur Verwendung der hier beschriebenen Weiterleitungs-URL in Weiterleitungs-URLs bei Ihrem IdP einrichten.
Führen Sie die Schritte unter IdP-Antwort prüfen aus, um die vom IdP zurückgegebene Antwort zu sehen und zu bestätigen, dass das Feld Destination korrekt ist.
Bei einem Anbieter von Workforce Identity-Pools locations/global/workforcePools/example-pool/providers/example-provider würde der Destination, der die Weiterleitungs-URL enthält, beispielsweise in der SAML-Antwort des IdP so angezeigt werden:
<Response Destination="https://auth.cloud.google/signin-callback/locations/global/workforcePools/example-pool/providers/example-provider"
Ungültige Assertion: NameID fehlt oder ist leer
Dieser Fehler tritt auf, wenn die von Ihrem IdP empfangene SAML-Antwort das Feld NameId nicht enthält oder einen leeren Wert hat.
Um diesen Fehler zu beheben, konfigurieren Sie Ihre IdP-Dokumentation so, dass sie NameID sendet, was das Thema einer SAML-Assertion ist, in der Regel der authentifizierte Nutzer.
Führen Sie die Schritte unter IdP-Antwort prüfen aus, um die vom IdP zurückgegebene Antwort und die darin festgelegte NameID zu sehen.
Alle <AudienceRestriction>-Objekte sollten die SAML-RP-Entitäts-ID enthalten.
Dieser Fehler tritt auf, wenn die AudienceRestriction-Tags in der SAML-Antwort von Ihrem IdP kein Audience-Tag mit einem Wert festlegen, der die Entitäts-ID des Anbieters von Workforce Identity-Pools darstellt.
Führen Sie folgende Schritte aus, um diesen Fehler zu beheben:
In der Dokumentation Ihres IdP finden Sie Informationen dazu, wie Sie die Zielgruppe in den
AudienceRestriction-Tags konfigurieren, die in der SAML-Antwort gesendet werden. In der Regel wird die Zielgruppe durch Einrichten des FeldsEntity IDoderAudiencein Ihrer IdP-Konfiguration konfiguriert. Weitere Informationen zu dem festzulegenden WertSP Entity IDfinden Sie im SAML-Abschnitt zum Erstellen eines Anbieters von Mitarbeiteridentitätsföderations-Pools.Versuchen Sie nach dem Aktualisieren der IdP-Konfiguration noch einmal, sich anzumelden.
Führen Sie die Schritte unter IdP-Antwort prüfen aus, um die vom IdP zurückgegebene Antwort und die darin festgelegten AudienceRestrictions zu sehen.
SCIM-Anmeldefehler
In diesem Abschnitt wird beschrieben, wie Sie SCIM-spezifische Fehler beheben, die bei der Anmeldung durch einen Nutzer einer Mitarbeiteridentitätsföderation auftreten können.
SCIM-Mandant wurde nicht gefunden
Dieser Fehler tritt auf, wenn ein Nutzer versucht, sich über einen Anbieter von Workforce Identity-Pools anzumelden, der für die Verwendung von SCIM konfiguriert ist, aber für diesen Anbieter kein SCIM-Mandant konfiguriert ist.
In diesem Fall erhalten Nutzer beim Anmeldeversuch die folgende Fehlermeldung:
There was an issue signing in with your identity provider.
So beheben Sie diesen Fehler für Ihren Identitätsanbieter:
- Konfigurieren Sie einen SCIM-Mandanten und ein SCIM-Token auf Google Cloud (Microsoft Entra ID | Okta).
- Verknüpfen Sie den Anbieter mit einem SCIM-Mandanten (Microsoft Entra ID | Okta).
Anmeldung schlägt fehl, wenn die SCIM-Nutzung für Nutzer und Gruppen aktiviert ist
Wenn --scim-usage auf enabled-for-users-groups gesetzt ist, können Web- und OAuth-Anmeldeversuche mit den folgenden Fehlermeldungen fehlschlagen:
SCIM-Nutzer nicht gefunden oder inaktiv:
- Fehler:
The workforce identity pool provider is configured to use identity information that is provided using SCIM, but a SCIM User could not be associated with the google.subject from the given credential.oder... the SCIM User associated with the google.subject from the given credential is not active. - Ursache: Der Nutzer wurde nicht über SCIM mit Google Cloud synchronisiert, die zugeordnete
google.subjectim Anbieter stimmt nicht mit der SCIM-Nutzerzuordnung überein oder der Nutzer ist im IdP alsactive: falsemarkiert. - Lösung: Prüfen Sie in Ihrem IdP, ob der Nutzer über SCIM bereitgestellt wird, ob sein Status aktiv ist und ob die Zuordnung der Anbieterattribute und die Zuordnung der SCIM-Mandantenansprüche für
google.subjectauf dieselbe Identität verweisen.
- Fehler:
CEL-Auswertungs- oder Claim-Mapping-Fehler:
- Fehler:
Failed to map attributes from the given credential with SCIM Tenant config. - Ursache: Ein CEL-Ausdruck in
--claim-mappingist ungültig oder die Auswertung ist fehlgeschlagen. - Lösung: Prüfen Sie die
--claim-mapping-Ausdrücke Ihres SCIM-Mandanten, um sicherzustellen, dass die CEL-Syntax gültig ist und die Attributnamen unterstützt werden.
- Fehler:
Größenbeschränkungen für zugeordnete Attribute überschritten:
- Fehler:
The size of SCIM mapped attribute google.display_name exceeds the 100 bytes limit.oderThe size of entire SCIM mapped attributes exceeds the 16 kB limit. - Ursache: Ein einzelnes zugeordnetes Attribut hat seine Größenbeschränkung überschritten (z. B. 100 Byte für
google.display_name, 32 Byte fürgoogle.posix_username, 127 Byte fürgoogle.subject) oder die gesamten serialisierten zugeordneten Anforderungen haben 16 kB überschritten. - Lösung: Passen Sie die Claim-Zuordnungen für den SCIM-Mandanten an oder aktualisieren Sie die IdP-Attributwerte, damit sie innerhalb der zulässigen Limits bleiben.
- Fehler:
SCIM-Bereitstellungs- und Synchronisierungsfehler
In diesem Abschnitt wird beschrieben, wie Sie Probleme mit der SCIM-Bereitstellung und ‑Synchronisierung in der Workforce Identity-Föderation beheben.
Fehler bei der SCIM-Tokenauthentifizierung (HTTP 401 oder 403)
Dieser Fehler tritt auf, wenn in den Logs des Identitätsanbieters (IdP) Authentifizierungsfehler (HTTP 401 Unauthorized oder HTTP 403 Forbidden) gemeldet werden. Häufige Ursachen sind:
- Das SCIM-Token fehlt, ist ungültig oder abgelaufen.
- Das SCIM-Token enthält zusätzliche Leerzeichen.
- In der Anfrage fehlt der Header
Authorization: Bearer <TOKEN>. - Das SCIM-Token hat nicht genügend Berechtigungen.
So beheben Sie das Problem:
- Prüfen Sie in der IdP-Bereitstellungskonfiguration, ob das SCIM-Token mit dem in Google Cloud generierten Secret-Token übereinstimmt, ohne zusätzliche Leerzeichen.
Wenn das Token verloren gegangen oder ungültig ist, generieren Sie ein neues SCIM-Token:
gcloud iam workforce-pools providers scim-tenants tokens create SCIM_TOKEN_ID \ --workforce-pool="WORKFORCE_POOL_ID" \ --provider="PROVIDER_ID" \ --scim-tenant="SCIM_TENANT_ID" \ --location="global"Ersetzen Sie Folgendes:
SCIM_TOKEN_ID: eine ID für das neue SCIM-Token.WORKFORCE_POOL_ID: die ID des Workforce Identity-Pools.PROVIDER_ID: die ID des Anbieters des Workforce-Pools.SCIM_TENANT_ID: die ID des SCIM-Mandanten.
Aktualisieren Sie das Secret-Token in Ihrer IdP-Konfiguration.
Ratenbegrenzung überschritten (HTTP 429 Too Many Requests)
Dieser Fehler tritt auf, wenn die IdP-Anforderungsraten das SCIM-Mandantenkontingent überschreiten. Standardmäßig sind Schreib- und Leseanfragen auf 3.000 Anfragen pro SCIM-Mandant pro Organisation pro Minute beschränkt. Das entspricht 50 Abfragen pro Sekunde (QPS). Weitere Informationen finden Sie unter Kontingente und Limits.
So beheben Sie das Problem:
- Prüfen Sie, ob die Rate der Synchronisierungsanfragen Ihres IdP innerhalb der Kontingentlimits liegt.
- Rufen Sie in der Google Cloud Console IAM & Verwaltung > Kontingente auf und filtern Sie nach
iamscim.googleapis.com, um die Kontingentnutzung zu überwachen. - Wenn Sie einen höheren Durchsatz benötigen, fordern Sie in der Google Cloud Console eine Kontingenterhöhung an.
SCIM-Mandant kann nicht erstellt werden
Dieser Fehler tritt auf, wenn der Befehl gcloud iam workforce-pools providers scim-tenants create fehlschlägt.
Häufige Ursachen sind:
- Im Workforce-Pool ist bereits ein SCIM-Mandant vorhanden. Jeder Personalpool unterstützt nur einen SCIM-Mandanten.
- Ein vor Kurzem gelöschter SCIM-Mandant befindet sich noch in der 30-tägigen Frist für das vorläufige Löschen.
- Sie haben nicht die Rolle „IAM Workforce Pool Admin“ (
roles/iam.workforcePoolAdmin). - Das Flag
--claim-mappingenthält nicht unterstützte CEL-Ausdrücke (Common Expression Language).
So beheben Sie das Problem:
- Prüfen Sie, ob Sie die IAM-Rolle „Workforce Pool Admin“ (
roles/iam.workforcePoolAdmin) haben. Listen Sie vorhandene SCIM-Mandanten auf, um zu prüfen, ob ein Mandant bereits vorhanden ist:
gcloud iam workforce-pools providers scim-tenants list \ --workforce-pool="WORKFORCE_POOL_ID" \ --provider="PROVIDER_ID" \ --location="global"Ersetzen Sie Folgendes:
WORKFORCE_POOL_ID: die ID des Workforce Identity-Pools.PROVIDER_ID: die ID des Anbieters des Workforce-Pools.
Wenn ein zuvor gelöschter Mandant vorläufig gelöscht wurde, löschen Sie ihn mit dem Flag
--hard-deleteendgültig:gcloud iam workforce-pools providers scim-tenants delete SCIM_TENANT_ID \ --workforce-pool="WORKFORCE_POOL_ID" \ --provider="PROVIDER_ID" \ --location="global" \ --hard-deleteErsetzen Sie
SCIM_TENANT_IDdurch die ID des SCIM-Mandanten.Achten Sie darauf, dass für
--claim-mappingnur unterstützte CEL-Ausdrücke verwendet werden. Weitere Informationen finden Sie unter Anspruchszuordnung.
SCIM-Token kann nicht erstellt werden
Dieser Fehler tritt auf, wenn der Befehl gcloud iam workforce-pools providers scim-tenants tokens create fehlschlägt.
Häufige Ursachen sind:
- Der SCIM-Mandant hat bereits die maximale Anzahl von zwei SCIM-Tokens.
- Sie haben nicht die Rolle „IAM Workforce Pool Admin“ (
roles/iam.workforcePoolAdmin).
So beheben Sie das Problem:
- Prüfen Sie, ob Sie die IAM-Rolle „Workforce Pool Admin“ (
roles/iam.workforcePoolAdmin) haben. Listen Sie vorhandene SCIM-Tokens auf, um zu prüfen, ob das Limit von zwei Tokens erreicht wurde:
gcloud iam workforce-pools providers scim-tenants tokens list \ --workforce-pool="WORKFORCE_POOL_ID" \ --provider="PROVIDER_ID" \ --scim-tenant="SCIM_TENANT_ID" \ --location="global"Ersetzen Sie Folgendes:
WORKFORCE_POOL_ID: die ID des Workforce Identity-Pools.PROVIDER_ID: die ID des Anbieters des Workforce-Pools.SCIM_TENANT_ID: die ID des SCIM-Mandanten.
Wenn der SCIM-Mandant bereits zwei Tokens hat, löschen Sie ein nicht verwendetes oder ungültiges Token:
gcloud iam workforce-pools providers scim-tenants tokens delete SCIM_TOKEN_ID \ --workforce-pool="WORKFORCE_POOL_ID" \ --provider="PROVIDER_ID" \ --scim-tenant="SCIM_TENANT_ID" \ --location="global"Ersetzen Sie
SCIM_TOKEN_IDdurch die ID des zu löschenden SCIM-Tokens.Versuchen Sie nach dem Löschen des Tokens noch einmal, das neue SCIM-Token zu erstellen.
Konflikt bei doppelter Attributzuordnung (HTTP 409 Conflict)
Dieser Fehler tritt auf, wenn in den Protokollen des Identitätsanbieters (IdP) während der Synchronisierung ein HTTP 409 Conflict gemeldet wird, weil der IdP doppelte Werte für google.subject oder google.group oder nicht eindeutige userName- oder displayName-Werte sendet.
So beheben Sie das Problem:
- Prüfen Sie in der Verwaltungskonsole Ihres IdP, ob die Attribute, die
google.subjectundgoogle.groupzugeordnet sind, sich nicht überschneidende Werte erzeugen. - Jeder Nutzer muss eine eindeutige
userNameund jede Gruppe eine eindeutigedisplayNamehaben.
Microsoft Entra ID-PATCH-Anfragen schlagen fehl
Dieser Fehler tritt auf, wenn Nutzeraktualisierungen oder PATCH-Anfragen von Microsoft Entra ID fehlschlagen, weil in der Mandanten-URL der Suchparameter ?aadOptscim062020 fehlt, der für RFC-konforme PATCH-Anfragen erforderlich ist.
So beheben Sie das Problem:
- Rufen Sie in Microsoft Entra ID Ihre Unternehmensanwendung auf und wählen Sie Bereitstellung > Bereitstellung verwalten > Administratoranmeldedaten aus.
Hängen Sie im Feld Mandanten-URL
?aadOptscim062020an den Basis-URI an:https://iamscim.googleapis.com/v1alpha1/tenants/SCIM_TENANT_UID?aadOptscim062020Ersetzen Sie
SCIM_TENANT_UIDdurch die eindeutige ID Ihres SCIM-Mandanten.Klicken Sie auf Verbindung testen und speichern Sie die Konfiguration.
Nutzer- oder gruppenbasierter Zugriff oder Freigabe funktioniert nicht
Dieses Problem tritt auf, wenn synchronisierte Nutzer nicht auf Google Cloud-Ressourcen zugreifen können oder wenn das Freigeben von Notebooks in Gemini Notebook für Unternehmen oder von Agenten in der Gemini Enterprise-App fehlschlägt.
Häufige Ursachen sind:
- Unbemerkte Synchronisierungsfehler oder Verzögerungen beim IdP.
- Inkonsistente Claim-Zuordnungen zwischen dem Anbieter (
--attribute-mapping) und dem SCIM-Mandanten (--claim-mapping). - Änderungen im IdP an Attributen, die
google.subjectodergoogle.groupzugeordnet sind. Google Cloud erwartet, dass Werte, die diesen Attributen zugeordnet sind, unveränderlich sind. - Die SCIM-Nutzung ist für Gruppen beim Anbieter nicht aktiviert.
So beheben Sie das Problem:
Synchronisierung und Mitgliedschaft prüfen: Bestätigen Sie, dass Nutzer, Gruppen und Gruppenmitgliedschaften erfolgreich mit Google Cloudsynchronisiert wurden:
Nutzersynchronisierung prüfen:
curl -G -H "Authorization: Bearer SCIM_TOKEN" \ "https://iamscim.googleapis.com/v1alpha1/tenants/SCIM_TENANT_UID/Users" \ --data-urlencode 'filter=userName eq "USER_NAME"'Gruppensynchronisierung prüfen:
curl -G -H "Authorization: Bearer SCIM_TOKEN" \ "https://iamscim.googleapis.com/v1alpha1/tenants/SCIM_TENANT_UID/Groups" \ --data-urlencode 'filter=displayName eq "GROUP_NAME"'Gruppenmitgliedschaft prüfen: Bestätigen Sie, dass ein Nutzer Mitglied einer Gruppe ist:
curl -G -H "Authorization: Bearer SCIM_TOKEN" \ "https://iamscim.googleapis.com/v1alpha1/tenants/SCIM_TENANT_UID/Groups" \ --data-urlencode 'filter=id eq "GROUP_ID" and members eq "USER_ID"'Wenn der Nutzer Mitglied der Gruppe ist, wird in der Antwort
totalResults: 1zurückgegeben. Wenn der Nutzer kein Mitglied ist, wirdtotalResults: 0zurückgegeben.
Ersetzen Sie Folgendes:
SCIM_TOKEN: Ihr SCIM-Secret-Token.SCIM_TENANT_UID: die eindeutige ID Ihres SCIM-Mandanten.USER_NAME: der Nutzername des synchronisierten Nutzers.GROUP_NAME: der Anzeigename der synchronisierten Gruppe.GROUP_ID: die SCIM-ID der synchronisierten Gruppe, die im Feldidder Antwort auf die Gruppenabfrage zurückgegeben wird.USER_ID: die SCIM-ID des synchronisierten Nutzers, die im Feldidder Antwort auf die Nutzerabfrage zurückgegeben wird.
Claim-Mappings prüfen: Achten Sie darauf, dass das Attribut, das im Anbieter
google.subjectzugeordnet ist (z. B.google.subject=assertion.email.lowerAscii()), mit der Identität übereinstimmt, die im SCIM-Mandanten zugeordnet ist (z. B.google.subject=user.emails[0].value.lowerAscii()). Da Claim-Mappings unveränderlich sind, müssen Sie bei inkonsistenten Zuordnungen den SCIM-Mandanten endgültig löschen und mit der richtigen Zuordnung neu erstellen.Unveränderlichkeit der Kennung sicherstellen: Prüfen Sie, ob sich die IdP-Attribute, die
google.subjectundgoogle.groupzugeordnet sind, nicht geändert haben. Google Cloudbehandelt Werte, die diesen Attributen zugeordnet sind, als unveränderliche Kennungen. Wenn sich ein Attributwert in Ihrem IdP geändert hat, machen Sie die Änderung in Ihrem IdP rückgängig oder löschen Sie den betroffenen Nutzer oder die betroffene Gruppe dauerhaft aus Ihrem IdP und erstellen Sie ihn oder sie mit dem neuen Wert neu, sodass die Kennung mit den Erwartungen von Google Cloudübereinstimmt.SCIM-Gruppennutzung aktivieren: Aktualisieren Sie Ihren Anbieter, um SCIM für Gruppen zu aktivieren:
gcloud iam workforce-pools providers update-oidc PROVIDER_ID \ --workforce-pool="WORKFORCE_POOL_ID" \ --location="global" \ --scim-usage="enabled-for-groups"Ersetzen Sie Folgendes:
PROVIDER_ID: die ID des Anbieters des Workforce-Pools.WORKFORCE_POOL_ID: die ID des Workforce Identity-Pools.
Änderungen im IdP werden verzögert oder nicht übernommen
Dieses Problem tritt auf, wenn IdP-Aktualisierungen für Nutzer, Gruppenmitgliedschaften oder Löschungen nicht sofort in Google Cloudangezeigt werden.
Da SCIM pushbasiert ist, hängen Aktualisierungen vom Synchronisierungszeitplan Ihres IdP ab. Microsoft Entra ID wird beispielsweise etwa alle 40 Minuten synchronisiert.
So beheben Sie das Problem:
- Warten Sie auf den nächsten geplanten Synchronisierungszyklus Ihres IdP.
- Wenn Sie Änderungen sofort übernehmen möchten, lösen Sie in der Verwaltungskonsole Ihres IdP eine On-Demand-Synchronisierung aus.
Nutzerverwaltung schlägt aufgrund des E-Mail-Formats fehl
Dieser Fehler tritt auf, wenn bestimmte Nutzer nicht mit Google Cloudsynchronisiert werden können und in den Logs Ihres Identitätsanbieters (IdP) ein HTTP-400 Bad Request-Fehler mit einem SCIM-Fehler vom Typ invalidValue gemeldet wird.
Google Cloud Für SCIM ist genau eine geschäftliche E-Mail-Adresse pro Nutzer erforderlich. Die Bereitstellung schlägt fehl, wenn der IdP mehrere E-Mail-Adressen sendet oder die E-Mail-Adresse nicht vom Typ work ist.
Konfigurieren Sie die IdP-Attributzuordnung so, dass nur die primäre geschäftliche E-Mail-Adresse gesendet wird, um dieses Problem zu beheben.
Gruppenaktualisierungen schlagen fehl (HTTP PUT wird nicht unterstützt)
Dieser Fehler tritt auf, wenn Gruppenaktualisierungen fehlschlagen, weil der Client HTTP PUT verwendet, was nicht unterstützt wird. Die Google Cloud SCIM API unterstützt nur HTTP PATCH für Gruppenaktualisierungen.
Konfigurieren Sie Ihren IdP oder benutzerdefinierten Client so, dass für Gruppenaktualisierungen HTTP-PATCH verwendet wird.
Anbieteraktualisierung schlägt mit sich gegenseitig ausschließenden Konfigurationen fehl
Dieser Fehler tritt auf, wenn die Erstellung oder Aktualisierung des Anbieters mit einer der folgenden Meldungen fehlschlägt:
Select one of scim_usage - ENABLED_FOR_USERS_GROUPS or extra_attributes_oauth2_client, but not both.Select one of scim_usage or extended_attributes_oauth2_client, but not both.
Die Einstellung --scim-usage=enabled-for-users-groups schließt sich mit den zusätzlichen Attributen (extra_attributes_oauth2_client) und den erweiterten Attributen (extended_attributes_oauth2_client) gegenseitig aus.
Entfernen Sie die in Konflikt stehende Konfiguration für zusätzliche oder erweiterte Attribute vom Anbieter oder ändern Sie die Einstellung --scim-usage, um dieses Problem zu beheben.
Fehler beim Austausch von Cloud OAuth API-Tokens
Wenn eine Tokenaustauschanfrage fehlschlägt, gibt die Cloud OAuth API den HTTP-Status 400 Bad Request oder 401 Unauthorized mit einer OAuth 2.0-Fehler-JSON-Antwort (RFC 6749) zurück. Das Feld error gibt einen der folgenden Fehlercodes an:
| Fehlercode | Beschreibung | Zeitersparnis |
|---|---|---|
invalid_request |
In der Anfrage fehlt ein erforderlicher Parameter, sie enthält einen ungültigen Parameterwert, sie enthält einen Parameter mehr als einmal oder sie ist anderweitig fehlerhaft. |
Prüfen Sie, ob alle erforderlichen URL-codierten Parameter (grant_type, code oder refresh_token, redirect_uri) angegeben sind.
|
invalid_client |
Clientauthentifizierung fehlgeschlagen. |
Prüfen Sie, ob die registrierten OAuth-Werte client_id und client_secret übereinstimmen, ob der OAuth-Client für Ihren Workforce Identity-Pool aktiviert ist und ob der Header Authorization: Basic korrekt Base64-codiert ist.
|
invalid_grant |
Der angegebene Autorisierungscode oder das Aktualisierungstoken ist ungültig, abgelaufen, widerrufen, stimmt nicht mit dem in der Autorisierungsanfrage verwendeten Weiterleitungs-URI überein oder wurde für einen anderen Client ausgestellt. | Achten Sie darauf, dass der Code oder das Token nicht abgelaufen ist oder bereits eingelöst wurde. |
unauthorized_client |
Der authentifizierte OAuth-Client ist nicht berechtigt, die angeforderte grant_type zu verwenden.
|
Prüfen Sie, ob Ihre OAuth-Clientregistrierung die Gewährung von Autorisierungscodes oder Aktualisierungstokens zulässt. |
unsupported_grant_type |
Der Autorisierungs-Genehmigungstyp wird vom Autorisierungsserver nicht unterstützt. |
Legen Sie für grant_type den Wert authorization_code oder refresh_token fest.
|
invalid_scope |
Der angeforderte Bereich ist ungültig, unbekannt, fehlerhaft oder überschreitet die vom Ressourceninhaber gewährten Bereiche. | Prüfen Sie, ob die angeforderten Bereiche mit den auf dem OAuth-Client konfigurierten Bereichen übereinstimmen und für Ihre Anwendung gültig sind. |
resource_exhausted |
Die Anfrage hat das Kontingent für den Cloud OAuth API-Tokenaustausch überschritten. | Prüfen Sie Ihre API-Nutzung in der Google Cloud Console oder fordern Sie eine Kontingenterhöhung an. |
Cloud OAuth-Nutzerinformationen und -Gruppenfehler
Wenn eine Anfrage an den Endpunkt /userinfo oder /groups fehlschlägt, gibt die Cloud OAuth API einen HTTP-Status 400 Bad Request, 401 Unauthorized oder 403 Forbidden mit einer OAuth 2.0-Inhabertoken-Fehlerantwort (RFC 6750 / OpenID Connect Core) zurück.
Das Feld error gibt einen der folgenden Fehlercodes an:
| Fehlercode | HTTP-Status | Beschreibung | Zeitersparnis |
|---|---|---|---|
invalid_request |
400 Bad Request/401 Unauthorized |
In der Anfrage fehlt der erforderliche Authorization-Header oder der Header ist fehlerhaft (er beginnt beispielsweise nicht mit Bearer).
|
Prüfen Sie, ob der Header Authorization: Bearer ACCESS_TOKEN richtig formatiert ist.
|
invalid_token |
401 Unauthorized |
Das angegebene Zugriffstoken ist ungültig, abgelaufen oder wurde widerrufen. |
Aktualisieren Sie das Zugriffstoken mit dem Grant refresh_token oder wiederholen Sie den Autorisierungscode-Vorgang.
|
insufficient_scope |
403 Forbidden |
Das Zugriffstoken hat nicht den erforderlichen openid-Bereich oder der Mandant des Tokens stimmt nicht mit der Organisation überein, die in der organisationsbezogenen Endpunkt-URL angegeben ist.
|
Prüfen Sie, ob das Token mit dem erforderlichen openid-Bereich angefordert wurde und ob Sie den richtigen Endpunkt aufrufen.
|