Volver a artículos
Solución de problemas2026-06-18•5 min de lectura•Equipo de CSR.plus

Cadena de certificados incompleta: corrige el intermediario faltante

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

ComponenteFunción¿Debe enviarlo el servidor?
Hoja (end-entity)Enlaza tu nombre de hostSí
IntermediarioEnlaza la hoja con la raízSí — faltar significa cadena rota
RaízEl ancla de confianza del clienteNo, 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/null

Cuenta 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/null

Có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.crt

No 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ódigoSignificadoSolución
verify error:num=20 unable to get local issuer certificateIntermediario faltante, o raíz ausente localmenteComprueba cuántos certificados envía el servidor
verify error:num=21 unable to verify the first certificateEl servidor no envía intermediariosConstruye el fullchain y recarga
verify error:num=19 self signed certificateCertificado autofirmado en usoCambia a un certificado de confianza pública
Chrome NET::ERR_CERT_AUTHORITY_INVALIDLa construcción de ruta fallóMisma solución, luego prueba con caché limpia
Java PKIX path building failedFalta CA en el TrustStore o intermediario no devueltoEnvía la cadena completa; no confíes en "abre en un navegador"
curl / Node fallan, el navegador funcionaEl navegador enmascara el problemaTrata curl como la verdad absoluta
Solo fallan algunos dispositivos AndroidAlmacén de confianza antiguo, sin obtención AIAEnvía la cadena completa
El intermedio no firmó la hojaIntermedio equivocado en el archivo de cadenaSirve el intermedio cuyo subject coincide con el issuer de la hoja
Configuraste cert.pemSolo hoja, sin intermediariosCambia a fullchain.pem
CDN / balanceador de carga y origen discrepanCadenas distintas en cada ladoActualiza 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.