AWS AmazonS3: Document verifying hybrid post-quantum TLS via CloudTrail keyExchange
Summary
Adds a new section explaining how AWS CloudTrail records the TLS key exchange in the tlsDetails.keyExchange field, lists the possible values (X25519MLKEM768, SecP256r1MLKEM768, x25519, secp256r1/secp384r1) with a sample event, updates the PQ-TLS client configuration link, removes AWS PrivateLink from the unsupported-endpoints note, and clarifies that S3 server access logs do not record key exchange.
Security assessment
The change documents how to audit whether requests use hybrid post-quantum TLS (ML-KEM) versus classical key exchange, strengthening visibility into encryption-in-transit posture. It is feature/audit documentation rather than a fix for a specific vulnerability, so it is not tied to a concrete incident.
Evidence
+AWS CloudTrail records the key exchange used for each request to Amazon S3 in the `keyExchange` field of the `tlsDetails` element.
Diff
diff --git a/AmazonS3/latest/userguide/UsingEncryptionInTransit.PQ-TLS.md b/AmazonS3/latest/userguide/UsingEncryptionInTransit.PQ-TLS.md index 70780b2..c414d12 100644 --- a//AmazonS3/latest/userguide/UsingEncryptionInTransit.PQ-TLS.md +++ b//AmazonS3/latest/userguide/UsingEncryptionInTransit.PQ-TLS.md @@ -7 +7 @@ -Using PQ-TLS with S3Learn more +Using PQ-TLS with S3Verify with CloudTrailLearn more @@ -21 +21 @@ Note -Hybrid post-quantum TLS is supported for all S3 endpoints except for AWS PrivateLink for Amazon S3, Multi-Region Access Points, and S3 Vectors. +Hybrid post-quantum TLS is supported for all S3 endpoints except for Multi-Region Access Points. @@ -33 +33,32 @@ Hybrid post-quantum TLS is only used for encryption in transit. This protects yo -The use of hybrid post-quantum TLS requires using a client that supports this functionality. AWS SDKs and tools have cryptographic capabilities and configuration that differ across languages and runtimes. To learn more about post-quantum cryptography for specific tools, see [Enabling hybrid post-quantum TLS](https://docs.aws.amazon.com/payment-cryptography/latest/userguide/pqtls-details.html). +The use of hybrid post-quantum TLS requires using a client that supports this functionality. AWS SDKs and tools have cryptographic capabilities and configuration that differ across languages and runtimes. To learn more about post-quantum cryptography for specific tools, see [Enabling hybrid post-quantum TLS](https://docs.aws.amazon.com/sdkref/latest/guide/pqtls-details.html) in the _AWS SDKs and Tools Reference Guide_. For a configuration example, see [Configuring hybrid post-quantum TLS for your client](./pqtls-how-to.html). + +## Verifying hybrid post-quantum TLS with AWS CloudTrail + +AWS CloudTrail records the key exchange used for each request to Amazon S3 in the `keyExchange` field of the `tlsDetails` element. You can use this field to confirm that your clients use hybrid post-quantum TLS, and to find clients that still use classical key exchange. For more information about `tlsDetails`, see [CloudTrail record contents](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html) in the _AWS CloudTrail User Guide_. + +The `keyExchange` field contains one of the following values: + +Value | Meaning +---|--- +`X25519MLKEM768` | Hybrid post-quantum key exchange (X25519 with ML-KEM-768), TLS 1.3 +`SecP256r1MLKEM768` | Hybrid post-quantum key exchange (P-256 with ML-KEM-768), TLS 1.3 +`x25519` | Classical elliptic curve key exchange, TLS 1.3 or TLS 1.2 +`secp256r1`, `secp384r1` | Classical elliptic curve key exchange, TLS 1.3 or TLS 1.2 + +The following example shows the `tlsDetails` element of a CloudTrail event for a request that used hybrid post-quantum TLS. + + + { + "eventVersion": "1.11", + "eventSource": "s3.amazonaws.com", + "eventName": "ListBuckets", + "awsRegion": "us-east-2", + "userAgent": "aws-cli/2.40.1 ...", + "tlsDetails": { + "tlsVersion": "TLSv1.3", + "cipherSuite": "TLS_AES_128_GCM_SHA256", + "clientProvidedHostHeader": "s3.us-east-2.amazonaws.com", + "keyExchange": "X25519MLKEM768" + }, + ... + } @@ -37 +68 @@ Note -PQ-TLS key exchange details for requests to Amazon S3 are not available in AWS CloudTrail events or S3 server access logs. +Amazon S3 server access logs record the TLS version and cipher suite for each request, but not the key exchange.