mceeomoba/apex-kev-change-deskComparación offline de instantáneas de CISA KEV para la revisión de cambios a nivel de campo. Prototipo gratuito, no es una evaluación de seguridad. Desarrollo asistido por IA.
Un prototipo offline de revisión de cambios para equipos de TI que compara dos instantáneas JSON de Vulnerabilidades Conocidas y Explotadas (KEV) de CISA. Informa registros añadidos, eliminados y editados, incluyendo los valores exactos antes/después de cada campo modificado. Es una utilidad de revisión de datos, no una evaluación de seguridad.
Prototipo gratuito. No se afirman clientes, servicio de pago ni validación de demanda. Desarrollado con asistencia de IA. No está afiliado ni respaldado por CISA.
Ejecuta el ejemplo sintético a continuación, o compara dos instantáneas guardadas del catálogo público. Comparte comentarios sobre el flujo de trabajo: ¿qué tarea de revisión intentabas completar y esto eliminó algún paso manual? Los comentarios son públicos y exponen tu identidad de GitHub. No incluyas inventarios de activos privados, nombres de clientes, credenciales ni detalles de incidentes. Publicado para el proyecto Apex; prototipo asistido por IA y recopilación de comentarios. Sin piloto de pago ni promesa de tiempo de respuesta.
Límite de entrada: los números JSON en forma decimal y exponencial son rechazados, incluso en campos de extensión. Los números enteros se conservan exactamente. No se garantiza que los esquemas futuros funcionen. No modifiques los valores de origen para eludir este límite.
Python 3.10 o superior. Solo biblioteca estándar. No se necesita cuenta ni instalación.
python3 kev_diff.py examples/before.json examples/after.json > review.json
python3 kev_diff.py examples/before.json examples/after.json --vendor 'Example Vendor' > vendor-review.json
python3 kev_diff.py examples/before.json examples/after.json --format markdown > review.md
python3 -m unittest discover -s tests -v
El catálogo de ejemplo es sintético, no un feed de vulnerabilidades actual. Muestra una adición, un registro editado y una eliminación. El registro editado cambia una fecha de vencimiento y un campo de extensión desconocido. Nada se ejecuta en segundo plano.
Para datos reales, descargue y conserve sucesivas instantáneas JSON usted mismo desde el catálogo de CISA o su espejo oficial. Verifique la procedencia y las fechas de descarga. Pase primero la instantánea anterior. Esta herramienta no obtiene fuentes, no establece autenticidad, no indica si un catálogo está completo ni afirma estar actualizada. Los valores SHA-256 de los archivos respaldan la reproducibilidad, no la autenticación.
Ejecute python3 -B scripts/verify_release.py desde una copia de trabajo. Ejecuta las pruebas sintéticas incluidas, compara los ejemplos JSON y Markdown con las salidas esperadas incluidas, y verifica que una entrada inválida con claves duplicadas no emita ningún informe. Falla si no se descubre ninguna prueba. La salida 0 significa que estas verificaciones de aceptación pasaron; la salida 1 significa fallo. Imprime un resumen JSON y hashes de los archivos principales/de ejemplo y de soporte listados, sin obtener datos. Los archivos temporales de entrada inválida se crean y eliminan en el directorio temporal del sistema operativo; el ejecutor/pruebas incluidas no editan intencionalmente la copia de trabajo; -B evita las escrituras normales de bytecode.
Esto ejecuta código Python desde la copia de trabajo, incluidos sus tests. Inspeccione y confíe en ese código antes de ejecutarlo. Las verificaciones superadas y los hashes de archivos no son una auditoría de seguridad, una firma de software, una prueba de autenticidad de la fuente, una evaluación de exposición ni evidencia de clientes. No redirija su salida sobre archivos fuente o de ejemplo.
JSON es el formato predeterminado. --format markdown produce una revisión legible por humanos con recuentos, procedencia de la instantánea, límites, cambios de metadatos y cada registro completo antes/después para los cambios coincidentes. No añade análisis ni modifica la comparación. Los valores de origen permanecen en bloques de código JSON; una valla de tamaño dinámico evita que los backticks incrustados escapen de esos bloques en renderizadores Markdown ordinarios, no en todos los visores. Abra el Markdown en un visor de su confianza. Revise los informes antes de compartirlos: se incluyen los registros completos antes/después para los cambios coincidentes, los cambios de metadatos y los filtros de proveedor. Mantenga markdown_report.py junto a kev_diff.py para este formato opcional.
added: ID de CVE presente solo en el archivo after proporcionado.removed: ID de CVE presente solo en el archivo before. No es prueba de remediación ni de seguridad. Un archivo after parcial puede causar muchas eliminaciones aparentes.changed: al menos un campo del registro difiere. Se conservan los valores antes y después, los indicadores de presencia de campos y los registros completos.--vendor es una coincidencia exacta, sin distinción de mayúsculas y minúsculas, sobre vendorProject, contra cualquiera de las instantáneas. No es coincidencia difusa ni detección de productos instalados. Omitirlo compara el catálogo completo proporcionado.Nunca redirija la salida sobre ninguno de los archivos de entrada. Por ejemplo, > before.json trunca esa fuente antes de que Python pueda leerla. Use un nuevo nombre de archivo de salida.
La salida 0 significa que se produjo una comparación válida, incluido un resultado sin cambios. La salida 2 significa entrada inválida o un error de archivo; el programa no emite ningún informe. Si usa redirección de shell, su shell puede crear un archivo de salida vacío incluso en caso de error, así que verifique el código de salida antes de reemplazar un informe anterior.
Todo el procesamiento de archivos es local. Sin solicitudes de red, telemetría, cuenta de almacenamiento, alertas automatizadas, escaneo, explotación, remediación ni integración con tiendas. Los archivos que guarde permanecen en su dispositivo. Los informes contienen los registros proporcionados y los filtros del proveedor; revíselos antes de compartirlos. El tamaño máximo de entrada es de 20 MB por archivo. Se rechazan UTF-8 no válido, claves/IDs JSON duplicados, fechas no válidas, recuentos que no coinciden y marcas de tiempo de publicación invertidas. Los campos desconocidos se conservan, no se validan contra un esquema. Los números JSON en forma decimal y exponencial en cualquier parte de una instantánea se rechazan explícitamente, incluidos los campos de extensión, para evitar redondear valores de forma silenciosa. Los números JSON enteros se conservan exactamente. No modifique los valores de origen para eludir este límite. Esto sacrifica la compatibilidad futura en favor de la exactitud: un feed oficial futuro con valores decimales/exponenciales será rechazado hasta que se añada soporte. Los campos obligatorios siguen el esquema oficial actual, pero esto no es una implementación completa de JSON Schema.