PuTTY SSH tunnel

From BNL Physics Computing

To setup an SSH tunnel to the BNL internal web proxy, create a new PuTTY session (the PuTTY software is available here) and go to the Connection -> SSH -> Tunnels page. On this page you enter the local port you are tunneling in the "Source port" box and the destination address and the destination port, separated by a colon, in the "Destination" box. Clicking on the "Add" button will move the tunnel into the larger box above these boxes (you can create more than one tunnel by repeating this operation, if your needs require it). See the next two figures.

Image:PuTTY_tunnel_a.png Image:PuTTY_tunnel_b.png

Next, as with any PuTTY session, you should go to Connection -> Data and enter the username for your account on the gateway machine in the "Auto-login username" box, otherwise you will be prompted for your username when you start the tunnel session (see the next figure).

Image:PuTTY_tunnel_c.png

FInally, go back to the "Session" page and set the name or address of the gateway machine in the "Host Name (or IP address)" box and give the session a name in the "Save Sessions" box. Clicking on the "Save" button will save the session and allow you to reload it later (see the next figure).

Image:PuTTY_tunnel_d.png

If you use the PuTTY SSH agent (Pageant), then right clicking on the icon in the tray will bring up a menu and you can start the tunnel session by selecting the session from the "Saved Sessions" submenu.