Skip to content

Release v3.2.6.0 - ⚙️🪖 Core Panzer v7.9.7+ & SDK v2.1 🪳

Latest
Latest

Choose a tag to compare

View all tags
@zero419-web zero419-web released this 06 Nov 10:58
· 16 commits to main since this release
Immutable release. Only release title and notes can be modified.
V3.2.6.0
5a0b0e5
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Note

Rilasciato sotto licenza :
🇪🇺📜 👉 EUPL-1.2

🛡️ [ ⚙️🪖 Motore Panzer v7.x+ ( sw.js ) ] :
Resilienza Totale e Sicurezza Militare per la PA. 🛡️🎖️🏛️

  • ✅ Questa release introduce l'evoluzione dell'architettura:
  • 🔐 Zero-Trust documentata nel Capitolo 2 della Wiki. 📚

  • 🪖 NOVITÀ v7.9.7+ :
    🐛 Sessione di BUG Fix & Supporto Safari

    • 🪳 Bug Fixed : Evento Fetch Del SW ( ⚙️🪖 ),
      • 🌐 NetworkFirst
      • 🚀 SWR - Stale-While-Revalidate
      • 🔀🎭 Regolatore di Flusso Polimorfo
      • 🖼️🩹 Placeholder: non restituisce più errore per una risorsa immagine su richiesta HEAD, ma gestisce correttamente lo status 404.
      • 🧠 Universal-Scan: risoluzione bug minori nell'albero di scansione.
    • ➕ 🧭 Safari, Supporto Sperimentale...
      • 🧭🚫🐺 Watchdog Anti-Incognito ❌🕵️ non Supportato

  • 🪖 NOVITÀ v7.9.6+ :
    🐛 Bug Fixed & Watchdog Avanzato

    • 🪳 Bug Fixed : Content-Length nelle risposte del Service Worker servite al browser.
    • 🐺️🐤 WATCHDOG DI SICUREZZA : introdotto il controllo di 3 tentativi prima di dichiarare se la chiave di cifratura 🔑🗄️ è effettivamente compromessa.

  • 🪖 NOVITÀ v7.9.5+ :
    🐛 Sessione di BUG Fix

    • 🪳 Molti Bug Fixed !
    • 🚀 SWR, Strategia migliorata su reti degradate.
    • 🔀🎭 Fix: Regolatore di Flusso Polimorfo, ora si adatta alle reti degradate e decide la strategia migliore.
    • 🎯 Riorganizzazione Del Evento Fetch Del SW ( ⚙️🪖 ), Per Il NetworkFirst/SaveBackground, SWR, CacheFirst ( Off-line )

  • 🪖 NOVITÀ v7.9+ :
    Sessione di 🪨 Hardening Mirato contro il Red-Team 🔴

    • 🔍 1. Validazione Forense Blob (isValidBlob)

    • 🧹 SVG & Anti-Polyglot: Blocco tag ostili (<script>, <iframe>), event handler inline (onload=) e signature di script in immagini raster (es. PNG, WEBP, JPEG).

    • 📄 PDF, PAdES & CAdES De-Obfuscated: Finestra di analisi estesa a 4096 byte per header e footer (per tollerare firme digitali, aggiornamenti incrementali e buste crittografiche .p7m), soglia minima a 2 KB (2048 byte), decodifica esadecimale, strip commenti/spazi, blocco stream compressi (/flatedecode, /lzwdecode, ecc.) e isolamento pattern malevoli da CONFIG.pdf.

    • 🧠 RAM Zero-Out: Bonifica della memoria con .fill(0) sui buffer attivi gestita tramite blocchi finally sicuri subito dopo l'analisi o in caso di eccezione.

    • 🧠 2. Deep Scanner IPC (universalScanner):

      • 🛑 Cap Nodi & Profilo: Limite massimo di 999 nodi per albero e vincolo tassativo a 12 livelli di profondità ( Anti-JSON-Bomb ).

      • 🛡️ Anti-Path Traversal: Sanitizzazione e scarto di chiavi e percorsi con risalite directory (../, ..\) o null byte (\0).

      • ⚡ CPU Yielding: Pausa non-blocking dell'Event Loop ogni 10 nodi per preservare la reattività del thread worker.

      • 🔒 3. Iniezione Security Headers (injectSecurityHeaders):

      • 🌐 Fetch Response Hardening: Riscrittura automatica in-flight degli header HTTP (nosniff, DENY, strict-origin-when-cross-origin, same-origin) su ogni risposta intercettata.

  • Il ⚙️ CORE v7.8+ :
    🪨 Hardening Generale...

  • Il ⚙️ CORE v7.7+ :
    🔬🧬 SW Forensics ( DNA Check & Binary Validation )
    Sintesi delle novità di hardening 🪨

    • 🤯 Testa (Header 512 Byte): Analisi dei primi 512 byte del file per la verifica stringente dei Magic Bytes reali, bloccando sul nascere lo spoofing del MIME-type e le estensioni camuffate.

    • 👣 Coda (Tail Check): Test di lettura a basso livello sul terminatore finale via blob.slice(-5).arrayBuffer() per escludere troncamenti, file corrotti o stream incompleti.

    • 🪵 Corpo & Anti-PDF Obfuscation (❌📜): Scansione dei payload PDF con supporto alla decodifica di tecniche di offuscamento (stringhe esadecimali/ottali, annotazioni annidate, flussi encodati) ed eradicazione di vettori malevoli (/JS, /JavaScript, /OpenAction, /Launch).

    • ✅ Risultato: Neutralizza il Cache Poisoning ☠️, azzera i crash silenziosi del Service Worker dovuti a eccezioni di lettura e forza l'azzeramento della memoria di lavoro (wipeRAM()) in caso di fallimento o abort dell'operazione.

  • Il ⚙️ CORE v7.6+: integra la nuova barriera 🚧 di sbarramento temporale contro le manomissioni a caldo del file system 📛, algoritmi avanzati di campionamento dell'Event Loop, ispezione forense 🔬 del payload a tre scomparti e la gestione asincrona dei canali reattivi con sbarramento IA. Il sistema garantisce l'immunità ai falsi positivi di I/O, l'azzeramento dei ⏱️ Timing Attacks, l'esecuzione atomica dei pacchetti e la protezione assoluta dei 🛡️💾 dati sensibili della PA anche su hardware datato o in condizioni di connettività critica ( Lie-Fi 🛜📶 ), blindando il transito fino al completamento sul Server Gateway.

