Skip to content

Commit

Permalink
Add documentation for using SSE-C on S3 primary storage
Browse files Browse the repository at this point in the history
Signed-off-by: Julius Härtl <jus@bitgrid.net>
  • Loading branch information
juliusknorr committed Nov 22, 2022
1 parent 33d6f32 commit 8789cf9
Showing 1 changed file with 36 additions and 0 deletions.
36 changes: 36 additions & 0 deletions admin_manual/configuration_files/primary_storage.rst
Original file line number Diff line number Diff line change
Expand Up @@ -182,3 +182,39 @@ all files for that user in their corresponding bucket.

You can find out more information about upscaling with object storage and Nextcloud in the
`Nextcloud customer portal <https://portal.nextcloud.com/article/object-store-as-primary-storage-16.html>`_.


------------------------
SSE-C encryption support
------------------------

Nextcloud added support for server side encryption (also known as SSE-C) with AWS.

This means Nextcloud can encrypt files such storage, using a client provided key, the moment they are uploaded. The decryption key is provided by the client. We are using the `SSE-C provided by AWS <http://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html>`_ and to do this for Amazon AWS, the client has to specify exact information, so these options we provide in Nextcloud config:

The key can be specified with the :code:`sse_c_key` parameter which needs to be provided as a base64 encoded string with a maximum length of 32 bytes, if it does not meet the requirements. The key can be generated using the the following command:

::
openssl rand 32 | base64


::

'objectstore' => [
array (
'class' => 'OC\\Files\\ObjectStore\\S3',
'arguments' =>
array (
'bucket' => 'nextcloud',
'key' => 'nextcloud',
'secret' => 'nextcloud',
'hostname' => 's3',
'port' => '443',
'use_ssl' => true,
'use_path_style' => true,
'autocreate' => true,
'verify_bucket_exists' => true,
'sse_c_key' => 'o9d3Q9tHcPMv6TIpH53MSXaUmY91YheZRwuIhwCFRSs=',
),
);
],

0 comments on commit 8789cf9

Please sign in to comment.