summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorCasey Bodley <cbodley@redhat.com>2023-02-15 10:47:04 -0500
committerDaniel Stenberg <daniel@haxx.se>2023-03-14 17:04:47 +0100
commit495d09810aa9ad6ed70ad0cf122e12007f2b8ae1 (patch)
treecd94d3180d9b5eb2ca6bad3f861c9d4a21e745e1 /docs
parentebef55a61df0094b9790710a42f63c48e7de3c13 (diff)
downloadcurl-495d09810aa9ad6ed70ad0cf122e12007f2b8ae1.tar.gz
aws_sigv4: fall back to UNSIGNED-PAYLOAD for sign_as_s3
all s3 requests default to UNSIGNED-PAYLOAD and add the required x-amz-content-sha256 header. this allows CURLAUTH_AWS_SIGV4 to correctly sign s3 requests to amazon with no additional configuration Signed-off-by: Casey Bodley <cbodley@redhat.com> Closes #9995
Diffstat (limited to 'docs')
-rw-r--r--docs/libcurl/opts/CURLOPT_AWS_SIGV4.34
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/libcurl/opts/CURLOPT_AWS_SIGV4.3 b/docs/libcurl/opts/CURLOPT_AWS_SIGV4.3
index dfc0be8d6..d4519fc95 100644
--- a/docs/libcurl/opts/CURLOPT_AWS_SIGV4.3
+++ b/docs/libcurl/opts/CURLOPT_AWS_SIGV4.3
@@ -101,5 +101,9 @@ calculation. For POST requests, this is a checksum of the provided
\fICURLOPT_POSTFIELDS(3)\fP. Otherwise, it's the checksum of an empty buffer.
For requests like PUT, you can provide your own checksum in a HTTP header named
\fBx-provider2-content-sha256\fP.
+.PP
+For \fBaws:s3\fP, a \fBx-amz-content-sha256\fP header is added to every request
+if not already present. For s3 requests with unknown payload, this header takes
+the special value "UNSIGNED-PAYLOAD".
.SH "SEE ALSO"
.BR CURLOPT_HEADEROPT "(3), " CURLOPT_HTTPHEADER "(3), "