Skip to content

5 collaudo devtools

Valentino Aglianรณ edited this page Nov 15, 2026 · 2 revisions

LOGO

๐Ÿ”ฅ Capitolo 4 : La Prova del Battesimo di Fuoco
( Debug & Log ๐Ÿž๐Ÿ“Š )

Il collaudo e la manutenzione del motore โš™๏ธ๐Ÿช– Panzer v7.x+ all'interno delle infrastrutture della Pubblica Amministrazione richiedono un monitoraggio rigoroso tramite i DevTools ( F12 ), applicando il protocollo di hardening e la sterilizzazione forense dei log ( ๐Ÿ•ณ๏ธ Black-Hole ).

Warning

โžก๏ธ Falsi Positivi in Debug: Quando i DevTools di Chrome sono aperti con l'opzione ๐Ÿšซ๐Ÿ’พ "Disable cache" attiva, il Service Worker potrebbe bypassare le logiche del Bunker. Disattiva questa opzione per i test di resilienza reale.

โš ๏ธ Configurazione : getNetworkProfile richiede monitoraggio RTT e Downlink. Non disabilitare le API di rete (navigator.connection).

Caution

๐Ÿ›‘ NOTA : โš™๏ธ๐Ÿช– Panzer v7.x+ : Non alterare la variabile di runtime encryptionKey o i parametri congelati in CONFIG (deepFreeze(CONFIG)); il protocollo ๐Ÿ•ณ๏ธ Black-Hole interpretando la manipolazione o il fallimento del canarino come tentata compromissione, attiverร  automaticamente la Purga Atomica (Destroy_ALL_Caches).


๐Ÿ“Š Tassonomia dei Log di Logistica e Storage

  • โฏ๏ธ๐Ÿ•ต๏ธ Durante le sessioni di ispezione attiva, ๐Ÿ‘ฉโ€๐Ÿ’ป l'operatore tecnico deve fare riferimento alla seguente ๐Ÿ—บ๏ธ mappatura semantica delle stringhe generate nativamente dal Service-Worker nei log di console :
๐Ÿ”น๐Ÿ“„ Log
Alcuni esempi di Log di Console ( SW Core Panzer v7.x+ โš™๏ธ๐Ÿช–) โ–ถ๏ธ Innesco Operativo
๐Ÿ“ฆ๐Ÿ›ก๏ธ SW: Risorsa validata e salvata: ${targetUrl} Successo validazione DNA Check e salvataggio in cache.
๐Ÿ’พ๐Ÿ›ก๏ธ SW: Risorsa estratta dal, ${targetCache} Decrittazione AES-GCM al volo in RAM e bonifica buffer.
๐Ÿ›ก๏ธ๐Ÿงน SW: Bonifica RAM eseguita per: ${finalPath} Sovrascrittura forzata .fill(0) anti-Memory Inspection.
โš ๏ธ SW Security: Firma header non valida Mismatch dei Magic Numbers nella Fase 1 (Testa).
โš ๏ธ SW Security: Firma footer fallita Mismatch marcatore di chiusura (%%EOF / IEND) nella Fase 2 (Coda).
๐Ÿ“„โŒ SW: Fallimento validazione/download su: ${url} Scarto risorsa durante lo Smart Sync per soglie o integritร .
๐ŸŒโŒ SW: Offline in ${mode} (Profilo: ${profileName}) Rilevamento assenza connettivitร  reale (checkRealOnline).
๐Ÿšจ SW: Storage Pieno!\n Emergency !\n๐Ÿงน cleanUserCache ! Rilevato QuotaExceededError: avvio pulizia del solo Magazzino utente.
โš ๏ธ SW: ErrorPage B64 Not Blob... Fallback su icona SVG Base64 interna in generateErrorPage.
๐Ÿ—„๏ธ๐Ÿšจ SW: INTEGRITร€ CRITTOGRAFICA FALLITA! - Avvio distruzione Dati... Fallimento test Canary Loopback (VAULT_SECURITY_BREACH_INTEGRITY).
๐Ÿ—„๏ธ๐Ÿ”ฅ SW: Tabula rasa completata con successo. Completamento purga atomica di cache e database PWA_Vault.
โš ๏ธ๐Ÿ’ฃ ANOMALIA CRITICA: Vault compromesso, chiave sparita! Database PWA_Vault esistente ma record master_key assente.
โŒ๐Ÿ›ก๏ธ SW: Errore durante la cifratura del file. Eccezione in encryptBlob con azzeramento immediato dei buffer RAM.
โŒ๐Ÿ›ก๏ธ SW: Fallimento decrittazione.\nDati non integri o chiave errata. Solleva VAULT_LOCKED_DECRYPTION in decryptBuffer.
๐Ÿ“œ๐Ÿ“ฆ SW: TTL Scaduto, Del: ${request.url} Rimozione automatica risorse non cifrate oltre CONFIG.userCacheTTL.
๐Ÿงน SW: UserCache svuotata, recupera spazio critico. Eseguita da cleanUserCache(true) su QuotaExceededError.
๐Ÿ”‘ SW: Primo avvio, inizializzazione chiave... Generazione nuova CryptoKey AES-GCM 256-bit (extractable: false).
๐Ÿ›ก๏ธ๐Ÿ” SW: Check di Sicurezza... Avvio verifica deepVaultValidation() all'attivazione.
๐Ÿ›ก๏ธโœ… SW: Integritร  Bunker confermata. Test crittografico sul canarino (vaultCanaryText) superato.
โš ๏ธ๐Ÿ›ก๏ธSecurity Violation: ๐Ÿ—„๏ธ๐Ÿšซ Vault Error... Risposta HTTP 403 restituita quando il caveau รจ bloccato (VAULT_LOCKED_NO_KEY).

