Enum SecretResolutionFailure

Namespace

MailFathom.Infrastructure.Secrets.Resolution

Assembly

MailFathom.Infrastructure.dll

Identifies why a secret-bearing configuration value produced no material.

public enum SecretResolutionFailure

Fields

CredentialsDirectoryUnavailable = 5

The process was not started with a systemd credentials directory.

InlineValueNotPermittedByInterpretationMode = 4

The material was supplied inline where the consumer accepts referenced material only.

Reserved for a consumer that narrows the permitted provenance below the interpretation mode, such as binary certificate material.

MaterialEmpty = 7

The target exists but holds no bytes.

MaterialNotFound = 6

The target names nothing the adapter could read.

MaterialTooLarge = 9

The material exceeds the maximum size a secret may occupy.

ProviderUnavailable = 8

The provider backing the scheme could not be reached.

No adapter shipped today produces this; it exists so a network-backed provider can distinguish an outage from a missing secret.

ReferenceMissing = 0

No value was configured at all.

RetrievalTimedOut = 11

Retrieving the material did not finish within the deadline the adapter enforces.

This is what a stalled network mount produces. It is distinct from ProviderUnavailable because a provider that refused is a different operator problem from one that never answered.

SchemeMissing = 1

The value carries no scheme separator, so it is not a reference.

SchemeNotSupported = 2

The scheme is well formed but no adapter serving it is registered.

TargetMissing = 3

Nothing follows the scheme separator.

TargetNotRegularFile = 10

The target names something other than a regular file, such as a FIFO, a socket, or a device.

A mistyped path can name any of them, and none holds material a credential could be read from: a FIFO blocks until a writer appears, and a character device yields bytes without end.

Remarks

The identity is the whole failure vocabulary a diagnostic may carry. Neither the reference target, nor the environment variable value, nor any part of the material may accompany it.