webssh

WebSSH

Introdução

Um aplicativo web simples para ser usado como cliente ssh para conectar-se aos seus servidores ssh. Está escrito em Python, baseado em tornado, paramiko e xterm.js.

Características

• Autenticação de senha SSH suportada, incluindo senha vazia.
• Autenticação de chave pública SSH suportada, incluindo chaves DSA RSA ECDSA Ed25519.
• Chaves criptografadas suportadas.
• Autenticação de dois fatores (senha única baseada em tempo) suportada.
• Terminal de tela cheia suportado.
• Janela do terminal redimensionável.
• Detecta automaticamente a codificação padrão do servidor ssh.
• Navegadores modernos, incluindo Chrome, Firefox, Safari, Edge, Opera são suportados.

Visualização

Como funciona

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

Requisitos

• Python 3.8+

Início rápido

1. Instale este aplicativo, execute o comando pip install webssh
2. Inicie um servidor web, execute o comando wssh
3. Abra seu navegador, navegue até 127.0.0.1:8888
4. Insira seus dados, envie o formulário.

Opções 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

Console do 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' ) ;

Fonte personalizada

Para usar fonte personalizada, coloque seu arquivo de fonte no diretório webssh/static/css/fonts/ e reinicie o servidor.

Argumentos de URL

Suporta passagem de argumentos por URL (consulta ou fragmento), como nos exemplos a seguir:

Passando dados do formulário (a senha deve ser codificada em base64, chave privada não suportada)

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

Passando uma cor de fundo do terminal

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

Passando uma cor de fonte do terminal

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

Passando um título definido pelo usuário

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

Passando uma codificação

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

Passando um tamanho de fonte

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

Passando um comando executado logo após o login

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

Passando um tipo de terminal

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

Use o Docker

Inicie o aplicativo

 docker-compose up

Derrube o aplicativo

 docker-compose down

Testes

Requisitos

 pip install pytest pytest-cov codecov flake8 mock

Use unittest para executar todos os testes

 python -m unittest discover tests

Use pytest para executar todos os testes

 python -m pytest tests

Implantação

Executando atrás de um 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 ;
}

Executando como um servidor independente

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

Pontas

• Para qualquer opção de implantação escolhida, não se esqueça de ativar o SSL.
• Por padrão, as solicitações HTTP simples de uma rede pública serão redirecionadas ou bloqueadas e o redirecionamento tem precedência sobre o bloqueio.
• Tente usar a política de rejeição como a política de chave de host ausente junto com seus conhecidos_hosts verificados, isso evitará ataques man-in-the-middle. A ideia é que ele verifique o arquivo de chaves do host do sistema("~/.ssh/known_hosts") e o arquivo de chaves do host do aplicativo("./known_hosts") em ordem, se o nome do host do servidor ssh não for encontrado ou a chave não for correspondido, a conexão será abortada.