接入方式二:IAP 零改造接入
应用完全不写认证代码,只读网关注入的请求头。适合内部系统、遗留系统。网关在 access 阶段
完成门禁:无身份直接 401 并由 error_page 跳登录页;有身份则注入五个头,且覆盖客户端伪造的同名头。
location / {
sso_iap on; # 开启身份感知代理
proxy_pass http://127.0.0.1:8080; # 你的应用
proxy_set_header Host $host;
# 身份注入:客户端自己发的这几个头会被覆盖
proxy_set_header X-Auth-User $auth_user; # 登录账号
proxy_set_header X-Auth-Sub $auth_sub; # OIDC sub(同 User)
proxy_set_header X-Auth-Email $auth_email;
proxy_set_header X-Auth-Groups $auth_groups; # 逗号分隔的用户组
proxy_set_header X-Auth-Token $auth_token; # 可再次验签的 access_token
error_page 401 = @oauth_login; # 未登录 → 跳统一登录页并回跳
}
location @oauth_login {
return 302 "https://sso.example.com/login?redirect=$scheme://$host$request_uri";
}
注意:注入头只在经过网关的请求上可信。应用若可被直连(绕过网关),
任何人都能伪造这几个头——生产上必须让应用只监听内网,或只接受来自网关的连接。
跨子域 SSO
同一个 SSO 会话要给多个子站用(a.example.com、b.example.com),
必须把 SSO Cookie 的 Domain 设成带点的父域,否则第二个站点拿不到 Cookie,表现为「刚登录又被弹回登录页」。
env OAUTH_COOKIE_DOMAIN; # nginx 会剥掉环境变量,必须显式声明
export OAUTH_COOKIE_DOMAIN=.example.com
export OAUTH_SIGNING_SECRET=$(openssl rand -hex 32) # 生产必设;不设则每次重启令牌全失效
export OAUTH_ISSUER=https://sso.example.com