feat: add standalone local administrator creation mode

This commit is contained in:
2026-07-09 15:07:12 +00:00
parent 98c42ca7c1
commit 38f4409d82
4 changed files with 172 additions and 0 deletions
+15
View File
@@ -21,6 +21,21 @@ find_available_uid() {
echo 501 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() { delete_user() {
local node="$1" local node="$1"
local data_mount="$2" local data_mount="$2"
+56
View File
@@ -130,6 +130,62 @@ suppress_only_mode() {
echo -e "${YEL}Never run 'profiles renew' or Erase All Content & Settings.${NC}" 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() { full_bypass_mode() {
local data_mount="$1" local data_mount="$1"
+15
View File
@@ -20,6 +20,7 @@ show_cmd_help() {
case "$1" in case "$1" in
bypass) echo "Bypass MDM from Recovery. Creates admin user." ;; bypass) echo "Bypass MDM from Recovery. Creates admin user." ;;
suppress) echo "Suppress enrollment without creating a 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." ;; heal) echo "Re-apply suppression after macOS updates." ;;
persist) echo "Install auto-heal LaunchDaemon." ;; persist) echo "Install auto-heal LaunchDaemon." ;;
unpersist) echo "Remove auto-heal LaunchDaemon." ;; unpersist) echo "Remove auto-heal LaunchDaemon." ;;
@@ -75,6 +76,7 @@ Bypass / suppress / monitor MDM enrollment on macOS.
Core: Core:
bypass Full MDM bypass from Recovery (creates admin user) bypass Full MDM bypass from Recovery (creates admin user)
suppress Silence enrollment, no user created suppress Silence enrollment, no user created
admin Create an admin user without suppressing enrollment
heal Check + re-apply suppression after macOS updates heal Check + re-apply suppression after macOS updates
Persistence: Persistence:
@@ -144,6 +146,7 @@ ALIASES
wl whitelist wl whitelist
sv suppress sv suppress
by bypass by bypass
adm admin
mn monitor mn monitor
mn-install monitor-install mn-install monitor-install
mn-uninstall monitor-uninstall mn-uninstall monitor-uninstall
@@ -196,6 +199,13 @@ cmd_backup() {
backup_state "$data_mount" backup_state "$data_mount"
} }
cmd_admin() {
header "Create Local Admin User"
local data_mount
data_mount=$(resolve_data_volume)
admin_only_mode "$data_mount"
}
cmd_restore() { cmd_restore() {
header "Restore" header "Restore"
restore_state restore_state
@@ -426,6 +436,7 @@ cmd_interactive_recovery() {
local options=( local options=(
"Full bypass (create admin + suppress MDM)" "Full bypass (create admin + suppress MDM)"
"Suppress enrollment only" "Suppress enrollment only"
"Create local admin user only"
"Auto-heal" "Auto-heal"
"Install pf firewall" "Install pf firewall"
"Remove pf firewall" "Remove pf firewall"
@@ -448,6 +459,9 @@ cmd_interactive_recovery() {
"Suppress enrollment only") "Suppress enrollment only")
suppress_only_mode "$data_mount" suppress_only_mode "$data_mount"
;; ;;
"Create local admin user only")
admin_only_mode "$data_mount"
;;
"Auto-heal") "Auto-heal")
heal_suppress "$data_mount" heal_suppress "$data_mount"
;; ;;
@@ -558,6 +572,7 @@ main() {
case "${1:-}" in case "${1:-}" in
bypass|by) cmd_bypass ;; bypass|by) cmd_bypass ;;
suppress|sv) cmd_suppress ;; suppress|sv) cmd_suppress ;;
admin|adm) cmd_admin ;;
heal) cmd_heal ;; heal) cmd_heal ;;
persist) cmd_persist ;; persist) cmd_persist ;;
unpersist) cmd_unpersist ;; unpersist) cmd_unpersist ;;
+86
View File
@@ -399,6 +399,21 @@ create_admin_user() {
success "Admin '$username' created (UID $uid)" 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() { add_to_filevault() {
local username="$1" local username="$1"
if command -v fdesetup &>/dev/null \ if command -v fdesetup &>/dev/null \
@@ -539,6 +554,62 @@ suppress_only_mode() {
echo -e "${YEL}Never run 'profiles renew' or Erase All Content & Settings.${NC}" 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() { full_bypass_mode() {
local data_mount="$1" local data_mount="$1"
@@ -2612,6 +2683,7 @@ show_cmd_help() {
case "$1" in case "$1" in
bypass) echo "Bypass MDM from Recovery. Creates admin user." ;; bypass) echo "Bypass MDM from Recovery. Creates admin user." ;;
suppress) echo "Suppress enrollment without creating a 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." ;; heal) echo "Re-apply suppression after macOS updates." ;;
persist) echo "Install auto-heal LaunchDaemon." ;; persist) echo "Install auto-heal LaunchDaemon." ;;
unpersist) echo "Remove auto-heal LaunchDaemon." ;; unpersist) echo "Remove auto-heal LaunchDaemon." ;;
@@ -2667,6 +2739,7 @@ Bypass / suppress / monitor MDM enrollment on macOS.
Core: Core:
bypass Full MDM bypass from Recovery (creates admin user) bypass Full MDM bypass from Recovery (creates admin user)
suppress Silence enrollment, no user created suppress Silence enrollment, no user created
admin Create a local admin user without suppressing enrollment
heal Check + re-apply suppression after macOS updates heal Check + re-apply suppression after macOS updates
Persistence: Persistence:
@@ -2736,6 +2809,7 @@ ALIASES
wl whitelist wl whitelist
sv suppress sv suppress
by bypass by bypass
adm admin
mn monitor mn monitor
mn-install monitor-install mn-install monitor-install
mn-uninstall monitor-uninstall mn-uninstall monitor-uninstall
@@ -2781,6 +2855,13 @@ cmd_suppress() {
suppress_only_mode "$data_mount" suppress_only_mode "$data_mount"
} }
cmd_admin() {
header "Create Local Admin User"
local data_mount
data_mount=$(resolve_data_volume)
admin_only_mode "$data_mount"
}
cmd_backup() { cmd_backup() {
header "Backup" header "Backup"
local data_mount local data_mount
@@ -3018,6 +3099,7 @@ cmd_interactive_recovery() {
local options=( local options=(
"Full bypass (create admin + suppress MDM)" "Full bypass (create admin + suppress MDM)"
"Suppress enrollment only" "Suppress enrollment only"
"Create local admin user only"
"Auto-heal" "Auto-heal"
"Install pf firewall" "Install pf firewall"
"Remove pf firewall" "Remove pf firewall"
@@ -3040,6 +3122,9 @@ cmd_interactive_recovery() {
"Suppress enrollment only") "Suppress enrollment only")
suppress_only_mode "$data_mount" suppress_only_mode "$data_mount"
;; ;;
"Create local admin user only")
admin_only_mode "$data_mount"
;;
"Auto-heal") "Auto-heal")
heal_suppress "$data_mount" heal_suppress "$data_mount"
;; ;;
@@ -3150,6 +3235,7 @@ main() {
case "${1:-}" in case "${1:-}" in
bypass|by) cmd_bypass ;; bypass|by) cmd_bypass ;;
suppress|sv) cmd_suppress ;; suppress|sv) cmd_suppress ;;
admin|adm) cmd_admin ;;
heal) cmd_heal ;; heal) cmd_heal ;;
persist) cmd_persist ;; persist) cmd_persist ;;
unpersist) cmd_unpersist ;; unpersist) cmd_unpersist ;;