# ipass-sso iPass **身份网关**(SSO-only 精简版):`ipass-core` 内核 + `ipass-plugin-sso` 编译期装配成 **单个** nginx 动态模块(`libipass_sso_gateway.so`),一个容器跑完。单进程、零外部依赖 (无 DB / Redis / MQ)。全家桶版见 [`../ipass-all`](../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 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`](CLAUDE.md) - K8s 清单 → [`deploy/k8s/ipass-sso.yaml`](deploy/k8s/ipass-sso.yaml)、IAP 演示 → [`deploy/k8s/iap-demo.yaml`](deploy/k8s/iap-demo.yaml) - IAP 接入 → [`docs/iap.md`](docs/iap.md)、[`docs/integrate-with-iap.md`](docs/integrate-with-iap.md) - 各插件自身文档 → 兄弟仓 `ipass-plugin-*/CLAUDE.md`;共享架构知识 → `../ipass-all/CLAUDE.md`