Skip to content

SIEM Integration ​

Overview ​

GhostAI's SIEM integration enables enterprises to stream every security event — PII detections, authentication, admin actions, policy changes, file processing, and more — to their existing Security Information and Event Management (SIEM) platform in real time.

This feature is part of the Enterprise plan and addresses the LOG-5 requirement for centralized security monitoring.

Enterprise Feature

SIEM integration requires an Enterprise subscription and the admin or owner role in your organization.

Why SIEM Integration Matters ​

Security operations teams rely on their SIEM as the single source of truth for security monitoring, incident response, and compliance evidence. Without SIEM integration, GhostAI audit events exist in isolation, creating blind spots in your security posture.

With SIEM integration, you can:

  • Correlate GhostAI events with other security signals (network, endpoint, identity)
  • Alert on suspicious patterns using your SIEM's detection rules
  • Investigate incidents with full context from GhostAI's audit trail
  • Report on AI data protection as part of compliance audits
  • Retain events according to your organization's log retention policies

Supported SIEMs ​

GhostAI includes pre-built presets for 16 SIEM platforms, plus a fully customizable option:

SIEMDefault FormatDescription
SplunkSplunk HECHTTP Event Collector with configurable index and source routing
Microsoft SentinelSentinelAzure Log Analytics Data Collector API integration
DatadogJSONDatadog Logs API with service and source tags
Elastic (ELK)JSONElasticsearch bulk API or Logstash HTTP input
IBM QRadarLEEFLog Event Extended Format over syslog or REST
Google Chronicle (SecOps)JSONChronicle Ingestion API with customer ID
CrowdStrike LogScaleJSONHEC-compatible ingest API (formerly Humio)
Palo Alto Cortex XSIAMCEFCortex XDR HTTP collector integration
Sumo LogicJSONHTTP Source collector endpoint
PantherJSONPanther HTTP log source
ExabeamJSONExabeam cloud connector REST API
LogRhythmJSONOpen Collector HTTP input
SecuronixJSONSecuronix SNYPR web import
DevoJSONDevo relay HTTP endpoint
AWS Security LakeOCSFOCSF v1.1 format for Security Lake ingestion
CustomAnyUser-defined endpoint with configurable headers, auth, and format

Each preset includes SIEM-specific configuration fields, default settings, logo assets, and error remediation advice for common HTTP status codes.

Delivery Methods ​

Webhook Push ​

GhostAI pushes batches of events to your SIEM endpoint in near real-time.

  • Batch size: Configurable from 1 to 1,000 events per batch (default: 100)
  • Flush interval: Configurable from 1 to 60 seconds (default: 5s)
  • Retry logic: Automatic retry with exponential backoff on delivery failure
  • Authentication: Bearer token, API key header, basic auth, or custom headers

Pull API ​

For SIEMs that prefer pull-based ingestion, GhostAI provides an authenticated polling endpoint.

  • Endpoint: GET /api/admin/siem/pull
  • Authentication: HMAC-signed tokens scoped to a single organization
  • Pagination: Cursor-based pagination with since timestamp filtering
  • Formats: All 6 output formats supported

Output Formats ​

GhostAI supports 6 output formats to match your SIEM's ingestion requirements:

FormatStandardUse Case
JSONGhostAI nativeDefault format; works with most modern SIEMs
CEFCommon Event FormatArcSight, Cortex XSIAM, and CEF-compatible SIEMs
LEEFLog Event Extended FormatIBM QRadar native format
Splunk HECSplunk HTTP Event CollectorSplunk Enterprise and Splunk Cloud
SentinelAzure Log AnalyticsMicrosoft Sentinel via Data Collector API
OCSFOpen Cybersecurity Schema Framework v1.1AWS Security Lake, OCSF-native platforms

You can preview how events look in each format before enabling delivery using the preview endpoint.

Event Catalog ​

GhostAI's event catalog contains 70+ event types organized into 8 categories:

Authentication Events ​

  • auth.login — User login (email/password, OAuth, SSO)
  • auth.logout — User logout
  • auth.login_failed — Failed login attempt
  • auth.mfa_enabled / auth.mfa_disabled — MFA configuration changes
  • auth.sso_login — SAML SSO authentication
  • auth.password_changed — Password change
  • auth.api_key_created / auth.api_key_revoked — API key lifecycle

