Offline-Lernmodell zu CVE-2026-112936 (filelock SQLite-Symlink-Follow)
Lokales Labor für CVE-2026-112936 (GHSA-j8f7-rjxc-mr56): filelock's
ReadWriteLock keyed seine Instanzen nach Path(lock_file).resolve() und ließ
sqlite3.connect() den Lock-Pfad öffnen, sodass ein an diesem Pfad platzierter Symlink
gefolgt wurde: Der Prozess erstellte oder sperrte die Datei, auf die der Link zeigte,
und das Umleiten des Links gab zwei Prozessen „den" Schreib-Lock auf verschiedene
Dateien. Der Fix, Commit 4d45e83caf7e (filelock 4.0.9), öffnet den Pfad mit
O_NOFOLLOW | O_NONBLOCK, lehnt alles ab, was keine reguläre Datei ist,
löst nur das Elternverzeichnis für den Schlüssel auf und verbindet SQLite über
/proc/self/fd/N. Lehrreich, deterministisch, C11 geprüft mit ASan/UBSan.
Kein SQLite, kein filelock, kein Netzwerk, kein anderer Benutzer. Jeder Fall baut seine
eigenen Namen in einer frischen mkdtemp()-Sandbox auf, führt die beiden Opens mit echten
Syscalls aus und entfernt die Sandbox; die Ausgabe besteht nur aus Labels und sandbox-relativen
Schlüsseln.
Spanisch: README.es.md. Übungen: PRACTICE.md.
src/filelock/_read_write.py)| Diff-Zeile | Code | Labor |
|---|---|---|
| alt 212, alt 309 | pathlib.Path(lock_file).resolve() | pre-Schlüssel: fl_resolve (nicht strikt, folgt Links) |
| neu 224-225, neu 322 | pathlib.Path(_canonical(lock_file)), „nur das Elternverzeichnis auflösen" | post-Schlüssel: fl_canonical (Elternverzeichnis aufgelöst, Name beibehalten) |
| alt 740-746 | sqlite3.connect(database, ...) | pre-Open: open(name, O_RDWR|O_CREAT|O_NONBLOCK)-Ersatz |
| neu 54-55 | _DB_OPEN_FLAGS = O_RDWR|O_CREAT|O_NOFOLLOW|O_NONBLOCK | post-Open-Flags, Modus 0600 (neu 775) |
| neu 776-779 | if not S_ISREG(os.fstat(fd).st_mode): schließen, „Ablehnung einer nicht regulären Lock-Datenbank" | REFUSED_NONREG |
| neu 753-765, 59 | den fd halten; target = f"{_FD_DIR}/{fd}" (/proc/self/fd unter Linux) | reopen-Aktion |
Die GHSA besagt, dass SQLites VFS den finalen Symlink im Userspace auflöst, sodass
fs.protected_symlinks und das Sticky-Bit dies nicht verhindern; der pre-Ersatz
des Labors lässt stattdessen den Kernel dem Link folgen, was im
Single-User-Sandbox dasselbe Ergebnis liefert. _canonical lebt in _api.py, außerhalb
des Diffs: nur sein Kommentar („nur das Elternverzeichnis auflösen") wird modelliert.
results/)| Am Lock-Pfad | vorher | nachher |
|---|---|---|
Symlink auf private/pwned.flag (fehlend), auch über eine Kette | FOLLOWED_CREATED, eine neue Datei außerhalb des Lock-Pfads | REFUSED_SYMLINK, nichts erstellt |
| Symlink auf eine existierende Datei (absolut oder relativ) | FOLLOWED_EXISTING, Schlüssel = das Ziel | REFUSED_SYMLINK, Schlüssel = der Link |
| Symlink auf eine FIFO / ein Verzeichnis / sich selbst / ein fehlendes Verzeichnis | OPENED_NONREG / ERR_EISDIR / ERR_ELOOP / ERR_ENOENT | REFUSED_SYMLINK |
| FIFO | OPENED_NONREG | REFUSED_NONREG |
| Link zwischen zwei Opens umgeleitet (GHSA-PoC-Schritt 3) | EXCLUSION_BROKEN, Schlüssel S/a.db und S/b.db | REFUSED |
| Link nach der Validierung ersetzt, dann verbinden | REOPEN_FOLLOWED (der Name wird erneut geöffnet) | REOPEN_SAME_INODE (/proc/self/fd/N) |
| reguläre Datei, fehlender Name, Verzeichnis, symlinktes Elternverzeichnis, Hardlink | in beiden gleich | in beiden gleich |
results/sweep.csv durchläuft 13 Arten von Objekten am Lock-Pfad. Bei 400
zufälligen Setups prüfen die Tests, dass post niemals einen Namen außerhalb des
Lock-Pfads erstellt, stets einen finalen Symlink ablehnt und dass ohne finalen Symlink
beide Versionen übereinstimmen, außer bei nicht regulären Dateien.
Zwei Fälle sind Beobachtungen des Labors, keine Befunde: ein Hardlink am
Pfad (c13) wird von beiden Versionen geöffnet (O_NOFOLLOW betrifft Symlinks;
fs.protected_hardlinks wird nicht modelliert), und das Umbenennen der Lock-Datei weg
und das Erstellen einer neuen zwischen zwei Opens (s04) spaltet den Inode in beiden
Versionen; dies bei der Datei eines anderen Benutzers in einem Sticky-Verzeichnis zu tun, erfordert
Rechte, die das Labor nicht modelliert.
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 enthält positive, negative, Edge- und Out-of-Domain-Fälle
mit manuell abgeleiteten Labels. fixtures/expected.tsv stammt aus
scripts/derive_expected.py, das dieselben Szenarien mit Pythons
os-Modul in seiner eigenen Sandbox ausführt und den pre-Schlüssel mit pathlibs
echtem resolve() berechnet; die C-Tests vergleichen Labels und Schlüssel gegen beide.
Ein Modell ist kein Befund: siehe LIMITATIONS.md und SOURCES.md. Lizenz: Apache-2.0.