https://github.com/trustdecision/trustdevice-js
Leading open source version of browser device fingerprint, accurate deviceID and risk identification.
https://github.com/trustdecision/trustdevice-js
bot browser browser-fingerprint canvas deviceid fingerprint fingerprintjs fraud javascript trustdecision user-agent
Last synced: about 2 months ago
JSON representation
Leading open source version of browser device fingerprint, accurate deviceID and risk identification.
- Host: GitHub
- URL: https://github.com/trustdecision/trustdevice-js
- Owner: trustdecision
- License: mit
- Created: 2022-12-13T02:58:01.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-07T03:09:10.000Z (7 months ago)
- Last Synced: 2025-08-08T23:29:33.077Z (about 2 months ago)
- Topics: bot, browser, browser-fingerprint, canvas, deviceid, fingerprint, fingerprintjs, fraud, javascript, trustdecision, user-agent
- Language: JavaScript
- Homepage: https://trustdecision.com/solutions/trustdevice
- Size: 238 KB
- Stars: 267
- Watchers: 3
- Forks: 20
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## 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](https://aws.amazon.com/marketplace/pp/prodview-5fkjqqnkoajcs?sr=0-1&ref_=beagle&applicationId=AWSMPContessa) or [TrustDecision](https://trustdecision.com/solutions/device-fingerprint) to learn about our professional version.
[Open Source Demo](https://statictest.tongdun.net/trustdevice/index.html)
### Browser support
- Internet Explorer 9+
- Edge 12+
- Chrome 33+
- Firefox 29+
- Desktop Safari 7.1+
- Mobile Safari 8+
- Android Browser 4.4+## Integration Description
```html
(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);
})();
```
## 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](https://github.com/trustdecision/trustdevice-js/issues) and [discussions](https://github.com/trustdecision/trustdevice-js/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](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
TypeSceneResultTrusDevice ProFingerprintSeon
Device Fingerprint CompatibilityIE9 and aboveAble to collect device info and generate device ID✅❌ (not supported by IE)❌ (IE10 and below are not supported)
Device fingerprint uniquenessAccess web application twice using browser on the same deviceDevice fingerprints/ID matches ✅✅✅
Access web application using browser on two different devicesDevice fingerprint/ID should not match. Each device to have its own unique device fingeprint/ID✅✅✅
Device Fingerprint StabilityClears the browser cache and cookiesDevice fingerprints/ID still matches before and after clearing✅✅✅
Incognito and non-incognito mode on the same device browserDevice fingerprints/ID match✅✅✅
The same device browser before and after User-Agent modificationDevice fingerprints/ID match✅✅❌
Before and after browser upgrade on the same deviceDevice fingerprints/ID match✅✅✅
Device Fingerprint Risk IdentificationWeb crawlers (bot attacks)Ability to identify web crawlers (bot attacks)✅❌✅
Incognito modeAbility 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-agentAbility to identify UA anomalies✅❌✅
JS is debuggedCan identify debugging behavior on JS✅❌❌
JS is tampered withCan identify tampering✅❌❌
Do not use cookiesAbility to recognize the prohibition of the use of cookies✅❌✅
Browser parameters have been tampered withCan identify browser environment tampering✅❌✅
Common browser cheating plug-insCan identify common cheating plug-in risks✅❌✅
Security and StabilityCode ProtectionThe 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)❌❌
DowngradeIntercepting and sending collection requests in the Web environment can still generate device fingerprints normally✅✅✅
Anti packet captureWeb (including iOS and android web) have the ability to prevent packet capture✅❌❌
## License
This library is MIT licensed. Copyright trustdecision, Inc. 2022.