2019-02-20 10:33:38 +01:00
|
|
|
<p align="center">
|
|
|
|
|
<img alt="sensor-d4-tls-fingerprinting" src="https://raw.githubusercontent.com/D4-project/sensor-d4-tls-fingerprinting/master/media/gopherd4.png" height="140" />
|
|
|
|
|
<p align="center">
|
|
|
|
|
<a href="https://github.com/D4-project/sensor-d4-tls-fingerprinting/releases/latest"><img alt="Release" src="https://img.shields.io/github/release/D4-project/sensor-d4-tls-fingerprinting/all.svg"></a>
|
|
|
|
|
<a href="https://github.com/D4-project/sensor-d4-tls-fingerprinting/blob/master/LICENSE"><img alt="Software License" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
|
|
|
|
|
<a href="https://goreportcard.com/report/github.com/D4-Project/sensor-d4-tls-fingerprinting"><img alt="Go Report Card" src="https://goreportcard.com/badge/github.com/D4-Project/sensor-d4-tls-fingerprinting"></a>
|
|
|
|
|
</p>
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
**sensor-d4-tls-fingerprinting** is intended to be used to feed a D4 project client (It can be used in standalone though).
|
|
|
|
|
|
|
|
|
|
# Main features
|
|
|
|
|
|
|
|
|
|
* extracts TLS certificates from pcap files or network interfaces
|
|
|
|
|
* fingerprints TLS client/server interactions with ja3/ja3s
|
|
|
|
|
* fingerprints TLS interactions with TLSH fuzzy hashing
|
|
|
|
|
* write certificates in a folder
|
|
|
|
|
* export in JSON to files, or stdout
|
|
|
|
|
|
2019-01-23 14:41:30 +01:00
|
|
|
# Use
|
2019-02-20 10:33:38 +01:00
|
|
|
This project is currently in development and is subject to change, check the list of issues.
|
|
|
|
|
|
|
|
|
|
## Compile from source
|
|
|
|
|
### requirements
|
|
|
|
|
* git
|
|
|
|
|
* golang >= 1.5
|
|
|
|
|
* libpcap
|
|
|
|
|
|
|
|
|
|
``` shell
|
|
|
|
|
#apt install golang git libpcap-dev
|
|
|
|
|
```
|
|
|
|
|
### Go get
|
|
|
|
|
|
2019-01-23 14:41:30 +01:00
|
|
|
``` shell
|
|
|
|
|
$go get github.com/D4-project/sensor-d4-tls-fingerprinting
|
2019-02-20 10:33:38 +01:00
|
|
|
$cd $GOPATH/github.com/D4-project/sensor-d4-tls-fingerprinting
|
|
|
|
|
$
|
2019-01-23 14:41:30 +01:00
|
|
|
```
|
2019-02-20 10:33:38 +01:00
|
|
|
A "sensor-d4-tls-fingerprinting" compiled for your architecture should then be in $GOPATH/bin
|
|
|
|
|
Alternatively, use make to compile arm/linux or amd64/linux
|
|
|
|
|
|
2019-01-23 14:41:30 +01:00
|
|
|
## How to use
|
2019-01-29 17:10:50 +01:00
|
|
|
|
|
|
|
|
Read from pcap:
|
|
|
|
|
``` shell
|
|
|
|
|
$ ./d4-tlsf-amd64l -r=file
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
Read from interface (promiscious mode):
|
|
|
|
|
``` shell
|
|
|
|
|
$ ./d4-tlsf-amd64l -i=interface
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
Write x509 certificates to folder:
|
|
|
|
|
``` shell
|
|
|
|
|
$ ./d4-tlsf-amd64l -w=folderName
|
|
|
|
|
```
|
|
|
|
|
Write output json inside folder
|
|
|
|
|
|
|
|
|
|
``` shell
|
|
|
|
|
$ ./d4-tlsf-amd64l -j=folderName
|
|
|
|
|
```
|
