ReactNative

Only supports Android and iOS

Integrated Requirement

Compliance Explanation#

Please note that when integrating SDK products provided by the TrustDecision in the APP of your company:

1.1 According to the user's information protection regulations, before your users start the App for the first time and start collecting information, your company should fully inform the user of the purpose, method, and scope of collecting, using, and sharing the user's personal information with a third party through an interactive interface or design (such as a pop-up window of the privacy policy), and obtain the express consent of the end user.

1.2 To provide business security and risk control services to your company, the TrustDecision SDK will collect, process, and use the identification information IDFA, AndroidID, OAID, MAC address, Wireless IP address, WIFI list, wireless router identification (BSSID, SSID), device type, device model, system type, geographical location(Rough location information, precise location information), login IP address and other device information of the user's device. To ensure compliance with your use of related services, the aforementioned privacy policy should cover the authorization of TrustDecision SDK to provide services and collect, process, and use relevant information. The following terms are for your reference. The specific expression can be determined by your company according to the overall framework and content of your privacy agreement:

TrustDecision SDK: For business security and risk control, our company uses the TrustDecision SDK. The SDK needs to obtain the information of your devices, such as IDFA, AndroidID, OAID, GAID, MAC address, Wireless IP address, WIFI list, wireless router identification (BSSID, SSID), device type, device model, system type, geographical location(Rough location information, precise location information), login IP address, application list, running process, network type, device software version, sensor information(light sensor, gravity sensor, magnetic field sensor, acceleration sensor, gyroscope sensor) and other related device information, for fraud risk identification.

Privacy Protocol: TrustDecision Privacy Policy

Environment#

	Android	iOS
Supported System Versions	Android 5.0 and above	iOS 9.0 and above
Supported Architectures	armeabi-v7a, arm64-v8a, x86	armv7,arm64,x86_64

Integrate

Install#

Plugin Install#

Please execute in your react native project root directory

Bash

  npm install --save react-native-trustdevice@1.1.5

AndroidManifest.xml#

Declare the following permissions in the AndroidManifest.xml file under the application module

XML

<manifest>
  <!-- required -->
  <uses-permission android:name="android.permission.INTERNET"/>
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
  <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
  <!-- Outside the Chinese Mainland -->
  <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
 
  <!--optional, If not declared, some device information will be abandoned -->
  <uses-permission android:name=

Permissions#

Name	Description
INTERNET(required)	Allows the app to access the network connection and send requests to communicate with the server.
ACCESS_NETWORK_STATE(required)	Collect network connection status information.
ACCESS_WIFI_STATE(required)	Collect the current WiFi access status and WLAN hotspot information.
AD_ID(required)	Collect the Google advertising ID, required outside the Chinese Mainland.
ACCESS_COARSE_LOCATION	Get location information, with an accuracy of approximately 30 to 1500 meters.
ACCESS_FINE_LOCATION	Get location information, with positioning accuracy within 10 meters.
READ_PHONE_STATE	Collect information on SIM card
QUERY_ALL_PACKAGES	Collect installed packages

Initialization#

Cautions#

Ensure that it is initialized after the user agrees to the privacy agreement.

Definition#

TSX

async function initWithOptions(options: { [key: string]: any });

Get blackBox#

Cautions#

Call getBlackBox after initWithOptions.
Don't cache blackBox returned by getBlackBox in the app. Please rely on this function to get blackBox.

Definition#

TSX

// get by synchronous call
async function getBlackBox();
// get by asynchronous call
async function getBlackBoxAsync();

Best Practices#

Get TrustDevice Module

TSX

const TrustDevice = NativeModules.TrustDevice;

Initialize and get blackBox

TSX

async function initWithOptions() {
  var options = {
    partner: "[Your partner]",
    appKey: "[Your appKey]",
    appName: "[Your appName]",
    dataCenter: "[Your data center]",
    debug: false,
  };
 
  const isDebugMode = __DEV__;
  // !!! If not set this parameter in DEBUG mode, the app will terminate
  if (isDebugMode

Obtain blackBox in actual business scenarios

TSX

async function register() {
  const blackBox = await TrustDevice.getBlackBox();
  // ...
}

Status Check#

getBlackBox() will return a 26-bit string while initialization successfully: rGPGX1678775227I9NCwcuVJCb.
getBlackBox() will return a string of around 5000 bits while initialization Failed, please refer to overview-definition

Other

Get SDK Version#

TSX

async function getSDKVersion();

Keep Configuration#

XML

-keep class com.trustdecision.**{*;}

All Configuration#

Key	Description	平台	Sample	Remove Field
partner(required)	Partner code, contact operator to obtain.	All	options["partner"] = "your partner"
appKey(required)	Application identification, please refer tohow to get appKey	All	options["appKey"] = "your appKey"
dataCenter(required)	Data-center： cn for China fra for Europe sg for Singapore idna for Indonesia us for the USA	All	options["dataCenter"] = "your dataCenter"
appName	Application name, contact operator to obtain	All	options["appName"] = "your appName"
debug	Allow debugging, default false, must be closed before the application release.	All	options["debug"] = true
timeLimit	Network timeout configuration, in seconds, default 15s	All	options["timeLimit"] = 5
location	whether collecting GPS location information, default allowed	All	options["location"] = true	latitude、longitude、gps_location
IDFA	Whether collecting IDFA information, default allowed	iOS	options["IDFA"] = true	idfa
deviceName	Whether collecting device name, default allowed	iOS	options["deviceName"] = true	device_name
runningTasks	Whether collecting running tasks, default allowed	Android	options["runningTasks"] = true	running_packages
sensor	Whether collecting sensor information, default allowed	Android	options["sensor"] = true	mangetic_field_sensor、gyroscope_sensor、light_sensor、accelerator_data、gravity_data
readPhone	Whether collecting READ PHONE STATE permission-related information, default allowed	Android	options["readPhone"] = true	country_iso、carrier、network_operator、sim_operator、phone_type、radio_type、device_svn
installPackageList