Struct RequestParts 

#[non_exhaustive]
pub struct RequestParts<'a> {
    pub method: &'a Method,
    pub path: &'a str,
    pub query: Option<&'a str>,
    pub headers: &'a HeaderMap,
    pub client: &'a ClientAddress,
}

Borrowed view of an incoming request, passed to an AuthDecider.

All fields borrow from the live request: building this is allocation-free, so the per-request gate stays cheap. The body is intentionally absent: an auth decision is taken from method, path, query, headers, and client alone.

Examples

use structured_proxy::hooks::RequestParts;
use structured_proxy::ClientAddress;

// The view a decider's own tests build.
let client = ClientAddress::from_peer(Some("203.0.113.7:51234".parse().unwrap()));
let headers = http::HeaderMap::new();
let parts = RequestParts::new(&http::Method::GET, "/v1/things", None, &headers, &client);
assert_eq!(parts.client.ip(), Some("203.0.113.7".parse().unwrap()));

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

method: &'a Method

Request method (the original method on the /verify path, recovered from the fronting proxy’s forwarding headers).

path: &'a str

Request path, query stripped.

query: Option<&'a str>

Raw query string, if any (without the leading ?).

headers: &'a HeaderMap

Request headers, with the forwarding headers as the client_address.forward policy wrote them for the upstream. With the default policy they hold only verified data; with append or preserve, X-Forwarded-For (and with preserve, X-Real-IP) still carries what the client sent. Decide on client, never on these headers.

client: &'a ClientAddress

The client address the proxy resolved, with the connection’s peer (the client, or the fronting proxy): the one to authorize on, whatever the forwarding policy.

Implementations

impl<'a> RequestParts<'a>

pub fn new( method: &'a Method, path: &'a str, query: Option<&'a str>, headers: &'a HeaderMap, client: &'a ClientAddress, ) -> Self

The view of a request: what the proxy hands a decider, and what a decider’s own tests build.

Trait Implementations

impl<'a> Debug for RequestParts<'a>

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

Formats the value using the given formatter.