Skip to content

Commit cda458a

Browse files
authored
Merge pull request #204709 from yelevin/yelevin/sentinel-entities
Added entities to schema reference
2 parents ca373da + 1513f31 commit cda458a

File tree

1 file changed

+77
-91
lines changed

1 file changed

+77
-91
lines changed

articles/sentinel/entities-reference.md

Lines changed: 77 additions & 91 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Microsoft Sentinel entity types reference | Microsoft Docs
33
description: This article displays the Microsoft Sentinel entity types and their required identifiers.
44
author: yelevin
55
ms.topic: reference
6-
ms.date: 11/09/2021
6+
ms.date: 07/06/2022
77
ms.author: yelevin
88
ms.custom: ignite-fall-2021
99
---
@@ -41,11 +41,11 @@ For best results - for guaranteed unique identification - you should use identif
4141
| [**Mail cluster**](#mail-cluster) | NetworkMessageIds<br>CountByDeliveryStatus<br>CountByThreatType<br>CountByProtectionStatus<br>Threats<br>Query<br>QueryTime<br>MailCount<br>IsVolumeAnomaly<br>Source<br>ClusterSourceIdentifier<br>ClusterSourceType<br>ClusterQueryStartTime<br>ClusterQueryEndTime<br>ClusterGroup | Query<br>Source | Query + Source |
4242
| [**Mail message**](#mail-message) | Recipient<br>Urls<br>Threats<br>Sender<br>P1Sender<br>P1SenderDisplayName<br>P1SenderDomain<br>SenderIP<br>P2Sender<br>P2SenderDisplayName<br>P2SenderDomain<br>ReceivedDate<br>NetworkMessageId<br>InternetMessageId<br>Subject<br>BodyFingerprintBin1<br>BodyFingerprintBin2<br>BodyFingerprintBin3<br>BodyFingerprintBin4<br>BodyFingerprintBin5<br>AntispamDirection<br>DeliveryAction<br>DeliveryLocation<br>Language<br>ThreatDetectionMethods | NetworkMessageId<br>Recipient | NetworkMessageId + Recipient |
4343
| [**Submission mail**](#submission-mail) | SubmissionId<br>SubmissionDate<br>Submitter<br>NetworkMessageId<br>Timestamp<br>Recipient<br>Sender<br>SenderIp<br>Subject<br>ReportType | SubmissionId<br>NetworkMessageId<br>Recipient<br>Submitter | |
44-
|
44+
| [**Sentinel entities**](#sentinel-entities) | Entities | Entities | |
4545

4646
## Entity type schemas
4747

48-
The following is a more in-depth look at the full schemas of each entity type. You'll notice that many of these schemas include links to other entity types - for example, the User account schema includes a link to the Host entity type, as one attribute of a user account is the host it's defined on. These externally-linked entities can't be used as identifiers for entity mapping, but they are very useful in giving a complete picture of entities on entity pages and the investigation graph.
48+
The following is a more in-depth look at the full schemas of each entity type. You'll notice that many of these schemas include links to other entity types - for example, the User account schema includes a link to the Host entity type, as one attribute of a user account is the host it's defined on. These externally linked entities can't be used as identifiers for entity mapping, but they are very useful in giving a complete picture of entities on entity pages and the investigation graph.
4949

5050
> [!NOTE]
5151
> A question mark following the value in the **Type** column indicates the field is nullable.
@@ -70,7 +70,6 @@ The following is a more in-depth look at the full schemas of each entity type. Y
7070
| IsDomainJoined | Bool? | Determines whether this is a domain account. |
7171
| DisplayName | String | The display name of the account. |
7272
| ObjectGuid | Guid? | The objectGUID attribute is a single-value attribute that is the unique identifier for the object, assigned by Active Directory. |
73-
|
7473

7574
Strong identifiers of an account entity:
7675

@@ -104,7 +103,6 @@ Weak identifiers of an account entity:
104103
| OSFamily | Enum? | One of the following values: <li>Linux<li>Windows<li>Android<li>IOS |
105104
| OSVersion | String | A free-text representation of the operating system.<br>This field is meant to hold specific versions the are more fine-grained than OSFamily, or future values not supported by OSFamily enumeration. |
106105
| IsDomainJoined | Bool | Determines whether this host belongs to a domain. |
107-
|
108106

109107
Strong identifiers of a host entity:
110108
- HostName + NTDomain
@@ -128,7 +126,6 @@ Weak identifiers of a host entity:
128126
| Type | String | ‘ip’ |
129127
| Address | String | The IP address as string, e.g. 127.0.0.1 (either in IPv4 or IPv6). |
130128
| Location | GeoLocation | The geo-location context attached to the IP entity. <br><br>For more information, see also [Enrich entities in Microsoft Sentinel with geolocation data via REST API (Public preview)](geolocation-data-api.md). |
131-
|
132129

133130
Strong identifiers of an IP entity:
134131
- Address
@@ -142,7 +139,6 @@ Strong identifiers of an IP entity:
142139
| Category | String | The malware category by the vendor, e.g. Trojan. |
143140
| Files | List\<Entity> | List of linked file entities on which the malware was found. Can contain the File entities inline or as reference.<br>See the File entity for additional details on structure. |
144141
| Processes | List\<Entity> | List of linked process entities on which the malware was found. This would often be used when the alert triggered on fileless activity.<br>See the [Process](#process) entity for additional details on structure. |
145-
|
146142

147143
Strong identifiers of a malware entity:
148144

@@ -157,7 +153,6 @@ Strong identifiers of a malware entity:
157153
| Name | String | The file name without the path (some alerts might not include path). |
158154
| Host | Entity | The host on which the file was stored. |
159155
| FileHashes | List&lt;Entity&gt; | The file hashes associated with this file. |
160-
|
161156

162157
Strong identifiers of a file entity:
163158
- Name + Directory
@@ -178,7 +173,6 @@ Strong identifiers of a file entity:
178173
| ParentProcess | Entity (Process) | The parent process entity. <br>Can contain partial data, i.e. only the PID. |
179174
| Host | Entity | The host on which the process was running. |
180175
| LogonSession | Entity (HostLogonSession) | The session in which the process was running. |
181-
|
182176

183177
Strong identifiers of a process entity:
184178

@@ -202,7 +196,6 @@ Weak identifiers of a process entity:
202196
| AppId | Int | The technical identifier of the application. This should be one of the values defined in the list of [cloud application identifiers](#cloud-application-identifiers). The value for AppId field is optional. |
203197
| Name | String | The name of the related cloud application. The value of application name is optional. |
204198
| InstanceName | String | The user-defined instance name of the cloud application. It is often used to distinguish between several applications of the same type that a customer has. |
205-
|
206199

207200
Strong identifiers of a cloud application entity:
208201
- AppId (without InstanceName)
@@ -221,7 +214,6 @@ Strong identifiers of a cloud application entity:
221214
| IpAddress | List&lt;Entity (IP)&gt; | Entities corresponding to the resolved IP addresses. |
222215
| DnsServerIp | Entity (IP) | An entity representing the DNS server resolving the request. |
223216
| HostIpAddress | Entity (IP) | An entity representing the DNS request client. |
224-
|
225217

226218
Strong identifiers of a DNS entity:
227219
- DomainName + DnsServerIp + HostIpAddress
@@ -239,7 +231,6 @@ Weak identifiers of a DNS entity:
239231
| TryGetResourceGroup | Bool | The resource group value if it exists. |
240232
| TryGetProvider | Bool | The provider value if it exists. |
241233
| TryGetName | Bool | The name value if it exists. |
242-
|
243234

244235
Strong identifiers of an Azure resource entity:
245236
- ResourceId
@@ -253,7 +244,6 @@ Strong identifiers of an Azure resource entity:
253244
| Type | String | 'filehash' |
254245
| Algorithm | Enum | The hash algorithm type. Possible values:<li>Unknown<li>MD5<li>SHA1<li>SHA256<li>SHA256AC |
255246
| Value | String | The hash value. |
256-
|
257247

258248
Strong identifiers of a file hash entity:
259249
- Algorithm + Value
@@ -267,7 +257,6 @@ Strong identifiers of a file hash entity:
267257
| Type | String | ‘registry-key’ |
268258
| Hive | Enum? | One of the following values:<li>HKEY_LOCAL_MACHINE<li>HKEY_CLASSES_ROOT<li>HKEY_CURRENT_CONFIG<li>HKEY_USERS<li>HKEY_CURRENT_USER_LOCAL_SETTINGS<li>HKEY_PERFORMANCE_DATA<li>HKEY_PERFORMANCE_NLSTEXT<li>HKEY_PERFORMANCE_TEXT<li>HKEY_A<li>HKEY_CURRENT_USER |
269259
| Key | String | The registry key path. |
270-
|
271260

272261
Strong identifiers of a registry key entity:
273262
- Hive + Key
@@ -283,7 +272,6 @@ Strong identifiers of a registry key entity:
283272
| Name | String | The registry value name. |
284273
| Value | String | String-formatted representation of the value data. |
285274
| ValueType | Enum? | One of the following values:<li>String<li>Binary<li>DWord<li>Qword<li>MultiString<li>ExpandString<li>None<li>Unknown<br>Values should conform to Microsoft.Win32.RegistryValueKind enumeration. |
286-
|
287275

288276
Strong identifiers of a registry value entity:
289277
- Key + Name
@@ -301,7 +289,6 @@ Weak identifiers of a registry value entity:
301289
| DistinguishedName | String | The group distinguished name. |
302290
| SID | String | The SID attribute is a single-value attribute that specifies the security identifier (SID) of the group. |
303291
| ObjectGuid | Guid? | The objectGUID attribute is a single-value attribute that is the unique identifier for the object, assigned by Active Directory. |
304-
|
305292

306293
Strong identifiers of a security group entity:
307294
- DistinguishedName
@@ -314,7 +301,6 @@ Strong identifiers of a security group entity:
314301
| ----- | ---- | ----------- |
315302
| Type | String | 'url' |
316303
| Url | Uri | A full URL the entity points to. |
317-
|
318304

319305
Strong identifiers of a URL entity:
320306
- Url (when an absolute URL)
@@ -343,7 +329,6 @@ Weak identifiers of a URL entity:
343329
| MacAddress | String | The MAC address of the device. |
344330
| Protocols | List&lt;String&gt; | A list of protocols that the device supports. |
345331
| SerialNumber | String | The serial number of the device. |
346-
|
347332

348333
Strong identifiers of an IoT device entity:
349334
- IoTHub + DeviceId
@@ -361,7 +346,6 @@ Weak identifiers of an IoT device entity:
361346
| Upn | String | The mailbox's UPN. |
362347
| RiskLevel | Enum? | The risk level of this mailbox. Possible values:<li>None<li>Low<li>Medium<li>High |
363348
| ExternalDirectoryObjectId | Guid? | The AzureAD identifier of mailbox. Similar to AadUserId in the Account entity, but this property is specific to mailbox object on the Office side. |
364-
|
365349

366350
Strong identifiers of a mailbox entity:
367351
- MailboxPrimaryAddress
@@ -391,7 +375,6 @@ Strong identifiers of a mailbox entity:
391375
| ClusterQueryStartTime | DateTime? | Cluster start time - used as start time for cluster counts query. Usually dates to the End time minus DaysToLookBack setting from Microsoft Defender for Office 365 (see note above). |
392376
| ClusterQueryEndTime | DateTime? | Cluster end time - used as end time for cluster counts query. Usually the mail data's received time. |
393377
| ClusterGroup | String | Corresponds to the Kusto query key used on Microsoft Defender for Office 365 (see note above). |
394-
|
395378

396379
Strong identifiers of a mail cluster entity:
397380
- Query + Source
@@ -425,7 +408,6 @@ Strong identifiers of a mail cluster entity:
425408
| DeliveryLocation | Enum? | The delivery location of this mail message. Possible values:<li>Unknown<li>Inbox<li>JunkFolder<li>DeletedFolder<li>Quarantine<li>External<li>Failed<li>Dropped<li>Forwarded |
426409
| Language | String | The language in which the contents of the mail are written. |
427410
| ThreatDetectionMethods | IList&lt;String&gt; | The list of Threat Detection Methods applied on this mail. |
428-
|
429411

430412
Strong identifiers of a mail message entity:
431413
- NetworkMessageId + Recipient
@@ -447,84 +429,88 @@ Strong identifiers of a mail message entity:
447429
| SenderIp | String | The sender's IP. |
448430
| Subject | String | The subject of submission mail. |
449431
| ReportType | String | The submission type for the given instance. This maps to Junk, Phish, Malware or NotJunk. |
450-
|
451432

452433
Strong identifiers of a SubmissionMail entity:
453434
- SubmissionId, Submitter, NetworkMessageId, Recipient
454435

436+
## Sentinel entities
437+
438+
| Field | Type | Description |
439+
| ----- | ---- | ----------- |
440+
| Entities | String | A list of the entities identified in the alert. This list is the **entities** column from the SecurityAlert schema ([see documentation](security-alert-schema.md)). |
441+
455442
## Cloud application identifiers
456443

457444
The following list defines identifiers for known cloud applications. The App ID value is used as a [cloud application](#cloud-application) entity identifier.
458445

459-
|App ID|Name|
460-
|------|----|
461-
|10026|DocuSign|
462-
|10395|Anaplan|
463-
|10489|Box|
464-
|10549|Cisco Webex|
465-
|10618|Atlassian|
466-
|10915|Cornerstone OnDemand|
467-
|10921|Zendesk|
468-
|10980|Okta|
469-
|11042|Jive Software|
470-
|11114|Salesforce|
471-
|11161|Office 365|
472-
|11162|Microsoft OneNote Online|
473-
|11394|Microsoft Online Services|
474-
|11522|Yammer|
475-
|11599|Amazon Web Services|
476-
|11627|Dropbox|
477-
|11713|Expensify|
478-
|11770|G Suite|
479-
|12005|SuccessFactors|
480-
|12260|Microsoft Azure|
481-
|12275|Workday|
482-
|13843|LivePerson|
483-
|13979|Concur|
484-
|14509|ServiceNow|
485-
|15570|Tableau|
486-
|15600|Microsoft OneDrive for Business|
487-
|15782|Citrix ShareFile|
488-
|17152|Amazon|
489-
|17865|Ariba Inc|
490-
|18432|Zscaler|
491-
|19688|Xactly|
492-
|20595|Microsoft Defender for Cloud Apps|
493-
|20892|Microsoft SharePoint Online|
494-
|20893|Microsoft Exchange Online|
495-
|20940|Active Directory|
496-
|20941|Adallom CPanel|
497-
|22110|Google Cloud Platform|
498-
|22930|Gmail|
499-
|23004|Autodesk Fusion Lifecycle|
500-
|23043|Slack|
501-
|23233|Microsoft Office Online|
502-
|25275|Microsoft Skype for Business|
503-
|25988|Google Docs|
504-
|26055|Microsoft Office 365 admin center|
505-
|26060|OPSWAT Gears|
506-
|26061|Microsoft Word Online|
507-
|26062|Microsoft PowerPoint Online|
508-
|26063|Microsoft Excel Online|
509-
|26069|Google Drive|
510-
|26206|Workiva|
511-
|26311|Microsoft Dynamics|
512-
|26318|Microsoft Azure AD|
513-
|26320|Microsoft Office Sway|
514-
|26321|Microsoft Delve|
515-
|26324|Microsoft Power BI|
516-
|27548|Microsoft Forms|
517-
|27592|Microsoft Flow|
518-
|27593|Microsoft PowerApps|
519-
|28353|Workplace by Facebook|
520-
|28373|CAS Proxy Emulator|
521-
|28375|Microsoft Teams|
522-
|32780|Microsoft Dynamics 365|
523-
|33626|Google|
524-
|34127|Microsoft AppSource|
525-
|34667|HighQ|
526-
|35395|Microsoft Dynamics Talent|
527-
|
446+
| App ID | Name |
447+
| ------ | --------------------------------- |
448+
| 10026 | DocuSign |
449+
| 10395 | Anaplan |
450+
| 10489 | Box |
451+
| 10549 | Cisco Webex |
452+
| 10618 | Atlassian |
453+
| 10915 | Cornerstone OnDemand |
454+
| 10921 | Zendesk |
455+
| 10980 | Okta |
456+
| 11042 | Jive Software |
457+
| 11114 | Salesforce |
458+
| 11161 | Office 365 |
459+
| 11162 | Microsoft OneNote Online |
460+
| 11394 | Microsoft Online Services |
461+
| 11522 | Yammer |
462+
| 11599 | Amazon Web Services |
463+
| 11627 | Dropbox |
464+
| 11713 | Expensify |
465+
| 11770 | G Suite |
466+
| 12005 | SuccessFactors |
467+
| 12260 | Microsoft Azure |
468+
| 12275 | Workday |
469+
| 13843 | LivePerson |
470+
| 13979 | Concur |
471+
| 14509 | ServiceNow |
472+
| 15570 | Tableau |
473+
| 15600 | Microsoft OneDrive for Business |
474+
| 15782 | Citrix ShareFile |
475+
| 17152 | Amazon |
476+
| 17865 | Ariba Inc |
477+
| 18432 | Zscaler |
478+
| 19688 | Xactly |
479+
| 20595 | Microsoft Defender for Cloud Apps |
480+
| 20892 | Microsoft SharePoint Online |
481+
| 20893 | Microsoft Exchange Online |
482+
| 20940 | Active Directory |
483+
| 20941 | Adallom CPanel |
484+
| 22110 | Google Cloud Platform |
485+
| 22930 | Gmail |
486+
| 23004 | Autodesk Fusion Lifecycle |
487+
| 23043 | Slack |
488+
| 23233 | Microsoft Office Online |
489+
| 25275 | Microsoft Skype for Business |
490+
| 25988 | Google Docs |
491+
| 26055 | Microsoft 365 admin center |
492+
| 26060 | OPSWAT Gears |
493+
| 26061 | Microsoft Word Online |
494+
| 26062 | Microsoft PowerPoint Online |
495+
| 26063 | Microsoft Excel Online |
496+
| 26069 | Google Drive |
497+
| 26206 | Workiva |
498+
| 26311 | Microsoft Dynamics |
499+
| 26318 | Microsoft Azure AD |
500+
| 26320 | Microsoft Office Sway |
501+
| 26321 | Microsoft Delve |
502+
| 26324 | Microsoft Power BI |
503+
| 27548 | Microsoft Forms |
504+
| 27592 | Microsoft Flow |
505+
| 27593 | Microsoft PowerApps |
506+
| 28353 | Workplace by Facebook |
507+
| 28373 | CAS Proxy Emulator |
508+
| 28375 | Microsoft Teams |
509+
| 32780 | Microsoft Dynamics 365 |
510+
| 33626 | Google |
511+
| 34127 | Microsoft AppSource |
512+
| 34667 | HighQ |
513+
| 35395 | Microsoft Dynamics Talent |
528514

529515
## Next steps
530516

0 commit comments

Comments
 (0)