Skip to content

Python program that calculate ja3, match with your JA3Blacklist and can block malicious connections. Type -help for INFO.

Notifications You must be signed in to change notification settings

Mic52M/JA3Block-Check

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 

Repository files navigation

JA3Block-Check Python Status License

Realtime & offline TLS fingerprint analysis and blacklist blocking 🔒🚦


✨ Overview

JA3Block-Check is a powerful Python tool that captures and analyzes TLS packets in real time and from pcap files, focusing on fingerprinting Client Hello and Server Hello messages to detect threats and security anomalies in encrypted traffic.


🚀 Features

  • 🕵️‍♂️ Real-time packet capture and live analysis
  • 📦 Offline support: analyze pcap files
  • Customizable output: stdout or file, JSON format for easy integration
  • 🗂️ Customizable JA3 blacklist (sslbl JA3 fingerprints)
  • Block malicious connections via iptables
  • 🧑‍💻 Compatibility: Python 3.x, Scapy, Colorama

🛠 Installation

git clone https://github.com/Mic52M/JA3Block-Check.git cd JA3Block-Check pip install -r requirements.txt


⚡ Usage

Online Mode

python JA3Script.py -i Any --json --savepcap -pf output

text

  • -i: network interface ("Any" for all)
  • --json: JSON output
  • --savepcap: save raw packets
  • -pf: output pcap file prefix

Offline Mode

python JA3Script.py -f input.pcap --json --savepcap -pf output

  • -f: path to the pcap file

Advanced Options

  • -jtype: "ja3", "ja3s", "all" (default: all)
  • --ja3blacklist: path to JA3 blacklist file
  • --IPblacklist: path to IP blacklist file

Examples

Live scan, JSON output, save pcap files python JA3Script.py -i Any --json --savepcap -pf results

Analyze a previously captured pcap python JA3Script.py -f traffic.pcap


📂 Project Structure

  • JA3Script.py: main script, CLI parser, core logic
  • requirements.txt: dependencies (Scapy, Colorama, etc.)
  • README.md: documentation

🏷️ Tags

#TLS #fingerprinting #JA3 #network-security #pcap #python #Infosec #iptables #cybersecurity #real-time #offline


🖼️ Badges

  • Build
  • Contributions
  • License
  • Last-Commit

📚 Resources


👨‍💻 Author

Mic52M

Cybersecurity Researcher.


⚖️ License

MIT License - see LICENSE for details.

About

Python program that calculate ja3, match with your JA3Blacklist and can block malicious connections. Type -help for INFO.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages