Integrating Cognito and Phoenix 1.3, using AWS clients, for Elixir
The following functionality is covered;
- User registration
- Confirm registration (with the confirmation code received from AWS, by email)
- User login
- Accessing a secured page if logged in
- Resetting a forgotten password (not yet, sorry)
- Logout
Integration is a tad tricky, given the verbosity of the API. Below is a simplified sequence diagram illustrating the user registration
Pull the project from Gitlab
$ git clone git@gitlab.com:azohra/cognito-phx.git
$ cd cognito-phx
First we will set up a new AWS Cognito user pool with the correct configuration.
- Visit your AWS console and go to the AWS Cognito service. Click on "Manage your User Pools" and click "Create a User Pool".
- Specify a name for your pool and click "Review Defaults".
- Optional: edit the password policy to remove some of the requirements. If you are just testing, using simple passwords will make it easier.
- Click the "edit client" link. Specify a name for your app and be sure to disable the client secret and enable the
ADMIN_NO_SRP_AUTH
option. - Click "Create pool". Take note of the Pool Id at the top of the page and click on the apps page. Here, take note of the App client id.
For this demo to run, you also must define some local system variables:
export AWS_ACCESS_KEY_ID="xxx"
export AWS_SECRET_ACCESS_KEY="xxxx"
export AWS_REGION="xxxxxx"
export AWS_AZOHRA_CLIENT_ID="xxx"
export AWS_AZOHRA_USER_POOL_ID="xxxx"
Now you can start the Phoenix app.
- Install dependencies with
mix deps.get
- Install Node.js dependencies with
cd assets && npm install
- Start Phoenix endpoint with
mix phx.server
Now you can visit localhost:4000
from your browser.
HTH!
Florin
- Official Cognito API reference: