CVE-2026-112936(filelock SQLite シンボリックリンク追従)のオフライン教育用モデル
CVE-2026-112936(GHSA-j8f7-rjxc-mr56)向けのローカルラボ:filelock の
ReadWriteLock はインスタンスを Path(lock_file).resolve() でキー付けし、
sqlite3.connect() にロックパスを開かせていたため、そのパスに仕込まれたシンボリックリンクが
辿られていた:プロセスはリンクが指すファイルを作成またはロックし、
リンクの向き先を変えると、2つのプロセスが異なるファイルに対して「その」書き込みロックを
得てしまった。修正コミット 4d45e83caf7e(filelock 4.0.9)は、パスを
O_NOFOLLOW | O_NONBLOCK で開き、通常ファイル以外を拒否し、
キーに対しては親ディレクトリのみを解決し、SQLite には
/proc/self/fd/N を介して接続する。教育的かつ決定論的で、C11 は ASan/UBSan で検証済み。
SQLite なし、filelock なし、ネットワークなし、他のユーザーなし。 各ケースは
新規の mkdtemp() サンドボックス内に独自の名前を構築し、実際の
システムコールで2回のオープンを実行してサンドボックスを削除する。出力はラベルとサンドボックス相対の
キーのみである。
スペイン語版:README.es.md。演習:PRACTICE.md。
src/filelock/_read_write.py)| Diff 行 | コード | ラボ |
|---|---|---|
| old 212, old 309 | pathlib.Path(lock_file).resolve() | pre キー:fl_resolve(非 strict、リンクを辿る) |
| new 224-225, new 322 | pathlib.Path(_canonical(lock_file))、「親のみを解決」 | post キー:fl_canonical(親は解決、名前は保持) |
| old 740-746 | sqlite3.connect(database, ...) | pre オープン:open(name, O_RDWR|O_CREAT|O_NONBLOCK) の代替実装 |
| new 54-55 | _DB_OPEN_FLAGS = O_RDWR|O_CREAT|O_NOFOLLOW|O_NONBLOCK | post オープンフラグ、モード 0600(new 775) |
| new 776-779 | if not S_ISREG(os.fstat(fd).st_mode):クローズ、「非通常のロックデータベースを拒否」 | REFUSED_NONREG |
| new 753-765, 59 | fd を保持;target = f"{_FD_DIR}/{fd}"(Linux では /proc/self/fd) | reopen アクション |
GHSA によれば、SQLite の VFS は最終シンボリックリンクをユーザー空間で解決するため、
fs.protected_symlinks やスティッキービットでは防げない。ラボの pre
代替実装では、代わりにカーネルにリンクを辿らせることで、シングルユーザーのサンドボックス内で
同じ結果を得ている。_canonical は _api.py にあり、
diff の外側である:モデル化しているのはそのコメント(「親のみを解決」)のみである。
results/)| ロックパス上の状態 | pre | post |
|---|---|---|
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 |
| 2回のオープンの間にリンクの向き先を変更(GHSA PoC ステップ 3) | EXCLUSION_BROKEN、キー S/a.db と S/b.db | REFUSED |
| 検証後にリンクを置き換え、その後接続 | REOPEN_FOLLOWED(名前が再度開かれる) | REOPEN_SAME_INODE(/proc/self/fd/N) |
| 通常ファイル、存在しない名前、ディレクトリ、シンボリックリンクの親、ハードリンク | 両方で同じ | 両方で同じ |
results/sweep.csv はロックパス上で13種類のオブジェクトを横断する。400 の
ランダムなセットアップで、テストは post がロックパス外に名前を
作成しないこと、常に最終シンボリックリンクを拒否すること、そして最終シンボリックリンクがなければ
非通常ファイルを除いて両バージョンが一致することを確認する。
2つのケースはラボによる観察であり、発見ではない:パス上のハードリンク
(c13)は両バージョンで開かれる(O_NOFOLLOW はシンボリックリンクに関するものであり、
fs.protected_hardlinks はモデル化していない)。また、ロックファイルを別名にリネームし
2回のオープンの間に新しいファイルを作成する(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 から生成され、これは同じシナリオを Python の os モジュールを独自のサンドボックス内で実行し、pathlib の実際の resolve() を用いて pre キーを計算します。C のテストは、ラベルとキーの両方をそれらと比較します。
モデルは検出結果ではありません。LIMITATIONS.md および SOURCES.md を参照してください。ライセンス: Apache-2.0。