CloudGuard WAF
  • Documentation Overview
  • What is CloudGuard WAF?
  • Getting started
    • Prepare key information
    • Log in to the Infinity Portal
    • Protect a Web Application / API
    • Deploy Enforcement Point
      • Gateway/Virtual Machine
        • AWS
          • Store Certificates in AWS
          • Store certificates on Gateway
        • Azure
          • Store Certificates in Azure
          • Store Certificates on Gateway
        • VMware
          • Store Certificates on Gateway
          • Configure networking in VMware Deployments
      • WAF as a Service
        • Certificates Managed by Check Point
        • Bring Your Own Certificate
      • Kubernetes Ingress
        • Kong Application Security
        • Istio Application Security
      • Docker
        • Single Docker
          • Deployment using 'docker' command
            • Store Certificates Locally on Docker
          • Deployment in Azure App Services
        • Dual Docker: NGINX/Kong/Envoy + Security Agent
      • Linux / NGINX / Kong
    • Monitor Events
  • Concepts
    • Gateways & Agents
    • Management & Automation
    • Security Practices
    • Contextual Machine Learning
  • Additional Security Engines
    • Anti-Bot
    • API Protection
      • API Discovery
      • Track API Discovery Learning
      • Enforce API Schema
    • File Security
    • Intrusion Prevention System (IPS)
    • Rate Limit
    • Snort Rules
  • SETUP INSTRUCTIONS
    • Setup Custom Rules and Exceptions
    • Setup Web User Response Pages
    • Setup Log Triggers
    • Setup Report Triggers
    • Setup Notification Triggers
    • Setup Behavior Upon Failure
    • Setup Agent Upgrade Schedule
  • HOW TO
    • Edit Web Application/API Settings
    • Edit Reverse Proxy Advanced Settings for a Web Asset
    • Protect an existing production site with CloudGuard WAF's Gateway
    • View Policy of all your Web Applications/APIs
    • Add Data Loss Prevention (DLP) rules
    • Configure Contextual Machine Learning for Best Accuracy
    • Track Agent Status
    • Track Learning and Move from Learn/Detect to Prevent
    • Rotate profile authentication token
    • Upgrade your Reverse Proxy when a Linux/NGINX agent is installed
    • Use Terraform to Manage CloudGuard WAF
    • Authorize Temporary Access for Check Point Support
    • Restrict Access to Backend Servers from CloudGuard WAF as a Service IPs Only
  • Troubleshooting
    • WAF Gateway / Virtual Machine
      • Azure
        • "Unable to find a tag containing the vault's name in the VMSS" Error
        • How To: Configure Key Vault for a Single Gateway
      • NGINX Error: Upstream Sent Too Big Header While Reading Response Header from Upstream
      • How To: Compare Between the Gateway's Certificate and the Upstream Certificate
    • Linux
      • SELinux: Checking Status and Disabling
    • WAF as a Service
      • Certificate Validation Failed: Adjusting CAA Record
      • How To: Redirect a Root Domain to a Subdomain Protected by WAF SaaS
      • How To: Extend Connection Timeout to Upstream
      • How To: Update Expired Certificates
  • references
    • Agent CLI
    • Management API
    • Event Query Language
    • Writing Snort Signatures
    • Events/Logs Schema
    • CVE-2022-3786 and CVE-2022-3602: OpenSSL X.509 Email Address Buffer Overflows (HIGH)
    • CVE-2025-1097, CVE-2025-1098, CVE-2025-24514, CVE-2025-1974: Ingress NGINX Controller RCE (Critical)
  • Resources
    • GitHub
    • Docker Hub
Powered by GitBook
On this page
  • Schema in openAPI format
  • Log fields

Was this helpful?

  1. references

Events/Logs Schema

PreviousWriting Snort SignaturesNextCVE-2022-3786 and CVE-2022-3602: OpenSSL X.509 Email Address Buffer Overflows (HIGH)

Last updated 3 months ago

Was this helpful?

When events are sent from CloudGuard WAF agents to be viewed in the cloud application and/or to a Syslog/CEF server, they are sent in a specific field structure.

This page will document the fields being sent. This will allow in the cloud application and log parsing to be done on the Syslog/CEF side (see configuration of for more info).

Schema in openAPI format

See below the security logs schema in openAPI format.

The definitions per field are relevant even when the logs aren't sent in JSON format.

Log fields

This table shows the predefined field keywords alongside their view name in the logs table and log cards.

in brackets for each field name is the name when sent to syslog/CEF. Usually the difference is simply an all-lowercase format vs lowerCamelCase

Field Name in Log View
Field Name
Description

Time

eventtime (sent as part of the protocol in syslog/CEF)

Time of the event in UTC.

Event Name

eventname (title - for syslog only)

This field describes the event in text.

Severity

eventseverity (eventSeverity)

