Skip to main content

SecretValue

Struct SecretValue 

Source
pub struct SecretValue(/* private fields */);
Expand description

A health-check header value held in memory only.

There is no Clone, Serialize, Deserialize or Display, and Debug prints a placeholder. The single way to read the bytes is SecretValue::expose_secret_bytes; call it only for the fingerprint HMAC and for the controlled in-memory IPC and wire builders.

Implementations§

Source§

impl SecretValue

Source

pub fn take_from_ingress( message: &mut HealthCheckHeaderValue, ) -> Result<Self, SecretValueError>

Move the value out of a generated ingress message.

The allocation moves with std::mem::take, so no copy is made and the generated field is left empty whether or not the value is accepted. The value must be UTF-8 and meet the per-value rules every health-check header meets (no forbidden control byte, no leading or trailing SP or HTAB); the name is the caller’s to validate.

Source

pub fn expose_secret_bytes(&self) -> &[u8] ⓘ

The clear bytes. The name is the warning: the only legitimate callers are the fingerprint HMAC and the controlled in-memory IPC and wire builders that carry the value onward.

Trait Implementations§

Source§

impl Debug for SecretValue

Source§

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

Formats the value using the given formatter. Read more

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<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

Source§

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

Source§

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

Source§

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.

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

Source§

type Output = T

Should always be Self
Source§

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

Source§

type Error = !

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

fn try_from(value: U) -> Result<T, !>

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.