Skip to content

Commit 64a935d

Browse files
authored
Merge pull request #225523 from oshezaf/asim/update-authentication
asim/update-authentication
2 parents 73c7277 + 1b2b6e6 commit 64a935d

17 files changed

+163
-88
lines changed

.openpublishing.redirection.json

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16084,11 +16084,36 @@
1608416084
"redirect_url": "/azure/sentinel/normalization-schema-dns",
1608516085
"redirect_document_id": true
1608616086
},
16087+
{
16088+
"source_path_from_root": "/articles/sentinel/authentication-normalization-schema.md",
16089+
"redirect_url": "/azure/sentinel/normalization-schema-authentication",
16090+
"redirect_document_id": true
16091+
},
16092+
{
16093+
"source_path_from_root": "/articles/sentinel/dhcp-normalization-schema.md",
16094+
"redirect_url": "/azure/sentinel/normalization-schema-dhcp",
16095+
"redirect_document_id": true
16096+
},
16097+
{
16098+
"source_path_from_root": "/articles/sentinel/user-management-normalization-schema.md",
16099+
"redirect_url": "/azure/sentinel/normalization-schema-user-management",
16100+
"redirect_document_id": true
16101+
},
1608716102
{
1608816103
"source_path_from_root": "/articles/sentinel/file-event-normalization-schema.md",
1608916104
"redirect_url": "/azure/sentinel/normalization-schema-file-event",
1609016105
"redirect_document_id": true
1609116106
},
16107+
{
16108+
"source_path_from_root": "/articles/sentinel/registry-event-normalization-schema.md",
16109+
"redirect_url": "/azure/sentinel/normalization-schema-registry-event",
16110+
"redirect_document_id": true
16111+
},
16112+
{
16113+
"source_path_from_root": "/articles/sentinel/process-events-normalization-schema.md",
16114+
"redirect_url": "/azure/sentinel/normalization-schema-process-event",
16115+
"redirect_document_id": true
16116+
},
1609216117
{
1609316118
"source_path_from_root": "/articles/service-bus/index.md",
1609416119
"redirect_url": "/azure/service-bus-messaging/index",

articles/sentinel/TOC.yml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -560,21 +560,21 @@
560560
- name: ASIM audit event schema
561561
href: normalization-schema-audit.md
562562
- name: ASIM authentication schema
563-
href: authentication-normalization-schema.md
563+
href: normalization-schema-authentication.md
564564
- name: ASIM DNS schema
565565
href: normalization-schema-dns.md
566566
- name: ASIM DHCP schema
567-
href: dhcp-normalization-schema.md
567+
href: normalization-schema-dhcp.md
568568
- name: ASIM file event schema
569569
href: normalization-schema-file-event.md
570570
- name: ASIM network session schema
571571
href: normalization-schema-network.md
572572
- name: ASIM process event schema
573-
href: process-events-normalization-schema.md
573+
href: normalization-schema-process-event.md
574574
- name: ASIM registry event schema
575-
href: registry-event-normalization-schema.md
575+
href: normalization-schema-registry-event.md
576576
- name: ASIM user management schema
577-
href: user-management-normalization-schema.md
577+
href: normalization-schema-user-management.md
578578
- name: ASIM web session schema
579579
href: normalization-schema-web.md
580580
- name: Legacy network normalization schema

articles/sentinel/normalization-about-parsers.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ When invoking the parser, always use available filtering parameters by adding on
6262

6363
Each schema has a standard set of filtering parameters documented in the relevant schema documentation. Filtering parameters are entirely optional. The following schemas support filtering parameters:
6464
- [Audit Event](normalization-schema-audit.md)
65-
- [Authentication](authentication-normalization-schema.md)
65+
- [Authentication](normalization-schema-authentication.md)
6666
- [DNS](normalization-schema-dns.md#filtering-parser-parameters)
6767
- [Network Session](normalization-schema-network.md#filtering-parser-parameters)
6868
- [Web Session](normalization-schema-web.md#filtering-parser-parameters)

articles/sentinel/normalization-about-schemas.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -18,15 +18,15 @@ Schema references outline the fields that comprise each schema. ASIM currently d
1818
| Schema | Version | Status |
1919
| ------ | ------- | ------ |
2020
| [Audit Event](normalization-schema-audit.md) | 0.1 | Preview |
21-
| [Authentication Event](authentication-normalization-schema.md) | 0.1.2 | Preview |
21+
| [Authentication Event](normalization-schema-authentication.md) | 0.1.3 | Preview |
2222
| [DNS Activity](normalization-schema-dns.md) | 0.1.6 | Preview |
23-
| [DHCP Activity](dhcp-normalization-schema.md) | 0.1 | Preview |
23+
| [DHCP Activity](normalization-schema-dhcp.md) | 0.1 | Preview |
2424
| [File Activity](normalization-schema-file-event.md) | 0.2 | Preview |
2525
| [Network Session](normalization-schema.md) | 0.2.5 | Preview |
26-
| [Process Event](process-events-normalization-schema.md) | 0.1.4 | Preview |
27-
| [Registry Event](registry-event-normalization-schema.md) | 0.1.2 | Preview |
28-
| [User Management](user-management-normalization-schema.md) | 0.1 | Preview |
29-
| [Web Session](normalization-schema-web.md) | 0.2.5 | Preview |
26+
| [Process Event](normalization-schema-process-event.md) | 0.1.4 | Preview |
27+
| [Registry Event](normalization-schema-registry-event.md) | 0.1.2 | Preview |
28+
| [User Management](normalization-schema-user-management.md) | 0.1 | Preview |
29+
| [Web Session](normalization-schema-web.md) | 0.2.6 | Preview |
3030

3131

3232
> [!IMPORTANT]
@@ -44,7 +44,7 @@ The following concepts help to understand the schema reference documents and ext
4444
|**Field class** | Fields might have several classes, which define when the fields should be implemented by a parser: <br><br> - **Mandatory** fields must appear in every parser. If your source doesn't provide information for this value, or the data can't be otherwise added, it won't support most content items that reference the normalized schema.<br> - **Recommended** fields should be normalized if available. However, they might not be available in every source. Any content item that references that normalized schema should take availability into account.<br> - **Optional** fields, if available, can be normalized or left in their original form. Typically, a minimal parser wouldn't normalize them for performance reasons.<br> - **Conditional** fields are mandatory if the field they follow is populated. Conditional fields are typically used to describe the value in another field. For example, the common field [DvcIdType](normalization-common-fields.md#dvcidtype) describes the value int the common field [DvcId](normalization-common-fields.md#dvcid) and is therefore mandatory if the latter is populated.<br>- **Alias** is a special type of a conditional field, and is mandatory if the aliased field is populated. |
4545
|[**Common fields**](normalization-common-fields.md) | Some fields are common to all ASIM schemas. Each schema might add guidelines for using some of the common fields in the context of the specific schema. For example, permitted values for the **EventType** field might vary per schema, as might the value of the **EventSchemaVersion** field. |
4646
|**Entities**| Events evolve around entities, such as users, hosts, processes, or files. Each entity might require several fields to describe it. For example, a host might have a name and an IP address. <br><br>A single record might include multiple entities of the same type, such as both a source and destination host. <br><br>ASIM defines how to describe entities consistently, and entities allow for extending the schemas. <br><br>For example, while the Network Session schema doesn't include process information, some event sources do provide process information that can be added. For more information, see [Entities](#entities). |
47-
|**Aliases**| Aliases allow multiple names for a specified value. In some cases, different users expect a field to have different names. For example, in DNS terminology, you might expect a field named [DnsQuery](normalization-schema-dns.md#query), while more generally, it holds a domain name. The alias [Domain](normalization-schema-dns.md#domain) helps the user by allowing the use of both names. <br><br>In some cases, an alias can have the value of one of several fields, depending on which values are available in the event. For example, the [Dvc](normalization-common-fields.md#dvc) alias, aliases either the [DvcFQDN](normalization-common-fields.md#dvcfqdn), [DvcId](normalization-common-fields.md#dvcid), [DvcHostname](normalization-common-fields.md#dvchostname), or [DvcIpAddr](normalization-common-fields.md#dvcipaddr) , or [Event Product](normalization-common-fields.md#eventproduct) fields.<br><br>[Native normalized tables](normalization-ingest-time.md#ingest-time-parsing) do not include aliases, as those would imply duplicate data storage. Instead the [stub parsers](normalization-ingest-time.md#combining-ingest-time-and-query-time-normalization) add the aliases. To implement aliases in parsers, create a copy of the original value by using the `extend` operator. |
47+
|**Aliases**| Aliases allow multiple names for a specified value. In some cases, different users expect a field to have different names. For example, in DNS terminology, you might expect a field named [DnsQuery](normalization-schema-dns.md#query), while more generally, it holds a domain name. The alias [Domain](normalization-schema-dns.md#domain) helps the user by allowing the use of both names. <br><br>In some cases, an alias can have the value of one of several fields, depending on which values are available in the event. For example, the [Dvc](normalization-common-fields.md#dvc) alias, aliases either the [DvcFQDN](normalization-common-fields.md#dvcfqdn), [DvcId](normalization-common-fields.md#dvcid), [DvcHostname](normalization-common-fields.md#dvchostname), or [DvcIpAddr](normalization-common-fields.md#dvcipaddr) , or [Event Product](normalization-common-fields.md#eventproduct) fields. When an alias can have several values, its type has to be a string to accommodate all possible aliased values. As a result, when assigning a value to such an alias, make sure to convert the type to string using the KQL function [tostring](/azure/data-explorer/kusto/query/tostringfunction).<br><br>[Native normalized tables](normalization-ingest-time.md#ingest-time-parsing) do not include aliases, as those would imply duplicate data storage. Instead the [stub parsers](normalization-ingest-time.md#combining-ingest-time-and-query-time-normalization) add the aliases. To implement aliases in parsers, create a copy of the original value by using the `extend` operator. |
4848

4949

5050
## Logical types

articles/sentinel/normalization-common-fields.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,6 @@ The following fields are generated by Log Analytics, in most cases, for each rec
1919
| Field | Type | Discussion |
2020
| ------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
2121
| <a name="timegenerated"></a>**TimeGenerated** | datetime | The time the event was generated by the reporting device.|
22-
| **_ResourceId** | String | The Azure Resource ID of the reporting device or service, or the log forwarder resource ID for events forwarded by using Syslog, CEF, or WEF. **_ResourceId** is not generated for sources for that do not have a resource concept, such as Microsoft Defender for Endpoint and will be empty for events from these sources. |
2322
| **Type** | String | The original table from which the record was fetched. This field is useful when the same event can be received through multiple channels to different tables, and have the same [EventVendor](#eventvendor) and [EventProduct](#eventproduct) values.<br><br>For example, a Sysmon event can be collected either to the `Event` table or to the `WindowsEvent` table. |
2423

2524

@@ -109,9 +108,11 @@ The currently supported list of vendors and products used in the [EventVendor](#
109108
| Corelight | Zeek |
110109
| GCP | Cloud DNS |
111110
| Infoblox | NIOS |
112-
| Microsoft | - AAD<br> - Azure<br> - Azure Firewall<br> - Azure Blob Storage<br> - Azure File Storage<br> - Azure NSG flows<br> - Azure Queue Storage<br> - Azure Table Storage <br> - DNS Server<br> - Microsoft 365 Defender for Endpoint<br> - Microsoft Defender for IoT<br> - Security Events<br>- SharePoint<br>- OneDrive<br>- Sysmon<br> - Sysmon for Linux<br> - VMConnection<br> - Windows Firewall<br> - WireData <br>
113-
| Okta | - Okta<BR> - Auth0<br> |
114-
| Palo Alto | - PanOS<br> - CDL<br> |
111+
| Microsoft | - Microsoft Azure Active Directory (Azure AD)<br> - Azure<br> - Azure Firewall<br> - Azure Blob Storage<br> - Azure File Storage<br> - Azure NSG flows<br> - Azure Queue Storage<br> - Azure Table Storage <br> - DNS Server<br> - Microsoft 365 Defender for Endpoint<br> - Microsoft Defender for IoT<br> - Security Events<br>- SharePoint<br>- OneDrive<br>- Sysmon<br> - Sysmon for Linux<br> - VMConnection<br> - Windows Firewall<br> - WireData
112+
| Linux | - su<br> - sudo |
113+
| Okta | - Okta<br> - Auth0 |
114+
| OpenBSD | OpenSSH |
115+
| Palo Alto | - PanOS<br> - CDL |
115116
| PostgreSQL | PostgreSQL |
116117
| Squid | Squid Proxy |
117118
| Vectra AI | Vectra Steam |

0 commit comments

Comments
 (0)