Chat now with support
Chat with Support

One Identity Safeguard for Privileged Sessions 8.0 LTS - Administration Guide

Preface Introduction The concepts of One Identity Safeguard for Privileged Sessions (SPS)
The philosophy of One Identity Safeguard for Privileged Sessions (SPS) Policies Credential Stores Plugin framework Indexing Supported protocols and client applications Modes of operation Connecting to a server through One Identity Safeguard for Privileged Sessions (SPS) Archive and backup concepts Maximizing the scope of auditing IPv6 in One Identity Safeguard for Privileged Sessions (SPS) SSH host keys Authenticating clients using public-key authentication in SSH The gateway authentication process Four-eyes authorization Network interfaces High Availability support in One Identity Safeguard for Privileged Sessions (SPS) Versions and releases of One Identity Safeguard for Privileged Sessions (SPS) Accessing and configuring One Identity Safeguard for Privileged Sessions (SPS)
Cloud deployment considerations The Welcome Wizard and the first login Basic settings
Supported web browsers 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 Cleaning up audit data Using plugins Forwarding data to third-party systems Starling integration
User management and access control
Login settings Managing One Identity Safeguard for Privileged Sessions (SPS) users locally Setting password policies for local users Managing local user groups Managing One Identity Safeguard for Privileged Sessions (SPS) users from an LDAP database Handling user names in User Principal Name (UPN) format Authenticating users to a RADIUS server Authenticating users with X.509 certificates Authenticating users with SAML2 Managing user rights and user groups Creating rules for restricting access to search audit data Displaying the privileges of users and user groups Listing and searching configuration changes
Managing One Identity Safeguard for Privileged Sessions (SPS)
Controlling One Identity Safeguard for Privileged Sessions (SPS): reboot, shutdown Managing One Identity 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 MSSQL-specific settings RDP-specific settings SSH-specific settings Using Sudo with SPS Telnet-specific settings VMware Horizon View connections VNC-specific settings Indexing audit trails Using the Sessions interface Advanced authentication and authorization techniques Reports 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)
Network troubleshooting Gathering data about system problems Viewing logs on One Identity Safeguard for Privileged Sessions (SPS) Changing log verbosity level of One Identity Safeguard for Privileged Sessions (SPS) Collecting logs and system information for error reporting Collecting logs and system information of the boot process for error reporting Support hotfixes Status history and statistics Troubleshooting a One Identity Safeguard for Privileged Sessions (SPS) cluster Understanding One Identity Safeguard for Privileged Sessions (SPS) RAID status Restoring One Identity Safeguard for Privileged Sessions (SPS) configuration and data VNC is not working with TLS Configuring the IPMI from the BIOS after losing IPMI password Incomplete TSA response received
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 Configuring SPS to use an LDAP backend Glossary

Network troubleshooting

The Basic Settings > Troubleshooting menu provides a number of diagnostic commands to resolve networking issues. Logfiles of One Identity Safeguard for Privileged Sessions (SPS) can also be displayed here — for details, see Viewing logs on One Identity Safeguard for Privileged Sessions (SPS).

Figure 331: Basic Settings > Troubleshooting — Network troubleshooting with SPS

The following commands are available:

  • ping: Sends a simple message to the specified host to test network connectivity.

  • traceroute: Sends a simple message from SPS to the specified host and displays all hosts on the path of the message. It is used to trace the path the message travels between the hosts.

  • connect: Attempts to connect the specified host using the specified port. It is used to test the availability or status of an application on the target host.

To run one of the above commands

  1. Navigate to Basic Settings > Troubleshooting.

  2. Enter the IP address or the hostname of the target host into the Hostname field of the respective command. For the Connect command, enter the target port into the TCP port field.

    Use an IPv4 address.

  3. Click the respective action button to run the command.

  4. Check the results in the pop-up window. Log files are displayed in a separate browser window.

Gathering data about system problems

