hapi-hazelcast-session v1.0.0

hapi-hazelcast-session

Server-side session for hapi, stored in Hazelcast cache server. Based on hapi-server-session.

Install

$ npm install hapi-hazelcast-session

Example

'use strict';

const hapi = require('hapi');

const main = async () => {
  const server = new hapi.Server({
    host: 'localhost',
    address: '127.0.0.1',
    port: 8000,
  });

  await server.register({
    plugin: require('hazelcast-server-session'),
    options: {
      host: '127.0.0.1',
      login: 'cluster_login',
      password: 'cluster_password',
      cookie: {
        isSecure: false, // never set to false in production
      },
    },
  });

  server.route({
    method: 'GET',
    path: '/',
    handler: (request, h) => {
      request.session.views = request.session.views + 1 || 1;
      return 'Views: ' + request.session.views;
    },
  });

  await server.start();
};

main().catch(console.error);

Options

  host: '127.0.0.1',
  login: 'cluster_login',
  password: 'cluster_password',

• host: Default: '127.0.0.1' host of the Hazelcast server
• login: Default: '' group name of the Hazelcast server

• password: Default: '' password of the Hazelcast server

• algorithm: Default: 'sha256' algorithm to use during signing

• cache: supports the same options as server.cache(options)
  • expiresIn: Default: session expiresIn if set or 2147483647 session cache expiration in milliseconds
  • segment: Default: 'session' session cache segment
• cookie: supports the same options as server.state(name, [options])
  • isSameSite: Default: 'Lax' sets the SameSite flag
  • path: Default: '/' sets the Path flag
  • ttl: Default: session expiresIn if set sets the Expires and Max-Age flags
• expiresIn: session expiration in milliseconds
• name: Default: 'id' name of the cookie
• key: signing key. Prevents weaknesses in randomness from affecting overall security
• size: Default: 16 number of random bytes in the session id