4.0 KiB
Модель аккаунтов: единая база, админ — 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, redirecthttps://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 у всех четырёх.
Что дальше
- Audiobookshelf: включить OIDC (нужен рабочий API-токен; текущий не принят).
- Docmost/Monica/Podfetch: либо дождаться встроенного OIDC/enterprise, либо оставить как есть — снаружи вход уже через Authentik.
- Локальные bootstrap-ключи сменить/удалить, когда SSO заработает везде.