Introduction

RealWear Foresight administrators can require HMT device users within their Foresight instance to set up a device PIN to unlock their HMT device. PIN configuration requirements have changed undergone changes from Android 8 to Android 10. If you have updated (or plan to update) your HMT software to Release 12 and are a Foresight administrator, review this article to learn more about Foresight PIN requirements and configuration.

Summary

• Foresight’s PIN length setting will continue to work for your devices that are currently running firmware release 11.x (based on Android 8), and older.
• Foresight’s PIN complexity setting will be used for your devices that have been updated to firmware release 12.x (based on Android 10), and newer.

This article contains requirements on PIN settings and references to Android 10 where you can learn more about the change.

Deprecation of Legacy Device Admin Policies

The device PIN length setting relies on a legacy device admin policy named USES_POLICY_LIMIT_PASSWORD. This policy has been deprecated in Android 10, which is the base for RealWear Firmware Release 12.

https://developer.android.com/work/versions/android-10#deprecation_of_device_admin_policies

Android 10 prevents apps and DPCs from applying legacy device admin policies. We recommend customers and partners transition to fully managed devices or work profiles. The following policies throw a SecurityException when invoked by a device admin targeting Android 10:

USES_POLICY_DISABLE_CAMERA

USES_POLICY_DISABLE_KEYGUARD_FEATURES

USES_POLICY_EXPIRE_PASSWORD

USES_POLICY_LIMIT_PASSWORD

Device PIN on Firmware 12

Starting with firmware 12, you will not be able to specify the number of digits in the PIN. You can specify only the required complexity level.

Reference:

¹https://developer.android.com/reference/android/app/admin/DevicePolicyManager#PASSWORD_COMPLEXITY_NONE

₂https://developer.android.com/reference/android/app/admin/DevicePolicyManager#PASSWORD_COMPLEXITY_LOW

₃https://developer.android.com/reference/android/app/admin/DevicePolicyManager#PASSWORD_COMPLEXITY_MEDIUM

⁴https://developer.android.com/reference/android/app/admin/DevicePolicyManager#PASSWORD_COMPLEXITY_HIGH

Device PIN on Firmware 11

User defined PIN length of 4 – 16 digits.

Mapping

We recommend updating your devices to the latest firmware and use PIN complexity.

There is no clear 1-1 mapping between PIN length and PIN complexity. For example, a PIN length of 6 digits in firmware 11.x (based on Android 8) does not have an equivalent PIN complexity setting in firmware 12.x (based on Android 10).