Codex Security Review ist mit ChatGPT Enterprise, ChatGPT Business, ChatGPT Edu und ChatGPT Pro verfügbar. Mit ChatGPT Plus ist die Funktion nicht verfügbar. Sicherheitsprüfungen verbrauchen einen Teil deines im Plan enthaltenen Codex-Kontingents oder ChatGPT-Credits.
Mit der Sicherheitsprüfung kannst du den Diff eines Pull Requests auf GitHub und den zugehörigen Code auf Sicherheitsprobleme prüfen. Wenn du ein Bedrohungsmodell oder Sicherheitsvorgaben hinterlegt hast, berücksichtigt Codex diese bei der Prüfung. Codex veröffentlicht Befunde, die deine Meldeschwelle erreichen.
Code Review kann bei der allgemeinen Codeprüfung ebenfalls Sicherheitsprobleme melden. Daher können beide Prüfungen denselben Befund melden.
Voraussetzungen
Um automatische Sicherheitsprüfungen mit Codex zu konfigurieren, brauchst du:
- Zugriff auf Codex Security Review für deinen Workspace
- eine konfigurierte Codex Cloud mit einem verbundenen GitHub-Repository
- Push- oder Adminrechte auf GitHub für die Einstellungen des Repositorys
Du kannst die Prüfungen aktivieren, bevor du das Repository scannst.
PR-Prüfungen in Daybreak aktivieren
- Öffne Daybreak und wähle auf dem Willkommensbildschirm PR-Prüfungen einrichten.
- Verbinde deine GitHub-Organisation, wenn du dazu aufgefordert wirst. Wähle die Repositorys aus, in denen Daybreak Pull Requests prüfen soll.
- Wähle PR-Prüfungen aktivieren. Daybreak prüft jeden neuen Pull Request in diesen Repositorys, sobald er geöffnet wird.
Codex Security Review konfigurieren
Die Einstellungen des Repositorys gelten für alle. Änderungen betreffen alle Pull Requests, die unter die Richtlinie Überprüfung des Repositorys fallen, auch die anderer Personen. Deine persönlichen Einstellungen gelten für deine Pull Requests, wenn das Repository persönliche Einstellungen berücksichtigt.
- Öffne die Codex-Einstellungen und wähle ein Repository aus.
- Aktiviere unter Auf Sicherheitslücken prüfen die Option Automatische Sicherheitsprüfung.
- Lege unter Überprüfung fest, welche Pull Requests Codex auf Sicherheitsprobleme prüft:
- Mit Persönliche Einstellungen berücksichtigen kann jede Person, die zum Repository beiträgt, die Sicherheitsprüfung in ihren persönlichen Codex-Einstellungen aktivieren.
- Alle PRs gilt für jeden Pull Request im Repository.
- Team-PRs gilt, sofern verfügbar, für Pull Requests, die Mitglieder deines ChatGPT-Workspaces öffnen. Die Mitgliedschaft in einem GitHub-Team spielt dabei keine Rolle.
- Lege unter Auslöser fest, wann Codex die Sicherheitsprüfung ausführt:
- Beim Öffnen eines PR startet die Sicherheitsprüfung unabhängig von Code Review, sobald jemand einen Pull Request öffnet.
- Bei jedem Push startet die Sicherheitsprüfung unabhängig von Code Review, sobald jemand neue Commits pusht.
- Bei jeder Codeprüfung setzt Code Review voraus. Codex führt die Sicherheitsprüfung zusammen mit Code Review aus.
Wenn du GitHub verbindest oder persönliche Prüfungen für eine andere Person aktivierst, löst das keine zusätzliche Prüfung deiner Pull Requests aus. Ob eine automatische Prüfung stattfindet, hängt von den Einstellungen des Repositorys und den persönlichen Einstellungen ab. Codex führt dabei keine separate Prüfung für jede verbundene Person aus. Je nach Einstellung unter Auslöser können spätere Pushes eine weitere Prüfung auslösen. Zusätzliche Prüfungen kannst du auch manuell anfordern.
Kontext aus einem Bedrohungsmodell hinzufügen
Du kannst ein Bedrohungsmodell konfigurieren, damit Codex weiß, welche Werte deine Anwendung schützen muss, wo ihre Vertrauensgrenzen liegen, welche Sicherheitsannahmen gelten und welche Risiken für das Repository bestehen. Ist für das Repository bereits ein Scan mit Codex Security konfiguriert, kannst du dessen Bedrohungsmodell verwenden. Gib andernfalls den Pfad zu einer im Repository eingecheckten Datei mit dem Bedrohungsmodell an. Ohne Quellenangabe erstellt Codex das Bedrohungsmodell bei jeder Prüfung neu.
Meldeschwellen festlegen
Standardmäßig melden automatische Sicherheitsprüfungen mit Codex Befunde der Schweregrade Hoch und Kritisch. Manuell angeforderte Prüfungen melden Befunde der Schweregrade Mittel, Hoch und Kritisch. Du kannst den Mindestschweregrad für automatische und manuelle Prüfungen getrennt festlegen und für einzelne Pfade abweichende Schwellen definieren.
Für Befunde, die Codex in einem Pull Request veröffentlicht, gelten auf GitHub dieselben Zugriffsrechte wie für den Pull Request selbst. Wer den Pull Request sehen kann, kann auch die Befunde sehen. Das gilt auch für öffentliche Repositorys und für Pull Requests von Personen außerhalb deines Workspaces. Die Meldeschwelle bestimmt, welche Befunde Codex auf GitHub veröffentlicht. Der vollständige Bericht zur Sicherheitsprüfung bleibt in Codex.
Sicherheitsprüfung mit Codex anfordern
Um eine Sicherheitsprüfung mit Codex manuell anzufordern, füge einem Pull Request diesen Kommentar hinzu:
@codex security review
Während der Prüfung reagiert Codex auf den Kommentar. Anschließend veröffentlicht Codex alle Befunde, die deine Meldeschwelle für manuelle Prüfungen erreichen, direkt im Pull Request. Öffne die zugehörige Codex-Aufgabe und wähle den Tab Sicherheitsbericht. Dort findest du den vollständigen Bericht mit Schweregrad, Angriffspfad, Belegen, Validierung und Hinweisen zur Behebung. Erreicht kein Befund die Meldeschwelle, veröffentlicht Codex keine Befunde im Pull Request. Wenn dort keine Befunde erscheinen, prüfe den Aufgabenstatus und den vollständigen Bericht, bevor du davon ausgehst, dass die Prüfung ohne Befund abgeschlossen wurde.
Weiterführende Dokumentation
- Pull Requests auf GitHub mit Codex prüfen erklärt, wie Code Review und die GitHub-Integration funktionieren.
- Codex Security gibt einen Überblick über das Produkt.
- Setup für Daybreak Defense Factory erklärt, wie du Repositorys scannst und Befunde prüfst.
- Das Bedrohungsmodell verbessern erklärt, wie du den Kontext für dein Repository anpasst.