CVE-2026-112936(filelock SQLite 심볼릭 링크 추적)의 오프라인 교육용 모델
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)| Diff 줄 | 코드 | 랩 |
|---|---|---|
| old 212, old 309 | pathlib.Path(lock_file).resolve() | pre 키: fl_resolve (비엄격, 링크를 따라감) |
| 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 |
| 두 번의 열기 사이에 링크가 다시 가리켜짐 (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가 잠금 경로 밖에 이름을
생성하지 않으며, 항상 최종 심볼릭 링크를 거부하고, 최종 심볼릭 링크가 없을 때
두 버전이 일반 파일이 아닌 파일을 제외하고 일치함을 확인한다.
두 가지 경우는 랩의 관찰이며 발견 사항이 아니다: 경로에 있는 하드 링크
(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에서 생성되며, 이는 자체 샌드박스에서 Python의 os 모듈로 동일한 시나리오를 실행하고 pathlib의 실제 resolve()로 pre 키를 계산합니다. C 테스트는 레이블과 키를 둘 모두와 비교합니다.
모델은 발견 사항이 아닙니다: LIMITATIONS.md 및 SOURCES.md를 참조하세요. 라이선스: Apache-2.0.