Sicherheitsergebnisse von Drittanbietern importieren

Wenn Sie bereits statische Analysen oder Tools zum Scannen auf Sicherheitslücken von Drittanbietern verwenden, können Sie die Ergebnisse direkt in CodeMender importieren, um sofort mit der Überprüfung und dem Patchen fortzufahren.

Sicherheitsberichte importieren

CodeMender parst externe Sicherheitsberichte und registriert die Ergebnisse in seiner lokalen Datenbank.

JSON-Datei mit Ergebnissen importieren

Verwenden Sie das Flag --file (oder -f), um Ergebnisse aus einer JSON-Datei zu importieren. Die JSON-Datei enthält ein Array von Ergebnissen, z. B.:

[
  {
    "file_path": "src/auth/session_manager.py",
    "start_line": 42,
    "end_line": 47,
    "snippet": "cursor.execute(\"SELECT * FROM users WHERE id = \" + user_id)",
    "title": "SQL Injection",
    "message": "Raw user input concatenated in SQL query",
    "severity": "HIGH",
    "vuln_type": "CWE-89"
  }
]

Jedes Ergebnis enthält die folgenden Felder:

  • file_path (erforderlich): der Pfad zur betroffenen Datei.
  • start_line und end_line: die erste und die letzte Zeile des anfälligen Codes. Ein Ergebnis kann mehrere Zeilen umfassen. Für eine einzelne Zeile können Sie line anstelle von start_line und end_line festlegen.
  • snippet: der anfällige Code. Wenn ein Ergebnis weder einen Zeilenbereich noch ein Snippet enthält, deckt es die gesamte Datei ab und cm fix sucht in der Datei nach dem anfälligen Code.
  • title, message, analysis und vuln_type: eine Beschreibung des Ergebnisses. Für jedes Ergebnis ist mindestens eines dieser Felder erforderlich.
  • severity: CRITICAL, HIGH, MEDIUM oder LOW. Der Standardwert ist MEDIUM.

Sie können auch einen SARIF 2.1.0-Bericht oder eine CSV-Datei importieren. Eine CSV-Datei benötigt eine Kopfzeile, die file_path und mindestens eines der anderen Felder enthält, z. B. eine Datei, die Sie mit cm report --format csv exportiert haben. Führen Sie cm report import --help aus, um die Formate zu sehen, die von Ihrer CLI-Version unterstützt werden.

Führen Sie den Importbefehl aus:

cm report import --file ./findings.json

Interaktiver Importmodus

Wenn Sie keine JSON-Datei haben, können Sie den Importbefehl ohne das Flag --file ausführen, um einen interaktiven Assistenten in Ihrem Terminal aufzurufen:

cm report import

Folgen Sie den Aufforderungen, um den Pfad, die Zeilennummer, den Schweregrad und die Beschreibung für jedes Ergebnis einzugeben. Geben Sie bei einer beliebigen Eingabeaufforderung q ein, um den Vorgang abzuschließen und zu speichern.

Importierte Ergebnisse verarbeiten

Nach dem Importieren externer Ergebnisse:

  1. Führen Sie cm report aus, um die Liste der registrierten Ergebnisse aufzurufen und die generierten <finding-id>-Werte abzurufen.
  2. Führen Sie die Überprüfung für ein importiertes Ergebnis aus, um einen Proof-of-Concept-Exploit zu generieren:
    cm verify FINDING_ID
  3. Generieren und validieren Sie einen Sicherheitspatch für das Ergebnis:
    cm fix FINDING_ID