Reveal URLs

Safari is supported through its macOS Xcode container and App Store route. Built-in providers use static scripts and Safari requests no all-sites access. A user-added site needs a runtime optional permission, then Safari injects content.js after navigation only for a granted, enabled, non-builtin rule; sub-frames run only when All frames is enabled. Safari settings are device-local and do not roam.

Reveal URLs — Manual do utilizador

O Reveal URLs é uma pequena extensão de navegador (e add-on do Thunderbird) que lhe mostra para onde uma ligação no seu e-mail realmente vai, para que possa detetar um link de phishing antes de clicar nele.

Este manual explica como instalar o Reveal URLs e como o utilizar. Para perguntas frequentes, consulte as perguntas frequentes; para saber como os seus dados são tratados, consulte a política de privacidade; para uma descrição técnica, consulte a descrição da arquitetura.

Encontrou um erro, uma ligação que foi assinalada erradamente (ou não detetada), ou um anfitrião de webmail que devia ser suportado? Comunique-o no rastreador de problemas do Codeberg.

Índice

O que faz e porquê

Um e-mail de phishing esconde um destino hostil atrás de um texto de ligação de aparência fidedigna. Por vezes é um anfitrião semelhante: o texto diz paypal.com enquanto a ligação aponta para paypa1.com. Muitas vezes é mais subtil, encaminhando através de um rastreador ou redirecionador, pelo que o sítio onde acaba não tem nada a ver com a marca indicada no texto.

Um e-mail de phishing que se faz passar por um serviço postal afirma que uma encomenda está retida até serem pagas taxas aduaneiras em atraso e incentiva o pagamento através de um botão «Ir para o pagamento». O Reveal URLs mostra que o botão não aponta para esse serviço postal, mas para parcel-pay.custom.co.xa, um sítio sem relação, revelando assim a mensagem como fraude.
O Reveal URLs desmascara o botão «Ir para o pagamento»: aponta para parcel-pay.custom.co.xa, não para o serviço postal que imita.

Nota: Esta captura de ecrã mostra um e-mail de phishing fraudulento que se faz passar por um serviço postal. O serviço imitado não é afiliado à Reveal URLs nem a apoia.

O Reveal URLs lê cada ligação na mensagem que está a ler e mostra-lhe o URL para onde realmente aponta. Na extensão de navegador e no Thunderbird, assinala ligações web, de e-mail, telefónicas e outras que induzem em erro, para que a diferença seja óbvia antes de clicar.

O Reveal URLs revela e sinaliza; não verifica. Não segue redirecionamentos: uma ligação que passa por um rastreador ou redirecionador é mostrada como o URL do redirecionador que realmente indica; o Reveal URLs não pode saber onde esse redirecionamento acaba por terminar. Numa ligação sem aviso, não foi detetada qualquer discrepância aplicável, mas isso não confirma que seja segura; por isso, leia o URL revelado antes de confiar numa ligação, mesmo quando nada está sinalizado. Para se lembrar disso, o URL revelado de uma ligação não sinalizada é mostrado numa cor âmbar «a rever» em vez de um verde tranquilizador.

Uma mensagem do Gmail com o Reveal URLs ativo: uma ligação enganosa é assinalada a vermelho com o URL de rastreio para onde aponta revelado acima do texto da ligação, enquanto o URL de uma ligação sem discrepâncias é revelado sem aviso.

Nota: os endereços de e-mail, os URL e os nomes nesta captura de ecrã foram mascarados com asteriscos por privacidade.

Na extensão de navegador e no add-on do Thunderbird, tudo acontece no seu próprio dispositivo, sem transmitir nada. Em todas as formas, o Reveal URLs não envia nenhum dos seus dados de e-mail para nós nem para terceiros — não há analytics nem rastreio. (As formas diferem no sítio onde são executadas e em como o código do painel do Outlook é servido; consulte a secção Privacidade e a política de privacidade para todos os detalhes.)

O Reveal URLs é executado em:

Navegadores web:

Aplicações de correio:

Nos alvos de navegador, o Reveal URLs anota as ligações no seu webmail. No Thunderbird anota as ligações no e-mail que está a ler diretamente no cliente de e-mail.

Instalação

A partir da loja do seu navegador ou cliente de e-mail (recomendado)

Instale o Reveal URLs a partir da loja do seu navegador ou cliente de e-mail. Todas as listagens estão agora disponíveis; o Opera executa a versão do Chrome.

Navegadores web:

Aplicações de correio:

Carregar você mesmo uma compilação (programadores e testes iniciais)

Se compilou o Reveal URLs a partir do código-fonte, pode carregar a compilação descompactada diretamente. Cada alvo é compilado com um comando make e produzido em dist/<target>/:

make build-chrome        # gera dist/chrome
make build-edge          # gera dist/edge
make build-firefox       # gera dist/firefox
make build-gmail         # gera dist/gmail
make build-opera         # gera dist/opera
make build-outlook       # gera dist/outlook
make build-safari        # gera dist/safari
make build-thunderbird   # gera dist/thunderbird

Depois, carregue a pasta resultante:

A extensão do Safari, o suplemento do Outlook e o suplemento do Gmail não são carregados como extensões de navegador descompactadas. Compile-os como acima e, depois:

make deploy-gmail        # implementa o suplemento do Gmail no Apps Script
make safari-xcode        # compila o projeto Xcode do Safari e depois execute-o
                         # a partir do menu Develop do Safari (macOS)
                         # Outlook: carregue dist/outlook lateralmente

A página de definições abre automaticamente na primeira vez que a extensão é instalada.

Utilização

De origem, o Reveal URLs anota as ligações nas mensagens dos fornecedores incorporados — sem necessidade de configuração:

A anotação é limitada ao corpo da mensagem, pelo que a interface própria da aplicação — a sua barra lateral, janela de composição e barras de ferramentas — fica intacta. No Thunderbird, todo o e-mail renderizado é abrangido.

O Reveal URLs a anotar uma mensagem do Gmail: o URL de cada ligação é mostrado na sua própria linha acima do texto da ligação, com uma ligação de rastreio não correspondente assinalada a vermelho e uma ligação sem discrepâncias revelada sem aviso.

Nota: os endereços de e-mail, os URL e os nomes nesta captura de ecrã foram mascarados com asteriscos por privacidade.

Como é mostrado o URL real

O URL real de cada ligação é mostrado na sua própria linha, logo acima do texto da ligação. Também é colocado na dica de ferramenta (título) da ligação, para que o URL completo esteja sempre disponível quando passa o rato sobre a ligação.

Realce de não correspondências

Para ligações web, o Reveal URLs compara um URL ou nome de anfitrião no texto visível de uma ligação com o URL para onde aponta. A comparação é feita no domínio registável, pelo que um subdomínio sem discrepâncias como mail.example.com para example.com não é assinalado, enquanto um semelhante como paypa1.com para paypal.com é. A extensão de navegador e o Thunderbird também verificam ligações de e-mail, telefónicas e opacas; as ligações javascript:, data: e vbscript: são sempre assinaladas.

A verificação considera apenas o URL que a própria ligação indica; os redirecionamentos nunca são seguidos, pelo que uma ligação por um rastreador ou redirecionador é comparada como o respetivo URL, não como a página que acaba por alcançar.

Uma não correspondência é mostrada na cor de não correspondência que escolheu e a negrito.

Duas definições relacionadas controlam isto:

A página de definições: o seletor de modo 'Revelar o URL', o interruptor 'Realçar ligações não correspondentes' e os campos de cor de não correspondência e cor sem discrepâncias.

O botão da barra de ferramentas

No Chrome, Edge, Opera, Firefox e Thunderbird, o ícone do Reveal URLs na barra de ferramentas é um interruptor rápido de ligar/desligar — clique nele para alternar a anotação. Quando a extensão está desligada, aparece um emblema OFF no ícone, e a respetiva dica informa se o clique a ligará ou desligará. Nos navegadores, a alteração produz efeito em todos os separadores abertos ao mesmo tempo; no Thunderbird, aplica-se à próxima mensagem que abrir.

