fix(review): 整分支终审修 3 处 —— 密文契约外部锚点 / 相对数据目录分家 / 首启默认口令可覆盖

终审(就地执行)发现的 3 个问题:

1. 密文契约只在单元层被钉住(R1 未闭环):集成测试用本仓自己的
   encrypt_login_password 造密文 ⇒ 自证自洽 ⇒ CIPHER_KEY 改错时全绿。
   新增 login_accepts_the_upstream_literal_ciphertext:用上游仓库注释里的
   字面密文登录成功,篡一个字节必须失败。
   变异自证:换掉 CIPHER_KEY ⇒ 旧 7 例仍全绿、只有新用例红。

2. 相对 TDC_DATA_DIR 会让数据目录分家:pglite-rs 打开数据目录后会 chdir
   进去 ⇒ 之后 accounts.json 落到 data/tdc.pg/<相对路径>/ 下。
   Config::from_env 在 chdir 之前把数据目录钉成绝对路径(新增纯函数
   data_dir_from + 单测)。

3. 首启管理员口令是公开默认值 admin 且无覆盖机制(R2 未闭环):
   新增 TDC_BOOTSTRAP_ADMIN_ACCOUNT / TDC_BOOTSTRAP_ADMIN_PASSWORD;
   TDC_STRICT_SECRETS=1 时还有管理员在用默认口令 ⇒ 启动即失败。

验收:207 passed / 0 failed / 1 ignored;clippy --all-targets 干净。

Co-Authored-By: Claude Code <[email protected]>
This commit is contained in:
adminandClaude Code committed 2026-10-25 11:44:37 +08:00
1 parent 4a5b7ecb2b
commit 3586333a7a
5 files changed
+243 -13

No files matched your search

