Files
admin 377636c014 docs: 按 sso 实际重写 CLAUDE.md/README(原文整份是 ipass-all 拷贝)
更正为 2 个 named context、18098/NodePort 30089、PVC subPath sso、
PLUGINS=[SsoPlugin,CorePlugin]、4 条指令(无 audit_stats/probe_min);
删掉不存在的 plugin-architecture-analysis.md 死链,/userinfo 改为 /oauth/userinfo。
2026-11-04 10:43:04 +08:00

41 lines
1.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`