更正为 2 个 named context、18098/NodePort 30089、PVC subPath sso、 PLUGINS=[SsoPlugin,CorePlugin]、4 条指令(无 audit_stats/probe_min); 删掉不存在的 plugin-architecture-analysis.md 死链,/userinfo 改为 /oauth/userinfo。
41 lines
1.9 KiB
Markdown
41 lines
1.9 KiB
Markdown
# 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`
|