How to enable key mapping to exit apps in a kiosk

Environment

• Knox Manage
• Knox Service Plugin running Knox 3.7.1 or higher
• Android Enterprise Device Owner/Kiosk mode
• Galaxy XCover Pro series or Galaxy Tab Active series

Overview

If a portable device in Kiosk mode is running an app with no built-in navigation bar and its main interface has disabled the navigation bar, device users might encounter a situation where they’re unable to exit the active app. If the device has one or more hardware keys, you can give the kiosk access to them, which passes the keypress events to the affected app.

In a Knox Manage profile, Knox Service Plugin offers the following policies to control hardware keys:

How to map hardware keys to apps

To give the kiosk access to the device’s hardware keys, you need to gather the package name of the kiosk app that defines the kiosk settings, then map the specific keys in the device profile.

First, find the name of the kiosk app:

1. On the Knox Manage console, go to Kiosk.

2. Highlight the kiosk app’s package name and copy it.

   

Then, map the desired keys to the kiosk app in the device profile:

1. Go to Profile.

2. Modify the policies of the applicable device profile.

3. Expand Samsung Knox > Knox Service Plugin policy drawer.

4. Under Device-wide policies, set the following policies:

   • Enable device policy controls — True.
   • Device Key Mapping > Enable Key Mapping — True.
   • Device Key Mapping > Enable Key Mapping to Launch apps — True.

5. Under Device Key Mapping to Launch application Configurations, define an app configuration:

   

   • Device Key Mapping — Select a hardware key to map to the kiosk app.
   • Device Key Mapping to Launch application Configurations > Package Name — Paste the package name of the kiosk app.

6. Click Save & Assign to save your changes and assign the profile to your device group.