@leeruu/agentguard 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +202 -0
- package/README.md +297 -2
- package/dist/audit/query.js +151 -0
- package/dist/audit/writer.js +174 -0
- package/dist/cli.js +624 -0
- package/dist/demo.js +246 -0
- package/dist/errors.js +28 -0
- package/dist/format.js +29 -0
- package/dist/limits.js +42 -0
- package/dist/logger.js +46 -0
- package/dist/main.js +239 -0
- package/dist/packs.js +51 -0
- package/dist/policy/bootstrap.js +127 -0
- package/dist/policy/decide.js +41 -0
- package/dist/policy/glob.js +80 -0
- package/dist/policy/load.js +203 -0
- package/dist/policy/match.js +431 -0
- package/dist/policy/types.js +15 -0
- package/dist/proxy.js +440 -0
- package/package.json +59 -4
- package/packs/core.yaml +104 -0
- package/packs/git.yaml +43 -0
- package/packs/net.yaml +48 -0
- package/packs/secrets.yaml +120 -0
package/packs/net.yaml
ADDED
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
version: 1
|
|
2
|
+
|
|
3
|
+
# net · 误触内网与付费接口(有线上业务时再加)
|
|
4
|
+
#
|
|
5
|
+
# 这些规则的共同点是「一次误触的代价不可逆」:打到生产内网、扣一次钱。
|
|
6
|
+
# 因此用 ask(当前实现 = 明确拒绝),而不是 allow 后再补救。
|
|
7
|
+
#
|
|
8
|
+
# 明确不覆盖:「生产域名白名单外」需要 allowlist 语义(DSL 目前只有逐条 deny/allow),
|
|
9
|
+
# 写死的域名列表很快就会过期,留给后续版本。
|
|
10
|
+
|
|
11
|
+
rules:
|
|
12
|
+
- id: net-internal-address-command
|
|
13
|
+
match:
|
|
14
|
+
tool: [bash, shell, run_command, execute_command, terminal, powershell]
|
|
15
|
+
args.command:
|
|
16
|
+
regex: '\b(?:10\.\d{1,3}\.\d{1,3}\.\d{1,3}|192\.168\.\d{1,3}\.\d{1,3}|172\.(?:1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3})\b'
|
|
17
|
+
decision: ask
|
|
18
|
+
reason: 访问内网地址(可能是生产环境)
|
|
19
|
+
|
|
20
|
+
- id: net-internal-address-url
|
|
21
|
+
match:
|
|
22
|
+
tool: [fetch, web_fetch, http_request, http_get, curl, browser_navigate]
|
|
23
|
+
args.url:
|
|
24
|
+
regex: '\b(?:10\.\d{1,3}\.\d{1,3}\.\d{1,3}|192\.168\.\d{1,3}\.\d{1,3}|172\.(?:1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3})\b'
|
|
25
|
+
decision: ask
|
|
26
|
+
reason: 访问内网地址(可能是生产环境)
|
|
27
|
+
|
|
28
|
+
- id: net-payment-api-command
|
|
29
|
+
match:
|
|
30
|
+
tool: [bash, shell, run_command, execute_command, terminal, powershell]
|
|
31
|
+
args.command:
|
|
32
|
+
regex: '(?:api\.stripe\.com/v1/(?:charges|refunds|payouts|transfers)|api\.paypal\.com/v1/payments|\bstripe\s+(?:charges|refunds|payouts|transfers)\s+(?:create|refund))'
|
|
33
|
+
decision: ask
|
|
34
|
+
reason: 调用支付类接口(可能真的扣钱)
|
|
35
|
+
|
|
36
|
+
- id: net-payment-api-url
|
|
37
|
+
match:
|
|
38
|
+
tool: [fetch, web_fetch, http_request, http_post, curl]
|
|
39
|
+
args.url:
|
|
40
|
+
regex: '(?:api\.stripe\.com/v1/(?:charges|refunds|payouts|transfers)|api\.paypal\.com/v1/payments)'
|
|
41
|
+
decision: ask
|
|
42
|
+
reason: 调用支付类接口(可能真的扣钱)
|
|
43
|
+
|
|
44
|
+
# 单窗口调用上限:防的是「逻辑 bug 导致循环调用」这类烧钱事故,不是防人
|
|
45
|
+
limits:
|
|
46
|
+
- tool: [bash, shell, run_command, execute_command]
|
|
47
|
+
max_calls: 200
|
|
48
|
+
window: 1h
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
version: 1
|
|
2
|
+
|
|
3
|
+
# secrets · 凭据泄漏(默认必装)
|
|
4
|
+
#
|
|
5
|
+
# 覆盖三类泄漏路径:
|
|
6
|
+
# 1. agent 直接读凭据文件
|
|
7
|
+
# 2. agent 访问云元数据端点拿临时凭据
|
|
8
|
+
# 3. agent 把密钥内容发/写到外部(issue、PR、消息、HTTP body)
|
|
9
|
+
#
|
|
10
|
+
# 明确不覆盖(架构限制,见 README):**工具返回值里含密钥**这种情况。
|
|
11
|
+
# 代理只判定请求,不看响应 —— 要做需要在响应方向加规则引擎,留到后续。
|
|
12
|
+
|
|
13
|
+
rules:
|
|
14
|
+
# ── 1. 读凭据文件 ─────────────────────────────────────────────────
|
|
15
|
+
# .env 家族用 regex 而不是 glob:要排除 .env.example / .env.sample / .env.template
|
|
16
|
+
# 这些模板文件本来就要读。deny 压过 allow,写成 glob 就再也没有办法放行它们了。
|
|
17
|
+
# 同时要兼容 Windows 反斜杠路径,所以分隔符写成 [/\\]。
|
|
18
|
+
- id: secrets-read-env
|
|
19
|
+
match:
|
|
20
|
+
tool: [read_file, read_text_file, read_multiple_files, view_file, open_file]
|
|
21
|
+
args.path:
|
|
22
|
+
regex: '(?:^|[/\\])\.env(?:\.(?!example$|sample$|template$)[A-Za-z0-9_-]+)*$'
|
|
23
|
+
decision: deny
|
|
24
|
+
reason: 敏感凭据文件(.env)
|
|
25
|
+
|
|
26
|
+
- id: secrets-read-key-file
|
|
27
|
+
match:
|
|
28
|
+
tool: [read_file, read_text_file, read_multiple_files, view_file, open_file]
|
|
29
|
+
args.path:
|
|
30
|
+
glob:
|
|
31
|
+
- '**/*.pem'
|
|
32
|
+
- '**/*.key'
|
|
33
|
+
- '**/id_rsa*'
|
|
34
|
+
- '**/id_ed25519*'
|
|
35
|
+
- '**/id_ecdsa*'
|
|
36
|
+
- '**/.aws/credentials'
|
|
37
|
+
- '**/.npmrc'
|
|
38
|
+
- '**/.netrc'
|
|
39
|
+
- '**/.git-credentials'
|
|
40
|
+
- '**/*.p12'
|
|
41
|
+
- '**/*.pfx'
|
|
42
|
+
decision: deny
|
|
43
|
+
reason: 敏感凭据文件(私钥 / 云凭据)
|
|
44
|
+
|
|
45
|
+
# read_multiple_files 用的是 paths(复数)—— 方案示例里的 args.path 对真实 server 不生效
|
|
46
|
+
- id: secrets-read-multiple-env
|
|
47
|
+
match:
|
|
48
|
+
tool: [read_multiple_files]
|
|
49
|
+
args.paths:
|
|
50
|
+
regex: '(?:^|[/\\])\.env(?:\.(?!example$|sample$|template$)[A-Za-z0-9_-]+)*$'
|
|
51
|
+
decision: deny
|
|
52
|
+
reason: 批量读取中包含 .env
|
|
53
|
+
|
|
54
|
+
- id: secrets-read-multiple-key
|
|
55
|
+
match:
|
|
56
|
+
tool: [read_multiple_files]
|
|
57
|
+
args.paths:
|
|
58
|
+
glob:
|
|
59
|
+
- '**/*.pem'
|
|
60
|
+
- '**/*.key'
|
|
61
|
+
- '**/id_rsa*'
|
|
62
|
+
- '**/id_ed25519*'
|
|
63
|
+
- '**/.aws/credentials'
|
|
64
|
+
- '**/.npmrc'
|
|
65
|
+
- '**/.netrc'
|
|
66
|
+
- '**/.git-credentials'
|
|
67
|
+
decision: deny
|
|
68
|
+
reason: 批量读取中包含私钥或云凭据
|
|
69
|
+
|
|
70
|
+
# ── 2. 云元数据端点 ───────────────────────────────────────────────
|
|
71
|
+
- id: secrets-cloud-metadata-command
|
|
72
|
+
match:
|
|
73
|
+
tool: [bash, shell, run_command, execute_command, terminal, powershell]
|
|
74
|
+
args.command:
|
|
75
|
+
regex: '169\.254\.169\.254'
|
|
76
|
+
decision: deny
|
|
77
|
+
reason: 访问云实例元数据端点(可换取临时凭据)
|
|
78
|
+
|
|
79
|
+
- id: secrets-cloud-metadata-url
|
|
80
|
+
match:
|
|
81
|
+
tool: [fetch, web_fetch, http_request, http_get, curl, browser_navigate]
|
|
82
|
+
args.url:
|
|
83
|
+
regex: '169\.254\.169\.254'
|
|
84
|
+
decision: deny
|
|
85
|
+
reason: 访问云实例元数据端点(可换取临时凭据)
|
|
86
|
+
|
|
87
|
+
# ── 3. 把疑似密钥写进外发内容 ─────────────────────────────────────
|
|
88
|
+
# 只覆盖常见外发字段。字段名的多样性是这类规则最脆弱的地方,
|
|
89
|
+
# 写错字段不会报错但永不命中,所以宁可多列几个。
|
|
90
|
+
- id: secrets-leak-body
|
|
91
|
+
match:
|
|
92
|
+
tool: [create_issue, create_pull_request, post_message, send_message, http_request, fetch, web_fetch, create_comment, update_issue]
|
|
93
|
+
args.body:
|
|
94
|
+
regex: '(?:\bsk-[A-Za-z0-9_-]{20,}|AKIA[0-9A-Z]{16}|gh[pousr]_[A-Za-z0-9]{20,}|xox[abprs]-[A-Za-z0-9-]{10,}|-----BEGIN [A-Z ]*PRIVATE KEY-----)'
|
|
95
|
+
decision: deny
|
|
96
|
+
reason: 外发内容中疑似包含密钥
|
|
97
|
+
|
|
98
|
+
- id: secrets-leak-content
|
|
99
|
+
match:
|
|
100
|
+
tool: [create_issue, create_pull_request, post_message, send_message, http_request, fetch, web_fetch, create_comment, update_issue]
|
|
101
|
+
args.content:
|
|
102
|
+
regex: '(?:\bsk-[A-Za-z0-9_-]{20,}|AKIA[0-9A-Z]{16}|gh[pousr]_[A-Za-z0-9]{20,}|xox[abprs]-[A-Za-z0-9-]{10,}|-----BEGIN [A-Z ]*PRIVATE KEY-----)'
|
|
103
|
+
decision: deny
|
|
104
|
+
reason: 外发内容中疑似包含密钥
|
|
105
|
+
|
|
106
|
+
- id: secrets-leak-text
|
|
107
|
+
match:
|
|
108
|
+
tool: [create_issue, create_pull_request, post_message, send_message, http_request, fetch, web_fetch, create_comment, update_issue]
|
|
109
|
+
args.text:
|
|
110
|
+
regex: '(?:\bsk-[A-Za-z0-9_-]{20,}|AKIA[0-9A-Z]{16}|gh[pousr]_[A-Za-z0-9]{20,}|xox[abprs]-[A-Za-z0-9-]{10,}|-----BEGIN [A-Z ]*PRIVATE KEY-----)'
|
|
111
|
+
decision: deny
|
|
112
|
+
reason: 外发内容中疑似包含密钥
|
|
113
|
+
|
|
114
|
+
- id: secrets-leak-description
|
|
115
|
+
match:
|
|
116
|
+
tool: [create_issue, create_pull_request, post_message, send_message, http_request, fetch, web_fetch, create_comment, update_issue]
|
|
117
|
+
args.description:
|
|
118
|
+
regex: '(?:\bsk-[A-Za-z0-9_-]{20,}|AKIA[0-9A-Z]{16}|gh[pousr]_[A-Za-z0-9]{20,}|xox[abprs]-[A-Za-z0-9-]{10,}|-----BEGIN [A-Z ]*PRIVATE KEY-----)'
|
|
119
|
+
decision: deny
|
|
120
|
+
reason: 外发内容中疑似包含密钥
|