Skip to content

Commit

Permalink
+ Update README.md
Browse files Browse the repository at this point in the history
+ Shields
+ Examples usages
  • Loading branch information
matricali committed Jun 6, 2017
1 parent 27890bd commit ec3adb9
Showing 1 changed file with 48 additions and 1 deletion.
49 changes: 48 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
[![license](https://img.shields.io/github/license/jorge-matricali/brutekrag.svg)](https://jorge-matricali.mit-license.org/2014-2017) [![GitHub contributors](https://img.shields.io/github/contributors/jorge-matricali/brutekrag.svg)](https://github.com/jorge-matricali/brutekrag/graphs/contributors)
[![PyPI](https://img.shields.io/pypi/dm/brutekrag.svg)](https://pypi.python.org/pypi/brutekrag)

# brutekrag
SSH brute force using dictionary attack. Written in _Python_.
_brute krag_ means "brute force" in afrikáans
Expand All @@ -18,5 +21,49 @@ pip install brutekrag
```
Then you can do
```bash
brutekrag --help
$ brutekrag --help

usage: brutekrag [-h] [-t TARGET] [-T TARGETS] [-pF PASSWORDS] [-uF USERS]
[-sF SINGLE] [--separator SEPARATOR] [-p PORT] [-u USER]
[-P PASSWORD] [--timeout TIMEOUT]

_ _ _
| | | | | |
| |__ _ __ _ _| |_ ___| | ___ __ __ _ __ _
| '_ \| '__| | | | __/ _ \ |/ / '__/ _` |/ _` |
| |_) | | | |_| | || __/ <| | | (_| | (_| |
|_.__/|_| \__,_|\__\___|_|\_\_| \__,_|\__, |
OpenSSH Brute forcer tool 0.2.0 __/ |
(c) Copyright 2014 Jorge Matricali |___/
optional arguments:
-h, --help show this help message and exit
-t TARGET, --target TARGET
Target hostname or IPv4.
-T TARGETS, --targets TARGETS
Targets file that containas one hostname or IPv4 per line.
-pF PASSWORDS, --passwords PASSWORDS
Path to password dictionary file. One password per line.
-uF USERS, --users USERS
Path to users list file. One user per line.
-sF SINGLE, --single SINGLE
Path to a file that contains a combination of both username and password. One combination per line, separated by space character by default.
--separator SEPARATOR
Custom username/password separator. It's should be used in conjunction with -sF.
-p PORT, --port PORT Target port (default 22).
-u USER, --user USER Single user bruteforce.
-P PASSWORD, --password PASSWORD
Single password bruteforce.
--timeout TIMEOUT Connection timeout (in seconds, 1 default).
```

## Example usages
```bash
# One target, one user, many passwords
brutekrag -t 10.10.0.14 --user root --passwords passwords.txt
# Many targets, one user, empty password
brutekrag -T targets.txt --user root --password ''
# One target, many pre-made combinations of user and password
brutekrag -t 192.168.0.1 --single combined.txt
```

0 comments on commit ec3adb9

Please sign in to comment.