本文へ移動
Senri

JWT

@senrijs/senri/jwt で、JWT を作って確かめる

import {  } from "@senrijs/senri";
import { , , type  } from "@senrijs/senri/jwt";
declare const : { : string };

const  = <>();

.("/login", async () => ({
    : await ({ : "42" }, ., { : "HS256", : 3600 }),
}));

.("/api", ({ : ., : ["HS256"] }));   // Authorization: Bearer <token>
.("/api/me", (, ) => ({ : .("jwtPayload") }));

暗号は Web Crypto だけで、Bun・Deno・Node.js・Cloudflare Workers・ブラウザで動きます。

決まり

  • algorithms は必須です。 トークンの alg が、この中にあるときだけ確かめます。none は受け付けません
  • exp・nbf があれば確かめます(clockTolerance で時計のずれを許します)。issuer・audience・subject・maxAge も指定できます
  • 期限を必ず付けたいときは、signJwt() の expiresIn を使います
  • Cookie から読むときは、jwt({ cookie: "名前", ... }) と書きます
  • だめなトークンは JwtError(401 の HttpError)で、WWW-Authenticate: Bearer error="invalid_token" が付きます。err.reason で理由(expired・signature など)が分かります

アルゴリズムと鍵

アルゴリズム鍵
HS256・HS384・HS512文字列の秘密鍵(HS256 は 32 バイト以上、HS384 は 48、HS512 は 64。短いと TypeError)
RS256・RS384・RS512、PS256・PS384・PS512、ES256・ES384、EdDSA・Ed25519PEM(PUBLIC KEY / PRIVATE KEY)、JWK、CryptoKey
  • PEM の公開鍵が、HMAC の秘密鍵として使われることはありません(アルゴリズムを取り違えさせる攻撃を防ぐため)
  • ES512 には、まだ対応していません

鍵の入れ替え

.("/api", ({
    : [{ : "2026-11", :  }, { : "2026-10", :  }],
    : ["HS256"],
}));

signJwt() は kid をヘッダーに入れ、verifyJwt() はトークンの kid と同じ鍵(と、kid のない鍵)だけを試します。JWKS の keys は、そのまま渡せます。

外の JWKS の URL から鍵を取ってくる機能と、暗号化(JWE)はありません。

オプション

名前

型

このページの内容