AWS Security ChangesHomeSearch

AWS AmazonS3: Document verifying hybrid post-quantum TLS via CloudTrail keyExchange

Service: AmazonS3 · 2026-11-18 · Documentation medium

File: AmazonS3/latest/userguide/UsingEncryptionInTransit.PQ-TLS.md · Type: encryption

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.