Manage Tunnels
  • 10 Jul 2023
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Manage Tunnels

  • Dark
    Light
  • PDF

Article Summary

NOTE

This functionality is only applicable for Axonius-hosted (SaaS) customers.

Use the Tunnels page to add and manage Axonius Tunnels.
Note that permission is required to add a tunnel.
Axonius Tunnel enables you to establish a link between an internal network and the Axonius-hosted (SaaS) instance.
The Axonius-hosted (SaaS) instance resides in the cloud and is not part of your organization's internal network. Axonius securely fetches data from the organization's data sources, known as adapters. To connect adapters that are only accessible by an internal network, you must configure and install an Axonius Tunnel on a server that has access to those sources.
For more details on installing an Axonius Tunnel, see: Installing Axonius Tunnel.

To manage Tunnels:

  1. From the top right corner of any page, click image.png. The System Settings page opens.
  2. In the Categories/Subcategories pane of the System Settings page, expand System, and select Tunnels.

The page displays the list of existing Tunnels, and each Tunnel's details and connection status.

Manage Tunnels_fillet.png

Adding a New Tunnel

To add a new tunnel:

  1. On the Tunnels page, click Add Tunnel.
    Manage Tunnels add Tunnel_fillet.png

  2. The New Tunnel Connection drawer appears.
    NewTunnelConnections

  3. Specify the following Tunnel settings:

    • Tunnel name (optional, default: Tunnel_x) - Specify an indicative name for the Tunnel connection or use the system default. The Tunnel name can always be changed.

TunnelEmail

  • Tunnel status notification
    • Notify by email when tunnel is disconnected
    • Notify by email when tunnel is connected

Choose one or both of these options to send email notifications to the recipients defined when a tunnel is disconnected or connected. When you choose one of the options, the Recipient Email Address field is displayed.
Recipient Email Address - Specify a list of email addresses to be notified when the Axonius Tunnel disconnects or is connected, depending on the notification options that you chose.

  • Proxy settings (optional, default: empty) - To configure a proxy service to be used by the Axonius Tunnel, select the Use Proxy checkbox. Once enabled, configure the Proxy address and Proxy port fields. Proxy user name and Proxy password are optional fields for proxy services.
  1. Click the Create and Download button.

    • A Tunnel record is added to the table.
    • The Tunnel installation package is downloaded.
  2. Install the Tunnel installation package based on the instruction described in: Installing Axonius Tunnel.

Once the installation is completed and Tunnel is successfully connected, you can configure the adapter connection to use the Axonius Tunnel to fetch data from the data sources in your organization's internal network. For details, see Configure and connect adapters to use the Axonius Tunnel.

Editing an Existing Tunnel

To edit an existing tunnel:

  1. From the Tunnels page, click an existing Tunnel Record. The Tunnel Connection drawer appears.
    NewTunnelConnections

  2. Click the Edit ( image.png ) icon.

  3. Edit the following Tunnel settings, as required: Tunnel name, Tunnel status notification, Proxy settings

  4. Click Save.

NOTE

If the Proxy Settings have been changed, it is necessary to reinstall the Tunnel. For more details, see Installing Axonius Tunnel.

Deleting a Tunnel

In order to delete an existing Tunnel, the following conditions should apply:

  • The Tunnel is not used to access existing Adapter connections.
  • The Tunnel status is disconnected.

To remove a tunnel:

  1. From the Tunnels page, click an existing Tunnel Record. The Tunnel Connection drawer appears.
  2. Click the Delete ( image.png) icon.

Setting a New Default Tunnel

The default Tunnel is used by the system to connect to servers that are only accessible by an internal network such as LDAP servers and SMTP servers.


To set a new default tunnel:

  1. From the Tunnels page, click an existing Tunnel Record. The Tunnel Connection drawer appears.

  2. Click the Edit ( image.png ) icon.

  3. Select the Set as default Tunnel connection checkbox to define the Tunnel as the system's default Tunnel.

SetAsDEfault

  1. Click Save.

Using a Tunnel to Connect to Adapter Connection

For details, see Configure and connect adapters to use the Axonius Tunnel.



Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.