Files
buryan-wiki/SSO.md
T

263 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Единый вход: фактическая проверка (21.10.2026)
Проверено не по документации, а запросами к каждому домену:
куда ведёт первый редирект, есть ли признаки OIDC.
## Итог
| Тип | Сколько | Домены |
|---|---|---|
| **SSO через forward-auth** | **19** | backup, bazarr, books, docs, element, finance, flow, grocy, home, hub, links, music, news, openclaw, prowlarr, radarr, rss, sonarr, status |
| **OIDC внутри сервиса** | **3** | vikunja, homebox, meals |
| **Свой вход** | **10** | adguard, files (Nextcloud), matrix, n8n, ombi, plex, immich, sync (Syncthing), vault (Vaultwarden), headscale |
| **Собственный UI Authentik** | 1 | admin |
| **Редиректы на другие домены** | 4 | chat→element, recipes→meals, requests→ombi, turn→call |
**Всего под SSO: 22 из 33 доменов с сервисами.**
## Где я ошибался раньше
Отчёт `ops/registry/COVERAGE.md` строился по строкам портов в реестре.
У сервисов внутри CT портов нет — и они попали в «без SSO» ошибочно.
Фактически большинство из них уже за oauth2-proxy.
## Что действительно без SSO
| Сервис | Почему |
|---|---|
| `plex` | свой вход, OIDC не поддерживает |
| `immich` | свой вход (API 401) |
| `syncthing` | свой вход |
| `vaultwarden` | свой вход (сознательно: хранилище паролей) |
| `adguard` | свой вход |
| `nextcloud` (files) | свой вход, OIDC-плагин не установлен |
| `n8n` | свой вход + свой `hub-login` |
| `ombi` | свой вход |
| `matrix` | отдельная система, свой вход — **так и задумано** |
| `headscale` | служебный |
## Gitea
Кнопка Authentik есть, локальный вход работает. Проверено владельцем:
вход через SSO работает.
## Вывод
Единый вход покрывает **основную часть сервисов**. Оставшиеся 10 —
либо сознательно отдельные (Matrix, Vaultwarden), либо не поддерживают OIDC
(Plex, Immich, Syncthing, Ombi).
---
# SSO: Memos и Stirling PDF (итог)
## Memos — нативный SSO
Memos умеет OIDC через своего провайдера идентификации.
| Что | Значение |
|---|---|
| Провайдер в Authentik | `provider-memos-sso`, приложение `memos-sso` |
| Redirect URI | `https://memo.buryans.ru/auth/callback` |
| IdP в Memos | `idp` таблица: `uid=authentik`, `type=OAUTH2` |
| Админ Memos | `admin` (восстановлен через SQL) |
| Прокси | **остановлен**, домен идёт напрямую в Memos |
Проверка: `https://memo.buryans.ru` → 200, на странице есть кнопка SSO.
## Stirling PDF — SSO через прокси
| Что | Значение |
|---|---|
| Провайдер | `provider-stirling`, приложение `stirling` |
| Прокси | `oauth2-proxy-stirling` на 8090 |
| Собственный вход | **отключён**: `SECURITY_ENABLELOGIN=false` |
Проверка: `https://pdf.buryans.ru` → 302 на Authentik, после входа — сразу приложение.
## Ловушки (все три стоили времени)
1. **API Memos игнорирует поля IdP.** POST `/api/v1/identity-providers`
создаёт запись с `type=TYPE_UNSPECIFIED`, `title=""`, `config={}`.
Рабочий способ — прямая вставка в таблицу `idp`.
2. **SQL-пароль в кавычках.** `sqlite3` с двойными кавычками падает:
`no such column: "$2a$12$..."`. Только одинарные кавычки, через файл.
3. **`pct exec … < файл` не видит хостовый файл.** Сначала `pct push`
в контейнер, потом читать.
## Итог по SSO
| Тип | Кол-во |
|---|---|
| forward-auth (oauth2-proxy) | 20 |
| OIDC внутри сервиса | 4 (vikunja, homebox, meals, memos) |
| свой вход | 9 |
## Закрытие прямого доступа (важно)
Пока порт приложения открыт в LAN, SSO можно обойти: `http://192.168.1.110:8089`
открывался мимо прокси. Исправлено:
| Сервис | Было | Стало |
|---|---|---|
| Stirling | `0.0.0.0:8089` | `127.0.0.1:8089` (только для прокси) |
| oauth2-proxy-stirling | порт 8090 через mapping | `network_mode: host`, слушает 8090 |
| oauth2-proxy-memos | порт 5231 | остановлен, не нужен (нативный SSO) |
Проверка:
```
8089 закрыт (в обход SSO не зайти)
8090 открыт (это прокси, отдаёт 302 на Authentik)
pdf.buryans.ru → 302 → Authentik
memo.buryans.ru → 200, кнопка Authentik
```
## Ловушка
Если убрать `ports` у сервиса, но оставить ключ `ports:` пустым, compose
падает: `services.X.ports must be a array`. Удалять нужно саму строку.
## Настоящая причина «SSO нет»: порт 80
Домашний nginx отдавал на порту 80 **дефолтный сервер**
(«Welcome to nginx!»), потому что для новых доменов не было блока `listen 80`.
Заходишь по `http://pdf.buryans.ru` — HTTPS, прокси и SSO не участвуют.
Исправлено: добавлены блоки с редиректом.
```
http://pdf.buryans.ru → 301 https://pdf.buryans.ru/
http://memo.buryans.ru → 301 https://memo.buryans.ru/
https://pdf.buryans.ru → 302 https://authentik.buryans.ru/...
```
## Правило при публикации нового домена
1. VPS: блок `listen 80` с ACME + 301 на https.
2. Домашний nginx: **тоже** блок `listen 80` с 301 на https.
3. Только потом `listen 443` с прокси на SSO.
4. Проверять **оба** протокола: `http://` и `https://`.
Без шага 2 домен открывается по HTTP в обход всего.
---
# Vikunja: ошибка «поставщик OpenID не предоставил email»
## Симптом
После входа через Authentik Vikunja показывает:
> Поставщик OpenID не предоставил адрес электронной почты.
## Причина
В переменных Vikunja стояло:
```
VIKUNJA_AUTH_OPENID_PROVIDERS_AUTHENTIK_SCOPE=openid
```
Только `openid` — без `email` и `profile`. Authentik физически не отдавал
адрес почты, потому что его не запрашивали.
Скоуп в провайдере Authentik при этом был правильный
(`email`, `profile`, `openid`) — проблема была на стороне клиента.
## Исправление
```
VIKUNJA_AUTH_OPENID_PROVIDERS_AUTHENTIK_SCOPE=openid profile email
```
## Ловушка
**Vikunja запущена через `docker run`, а не compose.** В
`/opt/lifestyle-lxc/docker-compose.yml` её нет — правка compose ничего
не даёт. Пересоздавать нужно через `docker run` с теми же томами:
```
-v /opt/lifestyle-lxc/vikunja/files:/app/vikunja/files
-v /opt/lifestyle-lxc/vikunja/db:/db
-p 9285:3456
```
## Проверка
```
docker inspect vikunja | grep SCOPE → openid profile email
локально: 200, домен: 200
```
---
# SSO для Memos и Stirling PDF
## Схема
Как у остальных сервисов: oauth2-proxy перед приложением.
```
интернет → VPS nginx (443) → домашний LAN
→ oauth2-proxy-memos :5231 → memos :5230
→ oauth2-proxy-stirling :8090 → stirling :8089
```
## Что сделано
| Шаг | Результат |
|---|---|
| Провайдеры в Authentik | `provider-memos`, `provider-stirling` |
| Приложения | `memos`, `stirling` |
| Redirect URI | `https://memo.buryans.ru/oauth2/callback`, `https://pdf.buryans.ru/oauth2/callback` |
| Контейнеры прокси | `oauth2-proxy-memos` (5231), `oauth2-proxy-stirling` (8090) |
| Домашний nginx | домены → прокси, а не напрямую |
| VPS nginx | проксирует на порты SSO, а не на приложение |
## Проверка
```
memo.buryans.ru → 302 https://authentik.buryans.ru/application/o/authorize/?client_id=KqfJv…
pdf.buryans.ru → 302 https://authentik.buryans.ru/application/o/authorize/?client_id=BWqb2…
```
## Ловушки
1. **Недостаточно закрыть домашний nginx**: VPS проксировал напрямую на порт
приложения и обходил SSO. Менять надо **оба** nginx.
2. Провайдер в Authentik требует `authorization_flow` и `invalidation_flow`,
а `redirect_uris` — список объектов, не строка.
3. oauth2-proxy в CT110 требует `DOCKER_API_VERSION=1.41`.
## Инцидент: 500 на /oauth2/callback
**Симптом:** после входа в Authentik прокси отдавал 500
«Внутренняя ошибка сервера».
**В логах:**
```
Error redeeming code during OAuth2 callback:
could not verify id_token: failed to verify signature
```
**Причина:** провайдеры, созданные через API, получили
`signing_key = None`. Authentik не подписывал id_token известным ключом,
и oauth2-proxy не мог проверить подпись.
**Исправление:**
```python
PATCH /providers/oauth2/{pk}/
{"signing_key": "<pk сертификата authentik Self-signed Certificate>"}
```
После назначения ключа JWKS отдаёт 1 ключ, подпись проверяется.
**Правило:** при создании OAuth2-провайдера через API **всегда** указывать
`signing_key`, иначе вход падает на проверке подписи.