Заказ и проверка сертификата

На этой странице описано, как выбрать и купить SSL-сертификат, указать домен для сертификата и подтвердить владение доменом через DNS или HTTP.

#Выбор сертификата

В консоли откройте SSL-сертификаты → Купить сертификат (/ssl/browse). В верхней части страницы можно отфильтровать каталог по каналу выпуска. На каждой карточке продукта указаны:

• Название продукта и бренд (например, Let's Encrypt, ZeroSSL, DigiCert)
• Метка типа: DV, OV, EV, Wildcard или Multi-Domain
• Срок действия в днях и цена

На момент написания в каталоге представлены следующие продукты; актуальные сведения всегда приведены на странице каталога:

Как выбрать:

• Требуется только шифрование HTTPS: выберите DV. Сертификаты DV со сроком действия 90 дней необходимо регулярно продлевать.
• Нужны все поддомены первого уровня (например, *.example.com): выберите Wildcard. Для сертификатов Wildcard доступна только проверка через DNS.
• Один сертификат для нескольких разных имён: выберите Multi-Domain.
• Нужно указать в сертификате сведения о вашей организации: выберите OV или EV и подготовьте данные компании.

#Оформление и оплата

1. На карточке продукта нажмите В корзину или Купить сейчас, чтобы сразу перейти в корзину (/billing/cart). SSL-сертификаты приобретаются с разовой оплатой.
2. Проверьте корзину и оформите заказ. Для сертификата будет создан счёт, а в разделе Мои сертификаты появится заказ сертификата со статусом Ожидает обработки. Домен к нему пока не привязан.
3. Оплатите счёт в разделе Финансы → Счета (/billing/invoices).

#Указание домена и способа проверки

После оплаты укажите в заказе домен для сертификата и способ проверки; затем платформа отправит запрос в удостоверяющий центр (CA). Сейчас этот шаг выполняется через пользовательский API с аутентификацией по токену входа в консоль:

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"
  }'

Параметры:

После успешной отправки заказ переходит в состояние ожидания проверки, а поле validation_data в ответе содержит данные, которые нужно опубликовать. Их можно в любой момент получить повторно через GET /api/user/ssl/orders/get?id=<order_id>; поля validation_token и validation_value содержат имя и значение записи.

#Подтверждение владения доменом

#Проверка через DNS (рекомендуется)

Добавьте TXT-запись у своего DNS-провайдера:

• Для сертификатов DV, например Let's Encrypt и ZeroSSL, обычно используется префикс _acme-challenge. Другие CA могут использовать другое имя или тип записи; всегда используйте данные, полученные для вашего заказа.
• Для сертификатов Wildcard обязательна проверка через DNS.
• Если зона размещена в Yeap Cloud DNS, запись можно добавить в консоли; см. документацию DNS.
• Изменения DNS обычно становятся видны через несколько минут — полчаса; при больших значениях TTL это может занять больше времени.

#Проверка через HTTP

Разместите на сайте файл проверки так, чтобы он был доступен по адресу http://<domain>/.well-known/.... Используйте точный путь и содержимое из ответа по заказу (например, /.well-known/acme-challenge/<token>). Убедитесь, что:

• Домен разрешается в адрес сервера с файлом и порт 80 доступен.
• URL возвращает исходное содержимое файла, а страница входа, межсетевой экран или правило перезаписи не перехватывают запрос.

#Проверка и выпуск сертификата

Когда запись станет доступна, вы можете самостоятельно запустить проверку:

# 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}'

Периодически запрашивать статус не требуется: платформа автоматически проверяет все заказы, отправленные в CA, через регулярные интервалы (примерно каждые 30 минут). После выпуска сертификат автоматически сохраняется, заказ получает статус Действует, и сертификат можно скачать в разделе Мои сертификаты.

Срок выпуска зависит от типа сертификата. Сертификаты DV обычно выпускаются вскоре после успешной проверки. Для сертификатов OV и EV удостоверяющий центр также проверяет организацию; это обычно занимает несколько рабочих дней. CA может связаться с вами по указанным контактным данным.

#Устранение неполадок

• Проверка не проходит: убедитесь с помощью dig TXT _acme-challenge.example.com, что запись общедоступна, а её значение указано полностью, без лишних кавычек и пробелов. Для проверки через HTTP откройте URL файла в браузере или с помощью curl и проверьте тело ответа.
• Заказ имеет статус «Ошибка»: CA отклонил запрос (например, домен не соответствует политике выпуска сертификатов). Причина сохраняется в заказе и возвращается конечной точкой получения заказа.
• Статус долго не меняется: свяжитесь с нами и укажите ID заказа.