From e609fa8b5227a584017d8e9ef147483e1b3d50ea Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Tue, 10 Nov 2026 15:53:51 +0300 Subject: [PATCH] =?UTF-8?q?[SSO]=20=D0=97=D0=B0=D1=89=D0=B8=D1=82=D0=B0=20?= =?UTF-8?q?=D0=BE=D1=82=20=D0=BF=D0=BE=D0=B2=D1=82=D0=BE=D1=80=D0=B5=D0=BD?= =?UTF-8?q?=D0=B8=D1=8F:=20check=5Fsso=5Fproviders.py=20=D0=BF=D1=80=D0=BE?= =?UTF-8?q?=D0=B2=D0=B5=D1=80=D1=8F=D0=B5=D1=82=20=D1=83=20=D0=B2=D1=81?= =?UTF-8?q?=D0=B5=D1=85=2068=20=D0=BF=D1=80=D0=BE=D0=B2=D0=B0=D0=B9=D0=B4?= =?UTF-8?q?=D0=B5=D1=80=D0=BE=D0=B2=20grant=5Ftypes,=20signing=5Fkey,=20pr?= =?UTF-8?q?operty=5Fmappings=20=D0=B8=20redirect=5Furis,=20=D0=BF=D0=BB?= =?UTF-8?q?=D1=8E=D1=81=20https-issuer=20=D1=83=20oauth2-proxy.=20=D0=97?= =?UTF-8?q?=D0=B0=D0=B4=D0=B0=D0=BD=D0=B8=D0=B5=20Hermes=20=D0=B5=D0=B6?= =?UTF-8?q?=D0=B5=D0=B4=D0=BD=D0=B5=D0=B2=D0=BD=D0=BE=2007:05.=20=D0=A1?= =?UTF-8?q?=D0=B5=D0=B9=D1=87=D0=B0=D1=81=200=20=D0=BF=D1=80=D0=BE=D0=B1?= =?UTF-8?q?=D0=BB=D0=B5=D0=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/scripts/check_sso_providers.py | 99 ++++++++++++++++++++++++++++++ ops/sso/SSO-DUPLICATES.md | 67 ++++++++++++++++++++ 2 files changed, 166 insertions(+) create mode 100755 ops/scripts/check_sso_providers.py create mode 100644 ops/sso/SSO-DUPLICATES.md diff --git a/ops/scripts/check_sso_providers.py b/ops/scripts/check_sso_providers.py new file mode 100755 index 0000000..9b15267 --- /dev/null +++ b/ops/scripts/check_sso_providers.py @@ -0,0 +1,99 @@ +#!/usr/bin/env python3 +"""Проверка OAuth-провайдеров Authentik: ловит то, что ломало вход. + +Проверяет у каждого провайдера четыре поля, из-за которых SSO молча не работает: + * grant_types содержит authorization_code + * signing_key назначен (иначе JWKS пуст и подпись не проверить) + * property_mappings не пуст (иначе в токене нет email) + * redirect_uris не пуст + +Плюс отдельно: issuer у oauth2-proxy должен быть https (иначе прокси не тянет JWKS). + +Запуск: python3 ops/scripts/check_sso_providers.py [--fix] +""" +import json +import subprocess +import sys +import urllib.request as u + +TOK = open("/root/.authentik-api-token").read().strip() +API = "http://192.168.1.114:9000/api/v3" +HDR = {"Authorization": "Bearer " + TOK, "Content-Type": "application/json"} +DEFAULT_MAPS = ["b4789a71-b08e-49bf-8d59-00aa78bc8b76", + "3ecf71c7-0d37-436d-9b9d-0634f9abc28b", + "11eaf97b-55fd-457a-b91f-fff4cecffc4f"] + + +def api(path, method="GET", body=None): + data = json.dumps(body).encode() if body is not None else None + req = u.Request(API + path, data=data, method=method, headers=HDR) + with u.urlopen(req, timeout=25) as r: + raw = r.read() + return json.loads(raw) if raw else {} + + +def problems(p): + out = [] + gt = p.get("grant_types") or [] + if "authorization_code" not in gt: + out.append("нет authorization_code в grant_types") + if not p.get("signing_key"): + out.append("не назначен signing_key (JWKS пуст)") + if not (p.get("property_mappings") or []): + out.append("пустые property_mappings (нет email в токене)") + if not (p.get("redirect_uris") or []): + out.append("нет redirect_uris") + return out + + +def main(): + fix = "--fix" in sys.argv + d = api("/providers/oauth2/?page_size=100") + items = d.get("results") or [] + bad = [] + for p in items: + pr = problems(p) + if pr: + bad.append((p, pr)) + + print("провайдеров:", len(items), "| с проблемами:", len(bad)) + for p, pr in bad: + print(" ⛔ %-34s %s" % ((p.get("name") or "")[:34], "; ".join(pr))) + + if fix and bad: + print("\nисправляю:") + for p, pr in bad: + body = {} + gt = p.get("grant_types") or [] + if "authorization_code" not in gt: + body["grant_types"] = ["authorization_code", "refresh_token"] + if not p.get("property_mappings"): + body["property_mappings"] = DEFAULT_MAPS + if not p.get("signing_key"): + body["signing_key"] = "af0928d2-4741-4b9a-b88b-5f7015304923" + if body: + try: + api("/providers/oauth2/%s/" % p["pk"], "PATCH", body) + print(" ✓ %s" % (p.get("name") or "")[:40]) + except Exception as e: + print(" ✗ %s: %s" % ((p.get("name") or "")[:30], str(e)[:60])) + + # проверка issuer у oauth2-proxy + out = subprocess.run( + "pct exec 109 -- docker inspect oauth2-proxy-vaultwarden " + "--format '{{range .Config.Env}}{{println .}}{{end}}'", + shell=True, capture_output=True, text=True, timeout=60).stdout + issuer = "" + for line in out.splitlines(): + if line.startswith("OAUTH2_PROXY_OIDC_ISSUER_URL="): + issuer = line.split("=", 1)[1].strip() + if issuer and not issuer.startswith("https://"): + print(" ⛔ oauth2-proxy issuer не https: %s (прокси не тянет JWKS)" % issuer) + elif issuer: + print(" ✓ oauth2-proxy issuer: %s" % issuer) + + return 1 if bad else 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/ops/sso/SSO-DUPLICATES.md b/ops/sso/SSO-DUPLICATES.md new file mode 100644 index 0000000..fe3cfc3 --- /dev/null +++ b/ops/sso/SSO-DUPLICATES.md @@ -0,0 +1,67 @@ +# Почему 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` (их несколько).