Sample Application

A sample application is included in the package. It includes examples for the following scenarios:

Type	On Page Load	On Event	IMEI Corroboration
Client to Server	✓	✓	✓
Server to Server	✓	✓	✓
QR Code	✓	✓	✓

The QR Code method also includes Redirect and Custom Scan URL examples. See Sample Application Pages for the full list.

A valid DeviceAssure licence key is required for the "Client to Server" examples as these will call the DeviceAssure API from the client.

To correctly identify an Android device or Desktop using the Chrome browser, or any browser that supports client-hints, data collection must occur over a secure context.

Running the Sample Application

Prerequisites

Node.js and npm installed on your machine (Node 22 or later is recommended)
A DeviceAssure licence key
(Optional) Docker installed on your machine

Setup

Unzip the package and navigate to the SampleApplication directory:

cd SampleApplication

Amend the env.js file to include your DeviceAssure licence key:

module.exports = {
  DEVICEASSURE_API_KEY: '<LICENCE_KEY>' // Replace with your DeviceAssure licence key
};

Install the required dependencies:

npm install

Start the web server:

npm start

The sample application will be available at http://localhost:8096 by default.

Running in Docker

Unzip the package and navigate to the SampleApplication directory:

cd SampleApplication

Add your DeviceAssure licence key in the env.js file as shown above.

Build the Docker image and run the container:

docker build -t deviceassure-sample-app .

docker run -p 8096:8096 --name deviceassure-sample-app deviceassure-sample-app