Enum UrlGuardError 

pub enum UrlGuardError {
    InvalidUrl(String),
    LocalhostBadPath(String),
    LocalNetworkQueryString,
    RedirectToPrivateIp(IpAddr),
    IdnaDomain(String),
    PrivateHostBlocked(String),
}

Errors returned by URL validation functions.

Variants

InvalidUrl(String)

URL failed url::Url::parse or used an unsupported scheme.

LocalhostBadPath(String)

A localhost tracker URL was missing the required /announce path — BEP 3 trackers must terminate at that path, and accepting bare-host URLs widens the SSRF surface unnecessarily.

LocalNetworkQueryString

A local-network web seed URL carried a query string. BEP 17/19 web seeds shouldn’t need one, and allowing them opens an SSRF vector (smuggling commands via ? to local services).

RedirectToPrivateIp(IpAddr)

In-flight redirect from a public URL landed on a private IP — fired by the custom reqwest::redirect::Policy returned by build_redirect_policy. Distinct from Self::PrivateHostBlocked, which is a pre-flight check on user-supplied URLs.

IdnaDomain(String)

An internationalised domain name was present and IDNA was disallowed by the active UrlSecurityConfig.

PrivateHostBlocked(String)

M218: a user-typed URL pointed at a private/loopback host. Stricter than Self::RedirectToPrivateIp (which only fires in-flight); this is the pre-flight check that rejects http://localhost/, http://192.168.1.1/, http://0.0.0.0/, http://[::ffff:127.0.0.1]/, etc. before the request leaves the process.

Trait Implementations

impl Debug for UrlGuardError

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

Formats the value using the given formatter.

impl Display for UrlGuardError

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

Formats the value using the given formatter.

impl Error for UrlGuardError

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.