29 Commits
Author SHA1 Message Date
admin 2821adf116 docs(deploy): 容器化部署方案 + rust-nginx-base 基础镜像说明
- docs/sso-deploy-plan.md:ucenter chg_0012 落地 SSO 的容器化部署计划
  (本机端口 8881 + host 编产物再 COPY 进极简镜像的逆模型)
- docs/rust-nginx-base.md:rust-nginx-base 镜像设计 + tag 约定 + 复用姿势
  (iPass / SSO / 未来其他 ngx-rust 项目共用)
0923
2026-09-24 16:27:08 +08:00
admin 67a8e731cc feat(deploy): 容器化构建(多阶段 Dockerfile + compose + entrypoint + 共用 base)
- 主镜像 Dockerfile:多阶段构建,复用 rust-nginx-base 镜像(nginx 1.30.4 + rust 1.89
  + 已 configure 的 pcre/openssl/编译链),冷构建从 ~17min 压到 ~5min
- deploy/nginx.conf:容器内 nginx 配置(端口 18098 / /usr/local/nginx/... 路径)
- docker-compose.yml:本机一键起服务(端口 8881→18098)+ S10 健康探测
- scripts/container-entrypoint.sh:容器入口脚本(启动前 healthcheck 等)
- .dockerignore:避免把 build/target/data/refs 误打进镜像
- deploy/Dockerfile.base:rust-nginx-base 镜像定义(apt 链 + nginx/pcre 源码 + 已
  ./configure 过的源码树)
- deploy/build-base-image.sh:构建并推送 base 镜像到阿里云 CR
  (crpi-yscq976uwza88qap.cn-shenzhen.personal.cr.aliyuncs.com/ssw188/nginx)
2026-09-24 16:27:05 +08:00
admin 1e2b117218 refactor(paths): 拆 source/ 包层,顶层与 ipass/ipass 对齐
- source/rust   → rust/
- source/conf   → conf/
- source/www    → www/
- source/data-seed → data-seed/
- source/data   → data/
- scripts/ 保留(语义不对应 ipass deploy/)
- /build/ 加入 .gitignore(本机 nginx 源码树)
- README.md 目录树同步 + build 路径 /tmp/sso-build → ./build
- Cargo.toml path 依赖 '../../deps/ipass' → '../deps/ipass'
- CLAUDE.md 同步路径示例

cargo check 通过(52s);release build 通过(1m26s),产物 libsso_gateway.dylib
2026-09-21 15:44:55 +08:00
ssw f9c2324c47 refactor: 将 ipass-core 内核外置为 deps/ipass 子模块,本仓库仅保留 SSO
- 新增 git submodule deps/ipass(指向 ipass/ipass,pin 9c46e27),内核与通用能力插件统一收归子模块
- 删除仓库内 crates/ipass-core、vendor/ngx-rust、crates/plugin-domain
- source/rust/Cargo.toml 改为 members=[plugin-sso, gateway] + exclude=[../../deps/ipass],ngx/nginx-sys/ipass-core 改为 ../../deps/ipass/... 的 path 依赖
- gateway 移除 plugin-domain 装配:PLUGINS=[SsoPlugin, CorePlugin],去除 ipass_proxy 指令 / domain 开关 / set_flag_domain
- plugin-sso 新增 compat.rs 兼容层,重建被主线内核移除的 4 个 http 辅助函数(body_object/json_body/send_ct/redirect),scim/cas/portal/reset.rs 改走 crate::compat
- 删除 tests/domain-e2e.sh,run-local-e2e.sh 的域名测试调用一并移除(e2e 由 7 套降为 6 套)
- 更新 README/CLAUDE/docs 反映子模块结构;构建已验证:cargo build --release 通过,产出 libsso_gateway.dylib
2026-09-21 15:17:35 +08:00
ssw d63beeb15d feat(sso): 应用管理补强 —— CAS service 白名单 / 应用元数据 / 可见范围 / 用户门户
安全修复(重要):CAS 首版未校验 service 白名单,/cas/login?service=https://evil 会把

已登录用户连同 ST-… 一起 302 出去,攻击者可据此换出用户名(开放重定向 + 票据外泄)。

