# Модель аккаунтов: единая база, админ — 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// {"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 заработает везде.