
Lab TLS locale CVE-2026-19553 con una configurazione Ubuntu 24.04 protetta e sette test dimostrativi.
Questo laboratorio locale per CVE-2026-19553 confronta CPython 3.13.15 con CPython 3.13.16 con patch. L'installer è destinato a una VM Ubuntu 24.04 LTS esistente, inclusa Ubuntu 24.04.5 con MCPJam e Apache già installati.
Questo repository è pubblico. La clonazione e il pull non richiedono un login GitHub. Digita questi comandi in Ubuntu, una riga alla volta:
cd ~
git clone https://github.com/monkeyyey/acw3-tls-lab.git lab
cd lab
bash setup.sh
Per un clone esistente, usare cd ~/lab, git pull --ff-only, poi bash setup.sh.
Conservare lo snapshot della VM. Eseguire con il proprio account normale, senza sudo; lo script
richiede sudo per le dipendenze e per leggere la configurazione Apache protetta.
Consentire almeno 1 GiB di spazio libero. L'impostazione predefinita utilizza build CPython
portatili con checksum fissato dal progetto python-build-standalone di Astral, lo stesso
progetto di distribuzione usato da uv. ARM64 (aarch64) e x86-64 sono supportati.
Ogni interprete e le sue librerie incluse restano sotto ~/acw3; non vengono apportate modifiche
al PATH, symlink globali o sostituzioni del Python di sistema.
Se Git è assente ma curl è disponibile:
cd ~
curl -fL https://github.com/monkeyyey/acw3-tls-lab/archive/refs/heads/main.tar.gz -o lab.tar.gz
tar -xf lab.tar.gz
cd acw3-tls-lab-main
bash setup.sh
~/mcpjam esiste.
Imposta MCPJAM_DIR se il tuo progetto MCPJam si trova altrove. Il tuo file
~/acw3/checks/versions-before.txt esistente dal Passo 1 viene conservato e confrontato.
Se il Passo 1 contiene solo alcune versioni, ogni voce salvata deve comunque corrispondere.
Un avviso identifica la cronologia incompleta, e viene utilizzata una baseline
completa e aggiornata per i controlli prima/dopo di questa esecuzione. Baseline salvate
vuote o non corrispondenti interrompono comunque il setup.--no-remove blocca la rimozione dei pacchetti. Questa politica si applica a quel comando.~/acw3/python-VERSION dopo aver verificato gli hash SHA-256 fissati.
Versione, architettura, URL del fornitore e digest sono registrati in
python-downloads.json, con un link al commit esatto
dei metadati upstream. Entrambi gli interpreti devono importare i moduli del lab
e superare i controlli di comportamento vulnerabile/patched.L'impostazione predefinita non richiede SQLite, OpenSSL o altri pacchetti di sviluppo.
Ciò evita un conflitto di dipendenze come libsqlite3-dev che richiede un
aggiornamento del libsqlite3-0 esistente nella VM. I pacchetti APT scaricati da un
precedente tentativo bloccato possono rimanere in cache; questo setup non installa
quei pacchetti di sviluppo in cache.
Se il setup stampa ancora BLOCKED, fermati e ispeziona l'errore. Anche uno strumento runtime
mancante può richiedere la sostituzione di una libreria installata; quella transazione
viene rifiutata. Non rimuovere la protezione per forzare un aggiornamento.
L'installer non modifica la configurazione di Apache/MCPJam, non riavvia i loro servizi, non cambia il comando Python predefinito, non modifica le impostazioni di rete né installa la CA generata nel trust di sistema. L'aggiunta di pacchetti mancanti modifica comunque la VM; il tuo snapshot fornisce un rollback se necessario.
bash setup.sh source mantiene l'approccio originale di build dai sorgenti. Utilizza
gli archivi ufficiali di python.org e make altinstall in prefissi privati,
e richiede xz-utils, build-essential, pkg-config, libssl-dev e
zlib1g-dev con la stessa protezione dei pacchetti. I pacchetti opzionali di sviluppo per SQLite, Tk e database
sono omessi. La modalità sorgente può comunque essere bloccata quando
gli header di sviluppo richiedono la sostituzione delle librerie runtime esistenti. Consenti
6 GiB liberi; ACW3_JOBS=1 bash setup.sh source riduce il parallelismo del compilatore.
I log locali vengono salvati fuori da Git in ~/acw3/checks/runs/. Un'esecuzione automatica
riuscita stampa 7/7 tests passed e termina con i controlli di preservazione
superati. I log includono build, output del client, server.txt e
results.tsv. Le riesecuzioni riutilizzano le installazioni Python private sane.
Per due terminali, esegui questi comandi dalla cartella del repository:
# Terminal 1
bash setup.sh server
# Terminal 2
bash setup.sh test
Premere Ctrl+C nel Terminale 1 al termine. bash setup.sh check fornisce un controllo di stato in sola lettura; bash setup.sh deps esegue solo la configurazione delle dipendenze.
| Test | Python | Risultato atteso |
|---|---|---|
| T01 | 3.13.15 | L'hostname mancante consente alla richiesta mock di raggiungere other.lab |
| T02 | 3.13.15 | L'hostname esplicito rifiuta other.lab |
| T03 | 3.13.15 | service.lab riesce |
| T04 | 3.13.16 | L'hostname mancante viene rifiutato prima della connessione |
| T05 | 3.13.16 | L'hostname esplicito rifiuta other.lab |
| T06 | 3.13.16 | service.lab riesce |
| T07 | 3.13.15 | Una CA non correlata rifiuta il certificato dell'attaccante |
Gli endpoint si associano a 127.0.0.1:8443 e 127.0.0.1:8444. La porta normale 6274 di MCPJam e le porte 80/443 di Apache sono separate. Non sono necessarie modifiche al DNS o al file hosts. Consultare il runbook per i singoli test.
I download pubblici non richiedono l'accesso. Per autenticarsi in vista di future push, eseguire:
bash setup.sh login
Questo installa GitHub CLI con la stessa protezione dei pacchetti, avvia il flusso di accesso tramite browser, quindi configura l'helper delle credenziali HTTPS di Git. Apri la pagina del dispositivo GitHub visualizzata sul tuo Mac se Ubuntu non ha un browser. Non eseguire mai il commit dei token né inserirli negli URL dei repository.
bash -n setup.sh
python3 -m unittest discover -s tests -v
La validazione locale ha superato tutti i 31 test di guardia/archivio. Tutti e quattro gli archivi Linux bloccati sono stati scaricati e i loro checksum e layout verificati. Anche T01-T07 e i conteggi previsti delle ricevute del server sono stati superati con le build portatili equivalenti per macOS. Questi controlli non costituiscono un'esecuzione su Ubuntu.