JWT と鍵形式変換：jose、jwk-to-pem、node-forge などの技術的比較

JWT（JSON Web Token）や JWK（JSON Web Key）を扱う際、フロントエンド開発者には「どのライブラリを使えば安全で効率的か？」という課題があります。ここでは、代表的な6つの npm パッケージ — jose、jwk-to-pem、node-forge、node-jose、pem、pem-jwk — を、実際の開発シナリオに基づいて比較します。

⚠️ 非推奨パッケージの確認

まず重要な前提として、node-jose は公式に非推奨（deprecated） とされています。npm ページおよび GitHub リポジトリに明記されており、作者が後継として jose を推奨しています。新規プロジェクトで使用すべきではありません。

// ❌ node-jose は非推奨
// const jose = require('node-jose'); // 使用しないでください

以下では、残りの5つのパッケージを中心に比較します。

🔑 主要な用途と機能範囲

jose：標準準拠の JWT/JWK ハンドリング

jose は IETF RFC 7515–7519（JWT/JWS/JWK）に完全準拠し、Web Crypto API と互換性のある設計を採用しています。フロントエンド（ブラウザ）と Node.js の両方で動作し、TypeScript 定義も完備。JWT の署名・検証、JWK の操作、JWE（暗号化トークン）まで対応。

// jose: JWT の検証例（フロントエンド/Node.js 両対応）
import { jwtVerify } from 'jose';

const { payload } = await jwtVerify(jwt, publicKey, {
  issuer: 'https://example.com',
  audience: 'my-app'
});

jwk-to-pem：JWK → PEM 変換専用

このパッケージは JWK を PEM 形式の文字列に変換するだけ のシンプルなツールです。JWT の検証機能は一切含みません。

// jwk-to-pem: JWK から PEM 生成
import jwkToPem from 'jwk-to-pem';

const pem = jwkToPem(jwk); // 公開鍵 or 秘密鍵
// その後、Node.js の crypto.verify() や node-forge で使用

pem-jwk：PEM → JWK 変換専用

jwk-to-pem の逆方向。PEM 文字列を JWK オブジェクトに変換します。

// pem-jwk: PEM から JWK 生成
import { pem2jwk } from 'pem-jwk';

const jwk = pem2jwk(pemString);
// その後、jose などで使用可能

node-forge：汎用暗号ライブラリ

RSA、AES、X.509、ASN.1 など、幅広い暗号機能を純 JavaScript で提供。ブラウザでも動作し、ネイティブ crypto に依存しません。ただし、JWT/JWK 専用の API はありません。

// node-forge: PEM から公開鍵を読み込み、署名検証
import forge from 'node-forge';

const publicKey = forge.pki.publicKeyFromPem(pem);
const verified = publicKey.verify(digest, signature);

pem：OpenSSL ラッパー（Node.js 専用）

内部で OpenSSL コマンドを呼び出すため、Node.js 専用。ブラウザでは動作しません。主に証明書や鍵の生成に使われ、JWT とは直接関係ありません。

// pem: 自己署名証明書の生成（Node.js のみ）
import pem from 'pem';

pem.createCertificate({ days: 365, selfSigned: true }, (err, keys) => {
  const { certificate, serviceKey } = keys;
  // certificate は PEM 形式
});

🧪 実際の JWT 検証フローでの比較

OAuth 2.0 の ID トークンを検証するケースを想定します。JWK Set（jwks.json）から公開鍵を取得し、JWT を検証します。

jose を使った最適解

// jose: JWKS からの自動キーフェッチと検証
import { createRemoteJWKSet, jwtVerify } from 'jose';

const JWKS = createRemoteJWKSet(new URL('https://example.com/.well-known/jwks.json'));
const { payload } = await jwtVerify(jwt, JWKS, {
  issuer: 'https://example.com',
  audience: 'my-app'
});

jwk-to-pem + Node.js crypto の組み合わせ

// jwk-to-pem + crypto: 手動変換と検証（Node.js のみ）
import jwkToPem from 'jwk-to-pem';
import { createPublicKey, verify } from 'crypto';

const pem = jwkToPem(jwk);
const key = createPublicKey(pem);
const [header, payload, signature] = jwt.split('.');
const data = header + '.' + payload;
const isValid = verify('RS256', Buffer.from(data), key, Buffer.from(signature, 'base64url'));

node-forge での検証（ブラウザ対応）

// node-forge: ブラウザで JWT 検証
import forge from 'node-forge';

const publicKey = forge.pki.publicKeyFromPem(pem);
const md = forge.md.sha256.create();
md.update(data, 'utf8');
const isValid = publicKey.verify(md.digest().bytes(), forge.util.decode64(signature));

💡 注意：node-forge は base64url ではなく standard base64 を期待するため、署名のデコードに注意が必要です。

📦 環境対応と依存関係

🔄 相互変換の補完関係

• jwk-to-pem と pem-jwk は 互いに補完的 です。片方が欠けていると双方向変換が困難になります。
• jose は 変換不要 で JWK を直接扱えるため、多くのケースでこれら2つを不要にします。
• node-forge は PEM を直接扱えるため、jwk-to-pem と組み合わせて使うパターンもあります。

🛠️ 実践的な選定ガイド

ケース1：フロントエンドで ID トークンを検証したい

✅ jose 一択。ブラウザ対応、TypeScript 対応、RFC 準拠、軽量。

ケース2：Node.js で JWK を PEM に変換してネイティブ crypto で使いたい

✅ jwk-to-pem。シンプルで信頼性が高い。

ケース3：ブラウザで OpenSSL 互換の暗号操作が必要（JWT 以外）

✅ node-forge。ただし、JWT 専用なら jose の方が安全で簡単。

ケース4：自己署名証明書を Node.js で生成したい

✅ pem。ただし、これは JWT とは無関係な用途。

📌 まとめ：推奨アーキテクチャ

• 新規プロジェクトで JWT/JWK を扱うなら、jose を使う。これだけでほとんどのニーズをカバーできます。
• 変換だけが必要なレガシー統合の場合、jwk-to-pem または pem-jwk を選ぶ。
• 汎用暗号操作が必要な特殊ケース で node-forge を検討する。
• node-jose は絶対に使わない。
• pem は JWT とは無関係。証明書生成専用と理解すること。

現代のフロントエンド開発では、セキュリティと標準準拠が最重要です。jose はそのバランスを最もよく取った選択肢であり、多くのチームが移行を進めています。