现要求 service 命中某接入方登记的 redirect_uris(精确或忽略 query;绝不做前缀/通配):

login 不过 → 403;validate → no;serviceValidate → INVALID_SERVICE(不复用 INVALID_TICKET)。

校验在签发票据之前;白名单复用「应用管理」注册表,不另开配置。

- 注册表增强:接入方新增 protocol(oauth2/cas) / description / logo_url / home_url /

  visible_roles·depts·groups(三项全空=全员可见),全部 #[serde(default)] 兼容存量 JSON;

  元数据收进 AppMeta 并做归一化校验(访问地址必须 http(s),防 javascript:)

- 用户门户(新建 portal.rs):GET /apps(按可见范围渲染卡片,CAS 应用直达 /cas/login?service=…)

  + GET /api/portal/apps(JSON);未登录 302 到 /login?redirect=<绝对地址>

- oauth::current_user():管理台会话与终端用户 SSO 会话都认;is_safe_redirect 把 127.0.0.1/[::1]

  与 localhost 同待遇(本地才能走完登录回跳)

- 管理台:应用管理表单补齐新字段,列表显示协议徽标 + 可见范围提示

- e2e:第 7 套 [B] 改为先登记 CAS 应用,新增白名单断言;新增 [G] 门户段;[F] 补字段断言

  → PASS=52 FAIL=0,七套全 rc=0

- 文档:README / CLAUDE.md / maxkey-migration-analysis / roadmap / design.md;技能补「必踩点 4、5」

  与「给应用管理加字段的套路」;截图更新(应用管理 + 用户门户)
pre-ipass-strip
2026-09-14 19:54:16 +08:00
ssw df8b9a08a8 docs(screenshot): 补 P1/P2 界面截图(身份同步 / 会话审计 / CAS-SCIM 接入指南 / 找回密码页)
- 均取自本地实例真机无头 Chrome 截图,已核对渲染正确
2026-09-14 19:26:58 +08:00
ssw 20466894fc feat(sso-ui): 补齐 P1/P2 的管理台界面与终端用户找回页
- 管理台 source/www/admin.html:3 页签 → 5 页签

  · 新增「身份同步」:钉钉/企微/飞书手动触发 + 结果表(处理/新建/更新/跳过)

  · 新增「会话 / 审计」:在线会话列表 + 三种踢下线、审计日志含 IP 归属地(geo 的可见出口)

  · 账号行加「双因子」按钮(setup→enable / disable)

  · 接入指南补 CAS 1.0/2.0、SCIM 2.0、LDAP/AD 三段端点与配置说明

  · 以上全部复用既有 API,后端零改动

- 自助密码重置补终端用户页面(reset.rs):GET /forgot、GET /reset?token=

  · 修真实 bug:send_reset 的重置链接原指向 POST 端点,用户点开必然失败 → 改为 GET 页面

  · oauth.rs 登录页加「忘记密码?」入口;页面渲染用占位符 replace(不用 format!,避开 JS 花括号转义)

- e2e:第 7 套新增 [F] 界面段(15 项断言)→ PASS=36 FAIL=0;七套全 rc=0

- 文档:README / CLAUDE.md / maxkey-migration-analysis / roadmap 同步 UI 说明

- 技能 ipass-core-add-plugin 补「UI 层」章节 + 排错 2 行(SIGPIPE 与 [[ ]] 的坑)
2026-09-14 19:15:29 +08:00
ssw 7718c9cf5a docs(skill): ipass-core-add-plugin 补 P1/P2 协议端点族经验并去重
- 新增「协议扩展端点族」章节:兄弟模块 route() 兜底分发、零新增 crate(手写 BER / TcpStream)

- 三条实测坑:新模块 env 白名单、302 空 body→NGX_ERROR、重置类 e2e 勿动 admin 种子口令(锁定级联)

