Configura la aplicación de la política de Autorización Binaria

La Autorización Binaria para Google Distributed Cloud es una Google Cloud función que extiende la aplicación alojada durante el tiempo de implementación de la Autorización Binaria a tus clústeres locales. El caso de uso principal de la Autorización Binaria en Google Distributed Cloud es proteger las cargas de trabajo, pero la Autorización Binaria funciona con todos los tipos de clústeres. Sigue los pasos de esta guía para aplicar las reglas de aplicación de una política de Autorización Binaria configurada en tu proyecto Google Cloud a tus clústeres. Para obtener más información sobre las políticas y reglas de la Autorización Binaria, consulta la descripción general de la Autorización Binaria.

Nota: Si habilitaste la Autorización binaria (vista previa) para Google Distributed Cloud, inhabilítala y limpia los recursos antes de habilitar la función de DG. Usa las instrucciones de este documento para habilitar la función de DG en clústeres de la versión 1.16.0 o posterior.

Requisitos previos

Antes de habilitar la aplicación de la política de Autorización Binaria para un clúster, asegúrate de cumplir con los siguientes criterios previos:

• Registra el clúster en una flota: Un clúster creado con bmctl se registra en el proyecto Google Cloud que especificas en el campo gkeConnect.projectID del archivo de configuración del clúster. Este proyecto se conoce como el proyecto host de la flota. Para obtener más información sobre las flotas, incluidos los casos de uso, las prácticas recomendadas y los ejemplos, consulta la documentación de Administración de flotas.

• Habilita la API de Binary Authorization en tu proyecto Google Cloud : habilita la autorización binaria Authorization en tu proyecto host de la flota.

• Agrega el rol de Evaluador de políticas de Autorización Binaria a tu proyecto host de flota: Para otorgar el rol de Evaluador de políticas de Autorización Binaria (roles/binaryauthorization.policyEvaluator) a la cuenta de servicio de Kubernetes en tu proyecto host de flota, ejecuta el siguiente comando:

  gcloud projects add-iam-policy-binding PROJECT_ID \
      --member="serviceAccount:PROJECT_ID.svc.id.goog[binauthz-system/binauthz-agent]" \
      --role="roles/binaryauthorization.policyEvaluator"
  

  Si tu clúster se ejecuta detrás de un servidor proxy, asegúrate de que este permita conexiones a la API de Binary Authorization (binaryauthorization.googleapis.com). Esta API proporciona validación y control de implementación basados en políticas para las imágenes implementadas en tu clúster. Para obtener más información sobre el uso de una configuración de proxy, consulta Instala detrás de un proxy.

Una vez que cumplas con los requisitos previos, podrás habilitar (o inhabilitar) la política de autorización binaria cuando crees un clúster nuevo o actualices uno existente.

Habilita la política de Autorización Binaria durante la creación del clúster

Puedes habilitar la aplicación de la política de Autorización Binaria con bmctl o con gcloud CLI.

bmctl

Para habilitar la Autorización Binaria cuando creas un clúster con bmctl, haz lo siguiente:

1. Antes de crear el clúster, agrega spec.binaryAuthorization.evaluationMode al archivo de configuración del clúster, como se muestra en el siguiente ejemplo:

   ...
   ---
   apiVersion: baremetal.cluster.gke.io/v1
   kind: Cluster
   metadata:
     name: user-basic
     namespace: cluster-user-basic
   spec:
     type: user
     ...
     binaryAuthorization:
       evaluationMode: "PROJECT_SINGLETON_POLICY_ENFORCE"
   

   Los valores permitidos para evaluationMode son los siguientes:

   • PROJECT_SINGLETON_POLICY_ENFORCE: Aplica las reglas especificadas en la política de Autorización Binaria, también conocida como política singleton de proyecto, en tu proyecto Google Cloud para regir la implementación de imágenes de contenedor en tu clúster.

   • DISABLE: Inhabilita el uso de la Autorización binaria para tu clúster. Este es el valor predeterminado. Si omites binaryAuthorization, la función se inhabilita.

2. Realiza los demás cambios necesarios en el archivo de configuración del clúster y, luego, ejecuta el comando bmctl create cluster.

Para obtener más información sobre la creación de clústeres, consulta Descripción general de la creación de clústeres.

gcloud CLI

Vista previa

Este producto o función se encuentra sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles "sin modificaciones" y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

