seneca-jwt v2.0.2

seneca-jwt

This plugin provides a JSON Web Token API using jsonwebtoken.

Install

Install via npm. You will need install Seneca.js also.

npm install seneca-jwt

Setup

var seneca = require('seneca')();
seneca.use('jwt');

options

• key: (string) a shared key for signing and verifying (required if publicKey and privateKey not provided)
• privateKey: (buffer) a key file (required if key not provided)
• publicKey: (buffer) a key file (required if key not provided)
• algorithm: (string, default 'RS256') the algorithm used with privateKey and publicKey

var seneca = require('seneca')();

// Use a shared key string
seneca.use('jwt', {
  key: 'superPassword'
});

// Use public and private keys
seneca.use('jwt', {
  privateKey: fs.readFileSync(path.join(__dirname, '/keys/jwt')),
  publicKey: fs.readFileSync(path.join(__dirname, '/keys/jwt.pub'))
});

Provided actions

seneca-jwt provide the following actions. (all including the {role: "jwt"})

generateKey - generate a new key

• arguments : none
• result: {key: "<generated-key>"}

sign - create a token with given payload

• arguments: payload, key, algorithm
key and algorithm can be provided in the seneca message, otherwise they are inferred from options.
• result: {token: "<generated-token>"}

verify - Check token validity

• arguments: token, key, algorithm
key and algorithm can be provided in the seneca message, otherwise they are inferred from options.
• result: callback called with an error if not valid

decode - Extract content of token without verifying

• arguments: token
• result: content of token

Test

npm test