Palo Alto Networks · AsyncAPI Specification

Cortex XSIAM Data Ingestion

Version 1.0.0

Cortex XSIAM Data Ingestion provides streaming log and event ingestion endpoints for collecting security telemetry from external data sources into the XSIAM data lake. The ingestion service accepts data via HTTPS with streaming support, enabling high-throughput log collection for SIEM replacement and XDR-native data lake consolidation. Supported ingestion methods include Syslog forwarding over TCP/UDP/TLS, HTTPS log forwarding via REST endpoints, and XDR data forwarding from integrated Palo Alto Networks products. Ingested data is processed by the XSIAM correlation and analytics engines for threat detection, investigation, and automated response. Each ingestion event results in normalized data being indexed into the appropriate XSIAM dataset identified by vendor, product, and log type.

View Spec View on GitHub Cloud SecurityCybersecurityFirewallNetwork SecuritySASESOARThreat IntelligenceXDRAsyncAPIWebhooksEvents

Channels

log_data/ingested
subscribe onLogDataIngested
Raw log data ingested into XSIAM
Event channel for raw log data ingestion. Logs are submitted to the XSIAM HTTP collector endpoint as structured JSON batches. Each log entry must include dataset, vendor, product, log_type, and raw_log fields to route the data to the correct parsing pipeline. The XSIAM ingestion engine parses, normalizes, and indexes the log data into the appropriate dataset for analytics and correlation.
event_data/ingested
subscribe onEventDataIngested
Structured event data ingested into XSIAM
Event channel for structured event data ingestion. Pre-parsed events with normalized field mappings are submitted directly to the XSIAM data lake, bypassing the raw log parsing pipeline. Each event must include dataset, vendor, product, log_type, and timestamp metadata along with the normalized event fields. Used when the source system has already normalized data into XSIAM-compatible field mappings.
xdr_data/forwarded
subscribe onXdrDataForwarded
XDR data forwarded from a Palo Alto Networks product
Event channel for XDR data forwarding from integrated Palo Alto Networks products including PAN-OS firewalls, Prisma Access, Cortex XDR agents, and other Strata products. Forwarded XDR data is automatically normalized and correlated within XSIAM for unified threat detection and investigation across the Palo Alto Networks security platform.

Messages

LogDataIngested
Log Data Ingested
Raw log data submitted to the XSIAM HTTP log collector for parsing and ingestion into the data lake
EventDataIngested
Event Data Ingested
Structured and normalized event data submitted directly to the XSIAM data lake for indexing without additional parsing
XdrDataForwarded
XDR Data Forwarded
Telemetry data forwarded from a Palo Alto Networks XDR-enabled product to XSIAM for unified detection and correlation

Servers

https
xsiam-collector https://api-{fqdn}/logs/v1/event
Cortex XSIAM HTTP log collector endpoint for streaming log and event data ingestion. The FQDN is specific to the XSIAM tenant and is found in Settings > Configurations > Data Collection > HTTP Collectors. All requests require API key authentication using the x-xdr-auth-id header (key ID) and the Authorization header (API key value). Payloads may be gzip-compressed using the Content-Encoding: gzip header for improved throughput efficiency.
tcp
syslog-receiver {syslogHost}:{syslogPort}
Syslog receiver endpoint for forwarding logs from external systems using Syslog over TCP, UDP, or TLS. Configure the source system to forward Syslog messages (RFC 3164 or RFC 5424) to this endpoint. TLS encryption is supported for secure log forwarding.