use http::header::{
CONTENT_SECURITY_POLICY, STRICT_TRANSPORT_SECURITY, X_CONTENT_TYPE_OPTIONS, X_FRAME_OPTIONS,
};
use hyper::{Body, Request, Response, header::HeaderValue};
use crate::{Error, handler::RequestHandlerOpts};
static HSTS_VALUE: HeaderValue =
HeaderValue::from_static("max-age=63072000; includeSubDomains; preload");
static XFO_VALUE: HeaderValue = HeaderValue::from_static("DENY");
static XCTO_VALUE: HeaderValue = HeaderValue::from_static("nosniff");
static CSP_VALUE: HeaderValue = HeaderValue::from_static("frame-ancestors 'self'");
#[derive(Clone, Copy, Debug)]
pub(crate) struct TlsConnection;
pub(crate) fn init(enabled: bool, handler_opts: &mut RequestHandlerOpts) {
handler_opts.security_headers = enabled;
tracing::info!("security headers: enabled={enabled}");
}
pub(crate) fn post_process<T>(
opts: &RequestHandlerOpts,
req: &Request<T>,
mut resp: Response<Body>,
) -> Result<Response<Body>, Error> {
if opts.security_headers {
if req.extensions().get::<TlsConnection>().is_some() {
append_hsts_header(&mut resp);
}
append_common_headers(&mut resp);
}
Ok(resp)
}
pub fn append_headers(resp: &mut Response<Body>) {
append_hsts_header(resp);
append_common_headers(resp);
}
fn append_hsts_header(resp: &mut Response<Body>) {
resp.headers_mut()
.insert(STRICT_TRANSPORT_SECURITY, HSTS_VALUE.clone());
}
fn append_common_headers(resp: &mut Response<Body>) {
resp.headers_mut()
.insert(X_FRAME_OPTIONS, XFO_VALUE.clone());
resp.headers_mut()
.insert(X_CONTENT_TYPE_OPTIONS, XCTO_VALUE.clone());
resp.headers_mut()
.insert(CONTENT_SECURITY_POLICY, CSP_VALUE.clone());
}
#[cfg(test)]
mod tests {
use http::header::{
CONTENT_SECURITY_POLICY, STRICT_TRANSPORT_SECURITY, X_CONTENT_TYPE_OPTIONS, X_FRAME_OPTIONS,
};
use hyper::{Body, Request, Response};
use super::{TlsConnection, append_headers, init, post_process};
use crate::handler::RequestHandlerOpts;
fn assert_common_headers(resp: &Response<Body>) {
let headers = resp.headers();
assert_eq!(headers.get(X_FRAME_OPTIONS).unwrap(), "DENY");
assert_eq!(headers.get(X_CONTENT_TYPE_OPTIONS).unwrap(), "nosniff");
assert_eq!(
headers.get(CONTENT_SECURITY_POLICY).unwrap(),
"frame-ancestors 'self'"
);
}
#[test]
fn post_process_sends_hsts_only_over_tls() {
for (enabled, tls) in [(true, true), (true, false), (false, true), (false, false)] {
let mut opts = RequestHandlerOpts::default();
init(enabled, &mut opts);
let mut req = Request::new(Body::empty());
if tls {
req.extensions_mut().insert(TlsConnection);
}
let resp = post_process(&opts, &req, Response::new(Body::empty())).unwrap();
if enabled {
assert_common_headers(&resp);
} else {
assert!(resp.headers().is_empty(), "tls={tls}");
}
assert_eq!(
resp.headers().get(STRICT_TRANSPORT_SECURITY).is_some(),
enabled && tls,
"enabled={enabled} tls={tls}"
);
}
}
#[test]
fn append_headers_sets_all_headers() {
let mut resp = Response::new(Body::empty());
append_headers(&mut resp);
assert_eq!(
resp.headers().get(STRICT_TRANSPORT_SECURITY).unwrap(),
"max-age=63072000; includeSubDomains; preload"
);
assert_common_headers(&resp);
}
}