diff --git a/.dockerignore b/.dockerignore index 01d44cb..4317137 100644 --- a/.dockerignore +++ b/.dockerignore @@ -4,6 +4,9 @@ !homegate.py !sync_ssh.py !homegate_ui.py +!dns_challenge.py +!dns-providers-legacy.json +!THIRD_PARTY_NOTICES.md !ui/ !ui/dist/ !ui/dist/** diff --git a/.gitea/workflows/release.yaml b/.gitea/workflows/release.yaml index b48641a..999eaf2 100644 --- a/.gitea/workflows/release.yaml +++ b/.gitea/workflows/release.yaml @@ -35,6 +35,7 @@ jobs: node --check ui/dist/app.js node --check ui/dist/settings.js node --check ui/dist/certificates.js + node --check ui/dist/dns-challenge.js for script in setup.sh run-local.sh ci/smoke_image.sh; do sh -n "$script"; done - name: Compose contracts env: diff --git a/CERTIFICATES.md b/CERTIFICATES.md index 91c3553..00c6b01 100644 --- a/CERTIFICATES.md +++ b/CERTIFICATES.md @@ -5,6 +5,57 @@ а домашний NPM направляет запрос в локальный Nextcloud и предъявляет публичный сертификат. Установка корневого CA на телефон для такого сертификата не требуется. +## Выпуск и автопродление через DNS challenge + +Этот вариант не зависит от VDS: сертификат выпускает и продлевает **домашний NPM**. +Нужен зарегистрированный публичный домен и API-доступ к его DNS-провайдеру. +Публичные A/AAAA-записи продолжают указывать на VDS; для проверки владения доменом +NPM временно создаёт TXT-запись `_acme-challenge`. Открывать домашние порты в интернет +не требуется. Зоны `.home`, `.local` и другие внутренние имена для Let's Encrypt не подходят. + +1. В **Настройки → Доменные зоны** добавьте `hyperdog.dev`. +2. Добавьте сервис с доменом `disk.hyperdog.dev` и локальным адресом Nextcloud. +3. В **HTTPS-сертификат → Источник** выберите **Let’s Encrypt — DNS challenge**. +4. Укажите домены сертификата и выберите DNS-провайдера. Скопируйте показанный шаблон + в поле **API-доступ DNS-провайдера**, заменив значения своим токеном. + Для Cloudflare используйте API Token с разрешением **Zone:DNS:Edit**, ограниченный нужной зоной. +5. При необходимости задайте время ожидания DNS; пустое поле оставляет значение плагина. + Подтвердите условия Let's Encrypt и нажмите **Выпустить сертификат**. +6. Дождитесь результата. Форма сама выберет полученный сертификат домашнего NPM. + Нажмите **Добавить сервис** или **Сохранить** — Homegate создаст локальный DNS и прокси. + +Отдельный выпуск доступен в **Сертификаты → Выпустить Let’s Encrypt**. Можно указать +несколько имён или wildcard, например `*.hyperdog.dev`. Он покрывает `disk.hyperdog.dev`, +но не `hyperdog.dev` и не `deep.disk.hyperdog.dev`. После отдельного выпуска выберите +сертификат в карточках нужных сервисов. + +### Продление и хранение токена + +Домашний NPM сохраняет DNS credentials и автоматически использует их при продлении. +Homegate передаёт их только в запросе выпуска и не сохраняет в своих файлах, +YAML, состоянии задания или логах. В Compose и env добавлять ничего не нужно. +Сертификат остаётся под тем же ID; Homegate не заменяет его сертификатом локального CA. +Резервируйте данные домашнего NPM, включая `/data` и `/etc/letsencrypt`. + +Для выпуска и продления домашнему NPM нужен исходящий доступ к интернету, DNS-провайдеру +и Let's Encrypt. При временном отсутствии интернета уже выпущенный сертификат работает +до истечения срока; локальный Nextcloud остаётся доступен. Подключение к NPM на VDS +не используется и его production-конфигурация не меняется. + +Современный NPM возвращает список провайдеров через API и использует email своей +учётной записи. Для старых версий без этого API Homegate показывает каталог NPM 2.12.6 +и дополнительное поле email. Доступность конкретного плагина зависит от версии домашнего NPM. + +Выпуск идёт в фоне и может занять до 15 минут. Если соединение прервалось или Homegate +перезапустился, нажмите **Проверить результат**: это только чтение списка сертификатов. +Повторный выпуск автоматически не отправляется. Уже существующий действующий сертификат +с тем же набором доменов и провайдером используется повторно. В этом случае новый токен +не записывается поверх старого; ротация credentials существующего сертификата выполняется в NPM. +Если выпуск отклонён, проверьте токен, права на зону и журнал домашнего NPM. + +Протокол: [Let's Encrypt DNS-01](https://letsencrypt.org/docs/challenge-types/#dns-01-challenge). +Права Cloudflare: [документация DNS-плагина Certbot](https://certbot-dns-cloudflare.readthedocs.io/en/stable/). + ## Уже есть подходящий сертификат в домашнем NPM 1. В **Настройки → Доменные зоны** добавьте `hyperdog.dev`. @@ -79,3 +130,9 @@ HTTPS работает до истечения сохранённого серт [исходниками NPM 2.12.6](https://github.com/NginxProxyManager/nginx-proxy-manager/blob/v2.12.6/backend/internal/certificate.js). Тесты используют изолированные HTTP-заглушки и настоящие X.509 сертификаты. Реальные credentials и сертификаты production VDS для разработки не использовались. +DNS challenge проверен по контрактам NPM +[2.12.6](https://github.com/NginxProxyManager/nginx-proxy-manager/blob/v2.12.6/backend/routes/nginx/certificates.js) +и [2.16.0](https://github.com/NginxProxyManager/nginx-proxy-manager/blob/v2.16.0/backend/routes/nginx/certificates.js). +Тесты проверяют фоновый выпуск, восстановление после таймаута, отсутствие повторного +ACME-запроса, фильтрацию credentials и запрет записи на VDS. Интерфейс проверен +с локальной заглушкой NPM; реальный ACME-выпуск и изменение публичного DNS при разработке не выполнялись. diff --git a/Dockerfile b/Dockerfile index ef9855e..4a11480 100644 --- a/Dockerfile +++ b/Dockerfile @@ -2,9 +2,9 @@ FROM python:3.13-slim-bookworm WORKDIR /app COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt -COPY homegate.py sync_ssh.py homegate_ui.py bootstrap.py standalone.py VERSION . +COPY homegate.py sync_ssh.py homegate_ui.py dns_challenge.py dns-providers-legacy.json THIRD_PARTY_NOTICES.md bootstrap.py standalone.py VERSION . COPY ui/dist ./ui/dist -ARG VERSION=0.5.0 +ARG VERSION=0.6.0 LABEL org.opencontainers.image.title="Homegate" \ org.opencontainers.image.description="LAN DNS, HTTPS and SSH management for Pi-hole and NPM" \ org.opencontainers.image.version=$VERSION diff --git a/README.md b/README.md index a674b91..047a917 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Homegate 0.5.0 +# Homegate 0.6.0 Дополнение к **существующим Pi-hole и Nginx Proxy Manager** для домашней сети: @@ -11,14 +11,15 @@ https://pve.home → NPM:443 → https://192.168.0.137:8006 Веб-панель Homegate управляет сервисами, доменными зонами, SSH и настройками сети. SSH-конфиг публикуется без авторизации для устройств домашней подсети. -**Простой запуск 0.5.0: [Compose без env и secrets, вся настройка в UI](SIMPLE.md).** +**Простой запуск 0.6.0: [Compose без env и secrets, вся настройка в UI](SIMPLE.md).** Откройте `http://IP-СЕРВЕРА:8098` и заполните адреса NPM/Pi-hole в форме. Пароль панели не нужен. Расширенный вариант с отдельными контейнерами: [Compose и Gitea Actions](REGISTRY.md). Также доступны: [веб-панель и локальный запуск](WEB.md), [SSH-конфиг и скрипт для ПК](SSH.md), [кастомные доменные зоны и миграция CA](DOMAINS.md). -**Для публичного домена можно выбрать существующий сертификат NPM или обновляемую -копию с NPM на VDS — без установки CA на телефон.** Настройка целиком через UI: -[сертификаты NPM и синхронизация с VDS](CERTIFICATES.md). +**Для публичного домена можно выпустить Let's Encrypt через DNS challenge с автопродлением +в домашнем NPM, выбрать существующий сертификат или обновляемую копию с NPM на VDS — +без установки CA на телефон.** Настройка целиком через UI: +[DNS challenge, сертификаты NPM и синхронизация с VDS](CERTIFICATES.md). Для режима **Homegate — локальный CA** нужно один раз установить `root-ca.crt` на каждое клиентское устройство. Для внутренних имён `.home` публичный сертификат Let's Encrypt не подходит. Установка корневого сертификата на сервер не устанавливает доверие на diff --git a/REGISTRY.md b/REGISTRY.md index 02ee37d..3bd8959 100644 --- a/REGISTRY.md +++ b/REGISTRY.md @@ -75,7 +75,7 @@ Homegate 0.4 поддерживает два способа установки: По умолчанию registry берётся из адреса Gitea, image — из `owner/repository` в нижнем регистре: ```text -git.example.home/your-user/homegate:0.5.0 +git.example.home/your-user/homegate:0.6.0 ``` Если registry доступен по другому имени/порту, задайте Actions **variable** `REGISTRY`, @@ -89,16 +89,16 @@ git.example.home/your-user/homegate:0.5.0 ## 2. Выпустите образ -Файл `VERSION` сейчас содержит `0.5.0`. После загрузки проверенного кода в Gitea: +Файл `VERSION` сейчас содержит `0.6.0`. После загрузки проверенного кода в Gitea: ```sh -git tag v0.5.0 -git push origin v0.5.0 +git tag v0.6.0 +git push origin v0.6.0 ``` При следующем выпуске измените `VERSION`, закоммитьте его вместе с изменениями и создайте -соответствующий тег. Тег должен совпасть с файлом `VERSION`: например `v0.5.0` и `0.5.0`. -Предварительные версии вида `v0.5.0-rc.1` также поддерживаются. Полный номер задаётся +соответствующий тег. Тег должен совпасть с файлом `VERSION`: например `v0.6.0` и `0.6.0`. +Предварительные версии вида `v0.6.0-rc.1` также поддерживаются. Полный номер задаётся в `VERSION`; примеры в Compose, Dockerfile и документации при выпуске также обновите. Workflow `.gitea/workflows/release.yaml` выполняет: @@ -110,7 +110,7 @@ Workflow `.gitea/workflows/release.yaml` выполняет: 3. Только для push тега `v*`, после успешных проверок — проверку `VERSION`, сборку `linux/amd64` + `linux/arm64` и публикацию в Gitea Container Registry. -Образ получает два тега: `0.5.0` и `sha-<полный SHA коммита>`. Тег `latest` не создаётся. +Образ получает два тега: `0.6.0` и `sha-<полный SHA коммита>`. Тег `latest` не создаётся. `org.opencontainers.image.source` связывает метаданные образа с URL исходников. Права на просмотр/скачивание пакета проверьте в Gitea Packages отдельно от доступа к коду. Workflow не запускает контейнеры Homegate и не развёртывает приложение. @@ -136,7 +136,7 @@ sh ci/smoke_image.sh homegate:test В Bash укажите свои адреса. Здесь `.10`, `.11` и `.2` — примеры: ```bash -export HOMEGATE_IMAGE=git.example.home/your-user/homegate:0.5.0 +export HOMEGATE_IMAGE=git.example.home/your-user/homegate:0.6.0 export HOMEGATE_LAN_IP=192.168.0.10 export HOMEGATE_PROXY_IP=192.168.0.11 export HOMEGATE_ALLOWED_NETWORKS='[192.168.0.0/24]' @@ -214,7 +214,7 @@ CA самой VM для `upstream_ca_file` по-прежнему устанав Обновление до уже опубликованной версии: ```sh -export HOMEGATE_IMAGE=git.example.home/your-user/homegate:0.5.0 +export HOMEGATE_IMAGE=git.example.home/your-user/homegate:0.6.0 docker compose pull docker compose up -d ``` diff --git a/SIMPLE.md b/SIMPLE.md index 856d074..07b64d0 100644 --- a/SIMPLE.md +++ b/SIMPLE.md @@ -1,6 +1,6 @@ # Homegate: запуск и настройка через браузер -Используйте образ `gitea.hyperdog.dev/dizyaka/homegate:0.5.0` после успешной публикации +Используйте образ `gitea.hyperdog.dev/dizyaka/homegate:0.6.0` после успешной публикации версии в Gitea Actions. Содержимое [compose.simple.yaml](compose.simple.yaml) сохраните на сервере как `compose.yaml`. Файл не содержит адресов, environment, secrets или паролей. @@ -37,8 +37,13 @@ RFC1918 и ULA адресов; после настройки действует скачивается в разделе **Сертификаты**; установите его на клиентские устройства для доверия HTTPS. Для публичных доменов, например `disk.hyperdog.dev`, можно использовать сертификат NPM -без установки CA на устройства. В карточке сервиса выберите **Существующий сертификат -домашнего NPM** или **Копия из NPM на VDS — автообновление**. Подключение к VDS +без установки CA на устройства. В карточке сервиса выберите **Let’s Encrypt — DNS challenge**, +укажите DNS-провайдера и API-токен по шаблону. Домашний NPM выпустит сертификат и будет +продлевать его автоматически; VDS не участвует. После выпуска сохраните сервис. +В Compose ничего добавлять не нужно. + +Также доступны **Существующий сертификат домашнего NPM** и +**Копия из NPM на VDS — автообновление**. Подключение к VDS задаётся в разделе **Настройки → Сертификаты с NPM на VDS**. Подробные шаги и поведение при продлении: [CERTIFICATES.md](CERTIFICATES.md). diff --git a/THIRD_PARTY_NOTICES.md b/THIRD_PARTY_NOTICES.md new file mode 100644 index 0000000..bffa180 --- /dev/null +++ b/THIRD_PARTY_NOTICES.md @@ -0,0 +1,26 @@ +# Third-party notices + +`dns-providers-legacy.json` contains provider names and credential templates from +[Nginx Proxy Manager v2.12.6](https://github.com/NginxProxyManager/nginx-proxy-manager/blob/v2.12.6/global/certbot-dns-plugins.json). + +MIT License + +Copyright (c) 2017 + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/VERSION b/VERSION index 8f0916f..a918a2a 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.5.0 +0.6.0 diff --git a/compose.registry.yaml b/compose.registry.yaml index e630d58..03d92d1 100644 --- a/compose.registry.yaml +++ b/compose.registry.yaml @@ -1,6 +1,6 @@ # Download this file only. Supply settings/passwords via the shell or an optional .env. # Docker Compose >= 2.30.0 (not docker stack deploy). See REGISTRY.md. -# Example image: git.example.home/your-user/homegate:0.5.0 +# Example image: git.example.home/your-user/homegate:0.6.0 name: homegate x-runtime: &runtime diff --git a/compose.simple.yaml b/compose.simple.yaml index 12f0189..5a28c00 100644 --- a/compose.simple.yaml +++ b/compose.simple.yaml @@ -2,7 +2,7 @@ name: homegate services: homegate: - image: gitea.hyperdog.dev/dizyaka/homegate:0.5.0 + image: gitea.hyperdog.dev/dizyaka/homegate:0.6.0 entrypoint: [python, /app/standalone.py] restart: unless-stopped init: true diff --git a/compose.yaml b/compose.yaml index 54c80ac..5228495 100644 --- a/compose.yaml +++ b/compose.yaml @@ -2,7 +2,7 @@ name: homegate services: homegate: build: . - image: homegate:0.5.0 + image: homegate:0.6.0 restart: unless-stopped init: true user: "${LOCAL_UID:-1000}:${LOCAL_GID:-1000}" @@ -50,7 +50,7 @@ services: ssh-export: build: . - image: homegate:0.5.0 + image: homegate:0.6.0 command: [serve] restart: unless-stopped init: true @@ -87,7 +87,7 @@ services: ui: build: . - image: homegate:0.5.0 + image: homegate:0.6.0 entrypoint: [python, /app/homegate_ui.py] command: [] restart: unless-stopped diff --git a/dns-providers-legacy.json b/dns-providers-legacy.json new file mode 100644 index 0000000..66be6b4 --- /dev/null +++ b/dns-providers-legacy.json @@ -0,0 +1,380 @@ +{ + "source": "https://github.com/NginxProxyManager/nginx-proxy-manager/blob/v2.12.6/global/certbot-dns-plugins.json", + "providers": [ + { + "id": "acmedns", + "name": "ACME-DNS", + "credentials": "dns_acmedns_api_url = http://acmedns-server/\ndns_acmedns_registration_file = /data/acme-registration.json" + }, + { + "id": "active24", + "name": "Active24", + "credentials": "dns_active24_api_key = \ndns_active24_secret = " + }, + { + "id": "aliyun", + "name": "Aliyun", + "credentials": "dns_aliyun_access_key = 12345678\ndns_aliyun_access_key_secret = 1234567890abcdef1234567890abcdef" + }, + { + "id": "azure", + "name": "Azure", + "credentials": "# This plugin supported API authentication using either Service Principals or utilizing a Managed Identity assigned to the virtual machine.\n# Regardless which authentication method used, the identity will need the “DNS Zone Contributor” role assigned to it.\n# As multiple Azure DNS Zones in multiple resource groups can exist, the config file needs a mapping of zone to resource group ID. Multiple zones -> ID mappings can be listed by using the key dns_azure_zoneX where X is a unique number. At least 1 zone mapping is required.\n\n# Using a service principal (option 1)\ndns_azure_sp_client_id = 912ce44a-0156-4669-ae22-c16a17d34ca5\ndns_azure_sp_client_secret = E-xqXU83Y-jzTI6xe9fs2YC~mck3ZzUih9\ndns_azure_tenant_id = ed1090f3-ab18-4b12-816c-599af8a88cf7\n\n# Using used assigned MSI (option 2)\n# dns_azure_msi_client_id = 912ce44a-0156-4669-ae22-c16a17d34ca5\n\n# Using system assigned MSI (option 3)\n# dns_azure_msi_system_assigned = true\n\n# Zones (at least one always required)\ndns_azure_zone1 = example.com:/subscriptions/c135abce-d87d-48df-936c-15596c6968a5/resourceGroups/dns1\ndns_azure_zone2 = example.org:/subscriptions/99800903-fb14-4992-9aff-12eaf2744622/resourceGroups/dns2" + }, + { + "id": "baidu", + "name": "baidu", + "credentials": "dns_baidu_access_key = 12345678\ndns_baidu_secret_key = 1234567890abcdef1234567890abcdef" + }, + { + "id": "beget", + "name": "Beget", + "credentials": "# Beget API credentials used by Certbot\nbeget_plugin_username = username\nbeget_plugin_password = password" + }, + { + "id": "bunny", + "name": "bunny.net", + "credentials": "# Bunny API token used by Certbot (see https://dash.bunny.net/account/settings)\ndns_bunny_api_key = xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx" + }, + { + "id": "cdmon", + "name": "cdmon", + "credentials": "dns_cdmon_api_key=your-cdmon-api-token\ndns_cdmon_domain=your_domain_is_optional" + }, + { + "id": "cloudflare", + "name": "Cloudflare", + "credentials": "# Cloudflare API token\ndns_cloudflare_api_token=0123456789abcdef0123456789abcdef01234567" + }, + { + "id": "cloudns", + "name": "ClouDNS", + "credentials": "# Target user ID (see https://www.cloudns.net/api-settings/)\n\tdns_cloudns_auth_id=1234\n\t# Alternatively, one of the following two options can be set:\n\t# dns_cloudns_sub_auth_id=1234\n\t# dns_cloudns_sub_auth_user=foobar\n\n\t# API password\n\tdns_cloudns_auth_password=password1" + }, + { + "id": "cloudxns", + "name": "CloudXNS", + "credentials": "dns_cloudxns_api_key = 1234567890abcdef1234567890abcdef\ndns_cloudxns_secret_key = 1122334455667788" + }, + { + "id": "constellix", + "name": "Constellix", + "credentials": "dns_constellix_apikey = 5fb4e76f-ac91-43e5-f982458bc595\ndns_constellix_secretkey = 47d99fd0-32e7-4e07-85b46d08e70b\ndns_constellix_endpoint = https://api.dns.constellix.com/v1" + }, + { + "id": "corenetworks", + "name": "Core Networks", + "credentials": "dns_corenetworks_username = asaHB12r\ndns_corenetworks_password = secure_password" + }, + { + "id": "cpanel", + "name": "cPanel", + "credentials": "cpanel_url = https://cpanel.example.com:2083\ncpanel_username = your_username\ncpanel_password = your_password\ncpanel_token = your_api_token" + }, + { + "id": "ddnss", + "name": "DDNSS", + "credentials": "dns_ddnss_token = YOUR_DDNSS_API_TOKEN" + }, + { + "id": "desec", + "name": "deSEC", + "credentials": "dns_desec_token = YOUR_DESEC_API_TOKEN\ndns_desec_endpoint = https://desec.io/api/v1/" + }, + { + "id": "duckdns", + "name": "DuckDNS", + "credentials": "dns_duckdns_token=your-duckdns-token" + }, + { + "id": "digitalocean", + "name": "DigitalOcean", + "credentials": "dns_digitalocean_token = 0000111122223333444455556666777788889999aaaabbbbccccddddeeeeffff" + }, + { + "id": "directadmin", + "name": "DirectAdmin", + "credentials": "directadmin_url = https://my.directadminserver.com:2222\ndirectadmin_username = username\ndirectadmin_password = aSuperStrongPassword" + }, + { + "id": "dnsimple", + "name": "DNSimple", + "credentials": "dns_dnsimple_token = MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAw" + }, + { + "id": "dnsmadeeasy", + "name": "DNS Made Easy", + "credentials": "dns_dnsmadeeasy_api_key = 1c1a3c91-4770-4ce7-96f4-54c0eb0e457a\ndns_dnsmadeeasy_secret_key = c9b5625f-9834-4ff8-baba-4ed5f32cae55" + }, + { + "id": "dnsmulti", + "name": "DnsMulti", + "credentials": "# See https://go-acme.github.io/lego/dns/#dns-providers for list of providers and their settings\n# Example provider configuration for DreamHost\n# dns_multi_provider = dreamhost\n# DREAMHOST_API_KEY = ABCDEFG1234" + }, + { + "id": "dnspod", + "name": "DNSPod", + "credentials": "dns_dnspod_email = \"email@example.com\"\ndns_dnspod_api_token = \"id,key\"" + }, + { + "id": "domainoffensive", + "name": "DomainOffensive (do.de)", + "credentials": "dns_domainoffensive_api_token = YOUR_DO_DE_AUTH_TOKEN" + }, + { + "id": "domeneshop", + "name": "Domeneshop", + "credentials": "dns_domeneshop_client_token=YOUR_DOMENESHOP_CLIENT_TOKEN\ndns_domeneshop_client_secret=YOUR_DOMENESHOP_CLIENT_SECRET" + }, + { + "id": "dynu", + "name": "Dynu", + "credentials": "dns_dynu_auth_token = YOUR_DYNU_AUTH_TOKEN" + }, + { + "id": "easydns", + "name": "easyDNS", + "credentials": "dns_easydns_usertoken = YOUR_EASYDNS_USERTOKEN\ndns_easydns_userkey = YOUR_EASYDNS_USERKEY\ndns_easydns_endpoint = https://rest.easydns.net" + }, + { + "id": "eurodns", + "name": "EuroDNS", + "credentials": "dns_eurodns_applicationId = myuser\ndns_eurodns_apiKey = mysecretpassword\ndns_eurodns_endpoint = https://rest-api.eurodns.com/user-api-gateway/proxy" + }, + { + "id": "firstdomains", + "name": "First Domains", + "credentials": "dns_firstdomains_username = myremoteuser\ndns_firstdomains_password = verysecureremoteuserpassword" + }, + { + "id": "freedns", + "name": "FreeDNS", + "credentials": "dns_freedns_username = myremoteuser\ndns_freedns_password = verysecureremoteuserpassword" + }, + { + "id": "gandi", + "name": "Gandi Live DNS", + "credentials": "# Gandi personal access token\ndns_gandi_token=PERSONAL_ACCESS_TOKEN" + }, + { + "id": "gcore", + "name": "Gcore DNS", + "credentials": "dns_gcore_apitoken = 0123456789abcdef0123456789abcdef01234567" + }, + { + "id": "godaddy", + "name": "GoDaddy", + "credentials": "dns_godaddy_secret = 0123456789abcdef0123456789abcdef01234567\ndns_godaddy_key = abcdef0123456789abcdef01234567abcdef0123" + }, + { + "id": "google", + "name": "Google", + "credentials": "{\n\"type\": \"service_account\",\n...\n}" + }, + { + "id": "googledomains", + "name": "GoogleDomainsDNS", + "credentials": "dns_google_domains_access_token = 0123456789abcdef0123456789abcdef01234567\ndns_google_domains_zone = \"example.com\"" + }, + { + "id": "he", + "name": "Hurricane Electric", + "credentials": "dns_he_user = Me\ndns_he_pass = my HE password" + }, + { + "id": "hetzner", + "name": "Hetzner", + "credentials": "dns_hetzner_api_token = 0123456789abcdef0123456789abcdef" + }, + { + "id": "hostingnl", + "name": "Hosting.nl", + "credentials": "dns_hostingnl_api_key = 0123456789abcdef0123456789abcdef" + }, + { + "id": "hover", + "name": "Hover", + "credentials": "dns_hover_hoverurl = https://www.hover.com\ndns_hover_username = hover-admin-username\ndns_hover_password = hover-admin-password\ndns_hover_totpsecret = 2fa-totp-secret" + }, + { + "id": "infomaniak", + "name": "Infomaniak", + "credentials": "dns_infomaniak_token = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" + }, + { + "id": "inwx", + "name": "INWX", + "credentials": "dns_inwx_url = https://api.domrobot.com/xmlrpc/\ndns_inwx_username = your_username\ndns_inwx_password = your_password\ndns_inwx_shared_secret = your_shared_secret optional" + }, + { + "id": "ionos", + "name": "IONOS", + "credentials": "dns_ionos_prefix = myapikeyprefix\ndns_ionos_secret = verysecureapikeysecret\ndns_ionos_endpoint = https://api.hosting.ionos.com" + }, + { + "id": "ispconfig", + "name": "ISPConfig", + "credentials": "dns_ispconfig_username = myremoteuser\ndns_ispconfig_password = verysecureremoteuserpassword\ndns_ispconfig_endpoint = https://localhost:8080" + }, + { + "id": "isset", + "name": "Isset", + "credentials": "dns_isset_endpoint=\"https://customer.isset.net/api\"\ndns_isset_token=\"\"" + }, + { + "id": "joker", + "name": "Joker", + "credentials": "dns_joker_username = \ndns_joker_password = \ndns_joker_domain = " + }, + { + "id": "leaseweb", + "name": "LeaseWeb", + "credentials": "dns_leaseweb_api_token = 01234556789" + }, + { + "id": "linode", + "name": "Linode", + "credentials": "dns_linode_key = 0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ64\ndns_linode_version = [|3|4]" + }, + { + "id": "loopia", + "name": "Loopia", + "credentials": "dns_loopia_user = user@loopiaapi\ndns_loopia_password = abcdef0123456789abcdef01234567abcdef0123" + }, + { + "id": "luadns", + "name": "LuaDNS", + "credentials": "dns_luadns_email = user@example.com\ndns_luadns_token = 0123456789abcdef0123456789abcdef" + }, + { + "id": "mijnhost", + "name": "mijn.host", + "credentials": "dns_mijn_host_api_key=0123456789abcdef0123456789abcdef" + }, + { + "id": "namecheap", + "name": "Namecheap", + "credentials": "dns_namecheap_username = 123456\ndns_namecheap_api_key = 0123456789abcdef0123456789abcdef01234567" + }, + { + "id": "netcup", + "name": "netcup", + "credentials": "dns_netcup_customer_id = 123456\ndns_netcup_api_key = 0123456789abcdef0123456789abcdef01234567\ndns_netcup_api_password = abcdef0123456789abcdef01234567abcdef0123" + }, + { + "id": "nicru", + "name": "nic.ru", + "credentials": "dns_nicru_client_id = application-id\ndns_nicru_client_secret = application-token\ndns_nicru_username = 0001110/NIC-D\ndns_nicru_password = password\ndns_nicru_scope = .+:.+/zones/example.com(/.+)?\ndns_nicru_service = DNS_SERVICE_NAME\ndns_nicru_zone = example.com" + }, + { + "id": "njalla", + "name": "Njalla", + "credentials": "dns_njalla_token = 0123456789abcdef0123456789abcdef01234567" + }, + { + "id": "nsone", + "name": "NS1", + "credentials": "dns_nsone_api_key = MDAwMDAwMDAwMDAwMDAw" + }, + { + "id": "oci", + "name": "Oracle Cloud Infrastructure DNS", + "credentials": "[DEFAULT]\nuser = ocid1.user.oc1...\nfingerprint = xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx\ntenancy = ocid1.tenancy.oc1...\nregion = us-ashburn-1\nkey_file = ~/.oci/oci_api_key.pem" + }, + { + "id": "ovh", + "name": "OVH", + "credentials": "dns_ovh_endpoint = ovh-eu\ndns_ovh_application_key = MDAwMDAwMDAwMDAw\ndns_ovh_application_secret = MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAw\ndns_ovh_consumer_key = MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAw" + }, + { + "id": "plesk", + "name": "Plesk", + "credentials": "dns_plesk_username = your-username\ndns_plesk_password = secret\ndns_plesk_api_url = https://plesk-api-host:8443" + }, + { + "id": "porkbun", + "name": "Porkbun", + "credentials": "dns_porkbun_key=your-porkbun-api-key\ndns_porkbun_secret=your-porkbun-api-secret" + }, + { + "id": "powerdns", + "name": "PowerDNS", + "credentials": "dns_powerdns_api_url = https://api.mypowerdns.example.org\ndns_powerdns_api_key = AbCbASsd!@34" + }, + { + "id": "regru", + "name": "reg.ru", + "credentials": "dns_username=username\ndns_password=password" + }, + { + "id": "rfc2136", + "name": "RFC 2136", + "credentials": "# Target DNS server\ndns_rfc2136_server = 192.0.2.1\n# Target DNS port\ndns_rfc2136_port = 53\n# TSIG key name\ndns_rfc2136_name = keyname.\n# TSIG key secret\ndns_rfc2136_secret = 4q4wM/2I180UXoMyN4INVhJNi8V9BCV+jMw2mXgZw/CSuxUT8C7NKKFs AmKd7ak51vWKgSl12ib86oQRPkpDjg==\n# TSIG key algorithm\ndns_rfc2136_algorithm = HMAC-SHA512" + }, + { + "id": "rockenstein", + "name": "rockenstein AG", + "credentials": "dns_rockenstein_token=" + }, + { + "id": "route53", + "name": "Route 53 (Amazon)", + "credentials": "[default]\naws_access_key_id=AKIAIOSFODNN7EXAMPLE\naws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" + }, + { + "id": "spaceship", + "name": "Spaceship", + "credentials": "[spaceship]\napi_key=your_api_key\napi_secret=your_api_secret" + }, + { + "id": "strato", + "name": "Strato", + "credentials": "dns_strato_username = user\ndns_strato_password = pass\n# uncomment if youre using two factor authentication:\n# dns_strato_totp_devicename = 2fa_device\n# dns_strato_totp_secret = 2fa_secret\n#\n# uncomment if domain name contains special characters\n# insert domain display name as seen on your account page here\n# dns_strato_domain_display_name = my-punicode-url.de\n#\n# if youre not using strato.de or another special endpoint you can customise it below\n# you will probably only need to adjust the host, but you can also change the complete endpoint url\n# dns_strato_custom_api_scheme = https\n# dns_strato_custom_api_host = www.strato.de\n# dns_strato_custom_api_port = 443\n# dns_strato_custom_api_path = \"/apps/CustomerService\"" + }, + { + "id": "selectelv2", + "name": "Selectel api v2", + "credentials": "dns_selectel_api_v2_account_id = your_account_id\ndns_selectel_api_v2_project_name = your_project\ndns_selectel_api_v2_username = your_username\ndns_selectel_api_v2_password = your_password" + }, + { + "id": "timeweb", + "name": "Timeweb Cloud", + "credentials": "dns_timeweb_api_key = XXXXXXXXXXXXXXXXXXX" + }, + { + "id": "transip", + "name": "TransIP", + "credentials": "dns_transip_username = my_username\ndns_transip_key_file = /etc/letsencrypt/transip-rsa.key" + }, + { + "id": "tencentcloud", + "name": "Tencent Cloud", + "credentials": "dns_tencentcloud_secret_id = TENCENT_CLOUD_SECRET_ID\ndns_tencentcloud_secret_key = TENCENT_CLOUD_SECRET_KEY" + }, + { + "id": "vultr", + "name": "Vultr", + "credentials": "dns_vultr_key = YOUR_VULTR_API_KEY" + }, + { + "id": "websupport", + "name": "Websupport.sk", + "credentials": "dns_websupport_identifier = \ndns_websupport_secret_key = " + }, + { + "id": "wedos", + "name": "Wedos", + "credentials": "dns_wedos_user = \ndns_wedos_auth = " + }, + { + "id": "edgedns", + "name": "Akamai Edge DNS", + "credentials": "edgedns_client_secret = as3d1asd5d1a32sdfsdfs2d1asd5=\nedgedns_host = sdflskjdf-dfsdfsdf-sdfsdfsdf.luna.akamaiapis.net\nedgedns_access_token = kjdsi3-34rfsdfsdf-234234fsdfsdf\nedgedns_client_token = dkfjdf-342fsdfsd-23fsdfsdfsdf" + }, + { + "id": "zoneedit", + "name": "ZoneEdit", + "credentials": "dns_zoneedit_user = \ndns_zoneedit_token = " + } + ] +} diff --git a/dns_challenge.py b/dns_challenge.py new file mode 100644 index 0000000..05fcd5c --- /dev/null +++ b/dns_challenge.py @@ -0,0 +1,175 @@ +"""Background DNS-01 issuance in the home NPM. Renewal belongs to NPM's scheduler.""" +from pathlib import Path +import re +import secrets +import threading +import time + +import homegate as h + +ISSUE_TIMEOUT = 900 +RESERVED = {"home", "lan", "local", "localhost", "internal", "invalid", "test", "example", "onion", "arpa"} + + +def providers(npm): + try: + rows = npm.call("GET", "/nginx/certificates/dns-providers") + legacy = False + except h.APIError as exc: + # In old NPM this path matches /:certificate_id and can return 400. + if exc.status not in (400, 404): + raise + rows = h.read_json(Path(__file__).with_name("dns-providers-legacy.json"))["providers"] + legacy = True + h.require(isinstance(rows, list) and 0 < len(rows) <= 256, "NPM вернул некорректный список DNS-провайдеров") + clean = [] + for row in rows: + h.require(isinstance(row, dict) and isinstance(row.get("id"), str) and + re.fullmatch(r"[a-z0-9_-]{1,100}", row["id"]), "Некорректный DNS-провайдер NPM") + clean.append({"id": row["id"], "name": str(row.get("name", row["id"]))[:200], + "template": str(row.get("credentials", ""))[:16384]}) + return {"providers": sorted(clean, key=lambda p: p["name"].lower()), "email_required": legacy} + + +def validate_request(value): + h.require(isinstance(value, dict) and not set(value) - + {"domains", "provider", "credentials", "email", "propagation_seconds", "agree"}, + "Некорректные параметры DNS challenge") + domains = value.get("domains") + h.require(isinstance(domains, list) and 1 <= len(domains) <= 100, "Укажите от 1 до 100 доменов") + names = [] + for name in domains: + h.require(isinstance(name, str), "Домены должны быть строками") + name = name.strip().lower().rstrip(".") + base = name.removeprefix("*.") + h.require(h.DOMAIN.fullmatch(base) and not base.split(".")[-1].isdigit() and + base.split(".")[-1] not in RESERVED, + "Для Let's Encrypt нужен публичный домен; .home, .local и другие локальные зоны не подходят") + h.require(name not in names, "Домен указан повторно") + names.append(name) + provider = value.get("provider") + h.require(isinstance(provider, str) and re.fullmatch(r"[a-z0-9_-]{1,100}", provider), "Выберите DNS-провайдера") + credentials = value.get("credentials") + h.require(isinstance(credentials, str) and 0 < len(credentials.strip()) <= 16384 and "\x00" not in credentials, + "Введите API-доступ DNS-провайдера в формате шаблона") + email = value.get("email", "") + h.require(isinstance(email, str), "Некорректный email") + email = email.strip() + h.require(not email or re.fullmatch(r"[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,63}", email), "Некорректный email") + propagation = value.get("propagation_seconds") + if propagation is not None: + h.number(propagation, 0, 600, "propagation_seconds") + h.require(value.get("agree") is True, "Подтвердите согласие с условиями Let's Encrypt") + return {"domains": names, "provider": provider, "credentials": credentials, "email": email, + "propagation_seconds": propagation, "agree": True} + + +class DNSChallenge: + def __init__(self, control, connect): + self.path = Path(control) / "dns-challenge.json" + self.connect = connect + self.lock = threading.RLock() + self.thread = None + self.job = h.read_json(self.path, {"status": "idle"}) + if self.job["status"] == "running": + self.update(status="unknown", message="Homegate был перезапущен. Проверьте результат в домашнем NPM перед повторным выпуском.") + + def update(self, **fields): + with self.lock: + self.job.update(fields) + h.save_json(self.path, self.job) + return self.status() + + def status(self): + with self.lock: + # Never publish the full request or an NPM response. + return {k: v for k, v in self.job.items() if k in + {"id", "status", "domains", "provider", "message", "certificate", "started_at"}} + + def start(self, value): + request = validate_request(value) + with self.lock: + h.require(self.job["status"] != "running", "Выпуск уже выполняется. Дождитесь результата.") + h.require(self.job["status"] != "unknown" or time.time() - self.job.get("issued_at", self.job.get("started_at", 0)) >= ISSUE_TIMEOUT, + "Результат предыдущего выпуска пока неизвестен. Нажмите «Проверить результат»; повторный выпуск доступен через 15 минут.") + self.job = {"id": secrets.token_hex(16), "status": "running", "domains": request["domains"], + "provider": request["provider"], "started_at": time.time(), "message": "Проверяем домашний NPM…"} + self.update() + self.thread = threading.Thread(target=self.run, args=(request,), daemon=True) + self.thread.start() + return self.status() + + def check(self): + with self.lock: + if self.job["status"] in ("idle", "success", "running"): + return self.status() + self.update(status="running", message="Проверяем, завершился ли выпуск в домашнем NPM…") + self.thread = threading.Thread(target=self.run, args=(None,), daemon=True) + self.thread.start() + return self.status() + + def matching(self, rows): + matches = [] + for row in rows: + if (row.get("provider") == "letsencrypt" and row.get("meta", {}).get("dns_challenge") is True + and row.get("meta", {}).get("dns_provider") == self.job["provider"] + and set(row.get("domain_names", [])) == set(self.job["domains"])): + info = h.certificate_info(row) + try: + h.check_certificate(info, self.job["domains"]) + except h.Error: + continue + matches.append(info) + # Reuse a valid certificate instead of submitting a duplicate ACME order. + return sorted(matches, key=lambda c: c["id"], reverse=True) + + def run(self, request): + npm, submitted = None, False + try: + npm = self.connect() + if request is None: + h.require(not self.job.get("npm_base") or npm.base == self.job["npm_base"], + "Подключение к домашнему NPM изменилось; проверьте сертификаты в прежнем NPM") + self.update(npm_base=npm.base) + rows = npm.call("GET", "/nginx/certificates") + matches = self.matching(rows) + if matches: + self.update(status="success", certificate=matches[0], message="Сертификат готов. Автопродление выполняет домашний NPM.") + return + if request is None: + self.update(status="unknown", message="Готовый сертификат пока не найден. Выпуск может продолжаться в NPM. Повторный запрос автоматически не отправляется.") + return + catalog = providers(npm) + h.require(any(p["id"] == request["provider"] for p in catalog["providers"]), + "Этот DNS-провайдер не поддерживается домашним NPM") + meta = {"dns_challenge": True, "dns_provider": request["provider"], + "dns_provider_credentials": request["credentials"]} + if catalog["email_required"]: + h.require(bool(request["email"]), "Для этой версии NPM укажите email Let's Encrypt") + meta.update(letsencrypt_email=request["email"], letsencrypt_agree=True) + if request["propagation_seconds"] is not None: + meta["propagation_seconds"] = request["propagation_seconds"] + self.update(issued_at=time.time(), message="Домашний NPM выпускает сертификат через DNS challenge. Это может занять несколько минут.") + submitted = True + result = npm.call("POST", "/nginx/certificates", json={"provider": "letsencrypt", + "domain_names": request["domains"], "meta": meta}, timeout=(5, ISSUE_TIMEOUT)) + info = h.certificate_info(result) + h.require(info["provider"] == "letsencrypt" and info["dns_challenge"], "NPM вернул неожиданный тип сертификата") + h.check_certificate(info, request["domains"]) + self.update(status="success", certificate=info, message="Сертификат выпущен. Автопродление выполняет домашний NPM.") + except h.APIError as exc: + uncertain = submitted and exc.status in (None, 408, 502, 503, 504) + self.update(status="unknown" if uncertain or request is None else "error", message=( + "NPM не подтвердил результат. Нажмите «Проверить результат»; Homegate не повторяет выпуск автоматически." + if uncertain else "Не удалось выполнить запрос к домашнему NPM. Проверьте подключение, DNS-доступ и журнал NPM. " + str(exc))) + except h.Error as exc: + self.update(status="unknown" if submitted or request is None else "error", message=str(exc)) + except Exception: + # Exception representations from parsers/third-party code may contain credentials. + self.update(status="unknown" if submitted or request is None else "error", + message="Не удалось обработать ответ NPM. Проверьте результат в его разделе сертификатов.") + finally: + if request is not None: + request.clear() + if npm: + npm.close() diff --git a/homegate.py b/homegate.py index 834098f..5ccd06e 100644 --- a/homegate.py +++ b/homegate.py @@ -47,6 +47,12 @@ class Error(RuntimeError): pass +class APIError(Error): + def __init__(self, message, status=None): + super().__init__(message) + self.status = status + + def require(ok, message): if not ok: raise Error(message) @@ -404,19 +410,20 @@ class API: def call(self, method, path, **kwargs): try: - response = self.session.request(method, self.base + path, timeout=(5, 30), + response = self.session.request(method, self.base + path, timeout=kwargs.pop("timeout", (5, 30)), allow_redirects=False, **kwargs) except requests.RequestException: - raise Error(f"{self.label}: connection or TLS error at {path}") from None - require(200 <= response.status_code < 300, - f"{self.label}: HTTP {response.status_code} at {path}; check credentials, version and permissions") + raise APIError(f"{self.label}: connection or TLS error at {path}") from None + if not 200 <= response.status_code < 300: + raise APIError(f"{self.label}: HTTP {response.status_code} at {path}; check credentials, version and permissions", + response.status_code) # Do not log response bodies: NPM upload responses contain the private key. if not response.content: return None try: return response.json() except ValueError: - raise Error(f"{self.label}: non-JSON response at {path}; check management URL") from None + raise APIError(f"{self.label}: non-JSON response at {path}; check management URL") from None def close(self): self.session.close() @@ -517,7 +524,8 @@ def certificate_info(cert): raise Error("NPM certificate has invalid PEM or missing DNS subject alternative names") from None return {"id": cert["id"], "name": cert.get("nice_name", ""), "provider": cert.get("provider"), "domains": domains, "expires": expires, "fingerprint": fingerprint, - "modified": cert.get("modified_on")} + "modified": cert.get("modified_on"), "dns_challenge": cert.get("meta", {}).get("dns_challenge") is True, + "dns_provider": cert.get("meta", {}).get("dns_provider")} def covers_domain(pattern, hostname): diff --git a/homegate_ui.py b/homegate_ui.py index fc14b9b..435710d 100644 --- a/homegate_ui.py +++ b/homegate_ui.py @@ -18,6 +18,7 @@ from urllib.parse import urlsplit import yaml import homegate as h +from dns_challenge import DNSChallenge, providers as dns_providers LOG = logging.getLogger("homegate.ui") BASE = Path(__file__).resolve().parent @@ -52,6 +53,7 @@ class Panel: raise UIError("UI password must contain at least 12 characters; run setup.sh") if self.config.exists() or not self.connections_file: h.load_config(self.config) + self.dns_challenge = DNSChallenge(self.control, self.connect_npm) def config_data(self): if self.connections_file and not self.config.exists(): @@ -178,7 +180,7 @@ class Panel: self.request_sync() return result - def certificates(self, remote=False): + def connect_npm(self, remote=False): h.require(self.connections_file is not None, "Сначала настройте подключения через UI") values = h.read_json(self.connections_file, {}) prefix = "remote_npm" if remote else "npm" @@ -191,12 +193,27 @@ class Panel: client = (h.RemoteNPM if remote else h.NPM)(values[prefix + "_url"], "Remote NPM" if remote else "NPM", verify) try: client.login(values[prefix + "_identity"], values[prefix + "_password"]) + return client + except Exception: + client.close() + raise + + def certificates(self, remote=False): + client = self.connect_npm(remote) + try: certs = client.call("GET", "/nginx/certificates") return {"certificates": [h.certificate_info(c) for c in certs if not remote or c.get("provider") == "letsencrypt"]} finally: client.close() + def dns_providers(self): + client = self.connect_npm() + try: + return dns_providers(client) + finally: + client.close() + def save(self, value, revision): h.validate_config(value) data = yaml.safe_dump(value, sort_keys=False, allow_unicode=True).encode() @@ -276,10 +293,10 @@ def handler_for(panel): path = urlsplit(self.path).path if self.command == "GET" and path == "/healthz": return self.respond(200, {"ok": True}) - if self.command == "GET" and path in ("/", "/app.js", "/settings.js", "/certificates.js", "/style.css", "/favicon.svg"): - name = {"/": "index.html", "/app.js": "app.js", "/settings.js": "settings.js", "/certificates.js": "certificates.js", "/style.css": "style.css", "/favicon.svg": "favicon.svg"}[path] + if self.command == "GET" and path in ("/", "/app.js", "/settings.js", "/certificates.js", "/dns-challenge.js", "/style.css", "/favicon.svg"): + name = {"/": "index.html", "/app.js": "app.js", "/settings.js": "settings.js", "/certificates.js": "certificates.js", "/dns-challenge.js": "dns-challenge.js", "/style.css": "style.css", "/favicon.svg": "favicon.svg"}[path] content_type = {"index.html": "text/html; charset=utf-8", "app.js": "text/javascript; charset=utf-8", - "settings.js": "text/javascript; charset=utf-8", "certificates.js": "text/javascript; charset=utf-8", "style.css": "text/css; charset=utf-8", "favicon.svg": "image/svg+xml"}[name] + "settings.js": "text/javascript; charset=utf-8", "certificates.js": "text/javascript; charset=utf-8", "dns-challenge.js": "text/javascript; charset=utf-8", "style.css": "text/css; charset=utf-8", "favicon.svg": "image/svg+xml"}[name] return self.respond(200, (BASE / "ui" / "dist" / name).read_bytes(), content_type) token, session = panel.session(self.headers.get("Cookie")) if self.command == "GET" and path == "/api/session": @@ -313,6 +330,10 @@ def handler_for(panel): return self.respond(200, panel.status()) if path in ("/api/npm-certificates", "/api/remote-certificates"): return self.respond(200, panel.certificates(remote=path == "/api/remote-certificates")) + if path == "/api/dns-providers": + return self.respond(200, panel.dns_providers()) + if path == "/api/dns-challenge": + return self.respond(200, panel.dns_challenge.status()) if path == "/api/ssh-config": text = h.render_ssh(h.ssh_entries(h.load_config(panel.config))) return self.respond(200, text.encode(), "text/plain; charset=utf-8") @@ -337,6 +358,10 @@ def handler_for(panel): return self.respond(200, panel.save_settings(body["config"], body["connections"], body["revision"])) if path == "/api/sync": return self.respond(202, panel.request_sync()) + if path == "/api/dns-challenge": + return self.respond(202, panel.dns_challenge.start(body)) + if path == "/api/dns-challenge/check": + return self.respond(202, panel.dns_challenge.check()) if path == "/api/logout": panel.sessions.pop(token, None) return self.respond(200, {"ok": True}, cookie="") diff --git a/tests/test_dns_challenge.py b/tests/test_dns_challenge.py new file mode 100644 index 0000000..aa9f04e --- /dev/null +++ b/tests/test_dns_challenge.py @@ -0,0 +1,204 @@ +"""DNS-01 issuance is local, asynchronous, secret-free in state, and retry-safe.""" +import copy +from datetime import timedelta +import json +import threading +import unittest +from unittest.mock import Mock, patch + +import homegate as h +import homegate_ui as ui +import dns_challenge as dc +import test_setup + + +class DNSChallengeTests(unittest.TestCase): + setUpPanel = test_setup.SetupTests.setUp + request = test_setup.SetupTests.request + connect = test_setup.SetupTests.connect + install = test_setup.SetupTests.install + + def setUp(self): + self.setUpPanel() + self.install() + self.rows = [] + self.posts = [] + self.legacy = False + self.fail_after_create = False + self.block = None + self.entered = threading.Event() + self.client = Mock(base='http://home-npm:81/api') + self.client.call.side_effect = self.call + self.panel.dns_challenge.connect = lambda: self.client + self.input = {'domains':['disk.example.com'], 'provider':'cloudflare', + 'credentials':'dns_cloudflare_api_token=DNS_PRIVATE_TOKEN', 'agree':True, + 'email':'admin@example.com', 'propagation_seconds':None} + + def call(self, method, path, **kwargs): + if method == 'GET' and path == '/nginx/certificates/dns-providers': + if self.legacy: + raise h.APIError('Not found', 404) + return [{'id':'cloudflare','name':'Cloudflare','credentials':'dns_cloudflare_api_token=EXAMPLE'}] + if method == 'GET' and path == '/nginx/certificates': + return copy.deepcopy(self.rows) + if method == 'POST' and path == '/nginx/certificates': + payload = copy.deepcopy(kwargs['json']) + self.posts.append(payload) + self.assertEqual(kwargs['timeout'], (5, dc.ISSUE_TIMEOUT)) + self.entered.set() + if self.block: + self.block.wait(3) + row = dict(payload, id=len(self.rows)+1, nice_name=', '.join(payload['domain_names']), + expires_on=(h.now()+timedelta(days=90)).isoformat()) + self.rows.append(row) + if self.fail_after_create: + raise h.APIError('NPM: connection or TLS error') + return copy.deepcopy(row) + raise AssertionError((method,path)) + + def finish(self): + self.panel.dns_challenge.thread.join(4) + self.assertFalse(self.panel.dns_challenge.thread.is_alive()) + return self.request('/api/dns-challenge')[1] + + def start(self): + code, body, _ = self.request('/api/dns-challenge', copy.deepcopy(self.input)) + self.assertEqual(code, 202, body) + return self.finish() + + def test_modern_npm_issues_dns_certificate_and_exports_only_public_metadata(self): + self.input['domains'] = ['example.com','*.example.com'] + result = self.start() + self.assertEqual(result['status'], 'success') + self.assertEqual(self.posts[0], {'provider':'letsencrypt','domain_names':self.input['domains'], + 'meta':{'dns_challenge':True,'dns_provider':'cloudflare', + 'dns_provider_credentials':self.input['credentials']}}) + self.assertTrue(result['certificate']['dns_challenge']) + for path in self.root.rglob('*'): + if path.is_file(): + self.assertNotIn('DNS_PRIVATE_TOKEN', path.read_text()) + for path in ['/api/dns-challenge','/api/state','/downloads/services.yaml']: + self.assertNotIn('DNS_PRIVATE_TOKEN', str(self.request(path)[1])) + with patch.object(h.RemoteNPM, 'call', side_effect=AssertionError('No VDS calls')): + self.assertEqual(self.start()['status'], 'success') + self.assertEqual(len(self.posts), 1) # valid certificate is reused + + def test_old_npm_receives_email_and_agreement_with_propagation_delay(self): + self.legacy = True + self.input['propagation_seconds'] = 120 + self.assertEqual(self.start()['status'], 'success') + meta = self.posts[0]['meta'] + self.assertEqual(meta['letsencrypt_email'], 'admin@example.com') + self.assertIs(meta['letsencrypt_agree'], True) + self.assertEqual(meta['propagation_seconds'], 120) + + def test_issuance_is_background_and_duplicate_posts_are_blocked(self): + self.block = threading.Event() + self.addCleanup(self.block.set) + code, _, _ = self.request('/api/dns-challenge', self.input) + self.assertEqual(code, 202) + self.assertTrue(self.entered.wait(2)) + self.assertEqual(self.request('/api/state')[0], 200) + self.assertEqual(self.request('/api/dns-challenge')[1]['status'], 'running') + self.assertEqual(self.request('/api/dns-challenge', self.input)[0], 400) + self.block.set() + self.assertEqual(self.finish()['status'], 'success') + self.assertEqual(len(self.posts), 1) + + def test_timeout_recovers_existing_certificate_without_another_acme_order(self): + self.fail_after_create = True + self.assertEqual(self.start()['status'], 'unknown') + self.assertEqual(self.request('/api/dns-challenge', self.input)[0], 400) + self.assertEqual(self.request('/api/dns-challenge/check', {})[0], 202) + self.assertEqual(self.finish()['status'], 'success') + self.assertEqual(len(self.posts), 1) + + def test_restart_does_not_repeat_pending_order(self): + dc.h.save_json(self.panel.dns_challenge.path, {'status':'running','domains':['disk.example.com'], + 'provider':'cloudflare','started_at':dc.time.time(),'issued_at':dc.time.time(),'npm_base':self.client.base}) + restarted = dc.DNSChallenge(self.control, lambda:self.client) + self.assertEqual(restarted.status()['status'], 'unknown') + with self.assertRaises(h.Error): + restarted.start(self.input) + self.assertEqual(self.posts, []) + + def test_clear_api_failure_is_reported_without_retry_or_response_secrets(self): + original = self.client.call.side_effect + self.client.call.side_effect = lambda method,path,**kw: ( + (_ for _ in ()).throw(h.APIError('NPM: HTTP 400',400)) if method == 'POST' else original(method,path,**kw)) + result = self.start() + self.assertEqual(result['status'], 'error') + self.assertIn('HTTP 400', result['message']) + self.assertEqual(sum(c.args[0]=='POST' for c in self.client.call.call_args_list), 1) + + def test_provider_and_email_are_validated_before_submitting(self): + self.input['provider'] = 'unknown_provider' + self.assertEqual(self.start()['status'], 'error') + self.input['provider'] = 'cloudflare' + self.legacy = True + self.input['email'] = '' + self.assertEqual(self.start()['status'], 'error') + self.assertEqual(self.posts, []) + + def test_invalid_requests_do_not_start_background_work(self): + for field, value in [('agree',False),('domains',['pve.home']),('domains',['a.local']), + ('domains',['192.168.0.1']),('domains',['*.example.com','*.example.com']), + ('domains',['a.example.com;rm']),('credentials',''),('email',None), + ('propagation_seconds',True),('propagation_seconds',601)]: + with self.subTest(field=field,value=value): + request = dict(self.input, **{field:value}) + self.assertEqual(self.request('/api/dns-challenge',request)[0],400) + self.assertIsNone(self.panel.dns_challenge.thread) + + def test_dns_endpoints_enforce_session_origin_csrf_and_lan(self): + for headers in [{'X-Homegate-CSRF':''},{'Origin':'https://attacker.example'}]: + self.assertEqual(self.request('/api/dns-challenge',self.input,headers=headers)[0],403) + self.assertEqual(self.request('/api/dns-challenge',self.input,peer='8.8.8.8')[0],403) + self.cookie = '' + for path in ['/api/dns-providers','/api/dns-challenge']: + self.assertEqual(self.request(path)[0],401) + self.assertEqual(self.posts,[]) + + def test_provider_catalog_uses_only_local_connection_and_safe_fields(self): + with patch.object(self.panel,'connect_npm',return_value=self.client) as connect: + code, body, _ = self.request('/api/dns-providers') + self.assertEqual(code,200) + self.assertFalse(body['email_required']) + self.assertEqual(body['providers'][0]['id'],'cloudflare') + connect.assert_called_once_with() + self.client.call.side_effect = h.APIError('Forbidden',403) + with self.assertRaises(h.APIError): + dc.providers(self.client) # authentication/permission errors must not become legacy fallback + + def test_old_api_bad_certificate_id_path_uses_legacy_catalog(self): + self.client.call.side_effect = h.APIError('Invalid certificate id',400) + catalog = dc.providers(self.client) + self.assertTrue(catalog['email_required']) + self.assertTrue(any(p['id']=='cloudflare' for p in catalog['providers'])) + + def test_result_can_be_selected_without_changing_certificate_or_vds(self): + result = self.start() + state = self.request('/api/state')[1] + config = state['config'] + config['domain_zones'].append('example.com') + config['services'] = [{'hostname':'disk.example.com','upstream':'http://192.168.0.20:8080', + 'certificate_mode':'npm','npm_certificate_id':result['certificate']['id']}] + self.assertEqual(self.request('/api/config',{'config':config,'revision':state['revision']})[0],200) + self.assertNotIn('DNS_PRIVATE_TOKEN',self.config.read_text()) + self.assertEqual(len(self.posts),1) + + def test_real_transport_timeout_can_be_extended_only_for_issuance(self): + client = h.NPM('http://home-npm:81','NPM') + self.addCleanup(client.close) + response = Mock(status_code=201, content=b'{}') + response.json.return_value = {} + with patch.object(client.session,'request',return_value=response) as request: + client.call('POST','/nginx/certificates',json={},timeout=(5,900)) + self.assertEqual(request.call_args.kwargs['timeout'],(5,900)) + client.call('GET','/nginx/certificates') + self.assertEqual(request.call_args.kwargs['timeout'],(5,30)) + source = h.RemoteNPM('https://vds.example.com','Remote NPM') + self.addCleanup(source.close) + for method,path in [('GET','/nginx/certificates/dns-providers'),('POST','/nginx/certificates')]: + with self.assertRaisesRegex(h.Error,'read-only'): + source.call(method,path) diff --git a/ui/dist/app.js b/ui/dist/app.js index ee7b3b0..2791641 100644 --- a/ui/dist/app.js +++ b/ui/dist/app.js @@ -67,9 +67,9 @@ function renderServices(){const c=controller();const first=services().find(r=>r.

Каталог сервисов ${services().length}

Прокси ${esc(data.config.proxy_ip)}
${[['all','Все сервисы'],['enabled','Включены'],['disabled','Выключены']].map(([v,l])=>``).join('')}
${serviceRows()}
СервисЛокальный адресКуда направлятьСостояние
Изменения сохраняются в services.yamlОбновление каждые ${data.config.interval_seconds||60} сек.
Как проходит соединение Локальная сеть

${first?`Маршрут для ${esc(first.hostname)}`:'Добавьте сервис, чтобы настроить первый маршрут'}

${icon('monitor',19)}Браузерваше устройство
${icon('globe',19)}Pi-holeимя → IP
${icon('route',19)}NPMHTTPS · 443
${icon('server',19)}${first?esc(serviceName(first)):'Ваша VM'}${first?esc(new URL(first.upstream).hostname):'IP:порт'}
${icon('shield',12)} Источник HTTPS-сертификата выбирается в настройках сервиса
Серверы на расстоянии команды ${icon('terminal',20)}

Подключите общий SSH-конфиг на компьютере.
IP и порты больше не нужно держать в памяти.

$ssh ${esc(ssh[0]?.aliases[0]||'имя-сервера')}
`;} -function renderDomains(){const root=controller().root;return heading('Доменные зоны','Свои имена для разных частей вашей домашней сети.',``)+`
${zones().map((z,i)=>{const count=services().filter(r=>r.hostname===z||r.hostname.endsWith('.'+z)).length;const covered=root&&root.zones.some(p=>z===p||z.endsWith('.'+p));return `
${icon('globe',21)}
.${esc(z)}

${count} ${count===1?'сервис':'сервисов'} в этой зоне

${root?(covered?badge('Разрешена CA','success'):badge('Нужна смена CA')):badge('CA ещё не создан','muted')}DNS / TLS
`;}).join('')}
${icon('info',19)}

Домены работают внутри вашей сети.
Pi-hole направляет имена на NPM. Для домашних сетей подходит home.arpa; можно использовать и собственные зоны.

${root?`
${icon('shield',19)}

Новая зона может потребовать нового корневого сертификата.
Если зона вне ограничений текущего CA, выполните миграцию и установите новый корень на устройства.

`:''}`;} +function renderDomains(){const root=controller().root;return heading('Доменные зоны','Свои имена для разных частей вашей домашней сети.',``)+`
${zones().map((z,i)=>{const count=services().filter(r=>r.hostname===z||r.hostname.endsWith('.'+z)).length;const covered=root&&root.zones.some(p=>z===p||z.endsWith('.'+p));return `
${icon('globe',21)}
.${esc(z)}

${count} ${count===1?'сервис':'сервисов'} в этой зоне

${root?(covered?badge('Разрешена CA','success'):badge('Вне локального CA')):badge('CA ещё не создан','muted')}DNS / TLS
`;}).join('')}
${icon('info',19)}

Домены работают внутри вашей сети.
Pi-hole направляет имена на NPM. Для домашних сетей подходит home.arpa; можно использовать и собственные зоны.

${root?`
${icon('shield',19)}

Новая зона может потребовать нового корневого сертификата.
Смена CA нужна только в режиме Homegate для зоны вне ограничений текущего корня. Для публичного сертификата NPM, DNS challenge или копии с VDS менять CA не требуется.

`:''}`;} function renderSSH(){const entries=sshEntries();return heading('SSH-доступ','Один дополнительный конфиг для всех ваших компьютеров.',`${icon('download',14)} Скрипт для ПК${icon('download',14)} Скачать конфиг`)+`
~/.ssh/config.d/homegate.conf
Загружаем конфиг…
Подключите за пару минут
1
Скачайте скрипт на компьютер

Python 3.9+ и OpenSSH. Приватные ключи остаются у вас.

${icon('download',12)} sync_ssh.py
2
Подключите дополнительный файл

Основной SSH-конфиг сохраняется. Для Windows используйте py -3.

python3 sync_ssh.py ${esc(sshUrl())} --install
3
Подключайтесь по имени

При следующих обновлениях запустите скрипт без --install.

ssh ${esc(entries[0]?.aliases[0]||'имя-сервера')}
${icon('lock',18)}

Открытая выгрузка только для вашей LAN.
${esc(sshUrl())}
${data.mode==='local'?'Этот адрес заработает после запуска ssh-export в Docker. Сейчас конфиг можно скачать кнопкой выше.':'Доступ ограничен разрешёнными подсетями. Пароль панели для этой выгрузки не нужен.'}

Серверы без веб-интерфейса ${(data.config.ssh_hosts||[]).length}

${(data.config.ssh_hosts||[]).map((r,i)=>``).join('')||``}
ПсевдонимыАдресПользователь
${esc(r.aliases.join(', '))} ${r.enabled===false?badge('Выключен','muted'):''}${esc(r.host)}:${r.port||22}${esc(r.user||'Из личного конфига')}
${icon('server',25)}

Здесь можно добавить NAS, backup-сервер или любую машину с SSH.
SSH веб-сервисов настраивается в карточке сервиса.

`;} -function renderCertificates(){const root=controller().root;const certs=controller().certificates||[];return heading('Сертификаты','Локальный CA, сертификаты NPM и обновляемые копии с VDS.',`${root?`${icon('download',14)} Скачать корневой CA`:''}`)+`
${icon('shield',29)}

Homegate Local Root CA

Ваш центр сертификации внутри домашней сети.

Состояние${root?badge('Создан','success'):badge('Ожидает запуска','muted')}
Действует до${date(root?.expires)}
Зоны в сертификате${esc(root?.zones.join(', ')||'Определятся при первом запуске')}
Срок сертификата сервиса90 дней
ПродлениеКогда осталось менее 30 дней
${root?`Отпечаток SHA-256
${esc(root.fingerprint)}
`:`
${icon('info',17)}

Корень создаётся контроллером. Сейчас панель не видит его данные.

`}
Установите доверие на устройства

Для режима Homegate установите корневой CA. Публичный сертификат из NPM или его копия с VDS не требуют установки CA на устройства.

1
Скачайте только root-ca.crt

Сверьте отпечаток с сервером. Приватный ключ CA никогда не публикуется в панели.

2
Импортируйте как доверенный корневой CA

Windows — доверенные корневые центры.
macOS — Связка ключей → System → Always Trust.
iOS — включите Full Trust после установки.

3
Откройте сервис по доменному имени

Например, https://${esc(services()[0]?.hostname||'service.home')}. Проверка сертификата по IP — другой запрос.

${icon('shield',17)}

Проверка TLS между NPM и самой VM настраивается отдельно для каждого сервиса.

Сертификаты сервисов

Данные контроллера
${certs.map(c=>``).join('')||''}
ДоменДействует доПродление
${date(c.expires)}${certificateRenewal(c)}

После первого применения здесь появятся сертификаты.

`;} +function renderCertificates(){const root=controller().root;const certs=controller().certificates||[];return heading('Сертификаты','Локальный CA, сертификаты NPM и обновляемые копии с VDS.',`${root?`${icon('download',14)} Скачать корневой CA`:''}`)+`
${icon('shield',29)}

Homegate Local Root CA

Ваш центр сертификации внутри домашней сети.

Состояние${root?badge('Создан','success'):badge('Ожидает запуска','muted')}
Действует до${date(root?.expires)}
Зоны в сертификате${esc(root?.zones.join(', ')||'Определятся при первом запуске')}
Срок сертификата сервиса90 дней
ПродлениеКогда осталось менее 30 дней
${root?`Отпечаток SHA-256
${esc(root.fingerprint)}
`:`
${icon('info',17)}

Корень создаётся контроллером. Сейчас панель не видит его данные.

`}
Установите доверие на устройства

Для режима Homegate установите корневой CA. Публичный сертификат из NPM или его копия с VDS не требуют установки CA на устройства.

1
Скачайте только root-ca.crt

Сверьте отпечаток с сервером. Приватный ключ CA никогда не публикуется в панели.

2
Импортируйте как доверенный корневой CA

Windows — доверенные корневые центры.
macOS — Связка ключей → System → Always Trust.
iOS — включите Full Trust после установки.

3
Откройте сервис по доменному имени

Например, https://${esc(services()[0]?.hostname||'service.home')}. Проверка сертификата по IP — другой запрос.

${icon('shield',17)}

Проверка TLS между NPM и самой VM настраивается отдельно для каждого сервиса.

Сертификаты сервисов

Данные контроллера
${certs.map(c=>``).join('')||''}
ДоменДействует доПродление
${date(c.expires)}${certificateRenewal(c)}

После первого применения здесь появятся сертификаты.

`;} function renderSettings(){if(data.connections)return renderManagedSettings();const c=data.config;return heading('Настройки сети','Адрес прокси, разрешённые подсети и частота обновления.')+`

Ваша локальная сеть

Доменные имена сервисов будут указывать на адрес NPM.

Локальный DNS

Выберите, кто создаёт записи для сервисов.

Подключения

Пароли остаются в Docker secrets на сервере.

${icon('globe',19)}
Pi-hole${c.dns_mode==='manual'?'Ручное управление DNS':'DNS-записи через API'}
${badge(controller().fresh&&controller().ok?'Синхронизирован':'Нет данных',controller().fresh&&controller().ok?'success':'muted')}
${icon('route',19)}
Nginx Proxy ManagerПрокси и HTTPS
${badge(controller().fresh&&controller().ok?'Синхронизирован':'Нет данных',controller().fresh&&controller().ok?'success':'muted')}

Адреса API и учётные данные задаются в .env и secrets/ при установке.

Последние изменения
${data.history.length?data.history.map(item=>`
${icon('check',13)}

${esc(item.text)}

`).join(''):'

Здесь появятся сохранения из панели.

'}
${icon('download',14)} Скачать текущий YAML
`;} function render(){if(!data)return;tab=pages.some(p=>p[0]===location.hash.slice(1))?location.hash.slice(1):'services';if(data.setup_required)tab='settings';nav();$('#content').innerHTML=({services:renderServices,domains:renderDomains,ssh:renderSSH,certificates:renderCertificates,settings:renderSettings})[tab]();$('#yaml-download').innerHTML=icon('download',16);$('#logout').hidden=data.auth_required===false;$('#yaml-download').hidden=data.setup_required;$('#service-search')?.addEventListener('input',e=>{search=e.target.value;$('#service-rows').innerHTML=serviceRows();});if(tab==='ssh')api('/api/ssh-config').then(text=>{if($('#ssh-preview'))$('#ssh-preview').textContent=text;}).catch(e=>toast(e.message,true));if(tab==='settings'){const form=$('#settings-form');form.addEventListener('input',()=>settingsDirty=true);form.addEventListener('submit',data.connections?saveManagedSettings:saveSettings);if(data.connections)bindManagedSettings(form);}} @@ -90,7 +90,7 @@ function guide(ca=false){if(!ca&&data.connections){location.hash='settings';retu async function saveSettings(e){e.preventDefault();const f=new FormData(e.target);const c=clone(data.config);c.proxy_ip=f.get('proxy_ip').trim();c.allowed_networks=f.get('allowed_networks').split(/\n|,/).map(x=>x.trim()).filter(Boolean);c.dns_mode=f.get('dns_mode');c.interval_seconds=Number(f.get('interval_seconds'));try{await saveConfig(c);}catch(err){$('#settings-error').hidden=false;$('#settings-error').textContent=friendlyError(err);}} document.addEventListener('click',async e=>{const button=e.target.closest('[data-action]');if(!button)return;const i=Number(button.dataset.index);const a=button.dataset.action;try{ - if(a==='add-service')serviceModal();else if(a==='edit-service')serviceModal(i);else if(a==='add-zone')zoneModal();else if(a==='add-ssh')sshModal();else if(a==='edit-ssh')sshModal(i);else if(a==='close-modal')$('#modal').close();else if(a==='guide')guide();else if(a==='ca-guide')guide(true);else if(a==='go-ssh')location.hash='ssh'; + if(a==='add-service')serviceModal();else if(a==='edit-service')serviceModal(i);else if(a==='add-zone')zoneModal();else if(a==='add-ssh')sshModal();else if(a==='edit-ssh')sshModal(i);else if(a==='close-modal')$('#modal').close();else if(a==='guide')guide();else if(a==='ca-guide')guide(true);else if(a==='issue-certificate')dnsChallengeModal();else if(a==='go-ssh')location.hash='ssh'; else if(a==='filter'){filter=button.dataset.filter;render();} else if(a==='sync'){button.disabled=true;const r=await api('/api/sync',{});toast(r.fresh?'Применение запрошено. Дождитесь обновления состояния.':'Запрос сохранён. Контроллер пока не отвечает.');button.disabled=false;} else if(a==='toggle-service'){const c=clone(data.config);c.services[i].enabled=c.services[i].enabled===false;await saveConfig(c);} diff --git a/ui/dist/certificates.js b/ui/dist/certificates.js index 9cf50f6..c637359 100644 --- a/ui/dist/certificates.js +++ b/ui/dist/certificates.js @@ -4,6 +4,7 @@ function certificateFields(route) {
@@ -12,7 +13,7 @@ function certificateFields(route) {

- `; + ${dnsChallengeFields(route.hostname || '')}`; } function bindCertificateFields(form, route) { @@ -20,6 +21,18 @@ function bindCertificateFields(form, route) { const mode = form.elements.certificate_mode, target = form.elements.npm_certificate_id; const source = form.elements.remote_certificate_id, status = form.querySelector('#certificate-list-status'); let selectedTarget = String(route.npm_certificate_id || ''), selectedSource = String(route.remote_certificate_id || ''); + const dns = bindDNSChallenge(form, cert => { + if(mode.value !== 'dns_challenge') return; + const hostname = form.elements.hostname.value.trim().toLowerCase(); + if(hostname && !cert.domains.some(d => d === hostname || (d.startsWith('*.') && hostname.endsWith(d.slice(1)) && hostname.split('.').length === d.split('.').length))) { + form.querySelector('#dns-challenge-status').textContent = `Сертификат #${cert.id} готов, но не покрывает ${hostname}. Укажите соответствующий домен сервиса или выпустите сертификат для него.`; + return; + } + local = [...local.filter(c => c.id !== cert.id), cert]; + selectedTarget = String(cert.id); mode.value = 'npm'; + update(); + status.textContent = 'Сертификат готов. Сохраните сервис — Homegate создаст DNS и прокси. Автопродление уже включено в NPM.'; + }); const option = (value, label) => ``; const label = c => `#${c.id} · ${c.name || c.domains.join(', ')} · ${c.domains.join(', ')} · до ${date(c.expires)}${c.provider === 'letsencrypt' ? ' · Let’s Encrypt' : ''}`; function populate(select, certs, selected, placeholder) { @@ -28,7 +41,10 @@ function bindCertificateFields(form, route) { select.value = selected; } function update() { - const copying = mode.value === 'remote_npm', enabled = mode.value !== 'homegate'; + const copying = mode.value === 'remote_npm', issuing = mode.value === 'dns_challenge'; + const enabled = ['npm','remote_npm'].includes(mode.value); + if(issuing) dns.load(); else dns.hide(); + document.querySelector('button[type="submit"][form="modal-form"]').disabled = issuing; form.querySelector('#npm-certificate-fields').hidden = !enabled; form.querySelector('#remote-certificate-field').hidden = !copying; target.disabled = !enabled; target.required = mode.value === 'npm'; @@ -39,11 +55,12 @@ function bindCertificateFields(form, route) { form.querySelector('#certificate-help').textContent = { homegate: 'Homegate выпускает и продлевает сертификат. На устройствах нужен доверенный корневой CA.', npm: 'Homegate привяжет этот сертификат к прокси и создаст локальный DNS. Сертификат не заменяется. Let’s Encrypt автоматически продлевает домашний NPM; Custom нужно обновлять у его издателя.', + dns_challenge: 'Сначала выпустите сертификат кнопкой ниже, затем сохраните сервис. Подключение к VDS для этого режима не требуется.', remote_npm: 'NPM на VDS продлевает сертификат самостоятельно. Homegate проверяет его каждый цикл и копирует обновление домой. На VDS выполняется только чтение. Если интернет недоступен, используется последняя копия до окончания её срока. При выборе существующего Custom обновляется именно он.' }[mode.value]; } async function load() { - if(mode.value === 'homegate') return; + if(!['npm','remote_npm'].includes(mode.value)) return; const request = ++generation, copying = mode.value === 'remote_npm'; status.textContent = 'Загрузка сертификатов…'; const results = await Promise.allSettled([api('/api/npm-certificates'), ...(copying ? [api('/api/remote-certificates')] : [])]); @@ -73,6 +90,6 @@ function readCertificateFields(fields, item) { function certificateRenewal(cert) { if(cert.mode === 'remote_npm') return cert.sync_error ? `Ошибка копирования: ${esc(cert.sync_error)}` : `Копия с VDS${cert.synced_at ? ' · проверена ' + esc(new Date(cert.synced_at * 1000).toLocaleString('ru-RU')) : ''}`; - if(cert.mode === 'npm') return cert.provider === 'letsencrypt' ? 'Автоматически в домашнем NPM' : 'Custom — у издателя сертификата'; + if(cert.mode === 'npm') return cert.provider === 'letsencrypt' ? `Автоматически в домашнем NPM${cert.dns_challenge ? ' · DNS challenge' : ''}` : 'Custom — у издателя сертификата'; return 'Автоматически в Homegate'; } diff --git a/ui/dist/dns-challenge.js b/ui/dist/dns-challenge.js new file mode 100644 index 0000000..ddaac44 --- /dev/null +++ b/ui/dist/dns-challenge.js @@ -0,0 +1,103 @@ +function dnsChallengeFields(domains = '') { + return ``; +} + +function bindDNSChallenge(form, onCertificate) { + const fields = form.querySelector('#dns-challenge-fields'); + const button = form.querySelector('#start-dns-challenge'), check = form.querySelector('#check-dns-challenge'); + const status = form.querySelector('#dns-challenge-status'), provider = form.elements.dns_provider; + let catalog = null, loading = false, timer = null, watching = false, waiting = false, delivered = null; + const domainNames = () => form.elements.dns_domains.value.split(/[\n,]/).map(s => s.trim().toLowerCase()).filter(Boolean); + function show(job) { + if(!form.isConnected) return; + waiting = job.status === 'running'; + button.disabled = waiting || !catalog; + check.hidden = !['unknown','error'].includes(job.status); + status.textContent = job.status === 'idle' ? '' : `${job.domains?.join(', ') || ''}: ${job.message || ''}`; + if(job.status === 'success' && watching && job.id !== delivered) { + delivered = job.id; + onCertificate(job.certificate); + } + if(waiting) { clearTimeout(timer); timer = setTimeout(poll, 1500); } + } + async function poll() { + if(!form.isConnected) return; + try { show(await api('/api/dns-challenge')); } + catch(error) { status.textContent = error.message; check.hidden = false; } + } + function template() { + form.querySelector('#dns-credential-template').textContent = catalog?.providers.find(p => p.id === provider.value)?.template || 'Выберите провайдера.'; + } + async function load() { + fields.disabled = false; + fields.hidden = false; + if(!form.elements.dns_domains.value && form.elements.hostname) form.elements.dns_domains.value = form.elements.hostname.value.trim(); + if(catalog || loading) return; + loading = true; button.disabled = true; + try { + catalog = await api('/api/dns-providers'); + if(!form.isConnected) return; + provider.innerHTML = '' + catalog.providers.map(p => ``).join(''); + form.querySelector('#dns-email-field').hidden = !catalog.email_required; + form.elements.dns_email.disabled = !catalog.email_required; + form.elements.dns_email.required = catalog.email_required; + form.querySelector('#dns-account-note').hidden = catalog.email_required; + button.disabled = waiting; + const job = await api('/api/dns-challenge'); + const names = domainNames(); + watching = job.status === 'running' && (names.length === 0 || names.every(d => job.domains?.includes(d))); + show(job); + } catch(error) { status.textContent = error.message; check.hidden = false; } + finally { loading = false; } + } + provider.addEventListener('change', () => { form.elements.dns_credentials.value = ''; template(); }); + button.addEventListener('click', async () => { + if(![...fields.querySelectorAll('input,textarea,select')].every(input => input.reportValidity())) return; + const propagation = form.elements.dns_propagation.value; + const request = {domains:domainNames(), provider:provider.value, credentials:form.elements.dns_credentials.value, + email:form.elements.dns_email.value, propagation_seconds:propagation === '' ? null : Number(propagation), agree:form.elements.dns_agree.checked}; + button.disabled = true; + try { + watching = true; delivered = null; + const job = await api('/api/dns-challenge', request); + form.elements.dns_credentials.value = ''; form.elements.dns_agree.checked = false; + show(job); + } catch(error) { status.textContent = error.message; button.disabled = false; check.hidden = false; } + }); + check.addEventListener('click', async () => { + check.disabled = true; + try { + if(!catalog) { await load(); return; } + watching = true; + show(await api('/api/dns-challenge/check', {})); + } catch(error) { status.textContent = error.message; } + finally { check.disabled = false; } + }); + return {load, hide:() => {fields.hidden = true; fields.disabled = true;}}; +} + +function dnsChallengeModal() { + showModal('Let’s Encrypt через DNS challenge', 'Выпуск и автопродление в домашнем NPM.', + ``, + ''); + const form = $('#modal-form'); + form.addEventListener('submit', e => e.preventDefault()); + const dns = bindDNSChallenge(form, cert => { + form.querySelector('#dns-challenge-status').textContent = `Готово: сертификат #${cert.id} для ${cert.domains.join(', ')}. Теперь выберите его в настройках сервиса. Продление выполняется автоматически в домашнем NPM.`; + }); + dns.load(); +} diff --git a/ui/dist/index.html b/ui/dist/index.html index e29a61d..d7acf12 100644 --- a/ui/dist/index.html +++ b/ui/dist/index.html @@ -9,6 +9,7 @@ + @@ -20,7 +21,7 @@ - +
diff --git a/ui/dist/style.css b/ui/dist/style.css index e515be7..92c827f 100644 --- a/ui/dist/style.css +++ b/ui/dist/style.css @@ -1 +1,3 @@ :root{font-family:Inter,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;color:#24333d;background:#f5f7f8;font-synthesis:none;--ink:#22323a;--muted:#7a8791;--line:#e4e9ec;--green:#257a56;--mint:#91deb3;--sidebar:#14272e;--radius:13px}*{box-sizing:border-box}body{margin:0;font-size:14px}button,input,select,textarea{font:inherit}button,a,input,select,textarea{-webkit-tap-highlight-color:transparent}button{cursor:pointer}button:disabled{cursor:not-allowed;opacity:.55}a{color:inherit;text-decoration:none}button{border:0}button:focus-visible,a:focus-visible{outline:3px solid #75c99f;outline-offset:3px}input:focus,select:focus,textarea:focus{outline:2px solid #a5d4be;outline-offset:1px}svg{vertical-align:middle;flex-shrink:0}button svg{pointer-events:none}[hidden]{display:none!important}.sidebar{position:fixed;inset:0 auto 0 0;width:244px;background:var(--sidebar);color:#ced9dc;display:flex;flex-direction:column;padding:34px 20px 22px;z-index:20}.brand{display:flex;gap:10px;align-items:center;color:#fff;font-size:26px;font-weight:730;letter-spacing:-1.2px;padding:0 12px}.brand-dot{color:var(--mint)}.workspace{margin:36px 2px 30px;padding:13px 11px;display:flex;align-items:center;gap:11px;border:1px solid #ffffff15;border-radius:10px;background:#ffffff04}.workspace-icon{width:32px;height:32px;border-radius:8px;display:grid;place-items:center;background:#31504f;color:#b8ead4;font-weight:650}.workspace strong{display:block;color:#eef3f4;font-size:12px;font-weight:600}.workspace div>span{font-size:10px;display:block;color:#8ea2a9;margin-top:4px}.workspace-dots{margin-left:auto;letter-spacing:2px}.nav-label{font-size:9px;letter-spacing:1.65px;color:#7e939a;padding:0 14px;margin-bottom:13px;font-weight:600}.nav-item{display:flex;align-items:center;gap:12px;margin-bottom:5px;border-radius:8px;padding:13px 14px;font-size:12px;font-weight:500;color:#aebdc3;transition:background .15s,color .15s}.nav-item:hover{background:#ffffff08;color:#fff}.nav-item.active{background:#29423f;color:#b2ebc9}.nav-item svg{opacity:.85}.nav-count{margin-left:auto;background:#ffffff13;min-width:20px;padding:2px 6px;font-size:10px;border-radius:5px;text-align:center}.sidebar-guide{margin:auto 4px 26px;padding:22px 14px 18px;border-top:1px solid #ffffff0e}.guide-orbit{display:grid;place-items:center;width:31px;height:31px;border:1px solid #75988a66;color:#93c8ae;font-size:18px;border-radius:50%;margin-bottom:13px}.sidebar-guide strong{font-size:12px;font-weight:600;color:#dce8e7}.sidebar-guide p{color:#8aa0a8;font-size:11px;line-height:1.8;margin:7px 0 13px}.text-link{background:none;color:#a3d9b9;padding:0;font-size:11px;display:flex;gap:20px;align-items:center}.sidebar-bottom{border-top:1px solid #ffffff10;padding:20px 11px 0;display:flex;align-items:center;gap:10px}.online-dot{height:6px;width:6px;display:inline-block;border-radius:50%;background:#81cda1;flex-shrink:0}.sidebar-bottom strong{display:block;font-size:10px;color:#c6d7d9;font-weight:500}.sidebar-bottom div>span{display:block;font-size:10px;margin-top:5px;color:#729098}.version{margin-left:4px;color:#a4bdc2}.sidebar-bottom button{margin-left:auto;color:#a5b7ba}.workspace-main{margin-left:244px;min-height:100vh;display:flex;flex-direction:column}.topbar{height:78px;background:#fff;border-bottom:1px solid var(--line);display:flex;align-items:center;justify-content:space-between;padding:0 42px;flex-shrink:0}.breadcrumb{display:flex;align-items:center;gap:14px;font-size:11px;color:#929da4}.breadcrumb strong{font-weight:500;color:#465760}.crumb-slash{color:#c7d0d5}.topbar-right{display:flex;align-items:center;gap:23px}.local-chip{font-size:10px;color:#6f7f86;display:flex;gap:7px;align-items:center}.avatar{border-radius:50%;background:#edf0e8;color:#6d775f;width:30px;height:30px;display:grid;place-items:center;font-size:11px;font-weight:600}.icon-button{padding:6px;display:inline-grid;place-items:center;border-radius:6px;background:transparent;color:#809098;min-width:30px;min-height:30px}.icon-button:hover{background:#eff3f4;color:#294a3d}.icon-button.danger:hover{background:#fff1ef;color:#b75d4e}main{padding:38px 42px 34px;max-width:1570px;width:100%;margin:0 auto;flex:1}.heading{display:flex;justify-content:space-between;align-items:center;gap:16px;margin-bottom:26px}.eyebrow{font-size:9px;letter-spacing:1.7px;font-weight:650;color:#94a29f;text-transform:uppercase;margin-bottom:10px}h1{font-size:28px;letter-spacing:-1px;line-height:1.25;font-weight:680;margin:0;color:#24363e}.subtitle{margin:10px 0 0;font-size:12px;line-height:1.65;color:#7d8a92}.button-row{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.btn{display:inline-flex;align-items:center;justify-content:center;gap:8px;border:1px solid var(--line);background:#fff;color:#46565e;border-radius:8px;padding:10px 14px;font-size:11px;font-weight:550;min-height:36px;white-space:nowrap;transition:background .15s,transform .15s}.btn:hover{background:#f8faf9;border-color:#cbd8d1}.btn:active{transform:translateY(1px)}.btn.primary{background:#2b7655;border-color:#2b7655;color:white;box-shadow:0 2px 3px #163e2310}.btn.primary:hover{background:#246747}.btn.dark{background:#213d36;color:#e5f2e9;border-color:#213d36}.btn.subtle{background:#f7f9f8}.btn.danger{background:#fff3f1;color:#b5594e;border-color:#f1d5d0}.btn.small{padding:6px 10px;font-size:10px;min-height:30px}.btn.link{padding:0;border:0;background:none;color:var(--green)}.status-strip{display:flex;align-items:center;gap:10px;padding:12px 15px;border:1px solid #e6e8db;background:#fbfcf6;border-radius:9px;margin-bottom:22px;color:#7c805d;font-size:11px;line-height:1.6}.status-strip strong{font-weight:600}.status-strip button{margin-left:auto}.status-strip.good{background:#f0f8f3;border-color:#d6e7dc;color:#3f7859}.status-strip.bad{background:#fff6f3;color:#a76852;border-color:#f1ded5}.stats{display:grid;grid-template-columns:repeat(4,1fr);gap:16px;margin-bottom:26px}.stat{background:#fff;border:1px solid var(--line);border-radius:var(--radius);padding:19px 20px 17px;min-height:120px}.stat-top{display:flex;align-items:center;justify-content:space-between;color:#8a989f;font-size:11px}.stat-top svg{color:#889c95}.stat-value{font-size:28px;font-weight:650;letter-spacing:-1px;margin-top:15px;line-height:1.15;color:#293e44;display:flex;align-items:center;gap:9px}.stat-value.text-value{font-size:17px;letter-spacing:-.3px;line-height:1.9}.stat-note{font-size:10px;color:#9aa5ab;margin-top:6px}.mini-pill{font-size:9px;letter-spacing:0;font-weight:500;padding:4px 6px;border-radius:5px;background:#f0f6f2;color:#638571}.section-heading{display:flex;align-items:center;justify-content:space-between;margin:27px 0 13px}.section-heading h2,h2.section-title{font-size:14px;font-weight:620;letter-spacing:-.2px;margin:0}.count-label{font-size:10px;background:#e9edf0;padding:2px 6px;color:#8a969d;border-radius:5px;margin-left:7px;font-weight:500}.section-kicker{font-size:10px;color:#929fa5}.panel{background:#fff;border:1px solid var(--line);border-radius:var(--radius);overflow:hidden}.panel-pad{padding:23px}.toolbar{display:flex;align-items:center;justify-content:space-between;gap:14px;padding:17px 20px;border-bottom:1px solid #edf0f2}.search-box{display:flex;align-items:center;gap:9px;max-width:310px;flex:1;color:#9eaaaf}.search-box input{width:100%;border:0;outline:0;background:transparent;color:#3a4c54;font-size:11px;min-height:27px}.search-box input::placeholder{color:#9aa5ab}.filters{display:flex;gap:5px;padding:3px;background:#f5f7f8;border-radius:7px}.filter{font-size:10px;color:#8c999f;background:transparent;padding:6px 9px;border-radius:5px}.filter.active{background:white;color:#3d6451;box-shadow:0 1px 4px #1f352311}.table-scroll{overflow-x:auto}table{border-collapse:collapse;width:100%;text-align:left}th{font-size:9px;font-weight:500;letter-spacing:.55px;color:#9ca8ae;padding:13px 20px;background:#fcfdfd;text-transform:uppercase}td{padding:18px 20px;border-top:1px solid #edf0f2;font-size:11px;vertical-align:middle;white-space:nowrap}tbody tr:hover{background:#fdfefd}.service-name{display:flex;align-items:center;gap:12px}.service-icon{height:38px;width:38px;background:#f7eee5;border-radius:10px;color:#b47e3e;display:grid;place-items:center;font-size:15px;font-weight:650;flex-shrink:0}.service-icon.teal{background:#e8f4f0;color:#4a9977}.service-icon.blue{background:#eaf0fb;color:#6d86ad}.service-name strong{display:block;max-width:240px;white-space:normal;overflow-wrap:anywhere;font-size:12px;font-weight:600;color:#344751}.service-name small{display:block;font-size:10px;color:#9aa6ac;margin-top:5px}.mono{font-family:"SFMono-Regular",Consolas,"Liberation Mono",monospace;font-size:10px;letter-spacing:-.2px}.domain-link{display:inline-flex;align-items:center;gap:5px;color:#417b61;font-weight:500;font-size:11px}.domain-link svg{opacity:.65}.badge{padding:5px 8px;display:inline-flex;align-items:center;gap:5px;font-size:9px;border-radius:6px;background:#f4f5ed;color:#969265;font-weight:500}.badge.success{background:#edf7f0;color:#56866b}.badge.muted{background:#f0f3f5;color:#86939a}.badge.blue{background:#eef3fa;color:#7188ae}.badge.error{background:#fff0ea;color:#bb755e}.badge .online-dot{width:4px;height:4px;background:currentColor}.row-actions{display:flex;align-items:center;gap:4px;justify-content:flex-end}.switch{width:29px;height:17px;background:#d7dfe1;border-radius:20px;padding:2px;display:inline-flex;align-items:center;transition:background .2s}.switch:after{content:"";width:13px;height:13px;border-radius:50%;background:#fff;box-shadow:0 1px 2px #0002;transition:transform .2s}.switch.on{background:#6ea78a}.switch.on:after{transform:translateX(12px)}.table-end{padding:13px 20px;display:flex;justify-content:space-between;color:#a5afb4;font-size:9px;border-top:1px solid #edf0f2}.add-row{display:flex;width:100%;justify-content:center;align-items:center;gap:8px;background:#fff;color:#93a49a;font-size:11px;padding:17px;border-top:1px dashed #e2e9e5}.add-row:hover{background:#f9fcfa;color:#397a56}.below-grid{display:grid;grid-template-columns:1.55fr 1fr;gap:20px;margin-top:22px}.panel-heading{display:flex;justify-content:space-between;align-items:center;font-size:12px;font-weight:600;margin-bottom:9px}.panel-description{font-size:10px;color:#95a1a7;line-height:1.8;margin:0}.flow{display:flex;align-items:center;justify-content:space-between;gap:9px;margin-top:23px;margin-bottom:13px}.flow-node{text-align:center;min-width:60px}.node-symbol{width:38px;height:38px;background:#f2f6f3;border:1px solid #e3ece6;border-radius:11px;display:grid;place-items:center;margin:0 auto 9px;color:#81998a}.flow-node strong{max-width:100px;overflow-wrap:anywhere;font-size:10px;font-weight:550;display:block}.flow-node small{font-size:8px;color:#a1adaf;display:block;margin-top:5px}.flow-line{flex:1;border-top:1px dashed #bdcfc4;position:relative;margin-top:-27px}.flow-line:after{content:"›";color:#a1b9ac;position:absolute;right:-1px;top:-9px;font-size:14px}.flow-foot{margin-top:19px;padding-top:13px;border-top:1px solid #f0f2f3;font-size:9px;color:#92a09b;display:flex;gap:7px;align-items:center}.ssh-card{background:#eff5f1;border-color:#dce7df;position:relative}.ssh-card .panel-heading{color:#35624b}.ssh-card .panel-description{color:#879b8e}.command-small{background:#fff9;border:1px solid #dae7df;color:#578267;border-radius:7px;display:flex;align-items:center;justify-content:space-between;padding:10px 12px;margin:17px 0;font-size:11px}.command-small .dollar{color:#afc5b7;padding-right:9px}.ssh-card .btn{background:transparent;border-color:#c9dccf;color:#557e65;width:100%;margin-top:1px}.page-footer{display:flex;justify-content:space-between;color:#a9b3b9;padding:20px 42px 25px;font-size:9px;gap:10px}.footer-dot{margin:0 7px;color:#cad2d6}.empty{padding:45px 20px;text-align:center;color:#98a5ac}.empty svg{margin-bottom:10px;color:#adbbb3}.empty h3{font-size:14px;color:#61716d;font-weight:550}.empty p{font-size:11px;line-height:1.7}.empty .btn{margin-top:10px}.zones-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:18px}.zone-card{padding:23px;position:relative}.zone-top{display:flex;justify-content:space-between;align-items:center;margin-bottom:22px}.zone-symbol{height:37px;width:37px;background:#edf4f0;color:#72a184;border-radius:10px;display:grid;place-items:center}.zone-name{font-size:21px;font-weight:620;letter-spacing:-.6px;word-break:break-word}.zone-caption{color:#97a49f;font-size:10px;margin:8px 0 20px}.zone-foot{display:flex;align-items:center;justify-content:space-between;border-top:1px solid #edf1ef;padding-top:14px}.info-box{margin-top:22px;display:flex;gap:12px;padding:18px 20px;border:1px solid #e0e7e2;background:#f2f7f3;border-radius:10px;font-size:11px;line-height:1.8;color:#698473}.info-box strong{color:#476d54}.info-box p{margin:0}.info-box.warning{background:#fbf8ef;border-color:#eae3cc;color:#9a8960}.info-box.warning strong{color:#867143}.two-col{display:grid;grid-template-columns:1.1fr 1fr;gap:23px}.code-panel{background:#1b3036;color:#bfd3c9;border:1px solid #294149;border-radius:10px;overflow:hidden}.code-top{display:flex;align-items:center;justify-content:space-between;padding:15px 19px;background:#ffffff04;border-bottom:1px solid #ffffff09;font-size:10px;color:#96aaa8}.code-top .icon-button{color:#a5bfb4}.code-top .icon-button:hover{background:#ffffff09}.code-panel pre{margin:0;padding:23px 21px;overflow:auto;font:11px/1.9 "SFMono-Regular",Consolas,monospace;white-space:pre;min-height:200px;max-height:480px}.step{display:flex;gap:13px;margin:23px 0}.step-number{border-radius:50%;background:#eaf2ed;color:#769b83;width:25px;height:25px;display:grid;place-items:center;font-size:10px;flex-shrink:0}.step strong{font-size:11px;font-weight:600;color:#43584d}.step p{font-size:10px;color:#8d9c94;line-height:1.8;margin:5px 0}.command-line{display:flex;gap:8px;align-items:center;background:#f5f8f6;border:1px solid #e4ebe7;border-radius:7px;padding:8px 10px;margin-top:10px;max-width:100%}.command-line code{font-size:9px;line-height:1.8;word-break:break-all;color:#5f7a68;flex:1}.command-line .icon-button{flex-shrink:0}.settings-grid{display:grid;grid-template-columns:minmax(0,1.4fr) minmax(260px,1fr);gap:23px}.form-section{padding:24px}.form-section+.form-section{border-top:1px solid var(--line)}.form-section h2{font-size:13px;font-weight:600;margin:0 0 7px}.form-section>p{font-size:11px;color:#909da4;line-height:1.7;margin:0 0 23px}.form-grid{display:grid;grid-template-columns:1fr 1fr;gap:17px}.field{display:flex;flex-direction:column;gap:7px;font-size:11px;color:#566a73;min-width:0}.field.full{grid-column:1/-1}.field input,.field select,.field textarea{border:1px solid #dce4e7;border-radius:7px;background:#fff;padding:10px 11px;color:#32464e;font-size:12px;width:100%;min-height:38px}.field textarea{resize:vertical;line-height:1.6}.field small{font-size:9px;line-height:1.6;color:#95a2a8}.field input::placeholder{color:#b1bbc0}.check-line{display:flex;align-items:center;gap:9px;color:#61746a;font-size:11px;line-height:1.6}.check-line input{accent-color:#347a58;width:15px;height:15px}.form-footer{display:flex;align-items:center;justify-content:flex-end;gap:9px;padding:17px 24px;background:#fafcfb;border-top:1px solid var(--line)}.stack{display:flex;flex-direction:column;gap:18px}.integration{display:flex;gap:11px;padding:18px 0;border-bottom:1px solid #edf1ef;align-items:center}.integration:last-child{border-bottom:0;padding-bottom:0}.integration-icon{height:35px;width:35px;display:grid;place-items:center;background:#f3f6f4;border-radius:9px;color:#8fa699}.integration strong{display:block;font-size:12px;font-weight:550}.integration small{display:block;margin-top:5px;color:#98a6a1;font-size:10px}.integration .badge{margin-left:auto}.certificate-card{padding:26px}.certificate-art{width:55px;height:65px;border:1px solid #c5ddcc;border-radius:9px;background:#f1f8f3;color:#91b79c;display:grid;place-items:center;margin-bottom:22px}.certificate-card h2{font-size:20px;letter-spacing:-.5px;margin:0 0 8px}.key-details{margin:23px 0}.detail-line{display:flex;justify-content:space-between;gap:20px;padding:11px 0;border-bottom:1px solid #eef2ef;font-size:11px;color:#8a9b91}.detail-line strong{font-weight:500;color:#506e5a}.fingerprint{font:10px/1.8 "SFMono-Regular",monospace;word-break:break-all;background:#f6f8f7;border-radius:7px;padding:11px;margin-top:12px;color:#82988a}.history-item{display:flex;align-items:flex-start;gap:10px;padding:13px 0;border-bottom:1px solid #f0f3f1;font-size:11px;color:#6b7f74}.history-item:last-child{border:0}.history-item svg{color:#84a691}.history-item time{font-size:9px;color:#a2aea7;margin-left:auto}.history-item p{margin:0;line-height:1.6}.note{font-size:10px;line-height:1.8;color:#8d9c94}.loading-state{display:flex;flex-direction:column;align-items:center;justify-content:center;min-height:400px;color:#8da094;font-size:12px}.spinner{height:24px;width:24px;border:2px solid #dde9e0;border-top-color:#679c79;border-radius:50%;animation:spin 1s linear infinite}@keyframes spin{to{transform:rotate(360deg)}}dialog{width:570px;max-width:calc(100% - 28px);padding:0;border:1px solid #dce6df;border-radius:15px;box-shadow:0 24px 100px #11271d3b;color:var(--ink);max-height:90vh}dialog::backdrop{background:#15282160;backdrop-filter:blur(3px)}.modal-header{padding:23px 26px 18px;display:flex;align-items:flex-start;justify-content:space-between;border-bottom:1px solid #edf1ef}.modal-header h2{font-size:19px;letter-spacing:-.5px;margin:0 0 7px}.modal-header p{font-size:11px;color:#91a099;margin:0;line-height:1.7}.modal-body{padding:24px 26px;max-height:65vh;overflow:auto}.modal-body .form-grid{gap:16px}.modal-subtitle{font-size:11px;font-weight:600;border-top:1px solid var(--line);padding-top:20px;margin:22px 0 13px;color:#4b6d58}.form-error{padding:11px 13px;margin-top:14px;font-size:11px;color:#aa6150;background:#fff1ec;border:1px solid #f1ddd5;border-radius:7px;line-height:1.7;word-break:break-word}.toast-region{position:fixed;right:28px;bottom:25px;z-index:100;max-width:420px}.toast{display:flex;gap:10px;align-items:flex-start;max-width:calc(100vw - 35px);padding:15px 19px;border:1px solid #d0e3d5;background:#f3faf5;box-shadow:0 8px 36px #24492f20;border-radius:10px;color:#527c60;font-size:12px;line-height:1.6;animation:rise .2s ease}.toast.error{background:#fff4ef;border-color:#eed1c5;color:#a96b56}.toast svg{margin-top:1px;flex-shrink:0}@keyframes rise{from{transform:translateY(10px);opacity:0}to{transform:translateY(0);opacity:1}}.login-screen{position:fixed;inset:0;z-index:50;background:#eff3ef;display:grid;place-items:center;padding:20px}.login-card{background:#fff;border:1px solid #dce7df;border-radius:18px;padding:38px;width:380px;max-width:100%;box-shadow:0 12px 50px #28472e09}.login-card img{margin-bottom:25px}.login-card h1{font-size:25px}.login-card p{font-size:12px;line-height:1.8;color:#87998d;margin:12px 0 26px}.login-card .btn{width:100%;margin-top:20px}.mobile-only{display:none}.sidebar-shade{display:none}details.advanced{margin-top:18px;border-top:1px solid #e8eeea;padding-top:16px}details.advanced summary{cursor:pointer;color:#799584;font-size:11px}details.advanced .form-grid{margin-top:18px}.mobile-label{display:none}@media(min-width:1500px){main{padding-top:45px}.stats{gap:22px}.heading{margin-bottom:30px}.stat{padding:24px}.sidebar{width:260px}.workspace-main{margin-left:260px}.topbar{padding:0 48px}main{padding-left:48px;padding-right:48px}}@media(max-width:1150px){.sidebar{width:212px;padding:28px 13px 20px}.workspace-main{margin-left:212px}.brand{font-size:23px}.topbar{padding:0 26px}main{padding:29px 26px}.stat{padding:17px 15px}.stats{gap:11px}td,th{padding-left:14px;padding-right:14px}.below-grid{grid-template-columns:1.2fr 1fr}.zones-grid{grid-template-columns:repeat(2,1fr)}.settings-grid,.two-col{grid-template-columns:1fr}.page-footer{padding:20px 26px}.flow{gap:5px}.flow-node{min-width:49px}.ssh-card .command-small{font-size:10px}}@media(max-width:850px){.sidebar{transform:translateX(-100%);transition:transform .2s;width:244px}.workspace-main{margin-left:0}.mobile-only{display:inline-grid}.menu-open .sidebar{transform:translateX(0)}.menu-open .sidebar-shade{display:block;position:fixed;inset:0;background:#0d251e55;z-index:19}.topbar{height:65px;padding:0 23px}.heading{align-items:flex-start}h1{font-size:26px}.stats{grid-template-columns:repeat(2,1fr)}.below-grid{grid-template-columns:1fr 1fr}.sidebar-guide{margin-top:auto}.table-end{gap:10px}.topbar-right{gap:15px}.breadcrumb{gap:9px}.page-footer{font-size:8px}}@media(max-width:560px){main{padding:25px 17px}.topbar{padding:0 17px}.breadcrumb>span:first-of-type{display:none}.crumb-slash{display:none}.local-chip{font-size:9px}.topbar-right{gap:8px}.heading{flex-direction:column;gap:20px;margin-bottom:22px}.heading .button-row{width:100%;justify-content:flex-end}.heading .button-row .btn{flex:1}.subtitle{font-size:11px}.stat{padding:17px}.stat-value{font-size:26px}.stats{gap:10px}.below-grid{grid-template-columns:1fr}.toolbar{flex-direction:column;align-items:stretch;padding:14px}.search-box{max-width:none}.filters{align-self:flex-start}.zones-grid{grid-template-columns:1fr}.status-strip{font-size:10px;align-items:flex-start}.status-strip svg{margin-top:3px}.status-strip button{font-size:10px}.form-grid{grid-template-columns:1fr}.field.full{grid-column:auto}.form-section{padding:20px}.modal-body{padding:20px}.modal-header{padding:20px}.form-footer{padding:16px 20px}.page-footer{flex-direction:column;padding:18px;text-align:center;gap:8px}.flow-node{min-width:60px}.section-heading{align-items:flex-start;gap:9px}.panel-pad{padding:20px}.toast-region{right:15px;bottom:15px}.badge{white-space:nowrap}.two-col,.settings-grid{gap:17px}.table-scroll{max-width:calc(100vw - 36px)}}@media(prefers-reduced-motion:reduce){*{animation:none!important;transition:none!important}} + +.dns-challenge-fields{border:0;padding:0;margin:18px 0 0;min-width:0}.dns-challenge-fields .info-box{margin-bottom:18px}.dns-credential-template{white-space:pre-wrap;overflow-wrap:anywhere;background:#f5f7f8;padding:14px;border-radius:8px;font-size:12px}.dns-challenge-actions{display:flex;gap:8px;flex-wrap:wrap}