Skip to content

Kraken: A multi-platform distributed brute-force password cracking system

Notifications You must be signed in to change notification settings

arcaneiceman/kraken

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


Warning

I have been reviewing the Kraken-Client code and since this was my first ever react app, its old, clunky and it needs major improvement (the server needs some work too). In the next few weeks/months I will do my best to rewrite it in either updated React or in another framework. Please feel free to continue using this as is, if you have any trouble please continue to raise issues and provide feedback! Thanks!


Kraken: A multi-platform distributed brute-force password cracking system

What is Kraken

Kraken is an online distributed brute force password cracking tool. It allows you to parallelize dictionaries and crunch word generator based cracking across multiple machines both as a web app in a web browser and as a standalone electron based client. Kraken aims to be easy to use, fault tolerant and scalable.

I wrote Kraken because I wanted to learn more about offensive security and to write an easy solution to overcome the limitation of using a single device when attempting distribute brute force workloads.

Installation

Server and Browser Client

Kraken is a dockerized application using docker-compose which will launch the db (Postgres), s3 compliant file storage (Minio), the server and the browser client. You can find the docker-compose file at the root directory of the repository. You can deploy it using the following command:

docker-compose up

Kraken's Browser Client should be accessible at:

Note: To run the Browser Client from a remote machine, you MUST use HTTPS for both server url and browser url. Eg. If you are hosting the server on 192.168.1.2, then browser client will be available at https://192.168.1.2:8443 and the server url should be https://192.168.1.2:8443/api

To upload password lists or dictionaries, upload them to Minio Console at localhost:9001. View steps below for a detailed guide Otherwise, you can generate word lists dynamically using crunch. See crunch options and how to use them here: crunch man page

Kraken's server runs on localhost:5000 and also hosts swagger documentation at localhost:5000/swagger.

Portable Desktop Client

The desktop client is an electron based portable application and can be run on Mac, Windows and Linux. Due to sensitive permissions required to function, it is highly recommended that you compile and it yourself by cloning the repo and using :

cd kraken-client
npm install
npm run electron-start
Windows

Note: Window EXE portable client needs to run in the folder with its hashcat dependencies. Hashcat files can be dowloaded from their home page or here. Ive included a compressed zip file with the portable executable and required hashcat files. They can be downloaded:

Linux

Releases include a Linux AppImage which only requires hashcat to be installed.

Install hashcat:

sudo apt-get install hashcat

You will have to give AppImage permission via properties to execute.

Adding WordLists to Kraken

To add your wordlists to minio, here are the steps:

  1. [UI way] Access your minio console at https://localhost:9001/. Should land you here:

image

  1. Log in with u:admin p:password (default; can be changed). A 'kraken' bucket should be present like so:

image

  1. Hit 'Browse' to see what files are available and add the wordlists you with 'Upload'

image

  1. Either wait up to 5 minutes for the server to pick it up or restart the server. You'll know the server has picked up the list when via log. Note: Large lists take a while to index.

image

  1. The wordlist should show up when creating the request

image

Note

This guide is on-going but please feel free to raise an issue or contact me for any help required.