One Identity Safeguard for Privileged Sessions (SPS) automatically generates core dump files if an important software component (for example, Zorp) of the system crashes for some reason. These core dump files can be of great help to the One Identity Support Team to identify problems. When a core dump file is generated, the SPS administrator receives an alerting e-mail, and an SNMP trap is generated if alerting is properly configured (for details, see Configuring system monitoring on SPS and System logging, SNMP and e-mail alerts).

To list and download the generated core dump files, navigate to Basic Settings > Troubleshooting > Core files.

By default, core dump files are deleted after 14 days. To change the deletion timeframe, navigate to Basic Settings > Management > Core files.

Figure 332: Basic Settings > Troubleshooting — System troubleshooting with SPS

Viewing logs on One Identity Safeguard for Privileged Sessions (SPS)

The Troubleshooting menu provides an interface to view the logs generated by the various components of One Identity Safeguard for Privileged Sessions (SPS).

NOTE: Because of performance reasons, log files larger than 2 Megabytes are not displayed in the web interface. To access these logs, download the file instead.

To view logs on SPS

  1. Navigate to Basic Settings > Troubleshooting > View log files.

    Figure 333: Basic Settings > Troubleshooting — Viewing logs on SPS

  2. Use the Logtype roll-down menu to select the message type.

    • syslog: All system logs of the SPS host.

    • scb: Logs of the SPS web interface.

    • paa: Logs related to the workings of the One Identity Safeguard for Privileged Analytics module.
    • logadapter: Logs of the log adapter plugin(s) and syslog instance(s) configured for ingesting logs from an external source.

    • http: Logs of the HTTP connections passing through SPS.

    • ica: Logs of the ICA connections passing through SPS.

    • rdp: Logs of the RDP connections passing through SPS.

    • ssh: Logs of the SSH connections passing through SPS.

    • telnet: Logs of the Telnet connections passing through SPS.

    • vnc: Logs of the VNC connections passing through SPS.

  3. Use the buttons at the bottom of the dialog to perform the following tasks:

    • To download the log file, click Download.

    • To follow the current log messages real-time, click Tail.

    • To display the log messages, click View.

  4. To display log messages of the last seven days, select the desired day from the Day field and click View.

    TIP: To display only the messages of a selected host or process, enter the name of the host or process into the Show only messages containing field.

    The Show only messages containing field acts as a generic filter: enter a keyword or a regular expression to display only messages that contain the keyword or match the expression.

Changing log verbosity level of One Identity Safeguard for Privileged Sessions (SPS)

The logging level of One Identity Safeguard for Privileged Sessions (SPS) can be set separately for every protocol.

NOTE: The Basic Settings > Management > Verbose system logs > Enable option is not related to the verbosity of traffic logs: it increases the log level of the non-network-related events, for example adds the commands executed by the SPS web interface to the logs, and so on.

Figure 334: <Protocol name> Control > Global Options — Changing the verbosity level

To change the verbosity level of SPS

  1. Navigate to the Global Options page of the traffic you want to change the log level of, for example, to Traffic Controls > SSH > Global Options to change the log level of SSH traffic, Traffic Controls > RDP > Global Options for remote desktop traffic, and so on.

  2. Select the desired log level from the Verbosity level field. Note that the new verbosity level applies only to new sessions started after committing the change. The verbosity level of active sessions will not change.

    NOTE: The verbosity level ranges from 1 (no logging) to 10 (extremely detailed), with level 4 being the default normal level. To debug complex problems, you might have to increase the verbosity level to 7. Higher level is needed only in extreme cases.

    		 Caution:

    High verbosity levels generate very large amount of log messages and might result in a very high load on the machine.

    For log levels 8-10, the logs contain highly sensitive data for all connections, as well as passwords and private keys in plain text format.

  3. Click .

  4. Optional: To set a different verbosity level for sessions that belong to a specific Connection Policy, complete the following steps:

    • Navigate to the Connection Policy you want to modify.

    • Select Override global verbosity level.

    • Select the desired log level from the Connection specific verbosity level field. Note that the new verbosity level applies only to new sessions started after committing the change. The verbosity level of active sessions will not change.

    • Click .

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating