aboutsummaryrefslogtreecommitdiffstats
path: root/guides/source/active_storage_overview.md
diff options
context:
space:
mode:
authorBrian Knight <brianknight10@gmail.com>2018-03-19 11:25:40 -0400
committerAndrew White <pixeltrix@users.noreply.github.com>2018-03-19 15:25:40 +0000
commitc1600009b2bbb3b67db20ddb14fef34d4cfa82bc (patch)
treede8feeed47f1130158deba421175f266feb08c1c /guides/source/active_storage_overview.md
parentdb8cce202b8e81154773e5195a3ae35e873427e6 (diff)
downloadrails-c1600009b2bbb3b67db20ddb14fef34d4cfa82bc.tar.gz
rails-c1600009b2bbb3b67db20ddb14fef34d4cfa82bc.tar.bz2
rails-c1600009b2bbb3b67db20ddb14fef34d4cfa82bc.zip
Allow full use of the AWS S3 SDK authentication options (#32270)
If an explicit AWS key pair and/or region is not provided in config/storage.yml, attempt to use environment variables, shared credentials, or IAM role credentials. Order of precedence is determined by the AWS SDK[1]. [1]: https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/setup-config.html
Diffstat (limited to 'guides/source/active_storage_overview.md')
-rw-r--r--guides/source/active_storage_overview.md7
1 files changed, 7 insertions, 0 deletions
diff --git a/guides/source/active_storage_overview.md b/guides/source/active_storage_overview.md
index 831a02a9a1..d67f65e88a 100644
--- a/guides/source/active_storage_overview.md
+++ b/guides/source/active_storage_overview.md
@@ -114,6 +114,13 @@ gem "aws-sdk-s3", require: false
NOTE: The core features of Active Storage require the following permissions: `s3:ListBucket`, `s3:PutObject`, `s3:GetObject`, and `s3:DeleteObject`. If you have additional upload options configured such as setting ACLs then additional permissions may be required.
+NOTE: If you want to use environment variables, standard SDK configuration files, profiles,
+IAM instance profiles or task roles, you can omit the `access_key_id`, `secret_access_key`,
+and `region` keys in the example above. The Amazon S3 Service supports all of the
+authentication options described in the [AWS SDK documentation]
+(https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/setup-config.html).
+
+
### Microsoft Azure Storage Service
Declare an Azure Storage service in `config/storage.yml`: