Code Monkey home page Code Monkey logo

pdump's Introduction

PDump

██████╗ ██████╗ ██╗   ██╗███╗   ███╗██████╗
██╔══██╗██╔══██╗██║   ██║████╗ ████║██╔══██╗
██████╔╝██║  ██║██║   ██║██╔████╔██║██████╔╝
██╔═══╝ ██║  ██║██║   ██║██║╚██╔╝██║██╔═══╝
██║     ██████╔╝╚██████╔╝██║ ╚═╝ ██║██║
╚═╝     ╚═════╝  ╚═════╝ ╚═╝     ╚═╝╚═╝
A DEHASHED password dumper written by purpl3ph03n1x

A Command Line Interface (CLI) tool which harness the power of DEHASHED API to retrieve leaked information for DEHASHED Data Well.

About The Tool

Insperation

During an assessment, I found myself CURLing the DEHASHED API, redirecting the output to files and then writing a couple of python lines to convert the JSON format to CSV. Doing this process once was fun, but then it was mandane as the searches increased. That was the epiphany moment of F**k it! I'll automate this sh*t!

The idea to convert CSV to XLSX was to include MACROs to get initial access to the client once opened! Nah, I am joking :P

The reason was that brings value to the client and after a couple of tunes using Excel can be considered a deliverable.

Behavior on the Filesystem

Output Location

Upon execution of the script two folders are created

  • log => Where the JSON response of the API is saved

  • results => Where the CSV and XLSX files are saved inside another folder whose name depends on the search type and search data.

  • Program the tool to have a fixed location to save the output, otherwise the filesystem will be full of log and results folders.

Output Format

PDump is saving the results in 3 output formats

  • JSON => This is the response of the API and is save with the aim of not comsuming API credits again if you want to perform some other kind of operations on the data
  • CSV => The format was selected for the response to be more human readable
  • XLSX => The tool is using the CSV format to generate a XLSX file using pandas for the ultimate human-friendly representation of the data

Filename Conventions

The folders in which he output data are saved follow the namespace {search type}-{search data}-{page}, if there is a pagination. For example, domain-gmail.com-1 would be the folder name in case the following command is executed

python3 pdump domain -s gmail.com

The filenames adhere to a different namespace {currentDaycurrentMonth_currentHourcurrentMinute}-{search type}-{search data}. For example, 2309_1257-domain-gmail.com.csv would be the filename in case the following command is executed and the datetime is 23/09/2023 12:57

python3 pdump domain -s gmail.com

Getting Started

Requirements

For the tool to be functional, the following python3 modules should be installed

requests openpyxl pandas python-dotenv

This can be done by executing the following command

python3 -m pip install -r requirements

Usage

usage: pdump.py [-h] [-s SEARCH] [-f FILE] query_type

Querying DEHASHED For Leaked Credentials

positional arguments:
  query_type            domain, email, username, password, vin, phone, name, ip_address, hashed_password

options:
  -h, --help            show this help message and exit
  -s SEARCH, --search SEARCH
                        The value to be searched against DEHASHED database
  -f FILE, --file FILE  A file with New Line Separated values

API provides with the capabilities to search for domain, email, username, password, hashed_password, vin, phone, name, ip_address

  • The code has been currently tested against domain, email, username, password

Therefore, the CLI arguments should be

  python3 pdump.py domain -s gmail.com
  python3 pdump.py password -f passwords.txt

Acknowledgements

I want to shout out my gratitude for my colleague and friend @nickvourd for his ethusiasm and believing that is not just a tool.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

pdump's People

Contributors

stavrosgns avatar larch1t3ct avatar nickvourd avatar

Stargazers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.