Verhindern, dass Nutzer Zugriff gewähren

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 Rollen

    API aktivieren

  • Richten 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 Google Cloud Console auf Dienste und APIs von Google Cloud zugreifen, müssen Sie die Authentifizierung nicht einrichten.

    gcloud

    Aktivieren Sie Cloud Shell in der Google Cloud Console.

    Cloud Shell aktivieren

    Unten in der Google Cloud Console wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Cloud Shell ist eine Shell-Umgebung, in der das Google Cloud CLI bereits installiert ist und Werte für Ihr aktuelles Projekt bereits festgelegt sind. Das Initialisieren der Sitzung kann einige Sekunden dauern.

    REST

    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.

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -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 setIamPolicy enden. 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.setIamPolicy
    • cloudresourcemanager.googleapis.com/folders.setIamPolicy
    • cloudresourcemanager.googleapis.com/organizations.setIamPolicy

    Andere Ressourcen haben ebenfalls setIamPolicy-Berechtigungen. Compute Engine-Instanzen haben beispielsweise die Berechtigung compute.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 setIamPolicy enden, finden Sie unter In Ablehnungsrichtlinien unterstützte Berechtigungen. Suchen Sie dort nach setIamPolicy.

  • 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 von Unified Access Policies (UAPs) und zum Binden an Ressourcen. Diese Berechtigungen sind:

    • Die Berechtigung iam.googleapis.com/accesspolicies.update, mit der Nutzer vorhandene UAPs aktualisieren können.
    • Berechtigungen, die auf createPolicyBinding enden. Diese Berechtigungen sind für jede Ressource vorhanden, an die Sie UAPs binden können. Für Projekte, Ordner und Organisationen gelten die folgenden Berechtigungen:
      • cloudresourcemanager.googleapis.com/projects.createPolicyBinding
      • cloudresourcemanager.googleapis.com/folders.createPolicyBinding
      • cloudresourcemanager.googleapis.com/organizations.createPolicyBinding

    Alternativ können Sie verhindern, dass alle Nutzer UAPs an Ressourcen binden, indem Sie die Organisationsrichtlinien-Einschränkung iam.managed.disableAccessPolicyBinding in Ihrer Organisation erzwingen. Diese Organisationsrichtlinie verhindert jedoch nicht, dass Nutzer vorhandene UAPs ändern, die bereits an Ressourcen gebunden sind.

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

  1. Öffnen Sie in der Google Cloud Console auf der Seite IAM den Tab Ablehnen.

    IAM aufrufen

  2. Wählen Sie Ihre Organisation aus.

  3. Klicken Sie auf Ablehnungsrichtlinie erstellen.

  4. 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.
  5. Fügen Sie im Bereich Ablehnungsregeln eine Ablehnungsregel hinzu, die Berechtigungen zum Ändern des Zugriffs blockiert:

    1. 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.

    2. 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.

    3. 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.

    4. 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 prod gilt. Weitere Informationen zu Ablehnungsbedingungen finden Sie unter Bedingungen in Ablehnungsrichtlinien.

  6. 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-Wert prod gilt. 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-Wert prod gilt. 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://goog/group/iam-admins@example.com"
          ],
          "deniedPermissions": [
            
            "cloudresourcemanager.googleapis.com/projects.setIamPolicy",
            "cloudresourcemanager.googleapis.com/folders.setIamPolicy",
            "cloudresourcemanager.googleapis.com/organizations.setIamPolicy",
            "iam.googleapis.com/accesspolicies.update",
            "cloudresourcemanager.googleapis.com/projects.createPolicyBinding",
            "cloudresourcemanager.googleapis.com/folders.createPolicyBinding",
            "cloudresourcemanager.googleapis.com/organizations.createPolicyBinding"
            
          ],
          "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.

Nächste Schritte