Struct Secret

pub struct Secret<T: Zeroize>(/* private fields */);

Wrapper type for secret values such as passwords or authentication keys.

Once wrapped, the inner value cannot leak accidentally, as both the std::fmt::Display and Debug implementations cover up the actual value and only show the type.

If you need access to the inner value, there is an expose method.

To make sure nothing leaks after the Secret has been dropped, a custom Drop implementation will zero-out the underlying memory.

Implementations

impl<T: Zeroize> Secret<T>

pub fn new(secret: T) -> Self

pub fn expose(&self) -> &T

Expose the underlying value of the secret

pub fn redacted(&self) -> &str

Display a placeholder for the secret

Trait Implementations

impl<T: Clone + Zeroize> Clone for Secret<T>

fn clone(&self) -> Secret<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Zeroize> Debug for Secret<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for Secret<T>

where T: Deserialize<'de> + Zeroize,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: Zeroize> Drop for Secret<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: Zeroize> From<T> for Secret<T>

fn from(value: T) -> Self

Converts to this type from the input type.

impl<T: PartialEq + Zeroize> PartialEq for Secret<T>

fn eq(&self, other: &Secret<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

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<T> Serialize for Secret<T>

where T: Serialize + Zeroize,

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: Eq + Zeroize> Eq for Secret<T>

impl<T: Zeroize> StructuralPartialEq for Secret<T>