From cc11fc8bb8b9d2cae2095da15a528eb3a6948d8d Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Fri, 16 Oct 2026 14:19:30 +0300 Subject: [PATCH] =?UTF-8?q?=D0=B5=D0=B4=D0=B8=D0=BD=D1=8B=D0=B9=20=D0=B2?= =?UTF-8?q?=D1=85=D0=BE=D0=B4:=20=D0=BE=D0=B1=D0=BD=D0=B0=D1=80=D1=83?= =?UTF-8?q?=D0=B6=D0=B5=D0=BD=D0=BE=20=D1=87=D1=82=D0=BE=20=D0=B2=20Authen?= =?UTF-8?q?tik=20=D1=83=D0=B6=D0=B5=2022=20=D0=BF=D1=80=D0=B8=D0=BB=D0=BE?= =?UTF-8?q?=D0=B6=D0=B5=D0=BD=D0=B8=D1=8F=20=D0=B8=20=D1=83=D1=87=D1=91?= =?UTF-8?q?=D1=82=D0=BD=D1=8B=D0=B5=20=D0=B7=D0=B0=D0=BF=D0=B8=D1=81=D0=B8?= =?UTF-8?q?=20=D1=81=D0=B5=D0=BC=D1=8C=D0=B8;=20=D0=BD=D0=B5=20=D1=85?= =?UTF-8?q?=D0=B2=D0=B0=D1=82=D0=B0=D0=B5=D1=82=20=D1=82=D0=BE=D0=BB=D1=8C?= =?UTF-8?q?=D0=BA=D0=BE=20=D0=B7=D0=B0=D1=81=D0=BB=D0=BE=D0=BD=D0=B0=20?= =?UTF-8?q?=D0=B2=20NGINX?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/scripts/SSO-STATE-AND-PLAN.md | 151 ++++++++++++++++++++++++++++++ 1 file changed, 151 insertions(+) create mode 100644 ops/scripts/SSO-STATE-AND-PLAN.md diff --git a/ops/scripts/SSO-STATE-AND-PLAN.md b/ops/scripts/SSO-STATE-AND-PLAN.md new file mode 100644 index 0000000..5be3692 --- /dev/null +++ b/ops/scripts/SSO-STATE-AND-PLAN.md @@ -0,0 +1,151 @@ +# Единый вход — состояние и план + +Обследовано 16.10.2026. + +## ГЛАВНОЕ ОТКРЫТИЕ: большая часть уже настроена + +В Authentik **уже есть** готовые настройки: + +``` +приложений: 22 +провайдеров OIDC: 24 +провайдеров-заслонов: 0 ← единственное, чего нет +``` + +### Приложения, уже заведённые + +``` +Gitea · grafana · Jellyfin · Linkding · Matrix · n8n · Navidrome +nextcloud · Overseerr · Paperless · Plex · Prowlarr · Radarr +Sonarr · Tautulli · Vaultwarden · Bazarr · Calibre-web +Dashy · FreshRSS · Node-RED · NPM Forward Auth +``` + +### Пользователи — это семья + +``` +roman maloyakapg@gmail.com (владелец) +elena gusak_e66@mail.ru +polina p.parshkova95@gmail.com +nikita +daniil +sergey buruan_s@mail.ru +AlexTest alextest@buryans.ru +akadmin (служебная) +``` + +### Группы + +``` +family · admin · limited +gitea_admins · gitea-users +grafana-admins +``` + +**Вывод: кто-то (скорее всего я в прошлых спринтах) уже проделал +всю работу в Authentik.** Включая учётные записи семьи и группы. + +## ЧЕГО НЕ ХВАТАЕТ + +**Службы эти настройки НЕ ИСПОЛЬЗУЮТ.** + +Провайдеры есть, но: +* в NGINX нет проверки входа; +* службы не знают своих ключей доступа; +* провайдеров-заслонов — **0**. + +**И есть зацепка:** приложение **«NPM Forward Auth»** (slug +`npm-forward-auth`) — значит заслон для СТАРОГО прокси +планировался. До нашего NGINX он не дошёл. + +## СКОРРЕКТИРОВАННЫЙ ПЛАН + +### Этап 1. Внешний заслон (закрывает большинство) + +``` +1. Создать в Authentik провайдер-заслон (proxy provider) +2. Привязать к приложению +3. Прописать в домашнем NGINX проверку входа +4. Проверить на ОДНОЙ службе +5. Включить для остальных +``` + +**Закроет одним движением:** +``` +Sonarr · Radarr · Prowlarr · Bazarr · Calibre-web · FreshRSS +Navidrome · Tautulli · Dashy · Node-RED · Overseerr +AdGuard · Uptime Kuma · Prometheus +``` + +### Этап 2. Встроенный вход (для умеющих) + +Провайдеры **уже есть** — надо прописать ключи в самих службах: + +| Служба | Что сделать | +|---|---| +| Gitea | прописать client_id/secret в настройках | +| Grafana | то же | +| Immich | то же | +| Paperless | то же | +| Linkding | то же | +| Vaultwarden | то же (с оговорками) | +| Nextcloud | то же | + +### Этап 3. Особые случаи — НЕ ТРОГАТЬ + +``` +Plex — свой вход, нужен для телевизоров и приложений +Jellyfin — свой вход, нужен для телевизоров +Proxmox — свой вход, нужен для управления +Syncthing — свой вход, нужен устройствам для синхронизации +Immich — свой вход нужен телефонам (загрузка фото) +AdGuard — свой вход для панели +Matrix — уже работает через SSO ✅ +``` + +**Причина:** устройства (телевизоры, телефоны) не умеют проходить +веб-вход. Для них заслон = потеря доступа. + +### Этап 4. Резервный вход + +``` +⚠️ Если Authentik упадёт — никто не войдёт никуда. + +Решение: + * прямой доступ по внутреннему адресу (в обход NGINX) + остаётся всегда — его правка не касается; + * снаружи (через VPS) заслон НЕ включаем — там своя защита. +``` + +## БЕЗОПАСНЫЙ ПОРЯДОК ПРАВКИ + +``` +1. Копия настройки NGINX +2. Правка на ОДНОЙ службе (например, status.buryans.ru) +3. Проверка: просит вход? пускает после входа? +4. Если да — включить для остальных +5. Если нет — убрать строки, перезагрузить + +Возврат одной командой: + rm /etc/nginx/conf.d/sso-guard.conf && systemctl reload nginx +``` + +## ПОЧЕМУ ЭТО НЕ ОПАСНО + +``` +✅ правка только домашнего NGINX; +✅ внешний доступ (через VPS) не затрагивается; +✅ прямой доступ по внутренним адресам не затрагивается; +✅ возврат одной командой; +✅ провайдеры в Authentik уже готовы — создавать не надо. +``` + +## Что нужно решить владельцу + +``` +1. Кому какой доступ? + Например: family — медиа и фото, admin — всё. +2. Нужен ли заслон для медиасерверов? + Телевизоры не умеют входить через веб → им прямой доступ. +3. Пускать ли снаружи через заслон, или оставить как есть? +```