Application Configuration File

The Connection Manager configuration files can be found at the default locations indicated below.

Windows Configuration File Location

C:\Program Files\Delinea\Connection Manager\Delinea.ConnectionManager.exe.config

macOS Configuration File Location

/Users/<yourusername>/Library/Preferences/com.Delinea.ConnectionManager.plist

Disabling Update Check on Startup for Windows

To disable automatic checking for updates on startup, for Windows open the configuration file and change the value to False as depicted in the screen shot below.

win-debug

Disabling Update Check on Startup for macOS

To disable automatic checking for updates on startup for macOS, in Terminal type:

defaults write com.Delinea.ConnectionManager Env.CheckUpdateOnStartup -bool false

Enabling Software Rendering for the Internal Browser on Windows

The CEF browser is an internal browser built into Connection Manager. It has the same functionality as a regular web browser and can be useful for handling browser content redirection. It uses hardware accelerated rendering by default. If you are experiencing issues with it, you may opt to enable software rendering by running the following command.

Copy
<setting name="SoftwareRenderForCEF" serializeAs="String">
   <value>True</value>
</setting>

Enabling/Disabling Auto Reauthenticate

This feature provides the option to configure vault reauthentication behavior in Connection Manager. Users may keep the existing behavior that automatically restarts the authentication flow or force a fresh login when their vault session/refresh tokens have expired--mimicking the existing web API behavior.

The default value is y which automatically restarts the authentication flow. If the value is set to n, the behavior will be more similar to the web API which forces a fresh login. The n option is beneficial for users who use SAML configuration through an external identity provider with a longer session/refresh length and enables audit logs to correctly generate upon logout.

Please see the User Configuration File for Windows file for editing this parameter on Windows.

Example for Windows

Copy
<setting name="AutoReauthenticate" serializeAs="String">
    <value>n</value>
</setting>

Example for macOS

Copy
defaults write com.Delinea.ConnectionManager Env.AutoReauthenticate n

Enabling the Session Status Popup on Windows

The Session Status popup window is disabled by default. This window would appear every time a user signed out of a session, confirming that they also signed out of the server. However, if you are experiencing memory leak issues, Delinea recommends enabling this window with the following command:

Copy
<Delinea.ConnectionManager.Wpf.Properties.Settings>
      <setting name="ShowDisconnectMessage" serializeAs="String">
        <value>True</value>
      </setting>
</Delinea.ConnectionManager.Wpf.Properties.Settings>

Configuring Proxy Settings

Users can configure the proxy settings via the following command after </startup>

Copy
<system.net>
    <defaultProxy enabled="True" useDefaultCredentials="True">
        <proxy proxyaddress="http://proxy.test.com:8080" />
    </defaultProxy>
</system.net>

This parameter should only be added under the direction of your administrator. Any errors in configuration could cause errors authenticating to the Delinea Platform or Secret Server.

Setting the Screenshot Queue Limit

If you have session recording enabled and are experiencing unstable internet connectivity, Connection Manager may no longer be able to send screenshots to the server and your session will be terminated. If you continue to experience internet connectivity issues, you can try increasing the screenshot queue limit to allow screenshots to be temporarily saved locally until connectivity is restored. The screenshot queue limit can be increased by changing 0 to any positive value in the following commands: 

Windows:

Copy
<setting name="ScreenshotsQueueLimit" serializeAs="String">
   <value>0</value>
</setting>

macOS:

Copy
defaults write com.Delinea.ConnectionManager Env.ScreenshotsQueueLimit -int 0

Configuring RDP Connection Timeout Over TCP on MacOS

This configuration allows the ability to customize RDP connection timeouts in milliseconds. This is helpful for situations involving proxy, MFA, or other configurations that require additional time to connect before timeout. Users can configure this parameter by running the following command in the terminal. The timeout can be adjusted as needed, but the recommended suggestion is to start with 60000 milliseconds as shown below:

Copy
defaults write com.Delinea.ConnectionManager RDP.TcpAckTimeout -int 60000

Incorrect Handling of System Keys

In the event that system keys are not handled correctly, users will need to adjust the corresponding parameters in the config file user.config by setting the variable "SshFunctionKeysMode". The default value is "CommonExtended" but can be set to the following values:

  • CommonExtended

  • Common

  • Linux

  • XtermR6

  • VT400

  • VT100Plus

  • Sco

  • CommonAlternative

  • VT52

  • LinuxAlternative

  • ScoAlternative

  • Wyse60

  • HpUx

  • Pick

Strings are case sensitive