agent-bom v0.97.4

_{Las marcas anteriores representan backends compatibles de descubrimiento, escaneo, conexión, despliegue o evidencia, no una profundidad de conector idéntica. Consulta la matriz de capacidades.}

Escáner de seguridad de código abierto y plano de control autoalojado para infraestructura de IA, MCP y nube.

15 ecosistemas de paquetes · 16 superficies de cumplimiento · 84 herramientas MCP · sin necesidad de cuenta
Inicio rápido · Demo en vivo · Documentación

Descubre → Escanea → Correlaciona → Actúa

agent-bom escanea repositorios y cadenas de suministro de software en SCA, secretos, IaC y contenedores; inventaría agentes de IA, MCP, modelos y conjuntos de datos; y conecta fuentes de nube, identidad, Snowflake y datos de solo lectura. Normaliza esa evidencia en un único modelo de Hallazgo + UnifiedGraph, correlaciona el riesgo alcanzable y luego lleva el trabajo a través del propietario, la corrección, la verificación, la evidencia de cumplimiento o la política de ejecución.

entrada de agente o herramienta → servidor MCP → paquete → hallazgo → impacto → propietario → corrección → verificación

Ejecuta ad hoc localmente o en CI, o usa tu plano de control autoalojado para escaneos programados o conectados, historial, asignaciones y aplicación en tiempo de ejecución. El código fuente y las credenciales sin procesar permanecen dentro del límite de ejecución controlado por el cliente; las relaciones recopiladas, inferidas, estáticas y de tiempo de ejecución permanecen distintas; la evidencia incompleta permanece explícita.

Inicio rápido · Flujo de trabajo de evidencia · Matriz de capacidades de integración · Prueba del comparador medido · Arquitectura del plano de control

Para quién es

La ingeniería de seguridad y el GRC siguen siendo flujos de trabajo separados: los hallazgos y la alcanzabilidad no se presentan como certificación de auditoría. Consulta límites del producto.

Recorrido del producto

Las capturas siguientes utilizan un entorno de muestra etiquetado visiblemente; los escaneos en vivo usan los mismos contratos de Hallazgo + UnifiedGraph. Selecciona cualquier imagen para ver la prueba a tamaño completo.

1 · Descubre el inventario	2 · Escanea
3 · Gráfico alcanzable	4 · Ruta clasificada
5 · Actúa y verifica

Continúa con la aplicación en tiempo de ejecución en la galería completa del producto · Protocolo de captura

Inicio rápido

Empieza aquí. Esta es la puerta de entrada: dos comandos, sin cuenta, sin configuración. La muestra sin conexión se completa sin descargar una base de datos de avisos y muestra la forma de salida del inventario, los hallazgos y el radio de explosión.

pip install agent-bom
agent-bom scan --demo --offline

La muestra contiene intencionalmente un paquete conocido como malicioso, por lo que el estado de salida 1 es esperado y el informe impreso está completo. Escanea un repositorio a continuación:

agent-bom scan .

El escaneo del repositorio muestra inventario, hallazgos e impacto alcanzable. agent-bom scan . y agent-bom scan -p . son el mismo comando; PATH es un alias de --project.

¿Necesitas un escaneo sin conexión? Siembra primero la base de datos más pequeña de avisos de paquetes:

agent-bom db update --osv-ecosystem PyPI
agent-bom scan . --offline

Si esa base de datos falta o no se puede leer, el escaneo escribe un artefacto parcial cuando se establece -o y sale con 1; por lo tanto, la CI no puede confundir la cobertura de avisos no disponible con un escaneo limpio.

En una base de datos nueva, ese comando cubre solo el ecosistema seleccionado; los paquetes de otros ecosistemas permanecen como brechas de cobertura sin conexión explícitas. Repite --osv-ecosystem para un repositorio políglota, o usa agent-bom db update --source osv para el archivo de todos los ecosistemas de OSV. El archivo completo puede superar 1 GB, puede tardar varios minutos y muestra progreso en vivo con el total exacto cuando el servidor lo proporciona. Ejecuta el más amplio agent-bom db update cuando también necesites feeds de distribución, probabilidad de explotación y vulnerabilidades conocidas explotadas.

Una salida distinta de cero es un veredicto, no un fallo. scan sale con 0 cuando nada coincidió con una puerta, y con 1 cuando algo lo hizo: un umbral --fail-on-* que estableciste, un paquete conocido como malicioso o un escaneo que no se completó. El informe se imprime completo en cualquier caso, y la última línea nombra la puerta que coincidió. Contrato completo de códigos de salida.

Guarda un artefacto con agent-bom scan . -f sarif -o findings.sarif, o sigue la guía de primera ejecución para formatos y uso en CI.

Bucle diario del desarrollador

Prueba el escáner sin instalarlo y luego verifica un paquete antes de agregarlo:

uvx agent-bom scan .
uvx agent-bom check [email protected] --ecosystem pypi

check devuelve un veredicto previo a la instalación de permitir/no seguro/incompleto; scan cubre el repositorio más la configuración de IA/MCP descubierta. Para que tanto las puertas de dependencias como las de secretos sean automáticas para un equipo, fija los hooks de consumidor incluidos:

repos:
  - repo: https://github.com/msaad00/agent-bom
    rev: v0.102.0
    hooks:
      - id: agent-bom-secrets
      - id: agent-bom-scan

Ejecuta pre-commit install una vez. Los hooks instalan agent-bom en su propio entorno aislado, por lo que los contribuyentes no necesitan una instalación global separada. Comportamiento de los hooks y ejemplos de CI.

agent-bom scan --demo --offline

Autoalojamiento

Inicia el plano de control de bucle local:

pip install 'agent-bom[ui]'
agent-bom serve

Para un despliegue compartido, usa la ruta documentada de Docker o Helm y configura identidad real, TLS, PostgreSQL, cifrado y claves de auditoría antes de exponerlo.

Los ejemplos apuntan a este candidato de versión; confirma la disponibilidad de la versión antes de copiar un pin exacto. De lo contrario, usa la última versión que se muestra en PyPI.

Descripción general del despliegue · Configuración empresarial · Conexiones en la nube

Confianza

• Descubrimiento de solo lectura por defecto; las decisiones de escritura en tiempo de ejecución son separadas y explícitas.
• Las credenciales son de solo escritura donde se almacenan, cifradas en reposo y nunca se devuelven en respuestas de API.
• Las rutas de API y del plano de control están limitadas por inquilino y protegidas por autenticación fuera del modo local explícito.
• La evidencia faltante se muestra como no disponible o parcial, nunca se convierte en un cero factual.
• Los ejemplos públicos y las capturas de pantalla usan solo identificadores sintéticos deterministas.

Modelo de amenazas · Verificación de versiones · Política de seguridad · Modelo de seguridad MCP

Contribución y soporte

¿Atascado o no sabes dónde encaja una pregunta? SUPPORT.md tiene el enrutamiento y una declaración honesta de qué respuesta esperar.

Para contribuir, empieza con CONTRIBUTING.md, AGENTS.md y los problemas abiertos.

Licencia Apache-2.0.