Administra una postura de seguridad

En esta página, se describe cómo puedes configurar y usar el servicio de postura de seguridad después de activar Security Command Center. Para comenzar, debes crear una postura que incluya tus políticas, organizadas en conjuntos de políticas, y, luego, implementar la postura con una implementación de postura. Después de implementar una postura, puedes supervisar el desvío y definirla mejor con el tiempo.

No puedes usar la administración de la postura de seguridad con las activaciones a nivel del proyecto. Para obtener más información, consulta Disponibilidad de funciones con activaciones a nivel del proyecto.

Antes de comenzar

Completa estas tareas antes de completar las tareas restantes de esta página.

Activar Security Command Center

Verifica que hayas activado Security Command Center a nivel de la organización.

Si quieres usar los detectores de Security Health Analytics como políticas, selecciona el servicio de Security Health Analytics durante el proceso de activación.

Configurar los permisos

Permisos para administrar posturas

Para obtener los permisos que necesitas para usar la postura, pídele a tu administrador que te otorgue el rol de IAM de administrador de la postura de seguridad (roles/securityposture.admin). Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Para obtener más información sobre los roles y los permisos de postura de seguridad, consulta IAM para activaciones a nivel de la organización.

Permisos para administrar los detectores de Security Health Analytics

Para habilitar o inhabilitar un servicio, debes tener el siguiente permiso de IAM. Puedes otorgar este permiso a nivel de la organización, la carpeta o el proyecto.

securitycentermanagement.securityCenterServices.update

Pídele a tu administrador que te otorgue uno de los siguientes roles que incluyen este permiso o que agregue el permiso al rol personalizado (si tu organización usa roles personalizados).

Configura Google Cloud CLI

Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI con el siguiente comando:

gcloud init

Para configurar la gcloud CLI con el objetivo de usar la identidad temporal como cuenta de servicio y autenticarte en las APIs de Google, en lugar de tus credenciales de usuario, ejecuta el comando siguiente:

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

Para obtener más información, consulta Identidad temporal como cuenta de servicio.

Habilita las APIs

Habilita las APIs del servicio de políticas de la organización y del servicio de postura de seguridad:

gcloud services enable orgpolicy.googleapis.com  securityposture.googleapis.com

Configura la conexión a AWS

Para usar los detectores integrados de Security Health Analytics que son específicos de AWS, debes conectarte a AWS para recopilar datos de configuración y recursos.

Crea e implementa una postura

Para comenzar a usar una postura de seguridad, debes completar lo siguiente:

  • Crea un archivo YAML de postura que defina las políticas que se aplican a tu postura de seguridad.
  • Crea una postura en Google Cloud que se base en el archivo YAML de la postura.
  • Implementa la postura.

En las siguientes secciones, se proporcionan instrucciones detalladas.

Crea un archivo YAML de postura

Una postura consta de uno o más conjuntos de políticas que implementas juntos. Estos conjuntos de políticas incluyen todas las políticas de prevención y detección que deseas incluir en tu postura.

Para crear tu postura, realiza una de las siguientes acciones:

Para obtener detalles sobre los campos que puedes usar en una postura, consulta la referencia de Posture y la referencia de PolicySet.

Crea un archivo de postura a partir de una plantilla de postura predefinida

Puedes usar una plantilla de postura predefinida para crear un archivo de postura.

Console

  1. En la consola de Google Cloud , ve a la página Administración de la postura.

    Ir a Administración de la postura

  2. Selecciona una organización.

  3. En la pestaña Plantillas, haz clic en la plantilla que quieras usar.

  4. En la página Detalles de la plantilla, haz clic en Crear postura.

  5. Proporciona un nombre único para la postura y haz clic en Crear. Se abrirá la página Detalles de la postura.

  6. Realiza una de las acciones siguientes:

gcloud

  1. Revisa las plantillas de postura predefinidas para determinar cuáles se aplican a tu entorno. Puedes aplicar algunas de ellas sin realizar cambios, pero otras requieren que personalices las políticas para que coincidan con tu entorno.
  2. Usa uno de los siguientes métodos para copiar los archivos YAML en tu propio editor de texto:

    • Copia el archivo YAML del contenido de referencia en las plantillas de postura predefinidas.
    • Ejecuta el comando gcloud scc posture-templates describe para copiar el archivo YAML.
    gcloud scc posture-templates describe \
        organizations/ORGANIZATION_ID/locations/global/postureTemplates/POSTURE_TEMPLATE \
        --revision-id=REVISION_ID
    

    Reemplaza los siguientes valores:

    • ORGANIZATION_ID es la organización en la que activaste Security Command Center.
    • POSTURE_TEMPLATE es el nombre de la plantilla de postura de seguridad predefinida, como se describe en Plantillas de postura de seguridad predefinidas.
    • REVISION_ID es la versión de revisión de la plantilla de postura predefinida. Si no incluyes el ID de revisión, se muestra la versión más reciente de la plantilla de postura predefinida.

    Por ejemplo, para ver la plantilla de postura predefinida de IA segura (aspectos básicos) en la organización 3589215982, ejecuta lo siguiente:

    gcloud scc posture-templates describe \
        organizations/3589215982/locations/global/postureTemplates/secure_ai_essential \
        --revision-id=v.1.0
    
  3. Realiza una de las acciones siguientes:

    • Si puedes usar la postura sin realizar ningún cambio (por ejemplo, si usaste una de las plantillas de _essentials), puedes crear la postura. Para obtener instrucciones, consulta Crea una postura.
    • Si necesitas modificar alguno de los conjuntos de políticas o las políticas, completa Modifica un archivo YAML de postura.

