Chat now with support
Chat with Support

One Identity Safeguard for Privileged Sessions 5.8.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

Enabling TLS-encryption for RDP connections

Purpose:

To enable TLS-encryption in an RDP connection policy, you have two options:

  • Enable Network Level Authentication (NLA, also called CredSSP). To enable NLA in RDP connections, see Network Level Authentication (NLA) with SPS. Note that Network Level Authentication uses SSL-encryption with self-signed certificates, so you do not have to configure a signing CA.

  • Complete the following steps to configure TLS-encryption.

Prerequisites:

Depending on your requirements, one or more of the following might be needed:

  • To use the same certificate for each session, an X.509 certificate and its private key are required. SPS can display this certificate to the peers on the client side. Use your own PKI system to generate these certificates, as they cannot be created on SPS. Note that the Common Name of the certificate must contain the domain name or the IP address of target machine. otherwise the clients might reject the certificate.

  • To generate certificates on-the-fly for a connection, a signing certificate authority is required. For details on creating a signing CA, see Signing certificates on-the-fly.

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

Steps:
  1. Navigate to RDP Control > Connections and select the connection policy in which you want to enable TLS.

    Figure 171: RDP Control > Connections — Enabling TLS-encryption for RDP connections

  2. Set the encryption settings used between the client/server and SPS in the Transport security settings section.

    To require encryption, select TLS. When the connection is encrypted, SPS has to show a certificate to the peer.

  3. Select the certificate to show to the peers.

    • If you want to enable TLS-encryption, but you do not have a certificate that is generated by an external CA, or a signing CA, select Generate self-signed certificate. This option is selected by default.

    • To use the same certificate for every peer, complete the following steps.

      1. Generate and sign a certificate for SPS in your PKI system, and export the certificate and its private key.

      2. Select Use the same certificate for each connection.

      3. Select Private key for host certificate, click and upload the private key.

      4. Select X.509 host certificate, click and upload the certificate.

    • If you want to use your own Signing CA, complete the following steps.

      1. Create a certificate authority that will be used to sign the certificates that SPS shows to the peer. For details, see Signing certificates on-the-fly.

      2. Select Generate certificate on-the-fly.

      3. In the Signing CA field, select the certificate authority to use.

    • To disable TLS encryption for RDP connections completely, select Legacy RDP Security Layer (also known as: Standard RDP Security). You might want to do this if you were using legacy RDP encryption, and you are experiencing compatibility issues. For example, you might experience compatibility issue when you attempt to connect to a very old Windows machine (for example, Windows Server 2003 or older).

      Caution:

      Security Hazard!

      Selecting this option can significantly reduce the strength of the encryption used!

  4. Optional step: If you were using legacy RDP encryption, and you are experiencing compatibility issues, select Allow fallback to legacy RDP Security Layer (also known as: Standard RDP Security). For example, you might experience compatibility issue when you attempt to connect to a very old Windows machine (for example, Windows Server 2003 or older).

    Caution:

    Security Hazard!

    Selecting this option can significantly reduce the strength of the encryption used!

  5. Click Commit.

    Expected result:

    The encryption settings are applied to the connection policy.

Using SPS as a Remote Desktop Gateway

Purpose:

Remote Desktop Gateway is a role service in the Remote Desktop Services server role that allows authorized remote users to connect to resources located on an internal or private network from any Internet-connected device. The accessible resources can be terminal servers, remote applications, remote desktops, and so on.

The Remote Desktop Gateway Server Protocol is a remote procedure call (RPC) protocol using HTTPS as the transport mechanism, used primarily for tunneling client to server traffic across firewalls. The One Identity Safeguard for Privileged Sessions can act as a Remote Desktop Gateway, receiving connections using the Remote Desktop Gateway Server Protocol and transferring them to the target servers using the RDP protocol.

The Remote Desktop Gateway Server Protocol enables inband destination selection, meaning that SPS can extract the address of the target server from the client connections. This greatly simplifies managing connections on SPS without having to encode the name of the target server in the username, which was problematic as the length of the username is limited on many platforms — especially in non-transparent mode.

