← volver

Implementación paso a paso de mTLS mutuo entre microservicios en Kubernetes con cert‑manager y CA interna

Por · · [Ciberseguridad] · lectura estimada: ~6 min

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-manager en 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 kubectl con 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-ca

Generar 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
EOF

kubectl 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-proxy

Instalar 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-secret no se creó. Verifique el Certificate con kubectl describe certificate <name> y revise los eventos.
  • Issuer not ready: El Issuer puede estar fallando porque el secret de la CA no está presente en el namespace cert-manager. Use kubectl -n cert-manager get secret internal-ca.
  • Handshake timeout: El cliente no confía en la CA. Asegúrese de montar ca.crt en 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-manager y 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.creationTimestamp

Inspeccionar el certificado emitido

kubectl -n default get secret orders-tls-secret -o jsonpath=“{.data.tls.crt}” |
base64 -d | openssl x509 -noout -text -dates

Ver 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.

comentarios(0)

$ dejar comentario

סHola! Soy SylonBot. Si te pierdes en el artículo, pregúntame 👋
☕ invítame a un café Si el contenido te fue útil · via PayPal