Crea un archivo de postura extrayendo políticas de un entorno existente

Puedes extraer las políticas (políticas de la organización, incluidas las políticas personalizadas y todos los detectores de Security Health Analytics, incluidos los detectores personalizados) que configuraste en un proyecto, una carpeta o una organización existentes para crear un archivo de postura. No puedes extraer políticas de una organización, carpeta o proyecto que ya tenga una postura aplicada.

Este comando solo extrae las políticas que configuraste antes para la organización, la carpeta o el proyecto, y no extrae las políticas de las carpetas o la organización superiores.

Si te conectaste a AWS, este comando también extrae los detectores que son específicos de AWS (versión preliminar).

  1. Ejecuta el comando gcloud scc postures extract para extraer las políticas de la organización y los detectores de Security Health Analytics existentes en tu entorno.

    gcloud scc postures extract POSTURE_NAME \
        --workload=WORKLOAD
    

    Reemplaza los siguientes valores:

    • POSTURE_NAME es el nombre del recurso relativo de la postura. Por ejemplo, organizations/ORGANIZATION_ID/locations/global/postures/POSTURE_ID.

      • POSTURE_ID es un nombre alfanumérico para tu postura que es único para tu organización. POSTURE_ID tiene un límite de 63 caracteres.
    • WORKLOAD es el proyecto, la carpeta o la organización de la que extraes las políticas. La carga de trabajo es una de las siguientes:

    • projects/PROJECT_NUMBER

    • folder/FOLDER_ID

    • organizations/ORGANIZATION_ID

    Por ejemplo, para extraer políticas de la carpeta 3589215982 en la organización 6589215984, ejecuta el siguiente comando:

    gcloud scc postures extract \
      organizations/6589215984/locations/global/postures/myStagingPosture \
      workload=folder/3589215982 > posture.yaml
    
  2. Abre el archivo posture.yaml resultante para editarlo.

  3. Realiza una de las acciones siguientes:

    • Si puedes usar la postura sin realizar ningún cambio (por ejemplo, si usaste una de las plantillas de _essentials), puedes crear la postura. Para obtener instrucciones, consulta Crea una postura.
    • Si necesitas modificar alguno de los conjuntos de políticas o las políticas, completa Modifica un archivo YAML de postura.

Crea un recurso de Terraform con definiciones de políticas

Puedes crear una configuración de Terraform para crear un recurso de postura.

Por ejemplo, puedes crear un recurso de postura que incluya restricciones de políticas de la organización integradas y personalizadas, y detectores de Security Health Analytics integrados y personalizados. La compatibilidad de la administración de posturas con los detectores integrados de Security Health Analytics que son específicos de AWS se encuentra en versión preliminar.

resource "google_securityposture_posture" "posture1"{
  posture_id  = "posture_example"
  parent      = "organizations/123456789"
  location    = "global"
  state       = "ACTIVE"
  description = "a new posture"
  policy_sets {
    policy_set_id = "list_constraint_policy_set"
    description   = "set of org policies with a list constraint"
    policies {
      policy_id = "resource_locations_policy"
      constraint {
        org_policy_constraint {
          canned_constraint_id = "gcp.resourceLocations"
          policy_rules {
            values {
              allowed_values = ["in:us-locations"]
            }
          }
        }
      }
    }
  }
  policy_sets {
    policy_set_id = "org_policy_set"
    description   = "set of org policies"
    policies {
      policy_id = "canned_org_policy"
      constraint {
        org_policy_constraint {
          canned_constraint_id = "storage.uniformBucketLevelAccess"
          policy_rules {
            enforce = true
            condition {
            	description = "condition description"
            	expression  = "resource.matchTag('org_id/tag_key_short_name,'tag_value_short_name')"
            	title       = "a CEL condition"
            }
          }
        }
      }
    }
    policies {
      policy_id = "custom_org_policy"
      constraint {
        org_policy_constraint_custom {
          custom_constraint {
            name           = "organizations/123456789/customConstraints/custom.disableGkeAutoUpgrade"
            display_name   = "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."
            action_type    = "ALLOW"
            condition      = "resource.management.autoUpgrade == false"
            method_types   = ["CREATE", "UPDATE"]
            resource_types = ["container.googleapis.com/NodePool"]
          }
          policy_rules {
            enforce = true
            condition {
            	description = "condition description"
            	expression = "resource.matchTagId('tagKeys/key_id','tagValues/value_id')"
            	title = "a CEL condition"
            }
          }
        }
      }
    }
  }
  policy_sets {
    policy_set_id = "sha_policy_set"
    description   = "set of sha policies"
    policies {
      policy_id = "sha_builtin_module"
      constraint {
        security_health_analytics_module {
          module_name             = "BIGQUERY_TABLE_CMEK_DISABLED"
          module_enablement_state = "ENABLED"
        }
      }
      description = "enable BIGQUERY_TABLE_CMEK_DISABLED"
    }
    policies {
      policy_id = "sha_custom_module"
      constraint {
        security_health_analytics_custom_module {
          display_name = "custom_SHA_policy"
          config {
            predicate {
              expression = "resource.rotationPeriod > duration('2592000s')"
            }
            custom_output {
              properties {
                name = "duration"
                value_expression {
                  expression = "resource.rotationPeriod"
                }
              }
            }
            resource_selector {
              resource_types = ["cloudkms.googleapis.com/CryptoKey"]
            }
            severity       = "LOW"
            description    = "Custom Module"
            recommendation = "Testing custom modules"
          }
          module_enablement_state = "ENABLED"
        }
      }
    }
  }

}

