AWS AmazonS3: S3 replication walkthrough: include/exclude filters and KMS encryption
Summary
Updates the S3 replication rule console walkthrough: renames prefix/tag filter fields to 'Include prefix'/'Add include tag', adds new 'Add exclude prefix'/'Add exclude tag' options for skipping objects, simplifies the SSE-KMS encryption step to a 'Replicate' choice, adds Encryption key type options (source Multi-Region key vs. specify destination key), and updates the JSON filter example to use an And/Not prefix exclusion.
Security assessment
The change documents how to configure replication of SSE-KMS-encrypted objects, including choosing source Multi-Region keys or specifying a destination KMS key, which determines which encryption keys protect replicated data. It also documents include/exclude prefix and tag filters that control which objects are copied. This is feature/UI documentation and encryption configuration guidance, not a fix for a specific vulnerability or incident.
Evidence
+ 11. To replicate objects encrypted with AWS KMS keys (SSE-KMS), under **Encryption** , choose **Replicate**. For information about using AWS KMS with replication, see [Replicating encrypted objects (SSE-S3, SSE-KMS, DSSE-KMS, SSE-C)](./replication-config-for-kms-objects.html).
Diff
diff --git a/AmazonS3/latest/userguide/replication-walkthrough1.md b/AmazonS3/latest/userguide/replication-walkthrough1.md index 9f615e2..910f423 100644 --- a//AmazonS3/latest/userguide/replication-walkthrough1.md +++ b//AmazonS3/latest/userguide/replication-walkthrough1.md @@ -56 +56 @@ If the destination bucket is in a different account from the source bucket, you - * To replicate all objects that have the same prefix, choose **Limit the scope of this rule using one or more filters**. This limits replication to all objects that have names that begin with the prefix that you specify (for example `pictures`). Enter a prefix in the **Prefix** box. + * To replicate all objects that have the same prefix, choose **Limit the scope of this rule using one or more filters**. This limits replication to all objects that have names that begin with the prefix that you specify (for example `pictures`). Enter a prefix in the **Include prefix** box. To exclude objects from the whole bucket instead, leave **Include prefix** blank and add exclusions. @@ -62 +62,3 @@ If you enter a prefix that is the name of a folder, you must use **/** (forward - * To replicate all objects with one or more object tags, choose **Add tag** and enter the key-value pair in the boxes. Repeat the procedure to add another tag. You can combine a prefix and tags. For more information about object tags, see [Tagging your objects](./object-tagging.html). + * To replicate all objects with one or more object tags, choose **Add include tag** and enter the key-value pair in the boxes. Repeat the procedure to add another tag. You can combine a prefix and tags. For more information about object tags, see [Tagging your objects](./object-tagging.html). + + * To skip objects within the rule's scope, choose **Add exclude prefix** or **Add exclude tag** , and enter the prefix or the key-value pair. You can add more than one of each. For more information, see [Excluding objects from a rule](./replication-add-config.html#replication-config-exclude). @@ -96,3 +98 @@ When you add a replication rule to a bucket, you must have the `iam:PassRole` pe - 11. To replicate objects in the source bucket that are encrypted with server-side encryption with AWS Key Management Service (AWS KMS) keys (SSE-KMS), under **Encryption** , select **Replicate objects encrypted with AWS KMS**. Under **AWS KMS keys for encrypting destination objects** are the source keys that you allow replication to use. All source KMS keys are included by default. To narrow the KMS key selection, you can choose an alias or key ID. - -Objects encrypted by AWS KMS keys that you do not select are not replicated. A KMS key or a group of KMS keys is chosen for you, but you can choose the KMS keys if you want. For information about using AWS KMS with replication, see [Replicating encrypted objects (SSE-S3, SSE-KMS, DSSE-KMS, SSE-C)](./replication-config-for-kms-objects.html). + 11. To replicate objects encrypted with AWS KMS keys (SSE-KMS), under **Encryption** , choose **Replicate**. For information about using AWS KMS with replication, see [Replicating encrypted objects (SSE-S3, SSE-KMS, DSSE-KMS, SSE-C)](./replication-config-for-kms-objects.html). @@ -110 +110,9 @@ If you chose to replicate objects encrypted with AWS KMS, do the following: - 1. Under **AWS KMS key for encrypting destination objects** , specify your KMS key in one of the following ways: + 1. Under **Encryption key type** , do one or both of the following: + + * If your objects are encrypted with multi-Region keys, select **Use source Multi-Region key**. + + * If your objects are encrypted with single-Region keys, select **Specify destination key** , and then choose the key in the next step. + +If you have both, select both. For more information, see [Using Multi-Region key resolution](./replication-config-for-kms-objects.html#replication-kms-multi-region-keys). + + 2. To specify a destination key, under **AWS KMS key for encrypting destination objects** , specify your KMS key in one of the following ways: @@ -326 +334,6 @@ Note - "Filter" : { "Prefix": "Tax"}, + "Filter": { + "And": { + "Prefix": "Tax", + "Not": { "Prefix": "Tax/drafts/" } + } + }, @@ -333,0 +347,2 @@ Note +This rule replicates objects with the `Tax` prefix, except objects under `Tax/drafts/`. +