🪖 Panzer SDK v2.1 BETA

  • 📱📄 PANZER SDK v2.1 BETA & Mobile-Ready PDF Engine :
    Integrazione ufficiale del layer SDK client-side ( SDK.js + app.js ) con supporto nativo a pdf_min.js per il rendering pagina per pagina su canvas HTML5 ad alta definizione su Chrome Mobile e tablet. Aggiornamento della GUI della Dashboard ( app.js ), fix su ServiceWorker.js, visore sandbox ( ❌💾 ) e sincronizzazione della stiva bunker ( 🛡️🗄️ ). Sblocco completo dei flussi di interazione e dei wrapper di scorrimento touch ( -webkit-overflow-scrolling: touch ) nel visore sandbox, garantendo una consultazione fluida, nativa e sicura degli atti amministrativi protetti in mobilità.

  • 🛡️🔒 Anti-Incognito Watchdog & Bunker Overlay :
    Aggiornamento del layer SDK con un sistema di rilevamento ambientale avanzato e un overlay di blocco anti-incognito, totalmente personalizzabile ( _showIncognitoBlocker ). Ottimizzato per garantire una copertura fullscreen a schermo intero su qualsiasi dispositivo e viewport, dai monitor desktop ai display mobile, inclusa la gestione nativa in modalità desktop da mobile. Integrazione di parametri flessibili per il controllo dinamico di icone, testi, stili cromatici, timeout del watchdog.

