Communitygithub.com

Caido-Modus

Vollständige CLI für die Caido-API, die HTTP-Verlauf, Sitzungen, Scopes, Filter, Umgebungen, Erkenntnisse und mehr abdeckt.

Was ist Caido-Modus?

Diese Fertigkeit (Skill) bietet ein vollständiges CLI-Tool zur Interaktion mit der Caido-API, das auf dem offiziellen `@caido/sdk-client`-Paket basiert. Sie deckt eine breite Palette von Funktionen ab, darunter die Suche im HTTP-Verlauf mit HTTPQL, das Abspielen und Bearbeiten von Anfragen, die Verwaltung von Wiedergabesitzungen und -sammlungen, Fuzzing, die Definition von Testbereichen (Scopes), das Speichern von Filtervorgaben, die Verwaltung von Umgebungsvariablen, das Erstellen von Sicherheitserkenntnissen (Findings), das Überwachen von Hintergrundaufgaben, den Projektwechsel, die Verwaltung gehosteter Dateien, die programmatische Steuerung der Abfangs (Intercept) und die Prüfung der Caido-Instanzgesundheit. Der Schlüsselvorteil ist die Möglichkeit, Anfragen direkt aus dem HTTP-Verlauf zu bearbeiten und erneut abzuspielen, wobei alle Authentifizierungs-Cookies und -Token erhalten bleiben – ein großer Vorteil gegenüber manuellem Kopieren und Einfügen. Die Authentifizierung erfolgt über ein Personal Access Token (PAT), das einmalig eingerichtet und dann automatisch zwischengespeichert wird. Die Fertigkeit ist plattformunabhängig und wird über die Kommandozeile ausgeführt. Sie ist ideal für Penetrationstester und Sicherheitsforscher, die Caido effizient und reproduzierbar nutzen möchten.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor✓OpenCode
npx skills add Aceproulx/claude-skills

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Caido-Modus Skill

Übersicht

Vollständige CLI für die Caido-API, basierend auf dem offiziellen @caido/sdk-client-Paket. Abdeckung:

  • HTTP-Verlauf – Suchen, Abrufen, Abspielen, Bearbeiten von Anfragen mit HTTPQL
  • Wiedergabe & Sitzungen – Sitzungen, Sammlungen, Einträge, Fuzzing
  • Scopes (Bereiche) – Erstellen und Verwalten von Testbereichen (Allowlist-/Denylist-Muster)
  • Filtervorgaben – Speichern und Wiederverwenden von HTTPQL-Filtervorgaben
  • Umgebungen – Speichern von Testvariablen (Opfer-IDs, Token usw.)
  • Erkenntnisse (Findings) – Erstellen, Auflisten und Aktualisieren von Sicherheitserkenntnissen
  • Aufgaben – Überwachen und Abbrechen von Hintergrundaufgaben
  • Projekte – Wechseln zwischen Testprojekten
  • Gehostete Dateien – Verwalten von Dateien, die von Caido bereitgestellt werden
  • Abfang (Intercept) – Programmgesteuertes Aktivieren/Deaktivieren des Abfangs von Anfragen
  • Plugins – Auflisten installierter Plugins
  • Export – Konvertieren von Anfragen in Curl-Befehle für PoCs
  • Gesundheit – Überprüfen des Status der Caido-Instanz

Der gesamte Datenverkehr läuft über Caido, sodass er in der Benutzeroberfläche für weitere Analysen sichtbar ist.

Warum dieses Modell?

Cookies und Authentifizierungstoken können sehr groß sein – Sitzungscookies, JWTs, CSRF-Token können leicht 1–2 KB erreichen. Statt manuellem Kopieren und Einfügen:

  1. Eine organische Anfrage im HTTP-Verlauf von Caido finden, die bereits gültige Authentifizierung enthält
  2. edit verwenden, um nur das Nötigste zu ändern (Pfad, Methode, Body) und dabei alle Authentifizierungs-Header intakt zu lassen
  3. Absenden – die Antwort kommt mit vollständigem Kontext zurück

Einrichtung der Authentifizierung

