--- title: "Remote Gateway files" description: "" url: "https://docs.itrsgroup.com/docs/geneos/7.11.0/visualization/active-console/tools/remote-gateway-files/index.html" --- ## Overview Active Console allows you to define Gateway connections from information on a file or source URL. The Remote Gateway Files support HTTP and HTTPS for connection files. This can be configured in the [Workspace Settings](/visualization/active-console/tools/../configuration/workspace-settings/#connections-settings). **Note** Beginning Active Console 5.8.x, you can use connection files hosted over HTTPS. These files or URLs must be in plaintext and in the following format: ``` ~~~~~~ ~~~~~~ ~~~~~~ ~~~~~~ … ``` ## Configure logon method in the workspace The `` can have the following values:
Value Description
LM_WORKSPACE Default logon method defined in the workspace. If you do not specify the logon type, this becomes the default option.
LM_USER_FIRSTTIME Requires you to enter a username and password when logging in to the Gateway for the first time.
LM_SSO Verifies your identity using an SSO provider such as SSO Agent, Gateway Hub, or ITRS Analytics.
## Configure connection security The `` can have the following rules: You can skip the definition of the description, secondary host, secondary port, and logon methods by including an asterisk (`*`). For example, if the Gateway does not have a secondary host, but you want to specify its logon type, then use the following: ``` itrsops~4533~myGateway~*~*~LM_USER_FIRSTTIME ``` You can also exclude elements from the end of the line. For example, if you want to specify a host and port, then use the following: ``` itrsops~4533 ``` In addition, you can provide blank lines and leave comments in the file. The comments must be on their own line, and begin with "`//`". For example: ``` //my gateway itrsops~4533~my gateway description //Another gateway itrsops~4534~another gateway description~*~*~ LM_SSO ``` Here is another example of a remote Gateway file: ``` itrsops~4564~maingateway itrsops~2346~another gateway~itrsops~4564 itrsops~4533~*~*~*~LM_USER_FIRSTTIME~SECURE hostname~3456~*~secondaryhost~1200~*~LM_WORKSPACE~INSECURE ``` Whenever the workspace is loaded, the Active Console looks for this file or URL. Then, it imports the defined Gateway connections. This function can be useful if there many workspaces share the same Gateways. For more information on how to declare these imported files or URLs in the workspace, see [Workspace Settings](/visualization/active-console/tools/../configuration/workspace-settings/#workspace-settings). If the Gateway list is defined on a remote URL, it cannot be embedded in any HTML or XML files. It must remain in the specified format as shown in the examples. **Note** When adding remote connection files through the Connection settings, ensure that you set the connection type to **URL** before adding the file name.
Value Description
INSECURE Connects to the Gateway’s insecure port. This is the default connection security setting.
SECURE

Connects to the Gateway’s secure port.

Note: Beginning Geneos 5.14.x, you can enable certificate validation for HTTPS connection by setting the enableCertificateValidation flag to true. For more information on how to set this flag up, see ActiveConsole.exe flags in Start Up Settings.