Files
buryan-infra/docs/SPRINT-2026-10-19-SSO.md
T
buryan-agent 6ab5a6476a Копии: освобождён диск (94%%→72%%), CT 111 добавлен в расписание и проверен
Ротация запускалась раз в неделю при ежедневных копиях — диск дошёл
до 94%%. Ротация переведена на ежедневный запуск (06:30), освобождено 24 ГБ.

CT 111 (книги, каталог, Duplicati, FreshRSS) не имел ни одного архива.
Добавлен в /etc/cron.d/lxc-backups (вс 05:15) и сразу проверен:
vzdump-lxc-111-2026_10_19-12_30_24.tar.zst, 3,3 ГБ.
2026-10-19 12:31:46 +03:00

278 lines
18 KiB
Markdown
Raw 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.
# Единый вход: спринт 19.10.2026 (вечер)
Продолжение работы по `AUDIT-FULL-2026-10-19.md`. Ниже — что на самом деле
было сломано, что исправлено, чем проверено и что осталось.
---
## 1. Итог
**16 служб проверены живым входом** (не «по факту создания»): вход один,
после него сразу служба, без второй формы. Плюс найдено и исправлено
**11 дефектов**, которых в аудите не было или причина была указана неверно.
Главное, чего не хватало: **способа проверить вход по-настоящему**. Теперь он
есть — `ops/sso/2026-10-19/login-check.py`. Это буквальное выполнение урока № 1
из аудита: «проверять не факт создания, а результат».
---
## 2. Как теперь проверяется вход
```bash
python3 /root/login-check.py https://git.buryans.ru/ https://flow.buryans.ru/
python3 /root/login-check.py https://books.buryans.ru/catalog/ --debug
```
Скрипт проходит весь круг так же, как браузер: служба → Authentik → ввод
логина и пароля → возврат с кодом → страница службы. Печатает, что служба
отдала в итоге, сколько было перенаправлений и какие cookie получились.
Для этого создана служебная учётная запись **`sso-check`** (Authentik pk=26):
* права как у члена семьи: `family`, `gitea-users`, `gitea_admins`,
`grafana-admins`, `linkding-users`, `matrix-users`, `mealie-users`,
`n8n-admins`, `navidrome-users`, `vaultwarden-users`;
* **не входит** в «authentik Admins»;
* пароль: `/root/.buryan-sso-check-password` (права 600);
* отключить одной командой: `is_active=false` через API.
Причина, по которой нельзя было обойтись учёткой `akadmin`: в
`/root/.buryan-ak-password` лежит пароль пользователя **базы** Authentik, а не
входной пароль.
---
## 3. Что было сломано и что сделано
### 3.1 Каталог книг (`books.buryans.ru/catalog/`) — цикл перенаправления
Причин оказалось **две**, аудит называл одну неверную:
| Что | Подробности |
|---|---|
| Адрес возврата не разрешён | у провайдера `catalog-proxy` был разрешён `…/oauth2/callback`, а служба просит `…/catalog/oauth2/callback` → Authentik отвечал «Redirect URI Error» |
| Имя cookie совпадало с Calibre | на `books.buryans.ru` два прокси входа; имя cookie по умолчанию у обоих `_oauth2_proxy`, ключи подписи разные. Браузер присылал чужую cookie → «cookie signature not valid» → снова на вход |
Сделано: адрес возврата исправлен, каталогу выдано своё имя cookie
`_oauth2_proxy_catalog`, свой ключ подписи.
**Проверено:** вход → «Каталог книг», код 200.
### 3.2 `backup.buryans.ru` вёл на Grafana
Прокси в CT 113 смотрел на `192.168.1.113:3000` — там Grafana. Duplicati живёт
в CT 111 на `192.168.1.240:8200`. Прокси перенаправлен на Duplicati.
**Проверено:** вход → «Backup» (Duplicati), код 200.
### 3.3 `flow.buryans.ru` (Node-RED) — внутренние адреса
Адрес возврата был `http://192.168.1.108:1881/oauth2/callback`, издатель —
`http://192.168.1.114:9000`: из дома работало, снаружи нет. Кроме того,
вышестоящая служба задавалась именем `node_red`, а прокси живёт в другой сети
Docker — служба не разрешалась (502).
Сделано: адрес возврата `https://flow.buryans.ru/oauth2/callback`, издатель
`https://authentik.buryans.ru/application/o/nodered/`, вышестоящий адрес
`http://192.168.1.108:1880`.
**Проверено:** вход → «Node-RED», код 200.
### 3.4 502 сразу после успешного входа
В журнале прокси — `AuthSuccess`, а браузер получал 502. Причина: сессия
с правами групп не влезает в cookie 4 КБ, прокси делит её на несколько cookie,
заголовок ответа вырастает, и nginx с буфером 4 КБ отдаёт 502.
Сделано: `/etc/nginx/conf.d/00-proxy-buffers.conf` на **обоих** nginx
(дом и VPS): `proxy_buffer_size 32k`, `proxy_buffers 8 32k`.
### 3.5 `headscale.buryans.ru` вёл на прокси Node-RED
Блок nginx указывал на `192.168.1.108:1881` (прокси Node-RED) вместо headscale.
Похоже на след правки «flow → Node-RED»: адрес попал не в тот блок.
Домашний headscale (CT 201) остановлен, рабочий — на VPS, слушает
`127.0.0.1:8443`. Исправлено на обоих nginx.
**Проверено:** `headscale.buryans.ru/windows` → 200, страница headscale.
### 3.6 Sonarr / Radarr / Prowlarr — своя форма входа
Причина в аудите указана неверно («`AuthenticationMethod` в базе не найдена»).
Настройка лежит **в `config.xml`**, а не в базе:
| Служба | Было | Стало |
|---|---|---|
| Sonarr | `Basic` | `External` |
| Radarr | `Forms` | `External` |
| Prowlarr | `Forms` | `External` |
Перед правкой — копия файла (`.bak-<дата>`). Все три работают на общем
PostgreSQL (`sonarr_db`, `radarr_db`, `prowlarr_db`), файлы `*.db` в контейнерах —
остатки: это отвечает на вопрос C-1 аудита для arr-служб.
**Проверено:** все три — код 200 без второй формы.
### 3.7 Vaultwarden — «в удовлетворении отказано»
Прокси входа использовал `client_id=vaultwarden-proxy`, а **приложения в
Authentik у этого провайдера нет** — вход отклонялся до формы. При этом
Vaultwarden уже умел родной вход через Authentik (`SSO_ENABLED=true`,
провайдер «Provider for Vaultwarden» с приложением).
Сделано: прокси убран (остановлен и снят с автозапуска), домен ведёт прямо на
Vaultwarden `192.168.1.109:8081`. Родной SSO у службы остаётся.
**Проверено:** `vault.buryans.ru` → 200, «Vaultwarden Web»; адрес
`/identity/connect/oidc-signin` отвечает и разбирает `code`/`state`.
### 3.8 Nextcloud 500 при возврате с входа
Настоящая причина — не логирование и не политика. В журнале:
```
Could not resolve OCA\Talk\Share\RoomShareProvider!
Class "OCA\Talk\Share\RoomShareProvider" does not exist
```
При входе копируется стартовый набор файлов, срабатывает обработчик активности,
он идёт за провайдером общих папок Talk — а приложение Talk включено без файлов.
Сделано: `occ app:disable spreed` (обратимо, включается `occ app:enable spreed`
после переустановки приложения).
**Проверено:** вход через `files.buryans.ru/apps/user_oidc/login/1` → «Dashboard —
Nextcloud», код 200.
### 3.9 `requests.buryans.ru` — 403 на возврате
`requests` и `ombi` ведут на один прокси, а адрес возврата у него — `ombi`.
Начав с `requests`, браузер получал cookie для `requests`, а возврат приходил
на `ombi` — проверка состояния не сходилась. Сделано: `requests` → 301 на
`ombi.buryans.ru` (как `recipes` → `meals`).
**Проверено:** 301 → `https://ombi.buryans.ru/`.
### 3.10 Лишний экран согласия при каждом входе
Все 35 провайдеров были привязаны к потоку
`default-provider-authorization-explicit-consent`: после пароля каждый раз
появлялся экран «Authorize Application». Переведены на
`default-provider-authorization-implicit-consent` — вход остаётся один, лишний
шаг пропадает. Откат: тот же скрипт с `FLOW_NAME=…explicit-consent`.
### 3.11 FreshRSS — данные не сохранялись
В compose путь монтирования был `/opt/freshrss/var/www/FreshRSS/data` — с лишним
префиксом, поэтому внутри контейнера каталог данных оставался пустым, и служба
каждый раз показывала мастер установки. В том же compose остались пустые
переменные после правки заменой строк (урок № 2 аудита).
Сделано: compose переписан построчно, данные монтируются в
`/var/www/FreshRSS/data` из `/opt/freshrss/data`, `docker compose config` проходит.
**Важно:** данных FreshRSS нет — **архива CT 111 не существует вовсе**.
Учётную запись и ленты нужно завести заново; мастер установки уже доступен.
---
## 4. Проверено живым входом
| Служба | Домен | Итог |
|---|---|---|
| Gitea | `git` | 200 |
| n8n | `n8n` | 200 |
| Node-RED | `flow` | 200 |
| Jellyfin | `media` | 200 |
| Navidrome | `music` | 200 |
| Calibre | `books` | 200 |
| Каталог книг | `books/catalog/` | 200 |
| Sonarr | `sonarr` | 200 |
| Radarr | `radarr` | 200 |
| Prowlarr | `prowlarr` | 200 |
| Bazarr | `bazarr` | 200 |
| Mealie | `meals` | 200 |
| Uptime Kuma | `status` | 200 |
| Dashy | `hub` | 200 |
| Duplicati | `backup` | 200 |
| Nextcloud | `files` | 200 |
Своя авторизация (так и задумано): `vault`, `plex`, `immich`, `home`, `element`,
`matrix`, `chat`, `pve`. Служебные: `headscale` (200), `requests` (301 → `ombi`).
---
## 5. Копии: что было и что сделано
Проверка началась с вопроса «а есть ли копии у книжного контейнера» — и
оказалось, что нет.
| Факт | Было | Стало |
|---|---|---|
| Диск копий | 98 ГБ, занято 87 ГБ (94%), свободно **6 ГБ** | 67 ГБ (72%), свободно **27 ГБ** |
| Ротация | раз в неделю (вс 05:00) — за неделю копии накапливались | **ежедневно 06:30**, после всех копий |
| CT 111 (книги, каталог, Duplicati, FreshRSS) | **ни одного архива** | еженедельно (вс 05:15); копия сделана и проверена — `vzdump-lxc-111-2026_10_19-12_30_24.tar.zst`, 3,3 ГБ |
| Свободное место после | — | 27 ГБ |
Ротацию запустили вручную: политика «оставлять 2 архива на гостя» освободила
24 ГБ (самый старый архив — образ Immich от 20.09, 8,1 ГБ).
### Что с копиями осталось
| Риск | Факты |
|---|---|
| **Копии не у всех** | архивы есть у 10 контейнеров из 30. Без копий: 102 (Dashy), 103 (Jellyfin), 106 (Home Assistant), 107 (AdGuard, Uptime Kuma), 116–127 (медиа), 134 (Prometheus), 151 (все базы — только `pg_dumpall`), 161 (VPN-шлюз) |
| **Копии только локально** | архивы на том же узле, что и данные. `offsite-backup.sh` есть в расписании — что именно он уносит, не проверено в этой сессии |
| **FreshRSS пуст** | данных нет и восстановить нечем — заводить заново |
| **Служебная учётка** | `sso-check` имеет доступ к службам семьи. Нужна для проверок; отключается `is_active=false` |
---
## 6. Что осталось и почему
| Служба | Причина (проверена) | Что нужно |
|---|---|---|
| **Linkding** (`links`) | `LD_ENABLE_AUTH_PROXY=True`, заголовок `X-Auth-Request-Preferred-Username` стоит, но служба по нему не впускает — показывает свою форму | Проверить, какой заголовок реально доходит (в журнале прокси видно `sso-check@buryans.ru`), и версию Linkding; возможно, нужен `X-Auth-Request-User` или `LD_AUTH_PROXY_…` другого образца |
| **Firefly** (`finance`) | в окружении службы **нет** ни `AUTHENTICATION_GUARD`, ни `AUTHENTICATION_GUARD_HEADER` — `remote_user_guard` не включён, поэтому после входа своя форма `/login` | прописать `AUTHENTICATION_GUARD=remote_user_guard`, `AUTHENTICATION_GUARD_HEADER=HTTP_X_FORWARDED_USER`, `AUTHENTICATION_GUARD_EMAIL=HTTP_X_FORWARDED_EMAIL`, `TRUSTED_PROXIES=**` |
| **Paperless** (`docs`) | ни OIDC, ни remote-user в настройках нет | либо родной OIDC (`PAPERLESS_…`/django-allauth), либо `PAPERLESS_ENABLE_HTTP_REMOTE_USER=true` + `AUTHENTICATION_BACKENDS` |
| **AdGuard** (`adguard`) | штатного механизма доверия прокси нет | решить: свой вход или убрать из единого входа |
| **Plex** (`plex`) | 401: Plex не принимает заголовки прокси | либо свой вход (убрать прокси), либо разрешить сети прокси в Plex |
| **Immich** (`immich`) | родной OIDC не настроен | включить OIDC в Immich (провайдер и адрес возврата уже есть) |
| **Tautulli** | блока nginx нет, прокси готов (`CT122:9984`), адрес возврата провайдера исправлен | блок nginx на двух хостах + сертификат |
| **Grafana** | провайдер `grafana-oidc` есть, но адрес возврата внутренний (`http://192.168.1.113:3000/login/generic_oauth`) | внешний адрес + `GF_SERVER_ROOT_URL` |
| **Prometheus / Alertmanager** | блоков nginx нет | блоки + сертификаты |
---
## 7. Файлы и пароли
| Что | Где |
|---|---|
| Проверка входа | `/root/login-check.py` |
| Пароль служебной учётки | `/root/.buryan-sso-check-password` (600) |
| Токен API Authentik | `/root/.authentik-api-token` (600) |
| Буферы заголовков nginx | `/etc/nginx/conf.d/00-proxy-buffers.conf` (дом и VPS) |
| Расписание копий контейнеров | `/etc/cron.d/lxc-backups` (CT 111 добавлен) |
| Ротация копий | `/opt/buryan-hub/scripts/vzdump-rotate.sh` (ежедневно 06:30) |
| Скрипты этой сессии | `ops/sso/2026-10-19/` |
---
## 8. Уроки (дополнение к аудиту)
1. **Провайдер без приложения в Authentik = отказ во входе.** Так «сломался»
Vaultwarden: провайдер есть, приложения нет.
2. **Два сервиса на одном домене должны иметь разные имена cookie.** Иначе
цикл входа, и в журнале будет невнятное «cookie signature not valid».
3. **Успешный вход может закончиться 502.** Это не ошибка входа, а маленький
буфер заголовков nginx: сессия с правами групп не влезает в 4 КБ.
4. **`AuthenticationMethod` у arr — в `config.xml`, не в базе.**
5. **Сломанное приложение в Nextcloud валит вход целиком** — проверять
`occ app:list` и журнал Nextcloud, а не только настройки OIDC.
6. **Копии нужно проверять по списку контейнеров, а не по числу архивов.**
«22 архива» звучит солидно, а CT 111 и CT 151 среди них нет.
7. **Расписание копий живёт не в Proxmox-задачах, а в `/etc/cron.d/lxc-backups`.**
Искать новые копии в `/etc/pve/jobs.cfg` бесполезно — там пусто.
8. **Ротация реже, чем делаются копии, съедает диск.** Копии ежедневно,
ротация раз в неделю — так и получилось 94%.