Using a PuTTY SSH Tunnel with Visimage3 - Revision history

Johno at 18:29, 25 April 2022

2022-04-25T18:29:37Z

Johno: /* Using a PuTTY SSH Tunnel with Visimage3 in Batch */

2022-04-22T21:57:30Z

‎Using a PuTTY SSH Tunnel with Visimage3 in Batch

Johno: /* Using a PuTTY SSH Tunnel with Visimage3 in Batch */

2022-04-22T21:56:03Z

‎Using a PuTTY SSH Tunnel with Visimage3 in Batch

Johno: /* Using a PuTTY SSH Tunnel with Visimage3 in Batch */

2022-04-22T21:55:31Z

‎Using a PuTTY SSH Tunnel with Visimage3 in Batch

Johno: /* Using a PuTTY SHH Tunnel wih Older Versions of Visimage3 */

2022-04-22T21:36:30Z

‎Using a PuTTY SHH Tunnel wih Older Versions of Visimage3

Johno: /* Using a PuTTY SHH Tunnel wih Older Versions of Visimage3 */

2022-04-22T21:34:38Z

‎Using a PuTTY SHH Tunnel wih Older Versions of Visimage3

Johno at 21:21, 22 April 2022

2022-04-22T21:21:03Z

Johno at 21:14, 22 April 2022

2022-04-22T21:14:29Z

Johno: /* Starting Server with a Connection using a PuTTY SSH Tunnel */

2022-04-22T21:03:30Z

‎Starting Server with a Connection using a PuTTY SSH Tunnel

Johno at 19:13, 22 April 2022

2022-04-22T19:13:35Z

@@ Line 9: / Line 9: @@
 *The host port where vsrvTCP is listening, for example "30502".<br />The port is used as part of the Tunnel '''Destination''' configuration in step 2.
 *Fiserv will also provide you with the Public Key File needed in step 3. This file is protected by a Passphrase which will also be supplied by Fiserv.
-Other clients should request this information from their own IT department.
+'''Other clients should request this information from their own IT department.'''
 ====Step 1: Create a new Session====
@@ Line 73: / Line 73: @@
 ====Import Things to Remember====
-*Pageant is required in order for Visimage3 to be able to PuTTY automatically.
+*Pageant is required in order for Visimage3 to be able to start PuTTY automatically.
 *The private key file used to authenticate the tunnel must be loaded into Pageant.
 *Visimage3 will automatically launch Pageant if it is not running and load the private key file.
@@ Line 89: / Line 89: @@
 * Create a task in the task scheduler to launch shortly after system reboot (or logon).
-Remember that all of these methods will require that you specify the passphrase associated with the private key file.
+'''Remember that all of these methods will require that you specify the passphrase associated with the private key file.'''
 == Using a PuTTY SHH Tunnel wih Older Versions of Visimage3 ==

@@ Line 80: / Line 80: @@
 ====Using a PuTTY SSH Tunnel with Visimage3 in Batch====
-As long as Pageant is running with the private key file loaded there are no special instructions for using an SSH Tunnel in batch.
+As long as Pageant is running with the private key file loaded there are no special instructions for using an SSH Tunnel in batch. Remember that Visimage3 will '''not''' be able to start server using a PuTTY SSH Tunnel in batch if Pageant is not running.
 There are several methods to start Pageant:

@@ Line 85: / Line 85: @@
 * Run Visimage3 and Start server.
 * Create a bat file to start Pageant with your private key file. The syntax is:
-{{{
+   "C:\Program Files\PuTTY\pageant.exe" "C:\somepath\name_of_key_file.ppk"
 :Remember to place quotes around the fully qualified name of Pageant and the key file if there are any blank characters in the filename.
 * Create a task in the task scheduler to launch shortly after system reboot (or logon).

@@ Line 81: / Line 81: @@
 ====Using a PuTTY SSH Tunnel with Visimage3 in Batch====
 As long as Pageant is running with the private key file loaded there are no special instructions for using an SSH Tunnel in batch.
 == Using a PuTTY SHH Tunnel wih Older Versions of Visimage3 ==

@@ Line 86: / Line 86: @@
 * Configure the tunnel as described above.
 * In the Visimage3 Connection window:
-:* Enter 127.0.0.1 (localhost) as the Hostname
+:* In the Host Address, enter '''127.0.0.1'''
-:* Enter the local port from the tunnel as the Port (30501 in our example)
+:* In Host Port, enter the local port from the tunnel you configured ('''30501''' in our example)
-*Before running Visimage3, launch PuTTY nd open the SSH Tunnel session to connect.
+* Before running Visimage3, launch PuTTY and open the SSH Tunnel session to connect.
-* Now run Visimage3, as long as PuTTY is running with the tunnel session loaded, Visimage3 will be able to connect.
+* Now run Visimage3, as long as PuTTY is running with the tunnel loaded, Visimage3 will be able to connect.

← Older revision		Revision as of 21:21, 22 April 2022
Line 81:		Line 81:
	====Using a PuTTY SSH Tunnel with Visimage3 in Batch====		====Using a PuTTY SSH Tunnel with Visimage3 in Batch====
	As long as Pageant is running with the private key file loaded there are no special instructions for using an SSH Tunnel in batch.		As long as Pageant is running with the private key file loaded there are no special instructions for using an SSH Tunnel in batch.
		+
		+	== Using a PuTTY SHH Tunnel wih Older Versions of Visimage3 ==
		+	It's possible to use a PuTTY SSH Tunnel with older versions of Visimage3, or without using Pageant. The logic is similar to configuring a connection to use sTunnel. Follow these steps:
		+	* Configure the tunnel as described above.
		+	* In the Connection window:
		+	:* Enter 127.0.0.1 (localhost) as the Hostname
		+	:* Enter the local port from the tunnel as the Port (30501 in our example)
		+	*Before running Visimage3, launch PuTTY nd open the SSH Tunnel session to connect.
		+	* Now run Visimage3, as long as PuTTY is running with the tunnel session loaded, Visimage3 will be able to connect.

@@ Line 57: / Line 57: @@
 Pageant is an SSH authentication agent included with PuTTY. It holds your private keys in memory, already decoded, so that you can use them often without needing to type a passphrase. Since the SSH Tunnel used by Visimage3 is protected by a key file with a passphrase it is preferable to only enter the passphrase once and have Pageant remember it for you.
-The user can choose to run Pageant on system startup or have Visimage3 launch it for you. Additional information on Pageant can be found [[https://documentation.help/PuTTY/pageant-start.html#S9.1]|here].
+The user can choose to run Pageant on system startup or have Visimage3 launch it for you. Additional information on Pageant can be found [https://documentation.help/PuTTY/pageant-start.html#S9.1 here].
 ====Starting Server with a Connection using a PuTTY SSH Tunnel====
@@ Line 64: / Line 66: @@
 :*The start server process will fail if Pageant is running, but the required key file is not loaded.
 :*If Pageant is not running, Visimage3 will launch Pageant and pass the required key file. The user will be prompted for the passphrase by Pageant, and Visimage3 will wait until the correct passphrase has been entered.
 Once Pageant is running, Visimage3 will continue the start server process by launching PuTTY in the background. There will be no need to authenticate any passwords for the tunnel because that is automatically handled by Pageant. Visimage3 will then connect to the local port, and if the tunnel is properly configured (and vsrvTCP is running on the host) the server will be started.
 ====Import Things to Remember====
 ====Using a PuTTY SSH Tunnel with Visimage3 in Batch====

@@ Line 53: / Line 53: @@
 *If the "Use PuTTY SSH Tunnel to Connect" choice is not visible, goto Edit > Preference > SSH Tunnel to enable this choice.
 [[File:V3ConnectionWithPuTTY.jpg|400px|Creating a new PuTTY Sesson]]
 ====Starting Server with a Connection using a PuTTY SSH Tunnel====