- 步骤 6 补 env 白名单铁律;排错表 +3 行;套数更新为七套;删除重复的「基准约定」段
2026-09-14 19:00:15 +08:00
ssw 4a780a4ce7 feat(sso): MaxKey 迁移 P1/P2 —— SCIM/CAS/LDAP/同步连接器/自助密码重置/归属地
- 新增 plugin-sso 模块(零新增 crate):scim.rs(SCIM 2.0)、cas.rs(CAS 1.0/2.0)、

  ldap.rs(LDAP/AD,手写 BER/ASN.1 Simple Bind)、sync.rs(钉钉/企微/飞书手动触发同步)、

  reset.rs(自助密码重置)、geo.rs(登录 IP 归属地)

- api.rs 兜底路由按 scim→cas→reset→sync 分发兄弟模块;h_login 集成 LDAP(未启用零行为变化)

- 修 http::redirect 空 body 触发 NGX_ERROR(CAS 302 无 Location 的根因)

- nginx.conf / nginx.test.conf 补 env SYNC_* / PASSWORD_RESET_*(worker 可见)

- 新增第 7 套 e2e tests/maxkey-p1p2-e2e.sh(21 项),harness 接入 [7/7];七套全绿 rc=0

- 修脚本 $var 紧跟全角字符被并入变量名的 shell 坑(tests + scripts)

- 文档同步:maxkey-migration-analysis(P1/P2 状态) / roadmap(v4) / CLAUDE.md / README.md
2026-09-14 18:51:37 +08:00
ssw f3aabb3405 test(sso): 给管理台会话管理端点补 e2e 回归(A10)
- mgt 会话管理接口(/api/admin/sessions 列表 + /api/admin/sessions/kick 踢出)
  早已实现且仅缺自动化覆盖,本次补足回归:
  - admin 登录 -> 列表含 alice 的 sso 会话
  - 按 username 强制踢出 alice 全部会话(kicked>=1)
  - 踢出后列表清零
  - 边界:kick 缺参 400、非 admin 读列表 401
- 修正断言信封取值:会话列表响应套 {code,data:{items}},原按顶层 items 取误判
- A10 置于脚本末尾(C5 之后),避免踢掉 alice SSO 会话污染 B/C 组业务测试
- 六套 e2e 全绿(互通 rc=0)
2026-09-14 15:50:09 +08:00
ssw 6409d42817 feat(sso): MaxKey/JNPF/uc 迁移 P0 修复
- /sign/api/oauth/v20/me 归一化盲区:补 /api/oauth/v20/me 路由别名
- scope 逗号+空白切分(authorize 与 has_openid 同口径,避免逗号串吞 id_token)
- mobile 身份字段走 User.extra 全链(check_mobile/create/set_profile/claims/me),
  me 补 MaxKey 别名字段 id/userId/displayName/fullName
- 单点注销:/logout、/sign/logout 别名 + redirect_uri 302 回跳
  (client 白名单,未登记 400;302 同时清会话 cookie)
- 管理员重置密码入口统一过 accounts::check_password
- e2e 互通套新增 A2b/A2c/A2d/A2e/A8b 六条断言,六套回归 rc=0
2026-09-13 22:06:12 +08:00
ssw 71809a4090 docs(skill): ipass-core-add-plugin 增补内核基准约定(上游同步/插件自解模式) 2026-09-13 18:55:06 +08:00
ssw 6120939e3c docs(skill): ipass-core-add-plugin 增补内核基准约定(上游同步/插件自解模式) 2026-09-13 18:54:33 +08:00
ssw 245e2efc5e docs: 指令名对齐 ipass_* 前缀(sso_iap 保留为插件特有开关) 2026-09-13 18:52:50 +08:00
ssw 4713071cd0 refactor(gateway): 装配重排 —— [Sso, Core, Domain] + JSON 信封兜底 + CoreExt
- PLUGINS = [SsoPlugin, CorePlugin, DomainPlugin]:重叠身份端点由 sso 优先
  接管(CAPTCHA/锁定/审计/身份字段),Core 补 LLM 三端点(grant/models/limits)
