Strumenti

/lagune-prove: proof of concept esclusivamente difensiva

Trasforma ogni rilievo individuato in una proof of concept (PoC) eseguibile ed esclusivamente difensiva e in un bollettino per la divulgazione responsabile.

🧪 Trasforma ogni rilievo individuato in un'evidenza eseguibile ed esclusivamente difensiva per la divulgazione responsabile.

Per ogni rilievo presente nella mappa di detect, scrive un bollettino autosufficiente e un test che verifica il percorso sicuro, così il test fallisce finché il problema è presente e passa non appena il codice viene corretto.

suggerimento

I test di Lagune restano isolati in .lagune/, separati dalla tua suite.

Come usarlo​

/lagune-prove

Come funziona​

Legge il sorgente a cui punta ogni rilievo e scrive una directory per ogni rilievo dimostrato in .lagune/proofs/, con esattamente due file:

FileChe cos'è
report.test.mjs (o .cjs)Il test. Gira su Poku quando il tuo progetto lo usa già, altrimenti sul runner nativo di Node.js, quindi non richiede nulla di installato.
report.mdUn bollettino autosufficiente: gravità, impatto, come si riproduce e il comando per eseguirlo, leggibile da solo.

Le prove sono sempre in JavaScript, così restano portabili qualunque sia il linguaggio del tuo progetto. Un indice README.md collega ogni prova e fornisce un unico comando per eseguirle tutte.

suggerimento
  • È facoltativo e autonomo: non è una delle cinque fasi e non fa parte della catena di tracciamento.
  • Scrive solo in .lagune/proofs/ e non tocca mai gli artefatti delle fasi né il tuo codice, che si limita a leggere.
  • Un rilievo il cui test non riproduce il problema non riceve alcuna prova, e ti dice di eseguire /lagune-detect su quel punto per riconciliare.
  • Eseguirlo di nuovo riconcilia le prove: un rilievo che non c'è più o che non si riproduce più perde la sua directory.
important

Viene eseguito solo quando lo richiami: l'agente non lo avvia mai di propria iniziativa.

Si basa su detect

Prove legge la mappa di detect prodotta da /lagune-detect, quindi esegui prima detect.

Solo difesa, e con autorizzazione​

Prima di generare qualsiasi cosa, conferma che tu sia autorizzato a testare il bersaglio, e rifiuta qualsiasi richiesta di exploit funzionante, payload di attacco o elusione del rilevamento. Una prova dimostra il comportamento sicuro e non emette mai un input di attacco.

Dalla prova alla divulgazione​

I due file di ogni rilievo dimostrato vanno insieme in un GitHub Gist privato per segnalare la vulnerabilità. Sono l'evidenza di un problema presente e non ancora divulgato, quindi un .gitignore dentro .lagune/proofs/ li tiene fuori da ogni commit: condividili solo tramite quel Gist finché i maintainer non l'hanno risolto.

Chiudere un rilievo nella catena di Lagune resta compito di /lagune-harden e /lagune-verify: prove produce evidenze, non chiude nulla.

Domande frequenti

No. /lagune-prove scrive evidenze esclusivamente difensive: un test che verifica il percorso sicuro, così fallisce finché il problema è presente e passa non appena il codice viene corretto, più un bollettino per la divulgazione responsabile.

Due file per rilievo: un test (report.test.mjs o .cjs) e un bollettino (report.md).

Prove scrive un bollettino autosufficiente che puoi condividere tramite un canale privato, come un GitHub Gist privato, seguendo la divulgazione responsabile.