Skip to main content

SecurityLabel

Struct SecurityLabel 

pub struct SecurityLabel {
    pub level: Level,
    pub assurance: Assurance,
    pub compartments: CompartmentSet,
}
Expand description

A complete security label: a point in the product lattice Level × Assurance × CompartmentSet.

The same type is used for an object’s classification and a subject’s clearance (a clearance is just a label the subject is allowed to read up to). Dominance and join are defined on the inherent SecurityLabel::can_access / SecurityLabel::join helpers below — note those helpers encode the fixed product-lattice algebra and are independent of any site policy (the policy in [super::lattice::Lattice] only constrains which labels are well-formed/known, never how they compare).

Copy + Ord + Hash (compartments are a packed [CompartmentSet] bitset, not a heap set) so S4’s AVC (#570) can key on a label directly — and so two equal labels serialize identically, which content-binding (manifest hash) and the (UCAN, bundle_hash) approval (S5) require.

Fields§

§level: Level

MLS sensitivity level (total order).

§assurance: Assurance

Crypto-assurance required to handle this label (total order, #548).

§compartments: CompartmentSet

Need-to-know compartments as a fixed bitset (powerset lattice under ⊆).

Implementations§

§

impl SecurityLabel

pub fn new( level: Level, assurance: Assurance, compartments: CompartmentSet, ) -> SecurityLabel

Construct a label from its axes. There is intentionally no Default — every label must be chosen explicitly so “unlabeled” can never silently mean “public”.

pub fn from_bits( level: Level, assurance: Assurance, bits: impl IntoIterator<Item = u32>, ) -> SecurityLabel

Construct a label from compartment bit indices (e.g. resolved from names by the policy). Out-of-range indices are dropped (fail-closed).

pub const fn bottom() -> SecurityLabel

The fail-closed label (Public, Unverified, {}).

This is deliberately distinct from the identity for provenance joins: the Biba assurance axis joins with min, whose identity is PqHybrid. In particular, an empty provenance set must remain unverified rather than acquire the join identity’s top assurance.

pub fn is_bottom(&self) -> bool

Whether this label is the lattice bottom.

pub fn can_access(&self, object: &SecurityLabel) -> bool

May a subject with this clearance access an object labelled object?

This is the Bell–LaPadula dominance relation — clearance self dominates the object label (self ⊒ object) iff, on every axis, the subject is at least the object:

  • self.level >= object.level (no read-up)
  • self.assurance >= object.assurance (#548 crypto-assurance axis)
  • object.compartments ⊆ self.compartments (cleared into all categories)

The assurance field is currently overloaded: here it is an authentication- strength gate, while provenance joining treats it as Biba integrity. Keep this gate unchanged pending the field-separation/proof follow-up in #1232.

The per-op MAC floor (design §3, §10): the fixed product-lattice order, content truth, never overridable by a token/UCAN/grant.

pub fn can_write_to(&self, object: &SecurityLabel) -> bool

Bell–LaPadula *-property (confinement / no-write-down): may a subject with clearance self write to an object labelled object?

The write-direction dual of can_access. A subject may write only to objects at least as restrictive as its own clearance — preventing a high-level subject from leaking secrets to a lower-level object:

  • object.level >= self.level (no-write-down)
  • self.assurance >= object.assurance (crypto floor is NOT flipped — you cannot write to a higher-assurance object than your key proves)
  • self.compartments.is_subset(object.compartments) (no compartment write-down: the target must be at least as compartmented as the writer)

The assurance axis intentionally does not flip: it is a crypto-authentication floor on both read and write, not a confidentiality axis. This is conservative — it tightens rather than relaxes the gate. See the assurance-axis overload note on can_access and #1232.

pub fn join(&self, other: &SecurityLabel) -> SecurityLabel

IFC provenance join over confidentiality, integrity, and compartments.

a ⊔ b = (max(level), min(assurance), union(compartments)): secrecy rises to the most restrictive input, while provenance integrity degrades to its weakest link. Associative, commutative, and idempotent.

pub fn join_all<'a>( labels: impl IntoIterator<Item = &'a SecurityLabel>, ) -> SecurityLabel

Fold the IFC join over a set of input labels (provenance-DAG join).

Non-empty inputs fold from the per-axis identity (Public, PqHybrid, {}). Empty provenance instead returns the fail-closed bottom() label, never the top-assurance identity.

Trait Implementations§

§

impl Clone for SecurityLabel

§

fn clone(&self) -> SecurityLabel

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
§

impl Debug for SecurityLabel

§

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter. Read more
§

impl<'de> Deserialize<'de> for SecurityLabel

§

fn deserialize<__D>( __deserializer: __D, ) -> Result<SecurityLabel, <__D as Deserializer<'de>>::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
§

impl Display for SecurityLabel

§

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter. Read more
§

impl Hash for SecurityLabel

§

fn hash<__H>(&self, state: &mut __H)
where __H: Hasher,

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
§

impl Ord for SecurityLabel

§

fn cmp(&self, other: &SecurityLabel) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 (const: unstable) · Source§

fn max(self, other: Self) -> Self
where Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 (const: unstable) · Source§

fn min(self, other: Self) -> Self
where Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 (const: unstable) · Source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized,

Restrict a value to a certain interval. Read more
§

impl PartialEq for SecurityLabel

§

fn eq(&self, other: &SecurityLabel) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
§

impl PartialOrd for SecurityLabel

§

fn partial_cmp(&self, other: &SecurityLabel) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more
1.0.0 (const: unstable) · Source§

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 (const: unstable) · Source§

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 (const: unstable) · Source§

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 (const: unstable) · Source§

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator. Read more
§

impl Serialize for SecurityLabel

§

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
§

impl Copy for SecurityLabel

§

impl Eq for SecurityLabel

§

impl StructuralPartialEq for SecurityLabel

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
§

impl<Q, K> Comparable<K> for Q
where Q: Ord + ?Sized, K: Borrow<Q> + ?Sized,

§

fn compare(&self, key: &K) -> Ordering

Compare self to key and return their ordering.
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
§

impl<T> ServiceExt for T

§

fn map_response_body<F>(self, f: F) -> MapResponseBody<Self, F>
where Self: Sized,

Apply a transformation to the response body. Read more
§

fn trace_for_http(self) -> Trace<Self, SharedClassifier<ServerErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using HTTP status codes. Read more
§

fn trace_for_grpc(self) -> Trace<Self, SharedClassifier<GrpcErrorsAsFailures>>
where Self: Sized,

High level tracing that classifies responses using gRPC headers. Read more
§

fn follow_redirects(self) -> FollowRedirect<Self>
where Self: Sized,

Follow redirect resposes using the Standard policy. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

§

impl<T> ErasedDestructor for T
where T: 'static,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSend for T
where T: Send,

§

impl<T> MaybeSync for T
where T: Sync,

§

impl<T> MaybeSync for T
where T: Sync,

§

impl<T> ResourceKey for T
where T: Eq + Hash + Clone + Send + Sync + Debug,

§

impl<T> TerminalState for T
where T: Clone + Send + Sync,