Expand description
Security 2: Message Encapsulation, extensions, and the SPAN and MPAN nonce state.
A S2Manager holds the network keys, the per-peer singlecast state
(SPAN) and the multicast state (MPAN) for one node, which is the
controller in a host stack and the simulated node in a simulator. It
builds and consumes the Security 2 frames whose contents are crypto (Nonce
Get, Nonce Report, Message Encapsulation); the key exchange commands are
ordinary command classes.
Nonces: the receiver sends a Nonce Report carrying its receiver entropy input (REI) when it cannot decrypt, the sender answers with its sender entropy input (SEI) in a SPAN extension, and from then on both ends draw nonces in lockstep from a CTR_DRBG seeded by both inputs and the key’s personalization string.
Modules§
- cmd
- Security 2 command ids.
Structs§
- Decrypted
- A decrypted Message Encapsulation.
- Encapsulation
- The unencrypted parts of a Message Encapsulation.
- Encrypt
Options - Options for one outgoing encapsulation.
- Nonce
Report - A Nonce Report as received.
- S2Manager
- Security 2 state for one node: keys, SPANs, MPANs and sequence numbers.
Enums§
- Extension
- A Security 2 Message Encapsulation extension.
- KeyId
- Which key a frame was (or is to be) protected with.
Constants§
- CC_
SECURITY_ 2 - The Security 2 command class id.
- MAX_
DECRYPT_ ATTEMPTS - How many successive SPAN nonces a receiver tries before asking for a resync.