This project was created during my studies of "pspac" at the FAU Erlangen. It's a simple framework to launch distributed "jobs", e.g. hashcat.
The jobs de.jowo.pspact.jobs.HashcatJob and de.jowo.pspact.jobs.BatchHashcatJob can be used to perform a mask attack using any number of nodes.
Because any hashcat argument can be passed to the framework essentially all hashes supported by hashcat can be cracked.
For a documentation of (most) parameters see de.jowo.pspac.MainClass and de.jowo.pspac.factories.
Examples:
| Node | Parameters | Comment |
|---|---|---|
| Master | -Dfactory=DemoFactory -Ddelaymillis=500 -Dmode=master -Dmaskfile=maskfile | Run master using the demo jobs |
| Master | -Dfactory=BatchMaskFactory -Dmode=master -Dmaskfile=maskfile -Dhashcatargs="-m 0" -Dhash=098f6bcd4621d373cade4e832627b4f6 | Crack the given MD5 hash using batch jobs |
| Worker | -Dmode=worker -Dmasterhost=localhost | Run worker connecting to the master at "localhost". Multiple instances of this worker can be started! |
Important parameters (pass using -D{name}):
| Parameter | Description | Default | Mandatory |
|---|---|---|---|
| maskfile | The path to the maskfile to be used for hash breaking | - | yes |
| mode | The mode to be used | worker | no |
| startmanually | Specifies whether the job should start automatically once the first worker has registered | true | no |
| LOG_DIR | The path for all log files, e.g. "/tmp/pspac_logs" | System.getProperty("java.io.tmpdir") | no |
Eclipse was used for development (as obvious by the .classpath). However you can also use:
ant clean dist
to create a deployable jar.
The master can be monitored using VisualVM using the de.jowo.pspac.MasterControl as illustrated below.
The above mentioned LOG_DIR specifies where the logfiles will be stored. Typically this points to a central NFS.
For a demo run with 3 workers using the rockyou-1-60.hcmask maskfile the following logs will be generated:
| Node | Logfile |
|---|---|
| Master | pspac_master.log |
| Worker 1 | pspac_1.log |
| Worker 2 | pspac_2.log |
| Worker 3 | pspac_3.log |
Distributes the workload to all registered workers.
The job to run is given as start parameter, see the usage section for details.
Executes the job given by the master. All jobs are implemented in the de.jowo.pspac.jobs package.