feat: add standalone local administrator creation mode

This commit is contained in:
2026-07-09 15:07:12 +00:00
parent 1cb0fb2a07
commit fbef9c314b
4 changed files with 172 additions and 0 deletions
+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
@@ -130,6 +130,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"
+15
View File
@@ -20,6 +20,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." ;;
@@ -75,6 +76,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:
@@ -144,6 +146,7 @@ ALIASES
wl whitelist
sv suppress
by bypass
adm admin
mn monitor
mn-install monitor-install
mn-uninstall monitor-uninstall
@@ -196,6 +199,13 @@ cmd_backup() {
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() {
header "Restore"
restore_state
@@ -426,6 +436,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"
@@ -448,6 +459,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"
;;
@@ -558,6 +572,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 ;;
+86
View File
@@ -399,6 +399,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 \
@@ -539,6 +554,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"
@@ -2612,6 +2683,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." ;;
@@ -2667,6 +2739,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:
@@ -2736,6 +2809,7 @@ ALIASES
wl whitelist
sv suppress
by bypass
adm admin
mn monitor
mn-install monitor-install
mn-uninstall monitor-uninstall
@@ -2781,6 +2855,13 @@ cmd_suppress() {
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() {
header "Backup"
local data_mount
@@ -3018,6 +3099,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"
@@ -3040,6 +3122,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"
;;
@@ -3150,6 +3235,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 ;;