Identifo.js

Browser library for authentication through Identifo.

Install

# Run this command in your project root folder.
# yarn
$ yarn add @identifo/identifo-auth-js

# npm
$ npm install @identifo/identifo-auth-js

Usage

Initialize

  import IdentifoAuth from '@identifo/identifo-auth-js';

  const identifo = new IdentifoAuth({
    url: 'http://localhost:8081', // URI of your Identifo server.
    appId: 'your app ID', // ID of application that you want to get access to.
  });

Parametrs

All parameters can be considered optional unless otherwise stated. Option | Type | Description --- | --- | --- url | string (required) | The url of your Identifo server. appId | string (required) | ID of application that you want to get access to. issuer | string | The issuer claim identifies the principal that issued the JWT. scopes | string [] | The default scopes used for all authorization requests. redirectUri | string | The URL where Identifo will call back to with the result of a successful authentication. It must be added to the "Redirect URLs" in your Identifo Application's settings. postLogoutRedirectUri | string | The URL where Identifo will call back to after a successful log-out. It must be added to the "Redirect URLs" in your Identifo Application's settings. tokenManager| TokenManager instance | The tokenManager provides access to client storage for specific purposes autoRenew| boolean | Renew tokens before they expire. By default autoRenew is false.

API

init()

Method which initialize your identifo instance and actualize your states. Call it before other methods.

handleAuthentication():Promise

Processing the received token. Call it on the redirect page to handle and verify token.

renewSession():Promise

Allows you to renew session manually. Returns new JWT.

identifo.renewSession().then((token) => {})

signin()

Redirect user to sign-in page. After successful sign-in you will be redirected to redirectUri

signup()

Redirect user to sign-up page. After successful sign-up you will be redirected to redirectUri

logout()

Logout and redirects back to postLogoutRedirectUri the user out of their current Identifo session and clears all tokens stored locally in the TokenManager. By default, the refresh token (if any) and access token are revoked so they can no longer be used.

getToken()

Returns token and token payload

{ token: 'JWT', payload: 'JWT payload' }

TokenManager

import IdentifoAuth, { SessionStorageManager } from '@identifo/identifo-auth-js';

const identifo = new IdentifoAuth({
    appId: 'your app ID',
    url: 'http://localhost:8081',
    tokenManager: new SessionStorageManager() // you can pass your custom key for storage. Bt default it`s identifo_access_token
  })

You can import SessionStorageManager | LocalStorageManager. By default it`s LocalStorageManager.

isAuth:boolean

Returns actual auth statis of the user.

const isAuth = identifo.isAuth;

redirectUri

The url that is redirected to when using identifo.signin or identifo signup methods. This must be listed in your Identifo application's redirect URLs. If no redirectUri is provided, defaults to the current url (window.location.href).

postLogoutRedirectUri

The url that is redirected to when using identifo.logout method. This must be listed in your Identifo application's redirect URLs. If not specified, user will be redirected to login page.

Author

madappgang

License

This project is licensed under the MIT license. See the LICENSE file for more info.