This package has been deprecated

Author message:

resin-auth is deprecated, please use balena-auth instead

resin-auth

resin-auth

Join our online chat at

Resin.io session authentication utilities

Role

The intention of this module is to provide low level access to how a Resin.io authentication tokens are parsed and persisted.

THIS MODULE IS LOW LEVEL AND IS NOT MEANT TO BE USED BY END USERS DIRECTLY.

Unless you know what you're doing, use the Resin SDK instead.

Installation

Install resin-auth by running:

$ npm install --save resin-auth

Documentation

The module returns a class that you use to get an instance of the auth module.

It accepts the following params:

Param	Type	Description
options	Object	options
options.dataDirectory	string	the directory to use for storage in Node.js. Ignored in the browser.
options.tokenKey	string	the key used to store the last token in the storage. token by default.

Example

import ResinAuth from 'resin-auth';
const auth = new ResinAuth({
	dataDirectory: '/opt/cache/resin',
	tokenKey: 'token'
});

• auth
  • ~setKey(key) ⇒ Promise.<void>
  • ~hasKey() ⇒ Promise.<Boolean>
  • ~removeKey() ⇒ Promise
  • ~getType() ⇒ Promise.<TokenType>
  • ~getKey() ⇒ Promise.<string>
  • ~getAge() ⇒ Promise.<(number|undefined)>
  • ~isExpired() ⇒ Promise.<boolean>
  • ~isValid() ⇒ Promise.<boolean>
  • ~needs2FA() ⇒ Promise.<boolean>

auth~setKey(key) ⇒ Promise.<void>

Kind: inner method of auth
Summary: Set the key
Access: public

Param	Type
key	String

Example

auth.setKey('...').then(() => { ... });

auth~hasKey() ⇒ Promise.<Boolean>

Kind: inner method of auth
Summary: Has a key
Returns: Promise.<Boolean> - has key
Access: public
Example

auth.hasKey().then((hasKey) => { ... });

auth~removeKey() ⇒ Promise

This promise is not rejected if there was no key at the time of removal.

Kind: inner method of auth
Summary: Remove the key
Access: public
Example

auth.removeKey();

auth~getType() ⇒ Promise.<TokenType>

Kind: inner method of auth
Summary: Gets the key type
Access: public
Example

auth.getType().then((type) => { ... });

auth~getKey() ⇒ Promise.<string>

Kind: inner method of auth
Summary: Gets the key
Access: public
Example

auth.getKey().then((key) => { ... });

auth~getAge() ⇒ Promise.<(number|undefined)>

Kind: inner method of auth
Summary: Gets the token age
Access: public
Example

auth.getAge().then((age) => { ... });

auth~isExpired() ⇒ Promise.<boolean>

Kind: inner method of auth
Summary: Checks if token is expired
Access: public
Example

auth.isExpired().then((expired) => { ... });

auth~isValid() ⇒ Promise.<boolean>

Kind: inner method of auth
Summary: Checks if token format is valid
Access: public
Example

auth.isValid().then((valid) => { ... });

auth~needs2FA() ⇒ Promise.<boolean>

Kind: inner method of auth
Summary: Checks whether 2FA is needed
Access: public
Example

auth.needs2FA().then((needs2FA) => { ... });

Support

If you're having any problem, please raise an issue on GitHub and the Resin.io team will be happy to help.

Tests

Run the test suite by doing:

$ npm test

Contribute

• Issue Tracker: github.com/resin-io-modules/resin-auth/issues
• Source Code: github.com/resin-io-modules/resin-auth

Before submitting a PR, please make sure that you include tests, and that tslint runs without any warning:

$ npm run lint

License

The project is licensed under the Apache 2.0 license.