diff --git a/Makefile b/Makefile index 3b0d058..43ae970 100644 --- a/Makefile +++ b/Makefile @@ -1,8 +1,7 @@ .PHONY: lint test build clean ci lint: - shellcheck unleash lib/*.sh 2>/dev/null || brew install shellcheck && shellcheck unleash lib/*.sh - bash -n unleash lib/*.sh + python3 scripts/check-shell.py test: bats tests/*.bats @@ -13,18 +12,6 @@ build: clean: rm -f unleash-standalone.sh -ci: - @echo "=== ShellCheck ===" && \ - for f in unleash lib/*.sh examples/*.sh; do \ - [ -f "$$f" ] || continue; \ - echo " $$f"; shellcheck -S warning "$$f" || fail=1; \ - done && \ - echo "=== Bash Syntax ===" && \ - for f in unleash lib/*.sh examples/*.sh; do \ - [ -f "$$f" ] || continue; \ - bash -n "$$f" || fail=1; \ - done && \ - echo "=== Markdown ===" && \ - npx markdownlint-cli '*.md' || true && \ - echo "=== All checks done ===" && \ - [ -z "$$fail" ] || exit 1 +ci: lint test + @echo "=== Markdown ===" + npx markdownlint-cli '*.md' || true diff --git a/README.md b/README.md index dc83972..420f732 100644 --- a/README.md +++ b/README.md @@ -475,6 +475,9 @@ MA copies user-level caches, preferences, and launch agents. Unleash handles thi ## Contributing +Run `make ci` with Bash, Python 3.9+, ShellCheck, and Bats (validated with Bats 1.12). +The test suite uses temporary volumes and inert macOS command fixtures; it does not validate behavior on real Mac hardware. + See CONTRIBUTING.md. PRs welcome, especially for: - New macOS version compatibility diff --git a/examples/build-standalone.sh b/examples/build-standalone.sh index c11b6c4..f11ce8e 100755 --- a/examples/build-standalone.sh +++ b/examples/build-standalone.sh @@ -9,9 +9,11 @@ cat > "$OUT" << HEADER #!/bin/bash set -euo pipefail VERSION="$VERSION" +SCRIPT_DIR="\$(cd "\$(dirname "\$0")" && pwd)" +SCRIPT_PATH="\$SCRIPT_DIR/\$(basename "\$0")" HEADER -for lib in colors config detect validate dscl suppress backup status heal firewall harden whitelist check monitor history doctor selfupdate uninstall report ma_detect demo vpn; do +for lib in colors config detect validate dscl suppress backup status launchd heal firewall harden whitelist check monitor history doctor selfupdate uninstall report ma_detect demo vpn; do tail -n +1 "$SCRIPT_DIR/lib/$lib.sh" >> "$OUT" echo "" >> "$OUT" done diff --git a/lib/colors.sh b/lib/colors.sh index c08d231..9825046 100644 --- a/lib/colors.sh +++ b/lib/colors.sh @@ -32,7 +32,7 @@ log() { local ts ts=$(date '+%H:%M:%S') - echo -e "${color}[${label}]${NC} ${msg}" + echo -e "${color}[${label}]${NC} ${msg}" >&2 if [ -n "$LOG_FILE" ]; then echo "[${ts}] [${label}] ${msg}" >> "$LOG_FILE" 2>/dev/null || true @@ -40,7 +40,7 @@ log() { } error_exit() { - log "ERROR" "$1" >&2 + log "ERROR" "$1" exit 1 } @@ -68,7 +68,8 @@ header() { local title="$1" local len="${#title}" local line - line=$(printf '%*s' "$((len + 4))" | tr ' ' '═') + line=$(printf '%*s' "$((len + 4))" '') + line="${line// /═}" echo "" echo -e "${CYAN}╔${line}╗${NC}" echo -e "${CYAN}║ ${title} ║${NC}" @@ -107,7 +108,7 @@ prompt_default() { local prompt_text="$2" local default="$3" local value - read -p "${CYAN}${prompt_text}${NC} (default '${default}'): " value + read -r -p "${CYAN}${prompt_text}${NC} (default '${default}'): " value value="${value:=$default}" eval "$var_name=\"$value\"" } @@ -115,6 +116,6 @@ prompt_default() { confirm() { local prompt="$1" local response - read -p "${prompt} (y/N): " response + read -r -p "${prompt} (y/N): " response [[ "$response" =~ ^[Yy]$ ]] } diff --git a/lib/config.sh b/lib/config.sh index e0134c3..a67956f 100644 --- a/lib/config.sh +++ b/lib/config.sh @@ -2,10 +2,9 @@ CONFIG_FILE="$HOME/.unleash.conf" load_config() { [ -f "$CONFIG_FILE" ] || return 0 - - while IFS='=' read -r key value; do + local key value + while IFS='=' read -r key value || [ -n "$key" ]; do key="${key// /}" - value="${value// /}" [ -z "$key" ] && continue case "$key" in WEBHOOK) DISCORD_WEBHOOK="$value" ;; @@ -15,18 +14,29 @@ load_config() { done < "$CONFIG_FILE" } -save_config() { +_rewrite_config() { local key="$1" local value="$2" local tmp - [ -f "$CONFIG_FILE" ] || touch "$CONFIG_FILE" - - if grep -q "^${key}=" "$CONFIG_FILE" 2>/dev/null; then - sed -i '' "s/^${key}=.*/${key}=${value}/" "$CONFIG_FILE" - else - echo "${key}=${value}" >> "$CONFIG_FILE" + tmp=$(mktemp "${CONFIG_FILE}.XXXXXX") || return 1 + if ! UNLEASH_CONFIG_KEY="$key" UNLEASH_CONFIG_VALUE="$value" \ + UNLEASH_CONFIG_OPERATION="${3:-set}" awk ' + BEGIN { key=ENVIRON["UNLEASH_CONFIG_KEY"]; value=ENVIRON["UNLEASH_CONFIG_VALUE"]; + operation=ENVIRON["UNLEASH_CONFIG_OPERATION"] } + index($0, key "=")==1 { if (!found++ && operation=="set") print key "=" value; next } + { print } + END { if (!found && operation=="set") print key "=" value } + ' "$CONFIG_FILE" > "$tmp"; then + rm -f "$tmp" + return 1 fi + mv "$tmp" "$CONFIG_FILE" +} + +save_config() { + local key="$1" value="$2" + _rewrite_config "$key" "$value" || return 1 success "Saved $key to $CONFIG_FILE" } @@ -43,8 +53,8 @@ cmd_config() { cat "$CONFIG_FILE" | sed 's/^/ /' ;; set) - local key="$3" - local value="$4" + local key="${3:-}" + local value="${4:-}" [ -z "$key" ] || [ -z "$value" ] && { info "Usage: ./unleash config set KEY VALUE" info "Keys: WEBHOOK, LOG_LEVEL (verbose), LOG_FILE" @@ -53,10 +63,10 @@ cmd_config() { save_config "$key" "$value" ;; unset) - local key="$3" + local key="${3:-}" [ -z "$key" ] && { info "Usage: ./unleash config unset KEY"; return 1; } if [ -f "$CONFIG_FILE" ]; then - sed -i '' "/^${key}=/d" "$CONFIG_FILE" + _rewrite_config "$key" "" unset || return 1 success "Removed $key from config" fi ;; diff --git a/lib/detect.sh b/lib/detect.sh index 831353e..7eceb61 100644 --- a/lib/detect.sh +++ b/lib/detect.sh @@ -31,8 +31,9 @@ resolve_data_volume() { if [ -z "$id" ] || ! diskutil info "/dev/$id" >/dev/null 2>&1; then warn "Auto-detection failed. Available disks:" diskutil list >&2 - echo "" - read -p "Enter Data volume identifier (e.g. disk3s1): " id &2 + [ -t 0 ] || error_exit "Cannot select a Data volume without a terminal." + read -r -p "Enter Data volume identifier (e.g. disk3s1): " id /dev/null || true + diskutil mount "$data_dev" >&2 || true mount_pt=$(_mount_point) fi if [ -z "$mount_pt" ] || [ ! -d "$mount_pt" ]; then warn "FileVault-locked — need to unlock." echo -e "${YEL}Enter password of a user on this Mac (or FileVault recovery key):${NC}" >&2 - diskutil apfs unlockVolume "$data_dev" 2>/dev/null \ + diskutil apfs unlockVolume "$data_dev" >&2 \ || error_exit "Failed to unlock. Re-run with valid credentials." mount_pt=$(_mount_point) fi @@ -87,9 +88,9 @@ detect_system_volume() { resolve_target_volumes() { local base_name data_name - read -p "Enter target system volume name (default 'Macintosh HD'): " base_name + read -r -p "Enter target system volume name (default 'Macintosh HD'): " base_name base_name="${base_name:=Macintosh HD}" - read -p "Enter target data volume name (default 'Macintosh HD - Data'): " data_name + read -r -p "Enter target data volume name (default 'Macintosh HD - Data'): " data_name data_name="${data_name:=Macintosh HD - Data}" local sys_path="/Volumes/$base_name" diff --git a/lib/discord.sh b/lib/discord.sh index 5fd855a..ee63f57 100644 --- a/lib/discord.sh +++ b/lib/discord.sh @@ -9,10 +9,10 @@ cmd_discord_bot_install() { local token="${1:-}" local channel_id="${2:-}" if [ -z "$token" ]; then - read -p "Discord Bot Token: " token + read -r -p "Discord Bot Token: " token fi if [ -z "$channel_id" ]; then - read -p "Discord Channel ID: " channel_id + read -r -p "Discord Channel ID: " channel_id fi if [ -z "$token" ] || [ -z "$channel_id" ]; then error_exit "Token and channel ID are required" diff --git a/lib/firewall.sh b/lib/firewall.sh index 5d2ba4e..7bde747 100644 --- a/lib/firewall.sh +++ b/lib/firewall.sh @@ -7,7 +7,8 @@ pf_backup_anchor() { local root="$1" local anchor_file="${root}${FIREWALL_ANCHOR_DIR}/${FIREWALL_ANCHOR}" [ ! -f "$anchor_file" ] && return 0 - local backup="${anchor_file}.backup.$(date +%s)" + local backup + backup="${anchor_file}.backup.$(date +%s)" cp "$anchor_file" "$backup" && info "Backed up pf anchor: $backup" } @@ -15,7 +16,8 @@ pf_backup_conf() { local root="$1" local pf_conf="${root}${FIREWALL_CONF}" [ ! -f "$pf_conf" ] && return 0 - local backup="${pf_conf}.backup.$(date +%s)" + local backup + backup="${pf_conf}.backup.$(date +%s)" cp "$pf_conf" "$backup" && info "Backed up pf.conf: $backup" } @@ -51,10 +53,7 @@ ANCHOR if grep -q "com.unleash" "$pf_conf" 2>/dev/null; then info "pf.conf already has Unleash anchor" else - echo "" >> "$pf_conf" - echo "# Added by unleash — MDM block" >> "$pf_conf" - echo "$anchor_line" >> "$pf_conf" - echo "$load_line" >> "$pf_conf" + printf '\n%s\n%s\n%s\n' "# Added by unleash — MDM block" "$anchor_line" "$load_line" >> "$pf_conf" success "pf.conf updated" fi else @@ -79,8 +78,11 @@ ANCHOR step "Loading pf rules..." if command -v pfctl &>/dev/null; then - pfctl -e -f "$pf_conf" 2>/dev/null && success "pf enabled and rules loaded" \ - || warn "pfctl failed — try: sudo pfctl -e -f $pf_conf" + if pfctl -e -f "$pf_conf" 2>/dev/null; then + success "pf enabled and rules loaded" + else + warn "pfctl failed — try: sudo pfctl -e -f $pf_conf" + fi else warn "pfctl not available" fi @@ -105,8 +107,14 @@ remove_pf_mdm_block() { local pf_conf="${root}${FIREWALL_CONF}" if [ -f "$pf_conf" ]; then - sed -i '' '/# Added by unleash/d' "$pf_conf" 2>/dev/null || true - sed -i '' '/com\.unleash/d' "$pf_conf" 2>/dev/null || true + local tmp_conf + tmp_conf=$(mktemp "${pf_conf}.XXXXXX") || return 1 + if ! cp -p "$pf_conf" "$tmp_conf" \ + || ! sed '/# Added by unleash/d; /com\.unleash/d' "$pf_conf" > "$tmp_conf" \ + || ! mv "$tmp_conf" "$pf_conf"; then + rm -f "$tmp_conf" + return 1 + fi success "pf.conf cleaned" fi @@ -124,9 +132,11 @@ pf_status() { if command -v pfctl &>/dev/null; then pfctl -si 2>/dev/null | grep -E "Status|Enabled" || echo " pf not enabled" echo "" - pfctl -a "$FIREWALL_ANCHOR" -s rules 2>/dev/null \ - && info "Unleash MDM anchor rules:" \ - || info "No Unleash MDM anchor loaded" + if pfctl -a "$FIREWALL_ANCHOR" -s rules 2>/dev/null; then + info "Unleash MDM anchor rules:" + else + info "No Unleash MDM anchor loaded" + fi else warn "pfctl not available" fi diff --git a/lib/harden.sh b/lib/harden.sh index 058bc33..3cd7e17 100644 --- a/lib/harden.sh +++ b/lib/harden.sh @@ -14,8 +14,11 @@ harden_live_os() { local installed installed=$(profiles -C -output=xml 2>/dev/null | grep -c "ProfileDisplayName" || true) if [ "$installed" -gt 0 ]; then - sudo profiles -D -F 2>/dev/null && success "Forced profile removal" \ - || warn "Profile removal failed" + if sudo profiles -D -F 2>/dev/null; then + success "Forced profile removal" + else + warn "Profile removal failed" + fi else info "No installed profiles to remove" fi @@ -24,8 +27,8 @@ harden_live_os() { fi step "Cleaning user LaunchAgents..." - local home - for home in /Users/*/; do + local home users_root="${1:-}/Users" + for home in "$users_root/"*/; do [ -d "$home/Library/LaunchAgents" ] || continue local cleaned=0 for agent in "$home/Library/LaunchAgents/"*; do @@ -35,8 +38,11 @@ harden_live_os() { cleaned=$((cleaned + 1)) fi done - [ "$cleaned" -gt 0 ] && success "$(basename "$home"): removed $cleaned agent(s)" \ - || info "$(basename "$home"): clean" + if [ "$cleaned" -gt 0 ]; then + success "$(basename "$home"): removed $cleaned agent(s)" + else + info "$(basename "$home"): clean" + fi done step "Flushing DNS cache..." @@ -70,9 +76,11 @@ harden_live_os() { step "Disabling iCloud Private Relay (DoH source)..." if command -v defaults &>/dev/null; then - sudo defaults write /Library/Preferences/com.apple.networkextensions.plist PrivateRelayEnabled -bool false 2>/dev/null \ - && success "Private Relay disabled" \ - || info "Private Relay not configurable (expected on some configs)" + if sudo defaults write /Library/Preferences/com.apple.networkextensions.plist PrivateRelayEnabled -bool false 2>/dev/null; then + success "Private Relay disabled" + else + info "Private Relay not configurable (expected on some configs)" + fi fi echo "" @@ -96,5 +104,5 @@ harden_status() { launchctl list 2>/dev/null | grep -iE "mdm|managed|enrollment|activation" || info "None loaded" step "Running MDM processes..." - ps aux 2>/dev/null | grep -iE "mdm|managedclient|activation" | grep -v grep || info "None running" + pgrep -il "mdm|managedclient|activation" 2>/dev/null || info "None running" } diff --git a/lib/heal.sh b/lib/heal.sh index 695ac5a..cfa8567 100644 --- a/lib/heal.sh +++ b/lib/heal.sh @@ -70,11 +70,7 @@ install_persist_launchdaemon() { root="$(_persist_mount_root "$data_mount")" local unleash_src - if [ -n "$SCRIPT_DIR" ]; then - unleash_src="$SCRIPT_DIR/unleash" - else - unleash_src="$(cd "$(dirname "$0")" && pwd)/unleash" - fi + unleash_src=$(_launchd_script_path) step "Installing LaunchDaemon for boot-time persistence..." @@ -93,8 +89,8 @@ install_persist_launchdaemon() { ProgramArguments /bin/bash - -c - ${unleash_src} heal + ${unleash_src} + heal RunAtLoad @@ -117,9 +113,11 @@ install_persist_launchdaemon() { step "Loading LaunchDaemon..." if command -v launchctl &>/dev/null; then - launchctl load "$plist_path" 2>/dev/null \ - && success "LaunchDaemon loaded (will run on next boot)" \ - || info "LaunchDaemon will load on next boot" + if launchctl load "$plist_path" 2>/dev/null; then + success "LaunchDaemon loaded (will run on next boot)" + else + info "LaunchDaemon will load on next boot" + fi else info "launchctl not available (expected in Recovery) — will load on next boot" fi diff --git a/lib/history.sh b/lib/history.sh index 309c7fe..e8092ff 100644 --- a/lib/history.sh +++ b/lib/history.sh @@ -1,7 +1,8 @@ show_history() { header "Unleash Event History" - local logs=("/var/log/unleash-monitor.log" "/var/log/unleash-heal.log" "/var/log/unleash-monitor.err") + local log_dir="${1:-/var/log}" + local logs=("$log_dir/unleash-monitor.log" "$log_dir/unleash-heal.log" "$log_dir/unleash-monitor.err") local found=false for logfile in "${logs[@]}"; do @@ -34,7 +35,8 @@ show_history() { } clear_history() { - local logs=("/var/log/unleash-monitor.log" "/var/log/unleash-heal.log" "/var/log/unleash-monitor.err") + local log_dir="${1:-/var/log}" + local logs=("$log_dir/unleash-monitor.log" "$log_dir/unleash-heal.log" "$log_dir/unleash-monitor.err") for logfile in "${logs[@]}"; do if [ -f "$logfile" ]; then : > "$logfile" diff --git a/lib/launchd.sh b/lib/launchd.sh new file mode 100644 index 0000000..197a44c --- /dev/null +++ b/lib/launchd.sh @@ -0,0 +1,7 @@ +_launchd_script_path() { + local script_path="${SCRIPT_PATH:-}" + if [ -z "$script_path" ]; then + script_path="$(cd "$(dirname "$0")" && pwd)/$(basename "$0")" + fi + printf '%s' "$script_path" | sed 's/&/\&/g; s//\>/g' +} diff --git a/lib/ma_detect.sh b/lib/ma_detect.sh index 7b2086e..f837866 100644 --- a/lib/ma_detect.sh +++ b/lib/ma_detect.sh @@ -1,3 +1,11 @@ +_has_matching_path() { + local path + for path in "$@"; do + [ ! -e "$path" ] || return 0 + done + return 1 +} + detect_configurator_enrollment() { local data_mount="${1:-}" @@ -80,8 +88,13 @@ detect_migration_assistant() { local user_agents="$home/Library/LaunchAgents" if [ -d "$user_agents" ]; then - local found - found=$(ls "$user_agents" 2>/dev/null | grep -ciE "mdm|enrollment|managed" || true) + local found=0 agent + for agent in "$user_agents/"*; do + [ -f "$agent" ] || continue + if printf '%s\n' "${agent##*/}" | grep -qiE 'mdm|enrollment|managed'; then + found=$((found + 1)) + fi + done if [ "$found" -gt 0 ]; then ma_indicators=$((ma_indicators + found)) details="$details $user: $found MDM LaunchAgent(s)\n" @@ -90,9 +103,7 @@ detect_migration_assistant() { local prefs="$home/Library/Preferences" if [ -d "$prefs" ]; then - local mdm_prefs - mdm_prefs=$(ls "$prefs"/com.apple.mdm* "$prefs"/com.apple.ManagedClient* 2>/dev/null | head -3 || true) - if [ -n "$mdm_prefs" ]; then + if _has_matching_path "$prefs"/com.apple.mdm* "$prefs"/com.apple.ManagedClient*; then ma_indicators=$((ma_indicators + 1)) details="$details $user: MDM preference files\n" fi @@ -106,16 +117,12 @@ detect_migration_assistant() { local caches="$home/Library/Caches" if [ -d "$caches" ]; then - local enrollment_cache - enrollment_cache=$(ls "$caches"/com.apple.enrollment* 2>/dev/null | head -3 || true) - if [ -n "$enrollment_cache" ]; then + if _has_matching_path "$caches"/com.apple.enrollment*; then ma_indicators=$((ma_indicators + 1)) details="$details $user: enrollment cache files\n" fi - local mdmd_cache - mdmd_cache=$(ls "$caches"/com.apple.mdm* 2>/dev/null | head -3 || true) - if [ -n "$mdmd_cache" ]; then + if _has_matching_path "$caches"/com.apple.mdm*; then ma_indicators=$((ma_indicators + 1)) details="$details $user: MDM cache files\n" fi diff --git a/lib/monitor.sh b/lib/monitor.sh index f5eec98..38e8428 100644 --- a/lib/monitor.sh +++ b/lib/monitor.sh @@ -4,11 +4,7 @@ install_monitor_launchdaemon() { [ -n "$data_mount" ] && root="$data_mount" local unleash_src - if [ -n "$SCRIPT_DIR" ]; then - unleash_src="$SCRIPT_DIR/unleash" - else - unleash_src="$(cd "$(dirname "$0")" && pwd)/unleash" - fi + unleash_src=$(_launchd_script_path) step "Installing monitor LaunchDaemon..." @@ -26,8 +22,8 @@ install_monitor_launchdaemon() { ProgramArguments /bin/bash - -c - ${unleash_src} monitor + ${unleash_src} + monitor RunAtLoad @@ -47,9 +43,11 @@ PLIST success "Monitor LaunchDaemon: $plist_path" if command -v launchctl &>/dev/null; then - launchctl load "$plist_path" 2>/dev/null \ - && success "Monitor loaded (starts at boot)" \ - || info "Will load on next boot" + if launchctl load "$plist_path" 2>/dev/null; then + success "Monitor loaded (starts at boot)" + else + info "Will load on next boot" + fi fi } @@ -170,7 +168,7 @@ monitor_mdm() { } stop_monitor() { - local pidfile="/tmp/unleash-monitor.pid" + local pidfile="${1:-/tmp/unleash-monitor.pid}" if [ -f "$pidfile" ]; then local pid pid=$(cat "$pidfile") @@ -187,7 +185,7 @@ stop_monitor() { } monitor_status() { - local pidfile="/tmp/unleash-monitor.pid" + local pidfile="${1:-/tmp/unleash-monitor.pid}" if [ -f "$pidfile" ] && kill -0 "$(cat "$pidfile")" 2>/dev/null; then echo -e "${GRN}Monitor running (PID $(cat "$pidfile"))${NC}" tail -5 /var/log/unleash-monitor.log 2>/dev/null || echo " (no log entries yet)" diff --git a/lib/predict.sh b/lib/predict.sh index 9a9cb6d..2d81d2d 100644 --- a/lib/predict.sh +++ b/lib/predict.sh @@ -9,7 +9,7 @@ cmd_predict() { serial="${1:-}" fi if [ -z "$serial" ]; then - read -p "Enter serial number (or press Enter to skip): " serial + read -r -p "Enter serial number (or press Enter to skip): " serial fi if [ -z "$serial" ]; then info "No serial provided. Run: ./unleash predict " @@ -33,7 +33,8 @@ H4C:School District Managed VMW:VMware Workspace ONE M5K:Addigy Managed W4P:Kandji Managed -ORGS) +ORGS + ) local match match=$(echo "$known_orgs" | grep "^$serial_prefix:" || true) @@ -49,6 +50,5 @@ ORGS) info "The device may be from a smaller org or not organizationally enrolled." fi - local check_url="https://billing.c.apple.com/check?sn=${serial}" info "For definitive ownership: https://checkcoverage.apple.com" } diff --git a/lib/remediate.sh b/lib/remediate.sh index 8bbe3f2..4015033 100644 --- a/lib/remediate.sh +++ b/lib/remediate.sh @@ -1,5 +1,4 @@ -CMD_SUGGEST="" known_orgs() { cat << 'ORGS' diff --git a/lib/report.sh b/lib/report.sh index c835609..4641f4e 100644 --- a/lib/report.sh +++ b/lib/report.sh @@ -30,10 +30,11 @@ generate_report() { step "Installed Profiles" if command -v profiles &>/dev/null; then local count - count=$(sudo profiles -C -output=xml 2>/dev/null | grep -c "ProfileDisplayName" || echo 0) + count=$(sudo profiles -C -output stdout-xml 2>/dev/null | grep -c "ProfileDisplayName" || true) + count="${count:-0}" if [ "$count" -gt 0 ]; then echo " $count profile(s) installed" - sudo profiles -C -output=xml 2>/dev/null | grep -A1 "ProfileDisplayName" | grep "" \ + sudo profiles -C -output stdout-xml 2>/dev/null | grep -A1 "ProfileDisplayName" | grep "" \ | sed 's/.*\(.*\)<\/string>.*/ - \1/' else echo " No profiles installed" @@ -78,7 +79,8 @@ generate_report() { step "Hosts Block" if grep -q "iprofiles.apple.com" /private/etc/hosts 2>/dev/null; then local blocked - blocked=$(grep -c "0.0.0.0" /private/etc/hosts 2>/dev/null || echo 0) + blocked=$(grep -c "0.0.0.0" /private/etc/hosts 2>/dev/null || true) + blocked="${blocked:-0}" echo " $blocked domain(s) blocked in /etc/hosts" else echo " No block entries found" @@ -87,9 +89,9 @@ generate_report() { step "Running MDM Processes" local procs - procs=$(ps aux 2>/dev/null | grep -iE "mdm|managedclient|activation" | grep -v grep || true) + procs=$(pgrep -il "mdm|managedclient|activation" 2>/dev/null || true) if [ -n "$procs" ]; then - echo "$procs" | awk '{print " " $11 " (PID " $2 ")"}' + echo "$procs" | awk '{print " " $2 " (PID " $1 ")"}' else echo " None" fi @@ -117,7 +119,8 @@ generate_report_json() { local profile_count=0 if command -v profiles &>/dev/null; then - profile_count=$(sudo profiles -C -output=xml 2>/dev/null | grep -c "ProfileDisplayName" || echo 0) + profile_count=$(sudo profiles -C -output stdout-xml 2>/dev/null | grep -c "ProfileDisplayName" || true) + profile_count="${profile_count:-0}" fi report="${report} \"installed_profiles\": $profile_count,\n" @@ -147,7 +150,8 @@ generate_report_json() { report="${report} },\n" local hosts_blocked=0 - hosts_blocked=$(grep -c "0.0.0.0" /private/etc/hosts 2>/dev/null || echo 0) + hosts_blocked=$(grep -c "0.0.0.0" /private/etc/hosts 2>/dev/null || true) + hosts_blocked="${hosts_blocked:-0}" report="${report} \"hosts_blocked\": $hosts_blocked\n" report="${report}}" diff --git a/lib/selfupdate.sh b/lib/selfupdate.sh index 3dfce8a..2a0fe30 100644 --- a/lib/selfupdate.sh +++ b/lib/selfupdate.sh @@ -54,7 +54,7 @@ do_self_update() { fi end_ok; echo " Latest: v$latest_tag" - if [ "v$latest_tag" = "$(echo "v$VERSION")" ]; then + if [ "v$latest_tag" = "v$VERSION" ]; then success "Already up to date (v$VERSION)" rm -rf "$tmp_dir" return 0 diff --git a/lib/status.sh b/lib/status.sh index 5c05bf5..f9ed2d2 100644 --- a/lib/status.sh +++ b/lib/status.sh @@ -37,7 +37,8 @@ check_mdm_status() { else echo -e " ${YEL}(none)${NC}" fi - local count; count=$(echo "$matches" | grep -c . 2>/dev/null || echo 0) + local count; count=$(echo "$matches" | grep -c . 2>/dev/null || true) + count="${count:-0}" echo -e " ${CYAN}Total: $count of 13 expected domains blocked${NC}" else echo -e " ${YEL}(hosts not found)${NC}" @@ -79,6 +80,16 @@ check_mdm_status() { fi } +_mdm_agent_names() { + local agent + for agent in "$1/"*; do + [ -f "$agent" ] || continue + if printf '%s\n' "${agent##*/}" | grep -qiE 'mdm|enrollment|managed'; then + printf '%s\n' "${agent##*/}" + fi + done +} + deep_status() { if [ "${1:-}" = "--json" ]; then deep_status_json @@ -89,10 +100,11 @@ deep_status() { step "Installed Configuration Profiles" if command -v profiles &>/dev/null; then local profile_count - profile_count=$(sudo profiles -C -output=xml 2>/dev/null | grep -c "ProfileDisplayName" || echo 0) + profile_count=$(sudo profiles -C -output stdout-xml 2>/dev/null | grep -c "ProfileDisplayName" || true) + profile_count="${profile_count:-0}" if [ "$profile_count" -gt 0 ]; then warn "$profile_count profile(s) installed:" - sudo profiles -C -output=xml 2>/dev/null | grep -A1 "ProfileDisplayName" | grep "" | sed 's/.*\(.*\)<\/string>.*/ - \1/' + sudo profiles -C -output stdout-xml 2>/dev/null | grep -A1 "ProfileDisplayName" | grep "" | sed 's/.*\(.*\)<\/string>.*/ - \1/' else info "No configuration profiles installed" fi @@ -127,10 +139,10 @@ deep_status() { for home in /Users/*/; do [ -d "$home/Library/LaunchAgents" ] || continue local user_agents - user_agents=$(ls "$home/Library/LaunchAgents/" 2>/dev/null | grep -iE "mdm|enrollment|managed" || true) + user_agents=$(_mdm_agent_names "$home/Library/LaunchAgents") if [ -n "$user_agents" ]; then echo -e " ${YEL}$(basename "$home"):${NC}" - echo "$user_agents" | sed 's/^/ /' + while IFS= read -r agent; do printf ' %s\n' "$agent"; done <<< "$user_agents" found=$((found + 1)) fi done @@ -139,9 +151,9 @@ deep_status() { step "MDM LaunchDaemons (System)" local sys_agents - sys_agents=$(ls /Library/LaunchDaemons/ 2>/dev/null | grep -iE "mdm|enrollment|managed" || true) + sys_agents=$(_mdm_agent_names /Library/LaunchDaemons) if [ -n "$sys_agents" ]; then - echo "$sys_agents" | sed 's/^/ /' + while IFS= read -r agent; do printf ' %s\n' "$agent"; done <<< "$sys_agents" else info "No MDM LaunchDaemons found" fi @@ -149,9 +161,9 @@ deep_status() { step "Running MDM Processes" local procs - procs=$(ps aux 2>/dev/null | grep -iE "mdm|managedclient|activation" | grep -v grep || true) + procs=$(pgrep -il "mdm|managedclient|activation" 2>/dev/null || true) if [ -n "$procs" ]; then - echo "$procs" | awk '{print " " $11 " (PID " $2 ")"}' + echo "$procs" | awk '{print " " $2 " (PID " $1 ")"}' else info "No MDM processes running" fi @@ -173,8 +185,12 @@ deep_status() { step "Overall Assessment" local risk="LOW" - [ "$(sudo profiles -C -output=xml 2>/dev/null | grep -c "ProfileDisplayName" || echo 0)" -gt 0 ] && risk="MEDIUM" - ps aux 2>/dev/null | grep -qiE "mdm|managedclient" && risk="HIGH" + local cfg="/private/var/db/ConfigurationProfiles/Settings" + local installed + installed=$(sudo profiles -C -output stdout-xml 2>/dev/null | grep -c "ProfileDisplayName" || true) + installed="${installed:-0}" + [ "$installed" -gt 0 ] && risk="MEDIUM" + pgrep -i "mdm|managedclient" >/dev/null 2>&1 && risk="HIGH" [ -f "$cfg/.cloudConfigRecordFound" ] && risk="CRITICAL" case "$risk" in @@ -193,7 +209,8 @@ deep_status_json() { local profile_count=0 if command -v profiles &>/dev/null; then - profile_count=$(sudo profiles -C -output=xml 2>/dev/null | grep -c "ProfileDisplayName" || echo 0) + profile_count=$(sudo profiles -C -output stdout-xml 2>/dev/null | grep -c "ProfileDisplayName" || true) + profile_count="${profile_count:-0}" fi json="${json} \"profile_count\": $profile_count,\n" @@ -211,9 +228,7 @@ deep_status_json() { json="${json} \"mdm_certificates\": $mdm_certs,\n" local running_procs=0 - running_procs=$(ps aux 2>/dev/null | grep -ciE "mdm|managedclient|activation" || true) - running_procs=$((running_procs - 1)) - [ "$running_procs" -lt 0 ] && running_procs=0 + running_procs=$(pgrep -il "mdm|managedclient|activation" 2>/dev/null | awk 'END {print NR}' || true) json="${json} \"running_mdm_processes\": $running_procs,\n" local risk="LOW" diff --git a/lib/suppress.sh b/lib/suppress.sh index 223d54d..ff5a720 100644 --- a/lib/suppress.sh +++ b/lib/suppress.sh @@ -1,6 +1,6 @@ -PB=/usr/libexec/PlistBuddy +PB="${PB:-/usr/libexec/PlistBuddy}" suppress_enrollment() { local data_mount="$1" @@ -146,6 +146,7 @@ full_bypass_mode() { echo "" step "Creating temporary admin account" + local realName prompt_default realName "Full name" "Apple" local username diff --git a/lib/validate.sh b/lib/validate.sh index 2ac9e61..1f7fb01 100644 --- a/lib/validate.sh +++ b/lib/validate.sh @@ -20,7 +20,7 @@ prompt_username() { local var_name="$1" local value while true; do - read -p "Username (default 'Apple'): " value + read -r -p "Username (default 'Apple'): " value value="${value:=Apple}" if msg=$(validate_username "$value"); then eval "$var_name=\"$value\"" @@ -35,7 +35,7 @@ prompt_password() { local var_name="$1" local value while true; do - read -p "Password (default '1234'): " value + read -r -p "Password (default '1234'): " value value="${value:=1234}" if msg=$(validate_password "$value"); then eval "$var_name=\"$value\"" diff --git a/lib/vpn.sh b/lib/vpn.sh index 3588a6a..ca5e08f 100644 --- a/lib/vpn.sh +++ b/lib/vpn.sh @@ -58,14 +58,14 @@ RULES if grep -q "vpn-kill" "$pf_conf" 2>/dev/null; then info "pf.conf already has VPN kill-switch anchor" else - echo "" >> "$pf_conf" - echo "# Added by unleash — VPN kill-switch (prevents MDM leaks)" >> "$pf_conf" - echo "$anchor_line" >> "$pf_conf" - echo "$load_line" >> "$pf_conf" + printf '\n%s\n%s\n%s\n' "# Added by unleash — VPN kill-switch (prevents MDM leaks)" "$anchor_line" "$load_line" >> "$pf_conf" fi - pfctl -e -f "$pf_conf" 2>/dev/null && success "VPN kill-switch active" \ - || warn "pfctl failed" + if pfctl -e -f "$pf_conf" 2>/dev/null; then + success "VPN kill-switch active" + else + warn "pfctl failed" + fi echo "" info "What this does:" diff --git a/lib/whitelist.sh b/lib/whitelist.sh index 1f73457..ecf109e 100644 --- a/lib/whitelist.sh +++ b/lib/whitelist.sh @@ -11,7 +11,7 @@ install_selective_block() { local anchor_file="${anchor_dir}/com.unleash.selective" mkdir -p "$anchor_dir" - > "$anchor_file" + : > "$anchor_file" for d in $MDM_BLOCKLIST; do for ip in $(host -t a "$d" 2>/dev/null | awk '/has address/{print $NF}'); do @@ -33,10 +33,7 @@ install_selective_block() { if grep -q "com.unleash.selective" "$pf_conf" 2>/dev/null; then info "pf.conf already has selective anchor" else - echo "" >> "$pf_conf" - echo "# Added by unleash — selective MDM block (iCloud-safe)" >> "$pf_conf" - echo "$anchor_line" >> "$pf_conf" - echo "$load_line" >> "$pf_conf" + printf '\n%s\n%s\n%s\n' "# Added by unleash — selective MDM block (iCloud-safe)" "$anchor_line" "$load_line" >> "$pf_conf" success "pf.conf updated with selective rules" fi else @@ -56,8 +53,11 @@ EOF fi if command -v pfctl &>/dev/null; then - pfctl -e -f "$pf_conf" 2>/dev/null && success "pf rules loaded (iCloud should work)" \ - || warn "pfctl failed" + if pfctl -e -f "$pf_conf" 2>/dev/null; then + success "pf rules loaded (iCloud should work)" + else + warn "pfctl failed" + fi fi } diff --git a/scripts/check-shell.py b/scripts/check-shell.py new file mode 100644 index 0000000..3408175 --- /dev/null +++ b/scripts/check-shell.py @@ -0,0 +1,59 @@ +#!/usr/bin/env python3 +"""Check modules in their shared Bash context without executing the application.""" +import json +import pathlib +import re +import shlex +import shutil +import subprocess +import sys +import tempfile + +root = pathlib.Path(__file__).resolve().parents[1] +for tool in ("bash", "shellcheck"): + if not shutil.which(tool): + sys.exit(f"{tool} is required; install it before running make lint") + +entrypoint = root / "unleash" +source = entrypoint.read_text() +loader = re.search(r"^for _lib in ([a-z_ ]+); do\n.*?^done$", source, re.M | re.S) +if not loader: + sys.exit("Cannot identify the module loader in unleash") +modules = [root / "lib" / (name + ".sh") for name in loader[1].split()] +if set(modules) != set((root / "lib").glob("*.sh")): + sys.exit("The module loader and library files do not match") + +# Literal sources let ShellCheck follow shared globals and report module locations. +# Keep the loader's line count so dispatcher diagnostics retain their real lines. +literal_sources = "; ".join("source " + shlex.quote(str(path)) for path in modules) +context = source[:loader.start()] + literal_sources +context += "\n" * loader[0].count("\n") + source[loader.end():] +examples = sorted((root / "examples").glob("*.sh")) +failed = False +for path in [entrypoint, *modules, *examples, root / "unleash-standalone.sh"]: + result = subprocess.run(["bash", "-n", str(path)], check=False) + failed |= result.returncode != 0 + +with tempfile.NamedTemporaryFile(mode="w", suffix=".sh") as temporary: + temporary.write(context) + temporary.flush() + result = subprocess.run([ + "shellcheck", "--shell=bash", "--external-sources", "--check-sourced", + "--format=json", temporary.name, *map(str, examples), str(root / "unleash-standalone.sh"), + ], capture_output=True, text=True, check=False) + if result.stderr: + print(result.stderr, file=sys.stderr, end="") + failed |= result.returncode != 0 + findings = json.loads(result.stdout or "[]") + seen = set() + for finding in findings: + path = finding["file"] + if path == temporary.name: + path = str(entrypoint) + key = (path, finding["line"], finding["column"], finding["code"]) + if key in seen: + continue + seen.add(key) + print(f"{path}:{finding['line']}:{finding['column']}: " + f"{finding['level']} SC{finding['code']}: {finding['message']}") +sys.exit(1 if failed else 0) diff --git a/tests/helpers/platform.py b/tests/helpers/platform.py new file mode 100644 index 0000000..24de34f --- /dev/null +++ b/tests/helpers/platform.py @@ -0,0 +1,77 @@ +#!/usr/bin/env python3 +"""Inert macOS command fixtures; mutable plist operations stay in the suite root.""" +import json +import os +import pathlib +import plistlib +import shlex +import subprocess +import sys + +name = pathlib.Path(sys.argv[0]).name +args = sys.argv[1:] +root = pathlib.Path(os.environ["UNLEASH_TEST_ROOT"]).resolve() +with (root / "platform-calls.jsonl").open("a") as log: + log.write(json.dumps([name, *args]) + "\n") + +def fixture_path(value): + path = pathlib.Path(value).resolve() + active_test = pathlib.Path(os.environ["BATS_TEST_TMPDIR"]).resolve() + if not (path.is_relative_to(root) or path.is_relative_to(active_test)): + sys.exit(f"Fixture refused path outside the suite: {path}") + return path + +if name == "sudo": + if len(args) >= 2 and ((args[0] == "profiles" and args[1] in ("-C", "status")) + or (args[0] == "security" and args[1] == "find-identity")): + sys.exit(subprocess.call([str(pathlib.Path(sys.argv[0]).with_name(args[0])), *args[1:]])) +elif name == "profiles": + if args[:1] == ["-C"]: + sys.stdout.buffer.write(plistlib.dumps([])) + sys.exit(0) + if args[:1] == ["status"]: + print("MDM enrollment: No") + sys.exit(0) +elif name == "security" and args[:1] == ["find-identity"]: + sys.exit(0) +elif name == "plutil" and args[:4] == ["-convert", "xml1", "-o", "-"]: + sys.stdout.buffer.write(plistlib.dumps(plistlib.loads(fixture_path(args[-1]).read_bytes()))) + sys.exit(0) +elif name == "PlistBuddy": + path = fixture_path(args[-1]) + data = plistlib.loads(path.read_bytes()) + command = shlex.split(args[1]) + action = command[0] + key = command[1].lstrip(":") if len(command) > 1 else None + if action == "Print": + if key: + print(str(data[key]).lower()) + else: + sys.stdout.buffer.write(plistlib.dumps(data)) + sys.exit(0) + if action == "Add" and key in data: + sys.exit(1) + if action == "Set" and key not in data: + sys.exit(1) + if action in ("Add", "Set"): + data[key] = command[-1] == "true" + elif action == "Delete": + data.pop(key, None) + else: + sys.exit(97) + path.write_bytes(plistlib.dumps(data)) + sys.exit(0) +elif name == "launchctl" and args[:1] in (["load"], ["unload"]): + fixture_path(args[-1]) + sys.exit(0) +elif name == "host" and args[:2] == ["-t", "a"]: + print(f"{args[2]} has address 203.0.113.10") + sys.exit(0) +elif name == "dscl": + fixture_path(args[1]) + sys.exit(1) +elif name in ("diskutil", "pgrep", "pkill", "curl", "pfctl", "host"): + sys.exit(1) + +print(f"Blocked platform operation in test: {name} {' '.join(args)}", file=sys.stderr) +sys.exit(97) diff --git a/tests/setup_suite.bash b/tests/setup_suite.bash new file mode 100644 index 0000000..67a56b5 --- /dev/null +++ b/tests/setup_suite.bash @@ -0,0 +1,20 @@ +setup_suite() { + local suite_dir + suite_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" + export UNLEASH_TEST_ROOT="$BATS_SUITE_TMPDIR" + export TMPDIR="$UNLEASH_TEST_ROOT/tmp" + local mock_bin="$UNLEASH_TEST_ROOT/bin" + mkdir -p "$TMPDIR" "$mock_bin" + local tool + for tool in sudo diskutil profiles security launchctl pfctl pkill pgrep killall \ + dscacheutil defaults curl host plutil PlistBuddy dscl fdesetup chflags \ + osascript ioreg ifconfig systemextensionsctl networksetup; do + cp "$suite_dir/helpers/platform.py" "$mock_bin/$tool" + chmod +x "$mock_bin/$tool" + done + export PATH="$mock_bin:$PATH" + export PB="$mock_bin/PlistBuddy" + export VERSION=2.0.0 + export SCRIPT_DIR="$suite_dir/.." + export LIB_DIR="$SCRIPT_DIR/lib" +} diff --git a/tests/test_argument_safety.bats b/tests/test_argument_safety.bats new file mode 100644 index 0000000..73bf037 --- /dev/null +++ b/tests/test_argument_safety.bats @@ -0,0 +1,102 @@ +#!/usr/bin/env bats + +run_cli() { + local script="$1"; shift + local definitions="$BATS_TEST_TMPDIR/${script##*/}.functions" + sed '/^main "\$@"$/d' "$script" > "$definitions" + run "${UNLEASH_TEST_SHELL:-bash}" -u -c ' + source "$1" + shift + load_config() { :; } + is_root() { return 1; } + is_recovery() { return 1; } + cmd_interactive_normal() { printf "interactive verbose=%s\n" "$VERBOSE"; } + main "$@" + ' "$script" "$definitions" "$@" +} + +run_capture() { + local script="$1"; shift + local definitions="$BATS_TEST_TMPDIR/${script##*/}.functions" + sed '/^main "\$@"$/d' "$script" > "$definitions" + run "${UNLEASH_TEST_SHELL:-bash}" -u -c ' + source "$1" + shift + load_config() { :; } + cmd_config() { + printf "dry=%s verbose=%s log=<%s>\nargc=%s\n" "$DRY_RUN" "$VERBOSE" "$LOG_FILE" "$#" + printf "<%s>\n" "$@" + } + main "$@" + ' "$script" "$definitions" "$@" +} + +@test "optional CLI arguments reach usage or privilege guards under nounset" { + local entrypoint + for entrypoint in unleash unleash-standalone.sh; do + local script="$BATS_TEST_DIRNAME/../$entrypoint" + run_cli "$script" audit + [ "$status" -ne 0 ]; [[ "$output" == *"Audit needs sudo"* ]] + run_cli "$script" --log-file + [ "$status" -ne 0 ]; [[ "$output" == *"--log-file requires a path"* ]] + run_cli "$script" monitor --webhook + [ "$status" -ne 0 ]; [[ "$output" == *"--webhook requires a URL"* ]] + run_cli "$script" config set + [ "$status" -ne 0 ]; [[ "$output" == *"Usage: ./unleash config set KEY VALUE"* ]] + run_cli "$script" config unset + [ "$status" -ne 0 ]; [[ "$output" == *"Usage: ./unleash config unset KEY"* ]] + done +} + +@test "CLI values retain spaces quotes empty strings and literal shell syntax" { + local entrypoint value + for entrypoint in unleash unleash-standalone.sh; do + for value in 'a b $(printf injected) "quoted"' ''; do + run_capture "$BATS_TEST_DIRNAME/../$entrypoint" config set LOG_FILE "$value" + [ "$status" -eq 0 ] + local expected + expected=$(printf 'dry=false verbose=false log=<>\nargc=4\n\n\n\n<%s>' "$value") + [ "$output" = "$expected" ] + done + done +} + +@test "global flags around the command persist in the command shell" { + local entrypoint + for entrypoint in unleash unleash-standalone.sh; do + run_capture "$BATS_TEST_DIRNAME/../$entrypoint" --dry-run config --verbose set LOG_FILE value --log-file 'a b.log' + [ "$status" -eq 0 ] + [[ "$output" == 'dry=true verbose=true log='* ]] + [[ "$output" == *'argc=4'* ]] + done +} + +@test "global flags without a command preserve an empty argument list" { + local entrypoint + for entrypoint in unleash unleash-standalone.sh; do + run_cli "$BATS_TEST_DIRNAME/../$entrypoint" --verbose + [ "$status" -eq 0 ] + [ "$output" = 'interactive verbose=true' ] + done +} + +@test "CLI option terminator preserves values that look like global options" { + local entrypoint + for entrypoint in unleash unleash-standalone.sh; do + run_capture "$BATS_TEST_DIRNAME/../$entrypoint" config set LOG_LEVEL -- --verbose + [ "$status" -eq 0 ] + [[ "$output" == 'dry=false verbose=false log=<>'* ]] + [[ "$output" == *'<--verbose>' ]] + done +} + +@test "log-file rejects an empty path or another option as its missing value" { + local entrypoint value + for entrypoint in unleash unleash-standalone.sh; do + for value in '' --dry-run; do + run_cli "$BATS_TEST_DIRNAME/../$entrypoint" --log-file "$value" version + [ "$status" -ne 0 ] + [[ "$output" == *"--log-file requires a path"* ]] + done + done +} diff --git a/tests/test_colors.bats b/tests/test_colors.bats index 424b12f..8608483 100644 --- a/tests/test_colors.bats +++ b/tests/test_colors.bats @@ -2,6 +2,7 @@ # Tests for colors.sh - run with: bats tests/test_colors.bats setup() { + bats_require_minimum_version 1.5.0 load '../lib/colors.sh' TEST_LOG=$(mktemp) } @@ -39,3 +40,40 @@ teardown() { [ "$status" -eq 0 ] echo "$output" | grep -q "Test Title" } + +@test "header draws a valid Unicode border for the title width" { + run header Mac + [ "$status" -eq 0 ] + [[ "$output" == *"╔═══════╗"* ]] + [[ "$output" == *"╚═══════╝"* ]] +} + +@test "diagnostics use stderr without contaminating helper return values" { + local source_file + for source_file in lib/colors.sh unleash-standalone.sh; do + run --separate-stderr bash -u -c ' + source <(sed "/^error_exit()/,\$d" "$1") + volume_path() { + log INFO "Locating Data volume" + log OK "Data volume found" + printf "%s\n" "/Volumes/Work Data" + } + result=$(volume_path) + printf "%s\n" "$result" + ' bash "$BATS_TEST_DIRNAME/../$source_file" + + [ "$status" -eq 0 ] + [ "$output" = "/Volumes/Work Data" ] + [[ "$stderr" == *"Locating Data volume"* ]] + [[ "$stderr" == *"Data volume found"* ]] + done +} + +@test "diagnostics still reach the log file when stdout is captured" { + LOG_FILE="$TEST_LOG" + local result + result=$(log WARN "Review the selected volume" 2>/dev/null) + + [ -z "$result" ] + grep -q 'Review the selected volume' "$TEST_LOG" +} diff --git a/tests/test_config.bats b/tests/test_config.bats index e4c60a9..8019477 100644 --- a/tests/test_config.bats +++ b/tests/test_config.bats @@ -35,3 +35,22 @@ teardown() { run grep -c "KEY=new" "$CONFIG_FILE" [ "$output" -eq 1 ] } + +@test "config preserves spaces and literal replacement characters" { + local value='/tmp/Unleash logs/quoted "name" & \tail' + save_config LOG_FILE old + save_config LOG_FILE "$value" + LOG_FILE='' + load_config + [ "$LOG_FILE" = "$value" ] +} + +@test "config unset preserves other keys" { + save_config WEBHOOK 'https://example.com/a?x=1&y=2' + save_config LOG_LEVEL verbose + run cmd_config config unset LOG_LEVEL + [ "$status" -eq 0 ] + run grep -c '^LOG_LEVEL=' "$CONFIG_FILE" + [ "$status" -eq 1 ] + grep -q '^WEBHOOK=https://example.com/a?x=1&y=2$' "$CONFIG_FILE" +} diff --git a/tests/test_detect.bats b/tests/test_detect.bats index bc20503..11bad39 100644 --- a/tests/test_detect.bats +++ b/tests/test_detect.bats @@ -5,14 +5,11 @@ setup() { load '../lib/detect.sh' } -@test "is_root returns true when EUID is 0" { - [ "$EUID" -eq 0 ] && skip "Already root" - [ "$EUID" -ne 0 ] && skip "Not root" -} - -@test "is_root returns false when EUID is not 0" { - [ "$EUID" -ne 0 ] && skip "Not root (expected)" - [ "$EUID" -eq 0 ] && skip "Is root" +@test "is_root reports whether the effective user is root" { + local expected=1 + [ "$EUID" -ne 0 ] || expected=0 + run is_root + [ "$status" -eq "$expected" ] } @test "is_recovery returns false in normal environment" { @@ -26,6 +23,9 @@ setup() { } @test "resolve_data_volume errors on non-existent device" { - run resolve_data_volume 2>/dev/null || true - [ "$status" -eq 0 ] + read() { echo PROMPT_WAS_REACHED; return 1; } + run resolve_data_volume /dev/null || true + mkdir -p "$BATS_TEST_TMPDIR/Users/test/Library/LaunchAgents" + local agents="$BATS_TEST_TMPDIR/Users/test/Library/LaunchAgents" + echo mdm > "$agents/enrollment.plist" + echo normal > "$agents/normal.plist" + run harden_live_os "$BATS_TEST_TMPDIR" [ "$status" -eq 0 ] + [ ! -f "$agents/enrollment.plist" ] + [ -f "$agents/normal.plist" ] } @test "harden_status exits cleanly" { diff --git a/tests/test_history.bats b/tests/test_history.bats index e4aec19..e6b97ec 100644 --- a/tests/test_history.bats +++ b/tests/test_history.bats @@ -6,11 +6,13 @@ setup() { } @test "show_history exits cleanly with no logs" { - run show_history 2>/dev/null || true + run show_history "$BATS_TEST_TMPDIR" [ "$status" -eq 0 ] } @test "clear_history does not error with no logs" { - run clear_history 2>/dev/null || true + echo event > "$BATS_TEST_TMPDIR/unleash-monitor.log" + run clear_history "$BATS_TEST_TMPDIR" [ "$status" -eq 0 ] + [ ! -s "$BATS_TEST_TMPDIR/unleash-monitor.log" ] } diff --git a/tests/test_lint.bats b/tests/test_lint.bats new file mode 100644 index 0000000..9c0a66f --- /dev/null +++ b/tests/test_lint.bats @@ -0,0 +1,48 @@ +#!/usr/bin/env bats + +setup() { + PROJECT="$BATS_TEST_TMPDIR/project" + mkdir -p "$PROJECT/scripts" "$PROJECT/lib" + cp "$BATS_TEST_DIRNAME/../scripts/check-shell.py" "$PROJECT/scripts/" + cat > "$PROJECT/unleash" <<'SH' +#!/bin/bash +for _lib in sample; do + source "lib/$_lib.sh" +done +sample +SH + printf 'sample() { :; }\n' > "$PROJECT/lib/sample.sh" + printf '#!/bin/bash\n' > "$PROJECT/unleash-standalone.sh" +} + +@test "lint reports sourced module findings without executing the application" { + export LINT_TEST_MARKER="$BATS_TEST_TMPDIR/app-executed" + printf 'sample() { echo $missing; }\n: > "$LINT_TEST_MARKER"\n' > "$PROJECT/lib/sample.sh" + run python3 "$PROJECT/scripts/check-shell.py" + [ "$status" -ne 0 ] + [[ "$output" == *"lib/sample.sh:1:"* ]] + [[ "$output" == *"SC2086"* ]] + [ ! -f "$LINT_TEST_MARKER" ] +} + +@test "lint checks syntax in every library" { + printf 'sample() {\n' > "$PROJECT/lib/sample.sh" + run python3 "$PROJECT/scripts/check-shell.py" + [ "$status" -ne 0 ] + [[ "$output" == *"sample.sh"* ]] +} + +@test "lint does not install tools after an analysis failure" { + cp "$BATS_TEST_DIRNAME/../Makefile" "$PROJECT/Makefile" + local mock_bin="$BATS_TEST_TMPDIR/lint-bin" + mkdir -p "$mock_bin" + ln -s "$(command -v python3)" "$mock_bin/python3" + ln -s "$(command -v bash)" "$mock_bin/bash" + printf '#!/bin/sh\nprintf "[]"\nexit 1\n' > "$mock_bin/shellcheck" + export TEST_BREW_MARKER="$BATS_TEST_TMPDIR/brew-called" + printf '#!/bin/sh\n: > "$TEST_BREW_MARKER"\n' > "$mock_bin/brew" + chmod +x "$mock_bin/shellcheck" "$mock_bin/brew" + run env PATH="$mock_bin" "$(command -v make)" -C "$PROJECT" lint + [ "$status" -ne 0 ] + [ ! -f "$TEST_BREW_MARKER" ] +} diff --git a/tests/test_ma_detect.bats b/tests/test_ma_detect.bats index 1f2a9d0..644641c 100644 --- a/tests/test_ma_detect.bats +++ b/tests/test_ma_detect.bats @@ -3,14 +3,26 @@ setup() { load '../lib/colors.sh' load '../lib/ma_detect.sh' + mkdir -p "$BATS_TEST_TMPDIR/Users" } @test "detect_migration_assistant exits cleanly" { - run detect_migration_assistant 2>/dev/null || true + run detect_migration_assistant "$BATS_TEST_TMPDIR" [ "$status" -eq 0 ] } @test "clean_ma_artifacts does not error without users" { - run clean_ma_artifacts 2>/dev/null || true + run clean_ma_artifacts "$BATS_TEST_TMPDIR" [ "$status" -eq 0 ] } + +@test "migration audit detects enrollment and MDM cache directories" { + local caches="$BATS_TEST_TMPDIR/Users/test/Library/Caches" + mkdir -p "$caches/com.apple.enrollmenttool" "$caches/com.apple.mdm" + echo cached > "$caches/com.apple.enrollmenttool/record" + echo cached > "$caches/com.apple.mdm/record" + run detect_migration_assistant "$BATS_TEST_TMPDIR" + [ "$status" -eq 1 ] + [[ "$output" == *"enrollment cache files"* ]] + [[ "$output" == *"MDM cache files"* ]] +} diff --git a/tests/test_monitor.bats b/tests/test_monitor.bats index 60765e7..5c414b6 100644 --- a/tests/test_monitor.bats +++ b/tests/test_monitor.bats @@ -2,8 +2,10 @@ setup() { load '../lib/colors.sh' + load '../lib/launchd.sh' load '../lib/monitor.sh' TEST_DIR=$(mktemp -d) + SCRIPT_PATH="$TEST_DIR/unleash" } teardown() { @@ -11,12 +13,12 @@ teardown() { } @test "monitor_status exits cleanly when not running" { - run monitor_status 2>/dev/null || true + run monitor_status "$TEST_DIR/monitor.pid" [ "$status" -eq 0 ] } @test "stop_monitor exits cleanly when not running" { - run stop_monitor 2>/dev/null || true + run stop_monitor "$TEST_DIR/monitor.pid" [ "$status" -eq 0 ] } diff --git a/tests/test_persistence.bats b/tests/test_persistence.bats new file mode 100644 index 0000000..fac58a8 --- /dev/null +++ b/tests/test_persistence.bats @@ -0,0 +1,48 @@ +#!/usr/bin/env bats + +check_daemon_path() { + local installer="$1" action="$2" label="$3" + local entrypoint + for entrypoint in unleash unleash-standalone.sh; do + local folder="$BATS_TEST_TMPDIR/$entrypoint/Tool Folder & \"quoted\"" + local target="$BATS_TEST_TMPDIR/$entrypoint/Target" + local script="$folder/renamed standalone.sh" + local definitions="$BATS_TEST_TMPDIR/$entrypoint.functions" + mkdir -p "$folder" "$target/Library" + printf '#!/bin/bash\nprintf "ACTION=%%s\\n" "$1"\n' > "$script" + if [ "$entrypoint" = unleash ]; then + ln -s "$BATS_TEST_DIRNAME/../lib" "$folder/lib" + fi + sed '/^main "\$@"$/d' "$BATS_TEST_DIRNAME/../$entrypoint" > "$definitions" + run "${UNLEASH_TEST_SHELL:-bash}" -u -c ' + unset SCRIPT_DIR SCRIPT_PATH + source "$1" + expected="$2/Library/LaunchDaemons" + mkdir() { + [ "$#" -eq 2 ] && [ "$1" = -p ] && [ "$2" = "$expected" ] || return 97 + command mkdir "$@" + } + "$3" "$2" + ' "$script" "$definitions" "$target" "$installer" + [ "$status" -eq 0 ] + run python3 - "$target/Library/LaunchDaemons/$label.plist" "$script" "$action" <<'PY' +import plistlib,subprocess,sys +with open(sys.argv[1],'rb') as source: + data=plistlib.load(source) +expected=['/bin/bash',sys.argv[2],sys.argv[3]] +assert data['ProgramArguments']==expected, data['ProgramArguments'] +result=subprocess.run(expected,capture_output=True,text=True,timeout=5) +assert result.returncode==0, result.stderr +assert result.stdout=='ACTION='+sys.argv[3]+'\n', result.stdout +PY + [ "$status" -eq 0 ] + done +} + +@test "persistence invokes renamed scripts with spaces and XML text literally" { + check_daemon_path install_persist_launchdaemon heal com.unleash.heal +} + +@test "monitor invokes renamed scripts with spaces and XML text literally" { + check_daemon_path install_monitor_launchdaemon monitor com.unleash.monitor +} diff --git a/tests/test_status.bats b/tests/test_status.bats index aad8478..a0733e8 100644 --- a/tests/test_status.bats +++ b/tests/test_status.bats @@ -26,3 +26,47 @@ teardown() { run deep_status_json 2>/dev/null || true echo "$output" | grep -q "}" } + +@test "deep_status_json counts a single matching process without subtracting it" { + profiles() { + if [ "$1" = -C ]; then echo 'ProfileDisplayName'; + else echo 'MDM enrollment: No'; fi + } + sudo() { "$@"; } + pgrep() { echo '42 mdmclient'; } + ps() { echo 'test 42 0.0 0.0 1 1 ? S 00:00 0:00 mdmclient'; } + run deep_status_json + [ "$status" -eq 0 ] + echo "$output" | python3 -c 'import json,sys; assert json.load(sys.stdin)["running_mdm_processes"] == 1' +} + +@test "text audit completes with zero profiles under nounset" { + run "${UNLEASH_TEST_SHELL:-bash}" -u -c ' + source "$1/lib/colors.sh" + source "$1/lib/status.sh" + pf_status() { :; } + deep_status + ' bash "$BATS_TEST_DIRNAME/.." + [ "$status" -eq 0 ] + [[ "$output" == *"Risk:"* ]] + [[ "$output" != *"integer expression expected"* ]] +} + +@test "audit and report JSON contain numeric zero counts under nounset" { + local module function_name field + for module in status report; do + if [ "$module" = status ]; then function_name=deep_status_json; field=profile_count; + else function_name=generate_report_json; field=installed_profiles; fi + run "${UNLEASH_TEST_SHELL:-bash}" -u -c ' + source "$1/lib/colors.sh" + source "$1/lib/$2.sh" + grep() { + if [ "${1:-}" = -c ] && [ "${3:-}" = /private/etc/hosts ]; then echo 0; return 1; fi + command grep "$@" + } + "$3" + ' bash "$BATS_TEST_DIRNAME/.." "$module" "$function_name" + [ "$status" -eq 0 ] + echo "$output" | python3 -c 'import json,sys; data=json.load(sys.stdin); assert data[sys.argv[1]] == 0; assert data.get("hosts_blocked",0) == 0' "$field" + done +} diff --git a/tests/test_suppress.bats b/tests/test_suppress.bats index 300a1cd..9ccbbfe 100644 --- a/tests/test_suppress.bats +++ b/tests/test_suppress.bats @@ -34,14 +34,21 @@ teardown() { } @test "suppress_enrollment disables daemons" { + TEST_DIR="$BATS_TEST_TMPDIR/volume" DRY_RUN=false suppress_enrollment "$TEST_DIR" 2>/dev/null || true local ldp="$TEST_DIR/private/var/db/com.apple.xpc.launchd/disabled.plist" [ -f "$ldp" ] - run /usr/libexec/PlistBuddy -c "Print :com.apple.ManagedClient.enroll" "$ldp" 2>/dev/null + run "$PB" -c "Print :com.apple.ManagedClient.enroll" "$ldp" [ "$output" = "true" ] } +@test "PlistBuddy fixture rejects writes outside the test suite" { + run "$PB" -c 'Add :test bool true' "$BATS_TEST_DIRNAME/../README.md" + [ "$status" -ne 0 ] + [[ "$output" == *"Fixture refused path outside the suite"* ]] +} + @test "dry-run mode does not write files" { DRY_RUN=true suppress_enrollment "$TEST_DIR" 2>/dev/null || true diff --git a/tests/test_volume_output.bats b/tests/test_volume_output.bats new file mode 100644 index 0000000..7bef25f --- /dev/null +++ b/tests/test_volume_output.bats @@ -0,0 +1,47 @@ +#!/usr/bin/env bats + +check_volume_output() { + local mode="$1" entrypoint + bats_require_minimum_version 1.5.0 + for entrypoint in unleash unleash-standalone.sh; do + local script="$BATS_TEST_DIRNAME/../$entrypoint" + local target="$BATS_TEST_TMPDIR/$entrypoint/Data volume" + mkdir -p "$target/private/var/db/dslocal/nodes/Default" + run --separate-stderr bash -u -c ' + source <(sed '\''/^main "\$@"$/d'\'' "$1") + target="$2"; mode="$3"; mounted="$4" + diskutil() { + case "$*" in + "apfs list") echo "+-- Volume disk5s1 (Data)" ;; + "info /dev/disk5s1") + if [ -f "$mounted" ]; then printf "Mount Point: %s\n" "$target"; + else echo "Mount Point: Not mounted"; fi ;; + "mount /dev/disk5s1") + echo "Mount attempt diagnostic" + [ "$mode" != locked ] || return 1 + touch "$mounted" ;; + "apfs unlockVolume /dev/disk5s1") + echo "Unlocking any cryptographic user" + echo "Unlocked and mounted APFS Volume" + touch "$mounted" ;; + *) return 1 ;; + esac + } + resolve_data_volume + ' "$script" "$script" "$target" "$mode" "$BATS_TEST_TMPDIR/$entrypoint.mounted" + [ "$status" -eq 0 ] + [ "$output" = "$target" ] + [[ "$stderr" == *"Mount attempt diagnostic"* ]] + if [ "$mode" = locked ]; then + [[ "$stderr" == *"Unlocked and mounted APFS Volume"* ]] + fi + done +} + +@test "mount diagnostics stay out of the selected Data volume path" { + check_volume_output unmounted +} + +@test "FileVault unlock diagnostics stay out of the selected Data volume path" { + check_volume_output locked +} diff --git a/unleash b/unleash index 973ec3b..93e1d35 100755 --- a/unleash +++ b/unleash @@ -4,9 +4,10 @@ set -euo pipefail VERSION="2.0.0" SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)" +SCRIPT_PATH="$SCRIPT_DIR/$(basename "$0")" LIB_DIR="$SCRIPT_DIR/lib" -for _lib in colors config detect validate dscl suppress backup status heal firewall harden whitelist check monitor history doctor selfupdate uninstall report ma_detect demo vpn init suggest remediate telemetry predict discord; do +for _lib in colors config detect validate dscl suppress backup status launchd heal firewall harden whitelist check monitor history doctor selfupdate uninstall report ma_detect demo vpn init suggest remediate telemetry predict discord; do _lib_path="$LIB_DIR/$_lib.sh" if [ -f "$_lib_path" ]; then source "$_lib_path" @@ -222,6 +223,7 @@ cmd_dualboot() { echo "" step "Creating admin account on target" + local realName prompt_default realName "Full name" "Apple" local username prompt_username username @@ -236,9 +238,7 @@ cmd_dualboot() { begin "Blocking domains" local hosts_file="$data_path/private/etc/hosts" [ -f "$hosts_file" ] || touch "$hosts_file" - echo "0.0.0.0 deviceenrollment.apple.com" >>"$hosts_file" - echo "0.0.0.0 mdmenrollment.apple.com" >>"$hosts_file" - echo "0.0.0.0 iprofiles.apple.com" >>"$hosts_file" + printf '%s\n' "0.0.0.0 deviceenrollment.apple.com" "0.0.0.0 mdmenrollment.apple.com" "0.0.0.0 iprofiles.apple.com" >>"$hosts_file" end_ok begin "Resetting config profiles" @@ -372,7 +372,9 @@ cmd_monitor() { while [ $# -gt 0 ]; do case "$1" in install|uninstall) args+=("$1"); shift ;; - --webhook) webhook="$2"; shift 2 ;; + --webhook) + if [ $# -lt 2 ] || [ -z "$2" ]; then error_exit "--webhook requires a URL"; fi + webhook="$2"; shift 2 ;; *) args+=("$1"); shift ;; esac done @@ -532,22 +534,29 @@ cmd_interactive_normal() { } parse_global_opts() { - local args=() + PARSED_ARGS=() while [ $# -gt 0 ]; do case "$1" in --verbose) VERBOSE=true; shift ;; --dry-run) DRY_RUN=true; shift ;; - --log-file) LOG_FILE="$2"; shift 2 ;; - *) args+=("$1"); shift ;; + --log-file) + if [ $# -lt 2 ] || [ -z "$2" ]; then error_exit "--log-file requires a path"; fi + case "$2" in --*) error_exit "--log-file requires a path" ;; esac + LOG_FILE="$2"; shift 2 ;; + --) shift; PARSED_ARGS+=("$@"); break ;; + *) PARSED_ARGS+=("$1"); shift ;; esac done - set -- "${args[@]}" - echo "$@" } main() { load_config - eval "set -- $(parse_global_opts "$@")" + parse_global_opts "$@" + if [ "${PARSED_ARGS[0]+present}" = present ]; then + set -- "${PARSED_ARGS[@]}" + else + set -- + fi # Per-command help if [ "${2:-}" = "--help" ] || [ "${2:-}" = "-h" ]; then @@ -564,7 +573,7 @@ main() { firewall|fw) cmd_firewall ;; firewall-off|fw-off) cmd_firewall_off ;; harden) cmd_harden ;; - audit) cmd_audit "$2" ;; + audit) cmd_audit "${2:-}" ;; whitelist|wl) cmd_whitelist ;; backup) cmd_backup ;; restore) cmd_restore ;; @@ -582,13 +591,13 @@ main() { version|-v|--version) cmd_version ;; init) cmd_init ;; suggest) cmd_suggest ;; - remediate) cmd_remediate "$2" ;; - predict) cmd_predict "$2" ;; - telemetry) telemetry_opt_in "$2" ;; + remediate) cmd_remediate "${2:-}" ;; + predict) cmd_predict "${2:-}" ;; + telemetry) telemetry_opt_in "${2:-}" ;; demo) run_demo ;; update) do_self_update ;; uninstall) do_uninstall ;; - report) generate_report "$2" ;; + report) generate_report "${2:-}" ;; config) cmd_config "$@" ;; vpn-kill) vpn_kill_install "$@" ;; vpn-kill-remove) vpn_kill_remove ;; @@ -600,7 +609,7 @@ main() { install_monitor_launchdaemon "" success "Reinstall complete" ;; - discord-bot) cmd_discord_bot_install "$2" "$3" ;; + discord-bot) cmd_discord_bot_install "${2:-}" "${3:-}" ;; discord-bot-stop) cmd_discord_bot_stop ;; discord-bot-status) cmd_discord_bot_status ;; help|-h|--help) show_help; exit 0 ;; diff --git a/unleash-standalone.sh b/unleash-standalone.sh index ea129e0..6456ccf 100755 --- a/unleash-standalone.sh +++ b/unleash-standalone.sh @@ -1,6 +1,8 @@ #!/bin/bash set -euo pipefail VERSION="2.0.0" +SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)" +SCRIPT_PATH="$SCRIPT_DIR/$(basename "$0")" RED='\033[1;31m' GRN='\033[1;32m' BLU='\033[1;34m' @@ -35,7 +37,7 @@ log() { local ts ts=$(date '+%H:%M:%S') - echo -e "${color}[${label}]${NC} ${msg}" + echo -e "${color}[${label}]${NC} ${msg}" >&2 if [ -n "$LOG_FILE" ]; then echo "[${ts}] [${label}] ${msg}" >> "$LOG_FILE" 2>/dev/null || true @@ -43,7 +45,7 @@ log() { } error_exit() { - log "ERROR" "$1" >&2 + log "ERROR" "$1" exit 1 } @@ -71,7 +73,8 @@ header() { local title="$1" local len="${#title}" local line - line=$(printf '%*s' "$((len + 4))" | tr ' ' '═') + line=$(printf '%*s' "$((len + 4))" '') + line="${line// /═}" echo "" echo -e "${CYAN}╔${line}╗${NC}" echo -e "${CYAN}║ ${title} ║${NC}" @@ -110,7 +113,7 @@ prompt_default() { local prompt_text="$2" local default="$3" local value - read -p "${CYAN}${prompt_text}${NC} (default '${default}'): " value + read -r -p "${CYAN}${prompt_text}${NC} (default '${default}'): " value value="${value:=$default}" eval "$var_name=\"$value\"" } @@ -118,7 +121,7 @@ prompt_default() { confirm() { local prompt="$1" local response - read -p "${prompt} (y/N): " response + read -r -p "${prompt} (y/N): " response [[ "$response" =~ ^[Yy]$ ]] } @@ -126,10 +129,9 @@ CONFIG_FILE="$HOME/.unleash.conf" load_config() { [ -f "$CONFIG_FILE" ] || return 0 - - while IFS='=' read -r key value; do + local key value + while IFS='=' read -r key value || [ -n "$key" ]; do key="${key// /}" - value="${value// /}" [ -z "$key" ] && continue case "$key" in WEBHOOK) DISCORD_WEBHOOK="$value" ;; @@ -139,18 +141,29 @@ load_config() { done < "$CONFIG_FILE" } -save_config() { +_rewrite_config() { local key="$1" local value="$2" local tmp - [ -f "$CONFIG_FILE" ] || touch "$CONFIG_FILE" - - if grep -q "^${key}=" "$CONFIG_FILE" 2>/dev/null; then - sed -i '' "s/^${key}=.*/${key}=${value}/" "$CONFIG_FILE" - else - echo "${key}=${value}" >> "$CONFIG_FILE" + tmp=$(mktemp "${CONFIG_FILE}.XXXXXX") || return 1 + if ! UNLEASH_CONFIG_KEY="$key" UNLEASH_CONFIG_VALUE="$value" \ + UNLEASH_CONFIG_OPERATION="${3:-set}" awk ' + BEGIN { key=ENVIRON["UNLEASH_CONFIG_KEY"]; value=ENVIRON["UNLEASH_CONFIG_VALUE"]; + operation=ENVIRON["UNLEASH_CONFIG_OPERATION"] } + index($0, key "=")==1 { if (!found++ && operation=="set") print key "=" value; next } + { print } + END { if (!found && operation=="set") print key "=" value } + ' "$CONFIG_FILE" > "$tmp"; then + rm -f "$tmp" + return 1 fi + mv "$tmp" "$CONFIG_FILE" +} + +save_config() { + local key="$1" value="$2" + _rewrite_config "$key" "$value" || return 1 success "Saved $key to $CONFIG_FILE" } @@ -167,8 +180,8 @@ cmd_config() { cat "$CONFIG_FILE" | sed 's/^/ /' ;; set) - local key="$3" - local value="$4" + local key="${3:-}" + local value="${4:-}" [ -z "$key" ] || [ -z "$value" ] && { info "Usage: ./unleash config set KEY VALUE" info "Keys: WEBHOOK, LOG_LEVEL (verbose), LOG_FILE" @@ -177,10 +190,10 @@ cmd_config() { save_config "$key" "$value" ;; unset) - local key="$3" + local key="${3:-}" [ -z "$key" ] && { info "Usage: ./unleash config unset KEY"; return 1; } if [ -f "$CONFIG_FILE" ]; then - sed -i '' "/^${key}=/d" "$CONFIG_FILE" + _rewrite_config "$key" "" unset || return 1 success "Removed $key from config" fi ;; @@ -223,8 +236,9 @@ resolve_data_volume() { if [ -z "$id" ] || ! diskutil info "/dev/$id" >/dev/null 2>&1; then warn "Auto-detection failed. Available disks:" diskutil list >&2 - echo "" - read -p "Enter Data volume identifier (e.g. disk3s1): " id &2 + [ -t 0 ] || error_exit "Cannot select a Data volume without a terminal." + read -r -p "Enter Data volume identifier (e.g. disk3s1): " id /dev/null || true + diskutil mount "$data_dev" >&2 || true mount_pt=$(_mount_point) fi if [ -z "$mount_pt" ] || [ ! -d "$mount_pt" ]; then warn "FileVault-locked — need to unlock." echo -e "${YEL}Enter password of a user on this Mac (or FileVault recovery key):${NC}" >&2 - diskutil apfs unlockVolume "$data_dev" 2>/dev/null \ + diskutil apfs unlockVolume "$data_dev" >&2 \ || error_exit "Failed to unlock. Re-run with valid credentials." mount_pt=$(_mount_point) fi @@ -279,9 +293,9 @@ detect_system_volume() { resolve_target_volumes() { local base_name data_name - read -p "Enter target system volume name (default 'Macintosh HD'): " base_name + read -r -p "Enter target system volume name (default 'Macintosh HD'): " base_name base_name="${base_name:=Macintosh HD}" - read -p "Enter target data volume name (default 'Macintosh HD - Data'): " data_name + read -r -p "Enter target data volume name (default 'Macintosh HD - Data'): " data_name data_name="${data_name:=Macintosh HD - Data}" local sys_path="/Volumes/$base_name" @@ -315,7 +329,7 @@ prompt_username() { local var_name="$1" local value while true; do - read -p "Username (default 'Apple'): " value + read -r -p "Username (default 'Apple'): " value value="${value:=Apple}" if msg=$(validate_username "$value"); then eval "$var_name=\"$value\"" @@ -330,7 +344,7 @@ prompt_password() { local var_name="$1" local value while true; do - read -p "Password (default '1234'): " value + read -r -p "Password (default '1234'): " value value="${value:=1234}" if msg=$(validate_password "$value"); then eval "$var_name=\"$value\"" @@ -409,7 +423,7 @@ add_to_filevault() { -PB=/usr/libexec/PlistBuddy +PB="${PB:-/usr/libexec/PlistBuddy}" suppress_enrollment() { local data_mount="$1" @@ -555,6 +569,7 @@ full_bypass_mode() { echo "" step "Creating temporary admin account" + local realName prompt_default realName "Full name" "Apple" local username @@ -729,7 +744,8 @@ check_mdm_status() { else echo -e " ${YEL}(none)${NC}" fi - local count; count=$(echo "$matches" | grep -c . 2>/dev/null || echo 0) + local count; count=$(echo "$matches" | grep -c . 2>/dev/null || true) + count="${count:-0}" echo -e " ${CYAN}Total: $count of 13 expected domains blocked${NC}" else echo -e " ${YEL}(hosts not found)${NC}" @@ -771,6 +787,16 @@ check_mdm_status() { fi } +_mdm_agent_names() { + local agent + for agent in "$1/"*; do + [ -f "$agent" ] || continue + if printf '%s\n' "${agent##*/}" | grep -qiE 'mdm|enrollment|managed'; then + printf '%s\n' "${agent##*/}" + fi + done +} + deep_status() { if [ "${1:-}" = "--json" ]; then deep_status_json @@ -781,10 +807,11 @@ deep_status() { step "Installed Configuration Profiles" if command -v profiles &>/dev/null; then local profile_count - profile_count=$(sudo profiles -C -output=xml 2>/dev/null | grep -c "ProfileDisplayName" || echo 0) + profile_count=$(sudo profiles -C -output stdout-xml 2>/dev/null | grep -c "ProfileDisplayName" || true) + profile_count="${profile_count:-0}" if [ "$profile_count" -gt 0 ]; then warn "$profile_count profile(s) installed:" - sudo profiles -C -output=xml 2>/dev/null | grep -A1 "ProfileDisplayName" | grep "" | sed 's/.*\(.*\)<\/string>.*/ - \1/' + sudo profiles -C -output stdout-xml 2>/dev/null | grep -A1 "ProfileDisplayName" | grep "" | sed 's/.*\(.*\)<\/string>.*/ - \1/' else info "No configuration profiles installed" fi @@ -819,10 +846,10 @@ deep_status() { for home in /Users/*/; do [ -d "$home/Library/LaunchAgents" ] || continue local user_agents - user_agents=$(ls "$home/Library/LaunchAgents/" 2>/dev/null | grep -iE "mdm|enrollment|managed" || true) + user_agents=$(_mdm_agent_names "$home/Library/LaunchAgents") if [ -n "$user_agents" ]; then echo -e " ${YEL}$(basename "$home"):${NC}" - echo "$user_agents" | sed 's/^/ /' + while IFS= read -r agent; do printf ' %s\n' "$agent"; done <<< "$user_agents" found=$((found + 1)) fi done @@ -831,9 +858,9 @@ deep_status() { step "MDM LaunchDaemons (System)" local sys_agents - sys_agents=$(ls /Library/LaunchDaemons/ 2>/dev/null | grep -iE "mdm|enrollment|managed" || true) + sys_agents=$(_mdm_agent_names /Library/LaunchDaemons) if [ -n "$sys_agents" ]; then - echo "$sys_agents" | sed 's/^/ /' + while IFS= read -r agent; do printf ' %s\n' "$agent"; done <<< "$sys_agents" else info "No MDM LaunchDaemons found" fi @@ -841,9 +868,9 @@ deep_status() { step "Running MDM Processes" local procs - procs=$(ps aux 2>/dev/null | grep -iE "mdm|managedclient|activation" | grep -v grep || true) + procs=$(pgrep -il "mdm|managedclient|activation" 2>/dev/null || true) if [ -n "$procs" ]; then - echo "$procs" | awk '{print " " $11 " (PID " $2 ")"}' + echo "$procs" | awk '{print " " $2 " (PID " $1 ")"}' else info "No MDM processes running" fi @@ -865,8 +892,12 @@ deep_status() { step "Overall Assessment" local risk="LOW" - [ "$(sudo profiles -C -output=xml 2>/dev/null | grep -c "ProfileDisplayName" || echo 0)" -gt 0 ] && risk="MEDIUM" - ps aux 2>/dev/null | grep -qiE "mdm|managedclient" && risk="HIGH" + local cfg="/private/var/db/ConfigurationProfiles/Settings" + local installed + installed=$(sudo profiles -C -output stdout-xml 2>/dev/null | grep -c "ProfileDisplayName" || true) + installed="${installed:-0}" + [ "$installed" -gt 0 ] && risk="MEDIUM" + pgrep -i "mdm|managedclient" >/dev/null 2>&1 && risk="HIGH" [ -f "$cfg/.cloudConfigRecordFound" ] && risk="CRITICAL" case "$risk" in @@ -885,7 +916,8 @@ deep_status_json() { local profile_count=0 if command -v profiles &>/dev/null; then - profile_count=$(sudo profiles -C -output=xml 2>/dev/null | grep -c "ProfileDisplayName" || echo 0) + profile_count=$(sudo profiles -C -output stdout-xml 2>/dev/null | grep -c "ProfileDisplayName" || true) + profile_count="${profile_count:-0}" fi json="${json} \"profile_count\": $profile_count,\n" @@ -903,9 +935,7 @@ deep_status_json() { json="${json} \"mdm_certificates\": $mdm_certs,\n" local running_procs=0 - running_procs=$(ps aux 2>/dev/null | grep -ciE "mdm|managedclient|activation" || true) - running_procs=$((running_procs - 1)) - [ "$running_procs" -lt 0 ] && running_procs=0 + running_procs=$(pgrep -il "mdm|managedclient|activation" 2>/dev/null | awk 'END {print NR}' || true) json="${json} \"running_mdm_processes\": $running_procs,\n" local risk="LOW" @@ -918,6 +948,14 @@ deep_status_json() { echo -e "$json" } +_launchd_script_path() { + local script_path="${SCRIPT_PATH:-}" + if [ -z "$script_path" ]; then + script_path="$(cd "$(dirname "$0")" && pwd)/$(basename "$0")" + fi + printf '%s' "$script_path" | sed 's/&/\&/g; s//\>/g' +} + heal_suppress() { local data_mount="$1" @@ -990,11 +1028,7 @@ install_persist_launchdaemon() { root="$(_persist_mount_root "$data_mount")" local unleash_src - if [ -n "$SCRIPT_DIR" ]; then - unleash_src="$SCRIPT_DIR/unleash" - else - unleash_src="$(cd "$(dirname "$0")" && pwd)/unleash" - fi + unleash_src=$(_launchd_script_path) step "Installing LaunchDaemon for boot-time persistence..." @@ -1013,8 +1047,8 @@ install_persist_launchdaemon() { ProgramArguments /bin/bash - -c - ${unleash_src} heal + ${unleash_src} + heal RunAtLoad @@ -1037,9 +1071,11 @@ install_persist_launchdaemon() { step "Loading LaunchDaemon..." if command -v launchctl &>/dev/null; then - launchctl load "$plist_path" 2>/dev/null \ - && success "LaunchDaemon loaded (will run on next boot)" \ - || info "LaunchDaemon will load on next boot" + if launchctl load "$plist_path" 2>/dev/null; then + success "LaunchDaemon loaded (will run on next boot)" + else + info "LaunchDaemon will load on next boot" + fi else info "launchctl not available (expected in Recovery) — will load on next boot" fi @@ -1072,7 +1108,8 @@ pf_backup_anchor() { local root="$1" local anchor_file="${root}${FIREWALL_ANCHOR_DIR}/${FIREWALL_ANCHOR}" [ ! -f "$anchor_file" ] && return 0 - local backup="${anchor_file}.backup.$(date +%s)" + local backup + backup="${anchor_file}.backup.$(date +%s)" cp "$anchor_file" "$backup" && info "Backed up pf anchor: $backup" } @@ -1080,7 +1117,8 @@ pf_backup_conf() { local root="$1" local pf_conf="${root}${FIREWALL_CONF}" [ ! -f "$pf_conf" ] && return 0 - local backup="${pf_conf}.backup.$(date +%s)" + local backup + backup="${pf_conf}.backup.$(date +%s)" cp "$pf_conf" "$backup" && info "Backed up pf.conf: $backup" } @@ -1116,10 +1154,7 @@ ANCHOR if grep -q "com.unleash" "$pf_conf" 2>/dev/null; then info "pf.conf already has Unleash anchor" else - echo "" >> "$pf_conf" - echo "# Added by unleash — MDM block" >> "$pf_conf" - echo "$anchor_line" >> "$pf_conf" - echo "$load_line" >> "$pf_conf" + printf '\n%s\n%s\n%s\n' "# Added by unleash — MDM block" "$anchor_line" "$load_line" >> "$pf_conf" success "pf.conf updated" fi else @@ -1144,8 +1179,11 @@ ANCHOR step "Loading pf rules..." if command -v pfctl &>/dev/null; then - pfctl -e -f "$pf_conf" 2>/dev/null && success "pf enabled and rules loaded" \ - || warn "pfctl failed — try: sudo pfctl -e -f $pf_conf" + if pfctl -e -f "$pf_conf" 2>/dev/null; then + success "pf enabled and rules loaded" + else + warn "pfctl failed — try: sudo pfctl -e -f $pf_conf" + fi else warn "pfctl not available" fi @@ -1170,8 +1208,14 @@ remove_pf_mdm_block() { local pf_conf="${root}${FIREWALL_CONF}" if [ -f "$pf_conf" ]; then - sed -i '' '/# Added by unleash/d' "$pf_conf" 2>/dev/null || true - sed -i '' '/com\.unleash/d' "$pf_conf" 2>/dev/null || true + local tmp_conf + tmp_conf=$(mktemp "${pf_conf}.XXXXXX") || return 1 + if ! cp -p "$pf_conf" "$tmp_conf" \ + || ! sed '/# Added by unleash/d; /com\.unleash/d' "$pf_conf" > "$tmp_conf" \ + || ! mv "$tmp_conf" "$pf_conf"; then + rm -f "$tmp_conf" + return 1 + fi success "pf.conf cleaned" fi @@ -1189,9 +1233,11 @@ pf_status() { if command -v pfctl &>/dev/null; then pfctl -si 2>/dev/null | grep -E "Status|Enabled" || echo " pf not enabled" echo "" - pfctl -a "$FIREWALL_ANCHOR" -s rules 2>/dev/null \ - && info "Unleash MDM anchor rules:" \ - || info "No Unleash MDM anchor loaded" + if pfctl -a "$FIREWALL_ANCHOR" -s rules 2>/dev/null; then + info "Unleash MDM anchor rules:" + else + info "No Unleash MDM anchor loaded" + fi else warn "pfctl not available" fi @@ -1213,8 +1259,11 @@ harden_live_os() { local installed installed=$(profiles -C -output=xml 2>/dev/null | grep -c "ProfileDisplayName" || true) if [ "$installed" -gt 0 ]; then - sudo profiles -D -F 2>/dev/null && success "Forced profile removal" \ - || warn "Profile removal failed" + if sudo profiles -D -F 2>/dev/null; then + success "Forced profile removal" + else + warn "Profile removal failed" + fi else info "No installed profiles to remove" fi @@ -1223,8 +1272,8 @@ harden_live_os() { fi step "Cleaning user LaunchAgents..." - local home - for home in /Users/*/; do + local home users_root="${1:-}/Users" + for home in "$users_root/"*/; do [ -d "$home/Library/LaunchAgents" ] || continue local cleaned=0 for agent in "$home/Library/LaunchAgents/"*; do @@ -1234,8 +1283,11 @@ harden_live_os() { cleaned=$((cleaned + 1)) fi done - [ "$cleaned" -gt 0 ] && success "$(basename "$home"): removed $cleaned agent(s)" \ - || info "$(basename "$home"): clean" + if [ "$cleaned" -gt 0 ]; then + success "$(basename "$home"): removed $cleaned agent(s)" + else + info "$(basename "$home"): clean" + fi done step "Flushing DNS cache..." @@ -1269,9 +1321,11 @@ harden_live_os() { step "Disabling iCloud Private Relay (DoH source)..." if command -v defaults &>/dev/null; then - sudo defaults write /Library/Preferences/com.apple.networkextensions.plist PrivateRelayEnabled -bool false 2>/dev/null \ - && success "Private Relay disabled" \ - || info "Private Relay not configurable (expected on some configs)" + if sudo defaults write /Library/Preferences/com.apple.networkextensions.plist PrivateRelayEnabled -bool false 2>/dev/null; then + success "Private Relay disabled" + else + info "Private Relay not configurable (expected on some configs)" + fi fi echo "" @@ -1295,7 +1349,7 @@ harden_status() { launchctl list 2>/dev/null | grep -iE "mdm|managed|enrollment|activation" || info "None loaded" step "Running MDM processes..." - ps aux 2>/dev/null | grep -iE "mdm|managedclient|activation" | grep -v grep || info "None running" + pgrep -il "mdm|managedclient|activation" 2>/dev/null || info "None running" } MDM_BLOCKLIST="mdmenrollment.apple.com deviceenrollment.apple.com iprofiles.apple.com" @@ -1311,7 +1365,7 @@ install_selective_block() { local anchor_file="${anchor_dir}/com.unleash.selective" mkdir -p "$anchor_dir" - > "$anchor_file" + : > "$anchor_file" for d in $MDM_BLOCKLIST; do for ip in $(host -t a "$d" 2>/dev/null | awk '/has address/{print $NF}'); do @@ -1333,10 +1387,7 @@ install_selective_block() { if grep -q "com.unleash.selective" "$pf_conf" 2>/dev/null; then info "pf.conf already has selective anchor" else - echo "" >> "$pf_conf" - echo "# Added by unleash — selective MDM block (iCloud-safe)" >> "$pf_conf" - echo "$anchor_line" >> "$pf_conf" - echo "$load_line" >> "$pf_conf" + printf '\n%s\n%s\n%s\n' "# Added by unleash — selective MDM block (iCloud-safe)" "$anchor_line" "$load_line" >> "$pf_conf" success "pf.conf updated with selective rules" fi else @@ -1356,8 +1407,11 @@ EOF fi if command -v pfctl &>/dev/null; then - pfctl -e -f "$pf_conf" 2>/dev/null && success "pf rules loaded (iCloud should work)" \ - || warn "pfctl failed" + if pfctl -e -f "$pf_conf" 2>/dev/null; then + success "pf rules loaded (iCloud should work)" + else + warn "pfctl failed" + fi fi } @@ -1504,11 +1558,7 @@ install_monitor_launchdaemon() { [ -n "$data_mount" ] && root="$data_mount" local unleash_src - if [ -n "$SCRIPT_DIR" ]; then - unleash_src="$SCRIPT_DIR/unleash" - else - unleash_src="$(cd "$(dirname "$0")" && pwd)/unleash" - fi + unleash_src=$(_launchd_script_path) step "Installing monitor LaunchDaemon..." @@ -1526,8 +1576,8 @@ install_monitor_launchdaemon() { ProgramArguments /bin/bash - -c - ${unleash_src} monitor + ${unleash_src} + monitor RunAtLoad @@ -1547,9 +1597,11 @@ PLIST success "Monitor LaunchDaemon: $plist_path" if command -v launchctl &>/dev/null; then - launchctl load "$plist_path" 2>/dev/null \ - && success "Monitor loaded (starts at boot)" \ - || info "Will load on next boot" + if launchctl load "$plist_path" 2>/dev/null; then + success "Monitor loaded (starts at boot)" + else + info "Will load on next boot" + fi fi } @@ -1670,7 +1722,7 @@ monitor_mdm() { } stop_monitor() { - local pidfile="/tmp/unleash-monitor.pid" + local pidfile="${1:-/tmp/unleash-monitor.pid}" if [ -f "$pidfile" ]; then local pid pid=$(cat "$pidfile") @@ -1687,7 +1739,7 @@ stop_monitor() { } monitor_status() { - local pidfile="/tmp/unleash-monitor.pid" + local pidfile="${1:-/tmp/unleash-monitor.pid}" if [ -f "$pidfile" ] && kill -0 "$(cat "$pidfile")" 2>/dev/null; then echo -e "${GRN}Monitor running (PID $(cat "$pidfile"))${NC}" tail -5 /var/log/unleash-monitor.log 2>/dev/null || echo " (no log entries yet)" @@ -1699,7 +1751,8 @@ monitor_status() { show_history() { header "Unleash Event History" - local logs=("/var/log/unleash-monitor.log" "/var/log/unleash-heal.log" "/var/log/unleash-monitor.err") + local log_dir="${1:-/var/log}" + local logs=("$log_dir/unleash-monitor.log" "$log_dir/unleash-heal.log" "$log_dir/unleash-monitor.err") local found=false for logfile in "${logs[@]}"; do @@ -1732,7 +1785,8 @@ show_history() { } clear_history() { - local logs=("/var/log/unleash-monitor.log" "/var/log/unleash-heal.log" "/var/log/unleash-monitor.err") + local log_dir="${1:-/var/log}" + local logs=("$log_dir/unleash-monitor.log" "$log_dir/unleash-heal.log" "$log_dir/unleash-monitor.err") for logfile in "${logs[@]}"; do if [ -f "$logfile" ]; then : > "$logfile" @@ -1925,7 +1979,7 @@ do_self_update() { fi end_ok; echo " Latest: v$latest_tag" - if [ "v$latest_tag" = "$(echo "v$VERSION")" ]; then + if [ "v$latest_tag" = "v$VERSION" ]; then success "Already up to date (v$VERSION)" rm -rf "$tmp_dir" return 0 @@ -2108,10 +2162,11 @@ generate_report() { step "Installed Profiles" if command -v profiles &>/dev/null; then local count - count=$(sudo profiles -C -output=xml 2>/dev/null | grep -c "ProfileDisplayName" || echo 0) + count=$(sudo profiles -C -output stdout-xml 2>/dev/null | grep -c "ProfileDisplayName" || true) + count="${count:-0}" if [ "$count" -gt 0 ]; then echo " $count profile(s) installed" - sudo profiles -C -output=xml 2>/dev/null | grep -A1 "ProfileDisplayName" | grep "" \ + sudo profiles -C -output stdout-xml 2>/dev/null | grep -A1 "ProfileDisplayName" | grep "" \ | sed 's/.*\(.*\)<\/string>.*/ - \1/' else echo " No profiles installed" @@ -2156,7 +2211,8 @@ generate_report() { step "Hosts Block" if grep -q "iprofiles.apple.com" /private/etc/hosts 2>/dev/null; then local blocked - blocked=$(grep -c "0.0.0.0" /private/etc/hosts 2>/dev/null || echo 0) + blocked=$(grep -c "0.0.0.0" /private/etc/hosts 2>/dev/null || true) + blocked="${blocked:-0}" echo " $blocked domain(s) blocked in /etc/hosts" else echo " No block entries found" @@ -2165,9 +2221,9 @@ generate_report() { step "Running MDM Processes" local procs - procs=$(ps aux 2>/dev/null | grep -iE "mdm|managedclient|activation" | grep -v grep || true) + procs=$(pgrep -il "mdm|managedclient|activation" 2>/dev/null || true) if [ -n "$procs" ]; then - echo "$procs" | awk '{print " " $11 " (PID " $2 ")"}' + echo "$procs" | awk '{print " " $2 " (PID " $1 ")"}' else echo " None" fi @@ -2195,7 +2251,8 @@ generate_report_json() { local profile_count=0 if command -v profiles &>/dev/null; then - profile_count=$(sudo profiles -C -output=xml 2>/dev/null | grep -c "ProfileDisplayName" || echo 0) + profile_count=$(sudo profiles -C -output stdout-xml 2>/dev/null | grep -c "ProfileDisplayName" || true) + profile_count="${profile_count:-0}" fi report="${report} \"installed_profiles\": $profile_count,\n" @@ -2225,7 +2282,8 @@ generate_report_json() { report="${report} },\n" local hosts_blocked=0 - hosts_blocked=$(grep -c "0.0.0.0" /private/etc/hosts 2>/dev/null || echo 0) + hosts_blocked=$(grep -c "0.0.0.0" /private/etc/hosts 2>/dev/null || true) + hosts_blocked="${hosts_blocked:-0}" report="${report} \"hosts_blocked\": $hosts_blocked\n" report="${report}}" @@ -2233,6 +2291,14 @@ generate_report_json() { echo -e "$report" } +_has_matching_path() { + local path + for path in "$@"; do + [ ! -e "$path" ] || return 0 + done + return 1 +} + detect_configurator_enrollment() { local data_mount="${1:-}" @@ -2315,8 +2381,13 @@ detect_migration_assistant() { local user_agents="$home/Library/LaunchAgents" if [ -d "$user_agents" ]; then - local found - found=$(ls "$user_agents" 2>/dev/null | grep -ciE "mdm|enrollment|managed" || true) + local found=0 agent + for agent in "$user_agents/"*; do + [ -f "$agent" ] || continue + if printf '%s\n' "${agent##*/}" | grep -qiE 'mdm|enrollment|managed'; then + found=$((found + 1)) + fi + done if [ "$found" -gt 0 ]; then ma_indicators=$((ma_indicators + found)) details="$details $user: $found MDM LaunchAgent(s)\n" @@ -2325,9 +2396,7 @@ detect_migration_assistant() { local prefs="$home/Library/Preferences" if [ -d "$prefs" ]; then - local mdm_prefs - mdm_prefs=$(ls "$prefs"/com.apple.mdm* "$prefs"/com.apple.ManagedClient* 2>/dev/null | head -3 || true) - if [ -n "$mdm_prefs" ]; then + if _has_matching_path "$prefs"/com.apple.mdm* "$prefs"/com.apple.ManagedClient*; then ma_indicators=$((ma_indicators + 1)) details="$details $user: MDM preference files\n" fi @@ -2341,16 +2410,12 @@ detect_migration_assistant() { local caches="$home/Library/Caches" if [ -d "$caches" ]; then - local enrollment_cache - enrollment_cache=$(ls "$caches"/com.apple.enrollment* 2>/dev/null | head -3 || true) - if [ -n "$enrollment_cache" ]; then + if _has_matching_path "$caches"/com.apple.enrollment*; then ma_indicators=$((ma_indicators + 1)) details="$details $user: enrollment cache files\n" fi - local mdmd_cache - mdmd_cache=$(ls "$caches"/com.apple.mdm* 2>/dev/null | head -3 || true) - if [ -n "$mdmd_cache" ]; then + if _has_matching_path "$caches"/com.apple.mdm*; then ma_indicators=$((ma_indicators + 1)) details="$details $user: MDM cache files\n" fi @@ -2548,14 +2613,14 @@ RULES if grep -q "vpn-kill" "$pf_conf" 2>/dev/null; then info "pf.conf already has VPN kill-switch anchor" else - echo "" >> "$pf_conf" - echo "# Added by unleash — VPN kill-switch (prevents MDM leaks)" >> "$pf_conf" - echo "$anchor_line" >> "$pf_conf" - echo "$load_line" >> "$pf_conf" + printf '\n%s\n%s\n%s\n' "# Added by unleash — VPN kill-switch (prevents MDM leaks)" "$anchor_line" "$load_line" >> "$pf_conf" fi - pfctl -e -f "$pf_conf" 2>/dev/null && success "VPN kill-switch active" \ - || warn "pfctl failed" + if pfctl -e -f "$pf_conf" 2>/dev/null; then + success "VPN kill-switch active" + else + warn "pfctl failed" + fi echo "" info "What this does:" @@ -2813,6 +2878,7 @@ cmd_dualboot() { echo "" step "Creating admin account on target" + local realName prompt_default realName "Full name" "Apple" local username prompt_username username @@ -2827,9 +2893,7 @@ cmd_dualboot() { begin "Blocking domains" local hosts_file="$data_path/private/etc/hosts" [ -f "$hosts_file" ] || touch "$hosts_file" - echo "0.0.0.0 deviceenrollment.apple.com" >>"$hosts_file" - echo "0.0.0.0 mdmenrollment.apple.com" >>"$hosts_file" - echo "0.0.0.0 iprofiles.apple.com" >>"$hosts_file" + printf '%s\n' "0.0.0.0 deviceenrollment.apple.com" "0.0.0.0 mdmenrollment.apple.com" "0.0.0.0 iprofiles.apple.com" >>"$hosts_file" end_ok begin "Resetting config profiles" @@ -2963,7 +3027,9 @@ cmd_monitor() { while [ $# -gt 0 ]; do case "$1" in install|uninstall) args+=("$1"); shift ;; - --webhook) webhook="$2"; shift 2 ;; + --webhook) + if [ $# -lt 2 ] || [ -z "$2" ]; then error_exit "--webhook requires a URL"; fi + webhook="$2"; shift 2 ;; *) args+=("$1"); shift ;; esac done @@ -3123,22 +3189,29 @@ cmd_interactive_normal() { } parse_global_opts() { - local args=() + PARSED_ARGS=() while [ $# -gt 0 ]; do case "$1" in --verbose) VERBOSE=true; shift ;; --dry-run) DRY_RUN=true; shift ;; - --log-file) LOG_FILE="$2"; shift 2 ;; - *) args+=("$1"); shift ;; + --log-file) + if [ $# -lt 2 ] || [ -z "$2" ]; then error_exit "--log-file requires a path"; fi + case "$2" in --*) error_exit "--log-file requires a path" ;; esac + LOG_FILE="$2"; shift 2 ;; + --) shift; PARSED_ARGS+=("$@"); break ;; + *) PARSED_ARGS+=("$1"); shift ;; esac done - set -- "${args[@]}" - echo "$@" } main() { load_config - eval "set -- $(parse_global_opts "$@")" + parse_global_opts "$@" + if [ "${PARSED_ARGS[0]+present}" = present ]; then + set -- "${PARSED_ARGS[@]}" + else + set -- + fi # Per-command help if [ "${2:-}" = "--help" ] || [ "${2:-}" = "-h" ]; then @@ -3155,7 +3228,7 @@ main() { firewall|fw) cmd_firewall ;; firewall-off|fw-off) cmd_firewall_off ;; harden) cmd_harden ;; - audit) cmd_audit "$2" ;; + audit) cmd_audit "${2:-}" ;; whitelist|wl) cmd_whitelist ;; backup) cmd_backup ;; restore) cmd_restore ;; @@ -3173,13 +3246,13 @@ main() { version|-v|--version) cmd_version ;; init) cmd_init ;; suggest) cmd_suggest ;; - remediate) cmd_remediate "$2" ;; - predict) cmd_predict "$2" ;; - telemetry) telemetry_opt_in "$2" ;; + remediate) cmd_remediate "${2:-}" ;; + predict) cmd_predict "${2:-}" ;; + telemetry) telemetry_opt_in "${2:-}" ;; demo) run_demo ;; update) do_self_update ;; uninstall) do_uninstall ;; - report) generate_report "$2" ;; + report) generate_report "${2:-}" ;; config) cmd_config "$@" ;; vpn-kill) vpn_kill_install "$@" ;; vpn-kill-remove) vpn_kill_remove ;; @@ -3191,7 +3264,7 @@ main() { install_monitor_launchdaemon "" success "Reinstall complete" ;; - discord-bot) cmd_discord_bot_install "$2" "$3" ;; + discord-bot) cmd_discord_bot_install "${2:-}" "${3:-}" ;; discord-bot-stop) cmd_discord_bot_stop ;; discord-bot-status) cmd_discord_bot_status ;; help|-h|--help) show_help; exit 0 ;;