Overview
Direct Message Injection (DMI) for Microsoft 365 allows NINJIO to place simulated phishing emails, training assignments, and system notifications directly into your employees' Exchange Online inboxes using Microsoft Graph APIs, rather than sending them across the public internet.
Why This Is Important
Traditional security awareness simulations face an inherent challenge: an email sent over the public internet tests both your perimeter technical defenses and your employees at the same time. This dynamic often leads to friction, skewed metrics, and administrative overhead:
Separating Employee Awareness from Gateway Filtering: When simulations arrive over standard inbound mail routes, success often hinges on whether your mail filters, security gateways, or reputation engines let the email through. DMI establishes a verified, authorized delivery pathway so your results reflect genuine human behavior rather than perimeter filter performance.
Eliminating External Sending Bottlenecks: External mail gateways and security providers frequently throttle, quarantine, or delay mass email campaigns based on sending IP reputation. DMI bypasses external mail-flow choke points entirely, ensuring predictable, consistent, and timely delivery for all your training and phishing campaigns.
Protecting Reporting Integrity: Automated security scanners and mail hygiene tools frequently inspect inbound emails by pre-clicking embedded links before the employee ever opens the message. These automated actions trigger false positive "clicks," making it difficult to assess true employee vulnerability. By placing messages directly into the inbox, DMI significantly reduces automated bot interaction and gives your security leadership dependable data.
Reducing Administrative Maintenance: Maintaining intricate perimeter allowlists, custom headers, and IP firewall rules across evolving email gateways requires ongoing administrative effort. DMI simplifies simulation operations by replacing complex connection setups with a one-time, native Microsoft tenant connection.
Key Benefits
Eliminates IP Throttling and Gateway Delays: Injections bypass external inbound mail-flow choke points and IP reputation filtering, ensuring prompt, reliable campaign delivery.
Cleaner, More Accurate Training Data: Because emails arrive via an authorized Microsoft integration rather than navigating external mail gateways, links are not prematurely tripped by perimeter security filters, significantly reducing automated "bot" clicks.
Automatic Delivery Fallback: If message injection cannot be completed (such as for unsupported mailbox types or transient connection issues), NINJIO immediately and automatically routes the email through standard SMTP delivery.
Simple, Plug-and-Play Setup: Administrators can connect their tenant with a single authorization workflow—no manual exchange of API keys or complex mail routing configurations required.
Realistic Employee Experience: Simulation emails appear naturally in the user's inbox with the configured sender name and email address, mirroring real-world communication.
Key Functionalities
Broad Coverage Across NINJIO Emails: DMI applies to all emails processed by NINJIO for enrolled recipients on connected domains, including phishing simulations, training notifications, magic links, reporter feedback, and certificates.
Domain-Level Delivery Controls: When your Microsoft tenant is connected, all associated email domains are imported, giving you the flexibility to keep or remove specific domains from DMI routing.
Multi-Account Tenant Support: A single Microsoft 365 tenant can be connected to multiple NINJIO client or sub-accounts, making it straightforward for organizations managing multiple entities.
Full Campaign Tracking: Employee actions—including email opens, link clicks, training completions, and reported emails submitted via the NINJIO Phish Reporter button—continue to track seamlessly.
How-To Steps: Connecting Microsoft DMI
Prerequisites
Your mailboxes must be hosted in Microsoft 365 (Exchange Online).
A Microsoft administrator with Global Administrator or Privileged Role Administrator rights must perform or approve the connection.
Ensure existing allowlisting and Microsoft Advanced Delivery policies remain active to support fallback delivery.
Quick How-To Video:
Step 1: Initiate Connection in NINJIO
Log in to the NINJIO Admin Portal.
Navigate to Settings > Sync > Microsoft DMI.
Click Connect.
Step 2: Grant Microsoft Tenant Consent
When redirected to the Microsoft login screen, sign in with your Global Administrator or Privileged Role Administrator account.
Review the requested application permissions (
Mail.ReadWriteandDomain.Read.All).Click Accept to approve the connection.
You will be redirected back to the NINJIO portal, where the status will display as Connected.
Note: The authorization request is bound to your browser session and must be approved within 30 minutes of initiation.
Step 3: Manage Your Domains
Once connected, review the list of imported tenant domains.
If you have domains that should not receive injected messages (e.g., shared administrative domains or external domains), select their checkboxes and click Delete selected.
Any emails sent to removed domains will automatically default to standard regular delivery.
NOTE: To see in-depth step-by-step documentation, please click here.
Step 4: Verify Delivery
Launch a test simulation to an internal test user on an active, connected domain.
Confirm the simulation arrives in the employee's Inbox as expected.
Important Considerations & Known Limitations
Exchange Online Only: On-premises Exchange servers and hybrid mailboxes hosted on-premises cannot receive messages via DMI and will automatically fall back to standard delivery.
Domain List Updates: The domain list is captured as a snapshot at the time of connection. If your organization adds a new domain in Microsoft 365, click Reconnect or disconnect and reconnect to refresh the list in NINJIO.
Individual Mailbox Exclusions: Mailbox exclusion is handled at the domain level or by who is enrolled in NINJIO. Excluding individual mailboxes within a connected domain is not supported inside the portal.
Message Size Limit: Injected emails (including attachments) must remain under approximately 3.5 MB; messages exceeding this threshold automatically fall back to standard SMTP.
Do Not Remove Allowlisting: Keep your existing perimeter allowlists and Microsoft Advanced Delivery configurations active so regular delivery continues uninterrupted during fallbacks.
Frequently Asked Questions (FAQ)
-
Q: Why does the Microsoft integration require read and write access (
Mail.ReadWrite)?A: Microsoft Graph permissions combine mailbox message creation and reading under a single unified permission (
Mail.ReadWrite) with no write-only alternative. NINJIO strictly utilizes the write capability to deposit campaign emails directly into the Inbox; NINJIO's application never reads, inspects, modifies, or deletes existing employee emails.
-
Q: Does granting tenant-wide permissions mean NINJIO will email everyone in our organization?
A: No. Technical access to the tenant allows NINJIO to inject emails only to the specific learners, targets, and admins configured inside your NINJIO user management platform. Inactive users or individuals not registered in NINJIO will never receive campaign emails.
-
Q: Does DMI completely bypass all email security?
A: DMI serves as an authorized delivery route rather than an inbound internet bypass. While it eliminates perimeter pre-delivery filtering and automated link clicking, endpoint protections, browser filters, and post-delivery mailbox scanning tools can still evaluate messages.
-
Q: What happens if Microsoft Graph experiences an outage or throttles traffic?
A: If an injection request fails or is throttled by Microsoft, NINJIO immediately routes the message via standard delivery channels so your campaign schedule remains intact.
-
Q: How do we disconnect or revoke NINJIO's DMI access?
A: You can stop message injection at any time by clicking Disconnect under Settings > Sync > Microsoft DMI in your NINJIO portal. To completely revoke application access from your tenant, an administrator can delete the Ninjio enterprise application in the Microsoft Entra admin center.
Comments
0 comments
Please sign in to leave a comment.