Policy Auditor 6.5.x Product Guide

Prev Next

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.


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

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

  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):

  • 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:

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

  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

  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

  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

  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

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

  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

  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.

    • Choose whether to reset the baseline scan data.

    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 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

  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

  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:        

    ./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 <Agent Guid>.zip format. Where <Agent GUID> 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

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

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

  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

  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

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

  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

  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

Displays an aggregated count of file integrity events grouped by the associated baseline date.

PA: File Integrity Event Counts

Displays a pie chart of file integrity events grouped by event type.

PA: File Integrity Events By System/Baseline Date

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

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

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

  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 | 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

  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 <ID> 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 <ID> 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 <ID> 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

  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

  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

  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.