How Knox Guard works
Last updated July 19th, 2024
You first register devices for Samsung Cloud services like Knox Guard, through either:
- Samsung Knox device resellers, who use the Knox Deployment Program console or REST APIs
- Knox Deployment App, which is designed for small-scale deployments or testing
These devices start out in a Pending state. You can approve these devices for Knox Guard payment tracking using either the Knox Guard console or REST API call approve. Once approved, devices transition to the Activating state. When the Knox Guard app on the device confirms activation, the device then transitions to Active.
Knox Guard can manage devices that are on either:
- Installment Plans — These devices begin in an Active state, become Locked if payments become overdue, and Payment complete when the payments are complete.
- Pay-As-You-Go Plans — These devices start in a Locked state, then become Active with the appropriate payment for a specified time period. After this period, the device becomes Locked again. Currently, these devices support all the current Knox Guard features except offline lock and default blinking reminder.
If a device is either rejected or is payment complete, it can be deleted from the Knox Guard payment tracking. Once deleted, the Knox Guard app on the device is uninstalled and the device is no longer tracked.
Device state
Device state changes when it is approved, assigned a license, completes the payment cycle and so on. For each device state, see the table:
| Device State | Description | External State (on console) |
|---|---|---|
| Pending | The device is pending when a reseller uploads the device to a customer. Customers can then see the device in the list and reject or accept it. | Pending |
| Rejected | When a customer rejects the device, it’s state will change to rejected. | Rejected |
| Accepted | Once accepted, a Knox Guard agent on the client side is triggered. If auto accept is on, the devices’ state is changed from “Pending” to “Accepted” automatically. | Activating |
| Enrolled | This state allows the device to be controlled by Knox Guard to lock, unlock, send a message, or blink a device. | Active |
| Exchanging | Status of a device, which is undergoing maintenance, being replaced with a new device/IMEI number. This requires Samsung customer support assistance and is for tracking purposes only. | Exchanging |
| Resetting | A device will report the resetting state if a license has expired or been deleted. Once reported, it will transition to the pending state | Resetting |
| StartingReminder | The state is changed to “StartingReminder” when a customer sends the start-reminder event to the client. | Starting Reminder |
| StoppingReminder | The state is changed to “StoppingReminder” when a customer sends the stop-reminder event to the client. | Stopping Reminder |
| Blinked | Reminder is activated on the client. | Reminder On |
| Locking | The state is changed to “Locking” when a customer sends the lock event to the client. | Locking |
| Locked | Confirmed that the device is locked. | Locked |
| Unlocking | The state is changed to “Unlocking” when a customer sends the unlock event to the client. | Unlocking |
| Completing | The state is changed to “Completing” when a customer sends the complete event to the client. | Completing |
| Completed | Device is out of control of Knox Guard anymore. customer can complete when the loan is over. | Completed |
License state
Following table provide information on different license states.
| State | Description | External state (on console) |
|---|---|---|
| Registered | The license has been created but has yet to be activated. | Registered |
| Active | The activation period has started and the license is still valid. | Active |
| Expired | License has surpassed the expiration date and is no longer valid. | Expired |
On this page
Is this page helpful?