Struct IpFilterLayer 

pub struct IpFilterLayer { /* private fields */ }

Tower Layer that applies CIDR-based IP allowlist or blocklist filtering.

Apply with Axum’s .layer() call. Use IpFilterLayer::new() with a configured IpFilterConfig to set your CIDR ranges and filter mode.

[!NOTE] Requests where the client IP cannot be extracted (header absent or unparseable) pass through unchecked regardless of mode.

Examples

use axum::{routing::get, Router};
use rune_axum_ipfilter::{FilterMode, IpFilterConfig, IpFilterLayer};

let app: Router = Router::new()
    .route("/api", get(|| async { "ok" }))
    .layer(IpFilterLayer::new(
        IpFilterConfig::new()
            .mode(FilterMode::Blocklist)
            .cidr("192.168.1.100/32"),
    ));

Implementations

impl IpFilterLayer

pub fn new(config: IpFilterConfig) -> IpFilterLayer

Creates an IpFilterLayer from a custom IpFilterConfig.

Trait Implementations

impl Clone for IpFilterLayer

fn clone(&self) -> IpFilterLayer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IpFilterLayer

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

Formats the value using the given formatter.

impl<S> Layer<S> for IpFilterLayer

type Service = IpFilterService<S>

The wrapped service

fn layer(&self, inner: S) -> <IpFilterLayer as Layer<S>>::Service

Wrap the given service with the middleware, returning a new service that has been decorated with the middleware.