⚙️ Caratteristiche Tecniche e Innovazioni:

  • 🔐🌡️🛡️ Jittered Thermal Shield Race ( 🐺 Watchdog di Sicurezza ): Modulo di ispezione forense 🕵️ integrato in deepVaultValidation(). Esegue una 🏁 gara asincrona ad alta precisione ( Promise.race ) tra la query a IndexedDB e il respiro della CPU gestito tramite waitTillIdle. Il sistema introduce programmaticamente un'🤯 entropia temporale casuale ( 🎲 Jittering ) che distrugge la baseline statistica di qualsiasi tentativo di ⏱️⚔️ Timing Attack, isolando matematicamente i rallentamenti hardware del disco (falsi positivi di I/O) dalle reali rimozioni dolose della chiave dal database.

  • 📦🛡️ Bunker Mode & 🔑 AES-GCM Isolato: Cifratura hardware-assisted a 256-bit tramite Web Crypto API. Il sistema garantisce il "Zero-Memory-Footprint 🧹💾🐾": ogni buffer binario viene bonificato tramite Uint8Array.fill(0) subito dopo il rendering e la trasmissione. La sicurezza è estesa dall'uso capillare di Object.freeze() su ogni oggetto di errore, rendendo il sistema "cieco" alle analisi esterne del Red Team 🏴‍☠️🔴.

  • 🔀 Fetch Sandbox 🫙 & Tagging 🏷️: L'intercettazione dei flussi in fetch inietta programmaticamente header di sicurezza 🪝🛡️🏷️ vincolanti. 📦 La risorsa decrittata viene segregata nell'ambiente di isolamento del browser, impedendo l'accesso e l'esfiltrazione da script terzi non autorizzati. In caso di errore, il sistema inietta un template HTML script-free per neutralizzare l'esposizione del DOM.

  • 🕳️ Black-Hole Protocol ( Emergency Wipe ): Risposta distruttiva alle violazioni critiche. In caso di fallimento dell'integrità crittografica, il sistema invoca una purga atomica dei dati e sovrascrive i puntatori in memoria, annichilendo ogni traccia di stato in <10ms.

  • 🕵️‍♂️🔬🧬 Validazione Forense Avanzata ( SW Forensics 🎖️): Protocollo di controllo binario sequenziale del payload esteso in tre scomparti stagni indipendenti:

    • Fase 1 🤯 ( HEAD ): Analisi biometrica dei Magic Numbers di testa contro attacchi di MIME-sniffing.
    • Fase 2 👣 ( TAIL ): Verifica dei marcatori di coda ( Footer ) per neutralizzare attacchi di tipo Append, pienamente compatibile con PDF firmati digitalmente in formato PAdES.
    • Fase 3 🪵 ( BODY ): Ispezione euristica profonda del codice dei 📄 PDF per intercettare ed eliminare macro-istruzioni malevole in transito.

  • ⏳💤 Scudo Termico Adattivo (🌡️🛡️ CPU Thermal Shield ): Integrazione della routine adattiva waitTillIdle basata sul monitoraggio del drift dell'Event Loop, preservando la fluidità di rete e la stabilità del thread.

  • 🤖🛰️⛓️ Gateway Bilanciato & Sbarramento IA ( PoC Cap. 7 ): Estensione dell'architettura client-server per la gestione sicura dell'I/O remoto. Il sistema implementa una scomposizione binaria atomica del buffer inviato al server, iniettando in coda il Report IA Locale ( Passo 11 ) contenente metriche di conformità ed euristica. Il Server Gateway, operando in isolamento volatile di memoria RAM, valida l'integrità del pacchetto tramite token effimeri e blocca all'ingresso ( HTTP 500 con Thermal Jitter forense ) qualsiasi payload con punteggio di compliance manomesso o inferiore a 0.50, azzerando i rischi di iniezione nel Database Amministrativo.

📊 ( Debug & Telemetria Forense dei Log )

Per garantire la massima manutenibilità operativa negli enti PA e superare i collaudi tecnici, il ⚙️🪖 motore Panzer v7.x+ espone una telemetria granulare a runtime. Gli operatori devono monitorare la console dei DevTools ( F12 ) o i log del server per verificare l'integrità del Bunker e le risposte del sistema alle emergenze.

