AWS Security ChangesHomeSearch

AWS kms: Adds DeriveSharedSecret log example and PCR17/ServiceName attestation fields

Service: kms · 2026-11-10 · Documentation medium

File: kms/latest/developerguide/ct-nitro-enclave.md · Type: logging

Summary

Adds a CloudTrail log example for DeriveSharedSecret (for an Enclave) and extends the existing Decrypt, GenerateDataKey, GenerateDataKeyPair and GenerateRandom examples with attestationDocumentEnclavePCR17 and attestationDocumentEnclavePCR8ServiceName fields; also standardizes 'Enclave' capitalization.

Security assessment

The change documents new attestation-derived fields (PCR17, PCR8ServiceName) and key-agreement events recorded in CloudTrail, which improve auditability and verification of which enclave/sandbox image used a KMS key; it is audit-logging documentation rather than a fix for a specific vulnerability.

Evidence

+                "attestationDocumentEnclavePCR17": "<AttestationDocument.PCR17>",

Diff

diff --git a/kms/latest/developerguide/ct-nitro-enclave.md b/kms/latest/developerguide/ct-nitro-enclave.md
index 3625eec..a0947c9 100644
--- a//kms/latest/developerguide/ct-nitro-enclave.md
+++ b//kms/latest/developerguide/ct-nitro-enclave.md
@@ -7 +7 @@
-Decrypt (for an enclave)GenerateDataKey (for an enclave)GenerateDataKeyPair (for an enclave)GenerateRandom (for an enclave)
+Decrypt (for an Enclave)DeriveSharedSecret (for an Enclave)GenerateDataKey (for an Enclave)GenerateDataKeyPair (for an Enclave)GenerateRandom (for an Enclave)
@@ -17 +17 @@ This section shows an example CloudTrail log entry for each of the supported Nit
-## Decrypt (for an enclave)
+## Decrypt (for an Enclave)
@@ -19 +19 @@ This section shows an example CloudTrail log entry for each of the supported Nit
-The following example shows an AWS CloudTrail log entry of a [Decrypt](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html) operation for an AWS Nitro enclave.
+The following example shows an AWS CloudTrail log entry of a [Decrypt](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html) operation for an AWS Nitro Enclave.
@@ -51 +51,3 @@ The following example shows an AWS CloudTrail log entry of a [Decrypt](https://d
-                "attestationDocumentEnclavePCR8": "<AttestationDocument.PCR8>"
+                "attestationDocumentEnclavePCR8": "<AttestationDocument.PCR8>",
+                "attestationDocumentEnclavePCR17": "<AttestationDocument.PCR17>",
+                "attestationDocumentEnclavePCR8ServiceName": "<ServiceName>"
@@ -70 +72 @@ Show moreShow less
-## GenerateDataKey (for an enclave)
+## DeriveSharedSecret (for an Enclave)
@@ -72 +74,55 @@ Show moreShow less
-The following example shows an AWS CloudTrail log entry of a [GenerateDataKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateDataKey.html) operation for an AWS Nitro enclave.
+The following example shows an AWS CloudTrail log entry of a [DeriveSharedSecret](https://docs.aws.amazon.com/kms/latest/APIReference/API_DeriveSharedSecret.html) operation for an AWS Nitro Enclave.
+    
+    
+    {
+        "eventVersion": "1.09",
+        "userIdentity": {
+            "type": "IAMUser",
+            "principalId": "EX_PRINCIPAL_ID",
+            "arn": "arn:aws:iam::111122223333:user/Alice",
+            "accountId": "111122223333",
+            "accessKeyId": "EXAMPLE_KEY_ID",
+            "userName": "Alice"
+        },
+        "eventTime": "2024-05-17T19:08:22Z",
+        "eventSource": "kms.amazonaws.com",
+        "eventName": "DeriveSharedSecret",
+        "awsRegion": "us-west-2",
+        "sourceIPAddress": "192.0.2.0",
+        "userAgent": "AWS Internal",
+        "requestParameters": {
+            "keyId": "1234abcd-12ab-34cd-56ef-1234567890ab",
+            "publicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEgUUW8niDuhiKDWYMZtisWdDQ8Kcxg8BOYbgDD5syoIBfdcmZot7A8e39xB7sli9LLEF73GRLFmRRmVHy4esFAw==",
+            "keyAgreementAlgorithm": "ECDH"
+        },
+        "responseElements": null,
+        "additionalEventData": {
+            **"recipient":{
+                "attestationDocumentModuleId": "i-123456789abcde123-enc123456789abcde12",
+                "attestationDocumentEnclaveImageDigest": "<AttestationDocument.PCR0>",
+                "attestationDocumentEnclavePCR1": "<AttestationDocument.PCR1>",
+                "attestationDocumentEnclavePCR2": "<AttestationDocument.PCR2>",
+                "attestationDocumentEnclavePCR3": "<AttestationDocument.PCR3>",
+                "attestationDocumentEnclavePCR4": "<AttestationDocument.PCR4>",
+                "attestationDocumentEnclavePCR8": "<AttestationDocument.PCR8>",
+                "attestationDocumentEnclavePCR17": "<AttestationDocument.PCR17>",
+                "attestationDocumentEnclavePCR8ServiceName": "<ServiceName>"
+            }**
+        },
+        "requestID": "12345126-30d5-4b28-98b9-9153da559963",
+        "eventID": "abcde202-ba1a-467c-b4ba-f729d45ae521",
+        "readOnly": true,
+        "resources": [{
+            "accountId": "111122223333",
+            "type": "AWS::KMS::Key",
+            "ARN": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
+        }],
+        "eventType": "AwsApiCall",
+        "recipientAccountId": "111122223333"
+    }
+
+Show moreShow less
+
+## GenerateDataKey (for an Enclave)
+
+The following example shows an AWS CloudTrail log entry of a [GenerateDataKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateDataKey.html) operation for an AWS Nitro Enclave.
@@ -104 +160,3 @@ The following example shows an AWS CloudTrail log entry of a [GenerateDataKey](h
-                "attestationDocumentEnclavePCR8": "<AttestationDocument.PCR8>"
+                "attestationDocumentEnclavePCR8": "<AttestationDocument.PCR8>",
+                "attestationDocumentEnclavePCR17": "<AttestationDocument.PCR17>",
+                "attestationDocumentEnclavePCR8ServiceName": "<ServiceName>"
@@ -120 +178 @@ Show moreShow less
-## GenerateDataKeyPair (for an enclave)
+## GenerateDataKeyPair (for an Enclave)
@@ -122 +180 @@ Show moreShow less
-The following example shows an AWS CloudTrail log entry of a [GenerateDataKeyPair](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateDataKeyPair.html) operation for an AWS Nitro enclave.
+The following example shows an AWS CloudTrail log entry of a [GenerateDataKeyPair](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateDataKeyPair.html) operation for an AWS Nitro Enclave.
@@ -157 +215,3 @@ The following example shows an AWS CloudTrail log entry of a [GenerateDataKeyPai
-                "attestationDocumentEnclavePCR8": "<AttestationDocument.PCR8>"
+                "attestationDocumentEnclavePCR8": "<AttestationDocument.PCR8>",
+                "attestationDocumentEnclavePCR17": "<AttestationDocument.PCR17>",
+                "attestationDocumentEnclavePCR8ServiceName": "<ServiceName>"
@@ -176 +236 @@ Show moreShow less
-## GenerateRandom (for an enclave)
+## GenerateRandom (for an Enclave)
@@ -178 +238 @@ Show moreShow less
-The following example shows an AWS CloudTrail log entry of a [GenerateRandom](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateRandom.html) operation for an AWS Nitro enclave.
+The following example shows an AWS CloudTrail log entry of a [GenerateRandom](https://docs.aws.amazon.com/kms/latest/APIReference/API_GenerateRandom.html) operation for an AWS Nitro Enclave.
@@ -207 +267,3 @@ The following example shows an AWS CloudTrail log entry of a [GenerateRandom](ht
-                "attestationDocumentEnclavePCR8": "<AttestationDocument.PCR8>"
+                "attestationDocumentEnclavePCR8": "<AttestationDocument.PCR8>",
+                "attestationDocumentEnclavePCR17": "<AttestationDocument.PCR17>",
+                "attestationDocumentEnclavePCR8ServiceName": "<ServiceName>"