Skip to content

Commit 842dc78

Browse files
author
Derrick Lee
committed
Address blocking issues
1 parent c3d9a9f commit 842dc78

2 files changed

Lines changed: 16 additions & 16 deletions

File tree

articles/sentinel/normalization-develop-parsers.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -262,7 +262,7 @@ Microsoft Sentinel provides handy functions for common lookup values. For exampl
262262
| invoke _ASIM_ResolveDnsResponseCode('DnsResponseCode')
263263
```
264264

265-
The first option accepts as a parameter the value to lookup and let you choose the output field and therefore useful as a general lookup function. The second option is more geared towards parsers, takes as input the name of the source field, and updates the needed ASIM field, in this case `DnsResponseCodeName`.
265+
The first option accepts as a parameter the value to look up and let you choose the output field and therefore useful as a general lookup function. The second option is more geared towards parsers, takes as input the name of the source field, and updates the needed ASIM field, in this case `DnsResponseCodeName`.
266266

267267
For a full list of ASIM help functions, refer to [ASIM functions](normalization-functions.md)
268268

@@ -327,7 +327,7 @@ For example, when parsing a custom log table, use the following to remove the re
327327
>[!IMPORTANT]
328328
> The different variants represent *different* event types, commonly mapped to different schemas, develop separate parsers
329329

330-
In many cases, events in an event stream include variants that require different parsing logic. To parse different variants in a single parser either use conditional statements such as `iff` and `case`, or use a union structure.
330+
In many cases, events in an eventstream include variants that require different parsing logic. To parse different variants in a single parser either use conditional statements such as `iff` and `case`, or use a union structure.
331331

332332
To use `union` to handle multiple variants, create a separate function for each variant and use the union statement to combine the results:
333333

@@ -430,7 +430,7 @@ To make sure that your parser produces valid values, use the ASIM data tester by
430430
<parser name> | limit <X> | invoke ASimDataTester ('<schema>')
431431
```
432432

433-
Specifying a schema is optional. If a schema is not specified, the `EventSchema` field is used to identify the schema the event should adhere to. Ig an event does not include an `EventSchema` field, only common fields will be verified. If a schema is specified as a parameter, this schema will be used to test all records. This is useful for older parsers that do not set the `EventSchema` field.
433+
Specifying a schema is optional. If a schema is not specified, the `EventSchema` field is used to identify the schema the event should adhere to. If an event does not include an `EventSchema` field, only common fields will be verified. If a schema is specified as a parameter, this schema will be used to test all records. This is useful for older parsers that do not set the `EventSchema` field.
434434

435435
> [!NOTE]
436436
> Even when a schema is not specified, empty parentheses are needed after the function name.

articles/sentinel/normalization-schema-asset.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.author: derricklee
1212

1313
---
1414

15-
# The Advanced Security Information Model (ASIM) Asset Entity Schema Reference
15+
# The Advanced Security Information Model (ASIM) asset entity schema reference
1616

1717
The Microsoft Sentinel Asset Entity Schema is designed to normalize assets from various products into a standardized format within Microsoft Advanced Security Information Model (ASIM). This schema focuses exclusively on assets in non-Microsoft data sources, ensuring consistent and efficient analysis.
1818

