Skip to main content

A network protocol analyzer and credential extractor

Project description

Image Alt text

PufferRelay

PufferRelay is a pentesting tool designed to extract valuable information from .pcap (Wireshark) files.
It focuses on parsing and analyzing network traffic to surface sensitive or actionable data that may aid in offensive security operations.


🔍 Features

  • Extracts protocol-specific data
    • LDAP, HTTP, FTP, TELNET, SMTP, NETBIOS, NTLM
  • Parses .pcap files and stores data in a queryable SQL format
  • Designed for use in red teaming and network traffic analysis
  • Modular structure for easy extension

🚀 Getting Started

🛠️ Install

⚗️PIPX

sudo apt install tshark
pipx install pufferrelay

👨🏿‍🔧PIP

python3 -m venv venv
source venv/bin/activate.fish
pip3 install -r requirements.txt

▶️ Usage

⚗️PIPX

pufferrelay {flag} {filename}

👨🏿‍🔧PIP

python3 -m PufferRelay {flag} {filename}

Parse pcap file into sqlite3 database and display all pertinent information

pufferrelay -f {filename}

Read 'DB_NAME' database and extract all pertinent information

pufferrelay -r

🐛 DEBUG

pufferrelay -f {filename} --log-level DEBUG

Documentation

The Wiki is under construction but will be available soon !


🤝 Contributing

We welcome contributions from the community! See CONTRIBUTING.md for guidelines.


📄 License

Licensed under the GPL-3.0 License.
See the NOTICE file for attribution details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pufferrelay-1.0.4.tar.gz (36.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pufferrelay-1.0.4-py3-none-any.whl (53.5 kB view details)

Uploaded Python 3

File details

Details for the file pufferrelay-1.0.4.tar.gz.

File metadata

  • Download URL: pufferrelay-1.0.4.tar.gz
  • Upload date:
  • Size: 36.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for pufferrelay-1.0.4.tar.gz
Algorithm Hash digest
SHA256 b5ffb8b9acb50ea50bccbe20bc20f678159965f5cad9efdd6bb815c18f4a1550
MD5 c30e4fcfb8a3b16cb992724203d02744
BLAKE2b-256 70a0df35326895253e9962d47f456f7d0718989f0e91de6fc74ffb605e4d428a

See more details on using hashes here.

File details

Details for the file pufferrelay-1.0.4-py3-none-any.whl.

File metadata

  • Download URL: pufferrelay-1.0.4-py3-none-any.whl
  • Upload date:
  • Size: 53.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for pufferrelay-1.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 68e6ce9d541a98e13d65d7d489088d86ccbaf21ad32f81cb3404ec1c35f8aa9e
MD5 79c6ec783509e7a9ddf64cbc6e6e74d8
BLAKE2b-256 4e71aa21d6c0c7f52ecc75f39fc5aa7a3ef647f1a1761c8aaec48215f4d5d526

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page