Files
sso/docs/integrate-with-iap.md
T
adminandClaude Code ddc396c992 fix(iap): 4 处 IAP location 补 X-Auth-* 注头 + 文档同步 (v0.7.22)
影响:sso_iap 验签后只设 $auth_* nginx 变量, 不会自动给 proxy_pass 请求加
X-Auth-User 等 5 个头. v0.7.22 前 4 处 IAP location 全部漏, demo app 读
X-Auth-User 拿到空字符串; nginx access log 显示 auth_user=admin ≠ 头已注.
补 5 行后下游 request.headers 正常, /me 端到端返用户身份.

改动:
- deploy/nginx.conf:/proxy/app-crm/{callback,/} + /proxy/app-mobile/{callback,/}
  四段 IAP location 各加 5 行 proxy_set_header X-Auth-* $auth_*.
- deploy/k8s/ipass-sso.yaml:镜像 tag v0.7.21 → v0.7.22; 头部注释记录此坑.
- docs/iap.md §6 坑列表加 #0, 附 5 行注头示例 + 解释 access log 误导.
- docs/integrate-with-iap.md §2.2 注释提醒(不照搬 4 段示例避免冗长);
  §6 ipass-sso 端 checklist + 失败排查表各加一条.

设计:sso_iap 注头责任全在 nginx.conf(不打算让 sso 插件自动改请求头——
保持 $auth_* 变量语义纯粹, 不想动就 $auth_* 直接用; 想要头自己
proxy_set_header, 跟 $arg_XXX / $http_XXX 风格一致).

Co-Authored-By: Claude Code <[email protected]>
2026-10-12 10:52:01 +08:00

22 KiB
Raw Blame History

ipass-sso IAP 集成指南(企业微信工作台场景)

把任意 Web app 接入 ipass-sso 的「Identity-Aware Proxy」+「WeChat Work 工作台」: 用户在企微工作台点应用图标 → 自动 OAuth → 进 app。app 永远不需要公网 IP/域名, 所有流量走 ipass-sso 反代。

适用场景:iPhone 企微工作台 / PC 企微工作台 / 任何浏览器访问受保护的内部应用。


1. 架构(一图)

                        ┌─────────────────────────────────────┐
                        │  WeChat Work  (企业微信)             │
   用户点工作台图标 ───→ │  https://work.weixin.qq.com/...     │
                        │  "应用主页" = https://idp/proxy/app/ │
                        └─────────────┬───────────────────────┘
                                      │ 302 → IdP /oauth/authorize
                                      ▼
                        ┌─────────────────────────────────────┐
                        │  ipass-sso (idp.example.com:88)     │
   ─────────────────────→│  nginx + libipass_sso_gateway.so   │
                        │                                     │
   ① 无 sso_sid → 401 ──→│  /proxy/app-crm/                   │  sso_iap on;
   ② 兜底跳 /portal/    │      ↓ sso_iap 鉴权 + 注 X-Auth-*   │  error_page 401
       wxwork/login     │      ↓ proxy_pass                  │
                        │      ↓ sub_filter (无, demo 自加)  │
                        └──────┬──────────────────────────────┘
                               │ X-Auth-User: alice
                               │ X-Auth-Token: eyJ...
                               ▼
                        ┌─────────────────────────────────────┐
                        │  app-crm (Mac 本机 127.0.0.1:18101) │
                        │  Flask + Python                     │
                        │  只需要读 X-Auth-User 就知道是谁     │
                        │  不需要公网 / 不需要处理 OAuth dance │
                        └─────────────────────────────────────┘

关键事实:

  • IAP 模式下 app 接收的请求已经被注入了 X-Auth-User / X-Auth-Sub / X-Auth-Email / X-Auth-Groups / X-Auth-Token 头
  • 唯一需要 app 自己处理 OAuth dance 的端点是 /callback(IdP 把 code 投递到这里)
  • 其余所有路径都依赖 IAP 自动鉴权 + 头注入

2. ipass-sso 端配置(三处)

2.1 注册 OAuth 客户端

/usr/local/nginx/data/oauth_clients.json 加一条:

