Implementación paso a paso de mTLS mutuo entre microservicios en Kubernetes con cert‑manager y CA interna
Introducción
En entornos de microservicios, la confidencialidad e integridad de la comunicación entre pods es crítica. mTLS (mutual TLS) permite que tanto el cliente como el servidor presenten y validen certificados, garantizando que sólo los componentes autorizados pueden intercambiar datos. En Kubernetes, cert-manager simplifica la emisión y renovación automática de certificados, mientras que una CA interna mantiene el control total sobre la cadena de confianza.
Este artículo describe paso a paso cómo:
- Crear una CA interna con
openssl. - Instalar y configurar
cert-manageren el clúster. - Definir Issuer y Certificate para generar certificados para cada microservicio.
- Habilitar la rotación automática y auditar los certificados emitidos.
Todo el contenido está orientado a sysadmins con conocimientos básicos de Kubernetes y Linux.
1. Preparación del entorno
1.1 Requisitos previos
Antes de comenzar, asegúrate de disponer de:
- Un clúster Kubernetes (v1.22+ recomendado).
- Acceso
kubectlcon privilegios de administrador. - Helm 3 instalado.
- OpenSSL disponible en la máquina local.
1.2 Creación de la CA interna
Utilizaremos OpenSSL para generar una autoridad certificadora (CA) que firmará los certificados de los microservicios.
# Directorio donde guardaremos los artefactos mkdir -p ~/mtls-ca && cd ~/mtls-caGenerar clave privada de la CA (RSA 4096)
openssl genrsa -out ca.key 4096
Crear certificado autofirmado de la CA (válido 10 años)
openssl req -x509 -new -nodes -key ca.key
-sha256 -days 3650
-subj “/C=ES/ST=Madrid/L=Madrid/O=MiEmpresa/OU=Infraestructura/CN=mtls-internal-ca”
-out ca.crt
El par ca.key / ca.crt será importado a Kubernetes como un Secret que cert-manager utilizará para firmar los certificados.
1.3 Subir la CA a Kubernetes
kubectl create namespace cert-manager
kubectl -n cert-manager create secret tls internal-ca
—cert=ca.crt —key=ca.key
Con este Secret disponible, podemos crear un Issuer que haga uso de la CA interna.
2. Instalación y configuración de cert‑manager
2.1 Instalación vía Helm
helm repo add jetstack https://charts.jetstack.io helm repo update
helm install cert-manager jetstack/cert-manager
—namespace cert-manager
—version v1.13.2
—set installCRDs=true
El flag installCRDs=true asegura que los CustomResourceDefinitions necesarios (Issuer, Certificate, etc.) sean creados.
2.2 Definir un Issuer basado en la CA interna
Crearemos un Issuer de tipo CA que utilice el Secret creado en el paso anterior.
cat > internal-ca-issuer.yaml <<EOF apiVersion: cert-manager.io/v1 kind: Issuer metadata: name: internal-ca-issuer namespace: cert-manager spec: ca: secretName: internal-ca EOF
kubectl apply -f internal-ca-issuer.yaml
Este Issuer será la referencia para todos los certificados que necesiten firmarse con la CA interna.
3. Emisión de certificados para microservicios
3.1 Plantilla de Certificate para un servicio
Supongamos que tenemos un microservicio orders expuesto mediante un Service llamado orders-svc. Crearemos un recurso Certificate que genere un certificado válido para el DNS interno orders-svc.default.svc.cluster.local.
cat > orders-certificate.yaml <<EOF apiVersion: cert-manager.io/v1 kind: Certificate metadata: name: orders-tls namespace: default spec: secretName: orders-tls-secret # donde se guardará el certificado + key dnsNames: - orders-svc.default.svc.cluster.local issuerRef: name: internal-ca-issuer kind: Issuer # Solicitar renovación 30 días antes del vencimiento renewalDays: 30 EOF
kubectl apply -f orders-certificate.yaml
Una vez creado, cert-manager generará orders-tls-secret con los campos tls.crt y tls.key.
3.2 Inyección del certificado en el pod
Modificaremos el Deployment del microservicio para montar el secret como volumen y pasar la ruta al contenedor.
cat > orders-deployment.yaml <<EOF apiVersion: apps/v1 kind: Deployment metadata: name: orders labels: app: orders spec: replicas: 2 selector: matchLabels: app: orders template: metadata: labels: app: orders spec: containers: - name: orders image: myrepo/orders:latest ports: - containerPort: 8443 volumeMounts: - name: tls mountPath: /etc/tls readOnly: true env: - name: TLS_CERT_PATH value: /etc/tls/tls.crt - name: TLS_KEY_PATH value: /etc/tls/tls.key volumes: - name: tls secret: secretName: orders-tls-secret EOF
kubectl apply -f orders-deployment.yaml
El contenedor debe estar configurado para usar el certificado en /etc/tls y escuchar en 8443 con TLS.
3.3 Configuración del cliente (mTLS)
Para que otro microservicio, por ejemplo payments, valide el certificado del servidor, necesita confiar en la CA interna. Creamos otro Certificate para payments y compartimos el CA bundle mediante un ConfigMap o un Secret de solo lectura.
# Generar certificado para payments (similar al anterior) cat > payments-certificate.yaml <<EOF apiVersion: cert-manager.io/v1 kind: Certificate metadata: name: payments-tls namespace: default spec: secretName: payments-tls-secret dnsNames: - payments-svc.default.svc.cluster.local issuerRef: name: internal-ca-issuer kind: Issuer EOFkubectl apply -f payments-certificate.yaml
Crear ConfigMap con la CA pública
kubectl -n default create configmap internal-ca-bundle
—from-file=ca.crt=ca.crt
En el Deployment de payments montaremos tanto su propio certificado como el bundle de la CA para validar al cliente remoto.
4. Rotación automática y auditoría
4.1 Configuración de renovación automática
El campo renewalDays del recurso Certificate indica cuántos días antes de la expiración cert-manager intentará renovar el certificado. Podemos reforzar esto con una Policy de cert-manager que limite la duración máxima.
cat > cert-manager-issuer-policy.yaml <<EOF apiVersion: cert-manager.io/v1 kind: Issuer metadata: name: internal-ca-issuer namespace: cert-manager spec: ca: secretName: internal-ca # Política de duración: máximo 90 días duration: 90d renewBefore: 30d EOF
kubectl apply -f cert-manager-issuer-policy.yaml
Con esto, cualquier Certificate que no especifique duration heredará el valor de 90 días.
4.2 Auditoría de certificados emitidos
Para cumplir requisitos de auditoría, podemos exportar la información de los certificados a un sistema de logging (por ejemplo, Elastic Stack) usando los eventos de Kubernetes y cert-manager webhook.
# Habilitar eventos detallados (solo ejemplo, ajuste según su cluster) kubectl edit cm -n kube-system kube-proxyInstalar promtail para enviar logs a Loki (asumiendo Loki instalado)
helm repo add grafana https://grafana.github.io/helm-charts helm install promtail grafana/promtail
—namespace monitoring
—set loki.serviceName=loki
—set extraScrapeConfigs[0].job_name=cert-manager
—set extraScrapeConfigs[0].static_configs[0].targets[0]=cert-manager.cert-manager.svc:9402
Los logs de cert-manager incluyen eventos como CertificateIssued, CertificateRenewed y CertificateFailed. Podemos crear una alerta en Grafana para notificar cualquier renovación fallida.
4.3 Verificación de la cadena de confianza
Para validar que un pod está usando el certificado correcto, podemos ejecutar desde dentro del contenedor:
# Dentro del pod (ejemplo con curl)
curl -v --cert /etc/tls/tls.crt --key /etc/tls/tls.key \
--cacert /etc/ca/ca.crt https://orders-svc.default.svc.cluster.local:8443/health
La salida mostrará la verificación del certificado del servidor y la autenticación mutua.
5. Troubleshooting
5.1 Errores comunes
- Certificate not found: El secret
*-tls-secretno se creó. Verifique elCertificateconkubectl describe certificate <name>y revise los eventos. - Issuer not ready: El
Issuerpuede estar fallando porque el secret de la CA no está presente en el namespacecert-manager. Usekubectl -n cert-manager get secret internal-ca. - Handshake timeout: El cliente no confía en la CA. Asegúrese de montar
ca.crten el contenedor y de que la ruta coincida con la configuración del cliente. - Renewal loop: Si la renovación falla repetidamente, revise los permisos del ServiceAccount usado por
cert-managery la validez de la clave privada de la CA.
5.2 Herramientas de diagnóstico
# Ver eventos de cert‑manager kubectl -n cert-manager get events --sort-by=.metadata.creationTimestampInspeccionar el certificado emitido
kubectl -n default get secret orders-tls-secret -o jsonpath=“{.data.tls.crt}” |
base64 -d | openssl x509 -noout -text -datesVer logs del pod cert‑manager
kubectl -n cert-manager logs -l app=cert-manager -c cert-manager
Conclusión
Implementar mTLS mutuo en Kubernetes con cert-manager y una CA interna brinda una capa robusta de autenticación y cifrado entre microservicios, reduciendo la superficie de ataque y facilitando cumplimiento normativo. La automatización de la emisión y rotación de certificados elimina tareas manuales y minimiza riesgos de expiración. Además, la integración con sistemas de logging permite auditorías continuas y detección temprana de anomalías.
Siguiendo los pasos descritos —creación de la CA, instalación de cert-manager, definición de Issuer/Certificate, inyección de secretos y configuración de rotación/auditoría—, cualquier equipo de operaciones puede desplegar una infraestructura de confianza sin depender de proveedores externos y manteniendo el control total sobre la cadena de certificación.