connect-crew

Connect/Express middleware to validate if a user belongs to a group. Works nicely with passport.

Install

$ npm install --save connect-crew

Requirements

• Connect or Express
• Node.js 4+
• An authentication middleware like passport

Usage

By default, connect-crew assumes your authentication middleware returns req.user.groups as an Array. Check path option if you need to change it.

Single request

const express = require('express';)
const crew = require('connect-crew');
const passport = require('passport');

app.use(passport.authenticate('local'));

app.get('/maria-hill',
	crew('staff'),
	(req, res, next) => res.json({ result: true })
);

app.get('/black-widow',
	crew(['avenger', 'staff']),
	(req, res, next) => res.json({ result: true })
);

All requests

const express = require('express';)
const crew = require('connect-crew');
const passport = require('passport');

app.use(passport.authenticate('local'))
app.use(crew('staff'));

API

crew(input, [options])

input

Type: string or array

Groups to validate.

options

path

Type: string
Default: user.groups

Groups array path inside req object.

error

Type: object
Default: { code: 401, message: 'Unauthorized'}

Error message when user doesn't belong to a group.

Set default options

crew.options({
	path: 'member.crew',
	error: {
		code: 401,
		message: 'You are not welcome'
	}
});

Develop

Inside the project folder:

npm i
npm start

License

MIT © Chef's Plate