https://github.com/trustdecision/trustdevice-android

Leading open source version of android device fingerprint, accurate deviceID and risk identification.
https://github.com/trustdecision/trustdevice-android

aaid androidid deviceid fingerprint gaid imei imsi kotlin-android oaid trustdecision udid uuid

Last synced: about 2 months ago
JSON representation

Leading open source version of android device fingerprint, accurate deviceID and risk identification.

Host: GitHub
URL: https://github.com/trustdecision/trustdevice-android
Owner: trustdecision
License: mit
Created: 2022-12-13T02:59:44.000Z (almost 3 years ago)
Default Branch: main
Last Pushed: 2025-07-15T03:40:43.000Z (3 months ago)
Last Synced: 2025-07-15T08:45:48.003Z (3 months ago)
Topics: aaid, androidid, deviceid, fingerprint, gaid, imei, imsi, kotlin-android, oaid, trustdecision, udid, uuid
Language: Kotlin
Homepage: https://trustdecision.com/solutions/trustdevice
Size: 14.3 MB
Stars: 398
Watchers: 8
Forks: 59
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

TrustDevice logo

# TrustDevice-Android
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 app 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.

## Quick start

### 1. Add repository

Add these lines to your `build.gradle`.
```groovy
allprojects {
repositories {
mavenCentral()
}
}
```

If your version of Gradle is 7 or newer, add these lines to your `settings.gradle`:
```groovy
repositories {
...
mavenCentral()
}
```

### 2. Add dependency

Add these lines to `build.gradle` of a module.
```groovy
dependencies {
...
implementation 'com.trustdecision.android:mobrisk:1.1.2'
}
```

### 3. Get deviceInfo

DeviceInfo contains device id, risk information and device details.

#### 3.1. Option 1

```java
// initialization
TDRisk.init(context);

// usage
JSONObject deviceInfo = TDRisk.getBlackbox();
// Obtain deviceid and risk information through deviceInfo
String deviceID = deviceInfo.optString("device_id");
JSONObject deviceRisk = deviceInfo.optJSONObject("device_risk_label");
JSONObject deviceDetail = deviceInfo.optJSONObject("device_detail");
```

`getBlackbox` method executes in the calling thread and takes time to execute.

#### 3.1.2. Option 2

```java
TDRisk.Builder builder = new TDRisk.Builder();
builder.callback(new TDRiskCallback() {
@Override
public void onEvent(JSONObject deviceInfo) {
// Obtain deviceid and risk information through deviceInfo
String deviceID = deviceInfo.optString("device_id");
JSONObject deviceRisk = deviceInfo.optJSONObject("device_risk_label");
JSONObject deviceDetail = deviceInfo.optJSONObject("device_detail");
}
});
TDRisk.initWithOptions(context, builder);
```

`callback` is in a sub-thread, please do not perform UI operations.

## Data Sample

```json
{
"device_id": "55161BB8343D62230217F2D8206B67D428AE288F788C379341A0A95D4300B3A3",
"device_risk_label": {
"root": "true",
"debug": "true",
"multiple": "false",
"xposed": "false",
"magisk": "true",
"hook": "false",
"emulator": "false",
"vpn": "false",
"device_info_tampered": "false"
},
"device_detail": {
"abiType": "arm64-v8a,armeabi-v7a,armeabi",
"accessibilityEnabled": "0",
"adbEnabled": "1",
"allowMockLocation": "0",
"androidId": "4d52a39e07b9e464",
"androidVersion": "13",
"appList": "...",
"availableMemory": "3012796416",
"availableStorage": "44510015488",
"batteryHealthStatus": "good",
"batteryLevel": "100",
"batteryStatus": "full",
"batteryTemp": "294",
"batteryTotalCapacity": "2800.0",
"brand": "google",
"coresCount": "8",
"country": "CN",
"cpuHardware": "Qualcomm Technologies, Inc SM8150",
"cpuProcessor": "AArch64 Processor rev 14 (aarch64)",
"dataRoaming": "0",
"debug": "7",
"defaultInputMethod": "com.google.android.inputmethod.latin/com.android.inputmethod.latin.LatinIME",
"developmentSettingEnabled": "1",
"display": "TP1A.221005.002",
"emulator": "false",
"filesAbsolutePath": "/data/user/0/com.trustdevice.android/files",
"fingerprint": "google/flame/flame:13/TP1A.221005.002/9012097:user/release-keys",
"gsfId": "3750143927290222004",
"hardware": "flame",
"harmonyOS": "false",
"hook": "",
"host": "abfarm-release-rbe-64-00071",
"httpProxy": "",
"kernelVersion": "4.14.276-gecab2e0c9918-ab8931408",
"language": "zh",
"magisk": "true",
"manufacturer": "Google",
"mediaDrmId": "A069CC34B11C17F1C390575C794166F83CDE53B0887D2F718EDC901ED337FDF4",
"model": "Pixel 4",
"packageName": "com.trustdevice.android",
"product": "flame",
"root": "true",
"screenBrightness": "57",
"screenInches": "5.67",
"screenOffTimeout": "600000",
"screenResolution": "1080x2280",
"sdkVersion": "33",
"sensorsInfo": "...",
"systemAppList": "...",
"timezone": "中国标准时间",
"totalMemory": "5730922496",
"totalStorage": "53684973568",
"touchExplorationEnabled": "0",
"vbMetaDigest": "7258013a5672eb08b29be5b233b1b49c36b0eb1cd58a896b7575b2be3fc6dc99",
"xposed": "false"
}
}
```

