--- title: "Managing YARA rule policies" slug: "managing-yara-rule-policies" tags: ["Email Security - Cloud", "Customer", "Cloud Security"] updated: 2026-09-04T18:57:29Z published: 2026-09-04T18:57:29Z canonical: "docs.trellix.com/managing-yara-rule-policies" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Managing YARA rule policies YARA rules analyze and detect potentially malicious textual or binary patterns within an email body, header, or attachment. Rules you write in a YARA file can be uploaded to the Email Security — Cloud Web UI and assigned to a domain. YARA rules can be configured to monitor, alert, or alert and quarantine when email matches the patterns you specify in a YARA file. ![ETP_yara.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-eef14ea6-2a8e-04e3-fd0c-36270b093926.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A13%3A52Z&se=2026-11-22T14%3A13%3A52Z&sr=c&sp=r&sig=USqhsjgR4J0Es7t5bOj5TGVYCx0Af5tMCo87ugGElUU%3D) All rules are implicitly set to **Monitor** mode by default. A rule set to **Monitor** mode will collect data on or tag matching email messages, but it will not quarantine messages or send an alert. One use case for Monitor mode is to test the effectiveness of an uploaded rule before configuring it in Alert and Quarantine mode. Select **Alert** or **Alert and Quarantine** to change the mode. A rule set to **Alert** mode will generate an alert. A rule set to **Alert and Quarantine** mode quarantines detected messages and generates an alert. > [!NOTE] > Note > > The rule mode is set to Monitor unless you select Alert or Alert and Quarantine. A single YARA rule file can only be set to one action mode. However, if two identical YARA rules are uploaded, they can be assigned different modes. For example, one rule can be set to Alert and Quarantine mode and the other to Monitor or Alert mode. The actions associated with Alert and Quarantine mode (generating an alert and quarantining the message) will take precedence if two separate YARA rules match against the same message. However, the Events tab of Message Details will include details for both Monitor and Alert and Quarantine mode hits. Alerts generated from Alert and Alert and Quarantine mode YARA rules can be searched for in Email Trace. See [Adding more filters](/data-and-email/docs/adding-more-filters) for more information. A YARA file can contain multiple rules, including global rules and private rules. Global rules are evaluated before other rules and they apply rule conditions to all other rules you upload. Private rules do not trigger alerts when matched against an email. ##### Creating a YARA rule file YARA files must meet the guidelines of YARA 4.3.0. For guidance on writing YARA rule files, see *Writing YARA Rules* by Victor Alvarez. ##### Creating and managing a YARA rule policy **To create a custom YARA rule policy in Email Security — Cloud:** 1. On the Policies page, click **Create Policy**. 2. Select the rule type **YARA Rules** and provide a policy name and description (optional). Click **Create**. 3. The policy configuration page opens. Under Rules, select **Manage**. 4. Set the YARA rule actions. Select **Alert** or **Alert and Quarantine**. If neither are selected, the rule mode is set to monitor. 5. Click **Add Ruleset**. ![ETP_YaraCreateRule.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-ccadc8b9-fb87-a0de-5021-602493908423.png?sv=2026-02-06&spr=https&st=2026-11-22T13%3A13%3A52Z&se=2026-11-22T14%3A13%3A52Z&sr=c&sp=r&sig=USqhsjgR4J0Es7t5bOj5TGVYCx0Af5tMCo87ugGElUU%3D) 6. Click in the YARA File field and browse to your YARA file. 7. Enter the ruleset name and description (optional). 8. By default, the rule weights defined in the YARA file are used. To override the rule weights, select **Override Rule Weight**. Drag the RuleSet Weight slider to indicate the weight of the rules. All rules in the YARA file will use the weight you define. - 0: The rule will be monitored. - 1-50: The rule will follow the rule actions set for that range. - 51-99: The rule will follow the rule actions set for that range. - 100: The rule will be considered malicious and will alert and quarantine when matched. 9. Select **Base Content**, **Active Content**, or **Base + Active Content** in the content type drop-down menu. Active Content and Base + Active Content only apply to attachments. - Base content—Allows Email Security to apply the YARA rule to a particular file type or to all common file types. The appliance does not extract the macro from the attachment. - Active content—Allows Email Security to apply the YARA rule to DOC, DOCX, PPT, PPSX, PPTX, XLS, XLSX, or common file types. The appliance extracts the macro from the attachment for analysis. - Base + Active content—Allows Email Security to apply the YARA rule to DOC, DOCX, PPT, PPSX, PPTX, XLS, XLSX, or common file types. The appliance analyzes the attachment and extracts the macro from the attachment for analysis. 10. Select the part of an email that is analyzed by the rule (header, body, header and body, or attachment). > [!NOTE] > Note > > You must configure a rule action for the part of the email you selected to be analyzed. 11. Click **Save Ruleset**. 12. In the YARA Rules Action Configuration section, select **Alert** or **Alert and Quarantine** for each option. All rule sets configured in the policy will follow the selected actions. 13. Click **Save Actions**.