Enum SsrfReason 

#[non_exhaustive]
pub enum SsrfReason {
    NonHttps,
    IpLiteral,
    InvalidUrl,
    Loopback,
    Private,
    Imds,
    MulticastOrReserved,
    CrossAuthority,
}

Stable, machine-readable reason an SSRF check rejected a target.

Surfaced by the SsrfPolicy::classify_url / SsrfPolicy::classify_ip / SsrfPolicy::classify_redirect family so callers can react programmatically — and so language bindings can map a rejection to a typed exception — instead of string-matching the free-form detail message. Maps to RFC-ACDP-0006 §7 / RFC-ACDP-0008 §4.8.

#[non_exhaustive]: future spec revisions may add ranges; match with a wildcard arm.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NonHttps

URL scheme is not https (and allow_http is off).

IpLiteral

URL embeds an IP literal; a hostname (forcing DNS) is required.

InvalidUrl

URL could not be parsed, has no host, or has an invalid hostname.

Loopback

Loopback range — IPv4 127.0.0.0/8 or IPv6 ::1.

Private

Private range — RFC 1918 (10/8, 172.16/12, 192.168/16), CGNAT 100.64/10, or IPv6 ULA fc00::/7.

Imds

Link-local / cloud instance-metadata reach — IPv4 169.254.0.0/16 (incl. 169.254.169.254), IPv6 fe80::/10, and the NAT64 well-known prefix 64:ff9b::/96 (which can translate to IMDS).

MulticastOrReserved

Multicast or otherwise reserved/unusable range (0.0.0.0/8, 192.0.0.0/24, 198.18.0.0/15, 224.0.0.0/4, 240.0.0.0/4, IPv6 multicast / unspecified).

CrossAuthority

A redirect target whose scheme, host, or effective port differs from the originating request’s authority (RFC-ACDP-0006 §7.5).

Implementations

impl SsrfReason

pub fn as_str(&self) -> &'static str

The stable snake_case identifier for this reason — the contract language bindings expose to host code.

Trait Implementations

impl Clone for SsrfReason

fn clone(&self) -> SsrfReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SsrfReason

impl Debug for SsrfReason

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

Formats the value using the given formatter.

impl Display for SsrfReason

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

Formats the value using the given formatter.

impl Eq for SsrfReason

impl PartialEq for SsrfReason

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for SsrfReason