BlackBerry AtHoc
Mobile App Administrator Guide
4.8
2021-02-17Z
| | 2
What is the BlackBerry AtHoc mobile app?....................................................... |
4 |
Product requirements............................................................................................................................................. |
4 |
Supported OS versions............................................................................................................................... |
4 |
Software requirements............................................................................................................................... |
4 |
Set up the BlackBerry AtHoc mobile app.......................................................... |
5 |
Personal Safety System (PSS) set up.................................................................................................................. |
5 |
Register the Mobile app......................................................................................................................................... |
5 |
Add BlackBerry AtHoc to the app list in BlackBerry UEM................................... |
6 |
Add BlackBerry AtHoc for iOS to the app list...................................................................................................... |
6 |
Add BlackBerry AtHoc for Android to the app list if BlackBerry UEM is not configured for Android |
|
Enterprise devices............................................................................................................................................. |
8 |
Add BlackBerry AtHoc for Android to the app list if BlackBerry UEM is configured for Android Enterprise |
|
devices............................................................................................................................................................... |
9 |
Configure the Mobile App device in BlackBerry AtHoc.................................... |
11 |
Configure the Mobile App device on the BlackBerry AtHoc application server............................................... |
11 |
Configure the Mobile App gateway settings...................................................................................................... |
11 |
Enable the mobile device.................................................................................................................................... |
14 |
Role-based permissions for the mobile app...................................................................................................... |
14 |
Configure mobile alert settings........................................................................................................................... |
15 |
Create a field report for the mobile app................................................................................................. |
15 |
Mobile alert types..................................................................................................................................... |
16 |
Configure scheduled location access..................................................................................................... |
16 |
Enable smart card authentication.................................................................... |
17 |
Enable Collaboration in BlackBerry AtHoc....................................................... |
18 |
BlackBerry AtHoc Customer Support Portal.................................................... |
19 |
Documentation feedback................................................................................. |
20 |
Legal notice.................................................................................................... |
21 |
| | iii
The BlackBerry AtHoc mobile app leverages the latest mobile technologies for rapid mass notification and personnel accountability. The BlackBerry AtHoc mobile app provides significant advantages to mobile operators, first responders, and alert recipients. This innovative application activates mass alerts and personnel tracking. The BlackBerry AtHoc mobile app is available on most popular devices, including Android and iOS smart phones and tablets. The BlackBerry AtHoc mobile app can be downloaded from Apple App store, Google Play store, and the BlackBerry World store.
Combined with the BlackBerry AtHoc management system, BlackBerry AtHoc’s award-winning, unified, netcentric technology, the BlackBerry AtHoc mobile app enhances an organization’s ability to reach key personnel during the most extreme conditions, extending situational awareness and the reach of the BlackBerry AtHoc management system.
The BlackBerry AtHoc mobile app has the following software requirements and supported OS versions and requirements.
•Android: 11.0, 10.0, 9.0, 8.0, 7.0. Android 6 and below are not supported.
•iOS 14, iOS 13 and iOS 12. iOS 11 and below are not supported.
•iPadOS (with iOS 13 or iOS 14)
•BlackBerry AtHoc release 7.5 or later release
•BlackBerry AtHoc release 7.10 or later release to enable biometric authentication
| What is the BlackBerry AtHoc mobile app? | 4
The BlackBerry AtHoc mobile app is available as a download from Apple App store, Google Play store, and BlackBerry World. When the BlackBerry AtHoc mobile app is installed, a appears on your device home screen.
When new alert content is published, the BlackBerry AtHoc mobile app displays an audio/visual alert notification on a mobile phone. The end-user can choose a response option (if response options are sent) and click a link to view complete Alert Inbox information on active alerts.
For detailed information about PSS and how to connect the BlackBerry AtHoc management system with the mobile app, contact the BlackBerry AtHoc Customer Support team.
Prerequisites
•Download and install the BlackBerry AtHoc mobile app from the Google Play store, Apple App store, or BlackBerry World store.
•Before you register the BlackBerry AtHoc mobile app on your device, you must have the organization code provided by your BlackBerry AtHoc administrator.
•If the BlackBerry AtHoc mobile app is pushed by UEM/MDM and you belong to the same organization configured in the UEM/MDM, then you only have to verify your email address when registering for the first time and are directed to the home screen. In this case, you do not have to enter the organization code. You must enter the organization code if you switch organizations after registering for the first time.
•You may have to enter the organization code when registering for the first time if the organization you belong to is not configured in UEM/MDM, or there is no organization code configured in UEM/MDM.
1.Tap the BlackBerry AtHoc app icon on your device.
2.On the Registration screen, read the welcome message. Close the message.
3.On the Registration screen, if it is not displayed, enter the email address that is associated with your BlackBerry AtHoc management system account.
4.Enter the PSS server URL. This URL is used for debugging purposes.
5.Tap Submit. The Email Verification screen with a confirmation message is displayed.
6.Check your email for a welcome email from the BlackBerry AtHoc system administrator with a link to activate your account to your registered email address.
7.On the welcome email, click Verify Now.
After the email address is verified, the Add Organization screen opens on your device.
8.Enter the organization code provided by your BlackBerry AtHoc administrator and tap Send or .
Note: If your organization is already configured with your email address and organization code, then you may not see this screen.
The screen indicates that you are connected to the organization.
| Set up the BlackBerry AtHoc mobile app | 5
Before you can manage BlackBerry AtHoc, you must add it to the app list in BlackBerry UEM. The app list contains apps that you can assign to users, user groups, and device groups. This section explains how to add BlackBerry AtHoc to BlackBerry UEM. For complete information on how to manage apps in BlackBerry
UEM, see the BlackBerry UEM Managing Apps Administration guide.
If your organization is using a proxy server, you must ensure that no SSL interception occurs. For more information on ports that must be open, visit support.blackberry.com/ to read article 52777.
1.On the menu bar, click Apps.
2.Click .
3.Click App Store.
4.In the search field, search BlackBerry AtHoc.
5.In the drop-down list, select the country of the store that you want to search in.
6.Click Search.
7.In the search results, click Add beside the BlackBerry AtHoc app.
8.To filter apps in the app list by category and to organize the apps into categories in the work apps list on users' devices, you can select a category for the app. In the Category drop-down list, do one of the following:
|
Tasks |
Steps |
|
|
|
|
|
|
Select a category for the app |
a. In the drop-down list, select a category. |
|
|
Create a category for the app |
a. Type a name for the category. The new category will appear in the |
|
|
|
drop-down list with the "new category" label beside it. |
b.Press Enter.
c.Press Enter.
9.In the App rating and review drop-down list, perform one of the following actions. When multiple versions of the app exist, the setting specified applies to all versions of the app.
•If you want users to rate and provide reviews of apps and see all reviews submitted by other users in your environment, select Public mode.
•If you want users to only rate and provide reviews of apps, select Private mode. Users cannot see reviews provided by other users. You can see reviews in the BlackBerry UEM management console.
•If you don't want users to rate or provide reviews of apps or see reviews provided by other users, select
Disabled.
10.In the Supported device form factor drop-down list, select the form factors that the app can be installed on.
For example, you can prevent the app from being available in the Work Apps app for iPad.
11.If you want the app to be deleted from the device when the device is removed from BlackBerry UEM, select
Remove the app from the device when the device is removed from BlackBerry UEM. This option applies only to apps with a disposition marked as required and the default installation for required apps is set to prompt once.
12.If you want to prevent apps on iOS devices from being backed up to the iCloud online service, select Disable iCloud backup for the app. This option applies only to apps with a disposition marked as required. You set the disposition of the app when you assign the app to a user or group.
13.In the Default installation for required apps drop-down list, perform one of the following actions:
| Add BlackBerry AtHoc to the app list in BlackBerry UEM | 6
•If you want users to receive one prompt to install the app on their iOS devices, select Prompt once. If users dismiss the prompt, they can install the app later using the Work Apps screen in the BlackBerry UEM Client app or the Work Apps icon on the device.
•If you don't want users to receive a prompt, select No prompt.
The default installation method applies only to apps with a disposition marked as required. You set the disposition of the app when you assign the app to a user or group.
14.In the app configuration table, complete one of the following tasks:
|
Create the app configuration from an XML template |
a. Click > Create from a template. |
|||
|
|
b. Click Browse and select the template that you |
|||
|
|
|
want to add. |
|
|
|
|
c. Click Upload. |
|
|
|
|
|
d. Type a name for the app configuration and |
|||
|
|
|
specify the following values: |
||
|
|
|
1. App Config Version: Enter the version of the |
||
|
|
|
app configuration. The default is 1. |
||
|
|
|
2. Organization Code: Enter your Organization |
||
|
|
|
Code for User registration. |
||
|
|
|
3. User registration email: Enter the email |
||
|
|
|
address for user registration. |
||
|
|
e. Click Save. |
|
|
|
|
|
|
|
|
|
|
Create the app configuration manually |
a. Click > Configure manually. |
|||
|
|
b. Enter a name for the app configuration. |
|||
|
|
c. Add the following settings: |
|||
|
|
|
|
|
|
|
|
|
Key |
Value |
|
|
|
|
|
|
|
|
|
|
appconfigversion |
Enter the version |
|
|
|
|
|
of the app |
|
|
|
|
|
configuration. |
|
|
|
|
firsttime_orgcode |
Enter your |
|
|
|
|
|
organization code |
|
|
|
|
|
for user registration. |
|
|
|
|
firsttime_pssurl |
Enter the PSS that |
|
|
|
|
|
the Mobile App |
|
|
|
|
|
communicates with, |
|
|
|
|
|
either US PSS or UK |
|
|
|
|
|
PSS. |
|
|
|
|
firsttime_email |
Enter the email |
|
|
|
|
|
address of a user for |
|
|
|
|
|
registration. |
|
|
|
d. |
|
|
|
|
|
Click Save. |
|
|
|
15. |
|
|
|
|
|
Click Add. |
|
|
|
|
|
After you finish |
|
|
|
|
| Add BlackBerry AtHoc to the app list in BlackBerry UEM | 7