Communitygithub.com

Caido Mode

Interface CLI complète pour l'API Caido, exploitant les sessions, la modification de requêtes et l'authentification intégrée.

Qu'est-ce que Caido Mode ?

Caido Mode est une compétence avancée pour agent IA qui fournit un accès complet à l'API de Caido via un outil en ligne de commande (CLI). Construite sur le SDK officiel `@caido/sdk-client`, elle permet de rechercher, modifier, et rejouer des requêtes HTTP tout en préservant l'authentification (cookies, tokens JWT) grâce à une méthode innovante : plutôt que de copier-coller manuellement des tokens volumineux, l'agent peut trouver une requête organique dans l'historique Caido, la modifier sur des éléments précis (chemin, méthode, corps) tout en conservant les en-têtes d'authentification, puis l'envoyer. La compétence utilise un système de jeton personnel (PAT) stocké dans un fichier secrets.json, avec une résolution automatique via variable d'environnement CAIDO_PAT. Elle est conçue pour les plateformes Caido (Caido Cloud, instances auto-hébergées) et fonctionne avec tout agent capable d'exécuter des commandes shell (Claude Code, Cursor, Codex, etc.). Elle prend en charge la gestion des sessions de rejeu, des collections, du fuzzing, des scopes, des filtres HTTPQL, des variables d'environnement, des findings de sécurité, des tâches, des projets, des fichiers hébergés, du contrôle d'interception, et des plugins. L'objectif principal est de faciliter les tests d'intrusion et l'analyse de sécurité en automatisant des workflows complexes directement depuis l'interface en ligne de commande.

Compatible avec✓Claude Code~Codex CLI✓Cursor✓OpenCode
npx skills add Aceproulx/claude-skills

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence Caido Mode

Aperçu

Interface CLI complète pour l'API Caido, construite sur le paquet officiel @caido/sdk-client. Couvre :

  • Historique HTTP - Recherche, récupération, rejeu, modification de requêtes avec HTTPQL
  • Rejeu et sessions - Sessions, collections, entrées, fuzzing
  • Scopes - Création et gestion des périmètres de test (listes autorisées/interdites)
  • Préréglages de filtre - Sauvegarde et réutilisation de préréglages de filtres HTTPQL
  • Variables d'environnement - Stockage de variables de test (IDs de victimes, jetons, etc.)
  • Findings - Création, liste et mise à jour des findings de sécurité
  • Tâches - Surveillance et annulation des tâches en arrière-plan
  • Projets - Basculement entre projets de test
  • Fichiers hébergés - Gestion des fichiers servis par Caido
  • Interception - Activation/désactivation programmatique de l'interception de requêtes
  • Plugins - Liste des plugins installés
  • Export - Conversion de requêtes en commandes curl pour preuves de concept
  • Santé - Vérification du statut d'une instance Caido

Tout le trafic passe par Caido, donc il apparaît dans l'interface utilisateur pour une analyse plus approfondie.

Pourquoi ce modèle ?

Les cookies et jetons d'authentification peuvent être énormes - les cookies de session, les JWT, les jetons CSRF peuvent facilement atteindre 1 à 2 Ko. Plutôt que de copier-coller manuellement :

  1. Trouver une requête organique dans l'historique HTTP de Caido qui contient déjà une authentification valide
  2. Utiliser edit pour modifier uniquement ce qui est nécessaire (chemin, méthode, corps) tout en gardant tous les en-têtes d'authentification intacts
  3. Envoyer la requête - la réponse revient avec tout le contexte préservé

Configuration de l'authentification

Configuration (unique)

  1. Ouvrir Tableau de bord → Développeur → Jetons d'accès personnels
  2. Créer un nouveau jeton
  3. Exécuter :
npx tsx ~/.agents/skills/caido-mode/caido-client.ts setup <votre-pat>

# Instance Caido non par défaut
npx tsx ~/.agents/skills/caido-mode/caido-client.ts setup <pat> http://192.168.1.100:8080

# Ou définir la variable d'environnement à la place
export CAIDO_PAT=caido_xxxxx

La commande setup valide le PAT via le SDK (qui l'échange contre un jeton d'accès), puis sauvegarde à la fois le PAT et le jeton d'accès mis en cache dans ~/.agents/config/secrets.json. Les exécutions suivantes chargent directement le jeton mis en cache, et un jeton mis en cache valide peut être utilisé même en l'absence du PAT.