## Open Source Features

- Basic device ID, This identifier is stable, it will remain the same even after uninstalling and reinstalling your app. But it will be different after factory reset of the device.
- Basic equipment information, which can be used for simple data analysis
- Basic risk identification ability

| RiskLabel | Risk Description |
| --------- | ------------------------------------------------------------ |
| root | Attackers will have higher privileges and can install many cheating software to affect the normal development of application business. |
| debug | Applications can be modified by attackers at will, and the program will return unexpected values. |
| multiple | Attackers can clone multiple app. |

## Open Source VS Pro

| | 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-android library. We recommend using GitHub Issues to submit bugs or Discussions to ask questions. Using [Issues](https://github.com/trustdecision/trustdevice-android/issues) and [Discussions](https://github.com/trustdecision/trustdevice-android/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 [www.trustdecision.com](https://www.trustdecision.com/trustDevice), registered account for a free trial; or via email trustdevice@trustdecision.com contact us directly and quickly open the service.

## TrustDevice Android Demo App

Try the library features in the [TrustDevice Android Demo App](https://github.com/trustdecision/trustdevice-android/releases/download/1.0.3/TrustDevice-release-1.0.3.apk).

## Compatibility

## TrustDevice Pro VS Others

TypeSceneResultTrusDevice ProFingerprintSeonSift

Device Fingerprint CompatibilitySupport Hongmeng system, including HarmonyOS 3.0, etc.Able to collect device info and generate device ID✅✅✅✅

Android 5.0 and above, including Android 14, etc.Able to collect device info and generate device ID✅✅✅✅

Device fingerprint uniquenessDifferent Apps (with different package names) on the same deviceDevice fingerprint/ID matches✅✅✅✅

The same app on two unique devices (including the case of the same device model and the same system version)Device fingerprint/ID should not match. Each device to have its own unique device fingeprint/ID✅✅✅✅

Device Fingerprint StabilityUninstall and reinstall of appDevice fingerprints/ID are consistent before and after reinstallation✅✅✅✅

Clear all app dataDevice fingerprints/ID are consistent before and after clearing all app data✅✅✅✅

Disable all app permissions except network permissions and clear app dataDevice fingerprints/ID are consistent before and after disabling all permissions✅✅✅✅

Modify the common information of the device system (brand, model, IMEI number, MAC address, etc.) through the device modification toolDevice fingerprint/ID still matches with before modification✅✅✅❌

Running same app in two instances using virtualization on the same device (i.e. using parallel space or dual space tools)Device fingerprint/ID still matches between both app instances✅✅✅✅

Android system upgradeDevice fingerprint/ID are consistent before and after system upgrade✅✅✅✅

Factory resetThe device fingerprints are the same before and after the device is restored to factory settings✅❌❌❌

Device Fingerprint Risk IdentificationSecondary packagingAbility to identify secondary packaged unofficial apps✅❌❌❌

Replay attackAbility to identify replay attacks✅❌❌❌

Suspected risky ROMAbility to identify suspected risky ROMs✅❌❌❌

Device location information has been tampered withAbility to identify tampering of location information✅❌❌❌

The device does not have a SIM card insertedCan identify whether the device is inserted with a SIM card✅❌❌❌

The device uses an HTTP proxyCan identify HTTP proxy risks✅❌❌❌

The device uses a VPN proxyCan identify VPN proxy risks✅❌❌❌

The device is RootedAbility to identify root risks✅❌✅✅

The device is an Android emulatorCan recognize emulator/simulator✅❌✅❌

The device is an Android cloud emulatorAbility to recognize cloud emulators✅❌✅❌

The device is an Android cloud real deviceCan identify cloud real device✅❌❌❌

Devices use system virtualization tools (i.e. parallel space, dual space, etc)Able to identify system virtualization tools✅❌❌❌

The device uses the virtualization tool to launch multiple instances of same applicationRecognize multiple instances of same applications on same device opened via virtualization tool✅❌❌❌

The device uses the device modification tool to modify the device parameter informationAbility to identify mainstream modification tools✅❌❌❌

The device uses scripting toolsCan identify mainstream scripting tools✅❌❌❌

The device uses the group control tool (tools to control multiple devices via a single terminal - device farm/device group)Can identify mainstream group control tools✅❌❌❌

The device is in Android ADB debugging stateAble to recognize Android ADB debugging✅❌❌✅

The device uses offerwall software (ad scamming software)Ability to identify devices using offerwall software✅❌❌❌

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✅ (OLLVM, VMP)❌❌❌

DowngradeIntercepting and sending collection requests in the Android environment can still generate device fingerprints normally✅❌✅❌

Anti packet captureAndroid has the ability to prevent packet capture✅❌❌❌

## License

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/trustdecision/trustdevice-android

Awesome Lists containing this project

README