Para obtener más información, consulta google_securityposture_posture.

Modifica un archivo YAML de postura

Completa los siguientes pasos para modificar un archivo YAML de postura:

  1. Abre el archivo YAML de la postura en un editor de texto.
  2. Verifica name, description y state al principio del archivo.

    name: organizations/ORGANIZATION_ID/locations/global/posture/POSTURE_ID
    description: DESCRIPTION
    state: STATE
    

    Para obtener detalles sobre estos campos, consulta la referencia de Posture.

    Por ejemplo:

    name: organizations/3589215982/locations/global/posture/stagingAIPosture
    description: This posture applies to staging environments for Vertex AI.
    state: ACTIVE
    
  3. Personaliza las políticas del archivo para que cumplan con tus requisitos.

    Para obtener detalles sobre los campos que puedes usar, consulta la referencia de PolicySet.

    1. Revisa las políticas existentes y sus valores. En el caso de las políticas que requieren información específica de tu entorno, establece los valores de forma adecuada. Por ejemplo, para la política ainotebooks.accessMode en la postura predefinida extendida de IA segura, agrega los modos de acceso permitidos en policyRules:

      - policyId: Define access mode for Vertex AI Workbench notebooks and instances
        complianceStandards:
        - standard: NIST SP 800-53
          control: AC-3(3)
        - standard: NIST SP 800-53
          control: AC-6(1)
        constraint:
          orgPolicyConstraint:
            cannedConstraintId: ainotebooks.accessMode
            policyRules:
            - values:
                allowedValues: service-account
        description: This list constraint defines the modes of access allowed to Vertex AI Workbench notebooks and instances where enforced. The allow or deny list can specify multiple users with the service-account mode or single-user access with the single-user mode. The access mode to be allowed or denied must be listed explicitly.
      
    2. Agrega restricciones adicionales de las políticas de la organización, como se documenta en Restricciones de las políticas de la organización. Si defines una política de la organización personalizada, asegúrate de que el archivo YAML incluya la definición de la restricción personalizada. No puedes usar una restricción personalizada que hayas creado con otros métodos (por ejemplo, con la consola deGoogle Cloud ).

      Por ejemplo, puedes establecer la restricción compute.trustedImageProjects para definir los proyectos que se pueden usar en el almacenamiento de imágenes y la creación de instancias de discos. Si copias este ejemplo, asegúrate de reemplazar allowedValues por una lista de proyectos adecuada:

      - policyId: Define projects with trusted images.
        complianceStandards:
        - standard:
          control:
        constraint:
          orgPolicyConstraint:
            cannedConstraintId: compute.trustedImageProjects
            policyRules:
            - values:
                allowedValues:
                - project1
                - project2
                - projectN
        description: This is a complete list of projects from which images can be used.
      
    3. Agrega detectores adicionales de Security Health Analytics, como los que se documentan en Resultados de Security Health Analytics. Por ejemplo, agrega un detector de Security Health Analytics para crear un hallazgo si un proyecto no usa una clave de API para la autenticación:

      - policyId: API Key Exists
        constraint:
          securityHealthAnalyticsModule:
            moduleEnablementState: ENABLED
            moduleName: API_KEY_EXISTS
      

      Como otro ejemplo, agrega un módulo personalizado de Security Health Analytics para detectar si los conjuntos de datos de Gemini Enterprise Agent Platform están encriptados:

      - policyId: CMEK key is used for Vertex AI DataSet
        complianceStandards:
        - standard: NIST SP 800-53
          control: SC-12
        - standard: NIST SP 800-53
          control: SC-13
        constraint:
          securityHealthAnalyticsCustomModule:
            displayName: "vertexAIDatasetCMEKDisabled"
            config:
              customOutput: {}
              predicate:
                expression: "!has(resource.encryptionSpec)"
              resourceSelector:
                resourceTypes:
                - aiplatform.googleapis.com/Dataset
              severity: CRITICAL
              description: "When enforced, this detector finds whether a dataset is not encrypted using CMEK."
              recommendation: "Restore the SHA module. See https://cloud.google.com/security-command-center/docs/custom-modules-sha-overview."
            moduleEnablementState: ENABLED
      

      Como otro ejemplo, para el nivel de servicio Enterprise (obsoleto), agrega un detector de Security Health Analytics específico de AWS (versión preliminar):

      - policySetId: AWS policy set
        description:  Policy set containing AWS built-in SHA modules for securing S3 buckets.
        policies:
        - policyId: S3 bucket replication enabled
          complianceStandards:
          - standard: NIST 800-53 R5
            control: SI-13(5)
          constraint:
            securityHealthAnalyticsModule:
              moduleEnablementState: ENABLED
              moduleName: S3_BUCKET_REPLICATION_ENABLED
          description: This control checks whether an Amazon S3 bucket has Cross-Region Replication enabled. The control fails if the bucket does not have Cross-Region Replication enabled or if Same-Region Replication is also enabled.
      
        - policyId: S3 bucket logging enabled
          complianceStandards:
          - standard: NIST 800-53 R5
            control: SI-7(8)
          - standard: PCI DSS 3.2.1
            control: 10.3.1
          constraint:
            securityHealthAnalyticsModule:
              moduleEnablementState: ENABLED
              moduleName: S3_BUCKET_LOGGING_ENABLED
          description: The AWS S3 Server Access Logging feature records access requests to storage buckets which is useful for security audits. By default, server access logging is not enabled for S3 buckets.
      

      Si agregas un detector específico de AWS, debes implementar la postura a nivel de la organización.

  4. Sube tu archivo de postura a un repositorio de código fuente con control de versiones para que puedas hacer un seguimiento de los cambios que realices en él con el tiempo.