Prerequisites:
  • To access remote servers using a Remote Desktop Gateway, the clients must use version 6.1 or newer of the Remote Desktop application. Note that officially only version 6.0 is available for the Windows 2003 Server operating system, though it is possible to install a newer version. However, this is a problem only when initiating RDP connections from the Windows 2003 Server host, not when the Windows 2003 Server is the target of the connection.

  • SPS must be a member of a Windows Domain (for details on joining a domain, see Network Level Authentication (NLA) with domain membership), or you must use a Local User Database (for details, see Creating a Local User Database).

  • Ensure that the system times of the Domain Controller, the target servers, the clients, and SPS are synchronized.

  • Gateway authentication on the SPS web interface cannot be used for connection policies that use SPS as a Remote Desktop Gateway. However, the Remote Desktop applications of the clients can be configured to perform two separate authentications, one on the Remote Desktop Gateway (that is, on SPS), and one on the target server. For details on configuring the Remote Desktop applications of the clients to perform gateway authentications, see Configuring Remote Desktop clients for gateway authentication.

  • The Remote Desktop Gateway Server Protocol supports various authentication methods. SPS acting as a Remote Desktop Gateway supports only NTLM authentication.

  • SPS can be used as a Remote Desktop Gateway. The terminal service clients must be configured to use SPS as the Remote Desktop Gateway. SPS will connect the server (selected inband) after authentication.

  • Remote Desktop Gateway will require a certificate. Decide whether you want to use a fix certificate, or an on-the-fly generated certificate before performing the steps below and prepare the certificate.

  • You may also need to adjust the port settings of the connections. The default port for RDP connections is 3389, but the Remote Desktop Gateway Server Protocol uses port 443. However, the SPS web interface uses port 443 as well, and other connection policies might already use port 443. Therefore, if administrator or user login is enabled on the interface that receives the Remote Desktop Services connections, add a new alias IP address to the interface of SPS and use this alias in your connection policy and the client configurations. For details on creating IP aliases on SPS, see Managing logical interfaces.

Steps:
  1. Navigate to RDP Control > Connections and create a new connection policy that will handle the incoming client connections that use the Remote Desktop Gateway Server Protocol.

  2. Enable the Act as a Remote Desktop Gateway option.

    Figure 172: RDP Control > Connections — Configuring SPS as a Remote Desktop Gateway (or RD Gateway)

  3. Set the target of the connections.

    • To direct every incoming connection to a single target server, select Use fixed address and specify the address of the target server.

    • To extract the destination address from the Remote Desktop Gateway Server Protocol, select Inband destination selection and set the address of the servers the clients are allowed to access in the Target > Domain fields. For details on using inband destination selection, see Modifying the destination address.

    NOTE:

    In non-transparent mode, enter the IP address generated for the Remote Desktop Gateway service into the To field. Do not enter the IP address configured for administrator or user login.

  4. To act as a Remote Desktop Gateway, SPS needs to display a certificate to the clients.

    • To display always the same certificate, select Use the same certificate for every connection and upload the X.509 certificate and the matching private key.

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

      Caution:

      The Common Name (CN) of the certificate must be the FQDN of SPS, which is the address of the Remote Desktop Gateway specified in the client applications. Otherwise the clients will reject the connections.

    • To automatically create new certificates on SPS for every client, select Generate certificate on-the-fly, then select the Certificate Authority (CA) to sign the generated certificates with from the Signing CA field. For details on creating a signing CA, see Signing certificates on-the-fly.

      By default, the Common Name (CN) of the generated certificate is <SPS-hostname.domainname>. You can set a custom Common Name in the Custom Common Name field.

      NOTE:

      Save the CA certificate used to sign the certificate that SPS shows into DER format and import it to the clients into the Local Computer > Trusted Root Certificate store of the clients so that the clients can verify the identity of SPS.

  5. Under Authentication backend:

    • To use Active Directory for authentication, select Active Directory.

    • To use a Local User Database for authentication, select Local User Database, enter the Domain, and select the Local User Database from the list.

  6. Configure other parameters of the connection policy as needed for your environment.

  7. Click Commit.

