Package Exports
- middy-middleware-jwt-auth
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (middy-middleware-jwt-auth) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
middy-middleware-jwt-auth
A middy JSON web token authorization middleware inspired by express-jwt.
Installation
Download node at nodejs.org and install it, if you haven't already.
npm install middy-middleware-jwt-auth --saveDocumentation
There is additional documentation.
Usage
import createHttpError from 'http-errors'
import middy from 'middy'
import { httpErrorHandler, httpHeaderNormalizer } from 'middy/middlewares'
import JWTAuthMiddleware, { EncryptionAlgorithms, IAuthorizedEvent } from 'middy-middleware-jwt-auth'
// Optionally define the token payload you expect to receive
interface ITokenPayload {
permissions: string[]
}
// Optionally define a type guard for the token payload
function isTokenPayload (token: any): token is ITokenPayload {
return token != null &&
Array.isArray(token.permissions) &&
token.permissions.every((permission: any) => typeof permission === 'string')
}
// This is your AWS handler
const helloWorld = async (event: IAuthorizedEvent<ITokenPayload>) => {
// The middleware adds auth information if a valid token was added
// If no auth was found, event.auth will remain undefined. You have to check
// that it exists.
if (event.auth == null) {
throw createHttpError(401, 'No valid bearer token was set in the authorization header', {
type: 'AuthenticationRequired'
})
}
// Check for authorization
if (event.auth.permissions.indexOf('helloWorld') === -1) {
throw createHttpError(403, `User not authorized for helloWorld, only found permissions [${event.auth.permissions.join(', ')}]`, {
type: 'NotAuthorized'
})
}
return {
body: JSON.stringify({ data: 'Hello world!' }),
statusCode: 200
}
}
// Let's "middyfy" our handler, then we will be able to attach middlewares to it
export const handler = middy(helloWorld)
.use(httpHeaderNormalizer()) // Make sure authorization header is saved in lower case
.use(httpErrorHandler()) // This middleware is needed do handle the errors thrown by the JWTAuthMiddleware
.use(JWTAuthMiddleware({
/** Algorithm to verify JSON web token signature */
algorithm: EncryptionAlgorithms.HS256,
/** An optional function that checks whether the token payload is formatted correctly */
isPayload: isTokenPayload,
/** A string or buffer containing either the secret for HMAC algorithms, or the PEM encoded public key for RSA and ECDSA */
secretOrPublicKey: 'secret'
}))