express-authen

Auto redirect to login page middleware for Expressjs. The main features:

1. Auto redirect to login page when access the required-logged-in page
2. Save the referer into session before redirect to login page

Installation

$ npm install express-authen

If you want to save this module into the package.json, simply use:

$ npm install --save express-authen

API

This middleware uses session to check wherether user logged-in or not, and save the referer before redirecting to login page. So, you should declare it after declaring the session middleware.

Example for v2.x.x

var authen = require('express-authen')
app.use(authen({
    'user': {
        'member':{
            'login':'/',
            'logout':'/customers/logout',
            'home':'/customers/dashboard'
        },
        'admin':{
            'login':'/admin/login',
            'logout':'/admin/logout',
            'home':'/admin/home'
        }
    },
    'default_page':'/',
    'auto_refer':true,
    'referer': 'referer',
    'excepts':['/api/list/members', '/api/add/members']
}))

authen 2.x.x (options)

options is an object for config middleware. options includes:

No | Property | Default value | Description | --- | --- | --- | --- | 1 | user | {} | Object with keys to user identity which represent the session name to validate | 2 | default_page | / | neutral page or homepage of the app that maybe not require any authentication | 3 | excepts | [] | an array - non-required auth page | 4 | auto_refer | boolean | (Optional) true or false to redirect or resume to refered page on login 5 | referer | referer | session' key for save the referer page |

Example for v1.x.x

var authen = require('express-authen')
app.use(authen({
    'login': '/',
    'home': '/home',
    'user': 'user',
    'referer': 'referer',
}))

authen 1.x.x (options)

options is an object for config middleware. options includes:

No | Property | Default value | Description | --- | --- | --- | --- | 1 | login | /login | login page path | 2 | home | / | default redirected page after logged-in | 3 | excepts | [] | an array - non-required auth page | 4 | user | user | session' key for determine wherether user logged-in | 5 | referer | referer | session' key for save the referer page |

License

MIT