Gere impressões digitais semânticas determinísticas para funções Go. Detete backdoors ao estilo xz e verifique a equivalência semântica usando análise Static Single Assignment (SSA) e Scalar Evolution.
sfw é um analisador estático para código-fonte Go. Ele constrói SSA com golang.org/x/tools/go/ssa, reescreve cada função em uma IR canônica e gera a impressão digital da função como o SHA-256 dessa IR. Sobre a impressão digital:
sfw diff compara dois arquivos função por função. Ele associa funções renomeadas por topologia e pontua cada alteração pelas capacidades que ela passa a alcançar e pelas proteções, verificações e configurações de segurança que ela remove.sfw deps diff compara o código de terceiros que duas árvores de um módulo compilam: funções alteradas, funções exportadas que passam a alcançar uma capacidade e arquivos alterados que a análise não consegue ver.sfw audit envia as alterações de alto risco de um diff, seu código-fonte e a mensagem de commit para um LLM, que lê o código (por meio de ferramentas, com um modelo Claude) e decide se a mensagem descreve a alteração.sfw index e sfw scan comparam topologias de funções com um armazenamento de assinaturas (PebbleDB ou JSON).A análise nunca executa o código em teste.
[!CAUTION] Esta ferramenta é fornecida apenas para pesquisa de segurança defensiva e testes autorizados. Não a utilize para criar, distribuir ou implantar malware. Os usuários são responsáveis pelo cumprimento das leis e políticas organizacionais aplicáveis. O autor não assume qualquer responsabilidade pelo uso indevido.
go install github.com/BlackVectorOps/semantic_firewall/v7/cmd/[email protected]
go.mod declara go 1.27.2. sfw version imprime a compilação:
Semantic Firewall CLI
Build: v7.1.1 (Pebble/Gob+PackedIdx)
As flags devem vir antes dos argumentos posicionais. A CLI analisa cada comando com o pacote flag do Go, que para no primeiro argumento que não seja flag; flags colocadas após um nome de arquivo são silenciosamente ignoradas.
| Comando | Flags (padrão) | Argumentos | Em sandbox |
|---|---|---|---|
check | --strict (false), --scan (false), --db (""), --no-sandbox (false) | <file.go|dir> | sim |
diff | --no-sandbox (false), --batch ("") | <old.go> <new.go>, ou nenhum com --batch <pairs-file> | sim |
deps diff | --no-sandbox (false) | <old-module-dir> <new-module-dir> | sim |
audit | --model (claude-opus-5-5), --api-key (""), --api-base (""), --no-sandbox (false) | <old.go> <new.go> "<commit message>" | sim (a etapa de diff) |
index | --name (obrigatório), --severity (HIGH), --category (malware), --db ("") | <file.go|dir> | não |
scan | --db (""), --threshold (0.75), --exact (false), --deps (false), --deps-depth (direct), --no-sandbox (false) | <file.go|dir> | sim |
migrate | --from (obrigatório), --to (obrigatório) | nenhum | não |
stats | --db ("") | nenhum | não |
version | nenhum | nenhum | não |
sfw <command> -h lista as flags de um comando. --severity é armazenado como fornecido, sem validação. Qualquer valor de --deps-depth diferente de transitive é tratado como direct.
Códigos de saída:
| Comando | Saída 0 | Saída 1 |
|---|---|---|
check | análise executada, mesmo quando um arquivo falhou ao carregar (reportado no campo error desse arquivo) | --strict e qualquer arquivo com erro; erros fatais |
diff | diff produzido, independentemente do risco | erros fatais |
diff --batch | todos os pares comparados, independentemente do risco | qualquer par falhou (após imprimir todos os resultados); erros fatais |
deps diff | diff produzido, independentemente do risco | qualquer uma das árvores falhou ao carregar; erros fatais |
scan | varredura executada, independentemente dos alertas | erros fatais (por exemplo, nenhum banco de dados) |
audit | veredito MATCH | veredito LIE, SUSPICIOUS ou ERROR |
diff trata um arquivo de entrada ausente como um arquivo vazio.
Imprime um array JSON com uma entrada por arquivo. Um diretório é percorrido recursivamente, ignorando vendor/, diretórios ocultos e arquivos _test.go. Os nomes de função são qualificados pelo pacote: um arquivo carregado isoladamente pertence a 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": "" }
]
}
]
A saída acima foi capturada de uma execução real, com o caminho absoluto encurtado para /work e cada objeto colocado em uma linha. new.go é o arquivo no exemplo de sfw diff.
--strict: uma instrução SSA não tratada faz o canonicalizador falhar em vez de emitir UnhandledInstr<T>, e qualquer erro por arquivo faz o comando sair com código 1.--scan: a topologia de cada função também é comparada com o banco de dados de assinaturas (--db, ou a resolução padrão) em um limite fixo de 0.75. As correspondências vão em um campo scan_results. Um banco de dados ausente é um erro fatal.Entrada:
// 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 imprime o seguinte. Esta é a saída completa, exceto que a entrada init é abreviada para seu status e delta.