Struct AccessControl 

pub struct AccessControl { /* private fields */ }

ACL rules v2

ACL files are small ordered routing tables. They have one default action and a handful of explicit sections:

• [default proxy] / [default direct] / [default block] - one line, specifies the default action
• [proxy_rules] - targets that must go through proxy
• [direct_rules] - targets that must connect directly
• [client_block] - client addresses that must be rejected by the server
• [outbound_block] / [block] - targets that must be blocked

Rule lines can be one of:

• CIDR network, like 10.9.0.32/16
• IP address, like 127.0.0.1 or ::1
• Exact domain, like |google.com
• Domain suffix, like ||google.com
• Regular expression, like (^|\.)gmail\.com$

Implementations

impl AccessControl

pub fn load_from_file<P: AsRef<Path>>(p: P) -> Result<AccessControl>

Load ACL rules from a file

pub fn file_path(&self) -> &Path

Get ACL file path

pub fn is_ip_empty(&self) -> bool

Check if there are no IP routing rules.

pub fn is_host_empty(&self) -> bool

Check if there are no host routing rules.

pub fn decide_host(&self, host: &str) -> Option<TargetDecision>

Decide how an ASCII domain should be handled.

Returns the first matching action, or None if no rule matches. The caller can then fall back to the default action.

pub async fn decide_target(&self, addr: &Address) -> TargetDecision

Decide how a target should be handled.

pub fn check_client_blocked(&self, addr: &SocketAddr) -> bool

Check if client address should be blocked (for server)

pub async fn check_outbound_blocked(&self, outbound: &Address) -> bool

Check if outbound address is blocked (for server)

NOTE: Address::DomainAddress is only validated by regex rules, resolved addresses are checked in the lookup_outbound_then! macro

Trait Implementations

impl Clone for AccessControl

fn clone(&self) -> AccessControl

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AccessControl

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

Formats the value using the given formatter.