Skip to content

Commit 624367c

Browse files
committed
Added filtering parameters to missing schemas
1 parent 553f033 commit 624367c

4 files changed

Lines changed: 97 additions & 1 deletion

File tree

articles/sentinel/normalization-schema-dhcp.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,31 @@ The DHCP information model is used to describe events reported by a DHCP server,
1616

1717
For more information, see [Normalization and the Advanced Security Information Model (ASIM)](normalization.md).
1818

19+
## Parsers
20+
21+
For more information about ASIM parsers, see the [ASIM parsers overview](normalization-parsers-overview.md).
22+
23+
### Filtering parser parameters
24+
25+
The DHCP parsers support [filtering parameters](normalization-about-parsers.md#optimizing-parsing-using-parameters). While these parameters are optional, they can improve your query performance.
26+
27+
The following filtering parameters are available:
28+
29+
| Name | Type | Description |
30+
|----------|-----------|-------------|
31+
| **starttime** | datetime | Filter only DHCP events that occurred at or after this time. This parameter filters on the `TimeGenerated` field, which is the standard designator for the time of the event, regardless of the parser-specific mapping of the EventStartTime and EventEndTime fields. |
32+
| **endtime** | datetime | Filter only DHCP events that occurred at or before this time. This parameter filters on the `TimeGenerated` field, which is the standard designator for the time of the event, regardless of the parser-specific mapping of the EventStartTime and EventEndTime fields. |
33+
| **srcipaddr_has_any_prefix** | dynamic | Filter only DHCP events where the source IP address prefix matches any of the listed values. Prefixes should end with a `.`, for example: `10.0.`. |
34+
| **srchostname_has_any** | dynamic | Filter only DHCP events where the source hostname has any of the listed values. |
35+
| **srcusername_has_any** | dynamic | Filter only DHCP events where the source username has any of the listed values. |
36+
| **eventresult** | string | Filter only DHCP events with a specific event result. Use `*` to include all results. |
37+
38+
For example, to filter only DHCP events from a specific IP address range in the last day, use:
39+
40+
```kusto
41+
_Im_DhcpEvent (srcipaddr_has_any_prefix=dynamic(['10.0.']), starttime = ago(1d), endtime=now())
42+
```
43+
1944
## Schema overview
2045

2146
The ASIM DHCP schema represents DHCP server activity, including serving requests for DHCP IP address leased from client systems and updating a DNS server with the leases granted.

articles/sentinel/normalization-schema-file-event.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,8 +30,31 @@ For the list of the file activity parsers Microsoft Sentinel provides out-of-the
3030

3131
When implementing custom parsers for the File Event information model, name your KQL functions using the following syntax: `imFileEvent<vendor><Product`.
3232

33-
Refer to the article [Managing ASIM parsers](normalization-manage-parsers.md) to learn how to add your custom parsers to the file activity unifying parser.
33+
Refer to the article [Managing ASIM parsers](normalization-manage-parsers.md) to learn how to add your custom parsers to the file activity unifying parser.
3434

35+
### Filtering parser parameters
36+
37+
The File Event parsers support [filtering parameters](normalization-about-parsers.md#optimizing-parsing-using-parameters). While these parameters are optional, they can improve your query performance.
38+
39+
The following filtering parameters are available:
40+
41+
| Name | Type | Description |
42+
|----------|-----------|-------------|
43+
| **starttime** | datetime | Filter only file events that occurred at or after this time. This parameter filters on the `TimeGenerated` field, which is the standard designator for the time of the event, regardless of the parser-specific mapping of the EventStartTime and EventEndTime fields. |
44+
| **endtime** | datetime | Filter only file events that occurred at or before this time. This parameter filters on the `TimeGenerated` field, which is the standard designator for the time of the event, regardless of the parser-specific mapping of the EventStartTime and EventEndTime fields. |
45+
| **eventtype_in** | dynamic | Filter only file events where the event type is one of the values listed, such as `FileCreated`, `FileModified`, `FileDeleted`, `FileRenamed`, or `FileCopied`. |
46+
| **srcipaddr_has_any_prefix** | dynamic | Filter only file events where the source IP address prefix matches any of the listed values. Prefixes should end with a `.`, for example: `10.0.`. |
47+
| **actorusername_has_any** | dynamic | Filter only file events where the actor username has any of the listed values. |
48+
| **targetfilepath_has_any** | dynamic | Filter only file events where the target file path has any of the listed values. |
49+
| **srcfilepath_has_any** | dynamic | Filter only file events where the source file path has any of the listed values. |
50+
| **hashes_has_any** | dynamic | Filter only file events where the file hash matches any of the listed values. |
51+
| **dvchostname_has_any** | dynamic | Filter only file events where the device hostname has any of the listed values. |
52+
53+
For example, to filter only file creation and modification events from the last day, use:
54+
55+
```kusto
56+
_Im_FileEvent (eventtype_in=dynamic(['FileCreated','FileModified']), starttime = ago(1d), endtime=now())
57+
```
3558

3659
## Normalized content
3760

articles/sentinel/normalization-schema-registry-event.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,29 @@ When implementing custom parsers for the Registry Event information model, name
3535

3636
Add your KQL functions to the `imRegistry` unifying parsers to ensure that any content using the Registry Event model also uses your new parser.
3737

38+
### Filtering parser parameters
39+
40+
The Registry Event parsers support [filtering parameters](normalization-about-parsers.md#optimizing-parsing-using-parameters). While these parameters are optional, they can improve your query performance.
41+
42+
The following filtering parameters are available:
43+
44+
| Name | Type | Description |
45+
|----------|-----------|-------------|
46+
| **starttime** | datetime | Filter only registry events that occurred at or after this time. This parameter filters on the `TimeGenerated` field, which is the standard designator for the time of the event, regardless of the parser-specific mapping of the EventStartTime and EventEndTime fields. |
47+
| **endtime** | datetime | Filter only registry events that occurred at or before this time. This parameter filters on the `TimeGenerated` field, which is the standard designator for the time of the event, regardless of the parser-specific mapping of the EventStartTime and EventEndTime fields. |
48+
| **eventtype_in** | dynamic | Filter only registry events where the event type is one of the values listed, including: `RegistryKeyCreated`, `RegistryKeyDeleted`, `RegistryKeyRenamed`, `RegistryValueDeleted`, or `RegistryValueSet`. |
49+
| **actorusername_has_any** | dynamic | Filter only registry events where the actor username has any of the listed values. |
50+
| **registrykey_has_any** | dynamic | Filter only registry events where the registry key has any of the listed values. |
51+
| **registryvalue_has_any** | dynamic | Filter only registry events where the registry value has any of the listed values. |
52+
| **registrydata_has_any** | dynamic | Filter only registry events where the registry data has any of the listed values. |
53+
| **dvchostname_has_any** | dynamic | Filter only registry events where the device hostname has any of the listed values. |
54+
55+
For example, to filter only registry key creation events from the last day, use:
56+
57+
```kusto
58+
_Im_RegistryEvent (eventtype_in=dynamic(['RegistryKeyCreated']), starttime = ago(1d), endtime=now())
59+
```
60+
3861
## Normalized content
3962

4063
Microsoft Sentinel provides the [Persisting Via IFEO Registry Key](https://github.com/Azure/Azure-Sentinel/blob/master/Hunting%20Queries/MultipleDataSources/PersistViaIFEORegistryKey.yaml) hunting query. This query works on any registry activity data normalized using the Advanced Security Information Model.

articles/sentinel/normalization-schema-user-management.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,31 @@ Some activities, such as **UserCreated**, **GroupCreated**, **UserModified**, an
3131
- [PreviousPropertyValue](#previouspropertyvalue) - the previous value of the property.
3232
- [NewPropertyValue](#newpropertyvalue) - the updated value of the property.
3333

34+
## Parsers
35+
36+
For more information about ASIM parsers, see the [ASIM parsers overview](normalization-parsers-overview.md).
37+
38+
### Filtering parser parameters
39+
40+
The User Management parsers support [filtering parameters](normalization-about-parsers.md#optimizing-parsing-using-parameters). While these parameters are optional, they can improve your query performance.
41+
42+
The following filtering parameters are available:
43+
44+
| Name | Type | Description |
45+
|----------|-----------|-------------|
46+
| **starttime** | datetime | Filter only user management events that occurred at or after this time. This parameter filters on the `TimeGenerated` field, which is the standard designator for the time of the event, regardless of the parser-specific mapping of the EventStartTime and EventEndTime fields. |
47+
| **endtime** | datetime | Filter only user management events that occurred at or before this time. This parameter filters on the `TimeGenerated` field, which is the standard designator for the time of the event, regardless of the parser-specific mapping of the EventStartTime and EventEndTime fields. |
48+
| **srcipaddr_has_any_prefix** | dynamic | Filter only user management events where the source IP address prefix matches any of the listed values. Prefixes should end with a `.`, for example: `10.0.`. |
49+
| **targetusername_has_any** | dynamic | Filter only user management events where the target username has any of the listed values. |
50+
| **actorusername_has_any** | dynamic | Filter only user management events where the actor username has any of the listed values. |
51+
| **eventtype_in** | dynamic | Filter only user management events where the event type is one of the listed values, such as `UserCreated`, `UserDeleted`, `UserModified`, `PasswordChanged`, or `GroupCreated`. |
52+
53+
For example, to filter only user creation events from the last day, use:
54+
55+
```kusto
56+
_Im_UserManagement (eventtype_in=dynamic(['UserCreated']), starttime = ago(1d), endtime=now())
57+
```
58+
3459
## Schema details
3560

3661
### Common ASIM fields

0 commit comments

Comments
 (0)