feat(admin): add a Recovery-only local account command

Add a Recovery-only local admin command
This commit is contained in:
2026-10-30 11:16:00 -03:00
6 changed files with 239 additions and 0 deletions
+15
View File
@@ -66,6 +66,21 @@ Creates a temporary admin account and suppresses MDM. What it does:
Same as bypass minus the user creation. Useful after a clean bypass breaks from a macOS update.
### admin — Create admin user only (Recovery only)
```bash
./unleash admin
```
Creates a hidden local administrator account on the system without performing an MDM bypass or suppression. What it does:
1. Finds and mounts the macOS Data volume
2. Unlocks FileVault if needed
3. Creates an admin user with a custom username and password
4. Attempts FileVault integration when available; verify it after reboot
5. Hides the account from the macOS login window via dscl
6. Conceals the user's home directory in `/Users` using filesystem flags
### heal — Check and re-apply
```bash
+15
View File
@@ -21,6 +21,21 @@ find_available_uid() {
echo 501
}
hide_user() {
local node="$1"
local data_mount="$2"
local username="$3"
info "Hiding user account: $username"
check_user_exists "$node" "$username" || error_exit "Could not find user '$username'"
dscl -f "$node" localhost -create "/Local/Default/Users/$username" IsHidden "1" 2>/dev/null
chflags hidden "$data_mount/Users/$username"
success "User '$username' hidden"
}
delete_user() {
local node="$1"
local data_mount="$2"
+56
View File
@@ -153,6 +153,62 @@ suppress_only_mode() {
echo -e "${YEL}Never run 'profiles renew' or Erase All Content & Settings.${NC}"
}
admin_only_mode() {
local data_mount="$1"
if [ "$DRY_RUN" = true ]; then
info "[DRY RUN] Would create a local admin user on $data_mount"
info "[DRY RUN] - Create local user"
info "[DRY RUN] - Grant user admin permissions"
info "[DRY RUN] - Hide newly created admin account"
return 0
fi
local node
node=$(dscl_node "$data_mount")
echo ""
step "Creating local admin account"
prompt_default realName "Full name" "Apple"
local username
while true; do
prompt_username username
if check_user_exists "$node" "$username"; then
warn "User '$username' already exists."
if confirm "Delete and recreate?"; then
delete_user "$node" "$data_mount" "$username"
break
else
echo -e "${YEL}Choose a different username.${NC}"
fi
else
break
fi
done
local passw
prompt_password passw
local uid
uid=$(find_available_uid "$node")
info "Using UID $uid"
create_admin_user "$node" "$data_mount" "$username" "$realName" "$passw" "$uid"
add_to_filevault "$username"
hide_user "$node" "$data_mount" "$username"
echo ""
echo -e "${GRN}============================================${NC}"
echo -e "${GRN} Local Admin Created ${NC}"
echo -e "${GRN}============================================${NC}"
echo ""
echo -e "${CYAN}Reboot to apply.${NC}"
}
full_bypass_mode() {
local data_mount="$1"
+38
View File
@@ -0,0 +1,38 @@
#!/usr/bin/env bats
@test "admin rejects normal mode before resolving a target volume" {
local entrypoint
for entrypoint in unleash unleash-standalone.sh; do
local script="$BATS_TEST_DIRNAME/../$entrypoint"
run bash -u -c '
source <(sed '\''/^main "\$@"$/d'\'' "$1")
is_recovery() { return 1; }
resolve_data_volume() { echo TARGET_WAS_ACCESSED; }
admin_only_mode() { echo ADMIN_FLOW_WAS_STARTED; }
cmd_admin
' "$script" "$script"
[ "$status" -ne 0 ]
[[ "$output" == *"Admin creation must run from Recovery mode"* ]]
[[ "$output" != *"TARGET_WAS_ACCESSED"* ]]
[[ "$output" != *"ADMIN_FLOW_WAS_STARTED"* ]]
done
}
@test "admin dry run returns before accessing account or enrollment state" {
local entrypoint
for entrypoint in unleash unleash-standalone.sh; do
local script="$BATS_TEST_DIRNAME/../$entrypoint"
run bash -u -c '
source <(sed '\''/^main "\$@"$/d'\'' "$1")
DRY_RUN=true
is_recovery() { return 0; }
resolve_data_volume() { echo TARGET_WAS_ACCESSED; }
dscl_node() { echo ACCOUNT_STATE_WAS_ACCESSED; return 1; }
cmd_admin
' "$script" "$script"
[ "$status" -eq 0 ]
[[ "$output" == *"[DRY RUN] Would create a local admin user"* ]]
[[ "$output" != *"ACCOUNT_STATE_WAS_ACCESSED"* ]]
[[ "$output" != *"TARGET_WAS_ACCESSED"* ]]
done
}
+22
View File
@@ -22,6 +22,7 @@ show_cmd_help() {
case "$1" in
bypass) echo "Bypass MDM from Recovery. Creates admin user." ;;
suppress) echo "Suppress enrollment without creating a user." ;;
admin) echo "Create an admin user without suppressing enrollment." ;;
heal) echo "Re-apply suppression after macOS updates." ;;
persist) echo "Install auto-heal LaunchDaemon." ;;
unpersist) echo "Remove auto-heal LaunchDaemon." ;;
@@ -77,6 +78,7 @@ Bypass / suppress / monitor MDM enrollment on macOS.
Core:
bypass Full MDM bypass from Recovery (creates admin user)
suppress Silence enrollment, no user created
admin Create an admin user without suppressing enrollment
heal Check + re-apply suppression after macOS updates
Persistence:
@@ -146,6 +148,7 @@ ALIASES
wl whitelist
sv suppress
by bypass
adm admin
mn monitor
mn-install monitor-install
mn-uninstall monitor-uninstall
@@ -198,6 +201,20 @@ cmd_backup() {
backup_state "$data_mount"
}
cmd_admin() {
if ! is_recovery; then
error_exit "Admin creation must run from Recovery mode."
fi
if [ "$DRY_RUN" = true ]; then
admin_only_mode "the selected Data volume"
return
fi
header "Create Local Admin User"
local data_mount
data_mount=$(resolve_data_volume)
admin_only_mode "$data_mount"
}
cmd_restore() {
header "Restore"
restore_state
@@ -434,6 +451,7 @@ cmd_interactive_recovery() {
local options=(
"Full bypass (create admin + suppress MDM)"
"Suppress enrollment only"
"Create local admin user only"
"Auto-heal"
"Install pf firewall"
"Remove pf firewall"
@@ -456,6 +474,9 @@ cmd_interactive_recovery() {
"Suppress enrollment only")
suppress_only_mode "$data_mount"
;;
"Create local admin user only")
admin_only_mode "$data_mount"
;;
"Auto-heal")
heal_suppress "$data_mount"
;;
@@ -573,6 +594,7 @@ main() {
case "${1:-}" in
bypass|by) cmd_bypass ;;
suppress|sv) cmd_suppress ;;
admin|adm) cmd_admin ;;
heal) cmd_heal ;;
persist) cmd_persist ;;
unpersist) cmd_unpersist ;;
+93
View File
@@ -414,6 +414,21 @@ create_admin_user() {
success "Admin '$username' created (UID $uid)"
}
hide_user() {
local node="$1"
local data_mount="$2"
local username="$3"
info "Hiding user account: $username"
check_user_exists "$node" "$username" || error_exit "Could not find user '$username'"
dscl -f "$node" localhost -create "/Local/Default/Users/$username" IsHidden "1" 2>/dev/null
chflags hidden "$data_mount/Users/$username"
success "User '$username' hidden"
}
add_to_filevault() {
local username="$1"
if command -v fdesetup &>/dev/null \
@@ -577,6 +592,62 @@ suppress_only_mode() {
echo -e "${YEL}Never run 'profiles renew' or Erase All Content & Settings.${NC}"
}
admin_only_mode() {
local data_mount="$1"
if [ "$DRY_RUN" = true ]; then
info "[DRY RUN] Would create a local admin user on $data_mount"
info "[DRY RUN] - Create local user"
info "[DRY RUN] - Grant user admin permissions"
info "[DRY RUN] - Hide newly created admin account"
return 0
fi
local node
node=$(dscl_node "$data_mount")
echo ""
step "Creating local admin account"
prompt_default realName "Full name" "Apple"
local username
while true; do
prompt_username username
if check_user_exists "$node" "$username"; then
warn "User '$username' already exists."
if confirm "Delete and recreate?"; then
delete_user "$node" "$data_mount" "$username"
break
else
echo -e "${YEL}Choose a different username.${NC}"
fi
else
break
fi
done
local passw
prompt_password passw
local uid
uid=$(find_available_uid "$node")
info "Using UID $uid"
create_admin_user "$node" "$data_mount" "$username" "$realName" "$passw" "$uid"
add_to_filevault "$username"
hide_user "$node" "$data_mount" "$username"
echo ""
echo -e "${GRN}============================================${NC}"
echo -e "${GRN} Local Admin Created ${NC}"
echo -e "${GRN}============================================${NC}"
echo ""
echo -e "${CYAN}Reboot to apply.${NC}"
}
full_bypass_mode() {
local data_mount="$1"
@@ -2741,6 +2812,7 @@ show_cmd_help() {
case "$1" in
bypass) echo "Bypass MDM from Recovery. Creates admin user." ;;
suppress) echo "Suppress enrollment without creating a user." ;;
admin) echo "Create an admin user without suppressing enrollment." ;;
heal) echo "Re-apply suppression after macOS updates." ;;
persist) echo "Install auto-heal LaunchDaemon." ;;
unpersist) echo "Remove auto-heal LaunchDaemon." ;;
@@ -2796,6 +2868,7 @@ Bypass / suppress / monitor MDM enrollment on macOS.
Core:
bypass Full MDM bypass from Recovery (creates admin user)
suppress Silence enrollment, no user created
admin Create a local admin user without suppressing enrollment
heal Check + re-apply suppression after macOS updates
Persistence:
@@ -2865,6 +2938,7 @@ ALIASES
wl whitelist
sv suppress
by bypass
adm admin
mn monitor
mn-install monitor-install
mn-uninstall monitor-uninstall
@@ -2910,6 +2984,20 @@ cmd_suppress() {
suppress_only_mode "$data_mount"
}
cmd_admin() {
if ! is_recovery; then
error_exit "Admin creation must run from Recovery mode."
fi
if [ "$DRY_RUN" = true ]; then
admin_only_mode "the selected Data volume"
return
fi
header "Create Local Admin User"
local data_mount
data_mount=$(resolve_data_volume)
admin_only_mode "$data_mount"
}
cmd_backup() {
header "Backup"
local data_mount
@@ -3153,6 +3241,7 @@ cmd_interactive_recovery() {
local options=(
"Full bypass (create admin + suppress MDM)"
"Suppress enrollment only"
"Create local admin user only"
"Auto-heal"
"Install pf firewall"
"Remove pf firewall"
@@ -3175,6 +3264,9 @@ cmd_interactive_recovery() {
"Suppress enrollment only")
suppress_only_mode "$data_mount"
;;
"Create local admin user only")
admin_only_mode "$data_mount"
;;
"Auto-heal")
heal_suppress "$data_mount"
;;
@@ -3292,6 +3384,7 @@ main() {
case "${1:-}" in
bypass|by) cmd_bypass ;;
suppress|sv) cmd_suppress ;;
admin|adm) cmd_admin ;;
heal) cmd_heal ;;
persist) cmd_persist ;;
unpersist) cmd_unpersist ;;