diff --git a/ops/sso/ONE-LOGIN.md b/ops/sso/ONE-LOGIN.md new file mode 100644 index 0000000..2861fd4 --- /dev/null +++ b/ops/sso/ONE-LOGIN.md @@ -0,0 +1,59 @@ +# Один вход вместо двух (10.11.2026) + +## Задача + +Владелец попросил убрать «родной вход»: сейчас в части сервисов два экрана — +прокси, затем форма самого приложения. + +## Сделано + +### 1. headscale.buryans.ru — закрыт web-корень + +`location = /` отдавал `302 /windows` (страница-заглушка). Заменено на `410`. +API для узлов работает без изменений: + +``` +/ → 410 +/health → 200 +/key → 200 +``` + +Узлы подключаются по путям API, их это не затрагивает. + +### 2. Grafana — только SSO + +Оказалось, OIDC в Grafana **уже был настроен** (провайдер `grafana-oidc`, +`GF_AUTH_GENERIC_OAUTH_*`), а nginx уже ходил напрямую в Grafana, минуя +`oauth2-proxy`. «Два входа» — это кнопка Authentik **и** форма логина на +одной странице. + +Добавлено: `GF_AUTH_DISABLE_LOGIN_FORM=true`. + +Проверка: + +``` +/login → 200, форма логина: убрана, кнопка Authentik: есть +``` + +Аварийный вход остался: `admin` через API (`GF_AUTH_BASIC_ENABLED` по умолчанию +включён), плюс откат — вернуть переменную в `/opt/grafana/docker-compose.yml`. + +## Что нельзя перевести на SSO-only + +| Сервис | OIDC в приложении | Решение | +|---|---|---| +| **monica** | нет | либо свой вход (1 экран), либо прокси (2 экрана) | +| **uptime kuma 2.5.8** | нет | то же | +| **adguard** | нет | свой вход — единственный | +| **docmost 0.97.0** | **есть** (миграция `sso-auth.js`) | можно перевести, нужен провайдер + env | +| **metrics** | зависит от приложения за прокси | проверить отдельно | + +Для приложений без OIDC «убрать родной вход» = убрать SSO совсем. +Это выбор владельца: один вход без SSO или два входа с SSO. + +## Следующий шаг (по решению владельца) + +1. **Docmost** — перевести на OIDC (провайдер в Authentik + переменные + `OIDC_ENABLED/CLIENT_ID/CLIENT_SECRET/ISSUER`). +2. **Monica, Kuma, AdGuard** — убрать `oauth2-proxy` из пути, оставить + родной вход (один экран, без SSO).