Struct HttpAcl 

pub struct HttpAcl { /* private fields */ }

Represents an HTTP ACL.

Implementations

impl HttpAcl

pub fn builder() -> HttpAclBuilder

Returns a new HttpAclBuilder.

pub fn is_scheme_allowed(&self, scheme: &str) -> AclClassification

Returns whether the scheme is allowed.

pub fn is_method_allowed( &self, method: impl Into<HttpRequestMethod>, ) -> AclClassification

Returns whether the method is allowed.

Note: If you pass a string ensure it is uppercased first.

pub fn is_host_allowed(&self, host: &str) -> AclClassification

Returns whether the host is allowed.

Note: The host should be in its canonical form (lowercase, punycode for IDN).

pub fn is_port_allowed(&self, port: u16) -> AclClassification

Returns whether the port is allowed.

pub fn is_ip_allowed(&self, ip: &IpAddr) -> AclClassification

Returns whether an IP is allowed.

pub fn resolve_static_dns_mapping(&self, host: &str) -> Option<SocketAddr>

Resolve static DNS mapping.

Note: The host should be in its canonical form (lowercase, punycode for IDN).

pub fn is_header_allowed( &self, header_name: &str, header_value: &str, ) -> AclClassification

Returns whether a header is allowed.

Note: Header names are case-insensitive, but this function assumes the caller provides them in a consistent case.

pub fn is_url_path_allowed(&self, url_path: &str) -> AclClassification

Returns whether a URL path is allowed.

Note: The URL path should be percent-decoded before passing it to this function.

pub fn is_valid<'h>( &self, scheme: &str, authority: &Authority, headers: impl Iterator<Item = (&'h str, &'h str)> + Send + Sync + 'h, body: Option<&[u8]>, ) -> AclClassification

Returns whether a request is valid.

Trait Implementations

impl Clone for HttpAcl

fn clone(&self) -> HttpAcl

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpAcl

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

Formats the value using the given formatter.

impl Default for HttpAcl

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for HttpAcl

fn eq(&self, other: &Self) -> 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.