To enable TLS-encryption in an RDP connection policy, you have two options:
Prerequisites
Depending on your requirements, you might need one or more of the following:
-
To use the same certificate for each session, an X.509 certificate and its private key are required. One Identity Safeguard for Privileged Sessions (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: 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, you need a signing certificate authority. For details on creating a signing CA, see Signing certificates on-the-fly.
TIP: One Identity recommends using 2048-bit RSA keys (or stronger).
To configure TLS-encryption
-
Navigate to Traffic Controls > RDP > Connections and select the connection policy in which you want to enable TLS.
Figure 212: Traffic Controls > RDP > Connections — Enabling TLS-encryption for RDP connections
-
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.
-
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. By default, this option is selected.
-
To use the same certificate for every peer, complete the following steps.
-
Generate and sign a certificate for SPS in your PKI system, and export the certificate and its private key.
-
Select Use the same certificate for each connection.
-
Select Private key for host certificate, click 
and upload the private key.
-
Select X.509 host certificate, click and upload the certificate.
-
If you want to use your own Signing CA, complete the following steps.
-
Create a certificate authority that is used to sign the certificates that SPS shows to the peer. For details, see Signing certificates on-the-fly.
-
Select Generate certificate on-the-fly.
-
In the Signing CA field, select the certificate authority to use.
NOTE: Import the certificate of the signing Certificate Authority to your clients. Otherwise, the client applications will display a warning because of the unknown Certificate Authority.
-
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 a compatibility issue if you attempt to connect to a very old Windows machine (for example, Windows Server 2003 or older).
-
(Optional) Even if you choose TLS-encryption, you have the option to choose using legacy RDP encryption as well. If you experience compatibility issues (for example, if you attempt to connect to a very old Windows machine, such as Windows Server 2003 or older) and want to allow using legacy RDP encryption if TLS-encryption is not possible, select Allow fallback to legacy RDP Security Layer (also known as: Standard RDP Security).
|
|
Caution: Security Hazard!
Selecting the Legacy RDP Security Layer or the Allow fallback to legacy RDP Security Layer options can significantly reduce the strength of the encryption used.
Selecting these options is only recommended if you cannot overcome compatibility issues in any other way.
To avoid security hazard, we recommend using TLS encryption. |
-
Click Commit.
Expected result
The encryption settings are applied to the connection policy.
Remote Desktop Gateway is a Remote Desktop Services server role. This role 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, for example:
-
Terminal servers
-
Remote desktops
-
Remote applications
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. One Identity Safeguard for Privileged Sessions (SPS) 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.
-
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 following are synchronized:
-
You cannot use the Gateway authentication on the SPS web interface for connection policies that use SPS as a Remote Desktop Gateway. However, you can 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 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.
-
You can use SPS as a Remote Desktop Gateway. You must configure the terminal service clients to use SPS as the Remote Desktop Gateway. SPS connects the server (selected inband) after authentication.
-
Remote Desktop Gateway requires 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 SPS interface. After that, use this alias in your connection policy and the client configurations. For details on creating IP aliases on SPS, see Managing logical interfaces.
|
|
Caution:
When the client uses hostname in inband destination selections, the hostname must comply with RFC5890: Internationalized Domain Names for Applications (IDNA). For example, from the ASCII characters only letters, digits, and the hyphen character is permitted.
Starting with version 6.1.0, SPS rejects connection requests where the hostname does not comply with RFC5890. |
To use SPS as a Remote Desktop Gateway
-
Navigate to Traffic Controls > RDP > Connections and create a new connection policy that will handle the incoming client connections that use the Remote Desktop Gateway Server Protocol.
-
Enable the Act as a Remote Desktop Gateway option.
Figure 213: Traffic Controls > RDP > Connections — Configuring SPS as a Remote Desktop Gateway (or RD Gateway)
-
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.
-
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.
TIP: 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 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.
-
In 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.
-
Configure other parameters of the connection policy as needed for your environment.
-
Click Commit.
To configure the Remote Desktop applications of the clients to perform two separate authentications. One of these authentications is on the Remote Desktop Gateway, that is, on One Identity Safeguard for Privileged Sessions (SPS). The other authentication is on the target server. For details on configuring SPS to act as a Remote Desktop Gateway (or RD Gateway), see Using One Identity Safeguard for Privileged Sessions (SPS) as a Remote Desktop Gateway.
Prerequisites
-
SPS must be configured to act as a Remote Desktop Gateway. For details, see Using One Identity Safeguard for Privileged Sessions (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.
To configure Remote Desktop clients for gateway authentication
-
On your Windows client, start the Remote Desktop Connection application and select Advanced > Settings.
Figure 214: Configuring Remote Desktop clients to use SPS as a Remote Desktop Gateway (or RD Gateway)
-
Configure the client to use SPS as its Remote Desktop Gateway. Select Connection settings > Use these RD Gateway settings.
Figure 215: Configuring Remote Desktop clients to use SPS as a Remote Desktop Gateway (or RD Gateway)
-
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.
-
Select Logon method > Ask for password (NTLM).
-
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.
-
Click OK.
-
Into the Username enter the domain username (for example, exampledomain\exampleusername).
-
Click Connect.
NOTE: Depending on your network environment, it might take up to a minute until the connection is established.
To use inband destination selection with RDP connections, it is recommended to use One Identity Safeguard for Privileged Sessions (SPS) as a Remote Desktop Gateway (or RD Gateway). For details, see Using One Identity Safeguard for Privileged Sessions (SPS) as a Remote Desktop Gateway.
To use inband destination selection with RDP connections without using One Identity Safeguard for Privileged Sessions (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.
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.
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 the % character to separate the fields, for example: username%my-targetserver
-
Do not use the @ character.
-
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.
