Back to top

Export and deploy configuration

Last updated July 26th, 2023

Knox Capture uses a simple EMM-based deployment model. You first need to export a scanning configuration as a .txt file, then use an EMM add the file to your app configuration to deploy Knox Capture as a managed-app to your end-users.

Exporting a configuration

Exporting and sharing a scan configuration enables other devices apply the configuration to their installation.

Export options

An IT admin can use several methods to export the configuration:

  • Save it as a file on the device.
  • Email it as a file attachment.
  • Use Nearby share to send to another IT admin’s device
  • Generate a QR code that can be scanned by other IT admins.

To share a configuration on a per-device basis, transfer the configuration using near-field communication (NFC) or with a QR code.

Launch the export menu

Regardless of the export method selected, begin by tapping the Share button in the lower-right of the home page to launch the Share configuration menu.

Save as file

To save the file:

  1. Tap the Save icon in the Share configuration menu.
  2. Enter a name and tap Done. Knox Capture saves the configuration within My Files > Downloads, and displays a success message.

Email file

To email the configuration as a text file attachment with the default email program:

  1. Tap the email icon within the Share configuration menu.
  2. Knox Capture launches the email application and starts a new message with the configuration file attached.

Nearby share

To share a configuration with another device using Nearby share:

  1. Tap the Nearby icon within the Share configuration menu.
  2. Ensure Nearby Share is turned on for both the transmitting and receiving devices.
  3. On the receiving device, tap the Device nearby is sharing popup that appears.

QR code

To generate a QR code that can be scanned by other devices to import the configuration, tap the QR code option in the Share configuration menu.

Knox Capture generates and displays a QR code. Optionally save or email the QR code by tapping either the Save or Email button. Tap Save to save the QR code as an image within the device My Files > Downloads folder. Tap Email to launch the default email app. The resulting email message includes instructions for importing the configuration using the QR code.

If the configuration is too large for one QR code, Knox Capture generates multiple QR codes in a PDF file. The end user must scan them all to complete the import process.

Deploying through an EMM

To deploy Knox Capture with a custom scanning configuration across a fleet of devices, set the scan configuration and use the EMM console to add it to Knox Capture’s App Config in Managed Google Play. Doing so ensures devices that the app runs for end-users in Managed mode.

Deployment varies depending on the EMM provider, but should resemble the following flow:

  1. Install Knox Capture on an admin device, configure the app, and export the configuration as a text file.
  2. Add the Knox Capture app to your Managed Google Play Store.
  3. Assign the app to a group or organization and launch the app configuration dialog. In most consoles, the app configuration (or App Config) dialog opens as a pop-up window or modal.
  4. Activate your license in the EMM.
  5. Copy and paste the text of the exported Knox Capture configuration into the provided configuration field.
  6. Save the updated settings and deploy.

If you do not add a configuration for Knox Capture in Managed Google Play when updating a license key, the app operates according to its previous configuration. For example, a device with an existing scan configuration will continue to operate in Managed mode after updating the license key. However, a new device without an existing configuration will operate in Admin mode. To ensure all devices operate in Managed mode, prepare and include the configuration each time you add or modify the app within the EMM console.

Sharing and importing configurations

Once a configuration has been exported, it can be shared with other devices running the app in Admin mode. Once the file has been shared, the receiving device can import the configuration by doing the following:

Importing a configuration overrides existing Knox Capture settings on a device and is irreversible.

  1. Tap the more actions menu icon within the home page to the right of the Profiles list label. Then select Import.
  2. After launching the import configuration menu, acknowledge the warning message by tapping Confirm.
  3. Find the configuration file to import. Knox Capture will import the configuration and display a success message:

Import with QR code

If a configuration was shared via QR code, you can import the configuration by doing the following:

  1. Tap the QR code icon within the import configuration menu to launch the camera scanner.
  2. Direct the camera at the QR code.
  3. After scanning the QR code, Knox Capture automatically imports the configuration and displays a success message.

If the configuration is too large for one QR code, Knox Capture displays multiple QR codes in a PDF file. The end user must scan them all to complete the import process. If the user attempts to scan a QR code that isn’t part of the same configuration, an error message is shown on the overlay until a different one is scanned.

Is this page helpful?