blob: 4e4deaa7f5a6b355ae9ddbd14a2131a501f43e6a (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
|
# Dynamic IP address allocation
## Server
The wg-dynamic server is a daemon responsible for handing out IP
addresses in form of leases to wg-dynamic clients requesting them.
### Address allocation
The pool of available addresses is made up of the list of addresses
that are part of the prefixes being routed over the wg
interface. Leases are picked uniformly random from this pool and
handed out to wg-dynamic clients upon request.
A client including an IP address in a request is granted that address
if and only if this address is already assigned to the
client. Specifically, a request for an IP address which is not
allocated to the client requesting it is _not_ assigned this address
but is instead assigned an address by random.
TODO: lease time
## Client
The wg-dynamic client is a daemon responsible for requesting IP
address leases from a wg-dynamic server, for a given wg
interface. Requests for leases are sent over the same wg interface to
a server on a well known IPv6 link local address and well known low
TCP port. A lease has at least one IP address and has at most one IPv4
address and at most one IPv6 address.
### Security
TODO: guaranteed to be sent only to and received only from the server
endpoint
TODO: no routing information is being accepted, eg only accepting /32
and /128 addresses
### Single lease
Clients keep track of exactly one lease, active or inactive. At
inception time, clients assume at most one global IPv4 and one global
IPv6 address configured for the wg interface to be part of a lease
valid for 15 seconds.
Addresses received in a lease are being added to the wg
interface. Addresses in an expired lease are being removed from the wg
interface.
## Protocol
Example:
client -> server: request_ip=1\n\n
server -> client: request_ip=1\nipv4=192.168.47.11/32\n\n
|
