[SSO] Kavita: правильный redirect_uri /signin-oidc, карточка и документация

This commit is contained in:
buryan-agent committed 2026-10-23 14:40:41 +03:00
1 parent ad55a563a3
commit 1070fbbad9
2 files changed
+26 -28

No files matched your search

+19 -26
View File
@@ -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` это делает).
+7 -2
View File
@@ -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 ключами.