๐Ÿ“ฆ Identificazione dei Magazzini di Memoria :

๐Ÿ”น๐Ÿ“ฆ๐Ÿ›ก๏ธ ( Bunker ), ( mappato in `CONFIG.cacheName` )
Indica operazioni di lettura, scrittura o ripristino di un asset di sistema core.

๐Ÿ”น Questa zona รจ protetta da cifratura hardware-assisted AES-GCM 256-bit ๐Ÿ”‘, isolata e vitale per il funzionamento offline.

๐Ÿ”น Il frontend riceve queste risorse marchiate dall'header personalizzato :
`X-PWA-Source: Bunker-Decrypted` (accompagnato dagli header di sicurezza iniettati da `injectSecurityHeaders`).
๐Ÿ”น๐Ÿ“ฆ๐Ÿ”“ ( Magazzino ), ( mappato in `CONFIG.userCacheName` )
๐Ÿ”น Indica la gestione delle risorse utente sussidiarie. รˆ un'area di storage dinamica, volatile, non cifrata e sacrificabile in caso di emergenza, vincolata al ciclo di vita di `CONFIG.userCacheTTL` (7 giorni).

๐Ÿšจ Protocollo di Emergenza e Purga :

  • ๐Ÿคจ In presenza di anomalie hardware o tentativi di manipolazione ( es: iniezione di chiavi corrotte ๐Ÿ”‘๐Ÿชฑ ), il motore esegue il protocollo distruttivo definito nel diagramma sottostante:
๐Ÿ”น๐Ÿ’พ๐Ÿšจ Scattato `QuotaExceededError` ( Memoria Piena )
๐Ÿ”น โ— Causa : Il dispositivo client ha esaurito lo spazio disco. ๐Ÿ’พ Durante il download o la cifratura degli asset pesanti la scrittura (`cache.put`) fallisce.

๐Ÿ”น โœ… Azione : Interviene `QuotaExceeded_User_Assets(cacheError)`, che invoca `cleanUserCache(true)` svuotando esclusivamente il Magazzino volatile (`CONFIG.userCacheName`) e ritenta il salvataggio.

