# Device Connect: React Native Integration

Device connect can be integrated to React Native projects to share customers' device data.

# Install Dependency from NPM

Install the React SDK from the npm package

yarn add react-native-risk-sdk

This will install the native module as a dependency. Since it is a native module you will have to link this to your native app. Run following command to auto link native modules

react-native link

# Android Studio changes

Once the linking is done you need to open Android Studio and add a maven repository url in your project level build.gradle file

maven {  
    url "s3://risk-manager-android-sdk/artifacts"  
    credentials(AwsCredentials) {  
        accessKey = "<access-key>"
	    secretKey = "<secret-key>"  
    }
}

Add your AWS access and secret keys in local.properties file also as follows:

AWS_KEY=<access-key>
AWS_SECRET=<secret-key>

Final change required is in the MainApplication class of your native app.

@Override  
protected List<ReactPackage> getPackages() {
    return Arrays.<ReactPackage>asList(
        ....
        new RiskSdkPackage(),
        ...
    );
}

That's it. Now that the bridge is complete we need to go to React to call the method to trigger the SDK.

# React Implementation

Once the bridge is complete, we should be able to get the FinBoxRiskSdk instance from the package that is installed. Below is a snippet of react code to call the exposed methods.

createUser function creates a user with the username provided and the periodic sync will be for the assigned username Once the createUser is successful you need to call startPeriodicSync with the duration to start fetching data from device.

import FinBoxRiskSdk from 'react-native-risk-sdk';

//Function to trigger RiskSdk
const callModule = () => {
    FinBoxRiskSdk.createUser(
        "<API_KEY>",
        "<USERNAME>",
        (errorStatus) => {
	    // Error Callback
            console.log("Error status -> ", errorStatus)
        }, 
        (msg) => {
            // Success Callback, Call the periodic sync once the user has been created
	    console.log("Final message", msg)
	    FinBoxRiskSdk.startPeriodicSync(12) //Start the sync periodically after every 12 hour
	}
    )
}

# Sync Data Periodically

In successful response to FinBoxAuthCallback, the syncs should be started. The method below syncs data in background at regular intervals:

FinBoxRiskSdk.startPeriodicSync(12) //Start the sync periodically after every 12 hour

# Cancel Periodic Syncing

If you have already set up the sync for the user data, you can cancel it any time by following code:

FinBoxRiskSdk.stopPeriodicSync();

# Handle Permissions

The Run-time permissions needs to handled by the developer when calling the helper methods. Based on the permissions available, the SDK intelligently syncs the alternate data.

Below are the list of Run-time permissions the SDK adds to the application Manifest, if Manifest Merger is enabled:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_CALENDAR" />
<uses-permission android:name="android.permission.READ_SMS" />
<uses-permission android:name="android.permission.RECEIVE_SMS" />
<uses-permission android:name="android.permission.READ_CALL_LOG" />
<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.GET_ACCOUNTS" />
<uses-permission
    android:name="android.permission.PACKAGE_USAGE_STATS"
    tools:ignore="ProtectedPermissions" />

To remove the unused permissions, add a remove rule to that permission as shown below:

<uses-permission
    android:name="android.permission.READ_CALL_LOG"
    tools:node="remove" />

The recommended behavior is to leave the permissions untouched, as it is easier to configure which data points to collect, which ones to skip compared to releasing updates by adding, removing permissions.

In case the Manifest merger is not enabled add the above specified permissions manually.

# Reset User Data

In case the user data needs to be removed to re-sync the entire data, use the method resetData.

FinBoxRiskSdk.resetData();

# MultiProcess Support

Device Connect uses a content provider to auto initialize the SDK. The limitation with the OS is that content providers are only initialized once in a multi process application and from the main process. For this reason, any calls to the SDK from other processes will lead to unstable behavior.

In case, you want to use the SDK from a process other than main process, follow the two steps mentioned below to initialize the SDK.

# Remove the Content Provider

Remove the content provider that auto initializes the SDK from the Android Manifest file.

<provider
    android:name="in.finbox.mobileriskmanager.init.AutoInitProvider"
    android:authorities="in.finbox.lenderapplication.riskmanagerprovider"
    android:enabled="true"
    android:exported="false"
    tools:node="remove" />

# Error Codes

Below table contains the constant name, error code value and the description of error code:

Some error codes can be resolved by validating the implementation and some by retrying the creation of user, while other error codes can only be resolved by contacting FinBox.