use crate::Credential;
use crate::constants::{
AWS_QUERY_ENCODE_SET, X_AMZ_CONTENT_SHA_256, X_AMZ_DATE, X_AMZ_S3_SESSION_TOKEN,
X_AMZ_SECURITY_TOKEN,
};
use http::request::Parts;
use http::{HeaderValue, header};
use log::debug;
use percent_encoding::{percent_decode_str, utf8_percent_encode};
use reqsign_core::hash::{hex_hmac_sha256, hex_sha256, hmac_sha256};
use reqsign_core::time::Timestamp;
use reqsign_core::{Context, Result, SignRequest, SigningRequest};
use std::fmt::Write;
use std::time::Duration;
#[derive(Debug)]
pub struct RequestSigner {
service: String,
region: String,
time: Option<Timestamp>,
}
impl RequestSigner {
pub fn new(service: &str, region: &str) -> Self {
Self {
service: service.into(),
region: region.into(),
time: None,
}
}
#[cfg(test)]
pub fn with_time(mut self, time: Timestamp) -> Self {
self.time = Some(time);
self
}
}
impl SignRequest for RequestSigner {
type Credential = Credential;
async fn sign_request(
&self,
_: &Context,
req: &mut Parts,
credential: Option<&Self::Credential>,
expires_in: Option<Duration>,
) -> Result<()> {
let Some(cred) = credential else {
return Ok(());
};
let now = self.time.unwrap_or_else(Timestamp::now);
let mut signed_req = SigningRequest::build(req)?;
canonicalize_header(&mut signed_req, cred, expires_in, now)?;
canonicalize_query(
&mut signed_req,
cred,
expires_in,
now,
&self.service,
&self.region,
)?;
let creq = canonical_request_string(&mut signed_req)?;
let encoded_req = hex_sha256(creq.as_bytes());
let scope = format!(
"{}/{}/{}/aws4_request",
now.format_date(),
self.region,
self.service
);
debug!("calculated scope: {scope}");
let string_to_sign = {
let mut f = String::new();
writeln!(f, "AWS4-HMAC-SHA256").map_err(|e| {
reqsign_core::Error::unexpected(format!("failed to write algorithm: {e}"))
})?;
writeln!(f, "{}", now.format_iso8601()).map_err(|e| {
reqsign_core::Error::unexpected(format!("failed to write timestamp: {e}"))
})?;
writeln!(f, "{}", &scope).map_err(|e| {
reqsign_core::Error::unexpected(format!("failed to write scope: {e}"))
})?;
write!(f, "{}", &encoded_req).map_err(|e| {
reqsign_core::Error::unexpected(format!("failed to write encoded request: {e}"))
})?;
f
};
debug!("calculated string to sign: {string_to_sign}");
let signing_key =
generate_signing_key(&cred.secret_access_key, now, &self.region, &self.service);
let signature = hex_hmac_sha256(&signing_key, string_to_sign.as_bytes());
if expires_in.is_some() {
signed_req.query.push(("X-Amz-Signature".into(), signature));
} else {
let mut authorization = HeaderValue::from_str(&format!(
"AWS4-HMAC-SHA256 Credential={}/{}, SignedHeaders={}, Signature={}",
cred.access_key_id,
scope,
signed_req.header_name_to_vec_sorted().join(";"),
signature
))
.map_err(|e| {
reqsign_core::Error::unexpected(format!(
"failed to create authorization header: {e}"
))
})?;
authorization.set_sensitive(true);
signed_req
.headers
.insert(header::AUTHORIZATION, authorization);
}
signed_req.apply(req)
}
}
fn canonical_request_string(ctx: &mut SigningRequest) -> Result<String> {
let mut f = String::with_capacity(256);
writeln!(f, "{}", ctx.method)
.map_err(|e| reqsign_core::Error::unexpected(format!("failed to write method: {e}")))?;
let path = percent_decode_str(&ctx.path)
.decode_utf8()
.map_err(|e| reqsign_core::Error::unexpected(format!("failed to decode path: {e}")))?;
writeln!(
f,
"{}",
utf8_percent_encode(&path, &super::constants::AWS_URI_ENCODE_SET)
)
.map_err(|e| reqsign_core::Error::unexpected(format!("failed to write encoded path: {e}")))?;
writeln!(
f,
"{}",
ctx.query
.iter()
.map(|(k, v)| { format!("{k}={v}") })
.collect::<Vec<_>>()
.join("&")
)
.map_err(|e| reqsign_core::Error::unexpected(format!("failed to write query: {e}")))?;
let signed_headers = ctx.header_name_to_vec_sorted();
for header in signed_headers.iter() {
let value = &ctx.headers[*header];
writeln!(
f,
"{}:{}",
header,
value.to_str().expect("header value must be valid")
)
.map_err(|e| reqsign_core::Error::unexpected(format!("failed to write header: {e}")))?;
}
writeln!(f)
.map_err(|e| reqsign_core::Error::unexpected(format!("failed to write newline: {e}")))?;
writeln!(f, "{}", signed_headers.join(";")).map_err(|e| {
reqsign_core::Error::unexpected(format!("failed to write signed headers: {e}"))
})?;
if ctx.headers.get(X_AMZ_CONTENT_SHA_256).is_none() {
write!(f, "UNSIGNED-PAYLOAD").map_err(|e| {
reqsign_core::Error::unexpected(format!("failed to write unsigned payload: {e}"))
})?;
} else {
write!(
f,
"{}",
ctx.headers[X_AMZ_CONTENT_SHA_256].to_str().map_err(|e| {
reqsign_core::Error::unexpected(format!("invalid header value: {e}"))
})?
)
.map_err(|e| {
reqsign_core::Error::unexpected(format!("failed to write content sha256: {e}"))
})?;
}
Ok(f)
}
fn canonicalize_header(
ctx: &mut SigningRequest,
cred: &Credential,
expires_in: Option<Duration>,
now: Timestamp,
) -> Result<()> {
for (_, value) in ctx.headers.iter_mut() {
SigningRequest::header_value_normalize(value)
}
if ctx.headers.get(header::HOST).is_none() {
ctx.headers.insert(
header::HOST,
ctx.authority.as_str().parse().map_err(|e| {
reqsign_core::Error::unexpected(format!(
"failed to parse authority as header value: {e}"
))
})?,
);
}
if expires_in.is_none() {
if ctx.headers.get(X_AMZ_DATE).is_none() {
let date_header = HeaderValue::try_from(now.format_iso8601()).map_err(|e| {
reqsign_core::Error::unexpected(format!("failed to create date header: {e}"))
})?;
ctx.headers.insert(X_AMZ_DATE, date_header);
}
if ctx.headers.get(X_AMZ_CONTENT_SHA_256).is_none() {
ctx.headers.insert(
X_AMZ_CONTENT_SHA_256,
HeaderValue::from_static("UNSIGNED-PAYLOAD"),
);
}
if let Some(token) = &cred.session_token {
let mut value = HeaderValue::from_str(token).map_err(|e| {
reqsign_core::Error::unexpected(format!(
"failed to create security token header: {e}"
))
})?;
value.set_sensitive(true);
let is_s3_express = ctx.authority.as_str().contains("s3express")
|| ctx.authority.as_str().contains("--x-s3");
if is_s3_express {
ctx.headers.insert(X_AMZ_S3_SESSION_TOKEN, value);
} else {
ctx.headers.insert(X_AMZ_SECURITY_TOKEN, value);
}
}
}
Ok(())
}
fn canonicalize_query(
ctx: &mut SigningRequest,
cred: &Credential,
expires_in: Option<Duration>,
now: Timestamp,
service: &str,
region: &str,
) -> Result<()> {
if let Some(expire) = expires_in {
ctx.query
.push(("X-Amz-Algorithm".into(), "AWS4-HMAC-SHA256".into()));
ctx.query.push((
"X-Amz-Credential".into(),
format!(
"{}/{}/{}/{}/aws4_request",
cred.access_key_id,
now.format_date(),
region,
service
),
));
ctx.query.push(("X-Amz-Date".into(), now.format_iso8601()));
ctx.query
.push(("X-Amz-Expires".into(), expire.as_secs().to_string()));
ctx.query.push((
"X-Amz-SignedHeaders".into(),
ctx.header_name_to_vec_sorted().join(";"),
));
if let Some(token) = &cred.session_token {
ctx.query
.push(("X-Amz-Security-Token".into(), token.into()));
}
}
if ctx.query.is_empty() {
return Ok(());
}
ctx.query.sort();
ctx.query = ctx
.query
.iter()
.map(|(k, v)| {
(
utf8_percent_encode(k, &AWS_QUERY_ENCODE_SET).to_string(),
utf8_percent_encode(v, &AWS_QUERY_ENCODE_SET).to_string(),
)
})
.collect();
Ok(())
}
fn generate_signing_key(secret: &str, time: Timestamp, region: &str, service: &str) -> Vec<u8> {
let secret = format!("AWS4{secret}");
let sign_date = hmac_sha256(secret.as_bytes(), time.format_date().as_bytes());
let sign_region = hmac_sha256(sign_date.as_slice(), region.as_bytes());
let sign_service = hmac_sha256(sign_region.as_slice(), service.as_bytes());
hmac_sha256(sign_service.as_slice(), "aws4_request".as_bytes())
}
#[cfg(test)]
mod tests {
use super::*;
use crate::provide_credential::StaticCredentialProvider;
use anyhow::Result;
use aws_credential_types::Credentials;
use aws_sigv4::http_request::PayloadChecksumKind;
use aws_sigv4::http_request::PercentEncodingMode;
use aws_sigv4::http_request::SignableBody;
use aws_sigv4::http_request::SignableRequest;
use aws_sigv4::http_request::SignatureLocation;
use aws_sigv4::http_request::SigningSettings;
use aws_sigv4::sign::v4;
use http::Request;
use http::header;
use reqsign_core::ProvideCredential;
use reqsign_file_read_tokio::TokioFileRead;
use reqsign_http_send_reqwest::ReqwestHttpSend;
type TestCase = (&'static str, fn() -> Request<&'static str>);
fn test_cases() -> Vec<TestCase> {
vec![
("get_request", test_get_request),
("get_request_with_sse", test_get_request_with_sse),
("get_request_with_query", test_get_request_with_query),
("get_request_virtual_host", test_get_request_virtual_host),
(
"get_request_with_query_virtual_host",
test_get_request_with_query_virtual_host,
),
("put_request", test_put_request),
(
"put_request_with_body_digest",
test_put_request_with_body_digest,
),
("put_request_virtual_host", test_put_request_virtual_host),
]
}
fn test_get_request() -> Request<&'static str> {
let mut req = Request::new("");
*req.method_mut() = http::Method::GET;
*req.uri_mut() = "http://127.0.0.1:9000/hello"
.parse()
.expect("url must be valid");
req
}
fn test_get_request_with_sse() -> Request<&'static str> {
let mut req = Request::new("");
*req.method_mut() = http::Method::GET;
*req.uri_mut() = "http://127.0.0.1:9000/hello"
.parse()
.expect("url must be valid");
req.headers_mut().insert(
"x-amz-server-side-encryption",
"a".parse().expect("must be valid"),
);
req.headers_mut().insert(
"x-amz-server-side-encryption-customer-algorithm",
"b".parse().expect("must be valid"),
);
req.headers_mut().insert(
"x-amz-server-side-encryption-customer-key",
"c".parse().expect("must be valid"),
);
req.headers_mut().insert(
"x-amz-server-side-encryption-customer-key-md5",
"d".parse().expect("must be valid"),
);
req.headers_mut().insert(
"x-amz-server-side-encryption-aws-kms-key-id",
"e".parse().expect("must be valid"),
);
req
}
fn test_get_request_with_query() -> Request<&'static str> {
let mut req = Request::new("");
*req.method_mut() = http::Method::GET;
*req.uri_mut() = "http://127.0.0.1:9000/hello?list-type=2&max-keys=3&prefix=CI/&start-after=ExampleGuide.pdf"
.parse()
.expect("url must be valid");
req
}
fn test_get_request_virtual_host() -> Request<&'static str> {
let mut req = Request::new("");
*req.method_mut() = http::Method::GET;
*req.uri_mut() = "http://hello.s3.test.example.com"
.parse()
.expect("url must be valid");
req
}
fn test_get_request_with_query_virtual_host() -> Request<&'static str> {
let mut req = Request::new("");
*req.method_mut() = http::Method::GET;
*req.uri_mut() = "http://hello.s3.test.example.com?list-type=2&max-keys=3&prefix=CI/&start-after=ExampleGuide.pdf"
.parse()
.expect("url must be valid");
req
}
fn test_put_request() -> Request<&'static str> {
let content = "Hello,World!";
let mut req = Request::new(content);
*req.method_mut() = http::Method::PUT;
*req.uri_mut() = "http://127.0.0.1:9000/hello"
.parse()
.expect("url must be valid");
req.headers_mut().insert(
header::CONTENT_LENGTH,
HeaderValue::from_str(&content.len().to_string()).expect("must be valid"),
);
req
}
fn test_put_request_with_body_digest() -> Request<&'static str> {
let content = "Hello,World!";
let mut req = Request::new(content);
*req.method_mut() = http::Method::PUT;
*req.uri_mut() = "http://127.0.0.1:9000/hello"
.parse()
.expect("url must be valid");
req.headers_mut().insert(
header::CONTENT_LENGTH,
HeaderValue::from_str(&content.len().to_string()).expect("must be valid"),
);
let body = hex_sha256(content.as_bytes());
req.headers_mut().insert(
"x-amz-content-sha256",
HeaderValue::from_str(&body).expect("must be valid"),
);
req
}
fn test_put_request_virtual_host() -> Request<&'static str> {
let content = "Hello,World!";
let mut req = Request::new(content);
*req.method_mut() = http::Method::PUT;
*req.uri_mut() = "http://hello.s3.test.example.com"
.parse()
.expect("url must be valid");
req.headers_mut().insert(
header::CONTENT_LENGTH,
HeaderValue::from_str(&content.len().to_string()).expect("must be valid"),
);
req
}
#[track_caller]
fn compare_request(name: &str, l: &Request<&str>, r: &Request<&str>) {
fn format_headers(req: &Request<&str>) -> Vec<String> {
let mut hs = req
.headers()
.iter()
.map(|(k, v)| format!("{}:{}", k, v.to_str().expect("must be valid")))
.collect::<Vec<_>>();
if !hs.contains(&format!("host:{}", req.uri().authority().unwrap())) {
hs.push(format!("host:{}", req.uri().authority().unwrap()))
}
hs.sort();
hs
}
assert_eq!(
format_headers(l),
format_headers(r),
"{name} header mismatch"
);
fn format_query(req: &Request<&str>) -> Vec<String> {
let query = req.uri().query().unwrap_or_default();
let mut query = form_urlencoded::parse(query.as_bytes())
.map(|(k, v)| format!("{}={}", &k, &v))
.collect::<Vec<_>>();
query.sort();
query
}
assert_eq!(format_query(l), format_query(r), "{name} query mismatch");
}
#[tokio::test]
async fn test() -> Result<()> {
for (name, req) in test_cases() {
calculate(req)
.await
.unwrap_or_else(|err| panic!("calculate {name} should pass: {err:?}"));
calculate_in_query(req)
.await
.unwrap_or_else(|err| panic!("calculate_in_query {name} should pass: {err:?}"));
test_calculate_with_token(req).await.unwrap_or_else(|err| {
panic!("test_calculate_with_token {name} should pass: {err:?}")
});
test_calculate_with_token_in_query(req)
.await
.unwrap_or_else(|err| {
panic!("test_calculate_with_token_in_query {name} should pass: {err:?}")
});
}
Ok(())
}
async fn calculate(req_fn: fn() -> Request<&'static str>) -> Result<()> {
let _ = env_logger::builder().is_test(true).try_init();
let mut req = req_fn();
let name = format!(
"{} {} {:?}",
req.method(),
req.uri().path(),
req.uri().query(),
);
let now = Timestamp::now();
let mut ss = SigningSettings::default();
ss.percent_encoding_mode = PercentEncodingMode::Double;
ss.payload_checksum_kind = PayloadChecksumKind::XAmzSha256;
let id = Credentials::new(
"access_key_id",
"secret_access_key",
None,
None,
"hardcoded-credentials",
)
.into();
let sp = v4::SigningParams::builder()
.identity(&id)
.region("test")
.name("s3")
.time(now.as_system_time())
.settings(ss)
.build()
.expect("signing params must be valid");
let mut body = SignableBody::UnsignedPayload;
if req.headers().get(X_AMZ_CONTENT_SHA_256).is_some() {
body = SignableBody::Bytes(req.body().as_bytes());
}
let output = aws_sigv4::http_request::sign(
SignableRequest::new(
req.method().as_str(),
req.uri().to_string(),
req.headers()
.iter()
.map(|(k, v)| (k.as_str(), std::str::from_utf8(v.as_bytes()).unwrap())),
body,
)
.unwrap(),
&sp.into(),
)?;
let (aws_sig, _) = output.into_parts();
aws_sig.apply_to_request_http1x(&mut req);
let expected_req = req;
let req = req_fn();
let (mut parts, body) = req.into_parts();
let ctx = Context::new()
.with_file_read(TokioFileRead)
.with_http_send(ReqwestHttpSend::default());
let loader = StaticCredentialProvider::new("access_key_id", "secret_access_key");
let cred = loader.provide_credential(&ctx).await?.unwrap();
let builder = RequestSigner::new("s3", "test").with_time(now);
builder
.sign_request(&ctx, &mut parts, Some(&cred), None)
.await
.expect("must apply success");
let actual_req = Request::from_parts(parts, body);
compare_request(&name, &expected_req, &actual_req);
Ok(())
}
async fn calculate_in_query(req_fn: fn() -> Request<&'static str>) -> Result<()> {
let _ = env_logger::builder().is_test(true).try_init();
let mut req = req_fn();
let name = format!(
"{} {} {:?}",
req.method(),
req.uri().path(),
req.uri().query(),
);
let now = Timestamp::now();
let mut ss = SigningSettings::default();
ss.percent_encoding_mode = PercentEncodingMode::Double;
ss.payload_checksum_kind = PayloadChecksumKind::XAmzSha256;
ss.signature_location = SignatureLocation::QueryParams;
ss.expires_in = Some(Duration::from_secs(3600));
let id = Credentials::new(
"access_key_id",
"secret_access_key",
None,
None,
"hardcoded-credentials",
)
.into();
let sp = v4::SigningParams::builder()
.identity(&id)
.region("test")
.name("s3")
.time(now.as_system_time())
.settings(ss)
.build()
.expect("signing params must be valid");
let mut body = SignableBody::UnsignedPayload;
if req.headers().get(X_AMZ_CONTENT_SHA_256).is_some() {
body = SignableBody::Bytes(req.body().as_bytes());
}
let output = aws_sigv4::http_request::sign(
SignableRequest::new(
req.method().as_str(),
req.uri().to_string(),
req.headers()
.iter()
.map(|(k, v)| (k.as_str(), std::str::from_utf8(v.as_bytes()).unwrap())),
body,
)
.unwrap(),
&sp.into(),
)
.expect("signing must succeed");
let (aws_sig, _) = output.into_parts();
aws_sig.apply_to_request_http1x(&mut req);
let expected_req = req;
let req = req_fn();
let (mut parts, body) = req.into_parts();
let ctx = Context::new()
.with_file_read(TokioFileRead)
.with_http_send(ReqwestHttpSend::default());
let loader = StaticCredentialProvider::new("access_key_id", "secret_access_key");
let cred = loader.provide_credential(&ctx).await?.unwrap();
let builder = RequestSigner::new("s3", "test").with_time(now);
builder
.sign_request(
&ctx,
&mut parts,
Some(&cred),
Some(Duration::from_secs(3600)),
)
.await?;
let actual_req = Request::from_parts(parts, body);
compare_request(&name, &expected_req, &actual_req);
Ok(())
}
async fn test_calculate_with_token(req_fn: fn() -> Request<&'static str>) -> Result<()> {
let _ = env_logger::builder().is_test(true).try_init();
let mut req = req_fn();
let name = format!(
"{} {} {:?}",
req.method(),
req.uri().path(),
req.uri().query(),
);
let now = Timestamp::now();
let mut ss = SigningSettings::default();
ss.percent_encoding_mode = PercentEncodingMode::Double;
ss.payload_checksum_kind = PayloadChecksumKind::XAmzSha256;
let id = Credentials::new(
"access_key_id",
"secret_access_key",
Some("security_token".to_string()),
None,
"hardcoded-credentials",
)
.into();
let sp = v4::SigningParams::builder()
.identity(&id)
.region("test")
.name("s3")
.time(now.as_system_time())
.settings(ss)
.build()
.expect("signing params must be valid");
let mut body = SignableBody::UnsignedPayload;
if req.headers().get(X_AMZ_CONTENT_SHA_256).is_some() {
body = SignableBody::Bytes(req.body().as_bytes());
}
let output = aws_sigv4::http_request::sign(
SignableRequest::new(
req.method().as_str(),
req.uri().to_string(),
req.headers()
.iter()
.map(|(k, v)| (k.as_str(), std::str::from_utf8(v.as_bytes()).unwrap())),
body,
)
.unwrap(),
&sp.into(),
)
.expect("signing must succeed");
let (aws_sig, _) = output.into_parts();
aws_sig.apply_to_request_http1x(&mut req);
let expected_req = req;
let req = req_fn();
let (mut parts, body) = req.into_parts();
let ctx = Context::new()
.with_file_read(TokioFileRead)
.with_http_send(ReqwestHttpSend::default());
let loader = StaticCredentialProvider::new("access_key_id", "secret_access_key")
.with_session_token("security_token");
let cred = loader.provide_credential(&ctx).await?.unwrap();
let builder = RequestSigner::new("s3", "test").with_time(now);
builder
.sign_request(&ctx, &mut parts, Some(&cred), None)
.await
.expect("must apply success");
let actual_req = Request::from_parts(parts, body);
compare_request(&name, &expected_req, &actual_req);
Ok(())
}
async fn test_calculate_with_token_in_query(
req_fn: fn() -> Request<&'static str>,
) -> Result<()> {
let _ = env_logger::builder().is_test(true).try_init();
let mut req = req_fn();
let name = format!(
"{} {} {:?}",
req.method(),
req.uri().path(),
req.uri().query(),
);
let now = Timestamp::now();
let mut ss = SigningSettings::default();
ss.percent_encoding_mode = PercentEncodingMode::Double;
ss.payload_checksum_kind = PayloadChecksumKind::XAmzSha256;
ss.signature_location = SignatureLocation::QueryParams;
ss.expires_in = Some(Duration::from_secs(3600));
let id = Credentials::new(
"access_key_id",
"secret_access_key",
Some("security_token".to_string()),
None,
"hardcoded-credentials",
)
.into();
let sp = v4::SigningParams::builder()
.identity(&id)
.region("test")
.name("s3")
.time(now.as_system_time())
.settings(ss)
.build()
.expect("signing params must be valid");
let mut body = SignableBody::UnsignedPayload;
if req.headers().get(X_AMZ_CONTENT_SHA_256).is_some() {
body = SignableBody::Bytes(req.body().as_bytes());
}
let output = aws_sigv4::http_request::sign(
SignableRequest::new(
req.method().as_str(),
req.uri().to_string(),
req.headers()
.iter()
.map(|(k, v)| (k.as_str(), std::str::from_utf8(v.as_bytes()).unwrap())),
body,
)
.unwrap(),
&sp.into(),
)
.expect("signing must succeed");
let (aws_sig, _) = output.into_parts();
aws_sig.apply_to_request_http1x(&mut req);
let expected_req = req;
let req = req_fn();
let (mut parts, body) = req.into_parts();
let ctx = Context::new()
.with_file_read(TokioFileRead)
.with_http_send(ReqwestHttpSend::default());
let loader = StaticCredentialProvider::new("access_key_id", "secret_access_key")
.with_session_token("security_token");
let cred = loader.provide_credential(&ctx).await?.unwrap();
let builder = RequestSigner::new("s3", "test").with_time(now);
builder
.sign_request(
&ctx,
&mut parts,
Some(&cred),
Some(Duration::from_secs(3600)),
)
.await
.expect("must apply success");
let actual_req = Request::from_parts(parts, body);
compare_request(&name, &expected_req, &actual_req);
Ok(())
}
}