Genera impronte digitali semantiche deterministiche per le funzioni Go. Rileva backdoor in stile xz e verifica l'equivalenza semantica utilizzando l'analisi Static Single Assignment (SSA) e Scalar Evolution.
sfw è un analizzatore statico per il codice sorgente Go. Costruisce l'SSA con golang.org/x/tools/go/ssa, riscrive ogni funzione in un IR canonico e ne calcola l'impronta digitale come SHA-256 di tale IR. Sulla base dell'impronta digitale:
sfw diff confronta due file funzione per funzione. Abbina le funzioni rinominate in base alla topologia e valuta ogni modifica in base alle capacità che raggiunge di nuovo e alle protezioni, ai controlli e alle impostazioni di sicurezza che rimuove.sfw deps diff confronta il codice di terze parti che due alberi di un modulo compilano: funzioni modificate, funzioni esportate che raggiungono di nuovo una capacità e file modificati che l'analisi non riesce a vedere.sfw audit invia le modifiche ad alto rischio di un diff, il loro codice sorgente e il messaggio di commit a un LLM, che legge il codice (tramite strumenti, con un modello Claude) e decide se il messaggio descrive la modifica.sfw index e sfw scan confrontano le topologie delle funzioni con un archivio di firme (PebbleDB o JSON).L'analisi non esegue mai il codice in esame.
[!CAUTION] Questo strumento è fornito esclusivamente per la ricerca sulla sicurezza difensiva e per i test autorizzati. Non utilizzarlo per creare, distribuire o implementare malware. Gli utenti sono responsabili del rispetto delle leggi applicabili e delle politiche organizzative. L'autore non si assume alcuna responsabilità per usi impropri.
go install github.com/BlackVectorOps/semantic_firewall/v7/cmd/[email protected]
go.mod dichiara go 1.27.2. sfw version stampa la build:
Semantic Firewall CLI
Build: v7.1.1 (Pebble/Gob+PackedIdx)
I flag devono precedere gli argomenti posizionali. La CLI analizza ogni comando con il pacchetto flag di Go, che si ferma al primo argomento non-flag; i flag inseriti dopo un nome di file vengono ignorati silenziosamente.
| Comando | Flag (predefinito) | Argomenti | In sandbox |
|---|---|---|---|
check | --strict (false), --scan (false), --db (""), --no-sandbox (false) | <file.go|dir> | sì |
diff | --no-sandbox (false), --batch ("") | <old.go> <new.go>, oppure nessuno con --batch <pairs-file> | sì |
deps diff | --no-sandbox (false) | <old-module-dir> <new-module-dir> | sì |
audit | --model (claude-opus-5-5), --api-key (""), --api-base (""), --no-sandbox (false) | <old.go> <new.go> "<commit message>" | sì (la fase di diff) |
index | --name (obbligatorio), --severity (HIGH), --category (malware), --db ("") | <file.go|dir> | no |
scan | --db (""), --threshold (0.75), --exact (false), --deps (false), --deps-depth (direct), --no-sandbox (false) | <file.go|dir> | sì |
migrate | --from (obbligatorio), --to (obbligatorio) | nessuno | no |
stats | --db ("") | nessuno | no |
version | nessuno | nessuno | no |
sfw <command> -h elenca i flag di un comando. --severity viene memorizzato così com'è, senza validazione. Qualsiasi valore di --deps-depth diverso da transitive viene trattato come direct.
Codici di uscita:
| Comando | Uscita 0 | Uscita 1 |
|---|---|---|
check | analisi eseguita, anche quando un file non è stato caricato (segnalato nel campo error di quel file) | --strict e qualsiasi file in errore; errori fatali |
diff | diff prodotto, indipendentemente dal rischio | errori fatali |
diff --batch | ogni coppia confrontata, indipendentemente dal rischio | qualsiasi coppia fallita (dopo aver stampato tutti i risultati); errori fatali |
deps diff | diff prodotto, indipendentemente dal rischio | uno dei due alberi non è stato caricato; errori fatali |
scan | scansione eseguita, indipendentemente dagli avvisi | errori fatali (ad es. nessun database) |
audit | verdetto MATCH | verdetto LIE, SUSPICIOUS o ERROR |
diff tratta un file di input mancante come un file vuoto.
Stampa un array JSON con una voce per file. Una directory viene attraversata ricorsivamente, saltando vendor/, le directory nascoste e i file _test.go. I nomi delle funzioni sono qualificati con il pacchetto: un file caricato da solo appartiene a command-line-arguments.
sfw check --no-sandbox new.go
[
{
"file": "new.go",
"functions": [
{ "function": "command-line-arguments.Handle", "fingerprint": "4acdccda3895dd4cec3af2d55ad43489f91860cd226f82091eaf0a2429849e2f", "file": "/work/new.go", "line": 5 },
{ "function": "command-line-arguments.Handle$1", "fingerprint": "1777c5c3ae9a69e395f6bbe8f35a1e447d25534afec7bb907eacf873e7d4917c", "file": "/work/new.go", "line": 7 },
{ "function": "command-line-arguments.Sum", "fingerprint": "7cc1efa6ef6ca643863de5dcb0a68f7c80cd6dae8c530697706f40ce737030ae", "file": "/work/new.go", "line": 10 },
{ "function": "command-line-arguments.init", "fingerprint": "825a2d206f4eb4ea4413c050e4ca9e4b8e439c2067219829a8fef891031a1850", "file": "" }
]
}
]
L'output sopra è stato catturato da un'esecuzione reale, con il percorso assoluto abbreviato in /work e ogni oggetto posto su una singola riga. new.go è il file nell'esempio sfw diff.
--strict: un'istruzione SSA non gestita fa fallire il canonicalizzatore invece di emettere UnhandledInstr<T>, e qualsiasi errore per file fa terminare il comando con codice 1.--scan: la topologia di ciascuna funzione viene inoltre confrontata con il database delle firme (--db, oppure la risoluzione predefinita) a una soglia fissa di 0.75. Le corrispondenze finiscono in un campo scan_results. Un database mancante è un errore fatale.Input:
// old.go
package p
import "fmt"
func Handle(cmd string) { fmt.Println(cmd) }
func Add(a, b int) int { return a + b }
// new.go
package p
import "net"
func Handle(cmd string) {
net.Dial("tcp", cmd)
go func() {}()
}
func Sum(a, b int) int { return a + b }
sfw diff --no-sandbox old.go new.go stampa quanto segue. Questo è l'output completo, tranne per il fatto che la voce init è abbreviata al suo stato e delta.