One Identity Safeguard for Privileged Sessions 6.0.1 - Administration Guide

Enabling TLS-encryption for Telnet connections

The following steps describe how to enable TLS-encryption in a Telnet connection policy. Note that when using encryption, One Identity Safeguard for Privileged Sessions (SPS) automatically changes the port number of the connection policy to 992.

To enable TLS-encryption in a Telnet connection policy

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

   Figure 197: Telnet Control > Connections — Enabling TLS-encryption for Telnet connections

   

2. Set the encryption settings used between the client and SPS in the Client-side transport security settings section.

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

   • To enable encrypted connections that use the STARTTLS method, select STARTTLS. Note that the peer must use the STARTTLS method. Unencrypted connections will be terminated after a brief period.

3. Select the certificate to show to the peers.

   • 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.

   • To use a separate certificate for every connection, 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.

4. Select how SPS should authenticate the peers.

   • To permit connections from peers without requesting a certificate, select No certificate is required.

   • To permit connections only from peers with a valid certificate that was signed by a specific CA, complete the following steps.

     1. Create a list of trusted Certificate Authorities that will be used to validate the certificates of the peers. For details on creating a trusted CA list, see Verifying certificates with Certificate Authorities.

     2. Select Only accept certificates authenticated by the trusted CA list.

     3. Select the certificate authority list to use in the Trusted CA field.

5. Set the encryption settings used between SPS and the server in the Server-side transport security settings section.

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

   • To enable encrypted connections that use the STARTTLS method, select STARTTLS. Note that the peer must use the STARTTLS method. Unencrypted connections will be terminated after a brief period.

6. Select the certificate to show to the server.

   • If the server does not require a certificate from SPS, select None.

   • 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.

   • To use a separate certificate for every connection, 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. Select the certificate authority to use in the Signing CA field.

   Limitations

   NOTE: When using the Use the same certificate for each connection option and the connection policy that allows access to multiple servers using HTTPS, the client applications will display a warning because the certificate used in the connection will be invalid (namely, the Common Name of the certificate will not match the hostname or IP address of the server).

   NOTE: Import the certificate of the signing Certificate Authority to your clients. Otherwise, the client applications will display a warning due to the unknown Certificate Authority.

7. Select how SPS should authenticate the peers.

   • To permit connections from peers without requesting a certificate, select No certificate is required.

   • To permit connections only from peers with a valid certificate that was signed by a specific CA, complete the following steps.

     1. Create a list of trusted Certificate Authorities that will be used to validate the certificates of the peers. For details on creating a trusted CA list, see Verifying certificates with Certificate Authorities.

     2. Select Only accept certificates authenticated by the trusted CA list.

     3. Select the certificate authority list to use in the Trusted CA field.

8. Click .

   Expected result

   The encryption settings are applied to the connection policy.

Creating a new Telnet authentication policy

An authentication policy is a list of authentication methods that can be used in a connection. Connection definitions refer to an authentication policy to determine how the client can authenticate to the target server. Separate authentication methods can be used on the client and the server-side of the connection.

To create a new authentication policy

1. Navigate to Telnet Control > Authentication Policies, and click .

   Figure 198: Telnet Control > Authentication Policies — Configuring Telnet authentication policies

   

2. Enter a name for the policy into the Name field.

3. Select the authentication method used on the client-side in the One Identity Safeguard for Privileged Sessions (SPS)Authenticate the client to SPS using field. For the client-side connection, SPS can authenticate the client inband (within the Telnet protocol) using the following authentication methods:

   • LDAP: SPS will authenticate the client to the LDAP database set in the LDAP Server of the connection policy. To use LDAP authentication on the client side, select Authenticate the client to SPS using > LDAP.

     NOTE: SPS will authenticate the client-side connection to the LDAP server configured in the connection policy. This is not necessarily the same as the LDAP server used to authenticate the users accessing the SPS web interface.

   • Local user database: Authenticate the client locally on the SPS gateway using a Local user database. Select the database to use in the Local user database field. For details on creating a Local User Database, see Creating a Local User Database.

   • RADIUS: SPS will authenticate the client to the specified RADIUS server. Select Authenticate the client to SPS using > RADIUS, enter the IP address or hostname of the RADIUS server into the Address field, the port number of the RADIUS server into the Port field, and the shared secret of the RADIUS server into the Shared secret field. Only password-authentication is supported (including one-time passwords), challenge-response based authentication is not.

     Use an IPv4 address.

     To add more RADIUS servers, click and fill in the respective fields.

   • None: Do not perform client-side authentication, the client will authenticate only on the target server.

     Caution: Hazard of security breach. If the None authentication option is selected on the client side and SPS is configured to use public-key or certificate based authentication on the server, the user will not be authenticated at all unless gateway authentication is required for the connection.

