Compare commits
1
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
9340b3d330 |
No files matched your search
@@ -113,46 +113,3 @@ pageinspect 抢救路径失效。
|
||||
`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 为准。
|
||||
@@ -36,15 +36,14 @@
|
||||
- **关键能力**: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)
|
||||
## SSO:ipass-sso 替代 MaxKey(2026-09-14 实测跑通)
|
||||
- **配置命名空间红线**:`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/`)。
|
||||
- **遗留缺口**:~~`signJnpfToken()` 仍返回占位串~~ → ✅ **2026-09-14 已修**(真签发 Sa-Token);剩余缺口见 `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 正式归档。
|
||||
|
||||
## 🚨 JNPF 登录/账号硬约束(2026-09-14 实测,适用于所有"程序化建号/登录"场景)
|
||||
|
||||
|
||||
@@ -113,9 +113,11 @@ config:
|
||||
MultiTenancyAppCode: # YM企业多租户模式下的应用编码(开启新租户时必填):应用唯一编码
|
||||
MultiTenantIgnoreTable: # 库隔离、字段隔离拼接租户忽略表, 多表使用[,]分割
|
||||
|
||||
# ------------------------------ SSO(MaxKey 统一认证)配置 [2026-08-22 任务 17] ------------------------------
|
||||
# ⚠️ 启用 SSO 后普通 /api/oauth/Login 失效,所有用户走 MaxKey OAuth2 登录。
|
||||
# 默认 false(不启用)保持单体部署行为零变化;启用 true 走 MaxKey。
|
||||
# ------------------------------ SSO(ipass-sso 统一认证)配置 [2026-09-14 任务 X] ------------------------------
|
||||
# ⚠️ 启用 SSO 后普通 /api/oauth/Login 失效,所有用户走 ipass-sso OAuth2 登录。
|
||||
# 默认 false(不启用)保持单体部署行为零变化;启用 true 走 ipass-sso。
|
||||
# 迁移自 MaxKey:ipass-sso 设计目标就是"照抄 MaxKey 文档的应用不改一行代码就能对接"
|
||||
# (refs/ipass-sso/docs/design.md §15),OAuth2 授权码流 + /me 字段完全兼容。
|
||||
ssoEnabled: false
|
||||
# 默认 SSO 协议:cas / auth2(OAuth2 优先)
|
||||
defaultSSO: auth2
|
||||
@@ -126,35 +128,65 @@ config:
|
||||
# JWT 生成秘钥
|
||||
login:
|
||||
jwtSecretKey: WviMjFNC72VKwGqm5LPoheQo5XN9iN4d
|
||||
# MaxKey 服务地址(/sign 是 MaxKey 上下文路径)
|
||||
# ipass-sso 服务地址(无 /sign context-path,对应 nginx 1.30.4 动态模块端口)
|
||||
sso:
|
||||
baseUrl: http://127.0.0.1:9527/sign
|
||||
baseUrl: http://127.0.0.1:18098
|
||||
# 登录成功后前端跳转地址(业务页)
|
||||
sucessFrontUrl: http://127.0.0.1:3000/home
|
||||
# 错误信息是否输出到页面
|
||||
ticketOutMessage: false
|
||||
# 单点注销接口
|
||||
ssoLogoutApiUrl: http://127.0.0.1:9527/sign/sign/logout
|
||||
ssoLogoutApiUrl: http://127.0.0.1:18098/oauth/logout
|
||||
# OAuth2 协议配置
|
||||
auth2:
|
||||
enabled: true
|
||||
# MaxKey 注册的应用 ID(与 SSW task 17 一致)
|
||||
# ipass-sso 管理台注册的 client_id(与 SsoBindController 配对)
|
||||
clientId: ssw-test-app-id
|
||||
# MaxKey 注册的 client_secret 明文(MaxKey 默认 NoOpPasswordEncoder,长度需 ≥29 字符)
|
||||
# ipass-sso 注册的 client_secret **明文**(HS256 模式,不需 PasswordReciprocal.encode)
|
||||
clientSecret: ssw-test-secret-2026-long-enough-1234567890
|
||||
baseUrl: http://127.0.0.1:9527/sign
|
||||
# 授权地址
|
||||
authorizeUrl: http://127.0.0.1:9527/sign/authz/oauth/v20/authorize
|
||||
# 获取 Token 地址
|
||||
accessTokenUrl: http://127.0.0.1:9527/sign/authz/oauth/v20/token
|
||||
# 获取用户信息地址
|
||||
userInfoUrl: http://127.0.0.1:9527/sign/api/oauth/v20/me
|
||||
# CAS 协议配置(暂不启用)
|
||||
baseUrl: http://127.0.0.1:18098
|
||||
# 授权地址(标准 OIDC /oauth/authorize,MaxKey 客户端也能走 context-path 归一化)
|
||||
authorizeUrl: http://127.0.0.1:18098/oauth/authorize
|
||||
# 获取 Token 地址:用 ipass-sso 的 MaxKey 兼容别名(裸对象 + Basic Auth 都能通)
|
||||
# ⚠️ 不能用标准端点 /oauth/token —— 它返回 {code,data,msg} 信封,SsoBindController 取顶层会拿到 null
|
||||
accessTokenUrl: http://127.0.0.1:18098/oauth/v20/token
|
||||
# 获取用户信息地址:MaxKey 兼容别名,返回 id/userid/username/realname/displayName/email/mobile 扁平字段
|
||||
userInfoUrl: http://127.0.0.1:18098/oauth/v20/me
|
||||
# CAS 协议配置(暂不启用,ipass-sso P1 路线)
|
||||
cas:
|
||||
enabled: false
|
||||
baseUrl: http://127.0.0.1:9527/sign
|
||||
serverLoginUrl: http://127.0.0.1:9527/sign/authz/cas/login
|
||||
serverValidateUrl: http://127.0.0.1:9527/sign/authz/cas
|
||||
baseUrl: http://127.0.0.1:18098
|
||||
serverLoginUrl: http://127.0.0.1:18098/oauth/authorize
|
||||
serverValidateUrl: http://127.0.0.1:18098/oauth/introspect
|
||||
|
||||
# ------------------------------ SSW × ipass-sso OAuth2(SsoBindController 专用) ------------------------------
|
||||
# ⚠️ 前缀必须是 config.oauth.sso.* —— SsoBindController 的 @Value 就是这个路径。
|
||||
# 上面的 config.sso.* 是 jnpf 原生 SSO 命名空间,两者不通用;
|
||||
# 曾因差一层 `oauth` 导致 7 个 @Value 全部静默落到默认值(yml 改了也不生效)。
|
||||
oauth:
|
||||
sso:
|
||||
# ipass-sso 服务地址(无 /sign context-path)
|
||||
baseUrl: http://127.0.0.1:18098
|
||||
# 登录成功后前端跳转地址(业务页)
|
||||
sucessFrontUrl: http://127.0.0.1:3000/home
|
||||
# OAuth2 callback(必须与 ipass-sso 注册的 redirect_uris 逐字符一致)
|
||||
callbackUrl: http://127.0.0.1:30000/api/ssw/tds/SsoBind/oauth2
|
||||
auth2:
|
||||
# ipass-sso 管理台注册的 client_id
|
||||
clientId: ssw-test-app-id
|
||||
# ipass-sso 的 client_secret 明文(不需要 MaxKey 的 PasswordReciprocal.encode)
|
||||
clientSecret: ssw-test-secret-2026-long-enough-1234567890
|
||||
# 用 MaxKey 兼容别名端点:裸对象 + Basic Auth 通吃(标准端点返回信封会取不到字段)
|
||||
accessTokenUrl: http://127.0.0.1:18098/oauth/v20/token
|
||||
userInfoUrl: http://127.0.0.1:18098/oauth/v20/me
|
||||
# SSO 首次登录自动建号时绑定的默认角色。
|
||||
# ⚠️ 不绑角色 → JNPF LoginServiceImpl#checkUser 会抛 LOG004「账号权限不足」,登录必失败:
|
||||
# 只有 account 字面等于 admin 且 is_administrator=1 才短路,其余账号必须至少有一条
|
||||
# base_role_relation 且该角色在 base_authorize 里有存量授权。
|
||||
# default-role-id 优先;留空则按 base_role.f_en_code 查 default-role-code。
|
||||
# 内置角色 enCode:manager(管理员) / developer(开发者) / user(使用者)
|
||||
default-role-id: ""
|
||||
default-role-code: user
|
||||
|
||||
# ------------------------------ 系统信息&错误反馈 ------------------------------
|
||||
SoftName: jnpf-java-boot # 项目标识名(英文)
|
||||
|
||||
+227
-36
@@ -5,8 +5,14 @@ import com.baomidou.mybatisplus.core.toolkit.IdWorker;
|
||||
import io.swagger.v3.oas.annotations.Operation;
|
||||
import io.swagger.v3.oas.annotations.tags.Tag;
|
||||
import jnpf.base.ActionResult;
|
||||
import jnpf.base.UserInfo;
|
||||
import jnpf.consts.AuthConsts;
|
||||
import jnpf.exception.LoginException;
|
||||
import jnpf.model.BaseSystemInfo;
|
||||
import jnpf.service.LoginService;
|
||||
import jnpf.util.JsonUtil;
|
||||
import jnpf.util.StringUtil;
|
||||
import jnpf.util.UserProvider;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
import org.springframework.beans.factory.annotation.Value;
|
||||
import org.springframework.http.HttpEntity;
|
||||
@@ -19,7 +25,6 @@ import org.springframework.web.bind.annotation.RequestMapping;
|
||||
import org.springframework.web.bind.annotation.RequestParam;
|
||||
import org.springframework.web.bind.annotation.RestController;
|
||||
import org.springframework.web.client.RestTemplate;
|
||||
import org.springframework.web.util.UriComponentsBuilder;
|
||||
|
||||
import java.net.URLEncoder;
|
||||
import java.nio.charset.StandardCharsets;
|
||||
@@ -29,16 +34,26 @@ import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
/**
|
||||
* SSO 绑定 Controller(SSW × MaxKey · 2026-08-22 任务 17)
|
||||
* SSO 绑定 Controller(SSW × ipass-sso · 2026-09-14 任务 X)
|
||||
*
|
||||
* <p>处理 MaxKey OAuth2 callback:
|
||||
* <p>处理 ipass-sso OAuth2 callback(2026-09-14 由 MaxKey 切换至 ipass-sso):
|
||||
* <ol>
|
||||
> 2. <li>用户访问 SSW → 自动跳转 MaxKey `/authz/oauth/v20/authorize`
|
||||
> 3. <li>MaxKey 登录后回调 SSW `/api/ssw/tds/SsoBind/oauth2?code=xxx`
|
||||
> 4. <li>本 controller 用 code 换 access_token → 调 `/api/oauth/v20/me` 拿 MaxKey 用户信息
|
||||
> 5. <li>按 f_sso_user_id 查 base_user:找到 → 更新 f_sso_last_login 并签发 Sa-Token;找不到 → 自动创建本地账号
|
||||
> 6. <li>返回 Sa-Token(用于后续 SSW 业务请求)+ redirect URL
|
||||
> 7. </ol>
|
||||
* 1. <li>用户访问 SSW → 自动跳转 ipass-sso `/oauth/authorize`
|
||||
* 2. <li>ipass-sso 登录后回调 SSW `/api/ssw/tds/SsoBind/oauth2?code=xxx`
|
||||
* 3. <li>本 controller 用 code 换 access_token(Basic Auth)→ 调 `/oauth/v20/me` 拿用户信息(Bearer)
|
||||
* 4. <li>按 f_sso_user_id 查 base_user:找到 → 更新 f_sso_last_login;找不到 → 自动创建本地账号
|
||||
* **并绑定默认角色**({@code base_role_relation},否则 JNPF 会以「账号权限不足」拒绝登录)
|
||||
* 5. <li>签发 **真** JNPF Sa-Token(`loginService.userInfo(u,sys)` → `UserProvider.login(u)` → `u.getToken()`)
|
||||
* 6. <li>返回 Sa-Token(用于后续 SSW 业务请求)+ redirect URL
|
||||
* </ol>
|
||||
*
|
||||
* <p>ipass-sso 与 MaxKey 字段兼容(设计目标就是"照抄 MaxKey 文档的应用不改一行代码"):
|
||||
* <ul>
|
||||
* <li>MaxKey `id` ↔ ipass-sso `userid`(两者都映射 f_sso_user_id)
|
||||
* <li>MaxKey `username` ↔ ipass-sso `username`(登录账号)
|
||||
* <li>MaxKey `displayName` ↔ ipass-sso `realname`(显示名)
|
||||
* <li>兼容字段:`id/userid/username` 都识别;`displayName/realname/name` 都识别
|
||||
* </ul>
|
||||
*
|
||||
* <p>约束:默认 schema 是 `public`(与 jnpf 一致);不考虑多租户时所有子空间共享一张 base_user。
|
||||
*
|
||||
@@ -52,8 +67,9 @@ public class SsoBindController {
|
||||
|
||||
private final JdbcTemplate jdbcTemplate;
|
||||
private final RestTemplate restTemplate;
|
||||
private final LoginService loginService;
|
||||
|
||||
@Value("${config.oauth.sso.baseUrl:http://127.0.0.1:9527/sign}")
|
||||
@Value("${config.oauth.sso.baseUrl:http://127.0.0.1:18098}")
|
||||
private String ssoBaseUrl;
|
||||
|
||||
@Value("${config.oauth.sso.auth2.clientId:ssw-test-app-id}")
|
||||
@@ -62,10 +78,10 @@ public class SsoBindController {
|
||||
@Value("${config.oauth.sso.auth2.clientSecret:ssw-test-secret-2026-long-enough-1234567890}")
|
||||
private String ssoClientSecret;
|
||||
|
||||
@Value("${config.oauth.sso.auth2.accessTokenUrl:http://127.0.0.1:9527/sign/authz/oauth/v20/token}")
|
||||
@Value("${config.oauth.sso.auth2.accessTokenUrl:http://127.0.0.1:18098/oauth/token}")
|
||||
private String ssoAccessTokenUrl;
|
||||
|
||||
@Value("${config.oauth.sso.auth2.userInfoUrl:http://127.0.0.1:9527/sign/api/oauth/v20/me}")
|
||||
@Value("${config.oauth.sso.auth2.userInfoUrl:http://127.0.0.1:18098/oauth/userinfo}")
|
||||
private String ssoUserInfoUrl;
|
||||
|
||||
@Value("${config.oauth.sso.sucessFrontUrl:http://127.0.0.1:3000/home}")
|
||||
@@ -73,13 +89,29 @@ public class SsoBindController {
|
||||
|
||||
/**
|
||||
* OAuth2 callback URL(SSW 后端处理 OAuth2 code 的端点)
|
||||
* 用作 token 交换时的 redirect_uri(必须与 ssw-test-app-id 的 mxk_apps_oauth_client_details.WEB_SERVER_REDIRECT_URI 一致)
|
||||
* 用作 token 交换时的 redirect_uri(必须与 ipass-sso 注册的 oauth_clients.json.redirect_uris 逐字符一致)
|
||||
*/
|
||||
@Value("${config.oauth.sso.callbackUrl:http://127.0.0.1:30000/api/ssw/tds/SsoBind/oauth2}")
|
||||
private String ssoCallbackUrl;
|
||||
|
||||
public SsoBindController(JdbcTemplate jdbcTemplate) {
|
||||
/**
|
||||
* SSO 首次登录自动建号时绑定的默认角色 ID(优先于 {@link #ssoDefaultRoleCode})。
|
||||
* <p>留空则按 enCode 查 {@link #ssoDefaultRoleCode}。
|
||||
*/
|
||||
@Value("${config.oauth.sso.default-role-id:}")
|
||||
private String ssoDefaultRoleId;
|
||||
|
||||
/**
|
||||
* 默认角色 enCode({@code base_role.f_en_code},如 {@code user})。
|
||||
* <p>新建的 SSO 影子账号若不挂角色,JNPF {@code LoginServiceImpl#checkUser} 会抛
|
||||
* LOG004「账号权限不足」,登录必然失败——所以必须有默认角色。
|
||||
*/
|
||||
@Value("${config.oauth.sso.default-role-code:user}")
|
||||
private String ssoDefaultRoleCode;
|
||||
|
||||
public SsoBindController(JdbcTemplate jdbcTemplate, LoginService loginService) {
|
||||
this.jdbcTemplate = jdbcTemplate;
|
||||
this.loginService = loginService;
|
||||
this.restTemplate = new RestTemplate();
|
||||
}
|
||||
|
||||
@@ -116,46 +148,63 @@ public class SsoBindController {
|
||||
log.info("[SSO] user info fetched: id={}, username={}", userInfo.get("id"), userInfo.get("username"));
|
||||
|
||||
// Step 3: 查 base_user(按 f_sso_user_id)
|
||||
String ssoUserId = String.valueOf(userInfo.get("id"));
|
||||
// 兼容 MaxKey `id` 与 ipass-sso `userid`(两者都映射 SSO 全局用户 ID)
|
||||
String ssoUserId = String.valueOf(
|
||||
userInfo.getOrDefault("userid",
|
||||
userInfo.getOrDefault("id", userInfo.get("username"))));
|
||||
List<Map<String, Object>> existing = jdbcTemplate.queryForList(
|
||||
"SELECT f_id, f_account, f_real_name, f_sso_user_id FROM base_user WHERE f_sso_user_id = ? LIMIT 1",
|
||||
"SELECT f_id, f_account, f_real_name, f_is_administrator, f_sso_user_id " +
|
||||
"FROM base_user WHERE f_sso_user_id = ? LIMIT 1",
|
||||
ssoUserId);
|
||||
|
||||
String localUserId;
|
||||
String localAccount;
|
||||
String localRealName;
|
||||
boolean localIsAdmin = false;
|
||||
boolean firstLogin = false;
|
||||
if (existing.isEmpty()) {
|
||||
// Step 4a: 自动创建本地账号
|
||||
firstLogin = true;
|
||||
localUserId = IdWorker.getIdStr();
|
||||
localAccount = "sso_" + ssoUserId;
|
||||
String realName = (String) userInfo.getOrDefault("displayName", userInfo.getOrDefault("username", localAccount));
|
||||
// 显示名兼容:MaxKey `displayName` / ipass-sso `realname` / OIDC `name`
|
||||
localRealName = (String) userInfo.getOrDefault("realname",
|
||||
userInfo.getOrDefault("displayName",
|
||||
userInfo.getOrDefault("name",
|
||||
userInfo.getOrDefault("username", localAccount))));
|
||||
String email = (String) userInfo.getOrDefault("email", "");
|
||||
String mobile = (String) userInfo.getOrDefault("mobile", "");
|
||||
jdbcTemplate.update(
|
||||
"INSERT INTO base_user (f_id, f_account, f_real_name, f_email, f_mobile_phone, " +
|
||||
"f_sso_user_id, f_sso_source, f_sso_app_id, f_sso_bind_time, f_sso_last_login, " +
|
||||
"f_tenant_id, f_enabled_mark, f_is_administrator, f_creator_time, f_delete_mark) " +
|
||||
"VALUES (?, ?, ?, ?, ?, ?, ?, ?, NOW(), NOW(), '0', 1, 0, NOW(), 0)",
|
||||
localUserId, localAccount, realName, email, mobile,
|
||||
ssoUserId, "maxkey", ssoClientId);
|
||||
"VALUES (?, ?, ?, ?, ?, ?, ?, ?, NOW(), NOW(), '0', 1, 0, NOW(), NULL)",
|
||||
localUserId, localAccount, localRealName, email, mobile,
|
||||
ssoUserId, "ipass-sso", ssoClientId);
|
||||
log.info("[SSO] auto-created local account: f_id={}, account={}", localUserId, localAccount);
|
||||
} else {
|
||||
// Step 4b: 更新 f_sso_last_login
|
||||
localUserId = (String) existing.get(0).get("f_id");
|
||||
localAccount = (String) existing.get(0).get("f_account");
|
||||
localRealName = (String) existing.get(0).get("f_real_name");
|
||||
Object adminFlag = existing.get(0).get("f_is_administrator");
|
||||
localIsAdmin = adminFlag != null && "1".equals(String.valueOf(adminFlag));
|
||||
jdbcTemplate.update(
|
||||
"UPDATE base_user SET f_sso_last_login = NOW() WHERE f_id = ?",
|
||||
localUserId);
|
||||
log.info("[SSO] existing user matched: f_id={}, account={}", localUserId, localAccount);
|
||||
}
|
||||
// 确保有默认角色(幂等:新号必挂,存量号缺角色时补挂)。
|
||||
// 不挂角色 → JNPF LoginServiceImpl#checkUser 抛 LOG004「账号权限不足」,登录必失败。
|
||||
ensureDefaultRole(localUserId, localAccount);
|
||||
|
||||
// Step 5: 签发 Sa-Token(通过 jnpf 内部接口)
|
||||
// 这里简化处理:调用 jnpf 自己的 /api/oauth/Login 接口,绕过密码(admin SSO bypass)
|
||||
// 实际生产应该用 Sa-Token 的 StpUtil.login(),但需要先在 SSW 上下文识别到用户
|
||||
// 这里采用"中转到 jnpf /api/oauth/Login 重新发 token"模式:
|
||||
// - 构造一个内部 token(firstLogin=true 走强制改密;否则直发)
|
||||
String sswToken = signJnpfToken(localUserId, localAccount, firstLogin);
|
||||
if (StringUtil.isEmpty(localRealName)) {
|
||||
localRealName = localAccount;
|
||||
}
|
||||
|
||||
// Step 5: 签发 JNPF 本地 Sa-Token(真签发,见 signJnpfToken 注释)
|
||||
String sswToken = signJnpfToken(localUserId, localAccount, localRealName,
|
||||
localIsAdmin, firstLogin);
|
||||
|
||||
// Step 6: 返回结果
|
||||
Map<String, Object> result = new HashMap<>();
|
||||
@@ -164,7 +213,7 @@ public class SsoBindController {
|
||||
result.put("localAccount", localAccount);
|
||||
result.put("firstLogin", firstLogin);
|
||||
result.put("ssoUserId", ssoUserId);
|
||||
result.put("ssoSource", "maxkey");
|
||||
result.put("ssoSource", "ipass-sso");
|
||||
result.put("redirectUrl", ssoSucessFrontUrl);
|
||||
return ActionResult.success(result);
|
||||
} catch (Exception e) {
|
||||
@@ -190,7 +239,7 @@ public class SsoBindController {
|
||||
HttpEntity<String> entity = new HttpEntity<>(body, headers);
|
||||
ResponseEntity<Map> resp = restTemplate.exchange(
|
||||
ssoAccessTokenUrl, HttpMethod.POST, entity, Map.class);
|
||||
return resp.getBody();
|
||||
return unwrapBody(resp.getBody());
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -202,17 +251,159 @@ public class SsoBindController {
|
||||
HttpEntity<String> entity = new HttpEntity<>(headers);
|
||||
ResponseEntity<Map> resp = restTemplate.exchange(
|
||||
ssoUserInfoUrl, HttpMethod.GET, entity, Map.class);
|
||||
return resp.getBody();
|
||||
return unwrapBody(resp.getBody());
|
||||
}
|
||||
|
||||
/**
|
||||
* 签发 SSW 本地 Sa-Token。
|
||||
* <p>简化方案:直接调 jnpf 的 SaToken 工具创建一个 admin token(实际生产应该用 Sa-Token 的 StpUtil)。
|
||||
* <p>这里先用字符串占位(前端拿到后会用 cookie/header 传给 jnpf /api/oauth/CurrentUser 验证)。
|
||||
* 兼容 ipass-sso 两种响应形态:
|
||||
* <ul>
|
||||
* <li>MaxKey 兼容别名端点(/oauth/v20/token、/oauth/v20/me)→ 裸对象,原样返回
|
||||
* <li>标准端点(/oauth/token、/oauth/userinfo)→ 信封 {code,data,msg},剥离出 data
|
||||
* </ul>
|
||||
* 这样 application.yml 配标准端点或别名端点都能工作,不再依赖"配对了哪个 URL"。
|
||||
*/
|
||||
private String signJnpfToken(String localUserId, String localAccount, boolean firstLogin) {
|
||||
// 实际生产应该调 sa-token API,这里临时用 jwt 字符串(前端需要单独走 jnpf /api/oauth/Login 拿真实 token)
|
||||
// TODO: 接入 Sa-Token 签发机制
|
||||
return "sso-token-" + localUserId + "-" + (firstLogin ? "first" : "returning");
|
||||
@SuppressWarnings("unchecked")
|
||||
private Map<String, Object> unwrapBody(Map<?, ?> body) {
|
||||
if (body == null) {
|
||||
return new HashMap<>();
|
||||
}
|
||||
Object data = body.get("data");
|
||||
if (body.containsKey("code") && data instanceof Map) {
|
||||
return (Map<String, Object>) data;
|
||||
}
|
||||
return (Map<String, Object>) body;
|
||||
}
|
||||
|
||||
/**
|
||||
* 确保 SSO 影子账号至少挂一个角色(写 {@code base_role_relation},object_type='user')。
|
||||
* <b>幂等</b>:已有任意角色关系则直接返回,不会重复插。
|
||||
*
|
||||
* <p>这是"能不能登录"的硬前提,不是可选优化:JNPF {@code LoginServiceImpl#checkUser}
|
||||
* 的分支是
|
||||
* <pre>
|
||||
* if (!("admin".equals(account) && isAdministrator == 1)) {
|
||||
* list = positions(userId) + [userId] + roles(list);
|
||||
* if (CollUtil.isEmpty(authorizeApi.getListByObjectId(list))) throw LOG004("账号权限不足");
|
||||
* }
|
||||
* </pre>
|
||||
* 也就是说 —— <b>只有 account 字面等于 {@code admin} 且 is_administrator=1 才短路</b>,
|
||||
* 普通账号必须至少有一条 role 关系且该 role 在 {@code base_authorize} 里有存量授权。
|
||||
*
|
||||
* <p>角色来源优先级:{@code config.oauth.sso.default-role-id} >
|
||||
* {@code config.oauth.sso.default-role-code}(查 {@code base_role.f_en_code})。
|
||||
* 取不到时只告警不中断——让 callback 照常返回,错误会以 checkUser 的
|
||||
* 「账号权限不足」显式暴露,比在此处静默吞掉更好定位。
|
||||
*/
|
||||
private void ensureDefaultRole(String localUserId, String localAccount) {
|
||||
try {
|
||||
Integer n = jdbcTemplate.queryForObject(
|
||||
"SELECT count(*) FROM base_role_relation WHERE f_object_type = 'user' " +
|
||||
"AND f_object_id = ? AND f_delete_mark IS NULL",
|
||||
Integer.class, localUserId);
|
||||
if (n != null && n > 0) {
|
||||
log.debug("[SSO] account={} 已有 {} 条角色关系,跳过默认角色绑定", localAccount, n);
|
||||
return;
|
||||
}
|
||||
String roleId = resolveDefaultRoleId();
|
||||
if (StringUtil.isEmpty(roleId)) {
|
||||
log.warn("[SSO] 未解析到默认角色(default-role-id/default-role-code={})," +
|
||||
"account={} 将无任何授权,登录会被 checkUser 以「账号权限不足」拒绝",
|
||||
ssoDefaultRoleCode, localAccount);
|
||||
return;
|
||||
}
|
||||
jdbcTemplate.update(
|
||||
"INSERT INTO base_role_relation (f_id, f_role_id, f_object_type, f_object_id, " +
|
||||
"f_creator_time, f_tenant_id, f_delete_mark) " +
|
||||
"VALUES (?, ?, 'user', ?, NOW(), '0', NULL)",
|
||||
IdWorker.getIdStr(), roleId, localUserId);
|
||||
log.info("[SSO] bound default role: account={}, userId={}, roleId={}", localAccount, localUserId, roleId);
|
||||
} catch (Exception e) {
|
||||
log.error("[SSO] 绑定默认角色失败 account={}: {}", localAccount, e.getMessage());
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 解析默认角色 ID:显式配置的 id 优先,否则按 enCode 查启用中的角色。
|
||||
*
|
||||
* @return 角色 ID;取不到返回 null
|
||||
*/
|
||||
private String resolveDefaultRoleId() {
|
||||
if (StringUtil.isNotEmpty(ssoDefaultRoleId)) {
|
||||
return ssoDefaultRoleId;
|
||||
}
|
||||
if (StringUtil.isEmpty(ssoDefaultRoleCode)) {
|
||||
return null;
|
||||
}
|
||||
List<String> ids = jdbcTemplate.queryForList(
|
||||
"SELECT f_id FROM base_role WHERE f_en_code = ? AND f_enabled_mark = 1 " +
|
||||
"AND f_delete_mark IS NULL LIMIT 1",
|
||||
String.class, ssoDefaultRoleCode);
|
||||
return ids.isEmpty() ? null : ids.get(0);
|
||||
}
|
||||
|
||||
/**
|
||||
* 签发 JNPF 本地 Sa-Token(**真签发**,取代原先的占位串)。
|
||||
*
|
||||
* <p>刻意复刻 JNPF 官方登录骨架 {@code AbstractTokenGranter#loginAccount} 的三步:
|
||||
* <ol>
|
||||
* <li>{@code loginService.userInfo(u, sysInfo)} —— 内部按 {@code userDetailKey} 走
|
||||
* {@code UserDetailsService.loadUserEntity(u)} 从库里加载 {@code UserEntity},
|
||||
* 写入 {@code LoginHolder},并用库中真值补全用户字段(组织/角色/管理员标记)
|
||||
* <li>{@code UserProvider.login(u)} —— 内部 {@code StpUtil.login(splicingLoginId(userId))}
|
||||
* 并把 UserInfo 写进 Sa-Token 会话
|
||||
* <li>{@code u.getToken()} 取回 token 明文(与官方 granter 返回同一个来源)
|
||||
* </ol>
|
||||
*
|
||||
* <p>传进来的 {@code localUserId/localRealName/isAdmin} 只是兜底初值,
|
||||
* 最终以 {@code userInfo()} 从库里读到的为准。
|
||||
*
|
||||
* <p>⚠️ 三个坑(都是实测踩出来的,别改回去):
|
||||
* <ul>
|
||||
* <li><b>不能跳过第 1 步</b>。JNPF 注册了 Sa-Token 登录监听器
|
||||
* {@code jnpf.listener.LoginListener#doLogin},它会在 {@code StpUtil.login()} 触发时
|
||||
* 读 {@code LoginHolder.getUserEntity()} 并 {@code UserService.updateById(entity)}
|
||||
* 回写登录统计;LoginHolder 为空直接 NPE,塞假实体会把用户行写坏。
|
||||
* <li><b>{@code userDetailKey} 必须是 {@code AuthConsts.USERDETAIL_ACCOUNT}</b>
|
||||
* ({@code "userDetailUserAccount"},与 {@code PasswordTokenGranter} 一致),
|
||||
* 否则 {@code UserDetailsServiceBuilder.getUserDetailService()} 拿不到加载器。
|
||||
* <li><b>不要自己调 {@code StpUtil.login(userId)}</b>:loginId 是
|
||||
* {@code splicingLoginId(userId)}(多租户下形如 {@code {datasourceId}:{userId}}),
|
||||
* 裸 userId 登录会和 {@code StpUtil.checkLogin()} 的校验路径对不上。
|
||||
* </ul>
|
||||
*/
|
||||
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);
|
||||
// 与 AbstractTokenGranter#switchTenant 的非多租户分支一致(本部署 MultiTenancy=false)
|
||||
u.setTenantId("");
|
||||
u.setTenantDbType(-1);
|
||||
u.setGrantType(firstLogin ? "sso-first" : "sso");
|
||||
|
||||
BaseSystemInfo sysInfo = null;
|
||||
try {
|
||||
sysInfo = loginService.getBaseSystemConfig(u.getTenantId());
|
||||
} catch (Exception e) {
|
||||
log.warn("[SSO] 读取系统配置失败,降级为默认值: {}", e.getMessage());
|
||||
}
|
||||
if (sysInfo == null || sysInfo.getSingleLogin() == null) {
|
||||
sysInfo = new BaseSystemInfo();
|
||||
sysInfo.setSingleLogin(0);
|
||||
}
|
||||
|
||||
// 关键:加载 UserEntity → LoginHolder,并补全用户字段(缺这步 listener 会 NPE)
|
||||
u = loginService.userInfo(u, sysInfo);
|
||||
|
||||
// 触发 StpUtil.login(LoginListener 此时能从 LoginHolder 取到实体)
|
||||
UserProvider.login(u);
|
||||
String token = u.getToken();
|
||||
log.info("[SSO] Sa-Token issued: account={}, userId={}, admin={}, firstLogin={}, token(head)={}",
|
||||
u.getUserAccount(), u.getUserId(), u.getIsAdministrator(), firstLogin,
|
||||
token == null ? "null" : token.substring(0, Math.min(12, token.length())));
|
||||
return token;
|
||||
}
|
||||
}
|
||||
@@ -4,10 +4,6 @@
|
||||
> **本文档为预判结论**;其后的本机实测复核见 [`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`。
|
||||
|
||||
---
|
||||
|
||||
@@ -41,9 +37,6 @@
|
||||
|
||||
**净结论不变**:可替代,且比预判更容易(改动量从"< 50 行"降到"零 Java 主流程改动")。
|
||||
|
||||
> ⚠️ 以上均为**协议层**结论,与 `boot/` 代码无关,**不受 2026-09-14 代码回滚影响**;
|
||||
> 第 4 章列的 `boot/` 改动当前**未落在仓库**(见文首代码落地状态)。
|
||||
|
||||
---
|
||||
|
||||
## 2. ipass-sso 是什么
|
||||
@@ -186,7 +179,7 @@ String realName = (String) userInfo.getOrDefault("displayName",
|
||||
String email = (String) userInfo.getOrDefault("email", "");
|
||||
String mobile = (String) userInfo.getOrDefault("mobile", "");
|
||||
|
||||
// 自动建账号 + 真签发 Sa-Token(2026-09-14 已验证;⚠️ 该实现已回滚,仓库当前仍是占位版,详见 §5.3)
|
||||
// 自动建账号 + 真签发 Sa-Token(2026-09-14 已修,占位串问题不复存在,详见 §5.3)
|
||||
```
|
||||
|
||||
### 3.3 当前依赖的 MaxKey 特性
|
||||
@@ -326,7 +319,7 @@ ipass-sso 当前**缺失**:
|
||||
|
||||
**建议**:本期接受缺失,由 SSW 端在 `SsoBindController` 补**登录失败计数**(Redis 计数 + 临时锁定)+ **审计日志**(base_user.f_sso_last_login 已够用)。
|
||||
|
||||
### 5.3 SsoBindController 现状问题 —— ✅ **2026-09-14 已验证可行(实现已回滚)**
|
||||
### 5.3 SsoBindController 现状问题 —— ✅ **2026-09-14 已修复**
|
||||
|
||||
原本 `signJnpfToken` 是**字符串占位实现**(返回 `"sso-token-" + localUserId + "-first"`),未真正签发 Sa-Token;
|
||||
前端拿它调业务接口必 401。**现已改为走 JNPF 官方登录骨架真签发**(详见 `RUNTIME-VALIDATION.md` §4 坑 4/坑 5):
|
||||
@@ -380,7 +373,7 @@ private String signJnpfToken(String localUserId, String localAccount, String loc
|
||||
| 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`) |
|
||||
| 5 | 修 signJnpfToken(真签发 Sa-Token)+ `ensureDefaultRole`(挂默认角色) | `SsoBindController.java` | ✅ **已完成**(2026-09-14) |
|
||||
| 6 | 加登录失败计数(Redis / DB 字段) | `SsoBindController.java` + Redis 工具类 | 中 |
|
||||
| 7 | curl 端到端验证 | `tests/sso-ipass-e2e.sh`(新写) | 无 |
|
||||
| 8 | (可选)拆掉 MaxKey 依赖(`refs/maxkey/` 仍保留作参考资料) | 文档 | 无 |
|
||||
@@ -395,7 +388,7 @@ private String signJnpfToken(String localUserId, String localAccount, String loc
|
||||
| 2 | 是替换 MaxKey 还是共存? | **替换**——SSW 当前只用 OAuth2,MaxKey 高级能力(SAML/CAS/RocketMQ)均未启用 | ⏳ 待拍板 |
|
||||
| 3 | `refs/maxkey/` 是否拆掉? | **保留**——作协议对齐参考(ipass-sso 自己也照抄 MaxKey) | ⏳ 待拍板 |
|
||||
| 4 | 安全运营闭环是否在替换时同步补齐? | **替换时同步补"登录失败计数"**(最高优先级),其余延后 | ⏳ 待拍板 |
|
||||
| 5 | signJnpfToken 占位是否一并修? | **是**——避免替换后还是登录不能用 | ✅ **已验证可行(2026-09-14)**,连带走通 checkUser「账号权限不足」;⚠️ 代码已回滚,未留在仓库 |
|
||||
| 5 | signJnpfToken 占位是否一并修? | **是**——避免替换后还是登录不能用 | ✅ **已修(2026-09-14)**,并连带修掉 checkUser「账号权限不足」 |
|
||||
| 6 | ipass-sso 部署形态(容器 vs 本机)? | **本机直接跑**(动态模块必须与 nginx 同源编译,进容器更绕) | ⏳ 待拍板(本机已实测可行) |
|
||||
| 7 | 多租户(mxk_institutions)是否在 ipass-sso 落地时启用? | **不启用**——SSW 多租户由 JNPF 多 schema 实现,不依赖 ipass-sso 多租户 | ⏳ 待拍板(不阻塞) |
|
||||
|
||||
|
||||
@@ -3,13 +3,6 @@
|
||||
> **状态**:可行性探索 + 本机端到端实测**均已跑通**(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。
|
||||
|
||||
---
|
||||
|
||||
@@ -39,8 +32,7 @@ ipass-sso 的定位就是「让按 MaxKey 文档写出来的应用不改一行
|
||||
| 用户实时同步 | ❌ 无 RocketMQ 对应物;改用「登录时拉一次 userinfo」(**已实现**,够用但非实时) |
|
||||
| 扩展协议 | ❌ SAML / CAS / SCIM / LDAP / 社交登录均无(SSW 当前不用,不阻塞) |
|
||||
|
||||
**推荐**:本期可推进替换。原先的「唯一硬前置」`signJnpfToken()` 真签发**已验证可行**(实现见 §4;
|
||||
⚠️ 该代码已回滚,不在当前仓库)。
|
||||
**推荐**:本期可推进替换。原先的「唯一硬前置」`signJnpfToken()` 真签发**已完成**(见 §5)。
|
||||
|
||||
## 3. 文档索引
|
||||
|
||||
@@ -53,7 +45,7 @@ ipass-sso 的定位就是「让按 MaxKey 文档写出来的应用不改一行
|
||||
|
||||
## 4. 替换要改什么
|
||||
|
||||
**三处**(OAuth2 主流程代码仍是一行未改)—— 以下是**实施方案**,⚠️ 当前仓库未包含(见顶部代码落地状态):
|
||||
**三处**(OAuth2 主流程代码仍是一行未改):
|
||||
|
||||
1. **`application.yml`**(源码 + 外挂 `dist/config/` 各一份)——新增 `config.oauth.sso.*` 段:
|
||||
|
||||
@@ -95,7 +87,7 @@ ipass-sso 的定位就是「让按 MaxKey 文档写出来的应用不改一行
|
||||
|
||||
| # | 事项 | 优先级 |
|
||||
|---|---|---|
|
||||
| 1 | ~~**`signJnpfToken()` 仍是占位符**~~ → ✅ **2026-09-14 已验证可行**(真签发 Sa-Token,`/api/oauth/me` 实测 code=600→200);⚠️ 该实现已回滚,落地时按 §4 实施 | ~~高~~ 方案已验证 |
|
||||
| 1 | ~~**`signJnpfToken()` 仍是占位符**~~ → ✅ **2026-09-14 已修**(真签发 Sa-Token,`/api/oauth/me` 已验证) | ~~高~~ 已完成 |
|
||||
| 2 | `config.ssoEnabled: false` 未开启 → 当前靠手动访问 callback 端点验证,前端跳转未接 | 高 |
|
||||
| 3 | 安全闭环:登录失败计数 / 锁定、密码策略、TOTP、会话踢出 | 中(至少补失败计数) |
|
||||
| 4 | 用户实时同步(MaxKey RocketMQ 的替代) | 低(登录时拉一次已够用) |
|
||||
@@ -128,47 +120,7 @@ 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`
|
||||
@@ -1,12 +1,6 @@
|
||||
# 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 仍是修复版产物。
|
||||
> 日期:2026-09-14 · 环境:本机开发联调 · 结论:**协议层零代码替换 MaxKey;真 Sa-Token 签发已打通,端到端全绿(PASS=12)**
|
||||
|
||||
---
|
||||
|
||||
@@ -74,7 +68,7 @@
|
||||
└─ 带 token → body code=200 + {userAccount:"sso_alice", userName:"爱丽丝"} ✅
|
||||
```
|
||||
|
||||
SSW 回调实际响应(**验证版构建已签为真 token** —— ⚠️ 该构建的源码改动已回滚,见备份分支):
|
||||
SSW 回调实际响应(**已修复为真 token**):
|
||||
|
||||
```json
|
||||
{"code":200,"msg":"Success","data":{
|
||||
@@ -234,12 +228,6 @@ javap -p ext/ssw/tds/controller/SsoBindController.class | grep ensureDefaultRole
|
||||
| `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` 不被加载。
|
||||
|
||||
@@ -247,9 +235,8 @@ javap -p ext/ssw/tds/controller/SsoBindController.class | grep ensureDefaultRole
|
||||
|
||||
## 6. 遗留 TODO(本次未做,需要时再推)
|
||||
|
||||
1. ~~**`signJnpfToken()` 仍是占位符**~~ —— ✅ **2026-09-14 已验证可行**(走 JNPF 官方登录骨架真签发
|
||||
Sa-Token,`/api/oauth/me` 带 token 通过鉴权),见 §4 坑 4/坑 5。
|
||||
⚠️ **但该实现已回滚**,仓库当前仍是占位版;重新落地时按 §5 清单 + 分支 `sso-real-token-9340b3d` 取回源码。
|
||||
1. ~~**`signJnpfToken()` 仍是占位符**~~ —— ✅ **已于 2026-09-14 修复**,见 §4 坑 4/坑 5。
|
||||
现在走 JNPF 官方登录骨架真签发 Sa-Token,`/api/oauth/me` 已能拿 token 通过鉴权。
|
||||
2. **SSO 开关未启用** —— `config.ssoEnabled: false`,当前是「手动访问 callback 端点」验证,未接前端跳转。
|
||||
3. **安全闭环缺失** —— 登录失败锁定、密码策略、TOTP、会话踢出在 ipass-sso roadmap(P0)未实现;SSW 侧也未有失败计数。
|
||||
4. **用户实时同步缺失** —— MaxKey 的 RocketMQ `MXK_IDENTITY_MAIN_TOPIC` 同步在 ipass-sso 无对应物;
|
||||
|
||||
Reference in new issue
Block a user