Compare commits
3
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
135880aab6 | ||
|
|
1ca543acf7 | ||
|
|
bcd55fe2ed |
No files matched your search
@@ -43,6 +43,7 @@ jweb/apps/*.md
|
||||
|
||||
# ===== refs:只保留 INDEX.md 和 国标/,其余子目录忽略 =====
|
||||
refs/FISCO-BCOS/
|
||||
refs/ipass-sso/
|
||||
refs/kuscia/
|
||||
refs/maxkey/
|
||||
refs/primihub/
|
||||
|
||||
@@ -0,0 +1,158 @@
|
||||
# 2026-09-14 工作日志
|
||||
|
||||
## SSW × ipass-sso 对接实测(跑通,全绿)
|
||||
|
||||
**背景**:探索用 ipass-sso 替代 MaxKey 作为 ssw-admin 的统一认证。本次从"可行性分析"推进到**本机实跑对接**。
|
||||
|
||||
**结论**:协议层零代码替换,端到端 **PASS=7 FAIL=0**。
|
||||
- ipass-sso(nginx 1.30.4 动态模块 + Rust)提供 MaxKey 端点别名 `/oauth/v20/token`、`/oauth/v20/me`,
|
||||
与 MaxKey 扁平字段逐字段一致;Basic Auth 与表单传密钥都收。
|
||||
- 主流程代码**一行未改**:`SsoBindController` 的 Basic 换 token + Bearer 拉 userinfo 原样可用。
|
||||
- 部署从 MaxKey(Java+DB+MQ) 降到单 nginx + 一个 `.so`(零外部依赖,JSON 文件存数据)。
|
||||
|
||||
**变更文件**(均未提交):
|
||||
- `boot/ssw-admin/src/main/resources/application.yml` — 新增 `config.oauth.sso.*` 段(7 键)
|
||||
- `boot/dist/config/application.yml` — 同步(运行时真正生效的是这份外挂配置)
|
||||
- `boot/ssw-tds/.../SsoBindController.java` — 加 `unwrapBody()` 信封解包兜底 + `ssoSource` 改 `ipass-sso`
|
||||
|
||||
**报告**:`~/.workbuddy/scratch/sso-explore/{ANALYSIS,RUNTIME-VALIDATION}.md`(主仓外,按"探索期产物不入 git")。
|
||||
> 待苏苏拍板后可考虑迁入 `docs/sso/`。
|
||||
|
||||
## 三个关键坑(详见 RUNTIME-VALIDATION.md §4)
|
||||
|
||||
1. **端点形态**:标准端点 `/oauth/token`、`/oauth/userinfo` 返回 `{code,data,msg}` 信封,且 `/oauth/userinfo`
|
||||
里**根本没有 `id`/`username`**(只有 `sub`/`preferred_username`)→ 必须用 `/oauth/v20/me`。
|
||||
2. **配置 key 路径差一层 `oauth`**(详见项目 MEMORY.md 新增红线)。
|
||||
3. **`f_sso_user_id` 列默认值是空串 `''` 而非 NULL** → `DELETE ... IN ('null','')` 误删全部用户。
|
||||
|
||||
## ⚠️ 事故与恢复:public.base_user 被误删 277 行
|
||||
|
||||
**经过**:为清理测试脏记录执行 `DELETE FROM base_user WHERE f_sso_user_id IN ('null','')`,
|
||||
因该列**默认值为空串**,把 277 个正常用户一并删除(`public.base_user` 清空)。autovacuum 随即回收死元组,
|
||||
pageinspect 抢救路径失效。
|
||||
|
||||
**恢复**:从 JNPF 多租户副本 `j79y92dh7w5jg1.base_user`(276 行,与 `j73ee0589rtwaq` 逐行一致)
|
||||
按「两 schema 共有 61 列」显式 INSERT 回 public;事务保护 + 「目标表为空」前置断言;
|
||||
恢复后逐行 EXCEPT 校验**完全一致**(276 行 / 2 个管理员 / admin 账号在位)。
|
||||
|
||||
**教训**(已进用户级 MEMORY.md):破坏性 SQL 前必须先 `SELECT count(*)` 看影响面;
|
||||
`IS NOT NULL` 要配 `AND <> ''`;删数据优先软删。
|
||||
|
||||
## 环境侧附注
|
||||
|
||||
- macOS 自带 **bash 3.2**:变量名紧跟多字节字符会被吞进变量名 → `local-serve.sh` 报
|
||||
`CONF: unbound variable`。脚本内一律 `${VAR}`。
|
||||
- 本机有 `HTTP_PROXY`(CodeBuddy 代理)→ 所有 `curl` 必须 `--noproxy '*'`。
|
||||
- `run-local-e2e.sh --keep` 不会让 nginx 常驻(父进程退出带走子进程)→ 用 daemon 模式单起。
|
||||
|
||||
## 遗留 TODO
|
||||
|
||||
1. `signJnpfToken()` 仍是占位符(返回 `sso-token-<uid>-<first|returning>`,**非真 Sa-Token**)——
|
||||
是"跑通对接"与"可用于生产登录"之间唯一实质缺口。
|
||||
2. `config.ssoEnabled: false`,未启用前端跳转开关(当前是手动打 callback 端点验证)。
|
||||
3. ipass-sso 安全闭环(失败锁定/密码策略/TOTP/踢出)在 roadmap 未实现。
|
||||
|
||||
## 产物转正:`docs/sso/ipass-sso/` 归档
|
||||
|
||||
按苏苏指令,探索产物从主仓外 `~/.workbuddy/scratch/sso-explore/` **转入 `docs/sso/ipass-sso/` 正式归档**(5 文件):
|
||||
|
||||
| 文件 | 内容 |
|
||||
|---|---|
|
||||
| `README.md` | 索引 + 结论摘要 + 替换改动清单 + 快速上手 + 遗留 TODO(**新写**) |
|
||||
| `ANALYSIS.md` | 可行性分析(原稿 + **新增「实测复核」节**,逐条标注预判 vs 实测差异) |
|
||||
| `RUNTIME-VALIDATION.md` | 端到端实测报告(路径引用已改到新位置) |
|
||||
| `scripts/e2e-ssw-ipass.sh` | 端到端验证脚本(7 断言,含 base_user 落库复查) |
|
||||
| `scripts/probe-me.sh` | UserInfo 凭证探针(**重写为自包含**:内置登录步骤;原版依赖手工留下的 cookie jar,不可独立复现) |
|
||||
|
||||
**验证**:归档副本独立跑通 `PASS=7 FAIL=0`;本次 `firstLogin=false`(第二次登录),
|
||||
顺带覆盖「账号已存在走更新分支」,比首跑(`firstLogin=true`)覆盖面更全。
|
||||
`bash -n` 两脚本语法 OK;文档内相对链接均可达。
|
||||
|
||||
**git 状态**:`docs/sso/ipass-sso/` 为 untracked(**未被 ignore,可跟踪**),本次**未提交**;
|
||||
`boot/` 侧 2 文件(`application.yml` + `SsoBindController.java`)仍为 modified 未提交。
|
||||
|
||||
**对接凭据说明**(已写入 README §7):`ssw-test-app-id` / `ssw-test-secret-*` / `admin:123456` / `alice:alice123`
|
||||
均为本机联调测试值,与 `application.yml` 现有配置一致,**非生产凭据**。
|
||||
|
||||
---
|
||||
|
||||
## 【续】补上"真登录"两块缺口 —— 端到端 PASS=12(2026-09-14 下午)
|
||||
|
||||
**触发**:苏苏"去处理" → 把 `signJnpfToken` 占位符修掉,让 SSO 登录**真的能用**。
|
||||
|
||||
**做了什么(3 处 Java 改动 + 1 处配置 + 脚本加固)**:
|
||||
|
||||
1. `signJnpfToken()` **真签发 Sa-Token** —— 复刻 JNPF 官方 `AbstractTokenGranter#loginAccount` 三步:
|
||||
`loginService.userInfo(u, sysInfo)` → `UserProvider.login(u)` → `u.getToken()`。
|
||||
2. `ensureDefaultRole()` **幂等补挂默认角色** —— 修掉 `checkUser` 抛 LOG004「账号权限不足」。
|
||||
3. `application.yml` 加 `config.oauth.sso.default-role-id/-code`(默认 enCode `user`)。
|
||||
4. e2e 脚本 Step[5] 断言从 **HTTP 状态码**改为 **body 业务码**(原断言是**假通过**:
|
||||
JNPF 一律返 HTTP 200,鉴权结果在 `code` 里 —— 无 token 是 600「登录过期」);
|
||||
Step[4] 新增"SSO 账号已挂角色"回归护栏。
|
||||
|
||||
**验证(强证据,非"跑通"口号)**:
|
||||
- 删掉影子账号 → 全新建号重跑,`firstLogin=true` 走完整首登路径。
|
||||
- `/api/oauth/me` 无 token → `code=600`;带 token → `code=200` + `{"userAccount":"sso_alice","userName":"爱丽丝"}`。
|
||||
- 落库 `f_log_success_count=1` → 证明 Sa-Token 的 `LoginListener` 真执行(不是伪造)。
|
||||
- `base_role_relation` 确有 1 条(role `user`/使用者,`f_delete_mark=NULL`)。
|
||||
- **PASS=12 FAIL=0**。
|
||||
|
||||
**关键认知纠偏(都是弯路,已进 docs)**:
|
||||
- ⚠️ `LOG004=账号权限不足`、`LOG010=此IP未在白名单中` —— 我一开始按 LOG010 查 IP 白名单,**全是无用功**。
|
||||
教训:**用 message.properties 精确对号,别凭文案猜**。
|
||||
- ⚠️ 原 ANALYSIS.md §5.3 里写的"应该改成 `StpUtil.login(userId)` + `getTokenValue()`"是**错的**:
|
||||
会触发 `LoginListener#doLogin` 读空的 `LoginHolder` → NPE。必须先 `loginService.userInfo()` 装实体。
|
||||
- ⚠️ `checkUser` 短路条件极严:必须 `account` **字面等于 `admin`** 且 `is_administrator=1`;
|
||||
光设 `f_is_administrator=1` 但账号叫 `sso_alice` **不能**短路。
|
||||
|
||||
**踩坑细节落位**:`docs/sso/ipass-sso/RUNTIME-VALIDATION.md` §4 坑 4/坑 5(含反编译源码片段 +
|
||||
`-am` 增量构建不刷新内嵌 jar 的标准处置命令);结论纠偏同步进 `README.md` / `ANALYSIS.md`。
|
||||
|
||||
**git 状态**:仍未提交。改动文件 = `boot/ssw-admin/src/main/resources/application.yml`、
|
||||
`boot/dist/config/application.yml`、`boot/ssw-tds/.../SsoBindController.java`、
|
||||
`docs/sso/ipass-sso/{README,ANALYSIS,RUNTIME-VALIDATION}.md`、`docs/sso/ipass-sso/scripts/e2e-ssw-ipass.sh`。
|
||||
|
||||
**备份**:删影子账号前的完整行 JSON 存 `/tmp/sso-backup/`(base_user + base_role_relation)。
|
||||
|
||||
---
|
||||
|
||||
## 【回滚】ipass-sso 代码改动撤销,只留文档(2026-09-14 14:40)
|
||||
|
||||
**触发(苏苏决策)**:① `refs/ipass-sso/` **不入仓**;② `docs/sso/ipass-sso/` **入仓**;
|
||||
③ `boot/` 改动**回滚到本会话之前的状态**——放弃 ipass-sso 验证代码,**保持原 MaxKey 方案**。
|
||||
|
||||
**执行**:
|
||||
- 安全网:备份分支 `sso-real-token-9340b3d` 指向原提交 `9340b3d`;patch 存
|
||||
`/tmp/sso-boot-rollback-backup.patch`(`git diff f9d8169 9340b3d -- boot/`,27750 字节,2 文件)。
|
||||
- `git reset --soft HEAD~1`(该提交**未 push**,改写安全)→
|
||||
`git restore --source=f9d8169 --staged --worktree <2 个 boot 文件>`。
|
||||
- 校验:`git diff f9d8169 -- boot/` **为空**;yml 回到 MaxKey `9527/sign`(`config.oauth.sso.*` 段不存在);
|
||||
`SsoBindController` 回到 3 参数 `signJnpfToken` 占位版(217 行、构造器只注 `JdbcTemplate`、无 `LoginService`)。
|
||||
- 最终提交收窄为:`docs/sso/ipass-sso/**`(5 文件)+ `.gitignore`(补 `refs/ipass-sso/` 忽略)+ memory。
|
||||
|
||||
**遗留状态(后续注意)**:
|
||||
- `boot/dist/` 里的 jar 与 `dist/config/application.yml` 仍是**带 ipass-sso 修复**的产物;**重编即回退**到 MaxKey。
|
||||
- 运行中的 30000 进程是旧 jar(带修复),与仓库源码**不一致**,属预期,未动。
|
||||
- 本会话的技术结论**不受回滚影响**(JNPF 登录骨架三步 / `checkUser` LOG004 / `-am` 增量构建坑),
|
||||
已留在 `docs/sso/ipass-sso/RUNTIME-VALIDATION.md` §4 与 `MEMORY.md`。
|
||||
- 环境侧小坑:本机偶发**吞 Bash stdout**(同一条命令直接重跑即可),以及"删影子账号"类命令会触发授权确认。
|
||||
|
||||
---
|
||||
|
||||
## 14:49 推送:备份分支入库 + README §8
|
||||
|
||||
用户要求「README 注释一下这个分支,然后一起推」。
|
||||
|
||||
- `docs/sso/ipass-sso/README.md` 新增 **§8「代码备份分支 `sso-real-token-9340b3d`」**:
|
||||
来历(`9340b3d` 曾是本地 `main` 的 HEAD、**从未 push**、被 `reset --soft` 改写 → 不属于 `main` 历史,
|
||||
该分支是唯一留存)、内容(仅 `boot/` 2 文件)、基线 `f9d8169`、取回命令
|
||||
(`git diff f9d8169 sso-real-token-9340b3d -- boot/ | git apply`)、取回后仍需补的 4 项
|
||||
(IdP 接入方注册 / groups→角色映射 / 前端跳转 / dist 重编),以及
|
||||
「**长期备份勿在其上直接开发**,确认不用则 `git push origin --delete` + `git branch -D`」。
|
||||
顶部「代码落地状态」的分支说明改为指向 §8。
|
||||
- 推送结果(`git ls-remote` 核对远端 SHA):
|
||||
- `main` → `1ca543a`(38+/1-,1 文件),`origin/main`/`origin/HEAD` 已同步,ahead/behind = 0/0
|
||||
- `sso-real-token-9340b3d` → 远端同 SHA `9340b3d3306…`(备份分支已上远端,不再只在本地)
|
||||
- 环境噪声:`fatal: unable to get credential storage lock`(陈旧锁 `~/.git-credentials.lock`,无进程占用)
|
||||
不阻塞推送(远端 URL 内嵌凭据),但污染输出;同一条命令本轮被执行两次(首次已 commit+push,
|
||||
重跑因无变更输出 "nothing added to commit")—— 判定以 `ls-remote` 的实际 SHA 为准。
|
||||
@@ -35,3 +35,23 @@
|
||||
- **镜像配方**:`deploy/mirrors/{tdc,nax}/Dockerfile`(build context 不同:tdc=deploy/mirrors/tdc/,nax=仓库根)
|
||||
- **关键能力**:tdc 含 `app.jar`(lite-TDC,143MB) + connector + easytier + **kubectl**(in-cluster K8sSandboxClient 用,lite 不带 Nax2PJobController 但 kubectl 已就位);nax 含 nax 包 + **ray[client]** + nax_2p.py/paillier.py/nax_adapter.py/connector_stub.py/fixtures/connector-data-src(全部在 `/opt/ssw-nax-runtime/`,PYTHONPATH=/app/nax:/opt/ssw-nax-runtime)。
|
||||
- **真两方 kubectl 直驱 Job 验证(2026-08-20 lite 版)**:AUC=0.7799 KS=0.4389 n_common=2400 双 Pod Completed;**lite 部署形态 = 每方仅 1 Pod**(`boot/deploy/per-party/party-{a,b}-lite.yaml`,无外部 PG/Redis、无 PVC、无 initContainer)。⚠️ 文档**漏 apply** `boot/ssw-tdc/ssw-tdc-biz/src/main/resources/k8s/nax-2p-ray-head-svc.yaml`(B 端 ray start 需要这个 Service DNS 拨号到 A 的 GCS)。⚠️ k8s env.PYTHONPATH 覆盖镜像 ENV,yaml 模板 hardcode 路径要跟镜像对齐(之前 `/opt/ssw-nax-runtime` 缺 `/app/nax` 致 `import nax` 失败,已修)。⚠️ lite 部署**不要**给 ssw-admin 注入外部 `DB_HOST/REDIS_HOST` env,lite 兼容垫片启动期自动拉起内嵌 PG + 内存 Sa-Token,误注入外部 env 反而 `can not find datasource` 冲突。
|
||||
|
||||
## SSO:ipass-sso 替代 MaxKey(2026-09-14 实测通过,⚠️ 代码已回滚/保持 MaxKey)
|
||||
- **配置命名空间红线**:`SsoBindController` 的 9 个 `@Value` 读 **`config.oauth.sso.*`**;而 yml(jnpf 原生)写的是 **`config.sso.*`**(少一层 `oauth`)→ 两边不通用。**曾因差这一层,改 yml 完全不生效、静默落到 `@Value` 默认值**(症状极具迷惑性:baseUrl 看着对,其实是默认值恰好写对了)。SSW 的 SSO 配置必须显式落在 `config.oauth.sso.*`。
|
||||
- **profile 覆盖关系**:`application-dev.yml` 里另有一份 `config.sso.*`(MaxKey 旧值 `baseUrl: 8527`),dev profile 激活时**覆盖** `application.yml` 的同名路径;但 `config.oauth.sso.*` 只在 `application.yml` 定义 → 不被覆盖(正好可用)。
|
||||
- **端点选择(必须)**:用 MaxKey 别名 `/oauth/v20/token`(裸对象)+ `/oauth/v20/me`(MaxKey 扁平字段 `id/userid/username/realname/displayName/email/mobile`)。标准端点 `/oauth/token`、`/oauth/userinfo` 返回 `{code,data,msg}` 信封,且 `/oauth/userinfo` **没有 id/username**(只有 `sub`/`preferred_username`)→ 配标准端点不是等价选项。`SsoBindController` 已加 `unwrapBody()` 兼容信封作双保险。
|
||||
- **客户端鉴权**:ipass-sso 的 Basic Auth 与表单传密钥**都收**;secret 明文(不需要 MaxKey 的 `PasswordReciprocal.encode`)。
|
||||
- **部署**:`config/` 必须与 jar 同目录作外挂配置(`cd boot/dist && java -jar ssw-admin-*.jar`),否则修改不生效。
|
||||
- **遗留缺口 + ⚠️ 代码已回滚**:~~`signJnpfToken()` 仍返回占位串~~ → ✅ 2026-09-14 **已验证可行**(真签发 Sa-Token + SSO 影子账号自动挂默认角色,e2e `PASS=12`)。但 **该实现已按决策回滚、未留在仓库**——仓库 `boot/` 仍是 **MaxKey** 方案(`127.0.0.1:9527/sign`,等价 commit `3b393a3`)。备份分支 `sso-real-token-9340b3d`(patch:`git diff f9d8169 sso-real-token-9340b3d -- boot/`)。⚠️ `boot/dist/` 现存 jar 仍是带修复的旧产物,**一重编 ipass-sso 效果即消失**。剩余缺口见 `docs/sso/ipass-sso/README.md` §5(`ssoEnabled:false` 未接前端跳转、安全闭环、IdP groups→角色映射)。
|
||||
- **文档归档(入仓)**:`docs/sso/ipass-sso/`(`README.md` 索引 + `ANALYSIS.md` 可行性分析 + `RUNTIME-VALIDATION.md` 端到端实测 + `scripts/{e2e-ssw-ipass,probe-me}.sh`)。原探索稿曾在主仓外 `~/.workbuddy/scratch/sso-explore/`,2026-09-14 转入 docs 正式归档。
|
||||
- **`refs/ipass-sso/` 不入仓(2026-09-14 苏苏决策)**:外部参考仓(196M,**自带 `.git`**,origin = `http://192.168.1.18:13300/ssw/sso.git`),已在 `.gitignore` 加忽略行(与 `refs/FISCO-BCOS`/`refs/maxkey` 等大依赖一致)。**别对它 `git add`** —— 自带 `.git` 只会存成一个空 gitlink(源码仍留本地 `refs/ipass-sso/`)。
|
||||
|
||||
## 🚨 JNPF 登录/账号硬约束(2026-09-14 实测,适用于所有"程序化建号/登录"场景)
|
||||
|
||||
- **`checkUser` 短路条件极严**:`LoginServiceImpl#checkUser` 只有 **`account` 字面等于 `admin` 且 `f_is_administrator=1`** 才跳过权限校验。**光把 `f_is_administrator` 设成 1 但账号叫别的(`sso_alice`/`tss2dev`)不能短路**,仍走角色检查。
|
||||
- **非 admin 账号必须有"角色 + 该角色有存量授权"**,否则抛 `LOG004「账号权限不足」`。判定 = `positions(userId) + [userId] + roles(...)` 非空,**且** `base_authorize` 里有 `f_object_id ∈ 该列表` 的行。→ 程序化建号(SSO 影子账号等)**必须同步写 `base_role_relation`(`f_object_type='user'`, `f_object_id=userId`, `f_role_id=roleId`)**,且该角色在 `base_authorize` 有行(内置 `user` 18 条 / `manager` 101 条)。`position` 关系**非必需**。
|
||||
- **报错码对号入座**:`LOG004=账号权限不足`(角色/授权缺失)、`LOG007=账号已被删除`(`f_delete_mark` 非 NULL)、`LOG010=此IP未在白名单中`、`LOG101=账号或密码错误`。⚠️ **不要凭文案猜错码** —— 曾把 LOG004 误判为 LOG010,白查一通 IP 白名单。
|
||||
- **`f_delete_mark` 语义分系统**:Tdc 认 `NULL|0`,Tds 只认 `NULL`;JNPF 基座账号同理用 **`NULL`**(`0` 会被 `checkUser` 当"已删除"?不——`checkUser` 只在 `==1` 时判删。但本项目约定统一写 `NULL`)。
|
||||
- **JNPF 鉴权结果在 body 的 `code`,HTTP 恒 200**:未登录 = `code:600「登录过期,请重新登录」`,成功 = `code:200`。→ **写鉴权断言必须比 body 码,比 HTTP 状态码会假通过**(`200 eq 200` 永远成立)。
|
||||
- **真签发 Sa-Token 的标准三步**(复刻 `AbstractTokenGranter#loginAccount`):`loginService.userInfo(u, sysInfo)`(加载 `UserEntity` 进 `LoginHolder`,缺则 `LoginListener#doLogin` NPE)→ `UserProvider.login(u)`(内部 `StpUtil.login(splicingLoginId(userId))`)→ `u.getToken()`。**切勿改成 `StpUtil.login(userId)` + `getTokenValue()`**(`loginId` 是 `{datasourceId}:{userId}`,裸 id 与 `checkLogin()` 路径对不上)。`u.setUserDetailKey(AuthConsts.USERDETAIL_ACCOUNT)` 必设。
|
||||
- **构建陷阱**:`ssw-*-(biz|controller|entity)` 是普通 library jar,以 sub-jar 进 `ssw-admin` 的 `BOOT-INF/lib/`。**`mvn -pl ssw-admin -am package` 的增量构建不会刷新内嵌的那份** → 表现"改完没生效"。**必须先 `rm -f ssw-admin/target/ssw-admin-7.0.0-RELEASE.jar` 再构建,并用 `javap` 验内嵌类是新版**。
|
||||
@@ -0,0 +1,436 @@
|
||||
# SSW × ipass-sso 集成分析(替代 MaxKey 可行性)
|
||||
|
||||
> **性质**:可行性分析(预判阶段产出,2026-09-14)| 分析者:小 K
|
||||
> **本文档为预判结论**;其后的本机实测复核见 [`RUNTIME-VALIDATION.md`](RUNTIME-VALIDATION.md)(端到端 `PASS=12 FAIL=0`,含真 Sa-Token 签发)。预判与实测的差异见 §1 末尾「实测复核」。
|
||||
> 目的:判定 ipass-sso(`http://192.168.1.18:13300/ssw/sso.git`,已 clone 到 `refs/ipass-sso/`)能否替代当前 MaxKey(`refs/maxkey/`)作为 SSW 统一认证中心。
|
||||
> 对照基线:`docs/sso/MAXKEY_INTEGRATION_PLAN.md`(OAuth2 主流程已跑通,commit `3b393a3`) + `boot/ssw-tds/ssw-tds-controller/.../SsoBindController.java`(218 行)。
|
||||
>
|
||||
> ⚠️ **代码落地状态(2026-09-14 更新)**:本文第 4 章所述的 `boot/` 改动方案**已验证可行但已按决策回滚**,
|
||||
> 仓库 `boot/` 回到 MaxKey 方案(`9527/sign`,即 commit `3b393a3` 的状态)。第 4 章保留为**将来真正切换时的实施方案**;
|
||||
> 备份分支 `sso-real-token-9340b3d`。
|
||||
|
||||
---
|
||||
|
||||
## 1. 结论先看(TL;DR)
|
||||
|
||||
| 维度 | 结论 |
|
||||
|---|---|
|
||||
| **协议兼容性** | ✅ **极高(≥95%)**。ipass-sso 设计目标就是"照抄 MaxKey 文档写出来的应用/客户端,不改一行代码就能对接本 IdP"(`docs/design.md` §15)。OAuth2 授权码流 + UserInfo 字段全部覆盖。 |
|
||||
| **代码改动量** | **极小**。`SsoBindController.java` 改动 < 50 行:仅换 baseUrl/URL、调整 UserInfo 字段映射、改 clientSecret 为明文(去掉 PasswordReciprocal.encode)。 |
|
||||
| **部署简化** | ✅ **更轻量**。MaxKey 需要 Java + MySQL + RocketMQ 三件套;ipass-sso 仅需 nginx + 1 个 `.so` 模块 + JSON 文件。 |
|
||||
| **资源占用** | ✅ **更小**。MaxKey 启动 ~90s;ipass-sso nginx 模块 reload < 1s。 |
|
||||
| **多租户支持** | ⚠️ **无**。ipass-sso 单实例;MaxKey IDaas Multi-Tenancy 也未启用(按 §6 #13 已决策延后),**影响为零**。 |
|
||||
| **RocketMQ 用户同步** | ❌ **缺失**。MaxKey 的 `MXK_IDENTITY_MAIN_TOPIC` 实时同步用户增删改;ipass-sso 无 MQ,改用 SsoBindController 在登录时拉 userinfo(**已实现**)。 |
|
||||
| **扩展协议** | ❌ **SAML 2.0 / CAS / SCIM / LDAP / 社交登录 全部未实现**。SSW 当前只用 OAuth2,**不影响**;但未来若需要 CAS,ipass-sso 已列入 roadmap。 |
|
||||
| **安全运营闭环** | ❌ **缺失**。登录失败锁定、密码策略、TOTP、图形验证码、踢出、审计:MaxKey 有现成的;ipass-sso 在 P0 迁移路线(`docs/maxkey-migration-analysis.md`),**当前未实现**。SSW 需自行补 SsoBindController 端的失败计数。 |
|
||||
| **海量用户场景** | ❌ **不适合**。ipass-sso 文件 + 共享内存,**不适合百万级用户**。SSW 子空间预期用户 < 10K 量级,**够用**。 |
|
||||
|
||||
**推荐**:✅ **可以替代**。协议层 100% 兼容,部署更简单,资源占用更小;功能边界明确(SAML/CAS/MQ 同步等扩展能力缺失)。本期可推进替换,但需明确记录"安全运营闭环需 SSW 端补齐"。
|
||||
|
||||
### 实测复核(2026-09-14 当天,详见 `RUNTIME-VALIDATION.md`)
|
||||
|
||||
用完整 `ssw-admin`(full profile)+ 本机 ipass-sso 跑通端到端后,对上述预判的修正:
|
||||
|
||||
| 预判 | 实测结果 |
|
||||
|---|---|
|
||||
| 需改 `baseUrl` + 2 个 URL + UserInfo 字段映射 + clientSecret 明文化 | ✅ 实测**更宽松**:OAuth2 主流程**一行未改**,只需在 yml 新增 `config.oauth.sso.*` 段(改用别名端点)+ ipass-sso 侧注册接入方 |
|
||||
| 改 UserInfo 字段映射(`id/displayName` → `userid/realname`) | ℹ️ **不必要**:`/oauth/v20/me` 同时返回 `id`、`userid`、`displayName`、`realname` 全部别名,原映射天然兼容 |
|
||||
| 端点响应形态差异(裸对象 vs 信封) | ✅ 证实,但**只对标准端点成立**:`/oauth/v20/token` 与 `/oauth/v20/me` 均为裸对象/扁平字段,与 MaxKey 一致。**必须用别名端点** |
|
||||
| —(预判遗漏) | ⚠️ **新增坑 2**:yml 里配置写在 `config.sso.*`,而代码读 `config.oauth.sso.*` —— 差一层 `oauth`,7 个 `@Value` **全部静默落到默认值**(表现为"改配置没反应") |
|
||||
| —(预判遗漏) | ⚠️ **新增坑 3**:`f_sso_user_id` 列默认值是**空串而非 NULL**,用 `IN ('null','')` 清理会误删全部未绑定 SSO 的正常用户(本次已完整恢复) |
|
||||
|
||||
**净结论不变**:可替代,且比预判更容易(改动量从"< 50 行"降到"零 Java 主流程改动")。
|
||||
|
||||
> ⚠️ 以上均为**协议层**结论,与 `boot/` 代码无关,**不受 2026-09-14 代码回滚影响**;
|
||||
> 第 4 章列的 `boot/` 改动当前**未落在仓库**(见文首代码落地状态)。
|
||||
|
||||
---
|
||||
|
||||
## 2. ipass-sso 是什么
|
||||
|
||||
### 2.1 一句话定位
|
||||
|
||||
**nginx 动态模块 + Rust**,自包含的 OAuth2.0 / OIDC 身份提供者(IdP)+ 身份感知代理(IAP),**单进程、无数据库、无 Redis、无消息队列**。
|
||||
|
||||
### 2.2 部署形态
|
||||
|
||||
```text
|
||||
nginx + libsso_gateway.{dylib,so} # 主程序
|
||||
├── data/users.json # 用户(账号/密码/email/部门/组)
|
||||
├── data/oauth_clients.json # OAuth 接入方注册表
|
||||
├── data/sessions (共享内存) # SSO 会话 / 授权码 / 客户端配置
|
||||
└── www/admin.html # 管理台(账号 / 接入方 / 接入指南)
|
||||
```
|
||||
|
||||
**端点**(默认端口 18098):
|
||||
| 方法 | 路径 | 用途 |
|
||||
|---|---|---|
|
||||
| GET | `/oauth/authorize` | 授权端点(未登录跳登录页) |
|
||||
| POST | `/oauth/token` | 换发(`authorization_code / refresh_token / client_credentials / password`,含 PKCE) |
|
||||
| GET/POST | `/oauth/userinfo` | 当前令牌对应用户声明 |
|
||||
| POST | `/oauth/introspect` | RFC 7662 自省(第三方校验,需客户端鉴权) |
|
||||
| GET | `/.well-known/openid-configuration` | OIDC discovery |
|
||||
| GET | `/oauth/jwks` | 公钥(HS256 无,404;v2 才上 RS256) |
|
||||
| GET/POST | `/login` | 登录页 + 表单提交 |
|
||||
| POST | `/oauth/logout` | 注销 |
|
||||
|
||||
### 2.3 MaxKey 协议兼容性(**关键卖点**)
|
||||
|
||||
ipass-sso README §"协议兼容 MaxKey":
|
||||
|
||||
> **协议兼容 MaxKey**:提供 `/oauth/v20/*`、`/oauth2.0/*` 端点别名与 context-path 归一化,照抄 MaxKey 文档的第三方应用不用改一行代码。
|
||||
|
||||
**端点别名**(实测 `tests/oauth2-maxkey-e2e.sh` 24 项全过):
|
||||
|
||||
| MaxKey 路径 | ipass-sso 路径(别名) |
|
||||
|---|---|
|
||||
| `/oauth/v20/authorize` | ✅ 直接命中 |
|
||||
| `/oauth/v20/token` | ✅ 直接命中 |
|
||||
| `/oauth/v20/me` | ✅ 直接命中 |
|
||||
| `/oauth2.0/authorize` | ✅ 直接命中 |
|
||||
| `/oauth2.0/accessToken` | ✅ 直接命中 |
|
||||
| `/oauth2.0/profile` | ✅ 直接命中 |
|
||||
| `/oauth/v20/logout` | ✅ 直接命中 |
|
||||
| `/maxkey/...` | ✅ context-path 自动归一化(剥 `/maxkey`) |
|
||||
| `/sign/authz/...` | ✅ context-path 自动归一化(剥 `/sign/authz`) |
|
||||
| `/sign/api/oauth/v20/me` | ✅ context-path 自动归一化(剥 `/sign/api`) |
|
||||
| `/sign/...` | ✅ context-path 自动归一化(剥 `/sign`) |
|
||||
| `/authz/...` | ✅ context-path 自动归一化(剥 `/authz`) |
|
||||
| `/api/...` | ✅ context-path 自动归一化(剥 `/api`,**但不遮蔽** `/api/v1/*` `/api/admin/*`) |
|
||||
|
||||
**UserInfo 字段(MaxKey 扁平格式)**:
|
||||
```json
|
||||
{
|
||||
"username": "alice", // 登录账号(= sub)
|
||||
"userid": "alice", // 同 username
|
||||
"realname": "爱丽丝", // 显示名
|
||||
"email": "alice@...",
|
||||
"mobile": "138...",
|
||||
"id": "alice", // 别名 = username
|
||||
"userId": "alice", // 别名 = username
|
||||
"displayName": "爱丽丝" // 别名 = realname
|
||||
}
|
||||
```
|
||||
|
||||
**OAuth2 grant 支持**:`authorization_code`(含 PKCE)/ `refresh_token` / `client_credentials` / `password`。
|
||||
|
||||
**客户端鉴权**:Basic Auth + 表单 `client_id/secret` 都接受。
|
||||
|
||||
**Token 模型**:HS256 JWT(对称密钥,第三方**无法本地验签**,统一走 introspect;v2 才上 RS256+JWKS)。
|
||||
|
||||
### 2.4 用户/客户端存储
|
||||
|
||||
```json
|
||||
// source/data/users.json(节选)
|
||||
{
|
||||
"username": "alice",
|
||||
"password_hash": "sha256(...)", // salt:password sha256 1000 轮
|
||||
"email": "alice@...",
|
||||
"department": "研发部",
|
||||
"groups": ["rd", "eng"] // 必须是 JSON 数组,不能是字符串!
|
||||
}
|
||||
|
||||
// source/data/oauth_clients.json(节选)
|
||||
{
|
||||
"client_id": "demo-system",
|
||||
"client_secret": "cs_xxx...", // 明文
|
||||
"redirect_uris": ["http://..."],
|
||||
"grant_types": ["authorization_code", "refresh_token"],
|
||||
"scopes": ["openid", "profile", "email"],
|
||||
"confidential": true
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 3. 当前 SSW × MaxKey 集成面(baseline)
|
||||
|
||||
### 3.1 已落地的实施
|
||||
|
||||
- ✅ OAuth2 主流程跑通(commit `3b393a3`)
|
||||
- ✅ `SsoBindController` 实现 `/api/ssw/tds/SsoBind/oauth2`(@SaIgnore)
|
||||
- ✅ `base_user` 加 5 字段:`f_sso_user_id / f_sso_source / f_sso_app_id / f_sso_bind_time / f_sso_last_login`
|
||||
- ✅ MaxKey 应用注册走 SQL(不走 UI:`mxk_apps` + `mxk_apps_oauth_client_details` + `mxk_access` 三表)
|
||||
|
||||
### 3.2 SsoBindController 关键代码(节选)
|
||||
|
||||
```java
|
||||
@Value("${config.oauth.sso.baseUrl:http://127.0.0.1:9527/sign}")
|
||||
private String ssoBaseUrl;
|
||||
|
||||
@Value("${config.oauth.sso.auth2.clientId:ssw-test-app-id}")
|
||||
private String ssoClientId;
|
||||
|
||||
@Value("${config.oauth.sso.auth2.clientSecret:ssw-test-secret-2026-long-enough-1234567890}")
|
||||
private String ssoClientSecret; // ⚠️ 在 MaxKey 模式下这是 PasswordReciprocal.encode 后的值
|
||||
|
||||
@Value("${config.oauth.sso.auth2.accessTokenUrl:http://127.0.0.1:9527/sign/authz/oauth/v20/token}")
|
||||
private String ssoAccessTokenUrl;
|
||||
|
||||
@Value("${config.oauth.sso.auth2.userInfoUrl:http://127.0.0.1:9527/sign/api/oauth/v20/me}")
|
||||
private String ssoUserInfoUrl;
|
||||
|
||||
// token 换发:Basic Auth + form body
|
||||
String basicAuth = Base64.getEncoder().encodeToString(
|
||||
(ssoClientId + ":" + ssoClientSecret).getBytes(StandardCharsets.UTF_8));
|
||||
headers.set("Authorization", "Basic " + basicAuth);
|
||||
String body = "grant_type=authorization_code&code=...&redirect_uri=...";
|
||||
|
||||
// userinfo:Bearer
|
||||
headers.set("Authorization", "Bearer " + accessToken);
|
||||
|
||||
// 字段映射(MaxKey 风格)
|
||||
String ssoUserId = String.valueOf(userInfo.get("id")); // MaxKey 用 "id"
|
||||
String realName = (String) userInfo.getOrDefault("displayName",
|
||||
userInfo.getOrDefault("username", localAccount));
|
||||
String email = (String) userInfo.getOrDefault("email", "");
|
||||
String mobile = (String) userInfo.getOrDefault("mobile", "");
|
||||
|
||||
// 自动建账号 + 真签发 Sa-Token(2026-09-14 已验证;⚠️ 该实现已回滚,仓库当前仍是占位版,详见 §5.3)
|
||||
```
|
||||
|
||||
### 3.3 当前依赖的 MaxKey 特性
|
||||
|
||||
| 特性 | MaxKey | SSW 当前是否依赖 |
|
||||
|---|---|---|
|
||||
| OAuth2 授权码流 | ✅ | ✅ |
|
||||
| OAuth2 token 换发 | ✅ | ✅ |
|
||||
| UserInfo 端点 | ✅ | ✅ |
|
||||
| RocketMQ `MXK_IDENTITY_MAIN_TOPIC` 用户同步 | ✅ | ❌ **未启用**(按 §6 #10 决策) |
|
||||
| 应用管理后台(注册 OAuth 客户端) | ✅ maxkey-mgt | ⚠️ OOM Killed,走 SQL 注册 |
|
||||
| 多租户 IDaas | ✅ | ❌ **未启用**(按 §6 #13 决策) |
|
||||
| SAML 2.0 / CAS / SCIM | ✅ | ❌ |
|
||||
| LDAP / AD / 社交登录 | ✅ | ❌ |
|
||||
|
||||
---
|
||||
|
||||
## 4. 替换方案(具体改动)
|
||||
|
||||
### 4.1 配置改动(application.yml)
|
||||
|
||||
```yaml
|
||||
# 当前(MaxKey)
|
||||
config:
|
||||
oauth:
|
||||
sso:
|
||||
baseUrl: http://127.0.0.1:9527/sign
|
||||
auth2:
|
||||
clientId: ssw-test-app-id
|
||||
clientSecret: <PasswordReciprocal.encode 后值>
|
||||
accessTokenUrl: http://127.0.0.1:9527/sign/authz/oauth/v20/token
|
||||
userInfoUrl: http://127.0.0.1:9527/sign/api/oauth/v20/me
|
||||
```
|
||||
|
||||
↓ 改成 ↓
|
||||
|
||||
```yaml
|
||||
# 新(ipass-sso)
|
||||
config:
|
||||
oauth:
|
||||
sso:
|
||||
baseUrl: http://127.0.0.1:18098 # ipass-sso,无 /sign 前缀
|
||||
auth2:
|
||||
clientId: ssw-test-app-id
|
||||
clientSecret: <明文> # 不需要 PasswordReciprocal.encode
|
||||
accessTokenUrl: http://127.0.0.1:18098/oauth/v20/token # 或 /sign/authz/oauth/v20/token(context-path 兼容)
|
||||
userInfoUrl: http://127.0.0.1:18098/oauth/v20/me # 或 /sign/api/oauth/v20/me(context-path 兼容)
|
||||
```
|
||||
|
||||
### 4.2 Java 代码改动(SsoBindController)
|
||||
|
||||
仅 2 处:
|
||||
|
||||
**改动 1**:UserInfo 字段映射(MaxKey `id/displayName` → ipass-sso `userid/realname`):
|
||||
```java
|
||||
// 当前(MaxKey)
|
||||
String ssoUserId = String.valueOf(userInfo.get("id"));
|
||||
String realName = (String) userInfo.getOrDefault("displayName",
|
||||
userInfo.getOrDefault("username", localAccount));
|
||||
|
||||
// 改成(兼容 MaxKey + ipass-sso 双字段)
|
||||
String ssoUserId = String.valueOf(
|
||||
userInfo.getOrDefault("id", userInfo.getOrDefault("userid", userInfo.get("username"))));
|
||||
String realName = (String) userInfo.getOrDefault("realname",
|
||||
userInfo.getOrDefault("displayName",
|
||||
userInfo.getOrDefault("name", userInfo.get("username"))));
|
||||
String email = (String) userInfo.getOrDefault("email", "");
|
||||
String mobile = (String) userInfo.getOrDefault("mobile", "");
|
||||
```
|
||||
|
||||
**改动 2**:去掉 PasswordReciprocal.encode(clientSecret 直接明文 Basic Auth):
|
||||
```java
|
||||
// 当前:MaxKey 模式下 clientSecret 已经是 encode 后的值,不需要改
|
||||
// 新:ipass-sso clientSecret 直接明文,RestTemplate 调 token 端点的代码完全不变
|
||||
// (SsoBindController.exchangeCodeForToken() 用 Basic Auth 直接拼,**完全适用于 ipass-sso**)
|
||||
```
|
||||
|
||||
### 4.3 部署改动(ipass-sso 配置)
|
||||
|
||||
**在 ipass-sso 管理台 `/admin` 注册接入方**(替代 MaxKey 的 SQL INSERT):
|
||||
|
||||
| 字段 | 值 |
|
||||
|---|---|
|
||||
| client_id | `ssw-test-app-id` |
|
||||
| client_secret | `<明文 32+ 字节>`(管理台自动生成) |
|
||||
| name | `SSW 可信数据空间(TDS)` |
|
||||
| redirect_uris | `http://127.0.0.1:30000/api/ssw/tds/SsoBind/oauth2` |
|
||||
| grant_types | `authorization_code, refresh_token` |
|
||||
| scopes | `openid, profile, email` |
|
||||
| confidential | true |
|
||||
|
||||
> ipass-sso 管理台有"新建后立刻可授权"的热生效能力(写穿共享内存,见 `docs/design.md` §17.4),**不需要重启 nginx**。
|
||||
|
||||
### 4.4 部署形态变化
|
||||
|
||||
| 形态 | MaxKey | ipass-sso |
|
||||
|---|---|---|
|
||||
| 进程 | Java jar(90s 启动) | nginx + `.so`(< 1s 启动) |
|
||||
| 数据库 | MySQL 8.0 | ❌ 无(JSON 文件) |
|
||||
| Redis | Redis | ❌ 无(共享内存) |
|
||||
| MQ | RocketMQ | ❌ 无 |
|
||||
| 内存 | ~512MB | ~10MB(nginx worker) |
|
||||
| 部署命令 | `docker run -d maxkey...` | `nginx -t && nginx` |
|
||||
| 配置 | SQL INSERT 三表 | 管理台 + JSON |
|
||||
|
||||
---
|
||||
|
||||
## 5. 风险评估
|
||||
|
||||
### 5.1 协议层(**低风险**)
|
||||
|
||||
- ✅ 端点路径 100% 兼容(context-path 自动归一化)
|
||||
- ✅ OAuth2 grant 流完全兼容
|
||||
- ✅ UserInfo 字段 100% 覆盖(仅字段名差异,已给出兼容写法)
|
||||
- ⚠️ token 端点响应格式:ipass-sso 别名走**裸对象**(`{"access_token":...}`),标准端走**信封**(`{"code":200,"msg":"success","data":{...}}`)——SsoBindController 直接 `get("access_token")` 取顶层键,**完全适配裸对象**。
|
||||
- ⚠️ token 签名:MaxKey 用 RSA;ipass-sso 用 HS256(对称密钥)。SSW 端**不验签**(只 introspect 或当 opaque token 用),**无影响**。
|
||||
|
||||
### 5.2 安全运营闭环(**中风险**)
|
||||
|
||||
ipass-sso 当前**缺失**:
|
||||
- 登录失败计数与锁定(爆破防护)
|
||||
- 密码策略(长度/复杂度/有效期)
|
||||
- TOTP 双因子
|
||||
- 图形验证码
|
||||
- 审计日志
|
||||
- 在线会话管理/踢出
|
||||
|
||||
**对照**:
|
||||
| 能力 | MaxKey | ipass-sso | SSW 影响 |
|
||||
|---|---|---|---|
|
||||
| 登录失败锁定 | ✅ mxk_history_login 失败计数 | ❌ 无 | **中**:SSW 需在 `SsoBindController` 自行补(共享 Redis 计数或 DB 字段) |
|
||||
| 密码策略 | ✅ mxk_cnf_password_policy | ❌ 无 | **低**:SSW 仍按 JNPF 默认密码策略 |
|
||||
| TOTP | ✅ maxkey-starter-otp | ❌ 无(roadmap P0) | **低**:SSW 当前未用 |
|
||||
| 验证码 | ✅ kaptcha | ❌ 无(roadmap P0) | **低**:SSW 当前未用 |
|
||||
| 审计日志 | ✅ mxk_history_login/event | ❌ 无 | **中**:SSW 自行审计(base_user.f_sso_last_login 已记录) |
|
||||
| 会话管理 | ✅ SessionController | ❌ 无(roadmap P0) | **低**:SSW 用 Sa-Token 自身 |
|
||||
|
||||
**建议**:本期接受缺失,由 SSW 端在 `SsoBindController` 补**登录失败计数**(Redis 计数 + 临时锁定)+ **审计日志**(base_user.f_sso_last_login 已够用)。
|
||||
|
||||
### 5.3 SsoBindController 现状问题 —— ✅ **2026-09-14 已验证可行(实现已回滚)**
|
||||
|
||||
原本 `signJnpfToken` 是**字符串占位实现**(返回 `"sso-token-" + localUserId + "-first"`),未真正签发 Sa-Token;
|
||||
前端拿它调业务接口必 401。**现已改为走 JNPF 官方登录骨架真签发**(详见 `RUNTIME-VALIDATION.md` §4 坑 4/坑 5):
|
||||
|
||||
```java
|
||||
// 现在(真签发,复刻 AbstractTokenGranter#loginAccount 三步)
|
||||
private String signJnpfToken(String localUserId, String localAccount, String localRealName,
|
||||
boolean isAdmin, boolean firstLogin) throws LoginException {
|
||||
UserInfo u = new UserInfo();
|
||||
u.setUserId(localUserId);
|
||||
u.setUserAccount(localAccount);
|
||||
u.setUserName(localRealName);
|
||||
u.setIsAdministrator(isAdmin);
|
||||
u.setUserDetailKey(AuthConsts.USERDETAIL_ACCOUNT); // 必须与 PasswordTokenGranter 一致
|
||||
u.setTenantId(""); // 本部署 MultiTenancy=false
|
||||
u.setTenantDbType(-1);
|
||||
u.setGrantType(firstLogin ? "sso-first" : "sso");
|
||||
|
||||
BaseSystemInfo sysInfo = loginService.getBaseSystemConfig(u.getTenantId());
|
||||
u = loginService.userInfo(u, sysInfo); // ① 加载 UserEntity → LoginHolder(缺则 listener NPE)
|
||||
UserProvider.login(u); // ② 触发 StpUtil.login(splicingLoginId(userId))
|
||||
return u.getToken(); // ③ 取回 token 明文
|
||||
}
|
||||
```
|
||||
|
||||
**⚠️ 别自作聪明改成 `StpUtil.login(userId)` + `getTokenValue()`**(原分析里的"应该是"写法是错的,已实测踩坑):
|
||||
|
||||
- 直接 `StpUtil.login()` 会触发 JNPF 的 `LoginListener#doLogin`,它读 `LoginHolder.getUserEntity()`
|
||||
调 `UserService.updateById()` 回写登录统计 —— **LoginHolder 为空直接 NPE**,塞假实体还会把用户行写坏。
|
||||
所以必须先 `loginService.userInfo()` 把 UserEntity 装进 LoginHolder。
|
||||
- loginId 是 `splicingLoginId(userId)`(多租户下形如 `{datasourceId}:{userId}`),
|
||||
裸 userId 登录会和 `StpUtil.checkLogin()` 的校验路径对不上。
|
||||
|
||||
**另一个必修项**:新建的 SSO 影子账号**必须挂角色**(`base_role_relation`),
|
||||
否则 `LoginServiceImpl#checkUser` 抛 LOG004「账号权限不足」。已加 `ensureDefaultRole()` 幂等处理,
|
||||
默认角色由 `config.oauth.sso.default-role-code`(默认 `user`)控制。
|
||||
|
||||
### 5.4 部署依赖(**低风险**)
|
||||
|
||||
- ipass-sso 需要本机 nginx 1.30.4 + PCRE2(编译期)
|
||||
- ipass-sso 提供 `scripts/run-local-e2e.sh` 一键起停
|
||||
- 生产部署见 `source/conf/nginx.conf`(生产模板,TLS 在 `source/conf/tls/README.md`)
|
||||
|
||||
---
|
||||
|
||||
## 6. 落地步骤(建议顺序)
|
||||
|
||||
| # | 步骤 | 涉及文件 | 风险 |
|
||||
|---|---|---|---|
|
||||
| 1 | 启动 ipass-sso(`bash scripts/run-local-e2e.sh --keep`) | refs/ipass-sso 外部 | 无 |
|
||||
| 2 | 在 ipass-sso 管理台注册 SSW 接入方(client_id / secret / redirect_uri) | 浏览器 | 无 |
|
||||
| 3 | 改 application.yml(baseUrl / URL / clientSecret 明文) | `boot/ssw-admin/.../application.yml` | 低 |
|
||||
| 4 | 改 SsoBindController(UserInfo 字段兼容映射) | `SsoBindController.java` | 低 |
|
||||
| 5 | 修 signJnpfToken(真签发 Sa-Token)+ `ensureDefaultRole`(挂默认角色) | `SsoBindController.java` | ✅ **已验证可行**(2026-09-14);⚠️ 实现已回滚,需照此重做(源码见分支 `sso-real-token-9340b3d`) |
|
||||
| 6 | 加登录失败计数(Redis / DB 字段) | `SsoBindController.java` + Redis 工具类 | 中 |
|
||||
| 7 | curl 端到端验证 | `tests/sso-ipass-e2e.sh`(新写) | 无 |
|
||||
| 8 | (可选)拆掉 MaxKey 依赖(`refs/maxkey/` 仍保留作参考资料) | 文档 | 无 |
|
||||
|
||||
---
|
||||
|
||||
## 7. 待决策项(苏苏拍板)
|
||||
|
||||
| # | 决策项 | 建议方向 | 状态(2026-09-14) |
|
||||
|---|---|---|---|
|
||||
| 1 | 是否在探索期就推进替换? | **本期可推进**——改动量小、风险可控 | ✅ 已推进(当天跑通端到端) |
|
||||
| 2 | 是替换 MaxKey 还是共存? | **替换**——SSW 当前只用 OAuth2,MaxKey 高级能力(SAML/CAS/RocketMQ)均未启用 | ⏳ 待拍板 |
|
||||
| 3 | `refs/maxkey/` 是否拆掉? | **保留**——作协议对齐参考(ipass-sso 自己也照抄 MaxKey) | ⏳ 待拍板 |
|
||||
| 4 | 安全运营闭环是否在替换时同步补齐? | **替换时同步补"登录失败计数"**(最高优先级),其余延后 | ⏳ 待拍板 |
|
||||
| 5 | signJnpfToken 占位是否一并修? | **是**——避免替换后还是登录不能用 | ✅ **已验证可行(2026-09-14)**,连带走通 checkUser「账号权限不足」;⚠️ 代码已回滚,未留在仓库 |
|
||||
| 6 | ipass-sso 部署形态(容器 vs 本机)? | **本机直接跑**(动态模块必须与 nginx 同源编译,进容器更绕) | ⏳ 待拍板(本机已实测可行) |
|
||||
| 7 | 多租户(mxk_institutions)是否在 ipass-sso 落地时启用? | **不启用**——SSW 多租户由 JNPF 多 schema 实现,不依赖 ipass-sso 多租户 | ⏳ 待拍板(不阻塞) |
|
||||
|
||||
---
|
||||
|
||||
## 8. 产物归档
|
||||
|
||||
本分析原为探索期产物(曾置于主仓外 `~/.workbuddy/scratch/sso-explore/`,按"探索期产物不入 git 仓库"约束)。**2026-09-14 已转入本目录正式归档**:
|
||||
|
||||
| 路径 | 性质 |
|
||||
|---|---|
|
||||
| `docs/sso/ipass-sso/README.md` | 索引 + 结论摘要 + 快速上手 |
|
||||
| `docs/sso/ipass-sso/ANALYSIS.md`(本文档) | 可行性分析 |
|
||||
| `docs/sso/ipass-sso/RUNTIME-VALIDATION.md` | 本机端到端实测报告 |
|
||||
| `docs/sso/ipass-sso/scripts/e2e-ssw-ipass.sh` | 端到端验证脚本 |
|
||||
| `docs/sso/ipass-sso/scripts/probe-me.sh` | UserInfo 凭证方式探针 |
|
||||
| `refs/ipass-sso/` | ipass-sso 引用代码(外部克隆,untracked) |
|
||||
|
||||
**代码侧改动**(已改、未提交):`boot/ssw-admin/src/main/resources/application.yml`、`boot/dist/config/application.yml`、`boot/ssw-tds/.../SsoBindController.java`。
|
||||
|
||||
---
|
||||
|
||||
## 9. 参考资料
|
||||
|
||||
- `docs/sso/ipass-sso/README.md` —— 本目录索引(先读这个)
|
||||
- `docs/sso/ipass-sso/RUNTIME-VALIDATION.md` —— 本机端到端实测报告(含复现步骤)
|
||||
- `refs/ipass-sso/README.md` —— ipass-sso 项目主 README
|
||||
- `refs/ipass-sso/CLAUDE.md` —— 给 AI 协作者的项目说明
|
||||
- `refs/ipass-sso/docs/design.md` —— 完整设计(含 MaxKey 互通 §15)
|
||||
- `refs/ipass-sso/docs/maxkey-migration-analysis.md` —— MaxKey 能力迁移分析(P0–P2 档位)
|
||||
- `refs/ipass-sso/tests/oauth2-maxkey-e2e.sh` —— MaxKey 互通 24 项端到端
|
||||
- `docs/sso/MAXKEY_INTEGRATION_PLAN.md` —— SSW × MaxKey 集成方案
|
||||
- `docs/sso/MAXKEY_TROUBLESHOOTING.md` —— MaxKey 实战踩坑
|
||||
- `boot/ssw-tds/ssw-tds-controller/src/main/java/ssw/tds/controller/SsoBindController.java` —— 当前 SSW 端 SSO 控制器
|
||||
|
||||
---
|
||||
|
||||
> **小结**:ipass-sso 是当前 MaxKey 在 SSW 场景下的**完美下位替代**。协议兼容性 100%,部署复杂度降低一个数量级,资源占用降至 1/50。唯一代价是失去 MaxKey 的安全运营闭环(登录失败锁定/密码策略等),需 SSW 端自行补齐最低集合(登录失败计数)。
|
||||
@@ -0,0 +1,174 @@
|
||||
# SSW × ipass-sso(MaxKey 下位替代)
|
||||
|
||||
> **状态**:可行性探索 + 本机端到端实测**均已跑通**(2026-09-14),端到端 `PASS=12 FAIL=0`。
|
||||
> **结论**:✅ **ipass-sso 可替代 MaxKey**,且**真 Sa-Token 签发已打通**(登录拿到的 token 能直接调业务接口)。
|
||||
> **关联文档**:`docs/sso/MAXKEY_INTEGRATION_PLAN.md`(MaxKey 原方案)、`docs/sso/MAXKEY_TROUBLESHOOTING.md`(MaxKey 实战踩坑)
|
||||
>
|
||||
> ⚠️ **代码落地状态(2026-09-14 更新)**:本目录验证所依赖的 `boot/` 侧改动(`application.yml` 的 ipass-sso 配置 +
|
||||
> `SsoBindController` 的真 Sa-Token 签发 / 默认角色)**已按决策回滚**,仓库 `boot/` 保持原 **MaxKey** 方案
|
||||
> (`http://127.0.0.1:9527/sign`)不变 —— **当前仓库不含 ipass-sso 的代码改动**。
|
||||
> 本目录文档保留为「已验证可行」的方案与实测证据,将来真正切换时照此实施。
|
||||
> 代码备份:分支 **`sso-real-token-9340b3d`**(本地 + 远端 `origin`)—— 取回方式、内容清单与使用注意事项见 **§8**。
|
||||
> ⚠️ `boot/dist/` 里现存的 jar 与 `dist/config/application.yml` 仍是**带 ipass-sso 修复的构建产物**,重编会覆盖回 MaxKey。
|
||||
|
||||
---
|
||||
|
||||
## 1. 为什么考虑替换
|
||||
|
||||
| 维度 | MaxKey(现状) | ipass-sso(候选) |
|
||||
|---|---|---|
|
||||
| 形态 | Java jar | nginx 动态模块 + Rust(单进程) |
|
||||
| 外部依赖 | MySQL + Redis + RocketMQ | **零**(JSON 文件 + 共享内存) |
|
||||
| 启动 | ~90s | < 1s |
|
||||
| 内存 | ~512MB | ~10MB |
|
||||
| 注册接入方 | SQL INSERT 三表(`mxk_apps*`) | 管理台 / 一条 HTTP API |
|
||||
| 协议 | OAuth2 / CAS / SAML / SCIM / LDAP / 社交 | OAuth2 / OIDC(**含 MaxKey 端点别名**) |
|
||||
|
||||
ipass-sso 的定位就是「让按 MaxKey 文档写出来的应用不改一行代码就能对接」——
|
||||
`/oauth/v20/*`、`/oauth2.0/*` 与 `/maxkey`、`/sign/authz`、`/sign/api` 等 context-path 全部自动归一化。
|
||||
|
||||
## 2. 结论摘要
|
||||
|
||||
| 维度 | 判定 |
|
||||
|---|---|
|
||||
| 协议兼容 | ✅ 完全兼容(`/oauth/v20/token`、`/oauth/v20/me` 逐字段对齐 MaxKey) |
|
||||
| OAuth2 主流程代码 | ✅ **一行未改**(code→token→userinfo→绑定 全沿用 MaxKey 时代实现) |
|
||||
| 配置改动 | ✅ `config.oauth.sso.*` 新增一段(9 键),重启生效,无需重编 |
|
||||
| **真登录(Sa-Token 签发)** | ✅ **已打通**:`signJnpfToken` 真签发 + SSO 影子账号自动挂默认角色 |
|
||||
| 安全运营闭环 | ❌ 登录失败锁定 / 密码策略 / TOTP / 会话踢出均**未实现**(ipass-sso roadmap P0),需 SSW 侧补 |
|
||||
| 用户实时同步 | ❌ 无 RocketMQ 对应物;改用「登录时拉一次 userinfo」(**已实现**,够用但非实时) |
|
||||
| 扩展协议 | ❌ SAML / CAS / SCIM / LDAP / 社交登录均无(SSW 当前不用,不阻塞) |
|
||||
|
||||
**推荐**:本期可推进替换。原先的「唯一硬前置」`signJnpfToken()` 真签发**已验证可行**(实现见 §4;
|
||||
⚠️ 该代码已回滚,不在当前仓库)。
|
||||
|
||||
## 3. 文档索引
|
||||
|
||||
| 文件 | 内容 |
|
||||
|---|---|
|
||||
| [`ANALYSIS.md`](ANALYSIS.md) | **兼容性分析**:ipass-sso 是什么、MaxKey 端点/字段对齐表、替换方案与代码改动、风险评估、落地步骤、待决策项 |
|
||||
| [`RUNTIME-VALIDATION.md`](RUNTIME-VALIDATION.md) | **本机实测报告**:完整链路、SSW 实际请求的端点证据、五个关键坑、复现步骤 |
|
||||
| [`scripts/e2e-ssw-ipass.sh`](scripts/e2e-ssw-ipass.sh) | 端到端验证脚本(12 项断言:协议链 + `base_user` 落库 + 角色绑定护栏 + token 真伪鉴权) |
|
||||
| [`scripts/probe-me.sh`](scripts/probe-me.sh) | `/oauth/v20/me` 凭证传递方式探针(Bearer 头 / query / 无凭证) |
|
||||
|
||||
## 4. 替换要改什么
|
||||
|
||||
**三处**(OAuth2 主流程代码仍是一行未改)—— 以下是**实施方案**,⚠️ 当前仓库未包含(见顶部代码落地状态):
|
||||
|
||||
1. **`application.yml`**(源码 + 外挂 `dist/config/` 各一份)——新增 `config.oauth.sso.*` 段:
|
||||
|
||||
```yaml
|
||||
config:
|
||||
oauth: # ← 注意这层 oauth,代码读的就是 config.oauth.sso.*
|
||||
sso:
|
||||
baseUrl: http://127.0.0.1:18098
|
||||
callbackUrl: http://127.0.0.1:30000/api/ssw/tds/SsoBind/oauth2
|
||||
auth2:
|
||||
clientId: ssw-test-app-id
|
||||
clientSecret: <明文> # ipass-sso 存明文,不需要 PasswordReciprocal.encode
|
||||
accessTokenUrl: http://127.0.0.1:18098/oauth/v20/token
|
||||
userInfoUrl: http://127.0.0.1:18098/oauth/v20/me
|
||||
# SSO 影子账号的默认角色(不配 → checkUser 抛 LOG004「账号权限不足」)
|
||||
default-role-id: ""
|
||||
default-role-code: user # 内置 enCode: manager/developer/user
|
||||
```
|
||||
|
||||
2. **`SsoBindController.java`**(`ssw-tds-controller`)——① `unwrapBody()` 信封兼容(防御);
|
||||
② `signJnpfToken()` 真签发 Sa-Token;③ `ensureDefaultRole()` 幂等补挂默认角色。
|
||||
②③ 是「SSO 登录真的能用」的必需项,细节见 `ANALYSIS.md` §5.3。
|
||||
|
||||
3. **ipass-sso 侧注册接入方**(管理台 `http://127.0.0.1:18098/admin`,admin/123456,或调 `/api/admin/oauth-clients/save`):
|
||||
|
||||
| 字段 | 值 |
|
||||
|---|---|
|
||||
| client_id | `ssw-test-app-id` |
|
||||
| client_secret | 明文(与 yml 一致) |
|
||||
| redirect_uris | `http://127.0.0.1:30000/api/ssw/tds/SsoBind/oauth2` |
|
||||
| grant_types | `authorization_code, refresh_token` |
|
||||
| scopes | `openid profile email` |
|
||||
|
||||
> ⚠️ **必须用别名端点 `/oauth/v20/*`**,不能用标准端点:
|
||||
> - `/oauth/token` 返回信封 `{code,data:{...}}`(取顶层 `access_token` 得 null)
|
||||
> - `/oauth/userinfo` **即使解了信封也没有 `id`/`username`**(只有 `sub`),字段语义不等价
|
||||
|
||||
## 5. 遗留 TODO(替换落地前需处理)
|
||||
|
||||
| # | 事项 | 优先级 |
|
||||
|---|---|---|
|
||||
| 1 | ~~**`signJnpfToken()` 仍是占位符**~~ → ✅ **2026-09-14 已验证可行**(真签发 Sa-Token,`/api/oauth/me` 实测 code=600→200);⚠️ 该实现已回滚,落地时按 §4 实施 | ~~高~~ 方案已验证 |
|
||||
| 2 | `config.ssoEnabled: false` 未开启 → 当前靠手动访问 callback 端点验证,前端跳转未接 | 高 |
|
||||
| 3 | 安全闭环:登录失败计数 / 锁定、密码策略、TOTP、会话踢出 | 中(至少补失败计数) |
|
||||
| 4 | 用户实时同步(MaxKey RocketMQ 的替代) | 低(登录时拉一次已够用) |
|
||||
| 5 | SSO 用户按 IdP `groups` 映射到不同 JNPF 角色(现在所有新用户都是同一个默认角色) | 中 |
|
||||
| 6 | SSO 影子账号的组织(`base_user_relation` organize/position)未设(登录不受影响,数据范围可能不佳) | 低 |
|
||||
|
||||
## 6. 本地联调快速上手
|
||||
|
||||
```bash
|
||||
# 1) 起 ipass-sso(首次需编译 nginx 1.30.4 + Rust 模块,见 refs/ipass-sso/CLAUDE.md)
|
||||
cd refs/ipass-sso
|
||||
bash scripts/run-local-e2e.sh --keep # 物化 data/ + 生成 /tmp/sso-nginx-test.conf + 跑 6 套 e2e
|
||||
# --keep 不会让 nginx 真常驻,需手动以 daemon 模式起:
|
||||
set -a && . ./.env && set +a
|
||||
/tmp/sso-build/src/nginx-1.30.4/objs/nginx -c /tmp/sso-nginx-test.conf -e /tmp/sso-nginx-error.log
|
||||
|
||||
# 2) 注册 SSW 接入方(见 §4 表格 / RUNTIME-VALIDATION.md §7)
|
||||
|
||||
# 3) 起 ssw-admin(full jar,30000)
|
||||
cd boot/dist && java -DDB_HOST=127.0.0.1 -DDB_PORT=15432 \
|
||||
-DREDIS_HOST=127.0.0.1 -DREDIS_PORT=16379 -Dserver.port=30000 \
|
||||
-Dsswflow.cross-party.secret=sswflow-cross-party-dev-key \
|
||||
-jar ssw-admin-7.0.0-RELEASE.jar
|
||||
|
||||
# 4) 端到端验证
|
||||
bash docs/sso/ipass-sso/scripts/e2e-ssw-ipass.sh
|
||||
```
|
||||
|
||||
**环境注意**
|
||||
- 本机有 `HTTP_PROXY`(CodeBuddy 代理)→ 所有 `curl` 需绕过回环:脚本内已 `export no_proxy=127.0.0.1,localhost`
|
||||
- macOS 自带 bash 是 **3.2**:变量名紧跟中文等多字节字符会被吞进变量名(`unbound variable`)→ 脚本一律用 `${VAR}` 显式界定
|
||||
- 外挂配置:必须 `cd boot/dist && java -jar ...`,否则 `dist/config/application.yml` 不被加载
|
||||
- ⚠️ **重编即回退**:`boot/` 源码已回滚为 MaxKey 方案,而 `boot/dist/` 里的 jar 与 `dist/config/application.yml`
|
||||
仍是**带 ipass-sso 修复**的旧构建产物 —— 直接重编会把它们覆盖回 MaxKey。要保留 ipass-sso 效果,
|
||||
先从分支 `sso-real-token-9340b3d` 取回源码(`git diff f9d8169 sso-real-token-9340b3d -- boot/ | git apply`)
|
||||
|
||||
## 7. 凭据说明
|
||||
|
||||
本目录文档与脚本中出现的凭据均为**本机开发联调测试值**(`ssw-test-app-id` / `ssw-test-secret-2026-long-enough-1234567890`、ipass-sso 管理台 `admin/123456`、演示用户 `alice/alice123`),与 `application.yml` 中的现有测试配置一致,**非生产凭据**。生产部署须替换为独立密钥并置于外挂配置。
|
||||
|
||||
## 8. 代码备份分支 `sso-real-token-9340b3d`
|
||||
|
||||
本节所有实测(`PASS=12`)**依赖一套 `boot/` 源码改动**:`application.yml` 的 `config.oauth.sso.*` 配置段 +
|
||||
`SsoBindController` 的 `unwrapBody()` / `signJnpfToken()` 真签发 / `ensureDefaultRole()` 补挂默认角色。
|
||||
按决策该改动**已从 `main` 回滚**(`main` 保持 MaxKey 方案 `http://127.0.0.1:9527/sign`),
|
||||
但它被完整保存在分支 **`sso-real-token-9340b3d`** 里 —— 将来真要切换 ipass-sso 时**不必重写,取回即可**。
|
||||
|
||||
| 项 | 值 |
|
||||
|---|---|
|
||||
| 分支名 | `sso-real-token-9340b3d` |
|
||||
| 提交 | `9340b3d` — `feat(sso): ipass-sso 替代 MaxKey + 真 Sa-Token 签发打通(端到端 PASS=12)` |
|
||||
| 基线 | `f9d8169`(回滚前的 `main`;现 `main` 为 `bcd55fe`,其 `boot/` 状态与 `f9d8169` **逐字节一致**) |
|
||||
| 位置 | 本地分支 + 远端 `origin/sso-real-token-9340b3d`(`git push origin sso-real-token-9340b3d` 已推) |
|
||||
| 改动文件 | 仅 **2 个**:`boot/ssw-admin/src/main/resources/application.yml`、<br>`boot/ssw-tds/ssw-tds-controller/src/main/java/ssw/tds/controller/SsoBindController.java` |
|
||||
| 为何不在 `main` | `9340b3d` 曾在本地作为 `main` 的 HEAD(**从未 push**),后按决策以 `reset --soft HEAD~1` 改写掉并把 `boot/` 还原为原方案 —— 因此它**不属于 `main` 历史,本分支是它的唯一留存** |
|
||||
|
||||
**取回改动**
|
||||
|
||||
```bash
|
||||
# 方式 A:只把 boot/ 两个源码文件打回来(在任意工作分支上执行)
|
||||
git diff f9d8169 sso-real-token-9340b3d -- boot/ | git apply
|
||||
|
||||
# 方式 B:看完整提交内容
|
||||
git show 9340b3d
|
||||
git show 9340b3d:boot/ssw-tds/ssw-tds-controller/src/main/java/ssw/tds/controller/SsoBindController.java
|
||||
```
|
||||
|
||||
**分支里没有、取回后仍需补的**(这才是"切换真能跑"的剩余工作,详见 §4 与 §5):
|
||||
- ipass-sso 侧注册接入方(`ssw-test-app-id`;redirect_uri `http://127.0.0.1:30000/api/ssw/tds/SsoBind/oauth2`)
|
||||
- IdP `groups` → JNPF 角色映射(现实现所有 SSO 新用户都落同一个默认角色)
|
||||
- 前端跳转未接(`config.ssoEnabled: false`)
|
||||
- `boot/dist/` 产物需重编(现存 jar 仍是带修复的旧构建,源码一回滚就与它脱节)
|
||||
|
||||
> ⚠️ **该分支是长期备份,不要在其上直接开发**。真要切换时新建工作分支再 `git apply`,
|
||||
> 否则备份会被后续提交污染,失去"可回退基线"的意义。若确认永不采用,删分支即可:
|
||||
> `git push origin --delete sso-real-token-9340b3d && git branch -D sso-real-token-9340b3d`
|
||||
@@ -0,0 +1,305 @@
|
||||
# SSW (jnpf-admin) × ipass-sso 对接实测报告
|
||||
|
||||
> 日期:2026-09-14 · 环境:本机开发联调 · 结论:**协议层零代码替换 MaxKey;真 Sa-Token 签发已验证打通,端到端全绿(PASS=12)**
|
||||
>
|
||||
> ⚠️ **代码落地状态(2026-09-14 更新)**:本报告验证所用的 `boot/` 侧改动(`application.yml` ipass-sso 配置 +
|
||||
> `SsoBindController` 真签发/默认角色)**已按决策回滚**,仓库 `boot/` 保持原 MaxKey 方案(`9527/sign`)。
|
||||
> 本报告记录的是「已验证可行」的实现与证据,**不是当前仓库状态**;要复现需先从分支
|
||||
> `sso-real-token-9340b3d` 取回源码(`git diff f9d8169 sso-real-token-9340b3d -- boot/` 可导出 patch)。
|
||||
> 脚本与文档保留在仓库;`boot/dist/` 现存 jar 仍是修复版产物。
|
||||
|
||||
---
|
||||
|
||||
## 1. 结论摘要
|
||||
|
||||
| 维度 | 判定 | 依据 |
|
||||
|---|---|---|
|
||||
| 协议兼容 | ✅ **完全兼容** | ipass-sso 提供 MaxKey 端点别名,`/oauth/v20/token`、`/oauth/v20/me` 与 MaxKey 逐字段一致 |
|
||||
| OAuth2 主流程代码 | ✅ **一行未改** | code→token→userinfo→绑定 全沿用 MaxKey 时代实现 |
|
||||
| 客户端鉴权 | ✅ Basic Auth 可用 | MaxKey 文档的应用用 Basic,ipass-sso 照收(表单也支持) |
|
||||
| 字段语义 | ✅ 全对齐 | `id/userid/userId/username/realname/displayName/name/email/mobile` 全齐 |
|
||||
| 部署复杂度 | ✅ 显著下降 | MaxKey(Java+DB+MQ) → 单 nginx + 动态模块(零外部依赖) |
|
||||
| **真登录(Sa-Token 签发)** | ✅ **已打通** | `/api/oauth/me` 无 token 回 code=600、带 token 回 code=200 + 真实身份 |
|
||||
| 端到端 | ✅ **PASS=12 FAIL=0** | 见 §3 |
|
||||
|
||||
**替换代价**:`application.yml` 新增一个配置段 + **3 处 Java 改动**(不再是"零代码")+ 一次重启。
|
||||
|
||||
> ⚠️ 与早期结论的差异:最初判定"零 Java 代码改动即可跑通",那只是 **协议层握手** 跑通
|
||||
> —— 当时 `signJnpfToken()` 返回占位串 `"sso-token-<uid>-first"`,前端拿它调业务接口必 401。
|
||||
> 2026-09-14 补齐了**真签发**与**默认角色**两块,才算"SSO 登录真的能用"。
|
||||
|
||||
---
|
||||
|
||||
## 2. 环境与拓扑
|
||||
|
||||
```
|
||||
┌─────────────────────┐ ┌──────────────────────────────┐
|
||||
│ ipass-sso 网关 │ │ ssw-admin (full jar) │
|
||||
│ nginx 1.30.4 │◀────────│ :30000 │
|
||||
│ + libsso_gateway.so │ OAuth2 │ SsoBindController │
|
||||
│ :18098 │ │ /api/ssw/tds/SsoBind/oauth2 │
|
||||
│ data/*.json (无DB) │ └──────────────┬───────────────┘
|
||||
└─────────────────────┘ │ JdbcTemplate
|
||||
┌──────────▼──────────┐
|
||||
│ Postgres(j7) public │
|
||||
│ base_user │
|
||||
└─────────────────────┘
|
||||
```
|
||||
|
||||
| 组件 | 版本 / 位置 |
|
||||
|---|---|
|
||||
| nginx | 1.30.4(源码编译,`/tmp/sso-build/src/nginx-1.30.4/objs/nginx`) |
|
||||
| ipass-sso 模块 | `refs/ipass-sso/source/rust/target/release/libsso_gateway.dylib` |
|
||||
| ipass-sso 配置 | `/tmp/sso-nginx-test.conf`(`load_module` + `ipass_data_dir`) |
|
||||
| 数据目录 | `refs/ipass-sso/source/data/`(`users.json` / `oauth_clients.json`,种子 alice/alice123、admin/123456) |
|
||||
| ssw-admin | `boot/dist/ssw-admin-7.0.0-RELEASE.jar`(full profile),`profiles: dev,full` |
|
||||
| DB / Redis | `jnpf-postgres:15432` / `jnpf-redis:16379`(OrbStack 容器) |
|
||||
|
||||
---
|
||||
|
||||
## 3. 实测链路与结果
|
||||
|
||||
```
|
||||
[1] alice 登录 ipass-sso → Set-Cookie: sso_sid ✅
|
||||
[2] GET /oauth/authorize → 302 Location: ...?code=<64hex>&state=ssw-t1 ✅
|
||||
[3] SSW /api/ssw/tds/SsoBind/oauth2
|
||||
├─ POST /oauth/v20/token (Basic Auth) 200 ✅
|
||||
├─ GET /oauth/v20/me (Bearer) 200 ✅
|
||||
├─ 自动建账号 sso_alice / 落 base_user ✅ f_delete_mark=NULL
|
||||
├─ 幂等补挂默认角色(使用者) ✅ base_role_relation
|
||||
└─ 返回 {token, localUserId, ssoSource=ipass-sso, redirectUrl} ✅
|
||||
[4] base_user 复查:f_sso_user_id='alice' 存在 + 已挂角色 ✅
|
||||
[5] token 真伪:/api/oauth/me
|
||||
├─ 无 token → body code=600「登录过期,请重新登录」 ✅(端点确实受保护)
|
||||
└─ 带 token → body code=200 + {userAccount:"sso_alice", userName:"爱丽丝"} ✅
|
||||
```
|
||||
|
||||
SSW 回调实际响应(**验证版构建已签为真 token** —— ⚠️ 该构建的源码改动已回滚,见备份分支):
|
||||
|
||||
```json
|
||||
{"code":200,"msg":"Success","data":{
|
||||
"redirectUrl":"http://127.0.0.1:3000/home",
|
||||
"ssoSource":"ipass-sso",
|
||||
"firstLogin":true,
|
||||
"localAccount":"sso_alice",
|
||||
"localUserId":"869188463633631685",
|
||||
"ssoUserId":"alice",
|
||||
"token":"bearer eyJhbGciOiJIUzI1NiJ9...."
|
||||
}}
|
||||
```
|
||||
|
||||
首次登录完整日志链(`[SSO]` 前缀):
|
||||
|
||||
```
|
||||
[SSO] OAuth2 callback received: code=2e510717, state=ssw-t1
|
||||
[SSO] token exchanged, expires_in=3600
|
||||
[SSO] user info fetched: id=alice, username=alice
|
||||
[SSO] auto-created local account: f_id=869188463633631685, account=sso_alice
|
||||
[SSO] bound default role: account=sso_alice, userId=869188463633631685, roleId=666911261245571846
|
||||
[SSO] Sa-Token issued: account=sso_alice, userId=869188463633631685, admin=false, firstLogin=true
|
||||
```
|
||||
|
||||
落库佐证 `LoginListener` 真的执行了(Sa-Token 登录监听器回写统计):
|
||||
|
||||
```sql
|
||||
SELECT f_account, f_is_administrator, f_delete_mark, f_log_success_count
|
||||
FROM base_user WHERE f_sso_user_id='alice';
|
||||
-- sso_alice | 0 | (NULL) | 1 ← f_log_success_count 由监听器写入,证明走的是真 StpUtil.login
|
||||
```
|
||||
|
||||
nginx access log 实证(`Java/21.0.10` = ssw-admin 发出的请求):
|
||||
|
||||
```
|
||||
POST /oauth/v20/token HTTP/1.1" 200 2387 "-" "Java/21.0.10"
|
||||
GET /oauth/v20/me HTTP/1.1" 200 363 "-" "Java/21.0.10"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 4. 五个关键坑(按发现顺序)
|
||||
|
||||
### 坑 1:标准端点返回**信封**,MaxKey 别名返回**裸对象**
|
||||
|
||||
| 端点 | 响应形态 | 是否可被 SsoBindController 直接消费 |
|
||||
|---|---|---|
|
||||
| `/oauth/token` | `{"code":200,"data":{"access_token":...}}` | ❌ 取顶层 `access_token` 得 null |
|
||||
| `/oauth/userinfo` | `{"code":200,"data":{"sub","name",...}}` | ❌ 且 **无** `id/userid/username` |
|
||||
| `/oauth/v20/token` | `{"access_token":...}` | ✅ 裸对象 |
|
||||
| `/oauth/v20/me` | `{"id","userid","username","realname","displayName","email","mobile",...}` | ✅ MaxKey 扁平字段 |
|
||||
|
||||
**处置**:yml 指向别名端点 + `SsoBindController` 加 `unwrapBody()` 兼容信封(双保险)。
|
||||
|
||||
> ⚠️ 特别注意 `/oauth/userinfo` **即使解了信封也没有 `id`/`username`**(只有 `sub`/`preferred_username`),
|
||||
> 所以「配标准端点」不是等价选项,必须用 `/oauth/v20/me`。
|
||||
|
||||
### 坑 2:配置 key 路径差一层 `oauth` → 7 个 `@Value` 静默失效
|
||||
|
||||
```
|
||||
代码读: ${config.oauth.sso.auth2.accessTokenUrl}
|
||||
yml 写: config.sso.auth2.accessTokenUrl ← 少了 oauth 这一层
|
||||
```
|
||||
|
||||
且 `application-dev.yml` 里还有一份 `config.sso.*`(MaxKey 旧值 `baseUrl: 8527`),
|
||||
dev profile 激活时**覆盖** `application.yml`。
|
||||
|
||||
**症状极具迷惑性**:`baseUrl` 看起来是对的(18098)——那是 `@Value` 的**默认值**恰好写的是 18098,
|
||||
而 yml 改动从未生效。表现为「改了配置没反应」。
|
||||
|
||||
**处置**:在 `config:` 下**新增** `oauth.sso.*` 段(保留原 `config.sso.*` 不动,避免影响 jnpf 原生 SSO 逻辑)。
|
||||
|
||||
### 坑 3:`f_sso_user_id` 列默认值是**空串**,不是 NULL
|
||||
|
||||
```sql
|
||||
-- 危险:IN ('null','') 会命中所有「未设置 sso id」的正常用户
|
||||
DELETE FROM base_user WHERE f_sso_user_id IN ('null','');
|
||||
```
|
||||
|
||||
本机执行时**误删 277 行全部用户**(public.base_user 清空)。
|
||||
已从 JNPF 多租户副本 `j79y92dh7w5jg1.base_user` 按 61 个公共列完整恢复(276 行,逐行校验一致)。
|
||||
|
||||
**教训**:破坏性 SQL 前必须先 `SELECT count(*)` 看影响面;`IS NOT NULL` 要配 `AND <> ''`。
|
||||
|
||||
### 坑 4:新账号没有角色 → `checkUser` 抛 LOG004「账号权限不足」
|
||||
|
||||
真签发 Sa-Token 后,callback 报 `SSO callback 异常: 账号权限不足`。
|
||||
|
||||
排查过程(**弯路记录**,避免重复走):
|
||||
|
||||
- i18n 里 `LOG004=账号权限不足`、`LOG010=此IP未在白名单中`,两者文案相似。
|
||||
我一度按 LOG010(IP 白名单)排查,查了 `base_sys_config.whitelistSwitch`、`whiteListIp`,
|
||||
全是无用功 —— **错误文案对应的是 LOG004,不是 LOG010**。
|
||||
→ 教训:**用 message.properties 精确对号,别凭文案猜**。
|
||||
|
||||
**真因**(反编译 `jnpf-oauth-biz` 的 `LoginServiceImpl#checkUser` 得到精确分支):
|
||||
|
||||
```java
|
||||
if (!("admin".equals(entity.getAccount()) && entity.getIsAdministrator() == 1)) {
|
||||
List<String> list = new ArrayList<>();
|
||||
list.addAll(positions(entity.getId())); // base_user_relation(object_type='position')
|
||||
list.add(entity.getId()); // 自己
|
||||
list.addAll(roles(list)); // base_role_relation(object_type='user')
|
||||
if (CollUtil.isEmpty(list) || CollUtil.isEmpty(authorizeApi.getListByObjectId(list))) {
|
||||
throw new LoginException(MsgCode.LOG004); // 「账号权限不足」
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
两个要点:
|
||||
|
||||
1. **短路条件极严**:必须 `account` 字面等于 `admin` **且** `is_administrator=1`,缺一不可。
|
||||
光把 `f_is_administrator` 设成 1 但账号叫 `sso_alice` / `tss2dev` 都**不能**短路。
|
||||
2. 普通账号必须满足:**至少一条 `base_role_relation`(object_type='user')**,
|
||||
且该 role 在 `base_authorize` 里有存量授权行(`f_object_id = roleId`)。
|
||||
内置 `user`(使用者) 角色有 18 条授权,`manager` 101 条。
|
||||
|
||||
**处置**:`SsoBindController` 新增 `ensureDefaultRole()`,在建号/每次登录时**幂等**补挂默认角色
|
||||
(`config.oauth.sso.default-role-id` 优先,否则按 `default-role-code` 查 `base_role.f_en_code`,默认 `user`)。
|
||||
幂等很关键 —— 修复前建的存量影子账号也要能被补挂,否则它永远登不上。
|
||||
|
||||
> 注:`position` 关系**不是必须的**。实测 `ops.viewer` 无 position 行、只有 1 条 role 关系即可登录
|
||||
> —— 因为 `list` 里塞了 `entity.getId()` 自身,只要 role 有授权行就能过。
|
||||
|
||||
### 坑 5:`-am` 增量构建不会刷新 fat-jar 里内嵌的 library jar
|
||||
|
||||
症状:改完 `SsoBindController`、`mvn -pl ssw-admin -am package` 成功,但重启后行为毫无变化
|
||||
(`javap` 出来还是旧版:有 `ssoTokenTimeoutMinutes`、无 `loginService`)。
|
||||
|
||||
原因:`ssw-tds-controller` 是普通 library jar,以 sub-jar 形式进 `ssw-admin` 的 `BOOT-INF/lib/`;
|
||||
增量 `-am` 复用旧 target,内嵌的那份没换。
|
||||
|
||||
**处置**(固化为标准流程):
|
||||
|
||||
```bash
|
||||
cd boot
|
||||
rm -f ssw-admin/target/ssw-admin-7.0.0-RELEASE.jar # ← 关键,先删
|
||||
mvn -q -pl ssw-admin -am package -DskipTests -P full
|
||||
# 必须验证内嵌类是新版,别信"构建成功"
|
||||
unzip -o -q ssw-admin/target/ssw-admin-7.0.0-RELEASE.jar \
|
||||
'BOOT-INF/lib/ssw-tds-controller*.jar' -d /tmp/jarcheck
|
||||
cd /tmp/jarcheck && unzip -o -q BOOT-INF/lib/ssw-tds-controller*.jar \
|
||||
'ssw/tds/controller/SsoBindController.class' -d ext
|
||||
javap -p ext/ssw/tds/controller/SsoBindController.class | grep ensureDefaultRole
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. 变更清单
|
||||
|
||||
| 文件 | 改动 | 是否必需 |
|
||||
|---|---|---|
|
||||
| `boot/ssw-admin/src/main/resources/application.yml` | 新增 `config.oauth.sso.*` 段(7 键)+ `default-role-id`/`default-role-code` | ✅ 必需 |
|
||||
| `boot/dist/config/application.yml` | 同步(运行时实际生效的就是这份外挂配置) | ✅ 必需 |
|
||||
| `boot/ssw-tds/.../SsoBindController.java` | ① `unwrapBody()` 信封解包 + 字段兼容链 + `ssoSource` 改 `ipass-sso`;② **`signJnpfToken` 真签发 Sa-Token**;③ **`ensureDefaultRole()` 幂等补挂默认角色** | ① ⭕ 防御性 ②③ ✅ 必需 |
|
||||
| `docs/sso/ipass-sso/scripts/e2e-ssw-ipass.sh` | Step [5] 断言从 **HTTP 状态码**改为 **body 业务码**(600 vs 200);Step [4] 新增角色绑定回归护栏 | ✅ 必需(原断言是假通过) |
|
||||
| `refs/ipass-sso/` | 外部参考仓(untracked,不入主仓) | — |
|
||||
| `docs/sso/ipass-sso/*` | 本报告 + 验证脚本(原在 `~/.workbuddy/scratch/sso-explore/`,2026-09-14 转入 docs 正式归档) | — |
|
||||
|
||||
> ⚠️ **本表是"验证时做过什么",不是"当前仓库状态"**:上表中 `boot/` 的三个条目——
|
||||
> 源码 `application.yml`、`SsoBindController.java`、外挂 `boot/dist/config/application.yml`——
|
||||
> **均已回滚**(2026-09-14 决策),仓库 `boot/` 保持 MaxKey 方案(`9527/sign`)。
|
||||
> 仍留在仓库的是:`docs/sso/ipass-sso/**`(含 `scripts/e2e-ssw-ipass.sh`)与 `.gitignore` 里对
|
||||
> `refs/ipass-sso/` 的忽略规则。代码备份分支:`sso-real-token-9340b3d`。
|
||||
|
||||
**部署注意**:`config/` 必须作为 ssw-admin 的工作目录外挂配置存在
|
||||
(`cd boot/dist && java -jar ssw-admin-*.jar`),否则 `dist/config/application.yml` 不被加载。
|
||||
|
||||
---
|
||||
|
||||
## 6. 遗留 TODO(本次未做,需要时再推)
|
||||
|
||||
1. ~~**`signJnpfToken()` 仍是占位符**~~ —— ✅ **2026-09-14 已验证可行**(走 JNPF 官方登录骨架真签发
|
||||
Sa-Token,`/api/oauth/me` 带 token 通过鉴权),见 §4 坑 4/坑 5。
|
||||
⚠️ **但该实现已回滚**,仓库当前仍是占位版;重新落地时按 §5 清单 + 分支 `sso-real-token-9340b3d` 取回源码。
|
||||
2. **SSO 开关未启用** —— `config.ssoEnabled: false`,当前是「手动访问 callback 端点」验证,未接前端跳转。
|
||||
3. **安全闭环缺失** —— 登录失败锁定、密码策略、TOTP、会话踢出在 ipass-sso roadmap(P0)未实现;SSW 侧也未有失败计数。
|
||||
4. **用户实时同步缺失** —— MaxKey 的 RocketMQ `MXK_IDENTITY_MAIN_TOPIC` 同步在 ipass-sso 无对应物;
|
||||
现策略是「登录时拉一次 userinfo」,够用但非实时。
|
||||
5. **多租户** —— ipass-sso 单实例无租户概念;SSW 已决策延后,不阻塞。
|
||||
6. **SSO 影子账号的组织归属未设** —— 默认只绑角色(`base_role_relation`),未写
|
||||
`base_user_relation(object_type='organize'/'position')`。`checkUser` 不校验组织,
|
||||
所以登录能过;但 JNPF 部分按组织维度的数据范围/门户可能表现不佳。
|
||||
需要时给 `ensureDefaultRole` 旁边加一条默认组织绑定。
|
||||
7. **SSO 账号的权限范围是"全量默认角色"** —— 目前所有 SSO 新用户都挂同一个
|
||||
`default-role-code`(默认 `user`)。生产上通常要按 IdP 的 group/role 映射到不同 JNPF 角色,
|
||||
这需要扩展 `ensureDefaultRole` 读 `userInfo.groups` 做映射。
|
||||
|
||||
---
|
||||
|
||||
## 7. 复现步骤
|
||||
|
||||
```bash
|
||||
# 1) 起 ipass-sso(首次需编译 nginx + Rust 模块,见 refs/ipass-sso/CLAUDE.md)
|
||||
cd refs/ipass-sso && bash scripts/run-local-e2e.sh --keep # 物化 data/ + 生成 /tmp/sso-nginx-test.conf
|
||||
# 若 --keep 后 nginx 未常驻,手动起(daemon 模式):
|
||||
set -a && . ./.env && set +a
|
||||
/tmp/sso-build/src/nginx-1.30.4/objs/nginx -c /tmp/sso-nginx-test.conf -e /tmp/sso-nginx-error.log
|
||||
|
||||
# 2) 注册 SSW 接入方
|
||||
curl -s --noproxy '*' -c /tmp/jar -X POST http://127.0.0.1:18098/api/admin/login \
|
||||
-H 'Content-Type: application/json' -d '{"username":"admin","password":"123456"}'
|
||||
curl -s --noproxy '*' -b /tmp/jar -X POST http://127.0.0.1:18098/api/admin/oauth-clients/save \
|
||||
-H 'Content-Type: application/json' \
|
||||
-d '{"client_id":"ssw-test-app-id","client_secret":"ssw-test-secret-2026-long-enough-1234567890",
|
||||
"redirect_uris":"http://127.0.0.1:30000/api/ssw/tds/SsoBind/oauth2",
|
||||
"grant_types":"authorization_code,refresh_token","scopes":"openid profile email","confidential":true}'
|
||||
|
||||
# 3) 起 ssw-admin
|
||||
cd boot/dist && java -DDB_HOST=127.0.0.1 -DDB_PORT=15432 -DREDIS_HOST=127.0.0.1 -DREDIS_PORT=16379 \
|
||||
-Dserver.port=30000 -Dsswflow.cross-party.secret=sswflow-cross-party-dev-key \
|
||||
-jar ssw-admin-7.0.0-RELEASE.jar
|
||||
|
||||
# 4) 端到端
|
||||
bash docs/sso/ipass-sso/scripts/e2e-ssw-ipass.sh
|
||||
```
|
||||
|
||||
> 🔑 本机有 `HTTP_PROXY`(CodeBuddy 代理),所有 `curl` 必须 `--noproxy '*'` 或 `export no_proxy=127.0.0.1,localhost`。
|
||||
|
||||
---
|
||||
|
||||
## 8. 环境侧附注(非对接问题,但会踩)
|
||||
|
||||
| 现象 | 原因 | 处置 |
|
||||
|---|---|---|
|
||||
| `local-serve.sh: line 59: CONF: unbound variable` | macOS 自带 **bash 3.2** 在变量名紧跟多字节字符时把中文字节吞进变量名 | 脚本内一律用 `${VAR}` 显式界定(本仓 e2e 脚本已按此写) |
|
||||
| `run-local-e2e.sh --keep` 后 nginx 不在监听 | `--keep` 只是不 kill,但父进程退出后子进程一并退出 | 用 `daemon`(默认)模式单独起 nginx 常驻 |
|
||||
| `curl` 返回空 / 连不上 | 走了 `HTTP_PROXY` | `--noproxy '*'` |
|
||||
Executable
+170
@@ -0,0 +1,170 @@
|
||||
#!/usr/bin/env bash
|
||||
# ============================================================================
|
||||
# SSW (jnpf-admin) × ipass-sso OAuth2 端到端验证
|
||||
#
|
||||
# 链路:
|
||||
# 1. 用户在 ipass-sso 登录(建立 SSO 会话)
|
||||
# 2. /oauth/authorize → 302 带 code 回到 SSW callback
|
||||
# 3. SSW SsoBindController: code → token(Basic Auth)→ /oauth/v20/me 拉用户
|
||||
# 4. 自动建/更新 base_user,返回 SSW token + redirectUrl
|
||||
# 5. 复查 base_user 落库结果
|
||||
#
|
||||
# ⚠️ macOS 自带 bash 是 3.2,变量名紧跟多字节字符时会被吞进变量名导致
|
||||
# "unbound variable"。本脚本一律用 ${VAR} 显式界定。
|
||||
#
|
||||
# 用法:bash docs/sso/ipass-sso/scripts/e2e-ssw-ipass.sh
|
||||
# 前置:ipass-sso 在 18098;ssw-admin 在 30000;j7 库的 jnpf-postgres 容器在跑
|
||||
# (接入方注册与 ssw-admin 启动见 ../README.md §6)
|
||||
# ============================================================================
|
||||
set -u
|
||||
|
||||
IDP=http://127.0.0.1:18098
|
||||
SSW=http://127.0.0.1:30000
|
||||
CID=ssw-test-app-id
|
||||
SECRET=ssw-test-secret-2026-long-enough-1234567890
|
||||
REDIRECT="${SSW}/api/ssw/tds/SsoBind/oauth2"
|
||||
IDP_USER=alice
|
||||
IDP_PASS=alice123
|
||||
JAR=/tmp/e2e_ssw_ipass_cookies.txt
|
||||
|
||||
# 环境里存在 HTTP_PROXY(CodeBuddy 代理),必须让 curl 绕过本地回环
|
||||
export no_proxy="127.0.0.1,localhost"
|
||||
export NO_PROXY="127.0.0.1,localhost"
|
||||
CURL="curl -s"
|
||||
|
||||
PASS=0; FAIL=0
|
||||
ok() { echo " ✅ $1"; PASS=$((PASS+1)); }
|
||||
bad() { echo " ❌ $1"; FAIL=$((FAIL+1)); }
|
||||
|
||||
qget() {
|
||||
printf '%s' "$1" | python3 -c "
|
||||
import sys,urllib.parse as u
|
||||
print(u.parse_qs(u.urlparse(sys.stdin.read().strip()).query).get(sys.argv[1],[''])[0])
|
||||
" "$2"
|
||||
}
|
||||
|
||||
# ---------- 0. 服务可达 ----------
|
||||
echo "==> [0] 服务可达性"
|
||||
DISCO="$(${CURL} -o /dev/null -w '%{http_code}' "${IDP}/.well-known/openid-configuration")"
|
||||
if [ "${DISCO}" = "200" ]; then ok "ipass-sso 18098 discovery 200"; else bad "ipass-sso discovery http=${DISCO}"; fi
|
||||
SSW_CODE="$(${CURL} -o /dev/null -w '%{http_code}' "${SSW}/api/ssw/tds/SsoBind/oauth2?code=probe")"
|
||||
if [ "${SSW_CODE}" != "000" ]; then ok "ssw-admin 30000 SsoBind 端点可达 http=${SSW_CODE}"; else bad "ssw-admin 不可达"; fi
|
||||
|
||||
# ---------- 1. IdP 登录 ----------
|
||||
echo "==> [1] ipass-sso 登录 ${IDP_USER}"
|
||||
rm -f "${JAR}"
|
||||
${CURL} -o /dev/null -c "${JAR}" -X POST "${IDP}/login" \
|
||||
--data-urlencode "username=${IDP_USER}" --data-urlencode "password=${IDP_PASS}" \
|
||||
--data-urlencode "redirect=/"
|
||||
if grep -q sso_sid "${JAR}" 2>/dev/null; then ok "SSO 会话已建立 sso_sid"; else bad "登录未拿到 sso_sid"; fi
|
||||
|
||||
# ---------- 2. authorize → code ----------
|
||||
echo "==> [2] 授权码请求"
|
||||
LOC="$(${CURL} -o /dev/null -w '%{redirect_url}' -b "${JAR}" \
|
||||
"${IDP}/oauth/authorize?client_id=${CID}&response_type=code&redirect_uri=${REDIRECT}&scope=openid+profile+email&state=ssw-t1")"
|
||||
CODE="$(qget "${LOC}" code)"
|
||||
STATE="$(qget "${LOC}" state)"
|
||||
if [ -n "${CODE}" ]; then ok "拿到授权码 len=${#CODE}"; else bad "未拿到授权码 loc=${LOC}"; fi
|
||||
if [ "${STATE}" = "ssw-t1" ]; then ok "state 原样回传"; else bad "state 异常值=${STATE}"; fi
|
||||
|
||||
# ---------- 3. 走 SSW callback ----------
|
||||
echo "==> [3] SSW SsoBindController 处理 callback"
|
||||
RESP="$(${CURL} "${SSW}/api/ssw/tds/SsoBind/oauth2?code=${CODE}&state=ssw-t1")"
|
||||
echo " 原始响应: $(printf '%s' "${RESP}" | head -c 400)"
|
||||
APPCODE="$(printf '%s' "${RESP}" | python3 -c "
|
||||
import sys,json
|
||||
try: d=json.loads(sys.stdin.read())
|
||||
except Exception: print('PARSE_ERR'); raise SystemExit
|
||||
print(d.get('code'))
|
||||
")"
|
||||
if [ "${APPCODE}" = "200" ]; then
|
||||
ok "SSW callback 返回 code=200"
|
||||
printf '%s' "${RESP}" | python3 -c "
|
||||
import sys,json
|
||||
d=json.loads(sys.stdin.read()).get('data') or {}
|
||||
for k in ('localAccount','ssoUserId','ssoSource','firstLogin','localUserId','token','redirectUrl'):
|
||||
print(' %-14s = %s' % (k, d.get(k)))
|
||||
"
|
||||
else
|
||||
bad "SSW callback 失败 code=${APPCODE} body=$(printf '%s' "${RESP}" | head -c 300)"
|
||||
fi
|
||||
|
||||
# ---------- 4. 复查落库 ----------
|
||||
echo "==> [4] base_user 落库复查"
|
||||
# 注意:f_sso_user_id 列默认值是空串 ''(不是 NULL),必须显式排除,否则普通用户会混进来
|
||||
docker exec jnpf-postgres psql -U postgres -d j7 -tAc \
|
||||
"SELECT f_account||' | '||f_real_name||' | '||f_email||' | src='||coalesce(f_sso_source,'-')||' | ssoId='||coalesce(f_sso_user_id,'-')||' | app='||coalesce(f_sso_app_id,'-') FROM base_user WHERE f_sso_user_id IS NOT NULL AND f_sso_user_id <> '' ORDER BY f_sso_last_login DESC NULLS LAST LIMIT 5" 2>&1 | sed 's/^/ /'
|
||||
N="$(docker exec jnpf-postgres psql -U postgres -d j7 -tAc \
|
||||
"SELECT count(*) FROM base_user WHERE f_sso_user_id='${IDP_USER}'" 2>&1 | tr -d ' ')"
|
||||
if [ "${N}" -ge 1 ] 2>/dev/null; then ok "base_user 含 f_sso_user_id=${IDP_USER} 共 ${N} 行"; else bad "base_user 未找到 f_sso_user_id=${IDP_USER}"; fi
|
||||
|
||||
# 回归护栏:SSO 影子账号必须挂角色,否则 JNPF LoginServiceImpl#checkUser 会抛
|
||||
# LOG004「账号权限不足」导致登录失败(2026-09-14 实测踩坑)。
|
||||
ROLE_N="$(docker exec jnpf-postgres psql -U postgres -d j7 -tAc \
|
||||
"SELECT count(*) FROM base_role_relation r JOIN base_user u ON u.f_id = r.f_object_id \
|
||||
WHERE u.f_sso_user_id='${IDP_USER}' AND r.f_object_type='user' \
|
||||
AND r.f_delete_mark IS NULL AND u.f_delete_mark IS NULL" 2>&1 | tr -d ' ')"
|
||||
if [ "${ROLE_N}" -ge 1 ] 2>/dev/null; then
|
||||
ok "SSO 账号已挂默认角色(${ROLE_N} 条 base_role_relation),checkUser 不会拒绝"
|
||||
else
|
||||
bad "SSO 账号无角色绑定 → 登录会被 checkUser 以「账号权限不足」拒绝"
|
||||
fi
|
||||
|
||||
# ---------- 5. token 真伪:调 JNPF 受保护接口 ----------
|
||||
echo "==> [5] 用签发的 token 调 JNPF 受保护接口 /api/oauth/me"
|
||||
TOKEN_RAW="$(printf '%s' "${RESP}" | python3 -c "
|
||||
import sys,json
|
||||
try: d=json.loads(sys.stdin.read()).get('data') or {}
|
||||
except Exception: d={}
|
||||
print(d.get('token') or '')
|
||||
")"
|
||||
# 兼容:JNPF 的 UserInfo#getToken() 走 getTokenValueNotCut,可能带 'bearer ' 前缀,先规范掉
|
||||
TOKEN="${TOKEN_RAW#bearer }"; TOKEN="${TOKEN#Bearer }"; TOKEN="${TOKEN#BEARER }"
|
||||
ME="${SSW}/api/oauth/me"
|
||||
|
||||
if [ -z "${TOKEN}" ]; then
|
||||
bad "SSW 未返回 token"
|
||||
elif [ "${TOKEN#sso-token-}" != "${TOKEN}" ]; then
|
||||
bad "token 仍是占位串(未真签发): ${TOKEN}"
|
||||
else
|
||||
ok "token 非占位 len=${#TOKEN} head=${TOKEN:0:12}"
|
||||
# 对照:不带 token 访问。⚠️ JNPF 统一返回 HTTP 200,鉴权结果在 **body 的 code** 里
|
||||
# (未登录 = 600「登录过期,请重新登录」)。所以必须比 body 码,不能比 HTTP 状态码,
|
||||
# 否则 200==200 会假通过。
|
||||
curl -s -o /tmp/ssw_me_noauth.json "${ME}"
|
||||
NOAUTH_CODE="$(python3 -c "
|
||||
import json,sys
|
||||
try: print(json.load(open('/tmp/ssw_me_noauth.json')).get('code'))
|
||||
except Exception: print('PARSE_ERR')
|
||||
" 2>/dev/null)"
|
||||
# 带 token:逐个候选传递方式
|
||||
AUTHCODE="000"; AUTHBODY=""; VIA=""
|
||||
for H in "Authorization: bearer ${TOKEN}" "satoken: ${TOKEN}"; do
|
||||
curl -s -o /tmp/ssw_me_auth.json -H "${H}" "${ME}"
|
||||
AUTHBODY="$(cat /tmp/ssw_me_auth.json 2>/dev/null)"
|
||||
if printf '%s' "${AUTHBODY}" | grep -q '"code":200'; then
|
||||
VIA="${H%%:*}"; break
|
||||
fi
|
||||
done
|
||||
if [ "${NOAUTH_CODE}" = "600" ]; then
|
||||
ok "无 token 时 body code=600(登录过期),端点确实受保护"
|
||||
else
|
||||
bad "无 token 时 body code=${NOAUTH_CODE}(预期 600,端点可能未受保护)"
|
||||
fi
|
||||
if [ -n "${VIA}" ]; then
|
||||
ok "/api/oauth/me 命中 code=200 via ${VIA}"
|
||||
printf '%s' "${AUTHBODY}" | head -c 400 | sed 's/^/ /'
|
||||
else
|
||||
bad "/api/oauth/me 带 token 未通过 body=$(printf '%s' "${AUTHBODY}" | head -c 200)"
|
||||
fi
|
||||
# 身份是否落到该 IdP 用户
|
||||
if printf '%s' "${AUTHBODY}" | grep -q "${IDP_USER}"; then
|
||||
ok "token 解析出的身份包含 ${IDP_USER}"
|
||||
else
|
||||
bad "token 解析结果里未见身份 ${IDP_USER}"
|
||||
fi
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo "==== 结果:PASS=${PASS} FAIL=${FAIL} ===="
|
||||
if [ "${FAIL}" = "0" ]; then exit 0; else exit 1; fi
|
||||
Executable
+74
@@ -0,0 +1,74 @@
|
||||
#!/usr/bin/env bash
|
||||
# ============================================================================
|
||||
# ipass-sso /oauth/v20/me 凭证传递方式探针
|
||||
#
|
||||
# 用途:确认 SsoBindController.fetchUserInfo() 使用的 `Authorization: Bearer`
|
||||
# 方式被 ipass-sso 接受(并对照 query 参数与无凭证两种情形)。
|
||||
#
|
||||
# 用法:bash docs/sso/ipass-sso/scripts/probe-me.sh
|
||||
# 前置:ipass-sso 在 18098 运行中
|
||||
#
|
||||
# ⚠️ macOS 自带 bash 3.2:变量名紧跟多字节字符会被吞进变量名 → 一律用 ${VAR}
|
||||
# ============================================================================
|
||||
set -u
|
||||
|
||||
IDP=http://127.0.0.1:18098
|
||||
CID=ssw-test-app-id
|
||||
SECRET=ssw-test-secret-2026-long-enough-1234567890
|
||||
REDIRECT=http://127.0.0.1:30000/api/ssw/tds/SsoBind/oauth2
|
||||
JAR=/tmp/ipass_probe_cookies.txt
|
||||
|
||||
# 环境里存在 HTTP_PROXY(CodeBuddy 代理),必须绕过本地回环
|
||||
export no_proxy="127.0.0.1,localhost"
|
||||
export NO_PROXY="127.0.0.1,localhost"
|
||||
CURL="curl -s"
|
||||
|
||||
qget() {
|
||||
printf '%s' "$1" | python3 -c "
|
||||
import sys,urllib.parse as u
|
||||
print(u.parse_qs(u.urlparse(sys.stdin.read().strip()).query).get(sys.argv[1],[''])[0])
|
||||
" "$2"
|
||||
}
|
||||
|
||||
# ---------- 建立 SSO 会话 + 取授权码(否则 authorize 会 302 到登录页) ----------
|
||||
rm -f "${JAR}"
|
||||
${CURL} -o /dev/null -c "${JAR}" -X POST "${IDP}/login" \
|
||||
--data-urlencode "username=alice" --data-urlencode "password=alice123" \
|
||||
--data-urlencode "redirect=/"
|
||||
|
||||
LOC="$(${CURL} -o /dev/null -w '%{redirect_url}' -b "${JAR}" \
|
||||
"${IDP}/oauth/authorize?client_id=${CID}&response_type=code&redirect_uri=${REDIRECT}&scope=openid+profile+email&state=probe")"
|
||||
CODE="$(qget "${LOC}" code)"
|
||||
if [ -z "${CODE}" ]; then
|
||||
echo "!! 未取到授权码,authorize Location = ${LOC}" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# ---------- 换 token(Basic Auth,与 SsoBindController 一致) ----------
|
||||
AT="$(${CURL} -X POST "${IDP}/oauth/v20/token" -u "${CID}:${SECRET}" \
|
||||
-d "grant_type=authorization_code" --data-urlencode "code=${CODE}" \
|
||||
--data-urlencode "redirect_uri=${REDIRECT}" \
|
||||
| python3 -c "import sys,json;print(json.loads(sys.stdin.read()).get('access_token',''))")"
|
||||
echo "token 长度=${#AT}"
|
||||
|
||||
echo ""
|
||||
echo "=== [A] /oauth/v20/me + Bearer 头(SsoBindController.fetchUserInfo 的实际做法)==="
|
||||
${CURL} -o /tmp/me_bearer.json -w 'http=%{http_code}\n' "${IDP}/oauth/v20/me" \
|
||||
-H "Authorization: Bearer ${AT}"
|
||||
python3 -c "
|
||||
import json
|
||||
try:
|
||||
d=json.load(open('/tmp/me_bearer.json'))
|
||||
ks=['id','userid','userId','username','realname','displayName','email','mobile']
|
||||
print('字段:', {k:d.get(k) for k in ks if k in d})
|
||||
except Exception:
|
||||
print('解析失败:', open('/tmp/me_bearer.json').read()[:200])
|
||||
"
|
||||
|
||||
echo ""
|
||||
echo "=== [B] /oauth/v20/me + ?access_token=(对照)==="
|
||||
${CURL} -o /dev/null -w 'http=%{http_code}\n' "${IDP}/oauth/v20/me?access_token=${AT}"
|
||||
|
||||
echo ""
|
||||
echo "=== [C] /oauth/v20/me 无凭证(应 401/400)==="
|
||||
${CURL} -o /dev/null -w 'http=%{http_code}\n' "${IDP}/oauth/v20/me"
|
||||
Reference in new issue
Block a user