package security // 安全模块的判据集。 // // 每条判据对应设计文档里的一条硬约束(S1–S12)。 // 纪律:**判据必须先跑通,再接内核** —— 否则接线出错时无法区分 // 「安全模块坏了」还是「接线错了」。 import ( "encoding/json" "os" "path/filepath" "strings" "testing" ) func testKey() ([]byte, error) { return []byte("0123456789abcdef0123456789abcdef"), nil } func newTestStore(t *testing.T, enabled bool) *Store { t.Helper() dir := t.TempDir() s := New(Options{ Path: filepath.Join(dir, "variables.json"), KeyFn: testKey, Enabled: enabled, }) if err := s.Load(); err != nil { t.Fatal(err) } return s } // const testToken 是一个形状合法的 GitHub token(用于触发模式库)。 const testToken = "ghp_ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789" // ★★ S3 + S11:**同明文自动合并到同一别名**(哈希键的天然性质)。 func TestSameSecretMergesToSameAlias(t *testing.T) { s := newTestStore(t, true) a1, err := s.Alias(testToken) if err != nil { t.Fatal(err) } a2, _ := s.Alias(testToken) if a1 != a2 { t.Fatalf("同一明文必须得到同一别名,实际 %s vs %s", a1, a2) } // 别名形态:sec_ + 16 hex = 20 字符 if !strings.HasPrefix(a1, AliasPrefix) || len(a1) != 20 { t.Errorf("别名形态异常: %q (len=%d)", a1, len(a1)) } // 不同明文 ⇒ 不同别名 other, _ := s.Alias("ghp_ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ") if other == a1 { t.Error("不同明文不应合并") } } // ★★ S3:别名必须**依赖主密钥**(即 HMAC,不是裸哈希)。 // // 裸哈希可被字典枚举(实测 hunter2 当场命中),而别名会进上下文/日志/记忆。 func TestAliasDependsOnMasterKey(t *testing.T) { s1 := New(Options{Path: filepath.Join(t.TempDir(), "a.json"), KeyFn: testKey, Enabled: true}) other := func() ([]byte, error) { return []byte("ffffffffffffffffffffffffffffffff"), nil } s2 := New(Options{Path: filepath.Join(t.TempDir(), "b.json"), KeyFn: other, Enabled: true}) a1, _ := s1.Alias("same-plain") a2, _ := s2.Alias("same-plain") if a1 == a2 { t.Fatal("不同主密钥必须产出不同别名(否则说明用了裸哈希)") } } // ★ 判据:裸哈希可被字典枚举 —— 用真实数据证明 HMAC 的必要性。 // // 这条不是测代码,而是**固化设计依据**:若有天有人把 HMAC 换成裸 SHA256, // 这条判据会连同其注释一起提醒他为什么不行。 func TestBareHashIsEnumerable(t *testing.T) { // 攻击者视角:拿到别名(裸哈希前 16 hex),拿常见弱口令字典去试 weak := "hunter2" sum := sha256Hex16(weak) // 字典命中(一行代码就够) hit := false for _, g := range []string{"password123", "admin", "letmein", "hunter2", "secret"} { if sha256Hex16(g) == sum { hit = true } } if !hit { t.Fatal("本判据的前提失效(裸哈希应可被字典命中)") } // 而 HMAC 版本:没有 key 无法枚举 s := newTestStore(t, true) a, _ := s.Alias(weak) if a == AliasPrefix+sum { t.Fatal("别名用了裸哈希 —— 会泄露 secret 内容") } t.Logf("裸哈希(危险): %s%s ;HMAC(当前实现): %s", AliasPrefix, sum, a) } // ★★ S1 + 插件无感知:拦截把明文换成别名,稍后能用别名换回(回填)。 func TestReplaceThenFill(t *testing.T) { s := newTestStore(t, true) text := "我的 token 是 " + testToken + " 请使用" out, evts := s.Replace(text, "input", Patterns) if strings.Contains(out, testToken) { t.Fatalf("明文未被替换: %s", out) } if !strings.Contains(out, "安全模块自动拦截") { t.Errorf("缺少拦截提示: %s", out) } if len(evts) != 1 { t.Fatalf("应恰好 1 条拦截事件,实际 %d", len(evts)) } alias := evts[0].Alias if !strings.Contains(out, "@{"+alias+"}") { t.Errorf("提示里应含 @{%s}: %s", alias, out) } // ★ 回填:把别名换回明文(这是插件能用密钥的唯一通道) back, n, used := s.Fill("Authorization: token @{" + alias + "}") if n != 1 { t.Fatalf("应回填 1 处,实际 %d", n) } if !strings.Contains(back, testToken) { t.Fatalf("回填未生效: %s", back) } if len(used) != 1 || used[0] != alias { t.Errorf("应报告用到的别名: %v", used) } } // ★★ S4:**不可误伤** —— 正常文本绝不能被替换。 // // 误报比漏报严重得多:它会把正常内容换掉、把任务搞坏,且归因极难。 func TestNoFalsePositives(t *testing.T) { s := newTestStore(t, true) benign := []string{ "请修复这个 bug,提交到 feat/login 分支", "git commit -m 'add feature'", "https://github.com/JianFeeeee/HologramAgent/pull/42", "这个函数返回 404 或者 500", "hex 颜色 #4f46e5 很好看", // ★ 关键:40 位 git SHA-1 不得被误伤(否则 agent 拿不到 commit id) "commit 9f86d081884c7d659a2feaa0c55ad015a3bf4f1b", "版本号 v1.2.3", "文件 /home/program/TrueAgent/docs/zh/kernel-secret-firewall-design.md", "时间戳 2026-10-14T17:27:16+08:00", "UUID 550e8400-e29b-41d4-a716-446655440000", "讨论一下 secret 管理和 token 轮换的策略", // 含关键词但不是赋值形态 "password 字段的长度校验有问题", // 同上 } for _, s0 := range benign { out, evts := s.Replace(s0, "input", Patterns) if len(evts) > 0 { t.Errorf("误伤正常文本 %q → %v", s0, evts) } if out != s0 { t.Errorf("未命中却改动了文本: %q → %q", s0, out) } } } // 各类凭据形状都要能识别(覆盖面)。 func TestRecognizesCommonShapes(t *testing.T) { s := newTestStore(t, true) cases := []struct{ name, text string }{ {"github", testToken}, {"gitlab", "glpat-FAKE-TEST-TOKEN-NOT-REAL"}, {"openai", "sk-FAKE-TEST-KEY-NOT-REAL-0000000"}, {"anthropic", "sk-ant-FAKE-TEST-KEY-NOT-REAL-00"}, {"aws", "AKIA0000FAKE0000TEST"}, {"slack", "xoxb-FAKE-TEST-TOKEN-NOT-REAL"}, {"assignment", `api_key = "FAKE-TEST-ASSIGNED-VALUE-000"`}, {"bearer", "Authorization: Bearer FAKE-TEST-BEARER-TOKEN-NOT-REAL"}, } for _, c := range cases { _, evts := s.Replace(c.text, "input", Patterns) if len(evts) == 0 { t.Errorf("%s 形状未被识别: %q", c.name, c.text) } } } // ★ 判据:赋值形态保留键名(否则人看不懂发生了什么)。 func TestAssignmentKeepsKeyName(t *testing.T) { s := newTestStore(t, true) out, evts := s.Replace(`api_key = "FAKE-TEST-ASSIGNED-VALUE-000"`, "input", Patterns) if len(evts) == 0 { t.Fatal("未命中") } if !strings.Contains(out, "api_key") { t.Errorf("应保留键名: %s", out) } } // ★ S1:**不提供取回明文的接口**(看值只能靠回填)。 // // 这条是防回归:若有人加了 Get/Reveal 之类的方法,判据通过编译期就能发现。 func TestNoPlaintextReadAPI(t *testing.T) { // 语义判据:List() 只给元信息;明文只能经 Fill 出现在"待发送的文本"里 s := newTestStore(t, true) alias, err := s.Submit(testToken, "测试") if err != nil { t.Fatal(err) } infos := s.List() if len(infos) != 1 { t.Fatalf("应有 1 条记录,实际 %d", len(infos)) } b, _ := json.Marshal(infos) if strings.Contains(string(b), testToken) { t.Fatalf("List 泄露了明文: %s", b) } if !strings.Contains(string(b), alias) { t.Error("List 应给出别名") } } // ★★ 落盘:明文绝不落盘,且文件必须 0600。 func TestPersistsCiphertextOnlyWith0600(t *testing.T) { s := newTestStore(t, true) if _, err := s.Submit(testToken, "落盘测试"); err != nil { t.Fatal(err) } b, err := os.ReadFile(s.path) if err != nil { t.Fatal(err) } if strings.Contains(string(b), testToken) { t.Fatalf("磁盘文件出现明文: %s", b) } if fi, err := os.Stat(s.path); err == nil { if fi.Mode().Perm() != 0o600 { t.Errorf("变量库权限应为 0600,实际 %04o", fi.Mode().Perm()) } } else { t.Fatal(err) } } // ★ 判据:权限不安全的变量库**拒绝加载**(响亮失败,不静默降级)。 func TestRejectsLoosePermissions(t *testing.T) { dir := t.TempDir() p := filepath.Join(dir, "v.json") if err := os.WriteFile(p, []byte("[]"), 0o644); err != nil { t.Fatal(err) } s := New(Options{Path: p, KeyFn: testKey, Enabled: true}) if err := s.Load(); err == nil { t.Fatal("0644 的变量库必须被拒绝") } if err := os.Chmod(p, 0o600); err != nil { t.Fatal(err) } if err := s.Load(); err != nil { t.Fatalf("0600 应可加载: %v", err) } } // ★ 持久化往返:重启后别名仍可用(用户要求落盘 + 不自动淘汰)。 func TestReloadKeepsVariables(t *testing.T) { dir := t.TempDir() p := filepath.Join(dir, "v.json") s1 := New(Options{Path: p, KeyFn: testKey, Enabled: true}) if err := s1.Load(); err != nil { t.Fatal(err) } alias, err := s1.Submit(testToken, "重启测试") if err != nil { t.Fatal(err) } // 模拟重启 s2 := New(Options{Path: p, KeyFn: testKey, Enabled: true}) if err := s2.Load(); err != nil { t.Fatal(err) } out, n, _ := s2.Fill("x=@{" + alias + "}") if n != 1 || !strings.Contains(out, testToken) { t.Fatalf("重启后别名应仍可用: n=%d out=%q", n, out) } } // ★ S12:不自动淘汰,但 agent 可**主动删除**。 func TestForgetRemovesVariable(t *testing.T) { s := newTestStore(t, true) alias, _ := s.Submit(testToken, "") if err := s.Forget(alias); err != nil { t.Fatalf("删除失败: %v", err) } out, n, _ := s.Fill("x=@{" + alias + "}") if n != 0 || strings.Contains(out, testToken) { t.Fatalf("删除后不应再回填: %q", out) } if err := s.Forget(alias); err != ErrUnknownAlias { t.Errorf("重复删除应返回 ErrUnknownAlias,实际 %v", err) } } // ★ 判据:拿不到密钥 ⇒ **拒绝产出别名**(宁可漏报,不用裸哈希)。 // // 这里要**直接测 `Alias()`**,不能只测 Replace: // Replace 里另有一道外层护栏(无密钥就整体早退),会把 Alias 层的降级 // 挡住 —— 变异实验证实了这一点(只测 Replace 时,把 Alias 改成裸哈希降级 // 判据仍绿)。纵深防御是对的,但两层必须各自有判据盯着。 func TestNoKeyMeansNoAlias(t *testing.T) { s := New(Options{Path: filepath.Join(t.TempDir(), "v.json"), KeyFn: nil, Enabled: true}) // ① Alias() 本身必须报错(不降级为裸哈希) if a, err := s.Alias("anything"); err != ErrNoMasterKey { t.Errorf("无密钥时 Alias 应返回 ErrNoMasterKey,实际 alias=%q err=%v", a, err) } // ② Submit() 也必须失败(不静默记个裸哈希别名) if a, err := s.Submit(testToken, ""); err == nil { t.Errorf("无密钥时 Submit 应失败,实际得到 %q", a) } // ③ outer guard:Replace 原样返回 out, evts := s.Replace("token="+testToken, "input", Patterns) if len(evts) != 0 { t.Fatal("无密钥时不得产出别名") } if out != "token="+testToken { t.Errorf("无密钥时应原样保留: %s", out) } // ④ Fill 也应安全降级(不 panic、不改动) if got, n, _ := s.Fill("@{sec_x}"); n != 0 || got != "@{sec_x}" { t.Errorf("无密钥时 Fill 应原样返回: %q", got) } // ⑤ 密钥长度不对也必须拒绝(AES-256 要 32 字节) bad := New(Options{Path: filepath.Join(t.TempDir(), "w.json"), KeyFn: func() ([]byte, error) { return []byte("too-short"), nil }, Enabled: true}) if _, err := bad.Alias("x"); err == nil { t.Error("密钥长度不对时必须报错") } } // ★ 开关:关闭后完全不做事(显式才是特权)。 func TestDisabledDoesNothing(t *testing.T) { s := newTestStore(t, false) out, evts := s.Replace("token="+testToken, "input", Patterns) if len(evts) != 0 || out != "token="+testToken { t.Error("关闭后不应做任何替换") } } // ★ FillMap:工具参数是 map,要能递归回填(插件调用前用)。 func TestFillMapRecursive(t *testing.T) { s := newTestStore(t, true) alias, _ := s.Submit(testToken, "") args := map[string]interface{}{ "url": "https://" + "@{" + alias + "}" + "@host/repo", "nested": map[string]interface{}{ "token": "@{" + alias + "}", }, "list": []interface{}{"plain", "@{" + alias + "}"}, "num": 42, } n, used := s.FillMap(args) if n != 3 { t.Fatalf("应回填 3 处,实际 %d", n) } if len(used) != 3 { t.Errorf("应报告 3 次使用: %v", used) } if !strings.Contains(args["url"].(string), testToken) { t.Error("顶层未回填") } if !strings.Contains(args["nested"].(map[string]interface{})["token"].(string), testToken) { t.Error("嵌套 map 未回填") } if !strings.Contains(args["list"].([]interface{})[1].(string), testToken) { t.Error("数组未回填") } if args["num"].(int) != 42 { t.Error("非字符串值不应被改动") } } // ★ 未知别名:原样保留(不报错、不吞掉),以免把正常文本改坏。 func TestFillKeepsUnknownAlias(t *testing.T) { s := newTestStore(t, true) in := "看看 @{sec_notexist} 和 @{sec_0000000000000000}" out, n, _ := s.Fill(in) if n != 0 { t.Fatalf("未知别名不应被替换,实际 %d", n) } if out != in { t.Errorf("未知别名应原样保留: %q", out) } // 不像引用的文本也不该被碰 out2, n2, _ := s.Fill("普通文本 @{bad-name!} 与 email@example.com") if n2 != 0 || out2 != "普通文本 @{bad-name!} 与 email@example.com" { t.Errorf("非引用文本被改动: %q", out2) } } // ★ 拦截事件是**可观测**的(S5,不静默做事),且 merged 标明是否合并。 func TestInterceptEventsObservable(t *testing.T) { s := newTestStore(t, true) _, e1 := s.Replace("a="+testToken, "input", Patterns) _, e2 := s.Replace("b="+testToken, "tool_result:cmd_run", Patterns) if len(e1) != 1 || len(e2) != 1 { t.Fatal("两次都应各产生 1 条事件") } if e1[0].Merged { t.Error("首次应 merged=false") } if !e2[0].Merged { t.Error("第二次同明文应 merged=true(合并)") } if e1[0].Alias != e2[0].Alias { t.Error("同明文应同一别名") } if e2[0].Where != "tool_result:cmd_run" { t.Errorf("应记录来源位置: %q", e2[0].Where) } } // ★ 判据:明文(高熵)不得从**别名**反推出来。 // // 这是 HMAC + 截断的性质,用抽样验证(不是穷举证明,而是防低级错误)。 func TestAliasDoesNotLeakPlaintext(t *testing.T) { s := newTestStore(t, true) alias, _ := s.Alias(testToken) // 别名里不能包含明文的任何连续 8 字符片段 for i := 0; i+8 <= len(testToken); i++ { if strings.Contains(alias, testToken[i:i+8]) { t.Fatalf("别名泄露了明文片段: %s", alias) } } } func sha256Hex16(s string) string { h := sha256Sum([]byte(s)) return hexEncode(h[:8]) }