PII Detection Events ​

  • pii.detected — PII entities detected in user input
  • pii.tokenized — PII replaced with tokens before LLM transmission
  • pii.detokenized — Tokens restored in LLM response
  • pii.false_positive — User reported false positive
  • pii.override — Per-message PII override applied
  • pii.response_scan — PII detected in LLM response

File Processing Events ​

  • file.uploaded — File uploaded for processing
  • file.scanned — File PII scan completed
  • file.pii_found — PII detected in uploaded file
  • file.quarantined — File quarantined due to policy violation

Admin Actions ​

  • admin.user_invited / admin.user_removed — Team membership changes
  • admin.role_changed — User role modification
  • admin.policy_updated — Organization policy change
  • admin.sso_configured — SSO configuration change

Chat & Model Events ​

  • chat.message_sent — Chat message processed
  • chat.model_switched — Model selection change
  • chat.tool_executed — Tool call (web search, image gen, code execution)

Policy & Configuration ​

  • policy.created / policy.updated / policy.deleted — Policy lifecycle
  • config.detection_changed — Detection settings modified
  • config.vertical_changed — Industry vertical changed

System Events ​

  • system.rate_limited — Rate limit enforced
  • system.error — System error occurred
  • system.health_check — Health check event

Compliance Events ​

  • compliance.report_generated — Compliance report created
  • compliance.score_changed — Compliance score updated
  • compliance.export_requested — Data export for compliance

Event Metadata ​

Every event includes:

  • Timestamp (ISO 8601 with millisecond precision)
  • Organization ID and tenant context
  • User ID (hashed in standard minimization mode)
  • Compliance tags — Applicable regulations (HIPAA, PCI-DSS, GDPR, SOX, GLBA, etc.)
  • MITRE ATT&CK mapping — Technique IDs where applicable
  • Severity — Critical, High, Medium, Low, Informational
  • Hash chain — prev_hash and sequence_number for tamper detection

Security Features ​

PII Scrubbing ​

Three minimization policies control what data appears in SIEM events:

PolicyBehavior
Standard (default)User identifiers hashed (SHA-256); IP addresses truncated; email domains preserved but local parts masked
AggressiveAll potentially identifying fields stripped; only event type, timestamp, org ID, and metrics retained
NoneFull fidelity; use only with SIEMs in the same security boundary

Hash Chain Integrity ​

Each event envelope includes:

  • event_hash — SHA-256 hash of the event payload
  • prev_hash — Hash of the previous event in the chain
  • sequence_number — Monotonically increasing sequence number per organization

This creates a tamper-evident chain — any gap or modification in the sequence is detectable during reconciliation.

Tenant Isolation ​

Events are strictly scoped to the originating organization:

  • Webhook deliveries only contain events for the configured organization
  • Pull API tokens are scoped to a single organization
  • Cross-tenant event access is prevented at both query and delivery layers

Credential Rotation ​

Rotate credentials without downtime:

  • Webhook credentials: POST /api/admin/siem/integrations/{id}/rotate-credentials
  • Pull API tokens: POST /api/admin/siem/integrations/{id}/rotate-pull-token

Setup Guide ​

For step-by-step setup instructions, see the SIEM Configuration Admin Guide.

Quick Start ​

  1. Navigate to Admin Dashboard → SIEM tab
  2. Click New Integration
  3. Select your SIEM from the preset list
  4. Follow the guided setup wizard with SIEM-specific field descriptions
  5. Send a test event to verify connectivity
  6. Enable the integration

Health Monitoring ​

The SIEM health dashboard provides:

  • Delivery success rate — Percentage of successfully delivered batches
  • Latency percentiles — p50/p95/p99 delivery latency
  • Error trends — Error counts over time with HTTP status breakdown
  • Gap detection — Identifies missing sequence numbers in the event chain
  • Reconciliation — Compare delivered vs expected event counts
  • Health score — Composite score (0–100) based on delivery metrics

Content Packs ​

Each SIEM preset includes downloadable content packs with:

  • Pre-built dashboards for GhostAI event visualization
  • Saved searches for common investigation queries
  • Detection rules for alerting on suspicious patterns (e.g., bulk PII exposure, failed auth spikes)
  • Field mappings for your SIEM's data model

API Reference ​

See the SIEM API Reference for complete endpoint documentation with request/response examples.

SOC 2 Type II Certified | BAA Available | HIPAA-Ready