README.md

TrustDevice-JS

A lightweight library for determining device uniqueness and risk identification.

Create a device identifier based on basic device information.

Will remain the same after uninstalling and reinstalling or clearing browser data.

🪧Attention🪧：The functions of the basic version of github are relatively limited.

You can visit AWS Marketplace or TrustDecision to learn about our professional version.

Open Source Demo

Browser support

• Internet Explorer 9+
• Edge 12+
• Chrome 33+
• Firefox 29+
• Desktop Safari 7.1+
• Mobile Safari 8+
• Android Browser 4.4+

Integration Description

<script>
    (function () {
      window._fmOpt = {
        success: function (result) {
          console.log('deviceId: ', result.deviceId)
        }
      }
      var fm = document.createElement('script');
      fm.type = 'text/javascript';
      fm.async = true;
      fm.src =
      './dist/fm.js?t='
      + (new Date().getTime()/3600000).toFixed(0);
      var s = document.getElementsByTagName('script')[0];
      s.parentNode.insertBefore(fm, s);
    })();
  </script>

Open Source Features

• Basic device ID, consistent when uninstalling applications and reinstalling.
• Basic equipment information, which can be used for simple data analysis.
• Basic risk identification ability

RiskLabel	Risk Description
disabledCookie	Cookies are set to disable.
debugger	The attacker or developer opens the browser developer tool for debugging.

Open Source VS Pro

Ability	Open Source	Pro
100%open source	yes	no
Device ID	Basic	Extremely stable
Device Risk Label	Basic	Extremely rich
Device Details	Basic	Extremely rich
IP Location	-	✓
Device Risk Score	-	✓
Environment Risk Evaluation	-	✓
Fraud Tools Detection	-	✓
Behavioral Activity Capturing	-	✓

Pro Introduction

TrustDecision TrustDevice has the leading device fingerprint technology, which has been integrated by more than 10000 global leading brands, protecting the entire customer journey.

There are 6 leading core features about TrustDevice Pro:

1. Wide Coverage

Comprehensive coverage of Android, iOS, Web, H5, applets and other device types.

2. Stable and Reliable

TrustDevice served more than 10,000 clients, 200 million+ daily active users , and 6 billion+ devices , with excellent product functions and stability. The fingerprint accuracy of different terminal devices exceeded 99.9%, and the output of risk labels exceeded 70 items.

3. Unparalleled Safety

TrustDevice's code virtualization & obfuscation technology make the malware fraudsters suffer from painful cost and imprecision when performing reverse-engineering.

4. Core Intellectual Property

Fully independent intellectual property rights, with a number of patented technology.

5. Security Compliance

TrustDevice is committed to the highest standards in security and compliance to keep your data safe. GDPR/CCA/PCI DSS/ISO 27701/ISO 9001 Compliant.

6. Easy to Deploy

SaaS（Software as a Service）deployment supported, reducing massively your integration cost and enabling rapid access to device fingerprint service.

Where to get support

We are happy to provide technical support for our open-source trustdevice-js library. We recommend using GitHub Issues to submit bugs or Discussions to ask questions. Using issues and discussions publicly will help the open-source community and other users with similar issues.

In addition, any idea or interest in using TrustDevice Pro can be found on the official website（ https://www.trustdecision.com/solutions/trustdevice ）, registered account, free trial; Or via email（ TrustDevice@TrustDecision.com ）, contact us directly and quickly open the service.

TrustDevice Pro VS Others

Type	Scene	Result	TrusDevice Pro	Fingerprint	Seon
Device Fingerprint Compatibility	IE9 and above	Able to collect device info and generate device ID	✅	❌ (not supported by IE)	❌ (IE10 and below are not supported)
Device fingerprint uniqueness	Access web application twice using browser on the same device	Device fingerprints/ID matches	✅	✅	✅
	Access web application using browser on two different devices	Device fingerprint/ID should not match. Each device to have its own unique device fingeprint/ID	✅	✅	✅
Device Fingerprint Stability	Clears the browser cache and cookies	Device fingerprints/ID still matches before and after clearing	✅	✅	✅
	Incognito and non-incognito mode on the same device browser	Device fingerprints/ID match	✅	✅	✅
	The same device browser before and after User-Agent modification	Device fingerprints/ID match	✅	✅	❌
	Before and after browser upgrade on the same device	Device fingerprints/ID match	✅	✅	✅
Device Fingerprint Risk Identification	Web crawlers (bot attacks)	Ability to identify web crawlers (bot attacks)	✅	❌	✅
	Incognito mode	Ability to recognize that the browser is in incognito mode/private browsing	✅	✅	✅
	Headless browser (Chrome Headless、phantomJS、selenium、puppeteer)	Able to identify the risk of use of headless browser	✅	❌	✅
	Abnormal user-agent	Ability to identify UA anomalies	✅	❌	✅
	JS is debugged	Can identify debugging behavior on JS	✅	❌	❌
	JS is tampered with	Can identify tampering	✅	❌	❌
	Do not use cookies	Ability to recognize the prohibition of the use of cookies	✅	❌	✅
	Browser parameters have been tampered with	Can identify browser environment tampering	✅	❌	✅
	Common browser cheating plug-ins	Can identify common cheating plug-in risks	✅	❌	✅
Security and Stability	Code Protection	The device fingerprint SDK and JS have code protection mechanisms (such as VMP), which effectively resist black hat cracking attempts to manipulate code logic and falsify data	✅ (VMP)	❌	❌
	Downgrade	Intercepting and sending collection requests in the Web environment can still generate device fingerprints normally	✅	✅	✅
	Anti packet capture	Web (including iOS and android web) have the ability to prevent packet capture	✅	❌	❌

License

This library is MIT licensed. Copyright trustdecision, Inc. 2022.