Crea una postura

Completa esta tarea para crear un recurso de postura en Security Command Center que puedas implementar. Si creaste una postura a partir de una plantilla de postura predefinida con la consola de Google Cloud , el recurso de postura se crea automáticamente por ti.

Console

  1. En la consola de Google Cloud , ve a la página Administración de la postura.

    Ir a Administración de la postura

  2. Selecciona una organización.

  3. Haz clic en Crear postura. Para crear una postura, puedes comenzar con una postura o plantilla existente, o usar las políticas aplicadas a un recurso.

    Crea una postura con una postura o plantilla existente

    1. Selecciona Comienza con una postura o plantilla existente (explora posturas).
    2. Especifica los detalles de la postura, como el nombre y la descripción.
    3. Haz clic en Seleccionar postura. Puedes crear una postura basada en una postura existente o en una plantilla.
      • Selecciona Postura para crear una postura con una existente. Selecciona una postura de la lista de posturas que se muestran y, luego, selecciona una o más revisiones de la lista de revisiones disponibles para la postura seleccionada.
      • Selecciona Plantilla para crear una postura con una plantilla y, luego, selecciona una o más plantillas de la lista de plantillas que se muestra.
    4. Haz clic en Guardar. En la sección Conjuntos de políticas, puedes ver la lista de conjuntos de políticas asociados con la postura seleccionada.
    5. Selecciona las políticas de la lista de conjuntos de políticas. También puedes editar la política y moverla a un conjunto de políticas diferente en esta página. No puedes crear una postura con dos políticas con el mismo nombre dentro del mismo conjunto de políticas.
    6. Haz clic en Crear.

    Crea una postura con las políticas aplicadas a un recurso

    1. Selecciona Comienza con una postura aplicada a un recurso (explora recursos).
    2. Especifica los detalles de la postura, como el nombre y la descripción.
    3. Haz clic en Seleccionar recursos.
    4. Selecciona un recurso de la lista de recursos que se muestra y haz clic en Crear.

    Se te redireccionará a la página Detalles de la postura, en la que se muestra información sobre la postura que creaste. Puedes ver los conjuntos de políticas asociados con esa postura.

gcloud

  1. Ejecuta el comando gcloud scc postures create para crear una postura con el archivo posture.yaml.

    gcloud scc postures create POSTURE_NAME \
        --posture-from-file=POSTURE_FROM_FILE
    

    Reemplaza los siguientes valores:

    • POSTURE_NAME es el nombre del recurso relativo de la postura. Por ejemplo, organizations/ORGANIZATION_ID/locations/global/postures/POSTURE_ID.

      • POSTURE_ID es un nombre alfanumérico para tu postura que es único para tu organización. POSTURE_ID tiene un límite de 63 caracteres.

    Por ejemplo, para crear una postura con el ID posture-example-1 en la organización organizations/3589215982, ejecuta lo siguiente:

    gcloud scc postures create \
        organizations/3589215982/locations/global/postures/posture-example-1 \
        --posture-from-file=posture.yaml
    

    Si el proceso de creación de la postura falla, borra la postura, soluciona el error y vuelve a intentarlo.

  2. Para verificar que la postura se haya creado correctamente, consulta Visualiza una postura.

Para aplicar esta postura a tu entorno, debes implementar la postura.

Terraform

Si creaste una configuración de Terraform para el recurso de postura, debes aprovisionarlo con tu canalización de infraestructura como código.

Para obtener más información, consulta Terraform en Google Cloud.

Implementa una postura

Después de crear una postura, la implementas en un proyecto, una carpeta o una organización para poder aplicar las políticas y sus definiciones a recursos específicos de tu organización y supervisar las desviaciones. Solo puedes implementar una postura en un proyecto, una carpeta o una organización.

Verifica que el estado de la postura sea ACTIVE.

Cuando implementas la postura, se realizan las siguientes acciones:

  • Se aplican las definiciones de las políticas de la organización y los detectores de Security Health Analytics.
  • Para cada política de la organización personalizada definida en la postura, se crea una nueva restricción personalizada. Esto es así incluso si creaste la postura a partir de una plantilla o de políticas extraídas y las mantuviste sin cambios. El ID de la restricción incluye el ID de revisión de la postura como sufijo. Si se borran todas las implementaciones de la postura, el sufijo se reemplaza por un UUID aleatorio.
  • Para cada detector personalizado de Security Health Analytics definido en la postura, se crea una nueva restricción personalizada. Esto es así incluso si creaste la postura a partir de una plantilla o de políticas extraídas y mantuviste esas políticas sin cambios.
  • El estado predeterminado de los módulos personalizados se establece en Habilitado.

Console

  1. En la consola de Google Cloud , ve a la página Administración de la postura.

    Ir a Administración de la postura

  2. Selecciona una organización.

  3. En la pestaña Posturas, haz clic en la postura que deseas implementar.

  4. En la página Detalles de la postura, selecciona la revisión de la postura. La revisión de la postura que selecciones debe estar en estado activo.

  5. Haz clic en Aplicar a los recursos.

  6. Haz clic en Seleccionar para elegir la organización, la carpeta o el proyecto en el que deseas implementar la postura.

  7. Haz clic en Aplicar postura.

