O Botão de reporte de phishing para Outlook On-Premise permite que os usuários reportem e-mails suspeitos diretamente do Outlook em ambientes corporativos que não utilizam Exchange Online nem Azure AD.
Quando um usuário reporta um e-mail, o sistema envia a informação para a Whalemate para análise ou a reencaminha para o e-mail configurado pela organização.
Permitir que os usuários reportem e-mails suspeitos diretamente do Outlook.
Centralizar os reportes de phishing dentro do programa de conscientização.
Facilitar a análise de incidentes pela equipe de segurança.
Integrar o reporte de phishing com ferramentas internas como SOC ou SIEM.
Medir o comportamento de reporte em campanhas de phishing.
O design do complemento se baseia em uma arquitetura simples cliente–servidor, sem dependências de serviços cloud da Microsoft.
Componentes principais
Outlook Add-in (Cliente)
Backend Whalemate (Servidor)
Não existem componentes intermediários nem serviços de terceiros.
Tipo: Office Add-in (MailApp)
UI: Task Pane
Tecnologia: Office.js
Execução: Cliente Outlook (On-Premise)
O add-in é acionado por uma ação manual do usuário ("Report Phishing") sobre um e-mail selecionado.
O complemento pode acessar apenas a informação exposta por Office.context.mailbox.item, incluindo:
Endereço de e-mail do remetente
Domínio do remetente
Endereço de e-mail do usuário que reporta
Data e hora do reporte
Data e hora de envio do e-mail suspeito
Corpo do e-mail (HTML e texto simples)
Links contidos no corpo do e-mail
Devido ao contexto On-Premise:
❌ Não há acesso aos headers completos do e-mail
❌ Não há acesso a anexos em binário
❌ Não há Microsoft Graph
❌ Não há Azure AD / MSAL
❌ Não são gerados tokens JWT de identidade forte
Essas restrições impedem, por exemplo, correlacionar o reporte com campanhas anteriores baseadas em headers personalizados.
Endpoint de recepção
POST https://back.whalemate.com/api/public/reported-email-microsoft-webhook
Responsabilidades do backend
Ao receber um reporte, o backend:
Registra o evento de reporte.
Armazena as informações do e-mail reportado.
Exibe o reporte na interface SIEM da Whalemate.
Reencaminha as informações para os e-mails configurados pela organização, se assim for necessário.
Fluxo lógico do reporte:
O usuário seleciona um e-mail suspeito no Outlook.
Pressiona o botão Report Phishing.
O add-in:
Obtém o item selecionado.
Extrai metadados e conteúdo permitido.
Envia o payload para o backend da Whalemate via HTTPS.
O backend processa e registra o reporte.
O usuário recebe feedback visual de sucesso ou erro.
[Usuário]
|
v
[Outlook On-Prem]
|
| Office Add-in (Office.js)
v
[Botão Report Phishing]
|
| HTTPS POST
v
[Backend Whalemate]
|
+--> SOC / UI
+--> Reencaminhamento para os e-mails configurados
Plataforma / Cliente
Add-in On-Premise
Add-in com MSAL (M365)
Outlook Windows 2010 ou anterior
❌ Não compatível
❌ Não compatível
Outlook 2013 (SP1)
✅ Compatível
❌ Não compatível
Outlook 2016
✅ Compatível
✅ Compatível
Outlook 2019
✅ Compatível
✅ Compatível
Outlook 2021
✅ Compatível
✅ Compatível
Outlook Microsoft 365 (Windows)
✅ Compatível
✅ Compatível
Outlook na Web (OWA)
✅ Compatível
✅ Compatível
Outlook Mac (Office 2016+)
❌ Não compatível
✅ Compatível
Windows Mail / Correio Windows 10–11
❌ Não compatível
❌ Não compatível
Apple Mail / Clientes POP–IMAP genéricos
❌ Não compatível
❌ Não compatível
Requisitos do cliente
Outlook com suporte a Office Add-ins (Office.js)
Permitir a instalação de add-ins personalizados
Conectividade HTTPS de saída para o backend da Whalemate
Requisitos do backend
Endpoint HTTPS acessível publicamente
Suporte para recepção de payloads JSON
Armazenamento seguro das informações reportadas
O add-in não executa código nativo no cliente.
Não persiste informações localmente.
A comunicação é realizada exclusivamente por HTTPS.
Não são utilizadas credenciais Microsoft nem tokens de autenticação.
O acesso aos dados está limitado ao e-mail selecionado pelo usuário.
‼️Este complemento foi projetado especificamente para ambientes On-Premise, priorizando simplicidade, compatibilidade e segurança, dentro das limitações técnicas impostas pelo modelo de extensibilidade do Outlook nesses ambientes.
Na implementação Outlook On-Premise, o reporte inclui os seguintes dados do e-mail:
Endereço de e-mail do remetente
Domínio do remetente
Endereço de e-mail do usuário que reporta
Data e hora do reporte
Data e hora de envio do e-mail suspeito
Corpo do e-mail (HTML e raw)
Links presentes no e-mail
Devido às limitações do ambiente on-premise, não são incluídos headers completos nem anexos, já que essas APIs não estão disponíveis sem o Microsoft Graph.
Não necessariamente. Na versão On-Premise, o add-in não tem acesso aos headers do e-mail.
Isso impede identificar o campaign_id que a Whalemate insere no header X-Mailgun-Tag, que é o mecanismo utilizado para vincular um reporte a uma campanha específica.
Por esse motivo:
O evento de reporte do usuário pode ser registrado corretamente.
Mas não sempre pode ser associado automaticamente a uma campanha, portanto pode não aparecer como "Reportado" nas analíticas dessa campanha.
Essa é uma limitação própria do modo On-Premise sem Microsoft Graph.
Não. Na implementação On-Premise, o add-in não tem acesso ao Microsoft Graph nem às APIs do Exchange, portanto não pode executar ações sobre a caixa de correio do usuário, como:
excluir e-mails
mover e-mails para spam
aplicar ações remotas sobre a mensagem
Por essa razão, a exclusão física do e-mail a partir do SIEM não está disponível na versão On-Premise.
Essa funcionalidade requer integração com Microsoft Graph ou Exchange Online.