Reference Guide
...
RDP Proxy
RDP Session Settings

RDP Device Properties

Some properties can be configured at the device level. To set device-based configurations:

  1. Navigate to Device> Inventory.
  2. Choose the desired group from the device and select the Edit option.
  3. Set the related properties.
RDP Device Properties
RDP Device Properties


Property

Definition

remoteDesktop.color-depth

This parameter is optional. The color depth to request, in bits-per-pixel. If specified, its value must be either 8, 16, or 24. Regardless of what value is chosen, if a particular update uses less than 256 colors, the Kron PAM Remote Desktop Client will always send that update as a 256-color PNG.

remoteDesktop.disable-audio

Audio is enabled by default in both the client and in “libguac-client-rdp”. If you are concerned about bandwidth usage, or if the audio is causing problems, you can explicitly disable audio by setting this parameter as "true".

remoteDesktop.domain

This parameter is optional. The domain to use when attempting authentication, if any.

remoteDesktop.dpi

This parameter is optional. The desired effective resolution of the client display, in DPI. If this value is not specified, the resolution and size of the client display will be used together to determine, heuristically, an appropriate resolution for the RDP session.

remoteDesktop.enable-audio-input

If set to "true", audio input support (microphone) will be enabled, leveraging the standard "AUDIO_INPUT" channel of RDP. By default, audio input support within RDP is disabled.

remoteDesktop.enable-drive

File transfer is disabled by default, but if enabled, RDP users can transfer files to and from a virtual drive which persists on the Kron PAM server. Enable file transfer support by setting this parameter as "true".

remoteDesktop.enable-printing

Printing is disabled by default, but if enabled, RDP users can print to a virtual printer that sends a PDF to the Kron PAM Remote Desktop client. Enable printing by setting this parameter as "true".

remoteDesktop.height

This parameter is optional. The height of the display to request, in pixels. If this value is not specified, the display height of the connecting client will be used.

remoteDesktop.ignore-cert

If set as "true", the certificate returned by the server will be ignored, even if that certificate cannot be validated. This is useful if you universally trust the server, and your connection to it, and know that the server's certificate cannot be validated (for example, if it is self-signed).

remoteDesktop.remote-app

Specifies the RemoteApp to start on the remote desktop. If supported by your remote desktop server, this application, and only this application, will be visible to the user.

remoteDesktop.resize-method

This parameter is optional and used to update the RDP server when the width or height of the client display changes. If this value is not specified, no action will be taken when the client display changes size.



Usually, the display size of an RDP session is constant and can only be changed when initially connecting. As of RDP 8.1, the "Display Update" channel can be used to request that the server change the display size. For older RDP servers, the only option is to disconnect and reconnect with the new size.



Possible values are:



display-update - Uses the "Display Update" channel added with RDP 8.1 to signal the server when the client display size has changed.



Reconnect - Automatically disconnects the RDP session when the client display size has changed and reconnects with the new size.

remoteDesktop.security

The security mode to use for the RDP connection. This mode dictates how data will be encrypted and what type of authentication will be performed, if any. By default, standard RDP encryption is requested, as it is the most widely supported.



Possible values are:



Rdp - Standard RDP encryption. This is the default and should be supported by all RDP servers.



Nla - Network Level Authentication. This mode requires log in information and performs an authentication step before the remote desktop session actually starts. If the username and password are not provided, the connection cannot be made. tls - TLS (Transport Layer Security) encryption. TLS is the successor to SSL.



Any - Allows the server to choose the type of security.

remoteDesktop.server-layout

The server-side keyboard layout. This is the layout of the RDP server and has nothing to do with the keyboard layout in-use on the client side. The Kron PAM Remote Desktop client is independent of the keyboard layout.



Possible values are: de-de-qwertz- German keyboard (qwertz) en-us-qwerty - English (US) keyboard

fr-fr-azerty - French keyboard (azerty) fr-ch-qwertz - Swiss French keyboard (qwertz) it-it-qwerty - Italian keyboard ja-jp-qwerty - Japanese keyboard sv-se-qwerty - Swedish keyboard

tr-tr-qwerty - Turkish keyboard failsafe - Unknown keyboard - this option sends only Unicode events and should work for any keyboard, though not necessarily on all RDP servers or applications. If your server's keyboard layout is not yet supported, this option should work in the meantime.

If mapping is desired, -ti must be added to the end of the relevant keyboard parameter. Supported keyboards with mapping:

 da_dk_qwerty-ti - Danish keyboard de_ch_qwertz-ti –Swiss German keyboard de_de_qwertz-ti -German keyboard (qwertz) en_gb_qwerty-ti -English (UK) keyboard en_us_qwerty-ti -English (US) keyboard es_es_qwerty-t – Spanish keyboard es_latam_qwerty-ti - Latin American Spanish keyboard fr_be_azerty-ti - Belgian French keyboard fr_ch_qwertz-ti – Swiss French keyboard fr_fr_azerty-ti - French keyboard (azerty) hu_hu_qwertz-ti – Hungarian keyboard (qwertz) it_it_qwerty-ti – Italian keyboard ja_jp_qwerty-ti - Japanese keyboard pt_br_qwerty-ti - Brazilian Portuguese keyboard ru_ru-ti – Russian keyboard sv_se_qwerty-ti -Swedish keyboard tr_tr_qwerty-ti - Turkish keyboard

remoteDesktop.enable-font-smoothing

If set to “true”, the text will be rendered with smooth edges. Text over RDP is rendered with rough edges by default, as this reduces the number of colors used by text, and thus reduces the bandwidth required for the connection.

remoteDesktop.disable-bitmap-caching

If set to "true", bitmap caching used in RDP sessions is disabled. This reduces bandwidth usage and increases performance.

remoteDesktop.disable-glyph-caching

In addition to screen regions, RDP maintains caches of frequently used symbols or fonts, collectively known as “glyphs.” As with bitmap and offscreen caching, certain known bugs in RDP implementations can cause performance issues with this enabled, and setting this parameter to “true” will disable that glyph caching in the RDP session.

remoteDesktop.disable-offscreen-caching

If set to "true", caching of offscreen elements is disabled. This can reduce memory usage and optimize connection speed, though it may affect performance when rendering offscreen content.

remoteDesktop.width

This parameter is optional. The width of the display to be requested, in pixels. If this value is not specified, the width of the connecting client display will be used.

isEnabledOcrForDevice

In order to disable OCR on a per device basis this parameter can set to false on the device properties.

Some of these settings can be configured on-the-fly using the Settings tab in the RDP Session. These include: Keyboard Layout (remoteDesktop.server-layout), Input Method, Mouse Emulation Mode, Color Depth (remoteDesktop.color-depth), Resolution (remoteDesktop.dpi), Audio Input (remoteDesktop.enable-audio-input), Audio Output (remoteDesktop.disable-audio), and Printing to PDF Image (remoteDesktop.enable-printing).

The Remote Desktop Properties can also be set globally on the System Config Management page. To do this we need to add the rdp parameter as sc.rdp.default.xxxx. If you want to add the parameter remoteDesktop.dpi as global in the System Config Manager you can add it as sc.rdp.default.remoteDesktop.dpi. When we set this parameter in the System Config Manager it will apply to all RDP devices.

Document image


Sometimes, the toolbar which contains the settings, and the other elements can obstruct the view in an RDP session. To hide this toolbar by default users can use the rdp.hide.top.menu.by.default parameter on APPENDIX 1: System Config Manager Parameters. When a user adds this parameter to the system config manager as true, this toolbar will be hidden at the start of the RDP session.