AWS kms: Refresh KMS Decrypt CLI examples and reference links
Summary
Updated wording, example key IDs, command formatting, and replaced API reference links with AWS KMS cryptography essentials links.
Security assessment
Cosmetic example and link updates for the Decrypt command; no change to cryptographic behavior or a vulnerability.
Evidence
For more information, see [AWS KMS cryptography essentials](https://docs.aws.amazon.com/kms/latest/developerguide/kms-cryptography.html#symmetric-key-0ps) in the _AWS Key Management Service Developer Guide_.
Diff
diff --git a/kms/latest/developerguide/example_kms_Decrypt_section.md b/kms/latest/developerguide/example_kms_Decrypt_section.md index a8c4fe3..648aad3 100644 --- a//kms/latest/developerguide/example_kms_Decrypt_section.md +++ b//kms/latest/developerguide/example_kms_Decrypt_section.md @@ -26 +26 @@ CLI -The following `decrypt` command example demonstrates the recommended way to decrypt data with the AWS CLI. This version shows how to decrypt data under a symmetric KMS key. +The following `decrypt` example demonstrates the recommended way to decrypt data with the AWS CLI. This version shows how to decrypt data under a symmetric KMS key. @@ -35 +35 @@ Before running this command, replace the example key ID with a valid key ID from - --key-id 1234abcd-12ab-34cd-56ef-1234567890ab \ + --key-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ @@ -37,2 +37 @@ Before running this command, replace the example key ID with a valid key ID from - --query Plaintext | base64 \ - --decode > ExamplePlaintextFile + --query Plaintext | base64 --decode > ExamplePlaintextFile @@ -43 +42 @@ This command produces no output. The output from the `decrypt` command is base64 -For more information, see [Decrypt](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html) in the _AWS Key Management Service API Reference_. +For more information, see [AWS KMS cryptography essentials](https://docs.aws.amazon.com/kms/latest/developerguide/kms-cryptography.html#symmetric-key-0ps) in the _AWS Key Management Service Developer Guide_. @@ -47 +46 @@ For more information, see [Decrypt](https://docs.aws.amazon.com/kms/latest/APIRe -The following example is the same as the previous one except that it uses the `certutil` utility to Base64-decode the plaintext data. This procedure requires two commands, as shown in the following examples. +The following `decrypt` example is the same as the previous one except that it uses the `certutil` utility to Base64-decode the plaintext data. This procedure requires two commands, as shown in the following examples. @@ -54 +53 @@ Before running this command, replace the example key ID with a valid key ID from - --key-id 1234abcd-12ab-34cd-56ef-1234567890ab ^ + --key-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 ^ @@ -71 +70 @@ Output: -For more information, see [Decrypt](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html) in the _AWS Key Management Service API Reference_. +For more information, see [AWS KMS cryptography essentials](https://docs.aws.amazon.com/kms/latest/developerguide/kms-cryptography.html#symmetric-key-0ps) in the _AWS Key Management Service Developer Guide_. @@ -75 +74 @@ For more information, see [Decrypt](https://docs.aws.amazon.com/kms/latest/APIRe -The following `decrypt` command example shows how to decrypt data encrypted under an RSA asymmetric KMS key. +The following `decrypt` example shows how to decrypt data encrypted under an RSA asymmetric KMS key. @@ -84 +83 @@ Before running this command, replace the example key ID with a valid key ID from - --key-id 0987dcba-09fe-87dc-65ba-ab0987654321 \ + --key-id a1b2c3d4-5678-90ab-cdef-EXAMPLE22222 \ @@ -87,2 +86 @@ Before running this command, replace the example key ID with a valid key ID from - --query Plaintext | base64 \ - --decode > ExamplePlaintextFile + --query Plaintext | base64 --decode > ExamplePlaintextFile