Skip to main content
ContraForce provides customizable email notifications for Microsoft Sentinel incidents, allowing you to configure alerts by severity level for each workspace. Keep your team informed about critical security events while filtering out noise.
Module Requirement: Full notification customization is available with the XDR + SIEM module. The XDR-only module has limited notification capabilities (Gamebook notifications only).

Notification Capabilities by Module

FeatureXDR ModuleXDR + SIEM Module
Sentinel incident notifications
Severity-based filtering
Per-workspace customization
Gamebook completion notifications
Distribution group support
XDR Module Users: ContraForce does not generate email notifications for Defender XDR incidents. Use Microsoft Defender’s built-in notification settings for Defender alerts. Deploying ContraForce will not interrupt your existing Defender notification configuration.

SIEM Notification Overview

With the XDR + SIEM module, you can:

Filter by Severity

Choose which incident severities trigger notifications—High, Medium, Low, or Informational

Configure Per Workspace

Set different notification preferences for each customer workspace

Use Distribution Groups

Route notifications to shared mailboxes or team distribution lists

Direct Portal Access

One-click access to incidents directly from notification emails

Configuring Notification Settings

Accessing Settings

1

Open Settings

Click Settings in the ContraForce navigation menu
2

Select Notifications

Click the Notifications tab
3

Choose Workspace

Select the workspace you want to configure from the dropdown
Direct link: portal.contraforce.com/settings/notifications

Notification Settings Interface

ContraForce notification settings interface
The notification settings interface displays:
ElementDescription
Workspace SelectorChoose which workspace to configure
Severity TogglesEnable/disable notifications per severity level
Recipient DisplayShows current notification recipients
Save ButtonApply changes to the selected workspace

Severity-Based Filtering

Customize which severity levels generate email notifications for each workspace.

Default Behavior

By default, notifications are enabled for all severity levels when a workspace is onboarded:
  • ✅ High severity — Enabled
  • ✅ Medium severity — Enabled
  • ✅ Low severity — Enabled
  • ✅ Informational — Enabled

Configuring Severities

1

Select Workspace

Choose the workspace from the dropdown
2

Toggle Severities

Click the toggle for each severity level to enable or disable
3

Save Changes

Click Save to apply your changes
Severity toggle settings

Severity Level Guidance

High severity incidents indicate active threats requiring immediate response.Examples:
  • Active malware execution
  • Credential theft detected
  • Ransomware activity
  • Privilege escalation attacks
Recommendation: Always keep enabled for all workspaces

Per-Workspace Configuration

MSSPs managing multiple customers can configure different notification settings for each workspace.

Use Cases

ScenarioConfiguration
Premium SLA customerAll severities enabled
Standard SLA customerHigh and Medium only
Development/test workspaceHigh only or disabled
Compliance-focused customerAll severities including Informational

Configuring Multiple Workspaces

1

Configure First Workspace

Select workspace, set severity preferences, save
2

Switch Workspace

Use the dropdown to select the next workspace
3

Configure Settings

Adjust severity settings for this workspace
4

Repeat

Continue for all workspaces requiring custom settings
Document your notification configuration for each customer. This helps maintain consistency and simplifies troubleshooting when customers report notification issues.

Email Notification Details

Sender Address

All ContraForce notifications are sent from:
Add this address to your email allowlist and your customers’ allowlists to ensure notifications aren’t blocked by spam filters.

Email Content

Each incident notification email includes:
FieldDescription
Subject LineIncident title with severity indicator
Incident IDUnique identifier for tracking
SeverityHigh, Medium, Low, or Informational
DescriptionSummary of the security event
MITRE TacticsAssociated ATT&CK techniques
EntitiesAffected users, devices, IPs, etc.
View Incident ButtonDirect link to the incident in ContraForce

Example Email

Example ContraForce notification email
The View Incident button opens the incident directly in the ContraForce Portal, allowing immediate investigation and response.

Distribution Group Notifications

Route notifications to a team distribution list instead of individual users for better team visibility.

Benefits

Team Visibility

Entire SOC team sees all alerts in a shared inbox

No Missed Alerts

Alerts aren’t missed when individuals are unavailable

On-Call Routing

Route to on-call rotation distribution groups

Ticketing Integration

Use email-to-ticket systems for automatic tracking

Setting Up Distribution Groups

Distribution group notifications require setup assistance from ContraForce:
1

