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

Maßnahmen zur Härtung vorschlagen

Vergleiche Architekturänderungen und wäge ihre Vor- und Nachteile für Sicherheit und technische Umsetzung ab.

Mit $codex-security:propose-security-hardening kannst du anhand von Sicherheitsbefunden und zugehörigen Belegen Optionen zur Härtung der Struktur oder Architektur erarbeiten. Der Workflow kann einen abgeschlossenen Scan von Codex Security analysieren oder von bereitgestellten Befunden, Schwachstellenmeldungen, Vorfallanalysen, Prüfunterlagen und Quellcode ausgehen.

Das Ergebnis stellt die Entwurfsoptionen und ihre technischen Vor- und Nachteile gegenüber. Codex ändert das Repository erst, wenn du eine Option ausgewählt und Codex mit der Umsetzung beauftragt hast.

Belege zusammenstellen

Stelle dem Workflow folgende Informationen zur Verfügung:

  • Ein Scanverzeichnis oder eine Sammlung von Befunden und Berichten.
  • Den zu untersuchenden Quellcodebaum und, sofern verfügbar, die Revision oder einen Snapshot.
  • PoCs, Traces, Belege aus Sicherheitsvorfällen oder Prüfunterlagen, die die Befunde stützen.
  • Vorgaben zu Leistung, Speicherbedarf, Kompatibilität, Zuverlässigkeit, Betrieb, Liefertermin oder Umfang der Änderungen.

Wiederkehrende Autorisierungsfehler können zum Beispiel darauf hindeuten, dass sich Berechtigungen mit einem gemeinsamen Kontrollmechanismus leichter durchsetzen lassen als mit separaten Prüfungen in jedem Handler. Die Belege können aber auch dafür sprechen, eine lokale Korrektur beizubehalten und auf eine Architekturänderung zu verzichten.

Workflow ausführen

Sende zum Beispiel diesen Prompt:

Analysiere mit $codex-security:propose-security-hardening die Befunde aus [scan directory or finding paths] anhand von [source tree and revision]. Leite aus den Belegen Optionen zur strukturellen Härtung ab und stelle ihre technischen Vor- und Nachteile gegenüber. Erstelle Vorher-nachher-Diagramme, einen Migrationsplan und Übergabeunterlagen für die Implementierung. Ändere das Repository nicht.

Eine Option auswählen

Prüfe vor der Auswahl, ob der Vorschlag folgende Kriterien erfüllt:

  • Er zeigt für jede vorgeschlagene Änderung, welche Befunde, Quellcodestellen und Belege aus dem Bedrohungsmodell sie stützen.
  • Er beschreibt den aktuellen Entwurf und die Sicherheitsinvarianten, die der neue Entwurf wahren soll.
  • Er vergleicht unterschiedliche Optionen im Hinblick auf Restrisiko, Leistung, Zuverlässigkeit, Betrieb, Kompatibilität und Migrationskosten.
  • Er begründet die Empfehlung mit Belegen und benennt Annahmen und offene Fragen.
  • Er enthält Hinweise zur Einführung, Validierung, Rücknahme der Änderungen und Implementierung.
  • Er unterscheidet zwischen beobachteten Tatsachen, Schlussfolgerungen und vorgeschlagenen Eigenschaften des Entwurfs.

Prüfe die Belege und wäge die Vor- und Nachteile ab, bevor du dich für eine Option entscheidest. Weder ein Architekturdiagramm noch eine Entwurfsempfehlung ersetzt die Überprüfung der ursprünglichen Befunde oder der implementierten Korrektur.

Härtungsempfehlungen aus einem Scan nutzen

Wenn ein Standardscan, ein vertiefter Scan oder ein Scan von Änderungen Befunde liefert, die in den Bericht gehören, kannst du eine Übersicht der Härtungsmaßnahmen anfordern. Codex speichert die Übersicht in hardening/hardening.md, die strukturierte Analyse in hardening/hardening.json und ergänzende Vorschläge oder Diagramme unter hardening/. Der Scan verlinkt die Übersicht in report.md.

Bewahre das Scanverzeichnis vollständig auf, damit die Links weiterhin funktionieren. Wie du die einzelnen Berichte prüfst, auf denen die Übersicht beruht, erfährst du in Schwachstellenberichte erstellen.