Aller au contenu principal

Microsoft Defender for Endpoint Integration

Forward AI interaction events to Microsoft Defender for Endpoint to gain endpoint-level visibility of AI platform usage and policy violations.

Overview

This integration enables:

  • Endpoint visibility of AI platform activity
  • Correlation of AI events with endpoint events
  • Automated response through Defender playbooks
  • Risk scoring based on AI interaction patterns
  • Compliance reporting combining endpoint and AI data

Data Flow:

AI Interaction → Noxys API → Defender API → Incident correlation → Response

Prerequisites

  • Microsoft Defender for Endpoint (E5 or standalone license)
  • Azure AD / Entra ID tenant
  • Admin role in Noxys
  • Security Admin role in Microsoft Defender
  • HTTPS endpoint connectivity

Step 1: Create API Client in Azure

Register Noxys in Entra ID to access Defender APIs.

  1. Azure PortalApp registrationsNew registration
  2. Configure:
    • Name: Noxys Defender Integration
    • Supported account types: Single tenant
  3. Register
  4. Note Client ID

Step 2: Generate Client Secret

  1. Certificates & secretsNew client secret
  2. Configure:
    • Description: Defender API
    • Expires: 24 months
  3. Copy secret value

Step 3: Configure API Permissions

Grant Defender API permissions.

  1. API permissionsAdd a permission
  2. Select APIs my organization uses
  3. Search for WindowsDefenderATP (Microsoft Defender for Endpoint)
  4. Choose Application permissions:
    • Alert.ReadWrite.All
    • Incident.ReadWrite.All
    • Machine.Read.All
  5. Grant admin consent

Step 4: Get Defender Tenant Info

