Using AppMgr with SSM

StageNow 5.8

Overview

This guide covers the use of App Manager to install apps through Secure Storage Manager, Zebra's mechanism for securely sharing files and/or data on devices in compliance with new and forthcoming Android security changes. The Google-mandated security restrictions are being phased in starting with devices running Android 11. SSM is compatible with MX 11.3 (and later), and its processes for use with App Manager and File Manger were designed to be transparent to the administrator in many scenarios.

In this process, direct file access is no longer permitted, and only trusted apps such as Zebra StageNow and OEMConfig can use SSM to deploy files to devices for installation and/or for sharing data with other apps. Once a file is deployed in this way, the file can be accessed ONLY by its intended target through the SSM-provided URI. SSM is preinstalled on all Zebra devices running Android 11 and later, and replaces the /enterprise partition as a means of sharing and persisting device data.

Any app intended to receive data shared through SSM must be capable of consuming data via URI
It should be noted that such changes are required NOT specifically for working with Zebra devices, but for compliance with new Android security specifications that will eventually be required of any Android app that shares data.

Requirements

  • Zebra device running Android 11 or later
  • MX 11.3 or later on device
  • StageNow 5.6 (or later) on Windows PC
  • Target app capable of URI data consumption

For more information about the File Manager parameters involved in this operation, see File Manager docs.


Install Apps Using SSM

The steps below provide a quick summary for administrators familiar with StageNow usage. For detailed instructions, please refer to docs for creating a Profile.

To Install an App With SSM

  1. In a new or existing StageNow Profile made for MX 11.3 (or later), add File Manager and App Manager.
  2. Under File Manager File Action, select "Deploy file for an application" and click Continue.
  3. For the "Target Application File Definition," enter the value: com.zebra.devicemanager/persist_apk/your_apk_name.apk.
    This defines the target app name (Device Manager), optional target-app folder (/persist_apk) and file name (your_apk_name.apk).
  4. Under Persist the File:
         a. Select "Persist" to keep the .apk file after an Enterprise Reset.
         b. Select "Do not persist" to discard the .apk file after an Enterprise Reset.
  5. Under Source Access Method select the location of the source .apk file:
         a. Select "File on Remote Server" option to download the source file from a server.
         This invokes the Source URI2 field for entering the server location. Zebra recommends this option as most secure.
         b. Select "File in the Device File System" to access a file on the device.

         For this option, enter the Source Path And File Name of the file being copied to the device. Example: /sdcard/your_apk_name.apk.
         When ready to proceed, the screen should appear similar to the image below.
         Confirm settings and click "Continue" button. image Click image to enlarge; ESC to exit.
  6. Under App Manager Application Action select Install from drop-down list.
  7. For the "File name and path," enter the value as below based on the Persistence option selected in Step 4:
         a. For "Persist" option: com.zebra.devicemanager/persist_apk/your_apk_name.apk
         b. For "Do not persist" option: com.zebra.devicemanager/non_persist_apk/your_apk_name.apk
    image Click image to enlarge; ESC to exit.
  8. Finish and save the Profile and create barcode(s).
    The app is securely installed on any compatible device that scans the barcode(s).

Also See