diff --git a/README.md b/README.md index 649572f..e406f82 100644 --- a/README.md +++ b/README.md @@ -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`(公开默认值) | ## 已实现范围 diff --git a/src/account.rs b/src/account.rs index 10f926d..4bf49f0 100644 --- a/src/account.rs +++ b/src/account.rs @@ -78,22 +78,43 @@ pub struct AccountStore { impl AccountStore { /// 打开(或创建)账号文件;**库里没有账号时引导一个 `admin`**。 + /// + /// 🔴 引导口令是**公开默认值**(`admin`)⇒ 生产档必须用 + /// [`AccountStore::open_with_admin`] 覆盖(或事后改密)。 pub fn open(path: &Path) -> std::io::Result { + 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 { 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)); diff --git a/src/config.rs b/src/config.rs index 82cdcc6..596b813 100644 --- a/src/config.rs +++ b/src/config.rs @@ -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, 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, 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, + /// 首次启动引导的**本地管理员账号名**(`TDC_BOOTSTRAP_ADMIN_ACCOUNT`)。 + pub bootstrap_admin_account: String, + /// 首次启动引导的**本地管理员口令**(`TDC_BOOTSTRAP_ADMIN_PASSWORD`)。 + /// + /// 🔴 `None` = 未设置 ⇒ 落回公开默认值 `admin`(本地调试用) + /// ⇒ 生产档必须设(`TDC_STRICT_SECRETS=1` 会因此拒绝启动)。 + pub bootstrap_admin_password: Option, } 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"); diff --git a/src/main.rs b/src/main.rs index f85d6c6..bd62be5 100644 --- a/src/main.rs +++ b/src/main.rs @@ -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 { diff --git a/tests/account_api.rs b/tests/account_api.rs index 93be8b2..56f74db 100644 --- a/tests/account_api.rs +++ b/tests/account_api.rs @@ -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() {