{
  "client_id": "app-crm",
  "client_secret": "cs_crm_xxx_change_me_2026",
  "name": "CRM 演示",
  "redirect_uris": [
    "https://idp.example.com:88/proxy/app-crm/callback"
  ],
  "grant_types": ["authorization_code", "refresh_token"],
  "scopes": ["openid", "profile", "email"],
  "confidential": true,
  "visible_roles": ["admin", "user"]
}

硬约定:

  • redirect_uris 必须写公网 URL + /proxy/<app-name>/callback(不是 127.0.0.1:<port>/callback)
  • client_secret 自己生成(openssl rand -hex 32 即可),app 端用 HTTP Basic Auth 或 form post 发
  • visible_roles 控制工作台谁能看见这个 app

2.2 nginx 加 IAP location

deploy/nginx.conf 的 server 块内加:

upstream app_crm_backend {
    server host.docker.internal:18101;        # Mac 本机端口(OrbStack docker 场景)
    # 或 server 127.0.0.1:8080;              # 纯本机场景
    # 或 server 192.168.1.18:18101;          # 局域网场景(demo app 必须 bind 0.0.0.0)
}

# /callback 子路径:单独挂,不走 sso_iap(IdP 来的 callback 无 JWT/cookie)
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;
    # sso_iap 只设 $auth_* 变量, 不会自动加 X-Auth-* 头给下游
    # (2026-10-12 v0.7.22 实测踩, 缺这 5 行 demo app 读 X-Auth-User 拿到空字符串)
    proxy_set_header X-Auth-User   $auth_user;
    proxy_set_header X-Auth-Email  $auth_email;
    proxy_set_header X-Auth-Groups $auth_groups;
    proxy_set_header X-Auth-Sub    $auth_sub;
    proxy_set_header X-Auth-Token  $auth_token;
}

# / 及其子路径:挂 sso_iap 强制 sso_sid
location /proxy/app-crm/ {
    ipass_api off;
    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;
    # sso_iap 只设 $auth_* 变量, 不会自动加 X-Auth-* 头给下游
    # (2026-10-12 v0.7.22 实测踩, 缺这 5 行 demo app 读 X-Auth-User 拿到空字符串)
    proxy_set_header X-Auth-User   $auth_user;
    proxy_set_header X-Auth-Email  $auth_email;
    proxy_set_header X-Auth-Groups $auth_groups;
    proxy_set_header X-Auth-Sub    $auth_sub;
    proxy_set_header X-Auth-Token  $auth_token;
}

# 401 兜底:跳企微登录, redirect 保留原 URL (named location 必须在 server 块内)
location @iap_oauth_login {
    return 302 "/portal/wxwork/login?redirect=$request_uri";
}

