Installiere das Plugin Codex Security, führe einen Standardscan für ein lokales Repository aus und prüfe die Befunde. Der Scan lässt deinen Quellcode unverändert und speichert einen Bericht mit Belegen und Hinweisen zur Behebung der Probleme.
Auf dieser Seite geht es um das Plugin Codex Security in der Desktop-App und in der Codex CLI. Wenn du ein verbundenes GitHub-Repository in Codex Cloud scannen möchtest, installiere das separate Plugin Daybreak Defense Factory (Preview) aus dem Plugin-Marketplace. Weitere Informationen findest du im Cloud-Setup.
Plugin installieren
-
Öffne Plug-ins und suche nach Codex Security oder nutze die folgende Schaltfläche:
-
Prüfe, ob das Plugin aktiviert ist, und öffne dann Sicherheit in der Seitenleiste.
Wenn bei der Plugin-Installation in einem verwalteten Workspace die Meldung „Durch die Administration deaktiviert“ erscheint, bitte die Person, der der Workspace gehört, den Zugriff auf Plugins zu prüfen. Wenn du ein persönliches Konto nutzt, findest du Hilfe in der Anleitung zur Fehlerbehebung bei Plugins und Apps.
-
Wechsle im Terminal in das Repository, das du prüfen möchtest, und starte Codex:
codex -
Gib
/pluginsein, suche nach Codex Security und wähle Install plugin. -
Gib
/newein, um einen neuen Chat für das Repository zu starten.
Um Codex Security für ein lokales Repository zu installieren, verwende die ChatGPT-Desktop-App oder die Codex CLI.
Wenn Sicherheit in der Seitenleiste der Desktop-App fehlt, prüfe, ob Codex ausgewählt und das Plugin aktiviert ist. Aktualisiere bei Bedarf die App und das Plugin. Prüfe außerdem, ob die Workspace-Administration das Plugin zulässt.
Versionen und Updates prüfen
Lies vor einem längeren Scan das Änderungsprotokoll des Plugins. In der Desktop-App verwaltest du deine Installation unter Plug-ins, in der Codex CLI über /plugins. Einzelheiten findest du im Leitfaden zu Plugins. Starte nach einem Plugin-Update einen neuen Chat, damit Codex die Skills und Tools des Plugins lädt. Gib dazu in der Codex CLI /new ein.
Codex und das Plugin Codex Security haben jeweils eine eigene Versionsnummer. Mit diesen Befehlen prüfst du in der Codex CLI die Version des Hosts und die Versionen der installierten Plugins:
codex --version
codex plugin list --json
Suche in der Liste installed nach Codex Security. Notiere dir beim Start eines Scans beide Versionsnummern, damit du sie angeben kannst, wenn du einen Fehler meldest.
Das eigenständige Paket @openai/codex-security enthält ein eigenes Plugin. Wenn du das Paket aktualisierst, wird das Marketplace-Plugin in Codex nicht mitaktualisiert. Wie du das Paket installierst und seine Version prüfst, erfährst du im Schnellstart für die CLI.
Wenn du Amazon Bedrock verwendest, konfiguriere den Codex-Host wie im Codex-Leitfaden für Amazon Bedrock beschrieben. Für das eigenständige Paket gelten die separaten Anbietereinstellungen der Security CLI.
Ersten Scan ausführen
Für die beste Scanqualität verwende gpt-5.6-sol und stelle den Reasoning-Aufwand auf xhigh.
Wähle ein Repository aus und konfiguriere den neuen Sicherheitsscan, bevor du ihn startest.
-
Scan-Setup öffnen
Wähle Sicherheit in der Seitenleiste, öffne Scans und wähle + Scan.
-
Codebasis und Scanbereich auswählen
Wähle ein vorhandenes Repository aus oder verwende einen anderen Ordner. Wähle Codebasis, lass Tiefenscan deaktiviert und wähle das gesamte Repository oder einen einzelnen Ordner aus. Prüfe anhand des Branches und der Revision, ob du den gewünschten Code scannst.
-
Sicherheitskontext ergänzen
Wähle das Modell und den Reasoning-Aufwand. Öffne Zusätzlicher Kontext nur, wenn du für die Prüfung einen Angriffsvektor, einen sicherheitskritischen Bereich oder ein Detail zum Repository beschreiben musst.
Aktiviere den zusätzlichen Kontext, um Angriffsvektoren und Prüfschwerpunkte zu beschreiben und relevante Sicherheitshinweise zu geben.
-
Scan starten
Wähle Scan starten und verfolge die einzelnen Scanphasen im Sicherheitsbereich. Wähle Aktivität anzeigen, um dir die Codex-Aufgabe anzusehen, die den Scan ausführt.
-
Ergebnis prüfen
Öffne den abgeschlossenen Scan, um die Befunde, die Prüfabdeckung und die verfügbaren Berichtsdateien einzusehen. Unter Befunde kannst du Probleme aus mehreren Scans prüfen. Unter Repositorys findest du den Scanverlauf eines Repositorys.
Prüfe die Scanergebnisse, die Befunde und die Prüfabdeckung im Sicherheitsbereich.
-
Standardscan anfordern
Sende diesen Prompt im neuen Chat:
Führe für dieses Repository einen Scan mit Codex Security durch. -
Scan bis zum Abschluss laufen lassen
Codex führt den Scan im Terminal aus, ohne einen Arbeitsbereich für das Setup zu öffnen. Lass die Aufgabe laufen, bis Codex den Abschluss meldet. Falls Codex auf eine Einschränkung der Konfiguration hinweist, prüfe die Einschränkung und den genauen Änderungsvorschlag, bevor du einer Aktualisierung der Konfiguration zustimmst.
-
Ergebnis prüfen
Lies die Zusammenfassung im Terminal und öffne dann die generierte Datei
report.md, um das vollständige Ergebnis zu sehen.
Führe diesen lokalen Plugin-Workflow in der ChatGPT-Desktop-App oder in der Codex CLI aus.
Ergebnis einordnen
Prüfe zuerst das Scanziel und die Revision. Lies anschließend nach, welche Bereiche geprüft wurden und welche für später zurückgestellt wurden. Auch nach einem abgeschlossenen Scan können Lücken in der Prüfabdeckung bleiben. Selbst wenn die Prüfung keine Befunde ergibt, können noch Schwachstellen vorhanden sein.
Öffne einen Befund. Lies nach, welche Stellen im Quellcode ihn belegen, welche Voraussetzungen für einen Angriff erfüllt sein müssen, wie der Befund validiert wurde und was noch unklar ist. Die Validierung kann sich auf die Analyse des Quellcodes stützen, ohne dass ein Beispiel zur Reproduktion ausgeführt wird. Entscheide anhand der dokumentierten Methode und der Belege, ob das Problem dein System betrifft.
Welche Dateien der Scan erstellt
In der Desktop-App findest du abgeschlossene Scans weiterhin unter Scans. Wenn du die Codex CLI verwendest, öffne das im Chat angegebene Scanverzeichnis. In report.md findest du das Ergebnis als lesbaren Bericht. Bei Bedarf kannst du detaillierte Schwachstellenberichte unter findings/ und Entwurfsvorschläge unter hardening/ anfordern.
Das Verzeichnis enthält außerdem scan-manifest.json, findings.json und coverage.json für Tools und Automatisierungen. Gib das Verzeichnis als Ganzes weiter oder archiviere es vollständig, damit die Links im Bericht weiterhin funktionieren.
Nächsten Workflow auswählen
- Lege Umfang und Sicherheitskontext fest, bevor du den nächsten Scan startest, oder prüfe eine Codeänderung.
- Behebe das Problem aus einem Befund und überprüfe die Korrektur, sobald dich die Belege überzeugen, oder verfolge den Befund in einem Issue.
Weitere Scanmodi und Workflows findest du in der Übersicht zu Codex Security.