Pour accéder à l’index complet de la documentation, consultez llms.txt. Pour obtenir la version Markdown d’une page de documentation, ajoutez .md à la fin de l’URL de la page.
Navigation principale

Importer les constats d’un scanner dans Daybreak

Connectez Wiz, Snyk Open Source ou Endor Labs, téléversez un rapport de scanner et choisissez les constats évalués à partager.

Vous pouvez importer des constats dans Daybreak Defense Factory en connectant un scanner ou en téléversant un rapport. Daybreak peut évaluer ces constats au regard de votre code et partager les résultats admissibles avec votre équipe.

Ouvrez Paramètres → Intégrations ou sélectionnez Importer dans Constats. Les options disponibles dépendent de votre espace de travail. Pour évaluer un constat, Daybreak doit avoir accès aux éléments de preuve du scanner et au commit du dépôt. Le partage nécessite également un environnement dans lequel vous avez le droit de publier des constats.

Importer des constats depuis un scanner connecté

  1. À côté du scanner, sélectionnez Connecter, Reconnecter si votre connexion a expiré ou Importer pour utiliser une connexion existante.
  2. Choisissez la source et les constats à importer. Si l’option Tout importer pour un dépôt est disponible pour Snyk ou Endor, choisissez un dépôt GitHub connecté pour inclure tous les projets correspondants dans l’organisation ou l’espace de noms sélectionné. Sinon, choisissez un projet et sélectionnez les constats. Dans Wiz, vous pouvez aussi utiliser une vue enregistrée prise en charge.
  3. Vérifiez le nombre de constats, le dépôt et le commit. Le total inclut les constats sélectionnés que Daybreak ne peut pas évaluer. Il peut donc dépasser le nombre de constats finalement partagés.
  4. Vérifiez la destination. En confirmant une destination partagée, vous autorisez Daybreak à évaluer les constats et à y publier les résultats admissibles classés À signaler. Toute personne ayant accès à cette destination peut consulter l’évaluation publiée et les éléments de preuve d’origine. Si un seul environnement est admissible, Daybreak le sélectionne automatiquement. Si plusieurs le sont, choisissez-en un. Si vous optez pour une évaluation ou un enregistrement à titre privé, les résultats restent privés.
  5. Confirmez une fois le nombre et la destination vérifiés. Si la vérification expire ou si la source change, vérifiez de nouveau les détails de l’importation. Une fois l’importation lancée, vous pouvez fermer les paramètres et suivre sa progression dans Mes importations récentes.

Choisir une source

Scanner Connexion Éléments à sélectionner
Wiz Connectez-vous à votre compte Wiz et autorisez la connexion. Choisissez les vulnérabilités des paquets d’un projet ou une vue enregistrée des constats de vulnérabilité, filtrée sur un seul dépôt de conteneurs et sur les images de conteneurs. Filtrer cette page limite la recherche à la page affichée. Vous pouvez sélectionner des constats sur plusieurs pages.
Snyk Open Source Utilisez un jeton d’API Snyk US-01 disposant d’un accès en lecture via l’API REST à l’organisation, aux projets et aux problèmes. Choisissez l’organisation qui surveille votre dépôt. Des manifestes distincts peuvent apparaître comme autant de projets surveillés. Si vous n’avez pas d’accès REST, utilisez un fichier CSV Issues Detail.
Endor Labs Saisissez votre espace de noms US, votre clé d’API et votre secret d’API. Utilisez une clé en lecture seule assortie d’une date d’expiration. Limitez sa portée à l’espace de noms et désactivez l’accès aux espaces de noms enfants. Choisissez des constats dans le contexte principal d’un projet ou utilisez l’importation par dépôt si elle est disponible.

Daybreak utilise la révision indiquée par le scanner lorsqu’il peut la vérifier. Si Snyk ne précise pas le commit, l’écran de vérification peut proposer une solution de repli pour ce dépôt. Si un constat Wiz nécessite une extraction du code, choisissez le dépôt GitHub et saisissez l’identifiant SHA complet de 40 caractères d’un commit accessible via votre connexion. Daybreak évaluera le code de ce commit. Ce code peut différer de celui qui a servi à construire l’image de conteneur. L’importation conserve les éléments de preuve d’origine du scanner.

Respecter les limites d’importation depuis un scanner connecté

