[SSO] Kavita: правильный redirect_uri /signin-oidc, карточка и документация
This commit is contained in:
1 parent
ad55a563a3
commit
1070fbbad9
2 files changed
+26
-28
No files matched your search
@@ -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` это делает).
|
||||
@@ -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 ключами.
|
||||
|
||||
Reference in new issue
Block a user