Зачем центру сертификации доказательство
Сертификат TLS утверждает, что открытый ключ принадлежит домену. Прежде чем центр подпишет это утверждение, ему нужно подтверждение, что тот, кто запрашивает сертификат, контролирует домен. В ACME — протоколе, который используют Let's Encrypt и другие центры, — подтверждением служит challenge: центр выдаёт вашему ACME-клиенту случайный токен, клиент публикует его там, где мог бы только владелец домена, а центр его ищет.
Три типа challenge отличаются только тем, куда помещается токен. Это единственное различие определяет, какие сертификаты вы можете получить, где должен работать ваш клиент и имеет ли значение то, что стоит перед вашим сайтом.
HTTP-01, TLS-ALPN-01 и DNS-01: сравнение
HTTP-01. Клиент отдаёт файл по адресу http://<domain>/.well-known/acme-challenge/<token>, а центр забирает его по порту 80. Это вариант по умолчанию в большинстве клиентов и самый простой для начала. Домен уже должен указывать на сервер, способный отдать файл, порт 80 должен быть открыт, а wildcard-сертификаты так выпустить нельзя.
TLS-ALPN-01. Клиент отвечает на соединение TLS на порту 443 специальным сертификатом для протокола acme-tls/1. Он подходит для конфигураций, где порт 80 закрыт, требует контроля над самим слушателем TLS и тоже не выпускает wildcard.
DNS-01. Клиент публикует TXT-запись _acme-challenge.<domain> со значением, выведенным из токена, а центр ищет её в DNS. Веб-сервер в процессе не участвует. Он проверяет wildcard, работает для хостов, недоступных из интернета, и не зависит от того, что стоит перед сайтом. Взамен клиенту нужен способ записывать DNS-записи: API или ваши руки.
Как работает DNS-01, шаг за шагом
1. Заказ. Ваш ACME-клиент запрашивает сертификат, покрывающий, скажем, example.com и *.example.com.
2. Токен. Для каждого имени центр возвращает challenge DNS-01, а клиент вычисляет значение для публикации из токена и ключа своего аккаунта.
3. TXT-запись. Значение попадает в TXT-запись с именем _acme-challenge.example.com. Wildcard использует то же имя, что и сам домен, поэтому для сертификата на оба нужны два TXT-значения под одним именем. Это нормально: добавьте оба.
4. Распространение. Запись должна дойти до каждого авторитативного сервера имён зоны, потому что центр может обратиться к любому из них и из разных мест.
5. Проверка и выпуск. Клиент просит центр проверить; центр находит значения, помечает имена как проверенные, и клиент скачивает сертификат. После этого TXT-записи можно удалить.
Вы можете увидеть то, что увидит центр, ещё до того, как попросите его посмотреть.
Проверка TXT-записи перед валидацией
# what your resolver sees
dig +short TXT _acme-challenge.example.com
# ask every authoritative name server directly
for ns in $(dig +short NS example.com); do
echo "$ns: $(dig +short TXT _acme-challenge.example.com @$ns)"
done
Для wildcard-сертификатов нужен DNS-01
Wildcard-сертификат покрывает каждое имя первого уровня под доменом: *.example.com соответствует www.example.com, api.example.com и любому поддомену, который вы добавите в следующем году, но не самому example.com и не a.b.example.com. Поэтому заказы wildcard обычно запрашивают example.com и *.example.com вместе.
Let's Encrypt проверяет wildcard-имена только через DNS-01, и причина проста: файл на одном веб-сервере доказывает контроль над одним именем хоста, а wildcard говорит от имени каждого имени хоста в зоне, поэтому доказательство должно исходить от самой зоны.
До миграции, за CDN, на закрытых хостах
Поскольку DNS-01 никогда не обращается к веб-серверу, ему всё равно, куда идёт трафик.
До миграции. Выпустите сертификат для новой платформы, пока домен всё ещё указывает на старую. Когда вы переключите DNS, сертификат уже на месте, и HTTPS работает с первого запроса.
За CDN или прокси. Проверка не зависит от того, какой сервер отвечает на порту 80, поэтому один и тот же клиент работает независимо от того, отдаётся ли сайт напрямую или через CDN.
Закрытые и внутренние хосты. Тестовый сервер, интранет-приложение или почтовый сервер, недоступные из интернета, всё равно могут получить публично доверенный сертификат, если их имя находится в публичной DNS-зоне, в которую вы можете писать.
Много серверов, одно имя. За балансировщиком HTTP-01 должен найти токен на том сервере, который ответит. DNS-01 проверяется один раз, а сертификат вы распространяете сами.
certbot, acme.sh и cert-manager
certbot поддерживает DNS-01 двумя способами. DNS-плагин записывает и удаляет TXT-записи через API вашего DNS-провайдера, что делает возможным и автоматическое продление; плагины есть для большинства крупных DNS-провайдеров и для динамических обновлений RFC 2136 на ваших собственных серверах имён. Ручной режим печатает запись и ждёт, пока вы её добавите: подходит для разового сертификата, но каждое продление требует человека.
acme.sh поддерживает DNS-01 с API более чем сотни провайдеров, а в Kubernetes то же самое делает cert-manager через solver dns01 в Issuer. Что бы вы ни использовали, храните учётные данные API так, чтобы их мог читать только root, и давайте токену самые узкие права, которые предлагает ваш провайдер, в идеале — редактирование DNS одной зоны. Руководство по certbot описывает установку, продление и сторону HTTP-01.
certbot: wildcard-сертификат через DNS-01
# with a DNS plugin (here: RFC 2136 dynamic updates to your own name server)
sudo certbot certonly \
--dns-rfc2136 --dns-rfc2136-credentials /etc/letsencrypt/rfc2136.ini \
-d example.com -d '*.example.com'
# manual: certbot prints the TXT values and waits for you
sudo certbot certonly --manual --preferred-challenges dns \
-d example.com -d '*.example.com'
# test renewal (works with a plugin; manual mode needs you again)
sudo certbot renew --dry-run
На cdn.com.tr: сертификат для edge готов до переключения DNS
Когда вы переносите работающий домен на cdn.com.tr, панель выпускает сертификат для edge через DNS-01, пока домен ещё указывает на вашего текущего провайдера. На вкладке Домены страницы Домены и правила нажмите Настроить сертификат и выберите Получить сертификат до переключения DNS. Мастер называет корневой домен и его wildcard, показывает TXT-запись, которую нужно добавить у вашего текущего DNS-провайдера, сам проверяет запись и выпускает wildcard-сертификат Let's Encrypt, который автоматически устанавливается на серверы CDN.
Переключайте DNS, когда будете готовы: домен отдаётся по HTTPS с первой секунды, без паузы на выпуск сертификата. Панель показывает дату окончания сертификата, а повторный запуск мастера занимает те же несколько минут. Руководство по проверке DNS проведёт вас по каждому экрану.
Когда DNS-01 — правильный challenge
Сертификат для новой платформы существует раньше, чем туда придёт первый посетитель.
Один wildcard-сертификат на каждое имя первого уровня, включая те, что вы добавите позже.
Публично доверенные сертификаты для тестовых, интранет- и почтовых серверов, недоступных из интернета.
Как настроить
Пошаговые руководства в справочном центре:
DNS-01: частые вопросы
Чем HTTP-01 отличается от DNS-01?
HTTP-01 доказывает контроль файлом, отдаваемым на порту 80 домена; DNS-01 — TXT-записью в DNS домена. HTTP-01 требует, чтобы домен указывал на сервер, запрашивающий сертификат; DNS-01 работает куда бы ни указывал домен и является тем challenge, который выпускает wildcard-сертификаты.
Почему две TXT-записи с одним именем?
Сертификату для example.com и *.example.com нужна одна проверка на каждое имя, и обе используют _acme-challenge.example.com. Добавьте оба значения как отдельные TXT-записи и держите их, пока проверка не завершится.
Сколько занимает распространение?
Обычно несколько минут, в зависимости от вашего DNS-провайдера и TTL записи. Перед запуском проверки опросите каждый авторитативный сервер имён через dig; если какой-то всё ещё отвечает без нового значения, подождите.
Работает ли DNS-01 за CDN?
Да. На challenge отвечает ваш DNS, а не сервер, который обслуживает веб-трафик, поэтому он работает одинаково с CDN перед сайтом и без него.
Продлевается ли сертификат DNS-01 автоматически?
С клиентом, который записывает ваш DNS через API, например DNS-плагином certbot, acme.sh или cert-manager, — да. В ручном режиме TXT-запись при каждом продлении добавляет человек, так что учтите это или перейдите на API.
Безопасно ли давать ACME-клиенту доступ к моему DNS?
Ограничьте его. Создайте токен, который может редактировать только нужную зону, или направьте _acme-challenge через CNAME в отдельную зону, используемую только для проверки, чтобы клиент не мог изменить ничего другого. Храните учётные данные так, чтобы их мог читать только root.