Як підключити 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-клієнтів

Цей матеріал був корисним?

Схожі матеріали