Detection and exclusion criteria
This page provides detailed information about all the field values that can be used in criteriaList objects when creating or updating a custom rule. The fields are organized by target and include the supported relation values and the validation rules applicable to each corresponding value.
Important
Rules that include only EDR-only fields and values, along with fields and values supported by both EDR and XDR, are processed exclusively by EDR.
Rules that include only XDR-only fields and values, along with fields and values supported by both EDR and XDR, are processed exclusively by XDR.
Rules that include only fields and values supported by both EDR and XDR are processed by both XDR and EDR.
EDR-only fields or values cannot be combined with XDR-only fields or values within the same rule.
Only one XDR resource can be defined as a criterion in a detection rule with the
connectionoruser connectiontarget.For any criterion object where
relationis set tocontains, thevalueproperty supports the use of wildcards. An exception applies to criteria wherefieldhas one of the following values:Process.MD5Process.SHA2File.MD5File.SHA2
For any criterion object where
relationis set toany, thevalueproperty must be an array. The array elements must follow the type specified in the Value validation rules column, or be strings selected from the allowed values listed in that column.
Note
For information about the createCustomRule and updateCustomRule methods, refer to createCustomRule and updateCustomRule.
Available for detection rules (with | Available for exclusion rules (with | Field name in GravityZone Control Center | Target | Field API name | EDR or XDR support | Relation API name | Value validation rules |
|---|---|---|---|---|---|---|---|
Yes | Yes | Alert name | All target entities | detection ImportantFor any XDR detection rule, you must use either this criterion or an operation criterion, but not both. | Both | is | string |
Yes | Yes | Name | process | Process.Name | EDR | is |contains| any | string |
Path | Process.Path | ||||||
Full path name | Process.FullPathName | ||||||
Command line | Process.CommandLine | ||||||
Parent name | Process.Parent.Name | ||||||
Parent path | Process.Parent.Path | ||||||
Parent full path name | Process.Parent.FullPathName | ||||||
Parent command line | Process.Parent.CommandLine | ||||||
User | Process.User | ||||||
MD5 | Process.MD5 | ||||||
SHA256 | Process.SHA2 | ||||||
Yes | Yes | Name | file | File.Name | Both | is |contains| any | string |
Path | File.Path | ||||||
Full path name | File.FullPathName | ||||||
Yes | Yes | Operation | file | File.Operation ImportantFor any XDR detection rule that uses the | EDR for exclusion rules Both for detection rules | is | any | Possible EDR-only values:
Possible XDR-only values:
Possible values for both EDR and XDR:
|
Yes | Yes | Creation process name | file | File.CreatedBy.Name | EDR | is |contains| any | string |
Creation process path name | File.CreatedBy.Path | ||||||
Creation process full path name | File.CreatedBy.FullPathName | ||||||
Creation process command line | File.CreatedBy.CommandLine | ||||||
Creation process user | File.CreatedBy.User | ||||||
Certificate signer | File.CertificateSigner Important
| ||||||
Certificate issuer | File.CertificateIssuer Important
| ||||||
Certificate signed status | File.CertificateSignedStatus ImportantRequires either | is | Possible values:
ImportantThe | ||||
Yes | Yes | MD5 | file | File.MD5 | XDR | is | contains | any | string |
SHA256 | File.SHA2 | ||||||
URL | File.Url | ||||||
Source IP | File.SourceIP | is |contains| any | string containing a valid IP | ||||
Destination IP | File.DestinationIP | ||||||
Yes | Yes | Source IP | connection | Connection.SourceIP | Both | is |contains| any | string containing a valid IP |
Destination IP | Connection.DestinationIP | ||||||
Yes | Yes | Source port | connection | Connection.SourcePort | EDR | is |contains| any | integer between 0 and 65,535 |
Destination port | Connection.DestinationPort | ||||||
Creation process name | Connection.Process.Name | is | contains | any | string | ||||
Creation process path | Connection.Process.Path | ||||||
Creation process full path name | Connection.Process.FullPathName | ||||||
Creation process command line | Connection.Process.CommandLine | ||||||
Creation process user | Connection.Process.User | ||||||
URL | Connection.URL Important
| ||||||
HTTP user | Connection.HTTPUser Important
| ||||||
HTTP downloaded file | Connection.HTTPDownloadedFile Important
| ||||||
HTTP uploaded file | Connection.HTTPUploadedFile Important
| ||||||
FTP user | Connection.FTPUser ImportantIncompatible with the following fields in the same rule:
| ||||||
SMB domain | Connection.SMBDomain Important
| ||||||
SMB share path | Connection.SMBSharePath Important
| ||||||
SMB user | Connection.SMBUser Important
| ||||||
SSH user | Connection.SSHUser ImportantIncompatible with the following fields in the same rule:
| ||||||
WMI exec query | Connection.WMIExecQuery ImportantIncompatible with the following fields in the same rule:
| ||||||
Telnet user | Connection.TelnetUser ImportantIncompatible with the following fields in the same rule:
| ||||||
File remote path | Connection.FileRemotePath ImportantIncompatible with the following fields in the same rule:
| ||||||
Domain | Connection.Domain Important
| ||||||
File remote operation | Connection.FileRemoteOperation ImportantIncompatible with the following fields in the same rule:
| is | any | Possible values:
| ||||
Protocol | Connection.Protocol ImportantThis criterion can only be used together with | is | Possible values:
| ||||
No | Yes | Flow name | connection | Connection.Flow.Name | XDR | is | contains | any | string |
Bitbucket repository name | Connection.BitbucketRepository.Name | ||||||
Yes | Yes | File name | connection | Connection.File.Name ImportantFor detection rules, requires | XDR | is | contains | any | string |
Email subject | Connection.Email.Subject ImportantFor detection rules, requires | ||||||
Application name | Connection.Application.Name ImportantFor detection rules, requires | ||||||
Key vault name | Connection.KeyVault.Name ImportantFor detection rules, requires | ||||||
Role name | Connection.Role.Name ImportantFor detection rules, requires | ||||||
Policy name | Connection.Policy.Name ImportantFor detection rules, requires | ||||||
Sharing link name | Connection.SharingLink.Name ImportantFor detection rules, requires | ||||||
URL name | Connection.Url.Name ImportantFor detection rules, requires | ||||||
SSH key name | Connection.SshKey.Name ImportantFor detection rules, requires | ||||||
Launch template name | Connection.LaunchTemplate.Name ImportantFor detection rules, requires | ||||||
Service principal name | Connection.ServicePrincipal.Name ImportantFor detection rules, requires | ||||||
User group name | Connection.UserGroup.Name ImportantFor detection rules, requires | ||||||
Automation account name | Connection.AutomationAccount.Name ImportantFor detection rules, requires | ||||||
Automation account hook name | Connection.AutomationAccountHook.Name ImportantFor detection rules, requires | ||||||
API name | Connection.Api.Name ImportantFor detection rules, requires | ||||||
Certificate authority name | Connection.CertificateAuthority.Name ImportantFor detection rules, requires | ||||||
Bucket name | Connection.Bucket.Name ImportantFor detection rules, requires | ||||||
Source user | Connection.SourceUser | ||||||
Destination user | Connection.DestinationUser | ||||||
Confluence page name | Connection.ConfluencePage.Name ImportantFor detection rules, requires | ||||||
Jira project name | Connection.JiraProject.Name ImportantFor detection rules, requires | ||||||
Yes | No | API operation | connection | Connection.Api.Operation ImportantThis criterion can only be applied together with | XDR | is | any | Possible values:
|
Application operation | Connection.Application.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Automation account hook operation | Connection.AutomationAccountHook.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Automation account operation | Connection.AutomationAccount.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Bucket operation | Connection.Bucket.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Certificate authority operation | Connection.CertificateAuthority.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Confluence page operation | Connection.ConfluencePage.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Email operation | Connection.Email.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
File operation | Connection.File.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Jira project operation | Connection.JiraProject.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Key vault operation | Connection.KeyVault.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Launch template operation | Connection.LaunchTemplate.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Policy operation | Connection.Policy.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Role operation | Connection.Role.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Service principal operation | Connection.ServicePrincipal.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Sharing link operation | Connection.SharingLink.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
SSH key operation | Connection.SshKey.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
URL operation | Connection.Url.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
User group operation | Connection.UserGroup.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Yes | Yes | Key | registry | Registry.Key | EDR | is | contains | any | string |
Value | Registry.Value | ||||||
Creation process name | Registry.CreatedBy.Name | ||||||
Creation process path | Registry.CreatedBy.Path | ||||||
Creation process full path name | Registry.CreatedBy.FullPathName | ||||||
Creation process command line | Registry.CreatedBy.CommandLine | ||||||
Registry data | Registry.Data ImportantThis criterion must be used together with | string ImportantFor the | |||||
Operation | Registry.Operation | is | any | Possible values:
| ||||
Registry type | Registry.DataType | is | Possible values:
| ||||
Yes | Yes | Name | user connection | UserLogin.Name | EDR | is | contains | any | string |
Domain | UserLogin.Domain | ||||||
No | Yes | Bitbucket repository name | user connection | UserLogin.BitbucketRepository.Name | XDR | is | contains | any | string |
Flow name | UserLogin.Flow.Name | ||||||
Yes | Yes | Jira project name | user connection | UserLogin.JiraProject.Name ImportantFor detection rules, requires | XDR | is | contains | any | string |
Source user | UserLogin.SourceUser | ||||||
Destination user | UserLogin.DestinationUser | ||||||
File name | UserLogin.File.Name ImportantFor detection rules, requires | ||||||
Email subject | UserLogin.Email.Subject ImportantFor detection rules, requires | ||||||
Application name | UserLogin.Application.Name ImportantFor detection rules, requires | ||||||
Key vault name | UserLogin.KeyVault.Name ImportantFor detection rules, requires | ||||||
Role name | UserLogin.Role.Name ImportantFor detection rules, requires | ||||||
Policy name | UserLogin.Policy.Name ImportantFor detection rules, requires | ||||||
Sharing link name | UserLogin.SharingLink.Name ImportantFor detection rules, requires | ||||||
URL name | UserLogin.Url.Name ImportantFor detection rules, requires | ||||||
SSH key name | UserLogin.SshKey.Name ImportantFor detection rules, requires | ||||||
Launch template name | UserLogin.LaunchTemplate.Name ImportantFor detection rules, requires | ||||||
Service principal name | UserLogin.ServicePrincipal.Name ImportantFor detection rules, requires | ||||||
User group name | UserLogin.UserGroup.Name ImportantFor detection rules, requires | ||||||
Automation account name | UserLogin.AutomationAccount.Name ImportantFor detection rules, requires | ||||||
Automation account hook name | UserLogin.AutomationAccountHook.Name ImportantFor detection rules, requires | ||||||
Api name | UserLogin.Api.Name ImportantFor detection rules, requires | ||||||
Certificate authority name | UserLogin.CertificateAuthority.Name ImportantFor detection rules, requires | ||||||
Bucket name | UserLogin.Bucket.Name ImportantFor detection rules, requires | ||||||
Confluence page name | UserLogin.ConfluencePage.Name ImportantFor detection rules, requires | ||||||
Source IP | UserLogin.SourceIP | string containing a valid IP | |||||
Destination IP | UserLogin.DestinationIP | ||||||
Yes | No | API operation | user connection | UserLogin.Api.Operation ImportantThis criterion can only be applied together with | XDR | is | any | Possible values:
|
Application operation | UserLogin.Application.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Automation account hook operation | UserLogin.AutomationAccountHook.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Automation account operation | UserLogin.AutomationAccount.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Bucket operation | UserLogin.Bucket.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Certificate authority operation | UserLogin.CertificateAuthority.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Confluence page operation | UserLogin.ConfluencePage.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Email operation | UserLogin.Email.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
File operation | UserLogin.File.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Jira project operation | UserLogin.JiraProject.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Key vault operation | UserLogin.KeyVault.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Launch template operation | UserLogin.LaunchTemplate.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Policy operation | UserLogin.Policy.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Role operation | UserLogin.Role.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Service principal operation | UserLogin.ServicePrincipal.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
Sharing link operation | UserLogin.SharingLink.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
SSH key operation | UserLogin.SshKey.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
URL operation | UserLogin.Url.Operation ImportantThis criterion can only be applied together with | Possible values:
| |||||
User group operation | UserLogin.UserGroup.Operation ImportantThis criterion can only be applied together with | Possible values: | |||||
Yes | No | Operation | Email.Operation ImportantAny detection rule with the | Both | is | any | Possible values:
| |
Yes | Yes | Subject | Email.Subject | is | contains | any | string | ||
Sender | Email.Sender | string, valid email | |||||
Receiver | Email.Receivers | ||||||
Attachment | Email.Attachments | string | |||||
Url | Email.Url | XDR | |||||
Source IP | Email.SourceIP | is | contains | any | string containing a valid IP | ||||
Destination IP | Email.DestinationIP | ||||||
Yes | No | Operation | application | Application.Operation ImportantAny detection rule with the | XDR | is | any | Possible values:
|
Yes | Yes | Name | Application.Name | is | contains | any | string | ||
Id | Application.Id | ||||||
Application address | Application.Address | ||||||
Source user | Application.SourceUser | ||||||
Destination user | Application.DestinationUser | ||||||
Source IP | Application.SourceIP | string containing a valid IP | |||||
Destination IP | Application.DestinationIP | ||||||
Yes | No | Operation | key vault | KeyVault.Operation ImportantAny detection rule with the | XDR | is | any | Possible values:
|
Yes | Yes | Name | KeyVault.Name | is | contains | any | string | ||
Source user | KeyVault.SourceUser | ||||||
Destination user | KeyVault.DestinationUser | ||||||
Source IP | KeyVault.SourceIP | string containing a valid IP | |||||
Destination IP | KeyVault.DestinationIP | ||||||
Yes | No | Operation | role | Role.Operation ImportantAny detection rule with the | XDR | is | any | Possible values: |
Yes | Yes | Name | Role.Name | is | contains | any | string | ||
Id | Role.Id | ||||||
Source user | Role.SourceUser | ||||||
Destination user | Role.DestinationUser | ||||||
Source IP | Role.SourceIP | string containing a valid IP | |||||
Destination IP | Role.DestinationIP | ||||||
Yes | No | Operation | policy | Policy.Operation ImportantAny detection rule with the | XDR | is | any | Possible values: |
Yes | Yes | Name | Policy.Name | is | contains | any | string | ||
Id | Policy.Id | ||||||
Resource policy type | Policy.ResourcePolicyType | ||||||
Source user | Policy.SourceUser | ||||||
Destination user | Policy.DestinationUser | ||||||
Source IP | Policy.SourceIP | string containing a valid IP | |||||
Destination IP | Policy.DestinationIP | ||||||
Yes | No | Operation | sharing link | SharingLink.Operation ImportantAny detection rule with the | XDR | is | any | Possible values: |
Yes | Yes | Name | SharingLink.Name | is | contains | any | string | ||
URL | SharingLink.Url | ||||||
Source user | SharingLink.SourceUser | ||||||
Destination user | SharingLink.DestinationUser | ||||||
Source IP | SharingLink.SourceIP | string containing a valid IP | |||||
Destination IP | SharingLink.DestinationIP | ||||||
No | Yes | Name | flow | Flow.Name | XDR | is | contains | any | string |
Id | Flow.Id | ||||||
URL | Flow.Url | ||||||
Source user | Flow.SourceUser | ||||||
Destination user | Flow.DestinationUser | ||||||
Source IP | Flow.SourceIP | string containing a valid IP | |||||
Destination IP | Flow.DestinationIP | ||||||
Yes | No | Operation | url | Url.Operation ImportantAny detection rule with the | XDR | is | any | Possible values:
|
Yes | Yes | Name | Url.Name | is | contains | any | string | ||
URL | Url.Url | ||||||
Source user | Url.SourceUser | ||||||
Destination user | Url.DestinationUser | ||||||
Source IP | Url.SourceIP | string containing a valid IP | |||||
Destination IP | Url.DestinationIP | ||||||
Yes | No | Operation | ssh key | SshKey.Operation ImportantAny detection rule with the | XDR | is | any | Possible values: |
Yes | Yes | Name | SshKey.Name | is | contains | any | string | ||
SSH public key | SshKey.PublicKey | ||||||
Source user | SshKey.SourceUser | ||||||
Destination user | SshKey.DestinationUser | ||||||
Source IP | SshKey.SourceIP | string containing a valid IP | |||||
Destination IP | SshKey.DestinationIP | ||||||
Yes | No | Operation | launch template | LaunchTemplate.Operation ImportantAny detection rule with the | XDR | is | any | Possible values: |
Yes | Yes | Name | LaunchTemplate.Name | is | contains | any | string | ||
Id | LaunchTemplate.Id | ||||||
Source user | LaunchTemplate.SourceUser | ||||||
Destination user | LaunchTemplate.DestinationUser | ||||||
Source IP | LaunchTemplate.SourceIP | string containing a valid IP | |||||
Destination IP | LaunchTemplate.DestinationIP | ||||||
Yes | No | Operation | service principal | ServicePrincipal.Operation ImportantAny detection rule with the | XDR | is | any | Possible values:
|
Yes | Yes | Name | ServicePrincipal.Name | is | contains | any | string | ||
Id | ServicePrincipal.Id | ||||||
Source user | ServicePrincipal.SourceUser | ||||||
Destination user | ServicePrincipal.DestinationUser | ||||||
Source IP | ServicePrincipal.SourceIP | string containing a valid IP | |||||
Destination IP | ServicePrincipal.DestinationIP | ||||||
Yes | No | Operation | user group | UserGroup.Operation ImportantAny detection rule with the | XDR | is | any | Possible values: |
Yes | Yes | Name | UserGroup.Name | is | contains | any | string | ||
Id | UserGroup.Id | ||||||
Source user | UserGroup.SourceUser | ||||||
Destination user | UserGroup.DestinationUser | ||||||
Source IP | UserGroup.SourceIP | string containing a valid IP | |||||
Destination IP | UserGroup.DestinationIP | ||||||
Yes | No | Operation | automation account | AutomationAccount.Operation ImportantAny detection rule with the | XDR | is | any | Possible values: |
Yes | Yes | Name | AutomationAccount.Name | is | contains | any | string | ||
Id | AutomationAccount.Id | ||||||
Source user | AutomationAccount.SourceUser | ||||||
Destination user | AutomationAccount.DestinationUser | ||||||
Source IP | AutomationAccount.SourceIP | string containing a valid IP | |||||
Destination IP | AutomationAccount.DestinationIP | ||||||
Yes | No | Operation | automation account hook | AutomationAccountHook.Operation ImportantAny detection rule with the | XDR | is | any | Possible values: |
Yes | Yes | Name | AutomationAccountHook.Name | is | contains | any | string | ||
Id | AutomationAccountHook.Id | ||||||
Source user | AutomationAccountHook.SourceUser | ||||||
Destination user | AutomationAccountHook.DestinationUser | ||||||
Source IP | AutomationAccountHook.SourceIP | string containing a valid IP | |||||
Destination IP | AutomationAccountHook.DestinationIP | ||||||
Yes | No | Operation | api | Api.Operation ImportantAny detection rule with the | XDR | is | any | Possible values:
|
Yes | Yes | Name | Api.Name | is | contains | any | string | ||
Id | Api.Id | ||||||
Destination user | Api.DestinationUser | ||||||
Source user | Api.SourceUser | ||||||
Source IP | Api.SourceIP | string containing a valid IP | |||||
Destination IP | Api.DestinationIP | ||||||
Yes | No | Operation | certificate authority | CertificateAuthority.Operation ImportantAny detection rule with the | XDR | is | any | Possible values:
|
Yes | Yes | Name | CertificateAuthority.Name | is | contains | any | string | ||
Source user | CertificateAuthority.SourceUser | ||||||
Destination user | CertificateAuthority.DestinationUser | ||||||
Source IP | CertificateAuthority.SourceIP | string containing a valid IP | |||||
Destination IP | CertificateAuthority.DestinationIP | ||||||
Yes | No | Operation | bucket | Bucket.Operation ImportantAny detection rule with the | XDR | is | any | Possible values:
|
Yes | Yes | Name | Bucket.Name | is | contains | any | string | ||
Source user | Bucket.SourceUser | ||||||
Destination user | Bucket.DestinationUser | ||||||
Source IP | Bucket.SourceIP | string containing a valid IP | |||||
Destination IP | Bucket.DestinationIP | ||||||
No | Yes | Name | bitbucket repository | BitbucketRepository.Name | XDR | is | contains | any | string |
Id | BitbucketRepository.Id | ||||||
Destination user | BitbucketRepository.DestinationUser | ||||||
Source user | BitbucketRepository.SourceUser | ||||||
URL | BitbucketRepository.Url | ||||||
Source IP | BitbucketRepository.SourceIP | string containing a valid IP | |||||
Destination IP | BitbucketRepository.DestinationIP | ||||||
Yes | No | Operation | jira project | JiraProject.Operation ImportantAny detection rule with the | XDR | is | any | Possible values:
|
No | Yes | Id | JiraProject.Id | is | contains | any | string | ||
Yes | Yes | Name | JiraProject.Name | ||||
Domain | JiraProject.Domain | ||||||
Destination user | JiraProject.DestinationUser | ||||||
Source user | JiraProject.SourceUser | ||||||
Source IP | JiraProject.SourceIP | string containing a valid IP | |||||
Destination IP | JiraProject.DestinationIP | ||||||
Yes | No | Operation | confluence page | ConfluencePage.Operation ImportantAny detection rule with the | XDR | is | any | Possible values: |
No | Yes | Id | ConfluencePage.Id | is | contains | any | string | ||
Yes | Yes | Name | ConfluencePage.Name | ||||
URL | ConfluencePage.Url | ||||||
Destination user | ConfluencePage.DestinationUser | ||||||
Source user | ConfluencePage.SourceUser | ||||||
Source IP | ConfluencePage.SourceIP | string containing a valid IP | |||||
Destination IP | ConfluencePage.DestinationIP |