Enquanto o Reveal URLs está ativado, o ícone da barra de ferramentas do navegador também lhe indica, por separador, o que encontrou na página atual. Se a página tiver ligações não correspondentes (semelhantes), o ícone mostra essa contagem num crachá vermelho; se a página tiver ligações mas nenhuma for discordante, mostra o número total de ligações analisadas num crachá cinzento; uma página sem ligações analisáveis (e qualquer página sobre a qual a extensão não atua) não mostra qualquer contagem. Cada separador mantém o seu próprio crachá, pelo que mudar de separador atualiza o número, e sair da página ou fechar o separador limpa-o. (Contagens acima de 99 são mostradas como 99+.)

O crachá nos seus estados (o navegador desenha-o, pelo que a colocação exata varia um pouco consoante o navegador): uma contagem vermelha de discordâncias, uma contagem cinzenta de ligações analisadas e o crachá OFF enquanto a extensão está desativada; o respetivo logótipo fica também em cinzento-claro esbatido. Numa página onde a extensão ativada não está ativa, não há crachá; a ausência do crachá OFF distingue esse mesmo logótipo esbatido do estado desativado.

Estas ilustrações não mostram todos os casos sem crachá; uma página ativa sem ligações analisáveis mantém o ícone de cor normal.

Ícone da barra de ferramentas a mostrar um crachá vermelho com o número de ligações discordantes na página atual Ícone da barra de ferramentas a mostrar um crachá cinzento com o número de ligações analisadas na página atual Ícone da barra de ferramentas com um logótipo cinzento-claro atenuado sem crachá enquanto a extensão ativada não está ativa nesta página Ícone da barra de ferramentas a mostrar o crachá vermelho OFF enquanto a extensão está desativada

(No Thunderbird, o botão mostra apenas o seu ícone, pelo que se mantém compacto na barra de ferramentas unificada. Também pode ligar e desligar o Reveal URLs com o interruptor Ativar na página de definições.)

A página de definições

A página de definições contém todas as opções. Abra-a a partir da página de extensões do seu navegador (por exemplo Detalhes → Opções da extensão), ou abre-se automaticamente na primeira instalação.

Além do interruptor principal Ativar e dos controlos de Sites ativos (que se aplicam de imediato), as alterações são guardadas com o botão Guardar definições.

As definições inferiores: a lista 'Ignorar estes anfitriões', o comprimento máximo do URL apresentado e os campos opcionais de tamanho e espessura de letra do URL revelado, acima do botão 'Guardar definições'.

Sites ativos — adicionar o seu próprio webmail

A secção Sites ativos, no topo da página de definições, lista as páginas onde o Reveal URLs é executado. Agora mantém uma altura fixa: escolha um site na lista pendente e edite apenas as definições desse site no painel abaixo.

O topo da página de definições: o interruptor principal 'Enable Reveal URLs' e a secção 'Active sites', com uma lista pendente 'Active site' acima de um único editor do site selecionado que mostra o match pattern, um interruptor 'Enabled', um interruptor 'Sub-frames' e o seu message-body selector.

A lista pendente mostra uma entrada por cada regra de site:

O editor do site selecionado mostra:

Os fornecedores incorporados (FastMail, Gmail, Outlook Live, Outlook 365, Proton, Tuta, Yahoo e Zoho) podem ser desativados e redirecionados, mas não podem ser removidos. Os seus nomes também podem ser renomeados aqui; limpar o nome de um fornecedor incorporado repõe o seu nome amigável predefinido.

