turall

Library to just create token authentication in expressJs faster. This is inspired by my personal needs to not have to write the same routes and models every time for a new project.

Usage

Installation is as simple as

npm install --save turall

You can startoff by writing simple express application as follows

var express    = require('express');
var mongoose   = require('mongoose');
var bodyParser = require('body-parser');
var turall     = require('turall');

var app = express();
// You can write code to connect to mongoose here

// This is needed to encode the jwt token
app.set("secret",<Super secret>);

// This will handle auto decoding of tokens
app.use(turall.authMiddleware);

// Define all routes for authentication
app.use("/auth",turall.routes);

// Finally create protected resource
app.get('/',turall.protect,function(req,res,next){
  // req.user contains info about logged in user
  res.json(req.user);
});

Creating a new user

You can create new user by posting email and password to /auth route from the example above. Response code is 200 for valid and 400 for invalid data.

Authenticating user

For authentication simply post to /auth/authenticate in the example above. You will get a valid json with token as key if the credentials are a match.

Roadmap

This is the first release and there is a lot of room for improvements. The following are the stuff i would like to work on in near future on this Library

• [ ] Add integration for custom models
• [ ] Add user mail validation
• [ ] Add sudo capabilities
• [ ] Better middleware