JWS Compact Serialization(RFC 7515 セクション3.1)に準拠したJWTを生成するには、JOSEヘッダー、JSONクレームセット、および共通鍵(シークレットキー)を <header>.<payload>.<signature> 形式の3パートから成る文字列に変換します。
1. JOSEヘッダーとAPIクレームペイロードの構築
まず、HS256 保護ヘッダーと、RFC 7519の登録済みクレーム(iss、sub、aud、iat、exp)およびアプリケーション固有のカスタムクレーム(role)を組み合わせたJSONペイロードを用意します。
{
"alg": "HS256",
"typ": "JWT"
}
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"aud": "api.example.com",
"iat": 1767225600,
"exp": 1767229200,
"role": "admin"
}
ここで 1767225600 は 2026-01-01T00:00:00Z を表し、1767229200 は 2026-01-01T01:00:00Z(有効期限1時間)を表します。
2. パディングなしBase64URL署名入力の作成
各JSONオブジェクトは余分な空白を含まないUTF-8バイト列にミニファイされ、Base64URL(- と _ を使用し、末尾の = パディングを除去)でエンコードされた後、ASCIIピリオド(.)で連結されます。
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2F1dGguZXhhbXBsZS5jb20iLCJzdWIiOiJ1c3JfOTQ4MSIsImF1ZCI6ImFwaS5leGFtcGxlLmNvbSIsImlhdCI6MTc2NzIyNTYwMCwiZXhwIjoxNzY3MjI5MjAwLCJyb2xlIjoiYWRtaW4ifQ
3. 再現可能なHMAC-SHA256署名テストベクター
Web Cryptoは crypto.subtle.importKey("raw", secretBytes, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]) を通じてシークレットのバイト列をインポートし、正確なASCII <base64url-header>.<base64url-payload> バイト列に署名します。UTF-8シークレット your-256-bit-secret を使用した標準的なHS256テストベクターにより、OpenSSL、Node.jsの crypto、Pythonの PyJWT、および本ツール間で決定論的な一致を確認できます。
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
{"alg":"HS256","typ":"JWT"} ヘッダーと上記のペイロードを your-256-bit-secret で署名すると、常に以下の147文字のトークンが生成されます。このままHTTPの Authorization: Bearer <token> ヘッダーに使用したり、JWTデコーダー&インスペクターでラウンドトリップ検証を行ったりできます。
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c