Struct SecretEntry 

pub struct SecretEntry {
    pub env_var: String,
    pub value: Zeroizing<String>,
    pub source: Option<SecretSource>,
    pub placeholder: String,
    pub allowed_hosts: Vec<HostPattern>,
    pub substitution: SecretSubstitution,
    pub passthrough_hosts: Vec<HostPattern>,
    pub violation_action: Option<SecretViolationAction>,
    pub require_tls_identity: bool,
}

A single secret entry.

value is the sensitive material — it never enters the sandbox and is redacted by the Debug impl.

Fields

env_var: String

Environment variable name exposed to the sandbox (holds the placeholder).

Must be non-empty and must not contain = or NUL. microsandbox does not require shell-identifier syntax because Linux environment entries only require a NAME=value shape.

value: Zeroizing<String>

The actual secret value (never enters the sandbox).

Empty when the entry carries a source reference instead: reference-model entries resolve the value host-side at spawn time so the durable sandbox config never stores raw secret material.

Wrapped in Zeroizing so the owned plaintext copy is wiped when the entry drops.

source: Option<SecretSource>

Host-side source reference resolved into value at spawn time. None means value already carries the material (the inline model used by value-based secrets).

placeholder: String

Placeholder string the sandbox sees instead of the real value.

Must be non-empty, no longer than MAX_SECRET_PLACEHOLDER_BYTES, and must not contain NUL, CR, or LF.

allowed_hosts: Vec<HostPattern>

Hosts allowed to receive the substituted secret value.

substitution: SecretSubstitution

Request locations where the placeholder can be substituted.

passthrough_hosts: Vec<HostPattern>

Hosts allowed to receive the placeholder unchanged.

violation_action: Option<SecretViolationAction>

Action on a violation for this secret (overrides the config default).

require_tls_identity: bool

Require verified TLS identity before substituting (default: true).

When true, the secret is only substituted if the connection uses TLS interception (not bypass) and the SNI matches an allowed host.

Implementations

impl SecretEntry

pub fn validate(&self, secret_index: usize) -> Result<(), SecretConfigError>

Validate this secret entry.

Trait Implementations

impl Clone for SecretEntry

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SecretEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SecretEntry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<CloudSecretEntry> for SecretEntry

fn from(entry: CloudSecretEntry) -> Self

Converts to this type from the input type.

impl From<SecretEntry> for CloudSecretEntry

fn from(entry: SecretEntry) -> Self

Converts to this type from the input type.

impl Serialize for SecretEntry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.