Wsh 1.3.3

Wsh (web shell) - remote unix/win shell, that works via HTTP.
This package contains two perl scripts for server and client
hosts: wsh-c.pl - client, wsh-s.pl - server. wsh-c.pl is
for console usage and wsh-s.pl runs as CGI script on the
target host.

FEATURES

+ command line history support (*)
+ file upload/download
+ protect server part script usage with secret key in
  HTTP message
+ data flow Xor encoding
+ can work trough HTTP proxy server (to hide client ip
  or bypass firewall)

  (*) - next packages are required:
  1) readline-4.2a.tar.gz or later from
     http://www.gnu.org/directory/readline.html
  2) ReadLine-Gnu-1.12.tar.gz or later from
     http://search.cpan.org/search?dist=Term-ReadLine-Gnu


HOW IT WORKS

+----------+        +------------+    |   +-------------------+
| CLIENT   |<-HTTP->| http proxy |<-HTTP->| WEB SERVER        |
| wsh-c.pl |        | (optional) |    |   | /cgi-bin/wsh-s.pl |
+----------+        +------------+    |   +-------------------+
                                      |
                                  Firewall?

wsh-c.pl provides shell-like prompt, encapsulating user
commands into HTTP POST requests and sending them to the
wsh-s.pl script on the target web server directly or via
HTTP proxy server. wsh-s.pl extracts and executes commands
from HTTP post requests and returns STDOUT and STDERR output
as HTTP response message. By default both scripts encode
HTTP data with Xor.

CONFIGURATION

1. Check path to perl in wsh-c.pl and config.pl files;
2. Run config.pl;
3. Edit wsh-c.conf file if you want to use HTTP proxy;
4. Put wsh-s.pl under the target host cgi-bin directory
   and check path to perl in wsh-s.pl;

USAGE

sh# ./wsh-c.pl targethost.com/cgi-bin/wsh-s.pl <Key>

<Key> is the default KEY, if you do not change it with
config.pl or manually in wsh-c.conf and wsh-s.pl files.

wsh commands:
  exit          as is;
  history       show commands history;
  !<number>     execute command with history <number>;
  wshget <file> get <file> from remote host to local directory;
  wshput <file> put <file> from local directory to remote host;
  lect <lecter:> change to lecter on Win32 (ex: "lect d:");

AUTHOR

Alex Dyatlov <alex@gray-world.net>
http://gray-world.net
Bug reports and new feature requests are welcome

THANKS

Simon Castro <scastro@entreelibre.com> - for WIN environment support addon
