The new docs.trellix.com offers a modernized UI and AI-powered features like conversational searches. Content is currently available only in English. Other languages will be available in mid-October 2026. We hope you enjoy the new experience.

Commands specific to Access Protection rules

Prev Next

When you create a rule, use parameters to block enable/disable, to apply the rule to specific users, files, or processes. You can also use parameters to report the number of tries made to access the rule-enabled files. You can also edit any rule using rule index. The getallaprules command lists all access protection rules with rule index created for a system.

Access Protection parameters to create rules

Options

Description

--rulename [value]

This command is used to name the Access Protection custom rule. Here, value can be alphanumeric and can take a maximum of 256 characters. Each custom rule name must be unique. When creating a rule, this parameter is mandatory.

--block [enable | disable]

This command is used to enable or disable blocking of access attempts defined in the rule. This parameter is mandatory.

The parameter to enable or disable the block command:--block [enable | disable]

Note

When creating a rule, both --block or --report parameters are mandatory. A rule is disabled when both --block and –report are disabled. If both rules exist, then block is given the higher precedence.

--report [enable | disable]

This command is used to enable or disable reporting of access tries. This parameter is mandatory.

Note

When creating a rule, both --block or --report parameters are mandatory. A rule is disabled when both --block and –report are disabled. If both rules exist, then block is given the higher precedence.

  • --includeprocess [name1:file1, name2:file2,…]

  • --excludeprocess [name1:file1, name2:file2,…]

This is an optional parameter and specifies the applicable process that triggers the rule if there is a subrule violation. You can identify a process with a name and a file. File can be either the file name or path. Wildcards [*, ?, and **] and comma-separated values are also accepted.

Note

When --includeprocess and --excludeprocess are not specified, the rule becomes applicable to all processes.

When the same process is mentioned in --includeprocess and --excludeprocess, then --excludeprocess takes higher precedence.

  • --includeusers [user1, user2,…]

  • --excludeusers [user1, user2,…]

--includeusers triggers the rule for the specified users when there is a violation, whereas --excludeusers does not trigger the rule even when there is a rule violation. These parameters are optional and can accept comma-separated values. Local and Domain users are supported.

Note

When --includeusers and --excludeusers are not specified, the rule becomes applicable to all users.

When the same user is mentioned in --includeusers and --excludeusers then --excludeusers takes higher precedence.