Instalar y renovar

Una vez emitido el certificado, debe implementarlo en su servidor web o CDN y renovarlo antes de que venza. Esta página cubre la página Mis certificados, cómo obtener los archivos del certificado y las formas habituales de implementarlos.

#La página Mis certificados

Abra Certificados SSL → Mis certificados (/ssl/certificates). La lista tiene estas columnas:

Detalles muestra el dominio principal, los nombres SAN, el emisor, el número de serie, las fechas de emisión y vencimiento y la huella digital SHA-256.

#Obtener los archivos del certificado

• Descargar en la lista: aparece una vez emitido el certificado y descarga el propio certificado como <domain>.crt (PEM).
• El paquete completo: el certificado, la clave privada y la cadena intermedia de la CA se pueden recuperar en una sola llamada mediante la API (solo para certificados activos):

curl -X POST https://api.yeap.cloud/api/user/ssl/orders/download \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"order_id": 123}'

Los campos de respuesta certificate, ca_bundle y private_key contienen el certificado, la cadena intermedia de la CA y la clave privada en formato PEM. Para los pedidos emitidos, la página de detalles del pedido en /ssl/order/<order_id> también tiene un botón Descargar certificado que guarda <domain>.crt, <domain>.key y <domain>-ca-bundle.crt.

#Implementar en un servidor web

La mayoría de los servidores requieren una cadena completa: primero su certificado y luego los certificados intermedios de la CA. Combínelos con:

cat example.com.crt example.com-ca-bundle.crt > example.com.fullchain.pem

Si no tiene los certificados intermedios, la herramienta Completar cadena de Herramientas SSL puede crear la cadena completa por usted.

#Nginx

server {
    listen 443 ssl;
    http2 on;
    server_name example.com;

    ssl_certificate     /etc/ssl/example.com.fullchain.pem;
    ssl_certificate_key /etc/ssl/example.com.key;
    ssl_protocols       TLSv1.2 TLSv1.3;
}

Ejecute nginx -t para comprobar la configuración y luego nginx -s reload.

#Apache

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile    /etc/ssl/example.com.fullchain.pem
    SSLCertificateKeyFile /etc/ssl/example.com.key
</VirtualHost>

Apache 2.4.8 y versiones posteriores aceptan un archivo de cadena completa en SSLCertificateFile.

#PFX/PKCS#12 (IIS, Tomcat y otros)

Los archivos se proporcionan en formato PEM. Conviértalos localmente con OpenSSL:

openssl pkcs12 -export -out example.com.pfx \
  -inkey example.com.key -in example.com.crt -certfile example.com-ca-bundle.crt

#Implementar en Yeap Cloud CDN

Si el sitio está en Yeap Cloud CDN, suba el certificado y la clave privada (PEM) para un nombre de host en la página de configuración SSL del dominio de la CDN (/cdn/domains/<domain>/ssl). La CDN también puede emitir y renovar automáticamente certificados gratuitos para sus nombres de host; consulte la documentación de CDN.

#Verificar la implementación

openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null \
  | openssl x509 -noout -subject -issuer -dates

También puede pegar el certificado servido en el Decodificador de certificados de Herramientas SSL para comprobar su validez y los nombres SAN. Si el servidor indica que la clave no coincide, utilice el Verificador de claves para confirmar que el certificado y la clave se corresponden.

#Renovación

Los certificados deben renovarse antes de su vencimiento. Los certificados DV (Let's Encrypt, ZeroSSL) tienen una validez de 90 días; los certificados OV/EV de pago suelen tener una validez de un año. La lista marca los certificados como próximos a vencer durante sus últimos 30 días.

En Mis certificados, los certificados activos y vencidos muestran un botón Renovar. Confirme el mensaje y se creará un pedido de renovación vinculado al pedido original ("Pedido de renovación creado"):

• Certificados DV gratuitos: el pedido de renovación no requiere pago. Envíe el dominio y vuelva a completar la validación como se describe en Solicitar y validar un certificado.
• Certificados de pago: debe pagar el pedido de renovación antes de continuar. Contacte con nosotros si necesita ayuda para completar una renovación de pago, o compre un certificado nuevo en el catálogo para reemplazar el anterior.

También puede iniciar una renovación mediante la API:

curl -X POST https://api.yeap.cloud/api/user/ssl/certificates/renew \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"order_id": 123}'

Cuando se emita el certificado renovado, reemplace los archivos anteriores en su servidor y vuelva a cargar el servicio.

#Subir un certificado existente

Si compró un certificado de otra CA, haga clic en Subir certificado e introduzca el dominio principal, el certificado (PEM), la clave privada (PEM) y, opcionalmente, el paquete de la CA. Se guardará en Mis certificados junto con los demás certificados. La plataforma comprueba el formato y lee automáticamente el emisor y la fecha de vencimiento.

#Eliminar un certificado

Haga clic en Eliminar y confirme. La eliminación no se puede deshacer. Los certificados subidos se pueden eliminar en cualquier momento; los certificados comprados no se pueden eliminar mientras estén activos.

#Reemisión y revocación

Si una clave privada se ha visto comprometida, necesita cambiar el dominio o necesita revocar un certificado, contacte con nosotros e indique el ID del pedido; lo gestionaremos con la CA.