react-serverless-auth

React Authentication Components using AWS Cognito

Installation

$ yarn add react-serverless-auth
or
$ npm install --save react-serverless-auth

Configuration

To simplify the integration with create-react-app the package uses environment variables as described in the create-react-app documentation. The environment variables are handled using dotenv by default.

Amazon Cognito User Pool

To use the react-serverless-auth components you need to create an Amazon Cognito User Pool from the AWS Console for Cognito User Pools or using the create-user-pool command in the AWS CLI.

IMPORTANT: When creating the App, the generate client secret box must be unchecked because the JavaScript SDK doesn't support apps that have a client secret.

The User Pool ID and Client ID are specified in the following environment variables:

REACT_APP_COGNITO_USER_POOL_ID
REACT_APP_COGNITO_CLIENT_ID

Authentication URLs

The authentication endpoint URLs are configurable and the following default values are pre-defined in src/routes.js:

REACT_APP_AUTH_LOGIN_URL=/auth/login
REACT_APP_AUTH_CONFIRM_URL=/auth/confirm
REACT_APP_AUTH_REGISTER_URL=/auth/register
REACT_APP_AUTH_RESET_URL=/auth/reset

Contributing

See CONTRIBUTING.md.

Technology Stack

• AWS SDK for JavaScript
• React
• Redux
• Redux-Saga
• Redux-Form

Dependencies

• amazon-cognito-identity-js
• reduce-reducers
• redux-form-validators
• redux-saga-routines