Cadena de certificados incompleta: corrige el intermediario faltante

Cadena de certificados incompleta: cómo diagnosticar y corregir el intermediario faltante (Nginx / Apache)
Respuesta directa: la mayoría de los "errores de cadena de certificados" no son certificados inválidos — el servidor simplemente envía la hoja sin sus intermediarios. Un comando lo resuelve: cuenta los certificados devueltos con openssl s_client -showcerts; un solo certificado significa una cadena rota. La solución es un archivo concatenado, hoja primero, luego intermediarios: apunta ssl_certificate de Nginx a él, o en Apache 2.4.8+ pon la cadena dentro del archivo de SSLCertificateFile. No envíes la raíz — los clientes ya la tienen.
Conceptos básicos
Los tres componentes
| Componente | Función | ¿Debe enviarlo el servidor? |
|---|---|---|
| Hoja (end-entity) | Enlaza tu nombre de host | Sí |
| Intermediario | Enlaza la hoja con la raíz | Sí — faltar significa cadena rota |
| Raíz | El ancla de confianza del cliente | No, ya está en el almacén de confianza |
Cómo funciona la cadena
Los clientes confían en las raíces directamente. Tu hoja está firmada por un intermediario que no está en su almacén de confianza, así que el servidor debe enviarlo durante el handshake para que el cliente construya hoja → intermediario → raíz. Por qué deben enviarse los intermediarios: los clientes solo confían en raíces locales; sin intermediarios no se puede construir ninguna ruta.
Por qué algunos clientes funcionan y otros fallan
Algunos clientes cachean intermediarios o obtienen el enlace faltante vía la extensión AIA; otros — Android antiguo, Java/OpenJDK, curl, Node, agentes de supervisión — fallan de inmediato. El servidor nunca debe confiar en la reparación del lado del cliente: la obtención AIA es poco fiable porque depende de la implementación del cliente y del alcance de red.
El orden importa
Hoja primero, luego intermediarios en orden de firma. Un orden incorrecto rompe algunos clientes de forma directa.
Jerarquía actual de Let's Encrypt
En la práctica una hoja ECDSA se sirve con un intermedio ECDSA, pero la firma entre algoritmos es válida en X.509: lo que debe coincidir es el emisor y la firma, no el tipo de clave.
Corrígelo en 6 pasos
Paso 1 — Mira qué envía realmente el servidor
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/nullCuenta los bloques BEGIN CERTIFICATE: 1 significa solo hoja; 2 o más es sano.
Paso 2 — Lee el código de verificación
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/nullCódigo 20 = emisor no encontrado (intermediario faltante); 21 = no se puede verificar el primer certificado; 19 = autofirmado.
Paso 3 — Obtén el intermediario correcto
Obtén el intermediario correcto del paquete de cadena de tu CA, o de la extensión Authority Information Access de la hoja. Nunca mezcles generaciones — una hoja ECDSA necesita un intermediario ECDSA. El Decodificador de certificado muestra el emisor y la AIA al instante.
Paso 4 — Concatena (hoja primero, sin raíz)
cat leaf.crt intermediate.crt > fullchain.crtNo añadas la raíz: los clientes ya la tienen en su almacén de confianza local.
Paso 5 — Configura el servidor
Nginx: solo existen ssl_certificate y ssl_certificate_key; no hay una directiva de cadena separada, así que los intermediarios deben vivir en el mismo archivo, hoja primero.
ssl_certificate /etc/ssl/certs/fullchain.crt;
ssl_certificate_key /etc/ssl/private/example.com.key;Apache 2.4.8+: SSLCertificateChainFile se eliminó; pon la cadena en el archivo referenciado por SSLCertificateFile.
Usuarios de Certbot: cert.pem es solo hoja (usarlo es la causa raíz de este error), chain.pem son solo intermediarios, fullchain.pem es lo que configuras.
CDN: la CDN termina TLS con su propio certificado; subir solo la hoja reenvía la misma cadena rota a los visitantes.
Paso 6 — Verifica
openssl verify -CAfile root.pem -untrusted intermediate.pem leaf.pem # espera "leaf.pem: OK"Luego vuelve a probar externamente con Verificador SSL y desde un perfil de navegador limpio.
Lista de solución de problemas
| Síntoma / código | Significado | Solución |
|---|---|---|
| verify error:num=20 unable to get local issuer certificate | Intermediario faltante, o raíz ausente localmente | Comprueba cuántos certificados envía el servidor |
| verify error:num=21 unable to verify the first certificate | El servidor no envía intermediarios | Construye el fullchain y recarga |
| verify error:num=19 self signed certificate | Certificado autofirmado en uso | Cambia a un certificado de confianza pública |
| Chrome NET::ERR_CERT_AUTHORITY_INVALID | La construcción de ruta falló | Misma solución, luego prueba con caché limpia |
| Java PKIX path building failed | Falta CA en el TrustStore o intermediario no devuelto | Envía la cadena completa; no confíes en "abre en un navegador" |
| curl / Node fallan, el navegador funciona | El navegador enmascara el problema | Trata curl como la verdad absoluta |
| Solo fallan algunos dispositivos Android | Almacén de confianza antiguo, sin obtención AIA | Envía la cadena completa |
| El intermedio no firmó la hoja | Intermedio equivocado en el archivo de cadena | Sirve el intermedio cuyo subject coincide con el issuer de la hoja |
| Configuraste cert.pem | Solo hoja, sin intermediarios | Cambia a fullchain.pem |
| CDN / balanceador de carga y origen discrepan | Cadenas distintas en cada lado | Actualiza el fullchain en ambos lados |
Lecturas adicionales
Herramientas: Verificador SSL comprueba la cadena en producción · Decodificador de certificado muestra emisor y AIA · Verificador de certificado y clave también confirma el certificado y el par de claves
Relacionado: Formatos de certificado SSL explicados · Comprueba si un certificado coincide con su clave privada · ACME HTTP-01 frente a DNS-01
Profundiza: Certificados SSL: guía completa · Tipos de certificado comparados · selector de certificados SSL
Preguntas frecuentes
¿Debo incluir la raíz en el fullchain?
No. Los clientes ya la tienen; enviarla solo añade bytes y confusión.
¿Por qué Chrome funciona mientras curl, Java o Android fallan?
Algunos clientes cachean intermediarios o los obtienen vía AIA; otros no. Juzga por curl, no por tu navegador.
¿Oculta un CDN esto?
No. El CDN termina TLS con su propio certificado, así que subir solo la hoja transmite la cadena rota a los visitantes.
¿Cuál es la diferencia entre cert.pem, chain.pem y fullchain.pem?
En el directorio de Certbot: cert.pem es solo la hoja, chain.pem son solo los intermediarios, fullchain.pem es hoja + intermediarios. Usa fullchain.pem en Nginx/Apache.
¿Qué debo hacer con las nuevas raíces de Let's Encrypt?
Normalmente nada manual — los clientes reciben la nueva cadena automáticamente. Solo asegúrate de que ninguna configuración fije un intermediario concreto y de que los almacenes de confianza de clientes antiguos contengan ISRG Root X1/X2.
Herramientas SSL/TLS gratuitas
Verifica e inspecciona tus certificados en segundos.
Información relacionada
Más información sobre cómo elegir y comprar certificados SSL.