Scanner Limite par lecture de la source Marche à suivre si vous atteignez la limite
Wiz 5 000 occurrences correspondant aux filtres par projet ou vue enregistrée, sur un maximum de 100 pages de 50 occurrences, dans la limite de 32 Mio. Affinez les filtres de gravité, de disponibilité d’un correctif ou de CVE avant de relancer l’aperçu.
Snyk Open Source 10 000 problèmes de paquets par projet surveillé, sur un maximum de 100 pages de 100 problèmes. La taille cumulée des pages d’origine encodées et du rapport converti doit rester inférieure ou égale à 8 Mio. Choisissez un projet plus petit ou téléversez un export filtré. Même si vous sélectionnez moins de problèmes après l’aperçu, la lecture du projet entier reste nécessaire.
Endor Labs 5 000 constats par aperçu de projet, par pages de 100 constats maximum et dans la limite de 32 Mio de données lues. Choisissez un projet plus petit ou téléversez un export filtré. Si l’ensemble des éléments de preuve dépasse la limite, sélectionnez individuellement un nombre plus restreint de constats.

La taille totale de chaque rapport récupéré, éléments de preuve compris, ne doit pas dépasser 32 Mio. Lors d’une importation par dépôt, Daybreak doit finir de lire tous les projets correspondants avant de pouvoir confirmer le nombre de constats du dépôt.

Une sélection peut inclure jusqu’à 10 000 occurrences du scanner. Daybreak peut évaluer jusqu’à 10 000 lignes dont les cibles ont été vérifiées lors d’un même examen. La liste des lignes et des révisions qui leur sont attribuées doit également tenir dans 512 Kio. Vous devrez donc peut-être scinder une sélection de moins de 10 000 occurrences. Pour Wiz, la limite d’extraction porte sur les constats auxquels une extraction du code est attribuée, même si plusieurs utilisent le même commit. Selon le sélecteur disponible dans votre espace de travail, vous pouvez attribuer une extraction à 16 ou 100 constats au maximum par examen. Scindez votre sélection dès qu’elle atteint la limite affichée. Une confirmation peut autoriser jusqu’à 100 environnements de destination, à raison d’un par connexion à un dépôt.

Téléverser un rapport de scanner

Sélectionnez Téléverser un fichier à côté du scanner. Les paramètres détectent le format et affichent les types d’exports acceptés par votre espace de travail.

Scanner Fichier à téléverser dans les paramètres
Wiz Utilisez un rapport complet sur les vulnérabilités des paquets au format JSON détaillé ou un fichier JSON Lines contenant un constat natif par ligne. Dans la vue Vulnerability Findings de Wiz, filtrez le rapport, sélectionnez Save as → Report, puis choisissez Repository Branch, JSON et Detailed pour exporter les données d’un dépôt. Lorsque vous y êtes invité, saisissez l’identifiant du tenant Wiz à l’origine de l’export.
Snyk Open Source Utilisez un fichier CSV Issues Detail provenant d’une seule organisation. Vérifiez l’organisation dans l’aperçu.
Endor Labs Utilisez le JSON natif des constats exportés avec endorctl pour l’espace de noms à importer. Conservez les UUID d’origine des constats. Si l’export est paginé, récupérez toutes les pages.

Le fichier téléversé et son contenu décompressé doivent chacun tenir dans 32 Mio, y compris pour les fichiers gzip. Pour les fichiers CSV Snyk et JSON Lines Wiz, les paramètres reconnaissent jusqu’à 10 000 lignes de données par fichier. Scindez les fichiers plus volumineux avant de les téléverser. Un constat JSON de plus de 1 Mio peut être rejeté. Pour un fichier CSV Snyk, limitez l’en-tête à 32 768 caractères, chaque champ à 131 072 caractères et chaque ligne logique à 1 048 576 caractères.

Choisir d’évaluer ou de partager les constats

Lorsque vous enregistrez le fichier, il est téléversé pour vérification. Avant de lancer l’importation, vérifiez les dépôts et les commits validés, les lignes qui nécessitent encore une extraction du code et les éventuelles entrées rejetées.

  • Pour conserver les éléments de preuve en vue d’une utilisation ultérieure, choisissez Enregistrer sans évaluation si l’écran de vérification propose une évaluation, ou Enregistrer à titre privé dans le cas contraire.
  • Pour évaluer les lignes admissibles et garder tous les résultats privés, choisissez Importer et évaluer à titre privé. Vous pourrez choisir ultérieurement une cible pour les lignes qui en ont encore besoin. Si plus de 10 000 lignes ont une cible, scindez le rapport ou enregistrez-le sans évaluation.
  • Pour partager les résultats admissibles, cochez la case Publier également les constats à signaler, décochée par défaut. Vérifiez l’espace de travail et les destinations. Si un dépôt dispose de plusieurs environnements admissibles, choisissez-en un ou sélectionnez Garder privé. Confirmez en sélectionnant Importer et publier les constats à signaler.

Pour que le partage automatique ait lieu, l’évaluation doit classer le constat comme étant à signaler, le scanner doit avoir indiqué un niveau de gravité et vous devez avoir autorisé une destination. Le rapport d’origine reste privé. Dans Activité, sélectionnez Arrêter le partage automatique pour arrêter les publications futures issues de cette importation.

