Communitygithub.com

khasky/public-client-leak-audit

AIエージェント向けスキル。公開クライアント(拡張機能、アプリ、SPA、CLI、SDK)の内部バックエンドの漏洩、機密情報、悪用を許す開示を監査し、オープンソース公開やストア提出前に強化します。

public-client-leak-audit とは?

このスキルは、公開クライアントコードベースを監査し、プライベートバックエンドの内部構造や機密情報、悪用を許す開示を特定・修正するためのものです。監査対象は拡張機能、アプリ、SPA、CLI、SDKなど、公開されるクライアント全般です。AIエージェントが自律的に6つのフェーズ(スコープ設定、漏洩スイープ、クライアント堅牢化、修正、検証、レポート作成)を実行し、発見と修正を自動化します。Claude Code、Cursor、CodexなどのAI Agentプラットフォームで動作し、参照ファイル(漏洩分類法、書き換えルール、堅牢化チェックリスト、レポートテンプレート)を必要に応じて読み込むことで効率的に監査を行います。このスキルは防御的な目的を持ち、コードの公開攻撃面を減らすために、公開クライアントが必要最小限の情報だけを公開し、内部動作を隠蔽するようにします。

対応~Claude Code~Codex CLI~Cursor
npx skills add khasky/public-client-leak-audit

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

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

ドキュメント

公開クライアントリーク監査

公開クライアントのコードベースを監査します。このクライアントはプライベートバックエンドと通信します。目標:公開面は自己完結型である必要があります。つまり、クライアントが行う呼び出しと交換するデータの形状(出荷されるクライアントでは避けられない)を明らかにしても構いませんが、それ以上は明らかにしてはいけません。サーバーの動作に関する余分な詳細はすべて、攻撃者にとっての自由な偵察手段となり、悪用のてことなります。

このスキルは3つの成果物を生成します:発見リスト(リーク+クライアント側のセキュリティホール。それぞれに ファイル:行 と重大度が付与されます)、一連の適用された修正、および残余の推奨事項を含むレポートです。

リファレンスファイル(必要なときにオンデマンドで読み込んでください。一度にすべてインライン化しないこと):

  • references/leak-taxonomy.md — 調査すべき開示のカテゴリ、それぞれが重要な理由、およびスターター検索パターン。
  • references/rewrite-rules.md — コメント/文字列書き換えルールとBefore/Afterの例。保持するか削除するかの判断方法。
  • references/client-hardening.md — クライアント側のセキュリティチェックリスト(パーミッション、IPC、トークン、DOM、ネットワーク、ビルド設定、サプライチェーン)。
  • references/report-template.md — 出力レポートの構造。
  • scripts/leak-sweep.sh — パラメーター化されたripgrepスイープで検索をシードするスクリプト(製品ごとにパターン配列をカスタマイズ)。

中核となるメンタルモデル

すべての開示を次の2つのバケットに分類します。

  • 必要最小限(保持):クライアントが呼び出すエンドポイント、実際に送受信するリクエスト/レスポンスの形状、独自のリトライ/バックオフ/デバウンスの選択、入力検証の上限、およびステータス → UI動作のマッピング。公開クライアントはこれらを隠せません。隠そうとするのはセキュリティシアターです。
  • 過剰開示(修正):リクエストに対してサーバーが何をするかを説明するもの、クライアントが厳密には必要としないサーバー側の制限/クォータ、出荷されたクライアントが決して呼び出さないエンドポイント、内部サーバーロジックを反映するエラーブランチ、アンチアビューズメカニズム、インフラ/技術スタックの識別子、プライベートリポジトリ/パス、バックエンドの動作をエンコードするテスト用足場。

書き換えルール。 クライアントコードとテストは契約を表明しても構いません(「HTTP 422 → 未サポートプロバイダメッセージを表示」)。しかし、サーバーが何をなぜ行うかを説明してはいけません(「サーバーは使い捨てドメインチェックを実行し、422で拒否する」)。コメントがサーバーの動作を説明している場合は、削除するか、クライアントが観測可能な契約に縮小してください。references/rewrite-rules.mdを参照してください。

ワークフロー

労力はリクエストに応じて調整してください。「これで何かリークしているか」というクイックな確認はフェーズ1〜2で、「オープンソース公開前のスクラブ」や「完全監査」は6つすべてを実行します。大規模なコードベースの場合は、フェーズ2を複数の並列読み取り専用エージェント(タクソノミークラスターごとに1つ)にファンアウトし、それらのファイル:行の発見結果をマージします。ただし、フェーズ1のスコープ設定は必ず自分で最初に行ってください。

フェーズ1 — 公開/プライベート境界のスコープ設定

検索を開始する前に、この製品にとって「プライベート」が何を意味するかを確立します。これをスキップしないでください。監査全体がこの境界に対して相対的に行われます。

  • 監査対象の公開アーティファクトと、そのプライベートな対応物(バックエンド、管理ツール、インフラ、モノレポの兄弟プロジェクト)を特定します。分割が明らかでない場合は、ユーザーに質問するか、AGENTS.md/README/CONTRIBUTINGから推測します。
  • 製品のバックエンドスタック、ホスティング、DB、アンチアビューズメカニズム、テスト/ステージング用の便宜をリストアップします。これにより、リークを見つけたときに認識できます。これらが不明な場合は、それが最初にユーザーへ質問すべきことです。
  • このクライアントにとって必要最小限とみなされるもの(実際のエンドポイントとペイロード)を書き留めます。そうすることで、避けられないものにフラグを立てる無駄な労力を省けます。

