Para ver el índice completo de la documentación, consulta llms.txt. Para ver la versión en Markdown de una página de la documentación, agrega .md al final de la URL de esa página.
Navegación principal
Tema

Importar hallazgos de escáneres a Daybreak

Conecta Wiz, Snyk Open Source o Endor Labs, sube un informe de escáner y elige qué hallazgos evaluados quieres compartir.

Puedes importar hallazgos a Daybreak Defense Factory al conectar un escáner o subir un informe. Daybreak puede evaluar esos hallazgos a partir de tu código y compartir con tu equipo los resultados que cumplan los requisitos.

Abre Configuración → Integraciones o selecciona Importar en Hallazgos. Las opciones disponibles dependen de tu Espacio de trabajo. Para evaluar los hallazgos, Daybreak necesita acceso a la evidencia del escáner y al commit del repositorio. Para compartirlos, también necesitas un entorno donde tengas permiso para publicar hallazgos.

Importar desde un escáner conectado

  1. Selecciona Conectar junto al escáner, Volver a conectar si la conexión caducó o Importar para usar una conexión existente.
  2. Elige la fuente y los hallazgos que quieres importar. Si Snyk o Endor ofrecen la opción Importar todo para un repositorio, elige un repositorio de GitHub conectado para incluir todos los proyectos que coincidan con ese repositorio en la organización o el espacio de nombres seleccionado. De lo contrario, elige un proyecto y selecciona los hallazgos. En Wiz, también puedes usar una vista guardada compatible.
  3. Revisa la cantidad de hallazgos, el repositorio y el commit. El total incluye los hallazgos seleccionados que no se pueden evaluar, por lo que puede superar la cantidad de hallazgos que finalmente se compartan.
  4. Verifica el destino. Al confirmar un destino compartido, autorizas a Daybreak a evaluar los hallazgos y a publicar allí los resultados clasificados como Publicables que cumplan los requisitos. Cualquier persona con acceso al destino puede leer la evaluación publicada y la evidencia original. Si solo un entorno cumple los requisitos, Daybreak lo selecciona automáticamente. Si hay varios, elige uno. Si eliges la evaluación privada o el guardado privado, los resultados se mantienen privados.
  5. Confirma cuando la cantidad y el destino sean correctos. Si la revisión caduca o la fuente cambia, vuelve a revisar los datos. Una vez iniciada la importación, puedes cerrar Configuración y consultar el progreso en Mis importaciones recientes.

Elegir una fuente

Escáner Conexión Qué puedes seleccionar
Wiz Inicia sesión en tu cuenta de Wiz y aprueba la conexión. Puedes seleccionar vulnerabilidades de paquetes de un proyecto o una vista guardada de hallazgos de vulnerabilidades filtrada para mostrar solo imágenes de contenedor de un único repositorio de contenedores. Filtrar esta página busca en la página actual. Puedes seleccionar hallazgos de varias páginas.
Snyk Open Source Usa un token de API de Snyk US-01 con acceso de lectura mediante REST a la organización, los proyectos y los problemas. Elige la organización que monitorea tu repositorio. Cada archivo de manifiesto puede aparecer como un proyecto monitoreado independiente. Si no tienes acceso mediante REST, usa un archivo CSV de Issues Detail.
Endor Labs Ingresa tu espacio de nombres de EE. UU., tu clave de API y tu secreto de API. Usa una clave de solo lectura con fecha de vencimiento, limita su alcance al espacio de nombres y desactiva la opción de incluir espacios de nombres secundarios. Elige hallazgos del contexto principal de un proyecto o usa la importación por repositorio si está disponible.

Daybreak usa la revisión que indica el escáner cuando puede verificarla. Si Snyk omite el commit, la pantalla de revisión puede ofrecer una alternativa para ese repositorio. Si un hallazgo de Wiz requiere un checkout, elige el repositorio de GitHub e ingresa el SHA completo de 40 caracteres de un commit al que tu conexión tenga acceso de lectura. Daybreak evaluará el código de ese commit. Puede ser distinto del código que se usó para crear la imagen de contenedor. La importación conserva la evidencia original del escáner.

Ajustar una importación desde un escáner conectado a los límites

