The `SAP_GATEWAY` parser monitors access and activities within the SAP Gateway, reflecting communication between external applications and SAP systems.

<br />

For information about Google SecOps for SAP, see [Secure SAP applications with Google SecOps](https://docs.cloud.google.com/sap/docs/secops/overview.md.txt).

## Field mapping reference

The following table describes the mapping between SAP Gateway log fields and Google SecOps UDM fields.

| Log field | UDM mapping | Logic |
|---|---|---|
| `timestamp` | `event.idm.read_only_udm.metadata.event_timestamp` | Initially empty, combined date/time string, then parsed to `event_timestamp`. |
| `weekday` | (none) | Day of the week extracted from the log message, used for timestamp parsing. |
| `month` | (none) | Month extracted from the log message, used for timestamp parsing. |
| `month_day` | (none) | Day of the month extracted from the log message, used for timestamp parsing. |
| `year` | (none) | Year extracted from the log message, used for timestamp parsing. |
| `time` | (none) | Time extracted from the log message, used for timestamp parsing. |
| `description` | `event.idm.read_only_udm.metadata.description` | General description field, often populated from grok. |
| `event_action` | `event.idm.read_only_udm.additional.fields` | Key "event_action", value from original `event_action`. |
| `parameter` | `event.idm.read_only_udm.target.resource.name` | Parameter associated with the event action. |
| `old_kv` | (none) | Source for key-value extraction. |
| `new_kv` | (none) | Source for key-value extraction. |
| `kv_data` | (none) | General key-value data extracted from the log, used to extract other fields like `HOST`, `USER-HOST`. |
| `security_result` | `event.idm.read_only_udm.security_result` | Holds security-related outcomes. |
| `TP` | `event.idm.read_only_udm.principal.application` OR `event.idm.read_only_udm.target.process.file.full_path` | Transaction Program name or Process ID. Mapping depends on `event_action`: - Mapped to `principal.application` if `event_action` is NOT "secinfo". - Mapped to `target.process.file.full_path` if `event_action` is "secinfo". |
| `hostname` | `event.idm.read_only_udm.principal.hostname` OR `event.idm.read_only_udm.target.hostname` | Hostname extracted from `HOST` field. Mapping depends on `event_action`: - Mapped to `principal.hostname` if `event_action` contains "reginfo". - Mapped to `target.hostname` if `event_action` contains "secinfo". |
| `ip_address` | `event.idm.read_only_udm.principal.ip` OR `event.idm.read_only_udm.target.ip` | IP address extracted from `HOST` field. Mapping depends on `event_action`: - Mapped to `principal.ip` if `event_action` contains "reginfo". - Mapped to `target.ip` if `event_action` contains "secinfo". |
| `action` | `event.idm.read_only_udm.security_result.action_details` | Specific action within the event (e.g., accepted, denied). |
| `security_result_action` | `event.idm.read_only_udm.security_result.action` | Security result action, derived from the `action` field (ALLOW/BLOCK). |
| `USER` | `event.idm.read_only_udm.principal.user.userid` | User ID extracted from `USER-HOST` field. |
| `hostname1` | `event.idm.read_only_udm.principal.hostname` | Hostname extracted from `USER-HOST` field. |
| `ip_address1` | `event.idm.read_only_udm.principal.ip` | IP address extracted from `USER-HOST` field. |
| `sap_host_context` | `event.idm.read_only_udm.additional.fields` | Key "sap_host_context", value from original `sap_host_context`. |
| `old_max_connection_setup_time` | `event.idm.read_only_udm.additional.fields` | Key "old_max_connection_setup_time", value from original field. |
| `new_max_connection_setup_time` | `event.idm.read_only_udm.additional.fields` | Key "new_max_connection_setup_time", value from original field. |
| `signal_name` | `event.idm.read_only_udm.additional.fields` | Key "signal_name", value from original `signal_name`. |
| `signal_action` | `event.idm.read_only_udm.additional.fields` | Key "signal_action", value from original `signal_action`. |
| `level` | `event.idm.read_only_udm.additional.fields` | Key "level", value from original `level`. |
| `log_severity_indicator` | `event.idm.read_only_udm.additional.fields` | Key "log_severity_indicator", value from original `log_severity_indicator`. |
| `message1` | `event.idm.read_only_udm.metadata.description` | Holds the main message content after initial grok. |
| `thread_id` | `event.idm.read_only_udm.principal.process.pid` | Thread ID extracted from the log. |
| `has_target_process` | (none) | Boolean flag indicating if target process information is present. Used for `event_type` logic. |
| `has_principal` | (none) | Boolean flag indicating if principal information is present. Used for `event_type` logic. |
| `has_target` | (none) | Boolean flag indicating if target information is present. |
| `has_principal_user` | (none) | Boolean flag indicating if principal user information is present. Used for `event_type` logic. |
| `HOST` | (none) | Raw field from KV on `kv_data`, contains host and IP info. Parsed to `hostname`, `ip_address`. |
| `USER-HOST` | (none) | Raw field from KV on `kv_data`, contains user and host/IP info. Parsed to `USER`, `hostname1`, `ip_address1`. |
| `old_kv.ACTION` | `event.idm.read_only_udm.additional.fields` | Key "old_ACTION", value from original `old_kv.ACTION`. |
| `old_kv.LOGFILE` | `event.idm.read_only_udm.additional.fields` | Key "old_LOGFILE", value from original `old_kv.LOGFILE`. |
| `old_kv.MAXSIZEKB` | `event.idm.read_only_udm.additional.fields` | Key "old_MAXSIZEKB", value from original `old_kv.MAXSIZEKB`. |
| `old_kv.SWITCHTF` | `event.idm.read_only_udm.additional.fields` | Key "old_SWITCHTF", value from original `old_kv.SWITCHTF`. |
| `new_kv.ACTION` | `event.idm.read_only_udm.additional.fields` | Key "new_ACTION", value from original `new_kv.ACTION`. |
| `new_kv.LOGFILE` | `event.idm.read_only_udm.additional.fields` | Key "new_LOGFILE", value from original `new_kv.LOGFILE`. |
| `new_kv.MAXSIZEKB` | `event.idm.read_only_udm.additional.fields` | Key "new_MAXSIZEKB", value from original `new_kv.MAXSIZEKB`. |
| `new_kv.SWITCHTF` | `event.idm.read_only_udm.additional.fields` | Key "new_SWITCHTF", value from original `new_kv.SWITCHTF`. |
| `(event_type logic)` | `event.idm.read_only_udm.metadata.event_type` | Determined based on `has_principal`, `has_target_process`, `has_principal_user` flags. |
| `(hardcoded)` | `event.idm.read_only_udm.metadata.product_name` | Hardcoded to "SAP_GATEWAY". |
| `(hardcoded)` | `event.idm.read_only_udm.metadata.vendor_name` | Hardcoded to "SAP". |
| `timestamp_1` | `event.idm.read_only_udm.metadata.event_timestamp` | Parsed from `SYSLOGTIMESTAMP` and year. |
| `MODULE` | `event.idm.read_only_udm.principal.process.file.full_path` |   |
| `VERSION` | `event.idm.read_only_udm.metadata.product_version` |   |
| `partner_ip` | `event.idm.read_only_udm.target.ip` | Extracted from `DETAIL`. |
| `partner_port` | `event.idm.read_only_udm.target.port` | Extracted from `DETAIL`. |
| `local_ip` | `event.idm.read_only_udm.principal.ip` | Extracted from `DETAIL`. |
| `local_port` | `event.idm.read_only_udm.principal.port` | Extracted from `DETAIL`. |
| `ERROR` | `event.idm.read_only_udm.security_result.description` |   |
| `summary` | `event.idm.read_only_udm.security_result.summary` | GwDisconnectClient, client disconnected (403) |
| `addr` | `event.idm.read_only_udm.target.ip` |   |
| `server_ciphersuites` | `event.idm.read_only_udm.network.tls.cipher` | 135:PFS:HIGH::EC_P256:EC_HIGH |
| `platform_tag` | `event.idm.read_only_udm.principal.platform` | Mapped to WINDOWS, LINUX, or MAC based on content. Also added to `principal.resource.attribute.labels`. |
| `client_cipher` | `event.idm.read_only_udm.network.tls.client.supported_ciphers` | Merged. |
| `client_ciphersuites` | `event.idm.read_only_udm.network.tls.client.supported_ciphers` | Merged. |
| `PORT` | `event.idm.read_only_udm.principal.port` |   |
| `HOST (if grok fails)` | `event.idm.read_only_udm.principal.hostname` |   |
| `result_filename` | `event.idm.read_only_udm.principal.process.file.full_path` |   |
| `user_id` | `event.idm.read_only_udm.principal.user.userid` |   |
| `key1, value_1` | `event.idm.read_only_udm.additional.fields` | Dynamic key/value from item array. |
| `key2, value_2` | `event.idm.read_only_udm.additional.fields` | Dynamic key/value from item array. |
| `key3, value_3` | `event.idm.read_only_udm.additional.fields` | Dynamic key/value from item array. |
| `key4, value_4` | `event.idm.read_only_udm.additional.fields` | Dynamic key/value from item array. |
| `segment_name` | `event.idm.read_only_udm.additional.fields` | Dynamic key/value from item array, key includes index. |
| `memory_address` | `event.idm.read_only_udm.additional.fields` | Dynamic key/value from item array, key includes index. |
| `allocation_details` | `event.idm.read_only_udm.additional.fields` | Dynamic key/value from item array, key includes index. |
| `total_size_bytes` | `event.idm.read_only_udm.additional.fields` | Dynamic key/value from item array, key includes index. |
| `module` | `event.idm.read_only_udm.additional.fields` | Dynamic key/value from item array, key includes index. |
| `operation` | `event.idm.read_only_udm.principal.resource.attribute.labels` | Dynamic key/value from item array, key includes index. |
| `component` | `event.idm.read_only_udm.additional.fields` | Dynamic key/value from item array, key includes index. |
| `capacity` | `event.idm.read_only_udm.additional.fields` | Dynamic key/value from item array, key includes index (as `entries_capacity`). |
| `context` | `event.idm.read_only_udm.additional.fields` | Dynamic key/value from item array, key includes index. |
| `ip_address_1` | `event.idm.read_only_udm.principal.ip` | Merged. |
| `ip_address_2` | `event.idm.read_only_udm.principal.ip` | Merged. |
| `SYSTEM_CALL` | `event.idm.read_only_udm.additional.fields` | Key "SYSTEM_CALL" |
| `line_number` | `event.idm.read_only_udm.additional.fields` | Key "line_number" |
| `LINE` | `event.idm.read_only_udm.additional.fields` | Key "LINE" |
| `COUNTER` | `event.idm.read_only_udm.additional.fields` | Key "COUNTER" |
| `TIME` | `event.idm.read_only_udm.additional.fields` | Key "TIME" |
| `LOCATION` | `event.idm.read_only_udm.additional.fields` | Key "LOCATION" |
| `COMPONENT` | `event.idm.read_only_udm.additional.fields` | Key "COMPONENT" |
| `RELEASE` | `event.idm.read_only_udm.additional.fields` | Key "RELEASE" |
| `RC` | `event.idm.read_only_udm.additional.fields` | Key "RC" |
| `product_information` | `event.idm.read_only_udm.additional.fields` | Key "product_information" |
| `product_information_2` | `event.idm.read_only_udm.additional.fields` | Key "product_information_2" |
| `library_status` | `event.idm.read_only_udm.additional.fields` | Key "library_status" |
| `SECUDIR_environment_variable_status` | `event.idm.read_only_udm.security_result.detection_fields` | Key "SECUDIR_environment_variable_status" |
| `TLS_extension_status` | `event.idm.read_only_udm.security_result.detection_fields` | Key "TLS_extension_status" |
| `bind_port_1` | `event.idm.read_only_udm.additional.fields` | Key "bind_port_1" |
| `bind_port_2` | `event.idm.read_only_udm.additional.fields` | Key "bind_port_2" |
| `bind_port_3` | `event.idm.read_only_udm.additional.fields` | Key "bind_port_3" |
| `bind_service_1` | `event.idm.read_only_udm.additional.fields` | Key "bind_service_1" |
| `bind_service_2` | `event.idm.read_only_udm.additional.fields` | Key "bind_service_2" |
| `bind_service_3` | `event.idm.read_only_udm.additional.fields` | Key "bind_service_3" |
| `bind_protocol_1` | `event.idm.read_only_udm.additional.fields` | Key "bind_protocol_1" |
| `bind_protocol_2` | `event.idm.read_only_udm.additional.fields` | Key "bind_protocol_2" |
| `bind_protocol_3` | `event.idm.read_only_udm.additional.fields` | Key "bind_protocol_3" |
| `build_information` | `event.idm.read_only_udm.principal.resource.attribute.labels` | Key "build_information" |
| `calling_module` | `event.idm.read_only_udm.additional.fields` | Key "calling_module" |
| `etd_event_sender_enable` | `event.idm.read_only_udm.additional.fields` | Key "etd_event_sender_enable" |
| `description1` | `event.idm.read_only_udm.additional.fields` | Key "description1" |
| `crypto_kernel_status` | `event.idm.read_only_udm.security_result.detection_fields` | Key "crypto_kernel_status" |
| `client_info` | `event.idm.read_only_udm.target.resource.attribute.labels` | Key "client_info" |
| `client_pvflags` | `event.idm.read_only_udm.target.resource.attribute.labels` | Key "client_pvflags" |
| `function_call` | `event.idm.read_only_udm.additional.fields` | Key "function_call" |
| `function_status` | `event.idm.read_only_udm.security_result.detection_fields` | Key "function_status" |
| `gateway_admin_status` | `event.idm.read_only_udm.security_result.detection_fields` | Key "gateway_admin_status" |
| `gw_status` | `event.idm.read_only_udm.security_result.detection_fields` | Key "gw_status" |
| `initialised_library` | `event.idm.read_only_udm.principal.resource.attribute.labels` | Key "initialised_library" |
| `pvflags` | `event.idm.read_only_udm.additional.fields` | Key "pvflags" |
| `server_tls_versions` | `event.idm.read_only_udm.target.resource.attribute.labels` | Key "server_tls_versions" |
| `client_tls_versions` | `event.idm.read_only_udm.principal.resource.attribute.labels` | Key "client_tls_versions" |
| `etd_event_sender_ssl_config` | `event.idm.read_only_udm.security_result.detection_fields` | Key "etd_event_sender_ssl_config" |
| `SECUDIR` | `event.idm.read_only_udm.principal.resource.attribute.labels` | Key "SECUDIR" |
| `features` | `event.idm.read_only_udm.principal.resource.attribute.labels` | Key "features" |
| `user_env_variables` | `event.idm.read_only_udm.principal.user.attribute.labels` | Key "user_env_variables" |
| `server_info` | `event.idm.read_only_udm.target.resource.attribute.labels` | Key "server_info" |
| `function` | `event.idm.read_only_udm.additional.fields` | Key "function" |
| `host_address_1` | `event.idm.read_only_udm.principal.resource.attribute.labels` | Key "host_address_1" |
| `host_address_2` | `event.idm.read_only_udm.principal.resource.attribute.labels` | Key "host_address_2" |
| `source_module_name` | `event.idm.read_only_udm.additional.fields` | Key "source_module_name" |
| `log_identifier` | `event.idm.read_only_udm.additional.fields` | Key "log_identifier" |
| `ciphersuites` | `event.idm.read_only_udm.additional.fields` | Key "ciphersuites" |