Web

The Authsignal Web SDK can be used to:

• Launch the pre-built UI to let users set up MFA and complete challenges
• Sign up and sign in users using passkeys

​

Installation

To install the Authsignal client as an npm package, run:

npm install @authsignal/browser

This will add our browser library module to your package.json.

Then you can initialize the Authsignal browser client in your code:

import { Authsignal } from "@authsignal/browser";

const authsignal = new Authsignal({
  tenantId: "YOUR_TENANT_ID",
  baseUrl: "YOUR_REGION_BASE_URL",
});

You can find your tenantId in the Authsignal Portal.

You must specify the correct baseUrl for your tenant’s region.

​

anonymousId

The anonymous ID of the user’s device. This can be used as the deviceId included in a track action call.

authsignal.anonymousId;

​

launch

launch lets you launch the pre-built UI.

authsignal.launch(url, options);

​

Usage

After you’ve made a server-side track call you’ll get back a url which you can pass to the Browser API’s launch function.

​

Arguments

​

Returns

​

Passkeys

For more information visit our passkeys documentation.

​

Registering a new passkey

const resultToken = await authsignal.passkey.signUp({ token, userName });

​

Authenticating with an existing passkey

const resultToken = await authsignal.passkey.signIn({ token });

​

Using passkey autofill

This feature requires rendering a text input with the attribute autocomplete="username webauthn":

<input type="text" id="username" autocomplete="username webauthn" />

Then when the page loads, you should initialize the input for passkey autofill by running the following code:

authsignal.passkey.signIn({ autofill: true }).then((resultToken) => {
  if (resultToken) {
    // The user has focused your text input and authenticated with an existing passkey
    // Send the token to your server to validate the result of the challenge
  }
});