Skip to content
Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
user-api
.gitignore
README.md
changelog.md
php_style.xml
protocol.pdf
protocol.tex

README.md

Documentation

Hashtopolis Protocol

The current up-to-date protocol version which Hashtopolis uses to communicate with clients is contained in the protocol.pdf file. The documentation for the User API can be found in user-api/user-api.pdf, listing all functions which can be called.

Generic Crackers

Custom crackers which should be able to get distributed with Hashtopolis need to fulfill some minimal requirements as command line options. Shown here with the help function of a generic example implementation (which is available here):

cracker.exe [options] action
Generic Cracker compatible with Hashtopolis

Options:
  -m, --mask <mask>                   Use mask for attack
  -w, --wordlist <wordlist>           Use wordlist for attack
  -a, --attacked-hashlist <hashlist>  Hashlist to attack
  -s, --skip <skip>                   Keyspace to skip at the beginning
  -l, --length <length>               Length of the keyspace to run
  --timeout <seconds>                 Stop cracking process after fixed amount of time

Arguments:
  action                              Action to execute ('keyspace' or 'crack')

-m and -w are used to specify the type of attack, but these options are not mandatory to look like this.

Please note that not all Hashtopolis clients are compatible with generic cracker binaries (check their README) and if there are slight differences in the cracker compared to the generic requirements there might be changes required on the client to adapt to another handling schema.

You can’t perform that action at this time.