Cognito MFA Package

This SDK is a wrapper for adding Biopass Multifactor authentications to applications which had their users in AWS Cognito.

Getting Started

Install the package

  npm install @locii/biopass-cognito-sdk

Require the package

To import @locii/biopass-cognito-sdk, run the following command

import { BiopassAuth } from "@locii/biopass-cognito-sdk";

After installing the packege, do the following steps:

Step 1: Create config file

export const config = {
  ClientId: '',
  UserPoolId: '',
  ClientMetadata: { redirectURI: 'http://localhost:3000/login' },
  Auth: {
    region: '',
    userPoolId: '',
    userPoolWebClientId: '',
    authenticationFlowType: 'CUSTOM_AUTH'
  }
};

ClientId: Biopass Client ID

UserPoolId: Cognito user pool ID

redirectURI: The user is redirected to this address after authentication. Please make sure this is exactly same as the Allowed Callback URL setting in Biopass application.

userPoolWebClientId: Cognito Client ID

Step 2:

import { Amplify } from 'aws-amplify';
import config from './amplify-config';
Amplify.configure(config);

Use React App

When signing in with user name and password, you will pass in the username and the password to the signin method of the Auth class.

Sign-In

import { BiopassAuth } from "@locii/biopass-cognito-sdk";

const login = async (event) => {
      BiopassAuth.signin(username, password, config.ClientMetadata)
        .then((res) => {
          // add your code
        })
        .catch((err) => // add your code);
  };

  useEffect(() => {
    BiopassAuth.resumeSignIn()
      .then((user) => {
       // add your code
      })
      .catch((err) => {
       // add your code
      });

  }, []);

Sign-Out

import { Auth } from 'aws-amplify';

async function signOut() {
    try {
        await Auth.signOut();
    } catch (error) {
        console.log('error signing out: ', error);
    }
}

Use Angular App

When signing in with user name and password, you will pass in the username and the password to the signin method of the Auth class.

Global config

Add a below command in Ployfills.ts

(window as any).global = window;

Sign-In

import { BiopassAuth } from "@locii/biopass-cognito-sdk";

  ngOnInit() {
    your code ...
    BiopassAuth.resumeSignIn()
      .then((user) => {
        console.log('userr', user);
        // add your code
      })
      .catch((err) => {
        // add your code
      });
  }

  login() {
      BiopassAuth.signin(this.username.value, this.password.value, configClientMetadata)
        .then((res) => {
          // add your code
        })
        .catch((err) => // add your code);
  }

Sign-Out

import { Auth } from 'aws-amplify';

  logout() {
    try {
      Auth.signOut();
    } catch (error) {
      console.log('error signing out: ', error);
    }
  }

Use Vue App

When signing in with user name and password, you will pass in the username and the password to the signin method of the Auth class.

Global config

Add a below command in App.vue

var global = window

Sign-In

import { BiopassAuth } from "@locii/biopass-cognito-sdk";

  created() {
    BiopassAuth.resumeSignIn()
      .then((user) => {
        // add your code
      })
      .catch((err) => {
        // add your code
      })
  },
  methods: {

    login() {
      //add your code

        BiopassAuth.signin(this.username, this.password, config.ClientMetadata)
          .then((res) => {
            // add your code
          })
          .catch((err) => console.log('asasasas'))
    }
  }

Sign-Out

import { Auth } from 'aws-amplify';

  logout() {
    try {
      Auth.signOut();
    } catch (error) {
      console.log('error signing out: ', error);
    }
  }