Skip to content

Commit 8789cf9

Browse files
committed
Add documentation for using SSE-C on S3 primary storage
Signed-off-by: Julius Härtl <jus@bitgrid.net>
1 parent 33d6f32 commit 8789cf9

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

admin_manual/configuration_files/primary_storage.rst

+36
Original file line numberDiff line numberDiff line change
@@ -182,3 +182,39 @@ all files for that user in their corresponding bucket.
182182

183183
You can find out more information about upscaling with object storage and Nextcloud in the
184184
`Nextcloud customer portal <https://portal.nextcloud.com/article/object-store-as-primary-storage-16.html>`_.
185+
186+
187+
------------------------
188+
SSE-C encryption support
189+
------------------------
190+
191+
Nextcloud added support for server side encryption (also known as SSE-C) with AWS.
192+
193+
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:
194+
195+
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:
196+
197+
::
198+
openssl rand 32 | base64
199+
200+
201+
::
202+
203+
'objectstore' => [
204+
array (
205+
'class' => 'OC\\Files\\ObjectStore\\S3',
206+
'arguments' =>
207+
array (
208+
'bucket' => 'nextcloud',
209+
'key' => 'nextcloud',
210+
'secret' => 'nextcloud',
211+
'hostname' => 's3',
212+
'port' => '443',
213+
'use_ssl' => true,
214+
'use_path_style' => true,
215+
'autocreate' => true,
216+
'verify_bucket_exists' => true,
217+
'sse_c_key' => 'o9d3Q9tHcPMv6TIpH53MSXaUmY91YheZRwuIhwCFRSs=',
218+
),
219+
);
220+
],

0 commit comments

Comments
 (0)