Как подключить Sectigo ACME: certbot, acme.sh, win-acme

Эта инструкция — для тех, кто заказал Sectigo ACME в TutHost. ACME-клиент — программа на сервере — настраивается один раз. Дальше она сама получает сертификаты Sectigo DV для доменов вашей подписки, подтверждает, что домен ваш (файлом на сайте или записью в DNS), и вовремя заменяет сертификат новым.

О самом продукте и ценах — на странице Sectigo ACME.

Если сайт на виртуальном хостинге TutHost

В DirectAdmin уже встроен бесплатный Let’s Encrypt: он включается в один клик и продлевается сам. Покупать Sectigo ACME стоит, только если вам нужен именно сертификат Sectigo. Тогда есть два пути: вставить ключи EAB в DirectAdmin (раздел 8) или настроить acme.sh через SSH (раздел 3). Что доступно на вашем сервере — уточните в поддержке.

1. Где взять три значения

  1. Войдите в личный кабинет my.tuthost.ua и откройте услугу Sectigo ACME.
  2. Если домены еще не добавлены, нажмите «Настроить», впишите домены и нажмите «Сохранить и создать подписку». Новые домены позже добавляются кнопкой «Добавить домены».
  3. На странице услуги появятся три значения. Обычно это занимает несколько секунд; если их долго нет, обновите страницу позже или напишите в поддержку.
  • Server URL — адрес сервера ACME Sectigo, например https://acme.sectigo.com/v2/DV. Это только пример: берите адрес из личного кабинета.
  • EAB MAC ID — идентификатор вашей подписки.
  • EAB MAC key — секретный ключ.

EAB (External Account Binding) — это «логин и пароль», по которым Sectigo узнает вашу оплаченную подписку. В командах ниже замените <Server URL>, <EAB MAC ID> и <EAB MAC key> своими значениями, а example.com — своим доменом.

EAB MAC key — как пароль. Не пересылайте его в письмах и чатах, не храните в публичных репозиториях и общих файлах.

2. certbot (Linux, nginx или Apache)

Для nginx — одна команда:

sudo certbot --nginx --agree-tos --email admin@example.com \
  --server <Server URL> \
  --eab-kid <EAB MAC ID> --eab-hmac-key <EAB MAC key> \
  -d example.com -d www.example.com

Для Apache замените --nginx на --apache. Если certbot не должен менять настройки веб-сервера, получите только сертификат: certbot certonly --webroot -w /путь/к/сайту с теми же --server, --eab-kid, --eab-hmac-key и -d.

certbot запоминает адрес сервера для этого сертификата, поэтому продление тоже идет через Sectigo.

3. acme.sh (в том числе без root)

acme.sh работает от обычного пользователя, поэтому подходит и для хостинга с доступом SSH. Сначала один раз зарегистрируйте учетную запись:

acme.sh --register-account --server <Server URL> \
  --eab-kid <EAB MAC ID> --eab-hmac-key <EAB MAC key>

Затем получите сертификат. После -w укажите папку, из которой открывается сайт:

acme.sh --issue --server <Server URL> \
  -d example.com -d www.example.com -w /path/to/webroot

Указывайте --server и в этой команде: без него acme.sh обратится к своему центру сертификации по умолчанию (ZeroSSL), а не к Sectigo. Короткого названия для Sectigo в acme.sh нет, поэтому нужен полный адрес.

Чтобы веб-сервер использовал сертификат и перечитывал его после каждого продления, установите сертификат командой --install-cert. Пути к файлам и команду перезагрузки укажите свои:

acme.sh --install-cert -d example.com \
  --key-file /path/to/example.com.key \
  --fullchain-file /path/to/fullchain.pem \
  --reloadcmd "systemctl reload nginx"

4. Wildcard через DNS (DNS-01)

Wildcard (*.example.com) выдается только после проверки через DNS: ACME-клиент сам добавляет в DNS домена временную TXT-запись. Для этого ваш DNS-провайдер должен предоставлять API, а клиент — иметь для него плагин. Проверка файлом на сайте (-w) для wildcard не подходит.

В acme.sh плагины DNS называются dns_<провайдер>; список и нужные переменные — в вики acme.sh, раздел DNS API. Задайте данные доступа к API своего DNS-провайдера как переменные окружения и запустите:

acme.sh --issue --server <Server URL> \
  --dns dns_<провайдер> -d '*.example.com'

