Sicherheitsprüfung
Die Sicherheitsprüfung wird mit einem Schlüssel gesetzt, security-check, in der Tabelle Checks von docs/ai/config.md. Anders als die übrigen Prüfungen nimmt sie nicht block, warn oder off, sondern eine Stufe.
| Wert | Führt aus |
|---|---|
off |
nichts |
local (Standard) |
den Scan nach gefährlichen Mustern |
deps |
den Musterscan plus die Abhängigkeitsabfrage |
full |
beides, plus die tiefe Prüfung auf Anforderung und vor einem Release |
Gefährliche Muster (alle Stufen außer off)
Abschnitt betitelt „Gefährliche Muster (alle Stufen außer off)“Bei git commit werden die hinzugefügten Zeilen nach Konstrukten wie eval/exec, shell=True, pickle.loads, yaml.load ohne sicheren Loader, v-html, innerHTML = und per Zeichenkettenverkettung gebautem SQL durchsucht. Die SQL-Prüfungen verlangen eine Anweisungsstruktur (SELECT ... FROM, INSERT INTO, UPDATE ... SET, DELETE ... FROM); das Wort „update“ oder „select“ in Fließtext oder URL hält also keinen Commit auf. Das getaggte Template-Literal eines Query-Builders, in dem jedes ${…} ein gebundener Parameter ist (sql`select … where code = ${code}` in Kysely, Drizzle oder postgres.js, Prisma.sql`…` , $queryRaw`…` , $executeRaw`…` ), wird nicht gemeldet; eine Zeile mit einem Raw-Helfer (sql.raw, sql.unsafe, Prisma.raw, $queryRawUnsafe und ähnliche), ein ungetaggtes Template-Literal oder echte +-Verkettung wird weiterhin gemeldet. Mit eingeschaltetem Regelsatz sql melden in PHP-Dateien (.php, .php3 bis .php8, .pht, .phtml, .inc, .module) sql-php-concat (Verkettung) und sql-php-interpolation (eine Variable in der Zeichenkette, auch ${name}) dasselbe, und sql-format meldet SQL, das mit "..." % x oder "...".format(...) gebaut wird; ein LIKE '%…%'-Operand oder ein Datumsformat wie strftime('%Y', d) gilt nicht als %-Operator. Ein festes DELETE … FROM- oder INSERT INTO-Literal gilt nur dann als Verkettung, wenn seine Zeile ein Anführungszeichen und + enthält. Eine schlichte raise-, print-, Logger- oder warnings.warn-Zeile (Python) oder echo-, error_log-, throw new- oder Logger-Zeile (PHP), die nur Zeichenketten-Literale und einfache Operanden enthält, gilt nicht als SQL aus Werten, auch wenn ihre Meldung select ... from enthält. Gesucht wird nur nach den Coding-Regelsätzen, die du in docs/project/coding_rules.md eingeschaltet hast. Diese Regelsätze lädt der Scan nur für einen Commit; ein kaputtes rules.py oder eine coding_rules.md in cp1252 sperrt so nicht mehr jeden Shell-Befehl mit git, ein Commit sperrt weiterhin mit der Absturzmeldung.
- Ein Treffer stoppt den Commit einmal pro Datei und Muster, mit Fundstelle. Behebe ihn, oder committe erneut, um ihn durchzulassen.
- Eine Zeile mit
act:allow-dangerist ausgenommen. - Ein Fund, den die Übernahme-Baseline von
act-adoptgebucht hat (adopt_baseline.pyprüft den vorhandenen Code einmal und bucht die Funde im Backlog), geht ohne den ersten Halt durch, sodass der erste Commit eines übernommenen Projekts nicht wegen Mustern aufgehalten wird, die schon vorher da waren. Es zählt nur das genaue Paar aus Datei und Regel, und eine Buchung läuft nicht ab: Ein neuer Treffer dieser Regel in dieser Datei geht ebenfalls durch, bis ihr Schlüssel aus.act-local/danger-scan-hints/baseline.jsonentfernt ist. Geheimnisse halten weiterhin. - Dokumentation (
.md,.txt,.rst) und alles unter.act/wird nie gescannt.
Das ist getrennt von secret-scan, einer regulären block/warn/off-Prüfung, die einen Commit stoppt, dessen vorgemerkter Diff einen Schlüssel, Token, privaten Schlüssel, eine .env-Datei oder eine Zuweisung mit hoher Entropie enthält. Sie erkennt außerdem Zugangsdaten in einem URL-Query-String, einen Schlüssel in einfachen Anführungszeichen ({'token': '...'}), einen PHP-Array-Eintrag ('token' => '...'), einen Literal-Fallback hinter einer Umgebungsvariablen-Abfrage (os.environ.get("API_TOKEN", "..."), process.env.API_TOKEN || "...") und ein Zugangsdaten-Paar in einem Wert in Anführungszeichen. Eine Zeile mit act:allow-secret ist ausgenommen. Ausgenommen ist auch eine Form in .act-lock.json im Projektwurzelverzeichnis: der Override-Hash, den doctor --accept schreibt, mit einer Regel-ID als Schlüssel und genau 64 kleingeschriebenen Hex-Ziffern als Wert, sonst nichts in der Zeile (eine Regel-ID wie R-safe-no-secret-cli neben einem Hex-Wert gilt nicht mehr als Zugangsdaten). Eine bekannte Token-Form in dieser Zeile wird weiter erkannt.
Eine Datei, die keinen Kommentar tragen kann (JSON, etwa ein Script-Eintrag, dessen Name nach Zugangsdaten aussieht), wird stattdessen über eine Liste behandelt: docs/ai/local/secret-accepted.md, pro angenommener Zeile eine Zeile - <path> <hash>: <reason>. <path> ist relativ zur Projektwurzel mit /, <hash> ein Hash der Zeile. Du rechnest ihn nicht selbst aus: Die Sperrmeldung druckt für jeden Fund den fertigen Eintrag (Pfad und Hash, nie den Wert), den du einfügst. Die Ausnahme fällt, sobald sich die Zeile ändert oder dieselbe Zeile in einer anderen Datei steht; der Commit wird dann wieder gesperrt. Eine fehlende, zu große oder unlesbare Liste nimmt nichts aus, und ein Eintrag, der die Liste selbst nennt, wird ignoriert.
Abhängigkeitslücken (deps, full)
Abschnitt betitelt „Abhängigkeitslücken (deps, full)“Eine Live-Abfrage bekannter Schwachstellen in deinen Abhängigkeiten. Sie nutzt osv-scanner, falls installiert, sonst npm audit, pnpm audit, composer audit oder pip-audit für das passende Ökosystem. Zu den Lock- und Requirement-Dateien, die sie liest, gehören package-lock.json, pnpm-lock.yaml (pnpm 9 oder neuer), composer.lock, requirements.txt, go.mod und Cargo.lock.
- Beim Commit: für genau die Lock-Dateien, die dieser Commit berührt. Der Scan läuft im Hintergrund; ist er nicht fertig, wird der Commit einmal mit „dependency scan running” abgelehnt, und der erneute Versuch liest das Ergebnis, das für den Tag zwischengespeichert ist. Wird ein Scan nie fertig, startet der Commit einen neuen Scan; stirbt auch der, wird der Commit verweigert, statt als „nicht geprüft“ durchzugehen. Um nur diesen Scan abzuschalten, setze
security-check: local. - Ein verlinkter Scan-Cache hält den Commit an: Solange
.act-localoder sein Scan-Cache-Ordner ein Link oder eine Junction ist, lässt sich dadurch kein Scan-Ergebnis festhalten; ein Commit, der eine Lock-Datei berührt, wird deshalb angehalten, statt ungeprüft durchzugehen. Die Meldung nennt den Link; er wird durch einen echten Ordner ersetzt, odersecurity-check: offwird gesetzt. - Nach
git merge,git pullodergit cherry-pick: Die Lock-Dateien, die der Befehl hereingebracht hat, werden gleich danach geprüft. Nichts wird aufgehalten; ein Befund landet als ein Bericht in der Inbox, einmal pro Lock-Datei-Stand und Tag. - Beim Sitzungsstart: einmal am Tag über jede Lock-Datei im Projekt, außer in Ordnern, die git ignoriert, und in verschachtelten Checkouts. Der Hinweis ist je Lock-Datei gruppiert und nennt das Alter des Scans; ein Ergebnis entfällt, sobald eine gescannte Lock-Datei sich geändert hat oder verschwunden ist.
- Was einen Commit aufhält: ein nicht akzeptierter Befund der Schwere high oder critical, mit Paket, Version, Advisory-Id, Schwere und behobener Version. Eine geringere oder unbekannte Schwere wird nur vermerkt.
pip-auditmeldet keine Schwere, seine Befunde werden daher nur vermerkt. - Einen Befund akzeptieren: füge eine Zeile
- <advisory-id>: <reason>indocs/ai/local/security-accepted.mdein, eine pro Zeile;#-Kommentare und Leerzeilen werden ignoriert. Die Id ist die, die das Scan-Werkzeug meldet (npm auditnutzt Zahlen,osv-scannerundpnpm auditnutzen GHSA-Ids); nach einem Wechsel des Paketmanagers brauchen die Einträge also neue Ids (act-depsweist darauf hin). - Fehler blockieren nie, außer ein Scan, der zweimal stirbt, und ein unlesbarer Bericht mit Funden: Ein fehlendes Werkzeug wird einmal pro Rechner mit seinem Installationsbefehl vermerkt; ein Netzwerk- oder Werkzeugfehler wird jedes Mal vermerkt, und der Commit geht durch, damit ein Rechner ohne Netz weiter committen kann.
python .act/scripts/security_scan.py --depsmeldet dann „scan incomplete“ statt „no known vulnerability found“. Endet ein Werkzeug mit seinem Exitcode für Funde, hinterlässt aber keinen lesbaren Bericht (beipip-audit, dessen eigene schwere Fehler ebenfalls mit 1 enden, nur einen nicht leeren), hält das den Commit an, weil niemand sagen kann, was gefunden wurde:security_scan.py --depsendet mit 1 und einer ZeileUNREAD FINDINGS, und auch der Hinweis beim Sitzungsstart und der Bericht nach einem Merge zeigen es.
Die tiefe Prüfung (full)
Abschnitt betitelt „Die tiefe Prüfung (full)“python .act/scripts/security_deep.py [--since <ref> | --all] führt Semgrep mit offenen Regelsätzen über die Dateien aus, die sich seit dem jüngsten Tag geändert haben (oder mit --all über den ganzen Baum). Sie läuft nur auf Anforderung und vor einem Release (act-release), nie bei jedem Commit, und bei einer anderen Stufe als full gibt sie eine Zeile aus und tut nichts, es sei denn, du übergibst --force. Der Release-Skill fügt einen Sicherheitsdurchgang durch die Rolle reviewer hinzu. Sein Urteil folgt dem Schweregrad: BLOCK nur für einen Fehler auf einem Pfad, den gewöhnliche Arbeit erreicht, einen fehlenden Teil des Auftrags, eine Sicherheitslücke, die ein Modell ohne Absicht erzeugen kann, oder eine abgeschwächte Prüfung, deren Grund der Autor nicht nennt; ein konstruierter Randfall wird stattdessen als Backlog-Fall abgelegt.
Welche Stufe wählen
Abschnitt betitelt „Welche Stufe wählen“local kostet nichts und braucht kein Werkzeug. Wechsle zu deps, wenn das Projekt Lock-Dateien hat und du Befunde zu bekannten Schwachstellen haben willst, bevor sie ausgeliefert werden; zu full vor Releases. Siehe die Konfigurationsreferenz für die genaue Zeile und Konfiguration dafür, wie Prüfungen allgemein funktionieren.