Para adicionar o seu próprio site de webmail:

  1. Em Adicionar site, introduza um URL de correspondência — um padrão de correspondência como https://mail.example.com/*.
  2. Introduza opcionalmente um Name para a lista pendente. Deixe-o em branco para recorrer ao match URL.
  3. Introduza um Message-body selector — um seletor CSS para o contentor que contém o corpo da mensagem, por exemplo .message-body.
  4. Se o corpo da mensagem for renderizado dentro de um subframe, marque Also run inside sub-frames.
  5. Clique em Add site. O seu navegador irá pedir permissão para aceder a esse site; conceda-a. O site só é adicionado depois de conceder a permissão.

As alterações aqui aplicam-se imediatamente. Remover um site que adicionou também revoga a respetiva permissão, pelo que o Reveal URLs deixa de aceder a ele. Para alterar o match URL de um site, remova-o e adicione-o de novo: o match permanece só de leitura porque é a identidade da regra.

Thunderbird (e outros clientes de e-mail). O Thunderbird já mostra todas as mensagens que lê, seja qual for o fornecedor, pelo que não precisa de uma lista por anfitrião. A secção Sites ativos não é, portanto, mostrada na página de definições do Thunderbird — apenas aparecem o interruptor principal, o idioma de apresentação, as cores, os tipos de letra e a lista de ignorados. Qualquer configuração de sites ativos que possa ter definido num navegador é preservada intacta: guardar as definições do Thunderbird nunca a limpa.

Os extras do Outlook e do Gmail

Além da extensão de navegador e do add-on do Thunderbird, o Reveal URLs está disponível como um extra nativo para duas aplicações de correio que uma extensão de navegador não consegue alcançar: um suplemento do Outlook e um extra do Gmail. Partilham a deteção de URL/anfitrião http/https da extensão de navegador, mas não analisam os seus esquemas de ligação adicionais.

A única diferença é como mostram as suas conclusões. A extensão de navegador anota as ligações no lugar — colorindo o URL acima ou ao lado de cada ligação. Os frameworks do Outlook e do Gmail não permitem que um extra altere a mensagem renderizada, pelo que em vez disso cada extra mostra um painel lateral (Outlook) ou cartão (Gmail) que lista as ligações que encontrou. Para cada ligação http/https mostra o texto visível e o URL e assinala uma não correspondência apenas quando o texto visível indica um URL ou nome de anfitrião cujo domínio registável não corresponde ao do destino da ligação.

O extra do Gmail está agora disponível no Google Workspace Marketplace.

Idiomas

O Reveal URLs está disponível em inglês e em muitos outros idiomas.

O texto não inglês é traduzido automaticamente e está em espera de revisão humana, pelo que uma frase pode ocasionalmente ler-se de forma estranha; o significado pretende-se igual ao original inglês. Se detetar uma tradução incorreta, comunique um problema no rastreador de problemas do Codeberg.

Privacidade

O Reveal URLs não envia nenhum dos seus dados de e-mail ou de mensagem para nós nem para terceiros, em nenhuma das suas formas — não há analytics nem rastreio. Como e onde o trabalho acontece depende da forma:

A única coisa armazenada são as suas próprias definições (como ativado/desativado, modo de revelação, cores, tamanhos de letra, a sua lista de ignorados e quaisquer sites que tenha adicionado), guardadas no armazenamento por utilizador do seu navegador, do Outlook ou da Google, e nunca enviadas para nós.

Consulte a política de privacidade para todos os detalhes.

Resolução de problemas

Uma ligação não está a ser revelada.

Um fornecedor incorporado deixou de funcionar após um redesenho.

Os fornecedores de webmail alteram a marcação das suas páginas de vez em quando. Se o seletor de um fornecedor incorporado já não corresponder após tal alteração, pode corrigi-lo você mesmo: em Sites ativos, edite o seletor do corpo da mensagem desse fornecedor para o novo contentor.

Licença e código-fonte

O Reveal URLs é software livre, licenciado sob a GNU Affero General Public License v3.0 (AGPL-3.0-only).

Notas do Safari

O Safari mostra um emblema apenas quando as ligações não correspondem; não tem um contador cinzento de página segura. Reabra as definições no menu de clique direito Reveal URLs — settings, em vez de recarregar um separador antigo.