Escáner Límite por lectura de la fuente Qué hacer si alcanzas el límite
Wiz 5000 coincidencias por proyecto filtrado o vista guardada, en un máximo de 100 páginas de 50 coincidencias, con un límite total de 32 MiB. Restringe los resultados con los filtros de gravedad, disponibilidad de correcciones o CVE antes de volver a abrir la vista previa.
Snyk Open Source 10 000 problemas de paquetes por proyecto monitoreado, en un máximo de 100 páginas de 100 problemas. Las páginas originales codificadas y el informe convertido pueden ocupar hasta 8 MiB en conjunto. Elige un proyecto más pequeño o sube una exportación filtrada. Aunque selecciones menos problemas después de la vista previa, es necesario leer el proyecto completo.
Endor Labs 5000 hallazgos por vista previa de un proyecto, en páginas de hasta 100 hallazgos, con un límite de lectura de 32 MiB. Elige un proyecto más pequeño o sube una exportación filtrada. Si la evidencia completa supera el límite, selecciona menos hallazgos individuales.

Cada informe recopilado y su evidencia pueden ocupar hasta 32 MiB en conjunto. Al importar por repositorio, Daybreak debe terminar de leer todos los proyectos que coincidan antes de confirmar la cantidad de hallazgos del repositorio.

Una selección individual admite hasta 10 000 ocurrencias detectadas por el escáner. En cada revisión se pueden evaluar hasta 10 000 filas con objetivos verificados. La lista de filas y sus revisiones asignadas también debe caber en 512 KiB, por lo que quizá debas dividir incluso una selección con menos filas. En Wiz, para el límite de checkouts se cuentan los hallazgos que tienen asignado un checkout, incluso si varios usan el mismo commit. Según el selector disponible en tu Espacio de trabajo, puedes asignar un checkout a un máximo de 16 o 100 hallazgos por revisión. Divide la selección según el límite que se muestre. Una confirmación puede autorizar hasta 100 entornos de destino, uno por cada conexión a un repositorio.

Subir un informe de escáner

Selecciona Subir archivo junto al escáner. Configuración detecta el formato y muestra qué exportaciones admite tu Espacio de trabajo.

Escáner Archivo que puedes subir en Configuración
Wiz Un informe completo de vulnerabilidades de paquetes en formato JSON detallado o un archivo JSON Lines con un hallazgo nativo por línea. En Hallazgos de vulnerabilidades de Wiz, filtra el informe, selecciona Guardar como → Informe y elige Rama del repositorio, JSON y Detallado para exportar los datos de un repositorio. Cuando se te solicite, ingresa el ID del inquilino de Wiz desde el que se hizo la exportación.
Snyk Open Source Un archivo CSV de Issues Detail de una sola organización. Verifica la organización en la vista previa.
Endor Labs Un archivo JSON en el formato nativo Finding, exportado con endorctl para el espacio de nombres que quieres importar. Conserva los UUID originales de los hallazgos y, si la exportación está paginada, incluye todas las páginas.

Tanto el archivo que subas como su contenido descomprimido deben respetar, por separado, el límite de 32 MiB, incluso si usas gzip. Para archivos CSV de Snyk y JSON Lines de Wiz, Configuración reconoce hasta 10 000 filas de datos por archivo. Divide los archivos más grandes antes de subirlos. Un hallazgo individual en JSON puede rechazarse si supera 1 MiB. En los archivos CSV de Snyk, limita el encabezado a 32 768 caracteres, cada campo a 131 072 caracteres y cada fila lógica a 1 048 576 caracteres.

Elegir si evaluar o compartir los hallazgos

Al guardar el archivo, lo subes para su revisión. Antes de iniciar la importación, verifica los repositorios y commits que ya se validaron, las filas que aún requieren un checkout y las entradas rechazadas.

  • Para conservar la evidencia y usarla más adelante, elige Guardar sin evaluar si la pantalla de revisión ofrece la opción de evaluar o Guardar de forma privada si no la ofrece.
  • Para evaluar las filas que cumplan los requisitos y mantener todos los resultados privados, elige Importar y evaluar de forma privada. Puedes elegir más adelante los objetivos de las filas que aún los necesiten. Si más de 10 000 filas tienen un objetivo asignado, divide el informe o guárdalo sin evaluar.
  • Para compartir los resultados que cumplan los requisitos, marca la casilla Publicar también los hallazgos publicables, que inicialmente está desmarcada. Revisa el Espacio de trabajo y los destinos. Si un repositorio tiene varios entornos que cumplen los requisitos, elige uno o selecciona Mantener privado. Confirma con Importar y publicar los hallazgos publicables.

