68 lines
3.5 KiB
Markdown
68 lines
3.5 KiB
Markdown
# Почему SSO ломался у 16 сервисов (10.11.2026)
|
||
|
||
## Наблюдение владельца
|
||
|
||
> «Ну у нас очень много дублей теперь)»
|
||
|
||
Точнее — **очень много ручных экземпляров одного механизма**. За сегодня в одном
|
||
только SSO нашлось **16 провайдеров с четырьмя одинаковыми поломками**.
|
||
|
||
## Что именно было сломано (у всех 16)
|
||
|
||
| Поле | Было | Последствие |
|
||
|---|---|---|
|
||
| `grant_types` | `[]` | ошибка `invalid_request` на входе |
|
||
| `signing_key` | пусто | JWKS `{}` → подпись токена не проверяется |
|
||
| `property_mappings` | пусто | в токене нет email → `could not get claim "email"` |
|
||
| issuer у прокси | `http://…` | прокси не тянет JWKS → ждёт HS256 |
|
||
|
||
Каждый пункт по отдельности ломал вход. У Vaultwarden сработали все четыре
|
||
последовательно — поэтому понадобилось четыре итерации.
|
||
|
||
## Почему так вышло
|
||
|
||
68 OAuth-провайдеров созданы **вручную**, копированием, без шаблона и без
|
||
проверки после обновления Authentik (сейчас 2026.8.5). Где-то поля не
|
||
заполнили — и никто не заметил, потому что панель не показывает проблему,
|
||
а вход просто не работает.
|
||
|
||
Это ровно та же болезнь, что:
|
||
* 9 ботов-аккаунтов вместо двух,
|
||
* 5 путей уведомлений,
|
||
* 2 индекса RAG,
|
||
* 3 недельных отчёта,
|
||
* oauth2-proxy без compose (создан `docker run`).
|
||
|
||
## Что сделано, чтобы не повторилось
|
||
|
||
### Проверка `ops/scripts/check_sso_providers.py`
|
||
|
||
Проверяет у всех 68 провайдеров четыре критичных поля и issuer у прокси:
|
||
|
||
```
|
||
провайдеров: 68 | с проблемами: 0
|
||
✓ oauth2-proxy issuer: https://authentik.buryans.ru/application/o/vaultwarden-sso/
|
||
```
|
||
|
||
Есть режим `--fix` — чинит найденное.
|
||
|
||
### Задание Hermes `sso-providers`
|
||
|
||
Ежедневно в **07:05**. Если появится новый провайдер с пустыми полями —
|
||
это станет событием в шине, а не тихой поломкой входа.
|
||
|
||
## Правило на будущее
|
||
|
||
**Новый OAuth-провайдер в Authentik** создаётся копированием эталона
|
||
(Element) или через blueprint — но не «с нуля руками». После создания
|
||
обязательно прогнать `check_sso_providers.py`.
|
||
|
||
## Что осталось
|
||
|
||
1. **Проверить вход во все 16 сервисов** — они были сломаны, но вы замечали
|
||
только Vault.
|
||
2. **`oauth2-proxy-vaultwarden` без compose** — при пересоздании контейнера
|
||
настройки потеряются. Файл окружения сохранён в `/root/oauth2-vault.env`,
|
||
но нужен compose.
|
||
3. Проверить, нет ли той же истории в других `oauth2-proxy` (их несколько).
|