Einrichtung (Einmalig)

  1. Öffnen Sie Dashboard → Entwickler → Persönliche Zugriffstoken
  2. Erstellen Sie ein neues Token
  3. Führen Sie aus:
npx tsx ~/.agents/skills/caido-mode/caido-client.ts setup <ihr-pat>

# Nicht-Standard-Caido-Instanz
npx tsx ~/.agents/skills/caido-mode/caido-client.ts setup <pat> http://192.168.1.100:8080

# Oder Umgebungsvariable setzen
# export CAIDO_PAT=caido_xxxxx

Der setup-Befehl validiert das PAT über das SDK (das es gegen ein Zugriffstoken eintauscht) und speichert dann sowohl das PAT als auch das zwischengespeicherte Zugriffstoken in ~/.agents/config/secrets.json. Nachfolgende Ausführungen laden das zwischengespeicherte Token direkt, und ein gültiges zwischengespeichertes Token kann auch ohne das PAT verwendet werden.

Status prüfen

npx tsx ~/.agents/skills/caido-mode/caido-client.ts auth-status

So funktioniert die Authentifizierung

Das SDK verwendet intern einen Device-Code-Flow – das PAT genehmigt diesen automatisch und erhält ein Zugriffs- und ein Aktualisierungstoken. Ein benutzerdefinierter SecretsTokenCache (der das TokenCache-Interface des SDK implementiert) speichert diese Token in secrets.json, sodass sie über CLI-Aufrufe hinweg erhalten bleiben.

Authentifizierungsauflösung: CAIDO_PAT-Umgebungsvariable → ~/.agents/config/secrets.json PAT → gültiges zwischengespeichertes Zugriffstoken → Fehler mit Einrichtungsanleitung

CLI-Tool

Befindet sich unter ~/.agents/skills/caido-mode/caido-client.ts. Alle Befehle geben JSON aus.


HTTP-Verlauf & Testbefehle

search – HTTP-Verlauf mit HTTPQL durchsuchen

npx tsx caido-client.ts search 'req.method.eq:"POST" AND resp.code.eq:200'
npx tsx caido-client.ts search 'req.host.cont:"api"' --limit 50
npx tsx caido-client.ts search 'req.host.cont:"api"' --desc --limit 10
npx tsx caido-client.ts search 'req.path.cont:"/admin"' --ids-only
npx tsx caido-client.ts search 'resp.raw.cont:"password"' --after <cursor>

recent – Kürzliche Anfragen abrufen

npx tsx caido-client.ts recent
npx tsx caido-client.ts recent --limit 50

get / get-response – Vollständige Details abrufen

npx tsx caido-client.ts get <anfrage-id>
npx tsx caido-client.ts get <anfrage-id> --headers-only
npx tsx caido-client.ts get-response <anfrage-id>
npx tsx caido-client.ts get-response <anfrage-id> --compact

edit – Bearbeiten und erneut abspielen (SCHLÜSSELFUNKTION)

Ändert eine vorhandene Anfrage und behält alle Cookies/Authentifizierungsheader:

# Pfad ändern (IDOR-Test)
npx tsx caido-client.ts edit <id> --path /api/user/999

# Methode ändern und Body hinzufügen
npx tsx caido-client.ts edit <id> --method POST --body '{"admin":true}'

# Header hinzufügen/entfernen
npx tsx caido-client.ts edit <id> --set-header "X-Forwarded-For: 127.0.0.1"
npx tsx caido-client.ts edit <id> --remove-header "X-CSRF-Token"

# Text finden/ersetzen in der gesamten Anfrage
npx tsx caido-client.ts edit <id> --replace "user123:::user456"

# Mehrere Änderungen kombinieren
npx tsx caido-client.ts edit <id> --method PUT --path /api/admin --body '{"role":"admin"}' --compact

