Filters

Expand all | Collapse all

Filters let you select events based on specified conditions. The collector service uses filters to select events that you want to send to KUMA. An event that matches the filter condition is sent to KUMA for processing.

You can use filters in the following KUMA services and features:

You can use standalone filters or built-in filters that are stored in the service or resource where they were created. For resources in input fields except the Description field, you can enable the display of control characters. Available filter settings are listed in the table below.

Available filter settings:

Setting

Description

Name

Unique name for the resource type. Maximum length of the name: 128 Unicode characters. Inline filters are created in other resources or services and do not have names.

Required setting.

Tenant

The name of the tenant that owns the resource.

Required setting.

Description

Filter description. Maximum length of the description: 4000 Unicode characters.

Conditions

Filtering criteria. You can create filter conditions and filter groups, or add existing filters.

To create filtering criteria, you can use builder mode or source code mode. In builder mode, you can create or edit filter criteria by selecting filter conditions and operators from drop-down lists. In source code mode, you can use text commands to create and edit search queries. The builder mode is used by default.

You can freely switch between modes when creating filtering criteria. To switch to source code mode, click the Code button. When switching between modes, the created condition filters are preserved. If the filter code is not displayed on the Code tab after linking the created filter to the resource, go to the Builder tab and then go back to the Code tab to display the filter code.

Creating conditions in builder mode

You can create filtering criteria in builder mode using the following buttons:

You can do the following:

Available condition settings are listed in the table below.

Available condition settings

Setting

Description

If

Using the inverted operator function.

Required setting.

Left operand and Right operand

Values to be processed by the operator. The available types of values depend on the selected operator.

Operands of filters

Required settings.

Operator

Condition operator. In this drop-down list, you can select the do not match case check box if you want the operator to ignore the case of values. This check box is ignored if the inSubnet, inActiveList, inCategory, InActiveDirectoryGroup, hasBit, and inDictionary operators are selected. This check box is cleared by default.

Filter operators

The available operand kinds depends on whether the operand is left (L) or right (R).

Available operand kinds for left (L) and right (R) operands

Operator

Event field type

Active list type

Dictionary type

Context table type

Table type

TI type

Constant type

List type

=

L,R

L,R

L,R

L,R

L,R

L,R

R

R

>

L,R

L,R

L,R

L,R (only when looking up a table value by index)

L,R

L

R

no value

>=

L,R

L,R

L,R

L,R (only when looking up a table value by index)

L,R

L

R

no value

<

L,R

L,R

L,R

L,R (only when looking up a table value by index)

L,R

L

R

no value

<=

L,R

L,R

L,R

L,R (only when looking up a table value by index)

L,R

L

R

no value

inSubnet

L,R

L,R

L,R

L,R

L,R

L,R

R

R

contains

L,R

L,R

L,R

L,R

L,R

L,R

R

R

startsWith

L,R

L,R

L,R

L,R

L,R

L,R

R

R

endsWith

L,R

L,R

L,R

L,R

L,R

L,R

R

R

match

L

L

L

L

L

L

R

R

hasVulnerability

L

L

L

L

L

no value

no value

no value

hasBit

L

L

L

L

L

no value

R

R

inActiveList

no value

no value

no value

no value

no value

no value

no value

no value

inDictionary

no value

no value

no value

no value

no value

no value

no value

no value

inCategory

L

L

L

L

L

no value

R

R

inContextTable

no value

no value

no value

no value

no value

no value

no value

no value

inActiveDirectoryGroup

L

L

L

L

L

no value

R

R

TIDetect

no value

no value

no value

no value

no value

no value

no value

no value

You can use hotkeys when managing filters. Hotkeys are described in the table below.

Hotkeys and their functions

Key

Function

e

Invokes a filter by the event field

d

Invokes a filter by the dictionary field

a

Invokes a filter by the active list field

c

Invokes a filter by the context table field

t

Invokes a filter by the table field

f

Invokes a filter

t+i

Invokes a filter using TI

Ctrl+Enter

Finish editing a condition

The usage of extended event schema fields of the "String", "Number", or "Float" types is the same as the usage of fields of the KUMA event schema.

When using filters with extended event schema fields of the "Array of strings", "Array of numbers", and "Array of floats" types, you can use the following operations:

Creating conditions in source code mode

The code editor mode allows you to quickly edit conditions, select and copy blocks of code. On the right side of the builder, you can find the navigator, which lets you to navigate the filter code. Line wrapping is performed automatically at AND, OR, NOT logical operators, or at commas that separate the items in the list of values.

Names of resources used in the filter are automatically specified. Fields containing the names of linked resources cannot be edited. The names of shared resource categories are not displayed in the filter if you do not have the "Access to shared resources" role. To view the list of resources for the selected operand inside the expression, press Ctrl+Space. This displays a list of resources.

The filters listed in the table below are included in the KUMA kit.

Predefined filters

Filter name

Description

[OOTB][AD] A member was added to a security-enabled global group (4728)

Selects events of adding a user to an Active Directory security-enabled global group.

[OOTB][AD] A member was added to a security-enabled universal group (4756)

Selects events of adding a user to an Active Directory security-enabled universal group.

[OOTB][AD] A member was removed from a security-enabled global group (4729)

Selects events of removing a user from an Active Directory security-enabled global group.

[OOTB][AD] A member was removed from a security-enabled universal group (4757)

Selects events of removing a user from an Active Directory security-enabled universal group.

[OOTB][AD] Account Created

Selects Windows user account creation events.

[OOTB][AD] Account Deleted

Selects Windows user account deletion events.

[OOTB][AD] An account failed to log on (4625)

Selects Windows logon failure events.

[OOTB][AD] Successful Kerberos authentication (4624, 4768, 4769, 4770)

Selects successful Windows logon events and events with IDs 4769, 4770 that are logged on domain controllers.

[OOTB][AD][Technical] 4768. TGT Requested

Selects Microsoft Windows events with ID 4768.

[OOTB][Net] Possible port scan

Selects events that may indicate a port scan.

[OOTB][SSH] Accepted Password

Selects events of successful SSH connections with a password.

[OOTB][SSH] Failed Password

Selects attempts to connect over SSH with a password.

Page top