gcloud

Ejecuta el comando gcloud scc posture-deployments create para implementar una postura en un proyecto, una carpeta o una organización.

gcloud scc posture-deployments create POSTURE_DEPLOYMENT_NAME \
    --posture-name=POSTURE_NAME \
    --posture-revision-id=POSTURE_REVISION_ID \
    --target-resource=TARGET_RESOURCE

Reemplaza los siguientes valores:

  • POSTURE_DEPLOYMENT_NAME es el nombre del recurso relativo para la implementación de la postura. El formato es organizations/ORGANIZATION_ID/locations/global/postureDeployments/POSTURE_DEPLOYMENT_ID.

  • LOCATION es global.

  • POSTURE_ID es un nombre alfanumérico para tu postura que es único para tu organización.

  • --posture-name=POSTURE_NAME es el nombre de la postura que implementarás. El formato es organizations/ORGANIZATION_ID/locations/global/postures/POSTURE_ID.

Si tu postura incluye un detector específico de AWS, debes implementar la postura a nivel de la organización (versión preliminar).

Por ejemplo, para implementar una postura, ejecuta el siguiente comando:

gcloud scc posture-deployments create \
  organizations/3589215982/locations/global/postureDeployments/postureDeployment123 \
  --posture-name=organizations/3589215982/locations/global/postures/StagingAIPosture \
  --posture-revision-id=version1 \
  --target-resource=projects/4589215982

Puedes ver la información de estado a medida que se completa el comando. Si el proceso de creación de la implementación de la postura falla, borra la implementación, soluciona el error y vuelve a intentarlo.

Terraform

Puedes crear un recurso de Terraform para implementar una postura.

resource "google_securityposture_posture_deployment" "posture_deployment_example" {
  posture_deployment_id          = "<POSTURE_DEPLOYMENT_ID>"
  parent = "organizations/<ORGANIZATION_ID>"
  location = "global"
  description = "a new posture deployment"
  target_resource = "<TARGET_RESOURCE>"
  posture_id = "<POSTURE_NAME>"
  posture_revision_id = "<POSTURE_REVISION_ID>"
}

Para obtener más información, consulta google_securityposture_posture_deployment.

Visualiza la información de la postura y de su implementación

Puedes ver la información de la postura y de la implementación de la postura para ver datos como los siguientes:

  • Qué posturas se implementan y dónde se aplican en la jerarquía de recursos (organizaciones, proyectos y carpetas)
  • Las revisiones y el estado de las posturas
  • Los detalles operativos de la implementación de una postura

Visualiza una postura

Puedes ver información sobre una postura (como su estado y las definiciones de políticas).

Console

  1. En la consola de Google Cloud , ve a la página Administración de la postura.

    Ir a Administración de la postura

  2. Selecciona una organización.

  3. En la pestaña Posturas, haz clic en la postura que deseas ver. Aparecerán los detalles de la postura.

gcloud

Ejecuta el comando gcloud scc postures describe para ver una postura que creaste.

gcloud scc postures describe POSTURE_NAME \
    --revision-id=REVISION_ID

Reemplaza los siguientes valores:

  • POSTURE_NAME es el nombre del recurso relativo de la postura. Por ejemplo, organizations/ORGANIZATION_ID/locations/global/postures/POSTURE_ID.

  • POSTURE_ID es un nombre alfanumérico para tu postura que es único para tu organización.

  • revision-id=REVISION_ID es una marca opcional que especifica qué versión de la postura se debe ver. Si no incluyes la marca, se devuelve la versión más reciente.

Por ejemplo, para ver una postura con el nombre organizations/3589215982/locations/global/postures/posture-example-1 y el ID de revisión abcdefgh, ejecuta lo siguiente:

gcloud scc postures describe \
    organizations/3589215982/locations/global/postures/posture-example-1 \
    --revision-id=abcdefgh

Visualiza información sobre una operación de implementación de postura

Ejecuta el comando gcloud scc posture-operations describe para ver los detalles de la operación de una operación de implementación de postura.

gcloud scc posture-operations describe OPERATION_NAME

En el ejemplo anterior, OPERATION_NAME es el nombre del recurso relativo para la operación. El formato es organizations/ORGANIZATION_ID/locations/global/operations/OPERATION_ID. Puedes obtener el OPERATION_ID con el argumento --async cuando ejecutas el comando de postura.

Por ejemplo, para ver una operación de análisis con el nombre organizations/3589215982/locations/global/operations/operation-1694515698847-605272e4bcd7c-f93dade6-067467ae, ejecuta lo siguiente:

gcloud scc posture-operations describe \
    organizations/3589215982/locations/global/operations/operation-1694515698847-605272e4bcd7c-f93dade6-067467ae

Visualiza información sobre una implementación de postura

Puedes ver dónde se implementa una postura, así como el estado de la implementación.

Console

  1. En la consola de Google Cloud , ve a la página Administración de la postura.

    Ir a Administración de la postura

  2. Selecciona una organización.

  3. En la pestaña Posturas, haz clic en la postura que implementaste.

  4. Ve a la pestaña Recursos para ver los proyectos, las carpetas y la organización en los que se implementa la postura, así como el estado de la implementación.

gcloud

Ejecuta el comando gcloud scc posture-deployments describe para ver información sobre una postura implementada.

gcloud scc posture-deployments describe POSTURE_DEPLOYMENT_NAME

