Communitygithub.com

Caido モード

Caido の API を完全カバーする CLI ツール。HTTP 履歴の検索、リクエストの編集/再送信、スコープ管理、ファインディング作成などを、UI 上でそのまま操作できます。

Caido モード とは?

Caido モードは、Caido Web アプリケーションセキュリティテストプラットフォームの全機能をコマンドラインから操作できる強力なスキルです。`@caido/sdk-client` パッケージをベースに、HTTP 履歴の検索・取得・編集・再送信、リプレイセッションとコレクションの管理、スコープ定義、フィルタープリセットの保存、環境変数によるテスト変数の管理、セキュリティファインディングの作成・更新、バックグラウンドタスクの監視、プロジェクト切り替え、インターセプト制御など、Caido の主要機能をすべて CLI から利用できます。特に、既存のリクエストの認証情報(Cookie やトークン)を維持したままパスやメソッド、ボディだけを編集できる `edit` コマンドが特徴で、IDOR テストなど権限昇格の検証に極めて有用です。全出力は JSON 形式で、エージェントやスクリプトからの処理に適しています。認証にはパーソナルアクセストークン(PAT)を使用し、一度設定すればトークンは `~/.agents/config/secrets.json` にキャッシュされます。

対応✓Claude Code~Codex CLI✓Cursor✓OpenCode
npx skills add Aceproulx/claude-skills

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Caido モード スキル

概要

公式 @caido/sdk-client パッケージをベースに構築された、Caido の API を完全カバーする CLI です。以下の機能を網羅します:

  • HTTP 履歴 - HTTPQL による検索、取得、再送信、リクエスト編集
  • リプレイ&セッション - セッション、コレクション、エントリ、ファジング
  • スコープ - テストスコープの作成と管理(許可リスト/拒否リストパターン)
  • フィルタープリセット - HTTPQL フィルタープリセットの保存と再利用
  • 環境変数 - テスト変数の保存(被害者 ID、トークンなど)
  • ファインディング - セキュリティファインディングの作成、一覧表示、更新
  • タスク - バックグラウンドタスクの監視とキャンセル
  • プロジェクト - テストプロジェクトの切り替え
  • ホストファイル - Caido が提供するファイルの管理
  • インターセプト - プログラムによるリクエストインターセプトの有効化/無効化
  • プラグイン - インストール済みプラグインの一覧表示
  • エクスポート - PoC 用の curl コマンドへの変換
  • ヘルス - Caido インスタンスのステータス確認

すべてのトラフィックは Caido を経由するため、UI に表示され、さらなる分析が可能です。

このモデルを選ぶ理由

Cookie や認証トークンは巨大になり得ます - セッション Cookie、JWT、CSRF トークンは簡単に 1〜2KB になります。手動でコピーペーストする代わりに:

  1. Caido の HTTP 履歴から、すでに有効な認証情報を持つ有機的なリクエストを見つける
  2. edit を使用して必要な部分だけを変更する(パス、メソッド、ボディ)一方で、すべての認証ヘッダーはそのまま維持する
  3. 送信する - 完全なコンテキストを保持したレスポンスが返ってくる

認証設定

セットアップ(初回のみ)

  1. ダッシュボード → 開発者 → パーソナルアクセストークン を開く
  2. 新しいトークンを作成する
  3. 以下を実行:
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-onlyHTTP ヘッダーのみ、ボディなし
--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"

名前空間とフィールド

名前空間フィールドタイプ説明
reqext文字列ファイル拡張子(. を含む)
reqhost文字列ホスト名
reqmethod文字列HTTP メソッド(大文字)
reqpath文字列URL パス
reqquery文字列クエリ文字列
reqraw文字列完全な raw リクエスト
reqport整数ポート番号
reqlen整数リクエストボディの長さ
reqcreated_at日付作成日時
reqtlsブールHTTPS かどうか
respraw文字列完全な raw レスポンス
respcode整数ステータスコード
resplen整数レスポンスボディの長さ
resproundtrip整数ラウンドトリップ時間(ミリ秒)
rowid整数リクエスト 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"

関連スキル