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

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 组合端点由装配根自己提供。

文档

S
Description
SSO 统一认证服务 —— nginx 动态模块 + Rust(自包含 OAuth2/OIDC IdP + IAP 身份注入)
Readme
5.5 MiB
0 Stars 1 Watchers 0 Forks
Languages
HTML 59.9%
Shell 15.4%
Rust 14.3%
Dockerfile 6%
Python 4.4%