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 :
- Trouver une requête organique dans l'historique HTTP de Caido qui contient déjà une authentification valide
- Utiliser
editpour modifier uniquement ce qui est nécessaire (chemin, méthode, corps) tout en gardant tous les en-têtes d'authentification intacts - Envoyer la requête - la réponse revient avec tout le contexte préservé
Configuration de l'authentification
Configuration (unique)
- Ouvrir Tableau de bord → Développeur → Jetons d'accès personnels
- Créer un nouveau jeton
- 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
| Option | Description |
|---|---|
--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-tls | Forcer 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 :
| Drapeau | Description |
|---|---|
--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-request | Ignorer le raw de la requête dans la sortie |
--headers-only | Uniquement les en-têtes HTTP, pas de corps |
--compact | Raccourci : --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 noms | Champ | Type | Description |
|---|---|---|---|
req | ext | string | Extension de fichier (inclut .) |
req | host | string | Nom d'hôte |
req | method | string | Méthode HTTP (majuscules) |
req | path | string | Chemin URL |
req | query | string | Chaîne de requête |
req | raw | string | Requête raw complète |
req | port | int | Numéro de port |
req | len | int | Longueur du corps de la requête |
req | created_at | date | Horodatage de création |
req | tls | bool | Est HTTPS |
resp | raw | string | Réponse raw complète |
resp | code | int | Code de statut |
resp | len | int | Longueur du corps de la réponse |
resp | roundtrip | int | Temps aller-retour (ms) |
row | id | int | ID de la requête |
source | - | special | "intercept", "replay", "automate", "workflow" |
preset | - | special | Ré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).