Licensing

AI Data Capture SDK 3.1

Overview

Certain AI Data Capture SDK models, such as the Image Attributes Proof of Delivery AI Model, require software licenses that must be procured and deployed to all target devices.

I. Procure License

The first step is to complete the License Request form. This brief form captures the following details:

  • Use Case (e.g., Picture Proof of Delivery AI Blueprint)
  • Quantity
  • Email Address
  • Country

II. Deploy & Activate License

After the license is procured, a confirmation email is sent containing the necessary activation details. The following steps outline the license deployment and activation process:

  1. Verify Prerequisites - All target devices must have the License Manager application, version 15.0.4 or higher. The application may be pre-installed; if not, it can be download from the License Manager Application Support page.
  2. Deploy and Activate - The license is deployed using an Enterprise Mobility Management (EMM) tool (e.g., Zebra StageNow, SOTI MobiControl). Activation requires the "Badge ID" and "Product Name" provided in the confirmation email. For detailed instructions, refer to the guides and videos on the support page.

Additional Resources:

III. Generate App Signature Certificate

To be added to the allowlist, the application signature requires a signature certificate. This allows Zebra's Access Manager (configured via StageNow) to identify and grant permissions to the application.

Use the following steps to generate a signature certificate encoded as a binary DER (.pem):

  1. Download the App Signature Tool as a .zip file and extract the .jar file.

  2. Open the command line interface (CLI). Navigate to the directory where the extracted .jar file is located.

  3. Generate the certificate. Execute the following command. Replace <app_name.apk> with the file path to the application .APK and <appname_certificate.PEM> with the desired output file name:

    java -jar SigTools.jar GETCERT -INFORM APK -OUTFORM DER -IN <appname.apk> -OUTFILE <appname_certificate.PEM>

  4. The .pem file is created in the folder specified in the command.

For further reference, see App Signature in Access Manager.

Important: Ensure that the paths for SigTools.jar and <app_name.apk> are correctly specified. Incorrect paths will result in errors.

IV. Allowlist the App

Applications must be added to the allowlist to enable use of the Zebra AI Suite SDK and communication between the SDK with the on-device Licensing Manager. This is configured using Zebra's StageNow device staging solution.

  1. Install and launch StageNow on the host computer.

  2. In the StageNow home screen, click Create New Profile from the left menu. image

  3. Perform the following:

    • Select MX version 14.2 or higher. The MX version on the device should match this version selected. See MX documentation for instructions on how to check the version.
    • Select Xpert Mode.
    • Click Create. image

  4. Enter the a profile name and click Start. image

  5. Scroll down and click the plus (+) sign next to AccessMgr. This adds AccessMgr to the Config tab on the right side. Click Add. image

  6. In the AccessMgr settings, enter/select the following values, then scroll down and click Continue.:

    • Server Access Action: Allow Caller to Call Service
    • Service Identifier: delegation-zebra-zsl-api-access-query
    • Caller Package Name: [Enter the app's package name, e.g. com.zebra.ai.ppoddemo]
    • Caller Signature: [Browse to the app's .pem signature certificate created in Step III.]

    image

  7. Click Complete Profile. image

  8. Select a deployment method::

    • StageNow - Generate the barcode from the profile. Open StageNow client on the device and scan the barcode.
    • EMM - Click Export for MDM to export the .xml file to deploy via EMM.

    image