About static configuration of the config.js file
- Last UpdatedJul 17, 2024
- 4 minute read
An administrator can modify configuration settings of InTouch Access Anywhere by editing its config.js file that is installed as part of the InTouch Access Anywhere web component. This is a JavaScript file that can be modified using any text editor.
Important: Always create a backup before making any changes to the config.js file.
Most configuration settings in the config.js file have the following format:
name: value,
A value can be a number, a flag (true or false), or text enclosed in quotation marks. Some settings are prefixed by a double slash (//), which means they are disabled. Remove the double slash to assign a value to a setting. JavaScript rules apply in this file and certain characters need to be escaped (for example, backslash).
After the settings are configured, save the file and restart the server.
The config.js file contains the following configuration settings. Setting names are case sensitive. When settings are specified using cookies, setting names are prefixed by EAN_.
|
address |
Address of InTouch Access Anywhere Server. This is always blank for the standard configuration. |
|
audiomode |
0 enables audio redirection (default). 1 plays audio on remote computer. 2 disables audio redirection. |
|
blaze_acceleration |
True determines if RDP acceleration is used. |
|
blaze_image_quality |
Sets the quality level using a numeric. For example: 40 (fair quality), 75, 95 (best). |
|
dialogTimeoutMinutes |
Time out period, in minutes, after which an inactive dialog is automatically closed and the session is logged off. The time out period is relevant only for dialogs that have a log off button. |
|
disableToolbar |
True (default); set to False to disable the toolbar, which contains shortcut icons and file functions, that appears within an InTouch Access Anywhere session window. |
|
domain |
The name of the domain against which the user name and password are authenticated to grant access to the Remote Desktop session. |
|
encryption |
False determines if encryption is enabled from the client to the InTouch Access Anywhere server. |
|
endURL |
URL to open to after the InTouch Access Anywhere session has ended (# value closes window). If there is a prefix with the symbol ^ then this sets the value of window.location instead of top.location. This is useful when the InTouch Access Anywhere session is embedded in a frame. |
|
fulladdress |
Address of RDP host. This is always blank for the standard configuration. |
|
gateway_address |
Defines the address and port of the Secure Gateway. For example: secure.acme.com:4343 |
|
gwport |
The default gateway port that will be used if it is not explicitly specified in the address field. |
|
hidden |
A comma or space-separated list of field names as they appear in config.js. For example, "username,password,domain". The listed fields are hidden to prevent the user from modifying them. To hide a button, such as the Advanced button, prefix the button text with the word show. For example, "showAdvanced,showAbout" hides both the Advanced and About buttons. All hidden variables will ignore previously saved settings. |
|
leaveMessage |
The message shown to the user after navigating away from an active session. |
|
minDesktopWidth |
Sets the minimum desktop width (in pixels) that InTouch Access Anywhere will display. The default is 800, which may not display as expected or desired on devices with a display width below 800 pixels. |
|
minDesktopHeight |
Sets the minimum desktop height (in pixels) that InTouch Access Anywhere will display. The default is 600, which may not display as expected or desired on devices with a display height below 600 pixels. |
|
minSendInterval |
Specifies the minimum duration between mouse position messages sent from the client when the mouse button is pressed. Units are in milliseconds. |
|
name |
Defines a custom string for the connection name. By default, the RDP host address is used. |
|
noHTTPS |
By default, InTouch Access Anywhere first attempts to connect using WebSockets. If the Secure Gateway is used with InTouch Access Anywhere, the connection will fall back to HTTPS when WebSockets are not available. If this setting is set to true, only WebSockets will be used and HTTPS fallback will be disabled. |
|
onlyHTTPS |
By default, InTouch Access Anywhere first attempts to connect using WebSockets. If the Secure Gateway is used with InTouch Access Anywhere, the connection will fall back to HTTPS when WebSockets are not available. If this setting is set to true, HTTPS is used immediately. |
|
overrideSaved |
False (default) settings that the user changes are preserved between sessions and override values set in config.js. Change to true for config.js to override preserved settings. |
|
password |
Password to pass into an InTouch Access Anywhere session (entered as clear text in config.js file). |
|
reconnectOnDropped |
True (default) automatically reconnects a session after recovering from a network outage. Set to False to disable this behavior. |
|
remember |
False (default) determines whether the user's password will be saved in the InTouch Access Anywhere page for future use. Set to true to enable password saving (not recommended for kiosk usage). |
|
resolution |
Sets the resolution size of the InTouch Access Anywhere screen. The value set must be a valid option under the InTouch Access Anywhere screen resolution setting. For example: "1024,768". For Full Screen, use: screen. |
|
sessionTimeoutMinutes |
Time out period, in minutes, after which an inactive session is disconnected. The time out period resets automatically whenever the user clicks on the keyboard or a mouse button. The default value is 0, which disables this feature. |
|
settings (URL parameter only) |
Name of the Configuration Group to be used. |
|
settingsURL |
URL of the connection settings file. |
|
use_gateway |
False (default), set to true to use a Secure Gateway for remote access. |
|
username |
Username to pass into an InTouch Access Anywhere session. |
|
wsport |
The default WebSocket port that will be used by the client. The value specified in the file (8080 by default) is used for both encrypted and unencrypted WebSocket communication. The user can override this value by explicitly specifying another port address in the client user interface (UI). For backward compatibility with older versions of InTouch Access Anywhere Server, this behavior can be modified. If singlePort is set to false, then the port value specified is only for encrypted communication. The value specified in the file plus one (8081 by default) will be used for unencrypted WebSocket communication. |
WARNING! Do not attempt to modify config.js settings not listed here unless directed by our Technical Support department.