• Para crear un clúster de usuario y habilitar la Autorización binaria, agrega la marca --binauthz-evaluation-mode=PROJECT_SINGLETON_POLICY_ENFORCE cuando ejecutes el comando gcloud container bare-metal clusters create.

  Esto crea un clúster de usuario que aplica las reglas especificadas en la política de Autorización Binaria, también conocida como política singleton de proyecto. Esta política está asociada a tu proyecto Google Cloud y especifica reglas para regir la implementación de imágenes de contenedor. Para obtener más información sobre cómo usar gcloud CLI para crear un clúster de usuario, consulta Crea un clúster de usuario con clientes de la API de GKE On-Prem. Para obtener más información sobre las políticas y reglas de la Autorización Binaria, consulta la Descripción general de la Autorización Binaria.

Habilita o inhabilita la política de Autorización Binaria para un clúster existente

Si tienes un clúster existente de la versión 1.16 o posterior, puedes habilitar o inhabilitar la Autorización Binaria en cualquier momento con bmctl o gcloud CLI.

bmctl

• Para habilitar la función, sigue estos pasos:

  1. Edita el archivo de configuración del clúster para agregar los campos binaryAuthorization:

     ...
     ---
     apiVersion: baremetal.cluster.gke.io/v1
     kind: Cluster
     metadata:
       name: user-basic
       namespace: cluster-user-basic
     spec:
       type: user
       ...
       binaryAuthorization:
         evaluationMode: "PROJECT_SINGLETON_POLICY_ENFORCE"
     

  2. Actualiza el clúster:

     bmctl update cluster -c CLUSTER_NAME --admin-kubeconfig=CLUSTER_KUBECONFIG
     

     Reemplaza lo siguiente:

     • CLUSTER_NAME: es el nombre del clúster que se actualizará.
     • CLUSTER_KUBECONFIG: Es la ruta al archivo kubeconfig del clúster.

  3. Espera a que esté lista la Deployment llamada binauthz-module-deployment en el espacio de nombres binauthz-system.

     Cuando la implementación está lista, la Autorización Binaria aplica las reglas especificadas en la política de Autorización Binaria, también conocida como política singleton de proyecto. Esta política está asociada a tu proyectoGoogle Cloud y especifica reglas para regir la implementación de imágenes de contenedor. Para obtener más información sobre cómo usar bmctl para actualizar un clúster, consulta Actualiza clústeres. Para obtener más información sobre las políticas y reglas de la Autorización Binaria, consulta la Descripción general de la Autorización Binaria.

• Para inhabilitar la función, sigue estos pasos:

  Para desactivar esta función, configura evaluationMode como DISABLED o quita la sección binaryAuthorization de la especificación del clúster. Una vez que se realice este cambio, espera unos minutos hasta que se quite la Deployment llamada binauthz-module-deployment en el espacio de nombres binauthz-system.

gcloud CLI

Vista previa

Este producto o función se encuentra sujeto a las "Condiciones de la Oferta de la Fase Previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles "sin modificaciones" y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

• Para habilitar la Autorización Binaria en un clúster existente, agrega la marca --binauthz-evaluation-mode=PROJECT_SINGLETON_POLICY_ENFORCE cuando ejecutes el comando gcloud container bare-metal clusters update.

  Esto actualiza un clúster de usuario para que la Autorización Binaria aplique las reglas especificadas en la política de Autorización Binaria, también conocida como política singleton de proyecto. Esta política está asociada a tu proyecto deGoogle Cloud y especifica reglas para regir la implementación de imágenes de contenedores. Para obtener más información sobre cómo usar gcloud CLI para actualizar un clúster de usuario, consulta gcloud container bare-metal clusters update en la referencia de gcloud CLI. Para obtener más información sobre las políticas y reglas de la Autorización Binaria, consulta la Descripción general de la Autorización Binaria.

• Para inhabilitar la autorización binaria en un clúster existente, ejecuta el comando gcloud container bare-metal clusters update con la marca --binauthz-evaluation-mode=DISABLED.

Soluciona problemas

Si no completas todos los requisitos previos, es posible que no veas ninguna indicación anticipada de un problema. Si la Autorización binaria comienza a fallar en la respuesta a las solicitudes de creación de Pods, verifica status.conditions para el ReplicaSet. Un mensaje como el siguiente indica que hay un problema con la configuración de autorización binaria:

failed to validate Binary Authorization policy

(1) Ensure the Binary Authorization API is enabled for your Google Cloud project:
    gcloud services enable binaryauthorization.googleapis.com --project=PROJECT_ID
(2) Ensure an IAM policy binding is in place granting binaryauthorization.policyEvaluator role to the binauthz-system/binauthz-agent Kubernetes service account:
    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member="serviceAccount:PROJECT_ID.svc.id.goog[binauthz-system/binauthz-agent]" \
        --role=roles/binaryauthorization.policyEvaluator