In diesem Dokument wird beschrieben, wie Sie als Administrator benutzerdefinierte Organisationsrichtlinien aufrufen, erstellen und verwalten können. Mit benutzerdefinierten Organisationsrichtlinien können Sie die Kontrolle über die spezifischen Felder anpassen, die durch Ihre Organisationsrichtlinien eingeschränkt sind.
Hinweis
- Weitere Informationen zu Organisationsrichtlinien und -einschränkungen sowie zu ihrer Funktionsweise finden Sie unter Einführung in den Organisationsrichtliniendienst.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für die Organisation zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Verwalten von Organisationsrichtlinien benötigen:
- Administrator für Organisationsrichtlinien (
roles/orgpolicy.policyAdmin) -
Zum Aktivieren von Google Cloud -APIs:
Service Usage Consumer (
roles/serviceusage.serviceUsageConsumer)
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Sie können die Verwaltung von Organisationsrichtlinien delegieren, indem Sie der Rollenbindung „Administrator für Organisationsrichtlinien“ IAM-Bedingungen hinzufügen. Wenn Sie die Ressourcen steuern möchten, für die ein Hauptkonto Organisationsrichtlinien verwalten kann, können Sie die Rollenbindung von einem bestimmten Tag abhängig machen. Weitere Informationen finden Sie unter Organisationsrichtlinien erstellen.
Benutzerdefinierte Einschränkungen
Eine benutzerdefinierte Einschränkung wird in einer YAML-Datei definiert, in der die Ressourcen, Methoden, Bedingungen und Aktionen angegeben sind, die der Einschränkung unterliegen. Das Verhalten benutzerdefinierter Einschränkungen und die unterstützten Parameter sind für jeden Dienst spezifisch. Bedingungen für benutzerdefinierte Einschränkungen werden mithilfe der Common Expression Language (CEL) definiert.
Benutzerdefinierte Beschränkung einrichten
Sie können eine benutzerdefinierte Einschränkung erstellen und für die Verwendung in Organisationsrichtlinien mithilfe der Google Cloud Console oder der Google Cloud CLI einrichten.
Console
So erstellen Sie eine benutzerdefinierte Einschränkung:
- Wechseln Sie in der Google Cloud Console zur Seite Organisationsrichtlinien.
- Wählen Sie in der Projektauswahl das Projekt aus, für das Sie die Organisationsrichtlinie festlegen möchten.
- Klicken Sie auf Benutzerdefinierte Einschränkung.
- Geben Sie im Feld Anzeigename einen menschenlesbaren Namen für die Einschränkung ein. Dieser Name wird in Fehlermeldungen verwendet und kann zur Identifizierung und Fehlerbehebung verwendet werden. Verwenden Sie keine personenidentifizierbaren Informationen oder vertraulichen Daten in Anzeigenamen, da diese in Fehlermeldungen angezeigt werden können. Dieses Feld kann bis zu 200 Zeichen enthalten.
-
Geben Sie im Feld Einschränkungs-ID die gewünschte ID für die neue benutzerdefinierte Einschränkung ein. Eine benutzerdefinierte Einschränkung darf nur Buchstaben (einschließlich Groß- und Kleinbuchstaben) oder Ziffern enthalten, z. B.
custom.disableGkeAutoUpgrade. Dieses Feld kann bis zu 70 Zeichen enthalten, das Präfix (custom.) nicht mitgezählt, z. B.organizations/123456789/customConstraints/custom. Beziehen Sie weder personenidentifizierbare Informationen noch sensible Daten in die ID der Einschränkung ein, da sie in Fehlermeldungen preisgegeben werden könnten. - Geben Sie im Feld Beschreibung eine menschenlesbare Beschreibung der Einschränkung ein. Diese Beschreibung wird als Fehlermeldung verwendet, wenn gegen die Richtlinie verstoßen wird. Geben Sie Details dazu an, warum der Richtlinienverstoß aufgetreten ist und wie er behoben werden kann. Beziehen Sie weder personenidentifizierbare Informationen noch sensible Daten in die Beschreibung ein, da sie in Fehlermeldungen preisgegeben werden könnten. Dieses Feld kann bis zu 2.000 Zeichen enthalten.
-
Wählen Sie im Feld Ressourcentyp den Namen der REST-Ressource von Google Cloud aus, die das Objekt und das Feld enthält, das Sie einschränken möchten, zum Beispiel
container.googleapis.com/Cluster. Die meisten Ressourcentypen unterstützen bis zu 20 benutzerdefinierte Einschränkungen. Wenn Sie versuchen, mehr benutzerdefinierte Einschränkungen zu erstellen, schlägt der Vorgang fehl. -
Diese Einschränkung kann nur für die REST-Methode
CREATEerzwungen werden. - Klicken Sie zum Definieren einer Bedingung auf Bedingung bearbeiten.
-
Erstellen Sie im Bereich Bedingung hinzufügen eine CEL-Bedingung, die auf eine unterstützte Dienstressource verweist, z. B.
resource.autopilot.enabled == false. Dieses Feld kann bis zu 1.500 Zeichen enthalten. Weitere Informationen zur Verwendung von CEL finden Sie unter Common Expression Language. Weitere Informationen zu den Dienstressourcen, die Sie in Ihren benutzerdefinierten Einschränkungen verwenden können, finden Sie unter Unterstützte Dienste für benutzerdefinierte Einschränkungen. - Klicken Sie auf Speichern.
- Wählen Sie unter Aktion aus, ob die ausgewertete Methode zugelassen oder abgelehnt werden soll, wenn die Bedingung erfüllt ist.
- Klicken Sie auf Einschränkung erstellen.
Die unterstützten Methoden für die einzelnen Dienste finden Sie unter Dienste, die benutzerdefinierte Einschränkungen unterstützen.
Die Ablehnungsaktion bedeutet, dass der Vorgang zum Erstellen oder Aktualisieren der Ressource blockiert wird, wenn die Bedingung als wahr ausgewertet wird.
Die Aktion „Zulassen“ bedeutet, dass der Vorgang zum Erstellen oder Aktualisieren der Ressource nur zulässig ist, wenn die Bedingung als „true“ ausgewertet wird. Alle anderen Fälle, mit Ausnahme der explizit in der Bedingung aufgeführten, werden blockiert.
Wenn Sie in jedes Feld einen Wert eingegeben haben, wird rechts die entsprechende YAML-Konfiguration für diese benutzerdefinierte Einschränkung angezeigt.
gcloud
- Zum Erstellen einer benutzerdefinierten Beschränkung erstellen Sie eine YAML-Datei im folgenden Format:
-
ORGANIZATION_ID: Ihre Organisations-ID, z. B.123456789. -
CONSTRAINT_NAME: Name, den Sie für Ihre neue benutzerdefinierte Einschränkung verwenden möchten. Eine benutzerdefinierte Einschränkung darf nur Buchstaben (Groß- und Kleinschreibung) oder Ziffern enthalten, z. B.custom.disableGkeAutoUpgrade. Dieses Feld kann bis zu 70 Zeichen enthalten, das Präfix (custom.) nicht mitgezählt, z. B.organizations/123456789/customConstraints/custom. Beziehen Sie weder personenidentifizierbare Informationen noch sensible Daten in die ID der Einschränkung ein, da sie in Fehlermeldungen preisgegeben werden könnten. -
RESOURCE_NAME: Der vollständig qualifizierte Name der Ressource von Google Cloud, die das Objekt und das Feld enthält, das Sie beschränken möchten. Beispiel:container.googleapis.com/NodePool. Die meisten Ressourcentypen unterstützen bis zu 20 benutzerdefinierte Einschränkungen. Wenn Sie versuchen, mehr benutzerdefinierte Einschränkungen zu erstellen, schlägt der Vorgang fehl. -
methodTypes: die REST-Methoden, für die die Einschränkung erzwungen wird. Kann nurCREATEsein. -
CONDITION: eine CEL-Bedingung, die für eine Darstellung einer unterstützten Dienstressource geschrieben wird. Dieses Feld kann bis zu 1.500 Zeichen enthalten. Beispiel:"resource.management.autoUpgrade == false". -
ACTION: Aktion, die ausgeführt werden soll, wennconditionerfüllt ist. Mögliche Werte sindALLOWundDENY. -
DISPLAY_NAME: Ein menschenlesbarer Name für die Einschränkung. Dieser Name wird in Fehlermeldungen verwendet und kann zur Identifizierung und Fehlerbehebung verwendet werden. Verwenden Sie keine personenidentifizierbaren Informationen oder vertraulichen Daten in Anzeigenamen, da diese in Fehlermeldungen angezeigt werden können. Dieses Feld kann bis zu 200 Zeichen enthalten. -
DESCRIPTION: Eine nutzerfreundliche Beschreibung der Einschränkung, die als Fehlermeldung angezeigt werden soll, wenn die Richtlinie verletzt wird. Dieses Feld kann bis zu 2.000 Zeichen enthalten. -
Nachdem Sie die YAML-Datei für eine neue benutzerdefinierte Einschränkung erstellt haben, müssen Sie sie einrichten, um sie für Organisationsrichtlinien in Ihrer Organisation verfügbar zu machen. Verwenden Sie zum Einrichten einer benutzerdefinierten Einschränkung den Befehl
gcloud org-policies set-custom-constraint: -
Prüfen Sie mit dem Befehl
gcloud org-policies list-custom-constraints, ob die benutzerdefinierte Einschränkung vorhanden ist:
name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME resourceTypes: RESOURCE_NAME methodTypes: - CREATE condition: "CONDITION" actionType: ACTION displayName: DISPLAY_NAME description: DESCRIPTION
Ersetzen Sie Folgendes:
Die unterstützten Methoden für die einzelnen Dienste finden Sie unter Dienste, die benutzerdefinierte Einschränkungen unterstützen.
Die Aktion „Zulassen“ bedeutet, dass der Vorgang zum Erstellen oder Aktualisieren der Ressource zulässig ist, wenn die Bedingung als wahr ausgewertet wird. Das bedeutet auch, dass alle anderen Fälle außer dem in der Bedingung explizit aufgeführten blockiert werden.
Die Ablehnungsaktion bedeutet, dass der Vorgang zum Erstellen oder Aktualisieren der Ressource blockiert wird, wenn die Bedingung als wahr ausgewertet wird.
gcloud org-policies set-custom-constraint CONSTRAINT_PATH
Ersetzen Sie CONSTRAINT_PATH durch den vollständigen Pfad zu Ihrer benutzerdefinierten Einschränkungsdatei. Beispiel: /home/user/customconstraint.yaml.
Nach Abschluss dieses Vorgangs sind Ihre benutzerdefinierten Einschränkungen als Organisationsrichtlinien in der Liste der Organisationsrichtlinien von Google Cloud verfügbar.
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
Ersetzen Sie ORGANIZATION_ID durch die ID Ihrer Organisationsressource.
Weitere Informationen finden Sie unter Organisationsrichtlinien aufrufen.
Benutzerdefinierte Einschränkung aktualisieren
Sie können eine benutzerdefinierte Einschränkung aktualisieren, indem Sie die Einschränkung in derGoogle Cloud Console bearbeiten oder eine neue YAML-Datei erstellen und den gcloud CLI-Befehl set-custom-constraint noch einmal verwenden. Es gibt keine Versionsverwaltung für benutzerdefinierte Einschränkungen. Daher wird die vorhandene benutzerdefinierte Einschränkung überschrieben. Wenn die benutzerdefinierte Einschränkung bereits erzwungen wird, wird die aktualisierte benutzerdefinierte Einschränkung sofort wirksam.
Console
Wechseln Sie in der Google Cloud Console zur Seite Organisationsrichtlinien.
Klicken Sie oben auf der Seite auf die Projektauswahl.
Wählen Sie in der Projektauswahl die Ressource aus, für die Sie die Organisationsrichtlinie aktualisieren möchten.
Wählen Sie aus der Liste auf der Seite Organisationsrichtlinien die Einschränkung aus, die Sie bearbeiten möchten, um die Seite Richtliniendetails für diese Einschränkung zu öffnen.
Klicken Sie auf Einschränkung bearbeiten.
Ändern Sie den Anzeigenamen, die Beschreibung, die Erzwingungsmethode, die Bedingung und die Aktion. Sie können die Einschränkungs-ID oder den Ressourcentyp nach dem Erstellen der Einschränkung nicht mehr ändern.
Klicken Sie auf Änderungen speichern.
gcloud
Rufen Sie die aktuelle benutzerdefinierte Einschränkung mit dem Befehl
gcloud org-policies describe-custom-constraintab.gcloud org-policies describe-custom-constraint CONSTRAINT_NAME \ --organization=ORGANIZATION_ID \ --format=FORMAT > PATHErsetzen Sie Folgendes:
ORGANIZATION_ID: Ihre Organisations-ID, z. B.123456789.CONSTRAINT_NAME: der Name der benutzerdefinierten Einschränkung, z. B.custom.disableGkeAutoUpgrade.FORMAT: Das Format für die Zulassungsrichtlinie. Verwenden Siejsonoderyaml.PATH: Der Pfad zu einer neuen Ausgabedatei für die benutzerdefinierte Einschränkung.
Ändern Sie die lokale Kopie der benutzerdefinierten Einschränkung, um die Änderungen am Anzeigenamen, an der Beschreibung, an der Erzwingungsmethode, an der Bedingung und an der Aktion widerzuspiegeln. Sie können die Einschränkungs-ID oder den Ressourcentyp nicht mehr ändern, nachdem die Einschränkung erstellt wurde.
Nachdem Sie die YAML-Datei für Ihre benutzerdefinierte Einschränkung aktualisiert haben, richten Sie sie ein, um sie für Organisationsrichtlinien in Ihrer Organisation verfügbar zu machen. Verwenden Sie zum Einrichten einer benutzerdefinierten Einschränkung den Befehl
gcloud org-policies set-custom-constraint:gcloud org-policies set-custom-constraint CONSTRAINT_PATHErsetzen Sie
CONSTRAINT_PATHdurch den vollständigen Pfad zu Ihrer benutzerdefinierten Einschränkungsdatei.
Nach Abschluss des Updates ist die aktualisierte benutzerdefinierte Einschränkung für Ihre Organisationsrichtlinien verfügbar. Wenn die ursprüngliche Einschränkung bereits erzwungen wird, wird die aktualisierte Einschränkung sofort wirksam.
Benutzerdefinierte Einschränkung löschen
Sie können eine benutzerdefinierte Einschränkung mit der Google Cloud Console oder der Google Cloud CLI löschen.
Console
Wechseln Sie in der Google Cloud Console zur Seite Organisationsrichtlinien.
Klicken Sie oben auf der Seite auf die Projektauswahl.
Wählen Sie in der Projektauswahl die Ressource aus, für die Sie die Organisationsrichtlinie löschen möchten.
Wählen Sie auf der Seite Organisationsrichtlinien die Einschränkung aus, die Sie löschen möchten, um die Seite Richtliniendetails für diese Einschränkung zu öffnen.
Klicken Sie auf Löschen.
Klicken Sie auf Löschen, um zu bestätigen, dass Sie die Einschränkung löschen möchten.
gcloud
Verwenden Sie zum Löschen einer benutzerdefinierten Einschränkung den gcloud CLI-Befehl org-policies delete-custom-constraint:
gcloud org-policies delete-custom-constraint custom.CONSTRAINT_NAME \
--organization=ORGANIZATION_ID
Ersetzen Sie Folgendes:
ORGANIZATION_ID: Ihre Organisations-ID, z. B.123456789.CONSTRAINT_NAME: der Name der benutzerdefinierten Einschränkung. Beispiel:custom.disableGkeAutoUpgrade.
Die Ausgabe sieht etwa so aus:
Deleted custom constraint [organizations/123456789/customConstraints/custom.disableGkeAutoUpgrade]
Wenn Sie eine benutzerdefinierte Einschränkung löschen, werden alle Richtlinien gelöscht, die mit dieser Einschränkung erstellt wurden. Der Name der gelöschten benutzerdefinierten Einschränkung kann innerhalb weniger Minuten wieder verwendet werden.
Änderungen an Organisationsrichtlinien testen und analysieren
Wir empfehlen, alle Änderungen an Ihren Organisationsrichtlinien zu testen und im Probelauf auszuführen, um zu verstehen, wie sich die Änderungen auf Ihre Umgebung auswirken.
Mit dem Policy Simulator für Organisationsrichtlinien können Sie die Auswirkungen einer Einschränkung und einer Organisationsrichtlinie auf Ihre aktuelle Umgebung nachvollziehen. Mit diesem Tool können Sie alle Ressourcenkonfigurationen prüfen, um zu sehen, wo Verstöße auftreten, bevor die Richtlinie in Ihrer Produktionsumgebung erzwungen wird. Eine ausführliche Anleitung finden Sie unter Änderungen an Organisationsrichtlinien mit dem Richtliniensimulator testen.
Wenn Sie die aktuellen Auswirkungen kennen, können Sie eine Organisationsrichtlinie im Probelaufmodus erstellen, um die Auswirkungen und potenziellen Verstöße einer Richtlinie in den nächsten 30 Tagen zu verstehen. Eine Organisationsrichtlinie im Probelaufmodus ist eine Art von Organisationsrichtlinie, bei der Verstöße gegen die Richtlinie im Audit-Log protokolliert werden, die verletzenden Aktionen jedoch nicht abgelehnt werden. Sie können eine Organisationsrichtlinie im Probelaufmodus aus einer benutzerdefinierten Einschränkung mit der Google Cloud Console oder der Google Cloud CLI erstellen. Eine ausführliche Anleitung finden Sie unter Organisationsrichtlinien testen.
Benutzerdefinierte Organisationsrichtlinie erzwingen
Nachdem eine benutzerdefinierte Einschränkung eingerichtet wurde, funktioniert sie genauso wie vordefinierte boolesche Einschränkungen. Google Cloud prüft zuerst benutzerdefinierte Einschränkungen, wenn ausgewertet wird, ob eine Nutzeranfrage zulässig ist. Wenn eine der benutzerdefinierten Organisationsrichtlinien die Anfrage ablehnt, wird die Anfrage abgelehnt. Anschließend prüft Google Cloud, ob für diese Ressource vordefinierte Organisationsrichtlinien erzwungen werden.
Sie können eine Beschränkung erzwingen, indem Sie eine Organisationsrichtlinie erstellen, die darauf verweist, und diese Organisationsrichtlinie dann auf eine Ressource von Google Cloud anwenden.Console
- Wechseln Sie in der Google Cloud Console zur Seite Organisationsrichtlinien.
- Wählen Sie in der Projektauswahl das Projekt aus, für das Sie die Organisationsrichtlinie festlegen möchten.
- Wählen Sie auf der Seite Organisationsrichtlinien die gewünschte Beschränkung aus, um die Seite Richtliniendetails aufzurufen.
- Zum Konfigurieren der Organisationsrichtlinie für diese Ressource klicken Sie auf Richtlinie verwalten.
- Wählen Sie auf der Seite Richtlinie bearbeiten die Option Richtlinie der übergeordneten Ressource überschreiben aus.
- Klicken Sie auf Regel hinzufügen.
- Wählen Sie im Abschnitt Erzwingung aus, ob diese Organisationsrichtlinie erzwungen werden soll oder nicht.
- Klicken Sie optional auf Bedingung hinzufügen, um die Organisationsrichtlinie von einem Tag abhängig zu machen. Wenn Sie einer Organisationsrichtlinie eine bedingte Regel hinzufügen, müssen Sie mindestens eine unbedingte Regel hinzufügen, da die Richtlinie sonst nicht gespeichert werden kann. Weitere Informationen finden Sie unter Organisationsrichtlinien mit Tags einschränken.
- Klicken Sie auf Änderungen testen, um die Auswirkungen der Organisationsrichtlinie zu simulieren. Weitere Informationen finden Sie unter Änderungen an Organisationsrichtlinien mit dem Richtliniensimulator testen.
- Klicken Sie auf Probelaufrichtlinie festlegen, um die Organisationsrichtlinie im Probelaufmodus zu erzwingen. Weitere Informationen finden Sie unter Organisationsrichtlinien testen.
- Nachdem Sie geprüft haben, ob die Organisationsrichtlinie im Probelaufmodus wie vorgesehen funktioniert, legen Sie die Live-Richtlinie fest, indem Sie auf Richtlinie festlegen klicken.
gcloud
- Wenn Sie eine Organisationsrichtlinie mit booleschen Regeln erstellen möchten, erstellen Sie eine YAML-Richtliniendatei, die auf die Beschränkung verweist:
-
PROJECT_ID: das Projekt, für das Sie die Einschränkung erzwingen möchten. -
CONSTRAINT_NAME: der Name, den Sie für Ihre benutzerdefinierte Beschränkung definiert haben. Beispiel:custom.disableGkeAutoUpgrade. -
Führen Sie den folgenden Befehl mit dem Flag
dryRunSpecaus, um die Organisationsrichtlinie im Probelaufmodus zu erzwingen: -
Nachdem Sie überprüft haben, ob die Organisationsrichtlinie im Probelaufmodus wie vorgesehen funktioniert, legen Sie die Live-Richtlinie mit dem Befehl
org-policies set-policyund dem Flagspecfest:
name: projects/PROJECT_ID/policies/CONSTRAINT_NAME spec: rules: - enforce: true dryRunSpec: rules: - enforce: true
Ersetzen Sie Folgendes:
gcloud org-policies set-policy POLICY_PATH --update-mask=dryRunSpec
Ersetzen Sie POLICY_PATH durch den vollständigen Pfad zur YAML-Datei Ihrer Organisationsrichtlinie. Es kann bis zu 15 Minuten dauern, bis die Richtlinie wirksam wird.
gcloud org-policies set-policy POLICY_PATH --update-mask=spec
Ersetzen Sie POLICY_PATH durch den vollständigen Pfad zur YAML-Datei Ihrer Organisationsrichtlinie. Es kann bis zu 15 Minuten dauern, bis die Richtlinie wirksam wird.
Beispieleinschränkung
Sie können benutzerdefinierte Einschränkungen definieren, die den von Google bereitgestellten vordefinierten Einschränkungen ähneln. Eine typische YAML-Datei für eine benutzerdefinierte Einschränkung sieht in etwa so aus:
name: organizations/1234567890123/customConstraints/custom.disableGkeAutoUpgrade
resourceTypes: container.googleapis.com/NodePool
methodTypes:
- CREATE
- UPDATE
condition: "resource.management.autoUpgrade == false"
actionType: ALLOW
displayName: Disable GKE auto upgrade
description: Only allow GKE NodePool resource to be created or updated if
AutoUpgrade is not enabled where this custom constraint is enforced.
Common Expression Language
Der Organisationsrichtliniendienst verwendet die Common Expression Language (CEL), um Bedingungen für benutzerdefinierte Einschränkungen auszuwerten. CEL ist eine Open-Source-Sprache ohne Turing-Vollständigkeit, die eine gemeinsame Semantik für die Auswertung von Ausdrücken implementiert.
Jeder Dienst, der benutzerdefinierte Einschränkungen unterstützt, stellt einen bestimmten Satz seiner Ressourcen und die Felder dieser Ressourcen zur Verfügung. Die verfügbaren Felder sind stark typisiert und können direkt von benutzerdefinierten Einschränkungen referenziert werden.
Sie können CEL-Bedingungen erstellen, die sich auf Dienstressourcenfelder beziehen, basierend auf dem Typ des Felds. Der Organisationsrichtliniendienst unterstützt eine Teilmenge der CEL-Datentypen, -Ausdrücke und -Makros. In den folgenden Abschnitten sind die verfügbaren Datentypen sowie gängige Ausdrücke und Makros aufgeführt, die damit verwendet werden können.
Weitere Informationen dazu, welche Ausdrücke und Makros für die einzelnen Dienste verfügbar sind, finden Sie unter Unterstützte Dienste für benutzerdefinierte Einschränkungen.
Das folgende JSON-Beispiel zeigt die potenziellen Feldtypen, auf die Sie mit benutzerdefinierten Einschränkungen verweisen können:
{
"integerValue": 1,
"stringValue": "A text string",
"booleanValue": true,
"nestedValue": {
"nestedStringValue": "Another text string"
},
"listValue": ["foo", "bar"],
"mapValue": {
"costCenter": "123"
}
}
Für jeden CEL-Ausdruck wird die benutzerdefinierte Einschränkung erzwungen, wenn die Bedingung als true ausgewertet wird. Sie können Ausdrücke mit „und“ (&&) und „oder“ (||) kombinieren, um eine komplexe Abfrage zu erstellen. Wenn Sie die YAML- oder JSON-Datei für Ihre benutzerdefinierte Einschränkung erstellen, setzen Sie die vollständige Abfrage in doppelte Anführungszeichen (").
Ganzzahl
Bei Ganzzahlfeldern wie integerValue im vorherigen Beispiel können Vergleichsoperatoren in Bedingungen verwendet werden. Beispiel:
resource.integerValue == 1
resource.integerValue > 5
resource.integerValue < 10
String
Stringfelder wie stringValue im vorherigen Beispiel können mit einem Stringliteral, einem regulären Ausdruck oder einem CEL-Ausdruck ausgewertet werden. Beispiel:
resource.stringValue == "abc"
// stringValue is exactly "abc".
resource.stringValue.matches("dev$")
// stringValue matches a regular expression, which specifies the string ends
// with the word "dev".
resource.stringValue.startsWith("startValue")
// stringValue starts with "startValue".
resource.stringValue.endsWith("endValue")
// stringValue ends with "endValue".
resource.stringValue.contains("fooBar")
// stringValue contains "fooBar".
Auf verschachtelte Felder wie nestedStringValue im vorherigen Beispiel muss mit dem vollständigen Pfad verwiesen werden. Beispiel:
resource.nestedValue.nestedStringValue == "foo"
// nestedValue contains the object nestedStringValue, which has a value of "foo".
Boolesch
Boolesche Felder wie booleanValue im vorherigen Beispiel enthalten einen booleschen Wert, der entweder true oder false ist.
Liste
Listenfelder wie listValue im vorherigen Beispiel können anhand der Größe der Liste, des Inhalts der Liste und des Vorhandenseins eines bestimmten Elements an einer beliebigen Stelle in der Liste ausgewertet werden.
Beispiel:
resource.listValue.size() >= 1 && resource.listValue[0] == "bar"
// listValue has size greater than or equal to one, and the first element is "bar".
resource.listValue.exists(value, value == "foo")
// listValue has at least one element that is exactly "foo".
resource.listValue.all(value, value.contains("foo"))
// listValue is a list of values that are all exactly "foo".
Karte
Kartenfelder wie mapValue im vorherigen Beispiel sind Schlüssel/Wert-Paare, die anhand des Vorhandenseins und des Werts bestimmter Elemente ausgewertet werden können.
Beispiel:
has(resource.mapValue.foo) && resource.mapValue.foo == "bar"
// mapValue contains the key "foo", and that key has the value "bar".
Fehlerbehebung bei benutzerdefinierten Einschränkungen
In den folgenden Abschnitten werden häufige Probleme im Zusammenhang mit dem Erstellen benutzerdefinierter Einschränkungen beschrieben und Problemumgehungen für diese Probleme vorgestellt.
Fehler beim Methodentyp
Benutzerdefinierte Einschränkungen werden mit einer Liste von Methoden erstellt, die erzwungen werden sollen, in der Regel entweder CREATE oder sowohl CREATE als auch UPDATE. Wenn Sie einen Methodentyp angeben, der von einer Ressource nicht unterstützt wird, z. B. die Methode UPDATE für Compute Engine-Image-Ressourcen, können Sie die benutzerdefinierte Einschränkung nicht speichern.
Tags nicht ausgewertet
Tags für Organisations-, Ordner- oder Projektressourcen werden von benutzerdefinierten Einschränkungen unterstützt. Weitere Informationen dazu, welche Dienste Tags unterstützen, finden Sie in der dienstspezifischen Dokumentation.
Dienstübergreifende Einschränkungen
Einige Dienste wie Compute Engine umfassen eine große Anzahl zugehöriger Ressourcen. Die Fehlermeldung für einen Verstoß gegen eine benutzerdefinierte Organisationsrichtlinie wird angezeigt, wenn der Verstoß auftritt, auch wenn die benutzerdefinierte Einschränkung für einen anderen Dienst gilt.
Beispielsweise kann eine Managed Service for Apache Spark-Aktion durch eine benutzerdefinierte Einschränkung für Compute Engine-Ressourcen blockiert werden.
CEL-Fehler beheben
Der Organisationsrichtliniendienst kompiliert und validiert die von Ihnen erstellten Bedingungen und gibt einen Fehler zurück, wenn die Bedingung syntaktisch nicht korrekt ist. Wenn Sie eine benutzerdefinierte Einschränkung nicht erstellen oder speichern können, ist wahrscheinlich ein ungültiger CEL-Syntaxfehler aufgetreten, den Sie zuerst beheben müssen.
In der Google Cloud -Konsole werden ungültige CEL-Syntaxfehler mit dem -Symbol Fehler gekennzeichnet. Wenn Sie den Mauszeiger auf dieses Symbol bewegen, wird eine Kurzinfo mit weiteren Informationen zum Syntaxfehler angezeigt.
Bestimmte Bedingungen können kompiliert werden, aber einen Fehler verursachen, wenn Google Cloudversucht, die Einschränkungen zu erzwingen. Wenn Sie beispielsweise eine Einschränkung mit einer Bedingung einrichten, die versucht, auf einen nicht vorhandenen Listenindex oder Zuordnungsschlüssel zuzugreifen, schlägt die Einschränkung fehl und gibt zum Zeitpunkt der Erzwingung einen Fehler zurück. Außerdem wird jeder Versuch, die Ressource zu erstellen, blockiert.
In den folgenden Abschnitten werden häufige CEL-Fehler und mögliche Problemumgehungen beschrieben.
Ungültiger Ausdruck oder Typkonflikt
Eine Bedingung, die mit ungültigen Ausdrücken oder Typkonflikten erstellt wurde, gibt einen Fehler zurück, wenn Sie versuchen, die benutzerdefinierte Einschränkung einzurichten. Beispiel für die folgende ungültige benutzerdefinierte Einschränkung, die einen String mit einer Ganzzahl vergleicht:
name: organizations/1234567890123/customConstraints/custom.badConfig
resourceTypes: dataproc.googleapis.com/Cluster
methodTypes:
- CREATE
- UPDATE
condition: "resource.config.masterConfig.numInstances == 'mismatch'"
actionType: ALLOW
displayName: Number of instances is a string
description: Demonstrate that type mismatches cause an error.
Wenn Sie versuchen, diese Einschränkung mit der Google Cloud CLI einzurichten, wird ein Fehler ausgegeben:
ERROR: (gcloud.org-policies.set-custom-constraint) INVALID_ARGUMENT: Custom constraint condition [resource.config.masterConfig.numInstances == "mismatch"] is invalid. Error: ERROR: <input>:1:15: found no matching overload for '_==_' applied to '(int, string)' (candidates: (%A0, %A0))
| resource.config.masterConfig.numInstances == "mismatch"
| ..........................................^.
In der Google Cloud -Konsole werden ungültige CEL-Syntaxfehler mit dem -Symbol Fehler gekennzeichnet. Wenn Sie den Mauszeiger auf dieses Symbol bewegen, wird eine Kurzinfo mit weiteren Informationen zum Syntaxfehler angezeigt.
Der Organisationsrichtliniendienst kompiliert und validiert die von Ihnen erstellten Bedingungen und gibt einen Fehler zurück, wenn die Bedingung syntaktisch nicht korrekt ist. Bestimmte Bedingungen können jedoch kompiliert werden, aber einen Fehler zurückgeben, wenn Google Cloud versucht, die Einschränkungen zu erzwingen. Wenn Sie beispielsweise eine Einschränkung mit einer Bedingung einrichten, die versucht, auf einen Listenindex oder Zuordnungsschlüssel zuzugreifen, der nicht vorhanden ist, schlägt die Einschränkung fehl und gibt zum Zeitpunkt der Erzwingung einen Fehler zurück. Außerdem wird jeder Versuch, die Ressource zu erstellen, blockiert.
Wenn Sie Bedingungen erstellen, die von Listen- oder Kartenelementen abhängen, empfehlen wir, die Bedingung mit einer Prüfung zu beginnen, die sicherstellt, dass die Bedingung in allen Fällen gültig ist. Prüfen Sie beispielsweise list.size(), bevor Sie auf ein bestimmtes Listenelement verweisen, oder verwenden Sie has(), bevor Sie auf ein Kartenelement verweisen.
Unterstützte Dienste
Jeder Dienst definiert die benutzerdefinierten Einschränkungsfelder, mit denen Organisationsrichtlinien für seine Dienstressourcen erzwungen werden können. Eine Liste der Dienste, die benutzerdefinierte Einschränkungen unterstützen, finden Sie unter Unterstützte Dienste für benutzerdefinierte Einschränkungen.
Weitere Informationen zum Einrichten eines Scanners für Organisationsrichtlinien finden Sie unter Ergebnisse von Sicherheitslücken in Organisationsrichtlinien.
Obligatorische Tags für Ressourcen erzwingen
Sie können obligatorische Tags für Ressourcen mithilfe einer benutzerdefinierten Organisationsrichtlinie erzwingen. Wenn Sie obligatorische Tags erzwingen, können Sie nur Ressourcen erstellen, die den Tagging-Richtlinien Ihrer Organisation entsprechen. Das bedeutet, dass Ressourcen an die Tag-Werte für die in der Richtlinie angegebenen obligatorischen Tag-Schlüssel gebunden sind. Weitere Informationen finden Sie unter Benutzerdefinierte Einschränkung zum Erzwingen von Tags einrichten.