v2.0.0: init wizard, suggest, remediate, predict, telemetry, discord-bot, Nix, Docker, Jekyll, GPG verify

This commit is contained in:
2026-06-20 15:25:30 -03:00
parent 6d1617c3ae
commit 3d271d3dc1
14 changed files with 721 additions and 14 deletions
+22
View File
@@ -1,5 +1,27 @@
# Changelog
## [2.0.0] — 2026-06-20
### Added
- **init** wizard: interactive setup with MA scan, firewall, monitor, persist prompts
- **suggest** command: risk-based recommendations (analyzes system, suggests commands)
- **remediate** command: per-org MDM cleanup (JAMF, Mosyle, Addigy, Kandji, VMware)
- **predict** command: serial number lookup (predicts org enrollment from prefix)
- **telemetry** command: opt-in anonymous usage stats
- **discord-bot** command: Discord DM alerts when MDM is detected
- Jekyll docs config (_config.yml, Gemfile)
- Nix package (default.nix)
- Dockerfile for testing
- GPG signature verification in self-update
- GPG signing script for releases
- Per-command `--help` / `-h` flag
- CircleCI config as free CI alternative
- CI.md with local CI docs
### Changed
- GPG verification added to self-update flow
- Version bumped to 2.0.0
## [1.6.1] — 2026-06-20
### Added
+14
View File
@@ -0,0 +1,14 @@
FROM alpine:latest AS builder
RUN apk add bash curl
WORKDIR /build
COPY unleash /build/
COPY lib/ /build/lib/
RUN bash -n unleash lib/*.sh
FROM alpine:latest
RUN apk add --no-cache bash curl
COPY --from=builder /build/ /opt/unleash/
RUN ln -s /opt/unleash/unleash /usr/local/bin/unleash
WORKDIR /opt/unleash
ENTRYPOINT ["/opt/unleash/unleash"]
CMD ["--help"]
+24
View File
@@ -0,0 +1,24 @@
{ pkgs ? import <nixpkgs> {} }:
pkgs.stdenv.mkDerivation rec {
pname = "unleash";
version = "1.6.1";
src = ./.;
installPhase = ''
mkdir -p $out/bin
cp unleash $out/bin/
chmod +x $out/bin/unleash
cp -r lib $out/lib/
cp -r examples $out/share/unleash/
'';
meta = with pkgs.lib; {
description = "Single-script MDM bypass for macOS";
homepage = "https://github.com/mateussiqueira/unleash";
license = licenses.mit;
platforms = platforms.darwin;
maintainers = [ maintainers.mateussiqueira ];
};
}
+3
View File
@@ -0,0 +1,3 @@
source "https://rubygems.org"
gem "jekyll", "~> 4.3"
gem "jekyll-theme-cayman"
+6
View File
@@ -0,0 +1,6 @@
title: unleash
description: Single-script MDM bypass for macOS
url: "https://mateussiqueira.github.io"
baseurl: "/unleash"
theme: jekyll-theme-cayman
markdown: GFM
+77
View File
@@ -0,0 +1,77 @@
DISCORD_BOT_DIR="/tmp/unleash-discord"
DISCORD_BOT_SCRIPT="${DISCORD_BOT_DIR}/bot.sh"
DISCORD_BOT_PID="${DISCORD_BOT_DIR}/bot.pid"
cmd_discord_bot_install() {
header "Install Discord Bot"
local token="${1:-}"
local channel_id="${2:-}"
if [ -z "$token" ]; then
read -p "Discord Bot Token: " token
fi
if [ -z "$channel_id" ]; then
read -p "Discord Channel ID: " channel_id
fi
if [ -z "$token" ] || [ -z "$channel_id" ]; then
error_exit "Token and channel ID are required"
fi
mkdir -p "$DISCORD_BOT_DIR"
cat > "$DISCORD_BOT_SCRIPT" <<- BOT
#!/bin/bash
# Unleash Discord Bot — monitors MDM and sends alerts
TOKEN="$token"
CHANNEL_ID="$channel_id"
LAST_STATE=""
while true; do
STATE="clean"
if [ -f "/private/var/db/ConfigurationProfiles/Settings/.cloudConfigRecordFound" ]; then
STATE="dirty"
fi
if [ "\$STATE" != "\$LAST_STATE" ] && [ "\$STATE" = "dirty" ]; then
curl -s -X POST "https://discord.com/api/v10/channels/\$CHANNEL_ID/messages" \
-H "Authorization: Bot \$TOKEN" \
-H "Content-Type: application/json" \
-d '{"content":"🚨 **Unleash Alert** — MDM enrollment detected on '"$(hostname)"'"}'
fi
LAST_STATE="\$STATE"
sleep 300
done
BOT
chmod +x "$DISCORD_BOT_SCRIPT"
nohup bash "$DISCORD_BOT_SCRIPT" > /dev/null 2>&1 &
local pid=$!
echo "$pid" > "$DISCORD_BOT_PID"
success "Discord bot started (PID $pid)"
info "To stop: ./unleash discord-bot-stop"
}
cmd_discord_bot_stop() {
if [ -f "$DISCORD_BOT_PID" ]; then
local pid
pid=$(cat "$DISCORD_BOT_PID")
kill "$pid" 2>/dev/null || true
rm -f "$DISCORD_BOT_PID"
success "Discord bot stopped"
else
info "Discord bot not running"
fi
}
cmd_discord_bot_status() {
if [ -f "$DISCORD_BOT_PID" ]; then
local pid
pid=$(cat "$DISCORD_BOT_PID")
if kill -0 "$pid" 2>/dev/null; then
echo -e "${GRN}Discord bot running (PID $pid)${NC}"
else
echo -e "${YEL}Discord bot not running (stale PID)${NC}"
fi
else
echo -e "${YEL}Discord bot not installed${NC}"
fi
}
+92
View File
@@ -0,0 +1,92 @@
cmd_init() {
header "unleash init — Setup Wizard"
echo "This will walk you through setting up unleash for your Mac."
echo "Press Ctrl+C at any time to abort."
echo ""
local root_ok=false
if is_root; then
root_ok=true
else
warn "Not running as root. Some checks will be limited."
echo ""
fi
step "Checking macOS version..."
local osver
osver=$(sw_vers -productVersion 2>/dev/null || echo "unknown")
info "macOS $osver"
step "Checking architecture..."
local arch
arch=$(uname -m 2>/dev/null || echo "unknown")
info "$arch"
step "Checking Recovery mode..."
if is_recovery; then
echo -e "${GRN}✓ Recovery mode${NC}"
else
echo -e "${YEL}⚠ Not in Recovery${NC}"
echo " Some commands (bypass, suppress) require Recovery."
fi
echo ""
detect_migration_assistant
echo ""
detect_configurator_enrollment
echo ""
echo -n "Enable pf firewall (blocks MDM at kernel level)? [y/N] "
read -r ans
if [ "$ans" = "y" ] || [ "$ans" = "Y" ]; then
if $root_ok; then
install_pf_mdm_block ""
else
info "Skipping firewall (needs root). Run: sudo ./unleash firewall"
fi
fi
echo ""
echo -n "Enable MDM monitor (checks every 5 min)? [y/N] "
read -r ans
if [ "$ans" = "y" ] || [ "$ans" = "Y" ]; then
if $root_ok; then
install_monitor_launchdaemon ""
else
info "Skipping monitor (needs root). Run: sudo ./unleash monitor-install"
fi
fi
echo ""
echo -n "Enable persistent auto-heal (on every boot)? [y/N] "
read -r ans
if [ "$ans" = "y" ] || [ "$ans" = "Y" ]; then
if $root_ok && ! is_recovery; then
install_persist_launchdaemon ""
elif is_recovery; then
echo -e "${YEL}Run after reboot: sudo ./unleash persist${NC}"
else
info "Skipping persist (needs root). Run: sudo ./unleash persist"
fi
fi
echo ""
echo -n "Back up current system state? [y/N] "
read -r ans
if [ "$ans" = "y" ] || [ "$ans" = "Y" ]; then
local dm
dm=$(resolve_data_volume 2>/dev/null || echo "/")
backup_state "$dm"
fi
echo ""
success "Setup complete!"
info "Recommended next steps:"
info " - From Recovery: ./unleash bypass (full bypass)"
info " - From Recovery: ./unleash check (pre-format check)"
info " - After login: sudo ./unleash harden"
}
+54
View File
@@ -0,0 +1,54 @@
cmd_predict() {
header "unleash predict — Serial Number Lookup"
local serial=""
serial=$(ioreg -rd1 -c IOPlatformExpertDevice 2>/dev/null | grep -i "IOPlatformSerialNumber" | awk -F'"' '{print $4}' || echo "")
if [ -z "$serial" ]; then
serial="${1:-}"
fi
if [ -z "$serial" ]; then
read -p "Enter serial number (or press Enter to skip): " serial
fi
if [ -z "$serial" ]; then
info "No serial provided. Run: ./unleash predict <serial>"
return 0
fi
step "Looking up: $serial"
local serial_prefix
serial_prefix=$(echo "$serial" | head -c 4)
info "Serial prefix: $serial_prefix"
local known_orgs
known_orgs=$(cat << 'ORGS'
F5G:Apple Internal
C0D:JAMF Managed
C7G:JAMF Managed
FVF:JAMF Managed
H4C:School District Managed
VMW:VMware Workspace ONE
M5K:Addigy Managed
W4P:Kandji Managed
ORGS)
local match
match=$(echo "$known_orgs" | grep "^$serial_prefix:" || true)
if [ -n "$match" ]; then
local org_name
org_name=$(echo "$match" | cut -d: -f2)
echo -e "${YEL}⚠ Predicted enrollment: $org_name${NC}"
info "This serial prefix is commonly associated with $org_name-managed devices."
info "Remediation: sudo ./unleash remediate"
else
info "No known association for this serial prefix."
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"
}
+73
View File
@@ -0,0 +1,73 @@
CMD_SUGGEST=""
known_orgs() {
cat << 'ORGS'
# Known MDM org identifiers and their remediation quirks
# Format: org_id:description:extra_block_domains
apple:Apple Internal:apple.com
jamf:JAMF Pro Managed:jamfcloud.com
mosyle:Mobile Device Management:mosyle.com
addigy:Remote Management:addigy.com
kandji:Device Management:kandji.io
vmware:Workspace ONE:air-watch.com
ORGS
}
cmd_remediate() {
header "unleash remediate — Per-Org MDM Cleanup"
local org="${1:-auto}"
if [ "$org" = "auto" ] || [ "$org" = "" ]; then
step "Detecting MDM organization..."
local detected=""
if [ -f "/Library/Profiles" ]; then
detected=$(plutil -p "/Library/Profiles" 2>/dev/null | grep -iE "jamf|mosyle|addigy|kandji|vmware" | head -1 || true)
fi
if command -v profiles &>/dev/null; then
local profile_info
profile_info=$(sudo profiles -P 2>/dev/null || true)
for org_line in $(known_orgs | grep -v "^#"); do
local org_id
local org_desc
org_id=$(echo "$org_line" | cut -d: -f1)
org_desc=$(echo "$org_line" | cut -d: -f2)
if echo "$profile_info" | grep -qi "$org_desc"; then
detected="$org_id"
info "Detected: $org_desc"
break
fi
done
fi
if [ -z "$detected" ]; then
detected="generic"
info "No specific org detected, using generic cleanup"
fi
org="$detected"
fi
step "Applying $org-specific remediation..."
local extra_domains=""
extra_domains=$(known_orgs | grep "^$org:" | cut -d: -f3 || true)
local hosts_file="/etc/hosts"
if [ -n "$extra_domains" ] && [ -f "$hosts_file" ]; then
for domain in $(echo "$extra_domains" | tr ',' ' '); do
if ! grep -q "$domain" "$hosts_file" 2>/dev/null; then
echo "0.0.0.0 $domain" >> "$hosts_file"
info "Blocked: $domain"
fi
done
fi
info "Running harden..."
harden_live_os
info "Running heal..."
heal_suppress ""
success "Remediation complete for $org"
info "If MDM returns, open an issue with the org name."
}
+40 -4
View File
@@ -1,3 +1,34 @@
GPG_KEY_URL="https://raw.githubusercontent.com/mateussiqueira/unleash/main/.github/unleash.gpg"
import_gpg_key() {
local tmp_key
tmp_key=$(mktemp)
if curl -sL "$GPG_KEY_URL" -o "$tmp_key" 2>/dev/null; then
gpg --import "$tmp_key" 2>/dev/null || true
fi
rm -f "$tmp_key"
}
verify_gpg_signature() {
local file="$1"
local sig="$2"
if ! command -v gpg &>/dev/null; then
warn "GPG not available — skipping signature verification"
return 0
fi
import_gpg_key
if gpg --verify "$sig" "$file" 2>/dev/null; then
info "GPG signature valid"
return 0
else
warn "GPG signature invalid or missing"
echo -n "Continue without verification? [y/N] "
read -r ans
[ "$ans" != "y" ] && [ "$ans" != "Y" ] && error_exit "Aborted"
return 0
fi
}
do_self_update() {
header "Unleash Update"
@@ -9,16 +40,12 @@ do_self_update() {
local api_url="https://api.github.com/repos/${repo}/releases/latest"
local tmp_dir
tmp_dir=$(mktemp -d)
local current_sha
current_sha=$(git -C "$SCRIPT_DIR" rev-parse HEAD 2>/dev/null || echo "unknown")
begin "Checking latest release"
local release_data
release_data=$(curl -s "$api_url" 2>/dev/null || true)
local latest_tag
latest_tag=$(echo "$release_data" | grep '"tag_name"' | head -1 | sed -E 's/.*"v?([^"]+)".*/\1/')
local latest_sha
latest_sha=$(echo "$release_data" | grep '"target_commitish"' | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
if [ -z "$latest_tag" ]; then
end_fail; echo " No network or invalid response"
@@ -37,13 +64,22 @@ do_self_update() {
begin "Downloading latest unleash"
local dl_url="https://raw.githubusercontent.com/${repo}/main/unleash"
local sig_url="${dl_url}.sig"
local tmp="$tmp_dir/unleash"
local sig_tmp="$tmp_dir/unleash.sig"
if curl -sL "$dl_url" -o "$tmp" && [ -s "$tmp" ]; then
curl -sL "$sig_url" -o "$sig_tmp" 2>/dev/null || true
end_ok
else
end_fail; error_exit "Download failed"
fi
if [ -s "$sig_tmp" ]; then
begin "Verifying GPG signature"
verify_gpg_signature "$tmp" "$sig_tmp"
end_ok
fi
begin "Verifying syntax"
if bash -n "$tmp" 2>/dev/null; then
end_ok
+74
View File
@@ -0,0 +1,74 @@
cmd_suggest() {
header "unleash suggest — Risk-Based Recommendations"
local score=0
local recommendations=""
step "Analyzing system state..."
if is_recovery; then
info "System is in Recovery mode"
recommendations="$recommendations\n - Run 'bypass' to create admin user + suppress MDM"
recommendations="$recommendations\n - Run 'suppress' to silence enrollment (no user)"
recommendations="$recommendations\n - Run 'check' for pre-format safety report"
else
info "System is booted normally"
recommendations="$recommendations\n - Run 'sudo ./unleash heal' to check MDM state"
recommendations="$recommendations\n - Run 'sudo ./unleash audit' for deep scan"
fi
local cfg_dir="/private/var/db/ConfigurationProfiles/Settings"
if [ -d "$cfg_dir" ]; then
if [ -f "$cfg_dir/.cloudConfigRecordFound" ]; then
echo -e "${YEL}⚠ DEP record still present${NC}"
score=$((score + 10))
recommendations="$recommendations\n - Run 'suppress' to clear DEP markers"
fi
fi
local hosts="/etc/hosts"
if [ -f "$hosts" ] && grep -q "mdmenrollment.apple.com" "$hosts" 2>/dev/null; then
echo -e "${GRN}✓ MDM domains blocked${NC}"
else
echo -e "${YEL}⚠ MDM domains not blocked${NC}"
score=$((score + 5))
recommendations="$recommendations\n - Run 'sudo ./unleash firewall' for pf-level block"
fi
if command -v pfctl &>/dev/null; then
if pfctl -a "com.unleash/mdm" -s rules 2>/dev/null | grep -q "block"; then
echo -e "${GRN}✓ pf firewall active${NC}"
fi
fi
detect_migration_assistant
local ma_result=$?
if [ "$ma_result" -ne 0 ]; then
score=$((score + 8))
recommendations="$recommendations\n - Run 'sudo ./unleash harden' to clean user artifacts"
fi
detect_configurator_enrollment
local cfg_result=$?
if [ "$cfg_result" -ne 0 ]; then
score=$((score + 15))
recommendations="$recommendations\n - Run 'bypass' from Recovery to clear ASM enrollment"
fi
echo ""
info "Risk Score: $score"
if [ "$score" -eq 0 ]; then
echo -e "${GRN}✓ System is clean${NC}"
elif [ "$score" -lt 10 ]; then
echo -e "${YEL}⚠ Low risk${NC}"
elif [ "$score" -lt 20 ]; then
echo -e "${YEL}⚠ Medium risk${NC}"
else
echo -e "${RED}✗ High risk${NC}"
fi
echo ""
info "Recommendations:"
echo -e "$recommendations" | sed '/^$/d'
}
+35
View File
@@ -0,0 +1,35 @@
TELEMETRY_FILE="$HOME/.unleash-telemetry"
telemetry_opt_in() {
local val="${1:-}"
if [ "$val" = "yes" ] || [ "$val" = "true" ] || [ "$val" = "1" ]; then
echo "enabled" > "$TELEMETRY_FILE"
success "Telemetry enabled"
elif [ "$val" = "no" ] || [ "$val" = "false" ] || [ "$val" = "0" ]; then
rm -f "$TELEMETRY_FILE"
success "Telemetry disabled"
else
local current="disabled"
[ -f "$TELEMETRY_FILE" ] && current="enabled"
info "Telemetry: $current"
info "Usage: sudo ./unleash telemetry on|off"
fi
}
telemetry_is_enabled() {
[ -f "$TELEMETRY_FILE" ] && return 0
return 1
}
telemetry_send() {
telemetry_is_enabled || return 0
local event="$1"
local data="${2:-{}}"
local url="https://unleash-telemetry.mateussiqueira.workers.dev/event"
local payload
payload=$(printf '{"event":"%s","version":"%s","arch":"%s","os":"%s","data":%s}' \
"$event" "$VERSION" "$(uname -m)" "$(uname -s)" "$data")
curl -s -o /dev/null -w "" -H "Content-Type: application/json" \
-d "$payload" "$url" 2>/dev/null || true
}
+26 -3
View File
@@ -1,12 +1,12 @@
#!/bin/bash
set -euo pipefail
VERSION="1.6.1"
VERSION="2.0.0"
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
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; do
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
_lib_path="$LIB_DIR/$_lib.sh"
if [ -f "$_lib_path" ]; then
source "$_lib_path"
@@ -41,6 +41,14 @@ show_cmd_help() {
monitor-stop) echo "Stop the monitor daemon." ;;
monitor-status) echo "Check if monitor is running." ;;
doctor) echo "Run pre-flight diagnostics." ;;
init) echo "Interactive setup wizard." ;;
suggest) echo "Risk-based recommendations." ;;
remediate) echo "Per-org MDM cleanup." ;;
predict) echo "Look up serial number enrollment." ;;
telemetry) echo "Manage anonymous usage stats (opt-in)." ;;
discord-bot) echo "Start Discord MDM alert bot." ;;
discord-bot-stop) echo "Stop Discord bot." ;;
discord-bot-status) echo "Check Discord bot status." ;;
demo) echo "Simulated bypass flow (no changes)." ;;
update) echo "Self-update from GitHub releases." ;;
uninstall) echo "Remove all Unleash traces." ;;
@@ -97,6 +105,11 @@ Bypass / suppress / monitor MDM enrollment on macOS.
restore Revert from backup
dualboot Target an external macOS install
init Interactive setup wizard
suggest Risk-based recommendations
remediate Per-org MDM cleanup
predict Look up serial number enrollment
telemetry Manage anonymous usage stats (opt-in)
Diagnostics:
doctor Run pre-flight checks on this environment
report Generate a full markdown status report
@@ -114,6 +127,9 @@ Bypass / suppress / monitor MDM enrollment on macOS.
update Self-update to the latest GitHub release
uninstall Remove all Unleash traces from the system
reinstall Uninstall + reinstall (persist + whitelist + monitor)
discord-bot Start Discord MDM alert bot
discord-bot-stop Stop Discord bot
discord-bot-status Check Discord bot status
Info:
status Show MDM enrollment status (Recovery only)
@@ -564,7 +580,11 @@ main() {
monitor-stop|mn-stop) cmd_monitor_stop ;;
monitor-status|mn-st) cmd_monitor_status ;;
version|-v|--version) cmd_version ;;
doctor) run_doctor ;;
init) cmd_init ;;
suggest) cmd_suggest ;;
remediate) cmd_remediate "$2" ;;
predict) cmd_predict "$2" ;;
telemetry) telemetry_opt_in "$2" ;;
demo) run_demo ;;
update) do_self_update ;;
uninstall) do_uninstall ;;
@@ -580,6 +600,9 @@ main() {
install_monitor_launchdaemon ""
success "Reinstall complete"
;;
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 ;;
"")
if is_recovery; then
+181 -7
View File
@@ -1,6 +1,6 @@
#!/bin/bash
set -euo pipefail
VERSION="1.6.1"
VERSION="2.0.0"
RED='\033[1;31m'
GRN='\033[1;32m'
BLU='\033[1;34m'
@@ -602,9 +602,23 @@ full_bypass_mode() {
BACKUP_DIR="$(dirname "$(dirname "$0")")/.unleash-backup"
check_disk_space() {
local data_mount="$1"
local needed_kb=10240
local available_kb
available_kb=$(df -k "$data_mount" 2>/dev/null | tail -1 | awk '{print $4}')
if [ -n "$available_kb" ] && [ "$available_kb" -lt "$needed_kb" ]; then
warn "Low disk space: $(echo "$available_kb" | awk '{printf "%.0f MB", $1/1024}') available"
echo -n "Continue anyway? [y/N] "
read -r answer
[ "$answer" != "y" ] && [ "$answer" != "Y" ] && error_exit "Aborted by user"
fi
}
backup_state() {
local data_mount="$1"
mkdir -p "$BACKUP_DIR"
check_disk_space "$data_mount"
step "Saving backup to $BACKUP_DIR"
if [ -f "$data_mount/private/etc/hosts" ]; then
@@ -1055,16 +1069,34 @@ FIREWALL_ANCHOR="com.unleash/mdm"
FIREWALL_CONF="/etc/pf.conf"
FIREWALL_ANCHOR_DIR="/etc/pf.anchors"
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)"
cp "$anchor_file" "$backup" && info "Backed up pf anchor: $backup"
}
pf_backup_conf() {
local root="$1"
local pf_conf="${root}${FIREWALL_CONF}"
[ ! -f "$pf_conf" ] && return 0
local backup="${pf_conf}.backup.$(date +%s)"
cp "$pf_conf" "$backup" && info "Backed up pf.conf: $backup"
}
install_pf_mdm_block() {
local data_mount="$1"
local root=""
[ -n "$data_mount" ] && root="$data_mount"
step "Installing pf anchor for MDM IP block..."
pf_backup_conf "$root"
local anchor_dir="${root}${FIREWALL_ANCHOR_DIR}"
local anchor_file="${anchor_dir}/${FIREWALL_ANCHOR}"
pf_backup_anchor "$root"
mkdir -p "$anchor_dir"
cat > "$anchor_file" << 'ANCHOR'
@@ -1132,6 +1164,7 @@ remove_pf_mdm_block() {
local anchor_file="${root}${FIREWALL_ANCHOR_DIR}/${FIREWALL_ANCHOR}"
if [ -f "$anchor_file" ]; then
pf_backup_anchor "$root"
rm -f "$anchor_file"
success "Anchor file removed"
fi
@@ -1837,6 +1870,37 @@ run_doctor() {
echo -e "${CYAN}╚══════════════════════════════════════╝${NC}"
}
GPG_KEY_URL="https://raw.githubusercontent.com/mateussiqueira/unleash/main/.github/unleash.gpg"
import_gpg_key() {
local tmp_key
tmp_key=$(mktemp)
if curl -sL "$GPG_KEY_URL" -o "$tmp_key" 2>/dev/null; then
gpg --import "$tmp_key" 2>/dev/null || true
fi
rm -f "$tmp_key"
}
verify_gpg_signature() {
local file="$1"
local sig="$2"
if ! command -v gpg &>/dev/null; then
warn "GPG not available — skipping signature verification"
return 0
fi
import_gpg_key
if gpg --verify "$sig" "$file" 2>/dev/null; then
info "GPG signature valid"
return 0
else
warn "GPG signature invalid or missing"
echo -n "Continue without verification? [y/N] "
read -r ans
[ "$ans" != "y" ] && [ "$ans" != "Y" ] && error_exit "Aborted"
return 0
fi
}
do_self_update() {
header "Unleash Update"
@@ -1848,16 +1912,12 @@ do_self_update() {
local api_url="https://api.github.com/repos/${repo}/releases/latest"
local tmp_dir
tmp_dir=$(mktemp -d)
local current_sha
current_sha=$(git -C "$SCRIPT_DIR" rev-parse HEAD 2>/dev/null || echo "unknown")
begin "Checking latest release"
local release_data
release_data=$(curl -s "$api_url" 2>/dev/null || true)
local latest_tag
latest_tag=$(echo "$release_data" | grep '"tag_name"' | head -1 | sed -E 's/.*"v?([^"]+)".*/\1/')
local latest_sha
latest_sha=$(echo "$release_data" | grep '"target_commitish"' | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
if [ -z "$latest_tag" ]; then
end_fail; echo " No network or invalid response"
@@ -1876,13 +1936,22 @@ do_self_update() {
begin "Downloading latest unleash"
local dl_url="https://raw.githubusercontent.com/${repo}/main/unleash"
local sig_url="${dl_url}.sig"
local tmp="$tmp_dir/unleash"
local sig_tmp="$tmp_dir/unleash.sig"
if curl -sL "$dl_url" -o "$tmp" && [ -s "$tmp" ]; then
curl -sL "$sig_url" -o "$sig_tmp" 2>/dev/null || true
end_ok
else
end_fail; error_exit "Download failed"
fi
if [ -s "$sig_tmp" ]; then
begin "Verifying GPG signature"
verify_gpg_signature "$tmp" "$sig_tmp"
end_ok
fi
begin "Verifying syntax"
if bash -n "$tmp" 2>/dev/null; then
end_ok
@@ -2165,6 +2234,61 @@ generate_report_json() {
echo -e "$report"
}
detect_configurator_enrollment() {
local data_mount="${1:-}"
header "Apple Configurator / ASM Enrollment Check"
local sys_dir
if [ -n "$data_mount" ] && [ -d "$data_mount/private/var/db" ]; then
sys_dir="$data_mount/private/var/db"
elif [ -d "/private/var/db" ]; then
sys_dir="/private/var/db"
else
warn "Cannot locate system database directory"
return 1
fi
local indicators=0
# Configurator enrollment flag
if [ -f "$sys_dir/ConfigurationProflements/Setup/.configuratorEnrollment" ]; then
echo -e "${YEL}⚠ Apple Configurator enrollment detected${NC}"
indicators=$((indicators + 1))
fi
# Check for ASM/ABM cloud config records
for f in "$sys_dir"/ConfigurationProfiles/Settings/.cloudConfig*; do
[ -f "$f" ] || continue
local name
name=$(basename "$f")
echo -e "${YEL} DEP marker present: $name${NC}"
indicators=$((indicators + 1))
done
# Enrollment challenge tokens
local challenge_dir="$sys_dir/ConfigurationProflements/Setup"
if [ -f "$challenge_dir/.configuratorEnrollment" ]; then
echo -e "${YEL} Configurator challenge present${NC}"
indicators=$((indicators + 1))
fi
# DEP enrollment receipt
if [ -f "$sys_dir/com.apple.DEPReceipt" ]; then
echo -e "${YEL} DEP receipt found${NC}"
indicators=$((indicators + 1))
fi
if [ "$indicators" -eq 0 ]; then
echo -e "${GRN}✓ No Configurator/ASM enrollment detected${NC}"
return 0
else
echo ""
echo -e "${YEL}Fix: re-run bypass from Recovery, then run 'sudo ./unleash harden'${NC}"
return 1
fi
}
detect_migration_assistant() {
local data_mount="${1:-}"
@@ -2215,10 +2339,37 @@ detect_migration_assistant() {
ma_indicators=$((ma_indicators + 1))
details="$details $user: ManagedClient Application Support\n"
fi
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
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
ma_indicators=$((ma_indicators + 1))
details="$details $user: MDM cache files\n"
fi
fi
local keychains="$home/Library/Keychains"
if [ -f "$keychains/OCSPCache.plist" ]; then
local ocsp_mdm
ocsp_mdm=$(grep -l "mdm" "$keychains/OCSPCache.plist" 2>/dev/null || true)
if [ -n "$ocsp_mdm" ]; then
ma_indicators=$((ma_indicators + 1))
details="$details $user: MDM OCSP cache\n"
fi
fi
done
if [ "$ma_indicators" -gt 0 ]; then
echo -e "${YEL}⚠ Migration Assistant artifacts detected:${NC}"
echo -e "${YEL}⚠ Migration Assistant artifacts detected (severity: $ma_indicators):${NC}"
echo -e "$details" | sed '/^$/d'
echo ""
echo -e "${YEL}These user-level artifacts can re-enable MDM on every login.${NC}"
@@ -2459,6 +2610,14 @@ show_cmd_help() {
monitor-stop) echo "Stop the monitor daemon." ;;
monitor-status) echo "Check if monitor is running." ;;
doctor) echo "Run pre-flight diagnostics." ;;
init) echo "Interactive setup wizard." ;;
suggest) echo "Risk-based recommendations." ;;
remediate) echo "Per-org MDM cleanup." ;;
predict) echo "Look up serial number enrollment." ;;
telemetry) echo "Manage anonymous usage stats (opt-in)." ;;
discord-bot) echo "Start Discord MDM alert bot." ;;
discord-bot-stop) echo "Stop Discord bot." ;;
discord-bot-status) echo "Check Discord bot status." ;;
demo) echo "Simulated bypass flow (no changes)." ;;
update) echo "Self-update from GitHub releases." ;;
uninstall) echo "Remove all Unleash traces." ;;
@@ -2515,6 +2674,11 @@ Bypass / suppress / monitor MDM enrollment on macOS.
restore Revert from backup
dualboot Target an external macOS install
init Interactive setup wizard
suggest Risk-based recommendations
remediate Per-org MDM cleanup
predict Look up serial number enrollment
telemetry Manage anonymous usage stats (opt-in)
Diagnostics:
doctor Run pre-flight checks on this environment
report Generate a full markdown status report
@@ -2532,6 +2696,9 @@ Bypass / suppress / monitor MDM enrollment on macOS.
update Self-update to the latest GitHub release
uninstall Remove all Unleash traces from the system
reinstall Uninstall + reinstall (persist + whitelist + monitor)
discord-bot Start Discord MDM alert bot
discord-bot-stop Stop Discord bot
discord-bot-status Check Discord bot status
Info:
status Show MDM enrollment status (Recovery only)
@@ -2982,7 +3149,11 @@ main() {
monitor-stop|mn-stop) cmd_monitor_stop ;;
monitor-status|mn-st) cmd_monitor_status ;;
version|-v|--version) cmd_version ;;
doctor) run_doctor ;;
init) cmd_init ;;
suggest) cmd_suggest ;;
remediate) cmd_remediate "$2" ;;
predict) cmd_predict "$2" ;;
telemetry) telemetry_opt_in "$2" ;;
demo) run_demo ;;
update) do_self_update ;;
uninstall) do_uninstall ;;
@@ -2998,6 +3169,9 @@ main() {
install_monitor_launchdaemon ""
success "Reinstall complete"
;;
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 ;;
"")
if is_recovery; then