b31066a04c
- ChatBubble: useActionSheet replaces custom Modal (native iOS popup, Android bottom sheet) - DM mode (isDM prop): hides like-count, shows Insta-style heart badge under bubble when liked - Group chat unchanged - Cleanup: remove unused Modal/Platform imports, sheet styles, actionsOpen state - deploy.sh: auto-detect ANDROID_HOME + auto-create local.properties for local Gradle - NEXT_RELEASE.md: DM reactions release note - Includes other staged work across binder-mac, marketing, ops/mdm, ios/
97 lines
3.6 KiB
Markdown
97 lines
3.6 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
|
|
```
|
|
|
|
## Delta-Workflow (current vs legacy)
|
|
|
|
Wenn das Ziel nur ist, die verbleibenden Ablauf-Unterschiede sichtbar zu machen,
|
|
nutze die Profile unter `tools/`:
|
|
|
|
```bash
|
|
# Aktueller Default-Flow
|
|
./tools/ab-profile.sh current <udid> ReBreak
|
|
|
|
# Legacy-Flow (nahe 01374c4) zur A/B-Reproduktion
|
|
./tools/ab-profile.sh legacy <udid> ReBreak
|
|
```
|
|
|
|
Die Delta-Matrix mit den drei harten Unterschieden steht in
|
|
`tools/delta-matrix.md`.
|
|
|
|
## 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.
|