@ministryofjustice/fb-jwt-client-node

Form Builder JSON Web Token Client (Node)

This package will not receive ongoing development
Last updated 5 months ago by form-builder-team .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @ministryofjustice/fb-jwt-client-node 
SYNC missed versions from official npm registry.

Form Builder JSON Web Token client (Node)

Base client for making requests to Form Builder platform endpoints that require JSON Web Tokens for authenctication

Requirements

Node

Installation

npm install @ministryofjustice/fb-jwt-client-node

Usage

Loading and initialising basic client

// load client class
const FBJWTClient = require('@ministryofjustice/fb-jwt-client-node')

// initialise client
const jwtClient = new FBJWTClient(serviceSecret, serviceToken, serviceSlug, microserviceUrl, [errorClass])

serviceSecret

Constructor will throw an error if no service secret is passed

serviceToken

Constructor will throw an error if no service token is passed

serviceSlug

Constructor will throw an error if no service slug is passed

microserviceUrl

Constructor will throw an error if no service url is passed

errorClass

By default, uses FBJWTClientError

Extending

// extend base class
class FBMyClient extends FBJWTClient {
  constructor (serviceSecret, serviceToken, serviceSlug, microserviceUrl, myVar) {
    super(serviceSecret, serviceToken, serviceSlug, microserviceUrl)
    // do something with additional constructor argument
    this.myVar = myVar
  }
}

const myClient = new FBMyClient('service_secret', 'service_token', 'myservice', 'http://myservice', 'my var')
// extend base class with custom error
class FBAnotherClient extends FBJWTClient {
  constructor (serviceSecret, serviceToken, serviceSlug, microserviceUrl) {
    // create custom error class
    class FBAnotherClientError extends FBJWTClient.prototype.ErrorClass {}
    super(serviceSecret, serviceToken, serviceSlug, microserviceUrl, FBAnotherClientError)
  }
}

Methods

  • generateAccessToken

    Generate JWT access token

  • createEndpointUrl

    Return user-specific endpoint

  • sendGet

    Handle client get requests

  • sendPost

    Handle client post requests

  • encrypt

    Encrypt data with AES 256

  • decrypt

    Decrypt data

  • encryptUserIdAndToken

    Encrypt user ID and token using service secret

  • decryptUserIdAndToken

    Decrypt user ID and token using service secret

  • handleRequestError

    Handle client response errors

  • createRequestOptions

    Create request options

  • throwRequestError

    Convenience function for throwing errors

Further details

See documentation in code for further details and fb-user-datastore-client-node and fb-submitter-client-node for examples.

Current Tags

  • 0.0.35                                ...           latest (5 months ago)

39 Versions

  • 0.0.35 [deprecated]           ...           5 months ago
  • 0.0.34 [deprecated]           ...           6 months ago
  • 0.0.33 [deprecated]           ...           6 months ago
  • 0.0.30 [deprecated]           ...           6 months ago
  • 0.0.29 [deprecated]           ...           6 months ago
  • 0.0.28 [deprecated]           ...           7 months ago
  • 0.0.27 [deprecated]           ...           a year ago
  • 0.0.26 [deprecated]           ...           a year ago
  • 0.0.25 [deprecated]           ...           a year ago
  • 0.0.23-c                                ...           a year ago
  • 0.0.23-b                                ...           a year ago
  • 0.0.23-a                                ...           a year ago
  • 0.0.23-3                                ...           a year ago
  • 0.0.23-2                                ...           a year ago
  • 0.0.23-1                                ...           a year ago
  • 0.0.24 [deprecated]           ...           a year ago
  • 0.0.23 [deprecated]           ...           a year ago
  • 0.0.22 [deprecated]           ...           a year ago
  • 0.0.21-delta                                ...           a year ago
  • 0.0.21-gamma                                ...           a year ago
  • 0.0.21-beta                                ...           a year ago
  • 0.0.21-alpha                                ...           a year ago
  • 0.0.20 [deprecated]           ...           a year ago
  • 0.0.19 [deprecated]           ...           a year ago
  • 0.0.18 [deprecated]           ...           a year ago
  • 0.0.17 [deprecated]           ...           a year ago
  • 0.0.16 [deprecated]           ...           a year ago
  • 0.0.15-alpha                                ...           a year ago
  • 0.0.15 [deprecated]           ...           a year ago
  • 0.0.14 [deprecated]           ...           a year ago
  • 0.0.13 [deprecated]           ...           a year ago
  • 0.0.12 [deprecated]           ...           a year ago
  • 0.0.11 [deprecated]           ...           a year ago
  • 0.0.10-alpha                                ...           a year ago
  • 0.0.9-alpha                                ...           2 years ago
  • 0.0.8-alpha                                ...           2 years ago
  • 0.0.7-alpha                                ...           2 years ago
  • 0.0.6-alpha                                ...           2 years ago
  • 0.0.5-alpha                                ...           2 years ago

Copyright 2014 - 2016 © taobao.org |