为什么 proxy_redirect 必须是正则 ~^(https?://[^/]+)?(/.*)$?

app 内 redirect("/me") 返回 Location: /me(相对路径)。nginx 默认会把 /me 改写成 <请求 Host>/me = https://idp/crm/.../me —— 错!要用正则显式捕获整个路径再加 /proxy/app-crm 前缀:

  • Location: /(demo app 内部 redirect 根)→ Location: /proxy/app-crm/
  • Location: /me → Location: /proxy/app-crm/me
  • Location: http://app_crm_backend/... → 同样改写回 /proxy/app-crm/...

字面量 proxy_redirect http://app_crm_backend/ /proxy/app-crm/; 不工作——它只匹配绝对 URL,漏掉相对路径。

2.3 WeChat Work 工作台应用配置

企微管理后台 → 应用 → 自建 / 第三方应用 → 应用主页 = https://idp.example.com:88/proxy/app-crm/

不是 https://idp.example.com:88/admin/,必须是 IAP 路径。 这样用户在企微点图标 → 第一次跳到 /proxy/app-crm/ → IAP 401 兜底跳企微登录 → OAuth dance → 落到 demo app。

环境变量(在 ipass-sso 容器内):

  • OAUTH_ISSUER=https://idp.example.com:88
  • OAUTH_COOKIE_DOMAIN=example.com(只影响 sso 终端用户 cookie;admin 会话恒 host-only)
  • WXWORK_ENABLED=true
  • WXWORK_CORP_ID=ww...
  • WXWORK_AGENT_ID=1000015
  • WXWORK_SECRET=...(从 K8s Secret 或 xop vault 注入,绝不写到 conf)
  • WXWORK_REDIRECT=https://idp.example.com:88/portal/wxwork/callback

3. App 端要求(关键规则)

3.1 三个 env 变量

# 公网 IdP 地址 (token 兑换 / userinfo 都走这里)
export IDP_BASE=https://idp.example.com:88

# 自己 redirect_uri (用 IAP 路径, 不是 loopback)
export REDIRECT_URI=https://idp.example.com:88/proxy/app-crm/callback

# HTML 路径前缀 (HTML 里所有内部链接加这个前缀; Flask 路由保持 /X)
export BASE=/proxy/app-crm

三个 env 都在 ~/.ipass-sso-data/oauth_clients.json 的 client 注册和 deploy/nginx.conf 里有对应。改一个必须改另两个。

3.2 路由不要带前缀

# ✅ 正确: Flask 路由保持 /X, IAP 会自动 strip /proxy/app-crm 前缀
@app.route("/")
def home(): ...
@app.route("/customers")
def customers_list(): ...
@app.route("/customers/<cid>")
def customer_detail(cid): ...
@app.route("/customers/new", methods=["GET", "POST"])
def customer_new(): ...

# ❌ 错误: 不要写成 /proxy/app-crm/customers, 否则 IAP 透传过来时
# prefix strip 后变成 /customers, 找不到路由 404
@app.route("/proxy/app-crm/customers")  # 错!
def customers_list(): ...

3.3 HTML 字符串必须带 BASE 前缀

# ✅ 正确: HTML 里的 href/action/src 用 BASE 拼
<a href="{BASE}/customers">客户</a>
<a href="{BASE}/customers/{cid}">{name}</a>
<form method=post action="{BASE}/customers/{cid}/stage">

# ❌ 错误: 写裸 /customers → 浏览器跳到 https://idp/customers (公网根)
# → IAP 没匹配 (前缀不对) → 落到 IdP 兜底 404
<a href="/customers">客户</a>   # 错!

3.4 Flask redirect() 不能带 BASE

# ✅ 正确: Flask redirect 输出相对路径, IAP proxy_redirect 会加前缀
@app.route("/callback")
def callback():
    ...
    return redirect("/me")           # 改 IAP 加前缀
    return redirect("/")             # 改 IAP 加前缀
    return redirect(f"/customers/{new_id}")

# ❌ 错误: 自己加 BASE, IAP 又加一次 → 双前缀
return redirect(f"{BASE}/me")        # 错! → /proxy/app-crm/proxy/app-crm/me

规则总结:

输出形态 由谁加 BASE
HTML 静态字符串 href / action / src app 自己 ({BASE}/...)
Flask 动态 redirect() 输出 IAP 的 proxy_redirect 正则

3.5 /callback 端点要做的(demo app 流程)

import os, secrets, urllib.parse, urllib.request, json
from flask import Flask, redirect, request, session

IDP         = os.environ.get("IDP_BASE", "https://idp.example.com:88")
CLIENT_ID   = "app-crm"
REDIRECT_URI= os.environ["REDIRECT_URI"]   # 必须 = oauth_clients.json 注册的
BASE        = os.environ.get("BASE", "")

app = Flask(__name__)
app.secret_key = os.environ.get("FLASK_SECRET", "change-me-32-bytes-random!")

@app.route("/login")
def login():
    state = secrets.token_urlsafe(16)
    session["state"] = state
    qs = urllib.parse.urlencode({
        "response_type": "code",
        "client_id":     CLIENT_ID,
        "redirect_uri":  REDIRECT_URI,
        "scope":         "openid profile email",
        "state":         state,
    })
    return redirect(f"{IDP}/oauth/authorize?{qs}")

@app.route("/callback")
def callback():
    # 注意: app-crm 实现是「无 state 也放行」, 因为 IdP-initiated 流程
    # (企微工作台点图标) 不带 state. 收到 state 才校验一致性.
    received = request.args.get("state")
    if received and received != session.get("state"):
        return "state 不匹配", 400
    code = request.args.get("code")
    if not code:
        return "no code", 400

    # token 兑换: confidential client 用 Basic Auth
    import base64
    basic = base64.b64encode(f"{CLIENT_ID}:{CLIENT_SECRET}".encode()).decode()
    req = urllib.request.Request(
        f"{IDP}/oauth/v20/token",  # 注意是 v20 不是 /oauth/token
        data=urllib.parse.urlencode({
            "grant_type":   "authorization_code",
            "code":         code,
            "redirect_uri": REDIRECT_URI,
        }).encode(),
        headers={
            "Authorization": f"Basic {basic}",
            "Content-Type":  "application/x-www-form-urlencoded",
            "Accept":        "application/json",
        },
        method="POST",
    )
    with urllib.request.urlopen(req, timeout=8) as r:
        tokens = json.loads(r.read())   # 直接是 OAuth2 裸响应 (不是信封)

    # 公开客户端 (无 client_secret) 改 form-post, 加 PKCE: code_verifier 等
    session["tokens"] = tokens
    return redirect("/me")              # 走 IAP proxy_redirect → /proxy/app-crm/me

3.6 其余路径直接读 X-Auth-* 头

@app.route("/")
def home():
    # IAP 已经鉴权 + 注头, app 不需要再校验
    user = request.headers.get("X-Auth-User", "(anonymous)")
    email = request.headers.get("X-Auth-Email", "")
    groups = request.headers.get("X-Auth-Groups", "").split(",")
    return f"<h1>欢迎 {user} ({email})</h1><p>组: {', '.join(g for g in groups if g)}</p>"

@app.route("/me")
def me():
    # 拿 access_token 调 userinfo
    token = request.headers.get("X-Auth-Token", "")
    req = urllib.request.Request(
        f"{IDP}/oauth/userinfo",
        headers={"Authorization": f"Bearer {token}"},
    )
    with urllib.request.urlopen(req) as r:
        ui = json.loads(r.read())
    return json.dumps(ui, indent=2, ensure_ascii=False)

4. 部署拓扑

4.1 单机 OrbStack(演示用)

Mac 127.0.0.1
  ├─ OrbStack docker 容器 (ipass-sso 镜像)
  │    ├─ 容器内 18098 (nginx)
  │    └─ 映射 Mac 28889 (docker run -p 28889:18098)
  │       容器内 → host.docker.internal:18101 → Mac 127.0.0.1:18101 (Flask)
  └─ Flask app 本机 127.0.0.1:18101

4.2 多机生产(app 在另一台)

              ipass-sso 容器 (Mac 28889 或 K8s pod)
                │ nginx upstream 指向 192.168.1.X:18101
                │ 关键: app 必须 bind 0.0.0.0 不是 127.0.0.1
                ▼
              app 服务器 (另一台 Mac / Linux / K8s pod)
                └─ Flask app bind 0.0.0.0:18101

4.3 K8s pod 内启动 demo app(反例 → 2026-10-12 v0.7.21 已变正例)

历史教训: K8s pod 在 OrbStack VM / 集群 netns 内独立, pod 内 192.168.1.x / host.docker.internal 都连不上 Mac LAN(被 K8s 网络层隔离)。v0.7.20 时期 IAP upstream 用 host.docker.internal:18101 + hostAliases 占位 → IAP 路径 502。

v0.7.21 解法(推荐,2026-10-12 落地 deploy/k8s/iap-demo.yaml):

  • demo app 也搬上 K8s(Flask + gunicorn, bind 0.0.0.0:8000, UID 10106)
  • 用 ClusterIP Service 暴露:app-crm-svc:8000 / app-mobile-svc:8000
  • ipass-sso nginx.conf upstream 改:server app-crm-svc:8000;
  • 同 ns 集群 DNS 自动解析 Service 名,删 hostAliases 占位
  • demo app 不做 token 兑换(IAP 已鉴权 + 注 X-Auth-* 头),不需 client_secret
  • 真要 demo app 在 K8s 外(Mac 127.0.0.1),只有以下两条退路:
    • app 改 bind 0.0.0.0 + upstream 写 Mac LAN IP 192.168.1.18(违背"绕开 Mac"原则)
    • Mac 起 socat/iptables 把 K8s 端口转出来(额外维护成本)

5. 端到端验证(5 步)

# 0) 起 demo app, 带 BASE env
cd /tmp/idp-sim
nohup env BASE=/proxy/app-crm \
  IDP_BASE=https://idp.example.com:88 \
  REDIRECT_URI=https://idp.example.com:88/proxy/app-crm/callback \
  FLASK_SECRET=$(openssl rand -hex 32) \
  python3 -u app-crm.py > app-crm.log 2>&1 &

# 1) 直连 demo app: / 应 redirect /login (无 BASE, 走 IAP proxy_redirect)
curl -s -o /dev/null -D - http://127.0.0.1:18101/ | grep -i location
# 期望: Location: /login

# 2) IAP /proxy/app-crm/ (无 sso_sid → 401 兜底)
curl -s -o /dev/null -D - http://127.0.0.1:28889/proxy/app-crm/ | grep -i location
# 期望: Location: /portal/wxwork/login?redirect=/proxy/app-crm/

# 3) IAP /proxy/app-crm/callback (无 sso_iap, demo app 400 因缺 state/code)
curl -s -o /dev/null -D - http://127.0.0.1:28889/proxy/app-crm/callback | head -1
# 期望: HTTP/1.1 400

# 4) 真 iPhone/PC 企微点 CRM 图标
#    期望: 落 /proxy/app-crm/me 或 /, 不再 /admin/ → /manage/users

6. AI 快速集成 checklist

把这一节复制给 AI,让它按项 check:

ipass-sso 端

  • oauth_clients.json 加 client, redirect_uris 第一条 = https://<idp-host>/proxy/<app-name>/callback
  • deploy/nginx.conf 加 4 段 location(upstream / callback / iap-loc / 401-namied-location)
  • 每段 IAP location 的 proxy_redirect 都用正则 ~^(https?://[^/]+)?(/.*)$ /proxy/<app-name>$2
  • iap-loc 显式 ipass_api off; + sso_iap on; + error_page 401 = @iap_oauth_login
  • 每段 IAP location 显式 5 行 proxy_set_header X-Auth-* $auth_*(v0.7.22 实测踩:sso_iap 只设 nginx 变量不自动注头;漏一行 → demo app 读 X-Auth-User 拿空字符串)
  • /callback 显式 ipass_api off; + proxy_pass http://<upstream>/callback(具体子路径)
  • 企微工作台应用主页 URL = https://<idp-host>/proxy/<app-name>/(IAP 路径)

App 端

  • IDP_BASE / REDIRECT_URI / BASE 三个 env 配齐
  • REDIRECT_URI 必须 = oauth_clients.json 注册的(否则 token 兑换 invalid_grant)
  • Flask 路由全部 /X(不带 /proxy/<app>/ 前缀)
  • HTML 模板里所有 href / action / src 写 {BASE}/X(带前缀)
  • Flask redirect() 全部 /X(不带 BASE,让 IAP proxy_redirect 改写)
  • id_token / access_token 兑换用 /oauth/v20/token(不是 /oauth/token,后者是信封格式)
  • 拿 userinfo 用 Authorization: Bearer <access_token> 打 /oauth/userinfo
  • 公开客户端(无 client_secret)走 PKCE/S256,token 兑换 form-post
  • app.run(host="0.0.0.0", port=PORT)(不是 127.0.0.1,否则 IAP 容器连不上)

失败排查(按概率排序)

现象 原因 修复
{"code":404,"msg":"接口不存在:GET /customers"} demo app 渲染 href="/customers", 浏览器跳公网 /customers 落 IdP 兜底 HTML 改 href="{BASE}/customers"
iPhone 点 CRM 落 /manage/users demo app redirect("/") 没被改写, IAP proxy_redirect 字面量只匹配绝对 URL nginx 改正则 ~^(https?://[^/]+)?(/.*)$ /proxy/<app>$2
落在 /proxy/app-crm/proxy/app-crm/(双前缀) demo app 自己也加了 BASE 到 redirect(), IAP 又加一次 demo app redirect() 还原成 /X 形式
invalid_grant: redirect_uri 不匹配 demo app 写的 REDIRECT_URI 与 oauth_clients.json 注册的不一致 env 改一致, 都用公网 IAP 路径
iPhone 一直转圈 demo app 监听 127.0.0.1, 容器连不上 app.run(host="0.0.0.0", port=PORT)
demo app 收不到 X-Auth-User(拿空字符串) sso_iap 只设 nginx 变量不自动注头 每段 IAP location 显式 proxy_set_header X-Auth-User $auth_user 等 5 行

7. 完整最小 app-crm 模板

最小可运行的 demo(约 100 行),复制后改 CLIENT_ID / REDIRECT_URI / BASE 即可:

#!/usr/bin/env python3
"""最小可工作的 IAP demo - 复制改 env 即用"""
import os, secrets, base64, json, urllib.parse, urllib.request
from flask import Flask, redirect, request, session

IDP          = os.environ["IDP_BASE"]
CLIENT_ID    = "app-crm"                                # ← 改
CLIENT_SECRET= "cs_crm_xxx_change_me_2026"              # ← 改
REDIRECT_URI = os.environ["REDIRECT_URI"]               # ← 改 = oauth_clients.json 注册
BASE         = os.environ.get("BASE", "")               # ← 改 = /proxy/<app-name>
PORT         = 18101                                    # ← 改
app = Flask(__name__)
app.secret_key = os.environ.get("FLASK_SECRET", secrets.token_hex(32))

def _idp_post(path, body, auth=True):
    headers = {"Accept": "application/json", "Content-Type": "application/x-www-form-urlencoded"}
    if auth:
        headers["Authorization"] = "Basic " + base64.b64encode(f"{CLIENT_ID}:{CLIENT_SECRET}".encode()).decode()
    req = urllib.request.Request(f"{IDP}{path}", data=urllib.parse.urlencode(body).encode(),
                                 headers=headers, method="POST")
    with urllib.request.urlopen(req, timeout=8) as r:
        return json.loads(r.read())

@app.route("/login")
def login():
    state = secrets.token_urlsafe(16)
    session["state"] = state
    qs = urllib.parse.urlencode({"response_type": "code", "client_id": CLIENT_ID,
                                 "redirect_uri": REDIRECT_URI, "scope": "openid profile email",
                                 "state": state})
    return redirect(f"{IDP}/oauth/authorize?{qs}")

@app.route("/callback")
def callback():
    rcv = request.args.get("state")
    if rcv and rcv != session.get("state"):
        return "state mismatch", 400
    tokens = _idp_post("/oauth/v20/token", {
        "grant_type": "authorization_code",
        "code": request.args["code"],
        "redirect_uri": REDIRECT_URI,
    })
    session["tokens"] = tokens
    return redirect("/me")                               # ← 不带 BASE, 走 IAP

@app.route("/")
def home():
    user = request.headers.get("X-Auth-User", "?")
    return f'<h1>欢迎 {user}</h1><ul><li><a href="{BASE}/me">看 userinfo</a></li></ul>'

@app.route("/me")
def me():
    tok = request.headers.get("X-Auth-Token", "")
    req = urllib.request.Request(f"{IDP}/oauth/userinfo",
                                 headers={"Authorization": f"Bearer {tok}"})
    with urllib.request.urlopen(req) as r:
        ui = json.loads(r.read())
    return f"<pre>{json.dumps(ui, indent=2, ensure_ascii=False)}</pre>"

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=PORT, debug=False)      # ← 0.0.0.0 不是 127.0.0.1

启动:

export IDP_BASE=https://idp.example.com:88
export REDIRECT_URI=https://idp.example.com:88/proxy/app-crm/callback
export BASE=/proxy/app-crm
export FLASK_SECRET=$(openssl rand -hex 32)
python3 app-crm.py

8. 参考

  • 实际跑的 demo app 源码:/tmp/idp-sim/app-crm.py(约 700 行,含客户/商机/阶段管理完整功能)
  • ipass-sso IAP 通用接入(不依赖企微工作台):docs/iap.md(讲 X-Auth-* 头注入 / Bearer vs Cookie 鉴权)
  • 记忆 iap-reverse-proxy.md:架构 + 拓扑 + 历次踩坑
  • 记忆 k8s-to-docker-migration.md:OrbStack 容器网络细节
  • IAP 烟测脚本:/tmp/idp-sim/test-iap.sh
  • demo app 重启脚本:/tmp/idp-sim/restart-demo-apps.sh