Öffentlicher Client-Leak-Audit
Prüfe eine öffentliche Client-Codebasis, die mit einem privaten Backend kommuniziert. Ziel: Die öffentliche Oberfläche muss in sich geschlossen sein – sie darf die aufgerufenen Endpunkte und die ausgetauschten Datenformen offenlegen (unvermeidbar für jeden ausgelieferten Client), aber nichts darüber hinaus. Jedes zusätzliche Detail darüber, wie der Server funktioniert, ist kostenlose Aufklärung für einen Angreifer und ein Hebel für Missbrauch.
Dieser Skill produziert drei Dinge: eine Liste von Funden (Leaks + clientseitige Sicherheitslücken, jeweils mit Datei:Zeile und Schweregrad), eine Reihe von angewandten Korrekturen und einen Bericht mit verbleibenden Empfehlungen.
Referenzdateien (auf Abruf laden – lies die benötigte Datei, nicht alle auf einmal):
references/leak-taxonomy.md– die Kategorien von Offenlegungen, die es zu jagen gilt, warum jede relevant ist, und Suchmuster zum Starten.references/rewrite-rules.md– die Kommentar-/Zeichenketten-Umschreibungsregel mit Vorher-/Nachher-Beispielen; wie man entscheidet, ob man etwas behält oder streicht.references/client-hardening.md– Checkliste zur Client-Härtung (Berechtigungen, IPC, Tokens, DOM, Netzwerk, Build-Konfiguration, Lieferkette).references/report-template.md– die Struktur des Ausgabeberichts.scripts/leak-sweep.sh– ein parametrisierter Ripgrep-Durchlauf zur Initialisierung der Suche (passe die Muster-Arrays je nach Produkt an).
Das zentrale mentale Modell
Ordne jede Offenlegung einem von zwei Eimern zu:
- Notwendiges Minimum (behalten): die Endpunkte, die der Client aufruft, die Anfrage-/Antwortformen, die er tatsächlich sendet und empfängt, seine eigenen Wiederholungs-/Backoff-/Entprellungs-Entscheidungen, Eingabevalidierungs-Grenzen und die Abbildung
Status → UI-Verhalten. Ein öffentlicher Client kann diese nicht verbergen; etwas anderes zu behaupten, ist Sicherheitstheater. - Übermäßige Offenlegung (korrigieren): alles, was beschreibt, was der Server mit einer Anfrage macht, serverseitige Limits/Kontingente, die der Client nicht strikt benötigt, Endpunkte, die der ausgelieferte Client nie aufruft, Fehlerzweige, die die interne Serverlogik spiegeln, Anti-Missbrauchs-Mechanismen, Infrastruktur-/Technologie-Identifikatoren, private Repos/Pfade und Testgerüste, die Backend-Verhalten kodieren.
Die Umschreibungsregel. Client-Code und Tests dürfen den Vertrag nennen ("HTTP 422 → zeige die Meldung 'nicht unterstützter Anbieter'"). Sie dürfen nicht erklären, was oder warum der Server es tut ("der Server führt eine Prüfung auf Einweg-Domains durch und lehnt mit 422 ab"). Wenn ein Kommentar Serververhalten erklärt, lösche ihn entweder oder reduziere ihn auf den clientseitig beobachtbaren Vertrag. Siehe references/rewrite-rules.md.
Arbeitsablauf
Skaliere den Aufwand auf die Anfrage: Eine schnelle "Leckt das etwas?"-Prüfung ist Phase 1–2; "Vor Open-Source-Veröffentlichung säubern" oder "Vollständiges Audit" sind alle sechs Phasen. Bei einer großen Codebasis Phase 2 auf mehrere parallele schreibgeschützte Agenten aufteilen (einen pro Taxonomie-Cluster) und deren Datei:Zeile-Funde zusammenführen – aber den Umfang in Phase 1 selbst zuerst festlegen.
Phase 1 – Abgrenzung der öffentlich/privaten Grenze
Bevor du suchst, lege fest, was "privat" für dieses Produkt bedeutet. Überspringe das nicht – das gesamte Audit ist relativ zu dieser Grenze.
- Identifiziere die öffentlichen Artefakte, die geprüft werden, und die privaten Gegenstücke (Backend, Verwaltungstools, Infrastruktur, Monorepo-Geschwister). Frage den Benutzer oder leite es aus einer
AGENTS.md/README/CONTRIBUTINGab, falls die Trennung nicht offensichtlich ist. - Liste den Backend-Stack, das Hosting, die Datenbank, Anti-Missbrauchs-Mechanismen und alle Test-/Staging-Umgebungen des Produkts auf – damit du einen Leck erkennst, wenn du einen siehst. Wenn du sie nicht kennst, ist das die erste Frage an den Benutzer.
- Schreibe auf, was als notwendiges Minimum für diesen Client gilt (seine tatsächlichen Endpunkte und Nutzdaten), damit du keine Zeit damit verschwendest, das Unvermeidbare zu markieren.
Phase 2 – Durchlauf nach Leaks
Gehe die Taxonomie in references/leak-taxonomy.md durch. Decke das gesamte Repository ab, nicht nur src/: Tests/e2e, Docs, README/CHANGELOG, CI/Workflow-Dateien, .env* und ihre .example-Zwillinge, Build-/Konfigurationsdateien, Paketmanifeste (Skripte, postinstall) und Locale-/i18n-Zeichenketten (sie werden innerhalb des Pakets ausgeliefert). Führe scripts/leak-sweep.sh <target-dir> als Startdurchlauf aus, lies dann die Treffer im Kontext – ein Musterfund ist ein Hinweis, kein Urteil. Für jeden tatsächlichen Fund notiere Datei:Zeile, ein kurzes Zitat und einen einzigen Grund. Führe auch eine Liste "geprüft, sauber", damit der Bericht die Abdeckung zeigt.
Achte besonders auf zwei wertvolle, leicht zu übersehende Klassen:
- Geheimnisse einen Schritt vor der Veröffentlichung – echte Werte in git-ignorierten
.env*-Dateien, die ein Quellpaket (Store/App-Store "reviewable sources"-Zip,npm pack, ein Verzeichnis-Backup) enthalten würde, weil der Bundler.gitignorenicht beachtet. Nicht versionierte Dateien sind nicht sicher. - Test-/e2e-Code – deterministische Testanmeldeinformationen, spezielle Abfrageparameter, Endpunkte, die der ausgelieferte Client nie aufruft, und Kommentare, die Serverinterna erzählen. Hier lecken Backend-Verhalten am häufigsten, weil Tests erwartete Serverantworten dokumentieren.
Phase 3 – Client-Härtung
Führe references/client-hardening.md aus. Dies ist orthogonal zu Leaks: Es geht darum, ob der Client unabhängig von dem, was er preisgibt, ausnutzbar ist. Priorisiere Sender-/Ursprungsvalidierung bei privilegierten IPC, Auth-Token-Speicherung und -Abfluss, DOM-/XSS-Senken, die von Seiten- oder Serverdaten gespeist werden, übermäßig breite Berechtigungen und Build-Zeit-Konfiguration, die es einem vergifteten Build erlaubt, das Backend umzuleiten oder ein Geheimnis zu bündeln.
Phase 4 – Behebung
Wende die Korrekturen an. Reihenfolge der Auswirkungen:
- Schließe zuerst Kanäle für Geheimnis-Leaks (schließe
.env*/Geheimnisdateien aus Quellpaketen aus; verschiebe echte Werte aus dateiartigen Positionen neben dem Commit). - Wende die Umschreibungsregel auf durchsickernde Kommentare/Zeichenketten/Docs an; bevorzuge Umbenennung von Code, sodass ein Kommentar unnötig wird, vor der Neuformulierung des Kommentars.
- Lösche toten Code, der Serverrichtlinien hartkodiert (Sitzungs-TTLs, Kontingente, entfernte Endpunkte).
- Kürze Tests/Docs auf den clientseitig beobachtbaren Vertrag; halte den Ablauf funktionsfähig, schneide die Erzählung.
- Lande die Härtungsänderungen mit Tests.
Verhaltenserhaltend ist die Standardeinstellung: Halte öffentliche API-Verträge, Speicher-IDs, Nachrichtennamen und Anfrage-/Antwortformen stabil, es sei denn, die Aufgabe will explizit eine funktionale Änderung.
Phase 5 – Verifikation
Beweise, dass du nichts kaputt gemacht und nichts übersehen hast:
- Führe das Typecheck, die Unit-Tests, den Linter und einen Produktionsbuild des Projekts aus. Erfasse die tatsächlichen Exit-Codes (ein
cmd | tail-Pipe meldet den Status vontailund verbirgt einen fehlgeschlagenen Build – führe ohne Pipe aus oder verwendePIPESTATUS/set -o pipefail). - Führe den Leak-Durchlauf erneut aus; bestätige, dass die beabsichtigten Muster jetzt null sind (außer absichtliche).
- Durchsuche das erstellte Artefakt und jedes Quellpaket nach Geheimnissen, Sourcemaps und internen Zeichenketten – grep
dist//Build-Ausgabe und das Quell-Zip. Verlasse dich nicht allein auf die Sauberkeit des Quellverzeichnisses. - Bestätige, dass legitime Abläufe noch funktionieren (z. B. ein Staging-/e2e-Build, der anders sein darf, wird korrekt aufgelöst).
Phase 6 – Bericht
Schreibe den Bericht gemäß references/report-template.md: Funde nach Schweregrad, angewandte Änderungen, verbleibende Empfehlungen (Geheimnisrotation, Git-History-Exposition, bewusst zurückgestellte Kompromisse) und die Verifikationsnachweise. Beachte, dass Git-History nicht rückwirkend korrigierbar ist – ein entferntes Geheimnis oder ein beschreibender Commit-Betreff bleibt im Log; empfehle Rotation und zukünftige Commit-Nachrichten-Hygiene anstelle einer Umschreibung der History eines öffentlichen Repos.
Leitplanken
- Markiere das Unvermeidbare nicht übermäßig. Endpunkte, Nutzdatenformen und
Status → UI-Abbildungen sind notwendiges Minimum; sie zu markieren untergräbt das Vertrauen in den Bericht. - Ein Musterfund ist ein Hinweis. Lies ihn im Kontext, bevor du ihn als Leck bezeichnest – "epoch" ist normalerweise ein Zeitstempel, "worker" könnte ein Web Worker sein, "durable" könnte eine Warteschlange sein, nicht Durable Objects.
- Behalte benutzerseitige Zeichenketten, die eine für den Benutzer relevante Richtlinie nennen (z. B. "Codes laufen in 10 Minuten ab"); schneide den internen Rahmen in der unsichtbaren Beschreibung/dem unsichtbaren Kommentar daneben.
- Dieser Skill prüft deine eigene / autorisierte Codebasis, um ihre öffentliche Angriffsfläche zu verringern. Er ist defensiv: Reduzierung von Offenlegung und Härtung des Clients, nicht das Bauen von Exploits.