diff --git a/ops/sso/JELLYFIN-SSO-BUTTON.md b/ops/sso/JELLYFIN-SSO-BUTTON.md new file mode 100644 index 0000000..19d4f91 --- /dev/null +++ b/ops/sso/JELLYFIN-SSO-BUTTON.md @@ -0,0 +1,68 @@ +# Jellyfin: кнопка «Войти через Authentik» (23.10) + +## Итог + +На странице входа Jellyfin появляется зелёная кнопка +**«Войти через Authentik»** → `/sso/OID/start/authentik`. +Локальная форма остаётся как резервный вход. + +## Как сделано + +Плагин SSO-Auth 5.1.1 на Jellyfin 12 **не отрисовывает кнопку** +(в `index.html` нет ни одного упоминания `sso`), хотя API плагина работает: +`/sso/OID/GetNames` → `["authentik"]`. + +Поэтому кнопка вставляется на уровне nginx на VPS: + +```nginx +# jellyfin-sso-button: кнопка входа через Authentik +sub_filter_once off; +sub_filter_types text/html; +sub_filter '' ''; +``` + +Скрипт ищет форму входа и вставляет перед ней ссылку на SSO; проверяет +`location.hash` и наличие `.manualLoginForm`, повторяет попытку каждые 600 мс +(страница — SPA). + +Бэкап конфига перед правкой: +`/etc/nginx/conf.d/buryans-all.conf.bak-sso-btn-20261023_161039`. + +## Важная ловушка: `EnableAuthorization` — это НЕ авто-редирект + +В плагине SSO-Auth флаг **`EnableAuthorization`** означает +**«новый пользователь требует одобрения администратором»**. +Мы включили его, ожидая авто-переход на SSO — и вход сломался: +пользователь не был «одобрен», а локальная форма оставалась единственным +выходом. Флаг возвращён в `false`. + +Вывод: **не отключать локальный вход, пока SSO не проверен на живом входе.** + +## Что проверено + +| Проверка | Результат | +|---|---| +| `/sso/OID/start/authentik` | 302 → Authentik | +| `/sso/OID/GetNames` | `["authentik"]` | +| Вход по ссылке SSO | **владелец вошёл успешно** | +| Вход по паролю (akadmin) | 200 OK | +| Кнопка в index.html | есть (6244 байта, маркер `authentik-login`) | +| `nginx -t` | успешно | +| media / hub | 302 (работают) | + +## Если понадобится убрать кнопку + +```bash +ssh root@193.233.210.184 +cp /etc/nginx/conf.d/buryans-all.conf.bak-sso-btn-20261023_161039 \ + /etc/nginx/conf.d/buryans-all.conf +nginx -t && systemctl reload nginx +``` + +## Ошибка, которую поймали по пути + +Первый заход «улучшить» инъекцию заменил блок по неверной границе и оставил +висящий символ — `nginx -t` выдал `unexpected "d"` на строке 341. +Сайты при этом продолжали работать (старые воркеры nginx), но конфиг был +невалиден. Восстановили из бэкапа и повторили проверенный вариант. +**Правило: перед любой правкой nginx — бэкап, после — `nginx -t`.**