๐Ÿ”น โŒโ˜ข๏ธ Nessuna purga del Bunker viene avviata, preservando l'integritร  dei file core cifrati giร  archiviati in `CONFIG.cacheName`.
๐Ÿ”น๐Ÿ—„๏ธ๐Ÿšจ๐Ÿ’ฃ `VAULT_SECURITY_BREACH_INTEGRITY` ( Purga Atomica โ˜ข๏ธ )
๐Ÿ”น โ— Causa : Rilevata alterazione strutturale dei byte della chiave master ๐Ÿ”‘, fallimento del test crittografico di decrittazione sul Canary Data (`CONFIG.vaultCanaryText`), oppure assenza confermata del record `master_key` da IndexedDB dopo i 3 tentativi adattivi (`MAX_RETRIES = 3`).

๐Ÿ”น โœ… Azione del software ( Tabula Rasa & Reset โ˜ข๏ธ๐Ÿ”„ ) : Il Service-Worker attiva il protocollo distruttivo immediato (`Destroy_ALL_Caches("VAULT_COMPROMISED")`) :
Cancellazione radicale di tutte le cache (`CONFIG.cacheName` e `CONFIG.userCacheName`), eliminazione del database IndexedDB (`indexedDB.deleteDatabase("PWA_Vault")`), azzeramento di `encryptionKey = null`, invio del messaggio broadcast `CORE_UPDATE_RELOAD` e lancio dell'errore `VAULT_COMPROMISED_AND_CLEANED`.
sequenceDiagram
    participant SW as โš™๏ธ Guardiano (SW)
    participant CA as ๐Ÿ’พ Magazzino (Cache)
    participant DB as ๐Ÿ—„๏ธ Caveau (DB)
    participant FE as ๐Ÿ–ฅ๏ธ Schermo (App)

    Note over SW: Rilevato pericolo/corruzione (VAULT_SECURITY_BREACH_INTEGRITY)
    SW->>CA: ๐Ÿงน Destroy_ALL_Caches()
    SW->>DB: ๐Ÿงจ indexedDB.deleteDatabase("PWA_Vault")
    SW->>SW: ๐Ÿง  encryptionKey = null & .fill(0)
    SW->>FE: ๐Ÿ“ข postMessage({ type: 'CORE_UPDATE_RELOAD', msg: 'DESTROY_ALL_CACHE' })
Loading
๐Ÿ”น๐Ÿ—๏ธโš™๏ธ Effetto Nuova Installazione :
๐Ÿ”น ๐ŸŒ๐Ÿ†• Il browser si ritrova davanti a una tabula rasa assoluta e avvia un ciclo di re-installazione ex-novo al ricaricamento.

๐Ÿ”น โ„น๏ธ Se la comunicazione diretta con il frontend dovesse fallire durante la crisi, l'effetto si concretizza in modo deterministico alla primissima riapertura o aggiornamento manuale dell'applicazione da parte dell'utente, costringendo il sistema a ripartire da uno stato nativo pulito e a riscaricare tutti gli asset core integri direttamente dal server d'origine.

๐Ÿ”น ๐Ÿ“ต Nel caso limite in cui la rete sia totalmente assente e il re-fetch fallisca, il motore si isolerร  nello stato logico protetto `VAULT_LOCKED_NO_KEY` (restituendo HTTP `403`), dirottando le richieste grafiche verso `CONFIG.defPlaceHolderLogo` (o `GLOBAL_BROKEN_BLOB`) oppure generando la pagina d'emergenza HTML `503` tramite `generateErrorPage`.

๐Ÿ› ๏ธ Protocollo di Collaudo Operativo :

  • ๐Ÿ‘ค Chiunque puรฒ testare la reattivitร  e l'affidabilitร  del sistema seguendo questa batteria di test guidati direttamente dai DevTools del browser.
๐Ÿ”น1. ๐Ÿ‹๏ธโ€โ™‚๏ธ Test di Stabilitร  Asincrona ( Cold Start ) :
๐Ÿ”น Verifica che il riavvio forzato del motore non provochi perdite di dati o falsi positivi.

๐Ÿ”น Apri i DevTools (`F12`) -> scheda Application -> Service Workers.

๐Ÿ”น Clicca sul pulsante Stop ( il pallino verde diventerร  bianco, svuotando la RAM del Worker ).

๐Ÿ”น Torna sulla pagina e premi `F5` per ricaricare.

๐Ÿ”น โœ… Risultato atteso :
Il Service-Worker si riavvia con `lastVaultCheck = 0`, esegue `verifyVaultIntegrity()` -> `deepVaultValidation()`, estrae la ๐Ÿ”‘ chiave intatta dal disco e convalida il canarino.
L'applicazione si avvia normalmente senza alcun errore crittografico.
๐Ÿ”น2. โš ๏ธ๐Ÿ“ฆ Test di Isolamento per Spazio Pieno ( Quota Exceeded ) :
๐Ÿ”น Verifica che la saturazione della memoria non inneschi per errore la purga del Bunker.

๐Ÿ”น Nei DevTools, vai sulla scheda Application -> menu Storage (Archiviazione).

๐Ÿ”น Spunta la casella "Simulate custom storage quota" e imposta il limite a 1 MB.

๐Ÿ”น Svuota la cache e ricarica la pagina (`F5`) per forzare la sincronizzazione `performSync`.

๐Ÿ”น โœ… Risultato atteso :
La scrittura dei file pesanti solleva `QuotaExceededError`, intercettato da `QuotaExceeded_User_Assets()` che svuota la sola `userCacheName` (`๐Ÿงน SW: UserCache svuotata, recupera spazio critico.`). Nessuna purga atomica del Bunker viene avviata e le chiavi del Vault restano integre.
๐Ÿ”น3. ๐Ÿ—๏ธ Test di Violazione per Chiave Rimossa ( NOVITร€ dalla v7.x+ ๐Ÿช– )
๐Ÿ”น Obiettivo Forense : Verificare la reazione autonoma del Service-Worker in caso di ๐Ÿ”‘โŒ๐Ÿ’พ Rimozione dolosa della chiave master dal disco, distinguendo tra rallentamenti hardware ( I/O Throttle ) e attacchi reali.

๐Ÿ”น Procedura Operativa di Test :
1. Nei DevTools di Chrome, navigare nel pannello Application -> IndexedDB -> `PWA_Vault` -> `keys`.
2. Selezionare il record master_key e premere il tasto Canc.
3. In Service-Workers, cliccare su Stop per forzare il kill del processo e la purga della RAM.
4. Ricaricare la pagina con `F5`.

๐Ÿ”น โœ… Risultato Atteso :
Al boot, deepVaultValidation() attiva un ciclo fino a 3 tentativi (MAX_RETRIES = 3) con una Promise.race tra la query al database e waitTillIdle() con ๐ŸŽฒ Jittering ( 250ms-600ms * attempt ).

Il sistema isola lo stato in due scenari :

๐Ÿงฑ SCENARIO A ( Falso Positivo - I/O Stress ) : Se l'I/O del dispositivo รจ bloccato, lo ๐ŸŒก๏ธ๐Ÿ›ก๏ธ Scudo Termico vince la gara (`THERMAL_SHIELD_TIMEOUT`). Il Panzer solleva `VAULT_TEMPORARILY_LOCKED` attivando il Bunker Shield ( Blocco HTTP 403 ) per congelare la sessione a scopo cautelativo, MA NON esegue la purga โ›”๐Ÿ’ฃ, preservando l'integritร  dei dati cifrati in attesa di ripristino stabilitร .

