One Identity Safeguard for Privileged Sessions 6.2.0 - Administration Guide

Preface Introduction The concepts of One Identity Safeguard for Privileged Sessions (SPS) The Welcome Wizard and the first login Basic settings
Supported web browsers and operating systems The structure of the web interface Network settings Configuring date and time System logging, SNMP and e-mail alerts Configuring system monitoring on SPS Data and configuration backups Archiving and cleanup Forwarding data to third-party systems Joining to One Identity Starling
User management and access control Managing One Identity Safeguard for Privileged Sessions (SPS)
Controlling One Identity Safeguard for Privileged Sessions (SPS): reboot, shutdown Managing Safeguard for Privileged Sessions (SPS) clusters Managing a High Availability One Identity Safeguard for Privileged Sessions (SPS) cluster Upgrading One Identity Safeguard for Privileged Sessions (SPS) Managing the One Identity Safeguard for Privileged Sessions (SPS) license Accessing the One Identity Safeguard for Privileged Sessions (SPS) console Sealed mode Out-of-band management of One Identity Safeguard for Privileged Sessions (SPS) Managing the certificates used on One Identity Safeguard for Privileged Sessions (SPS)
General connection settings HTTP-specific settings ICA-specific settings RDP-specific settings SSH-specific settings Telnet-specific settings VMware Horizon View connections VNC-specific settings Indexing audit trails Using the Search interface Advanced authentication and authorization techniques Reports The One Identity Safeguard for Privileged Sessions (SPS) RPC API The One Identity Safeguard for Privileged Sessions (SPS) REST API One Identity Safeguard for Privileged Sessions (SPS) scenarios Troubleshooting One Identity Safeguard for Privileged Sessions (SPS) Using SPS with SPP Configuring external devices Using SCP with agent-forwarding Security checklist for configuring One Identity Safeguard for Privileged Sessions (SPS) Jumplists for in-product help LDAP user and group resolution in SPS

Viewing session details

The session info window provides in-depth information on each of the indexed session stored in the connection database. You can use it to gain contextual insight about the indexed session and its events.

Access the session info window in the following ways:

  • In card view, click the button in the last column of the relevant session.

  • In table view, click the button.

    Figure 235: Search — Accessing session details

The session info window is displayed:

Figure 236: Session details

The session info window provides details about the sessions on tabs.

Overview tab

The Overview tab is divided into the following main areas:

  • The Events area displays session events in chronological order.

    View the date and time of the event, the event type and event details. To filter events, use the Events tab.

  • The Score area shows the risk score that the Analytics Module assigned to the session. Ranges from 0 to 100, 100 is the highest risk score.
  • The Quick look area contains user information, for example, gateway and server username, start and end time of the session, and so on.

    The gateway username corresponds to the Username field of the connection metadata database, so note the following:

    • If the user performed inband gateway authentication in the connection, the field contains the username from the gateway authentication (gateway username).

    • Otherwise, the field contains the username used on the remote server.

  • The Interesting events area displays events selected as interesting, for example, a list of commands and window titles from the session that could be interesting from a security point of view.

    The list of interesting events is currently hard-coded and cannot be modified. For terminal sessions it includes commands such as chmod, ssh, shutdown, sudo, su, mount, adduser, addgroup. For graphical sessions, it contains window titles such as Management Console, Control Panel, Server Manager, PowerShell, Security Settings, Windows Security Center.

  • The Network area displays session information, for example, verdict, protocol, connection policy, client and server address.

Details tab

In addition to the Quick look, Interesting events, and Network screen areas, the Details tab provides monitoring information, audit trail downloads information, and channels information, too.

Events tab

The Events tab displays the:

  • Session events in chronological order.

    You can narrow the event list by entering the event name in the Filter events field.

  • Date and time of the event.

  • Event type (command, screen content, window title).

  • Event details.

Alerts tab

The Alerts tab displays the:

  • Content policy alerts triggered in the session, in chronological order.

    You can narrow the alert list by entering the alert name in the Filter alerts field.

  • Date and time of the alert.

  • Alert details.

  • Screenshots. If screenshots are available for the session, you can click each alert to view the corresponding screenshot.

