2 * curvetun - the cipherspace wormhole creator
3 * Part of the netsniff-ng project
4 * By Daniel Borkmann <daniel@netsniff-ng.org>
5 * Copyright 2011 Daniel Borkmann <dborkma@tik.ee.ethz.ch>,
6 * Copyright 2011 Emmanuel Roullit.
7 * Subject to the GPL, version 2.
9 * This is curvetun, a lightweight, high-speed ECDH multiuser IP tunnel for
10 * Linux that is based on epoll(2). curvetun uses the Linux TUN/TAP interface
11 * and supports {IPv4,IPv6} over {IPv4,IPv6} with UDP or TCP as carrier
12 * protocols. It has an integrated packet forwarding trie, thus multiple
13 * users with different IPs can be handled via a single tunnel device on the
14 * server side and flows are scheduled for processing in a CPU-local manner.
15 * For transmission, packets are being compressed and encrypted by both, the
16 * client and the server side. As an appropriate key management, public-key
17 * cryptography based on elliptic curves are being used and packets are
18 * encrypted by a symmetric stream cipher (Salsa20) and authenticated by a MAC
19 * (Poly1305), where keys have previously been computed with the ECDH key
20 * agreement protocol (Curve25519). Cryptography is based on Daniel J.
21 * Bernsteins Networking and Cryptography library (NaCl).
23 * He used often to say there was only one Road; that it was like a great
24 * river: it's springs were at every doorstep and every path was it's
25 * tributary. "It's a dangerous business, Frodo, going out of your door,"
26 * he used to say. "You step into the Road, and if you don't keep your
27 * feet, there is no telling where you might be swept off to."
29 * -- The Lord of the Rings, Frodo about his uncle Bilbo Baggins,
30 * Chapter 'Three is Company'.
43 #include <sys/types.h>
45 #include <sys/socket.h>
46 #include <sys/ptrace.h>
47 #include <netinet/in.h>
56 #include "ct_usermgmt.h"
57 #include "ct_servmgmt.h"
60 #include "crypto_verify_32.h"
61 #include "crypto_box_curve25519xsalsa20poly1305.h"
62 #include "crypto_scalarmult_curve25519.h"
63 #include "crypto_auth_hmacsha512256.h"
65 #define CURVETUN_ENTROPY_SOURCE "/dev/random"
67 extern void print_stun_probe(char *server
, uint16_t sport
, uint16_t tunport
);
79 volatile sig_atomic_t sigint
= 0;
81 static const char *short_options
= "kxc::svhp:t:d:uCS46DN";
82 static const struct option long_options
[] = {
83 {"client", optional_argument
, NULL
, 'c'},
84 {"dev", required_argument
, NULL
, 'd'},
85 {"port", required_argument
, NULL
, 'p'},
86 {"stun", required_argument
, NULL
, 't'},
87 {"keygen", no_argument
, NULL
, 'k'},
88 {"export", no_argument
, NULL
, 'x'},
89 {"dumpc", no_argument
, NULL
, 'C'},
90 {"dumps", no_argument
, NULL
, 'S'},
91 {"no-logging", no_argument
, NULL
, 'N'},
92 {"server", no_argument
, NULL
, 's'},
93 {"udp", no_argument
, NULL
, 'u'},
94 {"ipv4", no_argument
, NULL
, '4'},
95 {"ipv6", no_argument
, NULL
, '6'},
96 {"nofork", no_argument
, NULL
, 'D'},
97 {"version", no_argument
, NULL
, 'v'},
98 {"help", no_argument
, NULL
, 'h'},
102 static void signal_handler(int number
)
113 static void header(void)
115 printf("%s%s%s\n", colorize_start(bold
), "curvetun "
116 VERSION_STRING
, colorize_end());
119 static void help(void)
121 printf("\n%s %s, lightweight curve25519-based VPN/IP tunnel\n",
122 PROGNAME_STRING
, VERSION_STRING
);
123 puts("http://www.netsniff-ng.org\n\n"
124 "Usage: curvetun [options]\n"
125 "Options, general:\n"
126 " -k|--keygen Generate public/private keypair\n"
127 " -x|--export Export your public data for remote servers\n"
128 " -C|--dumpc Dump parsed clients\n"
129 " -S|--dumps Dump parsed servers\n"
130 " -D|--nofork Do not daemonize\n"
131 " -d|--dev <tun> Networking tunnel device, e.g. tun0\n"
132 " -v|--version Print version\n"
133 " -h|--help Print this help\n"
134 " -c|--client[=alias] Client mode, server alias optional\n"
135 " -s|--server Server mode, options follow below\n"
136 " -N|--no-logging Disable server logging (for better anonymity)\n"
137 " -p|--port <num> Server port number (mandatory)\n"
138 " -t|--stun <server> Show public IP/Port mapping via STUN\n"
139 " -u|--udp Use UDP as carrier instead of TCP\n"
140 " -4|--ipv4 Tunnel devices are IPv4\n"
141 " -6|--ipv6 Tunnel devices are IPv6\n"
142 " (default: same as carrier protocol)\n\n"
144 " See Documentation/Curvetun for a configuration example.\n"
145 " curvetun --keygen\n"
146 " curvetun --export\n"
147 " curvetun --server -4 -u -N --port 6666 --stun stunserver.org\n"
148 " curvetun --client=ethz\n\n"
150 " There is no default port specified, so that you are forced\n"
151 " to select your own! For client/server status messages see syslog!\n"
152 " This software is an experimental prototype intended for researchers.\n\n"
153 "Secret ingredient: 7647-14-5\n\n"
154 "Please report bugs to <bugs@netsniff-ng.org>\n"
155 "Copyright (C) 2011-2012 Daniel Borkmann <dborkma@tik.ee.ethz.ch>,\n"
156 "License: GNU GPL version 2.0\n"
157 "This is free software: you are free to change and redistribute it.\n"
158 "There is NO WARRANTY, to the extent permitted by law.\n");
162 static void version(void)
164 printf("\n%s %s, lightweight curve25519-based VPN/IP tunnel\n",
165 PROGNAME_STRING
, VERSION_STRING
);
166 puts("http://www.netsniff-ng.org\n\n"
167 "Please report bugs to <bugs@netsniff-ng.org>\n"
168 "Copyright (C) 2011-2012 Daniel Borkmann <daniel@netsniff-ng.org>\n"
169 "License: GNU GPL version 2.0\n"
170 "This is free software: you are free to change and redistribute it.\n"
171 "There is NO WARRANTY, to the extent permitted by law.\n");
175 static void check_file_or_die(char *home
, char *file
, int maybeempty
)
180 memset(path
, 0, sizeof(path
));
181 slprintf(path
, sizeof(path
), "%s/%s", home
, file
);
184 panic("No such file %s! Type --help for further information\n",
187 if (!S_ISREG(st
.st_mode
))
188 panic("%s is not a regular file!\n", path
);
190 if ((st
.st_mode
& ~S_IFREG
) != (S_IRUSR
| S_IWUSR
))
191 panic("You have set too many permissions on %s (%o)!\n",
194 if (maybeempty
== 0 && st
.st_size
== 0)
195 panic("%s is empty!\n", path
);
198 static void check_config_exists_or_die(char *home
)
201 panic("No home dir specified!\n");
203 check_file_or_die(home
, FILE_CLIENTS
, 1);
204 check_file_or_die(home
, FILE_SERVERS
, 1);
205 check_file_or_die(home
, FILE_PRIVKEY
, 0);
206 check_file_or_die(home
, FILE_PUBKEY
, 0);
207 check_file_or_die(home
, FILE_USERNAM
, 0);
210 static char *fetch_home_dir(void)
212 char *home
= getenv("HOME");
214 panic("No HOME defined!\n");
218 static void write_username(char *home
)
221 char path
[PATH_MAX
], *eof
;
224 memset(path
, 0, sizeof(path
));
225 slprintf(path
, sizeof(path
), "%s/%s", home
, FILE_USERNAM
);
227 printf("Username: [%s] ", getenv("USER"));
230 memset(user
, 0, sizeof(user
));
231 eof
= fgets(user
, sizeof(user
), stdin
);
232 user
[sizeof(user
) - 1] = 0;
233 user
[strlen(user
) - 1] = 0; /* omit last \n */
234 if (strlen(user
) == 0)
235 strlcpy(user
, getenv("USER"), sizeof(user
));
237 fd
= open_or_die_m(path
, O_WRONLY
| O_CREAT
| O_TRUNC
, S_IRUSR
| S_IWUSR
);
239 ret
= write(fd
, user
, strlen(user
));
240 if (ret
!= strlen(user
))
241 panic("Could not write username!\n");
245 printf("Username written to %s!\n", path
);
248 static void create_curvedir(char *home
)
253 memset(path
, 0, sizeof(path
));
254 slprintf(path
, sizeof(path
), "%s/%s", home
, ".curvetun/");
258 ret
= mkdir(path
, S_IRWXU
);
259 if (ret
< 0 && errno
!= EEXIST
)
260 panic("Cannot create curvetun dir!\n");
262 printf("curvetun directory %s created!\n", path
);
263 /* We also create empty files for clients and servers! */
265 memset(path
, 0, sizeof(path
));
266 slprintf(path
, sizeof(path
), "%s/%s", home
, FILE_CLIENTS
);
268 create_or_die(path
, S_IRUSR
| S_IWUSR
);
270 printf("Empty client file written to %s!\n", path
);
272 memset(path
, 0, sizeof(path
));
273 slprintf(path
, sizeof(path
), "%s/%s", home
, FILE_SERVERS
);
275 create_or_die(path
, S_IRUSR
| S_IWUSR
);
277 printf("Empty server file written to %s!\n", path
);
280 static void create_keypair(char *home
)
284 unsigned char publickey
[crypto_box_curve25519xsalsa20poly1305_PUBLICKEYBYTES
] = { 0 };
285 unsigned char secretkey
[crypto_box_curve25519xsalsa20poly1305_SECRETKEYBYTES
] = { 0 };
287 const char * errstr
= NULL
;
289 printf("Reading from %s (this may take a while) ...\n", CURVETUN_ENTROPY_SOURCE
);
291 fd
= open_or_die(CURVETUN_ENTROPY_SOURCE
, O_RDONLY
);
293 ret
= read_exact(fd
, secretkey
, sizeof(secretkey
), 0);
294 if (ret
!= sizeof(secretkey
)) {
296 errstr
= "Cannot read from "CURVETUN_ENTROPY_SOURCE
"!\n";
302 crypto_scalarmult_curve25519_base(publickey
, secretkey
);
304 memset(path
, 0, sizeof(path
));
305 slprintf(path
, sizeof(path
), "%s/%s", home
, FILE_PUBKEY
);
307 fd
= open(path
, O_WRONLY
| O_CREAT
| O_TRUNC
, S_IRUSR
| S_IWUSR
);
310 errstr
= "Cannot open pubkey file!\n";
314 ret
= write(fd
, publickey
, sizeof(publickey
));
315 if (ret
!= sizeof(publickey
)) {
317 errstr
= "Cannot write public key!\n";
323 printf("Public key written to %s!\n", path
);
325 memset(path
, 0, sizeof(path
));
326 slprintf(path
, sizeof(path
), "%s/%s", home
, FILE_PRIVKEY
);
328 fd
= open(path
, O_WRONLY
| O_CREAT
| O_TRUNC
, S_IRUSR
| S_IWUSR
);
331 errstr
= "Cannot open privkey file!\n";
335 ret
= write(fd
, secretkey
, sizeof(secretkey
));
336 if (ret
!= sizeof(secretkey
)) {
338 errstr
= "Cannot write private key!\n";
344 xmemset(publickey
, 0, sizeof(publickey
));
345 xmemset(secretkey
, 0, sizeof(secretkey
));
348 panic("%s: %s", errstr
, strerror(errno
));
350 printf("Private key written to %s!\n", path
);
353 static void check_config_keypair_or_die(char *home
)
357 const char * errstr
= NULL
;
358 unsigned char publickey
[crypto_box_curve25519xsalsa20poly1305_PUBLICKEYBYTES
];
359 unsigned char publicres
[crypto_box_curve25519xsalsa20poly1305_PUBLICKEYBYTES
];
360 unsigned char secretkey
[crypto_box_curve25519xsalsa20poly1305_SECRETKEYBYTES
];
363 memset(path
, 0, sizeof(path
));
364 slprintf(path
, sizeof(path
), "%s/%s", home
, FILE_PRIVKEY
);
366 fd
= open(path
, O_RDONLY
);
369 errstr
= "Cannot open privkey file!\n";
373 ret
= read(fd
, secretkey
, sizeof(secretkey
));
374 if (ret
!= sizeof(secretkey
)) {
376 errstr
= "Cannot read private key!\n";
382 memset(path
, 0, sizeof(path
));
383 slprintf(path
, sizeof(path
), "%s/%s", home
, FILE_PUBKEY
);
385 fd
= open(path
, O_RDONLY
);
388 errstr
= "Cannot open pubkey file!\n";
392 ret
= read(fd
, publickey
, sizeof(publickey
));
393 if (ret
!= sizeof(publickey
)) {
395 errstr
= "Cannot read public key!\n";
399 crypto_scalarmult_curve25519_base(publicres
, secretkey
);
401 err
= crypto_verify_32(publicres
, publickey
);
404 errstr
= "WARNING: your keypair is corrupted!!! You need to "
405 "generate new keys!!!\n";
411 xmemset(publickey
, 0, sizeof(publickey
));
412 xmemset(publicres
, 0, sizeof(publicres
));
413 xmemset(secretkey
, 0, sizeof(secretkey
));
416 panic("%s: %s\n", errstr
, strerror(errno
));
419 static int main_keygen(char *home
)
421 create_curvedir(home
);
422 write_username(home
);
423 create_keypair(home
);
424 check_config_keypair_or_die(home
);
429 static int main_export(char *home
)
433 char path
[PATH_MAX
], tmp
[64];
435 check_config_exists_or_die(home
);
436 check_config_keypair_or_die(home
);
438 printf("Your exported public information:\n\n");
440 memset(path
, 0, sizeof(path
));
441 slprintf(path
, sizeof(path
), "%s/%s", home
, FILE_USERNAM
);
443 fd
= open_or_die(path
, O_RDONLY
);
445 while ((ret
= read(fd
, tmp
, sizeof(tmp
))) > 0) {
446 ret
= write(STDOUT_FILENO
, tmp
, ret
);
453 memset(path
, 0, sizeof(path
));
454 slprintf(path
, sizeof(path
), "%s/%s", home
, FILE_PUBKEY
);
456 fd
= open_or_die(path
, O_RDONLY
);
458 ret
= read(fd
, tmp
, sizeof(tmp
));
459 if (ret
!= crypto_box_curve25519xsalsa20poly1305_PUBLICKEYBYTES
)
460 panic("Cannot read public key!\n");
462 for (i
= 0; i
< ret
; ++i
)
464 printf("%02x\n\n", (unsigned char) tmp
[i
]);
466 printf("%02x:", (unsigned char) tmp
[i
]);
474 static int main_dumpc(char *home
)
476 check_config_exists_or_die(home
);
477 check_config_keypair_or_die(home
);
479 printf("Your clients:\n\n");
481 parse_userfile_and_generate_user_store_or_die(home
);
485 destroy_user_store();
492 static int main_dumps(char *home
)
494 check_config_exists_or_die(home
);
495 check_config_keypair_or_die(home
);
497 printf("Your servers:\n\n");
499 parse_userfile_and_generate_serv_store_or_die(home
);
503 destroy_serv_store();
510 static void daemonize(const char *lockfile
)
513 mode_t lperm
= S_IRWXU
| S_IRGRP
| S_IXGRP
; /* 0750 */
520 panic("Cannot daemonize: %s", strerror(errno
));
524 lfp
= open(lockfile
, O_RDWR
| O_CREAT
| O_EXCL
,
525 S_IRUSR
| S_IWUSR
| S_IRGRP
);
527 syslog_panic("Cannot create lockfile at %s! "
528 "curvetun server already running?\n",
531 slprintf(pidstr
, sizeof(pidstr
), "%u", getpid());
532 if (write(lfp
, pidstr
, strlen(pidstr
)) <= 0)
533 syslog_panic("Could not write pid to pidfile %s",
540 static int main_client(char *home
, char *dev
, char *alias
, int daemon
)
545 check_config_exists_or_die(home
);
546 check_config_keypair_or_die(home
);
548 parse_userfile_and_generate_serv_store_or_die(home
);
550 get_serv_store_entry_by_alias(alias
, alias
? strlen(alias
) + 1 : 0,
552 if (!host
|| !port
|| udp
< 0)
553 panic("Did not find alias/entry in configuration!\n");
555 printf("Using [%s] -> %s:%s via %s as endpoint!\n",
556 alias
? : "default", host
, port
, udp
? "udp" : "tcp");
560 ret
= client_main(home
, dev
, host
, port
, udp
);
562 destroy_serv_store();
567 static int main_server(char *home
, char *dev
, char *port
, int udp
,
568 int ipv4
, int daemon
, int log
)
572 check_config_exists_or_die(home
);
573 check_config_keypair_or_die(home
);
578 ret
= server_main(home
, dev
, port
, udp
, ipv4
, log
);
585 int main(int argc
, char **argv
)
587 int ret
= 0, c
, opt_index
, udp
= 0, ipv4
= -1, daemon
= 1, log
= 1;
588 char *port
= NULL
, *stun
= NULL
, *dev
= NULL
, *home
= NULL
, *alias
= NULL
;
589 enum working_mode wmode
= MODE_UNKNOW
;
591 if (getuid() != geteuid())
594 home
= fetch_home_dir();
596 while ((c
= getopt_long(argc
, argv
, short_options
, long_options
,
597 &opt_index
)) != EOF
) {
622 alias
= xstrdup(optarg
);
626 dev
= xstrdup(optarg
);
647 stun
= xstrdup(optarg
);
650 port
= xstrdup(optarg
);
658 panic("Option -%c requires an argument!\n",
662 whine("Unknown option character "
663 "`0x%X\'!\n", optopt
);
674 register_signal(SIGINT
, signal_handler
);
675 register_signal(SIGHUP
, signal_handler
);
676 register_signal(SIGTERM
, signal_handler
);
677 register_signal(SIGPIPE
, signal_handler
);
681 curve25519_selftest();
685 ret
= main_keygen(home
);
688 ret
= main_export(home
);
691 ret
= main_dumpc(home
);
694 ret
= main_dumps(home
);
697 ret
= main_client(home
, dev
, alias
, daemon
);
701 panic("No port specified!\n");
703 print_stun_probe(stun
, 3478, strtoul(port
, NULL
, 10));
704 ret
= main_server(home
, dev
, port
, udp
, ipv4
, daemon
, log
);