AWS kms: Adds DeriveSharedSecret log example and PCR17/ServiceName attestation fields
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>"