diff --git a/ops/services/cards/kavita.md b/ops/services/cards/kavita.md index aeb242c..210eab9 100644 --- a/ops/services/cards/kavita.md +++ b/ops/services/cards/kavita.md @@ -1,34 +1,27 @@ -# kavita +# Kavita | Параметр | Значение | |---|---| -| Группа | книги | -| Критичность | normal | -| CT | 111 (reading-lxc), адрес `192.168.1.240` | -| Порт | `5000` | -| Образ | `jvmilazz0/kavita:latest` | -| Библиотека | `/opt/books/library` (только чтение) | +| Группа | медиа / книги | +| CT | 111 (media-stack), `192.168.1.240:5000` | +| Домен | `https://kavita.buryans.ru` | +| Вход | **Authentik OIDC** (группа `kavita-Admin` → роль Admin) | +| Bootstrap | локальный `roman` (аварийный ключ, пароль в `/root/.services-admin-password`) | -## Что это +## SSO -Читалка комиксов, манги и книг в браузере. Понимает epub, cbz, pdf; -умеет OPDS для читалок. Дополняет Calibre-Web: тот про книги, -Kavita — про серии и графику. - -## Как проверить - -```bash -curl -s -o /dev/null -w '%{http_code}' http://192.168.1.240:5000/ # 200 -``` - -## Первый запуск - -1. Открыть `http://192.168.1.240:5000`, создать администратора. -2. Библиотека → «Add Library» → тип «Books» → путь `/library`. -3. Дождаться сканирования (21 epub, 4 fb2 уже внутри). +- Провайдер Authentik: `kavita` +- **redirect_uri: `https://kavita.buryans.ru/signin-oidc`** (не `/oidc/callback`!) +- Внутренний: `https://192.168.1.240:5000/signin-oidc` +- Роли: `rolesClaim=groups`, `rolesPrefix=kavita-` +- Группы: `kavita-Admin` (akadmin), `kavita-User`, `family` ## Ловушки -1. **CT111 — это `192.168.1.240`**, не `.111`. -2. Библиотека подключена **только на чтение** — Kavita не испортит файлы Calibre. -3. Конфиг в `/opt/kavita/config` попадает в `vzdump`, но не в пофайловый бэкап. +1. **Redirect URI** — Kavita использует `/signin-oidc`. Точное значение: + `curl -sk -D - https://kavita.buryans.ru/oidc/login | grep -i location` +2. **`POST /api/Settings/oidc` не существует** (404). Настройки сохраняются + только полным объектом: `POST /api/Settings` со всеми 29 ключами. +3. **После сохранения `enabled: false`**, пока контейнер не перезапущен. +4. `rolesClaim=groups` требует, чтобы Authentik отдавал `groups` в токене + (scope `profile` это делает). diff --git a/ops/sso/ACCOUNTS-MODEL.md b/ops/sso/ACCOUNTS-MODEL.md index d91d809..2e96253 100644 --- a/ops/sso/ACCOUNTS-MODEL.md +++ b/ops/sso/ACCOUNTS-MODEL.md @@ -24,13 +24,18 @@ ## Kavita: как устроен SSO -- Провайдер в Authentik: `kavita`, redirect `https://kavita.buryans.ru/oidc/callback` +- Провайдер в 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-` -**Ловушка:** после сохранения настроек OIDC Kavita показывает `enabled: false`, +**Ловушка №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 ключами.