Client-Connected Log Event JSON Format

Abstract

This document describes the JSON log event fields of the Log Streaming Client-Connected log event and provides an example.

The client-connected log event is generated when an OpenVPN client (including Connectors) connects to CloudConnexa.

The log event JSON contains the Header fields and a log JSON object. The fields in the log JSON object for when the eventName in the Header is set to client-connected are described in the table below. For more information on the Header, refer to Log Event Header Fields.

Table 5. JSON fields present in the log object for the client-connected log event

Field Name	Type	Description
clientUUID	String	The unique hardware UUID of the connected device.
clientSessionId	String	A unique identifier assigned to the connection. Can be used to correlate other session events.
clientOsType	String	The client's operating system.
clientOsVersion	String	The version of the client's operating system.
clientPublicIp	String	The client's public IP address.
clientTunnelIpV4	String	The IPv4 address of the client's OpenVPN tunnel.
clientTunnelIpV6	String	The IPv6 address of the client's OpenVPN tunnel.
sessionProtocol	String	The protocol used for the OpenVPN tunnel.
sessionTunnelProtocol	String	The type of tunneling protocol used.
sessionStartTime	DateTime	The timestamp of when the connection started.
gatewayRegionName	String	The name of the CloudConnexa Region that the client connected to.
gatewayRegion	String	The identifier of the CloudConnexa Region that the client connected to.
gatewayId	String	The identifier of the specific gateway in the Region the client is connected to.

Example of a Client-Connected Log Event

{
  "CloudConnexaLogVersion": 1,
  "timestamp": "2024-05-24T08:53:11.000000Z",
  "cloudId": "yuriidoroshkotest",
  "service": "CloudConnexa",
  "traceId": "ba7b71a2-c888-44c0-82d6-366a6f7c3ca1",
  "publicIp": "2a02:2378:11c4:ee42:6092:782:5f1f:997c",
  "initiator": "97bb7a07-7d15-4070-8239-7b610c131127",
  "initiatorType": "Device",
  "initiatorName": "device_1knjnknjk",
  "parentEntity": "long_user-name-1231232432545435665hhh3545435465465656hhhhh@yuriidoroshkotest",
  "parentEntityType": "User",
  "parentEntityName": "long_user-name-1231232432545435665hhh3545435465465656hhhhh",
  "category": "Security.Logins",
  "eventName": "client-connected",
  "log": {
    "clientUUID": "21a84507609d7a76",
    "clientOsType": "Android",
    "clientOsVersion": "14",
    "sessionProtocol": "OpenVPN / UDP",
    "clientPublicIp": "2a02:2378:11c4:ee42:6092:782:5f1f:997c",
    "sessionStartTime": "2024-05-24T08:53:11.000000Z",
    "clientTunnelIpV4": "100.96.1.163",
    "clientTunnelIpV6": "fd:0:0:810a::3",
    "clientSessionId": "6650558f1df239dff4ae2d54",
    "gatewayRegionName": "Chicago (IL)",
    "gatewayRegion": "us-central-1",
    "gatewayId": "us-ord-dc1-g1"
  }
}

In this section:

Client-Connected Log Event JSON Format

Search results