node-dtls-proxy

Node.js DTLS Proxy, library and tools to connect plain-text UDP clients with plain-text UDP servers over an encrypted tunnel..


Requirements

- nodejs version 4 or higher
- npm

$3

``
$ sudo apt-get install nodejs nodejs-legacy npm
`

$3

`
$ node --version
`

$3

`
wget -qO- https://deb.nodesource.com/setup_4.x | sudo bash -
sudo apt-get install nodejs
`

Package Installation

#### From npm
`
$ npm install -g node-dtls-proxy
`

#### From Source

`
$ git clone https://github.com/m4n3dw0lf/node-dtls-proxy
$ cd node-dtls-proxy
$ sudo npm install -g
$ openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout cert.key -out cert.crt -subj '/CN=node-dtls-proxy/O=m4n3dw0lf/C=BR'
`

Example

- Create 2 VMs, one for the Server and one for the Client and install the package.

$3

- On a terminal
`
$ dtls2udp

e.g:

$ dtls2udp 5684 5685 localhost 5683
`

- On another terminal
`
$ node examples/server/udp_server.js
`

$3

- On a terminal
`
$ udp2dtls

e.g:

$ udp2dtls 5687 localhost 5684
`

- On another terminal
`
$ node examples/client/udp_client.js
`

Docker-Compose Example

$3

> NOTE: remember to generate the certificate and key pair

this will start the dtls2udp and udp2dtls proxies.

for real scenarios, you will need to split the dtls2udp service in one server and the udp2dtls service to the other server.

$3

`
$ node examples/server/udp_server.js
`

$3

`
$ node examples/client/udp_client.js
`

$3

`
udp2dtls | [+] Starting UDP2DTLS Proxy
dtls2udp | [+] Starting DTLS2UDP Proxy
udp2dtls | UDP Server listening on port: 5687
dtls2udp | DTLS Server listening on port: 5684
dtls2udp | UDP Server listening on port: 5685
dtls2udp | Got a DTLS Connection from: 127.0.0.1:55209
udp2dtls | Encrypting UDP message from: 127.0.0.1:41585 and forwarding to DTLS2UDP endpoint
dtls2udp | Decrypting DTLS message from: 127.0.0.1:55209 and forwarding to UDP endpoint
dtls2udp | Encrypting UDP response from: 127.0.0.1:5683 and forwarding to UDP2DTLS endpoint
udp2dtls | Decrypting DTLS message and forwarding to UDP client: 127.0.0.1:41585
``