Add an invitation protocol.
authorGuus Sliepen <guus@tinc-vpn.org>
Wed, 29 May 2013 16:31:10 +0000 (18:31 +0200)
committerGuus Sliepen <guus@tinc-vpn.org>
Wed, 29 May 2013 16:31:10 +0000 (18:31 +0200)
commitced4c1a327b321a6d73028a3a15b41b0be64d910
tree2dd394e8d2754209d5dd89cfdf81fd19887ee46c
parent12e68b95e6a84582a016492a467d0a16337a3c4b
Add an invitation protocol.

Using the tinc command, an administrator of an existing VPN can generate
invitations for new nodes. The invitation is a small URL that can easily
be copy&pasted into email or live chat. Another person can have tinc
automatically setup the necessary configuration files and exchange keys
with the server, by only using the invitation URL.

The invitation protocol uses temporary ECDSA keys. The invitation URL
consists of the hostname and port of the server, a hash of the server's
temporary ECDSA key and a cookie. When the client wants to accept an
invitation, it also creates a temporary ECDSA key, connects to the server
and says it wants to accept an invitation. Both sides exchange their
temporary keys. The client verifies that the server's key matches the hash
in the invitation URL. After setting up an SPTPS connection using the
temporary keys, the client gives the cookie to the server. If the cookie
is valid, the server sends the client an invitation file containing the
client's new name and a copy of the server's host config file. If everything
is ok, the client will generate a long-term ECDSA key and send it to the
server, which will add it to a new host config file for the client.

The invitation protocol currently allows multiple host config files to be
send from the server to the client. However, the client filters out
most configuration variables for its own host configuration file. In
particular, it only accepts Name, Mode, Broadcast, ConnectTo, Subnet and
AutoConnect. Also, at the moment no tinc-up script is generated.

When an invitation has succesfully been accepted, the client needs to start
the tinc daemon manually.
13 files changed:
bash_completion.d/tinc
configure.ac
doc/tinc.8.in
doc/tinc.texi
src/Makefile.am
src/connection.h
src/invitation.c [new file with mode: 0644]
src/invitation.h [new file with mode: 0644]
src/net_setup.c
src/protocol.h
src/protocol_auth.c
src/tincctl.c
src/tincctl.h