En esta guía, se describe cómo inhabilitar los recursos avanzados de Eventarc con políticas de la organización personalizadas.
Eventarc Advanced no cumple con las certificaciones y los estándares que admite Eventarc Standard. Si tu organización requiere el cumplimiento de estos estándares, puedes inhabilitar la creación o actualización de recursos avanzados de Eventarc.
Antes de comenzar
Antes de inhabilitar los recursos avanzados de Eventarc, asegúrate de que se cumplan los siguientes requisitos previos:
- Conoces tu Google Cloud ID de organización.
- Para obtener los permisos que necesitas para administrar las políticas de la organización personalizadas, pídele a tu administrador que te otorgue el rol de IAM de administrador de políticas de la organización (
roles/orgpolicy.policyAdmin) en el recurso de organización.
Crea una restricción personalizada
Puedes crear una restricción personalizada y usarla en una política de la organización para evitar la creación y actualización de recursos avanzados de Eventarc nuevos.
Puedes crear una restricción personalizada con los siguientes tipos de recursos avanzados de Eventarc:
EnrollmentGoogleApiSourceMessageBusPipeline
Configura una restricción personalizada
Console
Para crear una restricción personalizada, haz lo siguiente:
- En la consola de Google Cloud , accede a la página Políticas de la organización.
- En el selector de proyectos, elige uno cuya política de la organización quieras configurar.
- Haz clic en Restricción personalizada.
- En el cuadro Nombre visible, ingresa un nombre legible por humanos para la restricción. Este nombre se usa en los mensajes de error y se puede usar para la identificación y depuración. No uses información de identificación personal (PII) ni datos sensibles en los nombres visibles, ya que podrían exponerse en mensajes de error. Este campo puede contener hasta 200 caracteres.
-
En el cuadro ID de restricción, ingresa el ID que quieras asignar a la nueva restricción
personalizada. Las restricciones personalizadas solo pueden contener letras (mayúsculas y minúsculas) o
números, por ejemplo,
custom.disableEventarcAdvancedResources. Este campo puede contener hasta 70 caracteres, sin contar el prefijo (custom.), por ejemplo,organizations/123456789/customConstraints/custom. No incluyas IIP ni datos sensibles en el ID de la restricción, ya que podrían exponerse en mensajes de error. - En el cuadro Descripción, ingresa una descripción legible por humanos de la restricción. Esta se usa como mensaje de error cuando se infringe la política. Incluye detalles sobre el motivo por el cual se produjo el incumplimiento de la política y cómo resolverlo. No incluyas IIP ni datos sensibles en la descripción, ya que podrían exponerse en mensajes de error. Este campo puede contener hasta 2,000 caracteres.
-
En el cuadro Tipo de recurso, selecciona el nombre del recurso de REST Google Cloud
que contiene el objeto y el campo que quieres restringir, por ejemplo,
container.googleapis.com/NodePool. La mayoría de los tipos de recursos admiten hasta 20 restricciones personalizadas. Si intentas crear más, la operación fallará. -
Esta restricción solo se puede aplicar en el método
CREATEde REST. - Para definir una condición, haz clic en Editar condición.
-
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. Este campo puede contener hasta 1,000 caracteres. Para obtener detalles sobre el uso de CEL, consulta Common Expression Language. Para obtener más información sobre los recursos de servicio que puedes usar en las restricciones personalizadas, consulta Servicios compatibles con restricciones personalizadas. - Haz clic en Guardar.
- En Acción, selecciona si quieres permitir o rechazar el método evaluado en caso de cumplirse la condición.
- Haz clic en Crear restricción.
Para ver los métodos compatibles con cada servicio, busca el servicio en Servicios que admiten restricciones personalizadas.
La acción de rechazo implica que la operación para crear o actualizar el recurso se bloquea si la condición se evalúa como verdadera.
La acción de permitir implica que la operación para crear o actualizar el recurso solo se permite si la condición se evalúa como verdadera. El resto de casos se bloquean, excepto los que se indican explícitamente en la condición.
Cuando ingreses un valor en cada campo, aparecerá a la derecha la configuración de YAML equivalente para esta restricción personalizada.
gcloud
- Para crear una restricción personalizada, crea un archivo YAML con el formato siguiente:
-
ORGANIZATION_ID: Es el ID de la organización, como123456789. -
CONSTRAINT_NAME: Es el nombre que quieres usar para la nueva restricción personalizada. Una restricción personalizada solo puede contener letras (mayúsculas y minúsculas) o números, por ejemplo,custom.disableEventarcAdvancedResources. Este campo puede contener hasta 70 caracteres, sin contar el prefijo (custom.), por ejemplo,organizations/123456789/customConstraints/custom. No incluyas PII ni datos sensibles en el ID de la restricción, ya que podrían exponerse en mensajes de error. -
RESOURCE_NAME: Es el nombre completamente calificado del recurso de Google Cloudque contiene el objeto y el campo que quieres restringir. Por ejemplo,eventarc.googleapis.com/Enrollment. La mayoría de los tipos de recursos admiten hasta 20 restricciones personalizadas. Si intentas crear más, la operación fallará. -
methodTypes: Son los métodos de REST en los que se aplica la restricción. Solo puede serCREATE. -
CONDITION: Es una condición de CEL que se escribe con base en una representación de un recurso de servicio compatible. Este campo puede contener hasta 1,000 caracteres. Por ejemplo,true. -
ACTION: Es la acción que se realiza si se cumple lacondition. Solo puede serALLOW. -
DISPLAY_NAME: Es un nombre legible para la restricción. Este nombre se usa en los mensajes de error y se puede usar para la identificación y depuración. No uses PII ni datos sensibles en los nombres visibles, ya que podrían exponerse en mensajes de error. Este campo puede contener hasta 200 caracteres. -
DESCRIPTION: Es una descripción simple de la restricción que se mostrará como un mensaje de error cuando se infrinja la política. Este campo puede contener hasta 2,000 caracteres. -
Después de crear el archivo YAML de una nueva restricción personalizada, debes configurarla con el objetivo de que esté
disponible para las políticas de la organización de tu empresa. Para configurar una restricción personalizada,
usa el
el comando
gcloud org-policies set-custom-constraint: -
Para verificar que la restricción personalizada exista, usa el
comando
gcloud org-policies list-custom-constraints:
name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME resourceTypes: RESOURCE_NAME methodTypes: - CREATE condition: "CONDITION" actionType: ACTION displayName: DISPLAY_NAME description: DESCRIPTION
Reemplaza los valores que se indican a continuación:
Para ver los métodos compatibles con cada servicio, busca el servicio en Servicios que admiten restricciones personalizadas.
Para obtener más información sobre los recursos disponibles para escribir condiciones, consulta Recursos admitidos.
La acción de permitir implica que, si la condición se evalúa como verdadera, se permite la operación para crear o actualizar el recurso. Esto también quiere decir que se bloquea el resto de casos, excepto el que se indica de forma explícita en la condición.
gcloud org-policies set-custom-constraint CONSTRAINT_PATH
Reemplaza CONSTRAINT_PATH por la ruta de acceso completa al
archivo de la restricción personalizada. Por ejemplo, /home/user/customconstraint.yaml.
Una vez que se complete esta operación, tus restricciones personalizadas estarán disponibles en la lista de políticas de la organización de Google Cloud .
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
Reemplaza ORGANIZATION_ID por el ID del recurso de tu organización.
Para obtener más información, consulta Visualiza las políticas de la organización .
Aplica una política de la organización personalizada
Puedes aplicar una restricción cuando creas una política de la organización que haga referencia a ella y, luego, aplicas esa política a un recurso de Google Cloud .Consola
- En la consola de Google Cloud , ve a la página Políticas de la organización.
- En el selector de proyectos, elige el proyecto cuya política de la organización quieres configurar.
- En la lista de la página Políticas de la organización, selecciona una restricción para ver la página Detalles de la política de esa restricción.
- Si deseas configurar las políticas de la organización para este recurso, haz clic en Administrar política.
- En la página Editar política, selecciona Anular la política del superior.
- Haz clic en Agregar una regla.
- En la sección Aplicación, selecciona si quieres que se aplique o no esta política de la organización.
- Opcional: Para que la política de la organización sea condicional en una etiqueta, haz clic en Agregar condición. Ten en cuenta que, si agregas una regla condicional a una política de la organización, debes agregar una regla sin condición como mínimo; de lo contrario, la política no se puede guardar. Para obtener más información, consulta Cómo definir el alcance de las políticas de la organización con etiquetas.
- Haz clic en Probar cambios para simular el efecto de la política de la organización. Para obtener más información, consulta Prueba los cambios en políticas de la organización con Policy Simulator.
- Para aplicar la política de la organización en modo de ejecución de prueba, haz clic en Establecer política de ejecución de prueba. Para obtener más información, consulta Prueba las políticas de la organización.
- Luego de verificar que la política de la organización en el modo de ejecución de prueba funciona según lo previsto, haz clic en Configurar política para configurar la política activa.
gcloud
- Para crear una política de la organización con reglas booleanas, crea un archivo YAML de política que haga referencia a la restricción:
-
PROJECT_ID: Es el proyecto en el que quieres aplicar tu restricción. -
CONSTRAINT_NAME: Es el nombre que definiste para tu restricción personalizada. Por ejemplo:custom.disableEventarcAdvancedResources. -
Para aplicar la política de la organización en
el modo de ejecución de
prueba, ejecuta el comando siguiente con la marca
dryRunSpec: -
Luego de verificar que la política de la organización en modo de ejecución de prueba funciona según lo previsto, configura la política
activa con el comando
org-policies set-policyy la marcaspec:
name: projects/PROJECT_ID/policies/CONSTRAINT_NAME spec: rules: - enforce: true dryRunSpec: rules: - enforce: true
Reemplaza los valores que se indican a continuación:
gcloud org-policies set-policy POLICY_PATH --update-mask=dryRunSpec
Reemplaza POLICY_PATH por la ruta de acceso completa al archivo YAML
de la política de la organización. La política tarda hasta 15 minutos en aplicarse.
gcloud org-policies set-policy POLICY_PATH --update-mask=spec
Reemplaza POLICY_PATH por la ruta de acceso completa al archivo YAML
de la política de la organización. La política tarda hasta 15 minutos en aplicarse.
¿Qué sigue?
- Obtén más información sobre las políticas de la organización
- Información sobre Eventarc Advanced