From 7b7f688c03d6f72b82696954f01e7fa3d5dec6d9 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Fri, 20 Nov 2026 21:01:03 +0300 Subject: [PATCH] [HOME] Fix SSO forwarded headers for Home/Immich; document rollback --- ops/sso/SSO-HOME-IMMICH-2026-11-20.md | 64 +++++++++++++++++++++++++++ ops/sso/fix_sso_headers.py | 60 +++++++++++++++++++++++++ 2 files changed, 124 insertions(+) create mode 100644 ops/sso/SSO-HOME-IMMICH-2026-11-20.md create mode 100644 ops/sso/fix_sso_headers.py diff --git a/ops/sso/SSO-HOME-IMMICH-2026-11-20.md b/ops/sso/SSO-HOME-IMMICH-2026-11-20.md new file mode 100644 index 0000000..091182a --- /dev/null +++ b/ops/sso/SSO-HOME-IMMICH-2026-11-20.md @@ -0,0 +1,64 @@ +# SSO: Home/Immich forwarded headers — 20.11.2026 + +## Симптом + +- Home (`home.buryans.ru`) уходит на Authentik, но после логина/на входе редирект не завершается. +- Immich (`immich.buryans.ru`) кнопка «Войти через Authentik» также не завершает вход. + +## Что проверено + +Home: +- nginx `home` использует `auth_request /oauth2/auth` → `oauth2-proxy` на `192.168.1.106:9130`; +- провайдер Authentik 41: `home-assistant-proxy`, redirect `https://home.buryans.ru/oauth2/callback`; +- секрет oauth2-proxy совпадает с провайдером; +- в `auth_request` не хватало `X-Forwarded-Host`/`X-Forwarded-Uri`. + +Immich: +- nginx без `auth_request`, проксирует напрямую на `192.168.1.104:2283`; +- OIDC в Immich: issuer `https://authentik.buryans.ru/application/o/immich/`, client `immich-oidc`, redirect `https://immich.buryans.ru/auth/login`; +- секрет совпадает с провайдером 43; +- в nginx не хватало `X-Forwarded-Host`. + +## Изменение + +`/etc/nginx/conf.d/buryans-all.conf`: + +- Home `/oauth2/auth` и `/oauth2/`: добавлены + - `X-Forwarded-Host $host` + - `X-Forwarded-Uri $request_uri` +- Immich `/`: добавлены + - `X-Forwarded-Host $host` + - `X-Forwarded-Port 443` + +Бэкап: `/etc/nginx/conf.d/buryans-all.conf.before-sso-headers-20261120_210044` + +Проверки: +- `nginx -t` — успешно; +- `systemctl reload nginx` — успешно; +- Home локально отдаёт 302 на Authentik с корректным redirect_uri. + +## Rollback + +```bash +cp /etc/nginx/conf.d/buryans-all.conf.before-sso-headers-20261120_210044 \ + /etc/nginx/conf.d/buryans-all.conf +nginx -t && systemctl reload nginx +``` + +## Важно + +VPS `193.233.210.184` из этой сети недоступен по SSH/HTTPS. +Если внешний nginx на VPS имеет **свою** копию блоков Home/Immich, те же заголовки нужно применить и там. +Иначе исправление действует только на домашнем nginx. + +## Проверка после пользователя + +1. `https://authentik.buryans.ru` открывается в браузере. +2. Home: вход → callback → HA. +3. Immich: кнопка Authentik → callback `/auth/login` → галерея. +4. Если ошибка — DevTools Network: `Location`, callback, `invalid_request`. + +## Не делали + +- Home не переводили в direct: централизованный вход обязателен. +- Секреты/клиенты Authentik не меняли. diff --git a/ops/sso/fix_sso_headers.py b/ops/sso/fix_sso_headers.py new file mode 100644 index 0000000..7a77047 --- /dev/null +++ b/ops/sso/fix_sso_headers.py @@ -0,0 +1,60 @@ +#!/usr/bin/env python3 +import datetime +import re +import shutil +import subprocess +import sys + +p = "/etc/nginx/conf.d/buryans-all.conf" +t = open(p, encoding="utf-8").read() +orig = t + +def block(name): + m = re.search(r"server_name\s+%s\s*;" % re.escape(name), t) + if not m: + return None, None + end = t.find("\n}", m.end()) + return m, end + +# Home: add forwarded headers to oauth2 auth + oauth2 sign-in locations. +m, end = block("home.buryans.ru") +if m: + b = t[m.end():end] + if "X-Forwarded-Host" not in b: + b = b.replace( + "proxy_set_header Cookie $http_cookie;", + "proxy_set_header Cookie $http_cookie;\n proxy_set_header X-Forwarded-Host $host;\n proxy_set_header X-Forwarded-Uri $request_uri;", + ) + b = b.replace( + "location /oauth2/ {\n proxy_pass http://192.168.1.106:9130;", + "location /oauth2/ {\n proxy_pass http://192.168.1.106:9130;\n proxy_set_header X-Forwarded-Host $host;\n proxy_set_header X-Forwarded-Uri $request_uri;", + ) + t = t[:m.end()] + b + t[end:] + +# Immich: tell Immich the external host/proto. +m, end = block("immich.buryans.ru") +if m: + b = t[m.end():end] + if "X-Forwarded-Host" not in b: + b = b.replace( + "location / {\n proxy_pass http://192.168.1.104:2283;", + "location / {\n proxy_pass http://192.168.1.104:2283;\n proxy_set_header X-Forwarded-Host $host;\n proxy_set_header X-Forwarded-Port 443;", + ) + t = t[:m.end()] + b + t[end:] + +if t == orig: + print("no changes") + sys.exit(0) + +backup = f"{p}.before-sso-headers-{datetime.datetime.now():%Y%m%d_%H%M%S}" +shutil.copy2(p, backup) +open(p, "w", encoding="utf-8").write(t) +r = subprocess.run(["nginx", "-t"], capture_output=True, text=True) +print(r.stdout.strip().splitlines()[-1] if r.stdout.strip() else r.stderr.strip()[-300:]) +if r.returncode != 0: + shutil.copy2(backup, p) + print("restored backup") + sys.exit(1) +subprocess.run(["systemctl", "reload", "nginx"], check=False) +print("backup", backup) +print("reloaded")