docs: add EN/PT language toggle and Portuguese pages (index, guide, faq)
This commit is contained in:
+142
@@ -0,0 +1,142 @@
|
||||
---
|
||||
layout: default
|
||||
title: FAQ — unleash
|
||||
---
|
||||
|
||||
# FAQ
|
||||
|
||||
## Geral
|
||||
|
||||
### Quais versões do macOS são suportadas?
|
||||
|
||||
12.x (Monterey) até 15.x (Sequoia), 26.x (Tahoe) e 27.x. Testado em Intel T2, M1, M2, M3, M4, M5.
|
||||
|
||||
### É a mesma coisa que bypass-mdm?
|
||||
|
||||
Não. Os scripts originais do bypass-mdm (v2, v3, express) só lidam com marcadores DEP e `/etc/hosts`. O Unleash cobre todas as cinco camadas:
|
||||
|
||||
- Marcadores DEP (igual ao original)
|
||||
- Bloqueio de rede via `/etc/hosts` (igual)
|
||||
- Override de daemons (original tem uma versão básica)
|
||||
- **Limpeza de artefatos de usuário** (original não faz isso)
|
||||
- **Firewall pf a nível de kernel** (original não faz isso)
|
||||
- **Daemon de auto-recuperação**, **monitor em segundo plano**, **auditoria**, **predict**, **remediate** e 30+ comandos
|
||||
|
||||
Além de distribuição em arquivo único, Homebrew tap e releases assinados com GPG.
|
||||
|
||||
### Preciso desabilitar o SIP?
|
||||
|
||||
Não. Todas as escritas miram o volume de Dados. O volume do sistema nunca é modificado.
|
||||
|
||||
### Preciso de internet?
|
||||
|
||||
`bypass` e `suppress` não precisam de internet. `persist`, `firewall` e `update` precisam (baixam recursos ou contatam o GitHub).
|
||||
|
||||
### Sobrevive a uma reinstalação do sistema?
|
||||
|
||||
Não. A instalação limpa apaga o volume de Dados. Execute `bypass` do Recovery novamente após reinstalar.
|
||||
|
||||
### Sobrevive a uma atualização do macOS?
|
||||
|
||||
Geralmente sim, com `persist`. O LaunchDaemon executa `heal` automaticamente na próxima inicialização após uma atualização. Sem `persist`, execute `sudo ./unleash heal` manualmente.
|
||||
|
||||
### A organização pode rastrear isso?
|
||||
|
||||
O serial do dispositivo permanece no Apple Business Manager para sempre. Só a organização pode removê-lo. Se o dispositivo se conectar à internet com todas as proteções removidas, ele será registrado novamente.
|
||||
|
||||
### Posso usar iCloud após o bypass?
|
||||
|
||||
Sim. Use `whitelist` em vez de `firewall` ou `suppress` básico. Ele resolve apenas os domínios MDM essenciais para IPs e bloqueia aqueles, deixando iCloud, App Store e atualizações intocados.
|
||||
|
||||
### Por que o MDM volta depois do Migration Assistant?
|
||||
|
||||
O Migration Assistant copia caches, preferências e launch agents do Mac antigo. Estes contêm artefatos de registro MDM que reativam o processo de registro. A maioria das ferramentas só limpa marcadores DEP de nível de sistema — o Unleash também limpa o diretório Library de cada usuário.
|
||||
|
||||
### Tem interface gráfica?
|
||||
|
||||
Ainda não. A CLI é a interface principal. Um wrapper SwiftUI está no [roadmap](https://github.com/mateussiqueira/unleash/blob/main/ROADMAP.md).
|
||||
|
||||
### Qual é a licença?
|
||||
|
||||
MIT. Gratuito para usar, modificar e distribuir.
|
||||
|
||||
## Técnico
|
||||
|
||||
### Como saber se meu Mac está registrado no MDM?
|
||||
|
||||
```bash
|
||||
sudo ./unleash check
|
||||
```
|
||||
|
||||
Retorna SAFE TO FORMAT (sem MDM) ou MDM DETECTED (vai travar após limpar).
|
||||
|
||||
### Como verificar se o bypass ainda está funcionando?
|
||||
|
||||
```bash
|
||||
sudo ./unleash status -d
|
||||
```
|
||||
|
||||
Verifica marcadores DEP, arquivo hosts, overrides de daemon e estado dos perfis.
|
||||
|
||||
### `profiles status -v` ainda mostra um perfil MDM — por quê?
|
||||
|
||||
Cosmético. O macOS armazena o estado dos perfis no SSV (Volume Selado do Sistema) somente leitura. Os daemons de registro reais estão desabilitados e os marcadores DEP foram removidos. Confie em `unleash status` em vez de `profiles status`.
|
||||
|
||||
### Qual a diferença entre `monitor` e `persist`?
|
||||
|
||||
`monitor` é um daemon que verifica a cada 5 minutos e envia uma notificação do macOS se o MDM tentar re-registrar. `persist` é um LaunchDaemon que executa `heal` em cada inicialização. Use ambos para proteção completa.
|
||||
|
||||
### Qual a diferença entre `firewall` e `whitelist`?
|
||||
|
||||
`firewall` bloqueia toda a faixa de IP da Apple (quebra iCloud/App Store). `whitelist` resolve apenas domínios MDM para IPs e bloqueia aqueles (mantém iCloud/App Store funcionando).
|
||||
|
||||
### Quais organizações o `remediate` suporta?
|
||||
|
||||
JAMF, Mosyle, Addigy, Kandji, VMware Workspace ONE. Ele detecta automaticamente a organização a partir do registro DEP e aplica limpeza direcionada.
|
||||
|
||||
### Como o `predict` funciona?
|
||||
|
||||
Ele lê o prefixo do número serial e verifica contra prefixos conhecidos de organizações MDM (de pesquisa comunitária). Se encontrar correspondência, prevê qual organização registrou o dispositivo.
|
||||
|
||||
## Solução de Problemas
|
||||
|
||||
### MDM volta após reiniciar
|
||||
|
||||
Execute do Recovery:
|
||||
```bash
|
||||
sudo ./unleash suppress
|
||||
```
|
||||
|
||||
Ou de um sistema já iniciado:
|
||||
```bash
|
||||
sudo ./unleash harden
|
||||
```
|
||||
|
||||
### Erro "Not a known DirStatus"
|
||||
|
||||
A detecção automática de volume falhou. Encontre seu volume de Dados:
|
||||
```bash
|
||||
diskutil list
|
||||
diskutil mount /dev/diskXsY
|
||||
./unleash bypass
|
||||
```
|
||||
|
||||
### Desbloqueio do FileVault falha no Recovery
|
||||
|
||||
Você precisa de uma senha de usuário ou da chave de recuperação do FileVault. Se nenhum estiver disponível, o volume de Dados não pode ser montado do Recovery. Desbloqueie manualmente no Utilitário de Disco primeiro.
|
||||
|
||||
### "Not a macOS Data volume"
|
||||
|
||||
O Unleash verifica `/private/var/db/dslocal/nodes/Default` no volume montado. Se estiver faltando, você montou o disco errado. Execute `diskutil list` para encontrar o volume de Dados correto.
|
||||
|
||||
### Monitor não inicia
|
||||
|
||||
1. Verifique se já está rodando: `sudo ./unleash monitor-status`
|
||||
2. Verifique permissões: precisa de root
|
||||
3. Verifique logs: `/var/log/unleash-monitor.log`
|
||||
|
||||
---
|
||||
|
||||
[Voltar ao início](/) · [Guia de Arquitetura](guide)
|
||||
|
||||
{% include lang-toggle.html %}
|
||||
@@ -0,0 +1,177 @@
|
||||
---
|
||||
layout: default
|
||||
title: Guia de Arquitetura — unleash
|
||||
---
|
||||
|
||||
# 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.
|
||||
|
||||
```
|
||||
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 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
|
||||
|
||||
```
|
||||
unleash/
|
||||
├── unleash # 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 Jekyll (GitHub Pages)
|
||||
├── tests/ # Testes Bats (78 testes)
|
||||
└── examples/ # build-standalone.sh, auto-bypass-usb.sh, etc.
|
||||
```
|
||||
|
||||
### Fluxo de Dispatch
|
||||
|
||||
1. `unleash` carrega todos os módulos `lib/*.sh`
|
||||
2. `load_config()` lê `~/.unleash.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.
|
||||
|
||||
## Processo de Build
|
||||
|
||||
1. **Fonte**: Módulos `lib/*.sh` individuais + ponto de entrada `unleash`
|
||||
2. **Teste**: 78 testes Bats cobrindo todos os módulos
|
||||
3. **Build**: `bash examples/build-standalone.sh` → `unleash-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.
|
||||
|
||||
### 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)
|
||||
|
||||
{% include lang-toggle.html %}
|
||||
@@ -0,0 +1,439 @@
|
||||
<p align="center">
|
||||
<img src="../icon.svg" width="100" alt="unleash logo">
|
||||
<br>
|
||||
<strong>unleash</strong>
|
||||
<br>
|
||||
<em>Script único de bypass MDM para macOS</em>
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<a href="#instalar">Instalar</a> ·
|
||||
<a href="#inicio-rapido">Início Rápido</a> ·
|
||||
<a href="#comandos">Comandos</a> ·
|
||||
<a href="guide">Guia de Arquitetura</a> ·
|
||||
<a href="faq">FAQ</a> ·
|
||||
<a href="#solucao-de-problemas">Solução de Problemas</a>
|
||||
</p>
|
||||
|
||||
---
|
||||
|
||||
unleash substitui os cinco scripts originais do bypass-mdm em um único arquivo que lida com todas as camadas do registro MDM da Apple: marcadores DEP, bloqueio de rede, substituição de daemons, artefatos de nível de usuário e firewall a nível de kernel. Funciona no modo Recovery em Apple Silicon e Intel.
|
||||
|
||||
**O que torna o unleash diferente de outras ferramentas de bypass:**
|
||||
|
||||
- **Cobre todas as 5 camadas** — não apenas marcadores DEP ou arquivo hosts. Bloqueia todos os caminhos que o MDM usa para re-registrar.
|
||||
- **Limpeza de artefatos de usuário** — o Migration Assistant copia caches MDM por usuário. O Unleash limpa todos os diretórios home.
|
||||
- **Firewall pf a nível de kernel** — `/etc/hosts` é contornado por DNS-over-HTTPS. pf não.
|
||||
- **Daemon de auto-recuperação** — sobrevive a atualizações do macOS. `persist` + `heal` pegam tudo que a atualização resetar.
|
||||
- **39 comandos** — bypass, suppress, monitor, harden, audit, backup, predict, remediate e mais.
|
||||
- **macOS 12–27** — testado em Intel T2, M1, M2, M3, M4, M5.
|
||||
|
||||
---
|
||||
|
||||
## Instalar
|
||||
|
||||
**Homebrew (mais fácil)**
|
||||
```bash
|
||||
brew install mateussiqueira/unleash/unleash
|
||||
```
|
||||
|
||||
**Download direto**
|
||||
```bash
|
||||
curl -L https://raw.githubusercontent.com/mateussiqueira/unleash/main/unleash-standalone.sh -o unleash
|
||||
chmod +x unleash
|
||||
```
|
||||
|
||||
**De um pendrive USB (para o modo Recovery)**
|
||||
1. Formate um USB/SSD como FAT32, APFS ou exFAT
|
||||
2. Copie a pasta `unleash` (ou apenas `unleash-standalone.sh`) para o drive
|
||||
3. Inicialize no Recovery e execute de `/Volumes/SeuDrive/unleash`
|
||||
|
||||
---
|
||||
|
||||
## Início Rápido
|
||||
|
||||
### Modo Recovery (bypass padrão)
|
||||
|
||||
1. Inicialize no Recovery:
|
||||
- **Apple Silicon**: segure o botão power → Options → Continue
|
||||
- **Intel**: Cmd+R ao ligar
|
||||
|
||||
2. Abra o Terminal (Utilitários → Terminal)
|
||||
|
||||
3. Execute:
|
||||
```bash
|
||||
"/Volumes/SeuDrive/unleash" bypass
|
||||
```
|
||||
|
||||
4. Siga as instruções para criar um usuário admin temporário
|
||||
|
||||
5. Reinicie. O registro MDM será suprimido.
|
||||
|
||||
### Sistema já iniciado (já configurado)
|
||||
|
||||
Se você já tem um Mac que foi bypassado anteriormente e o MDM voltou após uma atualização:
|
||||
|
||||
```bash
|
||||
sudo ./unleash heal
|
||||
```
|
||||
|
||||
Ou para verificar o status atual:
|
||||
|
||||
```bash
|
||||
sudo ./unleash status -d
|
||||
```
|
||||
|
||||
### Configuração com um comando (Mac novo)
|
||||
|
||||
```bash
|
||||
sudo ./unleash init
|
||||
```
|
||||
|
||||
Assistente interativo que executa a configuração completa: firewall, monitor, persist, backup e audit.
|
||||
|
||||
---
|
||||
|
||||
## Comandos
|
||||
|
||||
### Bypass & suppress
|
||||
|
||||
| Comando | Descrição | Recovery | Iniciado |
|
||||
|---------|-----------|----------|----------|
|
||||
| `bypass` | Bypass completo: cria usuário admin + suprime MDM | ✓ | ✗ |
|
||||
| `suppress` | Suprime registro sem criar um usuário | ✓ | ✓ |
|
||||
| `heal` | Reaplica supressão após atualizações do macOS | ✓ | ✓ |
|
||||
| `persist` | Instala LaunchDaemon para auto-recuperação na inicialização | ✓ | ✓ |
|
||||
| `unpersist` | Remove o LaunchDaemon de auto-recuperação | ✗ | ✓ |
|
||||
|
||||
### Firewall & hardening
|
||||
|
||||
| Comando | Descrição |
|
||||
|---------|-----------|
|
||||
| `firewall` | Bloqueia IPs Apple MDM via pf (nível de kernel, à prova de DoH) |
|
||||
| `firewall-off` | Remove o bloqueio pf do MDM |
|
||||
| `whitelist` | Bloqueia apenas domínios MDM, mantém iCloud/App Store |
|
||||
| `harden` | Mata processos MDM, remove perfis, limpa DNS — do sistema iniciado |
|
||||
|
||||
### Diagnósticos
|
||||
|
||||
| Comando | Descrição |
|
||||
|---------|-----------|
|
||||
| `audit` | Varredura MDM profunda — perfis, certificados, launch agents, score de risco |
|
||||
| `check` | Avaliação pré-formatação — este Mac vai travar após limpar? |
|
||||
| `history` | Mostra o log de eventos do monitor/heal |
|
||||
| `history-clear` | Limpa o log de eventos |
|
||||
| `doctor` | Diagnóstico pré-voo — root, Recovery, libs, disco, dependências |
|
||||
| `status` | Status do registro MDM (use `-d` para modo profundo) |
|
||||
| `report` | Relatório completo do sistema em formato legível ou JSON |
|
||||
|
||||
### Monitoramento
|
||||
|
||||
| Comando | Descrição |
|
||||
|---------|-----------|
|
||||
| `monitor` | Monitora o estado do MDM a cada 5 minutos, auto-recupera se necessário |
|
||||
| `monitor-stop` | Para o monitor em segundo plano |
|
||||
| `monitor-status` | Verifica se o monitor está rodando |
|
||||
| `monitor-install` | Instala o monitor como um LaunchDaemon |
|
||||
|
||||
### Kill-switch VPN
|
||||
|
||||
| Comando | Descrição |
|
||||
|---------|-----------|
|
||||
| `vpn-kill` | Instala kill-switch pf — bloqueia MDM fora do túnel VPN |
|
||||
| `vpn-kill-remove` | Remove o kill-switch VPN |
|
||||
| `vpn-kill-status` | Verifica o estado do kill-switch VPN |
|
||||
|
||||
### Utilitários
|
||||
|
||||
| Comando | Descrição |
|
||||
|---------|-----------|
|
||||
| `update` | Autoatualização a partir do GitHub Releases (verificada com GPG) |
|
||||
| `uninstall` | Remoção completa com confirmações de segurança |
|
||||
| `reinstall` | Desinstalar + instalar (atualização atômica) |
|
||||
| `config` | Ver/editar configurações persistentes em `~/.unleash.conf` |
|
||||
| `backup` | Salva o estado atual para restaurar depois |
|
||||
| `restore` | Restaura a partir de um backup anterior |
|
||||
| `demo` | Fluxo de bypass simulado — sem alterações reais |
|
||||
| `test` | Simulação dry-run de qualquer comando |
|
||||
| `dualboot` | Mira um volume externo ou dual-boot |
|
||||
|
||||
### Comandos inteligentes (v2.0)
|
||||
|
||||
| Comando | Descrição |
|
||||
|---------|-----------|
|
||||
| `init` | Assistente de configuração interativo — firewall, monitor, persist, backup |
|
||||
| `suggest` | Análise de risco e recomendações baseadas no sistema |
|
||||
| `remediate` | Limpeza por organização (JAMF, Mosyle, Addigy, Kandji, VMware) |
|
||||
| `predict` | Consulta de número serial — prevê qual organização registrou este Mac |
|
||||
| `telemetry` | Gerencia estatísticas de uso anônimas (opt-in) |
|
||||
| `discord-bot` | Inicia o bot de alertas do Discord |
|
||||
| `discord-bot-stop` | Para o bot do Discord |
|
||||
| `discord-bot-status` | Verifica se o bot do Discord está rodando |
|
||||
|
||||
### Aliases
|
||||
|
||||
Cada comando tem um alias curto:
|
||||
|
||||
```
|
||||
by = bypass fw = firewall fw-off = firewall-off
|
||||
sv = suppress mn = monitor doc = doctor
|
||||
st = status up = update uni = uninstall
|
||||
rei = reinstall vk = vpn-kill vkr = vpn-kill-remove
|
||||
vks = vpn-kill-status wl = whitelist
|
||||
it = init su = suggest rm = remediate
|
||||
pr = predict tel = telemetry db = discord-bot
|
||||
dbs = discord-bot-stop dbs2 = discord-bot-status
|
||||
```
|
||||
|
||||
### Opções globais
|
||||
|
||||
| Opção | Efeito |
|
||||
|-------|--------|
|
||||
| `--verbose` | Mostra mensagens de debug |
|
||||
| `--log-file <caminho>` | Escreve logs em um arquivo |
|
||||
|
||||
---
|
||||
|
||||
## Cenários
|
||||
|
||||
### Antes de comprar um Mac usado
|
||||
|
||||
```bash
|
||||
./unleash predict ABC12345678 # verifica serial contra organizações conhecidas
|
||||
./unleash check # este Mac é seguro para formatar?
|
||||
```
|
||||
|
||||
`predict` consulta o serial contra prefixos conhecidos de organizações MDM. Se corresponder a JAMF, Mosyle ou outra, você sabe o que esperar antes de comprar.
|
||||
|
||||
### Recuperação após Migration Assistant
|
||||
|
||||
1. Instale o macOS em um Mac novo
|
||||
2. O Migration Assistant copia seus dados antigos
|
||||
3. O MDM aparece em minutos após o login
|
||||
|
||||
**Solução**: Inicialize no Recovery e execute `unleash suppress` (ou `bypass` se precisar de um novo admin). Remove os marcadores DEP, artefatos de usuário e preferências MDM que o MA transferiu.
|
||||
|
||||
### Atualização do macOS trouxe o MDM de volta
|
||||
|
||||
1. A atualização do sistema restaura os daemons de registro automaticamente
|
||||
2. O bloqueio MDM em `/etc/hosts` geralmente é preservado
|
||||
|
||||
**Solução**: `sudo ./unleash heal` — re-desabilita daemons e verifica todas as camadas. Se você executou `persist` antes da atualização, isso acontece automaticamente na próxima inicialização.
|
||||
|
||||
### Configurando um Mac novo antes do primeiro boot
|
||||
|
||||
1. Inicialize no Recovery sem Wi-Fi
|
||||
2. Execute `unleash init` — assistente interativo
|
||||
3. Ele irá: suprimir MDM, instalar persist, instalar whitelist, executar audit
|
||||
4. Reinicie, configure normalmente, o MDM nunca incomoda
|
||||
|
||||
---
|
||||
|
||||
## Como Funciona
|
||||
|
||||
O MDM (Mobile Device Management) opera em cinco camadas no macOS. O Unleash bloqueia todas elas:
|
||||
|
||||
**Camada 1: Marcadores DEP** → `/etc/hosts` → **Camada 2: Bloqueio de rede**
|
||||
|
||||
**Camada 3: Override de daemons** → launchd desabilitado → **Camada 4: Artefatos de usuário**
|
||||
|
||||
**Camada 5: Firewall pf** → nível de kernel, à prova de DoH
|
||||
|
||||
### Camada 1: Marcadores de registro DEP
|
||||
|
||||
Em `/var/db/ConfigurationProfiles/Settings/`, a Apple armazena arquivos `.cloudConfig*` que marcam o Mac como registrado no DEP. Removê-los é a abordagem padrão de bypass.
|
||||
|
||||
**O que o unleash faz**: Remove todos os marcadores `.cloudConfig*`, cria arquivos falsos que dizem ao macOS que o dispositivo nunca foi registrado e impede a recriação bloqueando também a camada de rede.
|
||||
|
||||
### Camada 2: Bloqueio de rede
|
||||
|
||||
O cliente de registro contata os servidores da Apple para baixar o perfil MDM. Sem acesso à rede, ele não pode completar o registro.
|
||||
|
||||
**O que o unleash faz**:
|
||||
- **`/etc/hosts`** (básico): Bloqueia 13+ domínios Apple MDM incluindo `deviceenrollment.apple.com`, `mdmenrollment.apple.com`, `iprofiles.apple.com`. Entradas IPv4 (0.0.0.0) e IPv6 (::).
|
||||
- **Firewall pf** (avançado): Filtragem de pacotes a nível de kernel que bloqueia faixas de IP Apple mesmo quando DoH é usado.
|
||||
|
||||
Domínios bloqueados:
|
||||
|
||||
| Domínio | Serviço |
|
||||
|---------|---------|
|
||||
| `iprofiles.apple.com` | Entrega de perfis |
|
||||
| `deviceenrollment.apple.com` | Serviço DEP |
|
||||
| `mdmenrollment.apple.com` | Registro MDM |
|
||||
| `acmdm.apple.com` | Apple Configurator 2 MDM |
|
||||
| `axm-adm-mdm.apple.com` | Registro ACM |
|
||||
| `albert.apple.com` | Atribuição ABM |
|
||||
| `gdmf.apple.com` | Framework MDM |
|
||||
| `configuration.apple.com` | Serviço de configuração |
|
||||
| `xp.apple.com` | Gerenciamento de dispositivos |
|
||||
| `gs.apple.com` | Registro GSM |
|
||||
| `tb.apple.com` | Trust de dispositivo |
|
||||
| `vpp.itunes.apple.com` | Programa de compra em volume |
|
||||
|
||||
Mais o host MDM específico da sua organização, extraído do registro DEP.
|
||||
|
||||
### Camada 3: Override de daemons
|
||||
|
||||
O macOS registra quatro daemons de registro que executam na inicialização:
|
||||
|
||||
| Daemon | Propósito |
|
||||
|--------|-----------|
|
||||
| `com.apple.ManagedClient.enroll` | Registro principal |
|
||||
| `com.apple.ManagedClient.cloudConfiguration` | Configuração em nuvem |
|
||||
| `com.apple.mdmclient.daemon.runatboot` | Cliente MDM |
|
||||
| `com.apple.activationd` | Ativação do dispositivo |
|
||||
|
||||
**O que o unleash faz**: Cria overrides launchd desabilitados para todos os quatro, impedindo que iniciem.
|
||||
|
||||
### Camada 4: Limpeza de artefatos de usuário
|
||||
|
||||
O Migration Assistant e caches de login deixam dados de registro MDM nos diretórios home:
|
||||
|
||||
```
|
||||
~/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.*
|
||||
```
|
||||
|
||||
**O que o unleash faz**: Varre todos os diretórios home no volume de Dados e remove todos os preferences, caches e launch agents relacionados ao MDM.
|
||||
|
||||
### Camada 5: Firewall pf (opcional, avançado)
|
||||
|
||||
`/etc/hosts` pode ser contornado por DNS-over-HTTPS (DoH). O pf opera a nível de kernel — DoH não o contorna.
|
||||
|
||||
**Comando `firewall`**: Bloqueia toda a faixa de IP da Apple (`17.0.0.0/8` + `17.128.0.0/10`). 100% eficaz mas quebra iCloud, App Store e atualizações.
|
||||
|
||||
**Comando `whitelist`**: Resolve apenas os domínios MDM essenciais para IPs e bloqueia especificamente aqueles. Mantém iCloud e App Store funcionando.
|
||||
|
||||
---
|
||||
|
||||
## Intel vs Apple Silicon
|
||||
|
||||
| | Intel T2 | Apple Silicon |
|
||||
|---|---|---|
|
||||
| Recovery | Cmd+R ao ligar | Segurar botão power |
|
||||
| Volume do sistema | Gravável com SIP desabilitado | Apenas leitura (SSV) |
|
||||
| Desbloqueio FileVault | `diskutil apfs unlockVolume` | Igual, precisa de senha ou chave de recuperação |
|
||||
| Daemons de registro | Menos | `activationd` + `cloudConfiguration` |
|
||||
| Migration Assistant | Menos arriscado | **Carrega estado MDM** — sempre limpar depois |
|
||||
|
||||
No Apple Silicon, todas as escritas miram o volume de Dados. O volume do sistema nunca é modificado. Não precisa desabilitar SIP.
|
||||
|
||||
---
|
||||
|
||||
## Compatibilidade com versões do macOS
|
||||
|
||||
| Versão | Codinome | Status |
|
||||
|--------|----------|--------|
|
||||
| 12.x | Monterey | ✓ Testado |
|
||||
| 13.x | Ventura | ✓ Testado |
|
||||
| 14.x | Sonoma | ✓ Testado |
|
||||
| 15.x | Sequoia | ✓ Testado |
|
||||
| 26.x | Tahoe | ✓ Testado |
|
||||
| 27.x | (atual) | ✓ Testado |
|
||||
|
||||
Deve funcionar em qualquer versão que use o mesmo mecanismo de registro MDM — que não mudou desde Monterey.
|
||||
|
||||
---
|
||||
|
||||
## Solução de Problemas
|
||||
|
||||
### MDM volta após reiniciar
|
||||
|
||||
A causa mais provável são artefatos de nível de usuário. Execute do Recovery:
|
||||
```bash
|
||||
sudo ./unleash suppress
|
||||
```
|
||||
Ou de um sistema já iniciado:
|
||||
```bash
|
||||
sudo ./unleash harden
|
||||
```
|
||||
|
||||
### Erro "Not a known DirStatus"
|
||||
|
||||
O script detecta volumes automaticamente, mas se você tiver uma configuração não padrão:
|
||||
1. Execute `diskutil list` para encontrar seu volume de Dados
|
||||
2. Monte: `diskutil mount /dev/diskXsY`
|
||||
3. Execute unleash novamente
|
||||
|
||||
### Perfis ainda mostram registro
|
||||
|
||||
Isso é cosmético. O macOS armazena estado de perfis no SSV (Volume Selado do Sistema). Verifique os marcadores DEP reais:
|
||||
```bash
|
||||
sudo ./unleash status -d
|
||||
```
|
||||
|
||||
### FileVault está ativado
|
||||
|
||||
O Unleash detecta FileVault e pede a chave de recuperação ou senha do volume. Se o desbloqueio automático falhar, desbloqueie o volume manualmente no Utilitário de Disco primeiro.
|
||||
|
||||
### Atualização do macOS reativou o MDM
|
||||
|
||||
Execute `sudo ./unleash heal` após qualquer atualização do macOS. Se você usou `persist` antes da atualização, isso acontece automaticamente na próxima inicialização.
|
||||
|
||||
### Posso usar iCloud após o bypass?
|
||||
|
||||
Sim, mas:
|
||||
- O bloqueio básico de `/etc/hosts` também bloqueia `albert.apple.com` (ativação do iCloud) e `gdmf.apple.com`
|
||||
- Use o comando `whitelist` em vez de `firewall` para bloquear apenas domínios MDM e deixar iCloud/App Store funcionando
|
||||
- Ou remova manualmente essas duas linhas de `/etc/hosts`
|
||||
|
||||
### Restauração DFU / IPSW (travamento total)
|
||||
|
||||
Se o MDM for inquebrável mesmo do Recovery, o dispositivo pode precisar de uma restauração completa de firmware. Isso se aplica apenas ao Apple Silicon.
|
||||
|
||||
Você precisa de um segundo Mac com Apple Configurator 2 (grátis), um cabo USB-C e o arquivo IPSW para seu modelo de Mac.
|
||||
|
||||
1. Abra o Apple Configurator 2 no Mac auxiliar
|
||||
2. Conecte o Mac travado via USB-C enquanto segura o power
|
||||
3. No Configurator: clique com direito no dispositivo DFU → Advanced → Restore
|
||||
4. Escolha o arquivo IPSW, aguarde 10–30 minutos
|
||||
5. Após restaurar, inicialize no Recovery sem Wi-Fi e execute `unleash bypass`
|
||||
|
||||
**Isso apaga todos os dados.** Arquivos IPSW em [ipsw.me](https://ipsw.me).
|
||||
|
||||
---
|
||||
|
||||
## Logging
|
||||
|
||||
Todos os comandos registram com timestamps e níveis:
|
||||
|
||||
```
|
||||
[INF] Data volume: /Volumes/Macintosh HD - Data
|
||||
[ OK] Admin 'apple' created (UID 501)
|
||||
[WRN] DEP activation record present
|
||||
[ERR] Firewall needs sudo: sudo ./unleash firewall
|
||||
[STP] Locating Data volume by APFS role...
|
||||
[DBG] Checking pfctl availability
|
||||
```
|
||||
|
||||
Use `--verbose` para mensagens de debug e `--log-file <caminho>` para escrever tudo em um arquivo.
|
||||
|
||||
---
|
||||
|
||||
## Segurança
|
||||
|
||||
- **Sem escritas no SSV** — todas as alterações miram o volume de Dados
|
||||
- **Reversível** — `backup` salva o estado, `restore` reverte
|
||||
- **Sem apagar dados** — nunca executa `profiles renew` ou comandos de apagar
|
||||
- **Idempotente** — executar múltiplas vezes é inofensivo
|
||||
- **Pede confirmação** antes de ações destrutivas
|
||||
|
||||
---
|
||||
|
||||
## Links
|
||||
|
||||
- [Repositório GitHub](https://github.com/mateussiqueira/unleash)
|
||||
- [README completo](https://github.com/mateussiqueira/unleash/blob/main/README.md)
|
||||
- [Guia de Arquitetura](guide)
|
||||
- [FAQ](faq)
|
||||
- [Changelog](https://github.com/mateussiqueira/unleash/blob/main/CHANGELOG.md)
|
||||
- [Contribuindo](https://github.com/mateussiqueira/unleash/blob/main/CONTRIBUTING.md)
|
||||
- [Código de Conduta](https://github.com/mateussiqueira/unleash/blob/main/CODE_OF_CONDUCT.md)
|
||||
- [Política de Segurança](https://github.com/mateussiqueira/unleash/blob/main/SECURITY.md)
|
||||
- [Discussões](https://github.com/mateussiqueira/unleash/discussions)
|
||||
- [Reportar Bug](https://github.com/mateussiqueira/unleash/issues/new?template=bug_report.md)
|
||||
|
||||
{% include lang-toggle.html %}
|
||||
Reference in New Issue
Block a user