نموذج تعليمي دون اتصال لـ CVE-2026-112936 (متابعة الرابط الرمزي filelock SQLite)
مختبر محلي لـ CVE-2026-112936 (GHSA-j8f7-rjxc-mr56): كان ReadWriteLock في filelock يُميّز نسخه بواسطة Path(lock_file).resolve() ويسمح لـ sqlite3.connect() بفتح مسار القفل، لذا كان يتم اتباع أي رابط رمزي مزروع في ذلك المسار: كانت العملية تُنشئ أو تقفل الملف الذي يشير إليه الرابط، وإعادة توجيه الرابط أعطت عمليتين "قفل" الكتابة على ملفات مختلفة. الإصلاح، الالتزام 4d45e83caf7e (filelock 4.0.9)، يفتح المسار باستخدام O_NOFOLLOW | O_NONBLOCK، ويرفض أي شيء ليس ملفًا عاديًا، ويحلّ المجلد الأب فقط من أجل المفتاح ويتصل بـ SQLite عبر /proc/self/fd/N. تعليمي، حتمي، C11 مُتحقَّق منه باستخدام ASan/UBSan.
لا SQLite، لا filelock، لا شبكة، لا مستخدم آخر. كل حالة تبني أسماءها
الخاصة داخل صندوق رمل جديد mkdtemp()، وتُجري الفتحتين باستدعاءات نظام حقيقية
وتزيل صندوق الرمل؛ المخرجات هي تسميات ومفاتيح نسبية لصندوق الرمل فقط.
الإسبانية: README.es.md. التمارين: PRACTICE.md.
src/filelock/_read_write.py)| سطر الفرق | الكود | المختبر |
|---|---|---|
| القديم 212، القديم 309 | pathlib.Path(lock_file).resolve() | مفتاح pre: fl_resolve (غير صارم، يتبع الروابط) |
| الجديد 224-225، الجديد 322 | pathlib.Path(_canonical(lock_file))، "حلّ المجلد الأب فقط" | مفتاح post: fl_canonical (المجلد الأب محلول، الاسم محفوظ) |
| القديم 740-746 | sqlite3.connect(database, ...) | فتح pre: بديل open(name, O_RDWR|O_CREAT|O_NONBLOCK) |
| الجديد 54-55 | _DB_OPEN_FLAGS = O_RDWR|O_CREAT|O_NOFOLLOW|O_NONBLOCK | أعلام فتح post، الوضع 0600 (الجديد 775) |
| الجديد 776-779 | if not S_ISREG(os.fstat(fd).st_mode): إغلاق، "رفض قاعدة بيانات قفل غير عادية" | REFUSED_NONREG |
| الجديد 753-765، 59 | الاحتفاظ بـ fd؛ target = f"{_FD_DIR}/{fd}" (/proc/self/fd على Linux) | إجراء reopen |
يقول GHSA إن VFS الخاص بـ SQLite يحلّ الرابط الرمزي النهائي في فضاء المستخدم، لذا فإن
fs.protected_symlinks والبت اللاصق لا يوقفانه؛ بديل pre
في المختبر يسمح للنواة باتباع الرابط بدلًا من ذلك، مما يعطي النتيجة نفسها
في صندوق رمل أحادي المستخدم. يعيش _canonical في _api.py، خارج
الفرق: يُنمذَج تعليقه فقط ("حلّ المجلد الأب فقط").
results/)| عند مسار القفل | قبل | بعد |
|---|---|---|
رابط رمزي إلى private/pwned.flag (مفقود)، أيضًا عبر سلسلة | FOLLOWED_CREATED، ملف جديد خارج مسار القفل | REFUSED_SYMLINK، لا شيء يُنشأ |
| رابط رمزي إلى ملف موجود (مطلق أو نسبي) | FOLLOWED_EXISTING، المفتاح = الهدف | REFUSED_SYMLINK، المفتاح = الرابط |
| رابط رمزي إلى FIFO / مجلد / نفسه / مجلد مفقود | OPENED_NONREG / ERR_EISDIR / ERR_ELOOP / ERR_ENOENT | REFUSED_SYMLINK |
| FIFO | OPENED_NONREG | REFUSED_NONREG |
| إعادة توجيه الرابط بين فتحتين (خطوة 3 من PoC الخاص بـ GHSA) | EXCLUSION_BROKEN، المفاتيح S/a.db و S/b.db | REFUSED |
| استبدال الرابط بعد التحقق، ثم الاتصال | REOPEN_FOLLOWED (يُفتح الاسم مرة أخرى) | REOPEN_SAME_INODE (/proc/self/fd/N) |
| ملف عادي، اسم مفقود، مجلد، مجلد أب مرتبط رمزيًا، رابط صلب | نفسه في كلا الحالتين | نفسه في كلا الحالتين |
يعبر results/sweep.csv 13 نوعًا من الكائنات عند مسار القفل. على 400
إعداد عشوائي تتحقق الاختبارات من أن post لا يُنشئ أبدًا اسمًا خارج
مسار القفل، ويرفض دائمًا رابطًا رمزيًا نهائيًا، وأنه بدون رابط رمزي نهائي
تتفق كلتا النسختين باستثناء الملفات غير العادية.
حالتان هما ملاحظتان على المختبر، وليستا اكتشافين: الرابط الصلب عند
المسار (c13) يُفتح بواسطة كلتا النسختين (O_NOFOLLOW يتعلق بالروابط الرمزية؛
fs.protected_hardlinks غير مُنمذَج)، وإعادة تسمية ملف القفل بعيدًا
وإنشاء ملف جديد بين فتحتين (s04) يقسم الـ inode في كلتا
النسختين؛ فعل ذلك بملف مستخدم آخر في مجلد لاصق يتطلب
صلاحيات لا ينمذجها المختبر.
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/fllab case pre 'F:a.db;L:lock.db>a.db' 'open:lock.db'
يحتفظ fixtures/cases.tsv بحالات إيجابية وسلبية وحالات حدّية وحالات خارج النطاق
مع تسميات مستخلصة يدويًا. يأتي fixtures/expected.tsv من
scripts/derive_expected.py، الذي يشغّل السيناريوهات نفسها باستخدام وحدة
os الخاصة بـ Python في بيئتها المعزولة الخاصة ويحسب مفتاح pre باستخدام
resolve() الحقيقي من pathlib؛ وتقارن اختبارات C التسميات والمفاتيح بكليهما.
النموذج ليس اكتشافًا: راجع LIMITATIONS.md و SOURCES.md. الترخيص: Apache-2.0.