01374c426e
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>
81 lines
3.2 KiB
Markdown
81 lines
3.2 KiB
Markdown
# 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`](../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
|
|
|
|
```bash
|
|
make tidy # einmalig: dependencies auflösen
|
|
make build # → bin/rebreak-supervise-magic
|
|
```
|
|
|
|
Universal-Binary (Intel + ARM):
|
|
|
|
```bash
|
|
make build-universal
|
|
```
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
# 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-Build** — `CloudConfigurationDetails`-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.
|