README.md

Cognito-JWT-Token-Validator

Cognito JWT Token Validator provides an easy solution to validate JWT ID tokens provided by Cognito IdP, that is to be used in a custom authorizer.

Features

• Automatic handling of JWKs
• Verification of JWT with the issuer, audience, token_use, and expiry

Installation

npm install cognito-jwt-token-validator --save

Usage

Typesrcipt:

import { Validator } from 'cognito-jwt-token-validator';

// Authorize function

const validator = new Validator('issuer', 'audience');
const authorize = async (token) => {
	try {
    	const payload = await validator.validate(token);
    	return {
    		userid: payload.sub
    	};
    } catch(err) {
    	console.log('Failed to validate the token');
        return {
        	failed: true
        }
    }
};

Javascript (with promises):

const Validator = require('cognito-jwt-token-validator').Validator; 
const validator = new Validator('issuer', 'audience');

// Authorize function
const authorize = function (token) {
	return validator.validate(token)
    	.then((payload) => {
        	return { userid: payload.sub };
        });
};

Refer the demo/ directory for a complete implementation.

Contributing