Vérifier le statut

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

Comment fonctionne l'authentification

Le SDK utilise un flux de code d'appareil en interne - le PAT l'approuve automatiquement et reçoit un jeton d'accès + un jeton d'actualisation. Un SecretsTokenCache personnalisé (implémentant l'interface TokenCache du SDK) persiste ces jetons dans secrets.json afin qu'ils survivent aux invocations du CLI.

Résolution de l'authentification : variable d'environnement CAIDO_PAT → PAT dans ~/.agents/config/secrets.json → jeton d'accès mis en cache valide → erreur avec instructions de configuration

Outil CLI

Situé dans ~/.agents/skills/caido-mode/caido-client.ts. Toutes les commandes produisent du JSON.


Commandes d'historique HTTP et de test

search - Rechercher dans l'historique HTTP avec HTTPQL

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 <curseur>

recent - Obtenir les requêtes récentes

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

get / get-response - Récupérer les détails complets

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

edit - Modifier et rejouer (FONCTIONNALITÉ CLÉ)

Modifie une requête existante tout en préservant tous les cookies/en-têtes d'authentification :

# Changer le chemin (test IDOR)
npx tsx caido-client.ts edit <id> --path /api/user/999

# Changer la méthode et ajouter un corps
npx tsx caido-client.ts edit <id> --method POST --body '{"admin":true}'

# Ajouter/supprimer des en-têtes
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"

# Rechercher/remplacer du texte n'importe où dans la requête
npx tsx caido-client.ts edit <id> --replace "user123:::user456"

# Combiner plusieurs modifications
npx tsx caido-client.ts edit <id> --method PUT --path /api/admin --body '{"role":"admin"}' --compact

# Réutiliser un onglet/session de rejeu existant pour des sondes répétées
npx tsx caido-client.ts edit <id> --path /api/user/1001 --session <id-session> --compact
OptionDescription
--method <METHODE>Changer la méthode HTTP
--path <chemin>Changer le chemin de la requête
--set-header <Nom: Valeur>Ajouter ou remplacer un en-tête (répétable)
--remove-header <Nom>Supprimer un en-tête (répétable)
--body <contenu>Définir le corps de la requête (met à jour automatiquement Content-Length)
--replace <de>:::<vers>Rechercher/remplacer du texte n'importe où dans la requête (répétable)
--session <id>Réutiliser une session de rejeu existante au lieu de créer un nouvel onglet
--collection <id>Placer une session de rejeu nouvellement créée dans une collection
--sni <hôte>Surcharger le SNI TLS
--connect-host <hôte>Se connecter à un hôte différent tout en préservant la requête HTTP
--connect-port <port>Se connecter à un port différent
--connect-tls / --connect-no-tlsForcer TLS/texte brut pour la connexion

replay / send-raw - Envoyer des requêtes

# Rejouer tel quel
npx tsx caido-client.ts replay <id-requete>

# Rejouer avec un raw personnalisé
npx tsx caido-client.ts replay <id> --raw "GET /modified HTTP/1.1\r\nHost: example.com\r\n\r\n"

# Envoyer une requête entièrement personnalisée
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 -

# Se connecter ailleurs tout en préservant l'en-tête Host/SNI nécessaire
npx tsx caido-client.ts replay <id> --connect-host 10.0.0.5 --connect-port 8443 --sni example.com

--raw accepte une chaîne avec les séquences d'échappement \r\n, @fichier pour lire depuis le disque, ou - pour lire depuis l'entrée standard.

export-curl - Convertir en curl pour preuves de concept

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

Produit une commande curl prête à l'emploi avec tous les en-têtes et le corps.


Recherche d'onglet de rejeu

Utilisez ces commandes lorsqu'un onglet de rejeu de Caido est déjà ouvert et que vous souhaitez travailler directement à partir de son entrée active.

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

session-entries est accepté comme alias pour replay-entries.


Sessions et collections de rejeu

Sessions

# Créer une session de rejeu à partir d'une requête existante
npx tsx caido-client.ts create-session <id-requete>
npx tsx caido-client.ts create-session <id-requete> --collection <id-collection>

# Toujours renommer les sessions pour une identification facile dans l'interface Caido
npx tsx caido-client.ts rename-session <id-session> "idor-profil-utilisateur"

# Lister toutes les sessions de rejeu
npx tsx caido-client.ts replay-sessions
npx tsx caido-client.ts replay-sessions --limit 50

# Déplacer des sessions entre collections
npx tsx caido-client.ts move-session <id-session> <id-collection>

# Supprimer des sessions de rejeu
npx tsx caido-client.ts delete-sessions <id-session-1>,<id-session-2>

Collections

Organiser les sessions de rejeu en collections :

# Lister les collections de rejeu
npx tsx caido-client.ts replay-collections
npx tsx caido-client.ts replay-collections --limit 50

# Créer une collection
npx tsx caido-client.ts create-collection "Tests IDOR"

# Renommer une collection
npx tsx caido-client.ts rename-collection <id-collection> "Tests de contournement d'authentification"

# Supprimer une collection
npx tsx caido-client.ts delete-collection <id-collection>

Fuzzing

# Créer une session automatisée pour le fuzzing
npx tsx caido-client.ts create-automate-session <id-requete>

# Démarrer le fuzzing (configurer les payloads et marqueurs dans l'interface Caido d'abord)
npx tsx caido-client.ts fuzz <id-session>

Gestion des scopes

Définir ce qui est dans le périmètre de vos tests. Utilise des motifs glob.

# Lister tous les scopes
npx tsx caido-client.ts scopes

# Créer un scope avec liste autorisée et liste interdite
npx tsx caido-client.ts create-scope "Corp Cible" --allow "*.target.com,*.target.io" --deny "*.cdn.target.com"

# Mettre à jour un scope
npx tsx caido-client.ts update-scope <id-scope> --allow "*.target.com,*.api.target.com"

# Supprimer un scope
npx tsx caido-client.ts delete-scope <id-scope>

Motifs glob : *.example.com correspond à tout sous-domaine de example.com.


Préréglages de filtre

Sauvegarder des requêtes HTTPQL fréquemment utilisées en tant que préréglages nommés.

# Lister les filtres sauvegardés
npx tsx caido-client.ts filters

# Créer un préréglage de filtre
npx tsx caido-client.ts create-filter "Erreurs API" --query 'req.path.cont:"/api/" AND resp.code.gte:400'
npx tsx caido-client.ts create-filter "Points de terminaison d'authentification" --query 'req.path.regex:"/(login|auth|oauth)/"' --alias "auth"

# Mettre à jour un filtre
npx tsx caido-client.ts update-filter <id-filtre> --query 'req.path.cont:"/api/" AND resp.code.gte:500'

# Supprimer un filtre
npx tsx caido-client.ts delete-filter <id-filtre>

Variables d'environnement

Stockez des variables de test qui persistent entre les sessions. Excellent pour les tests IDOR avec plusieurs identifiants utilisateur.

# Lister les environnements
npx tsx caido-client.ts envs

# Créer un environnement
npx tsx caido-client.ts create-env "IDOR-Test"

# Définir des variables
npx tsx caido-client.ts env-set <id-env> victim_user_id "user_456"
npx tsx caido-client.ts env-set <id-env> attacker_token "eyJhbG..."

# Sélectionner l'environnement actif
npx tsx caido-client.ts select-env <id-env>

# Désélectionner l'environnement
npx tsx caido-client.ts select-env

# Supprimer un environnement
npx tsx caido-client.ts delete-env <id-env>

Findings

Créer, lister et mettre à jour des findings de sécurité. Ils apparaissent dans l'onglet Findings de Caido.

# Lister tous les findings
npx tsx caido-client.ts findings
npx tsx caido-client.ts findings --limit 50

# Obtenir un finding spécifique
npx tsx caido-client.ts get-finding <id-finding>

# Créer un finding lié à une requête
npx tsx caido-client.ts create-finding <id-requete> \
  --title "IDOR dans le point de terminaison du profil utilisateur" \
  --description "Peut accéder aux profils d'autres utilisateurs en modifiant le paramètre ID" \
  --reporter "rez0"

# Avec clé de déduplication (empêche les doublons)
npx tsx caido-client.ts create-finding <id-requete> \
  --title "Contournement d'authentification sur /admin" \
  --dedupe-key "admin-auth-bypass"

# Mettre à jour un finding
npx tsx caido-client.ts update-finding <id-finding> \
  --title "Titre mis à jour" \
  --description "Description mise à jour"

Tâches

Surveiller et annuler des tâches en arrière-plan (imports, exports, etc.).

# Lister toutes les tâches
npx tsx caido-client.ts tasks

# Annuler une tâche en cours
npx tsx caido-client.ts cancel-task <id-tache>

Gestion des projets

# Lister tous les projets
npx tsx caido-client.ts projects

# Basculer sur un projet actif
npx tsx caido-client.ts select-project <id-projet>

Fichiers hébergés

# Lister les fichiers hébergés
npx tsx caido-client.ts hosted-files

# Supprimer un fichier hébergé
npx tsx caido-client.ts delete-hosted-file <id-fichier>

Contrôle de l'interception

# Vérifier le statut de l'interception
npx tsx caido-client.ts intercept-status

# Activer/désactiver l'interception
npx tsx caido-client.ts intercept-enable
npx tsx caido-client.ts intercept-disable

Informations, santé et plugins

# Informations sur l'utilisateur actuel
npx tsx caido-client.ts viewer

# Lister les plugins installés
npx tsx caido-client.ts plugins

# Vérifier l'état de santé de l'instance Caido (version, état de préparation)
npx tsx caido-client.ts health

Contrôle de la sortie

Fonctionne avec get, get-response, replay, edit, send-raw :

DrapeauDescription
--max-body <n>Nombre maximum de lignes du corps de la réponse (défaut : 200, 0=illimité)
--max-body-chars <n>Nombre maximum de caractères du corps (défaut : 5000, 0=illimité)
--no-requestIgnorer le raw de la requête dans la sortie
--headers-onlyUniquement les en-têtes HTTP, pas de corps
--compactRaccourci : --no-request --max-body 50 --max-body-chars 5000

Référence HTTPQL

Langage de requête de Caido pour la recherche dans l'historique HTTP.

CRITIQUE : Les valeurs de chaînes DOIVENT être entre guillemets. Les valeurs entières ne sont PAS entre guillemets.

CRITIQUE : HTTPQL n'a PAS d'opérateur NOT. N'écrivez jamais NOT expr. Utilisez plutôt la variante d'opérateur nié :

  • ncont (ne contient pas), nlike (pas comme), nregex (pas regex), ne (pas égal)
  • Incorrect : NOT req.path.cont:"/admin"
  • Correct : req.path.ncont:"/admin"

Espaces de noms et champs

Espace de nomsChampTypeDescription
reqextstringExtension de fichier (inclut .)
reqhoststringNom d'hôte
reqmethodstringMéthode HTTP (majuscules)
reqpathstringChemin URL
reqquerystringChaîne de requête
reqrawstringRequête raw complète
reqportintNuméro de port
reqlenintLongueur du corps de la requête
reqcreated_atdateHorodatage de création
reqtlsboolEst HTTPS
resprawstringRéponse raw complète
respcodeintCode de statut
resplenintLongueur du corps de la réponse
resproundtripintTemps aller-retour (ms)
rowidintID de la requête
source-special"intercept", "replay", "automate", "workflow"
preset-specialRéférence du préréglage de filtre

Opérateurs

Chaîne : eq, ne, cont, ncont, like, nlike, regex, nregex Entier : eq, ne, gt, gte, lt, lte Booléen : eq, ne Logique : AND, OR, parenthèses pour le regroupement

Exemples de requêtes

# Requêtes POST avec réponses 200
req.method.eq:"POST" AND resp.code.eq:200

# Requêtes API
req.host.cont:"api" OR req.path.cont:"/api"

# Fichiers volumineux
resp.len.gt:1000000

# Requêtes lentes
resp.roundtrip.gt:5000

# Regroupement avec parenthèses
(req.host.cont:"target" OR req.host.cont:"api") AND resp.code.eq:200

# Négation (n'utilisez JAMAIS NOT)
req.path.ncont:"/public"

# Source spécifique
source.eq:"intercept"

# Expression régulière
req.path.regex:"/api/v[12]/"

Dépannage

"Erreur d'authentification"

Vérifier ~/.agents/config/secrets.json pour un PAT valide ou définir CAIDO_PAT.

Mauvais décomptage

Les réponses longues sont tronquées à 200 lignes (ou ce qui est défini avec --max-body). Utiliser --max-body 0 --max-body-chars 0 pour une sortie illimitée.

Paramètres d'hôte

  • Caido s'attend à ce que les chemins commencent par /. Fournir --path /foo, pas --path foo.
  • L'ordre des paramètres n'a pas d'importance (l'analyseur CLI les organise).

Skills associés