Find your Defender for Endpoint tenant ID.

  1. Microsoft Defender PortalSettingsAPI
  2. Note:
    • Tenant ID (displayed at top)
    • API URL (e.g., https://api.securitycenter.windows.com)

Step 5: Enable in Noxys

Configure Defender integration in Noxys.

  1. Noxys Admin PanelIntegrationsMicrosoft Defender
  2. Click Enable Integration
  3. Configure:
FieldValue
Tenant IDYour Azure tenant ID
Client IDApp registration Client ID
Client SecretClient secret from step 2
Defender API URLFrom step 4
  1. Click Test Connection
    • Should show: "✓ Successfully connected to Defender for Endpoint"
  2. Click Save

Step 6: Configure Event Forwarding

Select which events to send to Defender.

  1. SettingsEvent Forwarding
  2. Enable:
    • interaction.policy_violated — Policy violations
    • interaction.high_risk — High-risk interactions
    • alert.severity_critical — Critical alerts
    • alert.severity_high — High severity alerts
  3. Click Save

Step 7: Create Defender Alerts

Noxys interactions automatically create incidents in Defender.

  1. Microsoft Defender PortalIncidents
  2. Filter by Noxys
  3. Should see incidents like:
    • "High-risk AI interaction detected"
    • "Policy violation on user machine"

Example incident details:

Title: Policy violation - Block PII on ChatGPT
Severity: High
Category: AI Firewall
Details:
Platform: ChatGPT
Risk Score: 0.95
Risk Signal Detected: Email address
User: alice@acme.fr
Device: ALICE-LAPTOP
Timestamp: 2026-03-20 14:32:00

Step 8: Create Response Rules

Automatically respond to AI-related incidents.

  1. SettingsAutomated investigation and response
  2. Click Create rule
  3. Configure:
SettingValue
Name"Block user on critical AI violation"
ConditionThreat type = "AI Firewall" AND Severity = "High"
ActionIsolate device / Alert user / Create ticket
  1. Save

Advanced: Machine Learning Integration

Use Defender's machine learning to score AI interaction risk.

  1. Enable: SettingsAdvanced featuresAutomated investigation
  2. Noxys interaction data feeds ML models
  3. Defender correlates with endpoint events
  4. Combined risk score affects incident severity

Incident Correlation

Defender automatically correlates AI events with endpoint events:

Timeline:
14:30 - ChatGPT access from ALICE-LAPTOP
14:31 - Risk Signal classified as Restricted
14:32 - Policy violation: Block triggered
14:35 - Suspicious network activity from ALICE-LAPTOP
→ Correlated incident created

Defender Advanced Hunting

Query Noxys data using Defender's advanced hunting.

  1. HuntingAdvanced huntingCreate query
  2. Query Noxys custom table:
NoxysInteractions
| where RiskScore > 0.8
| join (DeviceNetworkInfo) on DeviceId
| summarize HighRiskCount=count() by DeviceId, DeviceName
| where HighRiskCount > 5
  1. Create detection rule from query

Integration with Threat Analytics

Monitor AI-related threats in Threat Analytics.

  1. Threat analytics → Create dashboard
  2. Add cards for:
    • "AI platform usage trends"
    • "High-risk interaction rate"
    • "Policy violations by platform"

Troubleshooting

Events Not Appearing in Defender

  1. Verify integration is Enabled
    • SettingsIntegrationsMicrosoft Defender
  2. Check event forwarding is configured
    • SettingsEvent Forwarding
  3. Test connection again
  4. Check Defender API URL is correct
  5. Verify permissions granted:
    • Alert.ReadWrite.All
    • Incident.ReadWrite.All

Incidents Not Created

  1. Verify events match forwarding criteria
  2. Check Defender is receiving API calls
    • Defender PortalSettingsAPIAudit log
  3. Verify client secret hasn't expired
  4. Check network connectivity between Noxys and Defender

Correlation Not Working

  1. Ensure both Noxys and Defender have endpoint data
  2. Verify device names match between systems
  3. Check incident timeline overlap
  4. Wait 5-10 minutes for ML model update

Cost Considerations

  • Defender for Endpoint: E5 license required (~$15/user/month)
  • Noxys Defender integration: Included, no additional cost
  • API calls: Included in Defender subscription

Best Practices

  1. Forward only critical events

    • Reduces noise in Defender incidents
    • Focus on policy_violated and severity_high+
  2. Use descriptive incident details

    • Include platform, risk score, Risk Signals type
    • Helps SOC team investigation
  3. Set up automated playbooks

    • Auto-isolate devices with repeated violations
    • Create tickets for incident response team
  4. Monitor correlation quality

    • Review incidents weekly
    • Adjust rules if too many false positives
  5. Leverage ML scoring

    • Let Defender ML correlate patterns
    • Don't override automatically-determined severity

Compliance & Audit

Defender audit log tracks all API calls:

  1. Defender PortalSettingsAPIAudit log
  2. Export for compliance:
    • GDPR requests
    • SOC 2 audits
    • Security reviews

Disabling Integration

If you need to disable Defender integration:

  1. IntegrationsMicrosoft DefenderDisable
  2. No more incidents are created
  3. Existing incidents remain in Defender
  4. Data is not deleted

To re-enable:

  1. Follow configuration steps again
  2. Events resume flowing to Defender

Integration with Other Microsoft Services

Defender integrations also enable:

  • Microsoft Sentinel: Export incidents to Sentinel
  • Microsoft 365 Defender: Unified threat dashboard
  • Intune: Device compliance enforcement

Support

PII alert mapping (Noxys signal -> Defender alert)

Noxys signals map to Microsoft Defender alert severity at the connector layer. Default mapping is editable in Noxys Console -> Integrations -> Microsoft Defender -> Severity mapping. Alerts ship via the Microsoft Graph Security API (https://graph.microsoft.com/v1.0/security/alerts_v2).

Noxys classificationNoxys severityDefender alert severityDefender category
CREDIT_CARD, IBAN, SSNCRITICALHighExfiltration
SECRET (API key, token)CRITICALHighCredentialAccess
EMAIL (bulk)HIGHMediumCollection
IP (confidential)HIGHMediumCollection
CODE (proprietary)MEDIUMLowCollection
SHADOW_AI (unvetted platform)MEDIUMLowCommandAndControl

The Noxys event body is preserved in additionalData (Graph Security schema) under the noxys key — Defender XDR custom detection KQL can read it directly.

Host isolation via Defender for Endpoint API

Defender supports two isolation modes: Full (no network) and Selective (allows Defender agent traffic only). Noxys recommends Full for CRITICAL alerts and never isolates on MEDIUM or LOW.

  1. Microsoft 365 Defender portal -> Settings -> Endpoints -> Advanced features
  2. Enable Automated Investigation and Live Response
  3. Hunting -> Custom detection rules -> Create new rule:
AlertEvidence
| where Title startswith "Noxys:"
| where Severity == "High"
| extend Classification = tostring(parse_json(AdditionalFields).noxys.classification)
| where Classification in ("CREDIT_CARD", "IBAN", "SSN", "SECRET")
| project Timestamp, AlertId, DeviceId, Classification
  1. Set Response action -> Isolate device with isolation type Full
  2. Save, run in test mode for 7 days, then enable

Path B: Noxys-driven push (advanced)

Enable only after 30 days of manual operation and an approved runbook.

  1. Noxys Console -> Integrations -> Microsoft Defender -> Advanced
  2. Toggle Push host isolation on CRITICAL alerts
  3. Confirm the Azure AD app has the Machine.Isolate application permission (WindowsDefenderATP API), admin-consented

Noxys then calls:

POST https://api.securitycenter.microsoft.com/api/machines/{machineId}/isolate
Authorization: Bearer <azure-ad-token>
Content-Type: application/json

{
"Comment": "Noxys: CRITICAL PII exfiltration to unvetted AI platform",
"IsolationType": "Full"
}

A 201 Created response flips the Noxys alert state to contained and writes an audit row. The Defender agent on the host shows the isolation banner within 5-15 seconds.

Prerequisites checklist for isolation

  • Azure AD App registration with the following Application permissions (admin-consented):
    • WindowsDefenderATP / Machine.Isolate
    • WindowsDefenderATP / Machine.Read.All
    • Microsoft Graph / SecurityAlert.ReadWrite.All
  • Defender for Endpoint Plan 2 (P2) license on every device you want to isolate
  • Tenant has accepted the Defender API end-user license terms

Test it

# Inject a synthetic CRITICAL alert into Noxys (staging tenant)
curl -X POST https://api-staging.noxys.cloud/v1/alerts/test \
-H "Authorization: Bearer $NOXYS_ADMIN_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"severity": "CRITICAL",
"classification": "SECRET",
"platform_id": "deepseek",
"user_sub": "test-user@corp.eu",
"host_id": "<defender-machine-id>"
}'

Expected within 90 seconds:

  • Alert appears in Microsoft 365 Defender -> Incidents & alerts, source = "Noxys AI Firewall"
  • Custom detection rule fires, Defender isolates the test device
  • Noxys alert state moves to contained