Wenn Sie Authentifizierungsprobleme in der Workload Identity-Föderation diagnostizieren und beheben möchten, sehen Sie sich die häufigen Fehlerantworten und die Konfigurationseinstellungen des Anbieters an. Sie können Token-Anforderungen, Organisationsrichtlinien und die Netzwerkverbindung prüfen, um die Ursachen zu ermitteln und den Zugriff für externe Arbeitslasten wiederherzustellen.
DieGoogle Cloud API akzeptiert keine von SecurityTokenService ausgestellten Anmeldedaten
Zugriffstokens, die von der SecurityTokenService API zurückgegeben werden, sind föderierte Zugriffstokens.
Die meisten Google Cloud APIs unterstützen zwar die Identitätsföderation, doch haben einige API-Methoden möglicherweise Einschränkungen. Eine Liste der Einschränkungen finden Sie unter Identitätsföderation: Produkte und Einschränkungen.
Wenn der folgende Fehler auftritt, versuchen Sie möglicherweise, ein föderiertes Zugriffstoken mit einem Dienst zu verwenden, der diese nicht unterstützt.
{
"error": {
"code": 401,
"message": "Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential. See https://developers.google.com/identity/sign-in/web/devconsole-project.",
"status": "UNAUTHENTICATED",
}
}
Um diesen Fehler zu beheben, tauschen Sie das föderierte Zugriffstoken gegen ein uneingeschränktes Zugriffstoken aus, indem Sie GenerateAccessToken aufrufen.
Weitere Informationen finden Sie unter Kurzlebige Anmeldedaten mit Identitätsföderation abrufen.
Identitätsanbieter zur Verwendung mit der Workload Identity-Föderation zulassen
Wenn Sie versuchen, einen nicht zulässigen Identitätsanbieter als Workload Identity-Poolanbieter zu konfigurieren, tritt der folgende Fehler auf:
FAILED_PRECONDITION: Precondition check failed.
- '@type': type.googleapis.com/google.rpc.PreconditionFailure
violations:
- description: "Org Policy violated for value: '{PROVIDER}'."
subject: orgpolicy:projects/{PROJECT}/locations/global/workloadIdentityPools/{POOL}
type: constraints/iam.workloadIdentityPoolProviders
Folgen Sie der Anleitung unter Konfiguration des Identitätsanbieters einschränken, um dieses Problem zu beheben und den Identitätsanbieter für die Verwendung mit der Workload Identity-Föderation zuzulassen.
Der Eingabe-JWK hat kein gültiges JSON-Format
Wenn Sie einen OIDC-Anbieter konfigurieren und den Fehler Input JWK is
not in a valid json format erhalten, kann das daran liegen, dass Endpunkte, die mit selbst signierten Zertifikaten gesichert sind, von Google Cloudnicht unterstützt werden. Insbesondere werden die Felder x5c und x5t nicht unterstützt und müssen aus dem OIDC-JWK entfernt werden.
So beheben Sie Probleme mit Ihrem JWK:
Bearbeiten Sie Ihren JWK und entfernen Sie die Felder
x5c(X.509-Zertifikatskette) undx5t(X.509-Zertifikat-SHA-1-Fingerabdruck).{ "kty": "RSA", "use": "sig", "kid": "example-key-id", "alg": "RS256", "n": "base64url-modulus", "e": "AQAB" }Prüfen Sie, ob die verbleibenden JWK-Felder wie in der OIDC-Spezifikation beschrieben formatiert sind.
Konfigurieren Sie den OIDC-Anbieter mit dem aktualisierten JWK.
Fehler beim Herstellen einer Verbindung zum Aussteller des angegebenen Ausweises
Wenn Sie den folgenden Fehler erhalten, kann es sein, dass Google Cloud das OIDC-Metadatendokument oder die JWKS Ihres IdP nicht abrufen kann:
{
"error": "invalid_grant",
"error_description":"Error connecting to the given credential's issuer."
}
Dieser Fehler tritt normalerweise auf, weil die Endpunkte nicht so konfiguriert sind, dass sie über das öffentliche Internet erreichbar sind. Prüfen Sie, ob der OIDC-Endpunkt öffentlich verfügbar ist und der OIDC-Spezifikation entspricht, um diesen Fehler zu beheben. Weitere Informationen finden Sie unter Externen Identitätsanbieter vorbereiten.
Wenn der Fehler weiterhin auftritt, prüfen Sie, ob der Tokenaussteller, die iss-Anforderung im Token, korrekt ist.
Die angegebene AWS-Anfrage enthält nicht alle erforderlichen Header
Wenn Sie beim Anfordern eines Tokens von der SecurityTokenService API den folgenden Fehler erhalten, liegt das daran, dass im Feld headers Ihres AWS-GetCallerIdentity-Tokens ein erforderlicher Header fehlt oder nicht unterstützte Header enthalten sind:
{
"error": "invalid_grant",
"error_description": "The given AWS request doesn't contain all the required headers."
}
Das Feld headers eines GetCallerIdentity-Tokens darf nur die folgenden HTTP-Anfrageheader enthalten:
Authorization: Die Anfragesignatur.host: Der Hostname des Feldsurl, z. B.sts.amazonaws.com.x-amz-date: Der Zeitpunkt, an dem Sie die Anfrage senden, angegeben im Stringformat ISO 8601 Basic.x-goog-cloud-target-resource: Der vollständige Ressourcenname des Workload Identity-Poolanbieters.x-amz-security-token: Das Sitzungstoken. Nur erforderlich, wenn Sie temporäre Sicherheitsanmeldedaten verwenden.
Dieser Fehler tritt auch auf, wenn der Signierer der Signaturversion 4 zusätzliche Header wie x-amz-content-sha256 in die signierte Anfrage einfügt. Achten Sie darauf, dass Ihre GetCallerIdentity-Anfrage einen leeren Text enthält und dass sowohl das Feld headers als auch das Feld SignedHeaders der signierten Anfrage nur die unterstützten Header enthalten. Weitere Informationen finden Sie unter Arbeitslast mit der REST API authentifizieren.
Zugeordnete „google.subject“-Anforderung überschreitet das Limit von 127 Byte
Wenn Sie die folgende Fehlermeldung erhalten, liegt das daran, dass die eingehenden Anmeldedaten, die von der SecurityTokenService API empfangen werden, eine google.subject-Anforderung generieren, die die Zeichenbeschränkung überschreitet:
{
"error": "invalid_request",
"error_description":"The size of mapped attribute google.subject exceeds the 127 bytes limit. Either modify your attribute mapping or the incoming assertion to produce a mapped attribute that is less than 127 bytes."
}
Verwenden Sie zur Behebung dieses Problems die Funktion extract, um unnötige Zeichen zu entfernen und eine eindeutige Subjekt-ID aus einer längeren Anforderung zu extrahieren, z. B.:
google.subject=assertion.sub.extract('/users/{sub_claim}')
Fehler 429: Zu viele Anfragen
Wenn Sie beim Anfordern eines Tokens von der SecurityTokenService API den Fehler 429 Too Many Requests erhalten, bedeutet dies, dass Ihr Google Cloud -Projekt das Ratenkontingentlimit für die API überschritten hat.
Der Fehler enthält eine Meldung wie die folgende:
{
"error": "quota_exceeded",
"error_description":"The request was throttled due to rate limit: sts.googleapis.com/requests. Please retry after a few seconds."
}
Um dieses Problem zu beheben, ermitteln Sie den Messwertnamen sts.googleapis.com/requests, der in der Fehlermeldung angegeben ist, suchen Sie den entsprechenden Messwertnamen auf der Seite „IAM-Kontingente“, prüfen Sie, ob der Nutzungsprozentsatz das Kontingent überschreitet, und fordern Sie dann eine Kontingenterhöhung an.