auth0/node-guardian

Name: node-guardian

Owner: Auth0

Description: Node.js Guardian Management client

Created: 2016-07-14 22:46:05.0

Updated: 2018-01-05 20:31:16.0

Pushed: 2018-01-05 20:31:15.0

Homepage: null

Size: 23

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

DEPRECATED

This library has been deprecated, and is no longer supported.

Please consider using Auth0 Management API instead.

Guardian Management Client

Client for Guardian Management based on API2

This is an small wrapper arround API2 that help you use the Guardian api.

API

OAuth 2.0 authorization framework (recomended)

.configure({ client: { tenant, region, clientId, clientSecret, domain, [baseUrl] } }):Client

Configures the client and returns a configured instance that will use OAuth2 against domain to request the authorization token for Auth0 Management API, Auth0 Management API must be properly configured to support this flow. More info

Example

nst client = require('guardian-management-client').configure({
tenant: 'mytenant',
region: 'eu' // Valid: eu | us | au,
clientId: // Client ID for a client with access to Auth0 Management API,
clientSecret: // Client secret for the Client ID Provided,
domain: '', // Will be used to get the token and (optionally call api2)
baseUrl: '', // Base url for API2, if not provided will be built as `https://{domain}/api/v2`
;

Direct token based auth

.configure({ client: { tenant, region, token } }):Client

Configures the client and returns a configured instance

Example

nst client = require('guardian-management-client').configure({
tenant: 'mytenant',
region: 'eu' // Valid: eu | us | au,
token: // AUTH0 API2 TOKEN
;

Enrollments

client.enrollment.create(enrollmentId, [enrollmentData]):Enrollment

Creates an instance of an enrollment

Example

nst enrollment = client.enrollment.create('dev_1234');

enrollment.fetch(): Promise

Fetchs data of an enrollment

enrollment.attrs(): Object

Retrieve fetched / modified data

enrollment.changed

Not yet applied changes

enrollment.data

Fetched / built data without the changes

enrollment.del(): Promise

Deletes an enrollment

Example

llment.fetch()
hen((enrollment) => {
const attrs = enrollment.attrs(); // Enrollment attributes (name, id, phone_number, etc)

return enrollment.del()

hen(function() {
// Enrollment has been deleted

Factors

client.factor.create(factorName, [factorData]):Factor

Creates an instance of a factor

Example

nst factor = client.factor.create('sms');

client.factor.getAll():Promise.<array.<Factor>>

Retrieves all factors from server

ient.factor.getAll().then((factors) => {
const factor1 = factors[0];
const factor2 = factors[1];
//...
;

factor.enable()

Marks a factor as enabled, changes won't be applied until you call .update()

factor.disable()

Marks a factor as disabled, changes won't be applied until you call .update()

factor.attrs(): Object

Retrieve fetched / modified data

factor.changed

Not yet applied changes

factor.data

Fetched / built data without the changes

factor.update(): Promise

Apply changes

Example

ient.factor.getAll().then((factors) => {
return factors[0].enable().update();

hen(() => {
// Factor has been enabled
;

Factor Providers

client.factorProvider.create({ factor: string, provider: string }, [factorProviderData]):FactorProvider

Creates an instance of a factor provider

Example

nst factorProvider = client.factor.create({ factor: 'sms', provider: 'twilio' });

factorProvider.set({ ... data })

Modify factor provider data, changes won't be applied until you call .update()

factorProvider.attrs(): Object

Retrieve fetched / modified data

factorProvider.changed

Not yet applied changes

factorProvider.data

Fetched / built data without the changes

factorProvider.update(): Promise

Apply changes

Example

nst fp = client.factorProvider.create({ factor: 'sms', provider: 'twilio' });

.set({ sid: '', ... });
.update().then(() => {
...
;

Users

client.user.create({ factor: string, provider: string }, [userData]):User

Creates an instance of a factor provider

Example

nst user = client.user.create('auth0|1234');

user.enableMFA()

Shortcut method, adds user_metadata.use_mfa = false to the user. This wont be applied until you call update.

user.disableMFA(): Object

Shortcut method, adds user_metadata.use_mfa = true to the user. This wont be applied until you call update.