← All posts

ES256 への移行ひとつで、正しい署名を台無しにする方法が 3 通り

Authagonal·July 20, 2026
jwtecdsaes256cryptovaultjwsdotnet

アルゴリズムの移行そのものは順調でした。その経緯は JWT 署名鍵の 3 つの人生 に書いています。稼働中の発行者で RS256 から ES256 へ切り替え、移行期間中は両方の鍵を JWKS で公開し、アクティブ鍵の選択ロジックがレガシーの RSA 鍵から自動的にローテーションしていく。鍵、ローテーション、ディスカバリーといった、いかにも難しそうな部分はすべて一発で動きました。

これは、そうはいかなかった部分の話です。移行の途中で 3 回、私たちの認証サーバーは署名が 暗号学的に正しい トークンを発行しました。計算は合っていて、正しい鍵が正しいバイト列に署名していたのです。それなのに、それを受け入れるバリデーターはこの世に 1 つもありませんでした。3 つの異なるレイヤーがそれぞれのやり方でバイト列を壊しており、外から見た失敗はどれもまったく同じ invalid signature でした。「フォーマットが違う」でも「長さが想定外」でもなく、ただ「無効」です。

移行の途中でこのエラーを睨んでいるところなら、最後のフィールドガイドまで飛ばしてください。デコードした署名の長さを見れば、ほぼ毎回、犯人のレイヤーがわかります。

RSA は私たちを甘やかしていた:整数 1 つ、エンコーディング 1 つ

ECDSA への移行前に誰も教えてくれないことがあります。RSA ではこの問題が一度も起きなかったので、これまでの勘がまったく通用しないのです。

RSA の署名は、それ自体が 1 つの整数です。ワイヤーフォーマットはその整数をビッグエンディアンで鍵長までパディングしたものにすぎず、RSA-2048 なら 256 バイト。書き表し方は実質 1 通りしかありません。どのライブラリで署名し、別のどのライブラリで検証しても、バイト列の意味は同じです。

ECDSA の署名は整数の ペア (r, s) です。ペアにはエンコーディングが必要で、エコシステムは互換性のない 2 つの方式に落ち着きました。

  • ASN.1 DER:2 つの INTEGER からなる SEQUENCE。可変長(P-256 では通常 70〜72 バイト)で、必ずバイト 0x30 で始まります。OpenSSL、X.509、TLS が話すのはこちらです。
  • 生の R‖S(IEEE P1363):r と s をそれぞれ先頭からパディングしてちょうど 32 バイトにし、連結したもの。常にちょうど 64 バイトです。JWS が ES256 に義務付けているのはこちらです(RFC 7518 §3.4)。

どちらも同じ署名をエンコードしており、どちらも「正しい」。バリデーターに想定していないほうを渡しても、「コンテナが違う」とは言ってくれません。でたらめな整数をデコードし、言えるただ 1 つのこと、つまり署名を検証できないと報告するだけです。

鍵からワイヤーまでの間にあるすべてのレイヤーが、自分がどちらを話すかについて一家言を持っています。私たちのところにはそのレイヤーが 3 つあり、3 つすべてを順番に間違えました。

落とし穴その 1:KMS は DER で答える

私たちの秘密鍵は HashiCorp Vault の transit エンジンの中にあり、外に出ることはありません。アプリケーションは署名してほしいバイト列を送り、署名を受け取ります。transit の鍵を rsa-2048 から ecdsa-p256 に切り替えたとき、署名リクエストには RSA 時代の名残がまだ付いていました。signature_algorithm=pkcs1v15 です。

これは RSA の パディング に関するパラメーターで、ECDSA 鍵にとっては意味がありません。Vault はエラーを返しませんでした。無関係なパラメーターを無視し、曲線の鍵で署名し、完全に正しい ECDSA 署名を付けて 200 を返したのです。デフォルトのマーシャリング形式、つまり DER で。

そのため正常系は端から端まで緑のままでした。リクエストは受け付けられ、署名は返ってきて、openssl dgst -verify にかければお墨付きをもらえたはずです。そしてすべての JWT ライブラリが、すべてのトークンを拒否しました。3 番目のセグメントを base64url デコードしたあと 64 バイトの R‖S を期待していたのに、出てきたのは 0x30 で始まる 71 バイトだったからです。

修正はリクエストパラメーター 1 つです。Vault の transit の sign エンドポイントは marshaling_algorithm=jws を受け付け、これを指定すると生の R‖S を直接返します。ただ、この罠の形に注目してください。鍵の種類に対して間違っていて、しかも 黙って無視される パラメーターです。リクエストは間違って見え、実際に間違っていて、それでも動きました。「動いた」の意味を取り違えれば、の話ですが。

落とし穴その 2:「整数をつなげるだけ」は 128 トークンに 1 つ失敗する

KMS がネイティブに R‖S を出力できないなら、DER を自前で変換したくなるでしょう。2 つの INTEGER を取り出して連結すれば終わり、と。これが 3 つの中で最もたちの悪い落とし穴です。ときどき 正しく動いてしまうからです。

DER の整数は最小長で、しかも符号付きです。つまり、

  • たまたま数値が小さい(最上位バイトがゼロの)r は、DER が先頭のゼロを取り除くため 31 バイト 以下でエンコードされます。
  • 最上位ビットが立っている r には符号用の 0x00 バイトが付き、33 バイト でエンコードされます。

JWS フォーマットが求めているのはどちらでもありません。各値を常に ちょうど 32 バイトになるよう先頭からパディングしたものです。DER の整数を素朴に連結すると、運次第で 63、64、65、66 バイトの署名ができあがり、検証を通るのは 64 バイトを引いたときだけです。符号バイトは処理したのにパディングを忘れると、r か s がゼロバイトで始まるたびに失敗する変換器が残ります。それぞれが 256 分の 1 の確率で起きるので、およそ 128 トークンに 1 つ が短くなります。

そのバージョンはスモークテストを通り、コードレビューを通り、リリースされ、そして本番で 1 時間に 1 回、パターンの見えないログイン失敗を起こします。私たちは Vault に変換させることでこれを回避しました(またしても marshaling_algorithm=jws です。署名処理を持っている側に、フォーマットも持たせる)。ただし同じ罠には .NET の中だけで完結する変種もあります。ECDsa.SignData/VerifyData は DSASignatureFormat を受け取りますが、フレームワークのあちこちでデフォルトが違うのです。SignedXml/証明書の世界は Rfc3279DerSequence で考える一方、生の ECDsa API のデフォルトは P1363 です。私たちのローカル検証パスは今では DSASignatureFormat.IeeeP1363FixedFieldConcatenation を明示しています。この移行以来、どこであれ、署名 API にフォーマットをデフォルト任せにはさせていません。

落とし穴その 3:修正が足元で base64 の方言を変えた

Vault はすべての署名を vault:v1:<encoded-bytes> というエンベロープで包みます。デフォルトの DER マーシャリングではエンコード部分は標準の base64 で、私たちのクライアントは律儀にそれを Convert.FromBase64String に渡していました。

marshaling_algorithm=jws に切り替えると、Vault は(いま従っている仕様からすれば当然ですが)署名部分を base64url でエンコードします。-/_ のアルファベットで、パディングなしです。1 つのリクエストフラグが、要求したバイトフォーマットと、それが届くときのテキストエンコーディングという 2 つのものを同時に変えていたのです。

Convert.FromBase64String はパディング付きの標準 base64 を求めます。64 バイトの署名は base64url で 86 文字になり、4 の倍数ではありません。そのためデコードは、1 つ残らずすべてのトークンで FormatException を投げました。ある意味、3 つの失敗の中ではこれがいちばん親切でした。もっともらしいバイト列を作ってどこか別の場所で静かに失敗するのではなく、少なくとも間違っているまさにその行で、派手に クラッシュ してくれたのですから。修正は、base64url のコーデックでデコードする(検証の往復では再エンコードもする)ことです。

皮肉なものです。署名はようやく正しいバイトフォーマットになったのに、今度は テキスト のレイヤーがそれを壊したのです。積み重なっていたエンコーディングは 3 つ。整数ペアのエンコーディング、固定長フィールドのパディング、そして文字エンコーディングです。どれもが単独で、正しい署名を拒否されるトークンに変えてしまえます。

フィールドガイド:長さが犯人を教えてくれる

アルゴリズム移行の途中で JWT の検証が失敗したら、トークンの 3 番目のセグメントを base64url デコードして、何が出てくるかを見てください。

デコードした署名 壊したレイヤー
ちょうど 64 バイト ワイヤーフォーマットは正しい。ほかを当たる(kid の不一致、JWKS 内の鍵の誤り、alg の固定)
70〜72 バイト、先頭バイトが 0x30 DER が漏れ出している:KMS か暗号ライブラリが ASN.1 を出力している
63 または 65 バイトで、失敗するのは 一部の トークンだけ 固定長フィールドのパディングをしない、手書きの DER→raw 変換
デコードが例外を投げる、またはゴミが出る 1 つ下のレイヤーでの base64 と base64url の取り違え

そして、フォーマットのバグと鍵のバグを数秒で切り分けるクロスチェックを 1 つ。同じ署名を、DER を話す OpenSSL で検証してみてください。OpenSSL は有効と言い、JWT ライブラリはどれも無効と言うなら、エンコーディングの問題です。両方とも無効と言うなら、鍵の問題です。

教訓

「暗号学的に正しい」は数学の性質です。「検証できる」は、数学と利用者の間にあるすべてのエンコーディング境界の性質です。そして私たちの署名は、その境界を 4 つ通過していました。KMS のマーシャリング、その転送用エンベロープ、クライアントのデコード、そして JWS のワイヤーフォーマットです。そのうち 3 つの境界が独自の意見を持ち、それぞれがちょうど 1 回ずつ隣と食い違いました。

テストに関する教訓は、私たちが実際にプロセスを変えた点です。署名パスを、自分のコードで検証して証明してはいけません。私たちの署名パスと検証パスはこれらの前提をすべて共有していたので、署名してから検証する往復テストは通るのに、本物の利用者はみな私たちを拒否していました。最終的に 3 つのバグをすべて押さえ込んだテストは、本物のトークンを発行し、それをプラットフォーム標準の JWT ライブラリで、公開済みの JWKS に対して検証します。私たちの前提ではなく、他人の前提で、です。そのうえで、容赦なく具体的なことを 1 つアサートします。デコードした署名がちょうど 64 バイトであること。数学は放っておいても大丈夫です。見張らなければならないのはバイト列のほうです。

どのスタックが受け取ってもトークンが検証できるよう、ES256 を最後の 1 バイトまで正しく仕上げる。その作業は、私たちが引き受ければ一度で済みます。Authagonal がトークンに署名して JWKS を公開するので、エンコーディングが深夜 2 時のあなたの問題になることはありません。