docs(iap): 注释说明 demo app BASE 路径前缀方案

nginx 侧不再用 sub_filter 重写 HTML 路径(固定串匹配会误伤 /api/ 这类
IdP 端点)。改为 demo app 自身用 env BASE 拼 href/action 路径, 这样
/proxy/app-crm/customers 在 demo app 内部路由还是 /customers, 但渲染
出的 HTML 已经带前缀, 浏览器点击直接进 IAP location 不会被劫到公网
/customer → IdP 404 接口不存在。

Co-Authored-By: Claude Code <[email protected]>
This commit is contained in:
adminandClaude Code committed 2026-10-10 17:12:16 +08:00
1 parent c7904aa6ee
commit abd85f7b9c
1 file changed
+11
+11
View File
@@ -176,6 +176,12 @@ http {
# 路径,覆盖 redirect("/")/redirect("/me")/redirect("/logout") 等
# 全部 demo app 内部跳转。绝对 URL(含 http://app_crm_backend/)
# 也一并覆盖 → 公网/IAP 场景下不会泄漏 backend 地址。
#
# sub_filter 重写 demo app HTML 里的根相对路径:demo app 渲染的
# href="/customers" / href="/opportunities" 等在它自己域名是绝对
# 路径,但在 IAP 路径前缀下错位 → 浏览器跳到公网 /customers(落
# 到 IdP 兜底 404)。把所有 demo app 内部路径加 /proxy/<app>/ 前缀。
# 不重写 /api/(demo app 的 /api/customers 是 IdP 数据源)。
location /proxy/app-crm/callback {
ipass_api off; # 防 merge_loc_conf 漏父级 ipass_api on
proxy_pass http://app_crm_backend/callback;
@@ -192,6 +198,9 @@ http {
error_page 401 = @iap_oauth_login;
proxy_pass http://app_crm_backend/;
proxy_redirect ~^(https?://[^/]+)?(/.*)$ /proxy/app-crm$2;
# 注:demo app 自身会用 env BASE=/proxy/app-crm 拼 HTML 里的
# href/action/script src=路径,nginx 侧不重写(sub_filter 是
# 固定串匹配,'/customers' 会误伤 /api/customers 这类 IdP 端点)。
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
@@ -214,6 +223,8 @@ http {
error_page 401 = @iap_oauth_login;
proxy_pass http://app_mobile_backend/;
proxy_redirect ~^(https?://[^/]+)?(/.*)$ /proxy/app-mobile$2;
# 注:demo app 自身会用 env BASE=/proxy/app-mobile 拼 HTML 里的
# href/action/script src=路径,nginx 侧不重写。
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;