Skip to main content

Allow Phishing Simulations via Email Headers in Google Workspace

Header-based whitelisting

Updated over a month ago

To ensure Arsen phishing simulations land directly in employees’ inboxes, you must authorize their delivery using a rule based on a specific header in Google Workspace.


1 – Objectives

  • Ensure simulation emails are delivered directly to the inbox

  • Identify Arsen emails using a dedicated header

  • Use a method suited to organizations with an upstream security filter

  • Verify that simulations are correctly received after configuration


2 – Prerequisites

  • Have administrator access to Google Workspace / Google Apps

  • Have already allowed Arsen IPs in your upstream filter (if applicable)


3 – Access Gmail compliance settings

To begin:

Google Admin Console overview showing the main admin categories: Users, Groups, Apps, Security, and Billing.
  • Click Apps

Google Admin Console with the “Apps” section highlighted, used to manage mobile and web application settings and access.
  • Select Google Workspace

Google Admin interface showing application families, with the “Google Workspace” tile selected among the core services.
  • Click Gmail

Google Admin list of Google Workspace services with “Gmail” highlighted and shown as enabled for all users.
  • Scroll down to the Compliance section


4 – Add a Gmail compliance rule

4.1 – Create a new rule

  • Go to Content compliance

  • Click Configure or Add another rule

Gmail settings page in Google Admin highlighting the “Content compliance” option with the Configure button.
  • Enter a clear name, for example: Arsen – Phishing simulation allow rule

  • Select email types: Inbound and Internal – Receiving

Content compliance rule form with “Inbound” and “Internal – receiving” selected as the email types.

4.2 – Add the Arsen header condition

  • Under Add expressions…, select If ANY of the following match the message

  • Click Add

Content expression configuration section showing the match mode and the “Add” button.
  • Choose Advanced content match

  • In Location, select Full headers

  • In Match type, choose Contains text

  • In Content, enter your unique Arsen header (specific to your account)

📚 Note
To find your header in Arsen:

  • Go to Settings in Arsen

  • Click the Campaigns Settings tab

  • Click the Phishing Simulation Whitelisting link and copy the header value

  • Click Save

Gmail advanced content match form configured to search for a specific text value inside full message headers, with an example “X-Arsen-…” header.

4.3 – Define the behavior when the header matches

  • In If the above expressions match, do the following:

    • Keep Modify message

    • Check Bypass spam filter for this message

  • Click Save

Gmail compliance rule action settings showing the “Bypass spam filter for this message” checkbox enabled.


5 – Test phishing simulation delivery

Changes can take up to one hour to propagate.

To validate the configuration:

  • Launch a test campaign to a small set of controlled addresses

  • Confirm that Arsen simulations are delivered to the inbox (not spam)

  • Run this test at least one hour after configuration to ensure the rule is active



Did this answer your question?