- 实现 CoreExt::reclaim_on_delete:删账号连带回收名下域名
- dispatch 未命中改 JSON 信封 404(对齐上游,原建议项落地)
- loc_switch 补 Proxy/Apix 变体(Proxy 同指 domain 开关;Llm/Apix 恒 false)
2026-09-13 18:52:50 +08:00
ssw d006cd0f2f refactor(domain): 域名插件整体替换为上游版 + conf/e2e 指令对齐
- plugin-domain 7 文件取上游 ddd4172+(config/store 独立、update_domains 三泛型)
- 路由对齐上游:purge 移至 /api/admin/purge;开关指令 sso_domain → ipass_proxy
- 未命中语义对齐上游:access 未命中由插件直接 404(不落转发层兜底),
  e2e zone 外 Host 断言同步修正
- nginx.conf / nginx.test.conf:sso_state/data_dir/api → ipass_*(sso_iap 保留,
  sso 插件特有开关)
2026-09-13 18:52:49 +08:00
ssw 7764fa76b7 refactor(sso): plugin-sso 适配上游内核(身份语义迁入插件层)
上游决策 A4/A5 的落点:
- accounts.rs(新):UserExt 扩展 trait(email/department/groups/锁定态存
  extra 强类型读写)、账号操作 create/set_profile/set_role/batch_update/
  unlock/record_login_failure(经 store::update_users + sync_shm 官方路径)、
  管理台 view、身份校验(口令策略 8 位留插件层,A6-1)
- storex.rs(新):插件文件读写(path_in_data 口径,A5),存量数据文件零迁移
- utilx.rs(新):html_escape/url_encode(内核以上游为准后移入插件)
- audit.rs(新):原内核审计模块迁入(仅 sso 使用)
- update_extra 闭包适配上游 FnOnce(&mut User) 签名;字段访问改 UserExt 方法
2026-09-13 18:52:26 +08:00
ssw 74e5678188 refactor(core): 内核原样同步上游 ipass-core ee05b27 (1.0.13)
按「上游内核为基准」收敛:ipass-core 14 文件与 refs/ipass 逐字节一致。
- 上游采纳我方建议已实现:User.extra flatten (A1) + users::update_extra、
  split_value rposition (A2)、iter_prefix_ex (A3)
- 新增内核身份端点 api.rs/auth.rs (CorePlugin) + usage.rs
- audit.rs 迁出内核(仅 sso 使用 → plugin-sso 本地模块)
- Cargo.toml 元数据保留我方 crate 名(产物 libsso_gateway.dylib 为部署依赖)
2026-09-13 18:52:26 +08:00
ssw 81c8346ad6 docs: 致上游 ipass 内核修改建议(A 档 6 项 + B 档自解清单)
- A1 User 加 extra flatten 透传通道(插件字段通用解,替代逐字段硬编码)
- A2 split_value position→rposition(内嵌分隔符截断 bug)
- A3 iter_prefix_ex 带 exp 枚举原语
- A4 账号操作支持路径确认(插件经 store::update_users + sync_shm 自实现)
- A5 插件文件读写口径二选一
- A6 PASSWORD_MIN_LEN 6→8、COOKIE_NAME 由插件声明
- B 档全部本地自解,不阻塞内核原样收敛
2026-09-13 17:18:16 +08:00
ssw 912c21a442 docs: 上游 ipass 插件化落地(ddd4172)第二轮一致性核对
- 上游 P0-P5 已同源插件化,Plugin trait 三回调与我方同构,trait 层零适配可合流
- 域名插件第一轮结论全部维持:8 路由 7 条一致、DomainEntry 逐字相同、domains.json 可互换
- 真分歧收敛为两类:内核边界属定位分歧(身份在内核 vs 身份即插件),建议项维持
  (update_plugin 三泛型、dispatch 兜底改 JSON 信封,上游实现可直抄)
- 技能第 8 节前提更新:先探明上游形态再选对照口径
2026-09-13 16:34:54 +08:00
ssw 8e9becaad7 docs: 插件化架构分析与迁移/任务文档,同步 CLAUDE.md 与路线图
新增
  docs/plugin-architecture-analysis.md  内核/插件边界分析、P 阶段拆分与装配契约
  docs/maxkey-migration-analysis.md     MaxKey 端点别名与 context-path 归一化对齐
  docs/task-plan.md                     阶段任务清单与验收口径

