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

> A2A v1.0のAgentCard署名は、JWSとRFC 8785の正規化で改ざんを検出します。署名が証明する範囲と、kid・jkuを使う検証手順、鍵の信頼設計を整理します。

- Canonical: https://kuucorp.com/blog/a2a-signed-agent-card-jws-verification-design/
- Date: 2026-10-26
- Last modified: 2026-10-26
- Publisher: Kuu株式会社 (https://kuucorp.com)

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

AgentCardの発見方法そのものは[A2A AgentCard発見設計](/blog/a2a-agent-discovery-enterprise-registry-design/)で扱いました。本稿は署名の生成・検証と信頼設計に絞ります。プロトコルの全体像は[A2Aプロトコルの用語解説](/glossary/a2a-protocol/)も参照してください。

## 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対策](/blog/mcp-cimd-authorization-server-ssrf-trust-policy/)とも共通します。外部から指定されたURLを自動で取得する処理は、取得先の制限が前提です。

### 規模別の留意点（SMB / エンタープライズ）

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

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

## 参考

- [Agent2Agent (A2A) Protocol Specification](https://a2a-protocol.org/latest/specification/)
- [RFC 7515: JSON Web Signature (JWS)](https://www.rfc-editor.org/rfc/rfc7515)

## まとめ

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