--- title: "Policy Auditor 6.5.x Product Guide" slug: "mpa-654-pg-0-00-en-us" tags: ["Policy Auditor", "Product Usage"] updated: 2026-08-17T07:36:53Z published: 2026-08-17T07:36:53Z canonical: "docs.trellix.com/mpa-654-pg-0-00-en-us" --- > ## 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. # Policy Auditor 6.5.x Product Guide --- # Overview At audit time, accuracy and timeliness are critical. Whether you need to prove compliance with mounting external regulations, quickly assess system patch status to prevent exploitation of vulnerabilities, or reduce liability by proving that your organization is following best practices, Trellix Policy Auditor eases the pressure. Trellix Policy Auditor helps you stay compliant, reduce costs and manual effort, and increase visibility. Our easy-to-manage solution automates and simplifies the process, helping you to quickly assess patch deployment progress, monitor critical security configurations, and report consistently and accurately against key industry mandates and internal policies across your entire infrastructure or on specific systems. ## Key features Trellix Policy Auditor eases audits through integration with Trellix ePO - On-prem, which unifies management and reporting. Trellix ePO - On-prem also facilitates policy customization and creation. These are some of the key features of Trellix Policy Auditor. - **Audit management —** Audit management allows you to create audits based on benchmarks and assign them to run on systems. Trellix Policy Auditor evaluates systems against independent standards that are developed by government agencies and private industry. It also evaluates systems against standards you create (using Benchmarks that you create). - **Benchmark management —** Benchmarks are documents containing an organized set of rules describing the wanted state of a system. A benchmark is the core component of an audit and can be used by Trellix Policy Auditor and other Trellix or third-party products. You can download the benchmark content, then activate or tailor the benchmark. - **Audit waivers —** Waivers allow you to temporarily change how systems are audited, for systems that might affect the audit scores. They are useful when you have systems that you know might be out of compliance but you don't want to bring the system into compliance for a temporary period. - **Audit findings —** Findings supplement the results of an audit check with additional information about the state of the system. Instead of seeing a value of false for a test result, findings give more meaningful information such as the minimum password length is set to 6 but it should be set to 8 or higher. - **File integrity monitoring and entitlement reporting —** File integrity monitoring notifies you of changes to specified text files on managed systems. Entitlement reporting informs you of changes to user and group rights to files. These features are useful for complying with government and industry standards, such as the Payment Card Industry (PCI) Data Security Standard. - **Advanced host assessment inventory scan —** Scan for inventory items such as applications, operating systems details, and ports in use. This allows you to monitor and log changes of these inventory items, and helps you identify deviations from a baseline. - **Roll-up reporting —** Roll-up reporting utilizes the roll-up functionality of Trellix ePO - On prem. You can run queries that report on summary data from multiple Trellix ePO - On-prem databases. Trellix Policy Auditor can use this feature to create rollup reports for audit results. ## How it works Trellix Policy Auditor gives you a broad visibility into the state of your network-connected devices across your IT infrastructure. It evaluates the status of managed systems relative to audits that contain benchmarks. This workflow gives you a high-level overview of how Trellix Policy Auditor works. 1. On Trellix ePO - On-prem, you create audits or inventory collection tasks. 2. You run the task immediately or schedule it for a later time. 3. On execution of the task, Trellix ePO - On-prem requests the Policy Auditor agents to collect information from the managed systems. 4. At the managed system, Policy Auditor or Advanced Host Assessment agents collect the information requested by Trellix ePO - On-prem. 5. The agents then have the audits or inventory collection data sent back to Trellix ePO - On-prem. 6. You can then generate reports, view the information about the dashboards, or export the result. ![Workflow diagram titled McAfee ePO showing a numbered 6-step flow: 1 Administrator icon, 2 Collection task gear icon, 3 Arrow labeled Request to collect information, 4 Box labeled Systems with PA Agents containing multiple PC icons, 5 Arrow labeled Collected information, and 6 Dashboard view and reporting icons; arrows indicate information flow between Trellix ePO and managed systems.](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/mpa_654_pg_0-00_en-us_page_0008_img_01.png?sv=2026-02-06&spr=https&st=2026-11-22T17%3A42%3A49Z&se=2026-11-22T18%3A42%3A49Z&sr=c&sp=r&sig=2cnmzCQ%2FMpv2BwebMeI%2FavUwR%2FhNl1lenhanwzVl1fo%3D) --- # Getting started with Trellix Policy Auditor Trellix Policy Auditor is an extension to Trellix ePO - On-prem software versions 5.9, 5.9.1, and 5.10, which automates the process for risk and compliance system audits. Audits can perform tasks such as check system settings, including password length, open or closed ports, file changes, and the presence of software updates. ## Introduction to compliance audits Before using Trellix Policy Auditor, it is important to understand what audits are, when you must use them, and why you must use them. ### What are compliance audits? A compliance audit is a comprehensive review of an organization's adherence to external regulatory guidelines or internal best practices. Trellix Policy Auditor automates the compliance audit process and allows you to show compliance to auditors by producing an audit trail showing compliance, compliance history, and actions taken to mitigate risks. Organizations that are out of compliance might be subject to fines or other sanctions, including criminal liability. ### When should you use audits? Use compliance audits when you are subject to government regulations that require your organization to determine system compliance and maintain records. You must also use audits to determine compliance with organizational requirements such as password complexity, password length, the presence of unsupported software, and software patch requirements. ### Why should you use audits? Trellix Policy Auditor automates the process for mandated and organizational audits. Its companion product, Trellix Benchmark Editor, contains built-in benchmarks that the software can use for mandated audits, such as Sarbanes-Oxley (SOX) and the Payment Card Industry Data Security Standards (PCI DSS). The reporting system allows you to show compliance to auditors while the Findings feature helps you to find solutions to audit issues. ## Auditing systems An audit is an independent evaluation of a computer system to determine whether it is in compliance with corporate and industry security standards. Audit results show recommended improvements to reduce risks. Trellix Policy Auditor evaluates systems against independent standards developed by government and private industry. It can also evaluate systems against standards that you create yourself. Trellix Policy Auditor uses audits to determine the compliance status of systems and returns results indicating any areas where the system is out of compliance. ### Scoring audits When you audit a system with Trellix Policy Auditor, it returns a score indicating how well the system complied with the audit. Trellix Policy Auditor supports the four scoring models described in the Extensible Configuration Checklist Description Format (XCCDF) 1.2 specifications. ## Software components and what they do Trellix Policy Auditor installs components that help you analyze systems for compliance with recognized, open-source standards and standards that you can create yourself. These are the Trellix Policy Auditor components as they appear in the interface: | Component | Function | | --- | --- | | Benchmark Editor | A utility used to enable, disable, create, and edit benchmarks. Each audit must contain at least one benchmark. Ideally, audits must contain only one benchmark. | | Benchmark Editor Content Distributor | Distributes content downloaded from Trellix Labs to systems. | | Findings | Manages findings, which help you understand why an audit check failed and provides information about how to fix the problem. | | PACore | The primary part of the software that controls all other features. | | PARollup | Uses the rollup capabilities of the Trellix ePO - On-prem software to collect summary information from registered Trellix ePO - On-prem servers and show aggregated data. | | Trellix Policy Auditor | Handles policy and task management, audit schedules, and system management. | | Advanced Host Assessment | Advanced Host Assessment allows you to do the following: - Create and edit host inventory scans - Manage scan results and reports. | | Advanced Host Assessment Content Distributer | Processes the Advanced Host Assessment Content into the server when it is checked into the master repository. | ### Trellix Policy Auditor agent The Trellix Policy Auditor agent plug-in expands the ability of the Trellix Agent to support Trellix Policy Auditor. When audits are deployed to systems with the Trellix Agent the agent plug-in determines when the audits must be run. The agent plug-in conducts audits at the appropriate time and returns the results to the Trellix ePO - On-prem server. The agent plug-in can conduct audits when the managed system is off the network, and returns results to the Trellix ePO - On-prem server once the system is reconnected to the network. Installing the agent plug-in adds a product icon to the Trellix Agent notification area. In Windows environments, the product icon optionally displays a balloon tip to indicate the system is being audited. Systems that have the Trellix Policy Auditor agent plug-in installed are known, in Trellix Policy Auditor terminology, as managed systems. ## Use of Trellix ePO - On-prem features Trellix Policy Auditor is an extension of the Trellix ePO - On-prem software, and uses and relies on many of its features. Trellix Policy Auditor is configured from Trellix ePO - On-prem. The Trellix ePO - On-prem server is the center of your managed environment and provides a single location where you can administer and monitor security settings throughout your network. You can use the default settings or configure the settings to match your organizational needs. This table lists the applicable the Trellix ePO - On-prem software features and describes how they are used by Trellix Policy Auditor. You must become familiar with each of the listed features and their uses. | Trellix ePO - On-prem feature | Location | Used by Trellix Policy Auditor | | --- | --- | --- | | Assign Policies | Menu \| Systems \| System Tree \| Assigned Policies | To assign policies, like file integrity monitor, to managed systems. | | Client tasks | Menu \| Systems \| System Tree \| Client Tasks | - To deploy the Trellix Policy Auditor agent plug-in to detected systems. - To update the Trellix Policy Auditor agent plug-in to the latest version. - To wake up the Trellix Agent on selected systems. | | Contacts | Menu \| User Management \| Contacts | To create user contact information when you want to notify specific personnel by email of an event. | | Dashboards and Monitors | Menu \| Reporting \| Dashboards | - To create a dashboard with Trellix Policy Auditor monitors - To manage the various dashboards that you use for policy audits - To access detailed information about policy audits | | Issues | Menu \| Automation \| Issues | To prioritize, assign, and track issues. Issues can also be associated with tickets in a third-party ticketing server. | | Policy Catalog | Menu \| Policy \| Policy Catalog | - To manage the times when audits are allowed to audit systems. - To manage settings for the file integrity monitor. | | Queries | Menu \| Reporting \| Queries | To create and maintain database queries regarding system security information. | | Registered Executables | Menu \| Configuration \| Registered Executables | To register a command that can be run on the server as part of an automatic response. | | Repositories | Menu \| Software \| Master Repository | To check in and manage content required by Trellix Policy Auditor, such as the Audit Engine content with all compliance and threat checks and published benchmarks. | | Server Settings | Menu \| Configuration \| Server Settings | To specify parameter values affecting the operations of Trellix Policy Auditor. | | Server Tasks | Menu \| Automation \| Server Tasks | - To manage Exemption Expiration. - To process audit results. - To process inventory scan results. | | Tag Catalog | Menu \| Systems \| Tag Catalog | To create tags that can be used to help organize your systems. | | Users | Menu \| User Management \| Users | To create or edit a specific person as a user of Trellix Policy Auditor and their permission type. | ## Managed systems Knowing how Trellix Policy Auditor classifies systems on your network is important for setting up and using the product, and for using its features. Trellix Policy Auditor uses two system classifications: Managed systems. - Managed systems — Systems in the System Tree that have both the Trellix Agent and the Trellix Policy Auditor agent plug-in installed. These classifications, and their characteristics and requirements, apply exclusively to Trellix Policy Auditor functionality. Other Trellix products might use the same classifications, but with different characteristics or requirements. ### Auditing managed systems When connected to a network managed by Trellix ePO - On-prem, managed systems can exchange information with the Trellix ePO - On-prem server as scheduled. The primary advantage of managed systems is is that they are audited by the agent even when they are not connected to the network. When they are reconnected, the Trellix Policy Auditor agent plug-in communicates the results to Trellix Policy Auditor. The Trellix Policy Auditor agent plug-in slightly increases memory and processor use. # Configuring Trellix Policy Auditor Trellix Policy Auditor is configured from the Trellix ePO - On-prem server. The server is the center of your security environment, providing a single location where you administer system security throughout your network. ## Server settings and what they control Trellix supplies default settings for Trellix Policy Auditor, findings, and Advanced Host Assessment. You can change server settings to fit your organizational needs. These are the server settings for Trellix Policy Auditor, Findings, and Advanced Host Assessment Scans. [Table 3-1 Trellix Policy Auditor server settings](/docs/mpa-654-pg-0-00-en-us#) | Server setting | Description | | --- | --- | | Audit data retention | Purges all audit data older than a designated date. You can also manage the purge settings for individual audits, based on how long you need to maintain the audit data. In large and complex organizations, the retention times for audit data may vary by audit. The ability to specify data maintenance per audit lowers the cost of maintaining audit data. - **Enable audit data purging —** Allow Trellix Policy Auditor to purge audit data older than a specified date. This setting is enabled by default. - **Only retain latest results for a system —** Retain only the latest audit data for a system. - **Purge findings data after —** Edit to specify how long findings data should be retained. The default setting is 12 months. - **Stop Data Maintenance after —** If PA: Purge Audit Results runs longer than the time specified, the task stops to allow other data maintenance tasks to run. When the task restarts, it resumes where it left off. The default setting is 2 hours. - **Remove related Findings results when purging Audit Results —** Select to purge findings data when purging audit results. This setting is selected by default. - **Purge unreferenced benchmark results —** Purge benchmark results that are removed from the audit. | | Audit data stream result retention | Purges the audit data stream older than a designated date. - **Only retain the latest results for a system —** Retain the latest audit data stream data only. - **Purge audit data stream result after —** Edit to specify how long to retain audit data stream data. The default is 12 months. | | Audit label | Allows you to use different descriptions for the default labels of Pass, Fail, Pass-Expired, Fail-Expired, Not Scored-Expired, Not Scored, or No Results. For example, instead of the word Pass, you can choose to use the word Successful. Trellix recommends that you keep the default settings. | | **Audit result detail level** | Findings provide information about why checks failed in an audit. Providing more detail helps when reviewing audits, but can impact the size of the database. **Note:** These settings can be overridden on a per audit basis. - **Generate and store Findings. Always retain thin OVAL Results.** — Generates and stores Findings for all audits. Also retains thin OVAL results for all audits. Thin results retain minimal information. This includes the OVAL ID and results. This does not include child elements or system characteristic information. This is the default setting. - **Generate and store Findings. Retain full OVAL results for failed non-patch checks with no XSLT generated Findings.** — Generates and stores Findings for all audits. Also retains full OVAL results for all failed, non-patch checks that do not have any XSLT generated Findings. This includes the results of the evaluated definition, extended definitions, and information gathered from the system. - **Do not generate and store Findings. Always retain thin OVAL Results.** — Only thin OVAL results are retained for all audits. Thin results retain minimal information. This includes the OVAL ID and results. This does not include child elements or system characteristic information. - **Do not generate and store Findings. Retain full OVAL results for all failed non-patch checks.** — Only full OVAL results for all failed non-patch checks are retained. This includes the results of the evaluated definition, extended definitions, and information gathered from the system. - **Discard "Not Applicable" rule results.** — Discards all rule results that are not applicable. | | **Audit score** | Indicates how well a system conforms to the ideal settings specified in an audit. You can change the scoring definitions to reflect your organization's determination of what constitutes a passed or failed audit. - **Minimum High Score** — Any score equal to or greater than this setting means that the system passed the audit. The default setting is 80. - **Audit Score - Fail** — Any audit score equal to or lower than this setting means that the system failed the audit. The default setting is 60. - **Maximum Low Score** — Any score less than the Minimum High Score but higher than the Audit Score - Fail setting means that the audit had mixed results: it neither passed nor failed. By default, an audit score between 60 and 80 is assigned a score category of Other. | | **Audit score categories** | Provides four categories with default names and colors that describe the success of an audit. You can change the names to fit your organization's requirements, but most users find the default names appropriate and easy to understand. - **High** — The system passed the audit. - **Low** — The system failed the audit. - **Medium** — The system has mixed audit results. Critical systems warrant attention to fix the audit failures, while non-critical systems might be left as is. - **Unknown** — Trellix Policy Auditor is unable to determine whether the system passed an audit. Situations yielding a status of Unknown include systems taken off the network or turned off. | | **Database Maintenance - allow online rebuild of indexes** | Enables database maintenance features, including the rebuilding of indexes. | | **Database Maintenance - maintain indexes whose fragmentation exceeds this percentage** | Specifies the amount of fragmentation that triggers index rebuilding and related maintenance. | | **Database Maintenance – stop processing after this time** | Specifies the amount of time, in hours, that database maintenance tasks run before stopping. | | **Default Scoring Model** | Supports the four standard eXtensible Configuration Checklist Description Format (XCCDF) scoring models. These scoring models are described in detail in *Scoring Audits*. The default scoring model is **Flat Unweighted**. This computes the score (the number of rules that passed) and compares it against the maximum possible score. | | **Differentiate expired results in a query** | Controls whether expired results are differentiated in a query. You can show expired results as expired or differentiate them as follows: - **pass-expired** — The results have expired but the last audit results evaluated to pass. - **fail-expired** — The results have expired but the last audit results evaluated to fail. - **other-expired** — The results have expired and the previous audit results evaluated to a condition other than pass or fail. | | **Frequency to run update audit assignments** | Defines the value, in hours, for running the **PA: Update Audit Assignments** server task. Trellix Policy Auditor sends audit content only to systems that are scheduled to receive the content. This reduces bandwidth and lessens client system disk space requirements. | | **Generate result data stream on target system** | Controls how much data stream information is generated for each target system. - **Do not generate result data stream** — Doesn't generate any result data. - **Full results with system characteristics** — Generates full results, including system characteristics for each target system. Full results retain detailed information, allowing you to generate in-depth reports from the results. This includes the results of the evaluated definition, extended definitions, and information gathered from the system. - **Full results without system characteristics** — Generates full results for each target system, but doesn't include system characteristics. Full results retain detailed information, allowing you to generate in-depth reports from the results. This includes the results of the evaluated definition and extended definitions. - **Thin Results** — Generates only thin results for each target system. Thin results retain minimal information. This includes the OVAL ID and results. This does not include child elements or system characteristic information. | | **Index configuration** | Controls database indexing that can improve either results processing or generating reports/queries. > **Note:** Index Configuration changes take effect when the PA: Maintain Database task is run. - **Minimal Indexing** — Maintains fewer indexes for faster results processing and a smaller database. Might have a negative impact when generating reports or queries. - **Hybrid Indexing** — Balances the indexing between results processing and reporting/query performance. This is the default setting. - **Maximum Indexing** — Maintains a higher number of indexes for faster performance when generating a report or query. Might have a negative impact on the database size and when processing results. | | **Max number of FIM version files** | Defines the number of file integrity file versions to store for use with FIM. You can store up to six versions of each monitored text file, including the baseline version. See *File Integrity Monitoring* for information on baselines and file versions. | | **Minimum pass percentage for rule aggregation** | Aggregates the results in queries and reports when the percentage of rules that pass in an audit exceed the defined percentage. | | **Number of benchmark results to purge per batch** | Specifies the number of benchmark results purged when purging audit results. | | **Threads for audit results processing** | Specifies the number of processing threads allotted to audit results. The default number is 5. | | **Threads for Findings Processing** | Specifies the number of processing threads allotted to Findings. The default number is 5. | | **Threads for File Integrity Processing** | Specifies the number of processing threads allotted to File Integrity Processing. The default number is 5. | | **Violation limit** | Limits the number of violation shown in reports through the **Violation limit** setting. Findings provide information about why checks failed in an audit. Because an audit might report thousands of violations, you can limit the number of violations shown. By default, Trellix Policy Auditor truncates the number of violation results to 300. | | **Findings data retention** | Enable or disable data purging through Findings. - **Purge findings data after** – Define the purge period in months for the Findings data. - **Purge Findings server task window - stop task after this time** – Define the period in hours to stop the Findings server task. | | Reset Baseline | Resets the baseline for your inventory scan. | | Include Inventory Items Flag | Select these inventory items to include in the scan report. - Applications - Services - Ports - CPEs > **Note:** > > - The settings to include or exclude CPEs from the scan is available only in the Server Settings page. > - If your organization has a mechanism to generate your own CPEs, ensure that **Include CPEs** is disabled to avoid incorrect data. - Operating system - Network interfaces - System Information - Registered Extensions | # Edit Trellix Policy Auditor server settings Edit the Trellix Policy Auditor server settings to fit your organizational and business needs. You must be an administrator to perform this task. **Task** 1. On the Trellix ePO - On-prem interface, select **Menu | Configuration | Server Settings**. 2. Under **Setting Categories**, select **Policy Auditor**. The Trellix Policy Auditor server settings appear in the main panel. 3. Click **Edit** to open the settings page. 4. Change the settings as needed, then click **Save**. ## How permission sets work When Trellix Policy Auditor is installed, it adds a permission group to each permission set. When you create a permission set, the Trellix Policy Auditor permission group is added to the set. One or more permission sets can be assigned to users who are not administrators (administrators have all permissions to all products and features). Permission sets only grant rights and access — no permission ever removes rights or access. When multiple permission sets are applied to a user account, they aggregate. For example, if one permission set does not provide any permissions to server tasks, but another permission set applied to the same account grants all permissions to server tasks, that account has all permissions to server tasks. Consider this as you plan your strategy for granting permissions to the users in your environment. #### How users, groups, and permission sets fit together Access to items in Trellix ePO - On‑prem is controlled by interactions between users, groups, and permission sets. For more information about how they interact, see *How users, groups, and permission sets fit together in Trellix ePO - On‑prem 5.10 Software Product Guide*. ## Trellix Policy Auditor permission sets Trellix Policy Auditor includes seven default permission sets that provide permissions for Trellix Policy Auditor and related applications. | Permission set | Component | Permissions | | --- | --- | --- | | PA Admin | Benchmark Editor | - Activate benchmarks - Edit benchmark tailoring - Create, delete, and apply labels - Create, delete, modify, import, and unlock benchmarks - Create, delete, and import checks | | PA Admin | Findings | - View and hide/unhide findings | | PA Admin | Issue Management | - Create, edit, view, and purge assigned issues | | PA Admin | Policy Assignment Rule | - View and edit rules | | PA Admin | Policy Auditor | - Accept and delete events, and reset system baseline - Allow access to Enterprise Manager - Grant and modify waivers - Allow access to File Entitlement - Add, remove, and change audits and assignments | | PA Admin | Trellix Policy Auditor Agent | - View and change settings - View Trellix Policy Auditor rollup reports | | PA Agent Admin | Trellix Policy Auditor Agent | - View and change settings | | PA Agent Admin | Advanced Host Assessment | - View and change Advanced Host Assessment policy - View and change Advanced Host Assessment task | | PA Audit Admin | Benchmark Editor | - View and export checks - View and export benchmarks | | PA Audit Admin | Findings | - View and hide/unhide findings | | | **Issue Management** | - Basic: Create issues and edit, view, and purge issues created by or assigned to me - Request Waiver: Create issues and edit, view, and purge issues created by or assigned to me - Benchmark Rule Compliance: Create issues and edit, view, and purge issues created by or assigned to me | | | **Policy Auditor** | - View Waivers - Allow access to Enterprise Manager - Add, remove, and change audits and assignments | | **PA Benchmark Activator** | **McAfee Benchmark Editor** | - Activate benchmarks - View and export checks - View and export benchmarks | | **PA Benchmark Editor** | **McAfee Benchmark Editor** | - Edit benchmark tailoring - Create, delete, and apply labels - Create, delete, and import checks - Create, delete, change, and import benchmarks | | **PA Scan Admin** | **Advanced Host Assessment Agent** | - View scans and assignments - Add, remove, and change scans and assignments. | | | **Advanced Host Assessment** | - View and change task settings - View and change Advanced Host Assessment policy settings. - Edit agent policy | | | **Server tasks** | - Create, edit, view, run, and end Scheduler tasks. - View the Scheduler tasks results in the Server Task Log. | > **Note:** These permissions are disabled by default. You need to enable it manually to create, run, and monitor scans. ### Systems View the **System Tree** tab. > **Note:** These permissions are disabled by default. You need to enable it manually to create, run, and monitor scans. | **Permission set** | **Component** | **Permissions** | | --- | --- | --- | | System Tree access | | Enable the following options: - Can search on the following nodes and portions of the System Tree: My Organization - Can access the following nodes and portions of the System Tree: My Organization > **Note:** These permissions are disabled by default. You need to enable it manually to create, run, and monitor scans. | | PA Viewer | **McAfee Benchmark Editor** **Findings** **Policy Auditor** | - View and export checks - View and export benchmarks - View findings - Allow access to File Entitlement - View Events - View waivers - View audits and assignments | | Advanced Host Assessment Agent | **Advanced Host Assessment** | - View scans and assignments - View and change Advanced Host Assessment policy. - View and change Advanced Host Assessment task. - View task settings | | PA Waiver Granter | **McAfee Benchmark Editor** **Findings** **Issue Management** | - View and export benchmarks - View and export checks - View findings - Create, edit, view, and purge assigned issues - Benchmark rule comparison: Create issues and edit, view, and purge issues created by or assigned to me - Request waiver: Create, edit, view, and purge issues | | | ### Edit permission sets You can edit the default Trellix Policy Auditor permission sets or create your own. You must be an administrator to perform this task. For option definitions, click ? in the interface. ### Task 1. In the Trellix ePO - On-prem interface, click **Menu | User Management | Permission Sets**, then select the permission set. 2. Click **Edit** next to the Trellix Policy Auditor permission group. The Edit Permission Set page appears. 3. Select the appropriate options, then click **Save**. 4. Repeat for all appropriate sections of other permission sets. # Using the Trellix Policy Auditor agent The Trellix Policy Auditor agent manages the schedule for performing audits, runs the audits, and returns the results to the server. You install the Trellix Agent and the Trellix Policy Auditor agent on managed systems. This enables audits to be conducted even if a system is not connected to the network. When the system reconnects to the network, it returns audit information to the server and receives updated content and schedules for future audits from the Trellix Policy Auditor server. ## How the Trellix Policy Auditor agent works The Trellix Policy Auditor agent updates the audit schedule on managed systems, launches audit scans according to a schedule, and returns results to the server. Install the Trellix Agent and the Trellix Policy Auditor agent on your managed systems. The agent can perform audits when a system is not connected to its network. When the system reconnects to the network, the agent returns the results to the server. The schedule relies on whiteout and blackout periods that you set. *Audit whiteout periods* are times when an audit can run on a system or group of systems. *Audit blackout periods* are times when an audit can't run. The Trellix Policy Auditor agent determines the age of the current information and uses pending blackout or whiteout windows to determine when content should be re-evaluated. When the Trellix Policy Auditor agent receives notification that the audit is complete, it calculates and stores the date and time of the next scheduled audit. You can use the **Run Audits** feature of Trellix ePO - On‑prem to force an immediate scan. When you do this, the agent marks the frequency information as expired and recalculates the date and time for the next scheduled audit. The recalculated date and time are always scheduled during a whiteout period. The Trellix Policy Auditor agent can perform audits when a system is not connected to its network. When the system reconnects to the network, the Trellix Policy Auditor agent returns the results to the server. ## How content is managed Content for Trellix Policy Auditor consists of benchmarks and checks. The content package is included when the product is installed, and is placed into the Trellix ePO - On‑prem **Master Repository**. Before you can use benchmarks in audits, you must activate them in Trellix Benchmark Editor. The **Master Repository** is updated daily by a server task that is included with the software. If you want to update Trellix Policy Auditor on a different schedule, you can create a server task. You must verify that the task is enabled. The **Master Repository** is configured when installed. But, you must ensure that proxy server settings, if any, are configured correctly. By default, Trellix ePO - On‑prem uses Microsoft Internet Explorer proxy settings. For information about repository management, proxy settings, and server tasks, see the Trellix ePO - On‑prem documentation. # Creating and managing audits Trellix Policy Auditor allows you to create audits based on benchmarks and assign them to run on systems. Trellix Policy Auditor evaluates systems against independent standards that are developed by government agencies and private industry. It can also evaluate systems against standards you create (using Benchmarks that you create). You can create audits from a Trellix-supplied selection of predefined benchmarks established by government and industry such as SOX, HIPAA, PCI, and FISMA. You can also create audits based on third-party benchmarks or benchmarks that you create yourself. Audits return results that include a score allowing you to determine how well a system complies with the rules in the benchmark. ## Audits and how they work The software uses audits to determine the compliance status of a system, and returns results indicating areas that are out of compliance. Trellix Policy Auditor evaluates systems against independent standards that are developed by government and private industry. It can also evaluate systems against standards that you create. An audit consists of: - A benchmark or a selected profile in a benchmark - A system or groups of systems - An audit frequency (how often the data should be gathered) - An optional waiver to temporarily exclude systems or audit results from reports *Benchmarks are documents that contain rules for describing the wanted state of a system according to recognized standards.* *Rules contain checks that are normally written in the OVAL language.* When you run an audit against a system, the audit reports the comparison between the configuration status of the system and the rules in the benchmarks. When the default audit scoring model is used, the audit also reports a comparative score of the system ranging from 0–100. ## Audit frequency Audit frequency describes how often data should be gathered. Frequency is defined as "Audit results should be no older than nnn time unit," where "nnn" is a number and "time unit" is days, weeks, or months. For example, if the frequency for an audit is defined as 1 month and a system has not been audited in more than 1 month, the results are considered to have expired. ## Differentiating expired results When you set the Differentiate expired results in a query server setting to true, reports and queries differentiate expired results as follows: - **pass-expired** — The results have expired but the last audit results evaluated to **pass**. - **fail-expired** — The results have expired but the last audit results evaluated to **fail**. - **other-expired** — The results have expired and the previous audit results evaluated to a condition other than **pass** or **fail**. ### No audit results If an audit has not run, it has a status of no results in reports and queries. Results are shown after the audit runs. ## When audits are run Trellix Policy Auditor provides three ways to run an audit. - **Manual** - You manually run an audit, the audit runs during the next whiteout period. - **Scheduled** - **Managed systems** — The Trellix Policy Auditor agent runs the audit before the results expire, even if the system is not connected to the network. The audit expiration date is defined by the audit frequency. - **Unmanaged systems** — The Trellix Policy Auditor network audit engine runs the audit before the audit expires, as defined by the audit frequency. The system must be connected to the network. - **Content update** - Trellix updates the audit content. This happens often with patch assessment audits. When content is updated, the audit runs during the next whiteout period. ## Per audit data maintenance Trellix Policy Auditor provides per audit data maintenance. This lets you control, at the individual audit level, what information to retain and how long to retain it. The software system settings provide a standard for retaining results for audits and findings. However, you might want to retain some audit information for a greater or lesser amount of time. You can create or edit an audit so that it retains audit or findings information for a different period of time than is specified in the global system settings. ## Benchmark profiles and their effect on audits Audits have benchmarks assigned to them. Many benchmarks contain *profiles*, which are named sets of selected groups, rules, and values targeted toward different computer system configurations and threat risks. A profile can: - Enable or disable groups - Enable or disable rules - Change the variables that are used within a rule, such as the minimum password length Profiles are normally designed to apply to a particular set of systems. For example, a benchmark might contain two profiles, one for Windows and one for UNIX. Or, a benchmark might contain high security, medium security, and low security profiles. Select a profile based on the risk of the systems being audited. Systems containing customer credit card information are a greater threat to an organization if the data is compromised than a system used to create company newsletters. ## Considerations for including systems in an audit Audits can be designed for a specific computer system configuration, and Trellix Policy Auditor allows you to include or exclude systems from an audit based on several system characteristics. Trellix Policy Auditor allows you to exclude managed systems based on system name, IP address, MAC address, or user name. ### Including systems in an audit Trellix Policy Auditor provides two methods for including systems in an audit. The first method includes managed systems by specifying **System Tree** and **Tags**: - **Add System —** A managed system as defined by system name, IP address, MAC address, or user name. - **Add Group —** A group defined in the Trellix ePO - On‑prem System Tree. - **Add Tag —** Systems that have been tagged in the Trellix ePO - On‑prem System Tree, such as server, workstation, or laptop. The second method allows you to include managed systems by specifying criteria. Criteria are defined by selecting properties and using comparison operators and values to represent managed systems. You can select one or multiple criteria. ## Benchmark labels and how they are used Labels classify a benchmark to aid in searches. Each benchmark can have multiple labels assigned to it. Labels can describe the programmatic use of a benchmark, such as applying a label of MNAC to a benchmark designed for the Trellix Network Access System extension. Labels can also describe the function of a benchmark, such as applying a label of SOX to a benchmark that tests compliance with the Sarbanes‑Oxley standard. Labels are applied with the Trellix Benchmark Editor extension or are contained in Trellix‑supplied benchmarks. When you assign a benchmark to an audit, the benchmark selection process includes a drop-down list that shows all available benchmark labels. You can filter benchmarks based on the label that you want to use for your audit. ## Findings Trellix Policy Auditor provides enhanced results for checks, also known as findings. Findings appear in monitors and queries and include additional information about the state of a system that is helpful to security officers and network administrators when fixing issues. Findings are included in reports and provide additional information in audit results. For example, if an audit expects a password with at least eight characters but finds a password with only six characters, the findings show the actual and expected results. Because it is possible to create a check that reports thousands of violations, Trellix Policy Auditor allows you to set a violation limit that reduces the number of violations that can be displayed to conserve database resources. Setting the violation limit to 0 causes monitors and queries to display all violations. ## Activate benchmarks You must activate a benchmark in Trellix Benchmark Editor before you can include it in an audit. **Task** 1. From the Trellix ePO - On-prem console, select **Menu | Risk & Compliance | Benchmarks** 2. Find the benchmark to use in your audit and check its status. If the status is not active, select it, then select **Actions | Activate**. The benchmark is activated and appears in the list of available benchmarks when you create an audit. > **Note** > > The **Content Version** specifies the version number of the Trellix Policy Auditor Security Content release. > > The **Benchmark/XCCDF version** specifies the version number of the benchmark used in Audits. The Benchmark Content version gets updated each time we release a new Content version. The content release includes updates to one or more benchmarks. > **Note** > > If **Benchmark version** column does not appear, you may add it from **Actions** menu. # Tailor a benchmark Tailoring a benchmark changes the rules or rule settings used by the benchmark. **Task** 1. From the Trellix ePO - On-prem console, select **Menu | Risk & Compliance | Benchmarks**. 2. Select a benchmark, click **Tailoring**, then click **OK**. 3. Select a **Rule** or **Group**, then click **Tailor Values**. 4. Change the **Rule** or **Rule Settings**, then click **Save**. In the Benchmark list, there are two benchmarks with the same name, one has **Tailor** in the **Status** column. ## Create an audit Audits determine whether systems comply with your security needs, and the results tell you what, if anything, needs to be done to make the systems compliant. **Before you begin** - You must have permissions to add, remove, and change audits and assignments. - You must have a benchmark that you have activated for use in the audit. A schedule-based client task audit schedules a daily, weekly, monthly, or one time audit. You select the days and times to run the audit. Task 1. From the Trellix ePO - On‑prem console, select **Menu | Risk & Compliance | Audits**, then select **Actions | New Audit**. 2. Select a platform and label to filter the benchmarks in the **Active Benchmarks** pane. For example, select the Microsoft Windows platform and the FISMA label to show only Windows benchmarks that have a FISMA label. > **Note** > > The **Content Version** specifies the version number of the Trellix Policy Auditor Security Content release. 1. From the **Active Benchmarks** pane, select the benchmark for the audit, click **Add Benchmark**. Trellix recommends that you use only one benchmark per audit. > **Note** > > If **Benchmark version** column does not appear, you may add it from **Actions** menu. 1. Choose a profile for your audit: in **Selected Benchmarks**, select the profile from the **Selected Profile** list, then click **Next**. Some benchmarks don't have profiles. 2. Choose a method for adding systems to the audit. - Select **System Tree and Tags** and click **Add System, Add Group, or Add Tag** to add systems to the audit. You can use more than one method to add systems. - Select **Criteria**, then select one or more **Available Properties** to add to the **Computer Properties** pane. Use arrows in the Available Properties pane to add or remove criteria and the **Comparison and Value** controls lists to type or select system properties. 3. Under the **Exclude these** pane, click **Add System** to exclude systems from the audit, then click **Next**. 4. On the **Properties** page, type audit information and select options, then click **Next**. 5. On the **Summary** page, review the information, then click **Save**. ## Run an audit manually You can manually run an audit when you must view results before the next scheduled audit. Task 1. Click **Menu | Policy | Audits**. 2. Select audits, then click **Actions | Run Audit**. The audit runs during the next whiteout period. ## Disable an audit When an audit is disabled, Trellix Policy Auditor continues to purge information according to the schedule you have set. The audit doesn't run until you re-enable it. Task 1. From the Trellix ePO - On-prem console, select **Menu | Policy | Audits**. 2. Select an audit, then click **Actions | Edit Audit**. 3. Click **Next** to display the properties page. 4. Deselect **Enable this Audit**, then click **Next**. 5. Click **Save**. ## Delete audits You can delete an audit and all associated results and findings when you no longer need them. Task 1. From the Trellix ePO - On-prem console, select **Menu | Policy | Audits**. 2. Select the audits that you want to delete, then click **Delete**. ## Audit whiteout and blackout periods *Audit whiteout periods are time intervals when an audit can run on a system or group of systems. Audit blackout periods are time intervals when an audit can't run.* Audits are not scheduled. For example, consider a benchmark that was last evaluated at 5:14 p.m. on Sunday May 6. The frequency requirement states that the information should not be older than four days. Blackout windows are set from 8:00 a.m. to 5:00 p.m. on weekdays. Whiteout windows cover the remaining period. If the benchmark is scheduled for re-evaluation during the Thursday evening whiteout window, the frequency requirement of 4 days is calculated so the benchmark must be evaluated no later than Thursday morning. Audit content updates sent to the Trellix ePO - On-prem server cause Trellix Policy Auditor to run the audit at the next available whiteout period. ## Set whiteout and blackout periods Set whiteout and blackout periods for running audits on systems. Task 1. From the Trellix ePO - On-prem console, select **Menu | Systems | System Tree**, then click the **Assigned Policies** tab. 2. From the **Product** drop-down list, select the Trellix Policy Auditor agent. 3. For **General**, click **My Default**. 4. Click a white square, which changes to blue, to designate a period of time when audits are not allowed to run. Click a blue square, which changes to white, to designate a period of time when audits are allowed run. 5. Click **Save**. # Service Level Agreements *Service Level Agreements* (SLA) are relationships that you create between system tags and patch severity levels. You then specify a number of days that you have to apply patches to systems that fit the relationship. As an example, you assign tags to systems, such as `Finance` or `Administrative`, and check creators can assign severity levels to patch checks, such as critical or moderate. When you create a **Service Level Agreement**, you can specify that `Finance` systems missing a critical patch are given 30 days until you are required to apply the patch. Similarly, you can specify that `Administrative` systems failing a critical patch check are given 90 days before you are required to patch the system. You can monitor the status of **Service Level Agreements** from the **PA: MS Patch Status Summary** dashboard monitor. ## Create, edit, and delete Service Level Agreements Create, edit, or delete a **Service Level Agreement** between a system tag and a patch severity. Task 1. Select **Menu | Risk & Compliance | Audits**, then select **Actions | Patch SLA** to open the **Service Level Agreement** page. 2. Select one of the following: | To... | Do this... | | --- | --- | | Create a new **Service Level Agreement** | 1. Select **Actions \| New SLA**. 2. Use the drop-down lists to select a tag and a severity level. 3. Type the number of days to install a patch after an audit discovers a system that requires a patch, then click **Save**. | | Edit an existing **Service Level Agreement** | 1. Select an SLA, then select **Actions \| Edit SLA**. 2. Edit the number of days, then click **Save**. | | Delete a **Service Level Agreement** | 1. Select an SLA, then select **Actions \| Delete SLA**. 2. Click **Yes**. | ## How viewing audit results works Trellix Policy Auditor offers a number of options for viewing audit results. Several options are available for viewing system and rule compliance. You can view audit results by clicking an audit from the **Audits** page. ### Results timeframe control The **Results timeframe** control allows you to view the results of an audit at any point in time since the audit first began. By default, the calendar is set to **Today**, which shows the results for current systems as defined by the frequency settings. A checkbox is available to show the last valid results if today's results are not current. The calendar control allows you to pick a date in the past and see the audit results for that date. ### Audit Benchmarks pane The **Audit Benchmarks** pane shows the status of each benchmark in the audit. You can view these columns in the pane: > **Note** > > If **Benchmark version** column does not appear, you may add it from **Actions** menu. - **Benchmark ID** — Benchmark identifier. - **Benchmark/XCCDF version** — The version number of the benchmark used in Audits. - **Profile ID** — Profile identifier, if any. - **Pass** — The number of benchmarks passed by all systems. - **Fail** — The number of benchmarks failed by all systems. - **pass-expired** — The results have expired but the last audit results evaluated to **pass**. - **fail-expired** — The results have expired but the last audit results evaluated to **fail**. - **other-expired** — The results have expired and the previous audit results evaluated to a condition other than pass or fail. You can click the hyperlinked number in the columns to go to the **View System Results** page. ### View Results column (systems) Under the **View Results** column, clicking **systems** allows you to view the results for each system audited. This is an extension of the **Audit Results** pane that allows you to see the results at the system level. These columns appear in the **Benchmark Systems** pane: - **Audit Date** — The date of the audit being viewed. - **Expiration Date** — The expiration date, if any, of the audit. - **Score** — The audit score for the system. - **System Group** — The name of the group, if any, that the system belongs to. - **System Name** — The name of the system. - **System Tags** — Any tags associated with the system. - **Rules Passed** — The number of rules that passed the audit. - **Rules Failed** — The number of rules that failed the audit. - **Rules Other** — The number of systems that had a result other than pass or fail. The page provides a control that allows you to view the results by system group, system subgroup, systems with a specific tag, or even individual systems. You can also adjust the results timeframe to select an audit to review. ### View Results column (rules) Under the **View Results** column, clicking **rule** allows you to view the rule results for each system audited. This is an extension of the **Audit Results** pane that it allows you to see the results at the rule level. These columns appear in the **Benchmark Rules** pane: - **Rule ID** — The benchmark rule identifier. - **Group Path** — The path of the group containing the rule. - **Systems Passed —** The number of systems that passed the audit. - **Systems Failed —** The number of systems that failed the audit. - **Systems Other —** The number of systems that had a result other than fail. The page provides a control that allows you to view the results by benchmark rule group, benchmark rule subgroup, or a specific rule, which can be selected by clicking **Find** and selecting a rule. ## Exporting audits and audit results Audits and audit results can be exported in four formats: Asset Reporting Format (ARF), CyberScope, OVAL, and XCCDF. In each case, the information is saved as a .zip file. You can export an audit and transfer it to another Trellix ePO - On-prem server, or transfer to a third-party application. | Option | Definition | | --- | --- | | **Export ARF** | Creates an Asset Reporting Format (ARF) results file that conforms to the ARF results schema. | | **Export CyberScope** | Creates a CyberScope file that conforms to the CyberScope standard. | | **Export OVAL** | Creates an OVAL results file that conforms to the OVAL results schema. This file can be consumed by any tool that understands the OVAL results schema. | | **Export XCCDF** | Creates an XCCDF file that conforms to the XCCDF results schema. It contains the latest results for all the systems and benchmarks in the audit. The results file could be consumed by any tool that understands the XCCDF results schema. | ## Export audits Export an audit to a file that conforms to the XCCDF or OVAL results schema. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. Click **Menu | Risk & Compliance | Audits**. 2. Select the audit to export, then click one of these options. - **Actions | Export ARF** — Export an audit to a file that conforms to the Asset Reporting Format (ARF) results schema. - **Actions | Export CyberScope** — Export an audit to a file that conforms to the CyberScope standard. - **Actions | Export OVAL** — Export an audit to a file that conforms to the OVAL results schema. - **Actions | Export XCCDF** — Export an audit to a file that conforms to the XCCDF results schema. 3. Click **Save**. 4. Give the export .zip file an appropriate name, then click **Save**. # Scoring audits When Trellix Policy Auditor performs an audit on a system, it generates information about system compliance that includes a compliance score. The software supports the four scoring models described in the National Institute of Standards and Technology (NIST) document Specification for the Extensible Configuration Checklist Description Format (XCCDF) Version 1.2 ([http://csrc.nist.gov/publications/nistir/ir7275-rev4/NISTIR-7275r4.pdf](http://csrc.nist.gov/publications/nistir/ir7275-rev4/NISTIR-7275r4.pdf)): - Default scoring model - Flat unweighted scoring model - Flat scoring model - Absolute scoring model The software is preconfigured to use a normalized implementation of the flat unweighted scoring model. You can change the scoring model and the software recalculates scores to reflect the change. ## Default scoring model The default scoring model computes the score independently for each collection of subgroups and rules in each group, and again for each rule and group in the audit's benchmarks. Despite the name of the scoring model, Trellix Policy Auditor does not use this model for its preconfigured scoring model. Instead, the software uses a normalized version of the flat unweighted scoring model that makes it easier to compare audit scores. ### Calculating scores using the default scoring model The calculated test score under the default scoring model depends on the number of groups, subgroups, and rules in benchmarks in an audit. This means that audits with large benchmarks can yield a high score while audits with small benchmarks can yield a low score. Audits can also have rules that are based on the system configuration, so it is possible, for example, for the same audit to yield one score on a Windows XP system and another score on a Windows 7 system. Because the maximum score can vary from audit to audit and from system to system, it is hard to compare audit scores. The primary use for this scoring model is for comparing historical audit scores on the same system. ## Flat unweighted scoring model The flat unweighted scoring model computes the score (the number of rules that passed) and compares it against the maximum score. Trellix Policy Auditor is preconfigured to use a normalized implementation of the flat unweighted scoring model. The *maximum possible score* is the number of all applicable rules in an audit. For example, if an audit evaluates a system against 283 rules and the system passes 212 of the rules, the flat unweighted scoring model gives the system a score of 212. Another audit might have fewer rules and yield a lower score. This makes it hard to compare results from different audits. ### How Trellix Policy Auditor calculates scores Because of the disparity in comparing audit scores, the software uses the flat unweighted scoring model and normalize the final score (maximum score of 100). It allows you compare an audit with other audits on the same system or between systems with different configurations, such as Windows XP or Windows 7. The software uses this equation to normalize audit scores: ```plaintext audit score = (rules passed ÷ maximum possible score) × 100 ``` This table shows how scores for different audits can be compared using a normalized implementation of the flat unweighted scoring model. Table 6-1 Flat unweighted scoring model | Audit example | Maximum score | Rules passed | Flat unweighted audit score | Normalized flat unweighted audit score | | --- | --- | --- | --- | --- | | Audit 1 | 283 | 212 | 212 | 74.9 | | Audit 2 | 15 | 14 | 14 | 93.3 | # Flat scoring model The flat scoring model compares the system score with the maximum possible system score. The maximum possible score is the sum of the weights of all rules in an audit that apply to a system. Rules that don't apply to a system are ignored when calculating the maximum possible score. The actual score is the sum of the weight of all rules that pass. Because the maximum possible score can vary from system to system, scores from systems that have different configurations, such as Windows XP or Windows 7, might not be directly comparable. This model is useful for comparing a system score with its historical scores. ### Score weighting The flat scoring model allows benchmarks to use weighted scores for each rule. A common example of score weighting is a school test where one question is worth more points than another question. In this example, an audit has a benchmark with two rules. One of the rules is weighted because the audit benchmark developer considered it to be more important than the other rule. | Rule | Assigned weight | Laptop maximum rule score | Non-laptop maximum rule score | | --- | --- | --- | --- | | Port 8015 on a laptop system is closed | 3 | 3 | 0 | | Password on any system must be 10 or more characters | 1 | 1 | 1 | | **Maximum possible score** | | **4** | **1** | The maximum possible audit score for a laptop is 4. On desktop systems, the software ignores the closed port rule and the maximum possible score is 1. # Absolute scoring model The absolute scoring model yields a score of 100 when a system passes all applicable rules, and a score of 0 if all applicable rules don't pass. This scoring model is useful when an organization requires that a system pass every rule to be considered secure. The absolute scoring model makes it easy to differentiate between systems that pass or fail an audit. ## Change the scoring model You can change the scoring model that Trellix Policy Auditor uses when reporting audit results. When you change the scoring model, the software recalculates the scores to reflect the selected model. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. **Select Menu | Configuration | Server Settings.** 2. Under **Setting Categories**, select **Policy Auditor**. The Trellix Policy Auditor server settings appear in the right panel. 3. **Click Edit.** 4. Select the scoring model from the **Default Scoring Model** drop-down list. 5. **Click Save.** # Managing audit waivers Waivers allow you to temporarily affect how systems are audited and might affect audit scores. They are useful when you have a system that you know might be out of compliance but you don't want to bring the system into compliance for a temporary period. For example, you might have systems in the Accounting Department that you don't want to patch near the end of an accounting cycle. You can create a waiver that temporarily ignores any missing patches on systems until after the end of the accounting cycle. You can also create another type of waiver that suppresses the systems from being audited. ## Types of waivers Trellix Policy Auditor provides three types of audit waivers that apply to selected systems. Each type of waiver affects scoring results differently. - **Exception waiver —** Forces the audit results of a selected benchmark rule to have a result of pass. This potentially affects the score of system audits. - **Exemption waiver —** Prevents selected systems from being audited. Systems not audited don't appear in audit results. - **Suppression —** Allows a selected benchmark rule to be included in an audit, but excludes the results. This affects the score of system audits. **All waivers have these common characteristics:** - A system, multiple systems, or groups of systems selected from the **System Tree**. - A start date and an expiration (end) date. Exception and suppression waivers must include a selected rule from a selected benchmark. The waiver applies to any audit that contains the benchmark. Because exemption waivers are independent of benchmarks or rules, the interface does not give you the opportunity to select them. ## Exception waivers Exception waivers potentially affect the audit scores of selected systems by forcing the audit result of a benchmark rule to have a status of pass. The primary use of an exception waiver is to force audit rules to pass. **Exception waivers have these characteristics:** - Apply to selected systems and groups in the System Tree. - Require you to select an audit benchmark and a rule contained in the benchmark. - Evaluate every rule during an audit, but force the selected rules to have a status of pass. - Can be backdated. Scores for results collected during the backdate time frame are recalculated. For example, Trellix Policy Auditor audits a system with a benchmark that contains five rules. Four rules pass and one fails, resulting in a score of 80%. If the rule that failed is granted an exception waiver, all five rules are considered to have passed and the score is 100%. ## Exemption waivers Exemption waivers prevent selected systems from being audited. Exemption waivers have these characteristics: - Apply to selected systems and groups in the System Tree. - Don't require you to select a benchmark and a rule. - Can't be backdated. - Don't audit the selected systems when the waiver is in effect. - Don't include selected systems in the audit results. For example, Trellix Policy Auditor audits a system with a benchmark that contains five rules. Four rules pass and one fails, resulting in a score of 80%. If the system is granted an exemption waiver, it is not audited and does not appear in the audit results. ## Suppression waivers Suppression waivers potentially change the audit scores of selected systems by excluding the audit result of a benchmark rule. The primary use of a suppression waiver is to hide audit results. Suppression waivers have these characteristics: - Apply to selected systems and groups in the System Tree. - Require you to select an audit benchmark and a rule contained in the benchmark. - Evaluate every rule during an audit, but don't include the rule result when calculating the score. - Can be backdated. Scores for results collected during the backdate time frame are recalculated. For example, Trellix Policy Auditor audits a system with a benchmark that contains five rules. Four rules pass and one fails, resulting in a score of 80%. If the rule that failed is granted a suppression waiver, the rule results are excluded and the score is 100%. ## Waiver status Waivers can have one of four status properties. | Status | Description | | --- | --- | | **Requested** | A waiver has been requested but approval has not been granted for it to take effect. Requested waivers don't appear on the Waivers tab, but appear in the Issue Catalog (go to Menu \| Automation). Requested waivers can be deleted. | | **Upcoming** | A waiver has been requested and granted approval but the waiver is not in effect because the start date has not yet arrived. Upcoming waivers can be deleted. | | **In-effect** | A waiver is active and audits involving the system specified by the waiver temporarily affect the scoring of the system. In-effect waivers cannot be deleted but can be canceled to give it a status of expired. | | **Expired** | A waiver is no longer in effect, because of user intervention or the expiration date has arrived. Expired waivers cannot be deleted. | ## Filter waivers by status Trellix Policy Auditor allows you to filter waivers according to a date that you select. You can filter waivers by their status. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. Select **Menu | Risk & Compliance | Waivers**. 2. From the **System Tree**, select a group that contains waivers of different status. 3. Use the **Status** drop-down list to select a status. The waivers are filtered according to the status you choose. ## How start and expiration dates work Waivers are effective for a limited time only. When you create a waiver, you specify a start date and an expiration date. - **Start date** — When the waiver takes effect. The start date is inclusive. - **Expiration date** — When the waiver is no longer in effect. Must be at least one day after the start date. The expiration date is not inclusive. For example, if you set a start date of March 1, 2014 and an expiration date of April 1, 2014, the waiver affects audits from March 1, 2014 through March 31, 2014. An audit conducted on April 1, 2014 is not affected by the waiver. ## Examples of filtering waivers by date When you filter waivers by date, Trellix Policy Auditor shows waiver status as of the selected date. The status might change according to the date you select for filtering. These assumptions apply to the filtering examples: - Today's date is November 10, 2014. - Waiver A has a start date of November 1, 2014 and an expiration date of November 15, 2014. - Waiver B has a start date of November 15, 2014 and an expiration date of December 1, 2015. | Filter by today's date | Filter by a future date | Filter by a past date | | --- | --- | --- | | Next to the **As of** date, click **Today**. The date is set to today's date of November 10, 2014. The **Waivers** tab shows: - Waiver A has a status of **In-effect**. - Waiver B has a status of **Upcoming**. | Next to the **As of** date, select November 15, 2014. The **Waivers** tab shows: - Waiver A has a status of **Expired**. - Waiver B has a status of **In-effect**. | Next to the **As of** date, select October 1, 2014. The **Waivers** tab shows: - Waiver A has a status of **Upcoming**. - Waiver B has a status of **Upcoming**. | ## Filter waivers by date [Task](/docs/mpa-654-pg-0-00-en-us#) 1. Select **Menu | Risk & Compliance | Waivers**. 2. Use the calendar control next to **As of** to select a different date. The **Waivers** tab shows the status of each waiver as of the selected date. ## Filter waivers by group Trellix Policy Auditor allows you to filter waivers by the group selected in the **System Tree**. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. **Select Menu | Risk & Compliance | Waivers.** 2. From the **System Tree**, select the group with the waivers. 3. From the **Filter** drop-down list, select **This Group Only**. The **Waivers** tab shows only the waivers for systems in the selected group. 4. From the **Filter** drop-down list, select **This Group and all Subgroups**. The **Waivers** tab shows waivers for systems in the selected group and any subgroups of the selected group. ## How waiver requests and grants work Trellix Policy Auditor shows waivers on the **Waivers** page when a user with the proper permissions grants approval for the waiver to take effect. Depending upon the internal security policies of your organization, the users who request waivers and the users who grant them can be different. A user who has permissions to request and grant waivers can create a waiver and grant it at the same time. ## [Request waivers](/docs/mpa-654-pg-0-00-en-us#) Trellix Policy Auditor allows you to request a waiver. If a user only has permissions to request waivers, another user who has permissions to grant waivers must grant the waiver before it appears on the **Waivers** page. If you have the correct permissions to grant waivers, you can create and grant the waiver in a single step. Requested waivers appear in the **Issues Catalog**. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. **Select Menu | Risk & Compliance | Waivers**, then click **New Waiver**. 2. Type a name for the waiver. In the **Notes** box, type descriptive information that you want to associate with the waiver. 3. From the **Waiver Type** drop-down list, select the type of waiver that you want to create. 4. Use one or both of these options to select systems to apply the waiver to: - **Add Systems** — Type the system name, IP address, MAC address, or user name that you want to search for. If you don't know the full name or address, you can type a partial search, like `172.21`. Click **OK** to open the **Search Results** page. - **Add Group** — For each group you want to add, select it from the **System Tree**, then click **OK**. 5. Select the systems that the waiver applies to, then click **OK** to open the **Waiver Request** page. - For exception and suppression waivers, select a benchmark and rules. - Exemption waivers don't require a benchmark and a rule. 6. Use the calendar control next to **Start Date** and **Expires Date** to select dates for the waiver to be in effect. 7. Click **Request Waiver**. If you have permissions to grant waivers, you can click **Grant Waiver** and the waiver appears in the **Waivers** tab. > **Note** > > The requested waiver does not appear in the **Waivers** tab because the waiver has not been granted yet. Requested waivers appear in the Issues Catalog (**Reporting | Issues**). ### Grant waivers Users with the permission to grant waivers can approve waivers requested by others. Task 1. Select **Menu | Automation | Issues**. 2. Select a requested waiver, then click **Edit**. 3. Click **Grant Waiver**. The waiver is now approved to take effect on the start date. ## End a waiver You can make a waiver expire. This is useful when you have a waiver with a status of **In-effect** and you want to end the waiver before the expiration date. Task 1. Select **Menu | Risk & Compliance | Waivers**. 2. Select a waiver with a status of **In-effect**, then click **View**. 3. Click **Expire Waiver**. The waiver has a status of **Expired**. ## Delete waivers You can delete a waiver before it takes effect. You can only delete waivers with a status of **Upcoming**. Task 1. Select **Menu | Risk & Compliance | Waivers**. 2. Select a waiver with a status of **Upcoming**, then click **View**. 3. Click **Delete Waiver**. The deleted waiver no longer appears on the **Waivers** tab. # Scanning the inventory Scan for inventory items such as applications, operating systems details, and ports in use. This allows you to monitor and log changes of these inventory items, and helps you identify deviations from a baseline. **Supported inventory scan items:** - **Applications** – Scans and reports all installed applications in the systems. Applications also include: - Patches - Windows Apps - Windows features - Package Manager Applications - Browser extensions and plug-ins - **Services** – Scans and reports all services in the systems. - **Ports** – Scans and reports all ports in the systems. > **Important** > > When scanning for ports on Linux systems, ensure that the systems have `netstat` installed for the scan to be successful. - **Operating System** – Scans and reports all Windows and Non-Windows operating systems in the systems. - **Network Interfaces** – Scans and reports network-related information. Information includes: - IPv4 or IPv6 addresses - MAC address - DHCP enabled - Default gateway - Primary and secondary DNS - **System Information** – Scans and reports system-related information. Information includes: - FQDN - GUID - System or motherboard serial number - System manufacturer and model - BIOS, BIOS vendor, version, and release date - **Registered Extensions** – Scans and reports all file types in the systems. For example, *.txt, *.exe, and *.dll. ## Create an inventory scan client task This Trellix ePO - On-prem client task allows you to define the inventory items to include in the scan. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. From the Trellix ePO - On-prem menu, select **Policy | Client Task Catalog**. 2. Under Client Task Types, select **Trellix Policy Auditor (Advanced Host Assessment)**, then select **New Task**. 3. From the drop-down, select **Inventory Scan**, then click **OK**. 4. Enter a task name and description, and set up the task. > **Note** > > Enable **Reset Baseline** whenever you edit and make changes to the client task. By design, the scan result includes only the difference in baseline from the last scan results, if this option is not enabled. This could result in incomplete data for the newly selected inventory item in the scan task. - Choose whether to reset the baseline scan data. - Choose whether to synchronize the scan results. Synchronize scan option populates the latest data from the previous scan. - Choose the inventory items to scan. 5. **Click Save.** ### Assign and schedule an inventory scan client task After you have created the client task to scan the inventory, you need to assign it to a group or system. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. From the Trellix ePO - On-prem menu, select **Risk & Compliance | Advanced Host Assessment Scans**. 2. From **Actions**, select **New Inventory Scan**. 3. Select a group, then select **OK**, and then on the Select Task page, make the following selections: - **Product – Trellix Policy Auditor (Security Assessment)** - **Task Type – Inventory Scan** - Then select the task you created for the inventory scan. 4. Set up the task inheritance, system tag criteria, and schedule, then click **Save**. ### Run an inventory scan for a specific system You can run a immediate inventory scan on an individual system from the **System Tree**. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. From the Trellix ePO - On-prem menu, select **Systems | System Tree**. 2. Select a group, then select the system. 3. From **Actions**, select **Host Inventory | Scan Now**. 4. In the Scan Now dialog, select **Inventory Scan**, then select **OK**. # Run a scan manually using command line You can run a scan locally on a system if it doesn't communicate with your Trellix ePO - On-prem. Before you begin - The system must be managed by your Trellix ePO - On-prem. - The system must have Trellix Policy Auditor installed. - You must create a client task for the specific system or its group. The collection items in the client task must match the collection items of your manual scan. If a system is located in an air gap network and it doesn't communicate with your Trellix ePO - On-prem, you can run an inventory scan on the system locally. This allows you to keep your inventory scan record up-to-date for all managed systems. Task 1. Log on to the system that you want to scan, then open command prompt or terminal. > **Important** > > - On Windows, open command prompt as an administrator. > - On non-windows, open terminal using a account that has sudo access. 1. Set the directory to the installation location of the Trellix Policy Auditor Phoenix engine. The default installation location is: - For Windows: `C:\Program Files (x86)\McAfee\Policy Auditor Agent\Phoenix` - For Non-windows: `/opt/McAfee/auditengine/phoenix/` 1. Run the following command: ```plaintext ./phoenix_engine_main -m inventory -i inventory_task_settings.json --opcode export --policy ``` - The output is a .zip file. It is saved with a file name in .zip format. Where is the GUID of the agent of this system. - The .zip file is saved at the installation location of the Trellix Policy Auditor Phoenix engine. > **Note** > > The command doesn't allow you to choose the inventory items to scan. When you run the command, all inventory items are scanned. 1. Transfer the .zip file to your Trellix ePO - On-prem server. # Import inventory scan report manually You can manually import inventory scan results of a system that doesn't communicate with your Trellix ePO - On-prem. > **Before you begin** > > - You must have run the inventory scan at the remote system. > - You must have access to the inventory scan result from your Trellix ePO - On-prem. The exported .zip file is imported to your Trellix ePO - On-prem. > - You must created an inventory scan for the specific system or its group on your Trellix ePO - On-prem. **Task** 1. From the Trellix ePO - On-prem menu, select **Risk & Compliance | Advanced Host Assessment Scans.** 2. Select **Actions | Import Scan Results.** 3. Click **Choose File**, then select the inventory scan result that you exported from the scanned system. 4. Click **Open**, then click **OK**. ## View an inventory scan report Your inventory scan results gives you a detailed or limited view of the inventory scan items. **Task** > **Note** > > The level of detail in your scan result depends on your choice while creating the scan task. > **Note** > > PA Server performs a version check before processing the inventory scan results. If the PA agent version is less than 6.4.3, the results are not processed by the server further. 1. From the Trellix ePO - On-prem menu, select **Risk & Compliance | Advanced Host Assessment Scans.** 2. From the list of inventory scan tasks, select a task. 3. From the **System Name** section, select a system. The **Host Inventory Results** section lists all the inventory items. The **Inventory Results for System** section lists the results for the selected inventory item. # Optimize disparate data You can apply criteria across data collected through inventory scan to gather more insights. #### Before you begin - The feature is provided as a stored procedure for SQL Server Management Studio. The stored procedure is copied automatically while you install Policy Auditor 6.4. - Ensure that you have administrator privileges to log in to SQL Server Management Studio. ### Task 1. Open SQL Server Management Studio. 2. Log on to your SQL Server that hosts the Trellix ePO - On-prem database. 3. From the Object Explorer, navigate to `<SQL Server name>` | Database | `ePO_<server name>` | Programmability | Stored Procedures. 4. From the list of stored procedures, right-click on `dbo.PASecurity_Scan_Result_DisparateData_Process`, then select **Execute Stored Procedure**. 5. Identify the necessary parameters, then enter your criteria in SQL syntactically correct statement in **Value**. 6. Enter the value for the corresponding **WhereClause** in SQL syntactically correct statement in **Value**. > **Important** > > Log on account must have administrator privileges. **Note** Ensure that you enter the correct value for the WhereClause. The procedure shows incorrect values or return null if WhereClause is empty, null, or incorrect. ## Purge scan data You can purge scan data and keep an up-to-date record by removing data that are older than a specific number of days. #### Before you begin - We recommend you do not delete a scan task. - The **Purge scan data** task does not remove the scan data from the repository. This mechanism allows inventory scan to fetch only the delta and present a complete result. To delete scan data from the repository, ensure that you use **Delete all scan results**. ### Task 1. From the Trellix ePO - On-prem menu, select **Automation | Server Tasks**. 2. In the Server Tasks page, select **New Task**. 3. Enter a name for the task and then in **Schedule Status**, select **Enable**, then click **Next**. 4. From the **1. Actions** drop-down, select **PA: Purge scan data**. 5. In **Purge application removal data older than (in days)**, enter the days. The server task removes scan data on removed application based on the value entered in this field. 6. Select **Delete all the scan results**, then click **Next**. > Ensure that you disable this option after its purpose is served. If this option is not disabled, all scan results are deleted with every scheduled scan. 7 Configure the schedule for this task, then click **Next**, and then click **Save**. ## Using file integrity monitoring and entitlement reporting File integrity monitoring notifies you of changes to specified text files on managed systems. Entitlement reporting informs you of changes to user and group rights to files. These features are useful for complying with government and industry standards, such as the Payment Card Industry (PCI) Data Security Standard. ### How file integrity monitoring works The file integrity monitoring feature uses the Trellix Policy Auditor agent to track file changes to specified text files. The software monitors files on managed systems only. You must install the Trellix Agent and the Trellix Policy Auditor agent on systems that you monitor. When a file is scanned, the agent plug-in returns an event to the Trellix Policy Auditor server. The event is encrypted and compressed to save disk space and bandwidth. When you create a policy to monitor files, the software checks the file for changes every hour by default. You can change the monitoring frequency to fit your organizational needs. File integrity monitoring allows you to: - Define which files should be tracked. You can use wildcard characters in file and path names. - Define which files should not be tracked. - Specify the frequency for detecting file changes. - See and receive notification about changes to the file or file attributes. Trellix Policy Auditor also provides the ability to retain up to six file versions, including the baseline version, and provides the ability to: - Compare a file with its baseline version, or any prior version. - Compare a file with a file on another system. - Show a side-by-side comparison of file changes and indicate which lines have been added, deleted, or modified. ### File information monitored The file integrity monitoring feature of Trellix Policy Auditor tracks a number of file attributes. A change in an attribute generates an event notifying you of the change. The monitored attributes differ between supported operating systems. The software monitors these attributes on all operating systems. - File size (in bytes) - File created (date and time) - Hidden - System - Last modified (date and time) - Read only - Owner - Group On Windows systems, the software monitors these attributes, plus the Archive attribute and permissions from the **Discretionary Access Control List** (DACL) ### File baselines When you create and apply a policy, the agent plug-in scans the file to create a baseline. The baseline contains information about the file attributes, and contains the file text if file versioning is enabled. If the file is changed, the software generates an event that is logged to the **File Integrity Monitor** page, included in reports, and can be handled by the issues and tickets feature of Trellix ePO - On-prem. Trellix Policy Auditor monitors the MD5 and SHA-1 hashes of a file as well as the file attributes and permissions information. These values are stored in a database that is created on each system and on the software server. Each time the file is scanned, the software compares its configuration to the baseline. When the file or an attribute changes, the agent plug-in detects the change and sends an event back to the server according to the monitoring frequency. If versioning is enabled, the text file contents are sent to the server as well. [Reset file baselines](/docs/mpa-654-pg-0-00-en-us#) ### Monitored and excluded files You can create a policy to monitor file changes on a regular schedule. The interface allows you to specify files to monitor and files to exclude from monitoring. It also provides the capability to monitor subfolders under each specified path and to monitor symbolic links. ### Wildcard characters Monitored and excluded paths and file names support the * and ? wildcard characters. The * wildcard character represents one or multiple characters and the ? wildcard represents a single character. You can choose to monitor a single file by typing the name of the file when you create a file integrity monitoring policy. By using wildcard characters, you can monitor files or paths of a specific type. For example, if you type `?:\Config` for the path and `*.txt` for the file, Trellix Policy Auditor monitors all text files in the Config folder on all hard drives. You can exclude specific paths and files in a similar manner. ### File validation Trellix Policy Auditor does not validate the existence of files. It ignores paths or files that don't exist. ## File versioning Trellix Policy Auditor allows you to store up to six versions, including the file baseline, of text files from managed systems. The software does not support versioning for non-text files. > **Note** > > The actual text files are not stored in the software database. The database stores the text file contents for quick comparison purposes, even when the system is not connected to the network. When you create a policy, you have the opportunity to store file versions for comparison purposes. The number of file versions you can store ranges from 2–6. This number includes the baseline version. File versions are stored on a First In, First Out (FIFO) basis. For example, if you configure the software to store three versions, it stores the baseline version plus the two most recent versions. If the file changes, the oldest non-baseline file is purged to recover disk space by an internal server task that runs once a day by default. ### Configuring the maximum number of stored file versions When you create a file integrity monitoring policy, you can specify the maximum file size stored for each version with the **Max versioned file size** setting. The available settings range from 1 MB to 4 MB. For example, if you set **Max versioned file size** to 3 MB, the text in the file is stored when its size is less than or equal to 3 MB. If the file size exceeds 3 MB, the software alerts you with an error message. If you receive an error message, you can edit the policy so that it stores text from files as large as 4 MB. ## File version comparison The comparison feature allows you to view the contents of a versioned file and compare the text file content with other files. The software uses a color-coding system to identify file lines that are equal, empty, deleted, inserted, or modified. You can compare a stored version of the text with: - The file baseline. - Previous file versions. - A specified file on another system. ### Double-byte characters The file version comparison feature supports files containing only single-byte characters in the file name and contents. It does not support file comparison for files containing double-byte characters. ## Accepting file integrity monitoring events When a monitored file changes, it generates an event that you can accept. You can accept events from the **File Integrity** page or from pages that you drill down to in reports. - Accepting an event designates the changed file as the new baseline version and purges, or deletes, any previous versions. - Accepting multiple events designates the most recently changed files as the new baseline version and purges any previous version. - Accepting an event for a versioned file sets it as the new baseline version and purges previous versions of the file. You can also accept events from the file integrity monitoring query reports drill-down pages. ## About purging file integrity monitoring events You can purge, or delete, file integrity monitoring events. The software purges events based on a selected age. You can also choose to purge baseline events. Purging events does not set a new baseline. If you select the option to purge baseline events on a versioned file, you cannot compare later files with the purged baseline file. However, you can compare file versions that have not been purged. If you purge a baseline file, the software discards the stored baseline file information, including stored text if versioning is enabled. The software retains the baseline file hash information and sends events with new file information when the file changes. You can also purge events from the last page shown when you drill down into file integrity monitoring query reports. ## Purge file integrity monitoring events Task 1. **Select Menu | Reporting | File Integrity**, then click the **Events** tab. 2. Select the file events to purge, then select **Actions | Purge**. 3. Edit the options to purge events older than the specified time. Select **Purge Baseline Events** to discard stored baseline settings, including the file text if versioning is enabled. 4. Click **OK**. # Entitlement reporting Entitlement reporting informs you of changes to user and group rights to files. Changes to the access permissions entitlement of a file generates an event notifying you of the change. One aspect of compliance monitoring is knowing which accounts have access to which files. Trellix Policy Auditor monitors these access permissions: - **User** — User who has access to the file. - **Is Group** — Whether the user is a group. - **Read Data** — Whether the user has the ability to read the file. - **Write Data** — Whether the user has the ability to write to the file. - **Execute** — Whether the user has the ability to execute the file. - **Delete** — Whether the user has the ability to delete the file. # Create and apply a file integrity monitoring policy Using a file integrity monitoring policy is a two-stage process. First, you must create the policy. Next, you must apply the policy to selected systems in a System Tree group. You can create one policy per group. ### Tasks - [*Create a file integrity monitoring policy*](/docs/mpa-654-pg-0-00-en-us#) *on page 55* Create a policy to monitor file integrity, file entitlement, and version changes. - [*Apply a policy to systems*](/docs/mpa-654-pg-0-00-en-us#) *on page 56* When you create a file integrity monitoring policy, you can apply it to systems in a selected **System Tree** group. You can apply one file integrity monitoring policy to a group. - [*Compare file versions*](/docs/mpa-654-pg-0-00-en-us#) *on page 57* When you enable file versioning, you can compare a file with a previous version, the baseline file, or a file on another system. - [*Accept file integrity monitoring events*](/docs/mpa-654-pg-0-00-en-us#) *on page 58* Trellix Policy Auditor generates events when monitored files change. You can accept events and automatically create a new file baseline. - [*Purge file integrity monitoring events*](/docs/mpa-654-pg-0-00-en-us#) *on page 54* Trellix Policy Auditor generates events when monitored files change. You can purge events based on their age. - [*Create a new file integrity monitoring baseline*](/docs/mpa-654-pg-0-00-en-us#) *on page 59* ## Create a file integrity monitoring policy Create a policy to monitor file integrity, file entitlement, and version changes. Task 1. Select **Menu | Policy | Policy Catalog**. 2. From the **Product** drop-down list, select **Policy Auditor Agent 6.2.0**. 3. From the **Category** drop-down list, select **File Integrity Monitor**. 4. Select **Actions | New Policy**. 5. Provide information about the new policy: | Option | Definition | | --- | --- | | Category | Select **File Integrity Monitor**. This is selected by default. | | Create a policy based on this existing policy | Select an existing policy, such as **My Default**, or another file integrity monitoring policy. | | Policy Name | Type a name for the policy. | | Notes | Type information about the policy. This field is optional. | 6 Click **OK**. The policy configuration page opens. Use the tabs to configure the policy. Table 9-1 Monitor tab | Option | Definition | | --- | --- | | Add | Open the **Monitor Item** page: - **File path** — Type a file path to the monitored files. - **File name** — Type a file name to monitor, using wildcard characters as needed. - **Include subfolders** — Monitor files in subfolders of the file path. This is useful when you use wildcard characters in file names. - **Follow symlinks** — Monitor files referenced by symlinks or shortcuts in the file path. - **Monitoring setting** - **File Entitlement** — Monitors whether a file has changed. - **File Entitlement, File Integrity** — Monitors whether a file has changed or whether the file's entitlements have changed. - **File Entitlement, File Integrity, File Versioning** — Monitors whether a file has changed, whether the file's entitlements have changed, and stores changes for supported text files. | | Edit | Change the configuration of the selected file. | | Max versioned file size (1-4 MB) | Select the maximum size of the files in the policy. You can only use versioning on text files. This has no effect on files that don't have versioning enabled. | | Remove | Remove the selected file from the list of files to be monitored. | Table 9-2 Exclude tab | Option | Definition | | --- | --- | | Add | Open the **Exclude Item** page: - **File path** — Type a file path to the files that you want to exclude from monitoring. - **File name** — Type a file that you want to exclude from monitoring. This is useful when you use wildcard characters for monitored files. | | Edit | Change the configuration of the selected file. | | Remove | Remove the selected file from the list of files to be monitored. | Table 9-3 General tab | Option | Definition | | --- | --- | | Run every | Set the monitoring frequency for the file. By default, this is set to one hour. | **7** Click **Save**. ### Apply a policy to systems When you create a file integrity monitoring policy, you can apply it to systems in a selected **System Tree** group. You can apply one file integrity monitoring policy to a group. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. **Select Menu | Systems | System Tree.** 2. Select the **System Tree** group where you want to apply the policy. 3. On the **Systems** tab, select the systems where you want to apply the policy. 4. From the **Product** drop-down list on the **Assigned Policies** tab, select **Policy Auditor Agent 6.2.0**. 5. Click **Edit Assignment** for a policy with a category of **File Integrity Monitor**. Under the **Actions** column heading, click **Edit Assignment**. 6. Select **Break inheritance** and assign the policy and settings below. 7. From the **Assigned policy** drop-down list, select a file integrity monitoring policy. - Click **Edit Policy** to make changes to the policy. - Click **New Policy** to create a new policy based on the selected policy. 8. Lock or unlock policy inheritance based on your needs. If you lock inheritance, you can't create a new policy based upon this policy that breaks inheritance. > **Tip** > > Trellix recommends that you unlock policy inheritance for file integrity monitoring policies. **9** Click **Save**. ## Compare file versions When you enable file versioning, you can compare a file with a previous version, the baseline file, or a file on another system. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. Select **Menu | Reporting | File Integrity**, then select the **Events** tab. 2. Select a versioned file event, then select **Actions | Compare**. 3. The file in **File 1** is the file you selected. Use the drop-down lists to select another file or a different file version. Click **Preview** to see the file contents. 4. Select the options for the **File 2** panel. | **Option** | **Definition** | | --- | --- | | **Compare with the baseline on the above host** | Compare the file in the **File 1** pane to the baseline version. | | **Compare with the previous version on the above host** | Compare the file in the **File 1** pane to the previous file version. | | **Select a file** | Select another file for comparison on the system or another system: - **Host —** Opens the **Quick System Search** page. Select the file on the **Search Results** page, then click **Select**. - **File name —** A versioned file on the selected host. - **Version —** A version of the selected file. | **5** Click **Run Comparison**. [Table 9-4](/docs/mpa-654-pg-0-00-en-us#) | **Option** | **Definition** | | --- | --- | | **Show/Hide Attributes** | Show or hide the file attributes. | | **Context Size** | Sets the number of lines to show surrounding lines from the empty, deleted, inserted, or modified lines in **File 2**. | ## Accept file integrity monitoring events Trellix Policy Auditor generates events when monitored files change. You can accept events and automatically create a new file baseline. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. Select **Menu | Reporting | File Integrity**, then click the **Events** tab. 2. Select the file events to accept, then select **Actions | Accept**. ## Purge file integrity monitoring events Trellix Policy Auditor generates events when monitored files change. You can purge events based on their age. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. Select **Menu | Reporting | File Integrity**, then click the **Events** tab. 2. Select the file events to purge, then select **Actions | Purge**. 3. Edit the options to purge events older than the specified time. Select **Purge Baseline Events** to discard stored baseline settings, including the file text if versioning is enabled. 4. Click **OK**. ## Create a new file integrity monitoring baseline You can create a new file integrity monitoring baseline for all monitored files on a system. > **Note** > > Use the `Accept` command on the **File Integrity Events** page to accept events for files and automatically create new baselines. Task 1. **Select** **Menu | Reporting | File Integrity**, then select the **Systems** tab. 2. **Select** a system, then click **Actions | Reset Baseline**. 3. Click **Yes**. ## Query reports for file integrity monitoring Trellix Policy Auditor provides four built-in query reports for file integrity monitoring. Each report provides information about events and allows you to drill down to see detailed information. The query reports also allow you to accept or purge events and to compare file versions if file versioning is enabled. You can edit the queries, make new queries based on the existing queries, and add the queries to a dashboard. [PA: File Integrity - All Events](/docs/mpa-654-pg-0-00-en-us#) Displays an aggregated count of file integrity events grouped by the associated baseline date. [PA: File Integrity Event Counts](/docs/mpa-654-pg-0-00-en-us#) Displays a pie chart of file integrity events grouped by event type. [PA: File Integrity Events By System/Baseline Date](/docs/mpa-654-pg-0-00-en-us#) Displays a list of the file integrity exceptions encountered after a baseline reset, grouped by system and baseline date. [PA: File Integrity Events By System/Event Type](/docs/mpa-654-pg-0-00-en-us#) Display an aggregated count of file integrity events grouped by system. # Using rollup reporting You can run queries that report on summary data from multiple Trellix ePO - On-prem databases. Trellix Policy Auditor can use this feature to create rollup reports for audit results. ## Rollup capabilities You can roll up three types of audit information from multiple servers. The software provides rollup capabilities for these areas of audit information: - Benchmark results - Rule results - Check results, including patches Each of these areas is independent and any combination of the three can be rolled up. You can include information from each of the areas because the data is related. ## Rollup reporting considerations You should carefully plan your rollup reporting configuration before implementing the feature. Here are some issues to consider: - The volume of audit results can be substantial. Care should be given to only roll up essential data. This is especially true for rules and checks. - The actual time to complete the initial roll up reporting run varies based on the amount of data in the source databases. Future runs take less time if performed at frequent intervals. If the sources have a large amount of data, the roll up process might take several hours to complete. Each time the roll up server tasks are run, they appear in the Server Task Log to show the status of the process. - When creating reports, only include data that is being rolled up. Otherwise results might not be accurate. For example, if only rule results are being rolled up by a server task, don't include benchmark results in the report. ## Rollup server tasks Trellix Policy Auditor includes three predefined server tasks to provide rollup reporting. The tasks are disabled by default. The tasks can roll up information to provide a meaningful view of audit results from multiple servers. The server tasks have predefined settings that don't limit the data returned. You can configure the settings by editing the tasks from the server tasks page. # Roll Up Data - PA Audit Benchmark Results You can view rolled up information for audit benchmark results. | **Data rolled up** | **Actions** | | --- | --- | | Audit Benchmark Result Score Rollup | - **Purge** - No purging - Purge all - Purge rolled up items older than a specified period of time - **Filter** - Score - Scoring system - Audit end time - Audit expiration date - Audit name - Benchmark name - Benchmark profile - Is most recent result - System name - Waiver in effect - **Rollup method** - Incremental - Full | | Benchmark Text Rollup | - **Purge** - No purging - Purge all - **Filter** - (none available) - **Rollup method** - Incremental - Full | | Benchmark Version Rollup | - **Purge** - No purging - Purge all - **Filter** - (none available) - **Rollup method** - Incremental - Full | # Rollup Data - PA: Audit Rule Result You can view rolled up information for audit rule results. [Table 10-1 Rollup results](/docs/mpa-654-pg-0-00-en-us#) | Option | Description | | --- | --- | | **Audit Rule Result Rollup** | - **Purge** - No purging - Purge all - Purge rolled up items older than a specified period of time - **Filter** - Benchmark group name - Benchmark L1 group name - Benchmark parent group - Group path - Rule name - Rule result - Waiver type - **Rollup method** - Incremental - Full | | **Benchmark Text Rollup** | - **Purge** - No purging - Purge all - **Filter** (none available) - **Rollup method** - Incremental - Full | | **Group Text Rollup** | - **Purge** - No purging - Purge all - **Filter** (none available) - **Rollup method** - Incremental - Full | | **Group Tree Rollup** | - **Purge** - No purging - Purge all - **Filter** (none available) - **Rollup method** - Incremental - Full | ## Roll Up Data - Audit Check Result You can view rolled up information for the presence of software patches. | **Data rolled up** | **Actions** | | --- | --- | | Audit Check Result Rollup | - **Purge** - No purging - Purge all - Purge rolled up items older than a specified period of time - **Filter** - Check ID - Check result - Check status - Check type (Default filter: Check type = Patch) - **Rollup method** - Incremental - Full | | Audit Check Definition Rollup | - **Purge** - No purging - Purge all - **Filter** (none available) - **Rollup method** - Incremental - Full | | Audit Check Text Rollup | - **Purge** - No purging - Purge all - **Filter** (none available) - **Rollup method** - Incremental - Full | | Group Tree Rollup | - **Purge** - No purging - Purge all - **Filter** (none available) - **Rollup method** - Incremental - Full | # Rollup reports Trellix Policy Auditor comes with a number of predefined rollup reports. You can use these reports or use them as starting points to create new reports to fit your organizational needs. The predefined reports show different aspects of audit results and use aggregation and grouping to help you interpret the information. You can drill down into each of the reports to find more detailed information. - **PA Rollup Audit Rule Results Pass-Fail-Other** — Shows audit rules by status. - **PA Rollup Benchmark Results - Failed by Scoring Category** — Shows benchmark results, categorized by scoring category, where the system failed the audit benchmark. - **PA Rollup Benchmark Results - Pass-Fail-Unknown** — Benchmark results categorized as pass/fail/unknown. - **PA Rollup Benchmark Results - Pass-Fail-Unknown by Server** — Benchmark results categorized as pass/fail/unknown, grouped by server. - **PA Rollup Failed Audit Rule Results By Rule** — Displays failed audit results grouped by rule title and rollup server. - **PA Rollup Failed By Actual Result, Benchmark, Group, Server** — Displays the actual results of a rule that failed during an audit. Data is grouped by server, benchmark, benchmark group and actual result. The average score is also displayed. - **PA Rollup Failed Rules By Group And Server** — Displays the rules that failed when audited, grouped by benchmark group and server. - **PA Rollup Patch Compliance Grouped by Server and Status** — Displays the rolled up patch compliance status grouped by server and status. Counts reflect the number of patches in the status. - **PA Rollup Patch Compliance Overview** — Displays the rollup count of patches grouped by compliance status. - **PA Rollup Patch Status by Benchmark, Server and Status** — Displays the rollup patch status grouped by benchmark, server, and status. - **PA Rollup Patch Status by Status, Benchmark, and Server** — Displays the rollup patch status grouped by status, benchmark, and server. - **PA Rollup Patch Status Grouped by Benchmark, Status and Server** — Displays the rollup patch status grouped by benchmark, server, and status. - **PA Rollup Patch Status Grouped by Server and Status** — Displays the rollup of patch status grouped by server and status. - **PA Rollup Patch Status Grouped by Status and Server** — Displays patch status grouped by status and server. - **PA Rollup Rule Results By Result and Server** — Displays rules results that have been reported, grouped by result and server. - **PA Rollup Rule Results By Server and Result** — Displays the audit rule results grouped by each rollup server. ## Configure rollup reporting Configure rollup reporting on a server to collect summary information from multiple servers. ### Task 1. Set up your servers according to *Multi-server rollup querying in Trellix ePolicy Orchestrator - On-prem Product Guide*. Register each server with the reporting server. 2. On each server, including the rollup server, select and configure these data types in a server task: - **Audit Benchmark Result Rollup** - **Audit Check Result Rollup** - **Audit Rule Result Rollup** 3. Configure and enable the **Roll Up Data (Local ePO Server)** server task on the reporting server. --- # Using findings Findings supplement the results of an audit check with additional information about the state of the system. Instead of seeing a value of false for a test result, findings give more meaningful information such as The minimum password length is set to 6 but it should be set to 8 or higher . ## How findings work Trellix Policy Auditor reports findings for supported checks. Findings are enhanced audit results. They appear in interface pages and queries and include additional information about why a system failed a check. The software is installed as a separate Trellix Policy Auditor module called **Findings** and is exposed to Trellix and third-party applications through a Java API. This allows other applications to: - Report additional details about findings. - Perform custom actions on findings such as remediation on violations. - Waive or hide selected findings. - Ignore findings. Findings can include three types of information: - **Violations —** Reporting violations provides additional information in audit results. For example, if an audit expects a password with at least eight characters but finds a password with only six characters, the results show the actual and expected results. It is possible to create a check that reports thousands of violations. To conserve database resources you can set a violation limit that reduces the number of violations that can be displayed. Setting the violation limit to zero causes monitors and queries to display all violations. - **Compliant —** A message is displayed when the system complies with the audit. - **Incomplete —** A message is displayed when the results gathered are not complete because they exceed the violation limit. ## Types of violations Violations are one of the types of information that can be shown by findings. Violations can be one of three subtypes: - **Positive feedback** — Additional information is shown when a rule passes. For example, if a rule determines whether the password age of a system is less than 90 days and the password is 60 days old, the enhanced results show that the expected value is <90 and the actual value is 60. - **Violation with actual and expected values** — Additional information is shown when a rule fails. For example, if a rule determines the password of a system has eight or more characters and the password has six characters, the enhanced results show a violation with the expected value of 8 and the actual value of 6. - **Violation with instance data** — Additional information is shown for each instance of a violation, up to the violation limit. For example, if a rule asserts that folder ABC can only be accessed by administrators and the folder is shared, the enhanced results show every user that has access to the folder. If the number of users that have access to the folder is greater than the violation limit, then the additional violations don't appear in the report or query. ## Violation limit For some checks, failure can result in many violations. To save processing time, bandwidth, and disk space, Trellix Policy Auditor provides a violation limit that allows you to cap the number of violations shown. The violation limit sets the maximum number of violations that are created for a specific check. The default violation limit is 300. Setting the violation limit to zero shows all violations. You can change the violations shown globally through the system settings. You can also configure how violations are retained and purge by using per audit data maintenance, which allows you to override global system settings at the individual audit level. ## Other findings enhancements Findings provide additional enhancements that improve the user experience. Trellix Policy Auditor gives users the ability to: - Import third-party findings, such as stylesheets and messages. You can import findings from the **Checks** page of Trellix Benchmark Editor. - Hide or unhide findings. # Hide or unhide findings You can hide or unhide selected findings for a failed check contained in an audit with at least one failed result. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. **Select Menu | Risk & Compliance | Audits**, then click an audit. 2. In the **Rules Failed** column, click a number. 3. Under the **Result** column, click **fail** for a rule. 4. From the **Checks** pane, click **Results**. 5. Select the findings that you want to hide or show. | Use this... | To do this... | | --- | --- | | Actions \| Hide Findings | Hide findings in reports for the check in this audit. | | Actions \| Unhide Findings | Show findings in reports for the check in this audit. | # Using dashboards and queries Dashboards allow you to keep constant watch on your environment. Dashboards are collections of monitors, or reports. Monitors can be anything from a chart-based query to a small web application that is refreshed at a user-configured interval. You can create your own dashboards from query results or use the Trellix Policy Auditor default dashboards. Users must have the appropriate permissions to use and create dashboards. ### Are you setting up dashboards for the first time? When setting up dashboards for the first time: 1. Decide which default dashboards and default monitors that you want to use. 2. Create any needed dashboards and their monitors. See the Trellix ePO - On-prem documentation for detailed information about how to build query reports that can be added to a dashboard. ### Reporting queries and systems deleted from the System Tree Trellix Policy Auditor deletes audit results based on the policy audit retention settings. This means that audit results are not deleted when a system is removed from the Trellix ePO - On-prem **System Tree**. Because of this, Trellix Policy Auditor reporting queries cannot use permissions based on the **System Tree** or a subset. If a Trellix ePO - On-prem user has access to run or create report queries, the report shows audit results for all systems that have had results collected and maintained according to the policy audit retention settings. This also applies to systems deleted from the System Tree. ## Trellix Policy Auditor default dashboards Trellix Policy Auditor ships with seven default dashboards, each of which has its own default monitors. All dashboards are owned by the Trellix ePO - On-prem Administrators. Administrators must make additional dashboards active and public before other users can view them. When you log on to Trellix ePO - On-prem, these are the visible Trellix Policy Auditor dashboards. - PA: Applications Summary - PA: Compliance Summary - PA: MS Patch Status Summary - PA: Operations - PA: Patch Supersedence - PA: PCI Summary - PA: Scans Summary - PA: Systems Summary - PA: Top 10 Host Inventory You can make other dashboards visible from the **Dashboards** page by clicking **Options | Select Active Dashboards**, and selecting **Available Dashboards**. ## PA: Applications Summary The PA: Applications Summary dashboard provides a high-level overview of the number of installed and removed applications and their variations. The dashboard also allows you to drill-down each list item for detailed information. The drill-down allows you to view the systems associated with an application, patch, or browser extension. ### PA: Applications Summary The monitors included in this dashboard are: - **Discovered Applications** – Displays a list of Installed applications. The list also displays the number of systems where these are installed. - **Discovered Applications Version(s)** – Displays a list of all installed software and their versions. The list also displays the number of systems where the software is installed with each row for individual versions. - **Discovered Software Patches** – Displays a list of software patches installed. The list also displays the number of applications that has the patches applied. - **Discovered Browser Extensions** – Displays a list of installed Browser extensions. The list also displays the number of browsers discovered with the extensions. - **Removed Applications** – Displays a list of all removed applications and their versions. The list also displays the number of systems from which the software was removed with each row for individual versions. ## PA: Compliance Summary The PA: Compliance Summary dashboard provides a high-level overview of audit results with links and drill down access to detailed information. ### PA: Compliance Summary dashboard The monitors included in this dashboard are: - **PA: Benchmark Results - Pass/Fail/Unknown** — Displays a pie chart, grouped by benchmark results and classified by status. - **PA: Benchmark Results - Failed by Scoring Category** — Displays a pie chart grouped by scoring category. - **PA: Rule Results By Benchmark Group** — Displays a grouped bar chart with each bar representing the number of benchmark results. The benchmark results are categorized by benchmark group. - **PA: Benchmark Results - Fail/Unknown by L1 Group** — Displays a grouped bar chart of benchmark results, with each bar representing the number of benchmark results. The chart is categorized by first-level System Tree group where the system status is failed or unknown. - **PA: Waivers In Effect** — Displays a list of waivers currently in effect, grouped by first-level System Tree group and classified by type of waiver. - **PA: Errors by Rule** — Displays rules from audits that fail with a result of error. ## PA: MS Patch Status Summary The **PA: MS Patch Status Summary** dashboard is a set of monitors providing a high-level overview of Microsoft patches with links and drill down access to detailed information. ### PA: MS Patch Status Summary dashboard The monitors included in this dashboard are: - **PA: Status for MS Patch Benchmarks** — Displays a bar chart representing the deployment of all Microsoft patches, classified by status: - **PA: MS Critical Patch Status** — Displays a pie chart representing the deployment of all critical Microsoft patches - **PA: MS Unpatched Systems Grouped by MS Patch** — Displays the unpatched checks grouped by check ID. - **PA: MS Patch Status Grouped by Tag** — Displays a bar chart of patch status grouped by tag. - **PA: MS Patch Status Grouped By Severity** — Displays the patch status of Microsoft patches grouped by the vendor-assigned severity. - **PA: Trend of Unpatched Critical MS Patches** — Displays the deployment status of all critical unpatched Microsoft patches by month. The count displayed for each month is the number of critical patches that are not patched. ## PA: Operations The **PA: Operations** dashboard is a set of monitors providing a high-level overview of information about the database, unprocessed audit results, unprocessed findings results and agent events. ### PA: Operations dashboard The monitors included in this dashboard are: - **PA: Unprocessed Audits Results by Audit** — Displays unprocessed audit results grouped by audit. - **PA: Unprocessed Finding Results by Audit** — Displays unprocessed finding results grouped by audit. - **PA: Agent Events Grouped by Event Type** — Displays events reported by Trellix Policy Auditor agent grouped by the event type. - **PA: Table Space Usage** — Displays the space used by each table in the Trellix ePO - On-prem database. Values are updated when the **PA: Get Index and Space Statistics** server task is run. - **PA: Maintenance - Ending Index Fragmentation Compared to 30%** — Display details on index fragmentation gathered after index maintenance. Values are updated when the **PA: Maintain Database** server task is run. - **PA: Last Reported Index Fragmentation Level Compared to 30%** — Displays the latest index fragmentation information gathered compared to 30%. Values are updated when the **PA: Get Index and Space Statistics** server task is run. ## PA: Patch Supersedence As new patches are released, some replace or supersede older patches, and some patches become obsolete. Trellix Policy Auditor now reports which patches are the latest that you must apply to your systems. For this release, the patch supersedence reports work with audit result data generated when running benchmarks auditing for Microsoft Windows, Microsoft Office, and Adobe (for Microsoft Windows) patches. Patch supersedence reporting occurs on the server with no impact to the Trellix Agent. ### PA: Patch Supersedence dashboard This dashboard is similar to the **MS Patch Status Summary** dashboard, but it excludes obsolete patches. The dashboard includes the following monitors: - **PA: Critical Patch Status for non-superseded patches** — Displays the critical patches that have not been superseded by other patches. - **PA: Patch count by Vendor for non-superseded patches** — Displays the patch count by vendor for non-superseded patches. - **PA: Patch Status Grouped By Severity for non-superseded patches** — Displays the status of non-superseded patches, grouped by the vendor assigned severity. - **PA: Trend of Unpatched Critical Patches for non-superseded patches** — Displays the trend of unpatched critical patches for non-superseded patches. - **PA: Number of superseded patches** — Displays the count of superseded patches by vendor. - **PA: Number of superseded patches by platform and application** — Displays the superseded patches by platform and application. The **PA: MS Patch Status Summary** report is still accessible. The **PA: MS Patch Status Summary** displays all Microsoft patches, including superseded and obsolete patches. Patch results are shown in the **Audit Patch Results** table, which is accessible using the Trellix ePO - On-prem Query Builder. This table includes three new columns: - **Is Patch OVAL Check Superseded** — A Boolean value which represents whether the patch is obsolete. If you want a report that contains only the most current patches, select this column as a filter. - **Latest Superseding OVAL Check ID's** — If this patch is obsolete, this column contains the latest OVAL patch check ID. - **Superseding OVAL Check ID's** — If this patch is obsolete, this column lists all OVAL patch check IDs that supersede this specific patch. The **Patch Supersedence Mapping** table allows you to view the directory of OVAL patch checks and the mapping to other OVAL patch checks that supersede it. This table drives the **PA: Number of superseded patches** and **PA: Number of superseded patches by platform and application** queries. ## PA: PCI Summary The Payment Card Industry dashboard (PA: PCI Summary) provides a high-level overview of audit results with links and drill down access to detailed information. ### PA: Compliance Summary dashboard Some reports are grouped by PCI aggregation names. These are the PCI aggregation names: - Requirement 1: Install and maintain a firewall configuration. - PCI Failed Systems Grouped By Aggregation. - Requirement 3: Protect stored data. - Requirement 4: Encrypt transmission of data across public networks. - Requirement 5.1: Anti-virus software installed. - Requirement 5.1: Anti-virus software up-to-date. - Requirement 7: Restrict access to data. - Requirement 8: Assign a unique ID to each computer user. - Requirement 10: Track and monitor all access to network resources and data. The monitors included in this dashboard are: - **PA: PCI Req 1: Install & Maintain Firewall Config** — Displays a pie chart grouped by scoring category. - **PCI Req 2: Do Not Use Vendor Supplied Defaults** — Displays a grouped bar chart of benchmark results, with each bar representing the number of benchmark results. The chart is categorized by first-level System Tree group where the system status is failed or unknown. - **PCI Req 4: Encrypt Transmission of Data** — Displays a pie chart, grouped by benchmark results and classified by status. - **PCI Req 5: Use AV or App Whitelisting** — Displays rules from audits that fail with a result of error. - **PCI Req 6.4: Automate documentation in CMS** — Displays a grouped bar chart with each bar representing the number of benchmark results. The benchmark results are categorized by benchmark group. - **PCI Req 7: Restrict Access to Data** — Displays a list of waivers currently in effect, grouped by first-level System Tree group and classified by type of waiver. - **PCI Req 8: Unique ID for each computer user** — Displays a list of waivers currently in effect, grouped by first-level System Tree group and classified by type of waiver. - **PCI Req 10.3, 10.5, 11.5: File Integrity Monitoring** — Displays a list of waivers currently in effect, grouped by first-level System Tree group and classified by type of waiver. - **PCI Req 11.2 Run Vulnerability Scans** — Displays a list of waivers currently in effect, grouped by first-level System Tree group and classified by type of waiver. ## PA: Scans Summary **The PA: Scans Summary** allows you to search for specific systems. It also displays a graphical representation of the number of systems scanned successful per week for a defined period. ### PA: Scans Summary The monitors included in this dashboard are: - **Scanned System Summary** – Displays a graphical representation of the number of systems scanned successful per week for a defined period. - **Quick Find** – Search for systems that consist of items that match your search keyword. The items considered for the search are based on the category you select from the Collected Item drop-down list. For example: 1. Select **Applications** from the **Collected Items** drop-down. 2. Search with the keyword `Java`. The search result displays all systems that contain applications with the word Java in its file name, description, and properties. ## PA: Systems Summary The **PA: Systems Summary** dashboard provides a high-level overview of the total number of installed applications, running services, and ports for the systems on your network. ### PA: Systems Summary The monitors included in this dashboard are: - **Applications per system** – Displays a list of all systems and the total number of applications installed on them individually. - **Services per system** – Displays a list of all systems and the total number of running services on them individually. - **Ports per system** – Displays a list of all systems and the total number of open ports on them individually. - **CPEs per system** – Displays a list of all systems and the total number of CPEs on them individually. ## PA: Top 10 Host Inventory The Top 10 Host Inventory (**PA: Top 10 Host Inventory**) provides a high-level overview of inventory scan results through graphs and drill down access to detailed information. ### PA: Top 10 Host Inventory dashboard The monitors included in this dashboard are: - **Top 10 Applications** – Displays a graphical representation of the list of top 10 applications installed across all systems in your enterprise network. - **Top 10 Browser Extensions** – Displays a graphical representation of the top 10 browser extensions installed across all systems in your enterprise network. - **Top 10 Discovered Services** – Displays a graphical representation of the top 10 services running across all systems in your enterprise network. - **Top 10 Package Manager Applications** – Displays a graphical representation of the top 10 package manager applications installed across all linux-based systems in your enterprise network. - **Top 10 Software Patches** – Displays a graphical representation of the top 10 software patches installed across all systems in your enterprise network. - **Top 10 Discovered Ports** – Displays a graphical representation of the top 10 open ports across all systems in your enterprise network. ## Run a query After an audit completes, use the Trellix Policy Auditor queries to view the results. **Task** 1. **Select Menu | Reporting | Queries & Reports.** 2. Expand **Trellix Groups**, then select from these query groups available for Trellix Policy Auditor: - **Host Inventory** - **Policy Auditor** - **Policy Auditor Rollup** 3. Find the query you want to run, then click **Run**. ## Queries as dashboard monitors Use any chart-based query as a dashboard that is refreshed at a user-configured frequency, so you can use your most useful queries on a live dashboard. > **Caution** > > Using pie chart or bar chart could affect the performance of your Trellix ePO - On-prem. This is due to the large volume of data processed by the Policy Auditor queries. Instead we recommend that you create a custom query using Table based chart.. ## Trellix Policy Auditor default queries The **Queries & Reports** page provides a set of queries that provide high-level reports on benchmarks, checks, rules, audit results, file integrity monitoring, findings, rollup reporting, waivers, applications, services, ports, and CPEs. - You can run these queries or use them as starting points to create custom queries. See the Trellix ePO - On-prem documentation for details about customizing and creating queries. - The results would return large data. We recommend you use the Trellix ePO - On-prem filters while creating the queries or while viewing the results. - You can export the report to CSV format by clicking **Export to CSV**. - From the Reports page, you can tag systems by clicking **Tag Systems**. The dialog displays all the tags that you have created. See the Trellix ePO - On-prem documentation for details about creating and using Tags. > **Attention** > > You must create the tags on the Tag Catalog page for them to appear in the Reports page. > **Important:** > > - The query results might show duplicate entries. The could be due to a difference in the value of any of the other columns. > - For example, when your run the **Discovered Applications** query, you might see the same application and version listed twice. This happens when the value in any of the other columns such as **Install Date** and **Install Location** are different. > - Ensure that you select appropriate labels and values while creating custom queries for an accurate report. **Table 12-1 Trellix Policy Auditor custom query types** | **Query** | **Description** | | --- | --- | | Applications per System | Displays the count of applications on scanned systems. | | CPEs per Asset | Displays the count of applicable CPEs on scanned systems. | | Discovered Applications | Displays the applications discovered across the systems in your enterprise network. | | Discovered Applications (with System property filter) | Refines your search results using System property filters. This displays the applications discovered across the scanned system/group of systems in your enterprise network. | | Discovered CPEs | Displays the discovered applicable CPEs on scanned systems. | | Discovered CPEs (with System property filter) | Refines your search results using System property filters. This displays the applicable CPEs discovered across the scanned system/group of systems in your enterprise network. | | Discovered Network Interface | Displays all network-related information about scanned systems. | | Discovered Network Interface (with System property filter) | Refines your search results using System property filters. This displays the network-related information discovered across the scanned system/group of systems in your enterprise network. | | Discovered Ports | Displays the ports discovered across the systems in your enterprise network. | | Discovered Ports (with System property filter) | Refines your search results using System property filters. This displays the ports discovered across the scanned system/group of systems in your enterprise network. | | Discovered Registered Extension | Displays the discovered file formats on the scanned systems. | | Discovered Registered Extension (with System property filter) | Refines your search results using System property filters. This displays the file formats discovered across the scanned system/group of systems in your enterprise network. | | Discovered Services | Displays the services discovered across the systems in your enterprise network. | | Discovered Services (with System property filter) | Refines your search results using System property filters. This displays the services discovered across the scanned system/group of systems in your enterprise network. | | Discovered System Information | Displays the discovered system information of the scanned systems. | | Ports per Asset | Displays the count of ports on scanned systems. | | Removed Applications | Displays the list of removed applications on the scanned system. | | > **Note:** The Removal Date in the report specifies the date when the application removal was discovered. This column does not specify the date when the application is removed. | | Scan Summary | Displays the list of systems scanned in a set period across the enterprise. | | Scan Summary (with System property filter) | Refines your search results using System property filters. This displays list of systems scanned in a set period discovered across the scanned system/group of systems in your enterprise network. | | Services per Asset | Displays the count of services on scanned systems. | | System Information (with System property filter) | Refines your search results using System property filters. This displays the discovered BIOS, serial number and other system information discovered across the scanned system/group of systems in your enterprise network. | | Top 'n' Discovered Applications | Displays the most installed applications discovered across the systems in your enterprise network. You can define value of n in your query. | | Top 'n' Discovered Services | Displays the most run services discovered across the systems in your enterprise network. You can define value of n in your query. | | Top 'n' Discovered Ports | Displays the most opened ports discovered across the systems in your enterprise network. You can define value of n in your query. | --- **Table 12-2 Findings default queries** | Query | Description | | --- | --- | | FND: Chart of Current Finding Status Types | Pie chart of the current Finding Status types. | | FND: Chart of Finding Status Grouped By Finding Identifier | Displays a grouped summary of the Finding Status grouped by the Finding Identifier. | | FND: Count of Violations Grouped By Message | Displays the count of violations grouped by the message. | | FND: Finding Status Grouped By Finding Identifier | Displays a grouped summary of the Finding Status that is grouped by the Finding Identifier. | | FND: Findings By Status and Message | Displays the current Findings grouped by their status and the Finding message. | | FND: Grouped Summary of Finding Status for Systems | Displays a grouped summary of a system showing the counts of Finding Status. | **Table 12-3 Host Inventory default queries** | Query | Description | | --- | --- | | Discovered Browser Extensions | Displays a list of installed Browser extensions. The list also displays the number of browsers discovered with the extensions. | | Discovered CPEs | Displays the number of CPEs detected on the systems. | | Discovered Network Interfaces | Displays the list of network interfaces and their details. | | Discovered Package Manager Applications | Displays the managed Linux systems and the total number of installed applications on these systems. | | Discovered Ports | Displays the list of ports used by various processes and their details. | | Discovered Registered Extensions | Displays the list of all file formats and their associated executables on these systems. | | Discovered Services | Displays the list of services and their details. | | Discovered Software Patches | Displays the list of installed software patches and the number of systems that have them. | | Discovered Applications | Displays the list of installed applications, App store applications, and Windows features. | | Discovered Applications Version(s) | Displays the list of installed applications and their versions. | | Removed Applications | Displays the managed systems and the list of removed applications on these systems. | | Scanned System Summary | Displays a graph on the number of successful inventory scans. | | System Information | Displays a list of system information, such as BIOS details, FQDN, and System manufacture. | 12 | Using dashboards and queries --- **Table 12-3 Host Inventory default queries *(continued)*** | Query | Description | | --- | --- | | **Top 10 Browser Extensions** | Displays a bar chart with the list of top 10 browser extensions across all systems in your enterprise network. | | **Top 10 Discovered Ports** | Displays a list of top 10 open ports across all systems in your enterprise network. | | **Top 10 Discovered Services** | Displays a bar chart with the list of top 10 services running across all systems in your enterprise network. | | **Top 10 Package Manager Applications** | Displays a bar chart with the list of top 10 installed applications across all Linux systems in your enterprise network. | | **Top 10 Software Patches** | Displays a bar chart with the list of top 10 software patches across all systems in your enterprise network. | | **Top 10 Windows Applications** | Displays a graphical representation of the list of top 10 applications installed across all systems in your enterprise network. | **Table 12-4 Trellix Policy Auditor default queries** | Query | Description | | --- | --- | | **PA: Agent Events** | Displays a list of threat events received from the Trellix Policy Auditor Agent. | | **PA: Agent Events Grouped by Event Type** | Displays a list of events reported by Trellix Policy Auditor Agent grouped by the event type. | | **PA: Benchmark Checks** | Displays a bar chart count of checks included in all activated benchmarks, grouped by benchmark. | | **PA: Benchmark Results - Pass/Fail/Unknown** | Pie chart of benchmark results categorized as pass/fail/unknown. | | **PA: Benchmark Rules** | Displays a count of rules included in all activated benchmarks, grouped by benchmark. | | **PA: Check Catalog List** | List of OVAL checks in the check catalog. | | **PA: Check Catalog Usage List** | List of OVAL checks used in benchmarks, including the rule and benchmark associations. | | **PA: Check Result Findings** | Pie chart of findings for current check results. | | **PA: Checks Across Benchmarks** | Displays a list of checks with a count of their usage in activated benchmarks. | | **PA: Critical Patch Status for non-superseded patches** | Displays a pie chart of critical patches that are not superseded by other patches. | | **PA: Group Results By Benchmark Group** | Bar chart of results for groups in the benchmark. Counts are rolled up from child group to parent group. | | **PA: Group Rule Results By Benchmark Group** | Displays rule results grouped by the benchmark group. | | **PA: Group Rule Results By Rule Result** | Displays rule results for a benchmark group. The report is grouped on the rule result. | | **PA: Index Statistic List** | Displays a list of information about the indexes in the Trellix ePO - On-prem database. Values are updated when the **PA: Get Index and Space Statistics** server task is run. | | **PA: Maintenance - Beginning Index Fragmentation Compared to 30%** | Displays details about index fragmentation gathered during index maintenance. Values are updated when the **PA: Maintain Database** server task is run. | [12](/docs/mpa-654-pg-0-00-en-us#) | Using dashboards and queries **Table 12-4 Trellix Policy Auditor default queries *(continued)*** | **Query** | **Description** | | --- | --- | | PA: Maintenance - Index Detail | Displays information related to database index maintenance. Values are updated when the PA: Maintain Database server task is run. | | PA: MS Critical Patch Status | Displays the status of critical Microsoft patches. | | PA: MS SLA Non-Compliant Systems Grouped By Patch and Tag | Displays the noncompliant systems grouped by patch and tag. | | PA: MS SLA Non-Compliant Systems Grouped By Tag and Patch | Displays the noncompliant systems grouped by the tag and patch. | | PA: Number of superseded patches | Displays the count of superseded patches by vendor. | | PA: Number of superseded patches by platform and application | Displays the superseded patches by platform and application. | | PA: Patch count by Vendor for non-superseded patches | Displays the patch count by vendor for non-superseded patches. | | PA: Patch Status Grouped by Severity for non-superseded patches | Displays the trend of unpatched critical patches for non-superseded patches. | | PA: Systems by Audit | Displays the systems assigned to an audit. | | PA: Trend - Rollup of Systems Reporting Failed Benchmarks Status | Displays the trend of failed benchmark audits over time, grouped by rollup server. | | PA: Trend Of Benchmarks Reporting As Failed | Displays the trend of benchmarks that failed during the audit process. | | PA: Trend Of Checks Reporting As False | Displays the trend of checks that reported as false during the audit process. | | PA: Trend Of File Integrity Events | Displays the trend of File Integrity Events received from managed systems. | | PA: Trend Of Rules Reporting As Failed | Displays the trend of rules that failed during the audit process. | | PA: Trend of Unpatched Critical MS Patches | Displays the trend of the systems reporting unpatched critical Microsoft patches. | | PA: Trend of Unpatched Critical Patches for non-superseded patches | Displays the trend of unpatched critical patches for non-superseded patches. | | PA: Unprocessed Audit Results | Displays unprocessed audit results. | | PA: Unprocessed Audit Results by Audit | Displays unprocessed audit results, grouped by audit. | | PA: Unprocessed Audit Results By System | Pie chart of unprocessed audit results grouped by system. | | PA: Unprocessed FIM Results by System | Displays the unprocessed FIM results, grouped by system. | | PA: Unprocessed Finding Results | List of unprocessed Finding results. | | PA: Unprocessed Finding Results By Audit | Displays the unprocessed finding results, grouped by system. | | PA: Unprocessed Finding Results By System | Pie chart unprocessed Finding results grouped by system. | # Trellix Policy Auditor agent debug tool The Trellix Policy Auditor agent debug tool allows you to run audits, benchmarks, and checks on system and save the results, including debug information and the log file, to a .zip file. The debug tool has an interactive console interface for all non-windows systems and a graphical interface for Windows systems. ## Run checks on non-Windows systems Run a check on a non-Windows system from the terminal. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. Open the terminal on your non-Windows system. 2. Navigate to the folder containing the agent plug-in. 3. Type `enginemain -n` and press **Enter**. 4. Run on of the following commands: | Interface | Definition | | --- | --- | | **Audits** | Run an audit on a system based on the available benchmarks. **1** Enter `resultFile <filename>` to specify the path and name of the audit results file. Example: `resultFile /opt/McAfee/auditengine/bin` **2** Enter `auList` to display a list of audits and their ID. **3** Enter `auRun <ID>` where is the audit ID. The audit results are saved to the results file specified in step 1. | | **Benchmarks** | Run a benchmark for a system. **1** Enter `resultFile <filename>` to specify the path and name of the audit results file. Example: `resultFile /opt/McAfee/auditengine/bin` **2** Enter `bmList` to display a list of benchmarks and their ID. **3** Enter `bmRun <ID>` where is the benchmark ID. The benchmark results are saved to the results file specified in step 1. | | **Checks** | Run OVAL checks on a system. **1** Enter `resultFile <filename>` to specify the path and name of the audit results file. Example: `resultFile /opt/McAfee/auditengine/bin` **2** Enter `ovList` to display a list of benchmarks and their ID. **3** Enter `ovRun <ID>` where is the OVAL ID. The OVAL check results are saved to the results file specified in step 1. | | **File integrity** | Run file integrity checks on a system. **1** Navigate to `/opt/McAfee/auditengine/bin`. **2** Enter `./fimcli -help` to list all File integrity related commands. | **5** Enter `exit`, to close the console. # Run a check on a Windows system Run a check on a Windows system using the Debug Tool. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. Navigate to your Trellix Policy Auditor installation folder. By default, Policy Auditor is installed to `C:\Program Files (x86)\McAfee\Policy Auditor Agent`. 2. Run **DebugConsole.exe**, do any of the following | **Interface** | **Definition** | | --- | --- | | **Audits** | Run an audit on a system based on the available benchmarks. 1. Click **Audits** to display a list of available benchmarks on the system. 2. Select an audit that you want to run, then click **Run Selected Items...** 3. Click **Save Debug Info...**, then navigate to a desired location. 4. Enter a filename, then click **OK** to save the results file. **Note:** The Version and Content Version provides the respective details | | **Benchmarks** | Run a benchmark for a system. 1. Click **Benchmarks** to display a list of available benchmarks on the system. 2. Select a benchmark that you want to run, then click **Run Selected Items...** 3. Click **Save Debug Info...**, then navigate to a desired location. 4. Enter a filename, then click **OK** to save the results file. **Note:** The Content Version would provide the respective details | | **Checks** | Run OVAL checks on a system. 1. Click **Checks** to display a list of available OVAL results on the system. 2. Select an OVAL result that you want to check, then click **Run Selected Items...** 3. Click **Save Debug Info...**, then navigate to a desired location. 4. Enter a filename, then click **OK** to save the results file. | | **File Integrity** | Run file integrity checks on a system. 1. Click **File Integrity** to display a list of files that are monitored on the system. 2. Select a file that you want to check, then click **Run Selected Items...** 3. Click **Save Debug Info...**, then navigate to a desired location. 4. Enter a filename, then click **OK** to save the results file. | | **Blackout times** | Click **Blackout times** to view the blackout times of the week. The page also displays the day and time of the blackout. | 1. Click **Close** to close the Debug tool. ## Save debug information You can save debug information, including the log file and database, to a .zip file on the system. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. Execute the agent plug-in debug tool and perform an action, such as run an audit. 2. Save the debug information to a file. | Interface | Definition | | --- | --- | | Graphical | **1** Click **Save Debug info**. **2** Type a file name and location to save the .zip file, then click **OK**. | | Interactive | Enter `saveDebug`. The file is saved in the agent plug-in folder. | ## Enable debug logging Enable debug logging with the required detail, number of logs, and their maximum size. [Task](/docs/mpa-654-pg-0-00-en-us#) 1. Open the Trellix Policy Auditor agent plug-in debug tool console. Go to the `%PA installation directory%\Policy Auditor Agent\` directory, then double-click **DebugConsole.exe**. 2. Click **Enable Debug Logging**, then set these options as required. | Option | Definition | | --- | --- | | Max Backup Index | Provide the number of previous logs to include. | | Log Details | Select the level of detail that you want to include in logs. - **EMERG** — Logs those events only that are urgent. - **FATAL** — Logs those events only that are fatal. - **ALERT** — Logs only alert messages. - **CRIT** — Logs only critical messages. - **ERROR** — Logs only error messages. - **WARN** — Logs only warning messages. - **NOTICE** — Logs only notices. - **INFO (Default)** — Logs only informative messages. This logging level is set by default and it provides brief information about the execution details. - **DEBUG** — Logs detailed information that can be used for debugging. - **NOTSET** — Sets the logging preference to not set. | | Max File Size | Specify the maximum file size for the logs. | 1. (Optional) Click the **Save Debug Info** to generate logs. # Display help You can obtain online help on running the tool from the command prompt or command-line interface. Task 1. Open a command prompt on a Windows system or a command-line interpreter on a non-Windows system. 2. Navigate to the folder containing the agent plug-in. On Windows systems, this is usually `c:\Program Files (x86)\McAfee\Policy Auditor Agent`. 3. Execute the tool, then type the appropriate command to display help. | Command | Description | | --- | --- | | `engineMain.exe --help` | Displays help for the graphical version of the tool on Windows systems. | | `help` | Displays help for the interactive console version of the tool on all supported systems. | # Implementing the Security Content Automation Protocol Security Content Automation Protocol (SCAP) is a collection of open standards to identify vulnerable software and configuration issues. These security standards are developed jointly by United States government organizations and the private sector. Trellix Policy Auditor uses SCAP to perform automated audits, including policy compliance evaluations such as the Federal Information Security Management Act (FISMA). Trellix Policy Auditor uses SCAP version 1.3. Security content conforming to the SCAP standard can be used by any product supporting the standard and the results can be shared between these products. Trellix Policy Auditor also supports importing data streams and data streams with tailoring. A data stream is a collection of component files. > Note > > Imported tailored SCAP 1.3 benchmarks are read-only. You can't edit these benchmarks. Importing SCAP 1.3 benchmarks that are not tailored allows you to edit, tailor, or duplicate a benchmark. ## Statement of FDCC compliance Trellix asserts that Trellix Policy Auditor does not alter or conflict with the Federal Desktop Core Configuration (FDCC) settings on Microsoft Windows XP and Vista systems. These ports are used by Trellix Policy Auditor. | Setting | Port | Can be edited | | --- | --- | --- | | Agent-server communication | 80 | No | | Agent wake-up communication | 8081 | Yes | | Agent broadcast communication | 8082 | Yes | | Console-application server communication | 8443 | Only during installation | | Sensor-server communication | 8444 | Only during installation | | Security threats communication | 8801 | Only during installation | | SQL server TCP | 1443 | Only during installation | ## Statement of SCAP implementation The Security Content Automation Protocol (SCAP) is a collection of six open standards developed jointly by United States government organizations and the private sector. Security content conforming to the SCAP standard can be used by any product that supports the standard and the results can be shared among these products. Trellix Policy Auditor allows users to import and export benchmarks and checks that use SCAP. Users can tailor or edit benchmarks within the Trellix Benchmark Editor interface and activate them for use in audits. Benchmarks determine whether a system complies with the benchmark rules. Benchmarks also return results that can be converted to a human-readable format. Benchmarks and checks incorporate the following reference protocols to make sure that all rules are processed accurately and appropriately, and that the results appear properly in reports and export files. - Common Vulnerabilities and Exposures (CVE) - Common Configuration Enumeration (CCE) - Common Platform Enumeration (CPE) - Common Vulnerability Scoring System (CVSS) - eXtensible Configuration Checklist Description Format (XCCDF) - Open Vulnerability and Assessment Language (OVAL) Trellix Policy Auditor is compliant with SCAP 1.3 and detects and assesses thousands of systems from a Trellix Policy Auditor server. This standardization allows regulatory authorities and security administrators to construct definitive security guidance and to compare results reliably and repeatedly. Trellix Policy Auditor is designed exclusively around SCAP and manages all aspects of analyzing systems for compliance. It uses XCCDF and OVAL to determine which items to check and how to check them. It uses the CPE, CCE, CVSS, and CVE reference protocols to make sure that all rules are accurately and appropriately evaluated during system audits. The SCAP standard references are visible in the interface, reports, and export files. ## Statement of CVE implementation Trellix Policy Auditor fully implements and supports the Common Vulnerabilities and Exposures (CVE) standard vulnerability dictionary. CVE provides unique, standardized identifiers for security vulnerabilities. CVE address vulnerability and exposure issues, not compliance items. Trellix Policy Auditor implements and supports CVE enumeration, which provides standardized references to known vulnerabilities. CVE uses a named list of information security weaknesses, providing standardized identifiers to facilitate a universal naming convention. Each CVE identifier consists of: - A CVE identifier number, such as CVE-2008-0042 - An indication of whether the CVE has a status of "entry" or "candidate" - A description of the vulnerability - A list of any references, such as advisories or OVAL identification Trellix Policy Auditor patch and vulnerability definitions are updated periodically when new content is available. The audit results can be viewed from the Audits, Reports, or Dashboard user interface. CVE information is accessible from the Checks interface, which displays details of Common Vulnerabilities. Users can view even more detailed CVE information from the Check Details page, which displays the Source, ID, and URL. For example, the URL http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2005-2122 refers the user to the Mitre site to view details about CVE-2005-2122. The security content provided by Trellix refers to CVE identifiers when addressing vulnerabilities and whether a vendor's patch has been applied to address the vulnerability. Previous versions of Trellix Policy Auditor have been certified by Mitre as CVE-compatible. ## Statement of CCE implementation CCE provides a standard system for identifying and referencing system configuration settings. CCE identifies the configuration itself, not the way the configuration was reached. CCE encourages interoperability, improves the correlation of test results, and simplifies gathering metrics. Trellix Policy Auditor includes CCE references in the checks content. The Checks tab lists all the checks available to users. Clicking on a check with CCE content lists CCE references that identify the CCE system configuration settings. Trellix Policy Auditor incorporates and supports version 5.0 of the Common Configuration Enumeration (CCE) standard. Previous versions of Trellix Policy Auditor have been certified by Mitre as CCE-compatible. ## Statement of CPE implementation Trellix Policy Auditor implements version 2.3 of the Common Platform Enumeration (CPE) standard. CPE provides a standard reference and notation method for information technology systems, platforms, and packages. Trellix Policy Auditor contains the CPE data dictionary in the database, with some of it in aggregated format to promote ease of use. Information from this dictionary drives aspects of the Trellix Policy Auditor interface. Trellix Policy Auditor associates OVAL definitions with CPE names and allows users to specify CPE names at the benchmark, group, profile, or rule level. Trellix Policy Auditor users can create audits with SCAP content that cover a number of common operating systems and platforms. When CPE platforms are specified, Trellix Policy Auditor uses this information to determine whether it should evaluate compliance with a rule or group of rules. For example, an audit can cover Windows XP and Windows Vista operating systems, but not the Windows 2000 operating system. CPE allows Trellix Policy Auditor to use the correct content on the correct systems. Previous versions of Trellix Policy Auditor have been certified by Mitre as CPE-compatible. ## Statement of CVSS implementation Trellix Policy Auditor incorporates version 3.0 of the Common Vulnerability Scoring System (CVSS). CVSS is a standardized open framework for measuring the effect of vulnerabilities. Each CVE includes an associated CVSS vector to determine the relative severity of vulnerabilities. CVSS is built on a quantitative model that ensures repeatable measurements on systems, valid comparisons between systems, and that allows users to view the underlying vulnerability characteristics. Using CVSS scores helps an organization to determine and prioritize responses to detected vulnerabilities. Trellix Policy Auditor supports all four standard SCAP scoring models: - Flat - Unweighted - Absolute - Default The default setting for Trellix Policy Auditor is a flat unweighted scoring model normalized to a maximum possible score of 100. The scoring model can be changed for comparison purposes. Previous versions of Trellix Policy Auditor have been certified by Mitre as CVSS-compatible. ## Statement of XCCDF implementation The eXtensible Configuration Checklist Description Format (XCCDF) is an XML specification language that supports the exchange of information, generation of results, tailoring, automated compliance testing, and compliance scoring. It also provides a data model and format for storing results of benchmark compliance testing. XCCDF provides a uniform standard for the expression of benchmarks and other configuration guidance to encourage good security practices. Trellix Policy Auditor uses benchmarks from Trellix or third-party sources to construct audits. Users can select the benchmark profile, if any, to use for the audit. After a system is audited, the audit results are returned to Trellix Policy Auditor, which analyzes and reports on the configuration and vulnerability data. The users can specify how long audit data is retained so that they or auditors can review changes in the state of a system over time. Trellix Policy Auditor implements version 1.2 of XCCDF. Previous versions of Trellix Policy Auditor have been certified by Mitre as XCCDF-compatible. # Statement of OVAL implementation The Open Vulnerability and Assessment Language (OVAL) describes the ideal configuration of systems, compares systems to the ideal configuration, and reports the test results. It provides a structured model for network and system administrators to detect vulnerabilities and configuration issues on systems. Trellix Benchmark Editor uses the Checks interface to import and export OVAL definitions and other formats supported by XCCDF. These checks can be filtered based on OVAL IDs, platforms, or any criteria set by the user. The Check Details interface display a hyperlink to specific OVAL IDs, which displays OVAL in XML format. When a system is audited, the OVAL content is processed according to the information in the XCCDF benchmarks contained in the audit. The OVAL content captures the state of the system at the particular time that the audit is run. The results are returned to Trellix Policy Auditor for analysis and reporting. The users specifies how long to retain audit data so that they or auditors can review changes in the state of a system over time. Trellix Policy Auditor provides fully integrated support for OVAL 5.11.2. Previous versions of Trellix Policy Auditor have been certified by Mitre as OVAL-compatible.