Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Scanner-Befunde in Daybreak importieren

Verbinde Wiz, Snyk Open Source oder Endor Labs, lade einen Scannerbericht hoch und wähle aus, welche bewerteten Befunde du teilen möchtest.

Du kannst Befunde in Daybreak Defense Factory importieren, indem du einen Scanner verbindest oder einen Bericht hochlädst. Daybreak kann die Befunde anhand deines Codes bewerten und die Ergebnisse mit deinem Team teilen, wenn sie die Voraussetzungen dafür erfüllen.

Öffne Einstellungen → Integrationen oder wähle unter Befunde die Option Importieren. Welche Optionen verfügbar sind, hängt von deinem Workspace ab. Für die Bewertung benötigt Daybreak Zugriff auf die Nachweise des Scanners und den Commit im Repository. Zum Teilen brauchst du außerdem eine Umgebung, in der du Befunde veröffentlichen darfst.

Befunde aus einem verbundenen Scanner importieren

  1. Wähle neben dem Scanner Verbinden. Ist deine Verbindung abgelaufen, wähle Erneut verbinden. Um eine bestehende Verbindung zu verwenden, wähle Importieren.
  2. Wähle die Quelle und die Befunde für den Import aus. Wenn für Snyk oder Endor die Option Alle Befunde für ein Repository importieren verfügbar ist, wähle ein verbundenes GitHub-Repository aus. Damit beziehst du alle passenden Projekte in der gewählten Organisation oder im gewählten Namespace ein. Wähle andernfalls ein Projekt und dann die gewünschten Befunde aus. In Wiz kannst du auch eine unterstützte gespeicherte Ansicht verwenden.
  3. Prüfe die Anzahl der Befunde sowie das Repository und den Commit für die Bewertung. Die Zahl auf der Schaltfläche 12 Befunde importieren umfasst beispielsweise alle 12 ausgewählten Scanner-Befunde, auch solche, die Daybreak nicht bewerten kann. Sie kann daher von der Anzahl der geteilten Befunde abweichen.
  4. Prüfe, was du mit der Bestätigung erlaubst. Wenn ein gemeinsamer Workspace und ein Ziel angegeben sind, erlaubst du mit der Bestätigung die Bewertung sowie die Veröffentlichung geeigneter Ergebnisse mit dem Status Meldefähig an diesem Ziel. Wer auf das Ziel zugreifen kann, kann die veröffentlichte Bewertung und die ursprünglichen Nachweise lesen. Gibt es nur eine geeignete Umgebung, wählt Daybreak sie vorab aus. Kommen mehrere Umgebungen infrage, wähle vor der Bestätigung eine davon aus. Bietet die Importübersicht eine private Bewertung oder nur das Speichern an, bleiben die Ergebnisse privat.
  5. Bestätige den Import, wenn die Anzahl und das Ziel stimmen. Wenn die Importübersicht abläuft oder sich die Quelle ändert, prüfe die Angaben erneut. Sobald der Import startet, kannst du die Einstellungen schließen und den Fortschritt unter Meine letzten Importe verfolgen.

Quelle auswählen

Scanner Verbindung Auswahlmöglichkeiten
Wiz Melde dich bei deinem Wiz-Konto an und genehmige die Verbindung. Du kannst Paket-Schwachstellen in einem Projekt oder eine gespeicherte Ansicht mit Schwachstellenbefunden auswählen, die auf ein einzelnes Container-Repository und auf Container-Images gefiltert ist. Mit Diese Seite filtern durchsuchst du die aktuelle Seite. Du kannst Befunde auf mehreren Seiten auswählen.
Snyk Open Source Verwende ein API-Token für Snyk US-01 mit REST-Lesezugriff auf die Organisation, die Projekte und die Issues. Wähle die Organisation aus, die dein Repository überwacht. Unterschiedliche Manifeste können als separate überwachte Projekte erscheinen. Wenn dir der REST-Zugriff fehlt, verwende eine CSV-Datei vom Typ „Issues Detail“.
Endor Labs Gib deinen US-Namespace, deinen API-Schlüssel und dein API-Secret ein. Verwende einen Schlüssel mit Ablaufdatum und ohne Schreibzugriff. Beschränke ihn auf den Namespace und deaktiviere den Zugriff auf untergeordnete Namespaces. Wähle Befunde aus dem Hauptkontext eines Projekts aus oder verwende den Repository-Import, sofern er verfügbar ist.

Daybreak verwendet die vom Scanner gemeldete Revision, wenn Daybreak sie verifizieren kann. Gibt Snyk keinen Commit an, kann die Importübersicht eine Alternative für dieses Repository anbieten. Benötigt ein Wiz-Befund einen Checkout, wähle das GitHub-Repository aus und gib den vollständigen, 40 Zeichen langen SHA des Commits ein, auf den deine Verbindung Lesezugriff hat. Daybreak bewertet den Code dieses Commits. Er kann von dem Code abweichen, mit dem das Container-Image erstellt wurde. Beim Import bleiben die ursprünglichen Nachweise des Scanners erhalten.

Grenzwerte beim Import über eine Scannerverbindung einhalten

Scanner Grenzwert pro Lesevorgang aus einer Quelle Wenn du den Grenzwert erreichst
Wiz 5.000 passende Vorkommen pro gefiltertem Projekt oder gespeicherter Ansicht, auf bis zu 100 Seiten mit je 50 Vorkommen und mit insgesamt höchstens 32 MiB. Grenze die Auswahl nach Schweregrad, Verfügbarkeit einer Fehlerbehebung oder CVE weiter ein, bevor du die Vorschau erneut öffnest.
Snyk Open Source 10.000 Paket-Issues pro überwachtem Projekt, auf bis zu 100 Seiten mit je 100 Issues. Die kodierten Originalseiten und der konvertierte Bericht dürfen zusammen höchstens 8 MiB umfassen. Wähle ein kleineres Projekt oder lade einen gefilterten Export hoch. Auch wenn du nach der Vorschau weniger Issues auswählst, muss Daybreak das gesamte Projekt einlesen.
Endor Labs 5.000 Befunde pro Projektvorschau, auf Seiten mit jeweils bis zu 100 Befunden. Insgesamt darf Daybreak dabei höchstens 32 MiB einlesen. Wähle ein kleineres Projekt oder lade einen gefilterten Export hoch. Wenn die vollständigen Nachweise den Grenzwert überschreiten, wähle weniger einzelne Befunde aus.

Jeder erfasste Bericht darf zusammen mit seinen Nachweisen höchstens 32 MiB umfassen. Bei einem Repository-Import muss Daybreak alle passenden Projekte vollständig einlesen, bevor es die Anzahl der Befunde für das Repository bestätigen kann.

Pro Auswahl kannst du bis zu 10.000 vom Scanner gemeldete Vorkommen aufnehmen. Pro Prüfung kann Daybreak bis zu 10.000 Zeilen mit verifizierten Zielen bewerten. Die Liste der Zeilen mit den jeweils zugewiesenen Revisionen darf außerdem höchstens 512 KiB umfassen. Daher musst du unter Umständen auch eine kleinere Auswahl aufteilen. Bei Wiz zählt für das Checkout-Limit die Anzahl der Befunde, denen ein Checkout zugewiesen ist, selbst wenn mehrere Befunde denselben Commit verwenden. Je nach Auswahldialog in deinem Workspace kannst du pro Prüfung bis zu 16 oder bis zu 100 Befunden einen Checkout zuweisen. Teile deine Auswahl auf, sobald du den angezeigten Grenzwert erreichst. Mit einer Bestätigung kannst du bis zu 100 Zielumgebungen autorisieren, eine pro Repository-Verbindung.

Scannerbericht hochladen

Wähle neben dem Scanner Datei hochladen. Die Einstellungen erkennen das Format und zeigen an, welche Exporte dein Workspace akzeptiert.

