chahinebrini 2cb1f8ad6e feat(binder-mac): SwiftUI Wizard für Self-Bind End-to-End-Flow
apps/rebreak-binder-mac/ — neue macOS-App die User durch den kompletten
Self-Bind-Prozess führt: Welcome → Preflight → Supervise → Enroll →
Configure (MDM-Push + Pre/Post-Check) → Sideload Lock-Profile (AirDrop).

3-Layer Smart-Resume: supervised? + Enrollment-Profil installed (cfgutil
Ground-Truth)? + MDM-Ack fresh (NanoMDM-DB via ssh+psql)?

Services: DeviceDetector (ideviceinfo + cfgutil), SuperviseRunner
(spawnt supervise-magic CLI), MDMClient (PUT /v1/enqueue?push=1, Apple
XML-Plist, identisch zum server-watcher-Format), MDMStatus (DB-Real-
Check + ManagedApplicationList-Result-Read).

Plus:
- fix(supervise-magic): EOF nach ProcessMessage Response (ErrorCode=0)
  ist Success, nicht Error — vermeidet false-fail bei iPhone-Restore-
  Reboot
- feat(mdm-profiles): rebreak-content-filter-mdm.mobileconfig als
  MDM-Push-Variante (ohne ConsentText, ohne globales allowAppRemoval=
  false — per-app via managed-state)

End-to-End validiert: App-Push via Ad-Hoc-Manifest (silent), Managed-
State via ManagedApplicationList-Query, NEFilter-Mode nach App-Force-
Quit, Lock-Profile non-removable nach Sideload.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-27 08:37:14 +02:00
..

ReBreak Supervise Magic

Go-CLI das ein unsupervised iPhone/iPad ohne Datenverlust in den supervised-Zustand überführt.

Mechanismus: Direktes Schreiben von Library/ConfigurationProfiles/CloudConfigurationDetails.plist via Apple's Lockdown-Protokoll (gidevice-Library, kein Apple Configurator nötig). Reverse-engineered aus TechLockdown's Supervise-Tool (2026-05-26).

Unterschied zum Legacy bootstrap-tool/rebreak-supervise.sh: Kein Backup-Restore-Round-Trip, kein Erase. Nur Plist-Inject + Reboot.

Status

🚧 Phase 1 — CLI MVP. Phase 2 (Mac-UI-Wrapper) geplant.

Voraussetzungen

Was Wie
Go 1.22+ brew install go
iPhone via USB USB-C-Kabel, „Diesem Computer vertrauen" geklickt
Find My iPhone aus Settings → [Name] → Wo ist? → Mein iPhone suchen → Aus
iPhone-Bildschirm entsperrt Damit Trust-Prompt akzeptiert werden kann

Build

make tidy   # einmalig: dependencies auflösen
make build  # → bin/rebreak-supervise-magic

Universal-Binary (Intel + ARM):

make build-universal

Usage

# Status checken
./bin/rebreak-supervise-magic check

# Supervise auslösen (interaktiv, mit Confirmations)
./bin/rebreak-supervise-magic supervise

# Verbose-Mode für Debug
./bin/rebreak-supervise-magic -v supervise

# Reverse: Supervised → Unsupervised (Plist zurückschreiben)
./bin/rebreak-supervise-magic unsupervise

Mechanismus im Detail

  1. Pair + Trust — gidevice verbindet sich zu lockdownd via usbmuxd. Falls iPhone noch nicht trusted, wird Trust-Prompt am iPhone gezeigt.
  2. Pre-Flight — UDID + ProductType + OS-Version dumpen. Find-My-iPhone-Status checken (muss aus sein).
  3. Plist-BuildCloudConfigurationDetails-Go-struct → XML-Plist via howett.net/plist. Felder: IsSupervised=true, IsMDMUnremovable=true, OrganizationName="ReBreak", EscrowBag optional.
  4. Plist-Write — Via MCInstall- oder AFC-Service ins iPhone-Filesystem-Container Library/ConfigurationProfiles/CloudConfigurationDetails.plist.
  5. Reboot — Lockdown-Reboot-Command. Wait-for-Re-Connect-Loop.
  6. Verify — IsSupervised-Status via Lockdown-Query erneut lesen. Supervision sollte jetzt aktiv sein.
  7. Settings-Check (manual) — iPhone-Settings → „Verwaltet von ReBreak" sichtbar.

Sicherheits-Hinweise

  • Tool macht USB-only, kein Network-Channel.
  • iPhone behält alle Apps, Daten, Login-States (kein Backup-Restore-Round-Trip).
  • Reverse-Operation (unsupervise) wirkt symmetrisch — Plist-Felder zurückschreiben + Reboot.
  • Apple-Compliance: gleiche Public-API wie iMazing/TechLockdown nutzen. Siehe Memory techlockdown-reverse-engineering.

Apple-Walls die wir damit umgehen

  • Erase-Required für Supervision via Apple Configurator
  • ABM/DEP-Enrollment für Supervised-Mode

Apple-Walls die bleiben

  • FMI muss vorher aus (Activation-Lock-Constraint)
  • iOS-Update kann das jederzeit patchen (bisher 5+ Jahre nicht)

Lizenz & Distribution

Phase 1: nur lokal nutzbar (Personal + Friends). Keine Mac-App-Store-Distribution geplant. Notarization nur falls wir Phase 2 (Mac-UI) als Distribution-Tool releasen.