api: streaming: organize code paths to accept unsigned and trailer
Some checks failed
ci/woodpecker/push/debug Pipeline failed
ci/woodpecker/pr/debug Pipeline failed

This commit is contained in:
Alex 2025-02-16 19:12:53 +01:00
parent 44a896f9b5
commit 7f10bad596

View file

@ -25,53 +25,60 @@ pub fn parse_streaming_body(
) -> Result<Request<ReqBody>, Error> { ) -> Result<Request<ReqBody>, Error> {
match checked_signature.content_sha256_header { match checked_signature.content_sha256_header {
ContentSha256Header::StreamingPayload { signed, trailer } => { ContentSha256Header::StreamingPayload { signed, trailer } => {
if trailer { if !signed && !trailer {
return Err(Error::bad_request( return Err(Error::bad_request(
"STREAMING-*-TRAILER is not supported by Garage", "STREAMING-UNSIGNED-PAYLOAD is not a valid combination",
));
}
if !signed {
return Err(Error::bad_request(
"STREAMING-UNSIGNED-PAYLOAD-* is not supported by Garage",
)); ));
} }
let signature = checked_signature let sign_params = if signed {
.signature_header let signature = checked_signature
.clone() .signature_header
.ok_or_bad_request("No signature provided")?; .clone()
let signature = hex::decode(signature) .ok_or_bad_request("No signature provided")?;
.ok() let signature = hex::decode(signature)
.and_then(|bytes| Hash::try_from(&bytes)) .ok()
.ok_or_bad_request("Invalid signature")?; .and_then(|bytes| Hash::try_from(&bytes))
.ok_or_bad_request("Invalid signature")?;
let secret_key = checked_signature let secret_key = checked_signature
.key .key
.as_ref() .as_ref()
.ok_or_bad_request("Cannot sign streaming payload without signing key")? .ok_or_bad_request("Cannot sign streaming payload without signing key")?
.state .state
.as_option() .as_option()
.ok_or_internal_error("Deleted key state")? .ok_or_internal_error("Deleted key state")?
.secret_key .secret_key
.to_string(); .to_string();
let date = req let date = req
.headers() .headers()
.get(X_AMZ_DATE) .get(X_AMZ_DATE)
.ok_or_bad_request("Missing X-Amz-Date field")? .ok_or_bad_request("Missing X-Amz-Date field")?
.to_str()?; .to_str()?;
let date: NaiveDateTime = NaiveDateTime::parse_from_str(date, LONG_DATETIME) let date: NaiveDateTime = NaiveDateTime::parse_from_str(date, LONG_DATETIME)
.ok_or_bad_request("Invalid date")?; .ok_or_bad_request("Invalid date")?;
let date: DateTime<Utc> = Utc.from_utc_datetime(&date); let date: DateTime<Utc> = Utc.from_utc_datetime(&date);
let scope = compute_scope(&date, region, service); let scope = compute_scope(&date, region, service);
let signing_hmac = crate::signature::signing_hmac(&date, &secret_key, region, service) let signing_hmac =
.ok_or_internal_error("Unable to build signing HMAC")?; crate::signature::signing_hmac(&date, &secret_key, region, service)
.ok_or_internal_error("Unable to build signing HMAC")?;
Some(SignParams {
datetime: date,
scope,
signing_hmac,
previous_signature: signature,
})
} else {
None
};
Ok(req.map(move |body| { Ok(req.map(move |body| {
let stream = body_stream::<_, Error>(body); let stream = body_stream::<_, Error>(body);
let signed_payload_stream = let signed_payload_stream =
SignedPayloadStream::new(stream, signing_hmac, date, &scope, signature) StreamingPayloadStream::new(stream, sign_params, trailer)
.map(|x| x.map(hyper::body::Frame::data)) .map(|x| x.map(hyper::body::Frame::data))
.map_err(Error::from); .map_err(Error::from);
ReqBody::new(StreamBody::new(signed_payload_stream)) ReqBody::new(StreamBody::new(signed_payload_stream))
@ -122,13 +129,13 @@ mod payload {
} }
#[derive(Debug, Clone)] #[derive(Debug, Clone)]
pub struct Header { pub struct ChunkHeader {
pub size: usize, pub size: usize,
pub signature: Hash, pub signature: Option<Hash>,
} }
impl Header { impl ChunkHeader {
pub fn parse(input: &[u8]) -> nom::IResult<&[u8], Self, Error<&[u8]>> { pub fn parse_signed(input: &[u8]) -> nom::IResult<&[u8], Self, Error<&[u8]>> {
use nom::bytes::streaming::tag; use nom::bytes::streaming::tag;
use nom::character::streaming::hex_digit1; use nom::character::streaming::hex_digit1;
use nom::combinator::map_res; use nom::combinator::map_res;
@ -149,96 +156,136 @@ mod payload {
let (input, _) = try_parse!(tag("\r\n")(input)); let (input, _) = try_parse!(tag("\r\n")(input));
let header = Header { let header = ChunkHeader {
size: size as usize, size: size as usize,
signature, signature: Some(signature),
};
Ok((input, header))
}
pub fn parse_unsigned(input: &[u8]) -> nom::IResult<&[u8], Self, Error<&[u8]>> {
use nom::bytes::streaming::tag;
use nom::number::streaming::hex_u32;
macro_rules! try_parse {
($expr:expr) => {
$expr.map_err(|e| e.map(Error::Parser))?
};
}
let (input, size) = try_parse!(hex_u32(input));
let (input, _) = try_parse!(tag("\r\n")(input));
let header = ChunkHeader {
size: size as usize,
signature: None,
}; };
Ok((input, header)) Ok((input, header))
} }
} }
#[derive(Debug, Clone)]
pub struct TrailerChunk {
pub content: String,
pub signature: Option<Hash>,
}
impl TrailerChunk {
pub fn parse_signed(input: &[u8]) -> nom::IResult<&[u8], Self, Error<&[u8]>> {
todo!()
}
pub fn parse_unsigned(input: &[u8]) -> nom::IResult<&[u8], Self, Error<&[u8]>> {
todo!()
}
}
} }
#[derive(Debug)] #[derive(Debug)]
pub enum SignedPayloadStreamError { pub enum StreamingPayloadError {
Stream(Error), Stream(Error),
InvalidSignature, InvalidSignature,
Message(String), Message(String),
} }
impl SignedPayloadStreamError { impl StreamingPayloadError {
fn message(msg: &str) -> Self { fn message(msg: &str) -> Self {
SignedPayloadStreamError::Message(msg.into()) StreamingPayloadError::Message(msg.into())
} }
} }
impl From<SignedPayloadStreamError> for Error { impl From<StreamingPayloadError> for Error {
fn from(err: SignedPayloadStreamError) -> Self { fn from(err: StreamingPayloadError) -> Self {
match err { match err {
SignedPayloadStreamError::Stream(e) => e, StreamingPayloadError::Stream(e) => e,
SignedPayloadStreamError::InvalidSignature => { StreamingPayloadError::InvalidSignature => {
Error::bad_request("Invalid payload signature") Error::bad_request("Invalid payload signature")
} }
SignedPayloadStreamError::Message(e) => { StreamingPayloadError::Message(e) => {
Error::bad_request(format!("Chunk format error: {}", e)) Error::bad_request(format!("Chunk format error: {}", e))
} }
} }
} }
} }
impl<I> From<payload::Error<I>> for SignedPayloadStreamError { impl<I> From<payload::Error<I>> for StreamingPayloadError {
fn from(err: payload::Error<I>) -> Self { fn from(err: payload::Error<I>) -> Self {
Self::message(err.description()) Self::message(err.description())
} }
} }
impl<I> From<nom::error::Error<I>> for SignedPayloadStreamError { impl<I> From<nom::error::Error<I>> for StreamingPayloadError {
fn from(err: nom::error::Error<I>) -> Self { fn from(err: nom::error::Error<I>) -> Self {
Self::message(err.code.description()) Self::message(err.code.description())
} }
} }
struct SignedPayload { enum StreamingPayloadChunk {
header: payload::Header, Chunk {
data: Bytes, header: payload::ChunkHeader,
data: Bytes,
},
Trailer(payload::TrailerChunk),
} }
#[pin_project::pin_project] struct SignParams {
pub struct SignedPayloadStream<S>
where
S: Stream<Item = Result<Bytes, Error>>,
{
#[pin]
stream: S,
buf: bytes::BytesMut,
datetime: DateTime<Utc>, datetime: DateTime<Utc>,
scope: String, scope: String,
signing_hmac: HmacSha256, signing_hmac: HmacSha256,
previous_signature: Hash, previous_signature: Hash,
} }
impl<S> SignedPayloadStream<S> #[pin_project::pin_project]
pub struct StreamingPayloadStream<S>
where where
S: Stream<Item = Result<Bytes, Error>>, S: Stream<Item = Result<Bytes, Error>>,
{ {
pub fn new( #[pin]
stream: S, stream: S,
signing_hmac: HmacSha256, buf: bytes::BytesMut,
datetime: DateTime<Utc>, signing: Option<SignParams>,
scope: &str, has_trailer: bool,
seed_signature: Hash, }
) -> Self {
impl<S> StreamingPayloadStream<S>
where
S: Stream<Item = Result<Bytes, Error>>,
{
pub fn new(stream: S, signing: Option<SignParams>, has_trailer: bool) -> Self {
Self { Self {
stream, stream,
buf: bytes::BytesMut::new(), buf: bytes::BytesMut::new(),
datetime, signing,
scope: scope.into(), has_trailer,
signing_hmac,
previous_signature: seed_signature,
} }
} }
fn parse_next(input: &[u8]) -> nom::IResult<&[u8], SignedPayload, SignedPayloadStreamError> { fn parse_next(
input: &[u8],
is_signed: bool,
has_trailer: bool,
) -> nom::IResult<&[u8], StreamingPayloadChunk, StreamingPayloadError> {
use nom::bytes::streaming::{tag, take}; use nom::bytes::streaming::{tag, take};
macro_rules! try_parse { macro_rules! try_parse {
@ -247,17 +294,30 @@ where
}; };
} }
let (input, header) = try_parse!(payload::Header::parse(input)); let (input, header) = if is_signed {
try_parse!(payload::ChunkHeader::parse_signed(input))
} else {
try_parse!(payload::ChunkHeader::parse_unsigned(input))
};
// 0-sized chunk is the last // 0-sized chunk is the last
if header.size == 0 { if header.size == 0 {
return Ok(( if has_trailer {
input, let (input, trailer) = if is_signed {
SignedPayload { try_parse!(payload::TrailerChunk::parse_signed(input))
header, } else {
data: Bytes::new(), try_parse!(payload::TrailerChunk::parse_unsigned(input))
}, };
)); return Ok((input, StreamingPayloadChunk::Trailer(trailer)));
} else {
return Ok((
input,
StreamingPayloadChunk::Chunk {
header,
data: Bytes::new(),
},
));
}
} }
let (input, data) = try_parse!(take::<_, _, nom::error::Error<_>>(header.size)(input)); let (input, data) = try_parse!(take::<_, _, nom::error::Error<_>>(header.size)(input));
@ -265,15 +325,15 @@ where
let data = Bytes::from(data.to_vec()); let data = Bytes::from(data.to_vec());
Ok((input, SignedPayload { header, data })) Ok((input, StreamingPayloadChunk::Chunk { header, data }))
} }
} }
impl<S> Stream for SignedPayloadStream<S> impl<S> Stream for StreamingPayloadStream<S>
where where
S: Stream<Item = Result<Bytes, Error>> + Unpin, S: Stream<Item = Result<Bytes, Error>> + Unpin,
{ {
type Item = Result<Bytes, SignedPayloadStreamError>; type Item = Result<Bytes, StreamingPayloadError>;
fn poll_next( fn poll_next(
self: Pin<&mut Self>, self: Pin<&mut Self>,
@ -284,55 +344,71 @@ where
let mut this = self.project(); let mut this = self.project();
loop { loop {
let (input, payload) = match Self::parse_next(this.buf) { let (input, payload) =
Ok(res) => res, match Self::parse_next(this.buf, this.signing.is_some(), *this.has_trailer) {
Err(nom::Err::Incomplete(_)) => { Ok(res) => res,
match futures::ready!(this.stream.as_mut().poll_next(cx)) { Err(nom::Err::Incomplete(_)) => {
Some(Ok(bytes)) => { match futures::ready!(this.stream.as_mut().poll_next(cx)) {
this.buf.extend(bytes); Some(Ok(bytes)) => {
continue; this.buf.extend(bytes);
} continue;
Some(Err(e)) => { }
return Poll::Ready(Some(Err(SignedPayloadStreamError::Stream(e)))) Some(Err(e)) => {
} return Poll::Ready(Some(Err(StreamingPayloadError::Stream(e))))
None => { }
return Poll::Ready(Some(Err(SignedPayloadStreamError::message( None => {
"Unexpected EOF", return Poll::Ready(Some(Err(StreamingPayloadError::message(
)))); "Unexpected EOF",
))));
}
} }
} }
Err(nom::Err::Error(e)) | Err(nom::Err::Failure(e)) => {
return Poll::Ready(Some(Err(e)))
}
};
match payload {
StreamingPayloadChunk::Chunk { data, header } => {
if let Some(signing) = this.signing.as_mut() {
let data_sha256sum = sha256sum(&data);
let expected_signature = compute_streaming_payload_signature(
&signing.signing_hmac,
signing.datetime,
&signing.scope,
signing.previous_signature,
data_sha256sum,
)
.map_err(|e| {
StreamingPayloadError::Message(format!(
"Could not build signature: {}",
e
))
})?;
if header.signature.unwrap() != expected_signature {
return Poll::Ready(Some(Err(StreamingPayloadError::InvalidSignature)));
}
signing.previous_signature = header.signature.unwrap();
}
*this.buf = input.into();
// 0-sized chunk is the last
if data.is_empty() {
// if there was a trailer, it would have been returned by the parser
assert!(!self.has_trailer);
return Poll::Ready(None);
}
return Poll::Ready(Some(Ok(data)));
} }
Err(nom::Err::Error(e)) | Err(nom::Err::Failure(e)) => { StreamingPayloadChunk::Trailer(trailer) => {
return Poll::Ready(Some(Err(e))) todo!()
} }
};
// 0-sized chunk is the last
if payload.data.is_empty() {
return Poll::Ready(None);
} }
let data_sha256sum = sha256sum(&payload.data);
let expected_signature = compute_streaming_payload_signature(
this.signing_hmac,
*this.datetime,
this.scope,
*this.previous_signature,
data_sha256sum,
)
.map_err(|e| {
SignedPayloadStreamError::Message(format!("Could not build signature: {}", e))
})?;
if payload.header.signature != expected_signature {
return Poll::Ready(Some(Err(SignedPayloadStreamError::InvalidSignature)));
}
*this.buf = input.into();
*this.previous_signature = payload.header.signature;
return Poll::Ready(Some(Ok(payload.data)));
} }
} }
@ -345,7 +421,7 @@ where
mod tests { mod tests {
use futures::prelude::*; use futures::prelude::*;
use super::{SignedPayloadStream, SignedPayloadStreamError}; use super::{StreamingPayloadError, StreamingPayloadStream};
#[tokio::test] #[tokio::test]
async fn test_interrupted_signed_payload_stream() { async fn test_interrupted_signed_payload_stream() {
@ -368,11 +444,11 @@ mod tests {
let seed_signature = Hash::default(); let seed_signature = Hash::default();
let mut stream = let mut stream =
SignedPayloadStream::new(body, signing_hmac, datetime, &scope, seed_signature); StreamingPayloadStream::new(body, signing_hmac, datetime, &scope, seed_signature);
assert!(stream.try_next().await.is_err()); assert!(stream.try_next().await.is_err());
match stream.try_next().await { match stream.try_next().await {
Err(SignedPayloadStreamError::Message(msg)) if msg == "Unexpected EOF" => {} Err(StreamingPayloadError::Message(msg)) if msg == "Unexpected EOF" => {}
item => panic!( item => panic!(
"Unexpected result, expected early EOF error, got {:?}", "Unexpected result, expected early EOF error, got {:?}",
item item