Skip to main content

Risk parameters

About risk parameters​

Risk parameters are sent to the Encap SCA server and passed on to you to make risk assessment possible.

How to configure risk parameters​

You can enable and disable the risk parameters in the application configuration, by configuring ENABLE_RISK_DATA with enabled or disabled.

You can get the information about what risk parameters are sent to the server by calling riskparameterServerConfig in the EncapController. This will return an EncapRiskParameterServerConfig object.

With the function setRiskParameter on the EncapController, you can set risk parameters. Only EncapRiskParameter.jailbreakDetected is available for the app to set currently.

Want to learn more?

For a complete list of the data that is collected by this feature, see the Optionally collected data section in our Collected data appendix.

Rooting status​

There is no default value for EncapRiskParameter.jailbreakDetected, so if the app does not call this function, then the rooting status is not passed on to the server.

The app is free to implement the rooting detection as desired; either by its own implementation, or with a third-party library such as Promon SHIELD®.

Wi-Fi information (SSID and BSSID)​

The SDK can be configured to collect the SSID (network name) and BSSID (network hardware address) of the Wi-Fi network to which the device is connected. This information can be a valuable component in risk assessment. For example, this can identify whether the end-user is on a known, trusted network.

To enable the collection of this data, the following two conditions must be met:

Important

If either of these requirements are not met, then the SSID and BSSID are not collected or sent to the server.

  • Developer configuration: You must add the Access Wi-Fi Information Entitlement to your application's target in Xcode. Without this entitlement, the SDK cannot access any Wi-Fi information.
  • End-user permission: The end-user of the application must have granted location permissions for the app. Apple requires location services to be enabled for an app to retrieve Wi-Fi network details.
On this page