Las identidades de carga de trabajo administradas para Google Kubernetes Engine (GKE) te permiten aprovisionar certificados X.509 para cargas de trabajo en clústeres administrados por flotas para establecer la autenticación de TLS mutua (mTLS). Después de configurar una autoridad certificadora (AC), puedes implementar cargas de trabajo y verificar sus identidades y certificados.
Descripción general
Para configurar y usar identidades de cargas de trabajo administradas para GKE, completa los siguientes pasos:
Implementa cargas de trabajo con identidades de cargas de trabajo administradas
Opcional: Habilita la federación de confianza entre grupos de identidades para cargas de trabajo
Grupo de identidades para cargas de trabajo administrado por Google
Cuando agregas clústeres a las flotas de GKE, GKE crea de forma automática un grupo de identidades para cargas de trabajo administrado por Google, que sirve como la raíz de confianza, también conocida como el dominio de confianza de SPIFFE para tus cargas de trabajo. Todas las cargas de trabajo dentro del dominio de confianza reciben certificados y anclas de confianza que habilitan la autenticación de forma predeterminada dentro del dominio de confianza. Si tienes varios dominios de confianza, puedes habilitar la federación de confianza entre ellos para habilitar la comunicación entre dominios de confianza.
El grupo de identidades para cargas de trabajo administrado por Google tiene las siguientes características:
Administración de identidades: Google administra el grupo por completo. No puedes crear ningún recurso secundario, como espacios de nombres, identidades o proveedores de identidad.
Compatibilidad con cargas de trabajo: Solo puedes usar el grupo para cargas de trabajo de GKE. No puedes agregar otros tipos de cargas de trabajo, como VMs de Compute Engine, al grupo.
Integración de flotas: Todos los clústeres del grupo están sujetos al modelo estándar de similitud de espacios de nombres de Kubernetes. Esto significa que todos los clústeres del grupo tienen privilegios equivalentes y las cargas de trabajo de cualquier clúster del grupo pueden usar cualquier identidad dentro de ese grupo.
Grupo de identidades para cargas de trabajo autoadministrado
En entornos de confianza mixta, como las flotas de múltiples usuarios, puedes configurar un grupo de identidades para cargas de trabajo autoadministrado independiente para un subconjunto de tus cargas de trabajo y clústeres. Un grupo de identidades para cargas de trabajo autoadministrado tiene las siguientes características:
Administración de identidades: Cuando defines tu propio grupo de identidades para cargas de trabajo, obtienes el control total de la administración de identidades en el grupo. En el grupo, puedes definir tu propia jerarquía de identidades, como espacios de nombres e identidades. Puedes definir políticas de certificación para especificar qué cargas de trabajo pueden certificar identidades en el grupo o los espacios de nombres.
Compatibilidad con cargas de trabajo: Cualquier carga de trabajo (por ejemplo, VMs, contenedores y cargas de trabajo sin servidores) se puede colocar en el grupo.
Integración de flotas: Para las cargas de trabajo administradas por flotas de GKE, las flotas proporcionan una interfaz integrada para administrar identidades. Puedes configurar tu grupo de identidades para cargas de trabajo como el grupo de usuarios del permiso de la flota. Las flotas crean automáticamente espacios de nombres de grupos de identidades para cargas de trabajo que corresponden a los espacios de nombres de la flota y asignan identidades a las cargas de trabajo.
Para usar un grupo de identidades para cargas de trabajo autoadministrado, debes configurar las funciones de administración de equipos de la flota, como los permisos de equipo y los espacios de nombres de la flota, y configurar el grupo autoadministrado como el grupo de usuarios del permiso. Para obtener instrucciones sobre cómo crear y configurar un grupo autoadministrado, consulta Autentica en las APIs de Google Cloud desde cargas de trabajo de flotas de confianza mixta.
Configuración de varios proyectos
Los recursos deGoogle Cloud que usas en este documento, como
los clústeres de GKE, la AC raíz y las AC subordinadas, pueden existir en
proyectos independientes. Cuando hagas referencia a estos recursos, usa la marca --project
para especificar el proyecto correcto para cada recurso.
Antes de comenzar
Crea o selecciona un proyecto de Google Cloud .
Roles necesarios para seleccionar o crear un proyecto
- Seleccionar un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
-
Crea un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos
(
roles/resourcemanager.projectCreator), que contiene el permisoresourcemanager.projects.create. Obtén más información para otorgar roles.
-
Crea un proyecto de Google Cloud :
gcloud projects create PROJECT_ID
Reemplaza
PROJECT_IDpor un nombre para el proyecto de Google Cloud que estás creando. -
Selecciona el proyecto de Google Cloud que creaste:
gcloud config set project PROJECT_ID
Reemplaza
PROJECT_IDpor el nombre de tu proyecto de Google Cloud .
Comprende las identidades de carga de trabajo administradas.
Asegúrate de que tus clústeres ejecuten la versión 1.33.0-gke.2248000 o una posterior.
Agrega tus clústeres a las flotas de GKE. Si tu clúster es un clúster de Autopilot, omite la marca
--enable-workload-identity. Las flotas crean automáticamente un grupo de identidades para cargas de trabajo administrado por Google, que actúa como un dominio de confianza.Ejecuta el siguiente comando para habilitar las flotas de GKE:
gcloud container clusters update CLUSTER_NAME \ --workload-pool=PROJECT_ID.svc.id.goog \ --enable-fleet \ --fleet-project=PROJECT_ID
Reemplaza estos valores:
CLUSTER_NAME: Es el nombre del clúster de GKE que se registrará en la flota de GKE.PROJECT_ID: el ID del proyecto host de la flota de GKE
-
Habilita las APIs de IAM y Certificate Authority Service, si aún no están habilitadas.
Roles necesarios para habilitar las APIs
Para habilitar las APIs, necesitas el permiso
serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles. Configura Google Cloud CLI para usar tu proyecto de facturación y cuota.
gcloud config set billing/quota_project PROJECT_ID
Reemplaza PROJECT_ID por el ID del proyecto de la flota.
Roles obligatorios
Para obtener los permisos que necesitas para crear identidades de cargas de trabajo administradas y aprovisionar certificados de identidad de cargas de trabajo administradas, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:
-
Para crear y configurar identidades para cargas de trabajo administradas:
Administrador de grupos de identidades para cargas de trabajo de IAM (
roles/iam.workloadIdentityPoolAdmin) -
Para crear y configurar grupos de AC:
Administrador del servicio de AC (
roles/privateca.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.
Elige una opción de CA
Para firmar tus certificados de carga de trabajo, elige la opción de autoridad certificadora (CA) que mejor se adapte a tu caso de uso:
AC predeterminada administrada por Google: Usa esta opción para obtener una solución completamente administrada y sin costo. La AC predeterminada proporciona una raíz de confianza compartida para todos los usuarios de Google Cloud .
CA personalizada: Usa esta opción para configurar tu propia infraestructura de clave pública (PKI) a través de Certificate Authority Service. Esta opción es adecuada si necesitas una raíz de confianza personalizada o si debes almacenar claves de firma en un módulo de seguridad de hardware (HSM) para cumplir con los requisitos de cumplimiento. Certificate Authority Service se cobra por separado de la identidad de carga de trabajo administrada. Para obtener más información, consulta Precios del Servicio de AC.
Configura una CA
AC predeterminada
Para vincular la CA predeterminada al grupo de identidades para cargas de trabajo, actualiza el grupo de identidades para cargas de trabajo con la marca use-default-shared-ca.
gcloud iam workload-identity-pools update TRUST_DOMAIN_NAME \
--location="global" \
--use-default-shared-ca \
--project=PROJECT_ID
Reemplaza lo siguiente:
TRUST_DOMAIN_NAME:Es el nombre del dominio de confianza. Según el tipo de grupo, asigna el nombre de la siguiente manera:
- Grupo administrado por Google:
PROJECT_ID.svc.id.goog - Grupo autoadministrado:
POOL_NAME.global.POOL_HOST_PROJECT_NUMBER.workload.id.goog
- Grupo administrado por Google:
PROJECT_ID: Es el ID del proyecto host de tu flota.
AC personalizada
- Configura CA Service para emitir certificados para identidades de cargas de trabajo administradas.
- Vincula las AC al grupo de identidades para cargas de trabajo.
- Autoriza identidades para cargas de trabajo administradas que te permitan solicitar certificados del grupo de AC.
Configura CA Service para emitir certificados destinados a identidades de cargas de trabajo administradas
Para configurar identidades de cargas de trabajo administradas para GKE, primero debes configurar una autoridad certificadora (AC) y una o más AC subordinadas. Esta configuración se conoce como jerarquía de AC.
Puedes usar grupos de CA Service para configurar esta jerarquía. Con esta jerarquía, el grupo de AC subordinado emite los certificados de Workload Identity X.509 a tus cargas de trabajo.
Los grupos de AC configurados para emitir certificados para cargas de trabajo que usan identidades de carga de trabajo administradas deben residir en la misma región que la carga de trabajo. Si quieres diseñar una arquitectura multirregional para la resiliencia ante las interrupciones regionales, te recomendamos que configures un grupo de AC subordinado de Certificate Authority Service para cada región en la que ejecutes cargas de trabajo. De esta manera, cada una de tus cargas de trabajo puede hacer referencia a un grupo de AC subordinado de Certificate Authority Service en la región.
Configura tu grupo de AC raíz
Para crear el grupo de AC raíz, haz lo siguiente:
Crea el grupo de AC raíz en el nivel Enterprise con
gcloud privateca pools create.
Este nivel está destinado a la emisión de certificados de larga duración y bajo volumen.
gcloud privateca pools create ROOT_CA_POOL_ID \
--location=REGION \
--project=CA_PROJECT_ID \
--tier=enterprise
Reemplaza lo siguiente:
ROOT_CA_POOL_ID: Es un ID único para el grupo de AC raíz. El ID puede tener hasta 64 caracteres y debe contener solo caracteres alfanuméricos en minúscula y mayúscula, guiones bajos o guiones. El ID del grupo debe ser único dentro de la región.REGION: Es la región en la que se encuentra el grupo de AC raíz.CA_PROJECT_ID: Es el ID del proyecto en el que deseas crear la CA raíz.
Para obtener más información sobre los grupos de AC, los niveles y las regiones, consulta Crea grupos de AC.
Configura tu AC raíz
Crea una AC raíz en el grupo de AC raíz con
gcloud privateca roots create.
Es posible que se te solicite habilitar la AC raíz si esta es la única en el grupo de AC raíz.
Para crear una CA raíz, ejecuta el siguiente comando:
gcloud privateca roots create ROOT_CA_ID \
--pool=ROOT_CA_POOL_ID \
--subject="CN=ROOT_CA_CN, O=ROOT_CA_ORGANIZATION" \
--key-algorithm="KEY_ALGORITHM" \
--max-chain-length=1 \
--location=REGION \
--project=CA_PROJECT_ID \
--auto-enable
Reemplaza lo siguiente:
ROOT_CA_ID: Es un nombre único para la AC raíz. El nombre de la AC puede tener hasta 64 caracteres y debe contener solo caracteres alfanuméricos en minúscula y mayúscula, guiones bajos o guiones. El nombre de la AC debe ser único dentro de la región.ROOT_CA_POOL_ID: Es el ID del grupo de AC raíz.ROOT_CA_CN: Es el nombre común de la AC raíz.ROOT_CA_ORGANIZATION: Es la organización de la AC raíz.KEY_ALGORITHM: Es el algoritmo de la clave, por ejemplo,ec-p256-sha256.REGION: Es la región en la que se encuentra el grupo de AC raíz.CA_PROJECT_ID: Es el ID del proyecto en el que creaste la AC raíz.
Para obtener más información sobre los campos subject de la AC, consulta
Asunto.
De manera opcional, puedes crear AC raíz adicionales en tu grupo de AC raíz. Esto puede ser útil para la rotación de AC raíz.
Configura las AC subordinadas
De manera opcional, puedes configurar AC subordinadas. Configurar AC subordinadas puede ayudar con lo siguiente:
Múltiples situaciones de emisión de certificados: Si tienes varias situaciones de emisión de certificados, puedes crear una AC subordinada para cada una.
Mejor balanceo de cargas: Agregar varias AC subordinadas en un grupo de AC te ayuda a lograr un mejor balanceo de cargas de solicitudes de certificado.
Para crear un grupo de AC subordinado y una AC subordinada, haz lo siguiente:
Crea el grupo de AC subordinado en el nivel DevOps, que está destinado a la emisión de certificados de corta duración y gran volumen.
gcloud privateca pools create SUBORDINATE_CA_POOL_ID \ --location=REGION \ --project=CA_PROJECT_ID \ --tier=devopsReemplaza lo siguiente:
SUBORDINATE_CA_POOL_ID: Es un ID único para el grupo de AC subordinado. El ID puede tener hasta 64 caracteres y debe contener solo caracteres alfanuméricos en minúscula y mayúscula, guiones bajos o guiones. El ID del grupo debe ser único dentro de la región.REGION: Es la región en la que se creará el grupo de AC subordinado.CA_PROJECT_ID: Es el ID del proyecto en el que creaste la AC subordinada.
Para obtener más información, consulta Crea grupos de AC.
Crea una AC subordinada en el grupo de AC subordinado. No cambies el modo de emisión basado en la configuración predeterminado.
gcloud privateca subordinates create SUBORDINATE_CA_ID \ --pool=SUBORDINATE_CA_POOL_ID \ --location=REGION \ --issuer-pool=ROOT_CA_POOL_ID \ --issuer-location=REGION \ --subject="CN=SUBORDINATE_CA_CN, O=SUBORDINATE_CA_ORGANIZATION" \ --key-algorithm="KEY_ALGORITHM" \ --use-preset-profile=subordinate_mtls_pathlen_0 \ --project=CA_PROJECT_ID \ --auto-enableReemplaza lo siguiente:
SUBORDINATE_CA_ID: Es un nombre único para la AC subordinada. El nombre puede tener hasta 64 caracteres y debe contener solo caracteres alfanuméricos en minúscula y mayúscula, guiones bajos o guiones. El nombre del grupo debe ser único dentro de la región.SUBORDINATE_CA_POOL_ID: Es el nombre del grupo de AC subordinado.REGION: Es la región en la que se encuentra el grupo de AC subordinado.ROOT_CA_POOL_ID: Es el ID del grupo de AC raíz.REGION: Es la región del grupo de AC raíz.SUBORDINATE_CA_CN: Es el nombre común de la AC subordinada.SUBORDINATE_CA_ORGANIZATION: Es el nombre de la organización emisora de AC subordinada.KEY_ALGORITHM: Es el algoritmo de la clave, por ejemplo,ec-p256-sha256.CA_PROJECT_ID: Es el ID del proyecto en el que creaste la AC subordinada.
Para obtener más información sobre los campos
subjectde la AC, consulta Asunto.
Crea un archivo de configuración de emisión de certificados
La vinculación de AC a grupos de identidades para cargas de trabajo requiere una configuración de emisión de certificados. Si necesitas que tus cargas de trabajo se autentiquen en varios dominios de confianza, consulta Habilita la federación de confianza entre grupos de identidades para cargas de trabajo (opcional).
Para establecer la
configuración de emisión de certificados,
crea un archivo de configuración de emisión de certificados llamado cic.json. El formato del archivo es similar al siguiente:
{
"inlineCertificateIssuanceConfig": {
"caPools": {
"REGION1": "projects/CA_PROJECT_NUMBER1/locations/REGION1/caPools/SUBORDINATE_CA_POOL_ID1",
"REGION2": "projects/CA_PROJECT_NUMBER2/locations/REGION2/caPools/SUBORDINATE_CA_POOL_ID2"
},
"lifetime": "DURATION",
"rotationWindowPercentage": ROTATION_WINDOW_PERCENTAGE,
"keyAlgorithm": "ALGORITHM"
}
}
Reemplaza lo siguiente:
REGION: Son las regiones en las que se encuentran las AC.CA_PROJECT_NUMBER: Es el número del proyecto en el que creaste el grupo de AC subordinado. Para obtener el número de proyecto del proyecto CA_PROJECT_ID, ejecuta el siguiente comando:gcloud projects describe CA_PROJECT_ID --format="value(projectNumber)"
SUBORDINATE_CA_POOL_ID: Es el nombre del grupo de AC subordinado.ALGORITHM: Opcional Es el algoritmo de encriptación que se usa para generar la clave privada. Los valores válidos sonECDSA_P256,ECDSA_P384,RSA_2048,RSA_3072,RSA_4096. Si no se especifica, se usaECDSA_P256como el algoritmo predeterminado.DURATION: Opcional Es la duración de la validez del certificado de hoja, en segundos. El valor debe estar entre 86400 (1 día) y 2592000 (30 días). Si no se especifica, se usa el valor predeterminado de 86,400 (1 día). La validez real del certificado emitido también depende de la AC que lo emite, ya que puede restringir su vida útil.ROTATION_WINDOW_PERCENTAGE: El porcentaje de vida útil del certificado en el que se activa una renovación (opcional). El valor debe estar entre 50 y 80. Si no se especifica, se usa 50 como el valor predeterminado.
Vincula las AC al grupo de identidades para cargas de trabajo
Después de crear tu jerarquía de AC y las opciones de configuración de emisión de certificados para cada AC, vincula las AC al grupo de identidades para cargas de trabajo. Para vincular una AC al grupo de identidades para cargas de trabajo, actualiza el grupo de identidades para cargas de trabajo con la configuración de emisión de certificados de la AC. Luego, puedes verificar que se haya actualizado el grupo.
Actualiza el grupo de identidades para cargas de trabajo
Para actualizar el grupo, ejecuta el siguiente comando:
gcloud iam workload-identity-pools update TRUST_DOMAIN_NAME \
--location="global" \
--inline-certificate-issuance-config-file=CIC_JSON_FILE_PATH \
--project=PROJECT_ID
Reemplaza lo siguiente:
TRUST_DOMAIN_NAME: Es el nombre del dominio de confianza. Según el tipo de grupo, asigna el nombre de la siguiente manera:- Grupo administrado por Google:
PROJECT_ID.svc.id.goog - Grupo autoadministrado:
POOL_NAME.global.POOL_HOST_PROJECT_NUMBER.workload.id.goog
- Grupo administrado por Google:
CIC_JSON_FILE_PATH: Es la ruta de acceso al archivo de configuración de emisión de certificados con formato JSON (cic.json) que creaste antes.
Verifica que se haya actualizado el grupo de identidades para cargas de trabajo
Para verificar que tu grupo de identidades para cargas de trabajo se haya actualizado con la configuración de emisión de certificados, ejecuta el siguiente comando:
gcloud iam workload-identity-pools describe TRUST_DOMAIN_NAME \
--location="global" \
--project=PROJECT_ID
Reemplaza TRUST_DOMAIN_NAME por el nombre del dominio de confianza
que usaste para actualizar el grupo de identidades para cargas de trabajo antes
en este documento.
El resultado del comando es similar al siguiente:
inlineCertificateIssuanceConfig:
caPools:
REGION1: projects/PROJECT_NUMBER1/locations/REGION1/caPools/SUBORDINATE_CA_POOL_ID1,
REGION2: projects/PROJECT_NUMBER2/locations/REGION2/caPools/SUBORDINATE_CA_POOL_ID2
keyAlgorithm: ALGORITHM
lifetime: DURATION
rotationWindowPercentage: ROTATION_WINDOW_PERCENTAGE
mode: TRUST_DOMAIN
name: TRUST_DOMAIN_NAME
state: ACTIVE
Si inlineCertificateIssuanceConfig no está presente en el resultado del comando, verifica que hayas configurado correctamente gcloud CLI para
usar el proyecto correcto para la facturación y la cuota. Es posible que debas actualizar a una
versión más reciente de gcloud CLI.
Autoriza identidades para cargas de trabajo administradas que permitan solicitar certificados del grupo de AC
Después de vincular las AC al grupo de identidades para cargas de trabajo, autoriza a las identidades para cargas de trabajo administradas para que soliciten certificados del grupo de AC. Para autorizar estas identidades, haz lo siguiente:
Otorga el rol de IAM Solicitante de certificados de cargas de trabajo del servicio de AC (
roles/privateca.workloadCertificateRequester) en cada grupo de AC subordinado al dominio de confianza. El siguiente comandogcloud privateca pools add-iam-policy-bindingautoriza al dominio de confianza para solicitar certificados de las cadenas de certificados del Servicio de CA.gcloud privateca pools add-iam-policy-binding SUBORDINATE_CA_POOL_ID \ --location=REGION \ --role=roles/privateca.workloadCertificateRequester \ --member="principal://iam.googleapis.com/projects/PROJECT_NUMBER/name/locations/global/workloadIdentityPools/TRUST_DOMAIN_NAME" \ --project=CA_PROJECT_IDReemplaza lo siguiente:
SUBORDINATE_CA_POOL_ID: Es el ID del grupo de AC subordinado.REGION: Es la región del grupo de AC subordinada.PROJECT_NUMBER: Es el número del proyecto que contiene el grupo de identidades para cargas de trabajo de GKE.Para obtener
PROJECT_NUMBERde tu proyecto de grupo de identidades para cargas de trabajo, ejecuta el siguiente comando.gcloud projects describe WORKLOAD_IDENTITY_POOL_PROJECT_ID --format="value(projectNumber)"
WORKLOAD_IDENTITY_POOL_PROJECT_ID: Es el ID del proyecto que contiene el grupo de identidades para cargas de trabajo.TRUST_DOMAIN_NAME: Es el nombre del dominio de confianza. Según el tipo de grupo, asigna el nombre de la siguiente manera:- Grupo administrado por Google:
PROJECT_ID.svc.id.goog - Grupo autoadministrado:
POOL_NAME.global.POOL_HOST_PROJECT_NUMBER.workload.id.goog
- Grupo administrado por Google:
CA_PROJECT_ID: Es el ID del proyecto en el que creaste la AC subordinada.
Otorga el rol Lector de grupos de servicios de CA (
roles/privateca.poolReader) en los grupos de AC subordinados a la identidad de carga de trabajo administrada. De esta manera, se autoriza a la identidad de carga de trabajo administrada a obtener los certificados X.509 firmados de las cadenas de certificados de la AC.gcloud privateca pools add-iam-policy-binding SUBORDINATE_CA_POOL_ID \ --location=REGION \ --role=roles/privateca.poolReader \ --member="principal://iam.googleapis.com/projects/PROJECT_NUMBER/name/locations/global/workloadIdentityPools/TRUST_DOMAIN_NAME" \ --project=CA_PROJECT_IDReemplaza lo siguiente:
SUBORDINATE_CA_POOL_ID: Es el ID del grupo de AC subordinado.REGION: Es la región del grupo de AC subordinada.PROJECT_NUMBER: Es el número del proyecto que contiene el grupo de identidades para cargas de trabajo de GKE.TRUST_DOMAIN_NAME: Es el nombre del dominio de confianza. Según el tipo de grupo, asigna el nombre con el siguiente formato:- Grupo administrado por Google:
PROJECT_ID.svc.id.goog - Grupo autoadministrado:
POOL_NAME.global.POOL_HOST_PROJECT_NUMBER.workload.id.goog
- Grupo administrado por Google:
CA_PROJECT_ID: Es el ID del proyecto en el que creaste la AC subordinada.
Implementa cargas de trabajo con identidades de carga de trabajo administradas
Después de configurar tus grupos de AC para que emitan certificados para identidades de cargas de trabajo administradas, puedes implementar cargas de trabajo que tengan identidades de cargas de trabajo administradas.
En esta sección, se muestra cómo implementar una carga de trabajo de prueba que tenga una identidad de carga de trabajo administrada. Para ello, implementa un Pod, verifica que se hayan generado las credenciales y consulta el certificado y el ID de SPIFFE.
Implementa un Pod
Puedes implementar un Pod que obtenga su identidad de carga de trabajo administrada de un grupo de identidades para cargas de trabajo administrado por Google o de un grupo de identidades para cargas de trabajo autoadministrado.
Grupo administrado por Google
Para implementar un Pod de prueba en tu clúster, haz lo siguiente:
Obtén las credenciales del clúster.
gcloud container clusters get-credentials CLUSTER_NAME \ --location=CLUSTER_ZONE \ --project=CLUSTER_PROJECT_IDCrea el espacio de nombres de Kubernetes.
kubectl create namespace KUBERNETES_NAMESPACEImplementa un PodSpec de prueba.
cat <<EOF | kubectl apply -f - apiVersion: v1 kind: Pod metadata: namespace: KUBERNETES_NAMESPACE name: example-pod spec: containers: - name: main image: debian command: ['sleep', 'infinity'] volumeMounts: - name: fleet-spiffe-credentials mountPath: /var/run/secrets/workload-spiffe-credentials readOnly: true nodeSelector: iam.gke.io/gke-metadata-server-enabled: "true" volumes: - name: fleet-spiffe-credentials csi: driver: podcertificate.gke.io volumeAttributes: signerName: spiffe.gke.io/fleet-svid trustDomain: fleet-project/svc.id.goog EOF
Grupo autoadministrado
Para implementar un Pod de prueba en tu clúster con un grupo de identidades para cargas de trabajo autoadministrado, haz lo siguiente:
Obtén las credenciales del clúster.
gcloud container clusters get-credentials CLUSTER_NAME \ --location=CLUSTER_ZONE \ --project=CLUSTER_PROJECT_IDCrea el espacio de nombres de Kubernetes.
kubectl create namespace KUBERNETES_NAMESPACEImplementa un PodSpec de prueba.
La siguiente PodSpec configura el atributo de volumen
trustDomainpara un grupo de identidades para cargas de trabajo autoadministrado:cat <<EOF | kubectl apply -f - apiVersion: v1 kind: Pod metadata: namespace: KUBERNETES_NAMESPACE name: example-pod spec: containers: - name: main image: debian command: ['sleep', 'infinity'] volumeMounts: - name: fleet-spiffe-credentials mountPath: /var/run/secrets/workload-spiffe-credentials readOnly: true nodeSelector: iam.gke.io/gke-metadata-server-enabled: "true" volumes: - name: fleet-spiffe-credentials csi: driver: podcertificate.gke.io volumeAttributes: signerName: spiffe.gke.io/fleet-svid trustDomain: fleet-project/tenancy-scope EOF
Enumera las credenciales de la carga de trabajo
Para enumerar las credenciales de la carga de trabajo, ejecuta el siguiente comando. La creación de las credenciales puede tardar unos minutos.
kubectl exec -it example-pod -n KUBERNETES_NAMESPACE -- ls /var/run/secrets/workload-spiffe-credentials
En el resultado del comando, se enumeran los siguientes archivos:
ca_certificates.pem: Contiene el certificado de la AC raíz que firma el certificado de la carga de trabajo.certificates.pem: Contiene el certificado X.509 de la carga de trabajo.private_key.pem: Contiene la clave privada de la carga de trabajo.trust_bundles.json: Contiene un mapa de dominios de confianza y certificados de la AC en los que se debe confiar para la carga de trabajo determinada. Cada entrada contiene la cadena del dominio de confianza como una clave y los certificados de la AC correspondientes a ese dominio de confianza.credential-bundle.pem: Contiene la clave privada y el certificado concatenados, lo que proporciona un solo archivo para las credenciales de mTLS. Este archivo solo está disponible en las versiones de GKE posteriores a la 1.35.2-gke.1291000.
Consulta el certificado.
Para ver el certificado, haz lo siguiente:
Exporta el certificado a un archivo de certificado.
kubectl exec -it example-pod --namespace=KUBERNETES_NAMESPACE -- cat /var/run/secrets/workload-spiffe-credentials/certificates.pem | openssl x509 -noout -text > certfileConsulta el archivo del certificado.
cat certfileEn el certificado, en el atributo
X509v3 Subject Alternative Name, verás el ID de SPIFFE, con un formato similar al siguiente, según el tipo de grupo de identidades para cargas de trabajo:- Grupo administrado por Google:
spiffe://PROJECT_ID.svc.id.goog/ns/KUBERNETES_NAMESPACE/sa/default - Grupo autoadministrado:
spiffe://POOL_NAME.global.POOL_HOST_PROJECT_NUMBER.workload.id.goog/ns/KUBERNETES_NAMESPACE/sa/default
defaulthace referencia a la ServiceAccount predeterminada de Kubernetes.- Grupo administrado por Google:
Prueba la autenticación de carga de trabajo a carga de trabajo
Para probar la autenticación de carga de trabajo a carga de trabajo, consulta Prueba la autenticación de mTLS con Go.
El código de muestra del repositorio crea cargas de trabajo de cliente y servidor. Puedes probar la autenticación mutua entre las cargas de trabajo con los certificados que generaste antes en este documento.
Habilita la federación de confianza entre grupos de identidades para cargas de trabajo (opcional)
Para habilitar la autenticación mutua de las cargas de trabajo en diferentes dominios de confianza, debes configurar la federación de confianza entre los grupos de identidades para cargas de trabajo. Este paso solo es necesario si tus cargas de trabajo deben autenticarse con cargas de trabajo en un grupo de identidades para cargas de trabajo diferente.
Para habilitar la federación de confianza, completa los siguientes pasos:
- Crea el archivo de configuración de confianza.
- Actualiza el grupo de identidades para cargas de trabajo con la configuración de confianza.
Crea el archivo de configuración de confianza
Crea el archivo de configuración de confianza con una sección inlineTrustConfig
que especifique los certificados para cada dominio.
El archivo de configuración de confianza contiene un conjunto de anclas de confianza que la identidad de carga de trabajo administrada usa para validar los certificados de intercambio de tráfico. El archivo de configuración de confianza asigna el dominio de confianza de SPIFFE a los certificados de la AC.
En el caso de la AC personalizada, descarga los certificados de un dominio de confianza que use una AC personalizada.
gcloud privateca pools get-ca-certs ROOT_CA_POOL_ID \ --output-file=CERTIFICATE_PATH \ --location=REGIONReemplaza lo siguiente:
ROOT_CA_POOL_ID: Es el ID del grupo de AC raíz.CERTIFICATE_PATH: Es la ruta de acceso de salida para el certificado codificado en PEM.REGION: Es la región del grupo de AC raíz.
Crea un archivo llamado
tc.jsonque contenga tu configuración de confianza intercalada. Si un dominio usa la AC predeterminada administrada por Google, usa el campotrustDefaultSharedCa. Si un dominio usa una CA personalizada, utiliza los certificados codificados en PEM que descargaste anteriormente.El archivo se ve de la siguiente manera:
En este ejemplo, TRUST_DOMAIN_A usa la CA predeterminada administrada por Google, y TRUSTED_DOMAIN_B usa una CA personalizada con los certificados raíz descargados.
{ "inlineTrustConfig": { "additionalTrustBundles": { "TRUST_DOMAIN_A": { "trustDefaultSharedCa": true }, "TRUSTED_DOMAIN_B": { "trustAnchors": [ { "pemCertificate": "-----BEGIN CERTIFICATE-----\nCERTIFICATE_MATERIAL1\n-----END CERTIFICATE-----" }, { "pemCertificate": "-----BEGIN CERTIFICATE-----\nCERTIFICATE_MATERIAL2\n-----END CERTIFICATE-----" } ] } } } }Reemplaza lo siguiente:
- TRUST_DOMAIN_A: Es el nombre del dominio de confianza que usa la CA predeterminada administrada por Google.
- TRUST_DOMAIN_B: Es el nombre del dominio de confianza que usa una CA personalizada.
- CERTIFICATE_MATERIAL: Es un conjunto de certificados de AC con formato PEM en los que se confía para emitir certificados en el dominio de confianza.
Actualiza el grupo de identidades para cargas de trabajo con la configuración de confianza
gcloud iam workload-identity-pools update TRUST_DOMAIN_NAME \
--location="global" \
--inline-trust-config-file=TC_JSON_FILE_PATH \
--project=PROJECT_ID
Reemplaza lo siguiente:
- TRUST_DOMAIN_NAME: Es el nombre del dominio de confianza.
- TC_JSON_FILE_PATH: Es la ruta de acceso al archivo de configuración de confianza con formato JSON (
tc.json) que creaste. - PROJECT_ID: El ID del proyecto
¿Qué sigue?
- Soluciona problemas de la identidad de carga de trabajo administrada para GKE.
- Obtén más información para crear grupos de AC.
Pruébalo tú mismo
Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
Comenzar gratis