この記事に関連するツール
ブラウザ上ですぐに試せます。記事の内容を確認しながら使うと、作業の流れをつかみやすくなります。
**JWKS(JSON Web Key Set)とは、JWTの署名を検証するための公開鍵を、JSONの keys 配列にまとめたものです。**RFC 7517 で定められた形式で、認証サーバーが /.well-known/jwks.json のようなURLで公開します。APIサーバーは、JWTのヘッダーにある kid と一致する鍵をJWKSから選び、その公開鍵で署名を検証します。
JWTツールでは、このJWKSや公開鍵(PEM)を貼り付けて、RS256のJWTの署名と有効期限をブラウザ内で確かめられます。
「公開鍵、どこに置いたっけ?」
JWTの署名検証にRSAなどの公開鍵方式を使うとき、必ずぶち当たる壁があります。「公開鍵はどうやって配布するのが一番安全?」「鍵を更新したとき、全サーバーの設定を書き換えるの?」
その悩みを解決する仕組みが**JWKS(JSON Web Key Set)**です。JWKS生成ツール では、ブラウザ内でRSA鍵ペアを生成し、JWKS形式(公開鍵)とPEM形式(秘密鍵)の両方をその場で確認できます。

JWKS:公開鍵の「ショーケース」
JWKSは「JSON形式で書かれた鍵のセット」です。認証サーバー(Auth0やCognitoなど)が特定のURL(/.well-known/jwks.json が一般的)でこのJSONを公開し、検証側のAPIサーバーがそれを読み取りに行きます。
なぜJWKSが便利なのか
- 自動ローテーション: 鍵を新しくしても、エンドポイントの中身を入れ替えるだけ。APIサーバーはURLを見に行くだけで最新の鍵を手に入れられる
- 複数鍵の並行管理: 「古い鍵」と「新しい鍵」を同時に置いておけるので、移行期間もスムーズ
- 世界標準: OAuth 2.0やOIDCで広く採用されているため、多くのライブラリが標準対応している
JWKSの中身:フィールドの意味
{
"keys": [
{
"kty": "RSA",
"n": "0vx7agoebGcQ...",
"e": "AQAB",
"kid": "f47ac10b-...",
"use": "sig",
"alg": "RS256",
"key_ops": ["verify"]
}
]
}
| フィールド | 役割 |
|---|---|
kty |
鍵の種類(RSAなど) |
n / e |
RSA公開鍵の本体(モジュラスと公開指数) |
kid |
鍵の識別子。JWTのヘッダーと照合し、どの鍵で検証するか選ぶための鍵ローテーションの要 |
use |
用途。署名検証用なら sig(暗号化用は enc) |
alg / key_ops |
アルゴリズムと許可操作の宣言。検証側の誤用防止 |
keys は配列なので、ローテーション中は新旧2つの鍵が並び、JWTヘッダーの kid で選別されます。
ブラウザで鍵ペアを生成する
JWKS生成ツール は jose ライブラリとWeb Crypto APIを組み合わせ、鍵ペアをその場で生成します。アルゴリズムは RS256(RSA 2048bit・既定)のほか、PS256・ES256・ES384・EdDSA(Ed25519)から選べます。
- 公開鍵(JWKS形式):
/.well-known/jwks.jsonのモックとして使える - 秘密鍵(PEM形式): JWTの署名生成に使える
kidは指定しなければランダムなIDが自動採番される
生成はブラウザ内で完結するため、秘密鍵がインターネットに流れる心配はありません。ローカル開発で自作の認証サーバー(モック)を立てる際や、JWT検証ロジックの単体テストに向いています。
JWT署名検証でJWKSが使われる流れ
- 認証サーバーがJWTを発行する
- JWTヘッダーには、署名に使った鍵を示す
kidが入る - APIサーバーはJWKSエンドポイントから公開鍵一覧を取得する
kidが一致する公開鍵を選ぶ- その公開鍵でJWTの署名を検証する
この仕組みによって、APIサーバーは秘密鍵を持つ必要がありません。秘密鍵は認証サーバー側だけに置き、検証側は公開鍵だけを使うことで役割を分けて安全に運用できます。JWTのペイロード自体はBase64URLエンコードされているだけで暗号化はされていない、という前提は JWTデコードツール で実際のトークンを確認すると分かりやすいです。
JWKSを扱うときの注意点
- JWTヘッダーの
kidとJWKS内のkidが一致しているか algが想定している署名アルゴリズムか- JWKSの取得結果を適切にキャッシュしているか
- 鍵ローテーション時に新旧の鍵を一時的に並べているか
- 失効した鍵をいつ削除するか決めているか
とくに鍵ローテーションでは、新しい鍵で発行されたJWTと、古い鍵で発行済みのJWTが同時に存在する期間があります。その間はJWKSに複数の公開鍵を載せ、どちらのJWTも検証できる状態にしておくのが一般的です。
既存のPEMの鍵を、JWK / JWKS にする(PEM ⇄ JWK の変換)
すでに OpenSSL などで作った PEM の鍵があるときは、JWKS生成ツールの「鍵の書き方の変換」で JWK にできます。逆に、JWK / JWKS を PEM にすることもできます。
- PEM → JWK: 公開鍵(
BEGIN PUBLIC KEY、SPKI)・秘密鍵(BEGIN PRIVATE KEY、PKCS#8)・証明書(BEGIN CERTIFICATE、X.509)に対応します。RSA・EC(P-256 / P-384 / P-521)・Ed25519 を自動で判定します。kidにサムプリント(RFC 7638)を入れる、useを付ける、証明書ならx5cも付ける、ができます - JWK / JWKS → PEM: 1つの JWK でも、
{"keys": [...]}の JWKS でも読めます。秘密鍵の成分(dなど)があれば、PKCS#8 の秘密鍵と、公開側の SPKI の両方を出します - PKCS#1 と SEC1:
BEGIN RSA PRIVATE KEY(PKCS#1)とBEGIN EC PRIVATE KEY(SEC1)は、この変換では読めません。ツールが、先に変換するためのopenssl pkcs8 -topk8 -nocrypt -in key.pemなどのコマンドを案内します
秘密鍵を JWK にすると、d などの秘密の値が入ります。公開する JWKS には、公開鍵の部分だけを入れてください。 変換はすべてブラウザの中で行われ、鍵は送信されません。
よくある質問
JWKSに秘密鍵を入れてもいいですか?
入れてはいけません。JWKSとして外部に公開するのは、署名検証に使う公開鍵です。秘密鍵はJWTを発行する側だけが保持し、ブラウザやAPI利用者から見える場所には置かないでください。
kid は必須ですか?
複数の鍵を扱う運用では非常に重要です。JWTヘッダーの kid とJWKS内の kid を照合することで、検証側はどの公開鍵を使えばよいか判断できます。鍵ローテーションを考えるなら、最初から kid を付けておくのがおすすめです。
ローカル開発用のJWKSはどう作ればいいですか?
JWKS生成ツール でテスト用の鍵ペアを生成し、公開鍵側をJWKSとして使えます。本番の秘密鍵を貼り付けたり共有したりせず、開発用と本番用の鍵を分けて管理してください。
生成した鍵をそのまま本番で使えますか?
推奨しません。このツールの用途は開発・テスト・学習です。生成自体はブラウザ内で完結し鍵が外部に送信されることはありませんが、本番の署名鍵はHSMやKMSなど、管理された環境で生成・保管すべきものです。
手元のPEMの公開鍵から、JWKSを作るには?
JWKS生成ツールの「鍵の書き方の変換」に、BEGIN PUBLIC KEY で始まる PEM を貼り、「kid にサムプリントを入れる」を選んで変換します。出てきた JWK を {"keys": [ … ]} に入れれば、JWKS になります。秘密鍵(BEGIN PRIVATE KEY)を貼ると秘密の値も出るので、公開用には使わないでください。
まとめ
- JWKSは公開鍵をJSON形式で配布する仕組み。
kidが鍵ローテーションの要 use/alg/key_opsは誤用防止の宣言- 検証側は秘密鍵を持たず、JWKSエンドポイントから取得した公開鍵だけで署名検証できる
- ローテーション中は新旧の鍵をJWKSに並存させる
OpenSSLのオプションを思い出す時間を節約したいときに、ぜひどうぞ。
おすすめリソース
このセクションにはアフィリエイトリンクが含まれる場合があります。リンク経由で購入すると、追加費用なしでDevToolKits.appが紹介料を受け取ることがあります。
