[SSO] Kavita: SSO работает; библиотека создана; файлы — заглушки 1.6 КБ

This commit is contained in:
buryan-agent committed 2026-10-23 14:54:38 +03:00
1 parent c574142805
commit 2200fd1958
1 file changed
+25 -26
+25 -26
View File
@@ -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/<pk>/
{"grant_types": ["authorization_code", "refresh_token"]}
```
## Роль akadmin
Проверка: `curl -sk -o /dev/null -w '%{http_code}' "<authorize-url>"` → 302.
После входа через OIDC akadmin получил `Pleb` (не Admin): claim с группами
не смапился в роль. Варианты:
- выдать Admin вручную в интерфейсе Kavita (Пользователи → akadmin → роль);
- либо донастроить `rolesClaim` (в токене должен быть claim `groups`
со значением `kavita-Admin`).