Merge pull request #637 from nextcloud/s3-legacy-auth

document 'legacy_auth' option for s3

Author: MorrisJobke

admin_manual/configuration_files/external_storage/amazons3.rst

@@ -29,6 +29,9 @@ the DNS infrastructure cannot be controlled. Ordinarily, requests will be
 made with ``http://bucket.hostname.domain/``, but with path style enabled,
 requests are made with ``http://hostname.domain/bucket`` instead.
 
+**Legacy authentication** is only required for S3 servers that only implement version 2 authentication,
+on default version 4 authentication will be used.
+
 See :doc:`../external_storage_configuration_gui` for additional mount 
 options and information.
 

admin_manual/configuration_files/primary_storage.rst

@@ -86,7 +86,8 @@ The S3 backend mounts a bucket on an Amazon S3 Storage or compatible server into
 			'use_ssl' => true,
 			'region' => 'optional',
 			// required for some non amazon s3 implementations
-			'use_path_style'=>true
+			'use_path_style' => true,
+			'legacy_auth' => false
 		),
 	),
 
@@ -100,6 +101,9 @@ but can be used with non-Amazon servers where the DNS infrastructure cannot be c
 requests will be made with http://bucket.hostname.domain/, but with path style enabled,
 requests are made with http://hostname.domain/bucket instead.
 
+:code:`legacy_auth` is only required for S3 servers that only implement version 2 authentication,
+on default version 4 authentication will be used.
+
 Multibucket Object Store
 ---------------------------