Enum ValidationError 

pub enum ValidationError {
    FileNotFound(String),
    FileNotReadable(String),
    InvalidDomain(String),
    InvalidCertFormat(String),
    InvalidKeyFormat(String),
    WeakKey(String),
    SuspiciousPath(String),
    DomainTooLong(String),
    HomographAttack(String),
}

Validation errors that can occur during configuration validation.

Security Context

These errors provide specific information about configuration failures to help administrators diagnose issues without exposing system internals.

Variants

FileNotFound(String)

Certificate or key file not found at the specified path.

Check that the path is correct and the file exists.

FileNotReadable(String)

Certificate or key file exists but is not readable.

Check file permissions and ownership.

InvalidDomain(String)

Domain name does not comply with RFC 1035.

Domain must contain only alphanumerics, hyphens, and dots. Labels cannot start or end with hyphens.

InvalidCertFormat(String)

Certificate file does not contain PEM format markers.

Certificate must start with -----BEGIN CERTIFICATE----- and end with -----END CERTIFICATE-----.

InvalidKeyFormat(String)

Private key file does not contain PEM format markers.

Private key must start with one of:

• -----BEGIN PRIVATE KEY-----
• -----BEGIN RSA PRIVATE KEY-----
• -----BEGIN EC PRIVATE KEY-----
• -----BEGIN ENCRYPTED PRIVATE KEY-----

WeakKey(String)

Private key is too weak for secure cryptography.

SECURITY: Minimum requirements:

• RSA keys: 2048 bits minimum
• EC keys: 256 bits minimum (e.g., P-256, secp256r1)

Weak keys can be brute-forced or factored with modern hardware.

SuspiciousPath(String)

File path contains suspicious characters or traversal attempts.

Paths containing .. or ~ are rejected to prevent directory traversal.

DomainTooLong(String)

Domain name exceeds the maximum length of 253 characters.

HomographAttack(String)

Domain contains Unicode characters that could be homograph attacks.

SECURITY: Domains with Cyrillic, Greek, or other characters that visually resemble ASCII (e.g., Cyrillic ‘а’ vs ASCII ‘a’) are rejected to prevent phishing attacks like “аpple.com”.

Trait Implementations

impl Clone for ValidationError

fn clone(&self) -> ValidationError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ValidationError

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

Formats the value using the given formatter.

impl Display for ValidationError

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

Formats the value using the given formatter.

impl Error for ValidationError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<ValidationError> for ConfigManagerError

fn from(source: ValidationError) -> Self

Converts to this type from the input type.