@@ -28,20 +28,20 @@ For more information about normalization in Microsoft Sentinel, see [Normalizati
2828

2929
For more information about ASIM parsers, see the [ASIM parsers overview](normalization-parsers-overview.md).
3030

31-
### Unifying Parsers
31+
### Unifying parsers
3232

3333
To use parsers that unify all ASIM out-of-the-box parsers and ensure that your analysis runs across all the configured sources, use the `_Im_AssetEntity` parser.
3434

3535

36-
### Add Your Own Normalized Parsers
36+
### Add your own normalized parsers
3737

3838
When [developing custom parsers](normalization-develop-parsers.md) for the Asset Entity schema, name your KQL functions using the following syntax:
3939
- `vimAssetEntity<vendor><Product>` for parameterized parsers
4040
- `ASimAssetEntity<vendor><Product>` for regular parsers
4141

4242
Refer to the article [Managing ASIM parsers](normalization-manage-parsers.md) to learn how to add your custom parsers to the unifying parsers.
4343

44-
### Filtering Parser Parameters
44+
### Filtering parser parameters
4545

4646
The Asset Entity parsers support various [filtering parameters](normalization-about-parsers.md#optimizing-parsing-using-parameters) to improve query performance. These parameters are optional but can enhance your query performance. The following filtering parameters are available:
4747

@@ -56,7 +56,7 @@ The Asset Entity parsers support various [filtering parameters](normalization-ab
5656
| **assetowner_has_any** | dynamic | Filter only assets for which the **'AssetOwner'** or **'AdditionalAssetOwners'** field is in one of the listed values. |
5757
| **entitysource_has_any** | dynamic | Filter only assets for which the **'EntitySource'** field is in one of the listed values. |
5858

59-
## Schema Details
59+
## Schema details
6060

6161
### <a id="common-entity-fields">Common ASIM Entity Fields</a>
6262

@@ -82,7 +82,7 @@ The following list mentions fields that have specific guidelines for Asset entit
8282
| **EntitySchema** | Mandatory | Enumerated | The schema used for the entity. The schema documented here is `Asset`. |
8383
| **EntitySchemaVersion** | Mandatory | SchemaVersion (String) | The version of the schema. The version of the schema documented here is `0.1.0`. |
8484

85-
### <a id="asset-owner-fields">Asset Owner Fields</a>
85+
### <a id="asset-owner-fields">Asset owner fields</a>
8686

8787
This section defines information about the asset owner. If your asset has multiple owners, populate both fields `AssetOwnerId` and `AdditionalAssetOwners`. `AdditionalAssetOwners` should be an array of strings and the strings must be in the same format as `AssetOwnerId`.
8888

@@ -95,7 +95,7 @@ This section defines information about the asset owner. If your asset has multip
9595
| **AssetOwnerScopeId** | Optional | string | The identifier of the scope to which the asset owner belongs. |
9696
| **AdditionalAssetOwners** | Optional | dynamic | A dynamic collection of additional owners or co-owners associated with the asset. This must be an **array of strings**. |
9797

98-
### <a id="asset-metadata-fields">Asset Metadata Fields</a>
98+
### <a id="asset-metadata-fields">Asset metadata fields</a>
9999

100100
| Field | Class | Type | Description |
101101
|-------|-------|------|-------------|
@@ -104,7 +104,7 @@ This section defines information about the asset owner. If your asset has multip
104104
| **IdentityDirectoryId** | Mandatory | string | The identifier of the identity directory associated with the entity. |
105105
| **AdditionalFields** | Optional | dynamic | Additional information about the entity that is not captured by other fields in the schema. |
106106

107-
### <a id="asset-type-fields">Asset Type Fields</a>
107+
### <a id="asset-type-fields">Asset type fields</a>
108108

109109
This section defines information about the asset type. The current types supported are [`File`](#file-fields) and [`Site`](#site-fields). The asset's type's additional properties should be populated.
110110

@@ -113,7 +113,7 @@ This section defines information about the asset type. The current types support
113113
| **AssetType** | Mandatory | string | The high-level type of the asset. The allowed and supported values are: `File`, `Site`. |
114114
| **AssetOriginalType** | Recommended | string | The original name of the high-level type of the asset at the source. |
115115

116-
### <a id="asset-security-fields">Asset Security Fields</a>
116+
### <a id="asset-security-fields">Asset security fields</a>
117117

118118
This section captures the asset's security posture and exposure context, including source permissions, sensitivity and data-classification details, DLP protection status, related threat indicators, and the last classification scan time. It also includes internal and external user access counts to help assess potential exposure.
119119

@@ -129,7 +129,7 @@ This section captures the asset's security posture and exposure context, includi
129129
| **InternalUsersCount** | Optional | int | The number of internal users associated with or having access to the asset. |
130130
| **ExternalUsersCount** | Optional | int | The number of external users associated with or having access to the asset. |
131131

132-
### <a id="asset-risk-fields">Asset Risk Fields</a>
132+
### <a id="asset-risk-fields">Asset risk fields</a>
133133

134134
This section captures risk context for the asset, including normalized and source-reported risk names and levels, first and last report timestamps, and provider-specific risk details.
135135

@@ -142,7 +142,7 @@ This section captures risk context for the asset, including normalized and sourc
142142
| **AssetRiskLastReportedTime** | Optional | datetime | The timestamp (UTC) of when the risk associated with the asset was most recently reported. |
143143
| **AssetOriginalRiskDetails** | Optional | dynamic | The full risk details for the asset as provided by the source system. |
144144

145-
### <a id="file-fields">File (Asset Type) Fields</a>
145+
### <a id="file-fields">File (asset type) fields</a>
146146

147147
This section captures file-specific asset properties. The properties should be populated if the `AssetType` is **File**.
148148

@@ -158,7 +158,7 @@ This section captures file-specific asset properties. The properties should be p
158158
| **FileIsSignatureValid** | Optional | bool | Indicates whether the digital signature of the file is valid. |
159159
| **FileSignatureDetails** | Optional | string | Details about the digital signature of the file, such as the signer or certificate information. |
160160

161-
### <a id="site-fields">Site (Asset Type) Fields</a>
161+
### <a id="site-fields">Site (asset type) fields</a>
162162

163163
This section captures site-specific location properties for sharepoint site assets. The properties should be populated if the `AssetType` is **Site**.
164164

@@ -174,7 +174,7 @@ This section captures site-specific location properties for sharepoint site asse
174174
| **AssetPath** | Alias | string | The alias for either `FilePath` or `SitePath` |
175175
| **User** | Alias | string | The alias for `AssetOwnerId`. |
176176

177-
## Schema Updates
177+
## Schema updates
178178

179179
The following are the changes in various versions of the schema:
180180

0 commit comments

Comments
 (0)