同步
  CLAUDE.md    crate 清单与目录地图:plugin-domain 标为「已迁入示例」,
               plugin-llm 明确「不迁入」(LLM 上游代理与配额计费属流量层,
               与本服务「身份层」的定位分界不变,半成品已从 workspace 移除);
               回归口径五套 → 六套;测试配置端口范围 18093-18099
  README.md    结构树补 plugin-domain,端口范围同步
  roadmap.md   P2 标记为已完成(部分)并写明 plugin-llm 不迁入的理由
2026-09-13 10:25:48 +08:00
ssw 8be8580ba9 feat: 管理台账号列表支持就地编辑与批量维护
账号列表新增筛选 + 批量操作条:勾选多个账号后一次性改部门/用户组,表格里
部门与用户组可就地编辑。批量提交只作用于「勾选里仍在当前筛选结果内」的账号,
避免筛选外被误改。

随附界面截图 docs/screenshots/admin-users-batch-ui.png。
2026-09-13 10:25:42 +08:00
ssw 9e3f828e17 test: 回归扩为六套,新增域名插件 / RS256-JWKS / 账号批量维护用例
新增
  tests/domain-e2e.sh           域名插件:申请 → pending → 审核放行 → 转发生效,
                                含自动子域名形状、Host 带端口、未知子域 404(且
                                该 404 由插件发出而非转发层兜底)、参数与保留名校验、
                                占用冲突、越权拒删、重复审核、驳回、删除即失效、purge
  tests/rs256-jwks-e2e.sh       RS256 签名与 JWKS 端点
  tests/admin-users-batch-e2e.sh 管理台账号批量维护

run-local-e2e.sh 注册为 [1/6]..[6/6],汇总行补出各套 rc。

用例约定:口令/密钥不进脚本(脚本开头 source load-env.sh,账号态 API Key 运行时
从 $DATA_DIR/users.json 读);用例开头先清理上一轮残留,否则「初始状态」类断言
在第二次跑时会假失败。
2026-09-13 10:25:26 +08:00
ssw 9ac47f7942 feat: 凭据改 .env 注入 + 本地联调脚本 + nginx 域名转发配置
凭据管理
  新增 .env.example(**进版本库**,只放本机/CI 演示默认值)与 scripts/load-env.sh
  (统一读取项目根 .env,已存在的环境变量优先)。三套既有 e2e 改为从 .env 取
  口令与签名密钥,命令行不再出现任何密钥 —— 既避免误入库,也避开终端历史泄露。

本地联调
  scripts/local-serve.sh start|stop|restart:按 .env 起停 nginx 与 demo 系统,
  替代手工拼路径。

