Skip Navigation

Integrate
CylancePERSONA
with a
BlackBerry Dynamics
app

If you previously integrated the separate
BlackBerry Analytics
SDK with your
BlackBerry Dynamics
app, after you upgrade to use SDK version 8.0, do the following to remove the previous integration:
  • Remove
    BAFBlackberryAnalytics.framework
    from the Link Binary With Libraries build phase.
  • Remove
    BAFBlackberryAnalyticsAssets.bundle
    from the Copy Bundle Resources build phase.
  • Remove the following method calls within your project:
    • BlackberryAnalytics.setStage()
    • BlackberryAnalytics.hostInitializationCompleted()
  • Change the import for the
    BAFBlackberryAnalytics.h
    header from
    #import <BAFBlackberryAnalytics/BAFBlackberryAnalytics.h>
    to
    #import <GD/BAFBlackberryAnalytics.h>
    .
  1. In your implementation of the
    AppDelegate
    , import the header
    BAFBlackberryAnalytics.h
    .
  2. In the app target
    Capabilities
    , enable
    Access WiFi Information
    .
  3. It is recommended that you add the following usage descriptions (or your own custom descriptions) to the
    Info.plist
    file to inform the user why the app requires location permission:
    • NSLocationWhenInUseUsageDescription: "Allow BlackBerry to collect location data, including Wi-Fi address and IP address, and usage patterns only when the app is in use. You may change this setting at any time from your device settings."
    • NSLocationAlwaysUsageDescription: "Always allow BlackBerry to collect location data, including Wi-Fi address and IP address, and usage patterns, even when the app is not in use. You may change this setting at any time from your device settings."
    • NSLocationAlwaysAndWhenInUseUsageDescription: "Allow BlackBerry to collect location data, including Wi-Fi address and IP address, and usage patterns both when the app is and is not in use. You may change this setting at any time from your device settings."
  4. Add the following Persona flag metadata to the
    Info.plist
    file under the ROOT <dict> tag:
    <dict> <key>BlackBerryDynamics</key> <dict> <key>EnableBlackBerryPersona</key> <true/> </dict> </dict>
  5. In the Settings or Preferences section of your app UI, add a menu item called “BlackBerry Persona Settings” that calls the following method:
    BAFBlackberryAnalytics.displaySISsettings.
    This method triggers the
    BlackBerry Dynamics Runtime
    to display a screen that prompts the user to opt in or opt out of
    CylancePERSONA
    using the user’s location and IP address data when assessing the user’s risk level.
    This is a mandatory legal requirement to ensure that the end user can choose whether to allow
    CylancePERSONA
    to collect and use data.