Screenshots are generated for search results and alerts when the session is opened, and for subsequent searches.

Screenshots are not available for:

  • Ongoing sessions.

  • Unindexed sessions.

  • Trails of HTTP sessions.

  • Encrypted trails (without the necessary certificate).

Contents tab

You can search in the contents of the audit trails as follows:

  • From your browser: Use this method to find all the sessions containing your search query.

    Enter the screen.content: expression search filter in the Search query field. For example: screen.content="exit". The search returns all the sessions where exit was on the screen.

  • From the Safeguard Desktop Player application: Use this method to find the exact location of the search query within a specific audit trail.

    Download the relevant audit trail, open it in the Safeguard Desktop Player application, and use the Search feature. You can also search in the contents of the audit trails for trails of graphical sessions created and indexed with One Identity Safeguard for Privileged Sessions (SPS) 6.0.

For more information, see Searching in the contents of audit trails.

Analytics tab

If you use the One Identity Safeguard for Privileged Analytics, you can view detailed analyses provided by the configured algorithms. For more information, see Analyzing data using One Identity Safeguard for Privileged Analytics.

Viewing active connections

If a connection is not closed and is still active, the label is displayed in the session info window.

To close an active connection, click the label.

You can also view the live connection as follows:

  1. Click the label.

  2. Download the audit trail.

    Trail data is exported in .srs format, which you can open with the Safeguard Desktop Player application.

    For more information on the Safeguard Desktop Player, see Safeguard Desktop Player User Guide.

Frequent Item Set (FIS) flow view visuals

Frequent Item Set (FIS) flow view visuals are also available on the Analytics tab. The FIS flow view is essentially similar to the flow view analytics overview, except that the FIS flow view only displays data narrowed down to a single user's previous sessions in the analysis period (which is the previous 90 days by default). For more information, see Visualizing Frequent Item Sets on the FIS flow view.

Session tags

Session tags allow you to get basic information about the session and its contents at a glance.

Scripted session tag: One Identity Safeguard for Privileged Sessions (SPS) currently supports the scripted session tag. SPS uses One Identity Safeguard for Privileged Analytics to detect if sessions are generated using human interaction or automation. If sessions are generated using automation, SPS displays the scripted tag in the search interface as shown below:

  • Scripted sessions are shown on the main search screen.

    Figure 237: Scripted sessions — cards view

  • Scripted sessions are shown on the Overview tab.

    Figure 238: Scripted sessions — Overview tab

Visualizing Frequent Item Sets on the FIS flow view

This section provides an overview of the Frequent Item Sets (FIS) flow view feature on the Search interface. It describes the underlying component (that is, the FIS algorithm), the elements of the FIS flow view visual, and possible scenarios (depending on your session details and pattern option choice).

From One Identity Safeguard for Privileged Sessions (SPS) version 6.2., a visual overview of Frequent Item Set (FIS) analysis is available on the Search interface. The FIS flow view is essentially similar to the flow view analytics overview, except that the FIS flow view only displays data narrowed down to a single user's previous sessions in the analysis period (which is the previous 90 days by default).

The component behind the analysis is the FIS algorithm, which examines multiple attributes of sessions and attempts to find values that frequently appear together, forming a set. Using this information, the algorithm can discover patterns in user behavior.

NOTE:

For the FIS algorithm to be able to score a user's sessions, the user needs at least 1 FIS baseline built. Algorithm baselines (including the FIS baselines) are built automatically every day (usually during hours with less heavy traffic).

Elements of the FIS flow view

To access the FIS flow view feature, click on of the session of your choice in Search > Sessions list, then click Analytics.

Figure 239: Search — The FIS flow view on the Analytics tab

Figure 240: Search — The FIS flow view (close-up)

The layout of the FIS flow view is similar to the attributes-grouped flow view, with the sessions forming a flow line (from here on referred to as a Connection). The relevant examined attributes (including the attribute nodes) are visible on the left hand side, while the irrelevant attributes (including the attribute nodes) are on the right hand side of the flow line visual.