# Eine vorhandene Wiedergabe-Registerkarte/Sitzung für wiederholte Tests wiederverwenden
npx tsx caido-client.ts edit <id> --path /api/user/1001 --session <sitzungs-id> --compact
OptionBeschreibung
--method <METHODE>HTTP-Methode ändern
--path <pfad>Anforderungspfad ändern
--set-header <Name: Wert>Header hinzufügen oder ersetzen (wiederholbar)
--remove-header <Name>Header entfernen (wiederholbar)
--body <inhalt>Body der Anfrage setzen (aktualisiert automatisch Content-Length)
--replace <von>:::<nach>Text in der gesamten Anfrage suchen/ersetzen (wiederholbar)
--session <id>Vorhandene Wiedergabesitzung wiederverwenden, anstatt neue Registerkarte zu erstellen
--collection <id>Neu erstellte caido-client.ts Wiedergabesitzung in einer Sammlung ablegen
--sni <host>TLS-SNI überschreiben
--connect-host <host>Mit einem anderen Host verbinden, während die HTTP-Anfrage erhalten bleibt
--connect-port <port>Mit einem anderen Port verbinden
--connect-tls / --connect-no-tlsTLS/Klartext für die Verbindung erzwingen

replay / send-raw – Anfragen senden

# Wie gehabt abspielen
npx tsx caido-client.ts replay <anfrage-id>

# Mit benutzerdefiniertem Rohwert abspielen
npx tsx caido-client.ts replay <id> --raw "GET /modified HTTP/1.1\r\nHost: example.com\r\n\r\n"

# Vollständig benutzerdefinierte Anfrage senden
npx tsx caido-client.ts send-raw --host example.com --port 443 --tls --raw "GET / HTTP/1.1\r\nHost: example.com\r\n\r\n"
npx tsx caido-client.ts send-raw --host example.com --raw @request.txt --name "G /"
cat request.txt | npx tsx caido-client.ts send-raw --host example.com --raw -

# Woanders verbinden, während gewünschter Host/SNI beibehalten wird
npx tsx caido-client.ts replay <id> --connect-host 10.0.0.5 --connect-port 8443 --sni example.com

--raw akzeptiert einen String mit \r\n-Escapes, @datei zum Lesen von der Festplatte oder - zum Lesen von stdin.

export-curl – In Curl für PoCs konvertieren

npx tsx caido-client.ts export-curl <anfrage-id>

Gibt einen gebrauchsfertigen Curl-Befehl mit allen Headern und Body aus.


Wiedergabe-Registerkarten-Lookup

Verwenden Sie dies, wenn eine Wiedergabe-Registerkarte von Caido bereits geöffnet ist und Sie direkt von ihrem aktiven Eintrag aus arbeiten möchten.

npx tsx caido-client.ts get-session <sitzungs-id-oder-name> --compact
npx tsx caido-client.ts replay-entries <sitzungs-id-oder-name> --limit 20
npx tsx caido-client.ts replay-entries <sitzungs-id-oder-name> --raw --compact
npx tsx caido-client.ts edit-session <sitzungs-id-oder-name> --body '{"test":true}' --compact

session-entries wird als Alias für replay-entries akzeptiert.


Wiedergabesitzungen & Sammlungen

Sitzungen

# Wiedergabesitzung aus einer vorhandenen Anfrage erstellen
npx tsx caido-client.ts create-session <anfrage-id>
npx tsx caido-client.ts create-session <anfrage-id> --collection <sammlungs-id>

# Sitzungen IMMER umbenennen, um sie in der Caido-Benutzeroberfläche leicht zu identifizieren
npx tsx caido-client.ts rename-session <sitzungs-id> "idor-user-profile"

# Alle Wiedergabesitzungen auflisten
npx tsx caido-client.ts replay-sessions
npx tsx caido-client.ts replay-sessions --limit 50

# Sitzungen zwischen Sammlungen verschieben
npx tsx caido-client.ts move-session <sitzungs-id> <sammlungs-id>

# Wiedergabesitzungen löschen
npx tsx caido-client.ts delete-sessions <sitzungs-id-1>,<sitzungs-id-2>

Sammlungen

Organisieren Sie Wiedergabesitzungen in Sammlungen:

# Wiedergabesammlungen auflisten
npx tsx caido-client.ts replay-collections
npx tsx caido-client.ts replay-collections --limit 50