๐Ÿ’ฅ SCENARIO B ( Vero Attacco - I/O Stabile ) : Se il canale risponde istantaneamente (isIOStable = true) confermando l'assenza della chiave per tutti e 3 i tentativi, l'anomalia dolosa รจ confermata al 100% ๐Ÿšจ e il protocollo scatta immediatamente :
โ€ข Attivazione Black-Hole ๐Ÿ•ณ๏ธ : Sterilizzazione forense degli errori tramite createCleanError() (stack trace rimosso) e timing noise anti-profilazione.
โ€ข ๐Ÿ’ฃ Purga Atomica Immediata : Esegue Destroy_ALL_Caches("VAULT_COMPROMISED") e indexedDB.deleteDatabase("PWA_Vault").
โ€ข Bonifica & Blocco : Azzeramento encryptionKey = null, broadcast CORE_UPDATE_RELOAD ai client e blocco delle richieste protette con HTTP 403 Forbidden.
๐Ÿ”น4. ๐Ÿชฑ๐Ÿ”‘ Test di Violazione per Chiave Corrotta ( ๐Ÿ’‰ Iniezione di Codice ) :
๐Ÿ”น Verifica la reazione se i byte della chiave vengono manipolati dall'esterno.
Poichรฉ la chiave รจ protetta nativamente in sandbox hardware/software con `extractable: false`, per simulare la corruzione รจ necessario iniettare un Oggetto sostitutivo fasullo tramite console.

๐Ÿ”น Nei DevTools, posizionati sulla scheda Console

๐Ÿ”น Sblocco del Browser ( Protezione Self-XSS ) :
Se la console blocca l'incolla ๐Ÿšซ๐Ÿ“‹, digita manualmente a schermo la stringa `consenti incolla` ( o `allow pasting` se il browser รจ in inglese ) e premi Invio.

๐Ÿ”น Copia e incolla il seguente script d'iniezione e premi Invio :
let req = indexedDB.open("PWA_Vault", 1);
req.onsuccess = function(e) {
    let db = e.target.result;
    let tx = db.transaction("keys", "readwrite");
    let putReq = tx.objectStore("keys").put({ finta_chiave: "dati_corrotti_12345" }, "master_key");
    putReq.onsuccess = function() {
        console.log("๐Ÿชฑ๐Ÿ”‘๐ŸŽฏ Chiave corrotta iniettata con successo nel DB!");
        db.close();
    };
};

  • ๐ŸŽฏ Per forzare la verifica delle routine di rete, si raccomanda di configurare il pannello Network dei DevTools emulando profili di connessione degradati ( es. Fast 3G o Slow 3G ).

  • โœ… Questo permette di validare visivamente il corretto funzionamento della routine getNetworkProfile, l'estrazione dei limiti da CONFIG.networkResilient.profiles e lo scatto automatico dei relativi timeout dinamici.

Tip

๐ŸŒŒ๐Ÿ›ก๏ธ SIMULAZIONE DEL TOTAL BLACKOUT NEI TEST DI COLLAUDO :

๐ŸŽš๏ธ Nel pannello Application -> Service-Workers dei DevTools, spunta la casella "Offline" e monitora i log.

Se il sistema รจ a regime, vedrai comparire esclusivamente stringhe con il marcatore ๐Ÿ’พ๐Ÿ›ก๏ธ SW: Risorsa estratta dal, ๐Ÿ“ฆ๐Ÿ›ก๏ธ (Bunker) e risposte con header X-PWA-Source: Bunker-Decrypted, a testimonianza del fatto che la PWA sta girando in Totale isolamento dal server e decifrando le risorse al volo via Web Crypto API.


โ†ฉ Torna alla Home ๐Ÿ 

๐Ÿ‘ˆ ๐Ÿ›๏ธ Perchรฉ la PA deve adottare
l'Architettura ๐Ÿช– Panzer v7+

  • ๐Ÿƒ Studio comparativo sul risparmio economico, indipendenza tecnologica (No Vendor Lock-in ๐Ÿšซ๐Ÿ”’) e sicurezza dei dati dei cittadini.

๐Ÿ‘‰ ๐Ÿ›ก๏ธ Capitolo 5:
Paradigma Difensivo Avanzato
e Logiche di Autodifesa

  • Ingegneria inversa del rischio applicata al web. Analisi dei vettori d'attacco client-side, mitigazione del tampering e protocolli di ๐Ÿงฝ Zeroization (Purga Atomica ๐Ÿ’ฃ๐Ÿ’ฅ).

LOGO Wiki Index

๐Ÿ—‚๏ธ Indice Rapido Wiki


LOGOLOGO

Clone this wiki locally