1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
use rama_http_types::{HeaderName, HeaderValue};
use super::authorization::{Authorization, Credentials};
use crate::{Error, HeaderDecode, HeaderEncode, TypedHeader};
/// `Proxy-Authorization` header, defined in [RFC7235](https://tools.ietf.org/html/rfc7235#section-4.4)
///
/// The `Proxy-Authorization` header field allows a user agent to authenticate
/// itself with an HTTP proxy -- usually, but not necessarily, after
/// receiving a 407 (Proxy Authentication Required) response and the
/// `Proxy-Authenticate` header. Its value consists of credentials containing
/// the authentication information of the user agent for the realm of the
/// resource being requested.
///
/// # ABNF
///
/// ```text
/// Proxy-Authorization = credentials
/// ```
///
/// # Example values
/// * `Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==`
/// * `Bearer fpKL54jvWmEGVoRdCNjG`
///
/// # Examples
///
#[derive(Clone, PartialEq, Debug)]
pub struct ProxyAuthorization<C: Credentials>(pub C);
impl<C: Credentials> TypedHeader for ProxyAuthorization<C> {
fn name() -> &'static HeaderName {
&::rama_http_types::header::PROXY_AUTHORIZATION
}
}
impl<C: Credentials> HeaderDecode for ProxyAuthorization<C> {
fn decode<'i, I: Iterator<Item = &'i HeaderValue>>(values: &mut I) -> Result<Self, Error> {
Authorization::decode(values).map(|auth| Self(auth.0))
}
}
impl<C: Credentials> HeaderEncode for ProxyAuthorization<C> {
fn encode<E: Extend<HeaderValue>>(&self, values: &mut E) {
values.extend(self.0.encode().map(|value| {
debug_assert!(
value.as_bytes().starts_with(C::SCHEME.as_bytes()),
"Credentials::encode should include its scheme: scheme = {:?}, encoded = {:?}",
C::SCHEME,
value,
);
value
}));
}
}