jose/docs/functions/jwt_verify.jwtVerify.md
2021-07-21 14:20:32 +02:00

1.6 KiB

Function: jwtVerify

jwt/verify.jwtVerify

jwtVerify(jwt, key, options?): Promise<JWTVerifyResult>

Verifies the JWT format (to be a JWS Compact format), verifies the JWS signature, validates the JWT Claims Set.

example ESM import

import { jwtVerify } from 'jose/jwt/verify'

example CJS import

const { jwtVerify } = require('jose/jwt/verify')

example Usage

const jwt = 'eyJhbGciOiJFUzI1NiJ9.eyJ1cm46ZXhhbXBsZTpjbGFpbSI6dHJ1ZSwiaWF0IjoxNjA0MzE1MDc0LCJpc3MiOiJ1cm46ZXhhbXBsZTppc3N1ZXIiLCJhdWQiOiJ1cm46ZXhhbXBsZTphdWRpZW5jZSJ9.hx1nOfAT5LlXuzu8O-bhjXBGpklWDt2EsHw7-MDn49NrnwvVsstNhEnkW2ddauB7eSikFtUNeumLpFI9CWDBsg'

const { payload, protectedHeader } = await jwtVerify(jwt, publicKey, {
  issuer: 'urn:example:issuer',
  audience: 'urn:example:audience'
})

console.log(protectedHeader)
console.log(payload)

Parameters

Name Type Description
jwt string | Uint8Array JSON Web Token value (encoded as JWS).
key KeyLike | JWTVerifyGetKey Key, or a function resolving a key, to verify the JWT with.
options? JWTVerifyOptions JWT Decryption and JWT Claims Set validation options.

Returns

Promise<JWTVerifyResult>

Defined in

jwt/verify.ts:59