影响:写操作(新建 / 修改 / 逻辑删除)现在多一道**权限键**判定; 能力集来自 `tdc_identity.f_capability`,解析不出时 **fail-open 放行** (对齐上游「菜单未映射即放行」口径)⇒ 存量连接器不受影响。 改动: - `src/registry.rs`:新增 `PERMISSION_KEYS`(18 个实体 → 权限键)与 `permission_key()`, 另加一条单测守住「每个实体都有权限键」。 - `src/domain/identity.rs`:新增 `capabilities()` —— 解析 `f_capability` 自由文本 (`,` `;` 空白分隔)成 token 集合;解析不出返回 `None`。 - `src/crud.rs`:新增 `require_write_permission()`;`create` / `update` / `delete` 改走它(读接口 `list` / `all` / `detail` / `detail_aggregate` **不动**, 读不做权限键判定)。 - `tests/permission_gate.rs`:5 个用例(能力集解析 / fail-open / 命中与未命中 / 通配符 / 内部令牌与无凭证),含一条**接线自证**——三个写路径未命中权限键时必须是 403。 设计:能力集解析不出 ⇒ 放行(fail-open);本地账号(无 `tdc_identity` 来源)同 footing。 Co-Authored-By: Claude Code <[email protected]>
171 lines
6.1 KiB
Rust
171 lines
6.1 KiB
Rust
//! 权限键:能力集解析 + 写操作二次校验。
|
||
//!
|
||
//! ⚠️ 本测试二进制内共用一个 PGlite 实例(pglite-rs 每进程只允许一个)。
|
||
|
||
use std::sync::Arc;
|
||
|
||
use axum::http::StatusCode;
|
||
use pglite::PGlite;
|
||
use tdc_connector::auth::Principal;
|
||
use tdc_connector::config::Config;
|
||
use tdc_connector::crud::require_write_permission;
|
||
use tdc_connector::domain::identity;
|
||
use tdc_connector::registry;
|
||
use tdc_connector::session::SessionStore;
|
||
use tdc_connector::state::{AppState, BootstrapIdentity};
|
||
use tokio::sync::OnceCell;
|
||
|
||
static DB: OnceCell<Arc<PGlite>> = OnceCell::const_new();
|
||
|
||
async fn shared_db() -> Arc<PGlite> {
|
||
DB.get_or_init(|| async {
|
||
let db = Arc::new(PGlite::open_temp().await.expect("打开临时 PGlite 失败"));
|
||
tdc_connector::db::ensure_schema(db.as_ref())
|
||
.await
|
||
.expect("建表失败");
|
||
db
|
||
})
|
||
.await
|
||
.clone()
|
||
}
|
||
|
||
async fn test_state() -> AppState {
|
||
let db = shared_db().await;
|
||
let mut config = Config::from_env(std::env::current_dir().unwrap());
|
||
config.identity_code = "TEST-CONNECTOR".to_string();
|
||
AppState::new(
|
||
config,
|
||
db,
|
||
Arc::new(SessionStore::new()),
|
||
BootstrapIdentity::default(),
|
||
)
|
||
}
|
||
|
||
/// 插入一条测试身份;`capability` 为 `None` 时该列为 NULL。
|
||
async fn upsert_identity(code: &str, capability: Option<&str>) {
|
||
let state = test_state().await;
|
||
let cap = match capability {
|
||
Some(c) => format!("'{}'", c),
|
||
None => "NULL".to_string(),
|
||
};
|
||
let id = format!("ID-{}", code);
|
||
let sql = format!(
|
||
"INSERT INTO tdc_identity (f_id, f_identity_code, f_name, f_capability) \
|
||
VALUES ('{}', '{}', '测试身份', {})",
|
||
id, code, cap
|
||
);
|
||
// 🔴 所有 DB 访问必须持 `state.db_lock`(PGlite 单 in-process backend,CLAUDE.md 红线)
|
||
// —— 测试代码也不例外,否则与并行的 `capabilities()` 查询在同一个 backend 上抢。
|
||
let _g = state.db_lock.lock().await;
|
||
state.db.exec(&sql).await.expect("插入测试身份失败");
|
||
}
|
||
|
||
fn session(code: &str) -> Principal {
|
||
Principal::Session {
|
||
identity_id: format!("ID-{}", code),
|
||
identity_code: code.to_string(),
|
||
}
|
||
}
|
||
|
||
#[tokio::test]
|
||
async fn missing_capability_fails_open() {
|
||
upsert_identity("NO-CAP", None).await;
|
||
let state = test_state().await;
|
||
let caps = identity::capabilities(&state, "NO-CAP").await;
|
||
assert!(caps.is_none(), "空能力集应解析为 None(⇒ fail-open)");
|
||
|
||
let spec = registry::find("Product").expect("Product 应在注册表里");
|
||
let r = require_write_permission(&state, spec, Some(&session("NO-CAP"))).await;
|
||
assert!(r.is_ok(), "能力集解析不出时必须 fail-open 放行");
|
||
}
|
||
|
||
#[tokio::test]
|
||
async fn parsed_capability_is_enforced_on_write() {
|
||
upsert_identity("ONLY-PRODUCT", Some("product")).await;
|
||
let state = test_state().await;
|
||
|
||
let caps = identity::capabilities(&state, "ONLY-PRODUCT").await;
|
||
assert_eq!(caps, Some(vec!["product".to_string()]));
|
||
|
||
let product = registry::find("Product").expect("Product 应在注册表里");
|
||
assert!(
|
||
require_write_permission(&state, product, Some(&session("ONLY-PRODUCT")))
|
||
.await
|
||
.is_ok(),
|
||
"命中权限键应放行"
|
||
);
|
||
|
||
let contract = registry::find("Contract").expect("Contract 应在注册表里");
|
||
assert!(
|
||
require_write_permission(&state, contract, Some(&session("ONLY-PRODUCT")))
|
||
.await
|
||
.is_err(),
|
||
"未命中权限键必须被拒"
|
||
);
|
||
}
|
||
|
||
#[tokio::test]
|
||
async fn wildcard_capability_allows_everything() {
|
||
upsert_identity("ROOT", Some("*")).await;
|
||
let state = test_state().await;
|
||
let spec = registry::find("Contract").expect("Contract 应在注册表里");
|
||
assert!(
|
||
require_write_permission(&state, spec, Some(&session("ROOT")))
|
||
.await
|
||
.is_ok(),
|
||
"通配符应放行全部实体"
|
||
);
|
||
}
|
||
|
||
#[tokio::test]
|
||
async fn internal_principal_bypasses_the_gate() {
|
||
let state = test_state().await;
|
||
let spec = registry::find("Contract").expect("Contract 应在注册表里");
|
||
assert!(
|
||
require_write_permission(&state, spec, Some(&Principal::Internal { operator: None }))
|
||
.await
|
||
.is_ok(),
|
||
"内部令牌必须直接放行"
|
||
);
|
||
assert!(
|
||
require_write_permission(&state, spec, None).await.is_err(),
|
||
"无凭证必须被拒"
|
||
);
|
||
}
|
||
|
||
/// 🔴 **接线自证**:三个**写路径**(`create` / `update` / `delete`)真的走了权限键判定。
|
||
///
|
||
/// 三个写函数都把权限判定放在**函数最开头**(在任何 DB 访问之前)⇒
|
||
/// 即便 id 不存在,被拒的也应该是 **403**,而不是业务层的「记录不存在或已删除」(200)。
|
||
/// ⇒ 这条用例是「把 `create` 里的 `require_write_permission` 换回 `require_menu_permission`」
|
||
/// 那次变异的**红点**(没有它,CRUD 写路径的接线是**测不到**的)。
|
||
#[tokio::test]
|
||
async fn crud_write_paths_enforce_the_permission_key() {
|
||
// ⚠️ 身份码要**唯一**:本测试二进制里的用例并行跑、共用同一个库 ⇒
|
||
// 复用别的用例的 `f_identity_code` 会撞主键。
|
||
upsert_identity("CAP-PRODUCT-ONLY", Some("product")).await;
|
||
let state = test_state().await;
|
||
let contract = registry::find("Contract").expect("Contract 应在注册表里");
|
||
let p = session("CAP-PRODUCT-ONLY");
|
||
let body = serde_json::json!({});
|
||
|
||
let r = tdc_connector::crud::create(&state, contract, &body, Some(&p)).await;
|
||
assert_eq!(
|
||
r.status(),
|
||
StatusCode::FORBIDDEN,
|
||
"create 未命中权限键必须 403"
|
||
);
|
||
let r = tdc_connector::crud::update(&state, contract, "NOT-EXIST", &body, Some(&p)).await;
|
||
assert_eq!(
|
||
r.status(),
|
||
StatusCode::FORBIDDEN,
|
||
"update 未命中权限键必须 403"
|
||
);
|
||
let r = tdc_connector::crud::delete(&state, contract, "NOT-EXIST", Some(&p)).await;
|
||
assert_eq!(
|
||
r.status(),
|
||
StatusCode::FORBIDDEN,
|
||
"delete 未命中权限键必须 403"
|
||
);
|
||
}
|