Remote Gateway files

Overview Copied

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.


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:

<hostname>~<port>~<description>~<Secondary Host>~<Secondary Port>~<Logon Method>~<Connection Security>
<hostname>~<port>~<description>~<Secondary Host>~<Secondary Port>~<Logon Method>~<Connection Security>
<hostname>~<port>~<description>~<Secondary Host>~<Secondary Port>~<Logon Method>~<Connection Security>
<hostname>~<port>~<description>~<Secondary Host>~<Secondary Port>~<Logon Method>~<Connection Security>

Configure logon method in the workspace Copied

The <Logon Method> 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 Obcerv.

Configure connection security Copied

The <Connection Security> 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:


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:


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~2346~another gateway~itrsops~4564

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.

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.


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.

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.

["Geneos"] ["Geneos > Active Console"] ["User Guide"]

Was this topic helpful?