JWT とは？

利用者を示すsub、発行者のiss、宛先のaud、有効期限のexpなど、用途に応じたクレームが入るよ。よく見る署名やMAC付きのJWS形式はHeader.Payload.Signatureの3パート。暗号化するJWEのコンパクト形式は5パートなので、すべてが3パートではないんだ。

署名やMACは改ざんの検知に使い、暗号化とは違うよ。JWSのPayloadはBase64urlで表しただけなので、入手した人は読める。機密情報を安易に入れないことと、トークン自体の漏えいを防ぐことが大切だね。

それだけではだめだよ。受け手が許可した方式と信頼する鍵で検証し、発行者、宛先、期限や用途に合うクレームも確認する。トークンが指定した方式を無条件に受け入れないようにしよう。署名付きの認証に、未署名のalg: noneを混ぜて受け入れてはいけないんだ。

内容を検証して利用できるけれど、保存や無効化は別の設計だよ。利用者が手元のトークンを消すだけでは、コピーされたトークンまで失効しない。受け手が失効情報を確認する方式なら期限前に拒否できるが、その管理が必要になる。短い期限も選択肢だけれど、JWTに必須の15分という規則はないんだ。

一律に禁止される方式ではないよ。HS256は共有秘密を使うMACなので、検証する側も同じ秘密を持ち、トークンを作れてしまう。公開鍵で検証する署名との違いを踏まえ、信頼関係に合う方式と十分な強さの鍵を選ぶ。人が覚えられるパスワードをそのままMACの鍵にしないことも必要だね。