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_lineundend_line: die erste und die letzte Zeile des anfälligen Codes. Ein Ergebnis kann mehrere Zeilen umfassen. Für eine einzelne Zeile können Sielineanstelle vonstart_lineundend_linefestlegen.snippet: der anfällige Code. Wenn ein Ergebnis weder einen Zeilenbereich noch ein Snippet enthält, deckt es die gesamte Datei ab undcm fixsucht in der Datei nach dem anfälligen Code.title,message,analysisundvuln_type: eine Beschreibung des Ergebnisses. Für jedes Ergebnis ist mindestens eines dieser Felder erforderlich.severity:CRITICAL,HIGH,MEDIUModerLOW. Der Standardwert istMEDIUM.
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:
- Führen Sie
cm reportaus, um die Liste der registrierten Ergebnisse aufzurufen und die generierten<finding-id>-Werte abzurufen. - Führen Sie die Überprüfung für ein importiertes Ergebnis aus, um einen Proof-of-Concept-Exploit zu generieren:
cm verify FINDING_ID
- Generieren und validieren Sie einen Sicherheitspatch für das Ergebnis:
cm fix FINDING_ID