Skip to main content

Module s2

Module s2 

Source
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.
EncryptOptions
Options for one outgoing encapsulation.
NonceReport
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.