The continuous line, with circles representing attribute nodes (that can be gray ( ) or contain the or the mark), displays the current session. Each attribute node represents that particular attribute's value in the current session. The FIS algorithm attempts to match these attribute values to the patterns in the user's baseline.

The different attribute node markings stand for:

: session data for this attribute is irrelevant for pattern match comparison (or session data is part of the Default option)

: session data for this attribute is a match for the selected pattern

: session data for this attribute is not a match for the selected pattern

Attributes

Similarly to the flow view, session data in the FIS flow view is grouped according to attributes (such as Protocol, Client name, Server hostname, Server port, and so on) that come from session data. The two attributes in the FIS flow view that do not come from session data as-is, but are further grouped instead:

  • Bucketed starting hour: the most frequently used session starting hours grouped into intervals of 3 hours each

  • Bucketed duration: the most frequently occurring session duration values, grouped into intervals of various length

NOTE:

As a rule, the relevant attributes and attribute nodes (marked with or ) are located on the left hand side of the flow line visual, while the irrelevant attribute nodes (marked with ) are located on the right hand side of the flow line visual. The number of relevant attributes for the pattern match comparison, as well as the attribute groups' (and, as a result, the attribute nodes') relative position and relative order (going from left to right) changes from pattern to pattern on the flow line visual.

The FIS score gauge

The FIS score gauge (located in the upper right corner of the FIS flow view visual) indicates the FIS score of the selected session.

Figure 241: Search — The FIS score gauge

The FIS score is assigned to the session after the FIS algorithm analyzes it in comparison with the latest available baseline. If the session has a high amount of matches to the user's baseline, the FIS score's value will be low (indicating normal user behavior).

NOTE:

The closer the FIS score gets to 100, the more it indicates unusual user behavior. For more information about normal and unusual user behavior, see Analyzing data using One Identity Safeguard for Privileged Analytics, Viewing session details, and this section.

The value of the FIS score (also visible on the Search > Sessions list, as well as in the aggregated score summary, usually above the FIS flow line visual) is one of the several components of the session's aggregated score.

Figure 242: Search — The FIS score visible on Search > Sessions list

For more information about analytics algorithms and scores, see this section.

Pattern selection drop-down list

The pattern selection drop-down list (by default set to the Default option) offers the available patterns that the FIS algorithm generates after baseline analysis.

Figure 243: Search — The pattern selection drop-down list (set to the Default option)

Figure 244: Search — The pattern selection drop-down list (further options)

Depending on which available pattern option you select, the visual will display one of these cases:

  • The Default option

    The Default option is the set of values that the FIS algorithm takes as a reference point. If you select the Default option, the flow line visual displays the user's previous sessions in the observed analysis period, with no patterns selected yet. The flow line visual below (set to the Default option) displays all possible attributes, marked with in all attributes.

    Figure 245: Search — FIS flow view - the Default option (no patterns displayed yet)

  • Pattern with a 100% match to this user's sessions during the observed analysis period

    The example below displays a pattern that appears in 100% of the user's previous sessions during the analysis period. As mentioned before, the relevant attribute nodes (marked with the or the sign, depending on whether that attribute value matches or does not match the Default option in that particular session) are arranged on the left-hand side, while the irrelevant ones (marked with ) are arranged on the right-hand side of the flow line visual. There are 3 attribute matches (namely, Protocol, Recording Connection policy, and Server port) to this particular pattern in this particular session.

    Figure 246: Search — FIS flow view - a pattern with a 100% match

  • Pattern with a high match percentage to this user's sessions during the observed analysis period

    The example below displays a pattern that appears in 92% of the user's previous sessions during the observed analysis period. Similarly to the previous example, the relevant attribute nodes are arranged on the left-hand side, while the irrelevant ones are arranged on the right-hand side of the flow line visual. This example contains different relevant attribute nodes than the previous example, with 4 attribute matches to this particular pattern in this particular session.

    Figure 247: Search — FIS flow view - a pattern with a high match percentage

  • Pattern with a low match percentage to this user's sessions during the observed analysis period

    The example below displays a pattern with a low match percentage, appearing in only 12% of this user's previous sessions during the observed analysis period. There are 3 attribute nodes that match ( marked with ) and 3 attribute nodes that do not match ( marked with ) this particular pattern in this particular session.

    Figure 248: Search — FIS flow view - a pattern with a low match percentage

