JSON Web Token

JSON Web Token（ジェイソン・ウェブ・トークン）は、JSONデータに署名や暗号化を施す方法を定めたオープン標準 (RFC 7519) である。略称はJWT。

ヘッダー	{ "alg" : "HS256", "typ" : "JWT" }	署名生成に使用したアルゴリズムを格納する。左記の`HS256`は、このトークンがHMAC-SHA256で署名されていることを示す。署名アルゴリズムとしては、SHA-256を使用したHMAC (HS256) や、SHA-256を使用したRSA署名 (RS256) がよく用いられる。JSON Web Algorithms (JWA, RFC 7518) では認証や暗号化用のさらに多くのアルゴリズムが提示されている^[9]。
ペイロード	{ "loggedInAs" : "admin", "iat" : 1422779638 }	認証情報などのクレームを格納する。JWTの仕様では、トークンに一般的に含まれる7つの標準フィールドが定義されている^[10]。また用途に応じた独自のカスタムフィールドを含むこともできる。左記の例では、トークン発行日時を示す標準のクレーム (`iat`) と、カスタムクレーム (`loggedInAs`) を格納している。
署名	HMAC-SHA256( base64urlEncoding(header) + '.' + base64urlEncoding(payload), secret )	トークン検証用の署名。署名は、ヘッダーとペイロードをBase64urlでエンコードされた上で、ピリオドで結合したものから生成する。署名はヘッダーで指定された暗号化アルゴリズムにより生成される。左記はHMAC-SHA256形式でのコード例である。Base64url方式は、Base64を元に特殊記号やパディングの扱いを変えたものである。

コード	名称	説明
`typ`	Token type	トークンの形式。`JWT`とすることが推奨される。
`cty`	Content type	JWTを入れ子にして署名や暗号化を行う場合、このフィールドに`JWT`を指定する。それ以外では通常指定しない^[10]。
`alg`	Message authentication code algorithm	発行者が使用した署名アルゴリズム。任意のアルゴリズムが指定可能だが、いくつかのアルゴリズムは安全ではない^[11]。`NONE`が指定された場合、署名なしのトークンを受け入れることになるので、安全ではない。通常はサーバーやライブラリで、`NONE`を無効・拒否する^[12]。
その他、JWSとJWE由来のヘッダーが存在する^[7]^[8]。

コード	名称	説明
`iss`	Issuer	トークン発行者の識別子。
`sub`	Subject	トークンの主題の識別子。
`aud`	Audience	トークンが意図している受信者の識別子。トークンを受け付ける受信者は、この値に自身が含まれるかを識別しなければならない。もし`aud`クレームが存在し、かつ自身が含まれない場合、トークンを拒否しなければならない。
`exp`	Expiration Time	トークンの有効期限。この期限以降の場合、トークンを受け付けてはならない。有効期限は1970-01-01 00:00:00Zからの秒数を数値で指定する（UNIX時間）^[13]。
`nbf`	Not Before	トークンの開始日時。この期限以降の場合、トークンを受け付けてよい。秒数を数値で指定する。
`iat`	Issued at	トークンの発行日時。秒数を数値で指定する。
`jti`	JWT ID	発行者ごとトークンごとに一意な識別子。サーバ側で`jti`を利用し、トークンの使用履歴を管理することで、リプレイ攻撃を防ぐことができる。

概要