webssh

WebSSH

Introduction

Une application web simple à utiliser comme client ssh pour vous connecter à vos serveurs ssh. Il est écrit en Python, basé sur tornado, paramiko et xterm.js.

Caractéristiques

• Authentification par mot de passe SSH prise en charge, y compris mot de passe vide.
• Authentification par clé publique SSH prise en charge, y compris les clés DSA RSA ECDSA Ed25519.
• Clés cryptées prises en charge.
• Authentification à deux facteurs (mot de passe à usage unique basé sur le temps) prise en charge.
• Terminal plein écran pris en charge.
• Fenêtre du terminal redimensionnable.
• Détecter automatiquement l'encodage par défaut du serveur ssh.
• Navigateurs modernes, notamment Chrome, Firefox, Safari, Edge, Opera pris en charge.

Aperçu

Comment ça marche

 +---------+     http     +--------+    ssh    +-----------+
| browser | <==========> | webssh | <=======> | ssh server|
+---------+   websocket  +--------+    ssh    +-----------+

Exigences

• Python3.8+

Démarrage rapide

1. Installez cette application, exécutez la commande pip install webssh
2. Démarrez un serveur Web, exécutez la commande wssh
3. Ouvrez votre navigateur, accédez à 127.0.0.1:8888
4. Saisissez vos données, soumettez le formulaire.

Options du serveur

 # start a http server with specified listen address and listen port
wssh --address= ' 2.2.2.2 ' --port=8000

# start a https server, certfile and keyfile must be passed
wssh --certfile= ' /path/to/cert.crt ' --keyfile= ' /path/to/cert.key '

# missing host key policy
wssh --policy=reject

# logging level
wssh --logging=debug

# log to file
wssh --log-file-prefix=main.log

# more options
wssh --help

Console du navigateur

 // connect to your ssh server
wssh . connect ( hostname , port , username , password , privatekey , passphrase , totp ) ;

// pass an object to wssh.connect
var opts = {
  hostname : 'hostname' ,
  port : 'port' ,
  username : 'username' ,
  password : 'password' ,
  privatekey : 'the private key text' ,
  passphrase : 'passphrase' ,
  totp : 'totp'
} ;
wssh . connect ( opts ) ;

// without an argument, wssh will use the form data to connect
wssh . connect ( ) ;

// set a new encoding for client to use
wssh . set_encoding ( encoding ) ;

// reset encoding to use the default one
wssh . reset_encoding ( ) ;

// send a command to the server
wssh . send ( 'ls -l' ) ;

Police personnalisée

Pour utiliser une police personnalisée, placez votre fichier de police dans le répertoire webssh/static/css/fonts/ et redémarrez le serveur.

Arguments d'URL

Prise en charge de la transmission d'arguments par URL (requête ou fragment) comme les exemples suivants :

Transmission des données du formulaire (le mot de passe doit être codé en base64, clé privée non prise en charge)

http://localhost:8888/ ? hostname=xx & username=yy & password=str_base64_encoded

Passer une couleur d'arrière-plan de terminal

http://localhost:8888/ # bgcolor=green

Passer une couleur de police de terminal

http://localhost:8888/ # fontcolor=red

Passer un titre défini par l'utilisateur

http://localhost:8888/ ? title=my-ssh-server

Passer un encodage

http://localhost:8888/ # encoding=gbk

Passer une taille de police

http://localhost:8888/ # fontsize=24

Passer une commande exécutée juste après la connexion

http://localhost:8888/ ? command=pwd

Passer un type de terminal

http://localhost:8888/ ? term=xterm-256color

Utiliser Docker

Démarrez l'application

 docker-compose up

Démontez l'application

 docker-compose down

Essais

Exigences

 pip install pytest pytest-cov codecov flake8 mock

Utilisez unittest pour exécuter tous les tests

 python -m unittest discover tests

Utilisez pytest pour exécuter tous les tests

 python -m pytest tests

Déploiement

Exécuter derrière un serveur Nginx

wssh --address= ' 127.0.0.1 ' --port=8888 --policy=reject

 # Nginx config example
location / {
    proxy_pass http://127.0.0.1:8888;
    proxy_http_version 1.1 ;
    proxy_read_timeout 300 ;
    proxy_set_header Upgrade $http_upgrade ;
    proxy_set_header Connection "upgrade" ;
    proxy_set_header Host $http_host ;
    proxy_set_header X-Real-IP $remote_addr ;
    proxy_set_header X-Real-PORT $remote_port ;
}

Exécuté en tant que serveur autonome

wssh --port=8080 --sslport=4433 --certfile= ' cert.crt ' --keyfile= ' cert.key ' --xheaders=False --policy=reject

Conseils

• Quel que soit le choix de déploiement que vous choisissez, n'oubliez pas d'activer SSL.
• Par défaut, les requêtes http simples provenant d'un réseau public seront soit redirigées, soit bloquées et la redirection aura priorité sur le blocage.
• Essayez d'utiliser la politique de rejet comme politique de clé d'hôte manquante avec vos hôtes connus vérifiés, cela empêchera les attaques de l'homme du milieu. L'idée est qu'il vérifie le fichier de clés d'hôte du système ("~/.ssh/known_hosts") et le fichier de clés d'hôte d'application (""./known_hosts") dans l'ordre, si le nom d'hôte du serveur ssh n'est pas trouvé ou si la clé n'est pas correspond, la connexion sera interrompue.