WSH 2.0.1
  
  WSH (Web Shell) - Shell distant UNIX/WIN sur un flux HTTP/HTTPS.
  
FONCTIONNALITES

  + Support SSL (*);
  + Support historique de ligne de commande (**);
  + Emission/reception de fichiers;
  + Protection du script serveur par une cle secrete dans les messages HTTP;
  + Codage du flux de donnees par Xor;
  + Peut utiliser un serveur proxy HTTP (pour cacher l'ip  du  client ou  passer
    au travers d'un firewall);

    (*) Le package Net::SSLeay est requis pour l'hote client:
    Telechargez le sur:
    http://search.cpan.org/author/SAMPO/Net_SSLeay.pm-1.22/

    (**) - Les packages suivants sont requis sur l'hote client:
    1) readline-4.2a.tar.gz ou superieur sur
       http://www.gnu.org/directory/readline.html
    2) ReadLine-Gnu-1.12.tar.gz ou superieur sur
       http://search.cpan.org/search?dist=Term-ReadLine-Gnu

FONCTIONNEMENT

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

  wsh-c.pl offre un prompt shell, encapsule les commandes dans des requetes HTTP
  POST et les envoie au script wsh-s.pl localise sur le serveur Web distant soit
  directement, soit via un serveur proxy HTTP. wsh-s.pl extrait et  execute  les
  commandes des requetes HTTP POST et renvoie les sorties STDOUT et STDERR  dans
  messages de reponse HTTP. Par defaut, les deux script codent le flux avec Xor.

INSTALLATION

  1. Verifiez le chemin vers Perl dans le fichier "config.pl";
  2. Executez "config.pl";
     Verifiez le fichier "wsh-c.conf", et si vous voulez utiliser un proxy HTTP;
        use_proxy	1
        proxy_ip	<ip>
        port            <port>
  3. Verifiez le chemin vers Perl et les permissions du fichier "wsh-c.pl" cree;
  4. Verifiez les directives suivantes dans le fichier "wsh-s.pl":
        my $win32 = 0;     # set $win32 = 1 to turn on WIN support
	my $encode = 1;    # set $encode = 1 to turn on Xor encoding
	my $invert = 85;   # xor value
  5. Positionnez wsh-s.pl dans le repertoire cgi-bin du serveur web et  verifiez
     le chemin vers Perl;

  A propos de SSL :

  a. Si vous utilisez un client SSL wsh-c.pl, vous pouvez configurer  ce  client
     pour qu'il verifie le CN du certificat du serveur (Notez que ceci peut etre
     detourne !):
	my $ssl_set_check=1;            # (0 || 1) don't or check the  webserver
					#          ssl certificate with internal
					#          ssl_crt_subject.
	my $ssl_crt_subject="/C=Fr/ST=Paris/L=Paris/O=XXX/OU=XXX/CN=XXX";
     => Vous pouvez le faire en executant une fois  le  client  wsh-c.pl  et  en
        recuperant le CN affiche par le message d'erreur.

  b. Nous n'avons pas teste le client wsh-c-SSL.pl sur un systeme Win32. Si vous
     avez la possibilite d'installer  Net:SSLeay  sur  Win32  et  de  tester  le
     client, envoyez-nous un mail.

USAGE

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

  <Key> est la cle par defaut, si vous ne  la  changez  pas  avec  config.pl  ou
  manuellement dans les fichiers wsh-c.conf et wsh-s.pl.

  Commandes WSH:
    exit           comme son nom l'indique;
    history        afficher l'historique des commandes;
    !<number>      execute la commande <number> dans l'historique;
    wshget <file>  recoit  le   fichier  <file>   du  serveur  distant  dans  le
		   repertoire local courant;
    wshput <file>  envoit le fichier  <file>  du  repertoire  local  courant  au
		   serveur distant;
    lect <lecter:> change de lecteur sous Win32 (ex: "lect d:");

LICENCE
  
  WebShell est distribue sous les termes de  la  licence  GNU  -  General Public
  Licence version 2.0.
  Consultez le fichier COPYING pour plus de details.

AUTEURS

  Alex Dyatlov <alex@gray-world.net>     - Code principal de WSH.
  Simon Castro <scastro@entreelibre.com> - Support WIN et SSL.

  La derniere version de WSH est disponible sur:
  http://gray-world.net/
  http://www.entreelibre.com/scastro/wsh/

  Le forum de discussion WSH est disponible sur:
  http://gray-world.net/board/
