Manual de operação do RoamSwitch for Mac
Explica, item a item e pela ordem em que realmente aparecem, o menu que se abre a partir do ícone da barra de menus. Mesmo quem o usa pela primeira vez não se perde se abrir o menu e ler por esta ordem.
1. Sobre este manual
O RoamSwitch é uma aplicação com o ícone 🛡️ que fica residente na barra de menus do Mac. Ao contrário das aplicações comuns, que se usam clicando no ícone da Dock, não precisa de ter uma janela sempre aberta. Clique no ícone da barra de menus, no canto superior direito do ecrã, e abre-se um menu adequado à situação do momento.
Os itens do menu não são fixos: mudam consoante o estado do momento. Por exemplo, «Aprovar o auxiliar» só é apresentado enquanto o auxiliar não está aprovado e desaparece depois de aprovado. «Libertar o isolamento Air-Gap» também só é apresentado quando o isolamento está realmente em vigor. Neste manual, estes itens estão assinalados com a marca Apresentação condicional.
Muitas funcionalidades avançadas estão assinaladas com Pro. São funcionalidades que não se podem ativar sem comprar (ou experimentar) o RoamSwitch Pro. Os itens sem marca são gratuitos. Na versão gratuita funcionam a mudança de proteção por rede de confiança, a proteção da área de transferência e os diagnósticos e verificações manuais. As defesas automáticas, como a análise automática de transferências, a vigilância dos itens de arranque automático, a deteção de ransomware e o bloqueio automático de portas e SSH, funcionam no Pro.
2. Ícone da barra de menus e linha de estado
No topo do menu aparece uma linha com o estado de proteção atual. Um emoji e poucas palavras indicam o estado, como em 🛡️ Protegido numa rede fidedigna. Ao clicar nesta linha, abre-se um ecrã que explica o estado em pormenor.
O aspeto do ícone também muda consoante o estado (por exemplo, assume uma cor de aviso durante o isolamento). Basta olhar para o ícone da barra de menus para ter uma ideia aproximada do nível de proteção neste momento.
As marcas nos itens significam: ✅ em funcionamento, 🟡 em funcionamento apenas em parte (por exemplo, helper não ligado), ⚠️ ativado mas parado (por exemplo, Pro desativado). O motivo aparece no fim do item e na janela de aviso. Também aparece em liveState e liveStateReason do get_guard_status do MCP.
15 segundos após o arranque, emite uma vez uma notificação que indica pelo nome as proteções que estão paradas. Se não conseguir ligar-se ao processo auxiliar duas vezes seguidas, emite também uma notificação, uma vez.
3. Aprovação do Auxiliar (apenas na primeira vez) Exibição condicional
Para efetivamente bloquear o tráfego de rede ou alternar a firewall, o RoamSwitch recorre a um pequeno programa auxiliar chamado «Auxiliar», que funciona com privilégios de administrador. Logo após a instalação, enquanto este Auxiliar ainda não tiver sido aprovado, aparece perto do topo do menu o item ⚠️ Aprovar Auxiliar….
Ao clicar, aparece um ecrã a pedir a palavra-passe de administrador do macOS. Depois de introduzir a palavra-passe e aprovar, este item nunca mais aparece e, a partir daí, todas as funções de proteção atuam automaticamente. Até concluir esta aprovação, o RoamSwitch não consegue bloquear realmente a rede. Faça-o sem falta na configuração inicial.
Procedimento
- Clique no ícone 🛡️ da barra de menus e escolha
⚠️ Aprovar Auxiliar…. - Na caixa de diálogo do macOS que aparece, introduza o nome de utilizador e a palavra-passe de uma conta de administrador deste Mac.
- Clique em «Modificar Definições». Quando a caixa de diálogo se fecha e o item desaparece do menu, a aprovação está concluída.
3.1 Notificações e permissões necessárias mais tarde
Os avisos do RoamSwitch chegam como notificações do macOS. Se não permitir as notificações, os avisos não aparecem no ecrã. Se as notificações não estiverem permitidas, isso é indicado na parte superior do menu, na janela de diagnóstico e no guia inicial, e daí pode abrir as Definições do Sistema. Consoante as funcionalidades que usar, serão necessárias mais tarde as permissões seguintes.
- Notificações: em «Notificações», nas «Definições do Sistema», permita o RoamSwitch. Mesmo que defina o estilo como «Nenhum», os avisos não aparecem no ecrã.
- Acesso Total ao Disco: necessário para o registo de execução de processos (Pro, ativado por si). Também é necessário para extrair ficheiros na recuperação de ransomware e para vigiar os cookies do Safari. Permita em «Privacidade e Segurança», nas «Definições do Sistema».
- Aprovação da extensão do sistema: necessária para que a proteção de ligações (Pro) também atue nos navegadores que cifram o DNS (DoH). Até ser aprovada, funciona apenas com a lista de /etc/hosts. Se ficar 10 minutos a aguardar aprovação, notifica (no máximo uma vez em 3 dias).
- Acessibilidade e Monitorização de Entrada: necessárias para a proteção contra USB maliciosos (BadUSB) (Pro, ativada por si).
- Localização: necessária, opcionalmente, apenas se quiser ler o nome da rede Wi-Fi (capítulo 5). O RoamSwitch não lê a localização do Mac.
As funcionalidades a que faltam permissões aparecem no menu com a marca ⚠️ e o motivo. Logo após ativar o Pro, uma notificação informa, uma vez, o que ficou ativado, o que tem de ativar por si e o que ainda não funciona (aprovação do processo auxiliar, aprovação da extensão do sistema, Acesso Total ao Disco, registo de pastas vigiadas).
4. Isolamento Air-Gap: o que mostra e como o remover Exibição condicional
O «Air-Gap» é uma defesa de emergência que desliga fisicamente o Mac da rede quando é detetada uma ameaça grave, como malware ou falsificação de ARP. Enquanto está ativo, a parte superior do menu mostra o tipo de isolamento (isolamento total / modo reduzido) e, se for conhecido, o motivo do acionamento.
| Item | Descrição |
|---|---|
| 🔒 Isolado (total) | Todo o tráfego de rede está a ser bloqueado. |
| 🔒 Isolado (degradado) | Estado em que só é permitida a comunicação mínima necessária e a comunicação suspeita é bloqueada. |
| ℹ️ Porque está isolado & como o remover… | Abre um ecrã que explica porque foi acionado o isolamento e como o remover. |
| 🔓 Remover isolamento Air-Gap | Depois de confirmar que é seguro, liberta-se o isolamento manualmente e repõe-se a comunicação de rede. |
Procedimento
- Clique no ícone 🛡️ da barra de menus e escolha
ℹ️ Porque está isolado e como o remover…, que se encontra abaixo da linha de estado de isolamento (🔒 Isolado…), para verificar o motivo que o desencadeou. - Se não encontrar nada fora do normal, escolha
🔓 Remover isolamento Air-Gapno mesmo menu. - Ao escolher «Libertar» na caixa de diálogo de confirmação, o tráfego de rede é restaurado de imediato.
5. Exibição de informações de ligação Wi-Fi Exibição condicional
Quando está ligado ao Wi-Fi, mostra numa linha o nome da rede (SSID) e o método de cifragem (como WPA3). Ao clicar, vê informações detalhadas da ligação, como a intensidade do sinal e a banda de frequência. Esta linha não aparece quando a ligação é feita apenas por LAN com fios.
O macOS não fornece o nome do Wi-Fi ligado às aplicações sem permissão de localização. Quando não é possível obter o nome, é apresentado «Ligado (nome indisponível)». Mesmo assim, o método de cifragem é avaliado sem o nome e é emitido um aviso para Open e WEP. Para ler o nome é necessária a permissão de localização. A permissão só é pedida quando lê a explicação no menu e clica. Enquanto não for possível obter o nome, a deteção de pontos de acesso falsos com nome semelhante não funciona.
6. Registo e mudança da rede atual
O RoamSwitch protege de forma flexível em locais de confiança, como casa ou o trabalho, e de forma rigorosa em qualquer outra rede desconhecida. Registe uma vez a rede em que se encontra e, da próxima vez que estiver nesse local, o nível de segurança muda automaticamente.
Se estiver numa rede que ainda não registou
| Opção | Descrição |
|---|---|
| Registar como «Casa» (Fidedigna) | Regista esta rede com o nível de segurança mais permissivo. Destinado ao Wi-Fi de casa, usado apenas pela família. |
| Registar como «Trabalho» (Proteção padrão) | Regista esta rede com um nível de segurança médio. Destinado a locais como um escritório, partilhados com outras pessoas. |
| Registar como «Partilha de ligação» (Proteção padrão) | Destinado a ligações como a partilha de ligação do telemóvel: apenas suas, mas mais próximas de uma rede pública. |
| Registar com nome personalizado… | Regista a rede escolhendo você mesmo o nome e o nível de segurança, para a poder identificar como quiser — «Casa dos pais», «Escritório satélite», e assim por diante. |
Procedimento
- Com o Mac ligado à rede que quer registar, clique no ícone 🛡️ da barra de menus.
- Passe o cursor sobre
Registar rede atuale, no submenu que se abre, escolha «Casa», «Trabalho» ou «Partilha de ligação», ou então «Registar com nome personalizado…». - Se escolheu «Registar com nome personalizado…», escreva no campo que aparece o nome que preferir, escolha o nível de segurança e clique em «Registar».
Se estiver numa rede já registada
O submenu lista, como botões de opção, os níveis de segurança que podem ser definidos para essa rede (Fidedigna, Proteção padrão, etc.), com o nível atual assinalado. Ao clicar, o nível muda de imediato. «Mudar o nome…» e «Anular o registo», abaixo do separador, permitem corrigir o nome da rede ou deixar de a registar.
Procedimento
- Para alterar o nível de segurança: clique no ícone 🛡️ da barra de menus →
Rede atual: {nome}e depois no nível para o qual quer mudar. Tem efeito imediato. - Para a renomear: Abaixo do separador no mesmo submenu, clique em «Renomear…», escreva o novo nome e clique em «Guardar».
- Para anular o registo: Clique em «Anular registo» no mesmo submenu. Da próxima vez que se ligar a esta rede, ela é tratada como não registada e aplica-se a proteção predefinida fora de casa (capítulo 8).
7. Gestão das redes registadas
Todas as redes registadas até agora aparecem em lista no submenu. Cada item é apresentado no formato {nome registado} [{nível de segurança}] ({parte do endereço MAC}), seguido do menu para mudar o nível de segurança, mudar o nome e eliminar o registo, igual ao do capítulo 6. Serve para rever de uma só vez as redes registadas quando estava fora e que agora não estão por perto. Se não tiver registado nenhuma, aparece uma indicação de que não há registos.
Procedimento
- Passe o cursor sobre o ícone 🛡️ da barra de menus →
Redes registadas (número). - Passe o cursor sobre a rede que quer rever e aparecem a mesma lista de níveis de segurança do capítulo 6, «Mudar o nome…» e «Anular registo». Escolha a operação de que precisa.
8. Proteção predefinida fora de casa
É o nível de segurança aplicado automaticamente sempre que se liga a uma rede que nunca registou antes — um café, uma estação, um aeroporto, e assim por diante. Pode alterar este nível predefinido selecionando-o no submenu. Como nunca é demasiada precaução numa rede desconhecida, o nível mais restritivo é selecionado por predefinição. Recomendamos que não o baixe, a menos que tenha um bom motivo.
Procedimento
- Passe o cursor sobre o ícone 🛡️ da barra de menus →
Proteção predefinida fora de casa: {nível}. - No submenu que se abre, clique no nível de segurança que quer definir como predefinição.
9. Proteção contra malware (XProtect & ClamAV)
Este é o submenu com mais itens de todo o RoamSwitch. Aqui estão reunidas as definições relacionadas com malware e acessos não autorizados: o XProtect nativo do macOS, o antivírus gratuito ClamAV, a proteção de downloads Web e email, o bloqueio de ameaças ao nível do DNS, a deteção de links de phishing e uma longa lista de funcionalidades de monitorização exclusivas do Pro. Vamos percorrê-las pela ordem em que aparecem.
9.1 Apple XProtect
Verifica a versão atual e o estado de funcionamento do XProtect, o motor de deteção de software malicioso integrado no macOS. «Verificar o estado do XProtect…» mostra os detalhes, e «Diagnóstico de segurança da app Ficheiros…» permite fazer uma verificação simples de ficheiros individuais. Este item mostra o estado da proteção que o Mac já tem; o RoamSwitch não acrescenta proteção.
Procedimento
- Para verificar um ficheiro individual: Escolha «Diagnosticar segurança de ficheiro…» no submenu Proteção contra malware e, na janela que se abre, arraste um ficheiro do Finder ou clique em «Escolher ficheiro» para indicar o ficheiro pretendido.
9.2 ClamAV (Antivírus gratuito)
O ClamAV é um motor antivírus gratuito e de código aberto. Se estiver instalado, pode executar a partir do submenu «Análise rápida agora», «Análise personalizada (indicar uma pasta)», «Atualizar definições de vírus», «Gerir ficheiros em quarentena», etc. Se não estiver instalado, é apresentada em seu lugar uma orientação de instalação.
Procedimento
- Para executar uma análise: Submenu Proteção contra malware → ClamAV → escolha «Análise rápida agora», ou escolha «Análise personalizada…» e indique uma pasta. Pode acompanhar o progresso no ícone da barra de menus ou na janela de análise, e receberá uma notificação quando terminar.
- Para gerir um ficheiro em quarentena: No mesmo submenu, abra «Quarentena», selecione um ficheiro na lista e escolha «Restaurar» (para o repor no local original em caso de falso positivo) ou «Eliminar definitivamente».
- Para atualizar as definições de vírus: no mesmo submenu, clique em «Atualizar definições de vírus». As definições mais recentes são obtidas da internet.
9.3 Proteção Web & email (verificação automática de downloads) Pro
Analisa automaticamente à procura de vírus cada ficheiro novo que aparece numa pasta indicada para vigilância, como a pasta Transferências. Quando transfere um ficheiro no navegador ou guarda um anexo de correio eletrónico, pode verificá-lo antes de o abrir. Com o interruptor ativa ou desativa a função, em «📁 Pastas vigiadas» acrescenta ou edita os alvos, e em «Gestão da quarentena» revê os ficheiros colocados em quarentena juntamente com o resultado da análise. Enquanto estiver ativa, é também apresentado o histórico das análises recentes.
Procedimento
- No submenu Proteção contra malware, verifique a linha «Proteção web e de correio». Já está ativada depois de ativar o Pro. Se a desativou, clique na linha para voltar a ativar o interruptor.
- Abra «📁 Pastas monitorizadas», use «Adicionar pasta» para escolher o local a monitorizar (por exemplo, Transferências) e clique em «Guardar» (a pasta Transferências está incluída por predefinição).
- A partir daí, qualquer novo ficheiro que apareça nessa pasta é analisado automaticamente. Se algo for detetado, recebe uma notificação e o ficheiro é movido para a quarentena.
9.4 Proteção contra ameaças DNS (bloqueio de sites maliciosos & C2) Pro
Função que bloqueia, ao nível do DNS, a resolução de nomes de domínios perigosos, como sites de phishing ou servidores «C2 (comando e controlo)» usados pelo malware para comunicar com os atacantes. Depois de ativar o interruptor, escolha em «Fornecedor» qual o serviço de DNS seguro a usar, e em «Política de aplicação» a quais redes se aplica. Quando ativo, a parte inferior do menu mostra se o DNS seguro está realmente a ser aplicado neste momento, ou excluído por estar numa rede fidedigna.
Procedimento
- No submenu Proteção contra malware, verifique a linha «Proteção DNS contra ameaças». Já está ativada depois de ativar o Pro. Se a desativou, clique na linha para voltar a ativar o interruptor.
- Passe o cursor sobre «Fornecedor» e clique no serviço de DNS seguro que quer usar.
- Passe o cursor sobre «Política de aplicação» e escolha a quais redes se aplica (todas as redes / apenas redes não fidedignas, etc.).
9.5 Proteção de links (deteção de ligações de phishing) Pro
Compara as ligações em que está prestes a clicar e os destinos de ligação das aplicações com uma lista de sites de phishing conhecidos, e avisa em tempo real. No submenu, pode escolher o modo de funcionamento, verificar o estado de atualização do feed de phishing e ativar ou desativar a atualização automática. Quando está ativada, também é apresentado o mecanismo (extensão do navegador, camada de rede, etc.) que está a fazer a verificação.
Procedimento
- No submenu Proteção contra malware, passe o cursor sobre «Proteção de links» e escolha, clicando, o modo de funcionamento (apenas notificar / bloqueio automático, etc.).
- Clique na linha «Atualização automática» para ativar ou desativar a atualização automática do feed de phishing.
«Permitir desta vez (5 min)» na notificação e «Permitir» no painel de aviso concedem a permissão apenas durante 5 minutos. Como a hora de fim da permissão fica guardada, termina ao fim de 5 minutos mesmo que feche ou reinicie a aplicação.
As ligações a servidores externos de diagnóstico (interact.sh, oast.pro, oast.live, oast.site, oast.online, oast.fun, oast.me, burpcollaborator.net, oastify.com, dnslog.cn, ceye.io e os respetivos subdomínios) são notificadas sem serem bloqueadas (nem retidas no modo de aviso). São os destinos com que as ferramentas de diagnóstico verificam se um ataque teve êxito; as aplicações normais quase nunca os usam. A notificação é enviada no máximo uma vez por hora para o mesmo anfitrião e inclui o nome da aplicação. É necessária a aprovação da extensão de sistema e, com a proteção de ligações desligada, não é notificado nada.
A proteção de ligações também atua sobre as ligações de navegadores que cifram o DNS (DoH) depois de aprovar a extensão do sistema. Antes da aprovação, funciona apenas com o bloqueio automático baseado na lista de /etc/hosts, pelo que as ligações DoH não podem ser travadas. Para aprovar, escolha «Aprovar extensão do sistema (abrir Definições do Sistema)…» dentro de «Proteção de ligações» e permita nas «Definições do Sistema». Se ficar 10 minutos à espera de aprovação, é notificado (no máximo uma vez a cada 3 dias). Enquanto a aprovação estiver pendente, a marca no menu é 🟡.
Nos dados de CVE e na lista da proteção de ligações, a hora da última atualização bem-sucedida e a falha mais recente aparecem na janela de cada CVE e no menu. No get_guard_status do MCP, é feedUpdates.
9.6 Ferramentas de verificação manual imediata
| Item | Descrição |
|---|---|
| 🔗 Verificar manualmente uma hiperligação… | Ao colar um URL duvidoso, verifica de imediato se é um site de phishing ou malicioso. |
| 🔑 Auditar manualmente fugas de segredos e chaves API… | Analisa o seu Mac à procura de chaves API, palavras-passe e outras informações sensíveis que possam ter ficado guardadas em texto simples por engano. |
| 📦 Verificar CVE de pacotes (Homebrew)… | Verifica se os pacotes instalados via Homebrew apresentam vulnerabilidades conhecidas (CVE). O Node.js (instaladores oficiais, nvm, fnm, Volta, asdf) e o PHP (MAMP, XAMPP, tarball ou compilação a partir do código-fonte, phpbrew, asdf, phpenv, mise) que o Homebrew não gere também são comparados; a versão é lida sem os executar. |
| 🤖 Auditar os ficheiros de instruções de agentes de IA… | Procura caracteres invisíveis e escritas perigosas como curl | sh nos ficheiros de instruções, nas skills e na memória dos agentes de IA (Claude Code, Codex, etc.) e nas definições do OpenClaw. Nos projetos registados, verifica também as tarefas do VS Code que são executadas só de abrir o projeto e as GitHub Actions, e, nas definições de cada agente, a permissão total sem confirmação e os hooks. Não comunica e não apresenta os valores de chaves nem de tokens. |
Procedimento
- Verificar manualmente uma hiperligação: Ao escolher este item, abre-se um campo de introdução: cole o URL que quer verificar e clique em «Verificar». O veredito de segurança aparece em poucos segundos. Um endereço escrito como nos relatórios de ameaças, por exemplo
hxxps://example[.]com, pode ser colado tal como está. É restaurado para o endereço original antes da verificação. - Auditar manualmente fugas de segredos e chaves API: Ao escolher este item, inicia-se uma verificação; quando terminar, são apresentados em lista os itens detetados (caminho do ficheiro e tipo).
- Verificação de CVE de pacotes: compara os pacotes do Homebrew com vulnerabilidades conhecidas e lista-os. Se em «Aceitar…» definir um motivo e um prazo (30, 90, 180 ou 365 dias), o item sai de «Requer ação» e volta quando o prazo termina ou a versão muda. O EPSS aparece como «EPSS 12 % (data)», mas não confirma exploração. Quando o Homebrew não existe, falha ou devolve 0 itens, é mostrado «Nada foi verificado», e
homebrewInventorytambém distingue estes casos.
O separador Pro verifica o extra-index-url do pip e os @scope do npm cuja origem não está fixada, apenas a ler ficheiros. Os projetos cujo ficheiro de bloqueio não tem uma definição para evitar versões acabadas de publicar são mostrados com gravidade «Baixa». Também avisa dos pacotes que, depois de marcados como verificados, ganharam código executado na instalação do npm.
Nos projetos registados, esta verificação e a de nomes de dependências semelhantes são feitas automaticamente após alterações aos ficheiros de bloqueio e afins, logo após o arranque e uma vez por dia (sem comunicação e sem executar nada). Só uma pessoa pode marcar um item como verificado. É uma função Pro, ativa por predefinição e desativável no menu. - Auditoria dos ficheiros de instruções de agentes de IA: as deteções são mostradas como «Risco: alto» ou «Risco: médio» com a localização e o número da linha. Uma correspondência é um ponto que uma pessoa deve verificar, não uma determinação de intenção maliciosa. As notificações de alteração são uma função Pro; não é enviada nenhuma notificação até criar uma referência com «Marcar como verificado», e o motivo é indicado (
agentSetupWatchemget_guard_status).
9.7 Lista dos interruptores de monitorização contínua
A partir daqui estão os itens que ativam ou desativam, um a um, as monitorizações sempre ativas (pela ordem do menu). Ao ativar o Pro, ativam-se automaticamente a deteção de ransomware, os honey tokens, a auditoria automática de registos, a deteção e o bloqueio de força bruta SSH (secção 11.3), entre outros. As contramedidas ClickFix, a deteção de Docker, a monitorização de credenciais do navegador e o registo da execução de processos estão desativados por predefinição, porque podem atrapalhar a utilização ou exigem permissões adicionais. Ative apenas o que precisar.
As notificações mostram o programa que originou o evento (caminho e PID), o seu processo pai e o comando (os valores secretos são ocultados). As vigilâncias que detetam alterações em ficheiros (itens de arranque, ficheiros críticos, ficheiros de bloqueio) não conseguem saber pelo macOS qual o processo que escreveu o ficheiro, pelo que listam os comandos iniciados por volta da hora da alteração como pistas que não apontam necessariamente para o autor (com o registo de execução de processos ativado). Quando a causa não pode ser identificada, a notificação di-lo.
Procedimento Em qualquer uma destas, basta clicar na linha correspondente no submenu Proteção contra malware para a ativar ou desativar (uma marca de visto indica o estado atual). «🗂 Recuperação de ransomware…» e «🧾 Registo de execução de processos…» não alternam: abrem uma janela dedicada.
| Item | Descrição |
|---|---|
| Bloqueio automático da rede ao detetar malware pelo XProtect Pro | Bloqueia automaticamente o tráfego de rede no instante em que o XProtect deteta malware. |
| Monitoriza novos registos de arranque automático Pro | Monitoriza novos registos de arranque automático de LaunchAgent/LaunchDaemon e deteta persistência suspeita (malware que tenta ficar). Verifica também a cada 5 segundos as linhas suspeitas acrescentadas aos ficheiros de arranque da shell (como .zshrc), scripts periódicos, rc do SSH, hooks do git, hooks de início e fim de sessão e scripts de Folder Action. |
| Bloqueio automático ao detetar comandos suspeitos no Terminal (proteção ClickFix) Pro | Deteta e bloqueia ataques do tipo «ClickFix», em que um falso ecrã de erro o induz a colar um comando malicioso no Terminal. Se o URL do comando corresponder a um instalador oficial conhecido, como o rustup ou o Homebrew, é enviado apenas um alerta informativo em vez de bloquear. |
| Deteta contentores privilegiados do Docker & montagens do docker.sock Pro | Deteta definições perigosas que podem levar facilmente a uma fuga de contentor (arranque em modo privilegiado, montagem errada de docker.sock). O simples facto de um contentor ser um contentor Exegol (ambiente de pentest) não gera notificação. Se um contentor notificado por privilégios ou outro motivo pertencer ao Exegol, a notificação acrescenta uma frase a indicá-lo. |
| 🐤 Deteção de ransomware por ficheiro isco Pro | Coloca deliberadamente «ficheiros isco» em locais bem visíveis, e trata qualquer encriptação ou adulteração desses ficheiros como um sinal imediato de ransomware. |
| 🔐 Deteção genérica de ransomware (análise de entropia) Pro | Deteta estatisticamente quando o conteúdo de um ficheiro passa de repente a dados quase aleatórios (provavelmente cifrados). Abrange também o ransomware novo que não toca nos ficheiros isca. Mesmo que o valor global seja baixo, conta o ficheiro se duas ou mais das janelas divididas em 4 KiB parecerem dados cifrados. Abrange também os métodos que cifram apenas o início do ficheiro e os que cifram um bloco de 4 KiB ou mais de dois em dois. |
| 🍯 Honeytokens de credenciais Pro | Instala credenciais «isco» inexistentes, e trata qualquer tentativa de as ler como prova da presença de um intruso. Num Mac não é possível detetar a leitura de ficheiros de credenciais reais, porque a app não usa o EndpointSecurity e não vê de forma fiável que processo abriu um ficheiro. Não é colocado nenhum isco onde ferramentas de IA como o Claude Code e o Codex leem os seus próprios ficheiros de início de sessão em cada arranque. A notificação mostra o caminho do ficheiro isco, o programa que o leu, o seu processo pai e o comando. Se o processo que o leu já terminou e não pode ser identificado, diz-se isso. |
| 🔑 Monitorização de acesso a credenciais do navegador Pro | Monitoriza acessos suspeitos a palavras-passe e cookies guardados no navegador — um comportamento clássico de malware de roubo de informação. Abrange Chrome, Brave, Edge, Vivaldi, Chromium, Arc, Opera, Opera GX e Firefox, além dos cookies do Safari. O Safari só é vigiado onde o macOS permite que a app leia a pasta, o que exige acesso total ao disco. Orion e DuckDuckGo não estão abrangidos. Que processo abriu um ficheiro é uma estimativa, e a vigilância apenas avisa. Está desativada por predefinição, mesmo com o Pro. |
| 🗂 Recuperação de ransomware… Pro | Abre uma janela para extrair ficheiros para outra localização (~/RoamSwitch-Recovered/<ID>/) a partir dos instantâneos locais APFS que o RoamSwitch cria periodicamente antes de qualquer dano por ransomware. Os ficheiros atuais não são substituídos. Para extrair, é necessária a autorização de acesso total ao disco. |
| 🧾 Registo de execução de processos… Pro | Regista o histórico dos processos iniciados, para que se possa verificar, após um incidente, o que foi executado. Avalia também as regras Sigma (uma parte de process_creation) colocadas em ~/Library/Application Support/RoamSwitch/sigma.d; uma correspondência apenas notifica e regista, sem bloquear. Deteta ainda o -c da shell e as formas de reverse shell de nc, ncat e socat (14 formas no total), os binários não assinados de /tmp, TMPDIR e /Users/Shared e o arranque de ferramentas de ataque como chisel e mimikatz (excluem-se os criados por ferramentas de desenvolvimento e as verificações de conectividade).Notifica quando um processo filho de um agente de programação com IA (claude, codex, etc.) executa um comando que envia ficheiros de credenciais ou valores secretos para o exterior (curl -T, scp, etc.) (T1048; High para ficheiros, Medium só para valores). Notifica também (Medium) quando algo é enviado nos 5 minutos seguintes à leitura de credenciais. Os envios para localhost não são examinados e nada é isolado. As ligações abertas pelas ferramentas integradas do agente, por git push, python e node não são visíveis, e argumentos divididos ou codificados podem passar despercebidos. |
| 📡 Reencaminhamento de eventos (SIEM)… Pro | Envia também os incidentes e notificações para um SIEM, servidor syslog, webhook ou ficheiro que escreveu. Desativado por predefinição. «Reencaminhamento de eventos…» não é um interruptor: abre uma janela própria (9.10). |
| 🔔 Auditoria automática de registos (aprendizagem periódica de novos padrões & anomalias de frequência) Pro | Aprende periodicamente os registos do sistema e deteta e notifica automaticamente padrões ou frequências diferentes do habitual. Só notifica anomalias relacionadas com a segurança, como falhas de autenticação e deteções do XProtect. As alterações nos registos causadas pelo funcionamento normal do sistema operativo não são notificadas e aparecem apenas no ecrã de auditoria. |
| 🔔 Monitorização periódica de adulteração de ficheiros críticos do sistema Pro | Verifica periodicamente se os ficheiros importantes do sistema operativo foram alterados (FIM). A notificação inclui o proprietário e a hora de modificação, bem como os inícios de sessão SSH iniciados desde 30 minutos antes da alteração até logo depois (uma pista baseada apenas na coincidência de tempo). Todos os ficheiros em /etc/sudoers.d e /etc/pam.d também são abrangidos; um ficheiro novo é notificado uma vez e acrescentado à referência. Na primeira verificação após uma atualização do macOS, /etc/pam.d é reimportado e as diferenças não são notificadas. As alterações e eliminações permanecem até que uma pessoa as confirme, e pode atualizar a referência com «Atualizar a referência dos ficheiros importantes para o estado atual…». |
| 🔔 Monitorização periódica de adulteração de ficheiros de bloqueio de dependências Pro | Monitoriza os ficheiros de bloqueio, como package-lock.json, dos projetos de desenvolvimento para detetar reescritas indevidas. Medida contra ataques à cadeia de abastecimento. |
| 🐚 Vigiar reverse shell continuamente Pro | De 4 em 4 segundos examina as shells, os interpretadores, nc, ncat e socat do utilizador com sessão iniciada e notifica quando encontra, duas vezes seguidas, um cuja entrada e saída estejam ligadas a TCP de saída para um endereço público. Apenas notifica; não termina nem bloqueia nada. Fica ativado automaticamente ao ativar o Pro. Limites Não vê os processos de root, as ligações a endereços privados nem os nomes que não constam da lista. O que reconhecer pode ser adicionado à lista de permitidos a partir do menu. |
| 🌐 Vigiar alterações às definições de rede Pro | Compara os servidores DNS, routers, PAC e WPAD distribuídos pela rede ligada com os da vez anterior na mesma rede, e notifica um DNS ou PAC nunca visto e um WPAD recém-ativado. Numa rede nova e perante uma alteração apenas do router, só memoriza. Se um router novo se distribuir a si próprio como novo DNS, a notificação é forte. Não compara a VPN nem os DNS configurados manualmente, e não altera definições nem bloqueia. Registe uma alteração que reconheça com «Atualizar a referência das definições de rede para o estado atual…». Fica ativado automaticamente ao ativar o Pro. Limites Não consegue detetar um servidor falso que distribua o mesmo DNS e router da vez anterior. |
| 🕸 Vigiar as falhas dos workers do servidor web Pro | Lê os registos de erros do nginx, do Apache e do PHP-FPM (Homebrew e o integrado no macOS) e avisa-o quando os workers terminam três vezes em cinco minutos por um sinal de falha (SIGSEGV, SIGABRT e semelhantes). O processo mestre substitui cada worker, por isso nenhuma outra vigilância o nota. Indica uma tentativa de explorar uma vulnerabilidade ou um erro do programa. Uma notificação por servidor por hora; nada é parado nem bloqueado. Também é lido um error_log indicado na configuração do nginx ou do PHP-FPM. |
| 🛡️ Manter as redes de confiança em «Equilibrado» se houver indícios de comprometimento Pro | Mesmo numa rede «Fidedigna (aberta)», enquanto tiver havido nas últimas 6 horas um sinal de comprometimento (um registo de nível high ou superior, como ransomware, honey token ou reverse shell), aplica a proteção padrão (firewall e modo furtivo ativados). Não aplica o bloqueio máximo e não altera nada durante uma substituição manual ou Air-Gap. Notifica quando baixa e quando repõe, e «Verificado (repor a confiança)» repõe de imediato. A duração pode ser alterada para 1 a 72 horas com defaults write com.tetsuharu.RoamSwitch RoamSwitch.DevicePosture.WindowHours -int N. Está ativado por predefinição. |
O registo de execução de processos é Pro e é ativado por si. Como um processo auxiliar executa o eslogger, é necessária a permissão de Acesso Total ao Disco. Até o ativar, não há registo nem deteção de adulteração (cadeia de hashes).
Ao ativar o registo dos processos que abriram ficheiros (desativado por predefinição), fica-se a saber o que a notificação indicava como «desconhecido», por exemplo o processo que leu uma isca. Um processo auxiliar executa dois eslogger, um para a escrita e outro para open, e mantém o registo em memória durante, no máximo, 180 segundos (nada é escrito no disco). Utiliza CPU. Neste Mac, o lado da escrita usou cerca de 0,2 % com cerca de 3 eventos por segundo, e o lado open cerca de 5–8 % com cerca de 256 eventos. Se o lado open exceder continuamente o limite (12 % por predefinição; à escolha 6, 12, 20 ou 30 %), só o lado open pára.
A vigilância dos lockfiles de dependências só observa as pastas vigiadas registadas em «Correspondência de CVE de pacotes». Sem registo, não observa nada. Nesse caso, o menu mostra ⚠️ e o motivo.
Para as iscas e os honeytokens, o menu mostra quantos foram colocados e os motivos dos que não puderam ser colocados. Se nenhum foi colocado, aparece ⚠️. Não são colocados onde existe um ficheiro de credenciais verdadeiro.
Se o docker não responder, a deteção do Docker mostra ⚠️ e o motivo. Os contentores que já estavam a correr quando foi ativada não são analisados.
A vigilância de terminações anómalas dos workers do servidor web não tem interruptor de ativar ou desativar. Com o Pro, funciona desde o arranque. O número de registos seguidos e o seu estado aparecem em webWorkerCrashWatch de get_guard_status.
Quando não foi possível criar o snapshot de recuperação de ransomware, o motivo aparece na janela de recuperação e em lastSnapshotError do MCP. Após 3 falhas seguidas, emite uma notificação, uma vez.
As ferramentas MCP para clientes de IA têm ainda campos como lastSnapshotError (falhas de instantâneo), placement (número de iscas colocadas e os motivos) e feedUpdates (atualizações de dados).
Quando não é possível ler a entrada Se uma monitorização que lê registos ou ficheiros (força bruta SSH, deteção de ransomware, etc.) estiver ativada mas não conseguir ler a sua entrada, notifica a causa com «A entrada não está a ser lida» (uma por interrupção, no máximo uma de 10 em 10 minutos). O que acontece enquanto não consegue ler não pode ser detetado, e não é revisto retroativamente. Em get_guard_status de um cliente de IA aparece liveState. Uma guarda que não consegue ler a sua entrada nunca é mostrada como «ativada».
9.8 Simulações de teste de funcionamento
É um teste simulado inofensivo que verifica em segurança «se está realmente protegido». Sem usar qualquer ameaça real, pode experimentar no momento se o fluxo de deteção, notificação e (se necessário) bloqueio automático funciona corretamente. Utilize-o para verificar o funcionamento logo após a instalação ou para verificações periódicas.
| Item | Descrição |
|---|---|
| 🚨 Simulação de proteção contra ransomware | Com um ficheiro de teste inofensivo, aciona a título de teste a deteção de ficheiros isca e a deteção por entropia. |
| 🚨 Simulação de Air-Gap associado à deteção de malware | Permite-lhe percorrer todo o fluxo, desde a deteção de malware até à ativação do isolamento Air-Gap, sem qualquer dano real. |
| ⚠️ Simulação de deteção de riscos do Docker | Confirma que a notificação de deteção de contentores privilegiados chega corretamente. |
Procedimento
- Escolha no submenu Proteção contra malware a simulação que quer experimentar.
- Se aparecer uma caixa de diálogo de confirmação, escolha «Executar». Se, dentro de poucos segundos a um minuto, receber uma notificação no mesmo formato de uma deteção real, significa que está a funcionar corretamente.
9.9 Regras de deteção de web shells e semelhantes (Web Rules)
Para os Mac usados em desenvolvimento web, esta função encontra web shells PHP, JavaScript, JSP e ASP, código injetado, PHP escondido em imagens e abusos de .htaccess (a partir do Mac 1.11.11). Abrange ~/Sites, MAMP, Herd, Local, /Library/WebServer/Documents, as pastas de projeto registadas para a comparação de CVE de pacotes e as pastas que a proteção web e de correio já vigia (como Transferências). Funciona sem ClamAV.
Abra as definições a partir do ícone 🛡️ da barra de menus → Proteção contra malware → «Definições das regras de web shells…». A janela mostra a versão e o número de regras, «Verificar agora as pastas web de desenvolvimento», botões que abrem as pastas das regras e dos hooks, «Nível de quarentena automática», o interruptor da resposta sobre contas e uma lista de ficheiros detetados mas deixados no sítio.
Por predefinição, a quarentena aplica-se apenas a «critical». As deteções graves, como as web shells de uma linha (eval($_POST[...]) e semelhantes), são movidas para o cofre de quarentena e notificadas, e podem ser repostas em «Gerir ficheiros em quarentena». O «high» não toca no ficheiro: apenas notifica e mostra o item na lista. O nível escolhe-se entre «Não pôr em quarentena», «Só critical» e «critical e high». A lista «Não detetar no futuro» é independente das exclusões do ClamAV.
Quando verifica: as pastas já vigiadas, como Transferências, são verificadas logo após uma escrita. As pastas web de desenvolvimento, uma vez por dia e com «Verificar agora as pastas web de desenvolvimento». A verificação diária não entra em node_modules nem .git porque demoraria demasiado (a de uma pasta escolhida entra em node_modules). O Mac não pode parar nada antes de executar: toda a deteção é posterior.
Quando algo não pôde ser inspecionado: se existirem ficheiros que não se conseguem abrir, pastas cuja lista não pode ser obtida ou ficheiros com mais de 4 MB dos quais só se inspecionou o início, o número é comunicado (numa análise manual, por notificação; na análise diária, no histórico de notificações). Nesse caso, «sem deteções» significa que nada foi encontrado no intervalo que se pôde inspecionar. O número também aparece em webRulesFolderScan de get_guard_status.
Os ficheiros de sessão do PHP também são inspecionados. A análise das pastas web de desenvolvimento (uma vez por dia e manual) lê os ficheiros que começam por sess_. As localizações são session.save_path no php.ini do Homebrew, MAMP e Herd e, quando não há indicação, /tmp, /private/var/tmp e semelhantes. Só são lidos os ficheiros sess_ diretamente na pasta; é critical se a marca de session.upload_progress e uma etiqueta de abertura do PHP estiverem juntas, e high se houver apenas a etiqueta de abertura.
A versão e as definições do PHP são verificadas pelo item «Vulnerabilidades facilmente exploráveis (software instalado)» do diagnóstico (§10). Lê dos ficheiros de configuração as versões do PHP do Homebrew, MAMP, Herd e PATH (as versões corrigidas são 8.2.35, 8.3.36, 8.4.27 e 8.5.12 ou posteriores), mod_php e session.upload_progress.enabled (ativo se não for indicado). O PHP só é iniciado para mostrar a versão e não faz ligações. Para o CVE-2026-115560, que não tem correção, a verificação só falha quando se reúnem as três condições: php_binary ou php_serialize, mudança por ini_set() e progresso de envio ativado.
A verificação de domínios é um item opcional do mesmo ecrã «Definições das regras de deteção de web shells, etc. …». Só funciona quando se introduzem domínios e se carrega em «Verificar domínios»; não é executada periodicamente e não é nem um item do diagnóstico nem uma ferramenta MCP. Um domínio por linha, até 20 (os domínios internacionalizados na forma xn--). Verifica SPF, DMARC (p=none é anotado), MTA-STS (só quando existe um MX; é preciso agir, por exemplo, se mx não abranger todos os hosts MX) e a data de expiração do registo (é preciso agir se faltarem menos de 30 dias ou se tiver expirado), e mostra CAA e DNSSEC como referência. Um item sem resposta é mostrado como não verificável.
Só envia para três destinos: o resolvedor DNS deste Mac (TXT, CAA, DS, MX e o TXT de _mta-sts), o servidor RDAP do registo do TLD (para o encontrar lê também a lista pública da IANA, que não inclui o nome do domínio) e o próprio host mta-sts do domínio (o certificado é verificado e os redirecionamentos não são seguidos). Os resultados não são guardados.
Para utilizadores avançados: coloque as suas próprias regras na localização aberta por «Abrir pasta de regras» (~/Library/Application Support/RoamSwitch/rules.d). Só são lidos os ficheiros cujo proprietário seja root ou o próprio utilizador e que outros não possam escrever. Para chamar um script em cada deteção, coloque post-detection na localização aberta por «Abrir pasta de hooks» (~/Library/Application Support/RoamSwitch/hooks); o conteúdo da deteção é passado em JSON pela entrada padrão e é interrompido ao fim de 30 segundos.
A ação sobre a conta (desativar a shell de início de sessão do proprietário de um ficheiro posto em quarentena) está desativada por predefinição, e ativá-la exige a palavra-passe de administrador. Não faz nada ao utilizador com sessão iniciada, a root nem a UID inferiores a 501, e pode ser anulada a partir do ecrã. As regras verificam-se com «Validar ficheiros de regras…», e o JSON Schema exporta-se com «Exportar esquema» para ~/Library/Application Support/RoamSwitch/web_rules.schema.json.
9.10 Reencaminhamento de eventos (SIEM, syslog, webhook) Pro
Esta funcionalidade guarda os incidentes e notificações que o RoamSwitch registou também num SIEM, servidor syslog, webhook ou ficheiro seu. Está desativada por predefinição e não envia nada. Só funciona quando, na janela aberta a partir do ícone 🛡️ da barra de menus → Proteção contra malware → «Reencaminhamento de eventos (SIEM)…», ativa «Reencaminhar eventos» e escreve um destino. Só envia enquanto houver uma licença Pro ativa.
O que é enviado: apenas o nome do anfitrião, o ID do evento, a hora, o tipo, a gravidade, a regra, a ação, o ID e o nome do processo, e o resumo. O conteúdo dos ficheiros, o ecrã e os carateres escritos não são enviados. Também não se envia nada para os servidores do operador do RoamSwitch. Os incidentes incluem o nome e o ID do processo, pelo que o administrador do destino os pode ver.
Destinos (introduza apenas os que usa): syslog (udp://, tcp://, tls://, RFC 5424 ou CEF), um ficheiro JSON Lines (0600, rotação ao atingir o limite) e um webhook assinado (HMAC-SHA256; o destino e a chave de assinatura ficam guardados na Keychain). O TLS verifica a cadeia de certificados e o nome do anfitrião e não envia nada se não puderem ser verificados. Pode indicar-se uma CA interna em PEM e, nesse caso, só se confia nessa CA. Pode filtrar-se pela gravidade mínima, e «Enviar teste» permite verificar antes de guardar.
Quando o envio falha: os eventos de TCP, TLS e webhook vão para uma fila no disco deste Mac (0600, limitada por «Limite da fila de reenvio» e «Continuar a tentar durante») e são reenviados com intervalos crescentes. Os eventos ainda não enviados ao sair da app também ficam na fila. UDP e o ficheiro não são reenviados. Os números enviados e falhados, o último erro e os eventos a aguardar reenvio aparecem em «Estado» na mesma janela.
Diferença para a edição Linux: os formatos, as definições e os reenvios são os mesmos do Linux (Manual de operação do servidor §16). Os destinos por política da organização (Fleet) e a recusa de endereços internos do webhook da edição Linux não existem no Mac.
9.11 Defesa contra ClickFix (verificação antes de colar e verificação do histórico após a execução) Pro
A proteção contra o ClickFix está no Pro e ativa-se manualmente (desativada por predefinição). Deteta de duas formas: verificando a área de transferência antes de colar e verificando o histórico da shell depois de executar.
Verificação da área de transferência: só lê quando o conteúdo muda e, se corresponder a uma regra de ClickFix, notifica «Colar pode executar um comando perigoso. Não cole no terminal.». Abre-se também uma caixa de diálogo que fica à frente das outras janelas. O botão da notificação ou o da caixa de diálogo permite esvaziar a área de transferência. Não limpa automaticamente e não aciona o Air-Gap. Não guarda o conteúdo e a notificação inclui apenas o nome da regra e os primeiros 8 caracteres.
Só lê a área de transferência a partir do macOS 15.4, e apenas se, em «Definições do Sistema», «Privacidade e Segurança» → «Colar de outras apps», o RoamSwitch estiver em «Permitir». Caso contrário, não lê e o menu mostra «A verificação da área de transferência não está permitida» (no cliente de IA, a origem da leitura é clipboard_not_permitted).
Verificação do histórico da shell: é uma deteção posterior à execução. Por predefinição, o zsh só grava no histórico quando a shell termina. Por isso, nada é detetado até fechar o separador do Terminal.
Se acrescentar setopt INC_APPEND_HISTORY a ~/.zshrc, a deteção ocorre logo após a execução. Pode ser acrescentado, com o seu consentimento, logo após ativar a defesa contra ClickFix e a partir do menu. Mostra a linha a acrescentar e o ficheiro, copia-o para ~/.zshrc.roamswitch-backup e só depois escreve. Não substitui uma cópia de segurança existente e usa outro nome com a hora. «Anular» apaga apenas a linha acrescentada. Se já estiver configurado, não aparece a indicação «Não é detetado até fechar o separador».
Esta definição não se aplica aos separadores do Terminal já abertos; produz efeito a partir de um novo separador. Se ~/.zshrc for uma ligação simbólica, não é reescrito.
10. Diagnóstico de segurança abrangente do Mac
Um diagnóstico geral que pontua as definições de segurança do Mac no seu conjunto. O nome do item de menu mostra em tempo real «○/○ bom · pontuação», pelo que o estado se vê de relance sem abrir o menu. Ao abrir o submenu, aparece o resultado (aprovado ou não) de cada verificação.
| Item | Descrição |
|---|---|
| 📊 Abrir relatório de diagnóstico completo… | Abre um ecrã de relatório com os detalhes de cada verificação e formas de corrigir o que precisar de atenção. |
| 📜 Auditoria de registos de segurança do Mac… | Reveja o registo dos eventos de segurança detetados e registados até agora. |
| 📈 Registo de atividade de segurança… | Pesquise na linha temporal de incidentes de contenção e nas deteções confirmadas de malware em anexos de e-mail, com filtros e um gráfico temporal. Veja a secção 10.1 abaixo para mais detalhes. |
| 🔔 Histórico de notificações… | Lista do histórico de notificações que o RoamSwitch já lhe mostrou. |
| 🛡️ Estado das proteções… | Lista, guarda a guarda, se as proteções ativadas nas definições estão realmente a funcionar. Para uma proteção que não está a funcionar, mostra um código do motivo, a causa e como a corrigir. |
| Executar novo diagnóstico agora | Executa novamente o diagnóstico na hora, atualizando-o com os resultados mais recentes. |
Procedimento
- Depois de rever as definições, clique em «Executar novo diagnóstico agora» no submenu: a pontuação é atualizada ali mesmo.
- Para saber que itens precisam de melhoria, escolha «📊 Abrir o relatório de diagnóstico completo…» e verifique os itens vermelhos e amarelos na janela que se abre. Muitos itens têm um botão que permite resolvê-los no momento.
O estado de funcionamento da proteção é indicado por um de cinco valores: ativa, parcialmente ativa, inativa, desligada e só Pro. Mesmo com a definição ligada, uma proteção não está a funcionar se a edição Pro estiver desativada, o auxiliar não estiver ligado, a extensão do sistema não estiver aprovada ou a sua entrada não puder ser lida. Para essa proteção, são apresentados um código de motivo (o mesmo valor que get_guard_status) e a forma de corrigir, no topo do menu e no relatório do diagnóstico geral. É relido de 15 em 15 segundos e em «Verificar novamente».
Os itens de diagnóstico incluem a deteção automática de proxy (WPAD / PAC) e os ficheiros de credenciais dos agentes de IA. O primeiro reprova se «Deteção automática de proxy» estiver ativada ou se a rede especificar um PAC; um PAC definido por si ou por um administrador é apenas apresentado.
O segundo abrange os ficheiros nas localizações predefinidas do Claude Code, Codex, Gemini CLI e outros, e verifica as suas permissões, o proprietário e se estão dentro de uma pasta de sincronização na nuvem ou de uma árvore de trabalho git. O conteúdo não é lido. Não vê os ficheiros cuja localização foi alterada por uma variável de ambiente, nem o ato de ler os ficheiros.
O diagnóstico também verifica quão recente é a cópia de segurança. Lê o registo do Time Machine e passa se a última cópia tiver no máximo 7 dias. Falha se não houver destino, se não houver cópia registada ou se a última tiver mais de 7 dias. Quando só está instalada outra app de cópias (Arq, Carbon Copy Cloner, SuperDuper!, ChronoSync, Backblaze) ou o registo não pode ser lido, o resultado é «desconhecido» e não entra na pontuação. Os instantâneos locais estão no mesmo disco e não contam como cópia externa. Não se verifica se a cópia pode ser restaurada.
Os itens de diagnóstico incluem também os certificados (autoridades de certificação) em que se confia adicionalmente (trust_anchors). Lê as definições de confiança do utilizador e do administrador com security dump-trust-settings, excluindo os certificados de raiz da Apple e os marcados como «deny». Os que têm um nome que parece uma ferramenta de interceção (mitm, burp, etc.) reprovam, sendo apresentados até 3; os restantes, como um certificado de raiz de empresa, aprovam.
Não vê os certificados que uma aplicação contém nem quando foram acrescentados, e não notifica no momento do acréscimo. O âmbito é T1553.004 (parcial). Não altera nada e não envia nada.
O diagnóstico também tem um item sobre vulnerabilidades com probabilidade de exploração (software instalado). Compara os pacotes instalados com o Homebrew, bem como os Node.js e PHP que o Homebrew não gere (instaladores oficiais, nvm, MAMP, etc.), com os dados de CVE conhecidas existentes neste Mac, e falha quando uma vulnerabilidade cuja exploração a CISA confirmou (KEV), ou com um EPSS (probabilidade de exploração) de 90 % ou mais, permanece numa versão afetada. Um PHP instalado fora do Homebrew é verificado diretamente, pela versão e pelas definições (secção 9.9). A lista KEV chega todos os dias como um pequeno ficheiro assinado, pelo que a marca aparece sem esperar pelos dados semanais. A verificação em si não utiliza a rede. Não vê as vulnerabilidades que não constam dos dados nem o software que não seja Node.js ou PHP instalado fora do Homebrew. Quando não consegue avaliar (sem Homebrew, sem dados, não concluída a tempo), o item fica de fora da pontuação. Este item é verificado de hora a hora (a primeira vez 5 minutos após o arranque) e é enviada uma notificação quando é acrescentada uma nova vulnerabilidade ou passam 24 horas com os mesmos resultados. O Pro recebe uma notificação push; o Free guarda-a no histórico de notificações. Os pacotes instalados com o Homebrew podem ser atualizados executando brew upgrade no Terminal.
10.1 Registo de atividade de segurança
Unifica a linha temporal de incidentes de contenção (deteção de falsificação de ARP, deteção de ficheiro-isco de ransomware, Air-Gap ligado ao XProtect, bloqueio automático de porta desconhecida, entre outros) com as deteções de malware confirmadas em anexos de e-mail num único ecrã, pesquisável por palavra-chave, filtrável por categoria ou gravidade, e explorável através de um gráfico temporal.
| Item | Descrição |
|---|---|
| Pesquisa e filtros | Combina uma pesquisa por palavra-chave com filtros de categoria (falsificação de ARP, ClickFix, etc.), gravidade (info / warning / critical) e período (últimas 24 horas até todo o período). |
| Gráfico temporal | Mostra o número de deteções no período selecionado como gráfico de barras — barras horárias para uma janela de 72 horas ou menos, diárias além disso, com mudança automática. |
| Exploração a partir do gráfico | Clique numa barra para limitar a lista a essa janela horária. Clique novamente para remover o filtro. |
| Exportação para CSV Pro | Exporta os resultados atualmente filtrados como ficheiro CSV. Uma célula que começa por =, +, -, @, uma tabulação ou um retorno de carro é escrita com um ' à frente, para que uma folha de cálculo não a execute como fórmula. |
O ecrã vizinho «📜 Auditoria de registos de segurança do Mac…» abrange o próprio registo unificado do macOS (sudo, SSH, Gatekeeper, XProtect, entre outros); este ecrã, em contrapartida, pesquisa apenas as decisões de contenção próprias do RoamSwitch, reunidas num único local.
Quando uma contenção causada pela deteção de ransomware (ficheiros isca, entropia) ou pela ligação com o XProtect guarda um pacote de provas, essa gravação é acrescentada como um registo sob o registo da deteção. No registo de atividade de segurança, os detalhes da lista mostram «Originado por» e o nome do pacote de provas. Na ferramenta MCP get_incident_timeline para clientes de IA, parentEventID, rootEventID e evidenceRefs aparecem apenas nos registos que têm uma ligação (no máximo 8 referências, que só contêm o nome do pacote, o nome do ficheiro e o SHA-256, nunca o conteúdo). O manifesto do pacote de provas regista também o id do registo que o originou. Só se cria uma ligação quando o id do registo que a originou é conhecido, e nunca só porque as horas estão próximas. A contenção por ARP spoofing não cria nenhum pacote de provas, por isso não tem registos ligados.
Procedimento
- Clique no ícone 🛡️ na barra de menus → «Diagnóstico de segurança Mac abrangente» → «📈 Registo de atividade de segurança…».
- Escolha uma categoria, gravidade e período na parte superior, e digite uma palavra-chave no campo de pesquisa, se necessário.
- Clique numa barra do gráfico para limitar a lista a essa janela horária. Clique novamente para remover o filtro.
11. Monitorização de portas e dispositivos
Esta secção reúne a monitorização da «fronteira do seu Mac com o mundo exterior» — desde a própria rede (ARP spoofing, VPN, portas abertas) até aos dispositivos físicos ligados (USB, Bluetooth).
11.1 Deteção de ARP spoofing
Deteta os ataques de «falsificação ARP (ARP spoofing)», em que outro dispositivo da mesma rede tenta espiar o tráfego do Mac. O estado atual é apresentado numa linha e, enquanto um ataque é detetado, «Bloquear tudo agora» aparece nesse local. «Bloqueio automático» e «Fixar o ARP/NDP da gateway (prevenção)» ativam-se ou desativam-se com interruptores. O segundo é uma medida preventiva que dificulta o próprio ataque em redes não fiáveis. Ao ativar o Pro, «Bloqueio automático» fica ativado por predefinição e «Fixar o ARP/NDP da gateway (prevenção)» fica desativado por predefinição.
Procedimento
- Se quiser bloquear manualmente enquanto um ataque está a ser detetado, clique em «Bloquear tudo agora» no submenu Monitorização de portas e dispositivos.
- Ao clicar nas linhas «Bloqueio automático» e «Fixar ARP/NDP do gateway (preventivo)», o interruptor correspondente é ativado ou desativado ali mesmo.
11.2 Túnel VPN (proteção MITM em redes não fidedignas) Pro
Funcionalidade que, quando está numa rede não fidedigna como um café ou um aeroporto, encripta o tráfego encaminhando-o através de uma VPN. Comece por escolher WireGuard ou Tailscale em «Backend».
| Backend | Características |
|---|---|
| WireGuard | Método que usa uma configuração WireGuard fornecida por si. Pode ligar e desligar, verificar o estado da ligação (handshake), ativar o kill switch (uma rede de segurança que corta todo o tráfego se a VPN cair) e importar ou eliminar ficheiros de configuração. |
| Tailscale | Método que usa a mesh network da sua conta Tailscale. Pode escolher um nó de saída (Exit Node), ativar ou desativar o kill switch, e ligar ou desligar. |
Procedimento
- No submenu Monitorização de portas e dispositivos → «Túnel VPN» → «Backend», escolha se quer usar WireGuard ou Tailscale.
- Para o WireGuard: Escolha «Importar ficheiro de configuração…» e selecione o ficheiro
.confpreparado com antecedência. Depois de importado, clique em «Ligar» para ativar a VPN de imediato. - Para o Tailscale: Ao escolher «Ligar», abre-se no navegador o ecrã de início de sessão do Tailscale. Inicie sessão com a sua conta e autorize. Depois disso, pode escolher o destino do encaminhamento em «nó de saída (Exit Node)».
- Com qualquer dos métodos, clique na linha «Kill switch» para o ligar ou desligar. Quando está ligado, o tráfego é interrompido se a ligação VPN cair inesperadamente, o que impede a fuga de tráfego sem cifra.
11.3 Portas expostas externamente
No Mac, mostra a lista das portas abertas e acessíveis a partir do exterior (por exemplo, um servidor de desenvolvimento esquecido). Também pode verificar o estado atual da firewall. As portas de desenvolvimento deixadas abertas sem intenção são brechas que os atacantes visam com facilidade. Consulte aqui regularmente para confirmar que nenhuma ficou aberta por esquecimento.
| Item | Descrição |
|---|---|
| Bloqueio automático de portas de escuta desconhecidas Pro | Quando é aberta uma porta nova que não reconhece, o acesso a partir do exterior é bloqueado automaticamente. Quando essa porta volta a escutar apenas em 127.0.0.1, o bloqueio é retirado automaticamente (os bloqueios manuais não são retirados). Ativa-se automaticamente quando o Pro é ativado. |
| Deteção de varredura de portas de entrada Pro | Deteta se está a sofrer uma «análise de portas», o reconhecimento que os atacantes fazem antes de um ataque. Ativa-se sozinha ao ativar o Pro e bloqueia automaticamente o endereço de origem durante 10 minutos. O gateway, os servidores DNS e os endereços do próprio Mac nunca são bloqueados. Só o bloqueio pode ser desativado no menu. |
| Deteção e bloqueio de força bruta SSH Pro | Lê o registo do sshd apenas quando o início de sessão remoto (SSH) está ligado. Por predefinição, notifica as origens que falham 6 vezes em 10 minutos e bloqueia durante 1 hora as novas ligações à porta SSH (as ligações em curso não são cortadas). Em cada reincidência, o período é multiplicado por 4, até um máximo de 7 dias, e liga-se automaticamente ao ativar o Pro. Não são bloqueados o gateway, o DNS, o próprio equipamento, as origens da lista de exclusão, as ligações em curso nem as origens que tiveram êxito com chave pública nos últimos 30 dias, e os endereços privados não estão isentos. Se existir fail2ban ou semelhante, apenas notifica. Os IPv6 do mesmo /64 são apenas registados, e os IPv6 externos são bloqueados por /64. |
| Definições do bloqueio de força bruta SSH… | Define o número de falhas e o tempo em que são contadas, a duração do primeiro bloqueio, o multiplicador aplicado a cada reincidência, o limite máximo, durante quanto tempo um início de sessão com chave pública isenta uma origem e a lista de origens que nunca são bloqueadas. Mostra também as origens bloqueadas neste momento e os inícios de sessão SSH recentes, e um bloqueio pode ser levantado por origem ou todos de uma vez. Ao desativar a deteção ou o bloqueio, todos os bloqueios atuais são levantados. A recuperação de emergência da rede também os inclui. |
| Limitar as origens SSH Pro | Em «Configurar o bloqueio de força bruta SSH…», indique em «Limitar as origens SSH» os IP ou intervalos permitidos (CIDR permitido, até 64 linhas) e prima «Limitar apenas a esta lista». As novas ligações SSH vindas de qualquer outro lado são recusadas com o pf. As sessões já estabelecidas não são cortadas, e a própria máquina e o loopback são sempre permitidos. Não é ativado se a lista estiver vazia ou se a origem atual não constar da lista. Com Tailscale, indique também 100.64.0.0/10. O kill switch da VPN não é contornado. Desativado por predefinição. |
| Bloquear o tráfego para servidores de ataque publicados Pro | Descarta o tráfego nos dois sentidos com os 3 endereços IP (210.149.87.120, 118.26.36.16 e 69.10.51.162) publicados pelo JPCERT/CC no seu relatório de 15 de outubro de 2026. Só funciona enquanto o RoamSwitch está a usar o pf (deteção de análise de portas do Pro, bloqueio de portas desconhecidas, kill switch da VPN); caso contrário, não mexe no pf. A auditoria de URL da proteção de ligações também avisa sobre estes 3 endereços. |
| Verificação de vulnerabilidades com prova concreta (verificação ativa de alcançabilidade) | Tenta alcançar as portas abertas para confirmar que são realmente acessíveis a partir do exterior. Envia, sem autenticação, aos servidores de desenvolvimento (127.0.0.1) um GET a cada um de 7 caminhos, como /admin e /actuator/env, e só assinala quando 200 devolve dados (páginas de início de sessão e redirecionamentos excluídos). Não inicia sessão, não adivinha nem faz fuzzing; os efeitos secundários são vestígios nos registos e um grande número de pedidos. Serve para encontrar aplicações que não verificam a autorização no servidor. Aos resultados do nmap não é acrescentado «Comprovado: acessível sem autenticação». |
| Exportar registo da verificação com prova concreta em CSV Pro | Exporta os resultados do diagnóstico para um ficheiro CSV que pode usar em registos e relatórios. Para que as folhas de cálculo não os executem como fórmulas, as células que começam por =, +, -, @, um tabulador ou um retorno de carro são escritas com um ' acrescentado no início. |
| Mostrar estado da verificação de vulnerabilidades com prova concreta Pro | Consulte na hora o resumo dos resultados da verificação mais recente. |
| Emparelhamento com o RoamSwitch Sensor… | Liga este Mac ao «RoamSwitch Sensor», um produto separado instalado em servidores e dispositivos IoT. |
Procedimento
- Para verificar quais as portas abertas, passe o cursor sobre «Portas expostas externamente (número)» no submenu Monitorização de portas e dispositivos.
- Ao escolher «Emparelhamento com o RoamSwitch Sensor…», abre-se um campo de introdução: digite o código de emparelhamento apresentado no ecrã do Sensor e clique em «Associar».
11.4 Dispositivos USB ligados / Proteção USB & BadUSB
Mostra a lista dos dispositivos USB atualmente ligados. Abaixo aparecem as contramedidas contra ataques «BadUSB». O BadUSB é um ataque em que um dispositivo se faz passar por uma pen USB, mas comporta-se como um teclado e escreve comandos por si próprio.
Quando não foi possível obter a lista dos dispositivos USB ligados, mostra que a obtenção falhou e acrescenta a hora da última obtenção bem-sucedida.
| Item | Descrição |
|---|---|
| Proteção física de portas contra USB não autorizado / BadUSB Pro | Deteta e avisa quando é ligado um dispositivo USB que não foi permitido. |
| Bloqueio automático de armazenamento USB não autorizado Pro | Desativa automaticamente qualquer dispositivo de armazenamento USB que não esteja na sua lista de permissões. |
| Definições de proteção USB / BadUSB… | Abre a janela de definições onde regista e gere os dispositivos permitidos. |
Procedimento
- Abra «Definições de proteção USB / BadUSB…», selecione na lista os dispositivos que vai continuar a usar e clique em «Adicionar à lista de permissões».
- Depois de concluir a configuração, clique em «Proteção física de portas contra USB não autorizado / BadUSB» e em «Bloqueio automático de armazenamento USB não autorizado» no submenu Monitorização de portas e dispositivos, para ativar cada uma.
11.5 Desativação automática do Bluetooth Pro
Interruptor que desliga automaticamente o Bluetooth nos momentos apropriados, por exemplo enquanto está numa rede não fidedigna. Reduz as oportunidades de ligações Bluetooth não autorizadas a curta distância. O que é mostrado aqui depende do estado do Bluetooth e do suporte de hardware.
Procedimento Clique na linha correspondente no submenu Monitorização de portas e dispositivos para a ativar ou desativar.
A desativação automática do Bluetooth é Pro e é ativada por si. É necessário o blueutil. Se desaparecer mais tarde, o menu mostra ⚠️ e o motivo, e notifica.
12. Substituição manual
O RoamSwitch normalmente muda o nível de segurança automaticamente consoante a rede a que está ligado. Utilize esta funcionalidade quando quiser fixar um nível específico apenas por agora. Escolha «Voltar à deteção automática» no topo para regressar ao modo automático a qualquer momento. Por baixo estão listados os níveis de segurança e, ao escolher um, é-lhe perguntado durante quanto tempo manter essa definição.
| Duração | Descrição |
|---|---|
| Até à próxima desconexão da rede (recomendado) | É removido automaticamente quando se desliga do Wi-Fi ou muda para outra rede. Não há risco de se esquecer de o repor — é a escolha mais segura. |
| Apenas durante 1 hora | Após 1 hora, regressa automaticamente ao modo automático. |
| Apenas durante 4 horas | Após 4 horas, regressa automaticamente ao modo automático. |
| Manter até ser removido manualmente | Mantém-se nessa definição até você selecionar «Voltar ao automático». Tenha cuidado para não se esquecer de o repor. |
Procedimento
- Passe o cursor sobre o ícone 🛡️ da barra de menus →
Substituição manual. - Clique no nível de segurança que quer fixar.
- Na lista de durações que aparece a seguir, clique durante quanto tempo quer mantê-lo: é aplicado de imediato.
- Sempre que quiser voltar ao modo automático, clique a qualquer momento em «Voltar ao automático» no mesmo local.
13. RoamSwitch Pro
Se o Pro não tiver sido comprado, é apresentado «💎 Ativar / comprar Pro…» e, ao clicar, abre-se o ecrã de ativação da licença (incluindo o caminho de compra). Se o Pro estiver ativo, é apresentado «💎 RoamSwitch Pro (ativo)» e, ao clicar, pode consultar-se o estado atual da licença. Ao ativar aqui a licença, as funcionalidades Pro dos capítulos 9 e 11 ficam disponíveis em conjunto.
Procedimento
- Se ainda não comprou: clique no ícone 🛡️ da barra de menus → «💎 Ativar / comprar Pro…» e continue a compra (ou o período de teste) na janela que se abre.
- Se já tiver uma chave de licença: Cole a chave no campo da chave de licença no mesmo ecrã e clique em «Ativar». Assim que a ativação for concluída com sucesso, o menu muda para «💎 RoamSwitch Pro (Ativo)».
14. Início automático ao iniciar sessão
Alterna o arranque automático do RoamSwitch sempre que o Mac é reiniciado ou se inicia sessão. Se estiver assinalada, arranca ao iniciar sessão. Para estar protegido em permanência, recomenda-se vivamente deixá-la ativada.
14.1 Autovigilância (reinício automático após terminação anómala)
A autovigilância está desativada por predefinição (opt-in). Escolha «Autovigilância (reinício automático após terminação anómala): Desativada…» no menu e, ao aceitar o aviso, o programa de vigilância incluído na aplicação é registado nos itens de início de sessão. Se for pedida aprovação em «Definições do Sistema» → «Geral» → «Itens de início de sessão e extensões», ative o item do RoamSwitch. Até estar ativado, a autovigilância não funciona. Mesmo depois de ativado, só começa a funcionar no próximo início de sessão.
Quando ativada, se o RoamSwitch terminar de forma anómala, reinicia-o e avisa. Enquanto não estiver ativada, não reinicia em caso de terminação anómala. Se existir uma configuração antiga instalada por script, é removida com o seu consentimento antes de registar. Pode desativá-la a qualquer momento no mesmo item. A desinstalação também a remove. O estado aparece no menu e em T1562.001 de get_detection_coverage (liveState e liveStateReason).
15. Idioma / Language
Escolha o idioma de apresentação do RoamSwitch com os botões de opção do submenu. Pode definir um idioma só para o RoamSwitch, separado do idioma do sistema macOS.
Procedimento Clique no idioma que quer usar no submenu: a exibição dos menus e das janelas muda de imediato.
16. Ajuda, Acerca do RoamSwitch & verificação de atualizações
| Item | Descrição |
|---|---|
| Ajuda & Guia… | Abre o ecrã de ajuda incorporado na aplicação. Use-o em conjunto com este manual online. |
| Acerca do RoamSwitch… | Mostra as informações básicas da aplicação, como o número de versão e o programador. Serve também para confirmar o número de versão ao contactar o suporte. |
| Verificar atualizações… | Verifica na hora se está disponível uma nova versão. |
17. Recuperação e desinstalação
| Item | Descrição |
|---|---|
| 🆘 Recuperação de emergência da rede… | Restaura à força a rede quando um isolamento ou bloqueio continuou por engano e já não é possível comunicar. É o último recurso quando «deixou de haver ligação à internet». |
| 🗑 Desinstalar o RoamSwitch… | Remove por completo a aplicação RoamSwitch, o auxiliar e os ficheiros relacionados, seguindo o procedimento correto. Inclui os programas auxiliares que ficariam com um simples arrastar e largar no Finder. |
Procedimento
- Recuperação de emergência quando perde a conetividade: Clique no ícone 🛡️ da barra de menus → «🧰 Recuperação e desinstalação» → «🆘 Recuperação de emergência da rede…» e escolha «Recuperar» na caixa de diálogo de confirmação.
- Para desinstalar: no mesmo submenu, clique em «🗑 Desinstalar o RoamSwitch…». Introduza a palavra-passe de administrador quando for pedida e escolha «Desinstalar» na caixa de confirmação; a aplicação, o auxiliar e todos os ficheiros relacionados são eliminados. Para mais detalhes, consulte os passos de desinstalação.
18. Sair (Quit)
Fecha o RoamSwitch. Enquanto estiver fechado, não funcionam nem a avaliação automática da rede nem as funções de proteção. Se só pretende pará-lo temporariamente, pode também, sem o fechar, fixar o nível de que precisa com a «Substituição manual» do capítulo 12.