Skip to content






Service manager

API Explorer

Installation behind a firewall

After installation, it is recommended that you configure your firewall to ensure TORO Integrate can communicate with other services, applications, and users as expected.

Below are the default ports used by TORO Integrate instances:

Protocol Port
HTTP 8080
HTTPS 8443

Modifying ports...

With an on-premise deployment, you can change the ports used by TORO Integrate.

In the following sub-sections, we'll discuss how to open those ports in different operating systems.

Corporate firewall

Steps may differ if you are configuring your own corporate firewall. If that is the case, it is recommended that you simply open the port for TORO Integrate to allow incoming and outgoing connections.

How to Open Ports

  1. To confirm if the port TORO Integrate is using is open, enter the following command in your terminal where <port> is the port number you have configured for TORO Integrate:

    iptables -nL | grep <port>

    The command above should give you an output of something like:

    ACCEPT     tcp  --             tcp dpt:<port>

    If it is open (says ACCEPT), then there is no need to execute the following steps.

  2. If your port is closed, you have two options to open them on a Linux device:

    • iptables

      1. Open up the port by executing the command:

        /sbin/iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport <port> -j ACCEPT           
      2. Save the change using the command:

        iptables-save > /etc/iptables.rules
      3. Restart iptables with:

        /etc/init.d/iptables restart

        ... or just reload iptables with:

        /etc/init.d/iptables reload
    • firewalld

      1. Open up the port by executing the command:

        firewall-cmd --zone=public --add-port=<port>/tcp --permanent
      2. Reload the firewall service using:

        firewall-cmd --reload

      For bonus points, you could check if your changes have reflected by entering:

      firewall-cmd --list-all


    You must allow ESTABLISHED and RELATED connections for your connections to operate in a two-way fashion. If you have configured iptables before, then you have probably already had this configured. To do so, use the command below:

    iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT    

    To allow outgoing traffic for all ESTABLISHED connections, use the following command:

    iptables -A OUTPUT -m conntrack --ctstate ESTABLISHED -j ACCEPT

To allow connections in macOS devices, you will need to change a couple of properties via System Preferences. Instead of allowing a port, we will allow incoming connections from your TORO Integrate instance.

  1. First, open the System Preferences window by clicking on the Apple menu and then selecting System Preferences.
  2. Click on Security & Privacy > Firewall > Firewall Options.
  3. Browse for TORO Integrate and select Allow incoming connections.

    Allow connections

  4. Click OK.

Unlock padlock

Make sure that you are able to unlock the padlock on the lower left portion of the screen to make changes.

Unlock padlock

For Windows, we will be using the Windows Defender application to make our changes.

  1. Display the machine's firewall settings by searching Windows Defender Firewall with Advanced Security.

    Opening Windows Defender

  2. Next, click on Inbound Rules and then select New Rule.

  3. Choose Port and then click Next.
  4. Fill in the fields. Afterwards, click Next.
  5. Select Allow the connection.
  6. Check where these rules should apply.
  7. Optionally, you can give your rule a name and a short description.

    Modifying inbound rules

Outbound rules

You may also provision an outbound rule for TORO Integrate's port. Do this by selecting Outbound Rules and populating in the fields like above.

Modifying outbound rules