# ServerSideEncryptionRuleProperty

Specifies the default server-side encryption configuration.

> - *General purpose buckets* - If you're specifying a customer managed KMS key, we recommend using a fully qualified KMS key ARN. If you use a KMS key alias instead, then AWS  resolves the key within the requester’s account. This behavior can result in data that's encrypted with a KMS key that belongs to the requester, and not the bucket owner.
> - *Directory buckets* - When you specify an [AWS  customer managed key](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) for encryption in your directory bucket, only use the key ID or key ARN. The key alias format of the KMS key isn't supported.

- Source: Generated at build time
- Type last changed: v2.230.0 · 26 Nov 2025

## Example

TypeScript:

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_s3 as s3 } from 'aws-cdk-lib';
const serverSideEncryptionRuleProperty: s3.CfnBucket.ServerSideEncryptionRuleProperty = {
  blockedEncryptionTypes: {
    encryptionType: ['encryptionType'],
  },
  bucketKeyEnabled: false,
  serverSideEncryptionByDefault: {
    sseAlgorithm: 'sseAlgorithm',

    // the properties below are optional
    kmsMasterKeyId: 'kmsMasterKeyId',
  },
};
```

Python:

```python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_s3 as s3

server_side_encryption_rule_property = s3.CfnBucket.ServerSideEncryptionRuleProperty(
    blocked_encryption_types=s3.CfnBucket.BlockedEncryptionTypesProperty(
        encryption_type=["encryptionType"]
    ),
    bucket_key_enabled=False,
    server_side_encryption_by_default=s3.CfnBucket.ServerSideEncryptionByDefaultProperty(
        sse_algorithm="sseAlgorithm",

        # the properties below are optional
        kms_master_key_id="kmsMasterKeyId"
    )
)
```

Java:

```java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.s3.*;

ServerSideEncryptionRuleProperty serverSideEncryptionRuleProperty = ServerSideEncryptionRuleProperty.builder()
        .blockedEncryptionTypes(BlockedEncryptionTypesProperty.builder()
                .encryptionType(List.of("encryptionType"))
                .build())
        .bucketKeyEnabled(false)
        .serverSideEncryptionByDefault(ServerSideEncryptionByDefaultProperty.builder()
                .sseAlgorithm("sseAlgorithm")

                // the properties below are optional
                .kmsMasterKeyId("kmsMasterKeyId")
                .build())
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.S3;

var serverSideEncryptionRuleProperty = new ServerSideEncryptionRuleProperty {
    BlockedEncryptionTypes = new BlockedEncryptionTypesProperty {
        EncryptionType = new [] { "encryptionType" }
    },
    BucketKeyEnabled = false,
    ServerSideEncryptionByDefault = new ServerSideEncryptionByDefaultProperty {
        SseAlgorithm = "sseAlgorithm",

        // the properties below are optional
        KmsMasterKeyId = "kmsMasterKeyId"
    }
};
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import "github.com/aws/aws-cdk-go/awscdk"

serverSideEncryptionRuleProperty := &ServerSideEncryptionRuleProperty{
	BlockedEncryptionTypes: &BlockedEncryptionTypesProperty{
		EncryptionType: []*string{
			jsii.String("encryptionType"),
		},
	},
	BucketKeyEnabled: jsii.Boolean(false),
	ServerSideEncryptionByDefault: &ServerSideEncryptionByDefaultProperty{
		SseAlgorithm: jsii.String("sseAlgorithm"),

		// the properties below are optional
		KmsMasterKeyId: jsii.String("kmsMasterKeyId"),
	},
}
```

## Properties

- `blockedEncryptionTypes`: [IResolvable](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnBucket.BlockedEncryptionTypesProperty](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_s3.CfnBucket.BlockedEncryptionTypesProperty.html) — A bucket-level setting for Amazon S3 general purpose buckets used to prevent the upload of new objects encrypted with the specified server-side encryption type.

  For example, blocking an encryption type will block `PutObject` , `CopyObject` , `PostObject` , multipart upload, and replication requests to the bucket for objects with the specified encryption type. However, you can continue to read and list any pre-existing objects already encrypted with the specified encryption type. For more information, see [Blocking or unblocking SSE-C for a general purpose bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/blocking-unblocking-s3-c-encryption-gpb.html) .

  > Currently, this parameter only supports blocking or unblocking server-side encryption with customer-provided keys (SSE-C). For more information about SSE-C, see [Using server-side encryption with customer-provided keys (SSE-C)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html) .

- `bucketKeyEnabled`: boolean | [IResolvable](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) — Specifies whether Amazon S3 should use an S3 Bucket Key with server-side encryption using KMS (SSE-KMS) for new objects in the bucket.

  Existing objects are not affected. Setting the `BucketKeyEnabled` element to `true` causes Amazon S3 to use an S3 Bucket Key. By default, S3 Bucket Key is not enabled.

  For more information, see [Amazon S3 Bucket Keys](https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html) in the *Amazon S3 User Guide* .

- `serverSideEncryptionByDefault`: [IResolvable](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnBucket.ServerSideEncryptionByDefaultProperty](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_s3.CfnBucket.ServerSideEncryptionByDefaultProperty.html) — Specifies the default server-side encryption to apply to new objects in the bucket.

  If a PUT Object request doesn't specify any server-side encryption, this default encryption will be applied.
