From 6fa76c84a99ce52d8e581361d8a207bb10410db9 Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Fri, 23 Oct 2026 19:22:20 +0300 Subject: [PATCH] =?UTF-8?q?[SSO]=20Jellyfin:=20=D0=BA=D0=BD=D0=BE=D0=BF?= =?UTF-8?q?=D0=BA=D0=B0=20=D0=B2=D1=85=D0=BE=D0=B4=D0=B0=20=D1=87=D0=B5?= =?UTF-8?q?=D1=80=D0=B5=D0=B7=20Authentik=20(nginx=20sub=5Ffilter),=20?= =?UTF-8?q?=D1=80=D0=B0=D0=B7=D0=B1=D0=BE=D1=80=20EnableAuthorization?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/sso/JELLYFIN-SSO-BUTTON.md | 68 ++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 ops/sso/JELLYFIN-SSO-BUTTON.md 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`.**