Configuring AWS Key Management Service - Configuring AWS Key Management Service - Alfresco - Alfresco Content Connector for AWS S3 - Alfresco/Alfresco-Content-Connector-for-AWS-S3/6.1/Alfresco-Content-Connector-for-AWS-S3/Configure/Configuring-Content-Connector-for-AWS-S3/Configuring-AWS-Key-Management-Service - 6.1 - 6.1

Alfresco Content Connector for AWS S3

Platform
Alfresco
Product
Alfresco Content Connector for AWS S3
Release
6.1
License
ft:lastPublication
2026-01-23T13:23:45.694000
ft:locale
en-US

AWS Key Management Service (KMS) is a managed service that makes it easy for you to create and control the encryption keys used to encrypt your content.

The primary resources in AWS KMS are customer master keys (CMKs). These are either customer-managed or AWS-managed. You can use either type of CMK to protect data encryption keys (or data keys) which are then used to encrypt or decrypt content stored by Alfresco Content Services in AWS S3. CMKs never leave AWS KMS unencrypted, but data keys can.

For more details, see the information on AWS KMS Concepts and How Envelope Encryption Works with Supported AWS Services in the AWS documentation.

To learn more about how AWS KMS uses cryptography and secures master keys, see the AWS Key Management Service Cryptographic Details whitepaper.

The S3 Connector provides the following encryption options:

Property setting Description
connector.s3.encryption Setting connector.s3.encryption=none means content stored in S3 is unencrypted. Note: Storing your content unencrypted isn’t recommended.
connector.s3.encryption=aes256 The content store is encrypted using AWS managed encryption.
connector.s3.encryption=kms The content store is encrypted using AWS KMS managed encryption.
Note: If the connector.s3.encryption property is missing, then the content store is AES256 encrypted by AWS-managed encryption.

For more information about each of these encryption options, see the Encryption overviewEncryption overview.

You can configure AWS KMS by adding the relevant properties to the global properties file.

  1. Edit alfresco-global.properties to set the server-encryption algorithm to KMS:
    connector.s3.encryption=kms
    

    If you plan to use the AWS-managed default master key then continue from step 4.

  2. To use a customer master key, either create a new KMS key using the AWS steps described in the AWS documentation, or use a CMK by importing your existing key material.
  3. Edit alfresco-global.properties and set the value of connector.s3.awsKmsKeyId property to the key alias (see example) or the Amazon Resource Name (ARN) of the KMS key created.
    connector.s3.awsKmsKeyId=alias/kmsKeyAlias
    

    You can leave the property empty in order to use the default master key attached to your account.

  4. You are now ready to start Alfresco Content Services.