Files
sso/deploy/nginx.conf
T
adminandClaude Code c7904aa6ee fix(iap): proxy_redirect 改用正则, 覆盖 demo app 返的相对 Location 头
v0.7.19 用字面量 proxy_redirect http://app_crm_backend/ /proxy/app-crm/;
只匹配绝对 URL, 但 demo app redirect("/") 返的是相对路径, 改写不生效。
v0.7.20 改用正则 ~^(https?://[^/]+)?(/.*)$ /proxy/app-crm$2:
  - 相对路径 /, /me, /logout 等都以 / 开头, 命中
  - 绝对 URL http://app_crm_backend/... 也覆盖
  -  是路径部分, 写入 /proxy/app-crm + 路径

iPhone 点 workbench → /oauth/authorize → /proxy/app-crm/callback →
demo app 兑换 token (200) → redirect("/") → 被改写为 /proxy/app-crm/ →
IAP 拿 sso_sid 注 X-Auth → proxy_pass → 用户看 demo app, 不再 /admin/

Co-Authored-By: Claude Code <[email protected]>
2026-10-10 16:19:26 +08:00

230 lines
11 KiB
Nginx Configuration File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ============================================================================
# ipass-sso 容器运行配置(精简版:身份/IdP + 管理台)
#
# 从 ipass-all/deploy/nginx.conf 派生的 SSO-only 版(2026-09-30 拍板):
# 剔除了 domain / llm / apix / cache / waf 5 个插件对应的 location 与
# 整个 LLM 数据面 server、动态域名 server;只保留身份 / 管理台 / API 端点。
#
# 指令清单 = 本仓 gateway 注册的 4 条:
# main : ipass_state / ipass_data_dir
# loc : ipass_api / sso_iap
#
# 非 root 适配(k8s 租户准入强制 runAsUser=10106):
# pid/lock/temp 全部挪 /tmp
# ============================================================================
worker_processes auto;
error_log /usr/local/nginx/logs/error.log info;
pid /tmp/nginx/nginx.pid;
lock_file /tmp/nginx/nginx.lock;
load_module /usr/local/nginx/modules/libipass_sso_gateway.so;
# 模块读取的 env 白名单(nginx 默认剥离全部环境变量;漏一条 = worker 里恒空)
env ADMIN_INIT_PASSWORD;
env OAUTH_SIGNING_SECRET;
env OAUTH_ISSUER;
env OAUTH_COOKIE_DOMAIN;
env SYNC_DINGTALK_URL;
env SYNC_WORKWECHAT_URL;
env SYNC_FEISHU_URL;
env PASSWORD_RESET_TOKEN_SINK;
env PASSWORD_RESET_TTL;
# 企微 OAuth 集成(2026-10-09 v0.7.0)—— 工作台「用企微登录」入口
env WXWORK_ENABLED;
env WXWORK_CORP_ID;
env WXWORK_AGENT_ID;
env WXWORK_SECRET;
env WXWORK_REDIRECT;
events {
worker_connections 2048;
}
http {
include /usr/local/nginx/conf/mime.types;
default_type application/json; # 业务侧默认 JSON,静态页在对应 location 覆盖
sendfile on;
keepalive_timeout 65;
# ------------------------------------------------------------------
# 非 root 适配:临时目录默认在编译前缀下(root 属主),10106 建不了
# ------------------------------------------------------------------
client_body_temp_path /tmp/nginx/client_body;
proxy_temp_path /tmp/nginx/proxy;
fastcgi_temp_path /tmp/nginx/fastcgi;
# ------------------------------------------------------------------
# 日志:带身份维度(WAF/缓存/域名等插件字段在精简版省略),排障不翻模块日志
# ------------------------------------------------------------------
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" "$http_user_agent" '
'"$upstream_addr" "$upstream_status" "$upstream_response_time" '
'auth_user=$auth_user';
access_log /usr/local/nginx/logs/access.log main;
# ------------------------------------------------------------------
# 内核:共享内存 + 数据目录(必须显式,理由见文件头)
# ------------------------------------------------------------------
ipass_state state 16m; # 身份会话+账号 Key(精简版无域名/用量/缓存/WAF)
ipass_data_dir /usr/local/nginx/data;
# ------------------------------------------------------------------
# IAP 反代:demo app 跑在 Mac 宿主机(launchd cn.ssw.wecom-crm-bot /
# cn.ssw.mock-crm,bind 127.0.0.1:18101/18102)。容器内靠
# host.docker.internal(OrbStack 解析为 0.250.250.254 = Mac loopback)走通。
# 上游不能用 192.168.1.18(demo app 没 bind 该接口,connection refused),
# 也不能用 127.0.0.1(容器 loopback ≠ 宿主机 loopback)。
# ------------------------------------------------------------------
upstream app_crm_backend { server host.docker.internal:18101; keepalive 16; }
upstream app_mobile_backend { server host.docker.internal:18102; keepalive 16; }
# ==================================================================
# 主 server(NodePort 30082):管理台 + IdP 全部端点
# ==================================================================
# ⚠️ 本次部署为明文 HTTP(2026-09-30 临时方案,TLS 后续接入)。
# 历史:本想用 K8s ConfigMap 把 self-signed cert 注入到
# /usr/local/nginx/data/tls/,但本 SA 在当前受限会话里没有
# 创建 ConfigMap 的工具调用授权。先用 18098 明文把 SSO + OIDC
# discovery 链路跑通,证书走 PVC sso/tls/ + 外部流程接入时再切回
# `listen 18098 ssl default_server` + 三条 ssl_certificate 指令。
server {
listen 18098 default_server; # 明文(NodePort 30082)
server_name _;
absolute_redirect off;
port_in_redirect off;
# 管理台核心壳(ipass-core www dist)+ sso 管理页
root /usr/local/nginx/www;
index index.html;
client_max_body_size 10m;
client_body_buffer_size 1m;
# ---- 管理/身份 API(content 阶段读体后按 PLUGINS 顺序分发)----
# 认领方:sso(身份端点/OIDC/SCIM/CAS/门户)+ core(账号/插件启停注册表)
location /api/ {
ipass_api on;
}
# OIDC/身份协议端点挂在根路径(/oauth/* /login /logout /userinfo
# /.well-known/* /apps /reset /cas/*),由 sso 插件认领
location / {
ipass_api on;
}
# ---- 管理台静态资源(这些 location 不开 ipass_api:静态文件走 nginx)----
location = / {
return 302 /admin/;
}
location = /admin {
return 302 /admin/;
}
location = /index.html {
add_header Cache-Control "no-store" always;
}
location /admin/ {
try_files $uri $uri/ /index.html; # SPA history 深链兜底
add_header Cache-Control "no-store" always;
}
# 插件面板路由(/plugin-<name>)走壳 SPA:直链/刷新时回 index.html
location /plugin- {
try_files $uri /index.html;
add_header Cache-Control "no-store" always;
}
# 壳内置面板路由(/manage/*,网关管理三页)同上
location /manage/ {
try_files $uri /index.html;
add_header Cache-Control "no-store" always;
}
location /assets/ {
add_header Cache-Control "no-store" always;
}
# 插件管理页 UMD 产物(壳按 /static/plugins/<name>/dist/<name>-admin.umd.js 拉取)
location /static/plugins/ {
alias /usr/local/nginx/static-plugins/;
add_header Cache-Control "no-store" always;
}
# 装配层自定义页清单(精简版不挂自定义页,无 /static/custom/)
# 老管理台 sso 五 tab 单页(精简版只挂 sso.html 一张;自包含,零外部资产)
# 默认 api=false 即可:merge_loc_conf 已不继承父 location / 的 ipass_api on
# (见 gateway/src/lib.rs::Merge 注释),无需显式 `ipass_api off;`
location /legacy/ {
alias /usr/local/nginx/legacy/;
add_header Cache-Control "no-store" always;
}
# ---- 企微域名校验文件(v0.7.0+)----
# 文件在 PVC 的 verify/ 目录(/usr/local/nginx/data/verify/WW_verify_*.txt),
# 部署时由 scripts/seed-verify.sh 从 data-seed/verify/ 复制过去。
# 留空内容即可命中(Content-Type 显式给 text/plain)。
location ~* ^/WW_verify_[A-Za-z0-9_-]+\.txt$ {
root /usr/local/nginx/data/verify;
add_header Content-Type "text/plain; charset=utf-8" always;
}
# ---- IAP 反代 demo app(v0.7.12+,出站代理模式)----
# /callback 子路径单独挂:不走 sso_iap(IdP 来的回调无 JWT/cookie,
# 否则 IAP 会 401 → 跳登录 → 死循环)。其它路径挂 sso_iap 强制 sso_sid,
# sso_sid 由 WeChat Work 登录或 /login 流程写入,缺失时跳企微登录。
#
# proxy_redirect 必须写正则 ~^/:demo app 内部 redirect("/") 返的
# 是相对路径,浏览器按当前请求 Host(公网域)解析 → 跳到 IdP 根
# → /admin/,不是 demo app。把所有以 / 开头的 Location 重写回 IAP
# 路径,覆盖 redirect("/")/redirect("/me")/redirect("/logout") 等
# 全部 demo app 内部跳转。绝对 URL(含 http://app_crm_backend/)
# 也一并覆盖 → 公网/IAP 场景下不会泄漏 backend 地址。
location /proxy/app-crm/callback {
ipass_api off; # 防 merge_loc_conf 漏父级 ipass_api on
proxy_pass http://app_crm_backend/callback;
proxy_redirect ~^(https?://[^/]+)?(/.*)$ /proxy/app-crm$2;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
}
location /proxy/app-crm/ {
ipass_api off; # 防 merge_loc_conf 漏父级 ipass_api on
sso_iap on;
error_page 401 = @iap_oauth_login;
proxy_pass http://app_crm_backend/;
proxy_redirect ~^(https?://[^/]+)?(/.*)$ /proxy/app-crm$2;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
}
location /proxy/app-mobile/callback {
ipass_api off;
proxy_pass http://app_mobile_backend/callback;
proxy_redirect ~^(https?://[^/]+)?(/.*)$ /proxy/app-mobile$2;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
}
location /proxy/app-mobile/ {
ipass_api off;
sso_iap on;
error_page 401 = @iap_oauth_login;
proxy_pass http://app_mobile_backend/;
proxy_redirect ~^(https?://[^/]+)?(/.*)$ /proxy/app-mobile$2;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
}
# ---- IAP 401 兜底:跳企微登录,redirect 保留原 URL ----
# 必须放在 server 块内(named location 不能在 http {} 顶层)
location @iap_oauth_login {
return 302 "/portal/wxwork/login?redirect=$request_uri";
}
}
}