Security & Trust

Report Phishing (Outlook add-in)

A one-click "Report Phishing" button in Outlook that sends a suspicious email straight to Versus Security Operations — turning every employee into a sensor. No message bodies are stored, and reporting a phishing simulation is always the right answer.

The Report Phishing button puts your whole workforce on the detection team. When someone spots a suspicious email, one click in Outlook sends it to Versus Security Operations — where it becomes a user report and an email detection, groups into the sender's case, and lights the people domain of your risk score. It is the human half of email security: the native control (Microsoft Defender for Office 365 or Google) catches what it can automatically; the button captures what a person noticed that the filter missed.

It is a lightweight Office Add-in served straight from Versus, so the task pane and the reporting API share one origin — there is nothing to host and no CORS to configure.

What a user sees

  1. A Report Phishing button appears on the ribbon when reading a message (Outlook desktop, web, and mobile).
  2. Clicking it opens a small Versus task pane showing the message's subject and sender, with an optional "why does this look like phishing?" note.
  3. The user clicks Report as phishing and gets back "Reported to Security Operations. Thank you."

That is the entire experience — no forwarding to a mailbox, no copy-pasting headers.

What Security Operations receives

Each report posts to Versus and creates:

  • a user report (reporter, subject, sender, any URLs the add-in saw, and the optional note), visible under Security Operations → Email → User reports; and
  • an email detection on the reported sender, which groups into that subject's case and raises the people domain of the risk score.

From there it follows the normal Aegis path: the case can escalate to the Desk, where AutoPilot investigates it, and the governed email responses (quarantine the message, block the sender) are available on the case.

Privacy by design. The add-in needs only read access to the open message, and Versus stores metadata only — subject, sender, URLs, the reporter, and the note. Message bodies are never sent to or stored by Versus. The add-in carries a per-tenant, low-privilege report token whose only permission is to post a report; it cannot read anything from Versus.

Works with phishing simulation

If you run phishing simulations, the Report Phishing button is how employees pass the test. A user who clicks a simulated lure and does not report it becomes a human-domain finding; a user who reports it — real or simulated — is the good outcome and is never penalised. The button and the simulation are two halves of the same awareness-training loop: measure who clicks, reward who reports.

Deploying the button

The task pane and manifest are served from your Versus instance. First, grab the report token, then push the add-in to users.

1. Get the report token

In Versus go to Security Operations → Email → "Report Phishing button — setup". Copy the manifest URL and the report token shown there. The token is per-tenant; you can rotate it from the same panel at any time (users re-enter it on next use).

2. Push the add-in to users

Choose one:

Tenant-wide (recommended) — Microsoft 365 admin center

  1. Open admin.microsoft.com → Settings → Integrated apps → Upload custom apps.
  2. Choose Provide link to manifest file and paste the manifest URL from step 1 (https://<your-versus-host>/api/aegis/email/addin/manifest.xml).
  3. Assign it to everyone (or a pilot group) and finish. The button appears for users within a few hours.

Per-user sideload (for a quick pilot)

In Outlook: Get Add-ins → My add-ins → Add a custom add-in → Add from URL, paste the manifest URL, and confirm.

3. Share the token once

The first time a user opens the task pane it asks for the report token (one-time, saved in Outlook's roaming settings so it follows them across devices). Send your users the token from step 1, or pre-seed it. After that, reporting is a single click.

How it fits together

PieceEndpoint (served by Versus)Purpose
Manifest/api/aegis/email/addin/manifest.xmlSideload this in Outlook / the M365 admin center
Task pane/api/aegis/email/addin/taskpane.htmlSaves the token, shows the message, reports
ReportPOST /api/aegis/email/addin/reportCreates the user report + email detection (metadata only)

Because everything is served from Versus, there is no separate add-in infrastructure to run, and the button always points at your own tenant's Security Operations.

Troubleshooting

  • No button in Outlook — centrally deployed add-ins can take a few hours to appear; confirm the assignment in Integrated apps, and that Outlook is signed in to the assigned account.
  • "Enter the report token" keeps appearing — the token was not saved (private/guest Outlook sessions do not persist roaming settings) or it was rotated in Versus. Re-paste the current token from the setup panel.
  • Report fails — confirm the manifest URL host matches your live Versus host and that the token has not been rotated. The task pane shows the error returned by Versus.
  • Reports not visible — they appear under Security Operations → Email → User reports for the tenant the token belongs to.