 adminandClaude Code
|
8b8562dff1
|
docs(iap): 完整集成指南 (app-crm 为例, 含 WeChat Work 接入)
覆盖:
- 架构一图 (企微工作台 → ipass-sso IAP → app)
- ipass-sso 端 3 处配置 (oauth_clients / nginx.conf / WXWORK env)
- app 端 3 个 env + 4 条硬规则 (Flask 路由 /HTML 字符串 /Flask redirect)
- /callback 端点 OAuth dance 模板 (/oauth/v20/token + Basic Auth)
- 部署拓扑 (OrbStack / 跨机 / K8s 反例)
- 5 步端到端验证
- AI 快速集成 checklist (按概率排序的失败排查)
- 100 行最小可运行 app-crm 模板
关键规则: HTML href/action/src 必须带 BASE, Flask redirect() 不能带 BASE,
nginx proxy_redirect 必须是正则, Flask 路由不能带 /proxy 前缀。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-10 18:24:19 +08:00 |
|
 adminandClaude Code
|
f35252e267
|
feat(deploy): 工作台 + 企微 OAuth 部署配置(v0.7.0)
**影响**
- 镜像 tag 升 `ipass-sso-v0.6.1` → `ipass-sso-v0.7.0`,需重建 + push
- pod env 增 5 条 WXWORK_*;SECRET 走 `kubectl set env` 注入(不进 git)
- 域名 `i96772757dm.mayishangshu.cn:88/portal/wxwork/callback` 配到 WXWORK_REDIRECT
- 新增 `nginx ~* ^/WW_verify_.*\.txt$` 静态,文件在 PVC `data/verify/`
**改动**
- `deploy/k8s/ipass-sso.yaml` 镜像 tag 升一档 + container env 加 5 条;SECRET 用占位 `REPLACE_ME_VIA_KUBECTL_SET_ENV`
- `deploy/nginx.conf` env 白名单 5 条;`location ~* ^/WW_verify_` 静态出
- `data-seed/verify/WW_verify_rA7XMVuzBQ7kaXWZ.txt` 占位文件,部署时由 seed-verify.sh 复制到 PVC
- `scripts/seed-verify.sh` 幂等复制脚本(已存在则跳过),不覆盖现场值
- `rust/Cargo.toml` / `Cargo.lock` workspace 增 `ureq` 间接(实际由 plugin-sso 引入)
- `docs/superpowers/specs/2026-10-09-sso-workbench-wxwork-design.md` 设计文档
**设计**
- 校验文件放 PVC 不放镜像(与 tls/ 同思路):换内容不重打镜像
- 部署后第一步:`kubectl -n wuguirong set env deploy/ipass-sso WXWORK_SECRET=<真值>`,触发滚动
- 启动日志若 `wxwork::route` 全部 None(=enabled=false),提示「WXWORK_ENABLED 未开或 SECRET 缺」
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-09 17:43:39 +08:00 |
|