CVE-2026-26189 的离线教学模型(trivy-action envfile 源注入)
CVE-2026-26189(GHSA-9p44-j4g5-cfx5)的离线模型:复合 action aquasecurity/trivy-action 使用 echo 将每个输入写为 export NAME=<input> 到 trivy_envs.txt,且没有进行 shell 引号处理,随后 entrypoint.sh 执行了 source ./trivy_envs.txt,因此输入中的 shell 语法会被 bash 读取。该 sink 随 7aca5acc9500 引入;修复版本 bc61dc55704e(trivy-action 0.34.0)使用 printf 'export %s=%q\n' 写入该行。教育用途、确定性、使用 ASan/UBSan 检查的 C11。不运行任何 action、workflow、runner 或 Trivy;不写入 trivy_envs.txt,也不进行任何 source 或求值。 该模型将该行构建为字符串,并由静态读取器说明 bash 会如何处理它。
西班牙语:README.es.md。练习:PRACTICE.md。
| Diff 行 | 代码 | 模型 |
|---|---|---|
7aca5acc9500 action.yaml ctx 151/159 | "Set Trivy environment variables" 的 shell: bash | 写入器是 bash(不带 -e 的 echo) |
| bc61dc55704e old 186 / new 186 | [ ! -z "$input_value" ] -> [ -n "$input_value" ]、!= "$default_value" | NOT_WRITTEN(修复前后答案相同) |
| 7aca5acc9500 new 184 = bc61dc55704e old 188 | echo "export $var_name=$input_value" >> trivy_envs.txt | pre 行 |
| bc61dc55704e new 189 | printf 'export %s=%q\n' "$var_name" "$input_value" >> trivy_envs.txt | post 行,src/bash_q.c |
7aca5acc9500 entrypoint.sh new 8-9 | if [ -f ./trivy_envs.txt ]; then source ./trivy_envs.txt | src/bread.c 读取该行 |
GHSA 指出了相同的调用点(action.yaml:188、entrypoint.sh:9)。每个 action 输入如何到达 set_env_var_if_provided 的 $2,以及存在哪些输入和默认值,不在 diff 中;fixtures 中的变量名来自 7aca5acc9500 的 test/test.bats(new 158-161),默认值是合成的。
标签,按优先级顺序:NOT_WRITTEN、BAD_INPUT、SYNTAX_ERROR、CMD_SUBST、CONTROL_OP(; & | ( ) 或后续行)、REDIRECT、EXPANSION($name、${..}、$[..])、TILDE、BRACE、WORD_SPLIT、VALUE_CHANGED(单个词,但不是输入)、LITERAL。
results/)| 输入 | pre | post |
|---|---|---|
trivy-$(id).sarif(GHSA 的 PR 标题模式)、trivy-`id`.sarif | CMD_SUBST | LITERAL |
a;id、a\nid、a|id、a&&id | CONTROL_OP | LITERAL |
a>f、a<f | REDIRECT | LITERAL |
$HOME、x${PATH}、$[1] | EXPANSION | LITERAL |
~、a:~/x / {a,b}、x{1..3} | TILDE / BRACE | LITERAL |
a b、a\tb / a 'b、' / "a"、a\b、a #c | WORD_SPLIT / SYNTAX_ERROR / VALUE_CHANGED | LITERAL |
image.sarif、CRITICAL,HIGH、knqyf263/vuln-image:1.2.3、a=~、a* | LITERAL | LITERAL |
| 空,或等于默认值 | NOT_WRITTEN | NOT_WRITTEN |
results/sweep.csv 单独尝试每个字节 0x01-0x7f,以及在 a 和 b 之间尝试:修复前,每个位置有 15 个字节会离开 LITERAL;修复后,没有字节会这样,且去引号后的值始终等于输入。在测试中,每个 1 字节和 2 字节 ASCII 值、在 40 个符号的特殊字母表上的每个 3 字节值,以及 60,000 个生成值,在修复后都给出 LITERAL。
src/bash_q.c 重述了本地 GNU bash 5.2.37 对 printf %q 的输出,仅限 ASCII:空值输出 '';如果任何字节是控制字节,整个值变为 $'...'(\a \b \t \n \v \f \r \E、\\、\',其他控制字节为三位八进制);否则在 space ! " $ & ' ( ) * , ; < > ? [ \ ] ^ ` { | } 前加反斜杠,在开头或 = 或 : 之后的 ~ 前加反斜杠,以及在开头的 # 前加反斜杠。
scripts/crosscheck_bash.sh(本地运行,不在 CI 中)在 4,051 个输入上将 C 和 Python 版本与该 bash 进行比较(0 差异),仅将值作为参数传递给 printf %q,并对这些行运行 bash -n(仅解析)。
sh scripts/build.sh test # -Wall -Wextra -Werror, ASan + UBSan
python3 scripts/derive_expected.py | diff - fixtures/expected.tsv
sh scripts/build.sh results /tmp/r && diff -r results /tmp/r
./build/trvenv case pre TRIVY_OUTPUT 'a;id' # prints the line; runs nothing
python3 scripts/crosscheck_labels.py build/trvenv # C vs Python, 4,051 inputs
fixtures/cases.tsv 保存正向、负向、边界和域外用例,其标签由人工推导得出。fixtures/expected.tsv 来自 scripts/derive_expected.py,这是 %q 和读取器的独立 Python 实现;C 测试会同时与两者进行比对。
模型并不等同于发现:参见 LIMITATIONS.md 和 SOURCES.md。许可证:Apache-2.0。