Client IP address extractors for the Axum web framework. The crate is just a thin wrapper around a framework-independent client-ip crate.

• Removed InsecureClientIp and related "leftmost" IP logic. The library now focuses solely on secure extraction based on trusted headers.
• Renamed SecureClientIp to ClientIp.
• Renamed SecureClientIpSource to ClientIpSource.

The changes are triggered by "rightmost" IP extraction bug.

There's a configurable [ClientIp] extractor you can use to make your application independent from a proxy it can run behind (if any) and also separate extractors for each proxy / source header.

The configurable extractor assumes initializing [ClientIpSource] at runtime (e.g. with an environment variable). This makes sense when you ship a pre-compiled binary, people meant to use in different environments. Here's an initialization example.

Specific extractors don't require runtime initialization, but you'd have to recompile your binary when you change proxy server.

// With the renaming, you have to change only one line when you change proxy
use axum_client_ip::XRealIp as ClientIp;

async fn handler(ClientIp(ip): ClientIp) {
    todo!()
}

• please run .pre-commit.sh before sending a PR, it will check everything

This project is licensed under the MIT license.