With the baseline generated every day on average (usually during hours with less heavy traffic), the baseline itself is continuously changing. As a result, the available patterns are also continuously changing over time.

Pattern match percentage

The pattern match percentage is a percentage value displayed under the pattern selection drop-down list, next to the pattern name (for example, Pattern 0 | Pattern 1, and so on).

 

Figure 249: Search — FIS flow view - the pattern match percentage

The percentage value always matches the value displayed next to the Pattern options (other than the Default option) in the drop-down list. The percentage indicates to what percent the selected pattern matches this user's sessions during the observed analysis period. Patterns that appear in less than 10% of this user's sessions during the observed analysis period are not displayed in the drop-down list as Pattern options (but may appear in the overall sum of Total count data, as mentioned in Displaying further details of individual Connection segments.

Displaying further details of individual Connection segments

Hovering on an individual Connection segment of the visual displays the exact number of occurrences of that particular attribute value during the observed analysis period. When the Connection splits to several branches (for example, in the example below, the Connection splits into separate branches according to Bucketed starting hour), hovering over the branched Connection segment of your choice will display that particular attribute's further details (namely, the attribute data (for example, IP addresses), and the Total count).

NOTE:

The Total count values include session data originating from patterns that appear in less than 10% of the user's sessions during the observed analysis period.

Figure 250: Search — Hovering on particular Connection segments to display further details

Replaying audit trails in your browser

The following describes how to create and replay an audit trail in your browser.

Caution:

You can replay audit trails in your browser, or using the Safeguard Desktop Player application. Note that there are differences between these solutions.

Browser Safeguard Desktop Player
Works without installation -
Works on any operating system Windows, Linux, Mac
Can replay audit trails recorded with SPS 5 F4 and newer
Can replay TN5250 sessions
Can extract files from SCP, SFTP, HTTP and RDP sessions -
Can replay HTTP sessions - Only exports raw files from the command line
Can replay X11 sessions
Can start replay while rendering is in progress -
Can follow 4-eyes connections -
Can replay live streams in follow mode -
Can export to PCAP -
Can display user input
Can display subtitles for video -
Export audit trail as video -
Export screen content text -
Can search in the contents of the audit trails -

For details on the Safeguard Desktop Player application, see Safeguard Desktop Player User Guide.

Caution:

Even though the One Identity Safeguard for Privileged Sessions (SPS) web interface supports Internet Explorer and Microsoft Edge in general, to replay audit trails you need to use Internet Explorer 11, and install the Google WebM Video for Microsoft Internet Explorer plugin. If you cannot install Internet Explorer 11 or another supported browser on your computer, use the the Safeguard Desktop Player application. For details, see "Replaying audit trails in your browser" in the Administration Guide and Safeguard Desktop Player User Guide.

To replay an audit trail in your browser

  1. On the Search page, find the audit trail you want to replay.

  2. Click to display the details of the connection.

    Alternatively, in the table view, click .

  3. Click to generate a video file from the audit trail you want to replay. Depending on the load of the indexer and the length and type of the audit trail, this can take several minutes.

    When the video is available, changes to and . You can use the button if you want to remove the generated video. After you remove the video file, the button is available and you can use it to recreate the video file.

  4. (Optional) If you have encrypted audit trails but the necessary certificates and private keys are not uploaded into your private keystore, you have to upload the keys first. After uploading them, click . The feature decrypts the encrypted upstream traffic elements. As a result, they will be displayed distributed in the generated video (see List of keyboard events, Show / hide events, and both versions of the Progress bar in the The Player window has the following controls: below).
  5. To replay the video, click .

    The Player window opens.

    Figure 251: Replaying audit trails in your browser

    TIP:

    You can quickly zoom in or out by clicking anywhere in the Player window.

    The Player window has the following controls:

    • : Play, Pause

    • , : Jump to previous event, Jump to next event

    • : Adjust replay speed

    • : Time since the audit trail started / Length of the audit trail. Click on the time to show the date (timestamp) of the audit trail.

    • : List of keyboard events. Special characters like ENTER, F1, and so on are displayed as buttons. If the upstream traffic is encrypted, upload your permanent or temporary keys to the User menu > Private keystore to display the keyboard events. This will not be displayed if your upstream traffic is encrypted but not unlocked.

    • : Active mouse button

    • : Create a screenshot

    • : Show / hide events. Select the types of events to display. Depending on the protocol used and how the audit trail was processed, One Identity Safeguard for Privileged Sessions (SPS) can display keyboard events, commands, mouse events, and window titles. Commands and window titles are displayed as subtitles at the top of the screen. This will not be displayed if your upstream traffic is encrypted but not unlocked.

    • : Fullscreen mode

    • : Progress bar

    • : Shows the distribution of events. Blue - commands, green - keyboard events, yellow - mouse events, orange - window title. This will not be displayed if your upstream traffic is encrypted but not unlocked.

    • : Close the player, and return to the Connection details page.

Replaying encrypted audit trails in your browser

To view screenshots generated for encrypted audit trails and replay encrypted audit trails in your browser, you have to upload the necessary certificates and corresponding private keys to your private keystore. Depending on the encryption, decrypting the upstream part of an audit trail may require an additional set of certificates and keys.

Only RSA keys (in PEM-encoded X.509 certificates) can be uploaded to the private keystore.

NOTE:

Certificates are used as a container and delivery mechanism. For encryption and decryption, only the keys are used.

One Identity recommends using 2048-bit RSA keys (or stronger).

Use every keypair or certificate only for one purpose. Do not reuse cryptographic keys or certificates (for example, do not use the certificate of the One Identity Safeguard for Privileged Sessions (SPS) webserver to encrypt audit trails, or the same keypair for signing and encrypting data).

For more information on audit trail encryption, see Encrypting audit trails and for more information about replaying audit trails in your browser, see Replaying audit trails in your browser.

You can upload certificates permanently or temporarily. The temporary certificates are deleted when you log out of SPS.

The certificates and private keys in your keystore can be protected with a passphrase. To use the certificates and private keys in a passphrase-protected keystore for decrypting audit trails, you have to unlock the keystore first by providing the security passphrase. The keystore then remains unlocked for the duration of your session.

To replay encrypted audit trails in your browser

  1. Click on User Menu > Private keystore.

    Figure 252: User Menu > Private keystore — The private keystore

  2. (Optional) Create a security passphrase, if you have not configured one yet.

    1. In Security passphrase, click Change.

    2. In the New: field, enter your new security passphrase. Repeat the same passphrase in the Confirm: field.

      NOTE:

      SPS accepts passwords that are not longer than 150 characters. The following special characters can be used: !"#$%&'()*+,-./:;<=>?@[\]^-`{|}

    3. Click Apply.

    If you forgot your security passphrase, contact our Support Team.

  3. Click to add a new certificate. A new empty row is added.

    Figure 253: Adding certificates

  4. Click the first (under Certificate) to upload the new certificate. A pop-up window with the header Changing certificate is displayed.

    Figure 254: Uploading certificates

  5. Click Choose File, select the file containing the certificate, and click Upload. Alternatively, you can also copy-paste the certificate into the Certificate field and click Set.

  6. To upload the private key corresponding to the certificate, click the second icon (under Key). A pop-up window with the header Changing key is displayed.

    Figure 255: Uploading the private key

  7. Click Choose File, select the file containing the private key, provide the Password if the key is password-protected, and click Upload. Alternatively, you can also copy-paste the private key into the Key field, provide the Password there, and click Set.

  8. To add more certificate-key pairs, click and repeat the steps above.

  9. To finish uploading certificates and keys to your private keystore, click Apply.

Related Documents