P5 - Permisos en OKE: el nodo tiene identidad, y todos sus pods la heredan

2026-11-20来源 dev.to AWSEnglish
P5 - Permisos en OKE: el nodo tiene identidad, y todos sus pods la heredan

Serie «Kubernetes en OCI al menor costo» — parte 5. En la parte 4
armamos el cluster y los node pools. Acá va cómo lo que corre adentro consigue permisos en OCI.

Soy Matías Galiano, arquitecto de plataforma: llevo 18 años escribiendo software y 7
diseñando y operando sistemas distribuidos sobre Kubernetes, con Terraform y GitOps.
La serie completa se publica primero en mi web, mgaliano.tech.

Hay cosas dentro del cluster que necesitan hablar con la API de OCI. El autoscaler tiene que
agregar y sacar nodos, External Secrets tiene que leer el Vault, Grafana lee métricas de OCI. La
pregunta es con qué credenciales lo hacen.

La respuesta corta es que en un cluster OKE Basic se lo hacen con la identidad del nodo, y
eso tiene una consecuencia que conviene tener clara desde el principio: cualquier pod que corra en
ese nodo puede usar los mismos permisos. Cuento cómo lo armé, por qué lo dejé así por ahora y qué
haría falta para que el permiso sea de cada pod.

Todo sale del Terraform del cluster de producción de Tiendis (iam.tf) y
de la configuración del autoscaler y de External Secrets en el repo de GitOps.

Dos formas de darle identidad a algo

En OCI tengo dos tipos de identidad para lo que corre en el cluster:

  • Usuarios con llave propia. Un usuario de IAM, un grupo, una policy y una llave. Es lo que usan las aplicaciones para escribir en su bucket: cada una tiene el suyo, limitado a ese bucket, como conté en la parte 2. La llave vive en un secreto de Kubernetes, y si alguien se la lleva, puede usarla desde cualquier lado hasta que la rote.
  • Instance principal. La máquina misma tiene identidad. No hay ninguna llave guardada: el nodo la obtiene sola, y OCI decide qué puede hacer según a qué grupo pertenece. Es lo que uso para las piezas de la plataforma: el autoscaler, External Secrets y Grafana.

Si venís de AWS, el instance principal es el equivalente al rol de IAM del nodo (el instance
profile
). Y el problema es el mismo que en EKS antes de IRSA: lo que tiene permiso es la máquina.

El dynamic group: un grupo que se arma solo

Un grupo común tiene usuarios que se agregan a mano. Un dynamic group tiene instancias, y no
se agregan a mano: entran solas si cumplen una regla. El mío es así:

