Files
buryan-infra/docs/CENTRAL-AUTH.md
T
buryan-agent e202f8ce6c Централизация входа: Jellyfin через SSO-плагин, Vaultwarden через SSO и заготовки
Jellyfin: поставлен плагин SSO Authentication 5.1.1, создан провайдер
jellyfin-sso, настроен вход (SchemeOverride=https — иначе адрес возврата
шёл как http и Authentik отказывал), домен media переведён напрямую,
8 пользователей заведены, akadmin — администратор.

Vaultwarden: включён админ-токен, созданы заготовки учёток в vaultwarden_db —
SSO привязывает их по почте (штатный приём), мастер-пароль остаётся.

users-sync.sh: одной командой заводит всех из Authentik в Gitea, Nextcloud,
Linkding, Navidrome, Jellyfin, Vaultwarden. Идемпотентно.

Plex и Overseerr: OIDC нет; варианты (PlexSSO, Seerr) описаны в docs.
2026-10-19 15:06:43 +03:00

107 lines
6.8 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.
# Централизация входа: Jellyfin, Vaultwarden, Plex, Overseerr
Что сделано и какие есть варианты. Источник правды для пользователей —
**Authentik** (база на CT 151). Общий скрипт: `/root/users-sync.sh`
(копия в `ops/sso/users-sync.sh`).
---
## 1. Сводка: как устроен вход сейчас
| Служба | Вход | Пользователи |
|---|---|---|
| **Jellyfin** (`media`) | **плагин SSO → Authentik** (OIDC) | 8 человек заведены, `akadmin` — админ |
| **Vaultwarden** (`vault`) | **родной SSO → Authentik** + мастер-пароль | 8 заготовок учёток |
| **Plex** (`plex`) | вход plex.tv (свой) | аккаунты Plex |
| **Overseerr** (`ombi`) | вход через Plex (свой) | подтягиваются из Plex |
Скрипт `users-sync.sh` заводит людей сразу в Gitea, Nextcloud, Linkding,
Navidrome, Jellyfin и Vaultwarden. Остальные (Paperless, Firefly, Mealie,
Immich) создают учётку сами при первом входе через единый вход.
---
## 2. Jellyfin — сделано
Jellyfin не умеет OIDC сам, но для него есть плагин
[SSO Authentication](https://github.com/K0lin/jellyfin-plugin-sso) (форк
9p4, поддерживает Authentik).
| Что | Значение |
|---|---|
| Плагин | `SSO Authentication 5.1.1` (для Jellyfin 12; для 10.8–10.11 нужен 5.0.x) |
| Файлы | `/opt/jellyfin/config/plugins/SSO-Auth/` (CT 103) |
| Провайдер Authentik | `jellyfin-sso`, приложение `jellyfin-sso` |
| Адрес возврата | `https://media.buryans.ru/sso/OID/redirect/authentik` |
| Настройка входа | `OidEndpoint=https://authentik.buryans.ru/application/o/jellyfin-sso`, `SchemeOverride=https` |
| RBAC | выключен (`EnableAuthorization=false`) — пускаем всех из Authentik |
| Домен | `media` ведёт прямо на `192.168.1.103:8096`, прокси Authentik снят |
Важные тонкости:
* **`SchemeOverride=https`** — без него плагин строит адрес возврата как
`http://…`, и Authentik отвечает «Redirect URI Error» (проверено).
* Пользователей лучше заводить заранее: плагин привязывается к **имени**
учётки, а не к почте.
* Вход завершается страницей «Logging in…» — это нормально, дальше работает
JS (Jellyfin 12 + Quick Connect).
## 3. Vaultwarden — сделано
| Что | Значение |
|---|---|
| SSO | `SSO_ENABLED=true`, `SSO_AUTHORITY=…/application/o/vaultwarden/` |
| Привязка | `SSO_SIGNUPS_MATCH_EMAIL` (по умолчанию `true`) — учётка ищется по почте |
| Учётные записи | 8 «заготовок» без ключей (`akey`, `private_key` пустые) |
| Мастер-пароль | остаётся — так устроен Vaultwarden, SSO его не заменяет |
| Админ-токен | `/root/.vaultwarden-admin-token` (600), панель `/admin` |
Заготовки — штатный приём: при первом входе через SSO такая учётка
привязывается, человек задаёт мастер-пароль и получает доступ.
## 4. Plex — варианты (не внедрено)
У Plex нет ни OIDC, ни доверия заголовкам: вход только через plex.tv.
Что реально можно сделать:
| Вариант | Суть | Цена |
|---|---|---|
| **PlexSSO** ([drkno/PlexSSO](https://github.com/drkno/PlexSSO)) | прокси перед Plex, который сам делает OIDC и отдаёт Plex уже авторизованный запрос; умеет сопоставлять пользователей | отдельный сервис, настройка сопоставления; ломается при смене API Plex |
| **Plex Home** (штатно) | несколько профилей внутри одного аккаунта plex.tv; переключение профиля без пароля | не централизовано, но один вход на устройство |
| Список сетей без входа | Plex пускает запросы от прокси как владельца | все под одним аккаунтом, без разграничения |
Мой вывод: для Plex честнее оставить его собственный вход — это и есть один
вход, а не двойной.
## 5. Overseerr — варианты (не внедрено)
Overseerr — вход только через Plex (или локальные пароли), OIDC нет.
Варианты:
| Вариант | Суть | Цена |
|---|---|---|
| Оставить как есть | вход через Plex, учётки подтягиваются сами | отдельный вход (Plex), но один |
| **Перейти на Seerr** | Overseerr и Jellyseerr объединились в [Seerr](https://github.com/seerr-team/seerr); поддерживает Jellyfin, Plex и Emby | миграция базы и настроек; зато вход через Jellyfin, а у Jellyfin теперь SSO |
| Локальные пароли | включить локальный вход, заводить людей скриптом | не SSO, пароли вручную |
Сейчас Overseerr открывается на `/setup` — он вообще не настроен. Настройка
требует входа через Plex: это действие владельца.
---
## 6. Как добавить нового человека
1. Создать в Authentik (группы: `family` и нужные служебные).
2. Запустить `bash /root/users-sync.sh` — заведёт в Gitea, Nextcloud,
Linkding, Navidrome, Jellyfin, Vaultwarden.
3. Остальные службы создадут учётку сами при первом входе.
## 7. Что важно помнить
* Почта в Authentik должна быть **уникальной** — Gitea не принимает дубли
(у `akadmin` и `roman` она была одна, поправили).
* В Jellyfin `akadmin` сделан администратором; `root` с паролем остаётся
запасным входом.
* В Vaultwarden мастер-пароль нужен всегда — это не недоделка, а устройство
продукта.