API Reference
中文

Risk Score

What is the device risk score

The device risk score is a single value that intuitively reflects the security status of a device. Device fingerprint will detect various environmental risks during the device's operation from multiple dimensions. Once a specific risk is detected, the corresponding risk label will be triggered. Each label is represented by a positive integer with a certain weight, and the weight scores are cumulative. The more risk labels are matched, the higher the risk score will be.

Risk Label Score Weights

Each risk label has its own weight, which is related to the final calculation of the risk score. Currently, the weight is set based on the probability of the current risk label being triggered globally and the difficulty of its triggering in the environment. Risk labels that are less likely to be triggered have a stronger weight, and vice versa. There will be certain differences in the weights of the device labels corresponding to different terminals (Android, iOS, Web, Harmony, WeChat, Alipay, ByteDance,Baidu,JD,XHS), which is somewhat related to the device operating environment.

"N/A" marked in the following table indicates that the risk label is not present in the current environment and the specific terminal environment is unavailable.

Weight table

Risk LabelAndroidiOSharmonyWebWeChatAlipayByteDanceBaiduJDXHS
abnormal_time66N/AN/A666666
emulator9999999999
incognito_modeN/AN/AN/A4N/AN/AN/AN/AN/AN/A
headless_modeN/AN/AN/A6666666
abnormal_useragentN/AN/AN/A6666666
debugger_detected1212N/A129N/AN/AN/AN/AN/A
hook_tool_detected99N/A9N/AN/AN/AN/AN/AN/A
device_info_tampered99N/A9999999
group_control1212N/AN/AN/AN/AN/AN/AN/AN/A
no_sim444N/AN/AN/AN/AN/AN/AN/A
abnormal_device_attrN/A12N/A12121212121212
script_temperedN/AN/AN/A12N/AN/AN/AN/AN/AN/A
virtual_machineN/AN/AN/A12N/AN/AN/AN/AN/AN/A
local_debugN/AN/AN/A6N/AN/AN/AN/AN/AN/A
adb_link4N/AN/AN/AN/AN/AN/AN/AN/AN/A
repackaged99N/AN/AN/AN/AN/AN/AN/AN/A
proxy_detected888N/A8N/AN/AN/AN/AN/A
root9N/AN/AN/AN/AN/AN/AN/AN/AN/A
jail_breakN/A9N/AN/AN/AN/AN/AN/AN/AN/A
vpn_detected44N/A4N/AN/AN/AN/AN/AN/A
replay_attacks1212129999999
cookie_tempered1212129999999
crawlerN/AN/AN/A8N/AN/AN/AN/AN/AN/A
malicious_crxN/AN/AN/A8N/AN/AN/AN/AN/AN/A
debug_toolN/AN/AN/A6N/AN/AN/AN/AN/AN/A
app_multiple_running6N/AN/AN/AN/AN/AN/AN/AN/AN/A
sys_multiple_running4N/AN/AN/AN/AN/AN/AN/AN/AN/A
gps_fake88N/AN/A8N/AN/AN/AN/AN/A
risk_rom13N/AN/AN/AN/AN/AN/AN/AN/AN/A
camera_fake88N/AN/AN/AN/AN/AN/AN/AN/A
suspected_reset44N/AN/AN/AN/AN/AN/AN/AN/A
short_uptime444N/AN/AN/AN/AN/AN/AN/A
screen_sharing66N/AN/AN/AN/AN/AN/AN/AN/A
cloud_phone99N/AN/AN/AN/AN/AN/AN/AN/A

Use of Risk Score

The risk score can be used to mark and review the suspicious environment of a device. It can conveniently and quickly apply the set of risk labels to the fraud protection scenario. There is no need to use the characteristics of individual risk labels, making it more convenient.

"device_risk_score":53

Customized Risk Weight Configuration

Risk labels are calculated based on statistical analysis of global data. In many special cases, the weights of various risk labels need to be adjusted according to the actual usage scenarios.

For example, some users hope to exclude the risk label of multi-instance system operation from the risk score calculation, because in their business scenarios, the use of multi-instance system operation is accepted by default, and multi-instance system operation is a built-in function of the device itself. In this case, the weights of the risk labels can be adjusted through the customer platform configuration.

The customer platform has a customized interface, which allows users to customize the weight for each risk label, so as to accurately adjust the score according to the scenario. The operation configuration is as follows:

  1. Log in to the customer platform, click [Device Fingerprint] - [Management] - [Risk Score] in sequence to navigate to the configuration page.
  2. According to the platform for which you want to configure the weight, select the corresponding platform type (Android,iOS, Web, HarmonyOS, WeChat, Alipay, ByteDance,Baidu,JD,XHS).
  3. Click "Edit", enter the desired weight in the weight column. The score range is an integer between 0 and 10,000.
  4. After making the changes, click "Save", and it will take effect in about 5 minutes. After it takes effect, you will receive the updated risk score.


Disable risk label weights

In special scenarios, if you want to disable the weight of the risk label for multi-instance system operation, you can set the weight to zero by clicking the "Clear to Zero" button on the page, and then click "Save" for the change to take effect.


Restoring Defaults

The device fingerprint will provide a set of default values based on the internal understanding of the risk label environment. Click the "Reset All" button and then click "Save", and all risk label weights will be restored to their default values. It also supports the reset of the weight value of a single risk label, which can be used as needed.