Local Admin Password

Instructions for changing the Local Admin Password within the Launcher.

Overview

Local Admin Password enables administrators to define a secure, device-level password within the Launcher configuration. By default, this password is not included in the configuration file, but it can be added or modified by providing an SHA256 hash of the desired password.

This feature restricts unauthorized access to administrative settings on shared devices. It ensures that only authorized IT personnel can bypass lockdown modes or modify configurations.

User Guide

To update the Local Admin Password, you must generate an SHA-256 hash of your new password and deploy it via your MDM.

1. Determine your new password.

2. Generate the hash using one of two methods below:

   1. Plug password into a SHA256 hash generator:(https://academo.org/demos/SHA-256-hash-generator/)

   2. Run the following command in your terminal:

      echo -n adpass321 | shasum -a 256 | awk '{ print $1 }

3. In your launcher.json file, add or update the adminPassword field within the settings object using the generated value.

Once this configuration file is read by Launcher, the new password will be required to access local admin features.

Feature Configuration

To set up the Local Admin Password feature for a particular device profile or device group, please follow the steps below: To change the password, add or modify the adminPassword field under settings with an SHA-256 hash of the password. Then push the new configuration to the device. Use the example below:

"settings" : {
    ...
    "adminPassword": "d4548952d6815a2d07efbddaa6cfdf81d910121ea4ec094e182b02503214bc92"
    ...
}