rename project to runaway
This commit is contained in:
+11
-11
@@ -1,20 +1,20 @@
|
||||
---
|
||||
layout: default
|
||||
title: Guia de Arquitetura — unleash
|
||||
title: Guia de Arquitetura — runaway
|
||||
---
|
||||
|
||||
# Guia de Arquitetura
|
||||
|
||||
## As Cinco Camadas do MDM
|
||||
|
||||
O registro MDM da Apple funciona através de cinco mecanismos independentes. Bloquear apenas um ou dois é o motivo pelo qual ferramentas de bypass falham com o tempo. O Unleash aborda todos os cinco.
|
||||
O registro MDM da Apple funciona através de cinco mecanismos independentes. Bloquear apenas um ou dois é o motivo pelo qual ferramentas de bypass falham com o tempo. O Runaway aborda todos os cinco.
|
||||
|
||||
```
|
||||
Camada 1: Marcadores DEP ─── /var/db/ConfigurationProfiles/Settings/.cloudConfig*
|
||||
Camada 2: Bloqueio hosts ─── /etc/hosts → 0.0.0.0 deviceenrollment.apple.com
|
||||
Camada 3: Daemons ─── launchd desabilitado → ManagedClient.enroll, activationd
|
||||
Camada 4: Dados usuário ─── ~/Library/Preferences/com.apple.mdm.*
|
||||
Camada 5: Firewall pf ─── pf anchor com.unleash/mdm → bloqueio kernel
|
||||
Camada 5: Firewall pf ─── pf anchor com.runaway/mdm → bloqueio kernel
|
||||
```
|
||||
|
||||
### Camada 1: Marcadores de Registro DEP
|
||||
@@ -100,8 +100,8 @@ pf (packet filter) opera na camada de rede do kernel, abaixo da resolução DNS.
|
||||
## Arquitetura do Script
|
||||
|
||||
```
|
||||
unleash/
|
||||
├── unleash # Ponto de entrada principal
|
||||
runaway/
|
||||
├── runaway # Ponto de entrada principal
|
||||
├── lib/
|
||||
│ ├── colors.sh # Logging, cores, prompts, show_cmd_help()
|
||||
│ ├── detect.sh # Detecção de Recovery, montagem de volume
|
||||
@@ -138,28 +138,28 @@ unleash/
|
||||
|
||||
### Fluxo de Dispatch
|
||||
|
||||
1. `unleash` carrega todos os módulos `lib/*.sh`
|
||||
2. `load_config()` lê `~/.unleash.conf` (se existir)
|
||||
1. `runaway` carrega todos os módulos `lib/*.sh`
|
||||
2. `load_config()` lê `~/.runaway.conf` (se existir)
|
||||
3. O argumento do comando é casado com o `case` dispatch no main
|
||||
4. A função handler é chamada (ex.: `cmd_bypass`, `cmd_firewall`)
|
||||
5. Cada handler chama funções lib que fazem o trabalho real
|
||||
|
||||
### Build Autocontido
|
||||
|
||||
`examples/build-standalone.sh` concatena todos os módulos lib + corpo do script principal em um único arquivo (`unleash-standalone.sh`, ~3200 linhas). Sem dependências externas — funciona em qualquer macOS com bash.
|
||||
`examples/build-standalone.sh` concatena todos os módulos lib + corpo do script principal em um único arquivo (`runaway-standalone.sh`, ~3200 linhas). Sem dependências externas — funciona em qualquer macOS com bash.
|
||||
|
||||
## Processo de Build
|
||||
|
||||
1. **Fonte**: Módulos `lib/*.sh` individuais + ponto de entrada `unleash`
|
||||
1. **Fonte**: Módulos `lib/*.sh` individuais + ponto de entrada `runaway`
|
||||
2. **Teste**: 78 testes Bats cobrindo todos os módulos
|
||||
3. **Build**: `bash examples/build-standalone.sh` → `unleash-standalone.sh`
|
||||
3. **Build**: `bash examples/build-standalone.sh` → `runaway-standalone.sh`
|
||||
4. **Assinar**: `scripts/sign-release.sh` → Assinatura GPG destacada
|
||||
5. **Release**: Release GitHub com standalone + assinatura + checksums
|
||||
|
||||
## Design de Segurança
|
||||
|
||||
### Sem persistência root
|
||||
O Unleash não instala backdoor, cria usuários ocultos ou modifica o volume do sistema. Todas as alterações são reversíveis.
|
||||
O Runaway não instala backdoor, cria usuários ocultos ou modifica o volume do sistema. Todas as alterações são reversíveis.
|
||||
|
||||
### Releases assinados com GPG
|
||||
Releases são assinados com chave GPG. O `selfupdate` verifica a assinatura antes de aplicar atualizações.
|
||||
|
||||
Reference in New Issue
Block a user