chahinebrini 01374c426e feat(supervise-magic): TechLockdown-clone v1 — supervise iPhones without erase

Implementiert eigenen MobileBackup2-Restore-Trick zur Supervision-Übernahme
von aktivierten iOS-Geräten ohne Factory-Reset. Foundation für DiGA-Phase-G
Lock-Layer-Stack (non-removable Apps, non-removable Profiles, OnDemand-VPN-
Toggle-Lock) auf Consumer-iPhones.

Verifiziert end-to-end auf:
- iPhone Air (iPhone18,4, iOS 26.5): TL→ReBreak re-supervise ✅
- Olfa iPhone 14 Pro (iPhone15,3, iOS 26.4.2): TL→ReBreak re-supervise ✅

Key empirische Findings:
1. Find-My-iPhone MUSS off sein (ErrorCode 211 sonst)
   → Stolen Device Protection (SDP) zwingt FMI an seit iOS 17.3+
2. SupervisorHostCertificates DARF NICHT in CloudConfigurationDetails sein
   für fresh-supervise auf activated unsupervised devices (sonst partial-apply)
3. MCInstall.SetCloudConfiguration firet 14002 auf allen activated devices
   → MobileBackup2-Restore-Trick ist der einzige Weg
4. TL's extracted-embed-bytes != TL's wire-output (Runtime-Mutation)
   → Verbatim-Kopieren reicht nicht

Reverse-Engineering basiert komplett auf:
- Apple's public protocol docs (devicemanagement, mobilebackup2 schemas)
- libimobiledevice (open-source reference impl)
- TL public-distributed binary (interop-RE, legal per US-DMCA-1201 + EU-2009/24)

Structure:
  cmd/supervise/         — main CLI (check, cloud-config, supervise, cert-info, unsupervise)
  cmd/dump-artifacts/    — diagnostic helper (no device needed)
  cmd/usbmux-proxy/      — MITM-proxy for TL-traffic-capture (debug)
  cmd/tl-patcher/        — patches TL's hard-coded usbmuxd path (debug)
  internal/dlmessage/    — DLMessage wire-protocol (4-byte BE length + plist)
  internal/mobilebackup2/— mobilebackup2-service impl (BaseVersionExchange,
                          Hello, Restore, ServeFiles + TL-extracted templates)
  internal/cloudconfig/  — CloudConfigurationDetails.plist builder (cert-less,
                          25 keys matching TL's runtime-output)
  internal/cert/         — auto-gen + persist supervisor-cert in ~/.rebreak-supervise/
  internal/mcinstall/    — MCInstall.GetCloudConfiguration für state-checks
  internal/device/       — go-ios DeviceEntry wrapper
  internal/afclock/      — AFC sync-lock auf /com.apple.itunes.lock_sync
  internal/notification_proxy/ — PostNotification (syncWillStart/etc)
  internal/preflight/    — FMI/Activation/OS-version pre-checks
  internal/supervise/    — End-to-end Flow-Orchestrierung (MobileBackup2 default,
                          MCInstall via REBREAK_FORCE_MCINSTALL=1)

Pending für volle Productization (Phase G):
- Fresh-supervise direkt-empirisch auf truly-unsupervised iPhone testen
  (heute Nacht nur durch Inferenz aus TL-Verhalten gestützt)
- Auto-MDM-enroll-Step nach Supervise (ConfigurationURL oder cfgutil-style)
- DiGA-Onboarding-Flow + Lyra-Coach für FMI/SDP-Disable
- Multi-Device-Validation (Modelle, iOS-Versionen)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-27 01:55:10 +02:00

3.2 KiB

Raw Blame History

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

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

3.2 KiB Raw Blame History