document that nonce-based authentication is for the future
[hippotat] / PROTOCOL
CommitLineData
3fba9787
IJ
1Server maintains a queue of outbound packets for each user
2
ca732796 3Packets which are older than the applicable max_queue_time are discarded
3fba9787 4
ca732796 5Each incoming request to the server takes up to max_batch_down bytes
3fba9787
IJ
6from the queue and returns them as the POST response body payload
7
ca732796 8Each incoming request contains up to max_batch_up bytes of payload.
3fba9787
IJ
9It's a multipart/form-data.
10
11Authentication: for now, plaintext password
12
0c8302b2
IJ
13Routing assistance: none in hippotat; can be requested on client
14 from userv-ipif via `vroutes' parameter. Use with secnet polypath
15 ideally uses the special support in secnet 0.4.x.
3fba9787 16
ca732796
IJ
17Client form parameters (multipart/form-data):
18 m metadata, newline-separated list (text file) of
19 client ip address (textual)
20 password
21 target_requests_outstanding
eb6eb974 22 http_timeout
7b07f0b5 23 d data (SLIP format, with SLIP_ESC and `-' swapped)
1672ded0
IJ
24
25
26
a2b48abf
IJ
27
28Possible future nonce-based authentication:
1672ded0
IJ
29
30server keeps big nonce counter for each client
31meaning is:
32 nonce counter is most recent nonce client has sent
33also server keeps bitmap of the previous ?64 nonces,
34 whether client has sent them
35
36client picks.... xxx