Skip to content

Commit f3e4869

Browse files
authored
[Logpush] Document new gateway HTTP and L4 fields (#17454)
1 parent ab965e7 commit f3e4869

File tree

2 files changed

+189
-3
lines changed

2 files changed

+189
-3
lines changed

src/content/docs/logs/reference/log-fields/account/gateway_http.mdx

Lines changed: 127 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,18 @@ Type: string
2020

2121
Action performed by gateway on the HTTP request.
2222

23+
## ApplicationIDs
24+
25+
Type: array\[int]
26+
27+
IDs of the applications that matched the HTTP request parameters.
28+
29+
## ApplicationNames
30+
31+
Type: array\[string]
32+
33+
Names of the applications that matched the HTTP request parameters.
34+
2335
## BlockedFileHash
2436

2537
Type: string
@@ -50,6 +62,18 @@ Type: string
5062

5163
File type blocked in the response eg. exe, bin, if any.
5264

65+
## CategoryIDs
66+
67+
Type: array\[int]
68+
69+
IDs of the categories that matched the HTTP request parameters.
70+
71+
## CategoryNames
72+
73+
Type: array\[string]
74+
75+
Names of the categories that matched the HTTP request parameters.
76+
5377
## Datetime
5478

5579
Type: int or string
@@ -62,6 +86,18 @@ Type: string
6286

6387
Destination ip of the request.
6488

89+
## DestinationIPContinentCode
90+
91+
Type: string
92+
93+
Continent code of the destination IP of the HTTP request (for example, 'NA').
94+
95+
## DestinationIPCountryCode
96+
97+
Type: string
98+
99+
Country code of the destination IP of the HTTP request (for example, 'US').
100+
65101
## DestinationPort
66102

67103
Type: string
@@ -108,7 +144,55 @@ Email used to authenticate the client.
108144

109145
Type: object
110146

111-
Information about files detected within the HTTP request.
147+
Information about files detected within the HTTP request. The following data is available for each file.
148+
149+
### action
150+
151+
Type: string
152+
153+
Action taken. Possible values are <em>none</em>, <em>allow</em> and <em>block</em>.
154+
155+
### content_type
156+
157+
Type: string
158+
159+
The file's content type (as read from headers), if applicable.
160+
161+
### direction
162+
163+
Type: string
164+
165+
Possible values are <em>upload</em> and <em>download</em>.
166+
167+
### file_name
168+
169+
Type: string
170+
171+
The file's name, if known.
172+
173+
### file_hash
174+
175+
Type: string
176+
177+
The file's sha256 hash as a hex string, if known.
178+
179+
### file_size
180+
181+
Type: int
182+
183+
The file's size, in bytes.
184+
185+
### file_type
186+
187+
Type: string
188+
189+
The file's type (as detected by signatures), if known.
190+
191+
## ForensicCopyStatus
192+
193+
Type: string
194+
195+
Status of any associated forensic copies that may have been captured during the request.
112196

113197
## HTTPHost
114198

@@ -152,6 +236,24 @@ Type: string
152236

153237
The name of the gateway policy applied to the request, if any.
154238

239+
## PrivateAppAUD
240+
241+
Type: string
242+
243+
The private app AUD, if any.
244+
245+
## ProxyEndpoint
246+
247+
Type: string
248+
249+
The proxy endpoint used on the HTTP request, if any.
250+
251+
## Quarantined
252+
253+
Type: bool
254+
255+
If the request content was quarantined.
256+
155257
## Referer
156258

157259
Type: string
@@ -176,6 +278,18 @@ Type: string
176278

177279
Source ip of the request.
178280

281+
## SourceIPContinentCode
282+
283+
Type: string
284+
285+
Continent code of the source IP of the request (for example, 'NA').
286+
287+
## SourceIPCountryCode
288+
289+
Type: string
290+
291+
Country code of the source IP of the request (for example, 'US').
292+
179293
## SourceInternalIP
180294

181295
Type: string
@@ -229,3 +343,15 @@ Contents of the user agent header in the HTTP request.
229343
Type: string
230344

231345
User identity where the HTTP request originated from.
346+
347+
## VirtualNetworkID
348+
349+
Type: string
350+
351+
The identifier of the virtual network the device was connected to, if any.
352+
353+
## VirtualNetworkName
354+
355+
Type: string
356+
357+
The name of the virtual network the device was connected to, if any.

src/content/docs/logs/reference/log-fields/account/gateway_network.mdx

Lines changed: 62 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,18 @@ Type: string
2020

2121
Action performed by gateway on the session.
2222

23+
## ApplicationIDs
24+
25+
Type: array\[int]
26+
27+
IDs of the applications that matched the session parameters.
28+
29+
## ApplicationNames
30+
31+
Type: array\[string]
32+
33+
Names of the applications that matched the session parameters.
34+
2335
## Datetime
2436

2537
Type: int or string
@@ -32,6 +44,18 @@ Type: string
3244

3345
Destination IP of the network session.
3446

47+
## DestinationIPContinentCode
48+
49+
Type: string
50+
51+
Continent code of the destination IP of the network session (for example, 'NA').
52+
53+
## DestinationIPCountryCode
54+
55+
Type: string
56+
57+
Country code of the destination IP of the network session (for example, 'US').
58+
3559
## DestinationPort
3660

3761
Type: int
@@ -86,6 +110,12 @@ Type: string
86110

87111
The name of the gateway policy applied to the request, if any.
88112

113+
## ProxyEndpoint
114+
115+
Type: string
116+
117+
The proxy endpoint used on this network session, if any.
118+
89119
## SNI
90120

91121
Type: string
@@ -104,6 +134,18 @@ Type: string
104134

105135
Source IP of the network session.
106136

137+
## SourceIPContinentCode
138+
139+
Type: string
140+
141+
Continent code of the source IP of the network session (for example, 'NA').
142+
143+
## SourceIPCountryCode
144+
145+
Type: string
146+
147+
Country code of the source IP of the network session (for example, 'US').
148+
107149
## SourceInternalIP
108150

109151
Type: string
@@ -116,14 +158,32 @@ Type: int
116158

117159
Source port of the network session.
118160

119-
## Transport
161+
## Transport (deprecated)
120162

121163
Type: string
122164

123-
Transport protocol used for this session. <br />Possible values are <em>tcp</em> | <em>quic</em> | <em>udp</em>.
165+
Transport protocol used for this session. <br />Possible values are <em>tcp</em> \| <em>quic</em> \| <em>udp</em>. Deprecated, please use TransportProtocol instead.
166+
167+
## TransportProtocol
168+
169+
Type: string
170+
171+
Transport protocol used for this session. <br />Possible values are <em>tcp</em> \| <em>quic</em> \| <em>udp</em>.
124172

125173
## UserID
126174

127175
Type: string
128176

129177
User identity where the network session originated from.
178+
179+
## VirtualNetworkID
180+
181+
Type: string
182+
183+
The identifier of the virtual network the device was connected to, if any.
184+
185+
## VirtualNetworkName
186+
187+
Type: string
188+
189+
The name of the virtual network the device was connected to, if any.

0 commit comments

Comments
 (0)