README.txt
1
2 This is a Windows utility to automatically start up STUNNEL to redirect
3 SSL VNC connections to a remote host. Then TightVNC Viewer (included)
4 is launched to use this SSL tunnel.
5
6 An example server would be "x11vnc -ssl", or any VNC server with a
7 2nd STUNNEL program running on the server side.
8
9 Just click on the program "ssvnc.exe", and then enter the remote
10 VNC Server and click "Connect". Click on "Help" for more information
11 information. You can also set some simple options under "Options ..."
12
13 If you want that application to run in "SSH-ONLY" mode, click on
14 the "sshvnc.bat" wrapper instead. Or enter SSH_ONLY.
15
16 Note that on Windows when the TightVNC viewer disconnects you may need to
17 terminate the STUNNEL program manually. To do this: Click on the STUNNEL
18 icon (dark green) on the System Tray and then click "Exit". Before that,
19 however, you will be prompted if you want ssvnc.exe to try to terminate
20 STUNNEL for you. (Note that even if STUNNEL termination is successful,
21 the Tray Icon may not go away until the mouse hovers over it!)
22
23 With this STUNNEL and TightVNC Viewer wrapper you can also enable using
24 SSL Certificates with STUNNEL, and so the connection is not only encrypted
25 but it is also not susceptible to man-in-the-middle attacks.
26
27 See the STUNNEL and x11vnc documentation for how to create and add SSL
28 Certificates (PEM files) for authentication. Click on the "Certs ..."
29 button to specify the certificate(s). See the Help there for more info
30 and 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
38 You can use x11vnc to create certificates if you like:
39
40 http://www.karlrunge.com/x11vnc/faq.html#faq-ssl-ca
41
42
43 Misc:
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
58 Important Note for Windows Vista: One user reports that on Windows Vista
59 if you move or extract the "ssvnc" folder down to the "Program Files"
60 folder you will be prompted to do this as the Administrator. But then
61 when you start up ssvnc, as a regular user, it cannot create files in
62 that folder and so it fails to run properly. We recommend to not copy
63 or extract the "ssvnc" folder into "Program Files". Rather, extract
64 it to somewhere you have write permission (e.g. C:\ or your User dir)
65 and create a Shortcut to ssvnc.exe on the desktop.
66
67 If you must put a launcher file down in "Program Files", perhaps an
68 "ssvnc.bat" that looks like this:
69 C:
70 cd \ssvnc\Windows
71 ssvnc.exe
72
73