Crea y administra restricciones personalizadas

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

La política de la organización de Google Cloud te brinda un control programático centralizado sobre los recursos de tu organización. Como administrador de políticas de la organización, puedes definir una política de la organización, que es un conjunto de restricciones llamadas restricciones que se aplican a los recursos de Google Cloud y descendientes de esos recursos en la jerarquía de recursos de Google Cloud. Puedes aplicar políticas de la organización a nivel de organización, carpeta o proyecto.

La política de la organización proporciona restricciones predefinidas para varios servicios de Google Cloud. Sin embargo, si deseas tener un mayor control de las políticas de la organización, puedes crear restricciones personalizadas y usarlas en las políticas de la organización.

En esta página, se describe cómo ver, crear y administrar restricciones de políticas de la organización personalizadas. Los administradores crean restricciones personalizadas para proporcionar un control más detallado y personalizable sobre los campos específicos que restringen las políticas de tu organización.

Antes de comenzar

Para obtener más información sobre qué son las políticas y restricciones de la organización y cómo funcionan, consulta la Introducción al servicio de políticas de la organización.

Roles obligatorios

Si deseas obtener los permisos que necesitas para administrar las políticas de la organización, pídele a tu administrador que te otorgue el rol de IAM Administrador de políticas de la organización (roles/orgpolicy.policyAdmin). Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Esta función predefinida contiene los permisos necesarios para administrar las políticas de la organización. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

  • orgpolicy.constraints.list
  • orgpolicy.policies.create
  • orgpolicy.policies.delete
  • orgpolicy.policies.list
  • orgpolicy.policies.update
  • orgpolicy.policy.get
  • orgpolicy.policy.set

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Restricciones personalizadas

Se crea una restricción personalizada en un archivo YAML que especifica los recursos, métodos, condiciones y acciones que están sujetas a la restricción. Estas son específicas del servicio en el que se aplica la política de la organización. Las condiciones para tu restricción personalizada se definen mediante Common Expression Language (CEL).

Configura una restricción personalizada

Puedes crear una restricción personalizada y configurarla para usarla en las políticas de la organización mediante la consola de Google Cloud o Google Cloud CLI.

Consola

  1. En Google Cloud Console, ve a la página Políticas de la organización.

    Ir a Políticas de la organización

  2. Selecciona el Selector de proyectos en la parte superior de la página.

  3. En el Selector de proyectos, selecciona el recurso para el que deseas configurar la política de la organización.

  4. Haz clic en Restricción personalizada.

  5. En el cuadro Nombre visible, ingresa un nombre sencillo para la restricción. La longitud máxima de este campo es 200 caracteres.

  6. En el cuadro ID de restricción, ingresa el nombre que deseas para la restricción personalizada nueva. Por ejemplo, custom.disableGkeAutoUpgrade La longitud máxima de este campo es de 70 caracteres, sin contar el prefijo (por ejemplo, organizations/123456789/customConstraints/custom.).

  7. En el cuadro Descripción, ingresa una descripción sencilla de la restricción que se mostrará como un mensaje de error cuando se incumpla la política. La longitud máxima de este campo es 2000 caracteres.

  8. En el cuadro Tipo de recurso, selecciona el nombre del recurso REST de Google Cloud que contiene el objeto y el campo que deseas restringir. Por ejemplo, container.googleapis.com/NodePool.

  9. En Método de aplicación, selecciona si deseas aplicar la restricción en un método de REST CREATE o en métodos CREATE y UPDATE. No todos los servicios de Google Cloud admiten ambos métodos. A fin de ver los métodos compatibles para cada servicio, busca el servicio en Servicios compatibles.

  10. Para definir una condición, haz clic en Editar condición.

    1. En el panel Agregar condición, crea una condición de CEL que haga referencia a un recurso de servicio compatible, por ejemplo, resource.management.autoUpgrade == false. La longitud máxima de este campo es 1,000 caracteres. Para obtener detalles sobre el uso de CEL, consulta Lenguaje de expresión común. Para obtener más información sobre los recursos del servicio que puedes usar en las restricciones personalizadas, consulta Servicios compatibles con restricciones personalizadas.

    2. Haz clic en Guardar.

  11. En Acción, selecciona si deseas permitir o rechazar el método evaluado si se cumple la condición anterior.

  12. Haz clic en Crear restricción.

Cuando ingreses un valor en cada campo, aparecerá la configuración YAML equivalente para esta restricción personalizada a la derecha.

gcloud

A fin de crear una restricción personalizada con Google Cloud CLI, crea un archivo YAML para la restricción personalizada:

name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resourceTypes:
- RESOURCE_NAME
methodTypes:
- METHOD1
- METHOD2
condition: CONDITION
actionType: ACTION
displayName: DISPLAY_NAME
description: DESCRIPTION

Reemplaza lo siguiente:

  • ORGANIZATION_ID: el ID de la organización, como 123456789.

  • CONSTRAINT_NAME: el nombre que deseas para tu nueva restricción personalizada. Por ejemplo, custom.disableGkeAutoUpgrade La longitud máxima de este campo es de 70 caracteres, sin contar el prefijo (por ejemplo, organizations/123456789/customConstraints/custom.).

  • RESOURCE_NAME: Es el nombre completo del recurso de REST de Google Cloud que contiene el objeto y el campo que deseas restringir. Por ejemplo, container.googleapis.com/NodePool Para obtener más información sobre los recursos del servicio que puedes usar en las restricciones personalizadas, consulta Servicios compatibles con restricciones personalizadas.

  • METHOD1,METHOD2: Una lista de métodos RESTful para los que se aplica la restricción. Puede ser CREATE o CREATE y UPDATE. No todos los servicios de Google Cloud admiten ambos métodos. A fin de ver los métodos compatibles para cada servicio, busca el servicio en Servicios compatibles.

  • CONDITION: Es una condición de CEL que hace referencia a un recurso de servicio compatible, por ejemplo, resource.management.autoUpgrade == false. La longitud máxima de este campo es 1,000 caracteres. Para obtener detalles sobre el uso de CEL, consulta Lenguaje de expresión común.

  • ACTION: la acción que se realiza si se cumple condition. Puede ser ALLOW o DENY.

  • DISPLAY_NAME: un nombre descriptivo para la restricción. La longitud máxima de este campo es 200 caracteres.

  • DESCRIPTION: una descripción fácil de usar de la restricción que se mostrará como un mensaje de error cuando se infringe la política. La longitud máxima de este campo es 2,000 caracteres.

Después de crear una restricción personalizada nueva con Google Cloud CLI, debes configurarla a fin de que esté disponible para las políticas de la organización. Para configurar una restricción personalizada, usa el comando gcloud org-policies set-custom-constraint:

gcloud org-policies set-custom-constraint CONSTRAINT_PATH
Reemplaza CONSTRAINT_PATH por la ruta completa a tu archivo de restricciones personalizado. Por ejemplo, /home/user/customconstraint.yaml Cuando termines, encontrarás las restricciones personalizadas como restricciones disponibles en la lista de políticas de la organización de Google Cloud. Para verificar que la restricción personalizada exista, usa el comando gcloud org-policies list-custom-constraints:
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
Reemplaza ORGANIZATION_ID por el ID del recurso de la organización. El resultado es similar a este:
CONSTRAINT: custom.disableGkeAutoUpgrade
LIST_POLICY: -
BOOLEAN_POLICY: SET
ETAG: COCsm5QGENiXi2E=
Para obtener más información, consulta Visualiza las políticas de la organización.

Actualizar una restricción personalizada

Para actualizar una restricción personalizada, edita la restricción en Google Cloud Console o crea un archivo YAML nuevo y vuelve a usar el comando set-custom-constraint de gcloud CLI. No hay control de versiones de restricciones personalizadas, por lo que se reemplaza la restricción personalizada existente. Si la restricción personalizada ya se aplicó, la restricción personalizada actualizada se aplica de inmediato.

Consola

  1. En Google Cloud Console, ve a la página Políticas de la organización.

    Ir a Políticas de la organización

  2. Selecciona el Selector de proyectos en la parte superior de la página.

  3. En el Selector de proyectos, selecciona el recurso para el que deseas actualizar la política de la organización.

  4. Selecciona la restricción que deseas editar de la lista en la página Políticas de la organización. Debería aparecer la página Detalles de la política para esa restricción.

  5. Haz clic en Editar restricción.

  6. Haz cambios en el nombre visible, la descripción, el método de aplicación, la condición y la acción. No puedes cambiar el ID de restricción ni el tipo de recurso una vez que se crea la restricción.

  7. Haga clic en Guardar cambios.

gcloud

Para editar una restricción personalizada existente con Google Cloud CLI, crea un archivo YAML nuevo que contenga los cambios que deseas realizar:

name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resourceTypes:
- RESOURCE_NAME
methodTypes:
- METHOD1
- METHOD2
condition: CONDITION
actionType: ACTION
displayName: DISPLAY_NAME
description: DESCRIPTION

Reemplaza lo siguiente:

  • ORGANIZATION_ID: el ID de la organización, como 123456789.

  • CONSTRAINT_NAME: el nombre que deseas para tu nueva restricción personalizada. Por ejemplo, custom.disableGkeAutoUpgrade La longitud máxima de este campo es de 70 caracteres, sin contar el prefijo (por ejemplo, organizations/123456789/customConstraints/custom.).

  • RESOURCE_NAME: Es el nombre completo del recurso de REST de Google Cloud que contiene el objeto y el campo que deseas restringir. Por ejemplo, container.googleapis.com/NodePool Para obtener más información sobre los recursos del servicio que puedes usar en las restricciones personalizadas, consulta Servicios compatibles con restricciones personalizadas.

  • METHOD1,METHOD2: Una lista de métodos RESTful para los que se aplica la restricción. Puede ser CREATE o CREATE y UPDATE. No todos los servicios de Google Cloud admiten ambos métodos. A fin de ver los métodos compatibles para cada servicio, busca el servicio en Servicios compatibles.

  • CONDITION: Es una condición de CEL que hace referencia a un recurso de servicio compatible, por ejemplo, resource.management.autoUpgrade == false. La longitud máxima de este campo es 1,000 caracteres. Para obtener detalles sobre el uso de CEL, consulta Lenguaje de expresión común.

  • ACTION: la acción que se realiza si se cumple condition. Puede ser ALLOW o DENY.

  • DISPLAY_NAME: un nombre descriptivo para la restricción. La longitud máxima de este campo es 200 caracteres.

  • DESCRIPTION: una descripción fácil de usar de la restricción que se mostrará como un mensaje de error cuando se infringe la política. La longitud máxima de este campo es 2,000 caracteres.

Después de crear una restricción personalizada nueva con Google Cloud CLI, debes configurarla a fin de que esté disponible para las políticas de la organización. Para configurar una restricción personalizada, usa el comando gcloud org-policies set-custom-constraint:

gcloud org-policies set-custom-constraint CONSTRAINT_PATH
Reemplaza CONSTRAINT_PATH por la ruta completa a tu archivo de restricciones personalizado. Por ejemplo, /home/user/customconstraint.yaml Cuando termines, encontrarás las restricciones personalizadas como restricciones disponibles en la lista de políticas de la organización de Google Cloud. Para verificar que la restricción personalizada exista, usa el comando gcloud org-policies list-custom-constraints:
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
Reemplaza ORGANIZATION_ID por el ID del recurso de la organización. El resultado es similar a este:
CONSTRAINT: custom.disableGkeAutoUpgrade
LIST_POLICY: -
BOOLEAN_POLICY: SET
ETAG: COCsm5QGENiXi2E=
Para obtener más información, consulta Visualiza las políticas de la organización.

Borrar una restricción personalizada

Puedes borrar una restricción personalizada con Google Cloud Console o Google Cloud CLI.

Consola

  1. En Google Cloud Console, ve a la página Políticas de la organización.

    Ir a Políticas de la organización

  2. Selecciona el Selector de proyectos en la parte superior de la página.

  3. En el Selector de proyectos, selecciona el recurso en el que deseas borrar la política de la organización.

  4. Selecciona la restricción que deseas borrar de la lista en la página Políticas de la organización. Debería aparecer la página Detalles de la política para esa restricción.

  5. Haz clic en Borrar.

  6. Para confirmar que deseas borrar la restricción, haz clic en Borrar.

gcloud

Para borrar una restricción personalizada, usa el comando org-policies delete-custom-constraint de la CLI de gcloud:

gcloud org-policies delete-custom-constraint custom.CONSTRAINT_NAME \
  --organization=ORGANIZATION_ID

Reemplaza lo siguiente:

  • ORGANIZATION_ID: el ID de la organización, como 123456789.

  • CONSTRAINT_NAME: Es el nombre de tu restricción personalizada. Por ejemplo, custom.disableGkeAutoUpgrade

El resultado es similar a este:

Deleted custom constraint [organizations/123456789/customConstraints/custom.disableGkeAutoUpgrade]

Si borras una restricción personalizada, todas las políticas que se hayan creado con esa restricción seguirán existiendo, pero se ignorarán.

Si creas otra restricción personalizada con el mismo nombre, esas restricciones de políticas de la organización ignoradas usan la nueva restricción personalizada y ya no se ignoran.

Aplica una restricción personalizada

Una vez que se configura una restricción personalizada, funciona de manera idéntica a las restricciones booleanas predefinidas. Google Cloud verifica las restricciones personalizadas primero cuando evalúa si una solicitud de usuario está permitida. Si alguna de las restricciones personalizadas rechaza la solicitud, esta se rechazará. Luego, Google Cloud verifica las restricciones predefinidas aplicadas en ese recurso.

Puedes aplicar una restricción booleana si creas una política de la organización que hace referencia a ella y si la aplicas a un recurso de Google Cloud.

Consola

Para aplicar una restricción booleana, sigue estos pasos:

  1. Abre la página Políticas de la organización en Google Cloud Console.

    Abrir la página Políticas de la organización

  2. Selecciona el Selector de proyectos en la parte superior de la página.
  3. En el Selector de proyectos, selecciona el proyecto para el que deseas configurar la política de la organización.
  4. Selecciona tu restricción de la lista en la página Políticas de la organización. Debería aparecer la página Detalles de la política para esa restricción.
  5. Para personalizar la política de la organización de este recurso, haz clic en Administrar política.
  6. En la página Editar política, selecciona Personalizar.
  7. Haz clic en Agregar regla.
  8. En Aplicación, selecciona si la aplicación de esta política de la organización debe estar activada o desactivada.
  9. De manera opcional, haz clic en Agregar condición para que la política de la organización sea condicional. Ten en cuenta que, si agregas una regla condicional a una política de la organización, debes agregar al menos una regla incondicional, o la política no se puede guardar. Para obtener más detalles, consulta Establece una política de la organización con etiquetas.
  10. Para finalizar y aplicar la política de la organización, haz clic en Guardar (Save). La política tardará hasta 15 minutos en aplicarse.

gcloud

Para crear una política de la organización que aplique una restricción booleana, crea un archivo de política en formato JSON que haga referencia a la restricción:

      name: projects/PROJECT_ID/policies/CONSTRAINT_NAME
      spec:
        rules:
        - enforce: true
    

Reemplaza lo siguiente:

  • PROJECT_ID: Es el proyecto en el que deseas aplicar la restricción.
  • CONSTRAINT_NAME: Es el nombre que definiste para tu restricción personalizada. Por ejemplo: custom.disableGkeAutoUpgrade

Para aplicar la política de la organización que contiene la restricción, ejecuta el siguiente comando:

    gcloud org-policies set-policy POLICY_PATH
    

Reemplaza POLICY_PATH por la ruta de acceso completa al archivo JSON de la política de la organización. La política tardará hasta 15 minutos en aplicarse.

Restricción de ejemplo

Puedes definir restricciones personalizadas similares a las restricciones predefinidas que proporciona Google. Un archivo YAML de restricción personalizado típico es similar al siguiente:

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

El servicio de políticas de la organización usa el Common Expression Language (CEL) para evaluar las condiciones en las restricciones personalizadas. CEL es un lenguaje completo de código abierto que no es de gira y que implementa una semántica común para la evaluación de la expresión.

Cada servicio que admite restricciones personalizadas hace que un conjunto particular de sus recursos y los campos de estos recursos estén disponibles. Los campos disponibles son de tipo sólido y se puede hacer referencia a ellos de forma directa mediante restricciones personalizadas.

Puedes crear condiciones de CEL que hagan referencia a los campos de recursos de servicio según el tipo de campo. El servicio de políticas de la organización admite un subconjunto de tipos, expresiones y macros de datos de CEL. En las siguientes secciones, se enumeran los tipos de datos disponibles y las macros y las expresiones comunes que funcionan con ellos.

A fin de obtener detalles sobre qué expresiones y macros están disponibles para cada servicio, consulta Servicios compatibles con restricciones personalizadas.

En el siguiente ejemplo de JSON, se muestra cada uno de los tipos de campo a los que puedes hacer referencia mediante restricciones personalizadas:

{
  integerValue: 1
  stringValue: "A text string"
  booleanValue: true
  nestedValue: {
    nestedStringValue: "Another text string"
  }
  listValue: [foo, bar]
  mapValue["costCenter"] == "123"
}

Para cada expresión CEL, la restricción personalizada se aplica de forma forzosa cuando la condición se evalúa como true. Puedes combinar expresiones con (&&) y (||) para crear una consulta compleja.

Integer

Los campos de números enteros, como integerValue en el ejemplo anterior, permiten que los operadores de comparación se usen en condiciones. Por ejemplo:

resource.integerValue == 1
resource.integerValue > 5
resource.integerValue < 10

String

Los campos de string, como stringValue en el ejemplo anterior, se pueden evaluar mediante un literal de string, una expresión regular o una expresión CEL. Por ejemplo:

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

Se debe hacer referencia a los campos anidados, como nestedStringValue en el ejemplo anterior, con la ruta completa. Por ejemplo:

resource.nestedValue.nestedStringValue == "foo"
// nestedValue contains the object nestedStringValue, which has a value of "foo".

Lista

Los campos de lista, como listValue en el ejemplo anterior, se pueden evaluar según el tamaño de la lista, el contenido de esta y si existe un elemento en particular dentro de ella.

Por ejemplo:

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

Map

Los campos de mapa, como mapValue en el ejemplo anterior, son pares clave-valor que se pueden evaluar en función de la existencia y el valor de elementos específicos.

Por ejemplo:

has(resource.mapValue.foo) && resource.mapValue.foo == "bar"
// mapValue contains the key "foo", and that key has the value "bar".

Soluciona errores de CEL

Una condición que se crea con expresiones no válidas o discrepancias de tipos muestra un error cuando intentas configurar la restricción personalizada. Por ejemplo, dada la siguiente restricción personalizada no válida, que compara una string con un número entero:

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.

Se produce un error si intentas configurar esa restricción mediante Google Cloud CLI:

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"
 | ..........................................^.

En Google Cloud Console, los errores de sintaxis de CEL no válidos se marcarán con un ícono de Error. Si destacas este ícono, se muestra información sobre la herramienta que contiene más información sobre el error de sintaxis.

El Servicio de políticas de la organización compila y valida las condiciones que creaste y muestra un error si la condición no es sintácticamente correcta. Sin embargo, hay ciertas condiciones que se compilan, pero generan un error cuando Google Cloud intenta aplicar las restricciones. Por ejemplo, si configuras una restricción con una condición que intenta acceder a un índice de lista o a una clave de mapa que no existe, la restricción falla y se muestra un error en el momento de la aplicación, y se bloquea cualquier intento de crear el recurso.

Cuando crees condiciones que dependan de los elementos de lista o de mapa, te recomendamos que inicies la condición con una verificación que garantice que sea válida en todos los casos. Por ejemplo, marca list.size() antes de hacer referencia a un elemento de lista en particular o usa has() antes de hacer referencia a un elemento de mapa.

Servicios compatibles

Cada servicio define el conjunto de campos de restricciones personalizados que se pueden usar para aplicar las políticas de la organización en los recursos de sus servicios. Para obtener una lista de los servicios que admiten restricciones personalizadas, consulta Servicios compatibles con restricciones personalizadas.

Para obtener más información sobre la configuración de un análisis de políticas de la organización, consulta Hallazgos de vulnerabilidades de políticas de la organización.

¿Qué sigue?