nginx 配置
  nginx.test.conf 新增 18093(转发回显后端)+ 18094(sso_domain on +
  proxy_pass http://$proxy_backend_addr),并补 error_page 500 502 503 =
  @no_backend 兜底。
  nginx.conf(生产模板)新增企业域名转发 server:
  server_name ~^(?<subdomain>.+dm)\.mayishangshu\.cn$,443 与 80 跳转各一个。

  为什么不给空上游用 `if ($proxy_backend_addr = "")` 兜底:`if` 在 **rewrite**
  阶段求值,而变量是 **access** 阶段才写入的 —— 合法子域名会被一起误判成
  未解析。改用 error_page + 固定 body 标记(NO_BACKEND),顺带把「转发层兜底」
  与「插件自己发的 404」区分开,e2e 断言才有意义。
2026-09-13 10:25:19 +08:00
ssw a988cc3763 refactor: 网关拆分为 ipass-core 内核 + plugin-sso/plugin-domain 插件 + gateway
原 source/rust/src/ 单体 crate 拆为 Cargo workspace:

  crates/ipass-core/    内核:state(共享内存) / store(JSON 原子写) /
                        users(账号唯一写入口) / models(共性字段 + extra 透传) /
                        config(共性常量) / plugin(装配契约) / loc(开关) /
                        session / audit / http / util
  crates/plugin-sso/    身份插件:OAuth2 / OIDC / IAP / TOTP / RSA 等个性代码
  crates/plugin-domain/ 域名插件:企业域名「子域名 → 后端」转发 + 申请/审核
  gateway/              **唯一** cdylib,module 壳 + PLUGINS 装配数组

收窄原则:内核只留共性,个性代码下放插件。收窄后内核不再提供原单体的
bump_window / put_ukey / put_upstream / reload_shm 等,改由插件用 state 泛型
原语自行重建;OAuth 常量与前缀(如 OAUTH_SESSION_COOKIE=sso_sid、
IAP_TOKEN_AUDIENCE=sso-gateway)与历史取值严格一致。

插件一律 crate-type=["rlib"] 由 gateway 静态链入,产出单个
libsso_gateway.dylib —— 不各自出 .so(nginx 动态模块无稳定 ABI,
跨 .so 传 String 即双重 free)。

插件装配点集中在 gateway 5 处:use / PLUGINS 数组 / ModuleConfig 字段 /
Merge / loc_switch 分支,外加指令数组(长度 +1,新增 sso_domain 等开关)。
2026-09-13 10:23:34 +08:00
ssw 8079982ba8 chore: 放行 .workbuddy/skills/ 并新增项目级技能 ipass-core-add-plugin
.workbuddy/ 原为整体忽略(本地记忆与临时产物),但项目级技能需要随仓库
共享给团队,故改为忽略其全部内容、仅放行 .workbuddy/skills/。

注意写法:不能用 `.workbuddy/` + `!.workbuddy/skills/` —— 父目录被整体
排除后 git 不会再向下遍历,否定规则不生效;必须写 `.workbuddy/*`。

新增技能 ipass-core-add-plugin:在「内核 + 编译期插件」式 nginx Rust 工作区
(ipass-core / plugin-* / gateway 单 cdylib)里新增或从 refs/ 移植一个能力插件
的完整流程 —— 量内核边界、crate 骨架、文件分工、gateway 5 处装配、配置、
e2e 注册,附「症状 → 根因」排错表。
2026-09-13 10:23:25 +08:00
ssw 3a908071ff docs: 修正 demo-system README 中残留的旧脚本路径 2026-09-12 21:53:35 +08:00
ssw 212f69c098 chore: 统一脚本可执行位(scripts/*.sh 与三套 e2e、demo 应用) 2026-09-12 21:50:54 +08:00
ssw c8a02b8c49 feat: 从网关项目剥离为独立 SSO 统一认证服务
定位:身份层(IdP + IAP),不含动态域名转发 / LLM 上游代理 / 用量计费。

代码(source/rust,nginx 动态模块 + Rust,单进程零外部依赖)
- IdP:authorization_code(含 PKCE)/ refresh_token / client_credentials / password
  四种 grant,含 discovery / introspect / userinfo / jwks 占位
- IAP:access 阶段门禁,注入 X-Auth-* 到后端,客户端伪造同名头被覆盖
- MaxKey 互通:/oauth/v20/* 与 /oauth2.0/* 别名 + context-path 归一化 + 扁平字段
- 管理接口:账号(含角色/部门/用户组)与 OAuth 接入方注册表,热写穿共享内存
- 模块改名 ngx_http_sso_module,指令 sso_state / sso_data_dir / sso_api / sso_iap,
  Cookie sso_sid(终端用户)与 sso_admin_session(管理员)两套身份两套会话

配置(source/conf)
- nginx.conf 生产模板(TLS、IAP 子域、含 auth_sub 的日志格式)
- nginx.test.conf 本机验证配置(明文 18095-18099)
- tls/README.md 证书约定与公钥比对校验

前端(source/www/admin.html)
- 三 tab:账号管理 / 接入方 / 接入指南;去掉审核队列、域名、LLM 上游、用量统计

测试与脚本
- tests/ 三套端到端:协议基线 14 项 · MaxKey 互通与接入 24 项 · 管理接口 31 项,全绿
- tests/demo-system 演示业务系统(Python 标准库),覆盖应用自建客户端与 IAP 零改造两种姿势
- scripts/run-local-e2e.sh 本机一键起停;scripts/seed-data.sh 物化运行时数据目录

文档
- README.md 概览与快速开始;CLAUDE.md 硬约定与排障速查
- docs/design.md 完整设计;docs/roadmap.md 待执行任务(v2 RS256+JWKS、用户管理界面)
2026-09-12 21:42:06 +08:00