# Sammlung erstellen
npx tsx caido-client.ts create-collection "IDOR-Tests"

# Sammlung umbenennen
npx tsx caido-client.ts rename-collection <sammlungs-id> "Auth-Bypass-Tests"

# Sammlung löschen
npx tsx caido-client.ts delete-collection <sammlungs-id>

Fuzzing

# Automatisierte Sitzung für Fuzzing erstellen
npx tsx caido-client.ts create-automate-session <anfrage-id>

# Fuzzing starten (Payloads und Markierungen zuerst in der Caido-Benutzeroberfläche konfigurieren)
npx tsx caido-client.ts fuzz <sitzungs-id>

Scope-Verwaltung

Legen Sie fest, was für Ihre Tests in Scope (Bereich) liegt. Verwendet Glob-Muster.

# Alle Scopes auflisten
npx tsx caido-client.ts scopes

# Scope mit Allowlist und Denylist erstellen
npx tsx caido-client.ts create-scope "Ziel-Unternehmen" --allow "*.target.com,*.target.io" --deny "*.cdn.target.com"

# Scope aktualisieren
npx tsx caido-client.ts update-scope <scope-id> --allow "*.target.com,*.api.target.com"

# Scope löschen
npx tsx caido-client.ts delete-scope <scope-id>

Glob-Muster: *.example.com passt auf alle Subdomains von example.com.


Filtervorgaben

Speichern Sie häufig verwendete HTTPQL-Abfragen als benannte Vorgaben.

# Gespeicherte Filter auflisten
npx tsx caido-client.ts filters

# Filtervorgabe erstellen
npx tsx caido-client.ts create-filter "API-Fehler" --query 'req.path.cont:"/api/" AND resp.code.gte:400'
npx tsx caido-client.ts create-filter "Auth-Endpunkte" --query 'req.path.regex:"/(login|auth|oauth)/"' --alias "auth"

# Filter aktualisieren
npx tsx caido-client.ts update-filter <filter-id> --query 'req.path.cont:"/api/" AND resp.code.gte:500'

# Filter löschen
npx tsx caido-client.ts delete-filter <filter-id>

Umgebungsvariablen

Speichern Sie Testvariablen, die über Sitzungen hinweg erhalten bleiben. Ideal für IDOR-Tests mit mehreren Benutzer-IDs.

# Umgebungen auflisten
npx tsx caido-client.ts envs

# Umgebung erstellen
npx tsx caido-client.ts create-env "IDOR-Test"

# Variablen setzen
npx tsx caido-client.ts env-set <umgebungs-id> victim_user_id "user_456"
npx tsx caido-client.ts env-set <umgebungs-id> attacker_token "eyJhbG..."

# Aktive Umgebung auswählen
npx tsx caido-client.ts select-env <umgebungs-id>

# Umgebungsauswahl aufheben
npx tsx caido-client.ts select-env

# Umgebung löschen
npx tsx caido-client.ts delete-env <umgebungs-id>

Erkenntnisse (Findings)

Erstellen, auflisten und aktualisieren Sie Sicherheitserkenntnisse. Erscheint im Tab „Findings“ von Caido.

# Alle Erkenntnisse auflisten
npx tsx caido-client.ts findings
npx tsx caido-client.ts findings --limit 50

# Bestimmte Erkenntnis abrufen
npx tsx caido-client.ts get-finding <erkenntnis-id>

# Mit einer Anfrage verknüpfte Erkenntnis erstellen
npx tsx caido-client.ts create-finding <anfrage-id> \
  --title "IDOR im Benutzerprofil-Endpunkt" \
  --description "Kann auf Profile anderer Benutzer zugreifen, indem ID-Parameter geändert wird" \
  --reporter "rez0"

# Mit Deduplizierungsschlüssel (verhindert Duplikate)
npx tsx caido-client.ts create-finding <anfrage-id> \
  --title "Auth-Bypass auf /admin" \
  --dedupe-key "admin-auth-bypass"