Alcuni esempi di Log di Console ( SW Panzer v7.x+ 🪖 ) Innesco Operativo
📦🛡️ SW: Risorsa validata e salvata: ${targetUrl} Successo cache e superamento DNA Check.
💾🛡️ SW: Risorsa estratta dal, ${targetCache} Decrittazione in RAM tramite modulo AES.
🛡️🧹 SW: Bonifica RAM eseguita per: ${finalPath} fill(0) anti Memory inspection su head, tail e fullBuffer.
🛡️ SW Security: Firma testa fallita per ${finalContentType}. DNA: ${headerHex} Fallimento Magic Numbers in Fase 1 (Blocco).
🛡️ SW Security: Firma coda fallita o corrotta per ${finalContentType}. TAIL DNA: ${tailHex} Fallimento marcatore strutturale di chiusura in Fase 2.
🛡️ SW Security: Vettore malevolo intercettato nel codice del PDF [${pattern}]. Blocco. Rilevamento macro-istruzioni (/JS, /JavaScript, ecc.) in Fase 3.
⏳ SW Drift: ${drift.toFixed(1)}ms -> Pausa applicata: ${time}ms Intervento dello scudo termico adattivo per il respiro dell'Event Loop.
🛑 PANZER THERMAL SHIELD: Sbarramento adattivo scattato a ${randomTimeoutMs.toFixed(2)}ms. Sforamento del timeout entropico della gara. Isolato falso positivo di I/O.
🗄️🚨 SW: CANALE REATTIVO MA CHIAVE ASSENTE! Rilevata rimozione dolosa dal disco. Canale integro (I/O stabile) ma riga vuota. Stanato attacco DevTools.
⚠️ SW Forensics: Asset scartato (${size}b < Min: ${min}b) -> ${contentType} Violazione soglie dimensionali minime strutturali della risorsa.
🌐❌ SW: Offline in ${mode} (Profilo: ${profileName}) Stato resilienza di rete e attivazione Offline Bunker Mode.
🔄 SW: Background Sync avviato... Sincronizzazione asincrona resiliente dei pacchetti PA.
🚨 SW: Storage Pieno! - Emergency Clean... Gestione QuotaExceeded tramite algoritmi predittivi.
🗄️🚨 SW: INTEGRITÀ CRITTOGRAFICA FALLITA! - Avvio distruzione Dati... Innesco immediato della contromisura distruttiva Emergency Wipe.
🗄️🔥 SW: Tabula rasa completata con successo. Risultato della Purga atomica controllata (Drop DB e Caches).
❌🛡️ SW: Errore durante la cifratura del file. Errore di Cifratura hardware-assisted con throw dell'eccezione.
❌🛡️ SW: Fallimento decrittazione. Dati non integri o chiave errata. Errore di decrittazione con blocco formale di sicurezza del caveau.
📜📦 SW: TTL Scaduto, Del: ${request.url} Pulizia automatica programmata dei dati memorizzati obsoleti.
🧹 SW: UserCache svuotata, recupera spazio critico. Intervento mirato in caso di saturazione della memoria locale del client.
🔑 SW: Primo avvio, inizializzazione chiave. Creazione ed allocazione della Master Key isolata non esportabile.
🛡️🔍 SW: Check di Sicurezza... Avvio del controllo di integrità asincrono sulla Master Key.
🛡️✅ SW: Integrità Bunker confermata. Riscontro negativo di manipolazione hardware; avvio del boot regolare.
🌐👮‍♂️ SW: Rete Degradata, [ ${profileName} ].\n SWR(Stale-While-Revalidate), ON per continuità operativa... Profili di rete degradati forzati all'uso della strategia SWR per la continuità offline della PA.

