Loading...

Безопасность

DNS-01 challenge: сертификаты Let's Encrypt, проверяемые через DNS

Прежде чем центр сертификации, такой как Let's Encrypt, выдаст сертификат, он проверяет, что вы контролируете домен. DNS-01 challenge делает это с помощью TXT-записи вместо файла на вашем веб-сервере, поэтому работает куда бы ни шёл ваш трафик: до миграции, за CDN, на серверах, недоступных из интернета. Это также единственный способ получить wildcard-сертификат. В этом руководстве объясняется, как он работает и как им пользоваться.

9 мин чтения Средний Обновлено

DNS-01 challenge: сертификаты Let's Encrypt, проверяемые через DNS

Зачем центру сертификации доказательство

Сертификат 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.