Solicitar y validar un certificado

Esta página explica cómo elegir y comprar un certificado SSL, indicar el dominio del certificado y demostrar su propiedad mediante la validación por DNS o HTTP.

#Elegir un certificado

En la consola, abra Certificados SSL → Comprar certificado (/ssl/browse). Puede filtrar el catálogo por canal de emisión en la parte superior de la página. Cada tarjeta de producto muestra:

• El nombre del producto y la marca (por ejemplo, Let's Encrypt, ZeroSSL, DigiCert)
• Una etiqueta de tipo: DV, OV, EV, Comodín o Multidominio
• El período de validez en días y el precio

En el momento de redactar esta documentación, el catálogo contiene lo siguiente; la página del catálogo es siempre la referencia definitiva:

Cómo elegir:

• Solo necesita cifrado HTTPS: elija DV. Los certificados DV de 90 días deben renovarse periódicamente.
• Necesita todos los subdominios de primer nivel (por ejemplo, *.example.com): elija Comodín. Los certificados comodín solo pueden validarse por DNS.
• Un certificado para varios nombres distintos: elija Multidominio.
• Quiere que el certificado incluya la identidad de su organización: elija OV o EV y tenga preparados los datos de su empresa.

#Finalizar la compra y pagar

1. En la tarjeta de un producto, haga clic en Añadir al carrito o en Comprar ahora para ir directamente al carrito (/billing/cart). Los certificados SSL se adquieren mediante un pago único.
2. Revise el carrito y finalice la compra. Se crea una factura para el certificado y aparece un pedido de certificado con el estado Procesamiento pendiente en Mis certificados. Todavía no tiene un dominio asociado.
3. Pague la factura en Facturación → Facturas (/billing/invoices).

#Enviar el dominio y el método de validación

Después del pago, envíe el dominio del certificado y el método de validación del pedido; a continuación, la plataforma envía la solicitud a la CA. Actualmente, este paso se realiza a través de la API de usuario, con autenticación mediante su token de inicio de sesión de la consola:

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

Parámetros:

Si la operación se realiza correctamente, el pedido pasa a estar pendiente de validación y validation_data en la respuesta indica qué debe publicar. Puede volver a obtener estos datos en cualquier momento con GET /api/user/ssl/orders/get?id=<order_id>; los campos validation_token y validation_value contienen el nombre y el valor del registro.

#Completar la validación del dominio

#Validación por DNS (recomendada)

Añada un registro TXT en su proveedor de DNS:

• Los certificados DV, como los de Let's Encrypt y ZeroSSL, suelen utilizar el prefijo _acme-challenge. Otras CA pueden utilizar un nombre o un tipo de registro distinto; utilice siempre los datos devueltos para su pedido.
• Los certificados comodín deben utilizar validación por DNS.
• Si la zona está alojada en Yeap Cloud DNS, puede añadir el registro en la consola; consulte la documentación de DNS.
• Los cambios de DNS suelen tardar entre unos minutos y media hora en ser visibles; con TTL altos, pueden tardar más.

#Validación por HTTP

Publique un archivo de validación en su sitio web para que sea accesible en http://<domain>/.well-known/.... Utilice la ruta y el contenido exactos devueltos para su pedido (por ejemplo, /.well-known/acme-challenge/<token>). Asegúrese de que:

• El dominio se resuelva al servidor que aloja el archivo y el puerto 80 sea accesible.
• La URL devuelva el contenido del archivo sin modificar y no lo intercepte una página de inicio de sesión, un firewall o una regla de reescritura.

#Comprobar la validación y la emisión

Una vez que su registro esté publicado, puede iniciar una comprobación manualmente:

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

# Refresh the order status from the CA; fetches the certificate if it has been issued
curl -X POST https://api.yeap.cloud/api/user/ssl/orders/refresh-status \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"order_id": 123}'

No necesita consultar el estado repetidamente: la plataforma comprueba automáticamente todos los pedidos enviados a una CA a intervalos regulares (aproximadamente cada 30 minutos). Cuando se emite el certificado, se guarda automáticamente, el pedido pasa al estado En vigor y puede descargarlo desde Mis certificados.

El tiempo de emisión depende del tipo de certificado. Los certificados DV suelen emitirse poco después de superar la validación. Los certificados OV y EV también requieren que la CA verifique su organización, lo que normalmente tarda varios días hábiles; la CA puede ponerse en contacto con usted mediante los datos que haya proporcionado.

#Solución de problemas

• La validación nunca se completa correctamente: confirme que el registro sea visible públicamente con dig TXT _acme-challenge.example.com y que el valor esté completo, sin comillas ni espacios adicionales. Para la validación por HTTP, abra la URL de validación en un navegador o con curl y compruebe el cuerpo de la respuesta.
• El pedido muestra el estado Fallido: la CA ha rechazado la solicitud (por ejemplo, porque el dominio no cumple su política de emisión). El motivo se guarda en el pedido y se devuelve en el endpoint de consulta del pedido.
• No hay avances durante mucho tiempo: póngase en contacto con nosotros e indique el ID del pedido.