Wildcard-сертификат покрывает все поддомены первого уровня одного домена. Например, сертификат *.example.uz подходит сразу для shop.example.uz, api.example.uz и blog.example.uz. Это очень удобно для проектов с множеством поддоменов, SaaS-сервисов, выдающих клиентам отдельные поддомены, или систем, где новые поддомены появляются постоянно. Let's Encrypt выдаёт wildcard бесплатно, но с одним условием: владение доменом подтверждается только методом DNS-01.
Почему именно DNS-01
Для обычного сертификата чаще используется HTTP-01: центр сертификации открывает специальный файл на сайте. С wildcard это не работает по логике вещей: под *.example.uz может быть бесконечно много имён, и они не обязаны указывать на один сервер. Поэтому CA проверяет, что вы управляете DNS-зоной домена. Вы добавляете TXT-запись с выданным значением на имя _acme-challenge.example.uz, центр читает её через DNS и выпускает сертификат.
Есть важная тонкость: wildcard покрывает только один уровень и не покрывает сам основной домен. Сертификат *.example.uz не подходит ни для example.uz, ни для a.b.example.uz. Поэтому в запросе обычно указывают оба имени: example.uz и *.example.uz. При этом на одном и том же имени _acme-challenge.example.uz появляются два разных TXT-значения, и оба должны существовать одновременно.
Ручное получение: хорошо для понимания, но не для постоянной работы
sudo certbot certonly --manual --preferred-challenges dns \
-d example.uz -d '*.example.uz'
# Certbot покажет TXT-значение для каждого имени.
# После добавления, перед нажатием Enter, проверьте:
dig TXT _acme-challenge.example.uz +short @8.8.8.8
Здесь Certbot выдаст два значения: их нужно добавить в DNS-зону и дождаться распространения записей. Чем меньше TTL у TXT-записи, тем быстрее пройдёт проверка. Главная проблема в том, что сертификат, полученный с --manual, не продлевается автоматически: Certbot не умеет сам добавлять TXT-запись. Через 90 дней сертификат истечёт, и сайт начнёт показывать ошибку. Поэтому для постоянной работы нужна автоматизация.
Три способа автоматизации
1. Через API DNS-провайдера
Если DNS домена обслуживается сервисом с API, ACME-клиент сам добавит TXT-запись и удалит её после проверки. acme.sh поддерживает более сотни DNS-сервисов, а для Certbot существуют отдельные плагины. Например, с Cloudflare достаточно записать API-токен в переменную и выполнить одну команду.
export CF_Token="токен-только-с-правом-правки-DNS"
acme.sh --issue --dns dns_cf -d example.uz -d '*.example.uz'
acme.sh --install-cert -d example.uz \
--key-file /etc/ssl/example.uz.key \
--fullchain-file /etc/ssl/example.uz.crt \
--reloadcmd "systemctl reload nginx"
Давайте токену право редактировать только нужную зону. Хранить на сервере ключ с полным доступом ко всему аккаунту опасно: при взломе сервера злоумышленник сможет изменить DNS всех ваших доменов.
2. Делегирование через CNAME
Если у сервиса, где ведётся DNS домена, нет API или вы не хотите давать серверу полный доступ, поможет делегирование через CNAME. Один раз вы направляете имя _acme-challenge.example.uz записью CNAME на имя в другой зоне, у которой есть API. Центр сертификации следует по CNAME и читает TXT-значение уже оттуда. Основная зона остаётся нетронутой, а автоматика меняет только маленькую вспомогательную зону.
; разовая запись в зоне example.uz
_acme-challenge.example.uz. CNAME _acme-challenge.acme.misol.uz.
# acme.sh: проверка в делегированной зоне
acme.sh --issue --dns dns_cf -d example.uz -d '*.example.uz' \
--challenge-alias acme.misol.uz
По этому же принципу работает известный проект acme-dns: небольшой DNS-сервер, предназначенный только для TXT-записей ACME, что удобно с точки зрения безопасности.
3. Собственный DNS-сервер для домена
В крупных проектах иногда поднимают свой DNS-сервер (например, BIND или PowerDNS), а ACME-клиент добавляет TXT-запись по протоколу динамического обновления RFC 2136. Это даёт полный контроль, но и ответственность за поддержку и резервирование DNS ложится на вас. Для малых и средних проектов обычно хватает первых двух способов.
Пример: сервис онлайн-меню с поддоменами для клиентов
Ташкентский стартап запустил сервис онлайн-меню для кафе: каждое кафе получает отдельный адрес вида kafe-nomi.misol.uz. Сначала под каждое новое кафе выпускали отдельный сертификат, и отслеживать десятки сертификатов в месяц стало тяжело. Команда перешла на один сертификат *.misol.uz, направила _acme-challenge через CNAME во вспомогательную зону с API и запустила acme.sh по cron. Теперь при подключении нового кафе о сертификате думать не нужно, а продление каждые 60 дней происходит само.
Если домен зарегистрирован через sayt.uz, записи CNAME или TXT можно добавить в разделе DNS личного кабинета. О возможности автоматизировать управление DNS через API лучше уточнить в кабинете sayt.uz или через техподдержку.
Частые ошибки
- Остались старые TXT-записи. После ручных попыток в зоне копятся лишние значения. Обычно они не мешают, но во избежание путаницы их стоит чистить.
- Не дождались распространения DNS. Если проверка стартует сразу после добавления записи, CA может ещё не увидеть новое значение. В acme.sh время ожидания задаёт параметр
--dnssleep. - Мешает CAA-запись. Если у домена есть CAA-запись и Let's Encrypt в ней не разрешён, сертификат не выдадут.
- Забыли основной домен. Если запросить только
*.example.uz, при открытииexample.uzбраузер покажет ошибку.
После получения сертификата полезно проверить, какие имена он покрывает. Следующая команда покажет список SAN, в котором должны быть и основной домен, и wildcard-имя.
openssl x509 -in /etc/ssl/example.uz.crt -noout -ext subjectAltName