It is the official code repository for our paper.

Title: Improving Password Guessing via Representation Learning

Authors: Dario Pasquini, Ankit Gangwal, Giuseppe Ateniese, Massimo Bernaschi, and Mauro Conti.

• Adaptive, Dynamic Mangling rules: ADaMs attack

Our basic GAN generator is an improved version of the one proposed in PassGAN. A comparison on the RockYou test-set follows:

Directory DATA/TFHUB_models contains pretrained GAN generators and autoencoders in tensorflow hub format. You can play with them using the python notebook sampleFromPassGAN.ipynb and CPG_poc.ipynb respectively.

The code for the training of the generator and the encoder will be uploaded soon.

Dependencies:

• tensorflow1 (only 1.14.0 tested)
• tensorflow_hub
• numpy
• tqdm
• gin #pip install gin-config
• numpy_ringbuffer # pip install numpy_ringbuffer
• peloton_bloomfilters from Peloton (in our repo, a modified version of the code aimed for py3)
  • peloton_bloomfilters; pip install .

Use the python script generatePasswords.py to unconditionally generate password.

USAGE: python3 generatePasswords.py NBATCH BATCHSIZE OUTPUTFILE

here:

• NBATCH = Number of passwords batches to generate
• BATCHSIZE = Number of passwords in a generated batch (bigger = faster; but depends from your GPU's memory )
• OUTPUTFILE = Path of the file where to write the generated passwords

An example:

python3 generatePasswords.py 10000 4096 ./OUTPUT/out.txt

The script: dynamicPG.py is a proof-of-concept implementation of Dynamic Password Guessing. The script takes as input the set of attacked passwords (plaintext) and perform DPG on it. The generated passwords are then printed on a chosen output file.

USAGE: python3 dynamicPG.py CONF TEST-SET #GUESSES OUTPUTFILE

here:

• CONF = gin configuration file. An example of this can be found in './DATA/CONFINGS/DPG_default.gin'. Here, you can choose the value for $\sigma$ and $\alpha$.
• TEST-SET = Path of the textual file containing the attacked passwords (plaintext). The file must contain a password per row.
• GUESSES = Number of passwords to produce.
• OUTPUTFILE = Path of the file where to write the generated passwords

An example:

python3 dynamicPG.py DATA/CONFINGS/DPG_default.gin ~/zomato.txt 10000000 output.txt

As reported in our paper, DPG is aimed to be applied on password leaks the follow distributions different from the one of the used training-set (our a priori knowledge). Additionally, it works particularly well when the attacked leak has large cardinality.

You can play with CPG using CPG_poc.ipynb.

The code needed to train a GAN generator is located inside the directory PasswordGAN.

To train the generator, you need to create a training set first. You can do that by using the script make_dataset.py. make_dataset.py takes three arguments as input:

1. The path to an txt file that contains the passwords you want to use to train the model. ⚠️ Every line of the file must be in the format: "[PASSWORD FREQUENCY] [PASSWORD]". For instance:

     49952 iloveyou
     33291 princess
     21725 1234567
     20901 rockyou
     20553 12345678
     16648 abc123
     ...........
   

   Here an example file.

2. The maximum length of the passwords to include in the training set (e.g., 10 or 16).

3. Where to save the output file in pickle format e.g, /home/user/dataset.pickle.

Once created the dataset, you have to edit the config file in PasswordGAN/CONF/arch1.gin. In particular, you have to set the variable setup.dataset_path with the path to the dataset e.g.:

setup.dataset_path = "/home/user/dataset.pickle"

Then, you can train the model by using the script train.py. The script takes as input the path to the config file e.g.,:

python train.py CONF/arch1.gin

The script saves tensorboard logs and checkpoints inside the folder "./PasswordGAN/HOME/CHECKPOINTS/".

The code needed to train a GAN generator is located inside the directory PasswordAE. As for the GAN model, a training set must be created. You can do that by using the script parseDataSetWithCount.py. This takes 6 input parameters:

1. A txt containing the passwords. This must have the same format "[PASSWORD FREQUENCY] [PASSWORD]" used for the GAN model.
2. The maximum length of the passwords to include in the training set (e.g., 10 or 16).
3. The minimum length of the passwords to include in the training set (e.g., 3).
4. The allowed charset e.g., ascii or utf-8.
5. The output directory.
6. The size of the validation-set in [0,1] e.g., 0.2 (20% is used a validation-set).

A complete example:

python parseDataSetWithCount.py ~/phpbb-withcount.txt 16 2 ascii HOME/DATASET/. 0.2

Once created the dataset file, you have to set setup.home inside the config file PasswordAE/CONF/CAE0.gin with the path to the dataset e.g., setup.home = "HOME/DATASET/"

Then, you can train the model:

python train.py CONFs/CAE0.gin

As for the GAN, it should save checkpoints and tfhub models inside PasswordAE/HOME/MODELS/.

Finally, you should be able to load the model with CPG_poc.ipynb and check if it works.

@INPROCEEDINGS {improvingpgvrl,
	author = {D. Pasquini and A. Gangwal and G. Ateniese and M. Bernaschi and M. Conti},
	booktitle = {2021 2021 IEEE Symposium on Security and Privacy (SP)},
	title = {Improving Password Guessing via Representation Learning},
	year = {2021},
	issn = {2375-1207},
	pages = {265-282},
	keywords = {password-security;deep-learning},
	doi = {10.1109/SP40001.2021.00016},
	url = {https://doi.ieeecomputersociety.org/10.1109/SP40001.2021.00016},
	publisher = {IEEE Computer Society},
	address = {Los Alamitos, CA, USA},
	month = {may}
}