Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

JA3S patch #74

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open

JA3S patch #74

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ebf6893
TLSServerHello.cipher_suite is deprecated and renamed to .ciphersuite
thegwan Mar 3, 2022
80b7ce4
use integer ID code of chosen ciphersuite instead of the object name
thegwan Mar 3, 2022
77ff039
ja3 --> ja3s
thegwan Mar 3, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 16 additions & 16 deletions python/ja3s.py
100644 → 100755
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
#!/usr/bin/env python
"""Generate JA3 fingerprints from PCAPs using Python."""
"""Generate JA3S fingerprints from PCAPs using Python."""

import argparse
import dpkt
Expand Down Expand Up @@ -36,10 +36,10 @@ def convert_ip(value):


def process_extensions(server_handshake):
"""Process any extra extensions and convert to a JA3 segment.
"""Process any extra extensions and convert to a JA3S segment.

:param client_handshake: Handshake data from the packet
:type client_handshake: dpkt.ssl.TLSClientHello
:param server_handshake: Handshake data from the packet
:type server_handshake: dpkt.ssl.TLSServerHello
:returns: list
"""
if not hasattr(server_handshake, "extensions"):
Expand Down Expand Up @@ -128,31 +128,31 @@ def process_pcap(pcap, any_port=False):
continue

server_handshake = handshake.data
ja3 = [str(server_handshake.version)]
ja3s = [str(server_handshake.version)]

# Cipher Suites (16 bit values)
ja3.append(str(server_handshake.cipher_suite))
ja3 += process_extensions(server_handshake)
ja3 = ",".join(ja3)
# Chosen Cipher Suite (16 bit values)
ja3s.append(str(server_handshake.ciphersuite.code))
ja3s += process_extensions(server_handshake)
ja3s = ",".join(ja3s)

record = {"source_ip": convert_ip(ip.src),
"destination_ip": convert_ip(ip.dst),
"source_port": tcp.sport,
"destination_port": tcp.dport,
"ja3": ja3,
"ja3_digest": md5(ja3.encode()).hexdigest(),
"ja3s": ja3s,
"ja3s_digest": md5(ja3s.encode()).hexdigest(),
"timestamp": timestamp}
results.append(record)

return results


def main():
"""Intake arguments from the user and print out JA3 output."""
desc = "A python script for extracting JA3 fingerprints from PCAP files"
"""Intake arguments from the user and print out JA3s output."""
desc = "A python script for extracting JA3s fingerprints from PCAP files"
parser = argparse.ArgumentParser(description=(desc))
parser.add_argument("pcap", help="The pcap file to process")
help_text = "Look for client hellos on any port instead of just 443"
help_text = "Look for server hellos on any port instead of just 443"
parser.add_argument("-a", "--any_port", required=False,
action="store_true", default=False,
help=help_text)
Expand Down Expand Up @@ -184,8 +184,8 @@ def main():
tmp = '[{dest}:{port}] JA3S: {segment} --> {digest}'
tmp = tmp.format(dest=record['destination_ip'],
port=record['destination_port'],
segment=record['ja3'],
digest=record['ja3_digest'])
segment=record['ja3s'],
digest=record['ja3s_digest'])
print(tmp)


Expand Down