Modelo educacional offline da CVE-2026-112936 (filelock SQLite symlink follow)
Laboratório local para CVE-2026-112936 (GHSA-j8f7-rjxc-mr56): o ReadWriteLock do filelock indexava as suas instâncias por Path(lock_file).resolve() e permitia que sqlite3.connect() abrisse o caminho do lock, pelo que um symlink colocado nesse caminho era seguido: o processo criava ou bloqueava o ficheiro para o qual o link apontava, e re-apontar o link dava a dois processos "o" lock de escrita em ficheiros diferentes. A correção, commit 4d45e83caf7e (filelock 4.0.9), abre o caminho com O_NOFOLLOW | O_NONBLOCK, recusa tudo o que não seja um ficheiro regular, resolve apenas o diretório pai para a chave e liga o SQLite através de /proc/self/fd/N. Educacional, determinístico, C11 verificado com ASan/UBSan.
Sem SQLite, sem filelock, sem rede, sem outro utilizador. Cada caso constrói os seus
próprios nomes dentro de uma sandbox mkdtemp() nova, executa as duas aberturas com syscalls
reais e remove a sandbox; a saída são apenas rótulos e chaves relativas à sandbox.
Espanhol: README.es.md. Exercícios: PRACTICE.md.
src/filelock/_read_write.py)| Linha do diff | Código | Laboratório |
|---|---|---|
| antiga 212, antiga 309 | pathlib.Path(lock_file).resolve() | chave pre: fl_resolve (não estrita, segue links) |
| nova 224-225, nova 322 | pathlib.Path(_canonical(lock_file)), "resolve only the parent" | chave post: fl_canonical (pai resolvido, nome mantido) |
| antiga 740-746 | sqlite3.connect(database, ...) | abertura pre: substituto open(name, O_RDWR|O_CREAT|O_NONBLOCK) |
| nova 54-55 | _DB_OPEN_FLAGS = O_RDWR|O_CREAT|O_NOFOLLOW|O_NONBLOCK | flags de abertura post, modo 0600 (novo 775) |
| nova 776-779 | if not S_ISREG(os.fstat(fd).st_mode): close, "refusing a non-regular lock database" | REFUSED_NONREG |
| nova 753-765, 59 | manter o fd; target = f"{_FD_DIR}/{fd}" (/proc/self/fd no Linux) | ação reopen |
O GHSA diz que o VFS do SQLite resolve o symlink final no espaço de utilizador, pelo que
fs.protected_symlinks e o sticky bit não o impedem; o substituto pre do laboratório
deixa o kernel seguir o link, o que dá o mesmo
resultado numa sandbox de utilizador único. _canonical vive em _api.py, fora
do diff: apenas o seu comentário ("resolve only the parent") é modelado.
results/)| No caminho do lock | pré | pós |
|---|---|---|
symlink para private/pwned.flag (inexistente), também através de uma cadeia | FOLLOWED_CREATED, um novo ficheiro fora do caminho do lock | REFUSED_SYMLINK, nada criado |
| symlink para um ficheiro existente (absoluto ou relativo) | FOLLOWED_EXISTING, chave = o alvo | REFUSED_SYMLINK, chave = o link |
| symlink para um FIFO / um diretório / ele próprio / um diretório inexistente | OPENED_NONREG / ERR_EISDIR / ERR_ELOOP / ERR_ENOENT | REFUSED_SYMLINK |
| FIFO | OPENED_NONREG | REFUSED_NONREG |
| link re-apontado entre duas aberturas (passo 3 do PoC do GHSA) | EXCLUSION_BROKEN, chaves S/a.db e S/b.db | REFUSED |
| link substituído após validação, depois connect | REOPEN_FOLLOWED (o nome é aberto novamente) | REOPEN_SAME_INODE (/proc/self/fd/N) |
| ficheiro regular, nome inexistente, diretório, pai com symlink, hard link | igual em ambas | igual em ambas |
results/sweep.csv atravessa 13 tipos de objeto no caminho do lock. Em 400
configurações aleatórias os testes verificam que post nunca cria um nome fora do
caminho do lock, recusa sempre um symlink final, e que sem um symlink final
ambas as versões concordam exceto para ficheiros não regulares.
Dois casos são observações do laboratório, não descobertas: um hard link no
caminho (c13) é aberto por ambas as versões (O_NOFOLLOW é sobre symlinks;
fs.protected_hardlinks não é modelado), e renomear o ficheiro de lock para fora
e criar um novo entre duas aberturas (s04) divide o inode em ambas
as versões; fazer isso ao ficheiro de outro utilizador num diretório sticky exige
permissões que o laboratório não modela.
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 contém casos positivos, negativos, de limite e fora do domínio, com rótulos derivados manualmente. fixtures/expected.tsv vem de scripts/derive_expected.py, que executa os mesmos cenários com o módulo os do Python em seu próprio sandbox e calcula a chave pre com o resolve() real do pathlib; os testes em C comparam os rótulos e as chaves com ambos.
Um modelo não é um achado: consulte LIMITATIONS.md e SOURCES.md. Licença: Apache-2.0.