+13 -2
View File
@@ -20,7 +20,8 @@
> `grant_type=password`;`grant_type=maxkey` 如实报业务失败,**不伪装成功**)。
> 但**不引入 j7** ⇒ 用本连接器自己的**本地账号库** `data/accounts.json` 顶替
> (口令只存 `md5(明文)`,**永不回显**);首次启动自动引导一个管理员账号
> **`admin` / `admin`**(⚠️ **本地调试默认值**,对外部署前必须改掉)。
> **`admin` / `admin`**(⚠️ **本地调试默认值**,可用
> `TDC_BOOTSTRAP_ADMIN_PASSWORD` 覆盖;对外部署前必须改掉)。
> 连接器身份登录(`/api/ssw/tdc/Auth/Login`)也仍然可用。
## 运行
@@ -119,7 +120,17 @@ sccache 0.18 经 `~/.cargo/config.toml` 的 `[build] rustc-wrapper` + `[env] SCC
- 能力集**解析不出** ⇒ **fail-open**(本地单机模式没有能力集,不该把写操作全锁死);
**解析出来** ⇒ 按键判定,`*` / `all` 通配放行。
- 无凭证 ⇒ 403;内部令牌 ⇒ 放行;**本地账号 ⇒ 放行**(⚠️ 已知边界,见 `.superpowers/sdd/` ledger)。
- 🔴 `TDC_STRICT_SECRETS=1` ⇒ 默认口令视为不安全 ⇒ **启动即失败**。
- 🔴 `TDC_STRICT_SECRETS=1` ⇒ 默认口令视为不安全 ⇒ **启动即失败**:
内部令牌等于公开默认值即拒绝;**且**本地管理员仍在用默认口令 `admin` 也拒绝
(口令改过、或用 `TDC_BOOTSTRAP_ADMIN_PASSWORD` 引导过 ⇒ 放行)。
**首次启动的本地管理员**:默认 `admin` / `admin`(⚠️ **本地调试默认值**)。
可用环境变量在**空库首次引导**时覆盖(**已有账号库时不再生效**,改密请走用户管理页):
| 环境变量 | 作用 | 默认 |
|---|---|---|
| `TDC_BOOTSTRAP_ADMIN_ACCOUNT` | 引导的管理员**账号名** | `admin` |
| `TDC_BOOTSTRAP_ADMIN_PASSWORD` | 引导的管理员**口令** | `admin`(公开默认值) |
## 已实现范围
+79 -2
View File
@@ -78,22 +78,43 @@ pub struct AccountStore {
impl AccountStore {
/// 打开(或创建)账号文件;**库里没有账号时引导一个 `admin`**。
///
/// 🔴 引导口令是**公开默认值**(`admin`)⇒ 生产档必须用
/// [`AccountStore::open_with_admin`] 覆盖(或事后改密)。
pub fn open(path: &Path) -> std::io::Result<Self> {
Self::open_with_admin(path, BOOTSTRAP_ADMIN_ACCOUNT, BOOTSTRAP_ADMIN_PASSWORD)
}
/// 同 [`AccountStore::open`],但**引导**用的账号名/口令可覆盖
/// (`TDC_BOOTSTRAP_ADMIN_ACCOUNT` / `TDC_BOOTSTRAP_ADMIN_PASSWORD`)。
///
/// ⚠️ 覆盖**只对「库里还没有账号」生效** ⇒ 已存在的账号库不会被覆盖
/// (改口令请走 `ResetPassword` 或改密后的账号库)。
pub fn open_with_admin(
path: &Path,
bootstrap_account: &str,
bootstrap_password: &str,
) -> std::io::Result<Self> {
let mut file: AccountFile = match std::fs::read(path) {
Ok(bytes) => serde_json::from_slice(&bytes).unwrap_or_default(),
Err(_) => AccountFile::default(),
};
if file.accounts.is_empty() {
let account = if bootstrap_account.trim().is_empty() {
BOOTSTRAP_ADMIN_ACCOUNT
} else {
bootstrap_account.trim()
};
file.accounts.push(Account {
id: crate::ids::next_id(),
account: BOOTSTRAP_ADMIN_ACCOUNT.to_string(),
account: account.to_string(),
real_name: "管理员".to_string(),
gender: 1,
mobile_phone: None,
description: Some("首次启动引导".to_string()),
enabled_mark: 1,
administrator: true,
password_md5: md5_hex(BOOTSTRAP_ADMIN_PASSWORD),
password_md5: md5_hex(bootstrap_password),
creator_time: now_iso(),
});
}
@@ -105,6 +126,22 @@ impl AccountStore {
Ok(store)
}
/// 是否**还有管理员账号在用默认口令**(`md5("admin")`)。
///
/// 🔴 供 `TDC_STRICT_SECRETS=1` 的护栏用:默认口令是**公开已知**的
/// ⇒ 生产档必须拒绝启动;口令改过(或引导时用环境变量覆盖过)就放行。
/// 判据是「**任何管理员账号**的散列等于默认散列」⇒ 换个账号名继续用
/// 默认口令**也**会被拦(fail-closed)。
pub fn bootstrap_admin_uses_default_password(&self) -> bool {
let default_md5 = md5_hex(BOOTSTRAP_ADMIN_PASSWORD);
self.inner
.lock()
.expect("账号库锁中毒")
.accounts
.iter()
.any(|a| a.administrator && a.password_md5 == default_md5)
}
/// 内存库(不落盘)。
pub fn empty() -> Self {
Self {
@@ -369,6 +406,46 @@ mod tests {
assert!(store.remove(&admin.id).is_err());
}
#[test]
fn bootstrap_admin_password_can_be_overridden() {
// 🔴 `TDC_BOOTSTRAP_ADMIN_PASSWORD` 的落点:引导口令可被覆盖
// ⇒ 生产档不必依赖「记得改密」这件事。
let store = AccountStore::open_with_admin(
&fresh_path("bootstrapoverride"),
"root",
"a-strong-bootstrap-pass",
)
.expect("打开账号库失败");
let admin = store.find_by_account("root").expect("应有 root 账号");
assert!(admin.administrator);
assert_eq!(admin.password_md5, md5_hex("a-strong-bootstrap-pass"));
// 覆盖了默认口令 ⇒ 生产档护栏放行
assert!(!store.bootstrap_admin_uses_default_password());
// ⚠️ 库里**已有账号**时,再开一次**不覆盖**既有账号(口令只由引导决定)。
// ⚠️ 这里必须用 `tmp_path`(**不**删文件)——`fresh_path` 会把上一次的库删掉。
let again = AccountStore::open_with_admin(
&tmp_path("bootstrapoverride"),
"other",
"another-pass",
)
.expect("再次打开账号库失败");
let admin2 = again.find_by_account("root").expect("root 账号仍在");
assert_eq!(admin2.password_md5, md5_hex("a-strong-bootstrap-pass"));
}
#[test]
fn default_bootstrap_password_is_detected() {
// 🔴 生产档护栏的判据:还有管理员用着 `md5("admin")` ⇒ 拒启动。
let store = AccountStore::open(&fresh_path("defaultpass")).expect("打开账号库失败");
assert!(store.bootstrap_admin_uses_default_password());
// 改密之后 ⇒ 放行
let admin = store.find_by_account(BOOTSTRAP_ADMIN_ACCOUNT).unwrap();
store
.reset_password(&admin.id, &md5_hex("a-new-strong-pass"))
.expect("改密失败");
assert!(!store.bootstrap_admin_uses_default_password());
}
#[test]
fn civil_from_days_matches_known_dates() {
assert_eq!(civil_from_days(0), (1970, 1, 1));
+82 -7
View File
@@ -3,12 +3,14 @@
//! 红线:内部令牌**只看 `X-Internal-Token` 头**,不接受 query / body;
//! `TDC_STRICT_SECRETS=1` 时默认口令即视为不安全 ⇒ 启动即失败。
use std::path::PathBuf;
use std::path::{Path, PathBuf};
pub const DEFAULT_INTERNAL_TOKEN: &str = "ssw-internal-token-e2e";
pub const DEFAULT_PORT: u16 = 30000;
pub const DEFAULT_IDENTITY_CODE: &str = "LOCAL-CONNECTOR";
pub const DEFAULT_IDENTITY_NAME: &str = "本地连接器";
/// 首次启动引导的本地管理员**账号名**默认值。
pub const DEFAULT_BOOTSTRAP_ADMIN_ACCOUNT: &str = "admin";
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum StandaloneMode {
@@ -38,6 +40,27 @@ fn env_or_default(raw: Option<String>, default: &str) -> String {
}
}
/// 数据目录:未设 `TDC_DATA_DIR` ⇒ `<项目目录>/data`;设了 ⇒ 取它的值。
///
/// 🔴 **必须返回绝对路径**:`pglite-rs` 打开数据目录后会 **`chdir` 进去**
/// ⇒ 之后任何**相对**路径都会被解析到 pg 数据目录底下
/// (实测:账号库曾落到 `data/tdc.pg/<相对路径>/accounts.json` ⇒ 数据目录分家)。
/// 这里在 chdir 发生**之前**用当时的 cwd 把相对路径钉成绝对路径。
///
/// 纯函数(cwd 由调用方传入)⇒ 可单测。
fn data_dir_from(raw: Option<String>, project_dir: &Path, cwd: &Path) -> PathBuf {
let raw = env_or_default(raw, "");
if raw.trim().is_empty() {
return project_dir.join("data");
}
let p = PathBuf::from(raw.trim());
if p.is_absolute() {
p
} else {
cwd.join(p)
}
}
/// 解析本地单机模式:`TDC_LOCAL_STANDALONE`(规格名,权威)优先,
/// `TDC_STANDALONE`(别名)为次;都没给 ⇒ 未配置 ⇒ `Auto`。
///
@@ -77,6 +100,13 @@ pub struct Config {
pub identity_code: String,
pub identity_name: String,
pub identity_secret: Option<String>,
/// 首次启动引导的**本地管理员账号名**(`TDC_BOOTSTRAP_ADMIN_ACCOUNT`)。
pub bootstrap_admin_account: String,
/// 首次启动引导的**本地管理员口令**(`TDC_BOOTSTRAP_ADMIN_PASSWORD`)。
///
/// 🔴 `None` = 未设置 ⇒ 落回公开默认值 `admin`(本地调试用)
/// ⇒ 生产档必须设(`TDC_STRICT_SECRETS=1` 会因此拒绝启动)。
pub bootstrap_admin_password: Option<String>,
}
impl Config {
@@ -86,12 +116,8 @@ impl Config {
.and_then(|v| v.trim().parse().ok())
.unwrap_or(DEFAULT_PORT);
let data_dir = {
let raw = env_or_default(std::env::var("TDC_DATA_DIR").ok(), "");
if raw.trim().is_empty() {
project_dir.join("data")
} else {
PathBuf::from(raw.trim())
}
let cwd = std::env::current_dir().unwrap_or_else(|_| PathBuf::from("."));
data_dir_from(std::env::var("TDC_DATA_DIR").ok(), &project_dir, &cwd)
};
let internal_token = internal_token_from(std::env::var("SSW_INTERNAL_TOKEN").ok());
let tds_base_url = {
@@ -137,6 +163,23 @@ impl Config {
Some(v)
}
};
// 🔴 本地管理员的引导账号/口令:口令**不设** ⇒ 落回公开默认值 `admin`
// (本地调试用);生产档(`TDC_STRICT_SECRETS=1`)必须显式设置。
let bootstrap_admin_account = env_or_default(
std::env::var("TDC_BOOTSTRAP_ADMIN_ACCOUNT").ok(),
DEFAULT_BOOTSTRAP_ADMIN_ACCOUNT,
)
.trim()
.to_string();
let bootstrap_admin_password = {
let raw = env_or_default(std::env::var("TDC_BOOTSTRAP_ADMIN_PASSWORD").ok(), "");
let v = raw.trim().to_string();
if v.is_empty() {
None
} else {
Some(v)
}
};
Self {
port,
project_dir,
@@ -148,6 +191,8 @@ impl Config {
identity_code,
identity_name,
identity_secret,
bootstrap_admin_account,
bootstrap_admin_password,
}
}
@@ -199,6 +244,8 @@ mod tests {
identity_code: DEFAULT_IDENTITY_CODE.to_string(),
identity_name: DEFAULT_IDENTITY_NAME.to_string(),
identity_secret: None,
bootstrap_admin_account: DEFAULT_BOOTSTRAP_ADMIN_ACCOUNT.to_string(),
bootstrap_admin_password: None,
}
}
@@ -236,6 +283,34 @@ mod tests {
assert!(c.check_secret_guard().is_ok());
}
/// 🔴 `pglite-rs` 打开数据目录后会 **chdir** 进去 ⇒ 相对 `TDC_DATA_DIR`
/// 会让**之后**的相对路径(账号库)落到 pg 数据目录底下 ⇒ 必须钉成绝对路径。
#[test]
fn data_dir_is_always_absolute() {
let project = Path::new("/opt/proj");
let cwd = Path::new("/work/repo");
// 未设 ⇒ 项目目录下的 data(本来就是绝对的)
assert_eq!(
data_dir_from(None, project, cwd),
PathBuf::from("/opt/proj/data")
);
// 空白 ⇒ 同上
assert_eq!(
data_dir_from(Some(" ".into()), project, cwd),
PathBuf::from("/opt/proj/data")
);
// 相对路径 ⇒ 相对**当时的 cwd** 钉成绝对路径
assert_eq!(
data_dir_from(Some("target/probe".into()), project, cwd),
PathBuf::from("/work/repo/target/probe")
);
// 绝对路径 ⇒ 原样
assert_eq!(
data_dir_from(Some("/var/lib/tdc".into()), project, cwd),
PathBuf::from("/var/lib/tdc")
);
}
#[test]
fn env_or_default_falls_back_on_missing_empty_or_blank() {
assert_eq!(env_or_default(None, "d"), "d");
+20 -2
View File
@@ -127,10 +127,28 @@ async fn main() {
// 本地账号库(上游完整前端的 JNPF 兼容登录用):JSON 文件,不进数据库。
// 🔴 挂在 `with_bootstrap` **之后**(`with_accounts` 只换 `accounts` 字段,其余保留)。
// ⚠️ `data_dir` 已在上面定义(来自 `config.data_dir`)⇒ 这里**不重新定义**。
// 🔴 引导口令可被 `TDC_BOOTSTRAP_ADMIN_PASSWORD` 覆盖(**只对空库生效**)。
let accounts = Arc::new(
tdc_connector::account::AccountStore::open(&data_dir.join("accounts.json"))
.expect("打开本地账号库失败"),
tdc_connector::account::AccountStore::open_with_admin(
&data_dir.join("accounts.json"),
&config.bootstrap_admin_account,
config
.bootstrap_admin_password
.as_deref()
.unwrap_or(tdc_connector::account::BOOTSTRAP_ADMIN_PASSWORD),
)
.expect("打开本地账号库失败"),
);
// 🔴 生产档护栏(`TDC_STRICT_SECRETS=1`):**默认口令 `admin` 是公开已知的**
// ⇒ 还有管理员在用它就**拒绝启动**(口令改过 / 引导时用环境变量覆盖过 ⇒ 放行)。
if config.strict_secrets && accounts.bootstrap_admin_uses_default_password() {
eprintln!(
"[tdc-connector] TDC_STRICT_SECRETS=1:本地管理员仍在用默认口令 `{}` ⇒ 启动即失败。\
请用 TDC_BOOTSTRAP_ADMIN_PASSWORD 引导,或先改密。",
tdc_connector::account::BOOTSTRAP_ADMIN_PASSWORD
);
std::process::exit(1);
}
let state = state.with_accounts(accounts);
let auth_state = AuthState {
+49
View File
@@ -229,6 +229,55 @@ async fn user_management_requires_an_administrator() {
);
}
/// 🔴 **R1 · 密文契约的「仓外」锚点**:用**上游仓库注释里的字面密文**登录。
///
/// 🔴 为什么必须有一条**不依赖本仓加解密实现**的用例:
/// 其余用例都用 `encrypt_login_password()` 造密文 ⇒ **自证自洽** ⇒
/// `CIPHER_KEY` 被改错时它们**全绿**(实测过:换 key 后 7 个用例仍全过)。
/// 上游契约只被 `src/cipher.rs` 的单元测试(字面向量)钉住 —— 那是**单元**层。
/// 本用例是**端到端**层:字面密文 ⇒ 登录成功 ⇒ **整条链**(解密 → md5 比对
/// → 会话签发)都对齐上游。
///
/// 上游 `src/utils/cipher.ts` 自检向量:`encryptPassword('123456')` 的字面密文。
const UPSTREAM_CIPHER_OF_123456: &str = "d4958348e22108119b3ef57b022c83f4bf857dd0b247eaab15b9a43d47ee3c503900f7135bf0de255bc33620c3cdc02b";
#[tokio::test]
async fn login_accepts_the_upstream_literal_ciphertext() {
let (app, accounts) = build("upstreamcipher").await;
// 新建账号的初始口令 = `DEFAULT_NEW_USER_PASSWORD` = "123456"
// ⇒ 账号库里存的是 `md5("123456")` = e10adc3949ba59abbe56e057f20f883e
let dave = accounts
.create("dave", "戴夫", 1, None, None)
.expect("建号失败");
assert_eq!(dave.password_md5, "e10adc3949ba59abbe56e057f20f883e");
// ① 上游字面密文 ⇒ 登录成功
let form = format!(
"account=dave&password={}&grant_type=password",
UPSTREAM_CIPHER_OF_123456
);
let (status, body) = call(&app, post_form("/api/oauth/Login", form)).await;
assert_eq!(status, 200);
assert_eq!(
body["code"], 200,
"上游字面密文应能登录(密文契约被改坏了?): {}",
body
);
assert!(!body["data"]["token"].as_str().unwrap_or_default().is_empty());
// ② 同一密文**篡一个字节** ⇒ 必然解出垃圾 ⇒ 业务失败(不许静默放行)
let mut tampered = UPSTREAM_CIPHER_OF_123456.to_string();
tampered.replace_range(0..1, if tampered.starts_with('d') { "e" } else { "d" });
let form = format!(
"account=dave&password={}&grant_type=password",
tampered
);
let (status, body) = call(&app, post_form("/api/oauth/Login", form)).await;
assert_eq!(status, 200);
assert_ne!(body["code"], 200, "篡改的密文必须登录失败:{}", body);
assert_eq!(body["msg"], "账号或密码错误");
}
/// 🔴 **E2 刻意分歧**:内部令牌通道访问用户管理 ⇒ **403**(上游更宽松,直接放行)。
#[tokio::test]
async fn internal_token_channel_is_rejected_by_the_admin_gate() {