SD-JWTとは?

SD-JWT(Selective Disclosure for JSON Web Tokens)は、一部のクレームが隠された署名付きトークンです。発行者は、それらのクレームのソルト付きハッシュ(ダイジェストと呼ばれます)にのみ署名します。保有者は、どのクレームを明かすかを決め、そのクレームの開示をトークンと一緒に送ります。検証者は保有者が選んだクレームを確認でき、それぞれが発行者の署名したダイジェストと一致することを検証できますが、残りのクレームについては何もわかりません。

SD-JWT VCは、これをもとに検証可能な認証情報を構築します。vctタイプで認証情報の種類を示し、cnfキーで認証情報を保有者のデバイスに結び付けます。SD-JWT VCは、EU加盟国が2026年12月までに市民に提供しなければならないEUデジタルIDウォレットの2つの認証情報形式の1つで、OpenID for Verifiable Credentialsでも使われています。

SD-JWTの構造

SD-JWTは、チルダ(~)で区切られた複数の部分からなる文字列です。

  • 発行者が署名したJWT(header.payload.signature)。
  • 明かすクレームごとに1つの開示。それぞれ、ランダムなソルト、クレーム名、その値からなるJSON配列をBase64urlでエンコードしたものです。配列要素の開示では、名前は省略されます。
  • 末尾にある任意の鍵バインディングJWT。保有者が署名し、その提示が自分のものであり、この検証者に向けたものであることを示します。鍵バインディングJWTがない場合、文字列はチルダで終わります。

使い方

SD-JWTを貼り付けます。改行とスペースは無視されるため、ログからコピーした折り返し付きのトークンも使えます。

発行者の署名を検証するには、発行者の公開鍵を、JWK、JWKセット(トークンのkidを持つ鍵が使われます)、PEM公開鍵、またはX.509証明書として入力します。秘密鍵のJWKを貼り付けても機能し、その公開部分だけが使われます。鍵の欄が空の場合は、トークンのヘッダーのx5cに証明書があれば、それが使われます。

表示される内容

  • 署名、開示、鍵バインディング、有効期間、ハッシュアルゴリズムの検証項目。
  • 発行者JWTのヘッダー。アルゴリズム、タイプ(SD-JWT VCの場合はdc+sd-jwt)、鍵IDが含まれます。
  • 署名済みペイロード。隠されたクレームのダイジェスト(_sd)と、隠された配列要素の{"...": digest}プレースホルダーが含まれます。
  • 開示を含むクレーム。検証者が読むのと同じように、すべての開示をそれぞれの位置に入れたペイロードです。
  • 開示。各開示のクレーム、値、クレーム内での位置、ダイジェストの表です。
  • 鍵バインディングJWT。オーディエンス(aud)、nonce、sd_hashを含むヘッダーとペイロードです。

検証項目の意味

  • 署名:発行者JWTが、入力した鍵で署名されていること。ヘッダーの証明書が代わりに使われた場合は、トークンがそれ自身の証明書と一致することを示します。その証明書が、たとえばEUのトラステッドリストに載っているような信頼できる発行者のものかどうかは、この検証の対象外です。
  • 開示:すべての開示のダイジェストが、署名済みトークン内にちょうど1回ずつ現れること。変更された開示はダイジェストが変わるため一致しなくなり、重複して送信された開示は警告されます。
  • 鍵バインディング:鍵バインディングJWTのsd_hashがこの提示そのもの(最後のチルダまでのSD-JWT)のハッシュであり、認証情報のcnfにある鍵で署名されていること。開示を削除したり追加したりすると、ハッシュが一致しなくなります。
  • 有効期間:トークンの有効期限(exp)と開始時刻(nbf)を、デバイスの時計と照らし合わせます。
  • ハッシュアルゴリズム:ダイジェストが_sd_algのアルゴリズムを使っていること。トークンで指定されていない場合はSHA-256です。ブラウザーはSHA-256、SHA-384、SHA-512を計算できます。

プライバシー

デコードとすべての検証はブラウザー内で行われるため、トークンや鍵がどこかに送信されることはありません。実際の認証情報には個人データが含まれているため、スクリーンショットを共有するときはテスト用の認証情報を使ってください。