Skip to main content
xorlab Security Platform allows users to report suspicious messages, which are then checked and resolved by admins or automatically. This feature works out of the box—a user simply sends the email in question as an .eml attachment to the default suspicious@<templateDomain> address, where the templateDomain property (not a variable) is configured in the activeguard/core/active_guard.yml file (see step #7 in Basic settings).
This reporting address can be changed to any address of your choice—please see Reporting address.
After a user reports a suspicious message, an automatic reply is sent back to the user acknowledging the receipt of the email. Another notification is sent when the case is resolved. You can disable this automatic mailing for acknowledgment emails and/or particular verdicts. In the latter case, you can also decide how the reported messages will be automatically handled and which notification template will be used for a given verdict. Moreover, you can customize how these notifications look—please see Customizing notification templates.

Configuring the Report Message button

Before you start configuring the Report Message button in any app, you have to check the following settings in the activeguard/core/active_guard.yml file which affect feedback from xorlab Security Platform:
  • no_auto_feedback.properties—make sure it is not active (more details in Profiles)
  • authorizedEmailReportRecipients under emailReporting—it lists all domains that are allowed to receive notifications regarding reported emails (a reporter using an email address not listed here will not receive any feedback from XSP).

Microsoft 365

In order to use the MS Outlook Report Message button with reporting service in xorlab Security Platform, you need to perform three actions: set up an Exchange Online mailbox for reported emails, opt for sending the reported messages there, and finally create a rule that redirects emails sent to this mailbox to a reporting account in XSP.
  1. Add an Exchange Online mailbox for reported emails, if you don’t have it already. For example, name it Reporting and assign the address of reporting@example.com.
  2. Go to the Microsoft 365 Defender portal and in the left pane scroll all the way down to select Settings. Click Email & collaboration, then User reported settings. Or you can go directly to the User submissions page.
  3. On the User reported settings page, make sure that the first switch is on. Depending on your preferences, select an Outlook report button configuration (you can leave the first default option selected), scroll down to the Reported message destinations section, and from the drop-down list under Send reported messages to: select the second option My reporting mailbox only. Then, in the input box under Add an exchange online mailbox to send reported messages to: enter your reporting mailbox address you have just set in step #1: Email address for reported messages Assigning a mailbox for user reported messages
  4. Click Save.
  5. Follow the steps described in the Mail flow rule section and create a new rule, e.g., MSReportingButtonIntegration, on the Rules page using these settings for rule conditions:
    • Apply this rule ifThe recipientis this person and select your Exchange Online reporting mailbox from the list, e.g., Reporting you created in step #1.
    • Do the followingRedirect the message to → enter the xorlab Security Platform reporting mailbox address, e.g., suspicious@mx.xyz.activeguard.cloud, where xyz is your customer ID for your XSP instances.
    Reporting rule conditions Rule conditions for redirecting reported messages
  6. Click Next twice, review the settings for your rule on the last page and if they are OK, click Finish, then Done when the transport rule is created. Remember to enable this rule on the Rules page.
After you successfully integrate the reporting feature in M365, it should work like presented below:
For more information, please refer to the Microsoft documentation.

Other apps

The reporting feature in xorlab Security Platform can be integrated with a reporting button in practically all email solutions. All you have to do is to assign an action to this button that would forward the suspicious email as an .eml attachment to the reporting email address you configured.