Skip to content

Commit e36e94d

Browse files
committed
Update README with new instructions and usage options
- Clarified motivation with updated timeline - Added section for pre-compiled package execution - Linked to releases page for executable download - Expanded usage options with detailed descriptions - Improved backend and frontend configuration details - Highlighted optional login and SSL settings
1 parent 59b8cab commit e36e94d

1 file changed

Lines changed: 15 additions & 5 deletions

File tree

README.md

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66

77
## Motivação
88

9-
Nas últimas semanas detectei o que julguei serem falhas
9+
Em Fevereiro de 2024 detectei o que julguei serem falhas
1010
gravíssimas no sistema Whaticket e seus derivados.
1111

1212
O autor do projeto original deixa claro que ele não teve
@@ -48,6 +48,12 @@ que é o padrão para o usuário administrador.
4848
4949
## Instruções
5050

51+
### Executando o pacote pré compilado
52+
53+
[Acessando a página de releases](https://github.com/allgood/WhaticketExploit/releases) Você pode baixar o arquivo executável e rodar direto no Windows.
54+
55+
### Executando a partir do código fonte
56+
5157
Você vai precisar do [nodejs](https://nodejs.org/) instalado em seu computador.
5258

5359
Tendo ele instalado, abra um terminal e navegue até a pasta em que
@@ -64,10 +70,14 @@ Depois você pode executar ele:
6470
npm start
6571
```
6672

67-
Ele vai solicitar a URL do backend. Ela precisa iniciar com `wss://`
68-
ou `ws://`, depois de clicar em "Analize" ele vai conectar ao
69-
websocket do servidor e iniciar a analisar. Se o servidor estiver
70-
vulnerável você verá as mensagens sendo trafegadas em tempo real.
73+
### Opções de uso
74+
75+
O Whaticket-Exploit fornece algumas opções na primeira tela:
76+
77+
* **backend_hostname**: Esse é obrigatório, vai indicar onde está rodando o serviço de websocket, normalmente sem porta, mas se tiver necessidade pode ser colocada no formato hostname:port
78+
* **frontend_hostname**: (opcional) O backend de alguns sistemas exigem a URL do frontend como origem, isso não adiciona segurança pois é facilmente forjável. Preenchendo esse campo o cabeçalho de origem será preenchido de acordo
79+
* **login** e **password**: (opcional) É possível fornecer um login e senha para observar vazamento de dados de outras empresas e usuários. **ATENÇÃO:** Nesse modo as mensagens direcionadas ao login fornecido também serão exibidas, o que não configura exatamente um vazamento... só é mesmo vazamento se mensagens que o usuário fornecido não devesse ter acesso aparecerem.
80+
* **enable ssl**: Geralmente marcado, indica que deve utilizar https para acessar o backend.
7181

7282

7383
## Foi útil?

0 commit comments

Comments
 (0)