d4-goclient/README.md

# d4-goclient

A D4 project client (sensor) implementing the [D4 encapsulation protocol](https://github.com/D4-project/architecture/tree/master/format).

The client can be used on different targets and architectures to collect network capture, logs, specific network monitoring and send it
back to a [D4 server](https://github.com/D4-project/d4-core).

For more information about the [D4 project](https://www.d4-project.org/).

# Installation

Fetch d4-goclient code and dependencies

```bash
go get github.com/satori/go.uuid
go get github.com/D4-project/d4-goclient
```

Use make to build binaries:

```bash
make arm5l  # for raspberry pi / linux
make amd64l # for amd64 / linux
```

## Dependencies

 - golang 1.10 (tested)
 - go.uuid

# Use

## Launch a d4-server (if you don't have a server)

See https://github.com/D4-project/d4-core/tree/master/server
$IP_SRV being the d4-server's address, $PORT its listening port

## Pipe data into the client

### Some file
```bash
cat /proc/cpuinfo | ./d4-goclient -c conf.sample/ |  socat - OPENSSL-CONNECT:$IP_SRV:$PORT,verify=0
```

### tcpdump (libpcap) output, discarding our own traffic
$IP being the monitoring computer ip
```bash
tcpdump not dst $IP and not src $IP -w - | ./d4-goclient -c conf.sample/ |  socat - OPENSSL-CONNECT:$IP_SRV:$PORT,verify=0
```