# Erkenntnis aktualisieren
npx tsx caido-client.ts update-finding <erkenntnis-id> \
  --title "Aktualisierter Titel" \
  --description "Aktualisierte Beschreibung"

Aufgaben

Überwachen und abbrechen von Hintergrundaufgaben (Importe, Exporte usw.).

# Alle Aufgaben auflisten
npx tsx caido-client.ts tasks

# Laufende Aufgabe abbrechen
npx tsx caido-client.ts cancel-task <aufgaben-id>

Projektverwaltung

# Alle Projekte auflisten
npx tsx caido-client.ts projects

# Aktives Projekt wechseln
npx tsx caido-client.ts select-project <projekt-id>

Gehostete Dateien

# Gehostete Dateien auflisten
npx tsx caido-client.ts hosted-files

# Gehostete Datei löschen
npx tsx caido-client.ts delete-hosted-file <datei-id>

Abfangkontrolle (Intercept)

# Abfangstatus prüfen
npx tsx caido-client.ts intercept-status

# Abfang ein-/ausschalten
npx tsx caido-client.ts intercept-enable
npx tsx caido-client.ts intercept-disable

Info, Gesundheit & Plugins

# Aktuelle Benutzerinformationen
npx tsx caido-client.ts viewer

# Installierte Plugins auflisten
npx tsx caido-client.ts plugins

# Caido-Instanz-Gesundheit prüfen (Version, Bereitschaftsstatus)
npx tsx caido-client.ts health

Ausgabesteuerung

Funktioniert mit get, get-response, replay, edit, send-raw:

FlagBeschreibung
--max-body <n>Maximale Anzahl Antwortbody-Zeilen (Standard: 200, 0 = unbegrenzt)
--max-body-chars <n>Maximale Anzahl Body-Zeichen (Standard: 5000, 0 = unbegrenzt)
--no-requestAnforderungsrohwert in der Ausgabe überspringen
--headers-onlyNur HTTP-Header, kein Body
--compactKurzform: --no-request --max-body 50 --max-body-chars 5000

HTTPQL-Referenz

Caidos Abfragesprache zur [email protected] im HTTP-Verlauf.

KRITISCH: Zeichenfolgenwerte MÜSSEN in Anführungszeichen gesetzt werden. Ganzzahlen werden NICHT in Anführungszeichen gesetzt.

KRITISCH: HTTPQL hat KEINEN NOT-Operator. Verwenden Sie niemals NOT ausdruck. Verwenden Sie stattdessen die negierte Operatorvariante:

  • ncont (enthält nicht), nlike (nicht wie), nregex (nicht Regex), ne (nicht gleich)
  • Falsch: NOT req.path.cont:"/admin"
  • Richtig: req.path.ncont:"/admin"

Namespaces und Felder

NamespaceFeldTypBeschreibung
reqextstringDateierweiterung (enthält .)
reqhoststringHostname
reqmethodstringHTTP-Methode (Großbuchstaben)
reqpathstringURL-Pfad
reqquerystringQuery-String
reqrawstringVollständige rohe Anfrage
reqportintPortnummer
reqlenintLänge des Anforderungsbodys
reqcreated_atdateErstellungszeitstempel
reqtlsboolIst HTTPS
resprawstringVollständige rohe Antwort
respcodeintStatuscode
resplenintLänge des Antwortbodys
resproundtripintRoundtrip-Zeit (ms)
rowidintAnfrage-ID
source-speziell"intercept", "replay", "automate", "workflow"
preset-speziellFiltervorgaben-Referenz

Operatoren

Zeichenfolge: eq, ne, cont, ncont, like, nlike, regex, nregex Ganzzahl: eq, ne, gt, gte, lt, lte Boolean: eq, ne Logisch: AND, OR, Klammern für Gruppierung

Beispielabfragen

# POST-Anfragen mit 200 Antworten
req.method.eq:"POST" AND resp.code.eq:200

# API-Anfragen
req.host.cont:"api" OR req.path.cont:"/api/"

# Anfragen mit bestimmter Erweiterung
(req.method.eq:"GET" AND req.ext.eq:".json") OR req.ext.eq:".xml"

