Skip to content

Commit 97b71f3

Browse files
authored
[Logs] Update Log fields to add Email Security Alerts dataset (#18611)
1 parent f04aae9 commit 97b71f3

File tree

1 file changed

+172
-0
lines changed

1 file changed

+172
-0
lines changed
Lines changed: 172 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,172 @@
1+
---
2+
# Code generator. DO NOT EDIT.
3+
4+
title: Email Security Alerts
5+
pcx_content_type: configuration
6+
sidebar:
7+
order: 21
8+
---
9+
10+
The descriptions below detail the fields available for `email_security_alerts`.
11+
12+
## AlertID
13+
14+
Type: `string`
15+
16+
The canonical ID for an Email Security Alert (for example, '4WtWkr6nlBz9sNH-2024-08-28T15:32:35').
17+
18+
## AlertReasons
19+
20+
Type: `array[string]`
21+
22+
Human-readable list of findings which contributed to this message's final disposition.
23+
24+
## Attachments
25+
26+
Type: `array[object]`
27+
28+
List of objects containing metadata of attachments contained in this message (for example, [{"Md5": "91f073bd208689ddbd248e8989ecae90", "Sha1": "62b77e14e2c43049c45b5725018e78d0f9986930", "Sha256": "3b57505305e7162141fd898ed87d08f92fc42579b5047495859e56b3275a6c06", "Ssdeep": "McAQ8tPlH25e85Q2OiYpD08NvHmjJ97UfPMO47sekO:uN9M553OiiN/OJ9MM+e3", "Name": "attachment.gif", "ContentTypeProvided": "image/gif", "ContentTypeComputed": "application/x-msi", "Encrypted": true, "Decrypted": true]}, ...]).
29+
30+
## CC
31+
32+
Type: `array[string]`
33+
34+
Email address portions of the CC header provided by the sender (for example, '[email protected]').
35+
36+
## CCName
37+
38+
Type: `array[string]`
39+
40+
Email address portions of the CC header provided by the sender (for example, 'First Last').
41+
42+
## FinalDisposition
43+
44+
Type: `string`
45+
46+
Final disposition attributed to the message. <br />Possible values are <em>unset</em> \| <em>malicious</em> \| <em>suspicious</em> \| <em>spoof</em> \| <em>spam</em> \| <em>bulk</em>.
47+
48+
## From
49+
50+
Type: `string`
51+
52+
Email address portion of the From header provided by the sender (for example, '[email protected]').
53+
54+
## FromName
55+
56+
Type: `string`
57+
58+
Name portion of the From header provided by the sender (for example, 'First Last').
59+
60+
## Links
61+
62+
Type: `array[string]`
63+
64+
List of links detected in this message, benign or otherwise; limited to 100 in total.
65+
66+
## MessageDeliveryMode
67+
68+
Type: `string`
69+
70+
The message's mode of transport to Email Security. <br />Possible values are <em>unset</em> \| <em>api</em> \| <em>direct</em> \| <em>bcc</em> \| <em>journal</em> \| <em>retroScan</em>.
71+
72+
## MessageID
73+
74+
Type: `string`
75+
76+
Value of the Message-ID header provided by the sender.
77+
78+
## Origin
79+
80+
Type: `string`
81+
82+
The origin of the message. <br />Possible values are <em>unset</em> \| <em>internal</em> \| <em>external</em> \| <em>secondPartyInternal</em> \| <em>thirdPartyInternal</em> \| <em>outbound</em>.
83+
84+
## OriginalSender
85+
86+
Type: `string`
87+
88+
The original sender address as determined by Email Security mail processing (for example, '[email protected]').
89+
90+
## ReplyTo
91+
92+
Type: `string`
93+
94+
Email address portion of the Reply-To header provided by the sender (for example, '[email protected]').
95+
96+
## ReplyToName
97+
98+
Type: `string`
99+
100+
Name portion of the Reply-To header provided by the sender (for example, 'First Last').
101+
102+
## SMTPEnvelopeFrom
103+
104+
Type: `string`
105+
106+
Value of the SMTP MAIL FROM command provided by the sender (for example, 'First Last <[email protected]>').
107+
108+
## SMTPEnvelopeTo
109+
110+
Type: `array[string]`
111+
112+
Values of the SMTP RCPT TO command provided by the sender (for example, 'First Last <[email protected]>').
113+
114+
## SMTPHeloServerIP
115+
116+
Type: `string`
117+
118+
IPv4/v6 of the SMTP HELO server.
119+
120+
## SMTPHeloServerIPAsName
121+
122+
Type: `string`
123+
124+
Autonomous System Name of the SMTP HELO server's IP.
125+
126+
## SMTPHeloServerIPAsNumber
127+
128+
Type: `string`
129+
130+
Autonomous System Number of the SMTP HELO server's IP.
131+
132+
## SMTPHeloServerIPGeo
133+
134+
Type: `string`
135+
136+
SMTP HELO server geolocation info (for example, 'US/NV/Las Vegas').
137+
138+
## SMTPHeloServerName
139+
140+
Type: `string`
141+
142+
Hostname provided by the SMTP HELO server.
143+
144+
## Subject
145+
146+
Type: `string`
147+
148+
Value of the Subject header provided by the sender.
149+
150+
## ThreatCategories
151+
152+
Type: `array[string]`
153+
154+
Threat categories attributed by Email Security processing (for example, 'CredentialHarvester', 'Dropper').
155+
156+
## Timestamp
157+
158+
Type: `int or string`
159+
160+
Start time of message processing (for example, '2024-08-28T15:32:35Z'). To specify the timestamp format, refer to [Output types](/logs/reference/log-output-options/#output-types).
161+
162+
## To
163+
164+
Type: `array[string]`
165+
166+
Email address portions of the To header provided by the sender (for example, '[email protected]').
167+
168+
## ToName
169+
170+
Type: `array[string]`
171+
172+
Name portions of the To header provided by the sender (for example, 'First Last').

0 commit comments

Comments
 (0)