Mit der Workload Identity-Föderation können Sie externen Arbeitslasten über Workload Identity-Pools und verbundene Identitätsanbieter (IdPs) Zugriff aufGoogle Cloud -Ressourcen gewähren. Wenn sich Ihre Anforderungen ändern, können Sie Pools und Anbieter mit derGoogle Cloud Console, der Google Cloud CLI oder der REST API erstellen, ansehen, aktualisieren, löschen oder wiederherstellen.
Hinweis
Erstellen Sie einen Workload Identity-Pool. Eine Anleitung finden Sie in den Konfigurationsanleitungen für die Workload Identity-Föderation.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die benötigten Berechtigungen zum Verwalten von Workload Identity-Pools und Anbietern zu erhalten:
-
Um Pools und Anbieter aufzurufen: IAM Workload Identity Pool Viewer (
roles/iam.workloadIdentityPoolViewer) -
So können Sie Pools und Anbieter aufrufen, erstellen, aktualisieren und löschen: IAM Workload Identity-Pooladministrator (
roles/iam.workloadIdentityPoolAdmin)
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Verwalten von Workload Identity-Pools und Anbietern erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind zum Verwalten von Workload Identity-Pools und -Anbietern erforderlich:
-
So rufen Sie Workload Identity-Pools und -Anbieter auf:
-
iam.googleapis.com/workloadIdentityPoolProviders.get -
iam.googleapis.com/workloadIdentityPoolProviders.list -
iam.googleapis.com/workloadIdentityPools.get -
iam.googleapis.com/workloadIdentityPools.list
-
-
So erstellen, aktualisieren und löschen Sie Pools und Anbieter:
-
iam.googleapis.com/workloadIdentityPoolProviders.create -
iam.googleapis.com/workloadIdentityPoolProviders.delete -
iam.googleapis.com/workloadIdentityPoolProviders.undelete -
iam.googleapis.com/workloadIdentityPoolProviders.update -
iam.googleapis.com/workloadIdentityPools.create -
iam.googleapis.com/workloadIdentityPools.delete -
iam.googleapis.com/workloadIdentityPools.undelete -
iam.googleapis.com/workloadIdentityPools.update
-
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Workload Identity-Pools verwalten
In diesem Abschnitt wird gezeigt, wie Sie Workload Identity-Pools verwalten.
Pools erstellen
So erstellen Sie Workload Identity-Pools in einem Projekt:
Console
-
Rufen Sie in der Google Cloud Console die Seite Neuer Arbeitslastanbieter und -pool auf.
-
Geben Sie im Abschnitt Identitätspool erstellen einen Namen für den Pool ein.
Die Google Cloud Console verwendet den Namen zum Erstellen einer Pool-ID. Klicken Sie zum Ändern der Pool-ID auf Bearbeiten. Sie können die Pool-ID später nicht ändern.
- Optional: Geben Sie im Feld Beschreibung eine Beschreibung für den Pool ein.
- Optional: Wenn Sie den Pool im deaktivierten Zustand erstellen möchten, klicken Sie auf den Ein/Aus-Button Aktivierter Pool.
- Klicken Sie auf Weiter.
- Konfigurieren Sie in den Abschnitten Anbieter zum Pool hinzufügen und Anbieterattribute konfigurieren einen Identitätsanbieter für den Pool. Eine Anleitung hierzu finden Sie unter Anbieter erstellen.
- Klicken Sie auf Speichern.
gcloud
Mit dem Befehl gcloud iam workload-identity-pools create wird ein Workload Identity-Pool in einem Projekt erstellt.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
POOL_ID: Eine eindeutige ID für den Workload Identity-Pool, z. B.my-pool. Muss aus 4–32 kleingeschriebenen alphanumerischen Zeichen oder Bindestrichen bestehen und darf nicht mitgcp-beginnen.PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.DISPLAY_NAME: Optional. Einen Anzeigenamen für den Workload Identity-Pool mit bis zu 32 Zeichen, z. B.My workload pool.DESCRIPTION: Optional. Eine Beschreibung des Workload Identity-Pools mit bis zu 256 Zeichen.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools create POOL_ID \ --project=PROJECT_ID \ --location="global" \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION"
Windows (PowerShell)
gcloud iam workload-identity-pools create POOL_ID ` --project=PROJECT_ID ` --location="global" ` --display-name="DISPLAY_NAME" ` --description="DESCRIPTION"
Windows (cmd.exe)
gcloud iam workload-identity-pools create POOL_ID ^ --project=PROJECT_ID ^ --location="global" ^ --display-name="DISPLAY_NAME" ^ --description="DESCRIPTION"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Create request issued for: [my-pool] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef] to complete...done. Created workloadIdentityPool [my-pool].
REST
Mit der Methode projects.locations.workloadIdentityPools.create wird ein Workload Identity-Pool in einem Projekt erstellt.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Eine eindeutige ID für den Workload Identity-Pool, z. B.my-pool. Muss aus 4–32 kleingeschriebenen alphanumerischen Zeichen oder Bindestrichen bestehen und darf nicht mitgcp-beginnen.DISPLAY_NAME: Optional. Einen Anzeigenamen für den Workload Identity-Pool mit bis zu 32 Zeichen, z. B.My workload pool.DESCRIPTION: Optional. Eine Beschreibung des Workload Identity-Pools mit bis zu 256 Zeichen.
HTTP-Methode und URL:
POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools?workloadIdentityPoolId=POOL_ID
JSON-Text anfordern:
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält einen Vorgang mit langer Ausführungszeit, der Ihre Anfrage darstellt. Informationen dazu, wie Sie prüfen, ob die Poolerstellung abgeschlossen ist, finden Sie auf dieser Seite unter Status eines Vorgangs mit langer Ausführungszeit prüfen.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
},
"done": false
}
Pools auflisten
So listen Sie alle Workload Identity-Pools in einem Projekt auf:
Console
-
Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf.
- Rufen Sie in der Tabelle die Liste der Workload Identity-Pools auf.
- Optional: Wenn Sie gelöschte Pools und Anbieter in die Liste aufnehmen möchten, klicken Sie auf den Schalter Gelöschte Pools und Anbieter einblenden.
gcloud
Mit dem Befehl gcloud iam workload-identity-pools list werden die Workload Identity-Pools in einem Projekt aufgelistet.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
-
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project. Wenn Sie vorläufig gelöschte Pools in die Ausgabe aufnehmen möchten, fügen Sie das Flag--show-deletedhinzu.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools list \ --project=PROJECT_ID \ --location="global" \ --format="json"
Windows (PowerShell)
gcloud iam workload-identity-pools list ` --project=PROJECT_ID ` --location="global" ` --format="json"
Windows (cmd.exe)
gcloud iam workload-identity-pools list ^ --project=PROJECT_ID ^ --location="global" ^ --format="json"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
[
{
"description": "Workload identity pool for external workloads.",
"displayName": "My workload pool",
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
"state": "ACTIVE"
}
]
REST
Mit der Methode projects.locations.workloadIdentityPools.list werden die Workload Identity-Pools in einem Projekt aufgelistet.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
-
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project. Wenn Sie vorläufig gelöschte Pools in die Antwort aufnehmen möchten, hängen Sie?showDeleted=truean die Anfrage-URL an.
HTTP-Methode und URL:
GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"workloadIdentityPools": [
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
"displayName": "My workload pool",
"description": "Workload identity pool for external workloads.",
"state": "ACTIVE"
}
]
}
Pool aufrufen
So rufen Sie Details zu einem bestimmten Workload Identity-Pool auf:
Console
-
Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf.
- Suchen Sie nach dem Workload Identity-Pool, den Sie ansehen möchten, und klicken Sie auf den Anzeigenamen. Die Google Cloud Console zeigt Details zum Workload Identity-Pool an.
gcloud
Der Befehl gcloud iam workload-identity-pools describe ruft Details zu einem Workload Identity-Pool ab.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
POOL_ID: Die ID des Workload Identity-Pools, z. B.my-pool.PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools describe POOL_ID \ --project=PROJECT_ID \ --location="global" \ --format="json"
Windows (PowerShell)
gcloud iam workload-identity-pools describe POOL_ID ` --project=PROJECT_ID ` --location="global" ` --format="json"
Windows (cmd.exe)
gcloud iam workload-identity-pools describe POOL_ID ^ --project=PROJECT_ID ^ --location="global" ^ --format="json"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
"displayName": "My workload pool",
"description": "Workload identity pool for external workloads.",
"state": "ACTIVE"
}
REST
Mit der Methode projects.locations.workloadIdentityPools.get werden Details zu einem Workload Identity-Pool abgerufen.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, z. B.my-pool.
HTTP-Methode und URL:
GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
"displayName": "My workload pool",
"description": "Workload identity pool for external workloads.",
"state": "ACTIVE"
}
Pool aktualisieren
Sie können einen Workload Identity-Pool aktivieren oder deaktivieren. Sie können auch den Anzeigenamen oder die Beschreibung ändern.
So aktualisieren Sie einen vorhandenen Workload Identity-Pool:
Console
-
Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf.
- Suchen Sie den Workload Identity-Pool, den Sie bearbeiten möchten.
- Klicken Sie auf den Anzeigenamen des Workload Identity-Pools.
-
So bearbeiten Sie den Anzeigenamen des Workload Identity-Pools:
- Klicken Sie auf der Seite Pooldetails neben dem Anzeigenamen auf das Symbol Bearbeiten.
- Aktualisieren Sie im angezeigten Dialogfeld Anzeigenamen des Pools bearbeiten den Anzeigenamen.
- Klicken Sie auf Speichern.
- Klicken Sie zum Deaktivieren oder Aktivieren des Workload Identity-Pools auf die Ein/Aus-Schaltfläche Status und dann auf Deaktivieren oder Aktivieren.
-
So bearbeiten Sie die Beschreibung:
- Klicken Sie unter Beschreibung neben dem Beschreibungstext auf Bearbeiten.
- Aktualisieren Sie die Beschreibung.
- Klicken Sie auf Speichern.
gcloud
Mit dem Befehl gcloud iam workload-identity-pools update wird ein vorhandener Workload Identity-Pool aktualisiert.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
POOL_ID: Die ID des Workload Identity-Pools, z. B.my-pool.PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.DISPLAY_NAME: Ein Anzeigename für den Workload Identity-Pool mit bis zu 32 Zeichen, z. B.My updated pool.-
DESCRIPTION: Eine Beschreibung des Workload Identity-Pools mit bis zu 256 Zeichen. Wenn Sie den Pool deaktivieren oder aktivieren möchten, übergeben Sie auch das Flag--disabledoder--no-disabled.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools update POOL_ID \ --project=PROJECT_ID \ --location="global" \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION"
Windows (PowerShell)
gcloud iam workload-identity-pools update POOL_ID ` --project=PROJECT_ID ` --location="global" ` --display-name="DISPLAY_NAME" ` --description="DESCRIPTION"
Windows (cmd.exe)
gcloud iam workload-identity-pools update POOL_ID ^ --project=PROJECT_ID ^ --location="global" ^ --display-name="DISPLAY_NAME" ^ --description="DESCRIPTION"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Update request issued for: [my-pool] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000001-0123456789abcdef] to complete...done. Updated workloadIdentityPool [my-pool].
REST
Mit der Methode projects.locations.workloadIdentityPools.patch wird ein vorhandener Workload Identity-Pool aktualisiert.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, z. B.my-pool.UPDATE_MASK: Eine durch Kommas getrennte Liste von Feldern, die aktualisiert werden sollen, z. B.displayName,description,disabled.DISPLAY_NAME: Ein Anzeigename für den Workload Identity-Pool mit bis zu 32 Zeichen, z. B.My updated pool.DESCRIPTION: Eine Beschreibung des Workload Identity-Pools mit bis zu 256 Zeichen.DISABLED: Gibt an, ob der Pool deaktiviert ist. Legen Sietruefest, um den Pool zu deaktivieren, oderfalse, um ihn zu aktivieren.
HTTP-Methode und URL:
PATCH https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID?updateMask=UPDATE_MASK
JSON-Text anfordern:
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION",
"disabled": DISABLED
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält einen Vorgang mit langer Ausführungszeit, der Ihre Anfrage darstellt. Informationen dazu, wie Sie prüfen, ob die Poolaktualisierung abgeschlossen ist, finden Sie auf dieser Seite unter Status eines Vorgangs mit langer Ausführungszeit prüfen.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000001-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
},
"done": false
}
Pool löschen
Wenn Sie einen Workload Identity-Pool löschen, werden auch die Anbieter des Workload Identity-Pools gelöscht. Dadurch verlieren die Identitäten im Pool den Zugriff aufGoogle Cloud -Ressourcen.
Sie können einen Pool bis zu 30 Tage nach dem Löschen wiederherstellen. Nach 30 Tagen wird sie endgültig gelöscht. Erst wenn ein Pool endgültig gelöscht wurde, können Sie seinen Namen beim Erstellen eines neuen Workload Identity-Pools wiederverwenden.
So löschen Sie einen Workload Identity-Pool und seine IdPs:
Console
-
Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf.
- Suchen Sie den Workload Identity-Pool, den Sie löschen möchten, und klicken Sie auf seinen Anzeigenamen.
- Klicken Sie auf Pool löschen und dann auf Löschen. Der Workload Identity-Pool und seine IdPs werden gelöscht.
gcloud
Mit dem Befehl gcloud iam workload-identity-pools delete wird ein Workload Identity-Pool gelöscht.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
POOL_ID: Die ID des zu löschenden Workload Identity-Pools, z. B.my-pool.PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools delete POOL_ID \ --project=PROJECT_ID \ --location="global"
Windows (PowerShell)
gcloud iam workload-identity-pools delete POOL_ID ` --project=PROJECT_ID ` --location="global"
Windows (cmd.exe)
gcloud iam workload-identity-pools delete POOL_ID ^ --project=PROJECT_ID ^ --location="global"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Delete request issued for: [my-pool] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000002-0123456789abcdef] to complete...done. Deleted workloadIdentityPool [my-pool].
REST
Mit der Methode projects.locations.workloadIdentityPools.delete wird ein Workload Identity-Pool gelöscht.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des zu löschenden Workload Identity-Pools, z. B.my-pool.
HTTP-Methode und URL:
DELETE https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält einen Vorgang mit langer Ausführungszeit, der Ihre Anfrage darstellt. Informationen dazu, wie Sie prüfen, ob das Löschen des Pools abgeschlossen ist, finden Sie auf dieser Seite unter Status eines Vorgangs mit langer Ausführungszeit prüfen.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000002-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
},
"done": false
}
Pool wiederherstellen
Sie können einen gelöschten Workload Identity-Pool bis zu 30 Tage nach dem Löschen wiederherstellen.
So stellen Sie einen Pool wieder her:
Console
-
Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf.
- Klicken Sie auf den Schalter Gelöschte Pools und Anbieter anzeigen.
- Suchen Sie nach dem Workload Identity-Pool, den Sie wiederherstellen möchten, und klicken Sie auf das -Symbol Wiederherstellen.
- Klicken Sie auf Wiederherstellen. Der Pool und seine Anbieter werden wiederhergestellt.
gcloud
Mit dem Befehl gcloud iam workload-identity-pools undelete wird ein vorläufig gelöschter Workload Identity-Pool wiederhergestellt.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
POOL_ID: Die ID des gelöschten Workload Identity-Pools, der wiederhergestellt werden soll, z. B.my-pool.PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools undelete POOL_ID \ --project=PROJECT_ID \ --location="global"
Windows (PowerShell)
gcloud iam workload-identity-pools undelete POOL_ID ` --project=PROJECT_ID ` --location="global"
Windows (cmd.exe)
gcloud iam workload-identity-pools undelete POOL_ID ^ --project=PROJECT_ID ^ --location="global"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Undelete request issued for: [my-pool] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000003-0123456789abcdef] to complete...done. Undeleted workloadIdentityPool [my-pool].
REST
Mit der Methode projects.locations.workloadIdentityPools.undelete wird ein vorläufig gelöschter Workload Identity-Pool wiederhergestellt.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des gelöschten Workload Identity-Pools, der wiederhergestellt werden soll, z. B.my-pool.
HTTP-Methode und URL:
POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID:undelete
JSON-Text anfordern:
{}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält einen Vorgang mit langer Ausführungszeit, der Ihre Anfrage darstellt. Informationen dazu, wie Sie prüfen, ob die Poolwiederherstellung abgeschlossen ist, finden Sie auf dieser Seite unter Status eines Vorgangs mit langer Ausführungszeit prüfen.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000003-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
},
"done": false
}
Anbieter von Workload Identity-Pools verwalten
In diesem Abschnitt wird gezeigt, wie Sie Workload Identity-Poolanbieter verwalten.
Anbieter erstellen
So erstellen einen Workload Identity-Anbieter in einem bestehenden Workload Identity-Pool:
Console
-
Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf.
- Suchen Sie den Workload Identity-Pool, dem Sie einen Anbieter hinzufügen möchten, und klicken Sie dann auf den Anzeigenamen.
- Klicken Sie auf Anbieter hinzufügen.
-
Wählen Sie den Anbietertyp aus, der erstellt werden soll:
- AWS: Ein Amazon Web Services (AWS)-IdP.
- OpenID Connect (OIDC): Ein OIDC-kompatibler IdP. Dies schließt Microsoft Azure ein.
-
Geben Sie einen Namen für den Anbieter ein.
Die Google Cloud Console verwendet den Namen zum Erstellen einer Anbieter-ID: Klicken Sie zum Ändern der Anbieter-ID auf Bearbeiten. Sie können die Anbieter-ID später nicht mehr ändern.
-
Füllen Sie die übrigen Felder für Ihren Anbieter aus:
- AWS: Geben Sie Ihre AWS-Konto-ID ein.
-
OIDC: Geben Sie die Aussteller-URL ein. Für Azure verwendet die Aussteller-URL das Format
https://sts.windows.net/AZURE_TENANT_ID. Informationen zu anderen Anbietern finden Sie in der Dokumentation des jeweiligen Anbieters.
Wenn Sie fertig sind, klicken Sie auf Weiter.
-
Klicken Sie zum Konfigurieren der Attributzuordnung auf Zuordnung bearbeiten. Mit der Attributzuordnung können Sie Informationen zu externen Identitäten verwenden, um einer Teilmenge dieser Identitäten Zugriff zu gewähren.
-
AWS: Dieser Schritt ist optional. Sie können die Standardzuordnung verwenden.
Weitere Informationen finden Sie unter Identitätsanbieter-Einstellungen für AWS und Azure.
-
OIDC: Wir empfehlen,
google.subjectassertion.subzuzuordnen. Andere Zuordnungen sind optional.Weitere Informationen finden Sie in den IdP-Einstellungen für Azure oder andere OIDC-Anbieter.
-
- Optional: Wenn Sie eine Attributbedingung angeben möchten, die die Identitäten festlegt, die sich authentifizieren können, klicken Sie auf Bedingung hinzufügen und geben Sie einen gültigen CEL-Ausdruck (Common Expression Language) ein. Weitere Informationen finden Sie unter Attributbedingungen.
- Klicken Sie auf Speichern. Der Workload Identity-Poolanbieter wird erstellt.
gcloud
AWS-Anbieter erstellen
Mit dem Befehl gcloud iam workload-identity-pools providers create-aws wird ein AWS-Workload Identity-Poolanbieter erstellt.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
PROVIDER_ID: Eine eindeutige ID für den Anbieter, z. B.my-aws-provider. Muss aus 4–32 kleingeschriebenen alphanumerischen Zeichen oder Bindestrichen bestehen und darf nicht mitgcp-beginnen.PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, dem der Anbieter hinzugefügt werden soll, z. B.my-pool.DISPLAY_NAME: Optional. Ein Anzeigename für den Anbieter mit bis zu 32 Zeichen, z. B.My AWS provider.AWS_ACCOUNT_ID: Ihre 12-stellige AWS-Konto-ID, z. B.123456789012.ATTRIBUTE_CONDITION: Optional. Ein CEL-Ausdruck (Common Expression Language), der einschränkt, welche Identitäten sich authentifizieren können, z. B.attribute.aws_role == 'arn:aws:sts::123456789012:assumed-role/my-role'.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools providers create-aws PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID" \ --display-name="DISPLAY_NAME" \ --account-id="AWS_ACCOUNT_ID" \ --attribute-condition="ATTRIBUTE_CONDITION"
Windows (PowerShell)
gcloud iam workload-identity-pools providers create-aws PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID" ` --display-name="DISPLAY_NAME" ` --account-id="AWS_ACCOUNT_ID" ` --attribute-condition="ATTRIBUTE_CONDITION"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers create-aws PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID" ^ --display-name="DISPLAY_NAME" ^ --account-id="AWS_ACCOUNT_ID" ^ --attribute-condition="ATTRIBUTE_CONDITION"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Create request issued for: [my-aws-provider] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000010-0123456789abcdef] to complete...done. Created workloadIdentityPoolProvider [my-aws-provider].
OIDC-Anbieter erstellen
Mit dem Befehl gcloud iam workload-identity-pools providers create-oidc wird ein OIDC-Workload Identity-Poolanbieter erstellt.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
PROVIDER_ID: Eine eindeutige ID für den Anbieter, z. B.my-oidc-provider. Muss aus 4–32 kleingeschriebenen alphanumerischen Zeichen oder Bindestrichen bestehen und darf nicht mitgcp-beginnen.PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, dem der Anbieter hinzugefügt werden soll, z. B.my-pool.DISPLAY_NAME: Optional. Ein Anzeigename für den Anbieter mit bis zu 32 Zeichen, z. B.My OIDC provider.ISSUER_URI: Die HTTPS-URL des OIDC-Ausstellers, z. B.https://idp.example.comoderhttps://sts.windows.net/AZURE_TENANT_ID.DISCOVERY_URI: Optional. Die URL, von der das OIDC-Discovery-Dokument abgerufen werden soll. Dadurch wird die Standard-URLISSUER_URI/.well-known/openid-configurationüberschrieben, z. B.https://idp.example.com/.well-known/custom-openid-configuration. Das Schema, der Host und der Port müssen mitISSUER_URIübereinstimmen und der Pfad muss ein/.well-known/-Segment gefolgt von einem nicht leeren Suffix enthalten.ATTRIBUTE_CONDITION: Optional. Ein CEL-Ausdruck (Common Expression Language), der einschränkt, welche Identitäten sich authentifizieren können, z. B.assertion.sub.startsWith('repo:my-org/').ACTOR_PROVIDERS: Optional. Die vollständigen Ressourcennamen von bis zu drei Workload Identity-Poolanbietern im selben Pool, die berechtigt sind, Actor-Tokens für diesen Anbieter auszustellen, z. B.projects/my-project/locations/global/workloadIdentityPools/my-pool/providers/my-actor-provider. Die Projekt-ID in jedem Ressourcennamen muss mit dem Projekt-ID- oder Projektnummernformat übereinstimmen, das Sie für diesen Anbieter verwenden. Weitere Informationen finden Sie unter Identitätsdelegierung und Akteurstokens konfigurieren.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID" \ --display-name="DISPLAY_NAME" \ --issuer-uri="ISSUER_URI" \ --discovery-uri="DISCOVERY_URI" \ --attribute-mapping="google.subject=assertion.sub" \ --attribute-condition="ATTRIBUTE_CONDITION" \ --actor-providers="ACTOR_PROVIDERS"
Windows (PowerShell)
gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID" ` --display-name="DISPLAY_NAME" ` --issuer-uri="ISSUER_URI" ` --discovery-uri="DISCOVERY_URI" ` --attribute-mapping="google.subject=assertion.sub" ` --attribute-condition="ATTRIBUTE_CONDITION" ` --actor-providers="ACTOR_PROVIDERS"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID" ^ --display-name="DISPLAY_NAME" ^ --issuer-uri="ISSUER_URI" ^ --discovery-uri="DISCOVERY_URI" ^ --attribute-mapping="google.subject=assertion.sub" ^ --attribute-condition="ATTRIBUTE_CONDITION" ^ --actor-providers="ACTOR_PROVIDERS"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Create request issued for: [my-oidc-provider] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000011-0123456789abcdef] to complete...done. Created workloadIdentityPoolProvider [my-oidc-provider].
REST
AWS-Anbieter erstellen
Mit der Methode projects.locations.workloadIdentityPools.providers.create wird ein AWS-Workload Identity-Poolanbieter erstellt.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, dem der Anbieter hinzugefügt werden soll, z. B.my-pool.PROVIDER_ID: Eine eindeutige ID für den Anbieter, z. B.my-aws-provider. Muss aus 4–32 kleingeschriebenen alphanumerischen Zeichen oder Bindestrichen bestehen und darf nicht mitgcp-beginnen.DISPLAY_NAME: Optional. Ein Anzeigename für den Anbieter mit bis zu 32 Zeichen, z. B.My AWS provider.AWS_ACCOUNT_ID: Ihre 12-stellige AWS-Konto-ID, z. B.123456789012.ATTRIBUTE_CONDITION: Optional. Ein CEL-Ausdruck (Common Expression Language), der einschränkt, welche Identitäten sich authentifizieren können, z. B.attribute.aws_role == 'arn:aws:sts::123456789012:assumed-role/my-role'.
HTTP-Methode und URL:
POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers?workloadIdentityPoolProviderId=PROVIDER_ID
JSON-Text anfordern:
{
"displayName": "DISPLAY_NAME",
"aws": {
"accountId": "AWS_ACCOUNT_ID"
},
"attributeCondition": "ATTRIBUTE_CONDITION"
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält einen Vorgang mit langer Ausführungszeit, der Ihre Anfrage darstellt. Informationen dazu, wie Sie prüfen, ob die Erstellung des Anbieters abgeschlossen ist, finden Sie auf dieser Seite unter Status eines Vorgangs mit langer Ausführungszeit prüfen.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000010-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
},
"done": false
}
OIDC-Anbieter erstellen
Mit der Methode projects.locations.workloadIdentityPools.providers.create wird ein OIDC-Workload Identity-Poolanbieter erstellt.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, dem der Anbieter hinzugefügt werden soll, z. B.my-pool.PROVIDER_ID: Eine eindeutige ID für den Anbieter, z. B.my-oidc-provider. Muss aus 4–32 kleingeschriebenen alphanumerischen Zeichen oder Bindestrichen bestehen und darf nicht mitgcp-beginnen.DISPLAY_NAME: Optional. Ein Anzeigename für den Anbieter mit bis zu 32 Zeichen, z. B.My OIDC provider.ISSUER_URI: Die HTTPS-URL des OIDC-Ausstellers, z. B.https://idp.example.comoderhttps://sts.windows.net/AZURE_TENANT_ID.DISCOVERY_URI: Optional. Die URL, von der das OIDC-Discovery-Dokument abgerufen werden soll. Dadurch wird die Standard-URLISSUER_URI/.well-known/openid-configurationüberschrieben, z. B.https://idp.example.com/.well-known/custom-openid-configuration. Das Schema, der Host und der Port müssen mitISSUER_URIübereinstimmen und der Pfad muss ein/.well-known/-Segment gefolgt von einem nicht leeren Suffix enthalten.ATTRIBUTE_CONDITION: Optional. Ein CEL-Ausdruck (Common Expression Language), der einschränkt, welche Identitäten sich authentifizieren können, z. B.assertion.sub.startsWith('repo:my-org/').ACTOR_PROVIDERS: Optional. Die vollständigen Ressourcennamen von bis zu drei Workload Identity-Poolanbietern im selben Pool, die berechtigt sind, Actor-Tokens für diesen Anbieter auszustellen, z. B.projects/my-project/locations/global/workloadIdentityPools/my-pool/providers/my-actor-provider. Die Projekt-ID in jedem Ressourcennamen muss mit dem Projekt-ID- oder Projektnummernformat übereinstimmen, das Sie für diesen Anbieter verwenden. Weitere Informationen finden Sie unter Identitätsdelegierung und Akteurstokens konfigurieren.
HTTP-Methode und URL:
POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers?workloadIdentityPoolProviderId=PROVIDER_ID
JSON-Text anfordern:
{
"displayName": "DISPLAY_NAME",
"oidc": {
"issuerUri": "ISSUER_URI",
"discoveryUri": "DISCOVERY_URI"
},
"attributeMapping": {
"google.subject": "assertion.sub"
},
"attributeCondition": "ATTRIBUTE_CONDITION",
"actorProviders": [
"ACTOR_PROVIDERS"
]
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält einen Vorgang mit langer Ausführungszeit, der Ihre Anfrage darstellt. Informationen dazu, wie Sie prüfen, ob die Erstellung des Anbieters abgeschlossen ist, finden Sie auf dieser Seite unter Status eines Vorgangs mit langer Ausführungszeit prüfen.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000011-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
},
"done": false
}
Dienstanbieter auflisten
So listen Sie die Anbieter der Workload Identity-Pools in einem Projekt auf:
Console
-
Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf.
- Klicken Sie zum Anzeigen der Anbieter für einen Workload Identity-Pool auf das Symbol Knoten für den Pool erweitern.
gcloud
Mit dem Befehl gcloud iam workload-identity-pools providers list werden die Anbieter in einem Workload Identity-Pool aufgelistet.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.-
POOL_ID: Die ID des Workload Identity-Pools, dessen Anbieter Sie auflisten möchten, z. B.my-pool. Wenn Sie vorläufig gelöschte Anbieter in die Ausgabe aufnehmen möchten, fügen Sie das Flag--show-deletedhinzu.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools providers list \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID" \ --format="json"
Windows (PowerShell)
gcloud iam workload-identity-pools providers list ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID" ` --format="json"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers list ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID" ^ --format="json"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
[
{
"attributeMapping": {
"google.subject": "assertion.sub"
},
"displayName": "My OIDC provider",
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
"oidc": {
"issuerUri": "https://idp.example.com"
},
"state": "ACTIVE"
}
]
REST
Mit der Methode projects.locations.workloadIdentityPools.providers.list werden die Anbieter in einem Workload Identity-Pool aufgelistet.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.-
POOL_ID: Die ID des Workload Identity-Pools, dessen Anbieter Sie auflisten möchten, z. B.my-pool. Wenn Sie vorläufig gelöschte Anbieter in die Antwort aufnehmen möchten, hängen Sie?showDeleted=truean die Anfrage-URL an.
HTTP-Methode und URL:
GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"workloadIdentityPoolProviders": [
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
"displayName": "My OIDC provider",
"state": "ACTIVE",
"attributeMapping": {
"google.subject": "assertion.sub"
},
"oidc": {
"issuerUri": "https://idp.example.com"
}
}
]
}
Dienstanbieter aufrufen
So rufen Sie Details zu einem bestimmten Workload Identity-Pool-Anbieter auf:
Console
-
Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf.
- Suchen Sie nach dem Workload Identity-Pool, der den Anbieter enthält, und klicken Sie dann auf das Symbol Knoten für den Pool maximieren.
- Suchen Sie nach dem Workload Identity-Poolanbieter, den Sie sich ansehen möchten, und klicken Sie auf das Symbol Bearbeiten. In der Google Cloud -Console werden detaillierte Informationen zum Anbieter angezeigt.
gcloud
Der Befehl gcloud iam workload-identity-pools providers describe ruft Details zu einem Workload Identity-Poolanbieter ab.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
PROVIDER_ID: Die ID des Anbieters des Workload Identity-Pools, z. B.my-oidc-provider.PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, der den Anbieter enthält, z. B.my-pool.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools providers describe PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID" \ --format="json"
Windows (PowerShell)
gcloud iam workload-identity-pools providers describe PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID" ` --format="json"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers describe PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID" ^ --format="json"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
"displayName": "My OIDC provider",
"state": "ACTIVE",
"attributeMapping": {
"google.subject": "assertion.sub"
},
"oidc": {
"issuerUri": "https://idp.example.com"
}
}
REST
Mit der Methode projects.locations.workloadIdentityPools.providers.get werden Details zu einem Workload Identity-Poolanbieter abgerufen.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, der den Anbieter enthält, z. B.my-pool.PROVIDER_ID: Die ID des Anbieters des Workload Identity-Pools, z. B.my-oidc-provider.
HTTP-Methode und URL:
GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
"displayName": "My OIDC provider",
"state": "ACTIVE",
"attributeMapping": {
"google.subject": "assertion.sub"
},
"oidc": {
"issuerUri": "https://idp.example.com"
}
}
Anbieter aktualisieren
Sie können einen Workload Identity-Poolanbieter aktivieren oder deaktivieren. Sie können auch die Kontoinformationen und die Attributzuordnung sowie den Anzeigenamen und die Beschreibung aktualisieren.
So aktualisieren Sie einen vorhandenen Workload Identity-Pool-Anbieter:
Console
Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf.
Suchen Sie nach dem Workload Identity-Pool, der den Anbieter enthält, und klicken Sie dann auf das Symbol Knoten für den Pool maximieren.
Suchen Sie nach dem Workload Identity-Poolanbieter, den Sie bearbeiten möchten, und klicken Sie auf das -Symbol Bearbeiten.
Bearbeiten Sie die Informationen des Anbieters und klicken Sie dann auf Speichern.
gcloud
AWS-Anbieter aktualisieren
Mit dem Befehl gcloud iam workload-identity-pools providers update-aws wird ein vorhandener AWS-Workload Identity-Poolanbieter aktualisiert.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
PROVIDER_ID: Die ID des zu aktualisierenden Anbieters, z. B.my-aws-provider.PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, der den Anbieter enthält, z. B.my-pool.DISPLAY_NAME: Ein Anzeigename für den Anbieter mit bis zu 32 Zeichen, z. B.Updated AWS provider.-
DESCRIPTION: Eine Beschreibung des Anbieters mit bis zu 256 Zeichen. Wenn Sie den Anbieter deaktivieren oder aktivieren möchten, übergeben Sie auch das Flag--disabledoder--no-disabled.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools providers update-aws PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID" \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION"
Windows (PowerShell)
gcloud iam workload-identity-pools providers update-aws PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID" ` --display-name="DISPLAY_NAME" ` --description="DESCRIPTION"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers update-aws PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID" ^ --display-name="DISPLAY_NAME" ^ --description="DESCRIPTION"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Update request issued for: [my-aws-provider] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000012-0123456789abcdef] to complete...done. Updated workloadIdentityPoolProvider [my-aws-provider].
OIDC-Anbieter aktualisieren
Mit dem Befehl gcloud iam workload-identity-pools providers update-oidc wird ein vorhandener AWS-Workload Identity-Poolanbieter aktualisiert.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
PROVIDER_ID: Die ID des OIDC-Anbieters, der aktualisiert werden soll, z. B.my-oidc-provider.PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, der den Anbieter enthält, z. B.my-pool.DISPLAY_NAME: Ein Anzeigename für den Anbieter mit bis zu 32 Zeichen, z. B.Updated OIDC provider.DESCRIPTION: Eine Beschreibung des Anbieters mit bis zu 256 Zeichen.-
ISSUER_URI: Die HTTPS-URL des OIDC-Ausstellers, z. B.https://idp.example.com. Wenn Sie den Anbieter deaktivieren oder aktivieren möchten, übergeben Sie auch das Flag--disabledoder--no-disabled.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID" \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION" \ --issuer-uri="ISSUER_URI"
Windows (PowerShell)
gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID" ` --display-name="DISPLAY_NAME" ` --description="DESCRIPTION" ` --issuer-uri="ISSUER_URI"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID" ^ --display-name="DISPLAY_NAME" ^ --description="DESCRIPTION" ^ --issuer-uri="ISSUER_URI"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Update request issued for: [my-oidc-provider] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000013-0123456789abcdef] to complete...done. Updated workloadIdentityPoolProvider [my-oidc-provider].
REST
Mit der Methode projects.locations.workloadIdentityPools.providers.patch wird ein vorhandener Workload Identity-Poolanbieter aktualisiert.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, der den Anbieter enthält, z. B.my-pool.PROVIDER_ID: Die ID des zu aktualisierenden Anbieters, z. B.my-aws-provider.UPDATE_MASK: Eine durch Kommas getrennte Liste von Feldern, die aktualisiert werden sollen, z. B.displayName,description,disabled.DISPLAY_NAME: Ein Anzeigename für den Anbieter mit bis zu 32 Zeichen, z. B.Updated AWS provider.DESCRIPTION: Eine Beschreibung des Anbieters mit bis zu 256 Zeichen.DISABLED: Gibt an, ob der Anbieter deaktiviert ist. Legen Sietruefest, um den Anbieter zu deaktivieren, oderfalse, um ihn zu aktivieren.
HTTP-Methode und URL:
PATCH https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID?updateMask=UPDATE_MASK
JSON-Text anfordern:
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION",
"disabled": DISABLED
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält einen Vorgang mit langer Ausführungszeit, der Ihre Anfrage darstellt. Informationen dazu, wie Sie prüfen, ob das Anbieterupdate abgeschlossen ist, finden Sie auf dieser Seite unter Status eines Vorgangs mit langer Ausführungszeit prüfen.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000012-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
},
"done": false
}
Anbieter löschen
Wenn Sie einen Workload Identity-Poolanbieter löschen, verlieren die Identitäten des Anbieters den Zugriff auf Google Cloud -Ressourcen.
Sie können einen Anbieter bis zu 30 Tage nach dem Löschen wiederherstellen. Nach 30 Tagen wird sie endgültig gelöscht. Bis ein Anbieter endgültig gelöscht wurde, können Sie seinen Namen nicht wiederverwenden, wenn Sie einen neuen Anbieter erstellen.
So löschen Sie einen Workload Identity-Poolanbieter:
Console
Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf.
Suchen Sie nach dem Workload Identity-Pool, der den Anbieter enthält, und klicken Sie dann auf den Anzeigenamen.
Suchen Sie im Bereich Anbieter den Anbieter, den Sie löschen möchten, und klicken Sie auf das zugehörige -Symbol Löschen.
Klicken Sie auf Löschen, um den Anbieter zu löschen.
gcloud
Mit dem Befehl gcloud iam workload-identity-pools providers delete wird ein Workload Identity-Poolanbieter gelöscht.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
PROVIDER_ID: Die ID des zu löschenden Workload Identity-Poolanbieters, z. B.my-oidc-provider.PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, der den Anbieter enthält, z. B.my-pool.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools providers delete PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID"
Windows (PowerShell)
gcloud iam workload-identity-pools providers delete PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers delete PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Delete request issued for: [my-oidc-provider] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000014-0123456789abcdef] to complete...done. Deleted workloadIdentityPoolProvider [my-oidc-provider].
REST
Mit der Methode projects.locations.workloadIdentityPools.providers.delete wird ein Workload Identity-Poolanbieter gelöscht.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, der den Anbieter enthält, z. B.my-pool.PROVIDER_ID: Die ID des zu löschenden Workload Identity-Poolanbieters, z. B.my-oidc-provider.
HTTP-Methode und URL:
DELETE https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält einen Vorgang mit langer Ausführungszeit, der Ihre Anfrage darstellt. Informationen dazu, wie Sie prüfen, ob das Löschen des Anbieters abgeschlossen ist, finden Sie auf dieser Seite unter Status eines Vorgangs mit langer Ausführungszeit prüfen.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000014-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
},
"done": false
}
Anbieter wiederherstellen
Sie können einen gelöschten Workload Identity-Pool-Anbieter bis zu 30 Tage nach dem Löschen wiederherstellen. So stellen Sie einen Anbieter wieder her:
Console
Rufen Sie in der Google Cloud Console die Seite Workload Identity-Pools auf.
Klicken Sie auf den Schalter Gelöschte Pools und Anbieter anzeigen.
Suchen Sie nach dem Workload Identity-Pool, der den Anbieter enthält, und klicken Sie dann auf das Symbol Knoten für den Pool maximieren.
Suchen Sie den Anbieter, den Sie wiederherstellen möchten, und klicken Sie dann auf das -Symbol Wiederherstellen.
Klicken Sie auf Wiederherstellen. Der Anbieter wird wiederhergestellt.
gcloud
Mit dem Befehl gcloud iam workload-identity-pools providers undelete wird ein vorläufig gelöschter Workload Identity-Poolanbieter wiederhergestellt.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
PROVIDER_ID: Die ID des gelöschten Workload Identity-Poolanbieters, der wiederhergestellt werden soll, z. B.my-oidc-provider.PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, der den Anbieter enthält, z. B.my-pool.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools providers undelete PROVIDER_ID \ --project=PROJECT_ID \ --location="global" \ --workload-identity-pool="POOL_ID"
Windows (PowerShell)
gcloud iam workload-identity-pools providers undelete PROVIDER_ID ` --project=PROJECT_ID ` --location="global" ` --workload-identity-pool="POOL_ID"
Windows (cmd.exe)
gcloud iam workload-identity-pools providers undelete PROVIDER_ID ^ --project=PROJECT_ID ^ --location="global" ^ --workload-identity-pool="POOL_ID"
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Undelete request issued for: [my-oidc-provider] Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000015-0123456789abcdef] to complete...done. Undeleted workloadIdentityPoolProvider [my-oidc-provider].
REST
Mit der Methode projects.locations.workloadIdentityPools.providers.undelete wird ein vorläufig gelöschter Workload Identity-Poolanbieter wiederhergestellt.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: Ihre Google Cloud -Projekt-ID. Projekt-IDs sind alphanumerische Strings, wiemy-project.POOL_ID: Die ID des Workload Identity-Pools, der den Anbieter enthält, z. B.my-pool.PROVIDER_ID: Die ID des gelöschten Workload Identity-Poolanbieters, der wiederhergestellt werden soll, z. B.my-oidc-provider.
HTTP-Methode und URL:
POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID:undelete
JSON-Text anfordern:
{}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Die Antwort enthält einen Vorgang mit langer Ausführungszeit, der Ihre Anfrage darstellt. Informationen dazu, wie Sie prüfen, ob die Wiederherstellung des Anbieters abgeschlossen ist, finden Sie auf dieser Seite unter Status eines Vorgangs mit langer Ausführungszeit prüfen.
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000015-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
},
"done": false
}
Status eines Vorgangs mit langer Ausführungszeit prüfen
Wenn Sie die REST API verwenden, gibt jede Methode, die einen Workload Identity-Pool oder -Anbieter erstellt, aktualisiert, löscht oder wiederherstellt, einen Vorgang mit langer Ausführungszeit (LRO) zurück. Der Vorgang mit langer Ausführungszeit verfolgt den Status der Anfrage und gibt an, ob die Änderung abgeschlossen ist.
gcloud
Der Befehl gcloud iam workload-identity-pools operations describe gibt den Status eines Vorgangs mit langer Ausführungszeit zurück.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
-
OPERATION_NAME: Der vollständige Ressourcenname des Vorgangs aus dem Feldnameder ursprünglichen Antwort:-
Poolvorgänge:
projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/operations/OPERATION_ID -
Anbietervorgänge:
projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID/operations/OPERATION_ID
Führen Sie für Anbietervorgänge stattdessen den Befehl
gcloud iam workload-identity-pools providers operations describeaus. -
Poolvorgänge:
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam workload-identity-pools operations describe OPERATION_NAME
Windows (PowerShell)
gcloud iam workload-identity-pools operations describe OPERATION_NAME
Windows (cmd.exe)
gcloud iam workload-identity-pools operations describe OPERATION_NAME
Sie sollten eine Antwort ähnlich der folgenden erhalten:
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPool",
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
"displayName": "My workload pool",
"description": "Workload identity pool for external workloads.",
"state": "ACTIVE"
}
}
REST
Die Methode projects.locations.workloadIdentityPools.operations.get gibt den Status eines Vorgang mit langer Ausführungszeit zurück.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
-
OPERATION_NAME: Der vollständige Ressourcenname des Vorgangs aus dem Feldnameder ursprünglichen Antwort:-
Poolvorgänge:
projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/operations/OPERATION_ID -
Anbietervorgänge:
projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID/operations/OPERATION_ID
-
Poolvorgänge:
HTTP-Methode und URL:
GET https://iam.googleapis.com/v1/OPERATION_NAME
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
"metadata": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPool",
"name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
"displayName": "My workload pool",
"description": "Workload identity pool for external workloads.",
"state": "ACTIVE"
}
}
Wenn das Feld done des Vorgangs false ist oder weggelassen wird, rufen Sie den Vorgang wiederholt ab, um seinen Status zu überwachen. Verwenden Sie einen abgeschnittenen exponentiellen Backoff, um eine Verzögerung zwischen Anfragen einzuführen. Wenn das Feld done auf true gesetzt ist, ist der Vorgang abgeschlossen.
Einschränkungen für die Workload Identity-Föderation verwalten
Sie können Einschränkungen für Organisationsrichtlinien verwenden, um einzuschränken, wie Ressourcen in Ihrer Google Cloud -Organisation verwendet werden können.
In diesem Abschnitt werden Einschränkungen beschrieben, die bei der Verwendung der Föderation für Workload Identity empfohlen werden.
Zulässige IdPs verwalten
Als Administrator der Organisation können Sie entscheiden, mit welchen IdPs Ihre Organisation eine Föderation eingehen darf.
Wenn Sie festlegen möchten, welche IdPs zulässig sind, aktivieren Sie die Listeneinschränkung constraints/iam.workloadIdentityPoolProviders in der Organisationsrichtlinie für Ihre Organisation. Die Einschränkung legt die Aussteller-URIs der zulässigen Anbieter fest. Sie können die Einschränkung über die Google Cloud Console oder die Google Cloud CLI aktivieren.
Wenn Sie die Föderation nur über AWS zulassen möchten, erstellen Sie eine einzelne Einschränkung mit dem URI https://sts.amazonaws.com. Das folgende Beispiel zeigt, wie diese Einschränkung mit der gcloud CLI erstellt wird:
gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \ https://sts.amazonaws.com --organization=ORGANIZATION_NUMBER
Sie können auch angeben, welche AWS-Konto-IDs Zugriff auf IhreGoogle Cloud -Ressourcen haben. Verwenden Sie die Listeneinschränkung constraints/iam.workloadIdentityPoolAwsAccounts, um die Konto-IDs anzugeben:
gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolAwsAccounts \ ACCOUNT_ID --organization=ORGANIZATION_NUMBER
Wenn Sie die Föderation nur über einen einzigen OIDC-Anbieter zulassen möchten, erstellen Sie eine einzelne Einschränkung mit dem issuer_uri des zugelassenen Anbieters. Im folgenden Beispiel wird nur die Föderation über einen bestimmten Azure-Mandanten zugelassen:
gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \ https://sts.windows.net/AZURE_TENANT_ID --organization=ORGANIZATION_NUMBER
Die Föderation von einem SAML-IdP ist besonders, da die öffentlichen Schlüssel, die zum Validieren der Assertion verwendet werden, bei der Konfiguration des SAML-IdP bereitgestellt werden. Daher ist es möglich, dass ein böswilliger Nutzer versucht, ein SAML-Metadatendokument mit der Entitäts-ID des IdP Ihrer Organisation mithilfe eines öffentlichen Schlüssels hochzuladen. Die Beschränkung der Föderation durch die Entitäts-ID in diesem Szenario bringt nur eine Illusion von Sicherheit.
Um dieses Risiko zu minimieren, empfehlen wir dringend, nur das Erstellen eines Workload Identity-Pools mit SAML-Föderation in einem Google Cloud -Projekt zuzulassen, das von Ihrer Organisation zentral verwaltet wird. Anschließend können Sie externen Identitäten in diesem Workload Identity-Pool Zugriff auf Ressourcen in Ihrer Organisation gewähren.
Wenn Sie die Föderation von SAML-IdPs zulassen möchten, erstellen Sie eine Einschränkung, die das spezielle Schlüsselwort KEY_UPLOAD zulässt.
gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \ KEY_UPLOAD --organization=ORGANIZATION_NUMBER
Sie können diese Befehle wiederholen, um die Föderation über zusätzliche Anbieter zuzulassen.
So blockieren Sie die Föderation über alle Anbieter:
Erstellen Sie eine YAML-Datei mit folgendem Inhalt:
constraint: constraints/iam.workloadIdentityPoolProviders listPolicy: allValues: DENY
Übergeben Sie die Datei an den Befehl
gcloud resource-manager org-policies set-policy:gcloud resource-manager org-policies set-policy FILE_NAME.yaml \ --organization=ORGANIZATION_NUMBER
Erstellen von Dienstkontoschlüsseln einschränken
Mit der Workload Identity-Föderation können Sie von außerhalb von Google Cloud auf Google Cloud -Ressourcen zugreifen, ohne einen Dienstkontoschlüssel verwenden zu müssen. Wenn Sie keine Dienstkontoschlüssel zur Authentifizierung verwenden, können Sie das Risiko reduzieren, indem Sie die Schlüsselerstellung deaktivieren.
Wenn Sie die Erstellung von Dienstkontoschlüsseln deaktivieren möchten, erzwingen Sie in der Organisationsrichtlinie für Ihre Organisation die boolesche Einschränkung iam.disableServiceAccountKeyCreation. Sie können auch die boolesche Einschränkung iam.disableServiceAccountKeyUpload erzwingen, um das Hochladen von öffentlichen Schlüsseln für Dienstkonten zu deaktivieren.
Sie können die Einschränkungen mit der Google Cloud Console oder der gcloud CLI aktivieren. Die folgenden Befehle der gcloud CLI aktivieren beispielsweise beide Einschränkungen:
gcloud resource-manager org-policies enable-enforce \ constraints/iam.disableServiceAccountKeyCreation \ --organization=ORGANIZATION_NUMBER gcloud resource-manager org-policies enable-enforce \ constraints/iam.disableServiceAccountKeyUpload \ --organization=ORGANIZATION_NUMBER
Workload Identity-Föderation überwachen
Sie können Cloud Monitoring-Messwerte verwenden, um Authentifizierungsereignisse für Ihre Workload Identity-Pools und -Anbieter zu überwachen. Eine Liste der verfügbaren Messwerte finden Sie unter IAM-Messwerte.
Nächste Schritte
Mehr über die Workload Identity-Föderation erfahren