Importer depuis la CLI

Vous pouvez importer un export de scanner enregistré avec codex-security publish findings. Pour obtenir un aperçu local, utilisez --to local --dry-run. Pour obtenir un aperçu d’une importation dans le cloud, utilisez --to cloud --dry-run --format json avec un dépôt connecté. L’aperçu dans le cloud contacte Daybreak et nécessite une authentification ChatGPT enregistrée dans un fichier.

Vérifiez l’aperçu avant de retirer --dry-run et de confirmer. Une entrée privateImport enregistre les constats dans votre boîte de réception privée. Les entrées de requests publient les constats dans les environnements de dépôt qui y sont indiqués. Consultez le reçu pour repérer les exclusions, les échecs et les lignes non traitées. Consultez la référence de la CLI pour des exemples d’importation en local et dans le cloud, et les guides d’importation des constats de scanners pour les formats et les commandes de la CLI.

Pour AWS Continuum, récupérez les problèmes détectés dans le code ou un constat individuel, puis affichez un aperçu du rapport enregistré avec la CLI. Codex Security peut s’appuyer sur les éléments de preuve recueillis lors de la validation sur la cible testée pour évaluer si un attaquant peut atteindre le code concerné.

Pour les analyses d’infrastructure en tant que code effectuées avec CrowdStrike Falcon Cloud Security, importez le rapport JSON enregistré dans votre atelier local.

Rouvrir une importation

Ouvrez Mes importations récentes depuis Paramètres → Intégrations ou Constats → Importer dans l’espace de travail où vous avez effectué l’importation. Vous pouvez également rouvrir une importation privée depuis la ligne correspondante dans Analyses. Le résumé indique le résultat pour chaque ligne, y compris le motif du rejet pour les entrées rejetées. Ouvrez une ligne acceptée pour consulter l’identifiant attribué par le scanner et les éléments de preuve enregistrés, ainsi que l’évaluation ou le constat publié, le cas échéant. Déconnecter le scanner empêche toute nouvelle lecture via cette connexion. Vous pouvez toujours rouvrir vos importations enregistrées.

Sur un constat privé, choisissez Évaluer pour vérifier ses éléments de preuve au regard du commit sélectionné. Lisez le motif affiché à côté du statut À signaler, Différé, Masqué ou Sans objet. Par exemple, si Daybreak ne peut pas lire un commit, le constat peut rester au statut Différé. Pour partager un résultat classé À signaler après une évaluation privée, choisissez un environnement de destination autorisé et sélectionnez Publier dans les constats partagés. Si le scanner n’a pas fourni de niveau de gravité reconnu, choisissez-en un avant la publication.

Reconnaître les importations répétées

Si la confirmation a été interrompue, rouvrez le reçu d’origine ou sélectionnez Vérifier l’importation d’origine si cette option est proposée. Relancer la demande d’origine permet de retrouver l’importation avec les choix que vous aviez déjà effectués.

Lorsque vous lancez une nouvelle importation, Daybreak compare chaque ligne aux éléments de preuve dont il dispose déjà.

  • Si vous utilisez la même connexion Endor et le même projet, ou la même connexion Wiz et le même projet ou la même vue de dépôt enregistrée, des identifiants de scanner et des éléments de preuve inchangés peuvent renvoyer à l’observation privée existante. Chaque nouvelle importation depuis une connexion Snyk enregistre une nouvelle observation privée par problème. Si vous redemandez une évaluation, Daybreak peut réévaluer même une ligne inchangée.
  • Si vous téléversez un fichier CSV Snyk identique pour la même organisation, Daybreak réutilise les lignes acceptées. Par exemple, si vous téléversez de nouveau les cinq mêmes problèmes, le bilan peut indiquer cinq problèmes inchangés et aucun nouveau problème. Toute modification des éléments de preuve crée une nouvelle version. Une évaluation antérieure reste associée aux éléments de preuve et au commit examinés à ce moment-là.
  • Si un même rapport contient deux occurrences d’un identifiant de constat du scanner, Daybreak signale les deux occurrences et peut importer les autres lignes valides. Conservez un seul enregistrement correct et importez le rapport corrigé. Des identifiants distincts peuvent correspondre à différents paquets ou dépôts affectés, même s’ils font référence à la même CVE.

Après la publication, Daybreak recherche un constat partagé existant dans le même dépôt et le même environnement. S’il trouve une correspondance, il ajoute les éléments de preuve publiés au problème existant. Un problème distinct peut donner lieu à un nouveau constat. Deux observations de scanner peuvent donc figurer dans un même constat partagé. Si vous relancez la même publication, les éléments de preuve ne sont pas ajoutés une seconde fois. Dans le constat partagé, ouvrez Observations pour consulter ses sources. Consultez la page Examiner les constats et les correctifs.