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:
- Eine organische Anfrage im HTTP-Verlauf von Caido finden, die bereits gültige Authentifizierung enthält
editverwenden, um nur das Nötigste zu ändern (Pfad, Methode, Body) und dabei alle Authentifizierungs-Header intakt zu lassen- Absenden – die Antwort kommt mit vollständigem Kontext zurück
Einrichtung der Authentifizierung
Einrichtung (Einmalig)
- Öffnen Sie Dashboard → Entwickler → Persönliche Zugriffstoken
- Erstellen Sie ein neues Token
- 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
| Option | Beschreibung |
|---|---|
--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-tls | TLS/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:
| Flag | Beschreibung |
|---|---|
--max-body <n> | Maximale Anzahl Antwortbody-Zeilen (Standard: 200, 0 = unbegrenzt) |
--max-body-chars <n> | Maximale Anzahl Body-Zeichen (Standard: 5000, 0 = unbegrenzt) |
--no-request | Anforderungsrohwert in der Ausgabe überspringen |
--headers-only | Nur HTTP-Header, kein Body |
--compact | Kurzform: --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
| Namespace | Feld | Typ | Beschreibung |
|---|---|---|---|
req | ext | string | Dateierweiterung (enthält .) |
req | host | string | Hostname |
req | method | string | HTTP-Methode (Großbuchstaben) |
req | path | string | URL-Pfad |
req | query | string | Query-String |
req | raw | string | Vollständige rohe Anfrage |
req | port | int | Portnummer |
req | len | int | Länge des Anforderungsbodys |
req | created_at | date | Erstellungszeitstempel |
req | tls | bool | Ist HTTPS |
resp | raw | string | Vollständige rohe Antwort |
resp | code | int | Statuscode |
resp | len | int | Länge des Antwortbodys |
resp | roundtrip | int | Roundtrip-Zeit (ms) |
row | id | int | Anfrage-ID |
source | - | speziell | "intercept", "replay", "automate", "workflow" |
preset | - | speziell | Filtervorgaben-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)
- Zielanfrage finden:
search 'req.path.cont:"/api/user/"' - Authentifizierungskontext erkennen: Die gefundene Anfrage enthält gültige Sitzungs- und Authentifizierungstoken
- Pfad bearbeiten und abspielen:
edit <id> --path /api/user/999 - Ergebnisse vergleichen: Unterschiedliche Antworten deuten auf IDOR hin. Verwenden Sie
--compactfür einen schnellen visuellen Vergleich. - Weiter testen: Erstellen Sie mithilfe von
--replace "user123:::user456"Varianten. - Erkenntnis dokumentieren:
create-finding <id> --title "IDOR in /api/user/" --description "..."
Wiedergabe-Sitzungsworkflow
- Sitzung erstellen:
create-session <id>– erstellt einen dedizierten Wiedergabe-Tab - Sitzung umbenennen:
rename-session <session-id> "benutzerprofil-tests" - Wiederholt abspielen:
edit <session-id> --path /api/user/1001 --session <session-id> - In Sammlung verschieben (optional):
move-session <session-id> <collection-id> - Ergebnisse überprüfen:
replay-entries <session-id>
Fuzzing-Workflow (mit Caido-Benutzeroberfläche)
- Zielanfrage finden:
search 'req.path.cont:"/api/user/"' - Automatisierte Sitzung erstellen:
create-automate-session <id> - Markierungen/Payloads konfigurieren (in der Caido-Benutzeroberfläche)
- Fuzzing starten:
fuzz <sitzungs-id> - Ergebnisse analysieren (in der Caido-Benutzeroberfläche)
- Erwähnenswerte Ergebnisse dokumentieren:
get <ergebnis-anfrage-id>undcreate-finding
Export-Workflow
- Anfrage finden/Hinzufügen: Zum manuellen Testen in Burp oder Postman
- In Curl exportieren:
export-curl <id> - In PoC einfügen: Der Curl-Befehl enthält alle Authentifizierungsheader
Scope-basierte Tests
- Scope erstellen:
create-scope "Produktion" --allow "*.example.com" --deny "*.dev.example.com" - Filtervorgabe speichern:
create-filter "Produktionsfehler" --query 'req.host.cont:"api.example.com" AND resp.code.gte:400' --alias "prod-errors" - Umgebung einrichten:
create-env "Prod-Test"undenv-set <env-id> admin_token "eyJ..." - 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