Reporting Plugin

Introduction

Mail reporting plugins (AKA "phishing buttons") enhance email security by allowing users to report phishing attempts directly from their email clients. They streamline the process, making it easier for organizations to identify and respond to potential threats.

---

Supported clients

• Office 365 (Desktop, Web, Mobile)

• Outlook 2016, 2019

• Outlook for Mac (2016, 2019)

• Gmail

Prerequisites

A connected Azure application. See here for details.

This application must then be selected in the plugin settings.

Client Profiles

Starting in Lucy version 4.13 you can save plugin configurations on a per-client basis (one profile per client). When you are ready to download the plugin you will be prompted to select a client, and the plugin will use that client's settings profile.

Plugin Settings

Before we can begin using the plugin we must configure it. To configure, navigate to Settings > Submitted Email Settings > Plugin Settings and create a new configuration. See this platform reference page for details on the configuration options.

Remember to select your Azure application in the Plugin settings at the bottom!

---

Download the plugin

You must configure your plugin settings before downloading and deploying.

To download the plugin navigate to the Incidents Dashboard and select Download Plugin, then select the appropriate option for your mail client.

• User/Machine Wide: MSI installer for Outlook Native

• Classic Microsoft Outlook 365: XML file for O365 using REST API

• Microsoft Outlook 365: XML file for O365 using Microsoft's Graph API

• Gmail Addon: App script for Gmail clients.

Deprecation notice for REST API plugin

Microsoft has ended support for REST-based plugins, please use the Graph API version.

In Lucy version 5.4 and above the download options have been updated to reflect this change:

---

Deployment

LUCY's reporting plugin is compatible with Microsoft O365, Outlook Native, and Gmail. The deployment is a little different for each version, so be sure to use the guide for your mail client.

Microsoft Office 365 (XML)

Outlook Native (MSI)

Gmail (apps script)