4. Click .

   NOTE: The client-side authentication settings apply for authenticating the user inband (that is, within the SSH protocol) to the SPS gateway, and is independent from the gateway authentication performed on the SPS web interface. The web-based gateway authentication is an out-of-band gateway authentication method that can be required by the connection policy. For details on out-of-band gateway authentication, see Configuring out-of-band gateway authentication. Gateway authentication on the SPS web interface can be used together with authentication policies. In an extreme setting, this would mean that the user has to perform three authentications: a client-side gateway authentication within the SSH protocol to SPS, an out-of-band gateway authentication on the SPS web interface, and a final authentication on the target server. The Connection Policy will ignore the settings for server-side authentication (set under Relayed authentication methods) if a Credential Store is used in the Connection Policy.

Extracting username from Telnet connections

For specific devices, it is now possible to extract the username from Telnet connections with the help of patterns (including TN3270 and TN5250 systems).

To select patterns or request a custom pattern

1. Navigate to Telnet Control > Authentication Policies and enable Extract username from the traffic.

2. Click Select target devices to display the list of available target devices. Select the respective device(s) in the Available devices column and click Add.

   NOTE: You can only add one TN3270 specific device to the authentication policy.

   To remove a device from the Target devices column, select it and click Remove.

3. Click OK. The target devices are listed after Selected devices.

4. If you cannot find your device in the list of available target devices, request a custom Pattern Set. To do this, contact our Support Team.

5. To upload the custom pattern set you received, navigate to Telnet Control > Pattern Sets, browse for the file and click Upload.

6. To delete a custom Pattern Set from One Identity Safeguard for Privileged Sessions (SPS), click in the respective row. Generic Pattern Sets cannot be deleted.

Creating and editing protocol-level Telnet settings

Procedure

Telnet settings determine the parameters of the connection on the protocol level, including timeout value, and so on. Complete the following procedure to create a new Telnet settings profile or edit an existing one:

To create and edit protocol-level Telnet settings

1. Navigate to the Settings tab of the Telnet Control menu item and click to create a Telnet setting profile. Enter a name for the profile (for example telnet_special).

2. Click to display the parameters of the connection.

3. Modify the parameters as needed. The following parameters are available:

   • Idle timeout: Timeout value for the connection 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 One Identity Safeguard for Privileged Sessions (SPS) from closing the connection.

   • Enable pre channel check: Select this option to evaluate the connection and channel policies before establishing the server-side connection. That way if the connection is not permitted at all, SPS does not establish the server-side connection.

   • To configure TLS security settings on both the Client side and the Server side, proceed to TLS security settings.

     Figure 199: <Protocol> Control > Settings > TLS security settings - configuring TLS security settings

     

     • Cipher strength specifies the cipher string OpenSSL will use. The following settings options are possible:

       • Recommended: this setting only uses ciphers with adequate security level.

       • Custom: this setting allows you to specify the list of ciphers you want to permit SPS to use in the connection. This setting is only recommended in order to ensure compatibility with older systems. For more details on customizing this list, check the 'openssl-ciphers' manual page on your SPS appliance.

     • Minimum TLS version specifies the minimal TLS version SPS will offer during negotiation. The following settings options are possible:

       • TLS 1.2: this setting will only offer TLS version 1.2 during negotiation. This is the recommended setting.

       • TLS 1.1: this setting will offer TLS version 1.1 and later versions during negotiation.

       • TLS 1.0: this setting will offer TLS version 1.0 and later versions during negotiation.

     NOTE: Note that SPS only permits TLS-encrypted connections. SSLv3 is not supported.

4. Click .

5. To display a banner message to the clients before authentication, enter the message into the Banner field. For example, this banner can inform the users that the connection is audited.

6. Select this settings profile in the TELNET settings field of your connections.