@blinkmobile/bm-identity

bm-identity.js

Provides easy management of authenication for our CLI via a single identity.

Getting Started

npm install @blinkmobile/bm-identity --save

const pkg = require('./package.json');
const BlinkMobileIdentity = require('@blinkmobile/bm-identity');
const blinkMobileIdentity = new BlinkMobileIdentity(pkg.name);

Usage

Login

If no LoginOptions are passed, a browser based login process will start. This is how users can login using a social account e.g. Google.

login (options: LoginOptions) => Promise{String}

interface LoginOptions {
  username? : String|Boolean, // Can also pass true, and username will be prompted for
  password? : String, // Will be prompted for password if username is truthy
  storeJwt? : Boolean, // Set to true to store jwt on local file system, defaults to false
  refreshToken? : Boolean, // Set to true will request a refresh token as well as an access token
}

blinkMobileIdentity.login()
  .then(jwt => {
    // Use jwt access token.
  });

storeJwt Option

• If set to true, will use @blinkmobile/blinkmrc User Config to store on local file system for later use.

Logout

logout () => Promise

blinkMobileIdentity.logout();

Assume AWS Role

assumeAWSRole (additionalParameters: Object) => Promise{AssumedRoleCredentials}

interface AssumedRoleCredentials {
  accessKeyId : String,
  secretAccessKey : String,
  sessionToken : String
}

blinkMobileIdentity.assumeAWSRole()
  .then(credentials => {
    // Use AWS credentials
  });

Get Access Token

To create an AccessToken using BlinkM Deployment Keys or retrieve the AccessToken stored after a successful login:

Using Deployment Keys

If the following environment variables are set:

• BLINKM_ACCESS_KEY
• BLINKM_SECRET_KEY

These will be used to create an AccessToken

getAccessToken () => Promise{string}

blinkMobileIdentity.getAccessToken()
  .then(jwt => {
    // Use access token
  });

Get Access Token Payload

Helper function to get the payload for a JWT

getPayload () => Promise{Object}

blinkMobileIdentity.getPayload()
  .then(payload => {
    // Use payload
  });

Manage Tenants

Get and set the current tenant. Also get and remove list of previously used tenants.

getTenants () => Promise{Tenants}

setTenant (tenantName: String) => Promise{Tenants}

removeTenant (tenantName: String) => Promise{Tenants}

interface Tenants {
  current : String,
  previous : Array{String}
}

blinkMobileIdentity.getTenants()
  .then(tenants => {
    // Use tenants
  });

blinkMobileIdentity.setTenant('TenantName')
  .then(tenants => {
    // Tenant was set
  });

blinkMobileIdentity.removeTenant('TenantName')
  .then(tenants => {
    // Tenant was removed
  });

Changelog

4.0.2 - 2018-07-20

Dependencies

• update @blinkmobile/blinkmrc to 2.0.0 (from 1.1.0)

• update inquirer to 5.1.0 (from 5.0.1)