Skip to main content

TrustedProxyList

zlayer_proxy::trust

Struct TrustedProxyList

pub struct TrustedProxyList { /* private fields */ }

Expand description

A list of trusted upstream proxies, expressed as a set of user CIDRs plus an optional Cloudflare IP cache.

Implementations§

impl TrustedProxyList

pub fn new( user_cidrs: Vec<IpNet>, cf_cache: Option<Arc<CloudflareIpCache>>, ) -> Self

Build a trusted-proxy list from user CIDRs and an optional Cloudflare IP cache.

pub fn localhost_only() -> Self

Shortcut: localhost-only, no CF. Safe default for origins that are NOT behind any upstream proxy.

§Panics

This function contains .expect() calls on CIDR parsing, but in practice it never panics: the CIDR strings (127.0.0.0/8 and ::1/128) are hardcoded constants that are guaranteed to be valid IpNet values. The expects exist only to satisfy the FromStr signature.

pub fn is_trusted(&self, peer: IpAddr) -> bool

True if peer is in user_cidrs OR in the CF cache (when present).

pub fn user_cidrs(&self) -> &[IpNet]

Returns the configured user CIDRs (for diagnostics / inspection).

pub fn has_cloudflare_trust(&self) -> bool

True if a CF cache is attached.

Trait Implementations§

impl Clone for TrustedProxyList

fn clone(&self) -> TrustedProxyList

Returns a duplicate of the value. Read more

1.0.0 · Source§

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

Performs copy-assignment from source. Read more

impl Debug for TrustedProxyList

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

impl Freeze for TrustedProxyList

impl RefUnwindSafe for TrustedProxyList

impl Send for TrustedProxyList

impl Sync for TrustedProxyList

impl Unpin for TrustedProxyList

impl UnsafeUnpin for TrustedProxyList

impl UnwindSafe for TrustedProxyList

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<'a, T, E> AsTaggedExplicit<'a, E> for T
where T: 'a,

fn explicit(self, class: Class, tag: u32) -> TaggedParser<'a, Explicit, Self, E>

impl<'a, T, E> AsTaggedImplicit<'a, E> for T
where T: 'a,

fn implicit( self, class: Class, constructed: bool, tag: u32, ) -> TaggedParser<'a, Implicit, Self, E>

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

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

Performs copy-assignment from self to dest. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> PolicyExt for T
where T: ?Sized,

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more

impl<T> Same for T

type Output = T

Should always be Self

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more