Scanner Datei für den Upload in den Einstellungen
Wiz Ein vollständiger Bericht über Paket-Schwachstellen im Format „Detailed JSON“ oder eine Datei im Format JSON Lines mit einem Befund im nativen Format pro Zeile. Filtere den Bericht in Wiz unter Vulnerability Findings. Wähle Save as → Report und für einen Repository-Export die Optionen Repository Branch, JSON und Detailed. Gib auf Aufforderung die ID des Wiz-Mandanten ein, aus dem der Export stammt.
Snyk Open Source Eine CSV-Datei vom Typ „Issues Detail“ aus einer einzelnen Organisation. Prüfe die Organisation in der Vorschau.
Endor Labs Befunde im nativen JSON-Format „Finding“ aus endorctl für den Namespace, den du importieren möchtest. Behalte die ursprünglichen UUIDs der Befunde bei und achte bei einem mehrseitigen Export darauf, alle Seiten zu exportieren.

Die hochgeladene Datei und ihr entpackter Inhalt dürfen jeweils höchstens 32 MiB umfassen. Das gilt auch für gzip-Uploads. Bei Snyk-CSV-Dateien und Wiz-Dateien im Format JSON Lines erkennen die Einstellungen bis zu 10.000 Datenzeilen pro Datei. Teile größere Dateien vor dem Hochladen auf. Ein einzelner JSON-Befund mit mehr als 1 MiB kann abgelehnt werden. Bei Snyk-CSV-Dateien darf die Kopfzeile höchstens 32.768 Zeichen enthalten, jedes Feld höchstens 131.072 Zeichen und jede logische Zeile höchstens 1.048.576 Zeichen.

Über Bewertung und Freigabe entscheiden

Beim Speichern lädst du die Datei zur Prüfung hoch. Prüfe vor dem Import die verifizierten Repositorys und Commits, die Zeilen, die noch einen Checkout benötigen, und etwaige abgelehnte Eingaben.

  • Um die Nachweise für später aufzubewahren, wähle Ohne Bewertung speichern, wenn die Importübersicht eine Bewertung anbietet. Wähle andernfalls Privat speichern.
  • Um geeignete Zeilen bewerten zu lassen und alle Ergebnisse privat zu halten, wähle Importieren und privat bewerten. Für Zeilen, denen noch ein Ziel fehlt, kannst du es später auswählen. Haben mehr als 10.000 Zeilen ein Ziel, teile den Bericht auf oder speichere ihn ohne Bewertung.
  • Um geeignete Ergebnisse zu teilen, aktiviere Meldefähige Befunde auch veröffentlichen. Die Option ist anfangs deaktiviert. Prüfe den Workspace und die Ziele. Kommen für ein Repository mehrere Umgebungen infrage, wähle eine davon oder Privat lassen. Bestätige mit Importieren und meldefähige Befunde veröffentlichen.

Für die automatische Freigabe muss der Befund als „Meldefähig“ bewertet sein. Außerdem muss der Scanner einen Schweregrad gemeldet haben und du musst ein Ziel autorisiert haben. Der ursprüngliche Bericht bleibt privat. Unter Aktivität kannst du mit Automatische Freigabe beenden weitere Veröffentlichungen aus diesem Import stoppen.

Befunde über die CLI importieren

Mit codex-security publish findings kannst du einen gespeicherten Scanner-Export importieren. Mit --to local --dry-run rufst du die lokale Vorschau auf. Für die Vorschau eines Cloud-Imports verwende --to cloud --dry-run --format json mit einem verbundenen Repository. Die Cloud-Vorschau stellt eine Verbindung zu Daybreak her und erfordert eine dateibasierte ChatGPT-Anmeldung.

Prüfe die Vorschau, bevor du --dry-run entfernst und den Import bestätigst. Ein Eintrag unter privateImport speichert die Befunde in deiner privaten Inbox. Einträge unter requests bewirken die Veröffentlichung in den dort aufgeführten Repository-Umgebungen. Prüfe im Importbeleg, ob es Ausschlüsse, Fehler oder unverarbeitete Zeilen gibt. Beispiele für lokale Importe und Cloud-Importe findest du in der CLI-Referenz. Die CLI-Formate und -Befehle findest du in den Anleitungen zum Scanner-Import.

Einen Import erneut öffnen

