Enum FilterDenial 

pub enum FilterDenial {
    UnsupportedScheme {
        scheme: String,
    },
    MissingHost,
    Malformed,
    DeniedIpLiteral {
        literal: String,
    },
    DeniedResolvedIp {
        ip: IpAddr,
    },
    UserinfoNotAllowed,
    ReservedNamespace {
        path: String,
    },
}

A denial with a name a peer can act on.

The discriminant is the class of the refusal, not the value — a peer cannot recover a Loopback denial by trying a different loopback address. The string is logged, never parsed.

Variants

UnsupportedScheme

The URL is not http or https. Push notifications are HTTP POSTs; any other scheme is either impossible (a transport that does not exist) or an obvious SSRF primitive (file://, gopher://).

Fields

scheme: String

The scheme the URL named.

MissingHost

The URL has no host. A URL like http:///path is not a URL the delivery adapter can resolve.

Malformed

The URL is malformed in a way url::Url::parse did not catch. Almost never raised; a parse failure is usually an UnsupportedScheme or MissingHost first.

DeniedIpLiteral

The URL contained an IP literal in a denied range. The string names the literal, not the resolved IP — check_at_config sees the literal; check_at_delivery does not re-raise this variant.

Fields

literal: String

The IP literal the URL named.

DeniedResolvedIp

The resolved IP is in a denied range, even though the URL string may have looked fine. DNS rebinding lands here.

Fields

ip: IpAddr

The IP the resolver returned.

UserinfoNotAllowed

The URL contained a userinfo segment (user:pass@host). The credential is not a credential the server is honouring, and the format is a known SSRF primitive in URL parsers that disagree about what it means.

ReservedNamespace

The URL targeted the version’s per-version well-known path or another reserved namespace the server owns. A PushNotificationConfig pointing at the server’s own agent card endpoint is a loopback primitive the static check would otherwise have to allow.

Fields

path: String

The path the URL named, for logging.

Trait Implementations

impl Clone for FilterDenial

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 FilterDenial

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

Formats the value using the given formatter.

impl Display for FilterDenial

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

Formats the value using the given formatter.

impl Eq for FilterDenial

impl Error for FilterDenial

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<FilterDenial> for NotificationConfigError

fn from(source: FilterDenial) -> Self

Converts to this type from the input type.

impl PartialEq for FilterDenial

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FilterDenial