Files
buryan-wiki/SSO.md
T

11 KiB
Raw Blame History

Единый вход: фактическая проверка (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 не мог проверить подпись.

Исправление:

PATCH /providers/oauth2/{pk}/
{"signing_key": "<pk сертификата authentik Self-signed Certificate>"}

После назначения ключа JWKS отдаёт 1 ключ, подпись проверяется.

Правило: при создании OAuth2-провайдера через API всегда указывать signing_key, иначе вход падает на проверке подписи.