Donde POSTURE_DEPLOYMENT_NAME es el nombre del recurso relativo para la implementación de la postura. El formato es organizations/ORGANIZATION_ID/locations/global/postureDeployments/POSTURE_DEPLOYMENT_ID.

  • LOCATION es global.
  • POSTURE_DEPLOYMENT_ID es un nombre único para la implementación de la postura.

Por ejemplo, para ver los detalles de una implementación de postura llamada organizations/3589215982/locations/global/postureDeployments/Posture-deployment-example-1, ejecuta el siguiente comando:

gcloud scc posture-deployments describe \
    organizations/3589215982/locations/global/postureDeployments/Posture-deployment-example-1

Actualiza una postura y su implementación

Puedes actualizar lo siguiente:

  • Es el estado de la postura.
  • Son las definiciones de políticas en una postura.
  • La organización, las carpetas o los proyectos en los que se implementa una postura.

Actualiza las definiciones de políticas en una postura

Es posible que debas actualizar una postura cuando habilites más servicios de Google Cloud , implementes recursos adicionales o requieras políticas adicionales para cumplir con requisitos de cumplimiento nuevos o cambiantes. Si actualizas una revisión de postura implementada, esta tarea crea una nueva revisión de postura. De lo contrario, se actualiza la revisión de la postura que especificas cuando ejecutas el comando de actualización.

  1. Abre un archivo YAML en un editor de texto. Agrega los campos que deseas actualizar, junto con sus valores. Si actualizas conjuntos de políticas, asegúrate de que tu archivo incluya todos los conjuntos de políticas que deseas incluir en la postura, incluidos los conjuntos de políticas que ya existen. Para obtener instrucciones, consulta Modifica un archivo YAML de postura.
  2. Ejecuta el comando gcloud scc postures update para actualizar la postura.

    gcloud scc postures update POSTURE_NAME \
        --posture-from-file=POSTURE_FROM_FILE \
        --revision-id=POSTURE_REVISION_ID \
        --update-mask=UPDATE_MASK
    

    Reemplaza los siguientes valores:

    • POSTURE_NAME es el nombre del recurso relativo de la postura. Por ejemplo, organizations/ORGANIZATION_ID/locations/global/postures/POSTURE_ID.

      • POSTURE_ID es un nombre alfanumérico para tu postura que es único para tu organización.
    • POSTURE_FROM_FILE es la ruta de acceso relativa o absoluta al archivo posture.yaml que incluye tus cambios.

      • POSTURE_ID es un nombre alfanumérico para tu postura que es único para tu organización.
    • POSTURE_FROM_FILE es la ruta de acceso relativa o absoluta al archivo posture.yaml que incluye tus cambios.

    • --revision-id=REVISION_ID es la revisión de la postura que deseas implementar. Si la postura ya está implementada, el servicio de postura de seguridad crea automáticamente una versión nueva de la postura con un ID de revisión diferente y lo incluye en el resultado.

    • --update-mask=UPDATE_MASK es la lista de campos que deseas actualizar, en formato separado por comas. Este argumento es opcional. Puedes establecer UPDATE_MASK en uno de los siguientes valores:

      • * o sin especificar: Aplica los cambios que realizaste en los conjuntos de políticas y la descripción de la postura.
      • policy_sets: Aplica solo los cambios que realizaste en los conjuntos de políticas.
      • description: Aplica solo los cambios que realizaste en la descripción de la postura.
      • policy_sets, description: Aplica los cambios que realizaste en los conjuntos de políticas y la descripción de la postura.
      • state: Aplica solo el cambio de estado.

    Por ejemplo, para actualizar una postura con el nombre posture-example-1 en la organización organizations/3589215982/locations/global y el ID de revisión establecido en abcd1234, ejecuta lo siguiente:

    gcloud scc postures update \
        organizations/3589215982/locations/global/posture-example-1 \
        --posture-from-file=posture.yaml --revision-id=abcd1234 --update-mask=policy_sets
    

    Si el proceso de actualización de la postura falla, soluciona el error y vuelve a intentarlo.

  3. Para verificar que la postura se haya actualizado correctamente, consulta Visualiza una postura.

Cambia el estado de una postura

El estado de una postura determina si está disponible para implementarse en un proyecto, una carpeta o una organización.

Una postura puede tener los siguientes estados:

  • DRAFT: La revisión de la postura no está lista para la implementación. No puedes implementar una revisión de postura que esté en el estado DRAFT.
  • ACTIVE: La revisión de la postura está disponible para la implementación. Puedes cambiar el estado de ACTIVE a DRAFT o DEPRECATED.
  • DEPRECATED: No se puede implementar una revisión de postura DEPRECATED en un recurso. Debes borrar todas las implementaciones de la postura existentes antes de poder dar de baja una revisión de la postura. Si quieres volver a implementar una revisión de postura que retiraste, debes cambiar su estado a ACTIVE.

Console

  1. En la consola de Google Cloud , ve a la página Administración de la postura.

    Ir a Administración de la postura

  2. Selecciona una organización.

  3. En la pestaña Posturas, haz clic en la postura que deseas actualizar.

  4. En la página Detalles de la postura, haz clic en Editar.

  5. Selecciona el estado de la postura y haz clic en Guardar.

gcloud

Para cambiar el estado de una postura, ejecuta el comando gcloud scc postures update. No puedes actualizar el estado de la postura al mismo tiempo que actualizas otros campos. Para obtener instrucciones sobre cómo ejecutar el comando gcloud scc postures update, consulta Modifica un archivo YAML de postura.