# Fehlgeschlagene API-Anfragen (Fehler 4xx/5xx)
req.host.cont:"api" AND resp.code.gte:400

# Authentifizierungs-Endpunkte (Groß-/Kleinschreibung nicht beachtend)
req.path.regex:"/(login|auth|oauth|token|session)/"

# Anfragen mit Passwörtern im Body
req.method.eq:"POST" AND req.raw.cont:"password"

# Zeitbasierte Abfrage
req.created_at.gt:"2024-01-01"

# Administration-Pfade
req.path.regex:"/admin|\.\\.\/|/internal/"

# Umleitung
resp.code.eq:301 OR resp.code.eq:302

# Große Antworten (mehr als 1 MB, 1048576 Bytes)
resp.len.gt:1048576

# Reine Wiedergabe-Sitzungen (kein natives Caido-Verkehr)
source.eq:"replay" AND req.path.cont:"/api/"

# Kombinierte Quellen
source.eq:"replay" OR source.eq:"automate"

Allgemeine Workflows

HTTP-Modifikationstests (IDOR, Auth-Bypass)

  1. Zielanfrage finden: search 'req.path.cont:"/api/user/"'
  2. Authentifizierungskontext erkennen: Die gefundene Anfrage enthält gültige Sitzungs- und Authentifizierungstoken
  3. Pfad bearbeiten und abspielen: edit <id> --path /api/user/999
  4. Ergebnisse vergleichen: Unterschiedliche Antworten deuten auf IDOR hin. Verwenden Sie --compact für einen schnellen visuellen Vergleich.
  5. Weiter testen: Erstellen Sie mithilfe von --replace "user123:::user456" Varianten.
  6. Erkenntnis dokumentieren: create-finding <id> --title "IDOR in /api/user/" --description "..."

Wiedergabe-Sitzungsworkflow

  1. Sitzung erstellen: create-session <id> – erstellt einen dedizierten Wiedergabe-Tab
  2. Sitzung umbenennen: rename-session <session-id> "benutzerprofil-tests"
  3. Wiederholt abspielen: edit <session-id> --path /api/user/1001 --session <session-id>
  4. In Sammlung verschieben (optional): move-session <session-id> <collection-id>
  5. Ergebnisse überprüfen: replay-entries <session-id>

Fuzzing-Workflow (mit Caido-Benutzeroberfläche)

  1. Zielanfrage finden: search 'req.path.cont:"/api/user/"'
  2. Automatisierte Sitzung erstellen: create-automate-session <id>
  3. Markierungen/Payloads konfigurieren (in der Caido-Benutzeroberfläche)
  4. Fuzzing starten: fuzz <sitzungs-id>
  5. Ergebnisse analysieren (in der Caido-Benutzeroberfläche)
  6. Erwähnenswerte Ergebnisse dokumentieren: get <ergebnis-anfrage-id> und create-finding

Export-Workflow

  1. Anfrage finden/Hinzufügen: Zum manuellen Testen in Burp oder Postman
  2. In Curl exportieren: export-curl <id>
  3. In PoC einfügen: Der Curl-Befehl enthält alle Authentifizierungsheader

Scope-basierte Tests

  1. Scope erstellen: create-scope "Produktion" --allow "*.example.com" --deny "*.dev.example.com"
  2. Filtervorgabe speichern: create-filter "Produktionsfehler" --query 'req.host.cont:"api.example.com" AND resp.code.gte:400' --alias "prod-errors"
  3. Umgebung einrichten: create-env "Prod-Test" und env-set <env-id> admin_token "eyJ..."
  4. Testen und Erkenntnisse dokumentieren

Kompatibilität & Hinweise

  • Plugin: Keine Plugins erforderlich – nur das offizielle Caido SDK
  • Kein installiertes Caido? Kein Problem – die CLI-Fertigkeit benötigt nur eine laufende Caido-Instanz mit einem PAT; lokale Binärdateien sind nicht erforderlich
  • Verifiziert mit Caido v0.48.0, sollte mit neueren Versionen kompatibel sein

Verwandte Skills