
نموذج تعليمي دون اتصال لـ CVE-2026-26189 (حقن المصدر في envfile الخاص بـ trivy-action)
نموذج دون اتصال لـ CVE-2026-26189 (GHSA-9p44-j4g5-cfx5): كان الإجراء المركّب aquasecurity/trivy-action يكتب كل مُدخل بصيغة export NAME=<input> داخل trivy_envs.txt باستخدام echo ودون اقتباس من الصدفة، ثم كان entrypoint.sh ينفّذ source ./trivy_envs.txt، فكانت صياغة الصدفة داخل أي مُدخل تُقرأ بواسطة bash. جاء موضع الخلل مع 7aca5acc9500؛ والإصلاح، bc61dc55704e (trivy-action 0.34.0)، يكتب السطر باستخدام printf 'export %s=%q\n'. تعليمي، حتمي، بلغة C11 مُتحقَّق منها بـ ASan/UBSan. لا يُشغَّل أي action أو workflow أو runner أو Trivy؛ ولا يُكتب أي trivy_envs.txt ولا يُنفَّذ source أو تقييم لأي شيء. يبني النموذج السطر كنص، ويبيّن قارئ ساكن ما الذي ستفعله bash به.
الإسبانية: README.es.md. التمارين: PRACTICE.md.
| سطر الفرق | الكود | النموذج |
|---|---|---|
7aca5acc9500 action.yaml ctx 151/159 | shell: bash لـ "Set Trivy environment variables" | الكاتب هو bash (echo دون -e) |
| 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 إلى $2 في set_env_var_if_provided، وأي المُدخلات والقيم الافتراضية موجودة، فذلك ليس في الفروقات؛ أسماء المتغيرات في الـ fixtures مأخوذة من test/test.bats في 7aca5acc9500 (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 (نمط عنوان PR في GHSA)، 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 في كل موضع؛ وبعده لا يفعل أي منها ذلك، وتكون القيمة بعد إزالة الاقتباس مساوية دائمًا للمُدخل. في الاختبارات، كل قيمة ASCII بطول 1 و2 بايت، وكل قيمة بطول 3 بايت على أبجدية خاصة من 40 رمزًا، و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) نسختي C وPython مع تلك الـ bash على 4,051 مُدخلًا (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، وهو تطبيق Python منفصل لـ %q وللقارئ؛ وتقارن اختبارات C بكليهما.
النموذج ليس اكتشافًا: راجع LIMITATIONS.md وSOURCES.md. الترخيص: Apache-2.0.