Генерация детерминированных семантических отпечатков для функций Go. Обнаружение бэкдоров в стиле xz и проверка семантической эквивалентности с использованием анализа Static Single Assignment (SSA) и Scalar Evolution.
sfw — это статический анализатор исходного кода на Go. Он строит SSA с помощью golang.org/x/tools/go/ssa, переписывает каждую функцию в канонический IR и вычисляет отпечаток функции как SHA-256 этого IR. Поверх отпечатка:
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 разбирает каждую команду с помощью пакета flag из Go, который останавливается на первом аргументе, не являющемся флагом; флаги, указанные после имени файла, молча игнорируются.
| Команда | Флаги (по умолчанию) | Аргументы | В песочнице |
|---|---|---|---|
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 сохраняется как указано, без проверки. Любое значение --deps-depth, отличное от transitive, трактуется как direct.
Коды выхода:
| Команда | Код выхода 0 | Код выхода 1 |
|---|---|---|
check | анализ выполнен, даже если файл не удалось загрузить (сообщается в поле error этого файла) | --strict и любой файл завершился с ошибкой; фатальные ошибки |
diff | diff сформирован, независимо от риска | фатальные ошибки |
diff --batch | все пары сравнены, независимо от риска | любая пара завершилась с ошибкой (после вывода всех результатов); фатальные ошибки |
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 приводит к сбою канонизатора вместо вывода UnhandledInstr<T>, а любая ошибка на уровне файла приводит к завершению команды с кодом 1.--scan: топология каждой функции также сопоставляется с базой сигнатур (--db или разрешение по умолчанию) при фиксированном пороге 0.75. Совпадения помещаются в поле 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 сокращена до её статуса и дельты.
Откройте для себя самые используемые инструменты нашего сообщества.
Данных о популярности пока нет.