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

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