フェーズ2 — リークのスイープ

references/leak-taxonomy.mdのタクソノミーに従って進めます。src/だけでなく、リポジトリ全体をカバーします:tests/e2e、docs、README/CHANGELOG、CI/ワークフローファイル、.env*とその.exampleのペア、ビルド/設定ファイル、パッケージマニフェスト(scripts、postinstall)、およびロケール/i18n文字列(これらはパッケージ内に出荷されます)。scripts/leak-sweep.sh <target-dir>をスタータースイープとして実行し、ヒットをコンテキスト内で読みます。パターンマッチはリードであって、確定ではありません。実際の発見ごとに、ファイル:行、短い引用、および1節の理由を記録します。また、「確認済み、問題なし」のリストも保持し、レポートでカバレッジを示せるようにします。

特に見逃しやすい2つの高価値クラスに注意してください:

  • 公開一歩手前のシークレット — gitで無視されている.env*ファイル内の実際の値。これらは、バンドラーが.gitignoreを尊重しないため、ソースバンドル(ストア/アプリストアの「レビュー用ソース」zip、npm pack、ディレクトリバックアップ)に含まれる可能性があります。追跡されていない ≠ 安全。
  • テスト/e2eコード — 決定論的なテスト資格情報、特別なクエリパラメータ、出荷されたクライアントが決して呼び出さないエンドポイント、サーバー内部を説明するコメント。テストは期待されるサーバーレスポンスを文書化するため、バックエンドの動作が最も頻繁にリークする場所です。

フェーズ3 — クライアント側の堅牢化

references/client-hardening.mdを実行します。これはリークとは直交しており、クライアントが何を開示するかに関係なく、悪用可能かどうかに関するものです。特権IPCにおける送信元/発信元の検証、認証トークンの保存と送信、ページまたはサーバー由来のデータを入力とするDOM/XSSシンク、過度に広いパーミッション、およびバックエンドを再ポイントしたりシークレットをバンドルしたりする悪意のあるビルドを可能にするビルド時の設定を優先的に扱います。

フェーズ4 — 是正

修正を適用します。影響の順序:

  1. 最初にシークレットリークチャネルを閉じます(ソースバンドルから.env*/シークレットファイルを除外、実際の値をコミット対象の近くにあるファイルから移動)。
  2. リークするコメント/文字列/ドキュメントに書き換えルールを適用します。コメントの文言を変更するよりも、コメントが不要になるようにコードをリネームすることを優先します。
  3. サーバーポリシー(セッションTTL、クォータ、削除されたエンドポイント)をハードコードするデッドコードを削除します。
  4. テスト/ドキュメントをクライアントが観測可能な契約にトリミングします。フローが機能するように保ち、ナレーションを削除します。
  5. テストを伴う堅牢化の変更を適用します。

動作を維持することがデフォルトです。タスクが明示的に機能変更を要求しない限り、公開API契約、ストレージキー、メッセージ名、リクエスト/レスポンスの形状を安定に保ちます。

フェーズ5 — 検証

何も壊していないこと、何も見逃していないことを証明します:

  • プロジェクトの型チェック、ユニットテスト、リンター、およびプロダクションビルドを実行します。実際の終了コードをキャプチャします(cmd | tailパイプはtailのステータスを報告し、失敗したビルドを隠します。パイプなしで実行するか、PIPESTATUS/set -o pipefailを使用します)。
  • リークスイープを再実行し、意図したパターンが(意図的なものを除いて)ゼロになったことを確認します。
  • ビルド成果物およびソースバンドルを、シークレット、ソースマップ、内部文字列についてスキャンします。dist//ビルド出力とソースzipをgrepします。ソースツリーのクリーンさだけに頼らないでください。
  • 正当なフローがまだ機能することを確認します(たとえば、異なることが許可されているステージング/e2eビルドが正しく解決されるなど)。

フェーズ6 — レポート

references/report-template.mdに従ってレポートを書きます:重大度別の発見、適用された変更、残余の推奨事項(シークレットのローテーション、git履歴の露出、意識的に先送りされたトレードオフ)、および検証証拠。git履歴は事後的に修正できません。削除されたシークレットや説明的なコミット件名はログに残ります。公開リポジトリの履歴を書き換えるのではなく、ローテーションと将来のコミットメッセージの衛生状態を推奨します。

ガードレール

  • 避けられないものに過剰にフラグを立てないでください。エンドポイント、ペイロード形状、およびステータス → UIマッピングは必要最小限です。これらにフラグを立てると、レポートへの信頼が損なわれます。
  • パターンヒットはリードです。それをリークと呼ぶ前にコンテキストで読んでください。「epoch」は通常はタイムスタンプ、「worker」はWeb Workerかもしれません、「durable」はキューであってDurable Objectsではないかもしれません。
  • ユーザーに関連するポリシーを述べているユーザー向け文字列(例:「コードは10分で期限切れになります」)は維持してください。その横にある非表示の説明/コメント内の内部フレーミングを削除してください。
  • このスキルは、公開攻撃面を減らすために、自分の/許可されたコードを監査します。これは防御的です。開示を減らし、クライアントを堅牢化するものであり、エクスプロイトを構築するものではありません。

関連スキル