
foxguard v0.13.0
Un escáner de seguridad de código rápido y universal, escrito en Rust. Baterías incluidas: soporta 14 idiomas, TUI para triaje, secretos, auditorías post-cuánticas, escaneos con detección de diferencias y más 𓃥
foxguard
Escaneo de seguridad local y rápido para código, secretos, dependencias y riesgo criptográfico.
Integrado en 0sec, el arnés de ciberseguridad de código abierto.
npx foxguard .
Por qué
Más de 200 reglas integradas en 12 lenguajes fuente, además de comprobaciones de configuración y manifiestos
Seguimiento de taint para 14 lenguajes, con análisis entre archivos para Python, JavaScript, Go, Java, Ruby, PHP, C# y Kotlin
Escaneos locales y de CI rápidos, con modo diff para “¿qué añadió esta rama?”
Escaneo de secretos, escaneo de dependencias respaldado por OSV y auditoría de criptografía post-cuántica
Puente YAML compatible con Semgrep/OpenGrep que carga ~98% del registro público (informe de cobertura)
Salida en terminal, JSON, SARIF, CycloneDX 1.6 CBOM y JSON compatible con Semgrep
Instalación
npx foxguard . # zero install
pipx install foxguard # prebuilt CLI from PyPI
curl -fsSL https://foxguard.dev/install.sh | sh # prebuilt binary (macOS/Linux)
cargo install foxguard # from source
Los instaladores binarios independientes verifican los binarios de las versiones de GitHub contra checksums.txt. Los binarios de las versiones también publican atestaciones de artefactos de GitHub; use gh attestation verify para la verificación manual, o consulte procedencia de la versión.
Los wheels de PyPI son compatibles con Python 3.9+ en Linux glibc 2.28+ (x86_64/ARM64), macOS
(Intel/Apple Silicon) y Windows x86_64. En un entorno virtual de Python existente,
use python -m pip install foxguard en su lugar. Estos instalan la CLI nativa
sin un compilador de Rust ni una descarga de binario en tiempo de ejecución; no se
proporciona ninguna API de Python. Los usuarios de Alpine/musl deben usar los binarios independientes de la versión de Linux.
GitHub Action:
- uses: 0sec-labs/foxguard/[email protected]
with:
path: .
severity: medium
fail-on-findings: "true"
upload-sarif: "true"
pre-commit:
repos:
- repo: https://github.com/0sec-labs/foxguard
rev: v0.14.2
hooks:
- id: foxguard
Integraciones: GitHub App, VS Code, Claude Code plugin, y MCP server.
Operaciones alojadas de GitHub App
foxguard-github-app escribe logs JSON delimitados por saltos de línea. Los escaneos completados y fallidos usan event=foxguard.scan.completed y event=foxguard.scan.failed, con campos de delivery, installation, repository, PR, commit, duration y usage_scope para correlación. Mantén los identificadores como campos de log, no como etiquetas de métricas.
Configura FOXGUARD_INTERNAL_ACCOUNTS con una lista separada por comas de tus propias cuentas y organizaciones de GitHub. La coincidencia no distingue mayúsculas de minúsculas. Otros propietarios se clasifican como external; una lista no configurada o un propietario ausente produce unknown. La actividad externa no es prueba de un cliente de pago, y los escaneos no son personas.
El registro de instalaciones se reconcilia con todas las páginas de la API de instalaciones de la App de GitHub al inicio y cada hora. Las actualizaciones fallidas conservan el estado existente; los webhooks concurrentes tienen prioridad. Los metadatos escasos de webhook preservan los detalles conocidos de la cuenta y los nombres de repositorios observados. Esos nombres no son un inventario completo de los repositorios accesibles de una instalación.
Persiste FOXGUARD_INSTALLATIONS_PATH y FOXGUARD_PULL_REQUEST_JOBS_PATH en almacenamiento duradero. Monitorea foxguard.installations.reconcile_failed junto con los fallos de escaneo; foxguard.installations.reconciled informa el total y los recuentos de instalaciones internas/externas/desconocidas tras una actualización exitosa. Dimensiona FOXGUARD_PR_WORKERS según el pico de memoria medido del escáner y el límite de memoria del contenedor: las terminaciones por OOM de procesos hijos pueden ocurrir sin reiniciar la aplicación alojada.