66 lines
4.0 KiB
Markdown
66 lines
4.0 KiB
Markdown
# Модель аккаунтов: единая база, админ — 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 заработает везде.
|