Go関数の決定論的セマンティックフィンガープリントを生成します。SSA(静的単一割り当て)解析とスカラー進化解析を用いて、xzスタイルのバックドアを検出し、セマンティック等価性を検証します。
sfw は Go ソースコード用の静的アナライザです。golang.org/x/tools/go/ssa を使って SSA を構築し、各関数を正規化された IR に書き換え、その IR の SHA-256 として関数をフィンガープリント化します。このフィンガープリントに基づいて、以下を提供します:
sfw diff は 2 つのファイルを関数単位で比較します。リネームされた関数はトポロジーによってマッチングし、各変更を、新たに到達するケイパビリティと、削除されたガード、チェック、セキュリティ設定によってスコアリングします。sfw deps diff は、モジュールの 2 つのツリーがコンパイルするサードパーティコードを比較します: 変更された関数、新たにケイパビリティに到達するエクスポート関数、および解析が認識できない変更ファイル。sfw audit は、diff の高リスクな変更、そのソース、およびコミットメッセージを LLM に送信します。LLM は(ツールを通じて、Claude モデルで)コードを読み、メッセージがその変更を説明しているかどうかを判断します。sfw index と sfw scan は、関数のトポロジーをシグネチャストア(PebbleDB または JSON)と照合します。解析はテスト対象のコードを決して実行しません。
[!CAUTION] このツールは防御的セキュリティ研究および許可されたテストのみを目的として提供されています。マルウェアの作成、配布、またはデプロイに使用しないでください。ユーザーは適用される法律および組織のポリシーへの準拠に責任を負います。作者は誤用に対して一切の責任を負いません。
go install github.com/BlackVectorOps/semantic_firewall/v7/cmd/[email protected]
go.mod は go 1.27.2 を宣言しています。sfw version はビルドを出力します:
Semantic Firewall CLI
Build: v7.1.1 (Pebble/Gob+PackedIdx)
フラグは位置引数より前に指定する必要があります。CLI は各コマンドを Go の flag パッケージで解析しますが、これは最初の非フラグ引数で停止するため、ファイル名の後に置かれたフラグは黙って無視されます。
| コマンド | フラグ(デフォルト) | 引数 | サンドボックス化 |
|---|---|---|---|
check | --strict (false), --scan (false), --db (""), --no-sandbox (false) | <file.go|dir> | はい |
diff | --no-sandbox (false), --batch ("") | <old.go> <new.go>、または --batch <pairs-file> 指定時はなし | はい |
deps diff | --no-sandbox (false) | <old-module-dir> <new-module-dir> | はい |
audit | --model (claude-opus-5-5), --api-key (""), --api-base (""), --no-sandbox (false) | <old.go> <new.go> "<commit message>" | はい(diff ステップ) |
index | --name (必須), --severity (HIGH), --category (malware), --db ("") | <file.go|dir> | いいえ |
scan | --db (""), --threshold (0.75), --exact (false), --deps (false), --deps-depth (direct), --no-sandbox (false) | <file.go|dir> | はい |
migrate | --from (必須), --to (必須) | なし | いいえ |
stats | --db ("") | なし | いいえ |
version | なし | なし | いいえ |
sfw <command> -h はコマンドのフラグを一覧表示します。--severity は検証なしで指定されたまま保存されます。transitive 以外の --deps-depth 値はすべて direct として扱われます。
終了コード:
| コマンド | 終了コード 0 | 終了コード 1 |
|---|---|---|
check | 解析が実行された(ファイルの読み込みに失敗した場合でも、そのファイルの error フィールドで報告される) | --strict 指定かついずれかのファイルでエラー; 致命的エラー |
diff | リスクに関係なく diff が生成された | 致命的エラー |
diff --batch | すべてのペアが diff された(リスクに関係なく) | いずれかのペアが失敗(すべての結果を出力した後); 致命的エラー |
deps diff | リスクに関係なく diff が生成された | いずれかのツリーの読み込みに失敗; 致命的エラー |
scan | アラートに関係なくスキャンが実行された | 致命的エラー(例: データベースがない) |
audit | 判定 MATCH | 判定 LIE、SUSPICIOUS または ERROR |
diff は存在しない入力ファイルを空のファイルとして扱います。
ファイルごとに 1 エントリを持つ JSON 配列を出力します。ディレクトリは再帰的に走査され、vendor/、隠しディレクトリ、_test.go ファイルはスキップされます。関数名はパッケージ修飾されます。単独で読み込まれたファイルは 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": "" }
]
}
]
上記の出力は実際の実行から取得したもので、絶対パスは /work に短縮され、各オブジェクトは 1 行にまとめられています。new.go は sfw diff の例にあるファイルです。
--strict: 処理されていない SSA 命令があると、canonicalizer は UnhandledInstr<T> を出力する代わりに失敗し、ファイルごとのエラーが発生するとコマンドは終了コード 1 で終了します。--scan: 各関数のトポロジーは、固定しきい値 0.75 でシグネチャデータベース(--db、またはデフォルトの解決方法)とも照合されます。一致結果は scan_results フィールドに格納されます。データベースが見つからない場合は致命的エラーとなります。入力:
// 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 は以下を出力します。これは完全な出力ですが、init エントリはステータスと差分のみに省略されています。
{
"old_file": "old.go",
"new_file": "new.go",
"summary": {
"total_functions": 4,
"preserved": 0,
"modified": 3,
"added": 1,
"removed": 0,
"semantic_match_pct": 0,
"topology_matched_pct": 75,
"renamed_functions": 1,
"high_risk_changes": 1
},
"functions": [
{
"function": "Handle",
"status": "modified",
"fingerprint_match": false,
"old_fingerprint": "f735eacc97909969c02c6c115696e44282599242dfb7ebc5f8450894210caecf",
"new_fingerprint": "4acdccda3895dd4cec3af2d55ad43489f91860cd226f82091eaf0a2429849e2f",
"matched_nodes": 1,
"added_ops": ["go Handle$1()", "t0 = net.Dial(\"tcp\":string, cmd)"],
"removed_ops": ["*t1 = t2", "t0 = new [1]any (varargs)", "t1 = &t0[0:int]", "t2 = make any <- string (cmd)", "t3 = slice t0[:]", "t4 = fmt.Println(t3...)"],
"risk_score": 30,
"topology_delta": "Capability+network(net.Dial), Calls-1, AddedGoroutine, StringLiterals~, Entropy+1.6"
},
{
"function": "init",
"status": "modified",
"...": "...",
"topology_delta": "NoStructuralChange"
},
{
"function": "Add → Sum",
"status": "renamed",
"fingerprint_match": true,
"old_fingerprint": "7cc1efa6ef6ca643863de5dcb0a68f7c80cd6dae8c530697706f40ce737030ae",
"new_fingerprint": "7cc1efa6ef6ca643863de5dcb0a68f7c80cd6dae8c530697706f40ce737030ae"
},
{
"function": "Handle$1",
"status": "added",
"fingerprint_match": false,
"new_fingerprint": "1777c5c3ae9a69e395f6bbe8f35a1e447d25534afec7bb907eacf873e7d4917c",
"risk_score": 5,
"topology_delta": "NewFunction"
}
],
"topology_matches": [
{ "old_function": "Handle", "new_function": "Handle", "similarity": 0.7048387096774194, "matched_by_name": true, "old_topology": "L0B0I7[fmt.Println]", "new_topology": "L0B0I3[go:closure:func(),net.Dial]" },
{ "old_function": "init", "new_function": "init", "similarity": 0.7419354838709677, "matched_by_name": true, "old_topology": "L0B1I6[fmt.init]", "new_topology": "L0B1I6[net.init]" },
{ "old_function": "Add", "new_function": "Sum", "similarity": 1, "matched_by_name": false, "old_topology": "L0B0I2[]", "new_topology": "L0B0I2[]" }
]
}