Files
buryan-infra/ops/scripts/SSO-STATE-AND-PLAN.md

152 lines
5.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Единый вход — состояние и план
Обследовано 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. Пускать ли снаружи через заслон, или оставить как есть?
```