pub struct CaseAuthenticatedTag(pub u32);Expand description
A CASE Authenticated Tag: an access-control subject shared by a group of nodes (Core §6.6.2.1.2).
A CAT is carried in a node’s operational certificate, so “the administrative root of trust does chain back through the individual source Node to the Fabric’s trusted root”. That is what makes it unlike a group key: group-like addressing, with per-node attribution intact.
The 32 bits are two halves. The upper 16 name the tag; the lower 16 are a version an administrator bumps whenever the set of nodes holding the tag changes, so that an access-control entry written against version 3 does not silently admit a node that was granted version 2 and has since been removed.
Tuple Fields§
§0: u32Implementations§
Source§impl CaseAuthenticatedTag
impl CaseAuthenticatedTag
Sourcepub const ADMINISTRATOR_IDENTIFIER: u16 = 0xFFFF
pub const ADMINISTRATOR_IDENTIFIER: u16 = 0xFFFF
0xFFFF — the Administrator identifier, reserved to the Joint Fabric (§12.2.4.1).
Sourcepub const ANCHOR_IDENTIFIER: u16 = 0xFFFE
pub const ANCHOR_IDENTIFIER: u16 = 0xFFFE
0xFFFE — the Anchor identifier, reserved to the Joint Fabric (§12.2.4.2).
Sourcepub const GENERAL_IDENTIFIER_MAX: u16 = 0xEFFF
pub const GENERAL_IDENTIFIER_MAX: u16 = 0xEFFF
The last identifier “generally available”; 0xF000..=0xFFFD is reserved.
Sourcepub const fn identifier(self) -> u16
pub const fn identifier(self) -> u16
The upper 16 bits, which “uniquely identifies a CAT”.
Sourcepub const fn is_valid(self) -> bool
pub const fn is_valid(self) -> bool
Whether the version is usable: “Version number is a monotonically increasing natural number in the range of 1 to 65535. A version number of 0 is invalid.”
Sourcepub const fn to_node_id(self) -> NodeId
pub const fn to_node_id(self) -> NodeId
The Node ID sub-encoding a CAT takes in an access-control entry’s Subjects list:
the tag with 0xFFFF_FFFD above it (§6.6.2.1.2).
“Note that this encoding cannot appear as an operational Node ID.”
Sourcepub const fn from_node_id(node_id: NodeId) -> Option<Self>
pub const fn from_node_id(node_id: NodeId) -> Option<Self>
Recovers a CAT from that sub-encoding, or None if the Node ID is not one.