curl/docs/cmdline-opts/aws-sigv4.d

Long: aws-sigv4
Arg: <provider1[:provider2[:region[:service]]]>
Help: Use AWS V4 signature authentication
Category: auth http
Added: 7.75.0
See-also: basic user
Example: --aws-sigv4 "aws:amz:east-2:es" --user "key:secret" $URL
---
Use AWS V4 signature authentication in the transfer.

The provider argument is a string that is used by the algorithm when creating
outgoing authentication headers.

The region argument is a string that points to a geographic area of
a resources collection (region-code) when the region name is omitted from
the endpoint.

The service argument is a string that points to a function provided by a cloud
(service-code) when the service name is omitted from the endpoint.
docs: add AWS HTTP v4 Signature 2020-07-03 20:50:06 +08:00			`Long: aws-sigv4`
http: improve AWS HTTP v4 Signature auth - Add support services without region and service prefixes in the URL endpoint (ex. Min.IO, GCP, Yandex Cloud, Mail.Ru Cloud Solutions, etc) by providing region and service parameters via aws-sigv4 option. - Add [:region[:service]] suffix to aws-sigv4 option; - Fix memory allocation errors. - Refactor memory management. - Use Curl_http_method instead() STRING_CUSTOMREQUEST. - Refactor canonical headers generating. - Remove repeated sha256_to_hex() usage. - Add some docs fixes. - Add some codestyle fixes. - Add overloaded strndup() for debug - curl_dbg_strndup(). - Update tests. Closes #6524 2021-01-25 22:02:09 +08:00			`Arg: <provider1[:provider2[:region[:service]]]>`
aws-sigv4.d: polish the wording Make it shorter and imperative form Closes #6439 2021-01-12 05:37:41 +08:00			`Help: Use AWS V4 signature authentication`
docs: add AWS HTTP v4 Signature 2020-07-03 20:50:06 +08:00			`Category: auth http`
			`Added: 7.75.0`
curl.1: require "see also" for every documented option gen.pl now generates a warning if the "See Also" field is not filled in for a command line option All command line options now provide one or more related options. 167 "See alsos" added! Closes #8019 2021-11-15 22:58:20 +08:00			`See-also: basic user`
curl.1: provide examples for each option The file format for each option now features a "Example:" header that can provide one or more examples that get rendered appropriately in the output. All options MUST have at least one example or gen.pl complains at build-time. This fix also does a few other minor format and consistency cleanups. Closes #7654 2021-08-31 22:37:14 +08:00			`Example: --aws-sigv4 "aws:amz:east-2:es" --user "key:secret" $URL`
docs: add AWS HTTP v4 Signature 2020-07-03 20:50:06 +08:00			`---`
aws-sigv4.d: polish the wording Make it shorter and imperative form Closes #6439 2021-01-12 05:37:41 +08:00			`Use AWS V4 signature authentication in the transfer.`
docs: add AWS HTTP v4 Signature 2020-07-03 20:50:06 +08:00
			`The provider argument is a string that is used by the algorithm when creating`
			`outgoing authentication headers.`
http: improve AWS HTTP v4 Signature auth - Add support services without region and service prefixes in the URL endpoint (ex. Min.IO, GCP, Yandex Cloud, Mail.Ru Cloud Solutions, etc) by providing region and service parameters via aws-sigv4 option. - Add [:region[:service]] suffix to aws-sigv4 option; - Fix memory allocation errors. - Refactor memory management. - Use Curl_http_method instead() STRING_CUSTOMREQUEST. - Refactor canonical headers generating. - Remove repeated sha256_to_hex() usage. - Add some docs fixes. - Add some codestyle fixes. - Add overloaded strndup() for debug - curl_dbg_strndup(). - Update tests. Closes #6524 2021-01-25 22:02:09 +08:00
			`The region argument is a string that points to a geographic area of`
			`a resources collection (region-code) when the region name is omitted from`
			`the endpoint.`

			`The service argument is a string that points to a function provided by a cloud`
			`(service-code) when the service name is omitted from the endpoint.`