Using StageNow to Enroll Your Device into SOTI as a Device Owner with a JSON File

Article ID:

Issue / Question

How do I use StageNow to enroll my device into a SOTI MobiControl Server using a JSON file instead of an INI file?

Applicable To

Zebra Android Devices running Android Oreo and above

Resolution / Answer

Before you begin this procedure, ensure that:

  • You have StageNow 2.10 and above installed on your PC
  • Your device MX version is MX 8.0 and above
  • Your device is connected wirelessly to the network and the StageNow server
  • Your device has the latest OS version installed (Android Oreo and above, GMS or AOSP)
  • You are enrolled as the Device Owner (DO)
  • Your device is in the Factory Default State, with no third party apps installed on your device
  • LifeGuard patch 7 or greater is installed
  • The Device Rule for this device exists in SOTI
NOTE When choosing the Android Enterprise account type in the Device Rule, we recommend that you select the Skip Google Account Addition During Enrollment on Managed Android Devices checkbox.


To enroll your device into a SOTI MobiControl Server via StageNow — with a JSON file, follow the steps below:

  1. On your PC, navigate to the SOTI MobiControl Device Agent Downloads page.
  2. Download the Agent MobiControl APK file to your PC (file name example: GoogleMobiControl1420_1069.apk).
  3. Follow the steps below to create the JSON file necessary for this procedure.
  4. Open the StageNow Workstation Tool, click Administrator Login on the top-right corner, and enter the administrator password to log in as an administrator.
  5. Click Create New Profile, and select the device MX version from the drop-down menu.
IMPORTANT! Your device MX version must be MX 8.0 or greater.

 

  1. Click the Xpert Mode Wizard and click Create.
  2. Enter a name for the profile and click Start. The ADD/EDIT window appears.
  3. Add the MDM Enrollment settings to your profile:
    1. Click the WIZARD tab (on the left section of the ADD/EDIT window).
    2. In the WIZARD tab, click MDM Enrollment to add this setting to the Config tab.


  4. Click Add when done.
  5. In the MDM Enrollment configuration, make the following changes:
    1. When prompted Which MDM Agent would you like to enroll for?, select SOTI.
    2. When prompted Select the group of devices you like to enroll for?, select Android N and above.
    3. When prompted Would you like to Download Configuration file?, select No.
    4. When prompted Is your SOTI App (.APK file) already present on the device?, select No, I want to Download the file to my device.
    5. Make the following changes in the Download App configuration:
      1. Target Path and File Name on Device > Enter /sdcard/<APK_filename> (e.g. /sdcard/GoogleMobiControl1420_1069.apk)
      2. Source File Location > Click the  button. The Staging Server URI Selector window opens.
      3. Select a File > Click the  button. Locate the Agent MobiControl APK file you downloaded in Step 2, and click Open.
      4. Click OK.
    6. Click Continue.
  6. No changes are required for the Install App configuration. Click Continue.
  7. In the Enroll Device Owner configuration, make the following changes:
    1. JSON File > Click the  button. Locate the JSON file you created in Step 3, and click Open.
    2. Click Continue.
  8. No changes are required for the Launch SOTI App configuration. Click Continue.
  9. In the Staging Profile Review page, click Expand to review your configurations. If necessary, you can amend your configurations by clicking the respective View buttons.
  10. Click Complete Profiles.
  11. Click the StageNow checkbox for PDF417 (for 2D scanners) or Linear (for 1D scanners) to specify the type of barcode for deployment, or click Select All to select all barcode types.
  12. Click Test to generate a PDF of the test staging barcode(s). A PDF of the test staging barcode(s) will be generated.
NOTE Embedded in the top right corner of the generated PDF is a barcode that bypasses the GMS Setup Wizard. Scan this barcode at the Android Welcome Screen to bypass the GMS Android Setup Wizard.


 
  1. Launch the StageNow Client on your device and scan the barcode(s) to start the enrollment process.
  2. If the enrollment process is successful, click Publish to publish the material for operator use.
  3. Enter the staging instructions for the operator and click Publish Now.

Creating the JSON (JavaScript Object Notation) File

  1. Click the Windows Start button. Type Notepad and click on the search result.
  2. Copy the text lines below into the Notepad text file.
    {
    "android.app.extra.PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME":
    "net.soti.mobicontrol.androidwork/net.soti.mobicontrol.admin.DeviceAdminAdapter",
    "android.app.extra.PROVISIONING_DEVICE_ADMIN_SIGNATURE_CHECKSUM":
    "hn8mSNJMPcovWbnnWrb-uMpWZjNlNp-jyV_2A-Whumc=\n",
    "android.app.extra.PROVISIONING_DEVICE_ADMIN_PACKAGE_DOWNLOAD_LOCATION":
    "https://drive.google.com/uc?export=download&id=17d1CKOBAEO1ZRTRz-U1xaZgU5MUEskel",
    "android.app.extra.PROVISIONING_SKIP_ENCRYPTION":"false",
    "android.app.extra.PROVISIONING_LEAVE_ALL_SYSTEM_APPS_ENABLED":true,
    "android.app.extra.PROVISIONING_ADMIN_EXTRAS_BUNDLE":{
    "enrollmentId":"ENTER_ENROLLMENT_ID_HERE"
    }
    }
    
  3. Replace the ENTER_ENROLLMENT_ID_HERE text with the enrollment ID that is generated when you create a device rule in SOTI. Ensure that the enrollment ID is within the quotation marks (" ").
  4. Click File > Save As. Enter your desired file name and append .json to the file name.
  5. Click Save.

 

+ Applicable Products

  • MC3300
  • MC3300R Series
  • TC51
  • TC51-HC Mobile Computer
  • TC52-HC
  • TC56
  • TC57 Touch Computer
  • TC70x
  • TC75x
  • VC80X
  • WT6000 Wearable Terminal