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 send a purchase request to the Zebra licensing team at AIBlueprintLicensing@zebra.com and include the following details:

  • SKU (e.g., Picture Proof of Delivery AI Blueprint: ZEBRA-AI-BP-PPOD)
  • Quantity
  • Contact Information

II. Deploy & Activate License

License Activation Process:

  1. License Details - The purchase confirmation email contains the details required for license deployment and activation via Enterprise Mobility Management (EMM) tools (e.g., StageNow, SOTI).
  2. Required Software - All target devices must have License Manager application version 15.0.4 or higher. The License Manager application may be pre-installed within the LifeGuard image. The application is available for download from the License Manager Application Support page.
  3. Activation - The license is activated using the "Badge ID" and "Product Name" provided. Activation steps are demonstrated in instructional videos and guides available 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