diff --git a/ops/services/cards/kavita.md b/ops/services/cards/kavita.md index 00f0198..548a027 100644 --- a/ops/services/cards/kavita.md +++ b/ops/services/cards/kavita.md @@ -2,39 +2,38 @@ | Параметр | Значение | |---|---| -| Группа | медиа / книги | | CT | 111 (media-stack), `192.168.1.240:5000` | | Домен | `https://kavita.buryans.ru` | -| Вход | **Authentik OIDC** (группа `kavita-Admin` → роль Admin) | -| Bootstrap | локальный `roman` (аварийный ключ, пароль в `/root/.services-admin-password`) | +| Вход | **Authentik OIDC** (работает — akadmin вошёл 23.10) | +| Библиотека | `/library` (Calibre-каталог CT111), тип «Книги» | +| Bootstrap | локальный `roman` (аварийный ключ, `/root/.services-admin-password`) | -## SSO +## SSO — что важно знать -- Провайдер 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` +- redirect_uri: **`https://kavita.buryans.ru/signin-oidc`** +- провайдер `kavita` в Authentik, `grant_types = [authorization_code, refresh_token]` +- роли: `rolesClaim=groups`, `rolesPrefix=kavita-` +- группы: `kavita-Admin` (akadmin), `kavita-User`, `family` -## Ловушки +## Создание библиотеки через API (ловушки) -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` это делает). +1. **`POST /api/Library/create`** — не `/add` и не `/save`. +2. Обязательны все поля: `name`, `type` (2 = Book), `folders`, **`fileGroupTypes` + массивом чисел**, `excludePatterns`, `metadataProvider` (валидно только **2**). +3. `fileGroupTypes`: `1` = архивы (cbz/cbr), **`2` = epub, `3` = pdf**. + С `[1]` Kavita видит epub-файлы, но пишет «unable to parse», и серий — 0. +4. Удаление: `DELETE /api/Library/delete?libraryId=1` (не `/api/Library/1`). -## Ловушка №5: пустой grant_types (23.10) +## Почему сейчас 0 серий (честно) -Провайдер, созданный через API Authentik, получает `grant_types: []`. -Симптом: «Ошибка URI перенаправления» / красный тост `invalid_request`. -Лечение: +Файлы в `/opt/books/library` — **заглушки по 1.6 КБ** (13 epub). Kavita +корректно отвечает «Unable to parse any meaningful information out of file». +То есть проблема не в Kavita, а в том, что реальных книг в каталоге нет. -``` -PATCH /api/v3/providers/oauth2// -{"grant_types": ["authorization_code", "refresh_token"]} -``` +## Роль akadmin -Проверка: `curl -sk -o /dev/null -w '%{http_code}' ""` → 302. +После входа через OIDC akadmin получил `Pleb` (не Admin): claim с группами +не смапился в роль. Варианты: +- выдать Admin вручную в интерфейсе Kavita (Пользователи → akadmin → роль); +- либо донастроить `rolesClaim` (в токене должен быть claim `groups` + со значением `kavita-Admin`).