Getting Started

In this short guide, you will learn how to integrate the Keyless Web SDK in your web application, and enroll and authenticate users through the Keyless platform.

Before jumping into your code editor, make sure that you're familiar with the various components of the authentication system, and common biometric authentication flows.

Prerequisites

Make sure to read the following page:

Prerequisites

Keys

Make sure you have all the required keys.

• CLOUDSMITH_TOKEN to download the Web SDK from cloudsmith repository

• CUSTOMER_NAME to define the customer

• KEYLESS_AUTHENTICATION_SERVICE_URL to estabilish a connection

• IMAGE_ENCRYPTION_PUBLIC_KEY for the image encryption to work

• IMAGE_ENCRYPTION_KEY_ID for the image encryption to work

Installation

Package Manager

First of all you must authenticate with our cloudsmith repository, in the root of your project folder create a file called .npmrc and write this line inside:

@keyless:registry=https://npm.cloudsmith.io/keyless/partners/

Then with the token that was given to you by Keyless, launch this command on your terminal:

npm config set //npm.cloudsmith.io/keyless/partners/:_authToken=CLOUDSMITH_TOKEN

Now you’re all set to install our packages. Meaning that you can now successfully install @keyless/sdk-web by launching the following command on your terminal:

npm install @keyless/sdk-web@2.4.2

Of course you’re free to use a package manager of your choice. Installing the @keyless/sdk-web-components package is the same and can be done with:

npm install @keyless/sdk-web-components@2.4.2

CDN