Öffne Meine letzten Importe über Einstellungen → Integrationen oder Befunde → Importieren in dem Workspace, in dem du den Import durchgeführt hast. Einen privaten Import kannst du auch über seinen Eintrag unter Scans erneut öffnen. Die Zusammenfassung zeigt das Ergebnis für jede Zeile. Bei abgelehnten Eingaben nennt sie auch den Grund. Öffne eine akzeptierte Zeile, um ihre Scanner-ID und die gespeicherten Nachweise einzusehen. Dort siehst du auch eine gegebenenfalls vorhandene Bewertung oder einen veröffentlichten Befund. Wenn du die Verbindung zum Scanner trennst, liest Daybreak darüber keine neuen Daten mehr ein. Deine gespeicherten Importe kannst du weiterhin öffnen.

Wähle bei einem privaten Befund Bewerten, damit Daybreak die Nachweise anhand des ausgewählten Commits prüft. Lies die Begründung neben Meldefähig, Zurückgestellt, Unterdrückt oder Nicht zutreffend. Kann Daybreak beispielsweise einen Commit nicht lesen, kann der Befund den Status „Zurückgestellt“ behalten. Um ein privat als „Meldefähig“ bewertetes Ergebnis zu teilen, wähle eine autorisierte Zielumgebung und dann Unter geteilten Befunden veröffentlichen. Hat der Scanner keinen erkannten Schweregrad angegeben, wähle vor der Veröffentlichung einen aus.

Wiederholte Importe erkennen

Wenn die Bestätigung unterbrochen wurde, öffne den ursprünglichen Importbeleg erneut oder wähle Ursprünglichen Import prüfen, sofern diese Option verfügbar ist. Wenn du die ursprüngliche Anfrage wiederholst, stellt Daybreak diesen Import mit den bereits gewählten Optionen wieder her.

Wenn du einen neuen Import startest, vergleicht Daybreak jede Zeile mit den bereits vorhandenen Nachweisen.

  • Bei derselben Endor-Verbindung und demselben Projekt können unveränderte Scanner-IDs und Nachweise auf die bestehende private Beobachtung verweisen. Das gilt auch bei derselben Wiz-Verbindung, wenn du dasselbe Projekt oder dieselbe gespeicherte Repository-Ansicht verwendest. Bei jedem neuen Import über eine Snyk-Verbindung erfasst Daybreak für jedes Issue eine neue private Beobachtung. Wenn du erneut eine Bewertung anforderst, kann Daybreak auch eine unveränderte Zeile erneut bewerten.
  • Wenn du dieselbe Snyk-CSV-Datei für dieselbe Organisation hochlädst, verwendet Daybreak die akzeptierten Zeilen erneut. Lädst du beispielsweise dieselben fünf Issues erneut hoch, kann die Übersicht fünf unveränderte und null neue Issues anzeigen. Geänderte Nachweise führen zu einer neuen Version. Eine frühere Bewertung bezieht sich weiterhin auf die damals geprüften Nachweise und den zugehörigen Commit.
  • Kommt eine Scanner-Befund-ID in einem Bericht mehrfach vor, markiert Daybreak beide Vorkommen und kann die übrigen gültigen Zeilen importieren. Behalte einen korrekten Datensatz mit dieser ID bei und importiere den korrigierten Bericht. Unterschiedliche IDs können verschiedene betroffene Pakete oder Repositorys bezeichnen, auch wenn sie auf dieselbe CVE verweisen.

Nach der Veröffentlichung prüft Daybreak, ob im selben Repository und derselben Umgebung bereits ein passender geteilter Befund vorliegt. Bei einer Übereinstimmung fügt Daybreak die veröffentlichten Nachweise dem bestehenden Issue hinzu. Für ein anderes Issue kann ein neuer Befund entstehen. Daher können zwei Scanner-Beobachtungen in einem geteilten Befund erscheinen. Wenn du dieselbe Veröffentlichung wiederholst, fügt Daybreak die Nachweise nur einmal hinzu. Öffne beim geteilten Befund Beobachtungen, um die Quellen einzusehen. Weitere Informationen findest du unter Befunde und Fehlerbehebungen prüfen.