Skip to main content
Enhance your email security with Contextual Banners—contact support@xorlab.com to add them to your subscription or to enable them.
The script packages and individual scripts linked on this page are protected downloads and require a password.

​
Why Contextual Banners Matter

Contextual Banners provide users with targeted security insights based on xorlab’s analysis, appearing at the top of the email body. They highlight risks such as low sender trust, potential partner impersonation, or suspicious attachments. Unlike generic warnings, these banners are selectively applied to reduce alert fatigue, ensuring that users remain attentive to truly relevant threats. Examples of different types of banners, categorized by severity:
  • Alert (Red) banners: Critical warnings for high-risk messages.\ Alert banner
  • Warning (Orange) banners: Moderate risks that require user attention. Warning banner
  • Information (Blue) banners: General insights without immediate action required. Info banner

​
How It Works

Contextual Banners highlight security risks based on matched detection rules:
  1. XSP adds an x-xor-banner header to flagged emails.
  2. The header includes a banner identifier.
  3. Exchange mail flow rules detect the identifier.
  4. If a match is found, the banner is added to the email body.
  5. Emails with a x-xor-banner header appear in XSP with the #banner tag.

​
Configuration in XSP

Optional FeatureThe Contextual Banners feature is optional and the configuration options are disabled by default. To enable this feature, please contact support@xorlab.com to add it to your subscription.
  1. Log in to the xorlab Security Platform.
  2. Click the Admin icon in the right menu.
  3. In the Admin Panel, click General Settings. Selecting General Settings
  4. Select Contextual Banners.
  5. Enable the Alert, Warning and Info banners. Enabling Contextual Banners

​
Configuration in Exchange Online

Before proceeding, ensure you are connected to Exchange Online via PowerShell. If you need guidance, refer to Microsoft’s official documentation.
  1. Download the xorlab contextual banner EXO script package to download all scripts to manage the banner mail flow rules.
  2. Run the Script xorlabExoAddBanners in the respective language in Dry-Run Mode:
    • Open a Cloud Shell in M365.
    • Navigate to the folder containing the PowerShell script or upload them using “Manage Files”.
    • Run the following command:
    You can also run the respective version for TestRecipients to only enable the rules for few selected recipients.
    If you lack admin privileges or are not allowed to install scripts, first run:
    Enter Y to confirm any prompts e.g., installing the NuGet module and trusting the PSGallery repository.
  3. After running the script, you should see the following message:
    • A Microsoft sign-in window will appear.
    • Log in with your Exchange administrator credentials.
    • Once connected, you should see the following output in the terminal:
  4. Press Enter and review the console output. You should see messages like this:
  5. Once the dry-run successfully simulates all 40+ rules, rerun the script without -DryRun to apply the changes.
The actual rule creation process can take several minutes. Once complete, go to the Transport rules page in the Exchange admin panel. You should see multiple rules with the prefix XorBanner:\ Banner rules in M365

​
Managing Banner Rules with PowerShell

You can manage banner transport rules in Exchange Online using the following PowerShell scripts. These scripts allow you to enable, disable, reset, or remove rules as needed.

​
Restore Banner Rules

You can restore all existing banner transport rules in Exchange Online using the xorlabExoAddBanners_DE.ps1 script and the -OverwriteRules switch:

​
Remove Banner Rules

You can remove all existing banner transport rules in Exchange Online using the xorlabExoRemoveBanners.ps1 script.

​
Enabling or Disabling Banner Rules

If you need to temporarily disable banner rules for testing or troubleshooting, you can disable them with the xorlabEnableRules.ps1 script and the -DisableRules switch:
Later, you can re-enable these rules using the xorlabEnableRules.ps1 script and the -EnableRules switch:

​
Allowing xorlab Banners in Microsoft Defender

If you are using Microsoft Defender, we recommend reviewing your Safe Links configuration to ensure that contextual banners render correctly. In some cases, Safe Links policies may rewrite or block banner content. To prevent this, add xorlab.com to the list of trusted URLs in your Safe Links policies (Policies & rules > Threat policies > Safe Links). This ensures that banners are displayed as intended and users receive the full security context

​
Configuration in On-Premise Exchange

​
Setup

  1. Download the xorlab contextual banner On-Prem script package to download all scripts to manage the banner mail flow rules and place them on your Exchange Server.
  2. Open “Exchange Management Shell” as administrator and go to the Download directory.

​
Installing Banners

  1. Run the script with the -DryRun command. (replace the email address below for that of the recipient)
  1. Rerun the script without the -DryRun command.
  2. Check in the Exchange Admin Center if mailflow rules were successfully added.

​
Removing Banners

Execute the script:

​
Excluding Specific Senders or Recipients

To prevent banners from appearing on specific emails, use the Contextual Banners Exclusion Lists in XSP:
  • Contextual banners recipient address exclusion: Prevents banners from appearing on emails sent to specific internal addresses.
  • Contextual banners sender address exclusion: Prevents banners from appearing on emails from specific external senders.
To configure these lists:
  1. Go to the admin panel in XSP.
  2. Click on the Lists tile.
  3. Search for “banners”.
  4. Add the email address.

​
Disabling Individual Banners

You can disable one or more banners using either of the following methods:
  • In Exchange: Disable the mail flow rule associated with the unwanted banner. You can find the rule using the banner identifier listed in the banners list.
  • In XSP: Go to General Settings > Contextual Banners and disable all banners of a specific severity (e.g., Alert, Warning, or Info).
Each banner has a unique identifier, which starts with the prefix BANNER_(Category)_(Name) (e.g., BANNER_verdict_phishing). Use that identifier to find the associated mail flow rule in Exchange when you want to disable an individual banner.
The full list of banner names, categories, severity levels and descriptions is documented in Detection Defaults → Banner categories and identifiers. Password required.