Go 함수에 대한 결정론적 시맨틱 지문을 생성합니다. SSA(Static Single Assignment) 분석과 Scalar Evolution을 사용하여 xz 스타일 백도어를 탐지하고 시맨틱 동등성을 검증합니다.
sfw는 Go 소스용 정적 분석기입니다. golang.org/x/tools/go/ssa로 SSA를 구축하고, 각 함수를 정규 IR로 재작성한 뒤, 해당 IR의 SHA-256으로 함수를 핑거프린팅합니다. 이 핑거프린트 위에서:
sfw diff는 두 파일을 함수 단위로 비교합니다. 이름이 변경된 함수는 토폴로지로 매칭하고, 각 변경 사항은 새로 도달하게 된 기능(capability)과 제거된 가드, 검사, 보안 설정을 기준으로 점수를 매깁니다.sfw deps diff는 모듈의 두 트리가 컴파일하는 서드파티 코드를 비교합니다: 변경된 함수, 새로 기능에 도달하게 된 내보낸 함수, 그리고 분석이 볼 수 없는 변경된 파일.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는 입력 파일이 없으면 빈 파일로 처리합니다.
파일당 하나의 항목을 가진 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로 축약되었고 각 객체는 한 줄에 배치되었습니다. 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[]" }
]
}