Wenn Sie Berechtigungen ablehnen, mit denen Nutzer Zugriff gewähren können, können Sie eine nicht autorisierte Rechteausweitung verhindern und Ihre Sicherheitsmaßnahmen verschärfen. In diesem Dokument wird beschrieben, wie Sie diese Berechtigungen identifizieren und eine Ablehnungsrichtlinie erstellen, die sie für die meisten Nutzer blockiert, aber Ausnahmen für vertrauenswürdige Hauptkonten zulässt.
Hinweis
Aktivieren Sie die IAM API, falls sie noch nicht aktiviert ist.
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die Berechtigung
serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von RollenRichten Sie die Authentifizierung ein.
Wählen Sie den Tab für die gewünschte Verwendung der Beispiele auf dieser Seite aus:
Console
Wenn Sie über die Cloud de Confiance Console auf Dienste und APIs von Cloud de Confiance by S3NS zugreifen, müssen Sie die Authentifizierung nicht einrichten.
gcloud
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit dem folgenden Befehl:
gcloud initREST
Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.
Weitere Informationen finden Sie in der Dokumentation zur Cloud de Confiance -Authentifizierung unter Für die Verwendung von REST authentifizieren.
Optional: Lesen Sie die Übersicht über Ablehnungsrichtlinien.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Deny Admin (roles/iam.denyAdmin) für Ihre Organisation zuzuweisen, um die Berechtigung zu erhalten, die Sie zum Erstellen einer Ablehnungsrichtlinie benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigung iam.denypolicies.create, die zum Erstellen einer Ablehnungsrichtlinie erforderlich ist.
Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Berechtigungen identifizieren, mit denen Nutzer Zugriff gewähren können
Bevor Sie eine Ablehnungsrichtlinie erstellen, um zu verhindern, dass Nutzer Zugriff gewähren, müssen Sie festlegen, welche Berechtigungen Sie ablehnen möchten.
Mit den folgenden Berechtigungen können Nutzer Zugriff gewähren:
Berechtigungen, die auf
setIamPolicyenden. Die am weitesten gefassten Berechtigungen sind die für Resource Manager-Ressourcen, da Zulassungsrichtlinien für diese Ressourcen von allen untergeordneten Ressourcen übernommen werden. Diese Berechtigungen sind:cloudresourcemanager.googleapis.com/projects.setIamPolicycloudresourcemanager.googleapis.com/folders.setIamPolicycloudresourcemanager.googleapis.com/organizations.setIamPolicy
Andere Ressourcen haben ebenfalls
setIamPolicy-Berechtigungen. Compute Engine-Instanzen haben beispielsweise die Berechtigungcompute.googleapis.com/instances.setIamPolicy. Wenn Sie verhindern möchten, dass Nutzer Zulassungsrichtlinien für diese Ressourcen ändern, fügen Sie diese Berechtigungen Ihrer Ablehnungsrichtlinie hinzu.Eine vollständige Liste der ablehnbaren Berechtigungen, die auf
setIamPolicyenden, finden Sie unter In Ablehnungsrichtlinien unterstützte Berechtigungen. Suchen Sie dort nachsetIamPolicy.Die Berechtigung
iam.googleapis.com/roles.update, mit der Nutzer benutzerdefinierte Rollen ändern können. Nutzer mit dieser Berechtigung können benutzerdefinierten Rollen Berechtigungen hinzufügen und sich selbst oder anderen diese Berechtigungen gewähren.
Berechtigungen zum Ändern des Zugriffs verweigern
Nachdem Sie festgelegt haben, welche Berechtigungen Sie ablehnen möchten, erstellen Sie eine Ablehnungsrichtlinie für Ihre Organisation, die diese Berechtigungen ablehnt.
Console
Öffnen Sie in der Cloud de Confiance Console auf der Seite IAM den Tab Ablehnen.
Wählen Sie Ihre Organisation aus.
Klicken Sie auf Ablehnungsrichtlinie erstellen.
Legen Sie im Abschnitt Richtlinienname die Richtlinien-ID fest. Gehen Sie dazu so vor:
- Geben Sie im Feld Anzeigename einen Anzeigenamen für die Richtlinie ein. Wenn Sie dieses Feld ausfüllen, wird das Feld ID automatisch ausgefüllt. Wenn Sie die ID der Richtlinie ändern möchten, aktualisieren Sie den Text im Feld ID.
- Geben Sie im Feld ID eine ID für die Richtlinie ein.
Fügen Sie im Bereich Ablehnungsregeln eine Ablehnungsregel hinzu, die Berechtigungen zum Ändern des Zugriffs blockiert:
Fügen Sie im Feld Abgelehnte Hauptkonten die Hauptkonten hinzu, denen der Zugriff verweigert werden soll. Verwenden Sie den Wert
principalSet://goog/public:all, um allen Nutzern die Berechtigung zum Ändern des Zugriffs zu verweigern. Eine vollständige Liste der Werte, die Sie verwenden können, finden Sie unter Hauptkonto-IDs für Ablehnungsrichtlinien.Fügen Sie im Feld Hauptkonten mit Ausnahmen die vertrauenswürdigen Hauptkonten hinzu, denen Sie Zugriff gewähren möchten. Eine vollständige Liste der Werte, die Sie verwenden können, finden Sie unter Hauptkonto-IDs für Ablehnungsrichtlinien.
Fügen Sie im Abschnitt Abgelehnte Berechtigungen die Berechtigungen hinzu, die Sie unter Berechtigungen identifizieren, mit denen Nutzer Zugriff gewähren können ermittelt haben.
Optional: Fügen Sie eine Ablehnungsbedingung hinzu, die angibt, welche Ressourcen von dieser Regel betroffen sind. Sie können beispielsweise eine Bedingung hinzufügen, damit die Richtlinie nur für Ressourcen mit dem Tag-Wert
prodgilt. Weitere Informationen zu Ablehnungsbedingungen finden Sie unter Bedingungen in Ablehnungsrichtlinien.
Klicken Sie auf Erstellen.
gcloud
Mit dem Befehl gcloud iam policies create wird eine Ablehnungsrichtlinie für eine Ressource erstellt.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
POLICY_ID: Kennzeichnung für die Ablehnungsrichtlinie.-
ORG_ID: Die numerische ID der Organisation, in der Sie die Ablehnungsrichtlinie erstellen möchten. -
POLICY_FILE: Eine Datei, die die Ablehnungsrichtlinie enthält, die Sie festlegen möchten. Verwenden Sie das folgende Format für die Ablehnungsrichtlinie:{ "displayName": "POLICY_NAME", "rules": [ { "denyRule": { "deniedPrincipals": [ DENIED_PRINCIPALS ], "exceptionPrincipals": [ EXCEPTION_PRINCIPALS ], "deniedPermissions": [ ACCESS_CHANGE_PERMISSIONS ], DENIAL_CONDITION } } ] }
Ersetzen Sie die folgenden Werte:
POLICY_NAME: Anzeigename für die Richtlinie zur Ablehnung.-
DENIED_PRINCIPALS: Die Hauptkonten, denen der Zugriff verweigert werden soll. Verwenden Sie den Wert"principalSet://goog/public:all", um allen Nutzern die Berechtigung zum Ändern des Zugriffs zu verweigern. Eine vollständige Liste der Werte, die Sie verwenden können, finden Sie unter Hauptkonto-IDs für Ablehnungsrichtlinien. -
EXCEPTION_PRINCIPALS: Die vertrauenswürdigen Hauptkonten, denen Sie Zugriff gewähren möchten. Eine vollständige Liste der Werte, die Sie verwenden können, finden Sie unter Hauptkonto-IDs für Ablehnungsrichtlinien. -
ACCESS_CHANGE_PERMISSIONS: Die Berechtigungen, die Sie unter Berechtigungen identifizieren, mit denen Nutzer Zugriff gewähren können ermittelt haben. -
DENIAL_CONDITION: Optional. Eine Ablehnungsbedingung, die angibt, welche Ressourcen von dieser Regel betroffen sind. Sie können beispielsweise eine Bedingung hinzufügen, damit die Regel nur für Ressourcen mit dem Tag-Wertprodgilt. Weitere Informationen zu Ablehnungsbedingungen finden Sie unter Bedingungen in Ablehnungsrichtlinien.
Führen Sie folgenden Befehl aus:
Linux, macOS oder Cloud Shell
gcloud iam policies create POLICY_ID \ --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID \ --kind=denypolicies \ --policy-file=POLICY_FILE
Windows (PowerShell)
gcloud iam policies create POLICY_ID ` --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID ` --kind=denypolicies ` --policy-file=POLICY_FILE
Windows (cmd.exe)
gcloud iam policies create POLICY_ID ^ --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID ^ --kind=denypolicies ^ --policy-file=POLICY_FILE
Wenn der Vorgang erfolgreich war, gibt dieser Befehl keine Ausgabe zurück. Verwenden Sie das Flag --format=json, um eine detaillierte Antwort auszugeben.
REST
Mit der Methode policies.createPolicy wird eine Ablehnungsrichtlinie für eine Ressource erstellt.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
-
ORG_ID: Die numerische ID der Organisation, in der Sie die Ablehnungsrichtlinie erstellen möchten. POLICY_ID: Kennzeichnung für die Ablehnungsrichtlinie.POLICY_NAME: Anzeigename für die Richtlinie zur Ablehnung.-
DENIED_PRINCIPALS: Die Hauptkonten, denen der Zugriff verweigert werden soll. Verwenden Sie den Wert"principalSet://goog/public:all", um allen Nutzern die Berechtigung zum Ändern des Zugriffs zu verweigern. Eine vollständige Liste der Werte, die Sie verwenden können, finden Sie unter Hauptkonto-IDs für Ablehnungsrichtlinien. -
EXCEPTION_PRINCIPALS: Die vertrauenswürdigen Hauptkonten, denen Sie Zugriff gewähren möchten. Eine vollständige Liste der Werte, die Sie verwenden können, finden Sie unter Hauptkonto-IDs für Ablehnungsrichtlinien. -
ACCESS_CHANGE_PERMISSIONS: Die Berechtigungen, die Sie unter Berechtigungen identifizieren, mit denen Nutzer Zugriff gewähren können ermittelt haben. -
DENIAL_CONDITION: Optional. Eine Ablehnungsbedingung, die angibt, welche Ressourcen von dieser Regel betroffen sind. Sie können beispielsweise eine Bedingung hinzufügen, damit die Regel nur für Ressourcen mit dem Tag-Wertprodgilt. Weitere Informationen zu Ablehnungsbedingungen finden Sie unter Bedingungen in Ablehnungsrichtlinien.
HTTP-Methode und URL:
POST https://iam.googleapis.com/v2/policies/cloudresourcemanager.googleapis.com%2Forganizations%2FORG_ID/denypolicies?policyId=POLICY_ID
JSON-Text anfordern:
{
"displayName": "POLICY_NAME",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
DENIED_PRINCIPALS
],
"exceptionPrincipals": [
EXCEPTION_PRINCIPALS
],
"deniedPermissions": [
ACCESS_CHANGE_PERMISSIONS
],
DENIAL_CONDITION
}
}
]
}
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting/operations/89cb3e508bf1ff01",
"metadata": {
"@type": "type.googleapis.com/google.iam.v2.PolicyOperationMetadata",
"createTime": "2026-10-31T19:06:12.455151Z"
},
"response": {
"@type": "type.googleapis.com/google.iam.v2.Policy",
"name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting",
"uid": "6665c437-a3b2-a018-6934-54dd16d3426e",
"kind": "DenyPolicy",
"displayName": "Deny access change permissions.",
"etag": "MTc3NDU4KjM4OZ0MzU5MjQ5OTI=",
"createTime": "2026-10-31T19:06:12.455151Z",
"updateTime": "2026-10-31T22:26:21.968687Z",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
"principalSet://goog/public:all"
],
"exceptionPrincipals": [
"principalSet://cloudresourcemanager.googleapis.com/organizations/1234567890123/type/ServiceAgent",
"principalSet://iam.googleapis.com/locations/global/workforcePools/example-pool/group/iam-admins"
],
"deniedPermissions": [
"cloudresourcemanager.googleapis.com/projects.setIamPolicy",
"cloudresourcemanager.googleapis.com/folders.setIamPolicy",
"cloudresourcemanager.googleapis.com/organizations.setIamPolicy"
],
"denialCondition": {
"title": "Only for prod resources",
"expression": "resource.matchTag('12345678/env', 'prod')"
}
}
}
]
}
}
Die Antwort identifiziert einen Vorgang mit langer Ausführungszeit. Sie können den Status des Vorgangs mit langer Ausführungszeit überwachen, um zu sehen, wann er abgeschlossen ist. Weitere Informationen finden Sie unter Status eines Vorgangs mit langer Ausführungszeit prüfen.