Files
buryan-infra/docs/SSO-CENTRALIZED.md
root 145f251141 Централизованный вход: 15 доменов через Authentik, один аккаунт
По решению владельца: «вход нужен централизованный, чтобы всё работало
с одного аккаунта из Authentik».

ПОД ВХОДОМ ТЕПЕРЬ: sonarr, radarr, prowlarr, bazarr, ombi, plex, media
(Jellyfin), vault (Vaultwarden), books (Calibre), news (FreshRSS),
docs и files (Paperless), music (Navidrome), links, hub (Dashy).
Снаружи все сначала ведут на вход Authentik, потом в службу. Дома так же.

ЧТО БЫЛО НЕ ТАК: у каждого прокси были прописаны ВНУТРЕННИЕ адреса
(REDIRECT_URL=http://192.168.1.117:9989/..., OIDC_ISSUER_URL=
http://192.168.1.114:9000/...). Снаружи браузер перенаправлялся на
недоступный из интернета адрес, вход не мог завершиться. Поэтому службы
пускали напрямую.

ИЗМЕНЕНО В ТРЁХ МЕСТАХ на каждую службу: в Authentik разрешён внешний
адрес возврата; у прокси переведены REDIRECT_URL и OIDC_ISSUER_URL на
https, включён режим за обратным прокси, cookie secure; на VPS домен
направлен на порт прокси.

МОИ ОШИБКИ В ЗАДАЧЕ (записаны в документ):
  * взял адрес по номеру контейнера — книги и новости ушли на старый
    .111 (у CT 111 теперь .240) -> 502, поймал проверкой;
  * направил Paperless на экземпляр, который сам же отключил часом
    раньше -> перевёл на рабочий CT 105;
  * cookie-секрет взял из клиентского (128 байт вместо 32) -> прокси
    перезапускался, сгенерировал правильные;
  * забыл DNS у прокси в CT 102 -> не мог разрезолвить authentik.

ПРОВЕРЕНО: все 15 доменов снаружи редиректят на https://authentik,
authorize принимается (страница входа отдаётся без ошибок), дома тоже
через вход, службы живы напрямую, наблюдение 59 проверок без провалов.

Внутренние адреса возврата сохранены — прямой доступ по IP:порт внутри
дома продолжит работать. Plex остался со своим аккаунтом (у него своя
авторизация), но домен уже за входом.
2026-10-18 14:15:45 +03:00

94 lines
4.7 KiB
Markdown

# Централизованный вход: сделано (задача 4.1.1 / 4.1.3)
**18.10.2026.** По решению владельца: «вход нам нужен централизованный,
чтобы всё работало с одного аккаунта из Authentik».
## Результат: 15 доменов под единым входом
| Домен | Что за служба |
|---|---|
| sonarr | сериалы |
| radarr | фильмы |
| prowlarr | индексаторы |
| bazarr | субтитры |
| ombi | заявки на фильмы |
| plex | медиасервер |
| media | Jellyfin |
| vault | Vaultwarden (пароли) |
| books | Calibre (книги) |
| news | FreshRSS (новости) |
| docs, files | Paperless |
| music | Navidrome |
| links | закладки |
| hub | Dashy (стартовая) |
Снаружи все они теперь **сначала ведут на вход Authentik**, и только
после входа — в службу. Дома — так же.
## Что было не так
У каждого прокси входа были прописаны **внутренние адреса**:
```
REDIRECT_URL=http://192.168.1.117:9989/oauth2/callback
OIDC_ISSUER_URL=http://192.168.1.114:9000/application/o/sonarr/
```
Снаружи браузер перенаправлялся на адрес, недоступный из интернета, —
вход не мог завершиться. Поэтому снаружи службы пускали напрямую.
## Что изменено (три места на каждую службу)
1. **Authentik** — в провайдере разрешён внешний адрес возврата
`https://<домен>/oauth2/callback` (внутренний оставлен, чтобы ничего
не сломать).
2. **Прокси** — `REDIRECT_URL` и `OIDC_ISSUER_URL` переведены на
`https://`, включён режим работы за обратным прокси, cookie помечены
как `secure`.
3. **VPS** — домен направлен на порт прокси, а не в саму службу.
## Мои ошибки в этой задаче
1. **Взял адрес по номеру контейнера** — направил книги и новости на
`192.168.1.111`, а у этого контейнера адрес давно `.240`. Домены
отдали 502. Поймал проверкой, исправил.
2. **Направил Paperless на отключённый экземпляр** — прокси смотрел в
CT 110, который я сам же выключил часом раньше. Перевёл на рабочий
CT 105.
3. **Cookie-секрет взял из клиентского** — 128 байт вместо 32, прокси
перезапускался с ошибкой `cookie_secret must be 16, 24, or 32 bytes`.
Сгенерировал правильные.
4. **Забыл DNS у одного контейнера** — прокси в CT 102 не мог
разрезолвить `authentik.buryans.ru` (в контейнере прописаны
1.1.1.1/8.8.8.8, недоступные). Добавил `--dns 192.168.1.107`.
## Проверено
| Проверка | Результат |
|---|---|
| Все 15 доменов снаружи | редирект на `https://authentik.buryans.ru` |
| Authorize принимается | да (страница входа отдаётся, ошибок нет) |
| Дома через вход | да |
| Службы живы напрямую | да |
| Наблюдение | 59 проверок, провалов нет |
## Что важно знать
* **Внутренние адреса возврата сохранены** — прямой доступ по IP:порту
внутри дома продолжит работать.
* **Один аккаунт**: вход через Authentik, учётные данные служб
передаются заголовками (`SET_XAUTHREQUEST`, `PASS_USER_HEADERS`).
* **Plex** остался со своим аккаунтом (у него собственная авторизация),
но домен уже за входом.
## Откат одной службы
```
# вернуть домен в службу на VPS
sed -i 's|http://192.168.1.CT:PROXY|http://192.168.1.CT:APP|' \
/etc/nginx/conf.d/buryans-all.conf && nginx -t && systemctl reload nginx
# вернуть прокси
pct exec CT -- docker rm -f oauth2-proxy-ИМЯ
# конфигурация «как было» сохранена: /root/oauth2-proxy-ИМЯ.before-sso.json
```