Chat now with support
Chat with Support

One Identity Safeguard for Privileged Sessions 5.9.0 - Administration Guide

Preface Introduction The concepts of SPS The Welcome Wizard and the first login Basic settings User management and access control Managing SPS
Controlling SPS: reboot, shutdown Managing Safeguard for Privileged Sessions clusters Managing a high availability SPS cluster Upgrading SPS Managing the SPS license Accessing the SPS console Sealed mode Out-of-band management of SPS Managing the certificates used on 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 (classic) interface Using the Search interface Searching session data on a central node in a cluster Advanced authentication and authorization techniques Reports The SPS RPC API The SPS REST API SPS scenarios Troubleshooting SPS Configuring external devices Using SCP with agent-forwarding Security checklist for configuring SPS Jumplists for in-product help Third-party contributions About us

Server host keys and certificates

The host keys and X.509 certificates of the trusted servers can be managed on the SSH Control > Server Host Keys page. When a client tries to connect to a server, SPS verifies the host key or the certificate of the server. SPS allows connections only to the servers listed on this page, unless the Accept key for the first time or the Accept certificate for the first time option is enabled in the connection policy.

  • To display the stored host keys of a host, enter its IP address into Host IP address field and click Search. Note that the search requires the exact IP address, and does not support wildcard characters.

    You can use IPv4 and IPv6 addresses as well.

  • To display the list of stored host keys, click Show All. Note that this function does not work if there are more than 250 hosts in the database. In this case, use Generate CSV instead.

  • To export the entire list into as a comma-separated list, click Generate CSV.

Figure 186: SSH Control > Server Host Keys — Server host keys

Automatically adding the host keys and host certificates of a server to SPS

Purpose:

The host keys and host certificates of the servers can be added either automatically or manually. To add the host key or certificates automatically, complete the following steps:

Steps:
  1. Navigate to the SSH Control > Connections.

  2. Configure a connection: fill the From, To, and Port fields.

    You can use IPv4 and IPv6 addresses as well.

    • To configure a transparent connection, enter the IP address of the server into the To field.

    • To configure a non-transparent connection, enter the IP address of SPS into the To field, and the address of the target server into the Target field.

  3. Click to display the advanced settings and verify that the Server side hostkey settings > Plain host key check option is set to Accept key for the first time.

    If the servers use X.509 certificates, select Allow X.509 host certificates, and verify that the X.509 host certificate check option is set to Accept certificate for the first time.

    Click Commit.

  4. Initiate an SSH connection from the client to the server. SPS will automatically record the host key of the server — the server's IP address and the host key will be listed on the SSH Control > Server Host Keys page.

Manually adding the host key or host certificate of a server

Purpose:

To add the host key or host certificate manually, complete the following steps:

NOTE:

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

Steps:
  1. Navigate to the SSH Control > Server Host Keys and click .

  2. Enter the IP address and port of the server into the Address and Port fields.

    You can use IPv4 and IPv6 addresses as well.

  3. To set the host key of the server, complete the following steps:

      • To add the RSA fingerprint of the server, click in the Public key (RSA) field.

      • To add the DSA fingerprint of the server, click in the Public key (DSA) field.

      A pop-up window is displayed.

    1. Figure 187: SSH Control > Server Host Keys — Uploading server host keys

      • Select Query to retrieve the host key from the server.

      • To upload the host key manually, select Browse, select the file, and click Upload. Optionally, you can also paste the key into the Copy-paste key section and select Upload.

        Close the window.

  4. To set the host certificates of the server, complete the following steps:

      • To add the RSA certificate of the server, click in the X.509 certificate (RSA) field.

      • To add the DSA certificate of the server, click in the X.509 certificate (DSA) field.

      A pop-up window is displayed.

    1. To upload the host key manually, select Browse, select the file, and click Upload. Optionally, you can also paste the key into the Copy-paste key section and select Upload.

      Close the window.

  5. Click Commit.

Creating and editing protocol-level SSH settings

Purpose:

SSH settings determine the parameters of the connection on the protocol level, including when the server-side connection is built, as well as the timeout value and greeting message of the connection. The following parameters determine which algorithms are used in the connections, and can be set independently for the client and the server side: key exchange, host key, cipher, MAC, and compression algorithms. Complete the following procedure to create a new SSH settings profile or edit an existing one.

Caution:

Before modifying any of the algorithm settings, check whether the default algorithms are supported by your SSH client and server.

If yes, then you can leave these settings untouched.

If not and you need to amend the default algorithm settings, ensure that the client and server sides are harmonized. You can either do that in SPS or on the client/server itself.

Note that modifying algorithm settings in SPS is recommended to advanced users only. If you are unsure about which settings to amend, then contact our Support Team for assistance.

Figure 188: SSH Control > Settings — SSH settings

Steps:
  1. Navigate to the SSH Control > Settings and click to create an SSH setting profile. Enter a name for the profile (for example strongencryption).

  2. Click to display the parameters of the SSH connection.

  3. To set a connection timeout value, enter a value in the Idle timeout field in milliseconds. To avoid early timeout, set it to a larger value, for example a week (604800000 milliseconds).

    Caution:

    Determining if a connection is idle is based on the network traffic generated by the connection, not the activity of the user. For example, if an application or the taskbar of a graphical desktop displays the time which is updated every minute, it generates network traffic every minute, negating the effects of timeout values greater than one minute and preventing SPS from closing the connection.

  4. To display a greeting message to the clients after connecting the server, enter the message into the Greeting field.

  5. To display a banner message to the clients before authentication (as specified in RFC 4252 — The Secure Shell (SSH) Authentication Protocol), enter the message into the Banner field. For example, this banner can inform the users that the connection is audited.

  6. Optional. You can specify additional text to append to the SSH protocol banner, for example to mask the OpenSSH version upon connection. Enter the text in the Software version field.

  7. If needed, modify the encryption parameters. SPS enforces policies on the various elements of the encrypted SSH communication, such as the MAC, key-exchange, and cipher algorithms that are permitted to be used. The parameters can be set separately for the client and for the server side. The attributes are comma-separated strings listing the enabled methods/algorithms, in the order of preference.

    For a complete list of the available parameters, see Supported encryption algorithms.

    NOTE:

    Do not use the CBC block cipher mode, or the diffie-hellman-group1-sha1 key exchange algorithm. For details, see "Supported encryption algorithms" in the Administration Guide.

  8. To check the protocol-level parameters of the connections very strictly, select the Strict mode option. This option is enabled by default. When this option is enabled:

    SPS will reject connections that use unrealistic parameters, for example:

    • The number of columns and rows of the terminal is bigger or equal than 512.

    • The size of the screen is greater than 8192 pixels in either directions.

    SPS will reject port-forwarding connections where the address in the port-forwarding request and the channel-opening request does not match.

    NOTE:

    Strict mode can interfere with certain client or server applications.

    NOTE:

    Strict mode is not working with the Windows 10 internal Bash/WSL feature, because it uses a very large terminal window size. Using Windows 10 internal Bash/WSL is not supported.

  9. Before establishing the server-side connection, SPS can evaluate the connection and channel policies to determine if the connection might be permitted at all, for example it is not denied by a Time Policy. To enable this function, select the Enable pre channel check option. That way SPS establishes the server-side connection only if the evaluated policies permit the client to access the server.

  10. Click Commit.

  11. Select this settings profile in the SSH settings field of your connections.

Related Documents