🏛️ Conformità PA e Normativa Nazionale:

  • 📜 Piena conformità agli Art. 68-69 del CAD ( Codice dell'Amministrazione Digitale ), garantendo i requisiti di trasparenza, il riuso e la portabilità totale del codice sorgente tra Enti Pubblici.

  • ⚡ Allineamento formale alle specifiche AgID publiccode.yml v0.5 per l'indicizzazione e il censimento ufficiale del repository su Developers Italia.

  • 🛑 Indipendenza tecnologica ( 🟢 Zero Vendor Lock-in ): Architettura Vanilla JS pura, nativa e slegata da framework commerciali o dipendenze esterne di terze parti, a totale garanzia di longevità software, manutenibilità forense e immunità ai vettori di attacco sulla supply chain nel tempo.

🔗 Riferimenti:

📚 Capitoli Consigliati, Dalla Wiki:

  • 👉 🧞 Capitolo 7:
    Estensione Architetturale Zero-Trust

    • Concept architetturale e framework di sicurezza per le Pubbliche Amministrazioni intenzionate ad adottare il modello, con specifiche di transito sicuro e integrazione Gateway.

  • 👉 🏛️🚨 Capitolo 8: Protezione PA

    • Disciplinare Tecnico di Tutela dell'Ente con linee guida operative per gli Affidamenti Esterni e capitolati di gara.

📝 NOTA TECNICA: ARCHITETTURA DI TRANSITO

  • ⚙️🪖 CORE PANZER V7.x+

Specifica dei Flussi e dei Layer di Sicurezza, Del PoC Capitolo 7 & Sezione B 🧞

🧱💾 3. RET_DB ( Retention Database Layer )

Persistenza Locale Strutturata e Gestione Stato Offline

Descrizione Breve:
Il motore di memorizzazione locale basato su IndexedDB ( Vanilla JS ) progettato per operare in modalità Local-First. Gestisce la persistenza del dato grezzo e transitorio sul client, garantendo transazioni atomiche e l'isolamento dei record prima della cifratura, con logiche di sincronizzazione bidirezionale automatica non appena la connettività viene ripristinata.

🔒🛰️ 4. Zero-Trust Crypto Loop ( Lato Client )

Isolamento in RAM e Pre-Cifratura Asimmetrica

Descrizione Breve:
Protocollo di sicurezza che assume il client come ambiente potenzialmente ostile. Prima di qualsiasi persistenza sul RET_DB o transito sul Fetch Layer, i dati in chiaro vengono isolati nella memoria volatile ( RAM ) e cifrati immediatamente tramite Web Crypto API utilizzando una chiave pubblica, impedendo accessi non autorizzati a livello hardware o tramite estensioni del browser.

🤝🔑 5. Crypto Transfer ( Protocollo di Trans-Crittazione )

Scambio Sicuro e Negoziazione delle Chiavi Sessione

Descrizione Breve:
Il meccanismo di transito e negoziazione delle chiavi crittografiche tra l'istanza client dell'Engine e il server endpoint. Gestisce il passaggio sicuro dei payload pre-cifrati e la rotazione dinamica delle chiavi di sessione, assicurando che i dati sensibili rimangano indecifrabili per qualsiasi nodo intermedio o proxy di rete.

🛡️⚙️ 6. Zero-Trust Crypto Loop ( Lato Server PHP )

Decifratura in Sandbox e Validazione Lato Endpoint

Descrizione Breve:
Il gemello lato server del loop di sicurezza, implementato in PHP nativo senza dipendenze esterne. Riceve il payload cifrato dal client, lo decifra esclusivamente all'interno di un ambiente di memoria isolato ( Sandbox ), esegue i controlli di integrità e conformità e prepara il dato per lo stivaggio finale o l'elaborazione interna.

📡⚡ 7. Fetch Layer Interception

Controllo e Dirottamento del Traffico di Rete

Descrizione Breve:
Il core del Service Worker che intercetta programmaticamente tutte le chiamate di rete in uscita e in ingresso. Riconosce le richieste destinate ai gateway della Pubblica Amministrazione e, in caso di assenza di rete o di anomalie, le dirotta in modo trasparente verso il RET_DB locale, garantendo la totale continuità operativa dell'applicazione.

🔄🎯 8. PWA-Pizza-Engine Sync Pipeline

Accodamento, Prioritizzazione e Schedulazione dei Payload

Descrizione Breve:
Il sistema di accodamento intelligente che gestisce i dati stivati offline durante i periodi di disconnessione. Organizza i payload in base a priorità strutturali, monitora lo stato della connessione tramite Background Sync API e avvia la spedizione sequenziale e sicura verso il server non appena rileva un canale di rete stabile.

🧪🕵️ 9. Human Debugger & Coherence Check

Strumento di Ispezione e Validazione Logica dei Flussi

Descrizione Breve:
Il protocollo interno di monitoraggio e simulazione che agisce come un debugger umano automatizzato. Traccia la tassonomia dei log dall'inserimento del dato fino all'endpoint, eseguendo test di coerenza strutturale tra i vari layer per intercettare anomalie, colli di bottiglia o potenziali perdite di dati ( data leakage ) prima della produzione.

🔄🏛️ 10. Gateway di Interoperabilità

Legacy e Ponti di Extrazione Iniettabili (🛑 Vendor Lock-In Bypass Layer 🟢)

Descrizione Breve:
Questo livello realizza un ponte di migrazione in-page conforme all'Art. 68 del CAD per contrastare il fenomeno del vendor lock-in. Permette il trasferimento sicuro di dati sensibili da applicativi proprietari ereditati e privi di API documentate, intercettando il payload estratto, eseguendo un controllo di integrità biologico del dato ( DNA Check ) e applicando la cifratura nativa prima dello stivaggio protetto nel Vault offline.

🤖🛡️ 11. Validazione Semantica Offline con IA Locale

Innesto su Protocollo di Trans-Crittazione ( 🤝 5. Crypto Transfer )

Descrizione Breve:
Una pipeline di verifica ad intelligenza artificiale eseguita interamente sul client ( Local-First ) tramite WebNN o modelli LLM integrati nel browser. Prima che il pacchetto dati venga trans-cifrato per l'inoltro di rete verso i gateway della Pubblica Amministrazione, il Service Worker estrae un campione semantico dal plaintext isolato in RAM, eseguendo un'analisi euristica per certificarne la conformità strutturale ed escludere anomalie o corruzioni documentali prima del rilascio.

🏛️🗺️ 12. GEOFENCING PASSIVO SILENZIOSO

( 🏷️ ENDER TAG )

Descrizione Breve:
Il sistema applica un vincolo geografico granulare al blocco binario prima del salvataggio in cache, verificandone la conformità in fase di ripristino ed eseguendo un fallimento controllato senza sollevare eccezioni fatali.

Assets 3
Loading