Офлайн-образовательная модель CVE-2026-112936 (следование по символической ссылке SQLite в filelock)
Локальная лаборатория для CVE-2026-112936 (GHSA-j8f7-rjxc-mr56): в filelock
ReadWriteLock индексировал свои экземпляры по 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 и sticky-бит этому не мешают; замена 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 в обеих
версиях; сделать это с файлом другого пользователя в sticky-каталоге требует
прав, которые лаборатория не моделирует.
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, который запускает те же сценарии с помощью модуля Python os в собственной песочнице и вычисляет ключ pre с помощью реального resolve() из pathlib; тесты на C сравнивают метки и ключи с обоими.
Модель — это не находка: см. LIMITATIONS.md и SOURCES.md. Лицензия: Apache-2.0.