D.UA

Усі інструкції

Автоматичні HTTPS-сертифікати через ACME DNS-01

DNS-01 підтверджує контроль над доменом через тимчасовий TXT-запис. Метод підтримує wildcard-сертифікати й не потребує з’єднання центру сертифікації з вашим вебсервером. Отриманий сертифікат потрібно встановити на сервері призначення.

Вимоги

Потрібні зареєстрований домен із DNS d.ua, Python 3, acme.sh, CLI та DNS-хук. Створіть API-токен із правами read і write:records. DDNS-токен не підходить. Не зберігайте облікові дані в публічних файлах чи історії команд.

Установіть допоміжні файли

Завантажте файли інтеграції. Установіть ukapp.py як виконувану команду ukapp, а dns_ukapp.sh скопіюйте до каталогу dnsapi acme.sh. Це власна інтеграція, яка ще не входить до основного комплекту acme.sh.

Перевірте на тестовому центрі сертифікації

Безпечно задайте UKAPP_TOKEN у середовищі процесу та UKAPP_CLI, якщо команда відсутня в PATH. Виконайте:

acme.sh --issue --server letsencrypt_test \
  --dns dns_ukapp -d yourname.d.ua --dnssleep 300

Замініть приклад своїм доменом. Тестовий сертифікат навмисно не є довіреним у браузерах. Після успішної перевірки використайте робочий центр сертифікації та процедури встановлення й продовження вашого клієнта.

Зберігайте стан для продовження

Хук запам’ятовує точний створений TXT у UKAPP_STATE_DIR, типово ~/.cache/ukapp-acme. Каталог має бути доступний завданням очищення та продовження. Наявні TXT зберігаються. Якщо результат запиту невідомий, перевірте DNS перед повторенням.

Альтернатива: lego

Архів також містить lego_ukapp.sh — адаптер для вбудованого провайдера exec у lego. Надайте CLI й адаптеру право виконання. Зберігайте UKAPP_TOKEN у середовищі та використовуйте типовий режим exec; не вмикайте EXEC_MODE=RAW. Для lego 5:

export UKAPP_CLI=/absolute/path/to/ukapp
export EXEC_PATH=/absolute/path/to/lego_ukapp.sh
export EXEC_PROPAGATION_TIMEOUT=600
lego run --dns exec --server letsencrypt-staging \
  --email you@example.com --accept-tos \
  --domains yourname.d.ua --path /private/path/lego-state

Каталоги облікового запису, сертифіката та перевірок мають бути приватними й постійними. Для автоматичного продовження використовуйте те саме середовище. Вбудований провайдер d.ua у lego не потрібний.

Перевірте результат

Переконайтеся, що тимчасовий TXT видалено, установіть сертифікат і налаштуйте перезавантаження сервера після продовження. Wildcard-сертифікат реєстру обслуговує власний проксі та не копіюється на ваш сервер.

Подробиці API для ACME · Домашній сервер