Generating Compliance Service Reports
Communicate the compliance status of your RHEL infrastructure to security stakeholders
Abstract
Chapter 1. Overview of compliance service reports
The compliance service enables users to download data based on filters in place at the time of download. Downloading a compliance report requires the following actions:
- Uploading current system data to Red Hat Insights for Red Hat Enterprise Linux
- Filtering your results in the compliance service web console
- Downloading reports; either exporting comma separated values (CSV) or JavaScript Object Notation (JSON) data, or as a PDF
Chapter 2. Uploading current system data to Insights
Whether you are using the compliance service to view system compliance status, remediate issues, or report status to stakeholders, upload current data from your systems to see the most up-to-date information.
Procedure
Run the following command on each system to upload current data to Insights for Red Hat Enterprise Linux:
[root@server ~]# insights-client --compliance
Chapter 3. Exporting compliance data for selected systems
Perform the following procedures to export a report showing compliance issues impacting your systems, based on filtering in place at the time of export.
3.1. Exporting a report for a single policy
Perform the following steps to export a compliance report for a single policy.
Procedure
- Navigate to the Red Hat Enterprise Linux > Compliance > Reports tab and log in if necessary.
- Click on the policy to view the report.
- Apply filters as needed to refine results.
- Click View policy for more detailed information such as compliance threshold and business objective.
- At the top of the systems list, click the download icon to the right of the Remediate button and select Export to CSV or Export to JSON, based on your export preferences.
- Choose to open or save the file. Then click OK.
3.2. Exporting a report for selected systems
Perform the following steps to export a compliance report for selected systems.
Procedure
- Navigate to Red Hat Enterprise Linux > Compliance > Systems and log in if necessary.
- Apply filters as needed to refine results.
- Select the systems you want to see in the report by checking the box next to each system name.
- At the top of the systems list, click the download icon and select Export to CSV or Export to JSON, based on your export preferences.
- Choose to open or save the file. Then click OK.
Chapter 4. Downloading PDF policy reports
The Insights for Red Hat Enterprise Linux compliance service enables you to create PDF reports for individual policies to share with stakeholders, such as your compliance team or auditors.
Reports include the following information:
- Policy details: policy type, operation system, compliance threshold, and business objective.
- Percentage of systems in compliance with the policy.
- Numbers of non-compliant and compliant systems.
- Non-compliant system information. You can select to include compliant systems when creating the report.
- List of top 10 failed rules: the most severe failed rules, along with the greatest number of failed systems for each rule, are ranked at the top.
4.1. Creating a PDF report for a policy
Perform the following steps to download a PDF report for a security policy.
Prerequisites
- You must be logged in to the Red Hat Hybrid Cloud Console.
- Policy reports are point-in-time reporting. Red Hat recommends uploading your latest system data to Insights for Red Hat Enterprise Linux before creating a policy report in the compliance service.
Procedure
-
Optionally run
insights-client --complianceon your systems to scan them and upload current data to the compliance service. - Navigate to Red Hat Enterprise Linux > Compliance > Reports.
- Locate the policy for which to create the report.
Click the download icon
on the far right of the same row as the policy name.
NoteYou can also click on the policy name and click Download PDF in the upper right of the page.
- In the Compliance report modal dialog, make selections for system data to include.
- Make selections for rule data to include.
- Optionally, add user notes.
- Click Export report.
Chapter 5. Deleting a compliance report
Prerequisites
- Login access to the Red Hat Hybrid Cloud Console.
Procedure
- Navigate to Red Hat Insights > Compliance > Reports. The list of available reports displays.
- Optional. Use the search filters to search for the report you want to delete. You may filter the reports by policy name, policy type, operating system, or by systems meeting compliance.
- Click the name of the report you want to delete. The report displays and shows the list of systems included in the report.
-
Click Delete report on the upper right side of the report. The Delete report dialog box appears with the message
Deleting a report is permanent and cannot be undone. - Click the Delete report button to confirm that you want to delete the report.
Chapter 6. Enabling notifications and integrations
You can enable the notifications service on Red Hat Hybrid Cloud Console to send notifications whenever a compliance policy is triggered. For example, you can configure the notifications service to automatically send an email message whenever a compliance policy falls below a certain threshold, or to send an email digest of all the compliance policy events that take place each day. Using the notifications service frees you from having to continually check the Red Hat Insights for RHEL dashboard for compliance event-triggered notifications.
Enabling the notifications service requires three main steps:
- First, an Organization Administrator creates a User access group with the Notifications administrator role, and then adds account members to the group.
- Next, a Notifications administrator sets up behavior groups for events in the notifications service. Behavior groups specify the delivery method for each notification. For example, a behavior group can specify whether email notifications are sent to all users, or just to Organization administrators.
- Finally, users who receive email notifications from events must set their user preferences so that they receive individual emails for each event or a daily digest of all compliance events.
In addition to sending email messages, you can configure the notifications service to send event data in other ways:
- Using an authenticated client to query Red Hat Insights APIs for event data
- Using webhooks to send events to third-party applications that accept inbound requests
- Integrating notifications with applications such as Splunk to route compliance events to the application dashboard
Additional resources
- For more information about how to set up notifications for compliance events, see Configuring notifications and integrations on the Red Hat Hybrid Cloud Console.
Chapter 7. Reference materials
To learn more about the compliance service, see the following resources:
Providing feedback on Red Hat documentation
We appreciate your feedback on our documentation. To provide feedback, highlight text in a document and add comments.
Prerequisites
- You are logged in to the Red Hat Customer Portal.
- In the Red Hat Customer Portal, the document is in the Multi-page HTML viewing format.
Procedure
To provide your feedback, perform the following steps:
Click the Feedback button in the top-right corner of the document to see existing feedback.
NoteThe feedback feature is enabled only in the Multi-page HTML format.
- Highlight the section of the document where you want to provide feedback.
Click the Add Feedback pop-up that appears near the highlighted text.
A text box appears in the feedback section on the right side of the page.
Enter your feedback in the text box and click Submit.
A documentation issue is created.
- To view the issue, click the issue link in the feedback view.