Actualiza una implementación de postura

Actualiza una implementación de postura en un proyecto, una carpeta o una organización para implementar una postura nueva o una revisión nueva de una postura.

Si la revisión de la postura que estás actualizando incluye una restricción de la organización personalizada que se borró con la consola de Google Cloud , no puedes actualizar la implementación de la postura con el mismo ID de postura. El servicio de políticas de la organización impide la creación de restricciones de organización personalizadas que tengan el mismo nombre. En su lugar, debes crear una versión nueva de la postura o usar un ID de postura diferente.

Además, se desactivarán los hallazgos de las implementaciones de políticas borradas como parte del proceso de actualización.

Console

  1. En la consola de Google Cloud , ve a la página Administración de la postura.

    Ir a Administración de la postura

  2. Selecciona una organización.

  3. En la pestaña Posturas, haz clic en la postura que deseas actualizar.

  4. En la página Detalles de la postura, selecciona la revisión de la postura.

  5. Haz clic en Aplicar a los recursos.

  6. Haz clic en Seleccionar para elegir la organización, la carpeta o el proyecto en el que deseas implementar la postura. Si ves un mensaje que indica que la implementación ya existe, bórrala antes de volver a intentarlo.

gcloud

Ejecuta el comando gcloud scc posture-deployments update para implementar una postura.

gcloud scc posture-deployments update POSTURE_DEPLOYMENT_NAME \
    --description=DESCRIPTION \
    --update-mask=UPDATE_MASK \
    --posture-id=POSTURE_ID \
    --posture-revision-id=POSTURE_REVISION_ID

Reemplaza los siguientes valores:

  • POSTURE_DEPLOYMENT_NAME es el nombre del recurso relativo para la implementación de la postura. El formato es organizations/ORGANIZATION_ID/locations/global/postureDeployments/POSTURE_DEPLOYMENT_ID.

    • POSTURE_DEPLOYMENT_ID es un nombre único para la implementación de la postura.
  • --description=DESCRIPTION es la descripción opcional de la postura implementada.

  • --posture-id=POSTURE_ID es el nombre de tu postura que es único para tu organización. El formato es organizations/ORGANIZATION_ID/locations/global/postures/POSTURE_NAME.

  • --posture-revision-id=POSTURE_REVISION_ID es la revisión de la postura que deseas implementar. Puedes obtenerlo de la respuesta que recibes cuando creas la postura o la visualizas.

  • --update-mask=UPDATE_MASK es la lista de campos que deseas actualizar, en formato separado por comas. Este argumento es opcional.

Por ejemplo, para actualizar una implementación de postura con los siguientes criterios:

  • Organización: organizations/3589215982/locations/global
  • ID de la implementación de la postura: postureDeploymentexample
  • ID de la postura: StagingAIPosture
  • Revisión: version2

Ejecuta el comando siguiente:

gcloud scc posture-deployments update \
    organizations/3589215982/locations/global/postureDeployments/postureDeploymentexample \
    --posture-id=organizations/3589215982/locations/global/postures/StagingAIPosture \
    --posture-revision-id=version2

Puedes ver la información de estado a medida que se completa el comando. Si el proceso de actualización de la implementación de la postura falla, borra la implementación, soluciona el error y vuelve a intentarlo.

Supervisa el desvío de la postura

Puedes supervisar una postura implementada para detectar desviaciones de las políticas definidas en la postura de seguridad. La desviación es un cambio en una política que se produce fuera de una postura. Por ejemplo, el desvío se produce cuando un administrador cambia una definición de política en la consola en lugar de actualizar la implementación de la postura.

El servicio de postura de seguridad crea hallazgos que puedes ver en la consola de Google Cloud o gcloud CLI cada vez que se produce un desvío.

Console

Para todas las posturas, puedes supervisar el desvío con la página Resultados.

  1. En la consola de Google Cloud , ve a la página Hallazgos.

    Ir a Administración de la postura

  2. Selecciona una organización.

  3. Usa las siguientes opciones de filtro para investigar los hallazgos de postura:

    • En el panel Filtros rápidos, selecciona el hallazgo Incumplimiento de la postura. También puedes ingresar el siguiente filtro en Vista previa de consulta:

      state="ACTIVE" AND NOT mute="MUTED" AND finding_class="POSTURE_VIOLATION"
      
    • Para ver los hallazgos relacionados con cualquier módulo personalizado de Security Health Analytics que se aplique específicamente a las cargas de trabajo de Gemini Enterprise Agent Platform, ejecuta la siguiente consulta de filtro:

      state="ACTIVE" AND NOT mute="MUTED" AND resource.type:"aiplatform"
      
    • Para ver los hallazgos relacionados con el desvío de las políticas de la organización de Gemini Enterprise Agent Platform que aplicaste en una postura, ejecuta la siguiente consulta de filtro:

        state="ACTIVE" AND NOT mute="MUTED" AND
        (category="SECURITY_POSTURE_POLICY_DRIFT" OR
        category="SECURITY_POSTURE_POLICY_DELETE" OR
        category="SECURITY_POSTURE_DETECTOR_DRIFT" OR
        category="SECURITY_POSTURE_DETECTOR_DELETE")
        AND contains(risks, risk_category = "AI_WORKLOAD_AT_RISK")
      
  4. Para ver los detalles de un hallazgo, haz clic en él.

gcloud

En gcloud CLI, para ver los hallazgos de desvío, ejecuta lo siguiente:

gcloud scc findings list ORGANIZATION_ID \
    --filter="category=\"SECURITY_POSTURE_DRIFT\""

En el ejemplo anterior, ORGANIZATION_ID es el ID de la organización.

Puedes exportar estos hallazgos de la misma manera que exportas cualquier otro hallazgo de Security Command Center. Para obtener más información, consulta Exporta datos de Security Command Center.

Corrige los hallazgos de postura

Para obtener información sobre cómo abordar cada hallazgo, consulta Hallazgos del servicio de postura de seguridad. También puedes actualizar la implementación de la postura con el mismo ID y la misma revisión de la postura.

Genera un hallazgo de desvío para realizar pruebas

Después de implementar una postura, puedes supervisar si hay desviaciones de tus políticas. Para ver los hallazgos de desvío en acción en un entorno de pruebas, completa lo siguiente:

  1. En la consola, ve a la página Política de la organización.

    Ir a la política de la organización

  2. Selecciona una organización.

  3. Edita una de las políticas que definiste en la postura implementada. Por ejemplo, si usas una postura de IA segura predefinida, puedes editar la política Restringir el acceso de IP pública en los notebooks y las instancias nuevos de Vertex AI Workbench.

  4. Después de cambiar la política, haz clic en Establecer política.

  5. Ir a la página Resultados

    Acceder a Hallazgos

  6. Selecciona una organización.

  7. En el panel Filtros rápidos, en la sección Nombre visible de la fuente, selecciona Postura de seguridad. Debería aparecer un hallazgo relacionado con tu cambio en un plazo de cinco minutos.

  8. Para ver los detalles del hallazgo, haz clic en él.

Borra una implementación de postura

Puedes borrar una implementación de postura si no se implementó correctamente, si ya no necesitas una postura en particular o si ya no quieres que se asigne una postura en particular a un proyecto, una carpeta o una organización. Para borrar una implementación de postura, esta debe encontrarse en uno de los siguientes estados:

  • ACTIVE
  • CREATE_FAILED
  • UPDATE_FAILED
  • DELETE_FAILED

Para verificar el estado de una implementación de postura, consulta Visualiza información sobre una implementación de postura.

Cuando borras una implementación de postura, quitas la postura del recurso (tu organización, carpeta o proyecto) al que la asignaste. Además, desactiva los hallazgos asociados.

El resultado para los diferentes tipos de políticas es el siguiente:

  • Cuando borras una implementación de postura que incluye políticas de la organización personalizadas, estas se borran. Sin embargo, la restricción personalizada sigue existiendo.
  • Cuando borras una implementación de postura que incluye detectores integrados de Security Health Analytics, el estado final de los módulos de Security Health Analytics depende de la organización, la carpeta o el proyecto en el que existía la implementación.

    • Si implementaste una postura en una carpeta o un proyecto, los detectores integrados de Security Health Analytics heredan su estado de la organización o carpeta superior.
    • Si implementaste una postura a nivel de la organización, los detectores integrados de Security Health Analytics vuelven al estado predeterminado. Para obtener una descripción de los estados predeterminados, consulta Habilita e inhabilita detectores.

Console

  1. En la consola de Google Cloud , ve a la página Administración de la postura.

    Ir a Administración de la postura

  2. Selecciona una organización.

  3. En la pestaña Posturas, haz clic en la postura que deseas quitar del recurso al que está asignada.

  4. En la página Detalles de la postura, selecciona la revisión de la postura y ve a Recursos.

  5. En la lista de recursos en los que se implementó la revisión de la postura actualmente activa, haz clic en Quitar.

gcloud

Ejecuta el comando gcloud scc posture-deployments delete para borrar una implementación de postura.

gcloud scc posture-deployments delete POSTURE_DEPLOYMENT_NAME

POSTURE_DEPLOYMENT_NAME es el nombre del recurso relativo para la implementación de la postura. El formato es organizations/ORGANIZATION_ID/locations/global/postureDeployments/POSTURE_DEPLOYMENT_ID.

  • POSTURE_DEPLOYMENT_ID es el nombre único de la implementación de la postura.

Por ejemplo, para borrar una implementación de postura llamada organizations/3589215982/locations/global/postureDeployments/posture-deployment-example-1, ejecuta lo siguiente:

gcloud scc posture-deployments delete \
    organizations/3589215982/locations/global/postureDeployments/posture-deployment-example-1

Borra una postura

Cuando borras una postura, también borras todas las revisiones. No puedes borrar una postura si se implementa alguna de sus revisiones. Debes borrar todas las implementaciones de postura para poder completar esta tarea.

Console

  1. En la consola de Google Cloud , ve a la página Administración de la postura.

    Ir a Administración de la postura

  2. Selecciona una organización.

  3. En la pestaña Posturas, haz clic en la postura que deseas borrar.

  4. En la página Detalles de la postura, haz clic en Borrar.

gcloud

Ejecuta el comando gcloud scc postures delete para borrar una postura.

 gcloud scc postures delete POSTURE_NAME

POSTURE_NAME es el nombre del recurso relativo de la postura.

Por ejemplo, organizations/ORGANIZATION_ID/locations/global/postures/POSTURE_ID. El ID de la postura es un nombre alfanumérico para tu postura que es único para tu organización.

Por ejemplo, para borrar una postura llamada organizations/3589215982/locations/global/postures/posture-example-1, ejecuta el siguiente comando:

 gcloud scc postures delete \
     organizations/3589215982/locations/global/postures/posture-example-1

¿Qué sigue?