Caido モード スキル
概要
公式 @caido/sdk-client パッケージをベースに構築された、Caido の API を完全カバーする CLI です。以下の機能を網羅します:
- HTTP 履歴 - HTTPQL による検索、取得、再送信、リクエスト編集
- リプレイ&セッション - セッション、コレクション、エントリ、ファジング
- スコープ - テストスコープの作成と管理(許可リスト/拒否リストパターン)
- フィルタープリセット - HTTPQL フィルタープリセットの保存と再利用
- 環境変数 - テスト変数の保存(被害者 ID、トークンなど)
- ファインディング - セキュリティファインディングの作成、一覧表示、更新
- タスク - バックグラウンドタスクの監視とキャンセル
- プロジェクト - テストプロジェクトの切り替え
- ホストファイル - Caido が提供するファイルの管理
- インターセプト - プログラムによるリクエストインターセプトの有効化/無効化
- プラグイン - インストール済みプラグインの一覧表示
- エクスポート - PoC 用の curl コマンドへの変換
- ヘルス - Caido インスタンスのステータス確認
すべてのトラフィックは Caido を経由するため、UI に表示され、さらなる分析が可能です。
このモデルを選ぶ理由
Cookie や認証トークンは巨大になり得ます - セッション Cookie、JWT、CSRF トークンは簡単に 1〜2KB になります。手動でコピーペーストする代わりに:
- Caido の HTTP 履歴から、すでに有効な認証情報を持つ有機的なリクエストを見つける
editを使用して必要な部分だけを変更する(パス、メソッド、ボディ)一方で、すべての認証ヘッダーはそのまま維持する- 送信する - 完全なコンテキストを保持したレスポンスが返ってくる
認証設定
セットアップ(初回のみ)
- ダッシュボード → 開発者 → パーソナルアクセストークン を開く
- 新しいトークンを作成する
- 以下を実行:
npx tsx ~/.agents/skills/caido-mode/caido-client.ts setup <your-pat>
# デフォルト以外の Caido インスタンスの場合
npx tsx ~/.agents/skills/caido-mode/caido-client.ts setup <pat> http://192.168.1.100:8080
# または環境変数を設定
エクスポート CAIDO_PAT=caido_xxxxx
setup コマンドは SDK 経由で PAT を検証し(アクセストークンと交換)、PAT とキャッシュされたアクセストークンの両方を ~/.agents/config/secrets.json に保存します。以降の実行ではキャッシュされたトークンが直接読み込まれ、有効なキャッシュトークンは PAT が存在しない場合でも使用できます。
ステータス確認
npx tsx ~/.agents/skills/caido-mode/caido-client.ts auth-status
認証の仕組み
SDK は内部でデバイスコードフローを使用しています。PAT が自動的にそれを承認し、アクセストークンとリフレッシュトークンを受け取ります。カスタムの SecretsTokenCache(SDK の TokenCache インターフェースを実装)がこれらのトークンを secrets.json に永続化し、CLI 呼び出し間で存続するようにします。
認証解決順序: CAIDO_PAT 環境変数 → ~/.agents/config/secrets.json の PAT → 有効なキャッシュアクセストークン → セットアップ手順を示すエラー
CLI ツール
~/.agents/skills/caido-mode/caido-client.ts にあります。すべてのコマンドは JSON を出力します。
HTTP 履歴およびテストコマンド
search - HTTPQL で HTTP 履歴を検索
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 - 最近のリクエストを取得
npx tsx caido-client.ts recent
npx tsx caido-client.ts recent --limit 50
get / get-response - 詳細を取得
npx tsx caido-client.ts get <request-id>
npx tsx caido-client.ts get <request-id> --headers-only
npx tsx caido-client.ts get-response <request-id>
npx tsx caido-client.ts get-response <request-id> --compact
edit - 編集と再送信(キー機能)
既存のリクエストを変更し、すべての Cookie/認証ヘッダーを保持:
# パスを変更(IDOR テスト)
npx tsx caido-client.ts edit <id> --path /api/user/999
# メソッドを変更し、ボディを追加
npx tsx caido-client.ts edit <id> --method POST --body '{"admin":true}'
# ヘッダーを追加/削除
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"
# リクエスト内の任意のテキストを検索/置換
npx tsx caido-client.ts edit <id> --replace "user123:::user456"
# 複数の編集を組み合わせる
npx tsx caido-client.ts edit <id> --method PUT --path /api/admin --body '{"role":"admin"}' --compact
# 既存のリプレイタブ/セッションを繰り返しのプローブに再利用
npx tsx caido-client.ts edit <id> --path /api/user/1001 --session <session-id> --compact
| オプション | 説明 |
|---|---|
--method <METHOD> | HTTP メソッドを変更 |
--path <path> | リクエストパスを変更 |
--set-header <Name: Value> | ヘッダーを追加または置換(繰り返し可) |
--remove-header <Name> | ヘッダーを削除(繰り返し可) |
--body <content> | リクエストボディを設定(Content-Length は自動更新) |
--replace <from>:::<to> | リクエスト内の任意のテキストを検索/置換(繰り返し可) |
--session <id> | 新しいタブを作成する代わりに既存のリプレイセッションを再利用 |
--collection <id> | 新しく作成されたリプレイセッションをコレクションに入れる |
--sni <host> | TLS SNI を上書き |
--connect-host <host> | HTTP リクエストを保持したまま別のホストに接続 |
--connect-port <port> | 別のポートに接続 |
--connect-tls / --connect-no-tls | 接続に TLS/平文を強制 |
replay / send-raw - リクエストを送信
# そのまま再送信
npx tsx caido-client.ts replay <request-id>
# カスタム raw で再送信
npx tsx caido-client.ts replay <id> --raw "GET /modified HTTP/1.1\r\nHost: example.com\r\n\r\n"
# 完全にカスタムなリクエストを送信
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 -
# リクエストの Host/SNI を保持したまま別の場所に接続
npx tsx caido-client.ts replay <id> --connect-host 10.0.0.5 --connect-port 8443 --sni example.com
--raw は、\r\n エスケープを含む文字列、ディスクから読み取る @file、または標準入力から読み取る - を受け入れます。
export-curl - PoC 用の curl コマンドに変換
npx tsx caido-client.ts export-curl <request-id>
すべてのヘッダーとボディを含む、すぐに使用できる curl コマンドを出力します。
リプレイタブの検索
Caido のリプレイタブがすでに開いていて、そのアクティブなエントリから直接作業したい場合に使用します。
npx tsx caido-client.ts get-session <session-id-or-name> --compact
npx tsx caido-client.ts replay-entries <session-id-or-name> --limit 20
npx tsx caido-client.ts replay-entries <session-id-or-name> --raw --compact
npx tsx caido-client.ts edit-session <session-id-or-name> --body '{"test":true}' --compact
session-entries は replay-entries のエイリアスとして受け入れられます。
リプレイセッションとコレクション
セッション
# 既存のリクエストからリプレイセッションを作成
npx tsx caido-client.ts create-session <request-id>
npx tsx caido-client.ts create-session <request-id> --collection <collection-id>
# Caido UI で簡単に識別できるように、セッションには常に名前を付けてください
npx tsx caido-client.ts rename-session <session-id> "idor-user-profile"
# すべてのリプレイセッションを一覧表示
npx tsx caido-client.ts replay-sessions
npx tsx caido-client.ts replay-sessions --limit 50
# セッションをコレクション間で移動
npx tsx caido-client.ts move-session <session-id> <collection-id>
# リプレイセッションを削除
npx tsx caido-client.ts delete-sessions <session-id-1>,<session-id-2>
コレクション
リプレイセッションをコレクションに整理:
# リプレイコレクションの一覧表示
npx tsx caido-client.ts replay-collections
npx tsx caido-client.ts replay-collections --limit 50
# コレクションを作成
npx tsx caido-client.ts create-collection "IDOR Testing"
# コレクションの名前を変更
npx tsx caido-client.ts rename-collection <collection-id> "Auth Bypass Tests"
# コレクションを削除
npx tsx caido-client.ts delete-collection <collection-id>
ファジング
# ファジング用の自動化セッションを作成
npx tsx caido-client.ts create-automate-session <request-id>
# ファジングを開始(最初に Caido UI でペイロードとマーカーを設定してください)
npx tsx caido-client.ts fuzz <session-id>
スコープ管理
テストのスコープを定義します。グロブパターンを使用します。
# すべてのスコープを一覧表示
npx tsx caido-client.ts scopes
# 許可リストと拒否リストを使用してスコープを作成
npx tsx caido-client.ts create-scope "Target Corp" --allow "*.target.com,*.target.io" --deny "*.cdn.target.com"
# スコープを更新
npx tsx caido-client.ts update-scope <scope-id> --allow "*.target.com,*.api.target.com"
# スコープを削除
npx tsx caido-client.ts delete-scope <scope-id>
グロブパターン: *.example.com は example.com のすべてのサブドメインに一致します。
フィルタープリセット
頻繁に使用する HTTPQL クエリを名前付きプリセットとして保存します。
# 保存済みフィルターの一覧表示
npx tsx caido-client.ts filters
# フィルタープリセットを作成
npx tsx caido-client.ts create-filter "API Errors" --query 'req.path.cont:"/api/" AND resp.code.gte:400'
npx tsx caido-client.ts create-filter "Auth Endpoints" --query 'req.path.regex:"/(login|auth|oauth)/"' --alias "auth"
# フィルターを更新
npx tsx caido-client.ts update-filter <filter-id> --query 'req.path.cont:"/api/" AND resp.code.gte:500'
# フィルターを削除
npx tsx caido-client.ts delete-filter <filter-id>
環境変数
セッションをまたいで永続化するテスト変数を保存します。複数のユーザー ID を使用した IDOR テストに最適です。
# 環境の一覧表示
npx tsx caido-client.ts envs
# 環境を作成
npx tsx caido-client.ts create-env "IDOR-Test"
# 変数を設定
npx tsx caido-client.ts env-set <env-id> victim_user_id "user_456"
npx tsx caido-client.ts env-set <env-id> attacker_token "eyJhbG..."
# アクティブな環境を選択
npx tsx caido-client.ts select-env <env-id>
# 環境の選択を解除
npx tsx caido-client.ts select-env
# 環境を削除
npx tsx caido-client.ts delete-env <env-id>
ファインディング
セキュリティファインディングを作成、一覧表示、更新します。Caido のファインディングタブに表示されます。
# すべてのファインディングを一覧表示
npx tsx caido-client.ts findings
npx tsx caido-client.ts findings --limit 50
# 特定のファインディングを取得
npx tsx caido-client.ts get-finding <finding-id>
# リクエストにリンクされたファインディングを作成
npx tsx caido-client.ts create-finding <request-id> \
--title "ユーザープロファイルエンドポイントの IDOR" \
--description "ID パラメータを変更することで他のユーザーのプロファイルにアクセス可能" \
--reporter "rez0"
# 重複排除キーを使用(重複を防ぐ)
npx tsx caido-client.ts create-finding <request-id> \
--title "/admin の認証バイパス" \
--dedupe-key "admin-auth-bypass"
# ファインディングを更新
npx tsx caido-client.ts update-finding <finding-id> \
--title "更新されたタイトル" \
--description "更新された説明"
タスク
バックグラウンドタスク(インポート、エクスポートなど)の監視とキャンセル。
# すべてのタスクを一覧表示
npx tsx caido-client.ts tasks
# 実行中のタスクをキャンセル
npx tsx caido-client.ts cancel-task <task-id>
プロジェクト管理
# すべてのプロジェクトを一覧表示
npx tsx caido-client.ts projects
# アクティブなプロジェクトを切り替え
npx tsx caido-client.ts select-project <project-id>
ホストファイル
# ホストファイルの一覧表示
npx tsx caido-client.ts hosted-files
# ホストファイルを削除
npx tsx caido-client.ts delete-hosted-file <file-id>
インターセプト制御
# インターセプトステータスの確認
npx tsx caido-client.ts intercept-status
# インターセプトの有効化/無効化
npx tsx caido-client.ts intercept-enable
npx tsx caido-client.ts intercept-disable
情報、ヘルス、プラグイン
# 現在のユーザー情報
npx tsx caido-client.ts viewer
# インストール済みプラグインの一覧表示
npx tsx caido-client.ts plugins
# Caido インスタンスのヘルスチェック(バージョン、準備状態)
npx tsx caido-client.ts health
出力制御
get、get-response、replay、edit、send-raw で使用可能:
| フラグ | 説明 |
|---|---|
--max-body <n> | レスポンスボディの最大行数(デフォルト: 200、0=無制限) |
--max-body-chars <n> | ボディの最大文字数(デフォルト: 5000、0=無制限) |
--no-request | 出力からリクエスト raw をスキップ |
--headers-only | HTTP ヘッダーのみ、ボディなし |
--compact | ショートハンド: --no-request --max-body 50 --max-body-chars 5000 |
HTTPQL リファレンス
HTTP 履歴を検索するための Caido のクエリ言語。
重要: 文字列値は必ず引用符で囲む必要があります。整数値は引用符で囲みません。
重要: HTTPQL には NOT 演算子がありません。NOT expr と書かないでください。代わりに否定演算子のバリアントを使用してください:
ncont(含まない)、nlike(類似しない)、nregex(正規表現一致しない)、ne(等しくない)- 間違い:
NOT req.path.cont:"/admin" - 正しい:
req.path.ncont:"/admin"
名前空間とフィールド
| 名前空間 | フィールド | タイプ | 説明 |
|---|---|---|---|
req | ext | 文字列 | ファイル拡張子(. を含む) |
req | host | 文字列 | ホスト名 |
req | method | 文字列 | HTTP メソッド(大文字) |
req | path | 文字列 | URL パス |
req | query | 文字列 | クエリ文字列 |
req | raw | 文字列 | 完全な raw リクエスト |
req | port | 整数 | ポート番号 |
req | len | 整数 | リクエストボディの長さ |
req | created_at | 日付 | 作成日時 |
req | tls | ブール | HTTPS かどうか |
resp | raw | 文字列 | 完全な raw レスポンス |
resp | code | 整数 | ステータスコード |
resp | len | 整数 | レスポンスボディの長さ |
resp | roundtrip | 整数 | ラウンドトリップ時間(ミリ秒) |
row | id | 整数 | リクエスト ID |
source | - | 特殊 | "intercept"、"replay"、"automate"、"workflow" |
preset | - | 特殊 | フィルタープリセット参照 |
演算子
文字列: eq、ne、cont、ncont、like、nlike、regex、nregex
整数: eq、ne、gt、gte、lt、lte
ブール: eq、ne
論理: AND、OR、グループ化のための括弧
クエリ例
# 200 レスポンスの POST リクエスト
req.method.eq:"POST" AND resp.code.eq:200
# API リクエスト
req.host.cont:"api" OR req.path.cont:"/api/"
# エラーレスポンス
resp.code.gte:400
# 特定の拡張子を除外
req.ext.ne:".css" AND req.ext.ne:".js"
# インターセプトソースのリクエスト
source.eq:"intercept"