SwiftAWSSignatureV4

2.0.0

AWS's signature version 4 in cross-platform Swift
benspratling4/SwiftAWSSignatureV4

What's New

Correct issues with dates & queries

2020-04-28T22:42:41Z

Also updates tool versions, dependencies & sets minimum mac os version

SwiftAWSSignatureV4

AWS's signature version 4 in cross-platform Swift

Given a (mutable) URLRequest, sign with AWS Signature v4 using an instance of an AWSAccount, which would include your IAM credentials.

var request:URLRequest = ...
let account:AWSAccount = ...
request.sign(for:account)

With a simple Data as the .httpBody of the request, no chunking is used.

Appropriate date headers are added for you as part of the signing process. You should add all other headers which are part of the service, but not speciic to signing before signing, because the signing process signs the headers.

To use chunking, provide an InputStream as the .httpBodyStream of the request, and / or provide a value for the chunk size (in bytes):

request.sign(for:account, chunkSize:32568)

Chunking alters the .httpBodyStream, so do not alter the .httpBodyStream after signing.

Testing/ Platform Status

Signing without chunking has been tested on both macOS and Linux. Chunking has only been tested on macOS. Chunking is primarily useful for streams, which send data before reading the entire body in RAM. Stream support may be altered or improve on Linux in the near future.

Depends on IBM's BlueCryptor for platform-independent hashing.

Description

  • Swift Tools 5.0.0
View More Packages from this Author

Dependencies

Last updated: Sun Mar 10 2024 23:38:35 GMT-0900 (Hawaii-Aleutian Daylight Time)