mirror of https://github.com/hasura/graphql-engine.git synced 2024-12-14 17:02:49 +03:00

History

Samir Talwar d9afcc1857 Upgrade all package-lock.json files to the v2 format. NPM v7 uses a new (backwards-compatible) lockfile format. This upgrades all our various _package-lock.json_ files to use the new format. It's much more verbose so that NPM can be a lot faster. I figured it was cleaner to do this once in a separate PR rather than upgrading them in combination with adding or upgrading a new dependency. PR-URL: https://github.com/hasura/graphql-engine-mono/pull/5869 GitOrigin-RevId: 322fb63b96e2d873a4a3cc05fa6c7afa414716ce		2022-09-28 08:15:29 +00:00
..
config	add passport-js auth webhook boilerplate (#528 )	2018-09-26 17:57:59 +05:30
controllers	add passport-js auth webhook boilerplate (#528 )	2018-09-26 17:57:59 +05:30
db	add passport-js auth webhook boilerplate (#528 )	2018-09-26 17:57:59 +05:30
.gitignore	add passport-js auth webhook boilerplate (#528 )	2018-09-26 17:57:59 +05:30
app.js	add passport-js auth webhook boilerplate (#528 )	2018-09-26 17:57:59 +05:30
knexfile.js	add passport-js auth webhook boilerplate (#528 )	2018-09-26 17:57:59 +05:30
package-lock.json	Upgrade all package-lock.json files to the v2 format.	2022-09-28 08:15:29 +00:00
package.json	add passport-js auth webhook boilerplate (#528 )	2018-09-26 17:57:59 +05:30
Procfile	add passport-js auth webhook boilerplate (#528 )	2018-09-26 17:57:59 +05:30
README.md	update docs link to avoid redirects	2021-03-01 18:51:18 +00:00

README.md

Passport.js Auth Webhook Boilerplate

This is a sample auth webhook for authenticating requests to the Hasura GraphQL Engine. This boilerplate also exposes login and signup endpoints.

Prerequisites

PostgreSQL
Node.js 8.9+

Getting Started

Deploy locally

# Clone the repo
git clone https://github.com/hasura/graphql-engine

# Change directory
cd graphql-engine/community/boilerplates/auth-webhooks/passport-js

# Install NPM dependencies
npm install

# Set DATABASE_URL env
export DATABASE_URL=postgres://<username>:<password>@<host>:<port>/<database_name>

# Apply migrations
# (Note) this step creates a "users" table in the database
knex migrate:latest

# Then simply start your app
npm start

Deploy with Heroku

 # Create heroku app
 heroku create <app-name>

 # Create PostgreSQL addon
 heroku addons:create heroku-postgresql:hobby-dev -a <app-name>

 # Add git remote
 git remote add heroku https://git.heroku.com/<app-name>.git

 # Push changes to heroku
 # Note: You need to run this command from the toplevel of the working tree (graphql-engine)
 git subtree push --prefix community/boilerplates/auth-webhooks/passport-js heroku master

 # Apply migrations
# (Note) this step creates a "users" table in the database
 heroku run knex migrate:latest

Usage

Signup/Login

Once deployed or started locally, we can create an user using /signup API like below:

curl -H "Content-Type: application/json" \
     -d'{"username": "test123", "password": "test123", "confirmPassword": "test123"}' \
     http://localhost:8080/signup

On success, we get the response:

{
  "id": 1,
  "username": "test123",
  "token": "4ffd5ee92853787836325dcea74c02e4"
}

We can also use /login API to fetch the user token,

curl -H "Content-Type: application/json" \
     -d'{"username": "test123", "password": "test123"}' \
     http://localhost:8080/login

Webhook for GraphQL Engine

Auth webhook that can be configured with Hasura GraphQl Engine is available at /webhook. It accepts Authorization header to validate the token against an user.

The client just need to add Authorization: Bearer <token> to the request sending to GraphQL Engine.

The endpoint (say http://localhost:8080/webhook) can be given as an environment variable HASURA_GRAPHQL_AUTH_HOOK to GraphQL Engine.