AWS Security ChangesHomeSearch

AWS payment-cryptography medium security documentation change

Service: payment-cryptography · 2025-11-16 · Security-related medium

File: payment-cryptography/latest/userguide/create-keys.md

Summary

Revised example output structure for key creation, including changes to KeyAttributes, KeyCheckValueAlgorithm (e.g., CMAC to SHA-1), and anonymized KeyArn account IDs

Security assessment

The change introduces SHA-1 for KeyCheckValueAlgorithm in some examples (a weaker algorithm than CMAC), which could indicate addressing documentation inaccuracies or security practices. It also adds explicit KeyModesOfUse configurations (e.g., DeriveKey, Verify) and Exportable flags, improving clarity on secure key management.

Diff

diff --git a/payment-cryptography/latest/userguide/create-keys.md b/payment-cryptography/latest/userguide/create-keys.md
index ec24699cc..16fc01c9b 100644
--- a//payment-cryptography/latest/userguide/create-keys.md
+++ b//payment-cryptography/latest/userguide/create-keys.md
@@ -30,4 +30,18 @@ Example output:
-      "eventVersion": "1.11",
-      "userIdentity": {
-        "accountId": "123456789012",
-        "invokedBy": "payment-cryptography.amazonaws.com"
+        "Key": {
+            "CreateTimestamp": "2022-10-26T16:04:11.642000-07:00",
+            "Enabled": true,
+            "Exportable": true,
+            "KeyArn": "FE23D3",
+            "KeyAttributes": {
+                "KeyAlgorithm": "TDES_3KEY",
+                "KeyClass": "SYMMETRIC_KEY",
+                "KeyModesOfUse": {
+                    "Decrypt": false,
+                    "DeriveKey": true,
+                    "Encrypt": false,
+                    "Generate": false,
+                    "NoRestrictions": false,
+                    "Sign": false,
+                    "Unwrap": false,
+                    "Verify": true,
+                    "Wrap": false
@@ -35,16 +49 @@ Example output:
-      "eventTime": "2025-08-15T17:50:41Z",
-      "eventSource": "payment-cryptography.amazonaws.com",
-      "eventName": "SynchronizeMultiRegionKey",
-      "awsRegion": "us-east-1",
-      "sourceIPAddress": "payment-cryptography.amazonaws.com",
-      "userAgent": "payment-cryptography.amazonaws.com",
-      "requestParameters": null,
-      "responseElements": null,
-      "eventID": "55c0fcbc-5b2e-4bd2-a976-99305be6e6fc",
-      "readOnly": false,
-      "eventType": "AwsServiceEvent",
-      "managementEvent": true,
-      "recipientAccountId": "123456789012",
-      "serviceEventDetails": {
-        "keyArn": "arn:aws:payment-cryptography:us-east-1:123456789012:key/kwapwa6qaifllw2h",
-        "replicationRegion": "us-east-2"
+                "KeyUsage": "TR31_B0_BASE_DERIVATION_KEY"
@@ -52 +51,5 @@ Example output:
-      "eventCategory": "Management"
+            "KeyCheckValue": "FE23D3",
+            "KeyCheckValueAlgorithm": "ANSI_X9_24",
+            "KeyOrigin": "AWS_PAYMENT_CRYPTOGRAPHY",
+            "KeyState": "CREATE_COMPLETE",
+            "UsageStartTimestamp": "2022-10-26T16:04:11.559000-07:00"
@@ -73 +75 @@ Example output:
-            "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/hjprdg5o4jtgs5tw",
+            "KeyArn": "arn:aws:payment-cryptography:us-east-2::key/7f7g4spf3xcklhzu",
@@ -90 +92 @@ Example output:
-            "KeyCheckValue": "B72F",
+            "KeyCheckValue": "AEA5CD",
@@ -115 +117 @@ Example output:
-            "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h",
+            "KeyArn": "arn:aws:payment-cryptography:us-east-2::key/ivi5ksfsuplneuyt",
@@ -132 +134 @@ Example output:
-            "KeyCheckValue": "9CA6",
+            "KeyCheckValue": "7CC9E2",
@@ -175 +177 @@ Example output:
-            "KeyCheckValueAlgorithm": "CMAC",
+            "KeyCheckValueAlgorithm": "SHA-1",
@@ -199 +201 @@ Example output:
-            "KeyArn": "arn:aws:payment-cryptography:us-east-2:111122223333:key/j4u4cmnzkelhc6yb",
+            "KeyArn": "arn:aws:payment-cryptography:us-east-2::key/37y2tsl45p5zjbh2",
@@ -216 +218 @@ Example output:
-            "KeyCheckValue": "5132",
+            "KeyCheckValue": "7F2363",
@@ -243 +245 @@ Example output:
-            "KeyArn": "arn:aws:payment-cryptography:us-west-2:075556953750:key/xzydvquw6ejfxnwq",
+            "KeyArn": "arn:aws:payment-cryptography:us-east-2::key/wc3rjsssguhxtilv",
@@ -260,2 +262,2 @@ Example output:
-            "KeyCheckValue": "7E34F19F",
-            "KeyCheckValueAlgorithm": "CMAC",
+            "KeyCheckValue": "",
+            "KeyCheckValueAlgorithm": "SHA-1",