Чтобы сертификат действовал и для самого example.com, этот домен должен быть в подписке отдельно — тогда добавьте в команду -d example.com.

Если DNS вашего домена обслуживает TutHost, уточните в поддержке, как настроить проверку через DNS.

5. win-acme (Windows, IIS)

Скачайте win-acme с официального сайта win-acme.com и запустите от имени администратора:

wacs.exe --baseuri <Server URL> --eab-key-identifier <EAB MAC ID> --eab-key <EAB MAC key>

Дальше в меню выберите сайт IIS и домены, как для обычного сертификата. Если программа запросит ключи EAB, вставьте EAB MAC ID и EAB MAC key. win-acme сам создает задание в Планировщике заданий Windows, которое продлевает сертификат.

6. Другие ACME-клиенты

Популярные ACME-клиенты поддерживают EAB. Где указать адрес сервера и ключи:

КлиентПараметры
Posh-ACME (PowerShell)Set-PAServer, затем New-PAAccount -ExtAcctKID … -ExtAcctHMACKey …
Caddyacme_ca <Server URL> и блок acme_eab { key_id … mac_key … }
Traefik v3acme.caServer, acme.eab.kid, acme.eab.hmacEncoded
cert-manager (Kubernetes)spec.acme.externalAccountBinding: keyID и keySecretRef (Secret с ключом)
lego--server, --eab, --kid, --hmac

7. Как проверить автопродление

certbot. Проверьте, что продление проходит:

sudo certbot renew --dry-run

Команда проверяет продление всех сертификатов и не заменяет рабочие. Автоматический запуск certbot обычно настраивает сам — через таймер systemd или cron. Проверить таймер: systemctl list-timers | grep certbot.

acme.sh. При установке acme.sh добавляет ежедневное задание cron. Проверьте его и дату следующего продления:

crontab -l | grep acme.sh
acme.sh --list

win-acme. Откройте Планировщик заданий Windows и убедитесь, что там есть задание win-acme.

8. DirectAdmin, Plesk и cPanel

DirectAdmin 1.711 и новее

С версии 1.711 DirectAdmin умеет получать сертификаты от стороннего ACME-провайдера с ключами EAB — для каждого домена отдельно. Ищите это на странице сертификатов домена (TLS Certificates): нужен выбор своего ACME-провайдера и поля для адреса сервера и ключей EAB. Вставьте Server URL, EAB MAC ID и EAB MAC key — дальше DirectAdmin сам продлевает сертификат.

Названия полей и то, доступна ли эта настройка в вашей учетной записи, зависят от версии и настроек панели. На хостинге TutHost уточните в поддержке.

Plesk с расширением «ACME SSL»

В Plesk 18.0.67 и новее (SSL It! 1.21 и новее) официальное расширение «ACME SSL» позволяет указать для домена адрес сервера ACME и ключи EAB. Расширение поддерживает проверку файлом на сайте (HTTP-01) и через DNS (DNS-01), поэтому подходит и для wildcard. Обычно центр сертификации для домена выбирает сам пользователь, но администратор сервера может это ограничить.

Администратор сервера может сделать то же самое из командной строки:

plesk ext sslit --certificate -issue -domain example.com \
  -directory-url <Server URL> -kid <EAB MAC ID> -hmac <EAB MAC key>

cPanel

Встроенный AutoSSL в cPanel работает только с Let’s Encrypt. Sectigo ACME здесь можно подключить только через SSH — с помощью acme.sh (раздел 3).

9. Типичные ошибки

  • externalAccountRequired или другая ошибка EAB — не переданы --eab-kid и --eab-hmac-key или в --server указан не тот адрес. Проверьте, что все три значения скопированы из кабинета полностью.
  • «A requested identifier has not been delegated» — домена нет в подписке. Добавьте его в кабинете кнопкой «Добавить домены» или докупите позиции кнопкой «Докупить домены / возврат».
  • Сертификат выдал не Sectigo — в команде acme.sh не указан --server (раздел 3).
  • Wildcard не выдается — нужна проверка через DNS (раздел 4).

10. Если ключ EAB попал к посторонним

Сразу напишите в поддержку: поможем решить, что делать с подпиской. Чтобы этого не случилось, храните EAB MAC key так же, как пароль.

Документация ACME-клиентов

Этот материал был полезным?

Похожие материалы