176 lines
8.2 KiB
Markdown
176 lines
8.2 KiB
Markdown
---
|
|
layout: default
|
|
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 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.runaway/mdm → bloqueio kernel
|
|
```
|
|
|
|
### Camada 1: Marcadores de Registro DEP
|
|
|
|
Quando uma organização atribui um dispositivo no Apple Business Manager (ABM), o macOS cria arquivos marcadores:
|
|
|
|
```
|
|
/private/var/db/ConfigurationProfiles/Settings/
|
|
.cloudConfigHasActivationRecord ← "este serial está no ABM"
|
|
.cloudConfigRecordFound ← "verificamos e o registro foi acionado"
|
|
.cloudConfigTimerCheck ← "verificar novamente mais tarde"
|
|
```
|
|
|
|
**Ataque**: Remove todos os marcadores `.cloudConfig*`. Cria arquivos falsos (`.cloudConfigRecordNotFound`, `.cloudConfigProfileInstalled`) que dizem ao macOS "nenhum registro necessário."
|
|
|
|
**Fraqueza**: O macOS pode recriá-los a partir de dados em cache se a camada de rede não também estiver bloqueada.
|
|
|
|
### Camada 2: Bloqueio de Rede
|
|
|
|
O cliente de registro contata servidores Apple para baixar o perfil MDM. Sem acesso à rede, não pode completar.
|
|
|
|
**Ataque**: Adiciona 13+ domínios Apple MDM ao `/etc/hosts` apontando para `0.0.0.0` e `::`:
|
|
|
|
```
|
|
0.0.0.0 deviceenrollment.apple.com
|
|
0.0.0.0 mdmenrollment.apple.com
|
|
0.0.0.0 iprofiles.apple.com
|
|
...
|
|
```
|
|
|
|
Também bloqueia o host MDM específico da sua organização (extraído do registro DEP durante o bypass).
|
|
|
|
**Fraqueza**: DNS-over-HTTPS contorna `/etc/hosts` completamente. Chrome, Firefox e alguns serviços do sistema usam DoH por padrão.
|
|
|
|
### Camada 3: Override de Daemons
|
|
|
|
O macOS registra quatro daemons de registro que executam na inicialização:
|
|
|
|
| Daemon | Caminho do sistema | Efeito quando desabilitado |
|
|
|--------|-------------------|----------------------------|
|
|
| `com.apple.ManagedClient.enroll` | `/System/Library/LaunchDaemons/` | Nunca executa registro |
|
|
| `com.apple.ManagedClient.cloudConfiguration` | `/System/Library/LaunchDaemons/` | Sem busca de config em nuvem |
|
|
| `com.apple.mdmclient.daemon.runatboot` | `/System/Library/LaunchDaemons/` | Cliente MDM permanece morto |
|
|
| `com.apple.activationd` | `/System/Library/LaunchDaemons/` | Ativação nunca inicia |
|
|
|
|
**Ataque**: Cria overrides launchd desabilitados em `/private/var/db/com.apple.xpc.launchd/disabled.plist`. Este é o mesmo mecanismo que o macOS usa internamente para `sudo launchctl disable`.
|
|
|
|
### Camada 4: Limpeza de Nível de Usuário
|
|
|
|
Diretórios home carregam artefatos MDM que reativam o registro após o login ou Migration Assistant:
|
|
|
|
```
|
|
~/Library/Preferences/com.apple.mdm.*
|
|
~/Library/Preferences/com.apple.ManagedClient.*
|
|
~/Library/Application Support/com.apple.ManagedClient*/
|
|
~/Library/Caches/com.apple.mdmclient
|
|
~/Library/LaunchAgents/com.apple.mdm.*
|
|
```
|
|
|
|
**Ataque**: Varre todos os diretórios home no volume de Dados. Remove todos os plists, caches e launch agents relacionados ao MDM.
|
|
|
|
**Por que isso importa**: O Migration Assistant copia TUDO acima. Esta é a razão #1 do MDM voltar após um bypass bem-sucedido — e a etapa que a maioria das outras ferramentas pula completamente.
|
|
|
|
### Camada 5: Firewall pf (Nível de Kernel)
|
|
|
|
`/etc/hosts` pode ser contornado por:
|
|
- DNS-over-HTTPS (DoH) no Chrome/Firefox
|
|
- Respostas DNS em cache
|
|
- Conexões IP diretas
|
|
|
|
pf (packet filter) opera na camada de rede do kernel, abaixo da resolução DNS. DoH não contorna pf.
|
|
|
|
**Comando `firewall`**: Bloqueia toda a faixa de IP da Apple:
|
|
```
|
|
17.0.0.0/8 ← Apple
|
|
17.128.0.0/10 ← Apple (estendido)
|
|
```
|
|
|
|
**Comando `whitelist`**: Resolve apenas domínios MDM → IPs e bloqueia especificamente aqueles. iCloud/App Store continuam funcionando.
|
|
|
|
**Comando `vpn-kill`**: Bloqueia IPs MDM quando o dispositivo NÃO está conectado à sua VPN.
|
|
|
|
## Arquitetura do Script
|
|
|
|
```
|
|
runaway/
|
|
├── runaway # Ponto de entrada principal
|
|
├── lib/
|
|
│ ├── colors.sh # Logging, cores, prompts, show_cmd_help()
|
|
│ ├── detect.sh # Detecção de Recovery, montagem de volume
|
|
│ ├── validate.sh # Validação de usuário/senha
|
|
│ ├── dscl.sh # Directory Services (CRUD de usuário)
|
|
│ ├── suppress.sh # Remoção DEP, hosts, desabilitação de daemon
|
|
│ ├── backup.sh # Backup e restore
|
|
│ ├── status.sh # Verificação de saúde e auditoria
|
|
│ ├── heal.sh # Auto-recuperação + LaunchDaemon persist
|
|
│ ├── firewall.sh # Gerenciamento de regras pf
|
|
│ ├── harden.sh # Hardening do sistema em execução
|
|
│ ├── whitelist.sh # Bloqueio seletivo iCloud-safe
|
|
│ ├── check.sh # Avaliação pré-formatação
|
|
│ ├── monitor.sh # Vigia MDM em segundo plano
|
|
│ ├── config.sh # Leitura/escrita de arquivo de config
|
|
│ ├── doctor.sh # Diagnóstico pré-voo
|
|
│ ├── history.sh # Leitura/limpeza de log de eventos
|
|
│ ├── selfupdate.sh # Autoatualização verificada com GPG
|
|
│ ├── uninstall.sh # Remoção completa
|
|
│ ├── report.sh # Relatório completo do sistema
|
|
│ ├── ma_detect.sh # Detecção de Migration Assistant
|
|
│ ├── demo.sh # Bypass simulado (sem alterações)
|
|
│ ├── vpn.sh # Regras pf de kill-switch VPN
|
|
│ ├── init.sh # Assistente de configuração
|
|
│ ├── suggest.sh # Recomendações baseadas em risco
|
|
│ ├── remediate.sh # Limpeza por organização
|
|
│ ├── predict.sh # Consulta de número serial
|
|
│ ├── telemetry.sh # Estatísticas anônimas de uso
|
|
│ └── discord.sh # Bot de alertas Discord
|
|
├── docs/ # Site de documentação Jekyll
|
|
├── tests/ # Testes Bats (78 testes)
|
|
└── examples/ # build-standalone.sh, auto-bypass-usb.sh, etc.
|
|
```
|
|
|
|
### Fluxo de Dispatch
|
|
|
|
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 (`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 `runaway`
|
|
2. **Teste**: 78 testes Bats cobrindo todos os módulos
|
|
3. **Build**: `bash examples/build-standalone.sh` → `runaway-standalone.sh`
|
|
4. **Assinar**: `scripts/sign-release.sh` → Assinatura GPG destacada
|
|
5. **Release**: release com standalone + assinatura + checksums
|
|
|
|
## Design de Segurança
|
|
|
|
### Sem persistência root
|
|
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.
|
|
|
|
### Telemetria opt-in
|
|
Telemetria está DESLIGADA por padrão. Se ativada, envia apenas contagens anônimas (comando executado, versão do macOS, sucesso/falha) — sem números de série, IPs ou dados identificáveis.
|
|
|
|
### Sem dependência de internet
|
|
Comandos principais (`bypass`, `suppress`, `heal`) funcionam completamente offline. Apenas `update`, `firewall` (resolução DNS) e `discord-bot` precisam de rede.
|
|
|
|
---
|
|
|
|
[Voltar ao início](/) · [FAQ](faq)
|