Configuring Remote Desktop clients for gateway authentication

Purpose:

To configure the Remote Desktop applications of the clients to perform two separate authentications: one on the Remote Desktop Gateway (that is, on SPS), and one on the target server. For details on configuring SPS to act as a Remote Desktop Gateway (or RD Gateway), see Using SPS as a Remote Desktop Gateway.

Prerequisites:
  • SPS must be configured to act as a Remote Desktop Gateway. For details, see Using SPS as a Remote Desktop Gateway.

  • The client must use version 6.1 or newer of the Remote Desktop application.

  • The target server must be member of a domain.

  • The logical interface of SPS must be accessible from the client. You might have to add the address of the logical interface to the Windows/System32/Drivers/etc/hosts file to accomplish this.

Steps:
  1. On your Windows client, start the Remote Desktop Connection application and select Advanced > Settings.

    Figure 173: Configuring Remote Desktop clients to use SPS as a Remote Desktop Gateway (or RD Gateway)

  2. Configure the client to use SPS as its Remote Desktop Gateway. Select Connection settings > Use these RD Gateway settings.

    Figure 174: Configuring Remote Desktop clients to use SPS as a Remote Desktop Gateway (or RD Gateway)

  3. Enter the address of SPS into the Server name field. Use the address of the SPS's logical interface that you have configured to accept RDP connections.

  4. Select Logon method > Ask for password (NTLM).

  5. Uncheck the Bypass RD Gateway server for local addresses and Use my RD Gateway credentials for the remote computer options.

    NOTE:

    Technically, gateway authentication is performed even if the Use my RD Gateway credentials for the remote computer option is selected, but the same credentials are used on the gateway and on the remote server.

  6. Click OK.

  7. Into the Username enter the domain username (for example, exampledomain\exampleusername).

  8. Click Connect.

    NOTE:

    Depending on your network environment, it might take up to a minute until the connection is established.

Inband destination selection in RDP connections

To use inband destination selection with RDP connections, it is recommended to use SPS as a Remote Desktop Gateway (or RD Gateway). For details, see Using SPS as a Remote Desktop Gateway.

To use inband destination selection with RDP connections without using SPS as a Remote Desktop Gateway (or RD Gateway), you must use SSL-encrypted RDP connections (see Enabling TLS-encryption for RDP connections).

Configure your RDP clients so SPS can record the username of client uses in the connection. If you do not configure these settings on the clients, SPS will automatically display a login screen for the users to enter their usernames and passwords. Note that although SPS automatically displays a login screen if it cannot determine the username used in the connection, currently you cannot specify the destination address in this login screen, only in your RDP client application.

  • On Windows Vista SP1 and newer platforms (Remote Desktop Protocol 6.1 or newer):

    Navigate to Local Group Policy Editor > Computer Configuration > Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Connection Client and enable the Prompt for credentials on the client computer option in the clients. For details, see the Microsoft Documentation.

  • On Windows Vista and older platforms (Remote Desktop Protocol 6.0 or older):

    Configure your RDP clients to save the credentials, or make sure that the Allow me to save credentials option is selected in the RDP client.

Also, your users have the option to encode the address of the destination server in their username, in the username field of their client application. Note that SPS automatically displays a login screen if it cannot determine the username used in the connection, or you have not encoded a destination server in the username field. You can specify the destination address in the login screen when prompted.

When encoding the address of the destination server in the username, there are a few points to keep in mind. Since most RDP client applications limit which special characters can be used in usernames, this is not always intuitive. For the Microsoft Remote Desktop application (mstsc) and the login screen that SPS displays, note the following points:

  • Use % character to separate the fields, for example: username%my-targetserver

  • To specify the port number of the server (if it does not use the default port), use the caret ^ character, for example: username%my-targetserver^6464

  • To specify an IPv6 address, replace the colons with carets, and enclose the address in parentheses. For example, to target the ::1 IP address, use username%(^^1). To target port 6464 of the same server, use username%(^^1)^6464.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating