Skip to content

Latest commit

 

History

History
58 lines (39 loc) · 1.9 KB

README.md

File metadata and controls

58 lines (39 loc) · 1.9 KB
Raw

alt text

NPM

Inspired in this post Amazon Cognito User Pools in NodeJS as fast as possible thanks Prasad.

Cognito defender

Cloud based painless wrapper library to handle authentication via AWS Cognito using JWT capabilities, on backend side, cognito defender has a good integration with express and nest.js framework.

Why cognito defender

In the early stages of projects we might to setup the Authentication and Authorisation features to grant access to specific users in the whole system, I wrapped the AWS Cognito identity library to use it on node.js backend and take the advantages to use AWS Cognito 50K first users FREE!

What cover cognito defender

  • user signing up
  • user sign in
  • forgot password
  • confirm password
  • verify email
  • refresh jwt token

What is not covering cognito defender

  1. MFA Setup: because the library used behind the scenes AWS Cognito really is made to be used on frontend side, then AWS Cognito require some interactions with the user to enable MFA which is not a good fit for API/Backend technologies.

How to use

  • Install it:
npm i cognito defender # or yarn add cognito-defender
  • Use it
import { CognitoDefender } from "cognito.defender";

const cognitoDefender = new CognitoDefender({
    regionCognitoPool: 'your-region',
    cognitoUserPoolId: 'pool-id',
    cognitoClientId: 'client-id',
});

const userCreated = await cognitoDefender.login({
  email: 'youremail@example.com',
  password: 'super-secret',
});
TODO
  • Allow to override payloads.
  • Allow wrap Attributes
  • Methods documentation
  • improvements