Erzeuge deterministische semantische Fingerabdrücke für Go-Funktionen. Erkenne Backdoors im xz-Stil und verifiziere semantische Äquivalenz mithilfe von Static Single Assignment (SSA)-Analyse und Scalar Evolution.
sfw ist ein statischer Analyzer für Go-Quellcode. Er erzeugt SSA mit golang.org/x/tools/go/ssa, schreibt jede Funktion in eine kanonische IR um und bildet den Fingerabdruck der Funktion als SHA-256 dieser IR. Aufbauend auf dem Fingerabdruck:
sfw diff vergleicht zwei Dateien Funktion für Funktion. Umbenannte Funktionen werden anhand ihrer Topologie zugeordnet, und jede Änderung wird danach bewertet, welche Fähigkeiten sie neu erreicht und welche Guards, Prüfungen und Sicherheitseinstellungen sie entfernt.sfw deps diff vergleicht den Drittanbieter-Code, den zwei Bäume eines Moduls kompilieren: geänderte Funktionen, exportierte Funktionen, die neu eine Fähigkeit erreichen, und geänderte Dateien, die die Analyse nicht sehen kann.sfw audit sendet die risikoreichen Änderungen eines Diffs, ihren Quellcode und die Commit-Nachricht an ein LLM, das den Code (über Tools, mit einem Claude-Modell) liest und entscheidet, ob die Nachricht die Änderung beschreibt.sfw index und sfw scan gleichen Funktions-Topologien gegen einen Signaturspeicher ab (PebbleDB oder JSON).Die Analyse führt den zu testenden Code niemals aus.
[!CAUTION] Dieses Tool wird ausschließlich für defensive Sicherheitsforschung und autorisierte Tests bereitgestellt. Verwenden Sie es nicht, um Malware zu erstellen, zu verbreiten oder einzusetzen. Benutzer sind für die Einhaltung geltender Gesetze und organisatorischer Richtlinien verantwortlich. Der Autor übernimmt keine Haftung für Missbrauch.
go install github.com/BlackVectorOps/semantic_firewall/v7/cmd/[email protected]
go.mod deklariert go 1.27.2. sfw version gibt den Build aus:
Semantic Firewall CLI
Build: v7.1.1 (Pebble/Gob+PackedIdx)
Flags müssen vor den Positionsargumenten stehen. Die CLI parst jeden Befehl mit Go's flag-Paket, das beim ersten Nicht-Flag-Argument stoppt; Flags, die nach einem Dateinamen platziert werden, werden stillschweigend ignoriert.
| Befehl | Flags (Standard) | Argumente | Sandboxed |
|---|---|---|---|
check | --strict (false), --scan (false), --db (""), --no-sandbox (false) | <file.go|dir> | ja |
diff | --no-sandbox (false), --batch ("") | <old.go> <new.go>, oder keines mit --batch <pairs-file> | ja |
deps diff | --no-sandbox (false) | <old-module-dir> <new-module-dir> | ja |
audit | --model (claude-opus-5-5), --api-key (""), --api-base (""), --no-sandbox (false) | <old.go> <new.go> "<commit message>" | ja (der Diff-Schritt) |
index | --name (erforderlich), --severity (HIGH), --category (malware), --db ("") | <file.go|dir> | nein |
scan | --db (""), --threshold (0.75), --exact (false), --deps (false), --deps-depth (direct), --no-sandbox (false) | <file.go|dir> | ja |
migrate | --from (erforderlich), --to (erforderlich) | keine | nein |
stats | --db ("") | keine | nein |
version | keine | keine | nein |
sfw <command> -h listet die Flags eines Befehls auf. --severity wird so gespeichert, wie angegeben, ohne Validierung. Jeder --deps-depth-Wert außer transitive wird als direct behandelt.
Exit-Codes:
| Befehl | Exit 0 | Exit 1 |
|---|---|---|
check | Analyse lief, selbst wenn eine Datei nicht geladen werden konnte (im error-Feld dieser Datei gemeldet) | --strict und eine Datei ist fehlgeschlagen; fatale Fehler |
diff | Diff erzeugt, unabhängig vom Risiko | fatale Fehler |
diff --batch | jedes Paar gediffed, unabhängig vom Risiko | ein Paar fehlgeschlagen (nach Ausgabe aller Ergebnisse); fatale Fehler |
deps diff | Diff erzeugt, unabhängig vom Risiko | einer der Bäume konnte nicht geladen werden; fatale Fehler |
scan | Scan lief, unabhängig von Warnungen | fatale Fehler (z. B. keine Datenbank) |
audit | Urteil MATCH | Urteil LIE, SUSPICIOUS oder ERROR |
diff behandelt eine fehlende Eingabedatei als leere Datei.
Gibt ein JSON-Array mit einem Eintrag pro Datei aus. Ein Verzeichnis wird rekursiv durchlaufen, wobei vendor/, versteckte Verzeichnisse und _test.go-Dateien übersprungen werden. Funktionsnamen sind paketqualifiziert: eine Datei, die eigenständig geladen wird, gehört zu 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": "" }
]
}
]
Die obige Ausgabe wurde aus einem echten Lauf erfasst, wobei der absolute Pfad zu /work verkürzt und jedes Objekt in eine Zeile gesetzt wurde. new.go ist die Datei im Beispiel sfw diff.
--strict: Eine nicht behandelte SSA-Anweisung führt dazu, dass der Canonicalizer fehlschlägt, anstatt UnhandledInstr<T> auszugeben, und jeder dateispezifische Fehler führt dazu, dass der Befehl mit Exit-Code 1 beendet wird.--scan: Die Topologie jeder Funktion wird zusätzlich gegen die Signaturdatenbank (--db oder die Standardauflösung) mit einem festen Schwellenwert von 0.75 abgeglichen. Die Treffer werden in einem Feld scan_results abgelegt. Eine fehlende Datenbank ist ein fataler Fehler.Eingabe:
// 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 gibt Folgendes aus. Dies ist die vollständige Ausgabe, mit der Ausnahme, dass der init-Eintrag auf seinen Status und sein Delta gekürzt ist.