One Identity Safeguard for Privileged Sessions (SPS) can index the contents of audit trails using its own indexer service or external indexers. Indexing extracts the text from the audit trails and segments it to tokens. A token is a segment of the text that does not contain whitespace: for example words, dates (2009-03-14), MAC or IP addresses, and so on. The indexer returns the extracted tokens to SPS, which builds a comprehensive index from the tokens of the processed audit trails.
Once indexed, the contents of the audit trails can be searched from the web interface. SPS can extract the commands typed and the texts seen by the user in terminal sessions, and text from graphical protocols like RDP, Citrix ICA, and VNC. Window titles are also detected.
SPS has an internal indexer, which runs on the SPS appliance. In addition to the internal indexer, external indexers can run on Linux hosts.
Processing and indexing audit trails requires significant computing resources. If you have to audit lots of connections, or have a large number of custom reports configured, consider using an external indexer to decrease the load on SPS. For sizing recommendations, ask your One Identity partner or contact our Support Team.
SPS also creates statistics of the occurrences of the search keywords, as well as screenshots from the audit trail. These statistics and screenshots can be included in custom reports as subchapters.
NOTE: The screenshots of the sessions containing the search keywords are not included in the report output for security reasons, but you can access the screenshots by using the clickable QR codes.
For more information on accessing the screenshots, see section Report output.
NOTE: Consider the following:
-
The screenshot generated from the search results contains the first occurrence of the search keywords. If your search keywords are visible in the audit trail for a longer period, it is possible that the first occurrence is not the most relevant.
-
For technical reasons, trail data in terminal connections (SSH and Telnet) is aggregated for each second. The screenshot generated for the report reflects the terminal buffer, as it was visible at the end of that second. If data that contains the search keyword was pushed off-screen during this second, the search still finds it, but it will not be visible on the generated screenshot. Similarly, if you search for multiple keywords, it is possible that you will receive results that do not contain every keyword on the same screen (but they were separately visible within the one-second interval).
NOTE: Only audit trails created after the content subchapter has been configured will be processed. It is not possible to create reports from already existing audit trails.
Prerequisites for the indexer service
If you are indexing the audit trails with the indexer service, make sure to enable indexing for the connections you want to include in the report. Otherwise, reporting on audit trail content will not work. For more information, see Configuring the internal indexer.
To configure SPS to create reports from the contents of audit trails
-
Login to the SPS web interface, and navigate to Reporting > View & edit subchapters > Content-based.
Figure 348: Reporting > View & edit subchapters > Content-based — Configuring audit trail reports
-
Click Create new and enter a name for the subchapter.
-
Enter the search keywords (or parts of the words) into the Search words field. The search keywords are used to search in the contents of the recorded traffic.
Note the following points.
-
Your search expression must be shorter than 255 characters.
-
The search is not case sensitive.
-
Wildcards and regular expressions are not supported.
-
To search for an exact phrase or expression, enclose the keywords in double quotes, for example "program files".
-
Configure filters to select the audit trails to index. The following filters are available:
-
Protocol: Process only audit trails of the specified traffic type (for example SSH).
-
Connection policy: Process only audit trails of the specified connection policy.
-
Channel policy: Process only audit trails of the specified channel policy.
-
Username: Process only audit trails where the specified username was used in the connection. Available only for protocols where the username is known (for example SSH).
-
Source IP address: Process only audit trails where the specified client IP address or port was used.
-
Target IP address: Process only audit trails where the specified server IP address or port was used.
NOTE: If you do not configure any filters, every available audit trail will be processed. Audit trails are created only for channels where the Record audit trail option is enabled for the particular channel in the channel policy.
-
Click Save.
-
Navigate to Reporting > Create & Manage Reports, and add the new subchapter to an existing report, or create a new report. For more information, see Configuring custom reports.
Figure 349: Reporting > Configuration > Add Subchapter — Adding subchapters to reports
You can turn any search query or statistics into a subchapter to add to your reports. This is an easy and flexible way of creating reports to monitor traffic, track certain parameters, or get alerted about particular events.
To create a search-based report subchapter from search results
-
Navigate to Search and define a valid search query.
-
Click 
Create report. The Create new subchapter page is displayed, with the Search query field populated with your query.
Figure 319: Search > Create report - Example subchapter created from search results with Query field populated
-
In the Subchapter title field, add a title to your subchapter.
- In Subchapter type, select the type that fits your query:
-
Sessions list: Displays a list of sessions.
Set Number of sessions and from Subchapter columns, select the session parameters to be displayed in a table in the report. You can add a maximum of 10 columns to the table.
-
Timeline view: Visualizes the timeline of sessions that meet the criteria of the Search query field, depending on the time range (day/month/week) selected at the Scheduling & Delivery step of the report configuration.
-
Statistics view: Visualizes the statistics data for the option you select in Field, for sessions that meet the criteria of the Search query field.
Select a presentation option for your report, such as List, Pie chart, or Bar chart. In Field, select the data field to create your statistics on.
-
Select Add to a report, and select from the list of available reports.
Alternatively, to configure a custom report from scratch and include this subchapter in it, select Include in a new report. For more information, see Configuring custom reports.
This section describes how to create a search-based subchapter from scratch to include the subchapter in a custom report.
To create a search-based report subchapter from scratch
-
If you have multiple SPS appliances organized into a cluster where one of the nodes is the Search Master (or Central Search) node, log in to that node.
-
Navigate to Reporting > Create and Manage Reports > View & edit subchapters > Search-based.
-
Select Create new. The Create new subchapter page is displayed.
Figure 320: Reporting > View & edit subchapters > Search-based — Create new subchapter
-
In Subsection title, add a title to your subchapter.
-
In Search query, enter a valid query.
- In Subchapter type, select the type that fits your query:
-
Sessions list: Displays a list of sessions.
Set Number of sessions and from Subchapter columns, select the session parameters to be displayed in a table in the report. You can add a maximum of 10 columns to the table.
-
Timeline view: Visualizes the timeline of sessions that meet the criteria of the Search query field, depending on the time range (day/month/week) selected at the Scheduling & Delivery step of the report configuration.
-
Statistics view: Visualizes the statistics data for the option you select in Field, for sessions that meet the criteria of the Search query field.
Select a presentation option for your report, such as List, Pie chart, or Bar chart. In Field, select the data field to create your statistics on.
-
Select Save.
-
To save your changes, navigate to Create and Manage reports and select Commit.
-
Add your subchapter to a new report or to an existing report. For more information, see Configuring custom reports.
To find and add the subchapter you created to a report, navigate to Reporting > Create and Manage Reports > View & edit subchapters > Search-based.
To help you comply with the regulations of the Payment Card Industry Data Security Standard (PCI DSS), One Identity Safeguard for Privileged Sessions (SPS) can generate reports on the compliance status of SPS. Note that this is not a fully-featured compliance report: it is a tool to enhance and complement your compliance report by providing information available in SPS. The report corresponds with the document Payment Card Industry (PCI) Data Security Standard, Requirements and Security Assessment Procedures, Version 3.0, published by the PCI Security Standards Council.
For details on the contents of the report, see Contents of PCI DSS reports.
To create PCI DSS reports
-
Log in to the SPS web interface, and navigate to Reporting > Create & Manage Reports > Built-in reports > PCI DSS > Create report.
Figure 350: Reporting > Create & Manage Reports > Built-in reports > PCI DSS > Create report — Generating PCI DSS reports
-
By default, members of the report group can access the custom reports through the SPS web interface. To change this, click Edit and enter the name of a different group into the Groups field.
NOTE: Members of the listed groups can access only these custom reports even if their groups do not have read access to the Reporting > Download reports page. However, only those reports will be listed, to which their group has access to.
-
By default, SPS sends out the reports in email to the address set in the Basic Settings > Management > Mail settings > Send reports to field.
NOTE: If this address is not set, the report is sent to the SPS administrator's email address.
-
To disable email sending, clear the Deliver in email option.
-
To email the reports to a different address, select Custom, and enter the email address where the reports should be sent. Click Add email to list multiple email addresses if needed.
-
Click Update report.
-
Click Create report.
The report will be automatically added in the list of reports (Reporting > Download reports), and also sent in an e-mail to the regular recipients of the report.
