Skip to main content

AuditedAvc

Struct AuditedAvc 

Source
pub struct AuditedAvc<A: Avc, S: AuditSink> { /* private fields */ }
Expand description

An Avc that routes every decision through an AuditSink. This is the S7 complete-mediation hook: because the PEP (S2) calls the AVC per op, wrapping it here audits every decision with no bypass.

Fail-closed: if the audit write fails on what would otherwise be a Permit, the wrapper downgrades to Deny (reason AuditFailClosed) and attempts to record that deny (best-effort: if the sink is broken, the enforced deny is still emitted as a tracing event so it is observable). A decision that cannot be audited is never allowed through.

Implementations§

Source§

impl<A: Avc, S: AuditSink> AuditedAvc<A, S>

Source

pub fn new( inner: A, sink: S, generation: u64, policy_hash: Option<[u8; 32]>, ) -> Self

Wrap an AVC with audit. generation should be the evaluator’s generation (TeEvaluator::generation); policy_hash the crate::mac::compiled::CompiledPolicy::policy_hash when available.

Source

pub fn inner(&self) -> &A

Borrow the inner AVC (diagnostics / cache stats).

Source§

impl<A: Avc, S: AuditSink> AuditedAvc<A, S>

Source

pub fn decide_delegated( &self, subject: SubjectCtx, on_behalf_of: Option<SubjectCtx>, object: ObjectCtx, action: Action, ) -> Decision

Delegated (#680/#681) counterpart of Avc::decide: subject is the effective, met context the PDP decides on (already meet(delegator, actor) from hyprstream_rpc::auth::mac::SecurityContext::delegated); on_behalf_of is the delegator principal, recorded on the audit record but never re-evaluated (the decision rests on the met subject alone — the delegator cannot re-widen it).

The plain Avc::decide is the single-principal case (on_behalf_of = None); this is the two-principal case the (future) reference monitor calls when a request arrived over a delegation. Kept off the Avc trait so the hot-path cache key stays (subject, object, action) — delegation is an audit-attribution concern, not a decision input.

Source

pub fn decide_delegated_with_token( &self, subject: SubjectCtx, on_behalf_of: Option<SubjectCtx>, object: ObjectCtx, action: Action, token: &TokenScope, ) -> Decision

Delegated counterpart of Avc::decide_with_token; see Self::decide_delegated for the two-principal semantics.

Trait Implementations§

Source§

impl<A: Avc, S: AuditSink> Avc for AuditedAvc<A, S>

Source§

fn decide( &self, subject: SubjectCtx, object: ObjectCtx, action: Action, ) -> Decision

Per-op decision. Hit → cached; miss → evaluate-and-cache. Fail-closed.
Source§

fn decide_with_token( &self, subject: SubjectCtx, object: ObjectCtx, action: Action, token: &TokenScope, ) -> Decision

Per-op decision additionally gated by a token scope (the distributed-AVC-entry path). The result is Permit only if the PDP permits AND the token authorizes the action. The label-ceiling comparison requires the lattice and is done by the PDP-side floor; this method applies the op-set + ttl gate. Default-deny.
Source§

fn flush(&self)

Drop all cached decisions (e.g. on revocation broadcast). Generation rollover already invalidates implicitly; this is for explicit revocation (design §6 refresh path).

Auto Trait Implementations§

§

impl<A, S> Freeze for AuditedAvc<A, S>
where A: Freeze, S: Freeze,

§

impl<A, S> RefUnwindSafe for AuditedAvc<A, S>

§

impl<A, S> Send for AuditedAvc<A, S>

§

impl<A, S> Sync for AuditedAvc<A, S>

§

impl<A, S> Unpin for AuditedAvc<A, S>
where A: Unpin, S: Unpin,

§

impl<A, S> UnsafeUnpin for AuditedAvc<A, S>
where A: UnsafeUnpin, S: UnsafeUnpin,

§

impl<A, S> UnwindSafe for AuditedAvc<A, S>
where A: UnwindSafe, S: UnwindSafe,

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
§

impl<T> Any for T
where T: Any,

§

fn into_any(self: Box<T>) -> Box<dyn Any>

§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

§

fn type_name(&self) -> &'static str

§

impl<T> AnySync for T
where T: Any + Send + Sync,

§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Sync + Send> ⓘ

§

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

§

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

§

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

§

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

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> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> FutureExt for T

§

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more
§

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more
§

impl<T, W> HasTypeWitness<W> for T
where W: MakeTypeWitness<Arg = T>, T: ?Sized,

§

const WITNESS: W = W::MAKE

A constant of the type witness
§

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

§

const TYPE_EQ: TypeEq<T, <T as Identity>::Type> = TypeEq::NEW

Proof that Self is the same type as Self::Type, provides methods for casting between Self and Self::Type.
§

type Type = T

The same type as Self, used to emulate type equality bounds (T == U) with associated type equality constraints (T: Identity<Type = U>).
§

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
Source§

impl<T> IntoRequest<T> for T

Source§

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request
§

impl<T> JaggedSlice<T> for T

§

type Index = Index2

§

fn push_into(self, array: &mut Jagged<T>)

§

fn insert_into(self, index: <T as JaggedSlice<T>>::Index, array: &mut Jagged<T>)

§

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, 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
§

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> SendSyncUnwindSafe for T
where T: Send + Sync + UnwindSafe + ?Sized,