rename project to runaway
This commit is contained in:
+11
-11
@@ -1,20 +1,20 @@
|
||||
---
|
||||
layout: default
|
||||
title: Architecture Guide — unleash
|
||||
title: Architecture Guide — runaway
|
||||
---
|
||||
|
||||
# Architecture Guide
|
||||
|
||||
## The Five Layers of MDM
|
||||
|
||||
Apple's MDM enrollment works through five independent mechanisms. Blocking just one or two is why bypass tools fail over time. Unleash addresses all five.
|
||||
Apple's MDM enrollment works through five independent mechanisms. Blocking just one or two is why bypass tools fail over time. Runaway addresses all five.
|
||||
|
||||
```
|
||||
Layer 1: DEP markers ─── /var/db/ConfigurationProfiles/Settings/.cloudConfig*
|
||||
Layer 2: Hosts block ─── /etc/hosts → 0.0.0.0 deviceenrollment.apple.com
|
||||
Layer 3: Daemons ─── launchd disabled → ManagedClient.enroll, activationd
|
||||
Layer 4: User data ─── ~/Library/Preferences/com.apple.mdm.*
|
||||
Layer 5: pf firewall ─── pf anchor com.unleash/mdm → kernel-level drop
|
||||
Layer 5: pf firewall ─── pf anchor com.runaway/mdm → kernel-level drop
|
||||
```
|
||||
|
||||
### Layer 1: DEP Enrollment Markers
|
||||
@@ -100,8 +100,8 @@ pf (packet filter) operates at the kernel networking layer, below DNS resolution
|
||||
## Script Architecture
|
||||
|
||||
```
|
||||
unleash/
|
||||
├── unleash # Main entry point — loads libs, dispatches commands
|
||||
runaway/
|
||||
├── runaway # Main entry point — loads libs, dispatches commands
|
||||
├── lib/
|
||||
│ ├── colors.sh # Logging, colors, prompts, show_cmd_help()
|
||||
│ ├── detect.sh # Recovery detection, volume mounting
|
||||
@@ -138,28 +138,28 @@ unleash/
|
||||
|
||||
### Dispatch Flow
|
||||
|
||||
1. `unleash` loads all `lib/*.sh` modules
|
||||
2. `load_config()` reads `~/.unleash.conf` (if exists)
|
||||
1. `runaway` loads all `lib/*.sh` modules
|
||||
2. `load_config()` reads `~/.runaway.conf` (if exists)
|
||||
3. Command argument is matched against the `case` dispatch in main
|
||||
4. Handler function is called (e.g., `cmd_bypass`, `cmd_firewall`)
|
||||
5. Each handler calls lib functions that do the actual work
|
||||
|
||||
### Standalone Build
|
||||
|
||||
`examples/build-standalone.sh` concatenates all lib modules + main script body into a single file (`unleash-standalone.sh`, ~3200 lines). No external dependencies — runs on any macOS system with bash.
|
||||
`examples/build-standalone.sh` concatenates all lib modules + main script body into a single file (`runaway-standalone.sh`, ~3200 lines). No external dependencies — runs on any macOS system with bash.
|
||||
|
||||
## Build Process
|
||||
|
||||
1. **Source**: Individual `lib/*.sh` modules + `unleash` entry point
|
||||
1. **Source**: Individual `lib/*.sh` modules + `runaway` entry point
|
||||
2. **Test**: 78 Bats tests covering all modules
|
||||
3. **Build**: `bash examples/build-standalone.sh` → `unleash-standalone.sh`
|
||||
3. **Build**: `bash examples/build-standalone.sh` → `runaway-standalone.sh`
|
||||
4. **Sign**: `scripts/sign-release.sh` → GPG detached signature
|
||||
5. **Release**: GitHub release with standalone + signature + checksums
|
||||
|
||||
## Security Design
|
||||
|
||||
### No root persistence
|
||||
Unleash does not install a backdoor, create hidden users, or modify the system volume. All changes are reversible.
|
||||
Runaway does not install a backdoor, create hidden users, or modify the system volume. All changes are reversible.
|
||||
|
||||
### GPG-signed releases
|
||||
Releases are signed with a GPG key. `selfupdate` verifies the signature before applying updates. Signature verification must pass or the update is rejected.
|
||||
|
||||
Reference in New Issue
Block a user