Repository navigation
5 collaudo devtools
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.
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).
- โฏ๏ธ๐ต๏ธ 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+ โ๏ธ๐ช) | |
|---|---|
๐ฆ๐ก๏ธ 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). |
๐น๐ฆ๐ก๏ธ ( 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).
- ๐คจ 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' })
๐น๐๏ธโ๏ธ 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`.
- ๐ค Chiunque puรฒ testare la reattivitร e l'affidabilitร del sistema seguendo questa batteria di test guidati direttamente dai
DevToolsdel 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
DevToolsemulando 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 daCONFIG.networkResilient.profilese 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.
๐ ๐๏ธ 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 ๐ฃ๐ฅ).
-
๐ Home
๐ Pagina principale del Progetto -
๐ Capitolo 0 : Scheda di Adozione e Metriche di Resilienza Tecnica
๐ Impatto e Validazione Empirica -
๐ Capitolo 1 : Introduzione
๐จโโ๏ธ Requisiti legali e conformitร CAD ( Art. 68/69 ) ๐ -
โ๏ธ Capitolo 2 : Architettura
๐ก๏ธ๐ฆ Bunker Mode e crittografia AES-GCM 256 del Vault ๐๐๏ธ -
๐ก Capitolo 3 : Note Finali
โ๏ธ Esempi di utilizzo pratico nella PA ๐๏ธ -
๐๏ธ Perchรฉ ๐ช Panzer v7.x+
๐ฝ Indipendenza ed eliminazione del Vendor Lock-in ๐ซ๐ -
๐ฅ Capitolo 4 : Collaudo
๐ฅ Battesimo di Fuoco, Debug e Log ๐๐ -
๐ก๏ธ Capitolo 5 : Paradigma Difensivo
Logiche di ๐ซ๐ฅ anti-tampering e Zeroization ๐งฝ -
๐ Capitolo 6 : Determina
๐จ๏ธ Modello pronto ed esecutivo per i dirigenti ๐ผ -
๐ง Capitolo 7 : Estensione Zero-Trust ๐
๐งโโ๏ธ Sezione B
๐๐งช Concept : Architetturale e Framework di Sicurezza per le PA ๐๏ธ -
๐๏ธ๐จ Capitolo 8 : Protezione PA
๐ Disciplinare Tecnico di Tutela dell'Ente con linee guida per Affidamenti Esterni. ๐ข -
๐โข๏ธ Capitolo 9 : La Difesa Oltre il Confine
๐๐งช Concept : di un sistema di difesa attiva per operare in modalitร Out-of-Sandbox ๐๐ซ -
๐๏ธ๐ฎ PA Futuro Digitale
๐๐ Concept : Manifesto tecnologico e linee guida d'architettura per l'Iper Cloud PA ๐ฉ๏ธ -
๐ก๏ธ๐๏ธ Capitolo 10 :
โ๏ธ๐ช CORE PANZER - UEFI PRE-BOOT GUARD
๐๐ช Advanced Military UEFI Pre-Boot Guard Modulo firmware bare-metal x86_64 progettato per l'ambiente UEFI... -
๐ก๏ธ๐ช Capitolo 11 :
โ๏ธ๐ ๏ธ Dal Hacking alla Difesa
๐ต๏ธโ๐ฃ Dall'AOB Scan all'Anti-Profiling โ La Conversione della Mentalitร Offensiva in Blindatura Istituzionale