SSH (secure shell) tunneling is the process of forwarding selected ports through an authenticated and encrypted tunnel. In many cases, SSH tunneling is used to connect to a remote database that is secured behind a restrictive firewall or other network restrictions.This article walks you through the process of creating an SSH tunnel on Windows using PuTTy.
-
Add a public key in your user settings. The public key will be propogated to all Integrate.io ETL servers in up to 30 minutes.
-
Create a Tunnel Connection in Integrate.io ETL:
-
On the dashboard Connections , click New Connection and choose for a connection to use.
-
Choose Reverse SSH tunnel connection as Access type and supply your connection’s hostname, username and port
-
Click Create connection.
-
It will fail because we haven't created the tunnel yet, but the light blue box will appear and you will be able to retrieve Integrate.io ETL’s tunnel server (Integrate.io ETL server endpoint that includes everything before the colon) and connection port (the number after the colon).
-
Download PuTTy.
-
Start a new PuTTy session and set the Hostname to Integrate.io ETL server with port 50683. For example:
-
Connection->Data, enter the tunnel username: sshtunnel
-
Connection->SSH, check “Don’t start a shell or command at all”
-
Connection->SSH->Auth, browse for your PPK private key that matches the public key you added in Integrate.io ETL.
-
Connection->SSH->Auth->TTY, check “Don’t allocate a pseudo terminal”.
-
Connection->SSH->Tunnel: Specify the source port (the connection port assigned to your connection, 53359 in this example), Specify the destination database’s host and port in the destination as “hostname:port”, select the “Remote” option and click “Add”.
-
Save the connection - Go back to Session section in sidebar, enter a description for your stored session (integrate.io ETL here) then click the save button.
-
Connect - double click the Integrate.io ETL session to initiate the connection.
-
Return to the Integrate.io ETL dashboard. After entering the database name, username, and password, click Test Connection.
-
Once the connection is successful, click Create Connection.