Menu

Manage devices

Knox Configure requires resellers to submit device information on behalf of their customers before profiles can be pushed to enrolled devices.

Through the reseller portal, resellers are able to review devices uploaded to a customer, upload a device and delete devices.

Upload a device

NOTE — The Knox Reseller Portal doesn't contain a generic CSV file template that can be downloaded for new device uploads. When uploading new devices, only the new Device IDs require submission within a new CSV file.

For the CSV file template, ensure the following when inputting to a new CSV file:

  • Enter one device IMEI per line. Avoid commas to ensure device information is uploaded correctly into the portal.
  • To prevent numeric device IDs from being converted into scientific notation format: Open the Format Cells screen from the Microsoft Excel Home screen Number drop-down menu. Select Number from the Category menu, and set the Decimal places value to 0. Select OK to save the updated setting.

To upload a device:

  1. Log in to the Knox Reseller Portal.
  2. Select Customers from the left-hand navigation.

  3. Under Company name / Internal reference, select the target customer link.

  4. Select the UPLOADS tab.

  5. Click UPLOAD DEVICES.

  6. Enter the following information:

    • Device CSV file — Click BROWSE to select a CSV file containing the IMEIs, order date, and order number of purchased devices pending upload.
    • ClosedProfile alias — (Optional) Select the profile alias created by the customer. Ensure the correct profile is associated with the device upload by coordinating with the customer.

      A profile alias enables customers to set multiple auto-assignment rules for each reseller, rather than a single auto-assignment rule.

      Before setting an auto-assignment rule:

      1. The customer must create a profile alias, which is shared with the reseller, and can be used by the reseller when uploading devices.
        • When an alias is created, it must be associated with an existing profile.
      2. The reseller attaches the profile alias to an upload, which the customer uses for a profile auto-assignment rule.

      Profile aliases are unique per reseller, but are not unique across resellers since they're not shared across resellers.

      The customer can create up to 10 profile aliases per reseller, and each profile alias can only be associated with a single profile.

      NOTE — This feature requires the reseller to coordinate with the customer to determine which profile alias to use to ensure the correct profile is used for each upload.
    • Order number — (Optional) Provide the order number for the listed customer's devices.
    • Order date — Click on the calendar icon to select the date when the customer placed the order.
    • Tags — (Optional) Tags allow you to search for devices easily once they have been uploaded into Knox Configure.
  7. Click Upload to commit the device upload data into the Reseller Portal for the selected customer.

View devices

  1. Log in to the Knox Reseller Portal.
  2. Select the Customers tab.

  3. Under Company name / Internal reference, select the target customer link.

  4. Select the DEVICES tab.

  5. Filter and sort submitted devices by IMEI/MEID, Serial number, Order number, Model, date the device was Uploaded,Tags, Upload ID, or Status.

    6. NOTE — Rejected devices will generate a CSV error event message, but will no longer be displayed within the Devices table.

Device details

Following the instructions above to view devices, click on the device for which you want to get additional details.

Other fields are explained above in the Upload a device section, Wi-Fi: phone MAC address is the latest addition to these features. This address can be used to restore the device in the database and allowlist the device Wi-Fi address.

Delete devices

Delete a device

  1. Log in to the Knox Reseller Portal.
  2. Select Customers from the left-hand navigation.

  3. Under Company name / Internal reference, select the target customer link.

  4. Select the UPLOADS tab.

  5. Select a device.

  6. Click ACTIONS > Delete device upload.

Delete multiple devices

To delete one or more selected devices:

  1. Log in to the Knox Reseller Portal.
  2. Select Customers from the left-hand navigation menu.
  3. Under Company name / Internal reference, select the target customer link.
  4. Select the DEVICES tab.
  5. Select those target devices you intend to delete.
  6. Select Delete devices from the ACTIONS drop-down menu.
  7. Confirm the deletion when prompted from the Delete devices screen.

Bulk delete devices

To efficiently delete a large volume of devices, create a CSV file with each device IMEI listed on a separate row.

To bulk delete devices:

  1. Log in to the Knox Reseller Portal.
  2. Click BULK ACTIONS on the left-hand navigation.
  3. Click DELETE DEVICE.

  4. Click on Instructions for all bulk actions in the lower right corner of the window, read the Bulk action instructions, then click GOT IT.

  5. After you've created your CSV file, click BROWSE and select the target file.
  6. Click SUBMIT.

Delete multiple devices using a CSV file upload

To delete one or more devices using a properly formatted CSV file upload:

  1. Log in to the Knox Reseller Portal.
  2. Select Customers from the left-hand navigation menu.
  3. Under Company name / Internal reference, select the target customer link.
  4. Select the DEVICES tab.
  5. Select Delete devices via CSV from the ACTIONS drop-down menu.
  6. After you've created your CSV file, click BROWSE and select the target file.

  1. Click SUBMIT.