Identify Email Address

Determine the distribution group email address (e.g., [email protected])
2

Provide During Onboarding

Share the email address during initial workspace onboarding
3

Or Contact Support

For existing workspaces, email [email protected]
4

Engineering Configuration

ContraForce Engineering team configures the distribution group
5

Verification

Test that notifications are reaching the distribution group
Distribution group changes require ContraForce support assistance. Self-service distribution group configuration is planned for a future release.

Common Distribution Group Patterns

PatternEmail ExampleUse Case
SOC Team Inbox[email protected]Shared visibility for all analysts
Customer-Specific[email protected]Dedicated inbox per customer
On-Call Rotation[email protected]Routes to current on-call analyst
Ticketing System[email protected]Auto-creates tickets in ITSM

Gamebook Notifications

Gamebook notifications are available for all modules (XDR and XDR + SIEM).

Gamebook Notification Events

EventNotification Sent
Gamebook completed successfully
Gamebook execution failed
Gamebook requires approval
Gamebook approved/rejected

Gamebook Email Content

  • Gamebook name and type
  • Target incident details
  • Actions executed
  • Execution status (Success/Failed/Pending)
  • Workspace name
  • Link to view details
Gamebook notifications help track automated response actions across your customer base, providing audit trails for compliance and visibility into response activity.

Integration with External Tools

Email-to-Ticket Integration

Route notifications to ITSM platforms that support email-based ticket creation:
PlatformSetup Method
ServiceNowConfigure inbound email actions
Jira Service ManagementUse email request channel
AutotaskSet up email-to-ticket rules
ConnectWiseConfigure email connector
ZendeskUse support email address

ServiceNow Integration

For tighter integration, use our native ServiceNow connector

Microsoft Teams / Slack

For real-time chat notifications:
1

Create Email-Enabled Channel

Set up an email address for your Teams channel or Slack workspace
2

Use as Distribution Group

Provide this email to ContraForce as your notification recipient
3

Receive in Chat

Notifications appear directly in your team chat

Best Practices

Begin with High severity only, monitor for a week, then gradually enable Medium and Low based on team capacity and incident quality.
Configure severity settings to match your SLA with each customer. Premium customers might get all severities; standard customers might only get High and Medium.
Individual email notifications risk being missed. Distribution groups ensure the entire team has visibility into alerts.
Route notifications to your ITSM for automatic ticket creation, SLA tracking, and audit trails.
Add [email protected] to email allowlists for your organization and your customers.
Monthly review notification settings. If a severity level generates too much noise, consider disabling it while you tune detection rules.

Troubleshooting

Common Issues

IssuePossible CauseSolution
Not receiving notificationsSpam filter blockingAdd sender to allowlist
Not receiving notificationsWrong module deployedVerify XDR + SIEM module is active
Not receiving notificationsSeverity disabledCheck notification settings
Not receiving notificationsDistribution group issueContact support to verify configuration
Too many notificationsAll severities enabledDisable Informational and Low
Delayed notificationsEmail server delaysCheck your mail server; ContraForce sends in near real-time
Missing workspacesPermissions issueVerify you have admin access to the workspace

Testing Notifications

To verify notifications are working:
1

Check Settings

Confirm notification settings are enabled for the workspace
2

Verify Email Allowlist

Ensure the sender address isn’t blocked
3

Wait for Incident

Wait for a new Sentinel incident (or ask ContraForce to send a test)
4

Check All Folders

Check inbox, spam, and junk folders
5

Verify Content

Confirm the email contains expected incident details

Frequently Asked Questions

All notifications are sent from [email protected]
No, ContraForce does not send notifications for Defender XDR incidents. Use Microsoft Defender’s built-in notification settings. ContraForce notifications are for Sentinel incidents (XDR + SIEM module) and Gamebook activity.
Contact [email protected] with the email address. The ContraForce Engineering team will configure it for your account.
Email templates are standardized and cannot be customized. For custom formatting, route emails to a ticketing system that can transform them.
Notifications are sent in near real-time when Sentinel incidents are processed. Typical delay is under 5 minutes from incident creation.
Currently, notifications are configured at the workspace level, not per-user. All recipients for a workspace receive the same notifications based on severity settings.
ContraForce currently supports email only. For SMS or push, route email notifications to PagerDuty, Opsgenie, or similar services.


Questions about notifications? Contact us at [email protected].