Integrate the Client Device Data Collector SDK

The following procedure allows you to integrate and use the CDDC SDK in your Android project.

To use the CDDC SDK in your Android project

1. Link CDDCSDK.aar from the OneSpan Mobile Security Suite package to your project's classpath.

2. (OPTIONAL) Set the correct permissions for device data collection in the AndroidManifest.xml file:

   • Bluetooth/Wi-Fi: ACCESS_FINE_LOCATION

   • Wi-Fi: ACCESS_WIFI_STATE, ACCESS_NETWORK_STATE and CHANGE_WIFI_STATE

   • Bluetooth: BLUETOOTH and BLUETOOTH_ADMIN for Android versions lower than 12

   • Bluetooth: BLUTOOTH_CONNECT and BLUETOOTH_SCAN for Android versions 12 and higher

   • BehavioSec: ACCESS_COARSE_LOCATION, GET_ACCOUNTS, and GET_TASKS

   • Phone state: READ_PHONE_STATE

You are now ready to use the CDDC SDK. For more information about the integration of the functions, refer to the API documentation or see the sample attached to the SDK product package. For more information about BehavioSec, refer to the BehavioSec documentation at https://developer.behaviosec.com/dw/start. (To access the material on this website, you need to log in with your BehavioSec developer credentials.)

Sample attached to the SDK product package does not work on emulators with API 21 and 22.

When you call the getCollectedCDDCData method, ensure that the context parameter is not null.

Considerations for the device unique identifier

The CDDC SDK needs a unique Identifier associated with the device. This mapping is done on the server side of the CDDC SDK. If the device fingerprint generated by Device Binding SDK is used as the unique identifier, it is not possible to perform a migration from one fingerprint to another. The new identifier would provide faulty data to the Risk Analytics service. A new device fingerprint needs to be generated using the Hardware parameter.

The following procedure allows you to integrate and use the CDDC SDK in your iOS project.

To use the CDDC SDK in your iOS project

1. Link MSSCDDC.xcframework from the OneSpan Mobile Security Suite package to your Xcode project (linked framework and libraries).
   The BehavioSecIOSSDK.xcframework, which is required to capture behavioral data, is automatically included in the MSSCDDC.xcframework.

2. Add the following keys and their description to the .plist file of your project:

   • NSFaceIDUsageDescription

   • NSLocationWhenInUseUsageDescription

   • NSBluetoothPeripheralUsageDescription

   • NSBluetoothAlwaysUsageDescription

If you use the -ObjC flag you will need to add a Swift file and a bridging header to your project.

You are now ready to use the CDDC SDK. For more information about the integration of the functions, refer to the API documentation or see the sample attached to the SDK product package. For more information about BehavioSec, refer to the BehavioSec documentation and downloads page. (To access the material on this website, you need to log in with your BehavioSec developer credentials.)