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. Пускать ли снаружи через заслон, или оставить как есть? +```