Go फ़ंक्शन्स के लिए नियतात्मक सिमैंटिक फ़िंगरप्रिंट जनरेट करें। Static Single Assignment (SSA) विश्लेषण और Scalar Evolution का उपयोग करके xz-शैली के बैकडोर का पता लगाएं और सिमैंटिक समतुल्यता सत्यापित करें।
sfw Go स्रोत के लिए एक स्टैटिक विश्लेषक है। यह golang.org/x/tools/go/ssa के साथ SSA बनाता है, प्रत्येक फ़ंक्शन को एक कैनोनिकल IR में पुनर्लिखित करता है, और उस IR के SHA-256 के रूप में फ़ंक्शन को फ़िंगरप्रिंट करता है। फ़िंगरप्रिंट के ऊपर:
sfw diff दो फ़ाइलों की फ़ंक्शन-दर-फ़ंक्शन तुलना करता है। यह नाम बदले गए फ़ंक्शन को टोपोलॉजी द्वारा मिलाता है और प्रत्येक परिवर्तन को उन क्षमताओं के आधार पर स्कोर करता है जिन तक वह नई पहुँच बनाता है और उन गार्ड, जाँच और सुरक्षा सेटिंग्स के आधार पर जिन्हें वह हटाता है।sfw deps diff किसी मॉड्यूल के दो ट्री में संकलित होने वाले तृतीय-पक्ष कोड की तुलना करता है: बदले गए फ़ंक्शन, नई क्षमता तक पहुँचने वाले निर्यातित फ़ंक्शन, और वे बदली हुई फ़ाइलें जिन्हें विश्लेषण नहीं देख सकता।sfw audit किसी diff के उच्च-जोखिम वाले परिवर्तनों, उनके स्रोत और कमिट संदेश को एक 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": "" }
]
}
]
ऊपर दिया गया आउटपुट एक वास्तविक रन से कैप्चर किया गया था, जिसमें absolute path को छोटा करके /work कर दिया गया है और प्रत्येक object को एक पंक्ति में रखा गया है। new.go वह फ़ाइल है जो sfw diff उदाहरण में है।
--strict: एक unhandled SSA instruction canonicalizer को UnhandledInstr<T> उत्सर्जित करने के बजाय विफल कर देता है, और कोई भी per-file error कमांड को exit 1 पर समाप्त कर देता है।--scan: प्रत्येक function की topology को 0.75 की निश्चित threshold पर signature database (--db, या default resolution) के विरुद्ध भी मिलाया जाता है। मिलान scan_results फ़ील्ड में जाते हैं। database का अनुपस्थित होना एक fatal error है।इनपुट:
// 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 प्रविष्टि को उसकी स्थिति और डेल्टा तक संक्षिप्त किया गया है।