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:
1 parent
4a5b7ecb2b
commit
3586333a7a
5 files changed
+243
-13
No files matched your search
@@ -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
@@ -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
@@ -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
@@ -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 {
|
||||
|
||||
@@ -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() {
|
||||
|
||||
Reference in new issue
Block a user