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
This commit is contained in:
admin committed 2026-09-21 15:44:55 +08:00
1 parent f9c2324c47
commit 1e2b117218
50 files changed
+138 -136

No files matched your search

+6 -3
View File
@@ -1,17 +1,20 @@
# ---------------------------------------------------------------------------
# 构建产物
# ---------------------------------------------------------------------------
/source/rust/target/
/rust/target/
**/*.dylib
**/*.so
**/*.o
**/*.a
# 本机 nginx 源码树(含编译好的二进制 + nginx/pcre 源码包,体积大、含本机路径,
# 不入库;仅作本地持久化,避免每次重下重编)
/build/
# ---------------------------------------------------------------------------
# 运行时数据(含真实口令散列与 API Key,禁止入库)
# 种子模板在 source/data-seed/,用 scripts/seed-data.sh 物化
# 种子模板在 data-seed/,用 scripts/seed-data.sh 物化
# ---------------------------------------------------------------------------
/source/data/
/data/
# ---------------------------------------------------------------------------
# 参考资料:来源项目与第三方实现,仅本地阅读,不入库
@@ -11,7 +11,7 @@ agent_created: true
用户要在这种工作区里新增/移植一个插件。典型形态(本文以 `ssw/sso` 为参照):
```text
source/rust/
rust/
├── crates/ipass-core/ 内核:state(共享内存) / store(JSON 原子写) / users(账号唯一写入口)
│ / models(共性字段 + extra 透传) / config(共性常量) / plugin(契约) / loc(开关)
├── crates/plugin-sso/ 身份插件
@@ -44,7 +44,7 @@ workspace 编不过(成员在 `members` 里但目录缺 `Cargo.toml`/`lib.rs`
不要凭 refs 的旧代码猜,逐条 grep 确认:
```bash
cd source/rust
cd rust
# 内核到底导出了什么
sed -n '1,200p' crates/ipass-core/src/lib.rs
# 逐个核实你要用的符号
@@ -65,7 +65,7 @@ grep -n "pub fn " crates/ipass-core/src/http.rs
### 2. 建 crate 骨架
```bash
mkdir -p source/rust/crates/plugin-<name>/src
mkdir -p rust/crates/plugin-<name>/src
```
`Cargo.toml`(照 `plugin-domain` 抄):
@@ -160,9 +160,9 @@ static mut NGX_HTTP_SSO_COMMANDS: [ngx_command_t; N+1] = [...];
### 5. 编译
```bash
cd source/rust
NGINX_SOURCE_DIR=/tmp/sso-build/src/nginx-1.30.4 \
NGINX_BUILD_DIR=/tmp/sso-build/src/nginx-1.30.4/objs \
cd rust
NGINX_SOURCE_DIR=./build/src/nginx-1.30.4 \
NGINX_BUILD_DIR=./build/src/nginx-1.30.4/objs \
CARGO_NET_OFFLINE=true cargo build --release
# 先单 crate 快速迭代(几十秒 vs 全量 ~1.5 分钟):
# ... cargo build -p plugin-<name>
@@ -177,10 +177,10 @@ CARGO_NET_OFFLINE=true cargo build --release
### 6. nginx 配置(测试 + 生产)
- `source/conf/nginx.test.conf`:给新能力加 listen 端口 + `sso_<name> on;`。
- `conf/nginx.test.conf`:给新能力加 listen 端口 + `sso_<name> on;`。
本机没有 PCRE,**`server_name ~regex` 会被渲染脚本降级成 `server_name _`**,
所以判 Host 的逻辑要放在插件里(按后缀 `strip_suffix`),不要依赖 `server_name` 捕获。
- `source/conf/nginx.conf`:生产模板可用正则 `server_name ~^(?<sub>.+dm)\.zone$;`。
- `conf/nginx.conf`:生产模板可用正则 `server_name ~^(?<sub>.+dm)\.zone$;`。
- `proxy_pass http://$module_var;` 在变量为空时会报 500 `no host in upstream`。
**不要用 `if ($var = "")` 兜底** —— `if` 在 rewrite 阶段求值,而变量是 access 阶段才写的,
合法请求会被一起误判。用 `error_page 500 502 503 = @fallback;` + `location @fallback { return 404 "MARKER"; }`。
@@ -312,7 +312,7 @@ _ => {
**后端端点不是交付终点**。本仓 2026-09-14 的 P1/P2 首轮就只做了 API + e2e,管理台一行没动,
用户找不到入口。新增能力时**必须同步问一句「UI 在哪」**。
### 管理台(`source/www/admin.html`)
### 管理台(`www/admin.html`)
单文件、纯静态 + `fetch`,无构建步骤。页签机制是「按钮 `data-tab` + `<section id="tab-XXX" hidden>`」,
新增一个页签要**改三处**,漏一处就表现为「点了没反应」或「内容永远显示」:
@@ -329,7 +329,7 @@ _ => {
需要「提前返回」的分支(如两步式弹窗)直接 `return`,别让后面的 `req.then` 兜底逻辑再跑一遍。
- 端点表这类「给接入方抄地址」的内容,用 `location.origin` 在前端拼绝对地址即可,
**不必为展示再开后端接口**。
- harness 会把模板 conf 里的 `/usr/local/nginx/www/` 重写成仓库的 `source/www/`(见 `WWW_DIR`),
- harness 会把模板 conf 里的 `/usr/local/nginx/www/` 重写成仓库的 `www/`(见 `WWW_DIR`),
所以本地改完 `admin.html` 直接生效,不用拷贝。
### 终端用户页面(找回密码 / 重置口令这类)
+22 -22
View File
@@ -39,8 +39,8 @@
cargo 解析 git 依赖时会 `update_submodules` 去克隆几十 MB 的 nginx 仓库。国内网络下卡死 ——
**实测 5 分钟 0% CPU、无网络活动、无产物**,`sample` 抓栈停在
`GitCheckout::update_submodules → fetch → wait4`。
3. **正解**:内核与 `ngx-rust` 放在 `deps/ipass` git 子模块(指向 `ipass/ipass`),`source/rust` 通过
`path` 依赖引用它;sso 自己的 `Cargo.toml` 用 `exclude = ["../../deps/ipass", "target"]` 处理嵌套
3. **正解**:内核与 `ngx-rust` 放在 `deps/ipass` git 子模块(指向 `ipass/ipass`),`rust` 通过
`path` 依赖引用它;sso 自己的 `Cargo.toml` 用 `exclude = ["../deps/ipass", "target"]` 处理嵌套
workspace,避免重复编译(`[submodule] deps/ipass` 一节见 README「目录结构」)。
### 为什么要 `--with-pcre=<绝对路径>`,以及路径不能随便挪
@@ -56,17 +56,17 @@
### 本机构建
```bash
cd source/rust
cd rust
export LIBCLANG_PATH=/Library/Developer/CommandLineTools/usr/lib # macOS,bindgen 需要
export NGINX_SOURCE_DIR=/tmp/sso-build/src/nginx-1.30.4
export NGINX_BUILD_DIR=/tmp/sso-build/src/nginx-1.30.4/objs
export NGINX_SOURCE_DIR=./build/src/nginx-1.30.4
export NGINX_BUILD_DIR=./build/src/nginx-1.30.4/objs
cargo build --release
# 产物:source/rust/target/release/libsso_gateway.{dylib,so}
# 产物:rust/target/release/libsso_gateway.{dylib,so}
```
冷编译约 40 秒,增量 1~2 秒。
> `source/rust/gateway/build.rs` **不可删**:macOS 必须 `-undefined dynamic_lookup`——动态模块引用的
> `rust/gateway/build.rs` **不可删**:macOS 必须 `-undefined dynamic_lookup`——动态模块引用的
> nginx 运行时符号由主程序在 `load_module` 时提供,链接时必然未定义。
> `ngx` crate 的 build.rs 也设了,但 `rustc-link-arg` **只对设置它的 crate 生效**、不传给依赖方。
@@ -81,7 +81,7 @@ bash scripts/run-local-e2e.sh --keep # 保留进程手工排查
## 目录地图(改代码前先看这里)
`source/rust/` 是 Cargo workspace(`cargo build` 在**根**跑,产物 `target/release/libsso_gateway.dylib`):
`rust/` 是 Cargo workspace(`cargo build` 在**根**跑,产物 `target/release/libsso_gateway.dylib`):
| 路径 | 职责 |
| --- | --- |
@@ -98,12 +98,12 @@ bash scripts/run-local-e2e.sh --keep # 保留进程手工排查
| 路径 | 职责 |
| --- | --- |
| `source/conf/nginx.conf` | 生产模板:IdP + 管理台 443、IAP 子域、80→443、含 `auth_sub` 的日志格式 |
| `source/conf/nginx.test.conf` | 本机/CI 验证配置(明文 18093-18099:18093/18094 为域名转发回显与转发口),`scripts/run-local-e2e.sh` 会渲染它 |
| `source/conf/tls/README.md` | 证书约定、acme.sh 签发、公钥比对校验(**ECC 不能用 `openssl rsa -modulus`**) |
| `source/www/admin.html` | 管理台单页(**五个 tab**:账号管理 / OAuth 应用 / 身份同步 / 会话·审计 / 接入指南),纯静态 + fetch;harness 会把模板里的 `/usr/local/nginx/www/` 重写到 `source/www/` |
| `source/data-seed/` | 种子模板(进版本库):`oauth_clients.json` + `users.json.example` |
| `source/data/` | 运行时数据(**不进版本库**,含真实口令散列与 API Key) |
| `conf/nginx.conf` | 生产模板:IdP + 管理台 443、IAP 子域、80→443、含 `auth_sub` 的日志格式 |
| `conf/nginx.test.conf` | 本机/CI 验证配置(明文 18093-18099:18093/18094 为域名转发回显与转发口),`scripts/run-local-e2e.sh` 会渲染它 |
| `conf/tls/README.md` | 证书约定、acme.sh 签发、公钥比对校验(**ECC 不能用 `openssl rsa -modulus`**) |
| `www/admin.html` | 管理台单页(**五个 tab**:账号管理 / OAuth 应用 / 身份同步 / 会话·审计 / 接入指南),纯静态 + fetch;harness 会把模板里的 `/usr/local/nginx/www/` 重写到 `www/` |
| `data-seed/` | 种子模板(进版本库):`oauth_clients.json` + `users.json.example` |
| `data/` | 运行时数据(**不进版本库**,含真实口令散列与 API Key) |
| `scripts/seed-data.sh` | 物化数据目录:`data-seed/` → `data/`,并生成 admin/alice 真实散列 |
| `tests/demo-system/` | 演示用「简单业务系统」(Python 标准库),验证两种接入姿势 |
| `refs/` | **不入版本库**:`refs/ipass`(来源项目)、`refs/MaxKey`(协议对齐参考) |
@@ -188,7 +188,7 @@ bash scripts/run-local-e2e.sh --keep # 保留进程手工排查
当前管理 server 设 1m。
- **JSON 空数组必须序列化成 `[]`**。`serde_json` 对空 `Vec` 本来就输出 `[]`,
但**别用 `json!({})` 顶替列表字段**——前端直接 `.map/.filter`,拿到 `{}` 会报错。
- **改 `source/rust/` 或 `source/conf/` 后必须重启 nginx**。动态模块在 `load_module` 时载入,
- **改 `rust/` 或 `conf/` 后必须重启 nginx**。动态模块在 `load_module` 时载入,
**reload 不会重新加载 `.so`**;`data/` 是写穿语义,重启后从文件重建。
- **`location @name` 不能写成 `location = @name`**。带 `=` 时 nginx 会把它注册成
「精确匹配普通 location」而 `clcf->named` 仍为 0,于是 `error_page 401 = @oauth_login`
@@ -200,7 +200,7 @@ bash scripts/run-local-e2e.sh --keep # 保留进程手工排查
**文档与仓库卫生**
- 不要在文档里写真实口令、API Key 或内网拓扑明细。
- **不要把 `source/data/`(含口令散列与全部 Key)提交进版本库**;`refs/`、`.workbuddy/`、
- **不要把 `data/`(含口令散列与全部 Key)提交进版本库**;`refs/`、`.workbuddy/`、
`target/` 已忽略。
- 改行为后同步更新 `docs/design.md` 对应小节;**待办项写进 `docs/roadmap.md`**,别散在代码注释里。
@@ -214,7 +214,7 @@ bash scripts/run-local-e2e.sh --keep # 保留进程手工排查
| **worker 进程静默消失 / 全站 502** | worker 里 panic 了(`panic = "abort"`)。看 error.log 的 panic 栈,多半是热路径 `unwrap()` |
| 编译报 `unresolved imports ngx::http::HttpPhase` | 又用 crates.io 的 `ngx` 0.5.1 了。必须用 `deps/ipass/rust/vendor/ngx-rust` |
| `cargo build` 卡住数分钟 0% CPU | 又把 `ngx` 改回 git 依赖了 —— 它挂的 submodule 会去克隆完整 nginx 仓库 |
| 链接报 `ld: symbol(s) not found` | `source/rust/build.rs` 的 `-undefined dynamic_lookup` 被删了(macOS 必需) |
| 链接报 `ld: symbol(s) not found` | `rust/build.rs` 的 `-undefined dynamic_lookup` 被删了(macOS 必需) |
| nginx 启动即报 `unknown "auth_user" variable` | 变量注册漏了 `add_variable` 那一步(见「核心机制」第 4 条) |
| `proxy_set_header X-Auth-User $auth_user;` 注入成了空 | 变量被标了 `NGX_HTTP_VAR_NOCACHEABLE`,或注册时机不在 preconfiguration |
| 授权码换发报 `invalid_client` | 接入方注册表没热加载(写操作漏 `sync_shm`),或回调地址逐字符不一致 |
@@ -241,7 +241,7 @@ bash scripts/run-local-e2e.sh --keep # 保留进程手工排查
# ---- 本机 ----
bash scripts/run-local-e2e.sh # 七套 e2e 全跑
bash scripts/run-local-e2e.sh --keep # 保留进程手工排查
bash scripts/seed-data.sh # 物化 source/data/
bash scripts/seed-data.sh # 物化 data/
bash scripts/seed-data.sh --force # 重建 users.json(丢已有账号)
# 手工打几个关键接口(网关在跑时)
@@ -271,13 +271,13 @@ curl -s -b "$JAR" -X POST http://127.0.0.1:18098/api/admin/sync/dingtalk
- **不要**引入数据库、Redis、消息队列或额外常驻进程 —— 本项目的价值就是单进程、零依赖。
- **LLM 上游代理与用量计费不搬回来**:那是流量层与计费层的职责,与本服务“身份层”的定位分界不变。
(动态域名转发已作为 `plugin-domain` **示例插件**迁入 `deps/ipass` 子模块:它侧重“如何在内核之上新增一个能力插件”,而非做量。)
- **不要**在 `source/data/` 里手工改文件后期待热生效 —— **共享内存才是运行期真源**,改文件需重启。
- **不要**把 `source/data/` 提交进版本库,也不要在 `refs/` 里提交参考项目。
- **不要**在 `data/` 里手工改文件后期待热生效 —— **共享内存才是运行期真源**,改文件需重启。
- **不要**把 `data/` 提交进版本库,也不要在 `refs/` 里提交参考项目。
- **不要**重写整个 `nginx.conf` —— 它很短,**逐点修改**。
- **不要**在未确认需求前动 `source/data/users.json`,那会直接影响登录。
- **不要**在未确认需求前动 `data/users.json`,那会直接影响登录。
- **不要**为了「顺手」把 HS256 换成 RS256(或反之):签名算法是给第三方的契约,
切换要走 `docs/roadmap.md` 里的 v2 计划(新旧并行 + `kid` 轮换)。
- 测试不要复用生产 data 目录:用 `source/data/` + 非特权端口(18095-18099),不要占用 80/443。
- 测试不要复用生产 data 目录:用 `data/` + 非特权端口(18095-18099),不要占用 80/443。
---
+23 -24
View File
@@ -41,14 +41,14 @@
```bash
# ① 准备 nginx 源码树(只需 configure,一次即可)
mkdir -p /tmp/sso-build/src && cd /tmp/sso-build/src
mkdir -p ./build/src && cd ./build/src
curl -fsSL https://nginx.org/download/nginx-1.30.4.tar.gz -o nginx.tar.gz && tar xzf nginx.tar.gz
curl -fsSL https://github.com/PCRE2Project/pcre2/releases/download/pcre2-10.44/pcre2-10.44.tar.gz -o pcre2.tar.gz && tar xzf pcre2.tar.gz
# ② 编译 nginx(必须含 rewrite 模块:`return` / `error_page` 内部跳转都靠它)
cd nginx-1.30.4
./configure --prefix=/tmp/sso-build/nginx \
--with-pcre=/tmp/sso-build/src/pcre2-10.44 --with-http_realip_module \
./configure --prefix=./build/nginx \
--with-pcre=./build/src/pcre2-10.44 --with-http_realip_module \
--without-http_gzip_module --without-http_ssi_module --without-http_userid_module \
--without-http_autoindex_module --without-http_geo_module \
--without-http_split_clients_module --without-http_referer_module \
@@ -59,11 +59,11 @@ cd nginx-1.30.4
git submodule update --init deps/ipass
# ④ 编译 Rust 模块
cd <本仓库>/source/rust
cd <本仓库>/rust
export LIBCLANG_PATH=/Library/Developer/CommandLineTools/usr/lib # macOS
export NGINX_SOURCE_DIR=/tmp/sso-build/src/nginx-1.30.4
export NGINX_BUILD_DIR=/tmp/sso-build/src/nginx-1.30.4/objs
cargo build --release # 产物 source/rust/target/release/libsso_gateway.dylib
export NGINX_SOURCE_DIR=./build/src/nginx-1.30.4
export NGINX_BUILD_DIR=./build/src/nginx-1.30.4/objs
cargo build --release # 产物 rust/target/release/libsso_gateway.dylib
# ⑤ 一键跑 SSO 端到端(自动播种数据、起 nginx + demo 系统、跑完自动清理)
cd <本仓库> && bash scripts/run-local-e2e.sh
@@ -93,18 +93,17 @@ sso/
│ ├── design.md 设计文档:端点、token 模型、共享内存、MaxKey 互通、构建与测试
│ ├── roadmap.md 路线图(v1–v4 已完成 + 待办)
│ └── screenshots/ 管理台与登录页截图
├── source/ 可部署产物(代码 + 配置 + 静态页)
│ ├── rust/ 动态模块源码(本仓库的 Cargo workspace)
│ │ ├── Cargo.toml members=[crates/plugin-sso, gateway];ipass-core/ngx-rust 走 deps/ipass 的 path 依赖
│ │ ├── crates/plugin-sso/ 身份插件:OAuth2 / OIDC + IAP(本仓库唯一业务 crate)
│ │ └── gateway/ 装配层:module 壳 + 插件注册表 → libsso_gateway.so
│ ├── conf/
│ │ ├── nginx.conf 生产模板(TLS、IAP 子域、日志字段)
│ │ ├── nginx.test.conf 本机/CI 验证配置(明文端口 18093-18099)
│ │ └── tls/README.md 证书约定、acme.sh 签发与校验
│ ├── www/admin.html 管理台单页(纯静态 + fetch;五个页签)
│ ├── data-seed/ 种子模板(进版本库)
│ └── data/ 运行时数据(**不进版本库**,由 scripts/seed-data.sh 生成)
├── rust/ 动态模块源码(本仓库的 Cargo workspace)
│ ├── Cargo.toml members=[crates/plugin-sso, gateway];ipass-core/ngx-rust 走 deps/ipass 的 path 依赖
│ ├── crates/plugin-sso/ 身份插件:OAuth2 / OIDC + IAP(本仓库唯一业务 crate)
│ └── gateway/ 装配层:module 壳 + 插件注册表 → libsso_gateway.so
├── conf/
│ ├── nginx.conf 生产模板(TLS、IAP 子域、日志字段)
│ ├── nginx.test.conf 本机/CI 验证配置(明文端口 18093-18099)
│ └── tls/README.md 证书约定、acme.sh 签发与校验
├── www/admin.html 管理台单页(纯静态 + fetch;五个页签)
├── data-seed/ 种子模板(进版本库)
├── data/ 运行时数据(**不进版本库**,由 scripts/seed-data.sh 生成)
├── tests/ 测试程序与测试应用(SSO 相关 e2e;域名/LLM 相关见 deps/ipass)
│ ├── oauth2-e2e.sh 协议基线(discovery/grant/token/IAP 注入)
│ ├── oauth2-maxkey-e2e.sh MaxKey 互通 + demo 系统接入
@@ -215,17 +214,17 @@ location @oauth_login { # 注意:named location 不
```bash
# 1. 模块装到 nginx
install -m 755 source/rust/target/release/libsso_gateway.so /usr/local/nginx/modules/
install -m 755 rust/target/release/libsso_gateway.so /usr/local/nginx/modules/
# 2. 配置(按环境改域名与证书路径)
cp source/conf/nginx.conf /usr/local/nginx/conf/nginx.conf
cp -r source/www /usr/local/nginx/www
cp -r source/data-seed /usr/local/nginx/data-seed
cp conf/nginx.conf /usr/local/nginx/conf/nginx.conf
cp -r www /usr/local/nginx/www
cp -r data-seed /usr/local/nginx/data-seed
# 3. 播种账号(生产务必覆盖默认口令)
DATA_DIR=/usr/local/nginx/data ADMIN_PASSWORD='<强口令>' bash scripts/seed-data.sh
# 4. 证书:见 source/conf/tls/README.md(acme.sh 签发 + 公钥比对校验)
# 4. 证书:见 conf/tls/README.md(acme.sh 签发 + 公钥比对校验)
# 5. 启动/重载
/usr/local/nginx/sbin/nginx -t && /usr/local/nginx/sbin/nginx
+1 -1
View File
@@ -20,7 +20,7 @@ error_log /usr/local/nginx/logs/error.log info;
pid /usr/local/nginx/logs/nginx.pid;
# nginx 会剥掉所有环境变量,机制类配置必须显式白名单。
# 未设置时不报错,模块按各自缺省值兜底(见 source/rust/src/config.rs)。
# 未设置时不报错,模块按各自缺省值兜底(见 rust/src/config.rs)。
env ADMIN_INIT_PASSWORD; # 播种管理员口令,仅首次启动用
env OAUTH_SIGNING_SECRET; # HS256 对称密钥;不设则每次重启令牌全失效
env OAUTH_ISSUER; # 令牌 iss 与 discovery 的 issuer,必须等于对外访问地址
@@ -27,7 +27,7 @@ error_log /usr/local/nginx/logs/error.log info;
pid /usr/local/nginx/logs/nginx.pid;
# nginx 默认会剥掉所有环境变量,机制类配置必须显式白名单。
# 未设置时不报错,模块按各自缺省值兜底(见 source/rust/src/config.rs)。
# 未设置时不报错,模块按各自缺省值兜底(见 rust/src/config.rs)。
env ADMIN_INIT_PASSWORD;
env OAUTH_SIGNING_SECRET;
env OAUTH_ISSUER;
File renamed without changes.
File renamed without changes.
File renamed without changes.
+29 -29
View File
@@ -85,7 +85,7 @@
---
## 5. 客户端模型(`source/data/oauth_clients.json`)
## 5. 客户端模型(`data/oauth_clients.json`)
顶层是 `OAuthClient` 数组(与 `users.json` / `domains.json` 同构:文件是唯一真源,启动时全量装载进共享内存 `ocl:` 前缀,热路径只读内存)。
@@ -134,7 +134,7 @@
---
## 6. 用户模型(`source/data/users.json` 新增身份字段)
## 6. 用户模型(`data/users.json` 新增身份字段)
在既有用户结构基础上,`User` 新增三个 `#[serde(default)]` 字段,支撑 token 声明与 IAP 注入:
@@ -297,23 +297,23 @@ server {
| 文件 | 改动 |
| --- | --- |
| `source/rust/src/oauth.rs` | **新增**:OAuth2 AS 全部逻辑(client/code/token 模型、HS256 JWT 签名/验签、PKCE、端点 handler、IAP 身份解析) |
| `source/rust/src/oauth_clients.rs` | **新增**:客户端注册表模块(`reload_shm` / `get` / `all` / `upsert` / `delete` / `view`) |
| `source/rust/src/api.rs` | `route()` 增加 `/oauth/authorize`、`/oauth/token`、`/oauth/userinfo`、`/oauth/introspect`、`.well-known`、`/oauth/jwks`、`/login`、`/oauth/logout`,转发到 `oauth::*` |
| `source/rust/src/lib.rs` | 新增 `sso_iap` 指令 + `IapHandler`(access 阶段门禁 + 写 `$auth_*` 变量);`AUTH_VAR_INDEX[5]` + `AUTH_VAR_NAMES`;`register_auth_vars()`(`add_variable` 挂 `auth_var_get` + `get_variable_index`)在 preconfiguration 注册;`state_zone_init` 调 `oauth_clients::reload_shm()` |
| `source/rust/src/config.rs` | 新增 OAuth 常量区(`KEY_OAUTH_*` 前缀、TTL、cookie、env 名、scopes、challenge 方法) |
| `source/rust/src/models.rs` | `User` 增 `email`/`department`/`groups` + `oauth_claims()`;新增 `OAuthClient` + `OAuthClientTable`(`allows_scope/allows_redirect/allows_grant`) |
| `source/rust/src/state.rs` | 新增 `oauth_session` / `oauth_code` / `oauth_client` 共享内存封装;`split_value` 改用 `rposition` |
| `source/rust/src/store.rs` | 新增 `oauth_clients_path` / `read/write/update_oauth_clients` |
| `source/rust/src/util.rs` | 新增 `url_encode`/`html_escape`;`HEX` 常量提升为模块级 |
| `rust/src/oauth.rs` | **新增**:OAuth2 AS 全部逻辑(client/code/token 模型、HS256 JWT 签名/验签、PKCE、端点 handler、IAP 身份解析) |
| `rust/src/oauth_clients.rs` | **新增**:客户端注册表模块(`reload_shm` / `get` / `all` / `upsert` / `delete` / `view`) |
| `rust/src/api.rs` | `route()` 增加 `/oauth/authorize`、`/oauth/token`、`/oauth/userinfo`、`/oauth/introspect`、`.well-known`、`/oauth/jwks`、`/login`、`/oauth/logout`,转发到 `oauth::*` |
| `rust/src/lib.rs` | 新增 `sso_iap` 指令 + `IapHandler`(access 阶段门禁 + 写 `$auth_*` 变量);`AUTH_VAR_INDEX[5]` + `AUTH_VAR_NAMES`;`register_auth_vars()`(`add_variable` 挂 `auth_var_get` + `get_variable_index`)在 preconfiguration 注册;`state_zone_init` 调 `oauth_clients::reload_shm()` |
| `rust/src/config.rs` | 新增 OAuth 常量区(`KEY_OAUTH_*` 前缀、TTL、cookie、env 名、scopes、challenge 方法) |
| `rust/src/models.rs` | `User` 增 `email`/`department`/`groups` + `oauth_claims()`;新增 `OAuthClient` + `OAuthClientTable`(`allows_scope/allows_redirect/allows_grant`) |
| `rust/src/state.rs` | 新增 `oauth_session` / `oauth_code` / `oauth_client` 共享内存封装;`split_value` 改用 `rposition` |
| `rust/src/store.rs` | 新增 `oauth_clients_path` / `read/write/update_oauth_clients` |
| `rust/src/util.rs` | 新增 `url_encode`/`html_escape`;`HEX` 常量提升为模块级 |
| `conf/nginx.conf` | 新增 IdP server(18098)+ IAP 代理 server(18099) |
| `source/conf/nginx.test.conf` | **新增**:本地最小验证配置(IdP 18098 + IAP 18099 + 回显后端 18097) |
| `conf/nginx.test.conf` | **新增**:本地最小验证配置(IdP 18098 + IAP 18099 + 回显后端 18097) |
| `tests/oauth2-e2e.sh` | **新增**:14 项端到端断言(客户端密钥运行时从种子读取,不硬编码) |
| `scripts/run-local-e2e.sh` | **新增**:macOS 本机 nginx + 模块一键起停并跑 e2e |
| `source/data/users.json` | 种子用户补充 `email`/`department`/`groups`(数组) |
| `source/data/oauth_clients.json`(及 `source/data-seed/`) | 新增 OAuth 客户端注册表(grafana / spa-demo / machine) |
| `data/users.json` | 种子用户补充 `email`/`department`/`groups`(数组) |
| `data/oauth_clients.json`(及 `data-seed/`) | 新增 OAuth 客户端注册表(grafana / spa-demo / machine) |
| `deps/ipass/rust/vendor/ngx-rust/nginx-sys/build/` | **补回**:`main.rs` + `wrapper.h`(官方 0.5.0 crate 的 bindgen 构建脚本,原被子模块内 `.gitignore` 的 `build/` 规则吞掉) |
| `.gitignore` | 子模块内加 `!rust/vendor/ngx-rust/nginx-sys/build/` 例外,本仓库放行 `source/data/oauth_clients.json` |
| `.gitignore` | 子模块内加 `!rust/vendor/ngx-rust/nginx-sys/build/` 例外,本仓库放行 `data/oauth_clients.json` |
---
@@ -332,21 +332,21 @@ curl -fsSL https://nginx.org/download/nginx-1.30.4.tar.gz -o nginx.tar.gz && tar
curl -fsSL https://github.com/PCRE2Project/pcre2/releases/download/pcre2-10.44/pcre2-10.44.tar.gz -o pcre2.tar.gz && tar xzf pcre2.tar.gz
# ② 编 nginx(须含 rewrite 模块,`return` 指令来自它)
cd nginx-1.30.4 && ./configure --prefix=/tmp/sso-build/nginx \
--with-pcre=/tmp/sso-build/src/pcre2-10.44 --with-http_realip_module \
cd nginx-1.30.4 && ./configure --prefix=./build/nginx \
--with-pcre=./build/src/pcre2-10.44 --with-http_realip_module \
--without-http_gzip_module --without-http_ssi_module --without-http_userid_module \
--without-http_autoindex_module --without-http_geo_module \
--without-http_split_clients_module --without-http_referer_module \
--without-http_uwsgi_module --without-http_scgi_module --without-http_grpc_module \
&& make -j"$(sysctl -n hw.ncpu)"
# 建 prefix 临时目录(没跑 make install 时 nginx 起不来)
mkdir -p /tmp/sso-build/nginx/{client_body_temp,proxy_temp,fastcgi_temp,uwsgi_temp,scgi_temp,logs,conf}
mkdir -p ./build/nginx/{client_body_temp,proxy_temp,fastcgi_temp,uwsgi_temp,scgi_temp,logs,conf}
# ③ 编 Rust 模块(输出 source/rust/target/release/libsso_gateway.dylib)
cd source/rust
# ③ 编 Rust 模块(输出 rust/target/release/libsso_gateway.dylib)
cd rust
export LIBCLANG_PATH=/Library/Developer/CommandLineTools/usr/lib
export NGINX_SOURCE_DIR=/tmp/sso-build/src/nginx-1.30.4
export NGINX_BUILD_DIR=/tmp/sso-build/src/nginx-1.30.4/objs
export NGINX_SOURCE_DIR=./build/src/nginx-1.30.4
export NGINX_BUILD_DIR=./build/src/nginx-1.30.4/objs
cargo build --release
```
@@ -368,7 +368,7 @@ bash tests/oauth2-maxkey-e2e.sh http://127.0.0.1:18098 http://127.0.0.1:180
bash tests/admin-oauth-clients-e2e.sh http://127.0.0.1:18098
```
脚本自动完成:`scripts/seed-data.sh` 物化 `source/data/`(生成 admin/alice 口令散列)、
脚本自动完成:`scripts/seed-data.sh` 物化 `data/`(生成 admin/alice 口令散列)、
生成 macOS 本机配置(替换 `load_module` / `mime.types` / `ipass_data_dir` / `pid` /
`error_log`,注释掉 TLS include,regex `server_name` 降级为 `_`)、注入
`OAUTH_SIGNING_SECRET` + `OAUTH_ISSUER`(可选 `OAUTH_COOKIE_DOMAIN`)、
@@ -416,7 +416,7 @@ bash scripts/run-local-e2e.sh # 起服务 + 三套 e2e + 关服务
bash scripts/run-local-e2e.sh --keep # 保留进程手工排查
```
生产部署见 `source/conf/nginx.conf` + `source/conf/tls/README.md`。
生产部署见 `conf/nginx.conf` + `conf/tls/README.md`。
---
@@ -537,10 +537,10 @@ location / { ipass_api on; }
| 文件 | 改动 |
| --- | --- |
| `source/rust/src/api.rs` | 别名路由表 + `MAXKEY_CONTEXT_PREFIXES` / `strip_maxkey_ctx`,`dispatch` 在 miss 后归一化重试 |
| `source/rust/src/oauth.rs` | `access_token_of`(Bearer → `access_token` 参数回退);`userinfo_v20`(MaxKey 扁平字段);`token_v20` + `send_token_body(bare)`;`mint_access_token` 声明语义修正 |
| `conf/nginx.conf`、`source/conf/nginx.test.conf` | IdP server 整站 `location / { ipass_api on; }` |
| `source/data/oauth_clients.json`、`source/data-seed/` | 新增 `demo-system`(机密)、`demo-spa`(公开 + PKCE) |
| `rust/src/api.rs` | 别名路由表 + `MAXKEY_CONTEXT_PREFIXES` / `strip_maxkey_ctx`,`dispatch` 在 miss 后归一化重试 |
| `rust/src/oauth.rs` | `access_token_of`(Bearer → `access_token` 参数回退);`userinfo_v20`(MaxKey 扁平字段);`token_v20` + `send_token_body(bare)`;`mint_access_token` 声明语义修正 |
| `conf/nginx.conf`、`conf/nginx.test.conf` | IdP server 整站 `location / { ipass_api on; }` |
| `data/oauth_clients.json`、`data-seed/` | 新增 `demo-system`(机密)、`demo-spa`(公开 + PKCE) |
---
@@ -670,7 +670,7 @@ DEMO_STYLE=standard DEMO_CLIENT_ID=demo-spa DEMO_PORT=18096 python3 examples/dem
列表类字段(`redirect_uris` / `grant_types` / `scopes`)**传字符串**即可:逗号、顿号、
分号、空格、换行都是分隔符——前端 textarea 一行一个回调地址的自然写法直接可用。
之所以不传 JSON 数组:`http::params` 解析 JSON body 时只收 String/Number/Bool,
数组会被跳过(见 `source/rust/src/http.rs`)。
数组会被跳过(见 `rust/src/http.rs`)。
### 17.3 校验规则(写死在 `oauth_clients::upsert`)
+1 -1
View File
@@ -149,7 +149,7 @@ MaxKey 的 44 张表里,对本项目最有参考价值的三组设计:
| 同步连接器 | `plugin-sso/src/sync.rs` | `POST /api/admin/sync/{dingtalk,workwechat,feishu}`(管理员,手动触发);标准库 TcpStream 拉取,归一化 `{users:[...]}` → upsert | §D(钉钉 mock) |
| 自助密码重置 | `plugin-sso/src/reset.rs` | `POST /api/public/forgot-password`、`/reset-password`;token 共享内存、单次有效、防账号枚举;发信可配置(日志 / `PASSWORD_RESET_TOKEN_SINK` 文件 / 生产 SMTP-webhook) | §C |
| ip2location | `plugin-sso/src/geo.rs` | 内嵌代表性 CN IPv4 CIDR 表 + 内网/保留段判定,零依赖粗判「内网/中国/海外」 | 审计日志 / 管理台「会话·审计」页 |
| **管理台界面** | `source/www/admin.html` | 新增「身份同步」(钉钉/企微/飞书手动触发 + 结果)、「会话 / 审计」(在线会话 + 踢下线 + 审计含归属地)两个页签;账号行加「双因子」;接入指南补 CAS / SCIM / LDAP 三段 | `tests/maxkey-p1p2-e2e.sh` §F |
| **管理台界面** | `www/admin.html` | 新增「身份同步」(钉钉/企微/飞书手动触发 + 结果)、「会话 / 审计」(在线会话 + 踢下线 + 审计含归属地)两个页签;账号行加「双因子」;接入指南补 CAS / SCIM / LDAP 三段 | `tests/maxkey-p1p2-e2e.sh` §F |
| **终端用户页面** | `plugin-sso/src/reset.rs`(`GET /forgot`、`GET /reset?token=`)+ `oauth.rs` 登录页入口 | 自助密码重置的可点开入口;`send_reset` 的重置链接改为指向页面 URL(原来指向 POST 端点,点开必然失败) | §F |
| **应用管理增强** | `oauth_state.rs` / `oauth_clients.rs` / `admin.html` | 接入方新增 **协议类型**(oauth2/cas)、**访问地址**、**描述**、**图标**、**可见范围**(角色/部门/用户组,三项全空=全员);管理台表单与列表同步(`#[serde(default)]` 向后兼容存量注册表) | §G |
| **CAS service 白名单** | `cas.rs` + `oauth_clients::allows_cas_service` | `service` 必须命中已登记回调地址(精确或忽略 query),否则 login → 403、serviceValidate → `INVALID_SERVICE`。**修复开放重定向 + 票据外泄**:原先任意 service 都会被 302 带票据 | §B |
+4 -4
View File
@@ -56,7 +56,7 @@ if (tag != shm_zone[i].tag) {
而两边现在传的都是**自己模块的 `ngx_module_t` 地址**:
```rust
// source/rust/src/lib.rs:451
// rust/src/lib.rs:451
ngx_shared_memory_add(cf, &raw mut name, size, (&raw mut ngx_http_sso_module).cast())
// refs/ipass/rust/src/lib.rs:824
ngx_shared_memory_add(cf, &raw mut name, size, (&raw mut ngx_http_ipass_module).cast())
@@ -100,7 +100,7 @@ unsafe { (*var).get_handler = Some(auth_var_get); } // 覆盖
> `deps/ipass` git 子模块(`ipass/ipass`)提供,不再内置。
```
source/rust/ # 本仓库的 Cargo workspace
rust/ # 本仓库的 Cargo workspace
├── Cargo.toml # members = [crates/plugin-sso, gateway];ipass-core/ngx-rust 走 deps/ipass 的 path 依赖
├── crates/
│ └── plugin-sso/ # 身份插件:OAuth2/OIDC + IAP 注入(本仓库唯一业务 crate)
@@ -188,8 +188,8 @@ pub trait Plugin {
| --- | --- |
| zone tag 不同 → EMERG 启动失败 | `src/core/ngx_cycle.c` → `ngx_shared_memory_add` |
| 同名 + CHANGEABLE → 返回已有变量而非新建 | `src/http/ngx_http_variables.c` → `ngx_http_add_variable` |
| sso 的 zone tag = `&ngx_http_sso_module` | `source/rust/src/lib.rs:451` |
| sso 的 zone tag = `&ngx_http_sso_module` | `rust/src/lib.rs:451` |
| ipass 的 zone tag = `&ngx_http_ipass_module` | `refs/ipass/rust/src/lib.rs:824` |
| 两边注册同名 `$auth_*` 且覆盖 get_handler | `source/rust/src/lib.rs:254-262`、`refs/ipass/rust/src/lib.rs:89` |
| 两边注册同名 `$auth_*` 且覆盖 get_handler | `rust/src/lib.rs:254-262`、`refs/ipass/rust/src/lib.rs:89` |
| 键前缀全景 | `refs/ipass/rust/src/config.rs:66-101` |
| 代码重复量(oauth 425 / users 525 / models 234 / state 150 行差异) | 两仓库同名文件 diff |
+2 -2
View File
@@ -8,7 +8,7 @@
## v1(已完成)
- [x] 从内部网关项目剥离出独立 SSO 服务(去掉动态域名转发 / LLM 上游代理 / 用量计费)
- [x] 目录重组:`docs/` `source/` `tests/` `scripts/`
- [x] 目录重组:`docs/` `rust/` `conf/` `www/` `data/` `data-seed/` `tests/` `scripts/`
- [x] 自包含 IdP:四种 grant + PKCE + discovery + introspect + userinfo
- [x] IAP 身份注入:`X-Auth-*` 五头,客户端伪造同名头被覆盖
- [x] MaxKey 端点别名与 context-path 归一化
@@ -209,7 +209,7 @@
- [x] **ip2location 登录 IP 归属地**(`geo.rs`):内嵌 CN CIDR 精简版,审计记录归属地
- [x] 新增第 7 套 e2e `tests/maxkey-p1p2-e2e.sh`(SCIM / CAS / 密码重置 / 同步 / LDAP 禁用回归,21 项);
**七套全绿 rc=0**
- [x] **管理台界面补齐**(`source/www/admin.html`):新增「身份同步」页签(钉钉/企微/飞书手动触发 + 结果表)、
- [x] **管理台界面补齐**(`www/admin.html`):新增「身份同步」页签(钉钉/企微/飞书手动触发 + 结果表)、
「会话 / 审计」页签(在线会话列表 + 踢下线、审计日志含 IP 归属地);账号行加「双因子」按钮;
接入指南补 CAS 1.0/2.0、SCIM 2.0、LDAP/AD 三段端点与配置说明。接入方/Session/审计均复用既有 API,后端零改动。
- [x] **自助密码重置的终端用户页面**:新增 `GET /forgot`(找回)与 `GET /reset?token=…`(设新口令)两个 HTML 页,
View File
File renamed without changes.
+4 -4
View File
@@ -17,7 +17,7 @@
# ⚠️ deps/ipass 是独立 workspace,必须 exclude,否则 cargo 报歧义。
[workspace]
members = ["crates/plugin-sso", "gateway"]
exclude = ["../../deps/ipass", "target"]
exclude = ["../deps/ipass", "target"]
[workspace.package]
version = "1.0.0"
@@ -42,9 +42,9 @@ publish = false
# 离线可编译、无子模块、版本锁定。
# ---------------------------------------------------------------------------
[workspace.dependencies]
ngx = { path = "../../deps/ipass/rust/vendor/ngx-rust" }
nginx-sys = { path = "../../deps/ipass/rust/vendor/ngx-rust/nginx-sys" }
ipass-core = { path = "../../deps/ipass/rust/crates/ipass-core" }
ngx = { path = "../deps/ipass/rust/vendor/ngx-rust" }
nginx-sys = { path = "../deps/ipass/rust/vendor/ngx-rust/nginx-sys" }
ipass-core = { path = "../deps/ipass/rust/crates/ipass-core" }
plugin-sso = { path = "crates/plugin-sso" }
# 业务层依赖:全部是纯 Rust 实现,不引入任何系统库或常驻依赖
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
+2 -2
View File
@@ -19,9 +19,9 @@ ROOT="$(cd "$HERE/.." && pwd)"
# shellcheck source=scripts/load-env.sh
. "$HERE/load-env.sh"
NGINX_SRC="${NGINX_SRC:-/tmp/sso-build/src/nginx-1.30.4}"
NGINX_SRC="${NGINX_SRC:-./build/src/nginx-1.30.4}"
NGINX_BIN="${NGINX_BIN:-$NGINX_SRC/objs/nginx}"
MODULE_DIR="$ROOT/source/rust/target/release"
MODULE_DIR="$ROOT/rust/target/release"
if [ -f "$MODULE_DIR/libsso_gateway.dylib" ]; then
MODULE="$MODULE_DIR/libsso_gateway.dylib"
else
+10 -10
View File
@@ -6,9 +6,9 @@
#
# 不依赖 Docker。动态模块必须对着「同一份 nginx 源码 + 相同 configure」的
# nginx 二进制编译加载,所以本脚本假定:
# - nginx 源码树:${NGINX_SRC}(默认 /tmp/sso-build/src/nginx-1.30.4)
# - nginx 源码树:${NGINX_SRC}(默认 ./build/src/nginx-1.30.4)
# - nginx 二进制:${NGINX_BIN}(默认 $NGINX_SRC/objs/nginx)
# - Rust 模块 :$ROOT/source/rust/target/release/libsso_gateway.{dylib,so}
# - Rust 模块 :$ROOT/rust/target/release/libsso_gateway.{dylib,so}
#
# 会一并拉起 demo-system(Python 标准库,:18096),用于验证:
# - MaxKey 端点别名 / context-path 归一化 (tests/oauth2-maxkey-e2e.sh)
@@ -32,23 +32,23 @@ ROOT="$(cd "$HERE/.." && pwd)"
# shellcheck source=scripts/load-env.sh
. "$HERE/load-env.sh"
NGINX_SRC="${NGINX_SRC:-/tmp/sso-build/src/nginx-1.30.4}"
NGINX_SRC="${NGINX_SRC:-./build/src/nginx-1.30.4}"
NGINX_BIN="${NGINX_BIN:-$NGINX_SRC/objs/nginx}"
MIME_TYPES="${MIME_TYPES:-$NGINX_SRC/conf/mime.types}"
PYTHON="${PYTHON:-python3}"
# macOS 上 cdylib 产物是 .dylib;Linux 是 .so。优先 .dylib,回退 .so。
MODULE_DIR="$ROOT/source/rust/target/release"
MODULE_DIR="$ROOT/rust/target/release"
if [ -f "$MODULE_DIR/libsso_gateway.dylib" ]; then
MODULE="$MODULE_DIR/libsso_gateway.dylib"
else
MODULE="$MODULE_DIR/libsso_gateway.so"
fi
CONF_SRC="$ROOT/source/conf/nginx.test.conf"
WWW_DIR="$ROOT/source/www"
CONF_SRC="$ROOT/conf/nginx.test.conf"
WWW_DIR="$ROOT/www"
DEMO_APP="$ROOT/tests/demo-system/app.py"
DATA_DIR="$ROOT/source/data"
DATA_DIR="$ROOT/data"
CONF_LOCAL="/tmp/sso-nginx-test.conf"
PID="/tmp/sso-nginx.pid"
@@ -79,14 +79,14 @@ mkdir -p "$NGINX_PREFIX"/{client_body_temp,proxy_temp,fastcgi_temp,uwsgi_temp,sc
}
[ -f "$MODULE" ] || {
echo "!! Rust 模块缺失:$MODULE" >&2
echo " cd $ROOT/source/rust && NGINX_SOURCE_DIR=$NGINX_SRC NGINX_BUILD_DIR=$NGINX_SRC/objs cargo build --release" >&2
echo " cd $ROOT/rust && NGINX_SOURCE_DIR=$NGINX_SRC NGINX_BUILD_DIR=$NGINX_SRC/objs cargo build --release" >&2
exit 1
}
[ -f "$MIME_TYPES" ] || { echo "!! mime.types 缺失:$MIME_TYPES" >&2; exit 1; }
[ -f "$DEMO_APP" ] || { echo "!! demo 系统缺失:$DEMO_APP" >&2; exit 1; }
# ---------------------------------------------------------------------------
# 种子数据:source/data-seed/ -> source/data/(幂等,不覆盖已有 users.json)
# 种子数据:data-seed/ -> data/(幂等,不覆盖已有 users.json)
# ---------------------------------------------------------------------------
echo "## [seed] 物化数据目录 $DATA_DIR"
bash "$HERE/seed-data.sh"
@@ -120,7 +120,7 @@ for ln in src:
out.append("error_log %s info;" % os.environ["ERR_LOG"]); continue
if s.startswith("pid "):
out.append("pid %s;" % os.environ["PID"]); continue
# 管理台静态页:模板里的 /usr/local/nginx/www → 仓库 source/www/
# 管理台静态页:模板里的 /usr/local/nginx/www → 仓库 www/
if "/usr/local/nginx/www/" in ln:
out.append(ln.replace("/usr/local/nginx/www/", os.environ["WWW_DIR"] + "/")); continue
# 正则 server_name(生产用子域捕获)→ 普通 server_name:本机 nginx 无 PCRE
+10 -10
View File
@@ -1,16 +1,16 @@
#!/usr/bin/env bash
# ============================================================================
# 物化运行时数据目录:source/data-seed/ -> source/data/
# 物化运行时数据目录:data-seed/ -> data/
#
# 为什么需要这一步
# source/data/ 是**运行时**目录(可写、含真实口令散列),不进版本库;
# source/data-seed/ 是**种子模板**(只放演示客户端与示例账号),进版本库。
# data/ 是**运行时**目录(可写、含真实口令散列),不进版本库;
# data-seed/ 是**种子模板**(只放演示客户端与示例账号),进版本库。
# 本脚本把两者接起来,并顺便把示例里的占位符换成真实值。
#
# 做的事:
# 1. source/data/oauth_clients.json <- source/data-seed/oauth_clients.json
# 2. source/data/users.json <- 由本脚本生成(admin / alice 两个账号)
# 3. source/data/users.json.example <- 同步一份示例(占位符,不含真实散列)
# 1. data/oauth_clients.json <- data-seed/oauth_clients.json
# 2. data/users.json <- 由本脚本生成(admin / alice 两个账号)
# 3. data/users.json.example <- 同步一份示例(占位符,不含真实散列)
#
# 幂等:users.json 已存在时**默认不动**(避免覆盖你手工改过的账号),要重建加 --force。
#
@@ -26,8 +26,8 @@ set -euo pipefail
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
ROOT="$(cd "$HERE/.." && pwd)"
SEED_DIR="${SEED_DIR:-$ROOT/source/data-seed}"
DATA_DIR="${DATA_DIR:-$ROOT/source/data}"
SEED_DIR="${SEED_DIR:-$ROOT/data-seed}"
DATA_DIR="${DATA_DIR:-$ROOT/data}"
ADMIN_PASSWORD="${ADMIN_PASSWORD:-123456}"
ALICE_PASSWORD="${ALICE_PASSWORD:-alice123}"
@@ -57,7 +57,7 @@ fi
# ---------------------------------------------------------------------------
# 2. 账号表:生成真实散列。
#
# ⚠️ 散列算法必须与 source/rust/src/util.rs::hash_password 逐位一致,
# ⚠️ 散列算法必须与 rust/src/util.rs::hash_password 逐位一致,
# 否则生成的账号永远登录不上:
# x = sha256("salt:password") ← 注意中间是冒号
# 重复 HASH_ROUNDS(=1000,见 config.rs) 次:x = sha256(x + salt)
@@ -71,7 +71,7 @@ else
"$PYTHON" - <<'PYEOF'
import hashlib, json, os, secrets
HASH_ROUNDS = 1000 # 必须与 source/rust/src/config.rs 的 HASH_ROUNDS 一致
HASH_ROUNDS = 1000 # 必须与 rust/src/config.rs 的 HASH_ROUNDS 一致
def pwd_hash(salt, password):
x = hashlib.sha256(("%s:%s" % (salt, password)).encode()).hexdigest()
+2 -2
View File
@@ -11,7 +11,7 @@
# - 参数校验:非法回调地址 / 非法授权类型 / 授权码模式缺回调
# - 公开客户端不持有密钥,且自动剔除 client_credentials / password
#
# 前置:网关以 source/conf/nginx.test.conf 运行(见 scripts/run-local-e2e.sh)
# 前置:网关以 conf/nginx.test.conf 运行(见 scripts/run-local-e2e.sh)
# 依赖:curl、python3
#
# 用法:bash tests/admin-oauth-clients-e2e.sh [IDP_BASE] [DATA_DIR]
@@ -25,7 +25,7 @@ unset _ENV_HERE
BASE="${1:-http://127.0.0.1:18098}"
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
DATA_DIR="${2:-$ROOT/source/data}"
DATA_DIR="${2:-$ROOT/data}"
ADMIN_USER="${ADMIN_USER:-admin}"
ADMIN_PASS="${ADMIN_PASS:-${ADMIN_PASSWORD:-123456}}"
+2 -2
View File
@@ -13,7 +13,7 @@
# - 改组 → 新签令牌立即携带新组(用户表热生效);旧令牌保持签发时快照
# - 审计日志写入 admin.user.batch
#
# 前置:网关以 source/conf/nginx.test.conf 运行(见 scripts/run-local-e2e.sh)
# 前置:网关以 conf/nginx.test.conf 运行(见 scripts/run-local-e2e.sh)
# 依赖:curl、python3
#
# 用法:bash tests/admin-users-batch-e2e.sh [IDP_BASE] [DATA_DIR] [IAP_DEMO_BASE]
@@ -27,7 +27,7 @@ unset _ENV_HERE
BASE="${1:-http://127.0.0.1:18098}"
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
DATA_DIR="${2:-$ROOT/source/data}"
DATA_DIR="${2:-$ROOT/data}"
IAP_DEMO="${3:-http://127.0.0.1:18095}"
ADMIN_USER="${ADMIN_USER:-admin}"
ADMIN_PASS="${ADMIN_PASS:-${ADMIN_PASSWORD:-123456}}"
+3 -3
View File
@@ -13,7 +13,7 @@
# - 界面:管理台单页含新增页签/按钮、终端用户 /forgot 与 /reset 页面可访问
# - 应用管理:协议类型 / 门户字段 / 可见范围;用户门户 /apps 按可见范围过滤
#
# 前置:网关以 source/conf/nginx.test.conf 运行(见 scripts/run-local-e2e.sh)
# 前置:网关以 conf/nginx.test.conf 运行(见 scripts/run-local-e2e.sh)
# 依赖:curl、python3
#
# 用法:bash tests/maxkey-p1p2-e2e.sh [IDP_BASE] [DATA_DIR]
@@ -25,7 +25,7 @@ unset _ENV_HERE
BASE="${1:-http://127.0.0.1:18098}"
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
DATA_DIR="${2:-$ROOT/source/data}"
DATA_DIR="${2:-$ROOT/data}"
ADMIN_USER="${ADMIN_USER:-admin}"
ADMIN_PASS="${ADMIN_PASS:-${ADMIN_PASSWORD:-123456}}"
PWD_SINK="${PASSWORD_RESET_TOKEN_SINK:-/tmp/sso-pwdreset-token.txt}"
@@ -224,7 +224,7 @@ code="$(curl -s -o /dev/null -w '%{http_code}' -X POST "$BASE/api/admin/login" -
echo
echo "############ [F] 界面:管理台单页 + 终端用户找回页 ############"
# --- 管理台单页(nginx alias 到 source/www/admin.html)---
# --- 管理台单页(nginx alias 到 www/admin.html)---
adm="$(curl -s "$BASE/admin")"
[[ "$adm" == *'data-tab="sync"'* ]] && ok "管理台含「身份同步」页签" || bad "管理台缺少身份同步页签"
[[ "$adm" == *'data-tab="ops"'* ]] && ok "管理台含「会话 / 审计」页签" || bad "管理台缺少会话/审计页签"
+3 -3
View File
@@ -7,8 +7,8 @@
# IAP 身份注入(无身份拦截、Bearer、Cookie、伪造头覆盖)
#
# 前置:
# - 网关以 source/conf/nginx.test.conf(或等价生产配置)运行
# - 种子:source/data/users.json(alice/alice123)、source/data/oauth_clients.json
# - 网关以 conf/nginx.test.conf(或等价生产配置)运行
# - 种子:data/users.json(alice/alice123)、data/oauth_clients.json
# (grafana / spa-demo / machine)
# - 依赖:curl、python3
#
@@ -27,7 +27,7 @@ unset _ENV_HERE
BASE="${1:-http://127.0.0.1:18098}"
IAP="${2:-http://127.0.0.1:18099}"
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
DATA_DIR="${3:-$ROOT/source/data}"
DATA_DIR="${3:-$ROOT/data}"
JAR="$(mktemp -t sso_e2e_cookies.XXXXXX.txt)"
HDR="$(mktemp -t sso_e2e_hdr.XXXXXX.txt)"
+2 -2
View File
@@ -11,7 +11,7 @@
# 前置:
# - scripts/run-local-e2e.sh 已拉起 nginx(:18098 IdP / :18095 IAP)
# 与 demo-system(:18096)
# - 种子:source/data/users.json(alice/alice123)、source/data/oauth_clients.json
# - 种子:data/users.json(alice/alice123)、data/oauth_clients.json
# (demo-system 机密 / demo-spa 公开)
# - 依赖:curl、python3
#
@@ -30,7 +30,7 @@ IDP="${1:-http://127.0.0.1:18098}"
DEMO="${2:-http://127.0.0.1:18096}"
IAPD="${3:-http://127.0.0.1:18095}"
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
DATA_DIR="${4:-$ROOT/source/data}"
DATA_DIR="${4:-$ROOT/data}"
JAR="$(mktemp -t sso_mk_cookies.XXXXXX.txt)"
H1="$(mktemp -t sso_mk_h1.XXXXXX.txt)"
+1 -1
View File
@@ -26,7 +26,7 @@ unset _ENV_HERE
BASE="${1:-http://127.0.0.1:18098}"
IAP="${2:-http://127.0.0.1:18099}"
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
DATA_DIR="${3:-$ROOT/source/data}"
DATA_DIR="${3:-$ROOT/data}"
PASS=0; FAIL=0
ok() { echo " ✅ $1"; PASS=$((PASS+1)); }
File renamed without changes.