From 34c2a80bc030ba7ba7bc7fabe846cd8ec0d68330 Mon Sep 17 00:00:00 2001 From: ruihan Date: Sat, 20 Jun 2026 18:21:16 -0300 Subject: [PATCH] docs: add EN/PT language toggle and Portuguese pages (index, guide, faq) --- docs/_includes/lang-toggle.html | 72 ++++++ docs/faq.md | 2 + docs/guide.md | 2 + docs/index.md | 2 + docs/pt/faq.md | 142 +++++++++++ docs/pt/guide.md | 177 +++++++++++++ docs/pt/index.md | 439 ++++++++++++++++++++++++++++++++ 7 files changed, 836 insertions(+) create mode 100644 docs/_includes/lang-toggle.html create mode 100644 docs/pt/faq.md create mode 100644 docs/pt/guide.md create mode 100644 docs/pt/index.md diff --git a/docs/_includes/lang-toggle.html b/docs/_includes/lang-toggle.html new file mode 100644 index 0000000..8f5e525 --- /dev/null +++ b/docs/_includes/lang-toggle.html @@ -0,0 +1,72 @@ + + + diff --git a/docs/faq.md b/docs/faq.md index d9b0157..a241ed6 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -138,3 +138,5 @@ Unleash checks for `/private/var/db/dslocal/nodes/Default` on the mounted volume --- [Back to home](/) · [Architecture Guide](guide) + +{% include lang-toggle.html %} diff --git a/docs/guide.md b/docs/guide.md index 294ec40..ec31a8e 100644 --- a/docs/guide.md +++ b/docs/guide.md @@ -173,3 +173,5 @@ Core commands (`bypass`, `suppress`, `heal`) work entirely offline. Only `update --- [Back to home](/) · [FAQ](faq) + +{% include lang-toggle.html %} diff --git a/docs/index.md b/docs/index.md index 5808e0e..e538200 100644 --- a/docs/index.md +++ b/docs/index.md @@ -456,3 +456,5 @@ Use `--verbose` for debug messages and `--log-file ` to write everything t - [Security Policy](https://github.com/mateussiqueira/unleash/blob/main/SECURITY.md) - [Discussions](https://github.com/mateussiqueira/unleash/discussions) - [Report a Bug](https://github.com/mateussiqueira/unleash/issues/new?template=bug_report.md) + +{% include lang-toggle.html %} diff --git a/docs/pt/faq.md b/docs/pt/faq.md new file mode 100644 index 0000000..28172cb --- /dev/null +++ b/docs/pt/faq.md @@ -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 %} diff --git a/docs/pt/guide.md b/docs/pt/guide.md new file mode 100644 index 0000000..25ee258 --- /dev/null +++ b/docs/pt/guide.md @@ -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 %} diff --git a/docs/pt/index.md b/docs/pt/index.md new file mode 100644 index 0000000..2907d5f --- /dev/null +++ b/docs/pt/index.md @@ -0,0 +1,439 @@ +

+ unleash logo +
+ unleash +
+ Script único de bypass MDM para macOS +

+ +

+ Instalar · + Início Rápido · + Comandos · + Guia de Arquitetura · + FAQ · + Solução de Problemas +

+ +--- + +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 ` | 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 ` 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 %}