resource "oci_identity_dynamic_group" "oke_nodes" { provider = oci.home # IAM se administra en la home region compartment_id = var.tenancy_ocid name = "oke-proyectos-nodes" description = "Worker nodes del cluster OKE proyectos" matching_rule = "ALL {instance.compartment.id = '${var.compartment_ocid}'}" } 

La regla dice «toda instancia del compartment del cluster». Cuando el autoscaler crea un nodo
nuevo, el nodo entra al grupo sin que yo haga nada, y cuando lo borra, sale. Es la forma que usa
la documentación de OKE, y funciona porque en ese compartment solo viven los nodos del cluster. Si
algún día creo otra máquina ahí, también entraría al grupo con todos sus permisos. La regla
correcta depende de eso: o el compartment es solo del cluster, o la regla filtra por algo más
específico, como un tag.

La policy: solo lo que alguien usa

El dynamic group no da permisos por sí mismo. Los da una policy, escrita casi en lenguaje
natural, donde cada línea dice quién, qué verbo y sobre qué:

resource "oci_identity_policy" "oke_nodes" { provider = oci.home compartment_id = var.compartment_ocid name = "oke-proyectos-nodes" statements = [ # cluster-autoscaler: agregar y sacar nodos del node pool (lo que pide la doc de OKE) "Allow dynamic-group oke-proyectos-nodes to manage cluster-node-pools in compartment id ${var.compartment_ocid}", "Allow dynamic-group oke-proyectos-nodes to manage instance-family in compartment id ${var.compartment_ocid}", "Allow dynamic-group oke-proyectos-nodes to use subnets in compartment id ${var.compartment_ocid}", "Allow dynamic-group oke-proyectos-nodes to read virtual-network-family in compartment id ${var.compartment_ocid}", "Allow dynamic-group oke-proyectos-nodes to use vnics in compartment id ${var.compartment_ocid}", "Allow dynamic-group oke-proyectos-nodes to inspect compartments in compartment id ${var.compartment_ocid}", # External Secrets: leer secretos del Vault y descifrarlos "Allow dynamic-group oke-proyectos-nodes to read secret-family in compartment id ${var.compartment_ocid}", "Allow dynamic-group oke-proyectos-nodes to use keys in compartment id ${var.compartment_ocid}", ] } 

Los verbos van de menos a más: inspect (ver que existe), read (leerlo), use (usarlo sin
cambiarlo) y manage (todo, incluido crear y borrar). La regla que me sirvió es arrancar por lo
que pide la documentación de cada pieza y no sumar nada que no tenga a alguien atrás usándolo. Por
eso cada grupo de líneas tiene un comentario con quién lo usa: si mañana saco el autoscaler, sé
exactamente qué líneas sobran.

Hay dos permisos que muchas guías suman y que en OKE no hacen falta: manage load-balancers y
manage volume-family. Los load balancers de los Service y los discos de los PersistentVolumeClaim
los crea el control plane de OKE con su propia identidad, no los nodos. Lo comprobé creando un
Service de tipo LoadBalancer y un PVC de prueba con la policy de arriba: los dos se crearon
bien. Tampoco hace falta read repos si los pods bajan las imágenes privadas de OCIR con un
imagePullSecret, que es como lo tengo.

Del lado del cluster, cada pieza solo tiene que saber que debe usar instance principal. En el
autoscaler es una variable de entorno, y en External Secrets, una línea del ClusterSecretStore:

# cluster-autoscaler extraEnv: OCI_USE_INSTANCE_PRINCIPAL: "true" --- # External Secrets apiVersion: external-secrets.io/v1 kind: ClusterSecretStore metadata: name: oci-vault spec: provider: oracle: region: sa-santiago-1 vault: <ocid del vault> compartment: <ocid del compartment> principalType: InstancePrincipal # un cluster Basic no tiene workload identity 

Ninguna de las dos tiene una llave montada, y eso es lo que más me gusta del esquema: no hay nada
que rotar.

Cómo consigue un pod la identidad del nodo

Para entender el límite hay que ver cómo funciona por dentro:

Secuencia: el pod pide la identidad al servicio de metadata del nodo, la usa para pedirle un token a IAM y con ese token lee el Vault

  1. Cada instancia de OCI tiene un servicio de metadata en la dirección 169.254.169.254. Es una IP link-local: el rango 169.254.0.0/16 está reservado para hablar solo con el vecino inmediato, no se rutea, y no existe ni en internet ni en la VCN. El hipervisor que corre debajo de la máquina atiende esa dirección y le responde solo a esa instancia. La popularizó AWS con EC2, y OCI, GCP y Azure usan la misma para lo mismo, así que las herramientas la buscan ahí en cualquier nube. Ahí la instancia consulta datos sobre sí misma y obtiene un certificado que dice quién es.
  2. Con ese certificado le pide a IAM un token temporal. IAM revisa si la instancia entra en algún dynamic group.
  3. Con el token llama a la API (en este caso, el Vault), y la API revisa si alguna policy del grupo permite esa acción.

El punto 1 es el que importa: «desde la propia máquina» incluye a todos los pods que corren en
ella
. Un pod cualquiera puede hacer el mismo pedido al servicio de metadata, obtener el mismo
token y leer los mismos secretos que External Secrets. El permiso no es de External Secrets: es del
nodo.

El límite de un cluster Basic

En la práctica, eso quiere decir que hoy cualquier pod del cluster podría leer todos los secretos
del Vault de ese compartment. No es un descuido de configuración: es cómo funciona el instance
principal, y en un cluster Basic no hay otra opción.

La salida real es workload identity: que el permiso se le dé a un service account de un
namespace concreto, y no al nodo. Es el equivalente a IRSA o Pod Identity en EKS, y la policy queda
así:

Allow any-user to read secret-family in compartment id <compartment> where all { request.principal.type = 'workload', request.principal.namespace = 'external-secrets', request.principal.cluster_id = '<ocid del cluster>' } 

Pero OKE solo la soporta en clusters Enhanced, que cuestan USD 0,10 por hora: unos USD 73 por
mes solo por el control plane, que en Basic es gratis. Por ahora lo dejé así, con estas
condiciones que para mí lo hacen razonable en esta etapa:

  • Todo lo que corre en el cluster es mío. No hay código de terceros sin revisar ni clientes que suban sus propios contenedores. El riesgo es que una dependencia comprometida en alguna imagen use ese acceso, y eso es justamente lo que tengo presente.
  • La policy es mínima y en un solo compartment. El daño posible es leer esos secretos o tocar ese node pool, no la cuenta entera.
  • Las aplicaciones no usan el nodo. Cada una tiene su usuario con llave propia limitada a su bucket, así que una aplicación comprometida no gana nada más por estar en el cluster que lo que ya tiene.

El día que en el cluster corra algo que no controlo, o que el CI empiece a compartir nodos con
cosas sensibles, pasar a Enhanced deja de ser opcional.

Referencias

Lo mismo en AWS

AWS (EKS) OCI (OKE Basic)
Identidad de la máquina Rol del nodo (instance profile) Instance principal + dynamic group
Quién entra Las instancias que usan el rol Las que cumplen la regla (matching_rule)
Permiso por pod IRSA o Pod Identity, sin costo extra Workload identity, solo en Enhanced (USD 0,10/h)
Endpoint de metadata 169.254.169.254 (IMDS) 169.254.169.254
Credenciales de las apps Usuario + access key, o rol por pod Usuario + customer secret key por bucket

La diferencia más grande de toda la serie está en esta tabla: en EKS, el permiso por pod viene
incluido; en OKE, hay que pagar el cluster Enhanced para tenerlo.

Lo que viene

En la parte 6 va el Vault y External Secrets: cómo
llegan los secretos desde Terraform hasta un pod sin pasar nunca por git.

Todos los posts de la serie, y lo que voy publicando sobre arquitectura, cloud y Kubernetes,
están en mgaliano.tech/blog.

原文:https://www.a8q9.cn/en/article/p5-permisos-en-oke-el-nodo-tiene-identidad-y-todos-sus-pods-la-heredan-e7951a.html

相关文章