Gateway Server Settings

Configure gateway server settings

  3 minute read  

Gateways servers are nodes that are configured to receive connections from other Trustgrid nodes (clients). These are the only nodes that need to have ports open and listening on the internet or WAN network.

The server sub-panel provides the settings controlling if a node will act as a server and if so how clients will connect to it.

Gateway Server Types

A gateway server can be one of three types:

  • public - all nodes, except other public gateways, in an organization will attempt to connect to this gateway on the listed IP/DNS name and port
  • private - allows only allow-listed clients to connect
  • hub - allows connections from edge nodes and other gateway nodes

Settings

Field NameDescription
Enabled

Either Enabled or Disabled. This determines if the main TLS Gateway server will be started or not. When enabled, the node will listen and accept connections from other nodes on the Public IP and DNS and port.

If this setting is set to Disabled the below settings are extraneous and not used, with the exception of UDP enabled as it is also a client setting.

UDP Enabled

This settings can be configured on both the gateway server and gateway client sub-panel.

  • On a server, this will determine if the server will listen for UDP tunnel connections on the configured UDP port.
  • On a client, this will determine if the client will attempt to build UDP tunnels to any server with UDP enabled.

UDP tunnels are only attempted if both the client and the server have the UDP Enabled field set to Enabled

Public IP or DNSThe public IP or DNS name of the gateway. This is the address that other nodes will use to connect to this gateway.
PortThe TCP port that the gateway will listen on. This is the port that other nodes will use to connect to this gateway.
UDP PortThe UDP port that the gateway will listen on for UDP tunnels. This is the port that other nodes will use to connect to this gateway.
Max Ingress MbpsThe ingress bandwidth limit for the gateway. Connections will be throttled when this limit is reached.
CertificateOptional When using DNS for gateway connections, you may specify an uploaded certificate to use for TLS connections. If not specified the certificate autogenerated during activation is used.
Gateway TypeThe type of gateway. See Gateway Types for more information.

After changing any of the above settings you will need to click Save for the changes to go into effect.

Example Gateway Server settings

Gateway Clients

This section is only used if the node is configured as a private gateway server. Only clients listed on this page will attempt to connect to the server.

Add Gateway Clients

To add clients:

  1. Type part of their name in the “Add Gateway Client” box.
    Example showing filtered list of nodes
  2. Select the desired node from the list. After selecting you should see the node in the table with Enabled set to true.
    Selected node added to table
  3. Optionally, repeat the above steps with additional nodes to add as clients.
  4. Click Save.

Remove Gateway Clients

To remove clients:

  1. Optionally, use the search box to the top right of the table to filter the displayed clients.
  2. Click the black X to the right of the client you wish to remove.
    Black X will remove the client
  3. Click Save.