Skip to content
Snippets Groups Projects
Commit 171dee43 authored by Thibault Debatty's avatar Thibault Debatty
Browse files

update README with installation instruction

parent d3a995c4
No related branches found
No related tags found
No related merge requests found
Pipeline #10417 passed
......@@ -6,8 +6,28 @@
A simple Python brute-force login cracker. Basically, a simplified Python version of Hydra [https://github.com/vanhauser-thc/thc-hydra].
## Installation
1. Download latest package release from [packages registry](https://gitlab.cylab.be/cylab/dokos/-/packages)
2. Install with :
```bash
python3 -m pip install ./dokos-*-py3-none-any.whl
```
## Usage
You can now use with
```bash
dokos -l <login> -P <passwords list> -f <failed login message> <url>
```
The **failed login message** is required so dokos can recognize when a login attempt has failed, and hence to detect
when login is sucessfull.
For example:
```bash
./dokos.py -l <login> -P <passwords list> <url>
dokos -l jane.doe@example.com -P 10-million-password-list.txt -f "Bad combination of e-mail and password" https://example.com/login
```
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment