Genera huellas digitales semánticas deterministas para funciones de Go. Detecta backdoors al estilo xz y verifica la equivalencia semántica mediante análisis de Asignación Única Estática (SSA) y Evolución Escalar.
sfw es un analizador estático para código fuente Go. Construye SSA con golang.org/x/tools/go/ssa, reescribe cada función en una IR canónica y genera una huella digital de la función como el SHA-256 de esa IR. Sobre la huella digital:
sfw diff compara dos archivos función por función. Empareja funciones renombradas por topología y puntúa cada cambio según las capacidades que alcanza de nuevo y las protecciones, comprobaciones y configuraciones de seguridad que elimina.sfw deps diff compara el código de terceros que compilan dos árboles de un módulo: funciones modificadas, funciones exportadas que alcanzan una capacidad de nuevo y archivos modificados que el análisis no puede ver.sfw audit envía los cambios de alto riesgo de un diff, su código fuente y el mensaje de commit a un LLM, que lee el código (mediante herramientas, con un modelo Claude) y decide si el mensaje describe el cambio.sfw index y sfw scan emparejan topologías de funciones contra un almacén de firmas (PebbleDB o JSON).El análisis nunca ejecuta el código bajo prueba.
[!CAUTION] Esta herramienta se proporciona únicamente para investigación en seguridad defensiva y pruebas autorizadas. No la utilices para crear, distribuir o desplegar malware. Los usuarios son responsables del cumplimiento de las leyes aplicables y las políticas organizativas. El autor no asume ninguna responsabilidad por el uso indebido.
go install github.com/BlackVectorOps/semantic_firewall/v7/cmd/[email protected]
go.mod declara go 1.27.2. sfw version imprime la compilación:
Semantic Firewall CLI
Build: v7.1.1 (Pebble/Gob+PackedIdx)
Los flags deben ir antes de los argumentos posicionales. La CLI analiza cada comando con el paquete flag de Go, que se detiene en el primer argumento que no es un flag; los flags colocados después de un nombre de archivo se ignoran silenciosamente.
| Comando | Flags (predeterminado) | Argumentos | En sandbox |
|---|---|---|---|
check | --strict (false), --scan (false), --db (""), --no-sandbox (false) | <file.go|dir> | sí |
diff | --no-sandbox (false), --batch ("") | <old.go> <new.go>, o ninguno con --batch <pairs-file> | sí |
deps diff | --no-sandbox (false) | <old-module-dir> <new-module-dir> | sí |
audit | --model (claude-opus-5-5), --api-key (""), --api-base (""), --no-sandbox (false) | <old.go> <new.go> "<commit message>" | sí (el paso de diff) |
index | --name (obligatorio), --severity (HIGH), --category (malware), --db ("") | <file.go|dir> | no |
scan | --db (""), --threshold (0.75), --exact (false), --deps (false), --deps-depth (direct), --no-sandbox (false) | <file.go|dir> | sí |
migrate | --from (obligatorio), --to (obligatorio) | ninguno | no |
stats | --db ("") | ninguno | no |
version | ninguno | ninguno | no |
sfw <command> -h lista los flags de un comando. --severity se almacena tal como se proporciona, sin validación. Cualquier valor de --deps-depth distinto de transitive se trata como direct.
Códigos de salida:
| Comando | Salida 0 | Salida 1 |
|---|---|---|
check | el análisis se ejecutó, incluso cuando un archivo no se pudo cargar (reportado en el campo error de ese archivo) | --strict y algún archivo dio error; errores fatales |
diff | diff generado, independientemente del riesgo | errores fatales |
diff --batch | todos los pares comparados con diff, independientemente del riesgo | cualquier par falló (después de imprimir todos los resultados); errores fatales |
deps diff | diff generado, independientemente del riesgo | cualquiera de los árboles no se pudo cargar; errores fatales |
scan | el escaneo se ejecutó, independientemente de las alertas | errores fatales (p. ej. sin base de datos) |
audit | veredicto MATCH | veredicto LIE, SUSPICIOUS o ERROR |
diff trata un archivo de entrada faltante como un archivo vacío.
Imprime un array JSON con una entrada por archivo. Un directorio se recorre recursivamente, omitiendo vendor/, los directorios ocultos y los archivos _test.go. Los nombres de funciones están cualificados por paquete: un archivo cargado por sí solo pertenece 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": "" }
]
}
]
La salida anterior se capturó de una ejecución real, con la ruta absoluta acortada a /work y cada objeto colocado en una sola línea. new.go es el archivo del ejemplo de sfw diff.
--strict: una instrucción SSA no manejada hace que el canonicalizador falle en lugar de emitir UnhandledInstr<T>, y cualquier error por archivo hace que el comando salga con código 1.--scan: la topología de cada función también se compara con la base de datos de firmas (--db, o la resolución predeterminada) con un umbral fijo de 0.75. Las coincidencias se colocan en un campo scan_results. Una base de datos ausente es un error 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 lo siguiente. Esta es la salida completa, excepto que la entrada init se abrevia a su estado y delta.