8b8562dff1f45eca6994e9f83fa474de942f6784
覆盖: - 架构一图 (企微工作台 → 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]>
ipass-all
iPass 全插件一体网关:内核 + 6 插件(身份 sso / 域名 domain / LLM 代理 llm / API 代理 apix / 制品缓存 cache / WAF waf)编译期装配成单个 nginx 动态模块, 一个容器跑完。单进程、零外部依赖。
端口
| 端口 | 承载 |
|---|---|
| 18098 | 管理台 /admin/ · OIDC(/.well-known/openid-configuration)· /api/* · apix(/apix/、/apixp/)· 制品缓存 8 路由(/go/ /cargo/ /pypi/ /npm/ /maven/ /v2/…)· 域名转发(Host: *.ipass.local) |
| 18099 | LLM 数据面 <base_url>/<slot>/...(sk_ Key 鉴权,出站换上游真 Key) |
快速开始
bash deploy/build.sh # 收集前端 + docker build + push 阿里云 CR
kubectl apply -f deploy/k8s/ipass-all.yaml # wuguirong 租户 ns(NodePort 30083/30084)
curl -fs http://192.168.1.26:30083/.well-known/openid-configuration
首次登录 admin / 123456(立即改密)。各插件能力与配置见管理台对应页。
装配清单与顺序
SsoPlugin → CorePlugin → DomainPlugin → LlmPlugin → ApixPlugin → CachePlugin → WafPlugin → trend
顺序即端点认领顺序:sso 排第一接管身份端点;trend 组合端点由装配根自己提供。
文档
- 构建约束、踩坑与边界 →
CLAUDE.md - K8s 清单 →
deploy/k8s/ipass-all.yaml - 各插件自身文档 → 兄弟仓
ipass-plugin-*/CLAUDE.md
Description
SSO 统一认证服务 —— nginx 动态模块 + Rust(自包含 OAuth2/OIDC IdP + IAP 身份注入)
5.5 MiB
0 Stars
1 Watchers
0 Forks
Languages
HTML
59.9%
Shell
15.4%
Rust
14.3%
Dockerfile
6%
Python
4.4%