Export events to syslog and SIEM
Airgate streams its events to your syslog collector or SIEM, so sign-ins, admin logins, sessions and configuration changes land next to the rest of your security logs. This guide adds a log export target, chooses the transport and format, and verifies delivery.
Before you begin
Section titled “Before you begin”- A collector reachable from Airgate over the internet: a syslog listener (UDP or TCP 514, TLS 6514), or a Splunk HTTP Event Collector (HEC). Allow the Airgate outbound addresses on your firewall.
- For TLS: the collector’s certificate, or its CA in PEM if it is private.
- For Splunk HEC: the HEC URL and a token.
- An administrator role with
admin:write.
Step 1: Prepare the collector
Section titled “Step 1: Prepare the collector”| SIEM | Recommended transport and format |
|---|---|
| IBM QRadar | TLS (or TCP), LEEF 2.0 |
| ArcSight | TCP or TLS, CEF |
| Microsoft Sentinel, Elastic, Graylog | TCP or TLS to the collector or agent, JSON |
| Splunk | Splunk HEC, JSON (or CEF / LEEF) |
| Any syslog server | UDP / TCP / TLS, RFC 5424 |
On the collector, create the listener or HEC token. In Splunk, the index must be allowed for the token.
Step 2: Add the target in Airgate
Section titled “Step 2: Add the target in Airgate”-
Open Settings › Log export and select Add target.
-
Name (for example
QRadar) and Description. -
Transport:
Transport Notes UDP Fire-and-forget datagrams, truncated at 8 KiB. Default port 514. TCP Reliable stream. Default port 514. Framing: Octet counting (default) (RFC 6587, what most collectors expect) or Newline-terminated (LF). TLS RFC 5425 syslog over TLS. Default port 6514. Framing as for TCP. Splunk HEC HTTP Event Collector, batched (100 events or 1 second), 3 attempts per batch. For UDP, TCP and TLS enter Host and Port. For Splunk HEC enter HEC URL (for example
https://splunk.contoso.com:8088;/services/collector/eventis appended unless the URL already contains/services/collector), HEC token, and optionally Index (empty = the token’s default), Sourcetype and Source. -
For TLS and HEC: keep Verify the server certificate on. Paste a private CA into Trusted CA certificate(s).
-
Message format:
Format Content RFC 5424 Structured data [nac@32473 tenant=".." event_id=".." …]and a summary messageCEF ArcSight Common Event Format: CEF:0|NAC Console|Cloud NAC|1.0|<topic>|…, withcs1tenant,cs2service,cs3roles,cs4profiles,cs5postureLEEF 2.0 IBM QRadar Log Event Extended Format JSON One JSON document per event: {"time":…,"topic":…,"data":{…}}Also set Facility (default
local0 (16)) and APP-NAME (defaultnac-console, 1 to 48 printable characters). For CEF, LEEF and JSON over syslog, Prefix the RFC 5424 header can be turned off for collectors that expect the bare payload. The Preview (auth.reject) box shows a sample message. -
Events: leave empty for the Default set, or pick topics (exact,
prefix.*). The default set isauth.*,tacacs.*,session.start,session.stop,admin.audit,system.alert,nad.problem,coa.sent,posture.changed,endpoint.profile_changed,guest.*andcert.*. Payloads are credential-redacted. -
Keep Enabled on and save.
Severity
Section titled “Severity”| Events | Syslog severity |
|---|---|
system.alert, nad.problem |
warning (error for critical alerts) |
auth.reject, failed TACACS+ requests, posture QUARANTINE / INFECTED |
warning |
admin.audit, config.changed, cert.revoked, endpoint.deleted |
notice |
| everything else | informational |
Verify
Section titled “Verify”- Select Send test message on the target row. The result appears as a notification.
- On the collector, search for the APP-NAME
nac-consoleor the test message. - On Settings › Log export, the target’s Status and Sent · drop · err counters show delivery. The tiles show Healthy, Messages sent, Dropped and Problems. Turn on Live status for automatic refresh.
Status and counters describe one Airgate server since it started. Configuration changes reach all servers within 15 seconds. While a TCP or TLS target is disconnected, up to 10,000 messages are queued, then dropped and counted.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Cause | Fix |
|---|---|---|
| Status stays Starting | The sender starts within 15 seconds. | Wait and refresh. |
| Status disconnected, errors growing (TCP / TLS) | The collector is unreachable or refuses the connection. | Check the host, port and firewall from the Airgate side. |
| TLS target fails with a certificate error | The collector’s certificate is not trusted or its name differs from Host. | Paste the CA into Trusted CA certificate(s); use the host name in the certificate. |
| Messages arrive but are not parsed | Format or framing does not match the collector’s parser. | Use Octet counting or LF as the collector expects; match the format (LEEF for QRadar, CEF for ArcSight). |
| Splunk HEC: HTTP 403 | Wrong HEC token, or the token is not allowed to write to Index. | Check the token and its allowed indexes. |
| Long messages cut off | UDP truncates at 8 KiB. | Use TCP, TLS or HEC. |
| Dropped grows | The target was down longer than the queue holds. | Fix the connection; use HEC or TCP to a reliable collector. |