Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry AtHoc
  3. BlackBerry AtHoc Integrations
  4. BlackBerry AtHoc CylanceGuard Integration
  5. Configure the BlackBerry AtHoc integration in the CylanceGUARD portal administrator console
  6. Configure BlackBerry AtHoc connection settings and pair devices

Configure
BlackBerry AtHoc
 connection settings and pair devices

You must create a connection between
CylanceGUARD
 and
BlackBerry AtHoc
 and map the devices in
CylanceGUARD
 to the devices in
BlackBerry AtHoc
. This mapping synchronizes
CylanceGUARD
 user information to
BlackBerry AtHoc
 and aligns the devices users will receive
BlackBerry AtHoc
 alerts on. For example, map the "Phone" device in
CylanceGUARD
 to the appropriate Phone device in
BlackBerry AtHoc
.
You can create only one connection setting.
Prerequisites
  • BlackBerry AtHoc
     server URL
  • Username and password for an operator with either the Alert Publisher and End Users Manager or the Alert Manager role in
    BlackBerry AtHoc
  • Username and password for an operator with the x_blbe_athoc.configurator role in the
    CylanceGUARD
     portal administrator console.
  • Organization code
  • Client ID and Client Secret of the API application created in the organization in
    BlackBerry AtHoc
  1. Log in to the
    CylanceGUARD
     portal administrator console.
  2. In the filter navigator, type
    BlackBerry AtHoc
    .
  3. Click
    Settings
    .
  4. Do one of the following:
    • If you are creating the connection for the first time, click
      New
      .
    • Select your existing connection settings record.
  5. In the 
    BlackBerry AtHoc System URL
     field, enter your system URL using the format: https://<
    athocserver.domain.com
    >.
  6. In the 
    Username
     field, enter the username of an operator with the Alert Publisher and End Users Manager or the Alert Manager role.
  7. In the 
    Password
     field, enter the operator's password.
  8. In the
    Organization Code
     field, enter your organization code.
  9. In the
    Alert Template Common Name
     field, enter the common name of the alert template. For more information, see Find an alert template common name.
  10. In the
    Client ID
     field, enter your client ID.
  11. In the
    Client Secret
     field, enter your client secret.
  12. Select the
    Enable targeting on Mobile App
     option. The mobile app must be enabled in
    BlackBerry AtHoc
     and active for the user.
  13. Click
    Validate
    .
  14. If the connection is successful, click
    Save
    .
  15. On the
    Consent
     window, click
    I agree
     to provide consent to securely share personally identifiable information (PII) for
    CylanceGUARD
     users with the
    BlackBerry AtHoc
     system.
    Consent is mandatory to use the
    BlackBerry AtHoc
     application. Without consent, devices cannot be paired and users cannot publish
    BlackBerry AtHoc
     alerts.
  16. If the device pairing already exists, a message to review device pairing appears. The message contains a link which redirects to the device pairing record in the
    Pair Devices
     module. If the device pairing does not exist, a message to create a new device pairing is displayed. This message contains a link that redirects to the
    Pair Device
     module.
  17. If you are creating a new device pairing, click
    New
    .
  18. From the
    ServiceNow Device
     drop-down list, select an unpaired device. This list is populated with
    CylanceGUARD
     User fields.
  19. From the
    BlackBerry AtHoc Device
     drop-down list, select an unpaired device. This list is populated with personal devices that are enabled in
    BlackBerry AtHoc
    .
  20. Click
    Pair Selected
    . The mapping between the
    CylanceGUARD
     and the
    BlackBerry AtHoc
     device is created.
  21. Click
    Save
    .
  22. Repeat steps 19 to 22 to pair additional devices if required.
  • You can map only one
    CylanceGUARD
     device with one
    BlackBerry AtHoc
     device. For example, if you paired the
    CylanceGUARD
     Email device with the AtHoc Email-WorkName device, you cannot pair the
    CylanceGUARD
     Email device with the AtHoc Phone-WorkName device.
  • Only one connection settings record can exist in the
    Settings
     module. Only one device pairing record can exist in the
    Pair Devices
     module.
  • To enable targeting on the mobile app, pair the Email device from ServiceNow with the Email-Work device from
    BlackBerry AtHoc
     in the
    Pair Devices
     module.