webssh

WebSSH

Introducción

Una aplicación web sencilla que se utilizará como cliente ssh para conectarse a sus servidores ssh. Está escrito en Python, basado en tornado, paramiko y xterm.js.

Características

• Se admite la autenticación de contraseña SSH, incluida la contraseña vacía.
• Se admite la autenticación de clave pública SSH, incluidas las claves DSA RSA ECDSA Ed25519.
• Se admiten claves cifradas.
• Se admite la autenticación de dos factores (contraseña de un solo uso basada en el tiempo).
• Compatible con terminal de pantalla completa.
• Ventana de terminal redimensionable.
• Detecta automáticamente la codificación predeterminada del servidor ssh.
• Se admiten navegadores modernos, incluidos Chrome, Firefox, Safari, Edge y Opera.

Avance

como funciona

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

Requisitos

• Pitón 3.8+

Inicio rápido

1. Instale esta aplicación, ejecute el comando pip install webssh
2. Inicie un servidor web, ejecute el comando wssh
3. Abra su navegador, navegue hasta 127.0.0.1:8888
4. Ingrese sus datos, envíe el formulario.

Opciones de servidor

 # 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

Consola del navegador

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

Fuente personalizada

Para usar una fuente personalizada, coloque su archivo de fuente en el directorio webssh/static/css/fonts/ y reinicie el servidor.

Argumentos de URL

Admite el paso de argumentos por URL (consulta o fragmento) como en los siguientes ejemplos:

Pasar datos del formulario (la contraseña debe estar codificada en base64, no se admite la clave privada)

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

Pasar un color de fondo de terminal

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

Pasar un color de fuente de terminal

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

Pasar un título definido por el usuario

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

Pasar una codificación

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

Pasar un tamaño de fuente

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

Pasar un comando ejecutado inmediatamente después de iniciar sesión

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

Pasando un tipo de terminal

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

Usar ventana acoplable

Inicia la aplicación

 docker-compose up

Derribar la aplicación

 docker-compose down

Pruebas

Requisitos

 pip install pytest pytest-cov codecov flake8 mock

Utilice unittest para ejecutar todas las pruebas

 python -m unittest discover tests

Utilice pytest para ejecutar todas las pruebas

 python -m pytest tests

Despliegue

Ejecutando detrás de un servidor 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 ;
}

Ejecutándose como un servidor independiente

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

Consejos

• Cualquiera que sea la opción de implementación que elija, no olvide habilitar SSL.
• De forma predeterminada, las solicitudes http simples de una red pública serán redirigidas o bloqueadas y la redirección tiene prioridad sobre el bloqueo.
• Intente utilizar la política de rechazo como política de clave de host faltante junto con sus hosts_conocidos verificados; esto evitará ataques de intermediario. La idea es que verifique el archivo de claves del host del sistema ("~/.ssh/known_hosts") y el archivo de claves del host de la aplicación (""./known_hosts") en orden, si no se encuentra el nombre de host del servidor ssh o no se encuentra la clave. coinciden, la conexión se cancelará.