Introduction
A Device fingerprint is a way to combine certain attributes of a device (operating system, IP address, device language settings etc.) in order to identify unique devices.
Unit partners with select providers to detect and prevent potential fraud. To enjoy improved protection, you must add the device fingerprint to new application.
Installation
Import the Device Fingerprint SDK by adding a <script>
tag at the head of your HTML page.
For production use:
<script src="https://web-scripts.unit.co/unit-fraud-sdk.js"></script>
For sandbox use:
<script src="https://web-scripts.s.unit.sh/unit-fraud-sdk.js"></script>
Usage
After adding the script tag, the SDK will automatically initialize and collect device information. To use the SDK in your application:
- Wait for the SDK to load
- Get the device fingerprint token
- Include the token in your application submission
Here's an example of how to implement this:
try {
// Get the device fingerprint array
const deviceFingerprints = await window.UnitFraudSDK.getDeviceFingerPrint();
// output: [{"provider": "...", "value": "..."}, {"provider": "...", "value": "..."}]
// Include the tokens in your application submission
const applicationData = {
// ... your application data ...
deviceFingerprints: deviceFingerprints
};
// Submit your application
await submitApplication(applicationData);
} catch (error) {
console.error('Error getting device fingerprints:', error);
}
Features
The Device Fingerprint SDK collects various device attributes including:
- Operating system and version
- Browser type and version
- Screen resolution
- Device language settings
- IP address
- Time zone
- Hardware information
- And more...
Troubleshooting
If you encounter any issues:
- Ensure the script tag is properly added to your HTML
- Check your browser's console for any error messages
- Verify that you're using the correct script URL for your environment (production vs. sandbox)
Mobile Implementation
The mobile Device Fingerprint SDK is coming soon. In the meantime, please continue using The Iovation (TransUnion TruValidate) device fingerprint string is called a "blackbox", the blackbox can be generated using their Android SDK, iOS SDK.