| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201 |
- // src/utils/jwt/jwt.ts
- import { decodeBase64Url, encodeBase64Url } from "../../utils/encode.js";
- import { AlgorithmTypes } from "./jwa.js";
- import { signing, verifying } from "./jws.js";
- import {
- JwtAlgorithmMismatch,
- JwtAlgorithmNotAllowed,
- JwtAlgorithmRequired,
- JwtHeaderInvalid,
- JwtHeaderRequiresKid,
- JwtPayloadRequiresAud,
- JwtSymmetricAlgorithmNotAllowed,
- JwtTokenAudience,
- JwtTokenExpired,
- JwtTokenInvalid,
- JwtTokenIssuedAt,
- JwtTokenIssuer,
- JwtTokenNotBefore,
- JwtTokenSignatureMismatched
- } from "./types.js";
- import { utf8Decoder, utf8Encoder } from "./utf8.js";
- var encodeJwtPart = (part) => encodeBase64Url(utf8Encoder.encode(JSON.stringify(part)).buffer).replace(/=/g, "");
- var encodeSignaturePart = (buf) => encodeBase64Url(buf).replace(/=/g, "");
- var decodeJwtPart = (part) => JSON.parse(utf8Decoder.decode(decodeBase64Url(part)));
- function isTokenHeader(obj) {
- if (typeof obj === "object" && obj !== null) {
- const objWithAlg = obj;
- return "alg" in objWithAlg && Object.values(AlgorithmTypes).includes(objWithAlg.alg) && (!("typ" in objWithAlg) || objWithAlg.typ === "JWT");
- }
- return false;
- }
- var sign = async (payload, privateKey, alg = "HS256") => {
- const encodedPayload = encodeJwtPart(payload);
- let encodedHeader;
- if (typeof privateKey === "object" && "alg" in privateKey) {
- alg = privateKey.alg;
- encodedHeader = encodeJwtPart({ alg, typ: "JWT", kid: privateKey.kid });
- } else {
- encodedHeader = encodeJwtPart({ alg, typ: "JWT" });
- }
- const partialToken = `${encodedHeader}.${encodedPayload}`;
- const signaturePart = await signing(privateKey, alg, utf8Encoder.encode(partialToken));
- const signature = encodeSignaturePart(signaturePart);
- return `${partialToken}.${signature}`;
- };
- var verify = async (token, publicKey, algOrOptions) => {
- if (!algOrOptions) {
- throw new JwtAlgorithmRequired();
- }
- const {
- alg,
- iss,
- nbf = true,
- exp = true,
- iat = true,
- aud
- } = typeof algOrOptions === "string" ? { alg: algOrOptions } : algOrOptions;
- if (!alg) {
- throw new JwtAlgorithmRequired();
- }
- const tokenParts = token.split(".");
- if (tokenParts.length !== 3) {
- throw new JwtTokenInvalid(token);
- }
- const { header, payload } = decode(token);
- if (!isTokenHeader(header)) {
- throw new JwtHeaderInvalid(header);
- }
- if (header.alg !== alg) {
- throw new JwtAlgorithmMismatch(alg, header.alg);
- }
- const now = Math.floor(Date.now() / 1e3);
- if (nbf && payload.nbf && payload.nbf > now) {
- throw new JwtTokenNotBefore(token);
- }
- if (exp && payload.exp && payload.exp <= now) {
- throw new JwtTokenExpired(token);
- }
- if (iat && payload.iat && now < payload.iat) {
- throw new JwtTokenIssuedAt(now, payload.iat);
- }
- if (iss) {
- if (!payload.iss) {
- throw new JwtTokenIssuer(iss, null);
- }
- if (typeof iss === "string" && payload.iss !== iss) {
- throw new JwtTokenIssuer(iss, payload.iss);
- }
- if (iss instanceof RegExp && !iss.test(payload.iss)) {
- throw new JwtTokenIssuer(iss, payload.iss);
- }
- }
- if (aud) {
- if (!payload.aud) {
- throw new JwtPayloadRequiresAud(payload);
- }
- const audiences = Array.isArray(payload.aud) ? payload.aud : [payload.aud];
- const matched = audiences.some(
- (payloadAud) => aud instanceof RegExp ? aud.test(payloadAud) : typeof aud === "string" ? payloadAud === aud : Array.isArray(aud) && aud.includes(payloadAud)
- );
- if (!matched) {
- throw new JwtTokenAudience(aud, payload.aud);
- }
- }
- const headerPayload = token.substring(0, token.lastIndexOf("."));
- const verified = await verifying(
- publicKey,
- alg,
- decodeBase64Url(tokenParts[2]),
- utf8Encoder.encode(headerPayload)
- );
- if (!verified) {
- throw new JwtTokenSignatureMismatched(token);
- }
- return payload;
- };
- var symmetricAlgorithms = [
- AlgorithmTypes.HS256,
- AlgorithmTypes.HS384,
- AlgorithmTypes.HS512
- ];
- var verifyWithJwks = async (token, options, init) => {
- const verifyOpts = options.verification || {};
- const header = decodeHeader(token);
- if (!isTokenHeader(header)) {
- throw new JwtHeaderInvalid(header);
- }
- if (!header.kid) {
- throw new JwtHeaderRequiresKid(header);
- }
- if (symmetricAlgorithms.includes(header.alg)) {
- throw new JwtSymmetricAlgorithmNotAllowed(header.alg);
- }
- if (!options.allowedAlgorithms.includes(header.alg)) {
- throw new JwtAlgorithmNotAllowed(header.alg, options.allowedAlgorithms);
- }
- let verifyKeys = options.keys ? [...options.keys] : void 0;
- if (options.jwks_uri) {
- const response = await fetch(options.jwks_uri, init);
- if (!response.ok) {
- throw new Error(`failed to fetch JWKS from ${options.jwks_uri}`);
- }
- const data = await response.json();
- if (!data.keys) {
- throw new Error('invalid JWKS response. "keys" field is missing');
- }
- if (!Array.isArray(data.keys)) {
- throw new Error('invalid JWKS response. "keys" field is not an array');
- }
- verifyKeys ??= [];
- verifyKeys.push(...data.keys);
- } else if (!verifyKeys) {
- throw new Error('verifyWithJwks requires options for either "keys" or "jwks_uri" or both');
- }
- const matchingKey = verifyKeys.find((key) => key.kid === header.kid);
- if (!matchingKey) {
- throw new JwtTokenInvalid(token);
- }
- if (matchingKey.alg && matchingKey.alg !== header.alg) {
- throw new JwtAlgorithmMismatch(matchingKey.alg, header.alg);
- }
- return await verify(token, matchingKey, {
- alg: header.alg,
- ...verifyOpts
- });
- };
- var decode = (token) => {
- const parts = token.split(".");
- if (parts.length !== 3) {
- throw new JwtTokenInvalid(token);
- }
- try {
- const header = decodeJwtPart(parts[0]);
- const payload = decodeJwtPart(parts[1]);
- return {
- header,
- payload
- };
- } catch {
- throw new JwtTokenInvalid(token);
- }
- };
- var decodeHeader = (token) => {
- const parts = token.split(".");
- if (parts.length !== 3) {
- throw new JwtTokenInvalid(token);
- }
- try {
- return decodeJwtPart(parts[0]);
- } catch {
- throw new JwtTokenInvalid(token);
- }
- };
- export {
- decode,
- decodeHeader,
- isTokenHeader,
- sign,
- verify,
- verifyWithJwks
- };
|