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・Ed25519 | PEM(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)はありません。
オプション
名前
型