Para que un hallazgo se comparta automáticamente, la evaluación debe clasificarlo como Publicable, el escáner debe haber indicado su gravedad y tú debes haber autorizado el destino. El informe original se mantiene privado. En Actividad, selecciona Dejar de compartir automáticamente para detener las futuras publicaciones de esa importación.

Importar desde la CLI

Puedes importar una exportación de escáner que hayas guardado con el comando codex-security publish findings. Para obtener una vista previa local, usa --to local --dry-run. Para obtener la vista previa de una importación en la nube, usa --to cloud --dry-run --format json con un repositorio conectado. La vista previa en la nube se conecta a Daybreak y requiere que tus credenciales de inicio de sesión de ChatGPT estén guardadas en un archivo.

Revisa la vista previa antes de quitar --dry-run y confirmar. Una entrada privateImport guarda los hallazgos en tu bandeja de entrada privada. Las entradas de requests publican los hallazgos en los entornos de repositorio que indican. Revisa el comprobante para identificar exclusiones, errores y filas sin procesar. Consulta la referencia de la CLI para ver ejemplos de importación local y en la nube, y las guías de importación de escáneres para consultar los formatos y comandos de la CLI.

Volver a abrir una importación

En el Espacio de trabajo donde hiciste la importación, abre Mis importaciones recientes desde Configuración → Integraciones o Hallazgos → Importar. También puedes volver a abrir una importación privada desde la fila correspondiente en Escaneos. El resumen indica qué ocurrió con cada fila, incluidas las entradas rechazadas y el motivo de cada rechazo. Abre una fila aceptada para ver el ID que le asignó el escáner, la evidencia guardada y, si los hay, la evaluación o el hallazgo publicado. Al desconectar el escáner, se detienen las nuevas lecturas a través de esa conexión. Puedes seguir abriendo las importaciones que hayas guardado.

Selecciona Evaluar en un hallazgo privado para contrastar su evidencia con el commit seleccionado. Lee el motivo que aparece junto al estado Publicable, Aplazado, Suprimido o No aplicable. Por ejemplo, si Daybreak no puede leer un commit, el hallazgo puede quedar en el estado Aplazado. Para compartir un resultado que se haya evaluado de forma privada y clasificado como Publicable, elige un entorno de destino autorizado y selecciona Publicar en hallazgos compartidos. Si el escáner no indicó un nivel de gravedad reconocido, elige uno antes de publicar.

Reconocer importaciones repetidas

Si se interrumpió la confirmación, vuelve a abrir el comprobante original o selecciona Verificar importación original cuando aparezca esa opción. Al reintentar la solicitud original, recuperas la importación con las opciones que ya habías elegido.

Cuando inicias una importación nueva, Daybreak compara cada fila con la evidencia que ya tiene.

  • En Endor, si usas la misma conexión y el mismo proyecto, los ID y la evidencia del escáner que no hayan cambiado pueden remitir a la observación privada existente. En Wiz ocurre lo mismo si usas la misma conexión y el mismo proyecto o la misma vista guardada del repositorio. Cada nueva importación desde una conexión de Snyk registra una observación privada nueva por cada problema. Si vuelves a solicitar una evaluación, Daybreak puede evaluar incluso una fila que no haya cambiado.
  • Si subes un archivo CSV de Snyk idéntico para la misma organización, Daybreak reutiliza las filas aceptadas. Por ejemplo, si vuelves a subir los mismos cinco problemas, el resultado puede mostrar cinco sin cambios y cero nuevos. Si la evidencia cambia, se crea una versión nueva. Las evaluaciones anteriores siguen haciendo referencia a la evidencia y al commit que se revisaron en cada una.
  • Si un informe contiene dos veces el mismo ID de hallazgo del escáner, Daybreak marca ambas ocurrencias y puede importar las demás filas válidas. Conserva un solo registro correcto e importa el informe corregido. Dos ID distintos pueden corresponder a paquetes o repositorios afectados diferentes, incluso si citan el mismo CVE.

Después de la publicación, Daybreak comprueba si ya existe un hallazgo compartido para el mismo problema en el mismo repositorio y entorno. Si encuentra una coincidencia, agrega la evidencia publicada a ese problema. Un problema distinto puede dar lugar a un hallazgo nuevo. Por eso, dos observaciones del escáner pueden aparecer en un mismo hallazgo compartido. Si reintentas la misma publicación, la evidencia se agrega una sola vez. Abre Observaciones en el hallazgo compartido para consultar sus fuentes. Consulta Revisar hallazgos y correcciones.