README.txt
1
2This is a Windows utility to automatically start up STUNNEL to redirect
3SSL VNC connections to a remote host. Then TightVNC Viewer (included)
4is launched to use this SSL tunnel.
5
6An example server would be "x11vnc -ssl", or any VNC server with a
72nd STUNNEL program running on the server side.
8
9Just click on the program "ssvnc.exe", and then enter the remote
10VNC Server and click "Connect". Click on "Help" for more information
11information. You can also set some simple options under "Options ..."
12
13If you want that application to run in "SSH-ONLY" mode, click on
14the "sshvnc.bat" wrapper instead. Or enter SSH_ONLY.
15
16Note that on Windows when the TightVNC viewer disconnects you may need to
17terminate the STUNNEL program manually. To do this: Click on the STUNNEL
18icon (dark green) on the System Tray and then click "Exit". Before that,
19however, you will be prompted if you want ssvnc.exe to try to terminate
20STUNNEL for you. (Note that even if STUNNEL termination is successful,
21the Tray Icon may not go away until the mouse hovers over it!)
22
23With this STUNNEL and TightVNC Viewer wrapper you can also enable using
24SSL Certificates with STUNNEL, and so the connection is not only encrypted
25but it is also not susceptible to man-in-the-middle attacks.
26
27See the STUNNEL and x11vnc documentation for how to create and add SSL
28Certificates (PEM files) for authentication. Click on the "Certs ..."
29button to specify the certificate(s). See the Help there for more info
30and also:
31
32 http://www.karlrunge.com/x11vnc
33 http://www.tightvnc.com
34 http://www.stunnel.org
35 http://www.openssl.org
36 http://www.chiark.greenend.org.uk/~sgtatham/putty/
37
38You can use x11vnc to create certificates if you like:
39
40 http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-ca
41
42
43Misc:
44
45 The openssl.exe stunnel.exe vncviewer.exe libeay32.dll
46 libssl32.dll programs came from the websites mentioned above.
47
48 IMPORTANT: some of these binaries may have cryptographic
49 software that you may not be allowed to download or use.
50 See the above websites for more information and also the
51 util/info subdirectories.
52
53 Also, the kill.exe and tlist.exe programs in the w98 directory
54 came from diagnostic tools ftp site of Microsoft's.
55
56
57
58Important Note for Windows Vista: One user reports that on Windows Vista
59if you move or extract the "ssvnc" folder down to the "Program Files"
60folder you will be prompted to do this as the Administrator. But then
61when you start up ssvnc, as a regular user, it cannot create files in
62that folder and so it fails to run properly. We recommend to not copy
63or extract the "ssvnc" folder into "Program Files". Rather, extract
64it to somewhere you have write permission (e.g. C:\ or your User dir)
65and create a Shortcut to ssvnc.exe on the desktop.
66
67If you must put a launcher file down in "Program Files", perhaps an
68"ssvnc.bat" that looks like this:
69C:
70cd \ssvnc\Windows
71ssvnc.exe
72
73