Files
buryan-infra/ops/sso/ACCOUNTS-MODEL.md
T

4.0 KiB
Raw Blame History

Модель аккаунтов: единая база, админ — akadmin

Дата: 23.10.2026.

Правило

Администратор везде — akadmin через Authentik. Локальные аккаунты допустимы только как аварийный ключ для настройки сервиса, пока в нём не включён SSO. Пароли таких ключей — в /root/.services-admin-password (один на все, 0600).

Что сделано

Сервис Аккаунт Через Authentik? Примечание
Authentik akadmin — главный админ, владелец
Kavita akadmin (SSO) ✅ OIDC включён группа kavita-Admin даёт роль Admin
Kavita roman ❌ локальный bootstrap-ключ, не для людей
Docmost akadmin@buryans.local ⚠️ локальный (в free нет OIDC) вход закрыт oauth2-proxy (Authentik), но внутри Docmost свой аккаунт
Monica akadmin@buryans.local ⚠️ локальный OAuth в Monica ограничен, пока локально
Audiobookshelf root ❌ локальный bootstrap; OIDC — следующий шаг
NetBox SSO ✅ через oauth2-proxy + заголовок вход только через Authentik
Podfetch SSO ✅ через oauth2-proxy внутри Basic Auth

Kavita: как устроен SSO

  • Провайдер в Authentik: kavita, redirect https://kavita.buryans.ru/signin-oidc
  • Приложение привязано к группам: family, authentik Admins, kavita-User, kavita-Admin
  • akadmin добавлен в kavita-Admin → при входе получает роль Admin
  • В Kavita: provisionAccounts, rolesClaim=groups, rolesPrefix=kavita-

Ловушка №1 (из-за неё была ошибка «URI перенаправления»): Kavita присылает redirect_uri = https://kavita.buryans.ru/signin-oidc, а не /oidc/callback. Точный адрес видно в заголовке Location при запросе GET /oidc/login. Регистрировать нужно именно /signin-oidc.

Ловушка №2: после сохранения настроек OIDC Kavita показывает enabled: false, пока контейнер не перезапущен. После docker restart kavita → enabled: true. Кроме того, POST /api/Settings/oidc не существует (404) — настройки сохраняются только полным объектом: POST /api/Settings со всеми 29 ключами.

Главная ловушка: пустой grant_types (23.10)

Провайдеры, созданные через API, рождаются с grant_types: []. Из-за этого Authentik отвечает:

  • на /authorize → invalid_request: The request is otherwise malformed;
  • в логах → Invalid grant_type for provider.

Проявилось как «Ошибка URI перенаправления» и красный тост в Kavita, хотя redirect_uri был верный.

Лечение: PATCH /providers/oauth2/<pk>/ {"grant_types": ["authorization_code","refresh_token"]}.

Поймано у четырёх провайдеров, созданных скриптом: kavita, netbox, docmost, podfetch. После правки authorize отдаёт 302 у всех четырёх.

Что дальше

  1. Audiobookshelf: включить OIDC (нужен рабочий API-токен; текущий не принят).
  2. Docmost/Monica/Podfetch: либо дождаться встроенного OIDC/enterprise, либо оставить как есть — снаружи вход уже через Authentik.
  3. Локальные bootstrap-ключи сменить/удалить, когда SSO заработает везде.