connect-vtexid

VTEX ID Authentication middleware for Connect. Written in coffee-script

It automatticaly caches vtexid response and handles errors

Installation

$ npm install --save connect-vtexid

Usage

Use it as any other Connect middleware

var connect = require('connect')
var app = connect()
 
var FIVE_MINUTES = 5 * 60
 
var options = {
    ttl: FIVE_MINUTES
}
 
var connectVtexid = require('connect-vtexid')
middleware = connectVtexid(options)
 
app.use(middleware)

Can as well be used as a grunt-contrib-connect middleware

Options

verbose

Default: false

Enables logging

verbosityLevel

Default: 1

Controls the desired verbosity level. Available options:

• 0: quiet mode
• 1: low verbosity
• 2: medium verbosity
• 3: high verbosity

ttl

Default: 5 minutes

Value (in seconds) setting how long the cache will live

replaceWhiteList

Default: false

Overrides default route white-list with an array of strings or regexes Does not replace if values is false (default)

addToWhiteList

Default: []

Adds routes to current white-list. It can be a string, a regexp or an array containing either strings or regexes

redirectUrl

Default: /admin/login?ReturnUrl=

String to vtexid redirect page It is automatically added to the white-list

logoutUrl

Default: /admin/logout

String to logout route

useReturnUrl

Default: true

Set to false if you do not want to pass the request url as parameter to the redirectUrl

Custom libs

URI White list

white-list sets a white list containing every public URI. It receives a publicUris parameter that is an array containing all public uris. Each public uri must be either a String or a RegExp

Default:

• /admin/Content
• /admin/Scripts
• /meta/whoami
• /^/admin/Site/Login.aspx/

Redirect url

return-url sets the vtexid redirect url.

Cookie parser

cookie-parser is a custom lib-independent cookie-parsing function.

Redirect

redirect is a custom lib-independent client-side redirect function.

Http errors

http-errors is a custom function for rendering error pages: It receives the res object, a statusCode as parameter and an optional customErrorPagePath , and returns an errorRendering function.

The errorRendering function receives an error message body and the vtexid cookie as parameters