On this page
We understand that successfully deploying your policies and settings correctly is important. To help you test and deploy your configurations, Knox Service Plugin (KSP) includes a setting called Debug mode.
By default, KSP runs in the background and does not have a UI. Debug mode enables you to easily see policy results and errors on a device, so you can verify that your configurations are correct. When turned on, it launches an app that displays the status of policies. This app should auto-launch when it receives any new polices.
We recommend you use Debug mode with a limited number of devices. You should turn it off for full deployments.
Here's an example of debug mode when opened manually on a device.
The app provides a list of the polices that you have pushed, along with details about the last configuration including:
- Policy title — Name of the policy.
- Updated — Last time the policy was updated (yyyy/mm/dd)
- Message — The status or error message that accompany the pushed policies (Success, Failed, or Conditional.)
For example, the screenshot below shows this information.
- Disable fingerprint authentication
- Updated 2018/10/12
- Message: Success. Fingerprint authentication is disabled.
When you first open the app, it only shows the most recent pushed configuration. You can click on this configuration to expand the link.
Activate Debug mode
Debug mode is activated inside your UEM console when you are pushing your policies. For example, if you are trying to debug the disable fingerprint authentication feature, follow these steps in your UEM:
- Turn on the Debug mode flag.
- Under password policies, choose Disable fingerprint.
- Push the policies to a device.
- Check the KSP app for debug information. If for any reason the app does not launch, check the following:
- Confirm that the device is using latest Google Play services and Play client application.
- Confirm the UEM has pushed the polices. Some UEMs have a delay between the time a policy is saved on the console and when it is received by the device. You may have to open the UEM agent on the device and preform a manual refresh to receive the policy. Refer to your UEM’s instructions for more information.
Note that where Debug mode appears in your UEM menu may vary. Here is an example of how it may look.
Debug mode features
You can preform the following actions when Debug mode is activated.
- To apply any updated policies, tap APPLY LATEST POLICIES.
- To list all configuration data, tap the latest configuration the screenshot below, this is shown as Configuration on 2019 / 05 /09
- You can also click on Configurations results to change the menu to Policies received. This provides the policy in JSON format.
- To get a log of the current configurations, tap the more menu and tap Export results.
Successful policies are displayed in black
Failed policies are displayed in red