[SSO] Jellyfin: кнопка входа через Authentik (nginx sub_filter), разбор EnableAuthorization

This commit is contained in:
buryan-agent committed 2026-10-23 19:22:20 +03:00
1 parent acb717d66a
commit 6fa76c84a9
1 file changed
+68
+68
View File
@@ -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 '</body>' '<script>…</script></body>';
```
Скрипт ищет форму входа и вставляет перед ней ссылку на 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`.**