webssh

WebSSH

Einführung

Eine einfache Webanwendung, die als SSH-Client verwendet werden kann, um eine Verbindung zu Ihren SSH-Servern herzustellen. Es ist in Python geschrieben und basiert auf Tornado, Paramiko und xterm.js.

Merkmale

• SSH-Passwortauthentifizierung wird unterstützt, einschließlich leerem Passwort.
• Unterstützt SSH-Public-Key-Authentifizierung, einschließlich DSA RSA ECDSA Ed25519-Schlüssel.
• Verschlüsselte Schlüssel werden unterstützt.
• Zwei-Faktor-Authentifizierung (zeitbasiertes Einmalpasswort) wird unterstützt.
• Vollbild-Terminal unterstützt.
• Größe des Terminalfensters veränderbar.
• Erkennt automatisch die Standardkodierung des SSH-Servers.
• Moderne Browser wie Chrome, Firefox, Safari, Edge und Opera werden unterstützt.

Vorschau

Wie es funktioniert

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

Anforderungen

• Python 3.8+

Schnellstart

1. Installieren Sie diese App und führen Sie den Befehl pip install webssh aus
2. Starten Sie einen Webserver und führen Sie den Befehl wssh aus
3. Öffnen Sie Ihren Browser und navigieren Sie zu 127.0.0.1:8888
4. Geben Sie Ihre Daten ein und senden Sie das Formular ab.

Serveroptionen

 # 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

Browserkonsole

 // 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' ) ;

Benutzerdefinierte Schriftart

Um benutzerdefinierte Schriftarten zu verwenden, legen Sie Ihre Schriftartendatei im Verzeichnis webssh/static/css/fonts/ ab und starten Sie den Server neu.

URL-Argumente

Unterstützen Sie die Übergabe von Argumenten per URL (Abfrage oder Fragment) wie in den folgenden Beispielen:

Übergabe von Formulardaten (Passwort muss in Base64 kodiert sein, privater Schlüssel wird nicht unterstützt)

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

Übergabe einer Terminal-Hintergrundfarbe

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

Übergabe einer Terminal-Schriftfarbe

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

Übergabe eines benutzerdefinierten Titels

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

Übergabe einer Kodierung

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

Übergabe einer Schriftgröße

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

Übergabe eines Befehls, der direkt nach der Anmeldung ausgeführt wird

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

Übergabe eines Terminaltyps

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

Verwenden Sie Docker

Starten Sie die App

 docker-compose up

Zerlegen Sie die App

 docker-compose down

Tests

Anforderungen

 pip install pytest pytest-cov codecov flake8 mock

Verwenden Sie unittest, um alle Tests auszuführen

 python -m unittest discover tests

Verwenden Sie pytest, um alle Tests auszuführen

 python -m pytest tests

Einsatz

Läuft hinter einem Nginx-Server

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 ;
}

Läuft als eigenständiger Server

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

Tipps

• Vergessen Sie bei jeder von Ihnen gewählten Bereitstellungsoption nicht, SSL zu aktivieren.
• Standardmäßig werden einfache HTTP-Anfragen von einem öffentlichen Netzwerk entweder umgeleitet oder blockiert, und die Umleitung hat Vorrang vor der Blockierung.
• Versuchen Sie, die Ablehnungsrichtlinie als Richtlinie für fehlende Hostschlüssel zusammen mit Ihren verifizierten bekannten Hosts zu verwenden. Dadurch werden Man-in-the-Middle-Angriffe verhindert. Die Idee besteht darin, dass die Hostschlüsseldatei des Systems („~/.ssh/known_hosts“) und die Hostschlüsseldatei der Anwendung („./known_hosts“) der Reihe nach überprüft werden, wenn der Hostname des SSH-Servers oder der Schlüssel nicht gefunden wird übereinstimmen, wird die Verbindung abgebrochen.