更正为 2 个 named context、18098/NodePort 30089、PVC subPath sso、 PLUGINS=[SsoPlugin,CorePlugin]、4 条指令(无 audit_stats/probe_min); 删掉不存在的 plugin-architecture-analysis.md 死链,/userinfo 改为 /oauth/userinfo。
1.9 KiB
1.9 KiB
ipass-sso
iPass 身份网关(SSO-only 精简版):ipass-core 内核 + ipass-plugin-sso 编译期装配成
单个 nginx 动态模块(libipass_sso_gateway.so),一个容器跑完。单进程、零外部依赖
(无 DB / Redis / MQ)。全家桶版见 ../ipass-all。
端口
| 端口 | 承载 |
|---|---|
| 18098 | 管理台 /admin/ · OIDC(/.well-known/openid-configuration、/.well-known/jwks.json、/oauth/*)· 账号 API /api/* · 门户与企微 /portal/* · IAP 反代 /proxy/app-* · 集群内账号同步 /api/admin/sync/ |
NodePort 30089 → pod 18098(明文,TLS 由上游终结)。
快速开始
bash deploy/build.sh # 收集前端 + docker build + push 阿里云 CR
kubectl apply -f deploy/k8s/ipass-sso.yaml # wuguirong 租户 ns(NodePort 30089)
curl -fs http://192.168.1.26:30089/.well-known/openid-configuration
⚠️ build.sh 默认 TAG=ipass-sso-v0.6.0,发版要显式覆盖:TAG=ipass-sso-vX.Y.Z bash deploy/build.sh。
首次登录 admin / 123456(scripts/seed-data.sh 的 ADMIN_PASSWORD 默认值,另有
alice / alice123)——上线后立即改密。
装配清单与顺序
SsoPlugin → CorePlugin
顺序即端点认领顺序:SsoPlugin 排第一,接管 login/logout/session/users CRUD/me 等身份端点
(带 CAPTCHA、账号锁定、审计);CorePlugin 只补 sso 没有的端点。
文档
- 构建约束、踩坑与边界 →
CLAUDE.md - K8s 清单 →
deploy/k8s/ipass-sso.yaml、IAP 演示 →deploy/k8s/iap-demo.yaml - IAP 接入 →
docs/iap.md、docs/integrate-with-iap.md - 各插件自身文档 → 兄弟仓
ipass-plugin-*/CLAUDE.md;共享架构知识 →../ipass-all/CLAUDE.md