約 4 分で読めます

A2A署名付きAgentCardの検証設計——JWSとJCS

他社のエージェントを自社のワークフローに接続するとき、最初に読むのは相手のAgentCardです。スキル、認証方式、エンドポイントがすべてここに書かれています。このカードが途中で書き換えられていれば、接続先そのものが攻撃者のものにすり替わります。A2A v1.0 はこの対策として、AgentCardにJWS署名を付ける仕組みを用意しています。ただし署名の検証は必須ではなく、何を証明できるかも正しく理解しておく必要があります。

AgentCardの発見方法そのものはA2A AgentCard発見設計で扱いました。本稿は署名の生成・検証と信頼設計に絞ります。プロトコルの全体像はA2Aプロトコルの用語解説も参照してください。

AgentCardの署名は何のためにあるのか

AgentCardの署名は、カードがJWS(RFC 7515)で署名されていることを示し、クライアントが完全性と出所を確認するための任意機能です。

A2A v1.0.0 の仕様では、AgentCardは JSON Web Signature(JWS)で署名してもよい(MAY)とされています。署名は必須ではありません。署名の目的は、クライアントがカードの完全性(途中で改ざんされていないこと)と出所を確認できるようにすることです。

署名はカード本体の signatures 配列に格納されます。要素は AgentCardSignature オブジェクトで、フィールドは次の3つです。

フィールド必須内容
protected必須base64url エンコードした保護ヘッダー(JSON)
signature必須base64url エンコードした署名値
header任意保護されない JWS ヘッダー値

配列なので複数の署名を持てます。仕様は、鍵ローテーションに対応するために複数署名を許容しています。

署名対象はどのように正規化されるのか

署名前にRFC 8785(JCS)で正規化することが必須で、signaturesフィールドは署名対象から除外されます。

同じ内容のJSONでも、キーの順序や空白が違えばバイト列が変わり、署名検証に失敗します。そこで仕様は、署名前にJCS(JSON Canonicalization Scheme、RFC 8785)による正規化を求めています。JCSはキーの辞書順整列、プリミティブ値の表記統一、不要な空白の排除を規定します。

AgentCard固有の前処理が3つあります。

  1. signatures フィールドを署名対象から除外する
  2. 任意フィールドのうち、明示的に設定されていないものは省略する
  3. デフォルト値を持つフィールドは、REQUIRED か optional キーワード付きでない限り省略する

注意すべきは2と3です。実装がデフォルト値を出力するシリアライザーを使っていると、署名側と検証側で正規化後のバイト列がずれます。署名の失敗原因として最も起きやすいのはここなので、署名側と検証側で同じ前処理を共有ライブラリー化してください。

検証はどの手順で行うのか

クライアントは署名の取り出し、公開鍵の取得、同一の正規化、署名検証の5手順を踏み、期限切れや失効済みの鍵は使えません。

仕様が定める保護ヘッダーの要件は、alg・typ(JOSE が推奨)・kid を必ず含めることです。jku(JWK Set の URL)は任意で付けられます。クライアントの検証手順(MUST)は次のとおりです。

  1. signatures 配列から署名を取り出す
  2. kid と jku、または信頼済みの鍵ストアから公開鍵を取得する
  3. デフォルト値のプロパティを除き、signatures を除外する
  4. RFC 8785 で正規化する
  5. 正規化したペイロードに対して署名を検証する

加えて、信頼する前に少なくとも1つの署名を検証すること(SHOULD)、鍵は HTTPS で取得すること(SHOULD)、期限切れや失効済みの鍵を検証に使ってはならないこと(MUST NOT)が示されています。署名の検証に成功してから初めて、カード内の skills や認証要件を接続判断に使う順序にします。

署名は何を証明し、何を証明しないのか

署名が証明するのは「鍵の保有者が発行し、改ざんされていない」ことで、鍵が誰のものかは別の信頼設計が必要です。

ここが設計上の落とし穴です。署名検証に通っても、それは「このカードは、この鍵の保有者が署名し、その後変更されていない」ことしか意味しません。その鍵が本当に相手企業のものかは、署名からは分かりません。

特に jku には注意が必要です。RFC 7515 は、jku で鍵を取得する際に次を求めています。

  • 取得に使うプロトコルが完全性保護を提供すること
  • HTTP GET は TLS を使い、サーバーの身元を RFC 6125 に従って検証すること
  • jku・kid などのヘッダーは、信頼判断に使う場合は完全性保護されていること

つまり、攻撃者が自分で作ったカードに自分の jku を書いて署名すれば、署名そのものは正しく検証できてしまいます。これを防ぐ設計が必要です。

  • jku の取得先ドメインを、カードを取得したドメインや許可リストと照合する
  • 取得した鍵を、事前に登録した信頼済み鍵ストアと突き合わせる
  • 初回接続時の鍵を固定し(pinning)、変更は承認フローを通す
  • jku の取得先を内部アドレスに向けられないよう、サーバー側リクエスト偽造(SSRF)対策を入れる

この考え方は、CIMD認可サーバー実装のSSRF対策とも共通します。外部から指定されたURLを自動で取得する処理は、取得先の制限が前提です。

規模別の留意点(SMB / エンタープライズ)

SMB: 接続先が数社であれば、鍵の公開鍵を相手から安全な経路で受け取り、信頼済み鍵ストアに登録する運用で足ります。jku による動的取得は使わず、鍵を固定するのが最も単純で安全です。導入や定着の支援が必要ならKuuの運用管理サービスをご検討ください。

エンタープライズ: 数十以上のエージェントを束ねる環境では、レジストリで署名検証ゲートを一元化し、未署名カードを拒否する方式が現実的です。鍵のローテーション期間中は複数署名を許容し、失効リストの確認を検証手順に組み込みます。大規模基盤での設計支援はKuu RDEで扱っています。

参考

まとめ

A2A v1.0 のAgentCard署名は、JWSとJCS(RFC 8785)による正規化で、カードの完全性と出所を確認する任意機能です。検証では、署名側と検証側で正規化の前処理をそろえること、jku の取得先を信頼済みの範囲に限定することが要点です。署名の成功は鍵の保有者を示すにとどまるため、鍵の信頼は別途設計してください。A2Aの署名検証や鍵管理の設計は、Kuuにご相談ください。

関連記事

A2A長時間タスク設計——ストリーミングとPush通知の使い分けx-mcp-header設計——引数をHTTPヘッダーで制御するMCPとA2Aの違い——補完するプロトコルを正しく使い分けるMCP Sampling——LLM補完委譲の設計とセキュリティ