Files
buryan-infra/ops/sso/JELLYFIN-SSO-BUTTON.md
T

3.1 KiB
Raw Blame History

Jellyfin: кнопка «Войти через Authentik» (23.10, финальная версия)

Как работает

Кнопка — отдельный JS-файл, который nginx подставляет в index.html:

/var/www/sso-button.js                — сам скрипт (на VPS)
/sso-sso-button.js                    — отдаётся nginx как статика
<script src="/sso-sso-button.js" defer></script>  — вставляется в </body>

Скрипт показывает зелёную кнопку по центру сверху, когда открыта страница входа (в адресе есть login или на странице есть поле пароля). Ссылка ведёт на /sso/OID/start/authentik. Локальная форма остаётся.

Конфиг (внутри server-блока media.buryans.ru)

proxy_set_header Accept-Encoding "";
# jellyfin-sso-button
sub_filter_once off;
sub_filter '</body>' '<script src="/sso-sso-button.js" defer></script></body>';
location = /sso-sso-button.js {
    alias /var/www/sso-button.js;
    default_type application/javascript;
    add_header Cache-Control "no-cache";
}

Три причины, почему первые попытки не работали

  1. EnableAuthorization — не авто-редирект, а «требовать одобрения новым пользователям». Включили → вход сломался, потому что пользователь не был одобрен. Флаг возвращён в false.
  2. Инлайн-скрипт через sub_filter вставлялся, но кнопка крепилась к body.parentNode (то есть вне body) и была невидима.
  3. gzip. Без proxy_set_header Accept-Encoding "" nginx не мог подменить сжатый ответ — браузер получал исходный HTML.

Плюс отдельная ошибка: правка конфига «по границе блока» оставила висящий символ, nginx -t упал с unexpected "d". Конфиг восстановлен из бэкапа.

Проверка

curl -sk https://media.buryans.ru/web/index.html | grep -c sso-sso-button.js   # 1
curl -sk -o /dev/null -w '%{http_code}\n' https://media.buryans.ru/sso-sso-button.js  # 200

Откат

ssh root@193.233.210.184
cp /etc/nginx/conf.d/buryans-all.conf.bak-inline-* /etc/nginx/conf.d/buryans-all.conf
nginx -t && systemctl reload nginx

Правила, которые вывел

  • перед правкой nginx — бэкап, после — nginx -t;
  • не отключать локальный вход, пока SSO не проверен на живом входе;
  • sub_filter требует отключённого Accept-Encoding;
  • скрипт для подмены держать отдельным файлом — никаких кавычек внутри директив nginx.