Hapi Register + Login Example (using) PostgreSQL
A login form using hapi-auth-register, hapi-auth-login & hapi-auth-jwt2 with a PostgreSQL DB
Why?
We did not find an end-to-end solution/tutorial
for login (using email & password) in Hapi.js apps,
so we wrote it.
By popular demand
this example focusses on PostgreSQL,
but it can easily be adapted to work with any backed/database.
If anything is unclear in this (or any of our other repos),
please tell us:
What?
This repo is a showcase for how to build a login flow using Hapi.js.
We use the following plugins:
Each one is hand-crafted, tested and maintained by us,
feel free to use the code how ever you see fit.
Note: If you have requests/suggestions for how to extend this example,
please let us know!
Highlights:
- ALL values inserted into the database are escaped using
pg-escape
(made by @TJ & Co ... so you know its good) - We use
Joifor validation - which
we display in the client UI. (see screenshots below)
Try it: https://hapi-login.herokuapp.com/
How?
The best way to get started is to run this example locally.
Please ensure you have PostgreSQL Installed and Running on your local machine
before you attempt to run this example.
see: https://wiki.postgresql.org/wiki/Detailed_installation_guides
1. Clone the repo:
git clone https://github.com/dwyl/hapi-login-example-postgres.git
cd hapi-login-example-postgres
2. Install Dependencies from NPM
npm install
3. Ensure you have the Required Environment Variables
create an .env file in your hapi-login-example-postgres directory.
add a line for your DATABASE_URL variable and one for JWT_SECRET:
e.g:
export DATABASE_URL=postgres://postgres:@localhost/test
export JWT_SECRET=https://git.io/vaN7A
default on mac is: export DATABASE_URL=postgres://postgres:@localhost/test
if you don't already have a database calledteston your system,
create it now by running this command in your psql/pgadmin:CREATE DATABASE test;
4. Run the Tests
npm test
Note: running npm test will first execute npm run create which creates
the necessary Database Tables to run the app. see:
/test/database_setup.sql
5. Run the Server
npm run dev
That's it.
Now, hack customise it to your heart's content!
Demo Screenshots
When you visit http://localhost:8000/ you will see a login form, you can login with any valid email address:
Make sure the email address is valid:
Your password needs to be more than 6 characters long:
We also use https://github.com/chriso/validator.js
to mitigate Cross Site Scripting
vulnerability:
Avoids Cross Site Scripting:
Want More?
If you would like to see this example expanded,
please either create an issue
with a specific request or