Introduction

The Platform SDK is a JavaScript client SDK that lets you quickly integrate easy and secure identity experiences into your web application. It offers risk detection and response, biometric WebAuthn authentication, identity orchestration, and more to come.

The entry point to the SDK API is set as the window.tsPlatform property.

Modules

The SDK is comprised of different modules. Modules are currently available for the following services:

• Detection and Response
• Identity Orchestration
• Identity Verification
• WebAuthn

Versioning

The Platform SDK is versioned according to the semantic versioning standard where X.Y.Z. corresponds to Major.Minor.Patch. The SDK version can be specified as:

• Specific version, such as 1.6.20
• Version range, such as 1.x or 1.6.x
• Latest

For more information on versioning, see Versioning and Changelog.

Installation

To load the SDK, include the following HTML script tag in all the relevant pages of your front-end web application:

<!-- This loads the latest SDK within the major version 1. Specify a different version if necessary -->
<script src="https://platform-websdk.transmitsecurity.io/platform-websdk/1.x/ts-platform-websdk.js" defer="true" id="ts-platform-script"></script>

Then add the code below to wait for the SDK loading event:

document.getElementById('ts-platform-script').addEventListener('load', () => {
  // do here things with `tsPlatform`
});

Initialization

Configure the SDK globally for all the modules by calling the initialize() SDK method, as in the example below.

// Configures the SDK with your client.
tsPlatform.initialize({ clientId: [CLIENT_ID] });

For example:

// Configures the SDK with your client ID from Step 1 and initial verification params
window.tsPlatform.initialize({ clientId: [CLIENT_ID],
drs: {
  serverPath: "https://api.eu.transmitsecurity.io/risk-collect/"
},
ido: {
  serverPath: 'https://api.eu.transmitsecurity.io/ido'
}});