Info, Low, Medium, High, Critical

Priority

eventpriority (eventPriority)

Low, Medium, High, Urgent

Confidence Level

eventconfidence (eventConfidence)

Low, Medium, High, Very High (The higher the confidence level, the less likely it is the event is a false-positive)

Event Reference Id

eventreferenceid (eventReferenceId)

Some events result in showing the user a reference ID (for example when showing an HTTP response page upon prevention). This reference ID will correlate to this field in the log.

Agent UUID

agentid (agentId)

UUID of the agent creating the log, if applicable.

Issuing Engine Version

issuingengineversion (issuingEngineVersion)

The agent's and service's version sending reporting this event.

Security Action

securityaction (securityAction)

The action taken by the security practice upon this event.

Asset Name

assetname (assetName)

The name of the asset, protected by the security practice that found a match and issued this log.

Asset ID

assetid (assetId)

The object ID of the asset, protected by the security practice that found a match and issued this log.

Zone Name

zonename (zoneName)

The name of the zone, protected by the security practice that found a match and issued this log.

Zone ID

zoneid (zoneId)

The object ID of the zone, protected by the security practice that found a match and issued this log. This can be used unique searches when given names are similar.

Practice Type

practicetype (practiceType)

The type of the security practice that found a match and issued this log (e.g. "Threat Prevention").

Practice SubType

practicesubtype (practiceSubType)

The subtype of the security practice that found a match and issued this log (e.g. "Web Application").

Practice Name

practicename (practiceName)

The name of the security practice that found a match and issued this log.

Practice ID

practiceid (practiceId)

The object UUID of the security practice that found a match and issued this log. This can be used unique searches when given names are similar.

Source IP

sourceip (sourceIp)

Source IP address of the network traffic that caused the matched event.

Source Port

sourceport (sourcePort)

Source TCP/UDP Port of the network traffic that caused the matched event.

Source Country

sourcecountryname (sourceCountryName)

Source country name of the network traffic that caused the matched event, if applicable.

Destination IP

destinationip (destinationIp)

Destination IP address of the network traffic that caused the matched event.

Destination Port

destinationport (destinationPort)

Destination TCP/UDP Port of the network traffic that caused the matched event.

Destination Country

destinationcountryname (destinationCountryName)

Destination country of the network traffic that caused the matched event, if applicable.

IP Protocol

ipprotocol (ipProtocol)

IP Protocol of the network traffic that caused the matched event.

Source Identifier

httpsourceid (httpSourceId)

The source identifier as determined from the HTTP traffic according to configuration (according to the X-Forwarded-For header, a cookie, source IP address, etc.).

HTTP Host

httphostname (httpHostName)

The source identifier as determined from the HTTP traffic according to configuration (according to the X-Forwarded-For header, a cookie, source IP address, etc.).

HTTP Method

httpmethod (httpMethod)

HTTP Method as determined from the HTTP traffic (e.g. GET, POST, etc.).

HTTP URI Path

httpuripath (httpUriPath)

HTTP URI path as determined from the HTTP traffic.

HTTP URI Query

httpuriquery (httpUriQuery)

HTTP URI query as determined from the HTTP traffic.

HTTP Request Headers

httprequestheaders (httpRequestHeaders)

HTTP Request Body

httprequestbody (httpRequestBody)

Incident Type

waapincidenttype (waapIncidentType)

CloudGuard WAF incident types (e.g. LDAP injection, SQL injection, etc.).

Incident Details

waapincidentdetails (waapIncidentDetails)

A more granular description of the event caught by CloudGuard WAF.

User Reputation

waapuserreputation (waapUserReputation)

CloudGuard WAF user reputation for the identified source.

Matched Location

matchedlocation (matchedLocation)

The location within the HTTP traffic where an indicator, causing this event, was detected (e.g. "referer parameter").

Matched Parameter

matchedparameter (matchedParameter)

The parameter name within the HTTP traffic, where an indicator, causing this event, was detected (e.g. "uuid").

Matched Sample

matchedsample (matchedSample)

The traffic data where the indicators were detected and created the event.

Match Reason

matchreason (matchReason)

An additional elaboration for the reason the event was detected (For example, when Web API Schema validation fails, this field will detail what exactly failed).

Found Indicators

waapfoundindicators (waapFoundIndicators)

The detected indicators which created the event.

Practice Override

waapoverride (waapOverride)

Override configuration for this event.

Event Audience (Hidden)

eventaudience

Constant value of 'Security' for events sent to user.

Tags (Hidden)

eventtags

For future use.

HTTP Request Headers (Sent only if relevant additional logging is configured on the object that was used).

HTTP Request Body (Sent only if relevant additional logging is configured on the object that was used). Body will be truncated if too long.

trigger
trigger
filter queries
Trigger objects
28KB
agents-security-logs-openapi-schema-v1.0.4.json