他社のエージェントを自社のワークフローに接続するとき、最初に読むのは相手の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つあります。
signaturesフィールドを署名対象から除外する- 任意フィールドのうち、明示的に設定されていないものは省略する
- デフォルト値を持つフィールドは、
REQUIREDかoptionalキーワード付きでない限り省略する
注意すべきは2と3です。実装がデフォルト値を出力するシリアライザーを使っていると、署名側と検証側で正規化後のバイト列がずれます。署名の失敗原因として最も起きやすいのはここなので、署名側と検証側で同じ前処理を共有ライブラリー化してください。
検証はどの手順で行うのか
クライアントは署名の取り出し、公開鍵の取得、同一の正規化、署名検証の5手順を踏み、期限切れや失効済みの鍵は使えません。
仕様が定める保護ヘッダーの要件は、alg・typ(JOSE が推奨)・kid を必ず含めることです。jku(JWK Set の URL)は任意で付けられます。クライアントの検証手順(MUST)は次のとおりです。
signatures配列から署名を取り出すkidとjku、または信頼済みの鍵ストアから公開鍵を取得する- デフォルト値のプロパティを除き、
signaturesを除外する - RFC 8785 で正規化する
- 正規化したペイロードに対して署名を検証する
加えて、信頼する前に少なくとも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にご相談ください。
