AWS payment-cryptography medium security documentation change
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",