Skip to content
Snippets Groups Projects
Commit 0f038ca4 authored by Yawning Angel's avatar Yawning Angel
Browse files

Document the obfs4 NaCl secretbox nonce generation.

Forgot to include this in the spec, though it was documented as a
comment in the framing code.
parent cdeda572
No related branches found
No related tags found
No related merge requests found
......@@ -269,6 +269,17 @@
The maximum allowed frame length is 1448 bytes, which allows up to 1427
bytes of useful payload to be transmitted per "frame".
The NaCl secretbox (Poly1305/XSalsa20) nonce format is:
uint8_t[24] prefix (Fixed)
uint64_t counter (Big endian)
The counter is initialized to 1, and is incremented on each frame. Since
the protocol is designed to be used over a reliable medium, the nonce is not
transmitted over the wire as both sides of the conversation know the prefix
and the initial counter value. It is imperative that the counter does not
wrap, and sessions MUST terminate before 2^64 frames are sent.
If unsealing a secretbox ever fails (due to a Tag mismatch), implementations
MUST drop the connection.
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment