connect-s3store

connect-s3store
===============

Use S3 as a node.js Connect session store.

$3

Use like any other Connect session store.

var connect = require('connect');
var S3Store = require('connect-s3store')(connect);
var store = new S3Store({
// Bucket to be used for sessions.
bucket: 'myappsessions',
// AWS key.
awsKey: 'xxxxxxxxxxxxxxxxxxxx',
// AWS secret.
awsSecret: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
// Optional. Prefix to apply to all session objects.
prefix: '/sessions/',
// Optional. Throttle trivial session writes in ms. Defaults to 60000ms.
throttle: 20000
});
var server = connect.createServer();
server.use(connect.session({secret: 'YourSecretKey', store: store });

$3

You may want to set a lifecycle configuration on your bucket to expire session objects to clean up expired sessions from your store.

$3

Tests are written to work with mocha. They expect the following environment variables to be set in order to make real requests against S3:

S3STORE_KEY=xxxxxxxxxxxxxxxxxxxx
S3STORE_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
S3STORE_BUCKET=xxxxxxxxxxxxxxx

You can run the tests in this fashion in order to avoid setting or exporting these shell variables globally:

S3STORE_KEY=xxxxxxxxxxxxxxxxxxxx S3STORE_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx S3STORE_BUCKET=xxxxxxxxxxxxxxx mocha